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
- Sign in to the Alkira Portal as an administrator.
- Go to
Settings → User Management. - 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.
- Use the
KEYbutton on that user to generate an API key. Copy it. - In Reagent, open Connections, click the Alkira Network Cloud tile, enter the portal host, paste the raw API key, and save.
| Field | Value |
|---|---|
| Alkira Portal | Your portal host, for example your-tenant.portal.alkira.com. Reagent calls https://<portal>/api. |
| API Key | The 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 user | Required | Purpose |
|---|---|---|
| Read | Yes | Telemetry (alerts, audit logs, provisioning jobs, connector health) and inventory |
| Edit | Only for response actions | Create 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) orEdit(response actions).
Setup
- Log in to the Cato Management Application at
cc.catonetworks.com, or the regional URL you normally use. - Go to
Administration > API Management(on some tenantsResources > API Keys). - Click
Create API Key. - Name it (for example
Zaun Integration). Set permissions toViewfor read-only monitoring, orEditif you want response actions (firewall rules, site isolation, policy publish). - Optionally restrict the key by source IP and set an expiration date.
- Copy the generated API key.
- Note your Account ID. It is the number in your CMA URL:
cc.catonetworks.com/#!/account/XXXX. - In Reagent, open Connections, click the Cato SASE Cloud tile, select the API region, paste the API key, enter the Account ID, and save.
| Field | Value |
|---|---|
| API Region | Global (default), US Region, or EU Region. Must match your CMA instance (table below). |
| API Key | The key from API Management. Sent in the x-api-key header. |
| Account ID | For 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 URL | API Region |
|---|---|
cc.catonetworks.com | Global (default) |
cc.us1.catonetworks.com | US Region |
cc.eu1.catonetworks.com | EU Region |
Permissions
| Key permission | Required | Purpose |
|---|---|---|
View | Yes | Read events, analytics, policy configuration, topology, audit trail |
Edit | Only for response actions | Firewall 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
- In FMC, go to
System → Users. - Create a dedicated user with a read-only admin role or a REST API role.
- In Reagent, open Connections, click the Cisco Firepower tile, enter the FMC URL, username, and password, and save.
Permissions
| Role | Required | Purpose |
|---|---|---|
| Dedicated read-only admin or REST API role | Yes | Read access policies, intrusion events, network objects, device status |
| REST API role with write access | Only for response actions | Change 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
- Log in to the Meraki Dashboard.
- Go to
Organization > Settingsand make sureAPI accessis enabled. - Click your username (top right) and open
My profile. - Under
API access, clickGenerate new API key. - Copy the key immediately. It is shown only once.
- 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 level | Required | Purpose |
|---|---|---|
| Organization admin, read-only | Yes | All data collection |
| Organization admin, full | Only for response actions | Firewall 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
- Log in to the Cloudflare Dashboard.
- Go to
My Profile → API Tokens. - Click
Create Tokenand use theCustom Tokentemplate. - Add the permissions in the table below. Add the write permissions only if you want response actions.
- Create the token and copy it. It is shown only once.
- Note your Account ID from the dashboard URL (
dash.cloudflare.com/<accountId>). - In Reagent, open Connections, click the Cloudflare tile, paste the API token, enter the Account ID, and save.
| Field | Value |
|---|---|
| API Token | The Custom Token you created. Sent as a Bearer token. |
| Account ID | The 32-character account ID, for example 023e105f4ecef8ad9ca31a8372d0c353. Most Cloudflare reads are account-scoped (/accounts/{account_id}/...). |
Permissions
Read permissions (required):
| Permission | Purpose |
|---|---|
Account:Read | Account details and account-scoped reads |
Zone:Read | Zone inventory |
Firewall Services:Read | Firewall rules and WAF security events |
DNS:Read | DNS records |
Analytics:Read | Traffic analytics |
Access: Apps and Policies:Read | Zero Trust Access apps and policies |
Logs:Read | Logs, including the Zero Trust Access logs behind the discovery signal |
Account Settings:Read | Account settings |
Intel:Read | IP and domain threat intelligence |
Write permissions (only for response actions):
| Permission | Purpose |
|---|---|
DNS:Edit | Change DNS records, for example to sinkhole a domain |
Firewall Services:Edit | Create or change firewall rules |
Account Filter Lists:Edit | Update 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
-
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.
-
Set
Permitted IPson that API admin to your Zaun environment's egress range. Do this before generating the key. -
Generate the key with the keygen call:
curl -k -X GET 'https://<host>/api/?type=keygen&user=<user>&password=<pwd>' -
Copy the
<key>value from the response. -
In Reagent, open Connections, click the PAN-OS tile, enter the base URL, paste the API key, and save.
| Field | Value |
|---|---|
| Base URL | The management URL of your PAN-OS firewall or Panorama, without /api (for example https://<firewall-or-panorama-host>) |
| API Key | The <key> value from the keygen response |
Permissions
| Admin role scope | Required | Purpose |
|---|---|---|
| Read API scopes | Yes | Security policies, threat and traffic logs, GlobalProtect sessions, URL filtering verdicts, address objects |
| Write API scopes | Only for response actions | Manage 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
- Log in to the Netskope Admin Console.
- Go to
Settings → Tools → REST API v2. - Click
New Token. - Assign the six endpoints listed under Permissions.
- Copy the token.
- In Reagent, open Connections, click the Netskope tile, enter the tenant URL and the token, and save.
| Field | Value |
|---|---|
| Tenant URL | Your 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.
| Endpoint | Purpose |
|---|---|
/api/v1/alerts | DLP, anomaly, policy, and malware alerts |
/api/v2/events | Web, app, network, and audit events. The AI app events come from here. |
/api/v1/clients | Enrolled client inventory |
/api/v1/quarantine | Quarantined files |
/api/v1/ubscore | User behavior scores (UEBA) |
/api/v1/infrastructure | Private 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.comor10.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.
- Log in to the FortiGate web UI.
- Go to
System > Admin Profilesand clickCreate New. - Grant read access to
Firewall,Log & Report, andSystem. Grant write onFirewallonly if you want Reagent to create address objects. - Save the profile.
- Go to
System > Administratorsand clickCreate New > REST API Admin. - Set a username (for example
zaun-api) and select the profile from step 4. - Under
Trusted Hosts, restrict to your Zaun egress IP range (recommended). - Click OK. The API token displays once. Copy it immediately.
- 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.
| Field | Value |
|---|---|
| Management URL | fortigate.example.com or 10.0.0.1:10443 |
| API Token | The REST API admin token. Sent as Authorization: Bearer <token>. |
| Verify TLS certificates | Keep 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 permission | Required | Purpose |
|---|---|---|
firewall.policy read | Yes | Firewall policies |
firewall.address read | Yes | Address objects |
system read | Yes | System status |
log.traffic read | Yes | Traffic logs |
firewall.address write | Only for response actions | Create 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
- Log in to the ZIA Admin Portal. Use the URL for your cloud, for example
admin.zscaler.net. - Go to
Administration > Authentication Settings > API Key Management. - Create an
OAuth 2.0 client. This generates a Client ID and Client Secret. - Note the scope format the client requires:
<cloud>::<org-id>::<api-role>. - Copy the Client ID and Client Secret.
- In Reagent, open Connections, click the Zscaler tile, select the cloud instance, paste the Client ID and Client Secret, and save.
| Field | Value |
|---|---|
| Cloud Instance | The cloud that matches your ZIA tenant (table below) |
| Client ID | From the OAuth 2.0 client |
| Client Secret | From the OAuth 2.0 client |
Your cloud instance is visible in your ZIA admin portal URL.
| Admin portal URL | Cloud Instance |
|---|---|
admin.zscaler.net | zscaler.net |
admin.zscalerone.net | zscalerone.net |
admin.zscalertwo.net | zscalertwo.net |
admin.zscalerthree.net | zscalerthree.net |
admin.zscloud.net | zscloud.net |
admin.zscalergov.net | zscalergov.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 role | Required | Purpose |
|---|---|---|
| Read-capable role | Yes | Everything under What Reagent reads |
| Write-capable role | Only for response actions | Custom URL categories, URL filtering block rules, the advanced threat protection denylist, and configuration activation |
Rate limits
ZIA enforces these per tenant.
| Endpoint group | Limit |
|---|---|
| Authentication | 2 requests/second, 1,000/hour |
| URL Lookup | 1 request/second, 400/hour, up to 100 URLs per request |
| Sandbox Reports | 2 requests/second, 1,000/hour, 1,000/day |
| Configuration endpoints | 1 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
- In the LayerX console, go to
Settings → API Tokensand clickGenerate Token. - Enter a description that names this integration, for example
Zaun. - Select the roles (see Permissions), set an expiry, and click
Create. - Copy the Client ID and Secret Key. The Secret Key is shown only once.
- 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.
- Run a credential health check after saving to confirm the pair authenticates and returns data.
| Field | Value |
|---|---|
| Client ID | From the generated LayerX API token |
| Secret Key | From the generated LayerX API token. Shown only once at creation. |
| Region | Detected 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
| Role | Required | Purpose |
|---|---|---|
Read Only | Yes | Device and extension discovery, policy reads |
Tag Admin | Only for response actions | Tag writes that drive containment through existing policies |
Alerts Reader | Optional | Alert triage status write-back |
Admin | Alternative | All 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.