Reagent Docs

Networking

Connect the secure web gateways, SASE platforms, firewalls, and browser security tools that show Reagent which AI apps people reach and with what data.

Networking is section 06 on the Connections page. It is the egress-observation layer: the connectors that tell you which AI apps people actually reach, seen from the proxy, from the firewall, or (with LayerX) from inside the browser. Connect whichever tiles below match what sits between your users and the internet.

Discovery signals lit from this layer: AI Chatbots in Browser (Netskope, Zscaler), AI Browser Extensions (LayerX), and AI Utilization in Sanctioned SaaS (Cloudflare Zero Trust Access logs). Firewall logs that land in the Zaun data lake also feed the AI-domain matching pack (template).

Most packs from this layer are templates. A template pack deploys paused and does not run until it is confirmed for your environment. LayerX's AI browser extension pack is live-validated and runs as soon as the connection is active.

Several of these connectors also expose response actions: block lists, address objects, and tag-driven policies. Those need write permissions that a read-only setup does not, and each Permissions table below calls out which grant enables them. Grant write only if you plan to use response actions from Monitor.

Alkira Network Cloud

Connector: alkira · Auth: API key (Alkira Portal API) · Requires: any plan

Alkira is a multi-cloud network-as-a-service platform. Its Cloud Services Exchange runs one network across AWS, Azure, GCP, OCI, data centers, branches, and SD-WANs through regional Cloud Exchange Points (CXPs), with segmentation, routing, and inserted firewall services. Reagent uses the Alkira Portal API to read telemetry and inventory from that fabric, and can change traffic policies on it when you ask it to.

Lights up: no discovery signal on its own. This tile gives Reagent the network inventory and telemetry behind your cloud egress, plus response actions (traffic policies, connector removal) from Monitor when the key has the edit role.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need an administrator login to the Alkira Portal.
  • Decide whether the key should be read-only or also allowed to change the fabric. The roles on the Alkira user decide what the key can do.

Setup

  1. Sign in to the Alkira Portal as an administrator.
  2. Go to Settings → User Management.
  3. Pick the user that will own the key. Grant that user the roles the operations need: read for telemetry and inventory, edit for response actions and provisioning.
  4. Use the KEY button on that user to generate an API key. Copy it.
  5. In Reagent, open Connections, click the Alkira Network Cloud tile, enter the portal host, paste the raw API key, and save.
FieldValue
Alkira PortalYour portal host, for example your-tenant.portal.alkira.com. Reagent calls https://<portal>/api.
API KeyThe raw key from the Alkira Portal. Reagent sends it as Authorization: api-key <base64> and base64-encodes it for you. Paste the raw key, not an encoded one.

Permissions

Alkira has no per-scope API token. The key inherits the roles of the user it was generated on.

Role on the Alkira userRequiredPurpose
ReadYesTelemetry (alerts, audit logs, provisioning jobs, connector health) and inventory
EditOnly for response actionsCreate or update traffic policies, remove a compromised cloud connector, provision changes to the live fabric

What Reagent reads

  • Telemetry: alerts, audit logs, provisioning jobs, connector health
  • Inventory: tenant networks, segments, groups, CXPs, cloud connectors, firewall services, traffic policies, routes

The key is exactly as powerful as the user it was generated on. Generate it on a dedicated user that carries only the roles you need. Paste the raw key; Reagent base64-encodes it before sending.


Cato SASE Cloud

Connector: cato-networks · Auth: API key in the x-api-key header (GraphQL API) · Requires: any plan

Cato SASE Cloud converges networking and security in one cloud service. Reagent queries the Cato GraphQL API for security events, application traffic analytics, firewall policy, and account topology.

Lights up: no discovery signal on its own. Response actions (firewall rules, site isolation, policy publish) run from Monitor when the key has Edit permission.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need an admin login to the Cato Management Application (CMA) that can create API keys.
  • Know which CMA URL you log in with. It decides the API region you pick in Reagent.
  • Decide whether the key gets View (read-only) or Edit (response actions).

Setup

  1. Log in to the Cato Management Application at cc.catonetworks.com, or the regional URL you normally use.
  2. Go to Administration > API Management (on some tenants Resources > API Keys).
  3. Click Create API Key.
  4. Name it (for example Zaun Integration). Set permissions to View for read-only monitoring, or Edit if you want response actions (firewall rules, site isolation, policy publish).
  5. Optionally restrict the key by source IP and set an expiration date.
  6. Copy the generated API key.
  7. Note your Account ID. It is the number in your CMA URL: cc.catonetworks.com/#!/account/XXXX.
  8. In Reagent, open Connections, click the Cato SASE Cloud tile, select the API region, paste the API key, enter the Account ID, and save.
