Skip to main content

Tags in Policies

When building Access and Policies, Lacework Edge has a set of tags you can use to characterize the users and/or traffic that you want to match.

Resource Tags

Resource Tags can be used in the "Applications" filter of a given Policy, to define which resources for which you are controlling access. Policies meant for routing traffic (Connector|Direct|Lacework Edge Routing) can only use certain tags, which are indicated in this list.

TagValueExampleRouting Policies
appuuid, not_found or *app:yourco.tcp.0.yourapp.com
app:not_found
✔️
appgroupappgroup_nameappgroup:internal_apps
classificationclassification_nameclassification:Gambling
connectorconnector_unique_nameconnector:internal-connector
domaindomain_namedomain:internal.yourco.com✔️
hosthost_namehost:myhost.internal.yourco.com✔️
networknetwork_cidrnetwork:192.168.1.0/24✔️
portport_numport:8080
url_inlist_uuidurl_in:listuuid
webappwebapp_namewebapp:google✔️

Session Tags

Session Tags are used in the "Users" filter of a given Policy, to qualify which user sessions will map to that Policy. These include tags pertaining to a user, their physical and networking location, and the device they are using.

TagValueExample
anomalousboolean or stringanomalous:true
anomalous:location
anonymous_usertrueanonymous_user:true
browserstringbrowser:Firefox
browser_versionstringbrowser_version:113.0
client_ipclient_nat_ipclient_ip:10.11.12.13
countrycountry_codecountry:US
country_inlist_uuidcountry_in:yourlistsuuid
device_activation_lock_enabledbooleandevice_activation_lock_enabled:true
device_risklow/medium/highdevice_risk:medium
disk_encryption_enabledbooleandisk_encryption_enabled:true
event_reviewboolean or stringevent_review:true
groupgroup_uuidgroup:someuuid
idp_attrstringidp_attr:title:Contractor
osstringos:Windows
os_versionstringos_version:13.1
posturehigh/medium/low/noneposture:medium
posture_gehigh/medium/low/noneposture_ge:medium
posture_lehigh/medium/low/noneposture_le:medium
useruser_uuid or *user:uuid
user_risklow/medium/highuser_risk:high
wifi_bssidwap_mac_addresswifi_bssid:00:B0:D0:63:C2:26
wifi_ssidwap_ssidwifi_ssid:yourco-5ghz

Tags Details

anomalous

Description: When set to true, Lacework Edge's AI detected unusual patterns of activity for this user. Two tags will be added to the user's session: one that indicates there is anomalous behavior (anomalous:true) as well as the type of behavior (anomalous:location). This facilitates writing a policy to match on the specific behavior, or on any behavior.
Value: boolean or string. Possible string values are activity, location, new_ip or new_location
Example: anomalous:true anomalous:location
Used In: User/Session filters

app

Description: Any Application defined in Lacework Edge.
Value: Either an application UUID in Lacework Edge, or the special value not_found. The tag app:not_found is typically used to match on Internet traffic routed to the Lacework Edge cloud that does not go through a connector. The special value app:* will always match. A policy must have at least one entry in its resource filter for it to be valid. If policy should match any resource, use the resource tag app:*.
Example: app:yourco.tcp.0.internal-file-share.egc
Used In: Application/Resource filters, including routing policies

appgroup

Description: The appgroup tag is applied to multiple Applications to save time and simplify the configuration access and policies. A common use of them is for when a single App has multiple endpoints.
Value: appgroup tag name
Example: appgroup:internal_apps
Used In: Application/Resource filters

anonymous_user

Description: Under some circumstances (e.g., access to internal windows domain controller for authentication) sessions will have access to resources before the user is logged in. Such a session will have the anonymous_user:true tag set.
Value: true
Example: anonymous_user:true
Used In: User/Session filters

browser

Description: Tag that is set only when the browser extension is used, identifying which browser.
Value: Either Chrome or Firefox
Example: browser:Firefox
Used In: User/Session filters

browser_version

Description: Tag that identifies the browser version number for browser extension.
Value: browser semver version
Example: browser_version:113.0
Used In: User/Session filters

classification

Description: Common categories of web sites. Can be used to allow/block traffic to an entire category, i.e. Social Media or Phishing sites. A complete list can be found here.
Value: Classification name
Example: classification:Gambling
Used In: Application/Resource filters

client_ip

Description: Public IP of the client's workstation, usually that of the Router/NAT.
Value: Client IP Example: client_ip:10.11.12.13
Used In: User/Session filters

connector

Description: Matches any applications or networks that designate a specific Lacework Edge Connector for routing. For example, to grant access to all applications that route through internal-connector, use connector:internal-connector as the resource match.
Value: Unique Name in Lacework Edge
Example: connector:internal-connector
Used In: Application/Resource filters

country

Description: The country a user's client is connecting from. To deny all client traffic originating from China, use a DENY policy with user filter set to country:CN.
Value: Country Code
Example: country:US
Used In: User/Session filters

