The dashboard includes a message feed. Messages typically relate to the configuration of the AppGate ZTNA Collective, a related system, or the network environment.
The following table describes each message, its source, and the action to take:
Source | Error Level | Message | Action |
|---|---|---|---|
Controller | Warning | A user did not get the entitlement | Go to Access > Entitlements and select the named entitlement. Confirm that it has a valid Site assigned. |
Controller | Warning | A user did not get the entitlement, because its Site | The Site assigned to the entitlement has no active Gateways. Go to System > Appliances and either seed a new Gateway or select an existing one and assign the correct Site to it. |
Controller | Warning | A user on identity provider | If IPv6 entitlements are in use but the identity provider has no IPv6 pool assigned, users cannot reach those entitlements. Assign the appropriate IP pool to the identity provider. |
Controller | Warning | Administrative API requests are being made to hostname | This message appears when an administrator or API script accesses the Controller using an IP that does not match the configured hostname. To prevent data instability, always target a single, specific Controller for administrative operations, as making changes across multiple Controllers simultaneously can cause instability. |
Controller | Warning | At least one of your policies is configured with override Site using the claim | Check the claim name in all policies that use Override using a claim. Either correct the claim in the identity provider mapping or update the claim name in the policy's override Site setting. |
Controller | Warning | At least one of your policies is configured with override Site using the claim | Confirm that the claim contains the correct Site UUID. To find the Site UUID, go to the Site settings and copy the UUID from the admin UI URL. |
Controller | Warning | Client profile settings are defined in more than one active policy for a user. The setting from | One or more users have a conflicting client profile setting across their device policies. Identify which user has |
Controller | Warning | Client settings are defined in more than one active policy for a user. The setting from policy | One or more users have a conflicting client settings configuration across their policies. This most commonly occurs in device policies or the device section of mixed policies. Identify which user has |
Controller | Error | Controller has failed to verify metered EC2 instance state. Failures lasting longer than one hour prevent users signing in on this Controller. Details: | This error occurs only with metered subscription instances from AWS. The Controller cannot reach the AWS metered subscription API and cannot use the metered license model. Users attempting to sign in after one hour are affected. Users already connected are not affected. |
Controller | Warning | Criteria script | The criteria script used to select users for the client auto-update service no longer exists. Go to System > Client Auto-Update and select an existing criteria script. |
Controller | Warning | Device Proxy Auto Config URL matches are defined in more than one active policy for a user. The setting from the policy | One or more users have a conflicting Device Proxy Auto Config URL setting across their policies. This most commonly occurs in device policies or the device section of mixed policies. Identify which user has |
Controller | Warning |
| Confirm that a valid admin policy is matched for this user. If no admin policy is active, see the knowledge base for remediation steps. |
Controller | Warning | Failed to allocate IP from pool | The Controller could not assign an IP from the pool to a user. In most cases, the IP pool is full on this Controller. If only one Controller is reporting this error and the IP pool list shows available IPs, confirm that users can reach all Controllers. Each Controller is responsible for allocating its share of the IP pool. |
Controller | Warning | Failed to map to IP pool | The Controller could not map the tunnel IP to the mapped IP pool for < |
Controller | Warning | Failed to retrieve details from the identity provider | The Controller cannot communicate with the identity provider. Verify the identity provider settings, certificates, and connectivity between the Controller and the identity provider. |
Controller | Warning | Identity provider | The identity provider has no IP pool assigned. Users can authenticate against the identity provider but receive an error because the Controller cannot assign a tunnel IP. Assign an IP pool to the identity provider. |
Controller | Error | Identity Provider | The identity provider failed to authenticate a user. Review the message details to determine why the user could not sign in, then investigate the identity provider configuration. |
Controller | Warning | Multiple active policies for a user have defined DNS settings for the same domain name | One or more users have a conflicting DNS domain setting across their DNS policies. Identify which user has |
Controller | Warning | Multiple custom help URLs are defined in more than one active policy for a user. The setting from policy | One or more users have a conflicting custom help URL setting across their device policies. Identify which user has |
Controller | Warning | One or more of your licenses has an error. Please check your licenses and remove the ones with errors. | One of the uploaded licenses is incorrect or expired. Sign in to the admin UI, go to Settings > Licenses, and verify that all licenses are valid. If a license is incorrect, contact support. |
Controller | Warning | One or more policy override Sites could not be found while trying to apply to entitlement | Identify which policy has an assignment for the named entitlement, either directly or via tag. Confirm that the specified override Site still exists. |
Controller | Warning | One or more policy override Sites could not be found while trying to apply to entitlement | More than one policy matches the named entitlement and each specifies a different override Site. Update the criteria scripts for all conflicting policies to resolve the conflict. |
Controller | Warning | Some entitlements use cloud resource names in a deprecated format. The following entitlements require migration: Please review the documentation on migrating resource names to the common JSON syntax. | Review the Migrating DNS settings documentation. |
Controller | Warning | Some entitlements use deprecated host formats (the "domain://" prefix, the "dns://" prefix with glob syntax or bare hostnames containing glob syntax). The following entitlements require migration: Please review the documentation on migrating to the dnsfwd:// format. | Review the Migrating DNS settings documentation. |
Controller | Warning | Trusted Network Detection settings are defined in more than one active policy for a user. The setting from policy | One or more users have a conflicting Trusted Network Detection setting across their policies. This most commonly occurs in device policies or the device section of mixed policies. Identify which user has |
Gateway | Warning | Brokered entitlement | When a brokered SSH or RDP entitlement host resolves to more than 10 IPs, the session caps the per-IP shortcut at 10. The remaining IPs are dropped. |
Gateway | Warning | Failed to evaluate condition | Review the condition and determine why it is not evaluating within the time limit. Go to the specific condition and test it with an active user to confirm whether it executes in time. |
Gateway | Warning |
| Review the cz-gonamed journal entry for the affected assets. |
Gateway | Warning | The client with DN: | The client DN has repeatedly retried connections to the same Gateway and has been load-limited. Review the client logs for |
Gateway | Warning | The following hostnames have been unresolved for at least X seconds | One or more hostnames could not be resolved by the DNS server specified in the DNS name resolver. Review the listed hostnames and confirm that the DNS configuration is correct. |
ZTP | Error | Failed to communicate with Risk Engine. | One of the Controllers could not reach the ZTP service. Confirm that all Controllers can reach the ZTP service. |
ZTP | Warning | Risk Engine is not active because this Collective is not registered to ZTP. | Confirm that the Collective is registered to ZTP. |
ZTP | Warning | Risk Engine is not available. | A network configuration issue exists — for example, a firewall is blocking the Controller from connecting to ZTP, or the ZTP services are down or experiencing technical issues. |
ZTP | Warning | Risk Engine live alerts not available. Socket connection is not established. | A network configuration issue exists — for example, a firewall is blocking the Controller from connecting to ZTP, or the ZTP services are down or experiencing technical issues. Check the status of your socket connection. |
ZTP | Error | ZTP registration has been revoked. Contact your ZTP administrator for more details. | The ZTP account is no longer valid. Contact your ZTP administrator to obtain valid credentials. |