Skip to main content
A Service Account is a non-human identity, such as an agent, that is authorized to interact with Connect AI. Service accounts authenticate via OAuth 2.0 Client Credentials. Use them to grant programmatic access to scripts, jobs, and external services.
Service Accounts
The Service Accounts tab contains the following information:
  • A row for every service account in your account:
    • Name is the service account name.
    • Client Id is the unique identifier used to authenticate the service account via OAuth 2.0 Client Credentials.
    • Status is the status of the service account (active or inactive). If you deactivate a service account, any services or automations using these credentials will fail on the next request. The service account remains in the registry for audit purposes.
    • Created is the date and time the service account was created.
    • Rotate, edit, and delete icons for the service account. When you rotate credentials, the current credentials stop working immediately. You must update dependent services before the next request.

​
Add a Service Account

1
In the Service Accounts tab of the Users page, click Add Account to open the Add Service Account page.
Add a Service Account
2
Enter the Name of the service account.
3
Enter a short Description of the service account.
4
Select an Authentication Type of Client Secret or Public Key. If you select Public Key, you are asked to upload the public key (PEM) file (RS256 or ES256).
5
Click Confirm to save the service account.
6
If you selected Client Secret, an Add Service Account dialog appears. Copy the Client Id and Client Secret. The Client Secret only appears once.
Share these credentials with the developer who will authenticate the service account using OAuth 2.0. See Service Account Setup for details.
7
Click Done. An Edit Service Account page appears.
Edit a Service Account
8
(Optional) Add an Access Role to the service account. Selecting an access role automatically updates the Permissions to the entities below.
9
(Optional) In Permissions, manually select the service account’s permissions to entities (data connections and workspaces) in your Connect AI instance. For more information about permissions, see Permissions and Access Control.

​
Edit a Service Account

You can modify any service account, rotate credentials, or delete a service account at any time by clicking the rotate, edit, or delete icons in the Service Accounts list. In the Edit Service Account page, you can do the following:
  • Edit the Name and Description fields.
  • Add and remove access roles.
  • Manually update permissions.
  • Rotate credentials (the current credentials will stop working immediately).
  • Delete the entire service account.