Create a Service Account

Service accounts enable services to securely authenticate themselves and obtain access to MIRACL Trust’s back-end APIs.

These accounts are similar to user accounts in terms of permissions. However, unlike user accounts, service accounts are non-interactive and do not require user input or login.

Each service account is linked to a specific project and can only access resources associated with that project. This ensures that service accounts are scoped appropriately and cannot access data or services outside their assigned project.

Each service account is assigned a token by MIRACL Trust. This token must be included in the Authorization header of API requests, using the standard Bearer token format:

Authorization: "Bearer <YOUR_SERVICE_ACCOUNT_TOKEN>"

If a service account is deactivated, its token is immediately invalidated and can no longer be used to authenticate requests.

To create a service account:

  1. Go to your project in the MIRACL Trust Portal.

  2. In the Configuration section, select Accounts.

  3. Click Add Service Account.

  4. Enter a name for the service account.

  5. Assign permissions by selecting the appropriate checkboxes.

  6. Select account status - Active Account or Inactive Account.

  7. Click Save. The service account token is displayed.

  8. Important: Copy and securely save the token now as it will not be shown again.

  9. Click I have copied the token. The service account is now added to the list of accounts.

To change the permissions and/or status of an existing service account:

  1. Locate the service account in the Accounts list.
  2. Click Manage.
  3. Adjust the permissions and/or status as needed.
  4. Click Save.