Custom Authentication Connection

Description

Custom Authentication is a connection type that allows you to set custom HTTP headers for API requests, including the pre-configured Authorization header. This solution provides flexibility in configuring and sending API requests, as well as supports validation and error handling.

With this connection type, you can link the Altcraft platform to any external service that requires custom HTTP headers for authentication or other purposes, including API requests with keys in the header.

Where the connection is used:

• Node "API call". You can use it to transfer information from the scenario to the connected service or, conversely, request API content from the service. It's useful when you need to transfer data from a captured profile in the scenario to a CRM system.

• Action Hooks. The event capture mechanism allows you to pass information about an event and the associated profile data to an external service.

• Import data on a schedule in the Market. Custom Authentication can be used to set up a connection to an external product feed.

How to create a connection

Go to Settings — Connections and select the connection type Custom Authentication:

A list of all configured Custom connections will appear. To add a new one, click + Create.

Enter a name for the new connection and, if necessary, add a description. Then add the desired headers and specify their values. You can select headers from the dropdown list or enter your own.

Forbidden headers

Some system headers are forbidden to add, as their use may cause issues with the connection. The list of these headers:

• "Host"
• "Connection"
• "Keep-Alive"
• "Accept-Encoding"
• "Content-Length"
• "Transfer-Encoding"
• "Trailer"
• "Upgrade"
• "Date"
• "Location"
• "Server"

If you want to provide access only to a specific service, specify its URL in the Allowed URL field:

Save the connection using the buttons in the upper right corner. Connection settings can be changed at any time. To do this, click Edit.