Token introspection

Token introspection in Toucan AI helps you verify and debug your integration, ensuring secure and accurate data access for every user.

Objective

In this tutorial, you will learn how to introspect a token in Toucan AI. Token introspection allows you to view and verify the contents of a previously generated token, ensuring that it contains the correct attributes and data access configurations.

Prerequisites

• A Toucan AI account.

• A previously generated token (either a sandbox token or a production token).

Steps

1. Access the Settings Menu

• From the main interface, click on the Settings button in the menu.

2. Navigate to the Embed Tab

• In the Settings menu, click on the Embed tab to access settings related to token generation and token introspection.

3. Find the Token Introspection Section

• Scroll down to the Token Introspection section within the Embed tab.

• This section allows you to paste a token and examine its contents.

4. Paste the Token

• Copy the token that you want to introspect. This could be a token you’ve generated for embedding or a sandbox token.

• Paste the token into the Token Introspection field.

5. View the Token Details

• After pasting the token, click on the Introspect Token button.

• The introspection tool will decode the token and display its contents, including user attributes, roles, and any other associated data.

  • You will be able to see the token's expiration time, user information, and any custom attributes that were added (e.g., location, department).

6. Verify the Token's Information

• Review the token's details to ensure that it contains the correct information and is valid for the intended use.

  • If the token is incorrect or has expired, you can generate a new one.

Conclusion

Congratulations! You have successfully introspected a token in Toucan AI. Token introspection allows you to validate the contents of a token, ensuring that it has the correct attributes and data access rights before using it in your application.