Authentication

Generate user authentication tokens securely for ALO SDK access using your Developer API Key and user credentials.

Generating User Authentication Tokens

When using ALO SDKs you will need to provide an authentication token for each of your ALO users that will need access to the ALO Cloud Platform.

You should generate user authentication tokens in a server side function so that you do not expose your ALO Developer API Key in client side code.

In order to generate a token for a given user you will need the following:

• Developer Account API Key

• ALO Cloud user id for the user that needs access. See the User API for information on obtaining user information.

To get a token you must perform a POST a request to the ALO Authorization Service

POST https://auth.alo.ai/v1/auth
Headers:
- Authorization: Bearer <DEVELOPER API KEY>
Payload:
- ttl
- user

Authentication Payload

Payload Key	Type	Required	Default	Description
ttl	integer	No	1440	Time in minutes for which granted access is valid. Min is 1, Max is 525600.
user	object	Yes		A collection of custom private claims used to share information with ALO

User Schema

Key	Type	Required	Description
id	string	Yes	Unique ALO Cloud ID for the user to grant access to

Example

POST https://auth.alo.ai/v1/auth
Headers:
- Authorization: Bearer jjPP43dkEJHzzzlIYSGVt8HE5xOAtz1
Payload:
- user: { id: "A744d43X-3316-56f7-a6a3-99ecbbd44agg" }
- ttl: 60

Response:

{ token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwSJRMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" }