Search Results

Agent error code #MERA400 indicates the Meraki Dashboard returned a response the agent could not parse. Common causes include: A proxy or captive portal returning HTML instead of the API response An unexpected API change Steps to Resolve Confirm requests reach...

Each Knocknoc user has a limit on how many things can be signed in and holding access at the same time. When that limit is reached, the user is shown a Session limit reached screen and asked to disconnect one of their active sessions before they can continue. ...

Knocknoc integrates with nftables to dynamically control network access on a Linux host. When a user authenticates, their IP address is added to an nftables named set, and removed again when their access ends. Your own rules reference that set with @setname t...

Agent error code #FSTL001 indicates Fastly rejected the API token in the agent's Fastly-Key header (HTTP 401). This is distinct from an authorization failure (#FSTL002), where the token is valid but cannot reach the service. Common causes include: The token h...

Agent error code #FSTL002 indicates the API token authenticated but is not allowed to act on the configured service (HTTP 403). The Knoc wizard's Validate connection step reads the token's own record, so a read-only token is reported here rather than at the fi...

Agent error code #FSTL003 indicates the TLS handshake with the Fastly API failed: the certificate could not be verified, was invalid, or did not match the host. Common causes include: A TLS-inspecting proxy presents its own certificate and its CA is not in the...

Agent error code #FSTL005 indicates Fastly answered with HTTP 429: the API token has made too many requests. The agent already retries a 429 a few times, honoring the Retry-After header, so this code means the limit was still in force after those retries. Com...

Agent error code #FSTL050 indicates the agent could not read the configured Fastly service. It reads the service to find the active version, which is where the ACL lives. Common causes include: The Service ID is wrong (see also #FSTL051) The token cannot read ...

Agent error code #FSTL051 indicates Fastly answered HTTP 404 for the configured service. Common causes include: The Service ID has a typo, or a service name was entered instead of its ID The service was deleted The token belongs to a different Fastly account S...

Agent error code #FSTL052 indicates the configured service has no active version, so its ACLs are not in force and there is nothing for Knocknoc to write into. Common causes include: The service was created but never activated Every version was deactivated dur...

Agent error code #FSTL100 indicates the agent could not list the ACLs on the service's active version, so it could not resolve the configured ACL name to an ACL. Common causes include: The token can read the service but not its versioned configuration A transi...

Agent error code #FSTL101 indicates no ACL with the configured name exists on the service's active version. Knocknoc looks the ACL up by name on every fresh resolve, so this also fires when an ACL was deleted and its replacement was never activated. Common cau...

Agent error code #FSTL150 indicates Fastly refused to add the entry for a granted address, so the user has not been allowed through. An address the ACL already holds is not an error: Knocknoc treats a duplicate as a successful grant. A full ACL reports #FSTL15...

Agent error code #FSTL151 indicates Fastly refused to remove an entry, so an address may still be allowed through after its grant ended. An entry that is already gone is not an error: Knocknoc treats it as a completed revoke. Common causes include: The token c...

Agent error code #FSTL152 indicates the agent could not read the ACL's entries. It reads them to find the entry to remove on a revoke, and to reconcile its own view of the ACL. Common causes include: The token lost access to the service The ACL was deleted (se...

Agent error code #FSTL153 indicates the ACL is full, so the grant could not be added. Fastly caps an ACL at 1,000 entries and documents no self-service way to raise it. Unlike a rate limit (#FSTL005), waiting does not clear this. Something has to leave the ACL...