Integrations

Who is this for? Catalog managers and integration administrators who connect Altana to their organization's external systems.

The Integrations tab is where you connect Altana to the systems you run outside of it — pushing events to your endpoints as they happen, and picking up files for screening. It has three areas: Webhooks, Mapping, and SFTP. Availability depends on your tenant configuration; if you don't see the tab, contact your Altana representative.

Open Settings from the user menu and select the Integrations tab.

Webhooks

A webhook delivers Altana events to an endpoint you control. Use the Webhooks tab to register and manage those endpoints. To subscribe a webhook to a catalog's product changes, and for the format of the batches your endpoint receives and the delivery guarantees to build against, see Catalog Subscriptions.

Create a webhook

1. On the Webhooks tab, select Create Webhook.
2. Enter a Name and the URL of your endpoint. The URL must use https://.
3. Choose the HTTP Method (POST, PUT, or PATCH).
4. Choose an Authentication Type and provide its credentials:
   • Bearer Token (JWT/JWKS) — optionally set a JWT audience. Altana signs the request so you can verify it against a public key.
   • Basic Auth — username and password.
   • API Key — the key and, optionally, the header name to send it in (defaults to X-API-Key).
   • OAuth2 Client Credentials — token URL, client ID and secret, and optional scopes.
5. Optionally paste a Custom CA Certificate (PEM) if your endpoint uses a private certificate authority, or use Fetch from URL to retrieve the chain automatically.
6. Select the payload types this webhook should receive. Optionally enable gzip compression.
7. Select Validate to confirm Altana can reach the endpoint, then Create.

Test, edit, or delete a webhook

• Test sends a test request and shows the response, so you can confirm the endpoint is reachable.
• Edit updates any field. Leave a credential field blank to keep the existing secret in place.
• Delete removes the webhook after you confirm.

Mapping

A mapping connects an event to a webhook so that the event is delivered automatically whenever it occurs. Create a webhook first, then map events to it.

1. On the Mapping tab, select Create Dispatch Mapping.
2. Choose the Event to listen for and the Webhook to deliver it to.
3. Set the mapping Active (or leave it disabled to configure it now and turn it on later), then Create.

Each mapping shows its event, target webhook, status, and creation date. Use the row actions to edit or delete a mapping.

SFTP

An SFTP endpoint lets Altana monitor a directory on your file server and pick up files for transaction screening.

Create an SFTP endpoint

1. On the SFTP tab, select Create SFTP Endpoint.
2. Under connection details, enter a Name, Host, and Port (22 by default), and a Username.
3. Choose how to authenticate — Password or SSH Private Key — and provide the credential.
4. Under file monitoring, set the Inbound Path Altana should watch and the File Pattern to match (for example, *.json).
5. Set the Outbound Path where processed files are moved, choose the Data Mapping for the file format, and leave the endpoint Enabled.
6. Optionally enable Delete source after processing, then Create.

Manage SFTP endpoints

Each endpoint lists its host, status, inbound path, and file pattern. Use the row actions to View Files (recent files picked up by the endpoint), Edit the configuration, or Delete the endpoint.