FieldValue
API RegionGlobal (default), US Region, or EU Region. Must match your CMA instance (table below).
API KeyThe key from API Management. Sent in the x-api-key header.
Account IDFor reference. The number from your CMA URL, for example 2634. Passed as a variable in GraphQL queries, not used for authentication.

Your API region matches the CMA URL you use to log in.

CMA login URLAPI Region
cc.catonetworks.comGlobal (default)
cc.us1.catonetworks.comUS Region
cc.eu1.catonetworks.comEU Region

Permissions

Key permissionRequiredPurpose
ViewYesRead events, analytics, policy configuration, topology, audit trail
EditOnly for response actionsFirewall rules, site isolation, policy publish

What Reagent reads

  • Raw and aggregated security events
  • XDR incident stories for correlated threat investigation
  • Internet and WAN firewall policy configuration
  • Application traffic analytics and connection quality metrics
  • Sites, users, and admins for enrichment
  • Audit trail
  • Sandbox analysis results
  • Real-time account topology snapshots

Pick the region that matches the CMA URL you log in with. If you set an expiration date on the key, note it: the connection stops when the key expires, and you will need to create a new key and update the tile.


Cisco Firepower

Connector: cisco-firepower · Auth: Token auth (FMC username and password) · Requires: any plan

Cisco Firewall Management Center (FMC) is the central manager for Cisco firewalls and IPS. Reagent authenticates to the FMC REST API with a dedicated user and reads access policies, intrusion events, network objects, and device status.

Lights up: nothing directly from the API. Firewall logs from these devices that land in the Zaun data lake feed the AI-domain matching pack (template).

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need FMC admin access to create users under System → Users.
  • Plan on a dedicated service user for Reagent. Do not reuse a human admin's account (see the limits below).

Setup

  1. In FMC, go to System → Users.
  2. Create a dedicated user with a read-only admin role or a REST API role.
  3. In Reagent, open Connections, click the Cisco Firepower tile, enter the FMC URL, username, and password, and save.

Permissions

RoleRequiredPurpose
Dedicated read-only admin or REST API roleYesRead access policies, intrusion events, network objects, device status
REST API role with write accessOnly for response actionsChange access policies and network objects

What Reagent reads

  • Access policies
  • Intrusion events
  • Network objects
  • Device status

FMC throttles the API to 120 requests per minute per token, and tokens are bound to the user that authenticates. The API also enforces a per-user concurrency limit of 10 sessions. Provision a dedicated service user so Reagent does not contend with human admins for either limit. FMC sessions expire after 30 minutes of inactivity; Reagent re-authenticates automatically with the stored credentials.


Cisco Meraki

Connector: meraki-firewall · Auth: Meraki Dashboard API key · Requires: API access enabled on the organization

Cisco Meraki is cloud-managed networking: MX security appliances, MS switches, MR wireless APs, and Systems Manager MDM. Reagent reads the Dashboard API for device and client inventory, MX security events, content filtering, and firewall rules, and can update rules, block clients, or control ports when you ask it to.

Lights up: nothing directly from the API. MX firewall logs that land in the Zaun data lake feed the AI-domain matching pack (template). Response actions (firewall updates, client blocking, port control, Systems Manager commands) run from Monitor when the key belongs to a full organization admin.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need a Meraki organization admin account. Read-only organization admin is enough for data collection.
  • Each admin can have up to 2 API keys.
  • Decide whether the admin who generates the key is read-only (collection only) or full (collection plus response actions).

Setup

  1. Log in to the Meraki Dashboard.
  2. Go to Organization > Settings and make sure API access is enabled.
  3. Click your username (top right) and open My profile.
  4. Under API access, click Generate new API key.
  5. Copy the key immediately. It is shown only once.
  6. In Reagent, open Connections, click the Cisco Meraki tile, paste the API key, and save.

Permissions

The API key inherits the dashboard permissions of the admin who generated it. There are no per-key scopes.

Admin levelRequiredPurpose
Organization admin, read-onlyYesAll data collection
Organization admin, fullOnly for response actionsFirewall rule updates, client blocking, switch port control, Systems Manager commands

