Authenticate with a service account
Use Basic or Bearer authentication when accessing APIs with a service account
読み終わるまでの所要時間 1 分最終更新 1ヶ月前
You can use either Basic or Bearer authentication to access Unity service API endpoints with a service account. In both cases, use a key ID as the client name and the matching secret as the client secret. Don't use the service account name or its UUID to authenticate.
All keys that belong to the same service account are interchangeable and resolve to the same service account. Read more about managing keys for a service account.
Bearer token authentication
To use Bearer authentication, first obtain a JWT token for the service account, and then pass it in the header of your API request. To obtain the token, follow the standard OAuth 2.0 Client Credentials flow by sending an HTTP POST request to the Keycloak token endpoint:
Authorizationhttps://<SolutionFQDN>/auth/realms/unity/protocol/openid-connect/token
Replace with the fully qualified domain name (FQDN) of the solution.
<SolutionFQDN>Example
The following sample request uses cURL to obtain a JWT token:
curl --request POST \ --url 'https://<SolutionFQDN>/auth/realms/unity/protocol/openid-connect/token' \ --header 'content-type: application/x-www-form-urlencoded' \ --data grant_type=client_credentials \ --data client_id=<KeyId> \ --data client_secret=<Secret>
Replace the and strings with the ID and the secret of one of the keys that were created for the service account.
<KeyId><Secret>