country_in

Description: Refers to a Lacework Edge List that contains a list of Countries, matching on the country a user's client is connected from.
Value: List UUID in Lacework Edge
Example: country_in:yourlistsuuid
Used In: User/Session filters

device_activation_lock_enabled

Description: Whether the client device has activation lock enabled (an anti-theft protection).
Value: true/false
Example: device_activation_lock_enabled:true
Used In: User/Session filters

device_risk

Description: The calculated risk level of that user's device.
Value: low/medium/high
Example: device_risk:medium
Used In: User/Session filters

disk_encryption_enabled

Description: Whether the client device has OS disk encryption (e.g., BitLocker, FileVault) enabled.
Value: true/false
Example: disk_encryption_enabled:true
Used In: User/Session filters

domain

Description: Any domain name. Includes all sub-domains.
Value: Domain name
Example: domain:internal.yourco.com
Used In: Application/Resource filters, including routing policies

event_review

Description: Used for workflows. The tag event_review:true is added to a user's session when a new notification is sent out. Using this tag, you can block access to a resource until that user has reviewed and cleared events. A second tag with the specific type of notification is added as well, for example event_review:documentsharedexternally.
Value: boolean or string. Possible string values are: alert_config:uuid, anomalouslocationbyuser, documentsharedexternally, newexebyuser, suspiciousaccessdenied, unusualnumberofalertsbyuser, useronvpn, usertravelling, weird_user, workflowdeniedbyuser
Example: event_review:true event_review:documentsharedexternally
Used In: User/Session filters

group

Description: Any group the user belongs to will be added as a group:uuid tag for the session.
Value: group-uuid
Example: group:okta.id
Used In: User/Session filters

host

Description: Any host name. Does not include subdomains.
Value: Host name
Example: host:myhost.internal.yourco.com
Used In: Application/Resource filters, including routing policies

idp_attr

Description: Any attributes returned by the identity provider are added to the user's session as a idp_attr:string tag.
Value: string
Example: idp_attr:title:SDET
Used In: User/Session filters

network

Description: Any subnet to which you want to control access.
Value: Subnet in CIDR notation
Example: network:192.168.1.0/24
Used In: Application/Resource filters, for routing policies only

os

Description: The operating system family the client is running.
Value: The value Windows, macOS or iOS
Example: os:Windows
Used In: User/Session filters

os_version

Description: The operating system version the client is running.
Value: The semver version number
Example: os_version:13.3.1
Used In: User/Session filters

posture

Description: Indicates the highest level of Device Posture that a device currently matches. posture matches on an exact Posture Level.
Value: The value high, medium or low or none
Example: posture:medium
Used In: User/Session filters

posture_ge

Description: Indicates the highest level of Device Posture that this device currently matches. posture_ge matches Posture Levels greater than or equal to the value entered.
Value: The value high, medium or low or none
Example: posture_ge:medium
Used In: User/Session filters

posture_le

Description: Indicates the highest level of Device Posture that this device currently matches. posture_le matches Posture Levels less than or equal to the value entered.
Value: The value high, medium or low or none
Example: posture_le:low
Used In: User/Session filters

port

Description: Incoming port of a user's traffic
Value: port_num
Example: port:8080
Used In: Application/Resource filters

url_in

Description: Refers to a Lacework Edge List that contains a list of domains, hostnames and URLs. The current request is matched against the entries in the list. An entry of the form xyz.com will match all hosts and URLs that have the xyz.com domain. An entry of the form xyz.com/ will match only URLs that have the exact hostname xyz.com. An entry of the form xyz.com/static will match only URLs with an exact hostname match on xyz.com and that have a path prefix of /static.
Value: List UUID in Lacework Edge
Example: url_in:listuuid
Used In: Application/Resource filters

user

Description: Every user has the tag user:uuid added to their session. To match on a specific user use a user:uuid tag. Similar to app:* it's possible to use user:* as a wildcard to indicate that a user filter on a policy should always match.
Value: uuid
Example: user:uuid
Used In: User/Session filters

user_risk

Description: The calculated risk level of a user.
Value: low/medium/high
Example: user_risk:high
Used In: User/Session filters

webapp

Description: Netify maintains a list of common webapps that encompass the domains that app uses (i.e. Zoom runs in zoom.com, zomgov.com, zoom.us, etc.).
Value: Webapp Name - see the list here
Example: webapp:zoom
Used In: Application/Resource filters, including routing policies

wifi_bssid

Description: MAC Address of the Wireless Access Point to which this device is connected.
Value: MAC Address
Example: wifi_bssid:00:B0:D1:63:C2:26
Used In: User/Session filters, for config and routing policies only

wifi_ssid

Description: SSID of the Wireless Access Point to which this device is connected.
Value: SSID
Example: wifi_ssid:yourco-5ghz
Used In: User/Session filters, for config and routing policies only