Fenris Digital Authentication Documentation

Download OpenAPI specification:Download

Introduction

Fenris Digital restricts access to its APIs and manages access tokens through an OAuth2 authorization server. The Client Credentials workflow defined by the OAuth 2 specification is the principal token manager. You will receive a Client-Id and Client Secret used to obtain an access token from the Authorization Server.

Code Samples

We provide example code for using Fenris' AWS Cognito-based authentication API to fetch a token for making later requests.

Samples are currently available in Python, JavaScript, Java, C#, and Ruby.

You can download the current code samples here .

Authentication

Obtain a token.

Returns an authentication token.

header Parameters
Content-Type
string
Example: application/x-www-form-urlencoded
Authorization
string
Example: Basic<<BASIC_STRING>>

The BASIC_STRING is the Base-64 encoding of the cliient_id and client_secret separated by a colon. This is the standard token passed for Basic authentication with username replaced by client_id, and password replaced by client_secret. Many libraries will do this for you if you select basic authentication and set the username to your client_id and set the password to the client_secret.

Request Body schema: application/x-www-form-urlencoded
required
client_id
required
string

A client ID obtained from Fenris Digital.

grant_type
required
string

The type of token to be granted.

Responses

Response Schema: */*
token_type
string

The type of security token being returned. This will always be a bearer token.

expires_in
string

The remaining ammount of time the token will be valid for in seconds. Note: Access tokens are good for one day before they must be refreshed. You must submit another call to obtain a new token after the previous one expires.

access_token
string

The value to be used as a Bearer token in the Authorization header of the request.

Request samples

Content type
application/x-www-form-urlencoded
client_id=OBTAIN_FROM_FENRIS&grant_type=client_credentials