How to set up Anomalo

Atlan supports the API authentication method for fetching metadata from Anomalo. This method uses an API key to fetch metadata.

Your Anomalo Deployment Admin Superuser must also configure a webhook in Anomalo to send events to Atlan when your checks run in Anomalo. This will update the check metadata in Atlan in real time.

Generate an API key

You will need to create an API key in Anomalo for integrating with Atlan.

To create an API key for crawling Anomalo:

1. Log in to your Anomalo instance.
2. From the left menu of your Anomalo instance, click Settings.
3. On the Settings page, in the Account tab, change to the API keys tab.
4. On the API keys page, to generate a new API key:
   • If you have existing API keys, click the Add an API key button.
   • If you do not have any API keys, click the Create an API key button.
5. In the New API Key dialog, enter the following details:
   1. For Description, add a meaningful description for your API key — for example, Atlan connection.
   2. For Expiration, keep the default selection or select a preferred option.
   3. Click Save to finish creating the API key.
6. From the corresponding screen, copy the API Key value and store it in a secure location.
   🚨 Careful! The API key cannot be retrieved later. You must copy the key value before closing the dialog box.

Configure a webhook

As a Deployment Admin Superuser, you will need to create a webhook in your Anomalo instance to send real-time notifications to Atlan. You will need the following:

• URL of your Atlan instance
• API token generated in Atlan

To configure a webhook:

1. Log in to your Anomalo instance as a Deployment Admin Superuser.
2. Navigate to /admin/main/notificationchannel/add/ to add a new webhook notification channel.
3. Next to Notification channels in the left menu, click + Add.
4. In the Add notification channel form, configure the following:
   1. For Organization, select the organization for which you want to configure a webhook in Anomalo.
   2. Click the is default checkbox to allow the webhook to be added to all tables by default.
   3. From the Channel type dropdown, select Webhook.
   4. For Config, paste the following code in a JSON string format:

      {
        "to": "https://<atlan_instance>/events/anomalo", 
        "always_send": true, 
        "custom_headers": { 
          "Authorization": "Bearer <API_KEY>",
         }
      }

      • Replace <atlan_instance> with the URL of your Atlan instance.
      • Replace <API_KEY> with the API token you generated in Atlan.
   5. For Description, add a meaningful description for your notification channel — for example, Atlan webhook.
   6. For Deliver real time, click Yes to enable it.
   7. For Deliver digest, click No to disable it.
   8. At the bottom of the form, click Save to save your configuration.