Authentication

When calling the Event Notification Service REST API, an Event Notification Service REST API user must authenticate themselves, using the /authenticate endpoint. The Event Notification Service REST API user passes their credentials to the /authenticate endpoint, which creates a JSON Web Token (JWT) that can be used to authorize access to any endpoint of the Event Notification Service REST API. Credentials are a Base64-encoded combination of the Event Notification Service REST API user’s user name and password separated by a colon (:).

Note:The /authenticate endpoint is not added to the base URL. Instead, depending on your AWS instance, use one of the following URLs for authentication:

https://<siteID>-uat.flexnetoperations.eu/notifications/api/v1/authenticate

https://<siteID>-uat.flexnetoperations.com/notifications/api/v1/authenticate

where <siteID> is your organization’s site ID which is supplied by Revenera. For production environments, omit "‑uat". For more information on <siteID>, see About Your Site ID.

The following sections describe the main steps involved in authentication:

•

Step 1: Providing FlexNet Operations Credentials

•

Step 2: Providing a JWT

Step 1: Providing FlexNet Operations Credentials

The following procedures explain how to provide credentials, including an example for each step.

To provide FlexNet Operations credentials

1.

Concatenate the user name and password with a single colon.

Example: If the user name is "serviceuser@revenera.com" and the password is "password", the resulting concatenated string would be serviceuser@revenera.com:password.

2.

Base64 encode the concatenated user name and password.

Example: Base64 encode the string serviceuser@revenera.com:password to obtain "c2VydmljZXVzZXJAcmV2ZW5lcmEuY29tOnBhc3N3b3JkCg=="

3.

Add either "Fno" or "Basic" before the Base64-encoded string.

Examples:
Fno c2VydmljZXVzZXJAcmV2ZW5lcmEuY29tOnBhc3N3b3JkCg==

Basic c2VydmljZXVzZXJAcmV2ZW5lcmEuY29tOnBhc3N3b3JkCg==

4.

Make a POST call to the /authenticate endpoint, where you add the "Authorization" key to the header of the request, with the Base64-encoded result as the value.

Example: Add the value "Basic c2VydmljZXVzZXJAcmV2ZW5lcmEuY29tOnBhc3N3b3JkCg==" (or
"Fno c2VydmljZXVzZXJAcmV2ZW5lcmEuY29tOnBhc3N3b3JkCg==") to the Authorization header.

The response will include a JWT, which Event Notification Service REST API users can use to authenticate themselves when calling any endpoint of the Event Notification Service REST API.

Step 2: Providing a JWT

When accessing any endpoint of the Event Notification Service REST API, users authenticate themselves by including the JWT (generated in Step 1: Providing FlexNet Operations Credentials) in the header of the request. The validity of the JWT is 60 minutes.

To provide a JWT

1.

Call the desired endpoint.

2.

Add the “Authorization” key to the header of the request, with the JWT as the value, so that it resembles this example:

Authorization: Bearer

eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE1NTcwOTEwOTl9.PMMvCRlOkTCtS1pDIKzEHIvEjIctvc5RrN2keQCU5AUp-tg1ekIXOOtuaHKZJEfVFdmZqvDulI47t5_vcB_VeFbl2QQirvzkrg1YHbyZMLmc_jMSSsgAqvSlaz83jOU7lJvF_bZl_xv5O3jb5MJDoD6v4Miuc-J46hJGe4UvEc