What Reagent reads

  • Organization, network, and device inventory (MX, MS, MR, SM)
  • Device health and status (online, offline, alerting)
  • Network clients: MAC, IP, OS, connection type, usage
  • MX security events: IDS/IPS alerts, malware events, content filtering
  • Firewall rules (L3 and L7)
  • IDS/IPS and AMP/malware protection settings
  • Content filtering: URL allow/block lists, category blocking
  • Air Marshal wireless rogue AP detection
  • Configuration change audit trail and admin RBAC
  • VPN, VLAN, and wireless SSID configuration
  • Login security and authentication policy posture

What Reagent can change

Full organization admin only.

  • Firewall rules (L3 and L7)
  • Switch ports: enable, disable, VLAN changes, port cycling
  • Clients: block, unblock, assign group policies
  • Systems Manager: remote lock, remote wipe

The key is shown only once. Rate limits are 10 requests per second per organization sustained, with a burst of up to 30 requests in the first 2 seconds. Meraki returns HTTP 429 with a Retry-After header when exceeded.


Cloudflare

Connector: cloudflare · Auth: API token (Bearer) · Requires: any plan

Cloudflare sits at the edge: WAF, DDoS mitigation, Bot Management, Zero Trust (Access, Gateway, WARP), DNS, SSL/TLS, and Page Shield. Reagent calls the Cloudflare v4 REST API with an account-scoped token to read Zero Trust Access activity, Gateway rules, WAF events, DNS, and audit logs, and can edit DNS records, firewall rules, and filter lists when you ask it to.

Lights up: AI Utilization in Sanctioned SaaS, from Cloudflare Zero Trust Access logs (template pack, deploys paused until confirmed for your environment). The signal covers apps fronted by Access, not general Gateway browsing. Response actions (DNS edits, firewall rules, filter lists) run from Monitor when the token has the write permissions.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need a Cloudflare login that can create API tokens with account-level permissions.
  • Have your Account ID ready. It is in the dashboard URL: dash.cloudflare.com/<accountId>.

Setup

  1. Log in to the Cloudflare Dashboard.
  2. Go to My Profile → API Tokens.
  3. Click Create Token and use the Custom Token template.
  4. Add the permissions in the table below. Add the write permissions only if you want response actions.
  5. Create the token and copy it. It is shown only once.
  6. Note your Account ID from the dashboard URL (dash.cloudflare.com/<accountId>).
  7. In Reagent, open Connections, click the Cloudflare tile, paste the API token, enter the Account ID, and save.
FieldValue
API TokenThe Custom Token you created. Sent as a Bearer token.
Account IDThe 32-character account ID, for example 023e105f4ecef8ad9ca31a8372d0c353. Most Cloudflare reads are account-scoped (/accounts/{account_id}/...).

Permissions

Read permissions (required):

PermissionPurpose
Account:ReadAccount details and account-scoped reads
Zone:ReadZone inventory
Firewall Services:ReadFirewall rules and WAF security events
DNS:ReadDNS records
Analytics:ReadTraffic analytics
Access: Apps and Policies:ReadZero Trust Access apps and policies
Logs:ReadLogs, including the Zero Trust Access logs behind the discovery signal
Account Settings:ReadAccount settings
Intel:ReadIP and domain threat intelligence

Write permissions (only for response actions):

PermissionPurpose
DNS:EditChange DNS records, for example to sinkhole a domain
Firewall Services:EditCreate or change firewall rules
Account Filter Lists:EditUpdate account-level lists that rules reference

What Reagent reads

  • WAF security events
  • Zero Trust Access logs (the apps users authenticate to through Access)
  • Gateway rules
  • Device inventory
  • DNS records
  • Audit logs, for configuration drift
  • Page Shield
  • SSL certificates
  • IP and domain threat intelligence

The token is shown only once. Most reads are account-scoped, so the Account ID you enter must belong to the account the token was created in.


PAN-OS

Connector: paloalto-firewall · Auth: XML API key · Requires: any plan

Palo Alto Networks PAN-OS firewalls provide GlobalProtect VPN, threat prevention, URL filtering, WildFire malware analysis, and traffic visibility. Reagent uses the PAN-OS XML API to read security policies, threat and traffic logs, GlobalProtect sessions, and URL filtering verdicts, and can manage address objects and submit files to WildFire when you ask it to.

