OKTA052 - Okta Network Zone Not Found

Agent error code #OKTA052 indicates that Okta returned HTTP 404 for the configured Network Zone ID. The Knocknoc backend points at a network zone that no longer exists in the org.

Common causes include:

• The network zone was deleted in the Okta admin console
• The wrong ID was copied into the Knocknoc backend configuration when the Knoc was set up
• The Knoc was migrated from a different Okta org (e.g. preview to production) and the old ID was retained

Steps to Resolve

Locate the Correct Network Zone

1. In the Okta admin console, navigate to Security > Networks
2. Open the network zone intended for use with Knocknoc
3. Copy the ID from the browser URL (the nzo... segment)
4. Paste it into the Network Zone ID field of the Knocknoc backend configuration

For the full setup, see the Okta setup guide.

Confirm the Org Matches

1. Confirm the Okta admin console you are looking at is the same org as the Okta Domain configured on the Knocknoc backend
2. Preview orgs (acme.oktapreview.com) hold a separate set of zone IDs from production (acme.okta.com)

Create a New Network Zone

If the original zone was deliberately deleted:

1. In Security > Networks, click Add Zone > IP Zone
2. Give it a name and add at least one sentinel gateway (e.g. 192.0.2.0/32) so the create succeeds. Knocknoc replaces this list on the next grant
3. Save and copy the new ID into the Knocknoc backend configuration

Still Having Issues?

We can help you out, contact us at support@knocknoc.io.