Create an Aisera Service Account (Optional)
You can generate a webhook URL with Basic authentication using a Service Account in the Aisera platform and an x-app-token.
With many of the default (already mapped) system integrations, you need to create an account on the system you want to integrate with so that the Aisera application can log into that system. You can use a Aisera Service Account as the user account that logs into the integrated system. For many use cases, this account will only need Read permissions (with export ability) to the mapped fields on your integrated system, so that the system data can be read into the Aisera DB and anonymized before operations are performed. For some use cases - where you want results written back to the source after operations are performed, this account may need Read/Write permissions (with import ability).
To Create a Service Account:
Navigate to Settings > User Accounts.
Click on New User Account and provide the required details, such as a preferred email address (used as the username for Basic authentication), password, and select Service Account as the login role. The account name can be any combination of letters and numbers, because it is stored as a String.
User Account Details
Once the account is created, use the username and password of the Service Account, along with an x-app-token to authenticate and generate a URL within the Aisera tenant.
You'll then need to access any pod to retrieve Service Account user's Basic authentication token for the request. This should only be done by Aisera employees, and they can look up the Aisera server command to return the Base64-encoded token using the internal Confluence system. This will return an encrypted username:password combination the you can add after the ?key={ characters in the example URL in the following section.
Get the app-token:
Make sure your Data Source is set as the System of Record (SOR) in your application's Detail window. If it isn't, toggle the SOR switch to the ON position, as shown below. Then refresh your window and you will be able to see the encrypted x-app-token associated with your Data Source.
Copy the token from the App Token field and paste it into the URL in the brackets at the end.
Create the URL:
Create the URL in the following format:
https://{tenant_url}/{tickets_type}?key={authorization_param}&apptoken={appToken}where: authorization_param: your encrypted Service Account credentials, returned by the Aisera server
appToken: the encrypted token in the App Token field of the Integration Information section of your applications Details page.
Last updated