Authentication

Generating User Authentication Tokens

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

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

• Developer Account API Key

• ĀLO 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 ĀLO Authorization Service

POST https://auth.alo.ai/v1/auth
Headers:
- Authorization: Bearer <DeveloperApiKey>
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 ĀLO 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" }

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