Introduction

The recommended way to use the dtect Security API is by generating a Security Token. This approach offers enhanced security by allowing your backend system to securely retrieve the corresponding Security Result from our API endpoint. Using a Security Token adds an extra layer of protection against client-side manipulation.

Generating a Security Token

Use the getSecurityToken() function provided by our Frontend SDK to generate a Security Token. This function is available in all versions of the SDK. See the Frontend SDK documentation for detailed instructions and code examples.

Retrieving the Security Result

To retrieve the Security Result associated with a Security Token, make a request to our Retrieve Security Result with Security Token endpoint. This request must be made from your backend server.

Required Parameters:

token: The Security Token generated by the getSecurityToken() function.

x-api-key: Your Server API Key. This key authenticates your backend with our API.

client-id: Your Server Client ID. This ID identifies your application.

Obtaining API Credentials:

You can create and manage your Server API Keys and Server Client IDs in the Server Keys section of our Dashboard. Click here to learn more about API Credentials.

API Reference:

For detailed information about the Retrieve Security Result with Security Token endpoint, including request/response formats and error codes, please refer to the API Reference.

Benefits of the Security Token Approach:

Enhanced Security: Sensitive security data is never directly exposed in the user's browser.

Data Integrity: The Security Token ensures that the Security Result is retrieved from our API without modification.

Centralized Control: Managing security policies and access control on the server-side provides greater control and flexibility.

Generating a Security Token#

Retrieving the Security Result#

Generating a Security Token

Retrieving the Security Result