How to Prevent Timeout Errors for Token Inline Hooks

This article describes the types of issues that can cause inline hook executions to time out and how to prevent them.

• Token Inline Hooks

When Inline Hooks within Okta attempt to make a call to the endpoint configured for the hook, execution will automatically fail if it cannot complete within the hook's configured timeout.

These timeouts typically occur because the hook endpoint itself is failing to respond within this timeout. If the hook endpoint is secured with OAuth, a timeout can also occur if Okta is unable to get tokens from the OAuth provider AND call the hook endpoint within this timeout.

• Ensure the hook endpoint responds to the request within the configured Inline Hook timeout. By default, this timeout is 3 seconds. Open a Support case if there is a need to adjust this timeout for a specific hook.
• If securing a Token Inline Hook endpoint with OAuth, ensure that the implementation cannot trigger a recursive loop, where the hook is secured with tokens issued by the same Authorization Server that has the access rule that will invoke the same hook