Lights up: nothing directly from the API. Traffic and URL logs that land in the Zaun data lake feed the AI-domain matching pack (template). Response actions (address objects, security policy changes) run from Monitor when the API admin has write scopes.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need admin access to the firewall management interface to create admin roles and users.
  • Have your Zaun environment's egress IP range on hand for Permitted IPs.

Setup

  1. On the firewall, create a dedicated admin role with the read and write API scopes you need, and a dedicated API admin user with that role.

  2. Set Permitted IPs on that API admin to your Zaun environment's egress range. Do this before generating the key.

  3. Generate the key with the keygen call:

    curl -k -X GET 'https://<host>/api/?type=keygen&user=<user>&password=<pwd>'
  4. Copy the <key> value from the response.

  5. In Reagent, open Connections, click the PAN-OS tile, enter the base URL, paste the API key, and save.

FieldValue
Base URLThe management URL of your PAN-OS firewall or Panorama, without /api (for example https://<firewall-or-panorama-host>)
API KeyThe <key> value from the keygen response

Permissions

Admin role scopeRequiredPurpose
Read API scopesYesSecurity policies, threat and traffic logs, GlobalProtect sessions, URL filtering verdicts, address objects
Write API scopesOnly for response actionsManage address objects and security policies, submit files to WildFire

What Reagent reads

  • Security policies
  • Threat and traffic logs
  • GlobalProtect VPN sessions
  • URL filtering verdicts
  • Address objects

Always set Permitted IPs on the API admin before issuing the key. Without it the key works from anywhere that can reach the management interface. PAN-OS API keys do not expire by default. Rotate them on a schedule, and disable the admin user if the key is ever exposed.


Netskope

Connector: netskope · Auth: REST API v2 token (Netskope-Api-Token header) · Requires: any plan

Netskope Security Cloud is an SSE platform: CASB, secure web gateway, ZTNA, DLP, UEBA, cloud firewall, and private access in one cloud-native service. Reagent reads its REST API for alerts, web and app events, client inventory, quarantined files, and user behavior scores, so AI apps reached through the Netskope proxy show up on Discover with the user, app, device, and activity context Netskope has.

Lights up: AI Chatbots in Browser, from Netskope AI app events (template pack, deploys paused until confirmed for your environment).

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need Netskope Admin Console access that can create REST API v2 tokens.
  • Know your tenant URL, for example acme.goskope.com.

Setup

  1. Log in to the Netskope Admin Console.
  2. Go to Settings → Tools → REST API v2.
  3. Click New Token.
  4. Assign the six endpoints listed under Permissions.
  5. Copy the token.
  6. In Reagent, open Connections, click the Netskope tile, enter the tenant URL and the token, and save.
FieldValue
Tenant URLYour tenant host, for example your-tenant.goskope.com. Reagent calls https://<tenant>.goskope.com.
API Token (V2)The token from REST API v2. Sent in the Netskope-Api-Token header.

Permissions

Netskope v2 tokens are scoped by endpoint. Assign all of these when you create the token.

EndpointPurpose
/api/v1/alertsDLP, anomaly, policy, and malware alerts
/api/v2/eventsWeb, app, network, and audit events. The AI app events come from here.
/api/v1/clientsEnrolled client inventory
/api/v1/quarantineQuarantined files
/api/v1/ubscoreUser behavior scores (UEBA)
/api/v1/infrastructurePrivate access publishers and apps

What Reagent reads

  • Alerts: DLP, anomaly, policy, malware
  • Events: web, app, network, audit
  • Enrolled client inventory
  • Quarantined files
  • User behavior scores (UEBA)
  • URL classification
  • Private access publishers and apps
  • File threat intelligence

Assign all six endpoints when you create the token. Enter the tenant URL as a host, the way the form shows it (acme.goskope.com).


FortiGate

Connector: fortigate-firewall · Auth: REST API admin token (Authorization: Bearer header) · Requires: any plan

FortiGate is Fortinet's next-generation firewall. Reagent uses the FortiGate REST API to read firewall policies, address objects, traffic logs, and system status, and can create address objects when you ask it to.

Lights up: nothing directly from the API. Traffic logs that land in the Zaun data lake feed the AI-domain matching pack (template). Response actions (address objects) run from Monitor when the admin profile has write on firewall.address.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need FortiGate web UI access that can create admin profiles and REST API admins.
  • Know the management URL: a hostname or IP, with the port if it is not the default, for example fortigate.example.com or 10.0.0.1:10443.
  • Know whether the appliance serves its management interface with a private or self-signed CA.
  • Have your Zaun egress IP range on hand for Trusted Hosts.

Setup

Create the admin profile first, then the REST API admin that uses it.

  1. Log in to the FortiGate web UI.
  2. Go to System > Admin Profiles and click Create New.
  3. Grant read access to Firewall, Log & Report, and System. Grant write on Firewall only if you want Reagent to create address objects.
  4. Save the profile.
  5. Go to System > Administrators and click Create New > REST API Admin.
  6. Set a username (for example zaun-api) and select the profile from step 4.
  7. Under Trusted Hosts, restrict to your Zaun egress IP range (recommended).
  8. Click OK. The API token displays once. Copy it immediately.
  9. In Reagent, open Connections, click the FortiGate tile, enter the management URL, paste the token, leave Verify TLS certificates on unless the appliance uses a private or self-signed CA, and save.
FieldValue
Management URLfortigate.example.com or 10.0.0.1:10443
API TokenThe REST API admin token. Sent as Authorization: Bearer <token>.
Verify TLS certificatesKeep enabled. Disable only when this appliance uses a private or self-signed CA. The opt-out is stored on this credential and logged with the appliance host.

Permissions

For the operations Reagent calls today, the REST API admin's profile needs these.

Profile permissionRequiredPurpose
firewall.policy readYesFirewall policies
firewall.address readYesAddress objects
system readYesSystem status
log.traffic readYesTraffic logs
firewall.address writeOnly for response actionsCreate address objects

What Reagent reads

  • Firewall policies
  • Address objects
  • Traffic logs
  • System status

The token displays once, at creation. If you turn off TLS verification, the choice is recorded on the credential and logged with the appliance host. Turn it back on once the appliance has a certificate from a trusted CA.


Zscaler

Connector: zscaler-zia · Auth: OAuth 2.0 client credentials · Requires: any ZIA tenant

Zscaler Internet Access (ZIA) is a cloud secure web gateway: URL filtering, firewall, DLP, sandboxing, and advanced threat protection. Reagent reads the ZIA API for URL categorization, firewall and URL filtering policy, cloud application control, DLP configuration, and user, group, department, and location inventory, so AI apps reached through Zscaler show up on Discover as app-level sightings: app name, risk index, sanctioned state, and user and byte counts per app, without per-user or per-location attribution.

Lights up: AI Chatbots in Browser, from ZIA Shadow IT AI apps (template pack, deploys paused until confirmed for your environment). Response actions (URL categories, block rules, denylist entries) run from Monitor when the API role can write.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need ZIA Admin Portal access to Administration > Authentication Settings > API Key Management.
  • Know your cloud instance. It is in your admin portal URL (table below).
  • Know your org ID and the API role you will put in the OAuth scope.

Setup

  1. Log in to the ZIA Admin Portal. Use the URL for your cloud, for example admin.zscaler.net.
  2. Go to Administration > Authentication Settings > API Key Management.
  3. Create an OAuth 2.0 client. This generates a Client ID and Client Secret.
  4. Note the scope format the client requires: <cloud>::<org-id>::<api-role>.
  5. Copy the Client ID and Client Secret.
  6. In Reagent, open Connections, click the Zscaler tile, select the cloud instance, paste the Client ID and Client Secret, and save.
FieldValue
Cloud InstanceThe cloud that matches your ZIA tenant (table below)
Client IDFrom the OAuth 2.0 client
Client SecretFrom the OAuth 2.0 client

Your cloud instance is visible in your ZIA admin portal URL.

Admin portal URLCloud Instance
admin.zscaler.netzscaler.net
admin.zscalerone.netzscalerone.net
admin.zscalertwo.netzscalertwo.net
admin.zscalerthree.netzscalerthree.net
admin.zscloud.netzscloud.net
admin.zscalergov.netzscalergov.net (US Gov)

Permissions

ZIA scopes the OAuth client as <cloud>::<org-id>::<api-role>. The API role you assign to the client decides what Reagent can do.

API roleRequiredPurpose
Read-capable roleYesEverything under What Reagent reads
Write-capable roleOnly for response actionsCustom URL categories, URL filtering block rules, the advanced threat protection denylist, and configuration activation

Rate limits

ZIA enforces these per tenant.

Endpoint groupLimit
Authentication2 requests/second, 1,000/hour
URL Lookup1 request/second, 400/hour, up to 100 URLs per request
Sandbox Reports2 requests/second, 1,000/hour, 1,000/day
Configuration endpoints1 request/second, 400/hour

What Reagent reads

  • Real-time URL categorization lookups
  • Cloud sandbox analysis reports by file hash
  • Firewall and URL filtering policy rules
  • DLP dictionaries and engine configuration
  • SSL inspection rules and cloud application control policies
  • Advanced threat protection settings and malicious URL denylists
  • Users, groups, departments, and locations for enrichment
  • Security policy configuration for compliance and posture

Pick the cloud instance that matches your admin portal URL exactly. zscalergov.net is the US Gov cloud. The OAuth client scope uses the <cloud>::<org-id>::<api-role> format; note it when you create the client.


LayerX

Connector: layerx · Auth: API token (Client ID and Secret Key), sent as HTTP Basic · Requires: any LayerX tenant

LayerX is an agentless browser and AI-usage security platform delivered as an enterprise browser extension. It sees what the proxy and the firewall cannot: which extensions are installed in each browser, and which GenAI and agentic-browser policies apply. Reagent reads the LayerX REST API for device and extension inventory, policy configuration, and tags, and drives response through tags.

Lights up: AI Browser Extensions (live-validated pack; it runs as soon as the connection is active). Response actions (tagging an extension or other asset so an existing LayerX policy acts on it, and alert triage write-back) run from Monitor when the token carries the Tag Admin and Alerts Reader roles.

LayerX delivers its security event stream by push to the log destination you configure in the LayerX console, rather than exposing events for polling. This connection covers inventory, policy, and response, not the event stream itself.

Before you start

  • You need the manage integrations permission in Reagent (Administrator, MSSP Admin, or a custom role with it).
  • You need LayerX console access to Settings → API Tokens.
  • Decide which roles the token gets (see Permissions). Read Only is enough for discovery.
  • Leave region detection to Reagent. Pick a region by hand only if detection cannot decide.

Setup

  1. In the LayerX console, go to Settings → API Tokens and click Generate Token.
  2. Enter a description that names this integration, for example Zaun.
  3. Select the roles (see Permissions), set an expiry, and click Create.
  4. Copy the Client ID and Secret Key. The Secret Key is shown only once.
  5. In Reagent, open Connections, click the LayerX tile, paste the Client ID and Secret Key, leave Region on automatic detection, and save. Saving probes all five LayerX API hosts with your token and keeps the one that holds your data.
  6. Run a credential health check after saving to confirm the pair authenticates and returns data.
FieldValue
Client IDFrom the generated LayerX API token
Secret KeyFrom the generated LayerX API token. Shown only once at creation.
RegionDetected on save. Only pick manually if detection cannot decide.

LayerX homes each tenant on one of five API hosts (Global, US East 1, US East 1 prod02, AP Northeast 1, Japan), and the console domain does not say which. A wrong manual pick does not fail loudly: LayerX answers every request on the wrong shard with an empty result, so the connection looks healthy and reports no devices, extensions, or policies.

Permissions

RoleRequiredPurpose
Read OnlyYesDevice and extension discovery, policy reads
Tag AdminOnly for response actionsTag writes that drive containment through existing policies
Alerts ReaderOptionalAlert triage status write-back
AdminAlternativeAll of the above, if your tenant does not expose the narrower roles

What Reagent reads

  • Device discovery: endpoints observed through the LayerX browser extension
  • Extension discovery: browser extensions across the fleet, with permissions and risk data
  • Policy configuration: secure browsing, data control, browser posture, GenAI and agentic-browser policies
  • Tags: the named asset groups your policies match on

Response actions

Writes go through tags. Adding an asset to a tag that an existing LayerX policy references is how a containment action takes effect: tag a malicious extension, and the block policy already watching that tag picks it up.

  • Create tags and add, remove, or annotate their assets
  • Update an alert's triage status after investigation

A plain tag update replaces the full asset list. Use the upsert action when you mean to add an asset without disturbing what is already there.

The Secret Key is shown only once. If you lose it, generate a new token rather than trying to recover it. The token expires on the date you set, and the connection stops working until you rotate it on the tile. If the connection looks healthy but reports no devices, extensions, or policies, the region is wrong: clear the manual pick and let detection choose.