Registration Tokens

>What Are Registration Tokens?

>Prerequisites for Creating a Registration Token

>Registration Token Status

>Adding a Registration Token

>Actions for Registration Tokens

 

>New to Sentinel EMS?
See How to Use Sentinel EMS?

>About Authorization (Auth) Tokens
See Authorization (Auth) Tokens

What Are Registration Tokens?

A registration token is a bootstrap token that enables licensed applications to get their individual auth tokens and together they support token-based authentication in order to consume licenses as per the Connected (Cloud LM) deployment mode. Token-based authentication ensures that each request to the RMS Cloud License Manager is accompanied by a token. The RMS Cloud License Manager verifies the token before sending the response.

A Sentinel EMS administrator, a vendor user with Customer Management permissions, or a customer's administrator user creates and shares registration tokens with customers and end users.

A single registration token can be used to create multiple authorizations (auth) tokens. This is useful for customer administrator users who want ease of use by using one registration token to enable multiple users or machines where the licensed applications will run to get their individual auth tokens. There is no need to create a registration token for each user and machine.

Prerequisites for Creating a Registration Token

Sentinel EMS vendor portal: A role that includes Customer Management permissions. At minimum, you need the Add permission. For details, see Roles.

Sentinel EMS customer portal: The customer portal user must be a customer's administrator user. For details, see Users and the section on registration tokens in the Guide to the Sentinel EMS Customer Portal.

Registration Token Status

The Status attribute for a registration token can be one of the following:

>Enabled: The registration token is enabled and can be used to create auth tokens.

>Disabled: The registration token is disabled and cannot be used to create auth tokens. To edit the token, you must enable it.

>Expired: The allotted time for the registration token ended. The registration token is listed as enabled but cannot be edited.

Adding a Registration Token

From the navigation pane in the vendor portal, select Customers > Registration Tokens to view the Registration Tokens page. The Add Registration Token button on this page is used to create a registration token using the page given below:

Registration Token Attributes

The following table explains the attributes that are used to create a registration token:

Attribute Description Required/Optional Valid Values
Customer

The customer for whom the registration token is generated.

Note: The Add Customer button is displayed only if the logged-in user is associated with a single market group.

Required

>Alphanumeric

>1 to 200 characters

Customer Identifier The customer identifier defined in Sentinel EMS for the specified Customer is displayed automatically. This field is disabled and cannot be modified.

Required

Read-only

Expiration Date

The date after which the registration token cannot be used. You can extend the expiration date for up to 30 days from the current date.

You can also shorten the validation period by decreasing the date to the current date plus one day (tomorrow). For example, if today's date is 06/15/2024, the earliest expiration date is 06/16/2024.

Optional

Date in MM/DD/YYYY format

Maximum value: 30 days from the current date

Default value: 7 days from the current date

Identifier

The name that identifies the registration token for ease of use.

You can use the same identifier for multiple customers but you cannot repeat the same identifier for the same customer.

If you do not enter an identifier, the system generates an identifier automatically.

Optional

>Alphanumeric

>1 to 100 characters

Count The number of authorization (auth) tokens that can be generated for the registration token Required

Minimum value: 1

Maximum value: 1,000,000

Additional Attributes

Ref ID 1 Reference identifier that identifies the registration token in an external system. Optional

>Alphanumeric

>0 to 100 characters

Ref ID 2 Reference identifier that identifies the registration token in an external system. Optional

>Alphanumeric

>0 to 100 characters

Actions for Registration Tokens

The following table lists the actions available for registration tokens:

Action Description
Edit button Edit

Updates existing registration token information. You can edit a registration token up to 30 days from the current date. This enables you to extend or shorten the registration token validation period, for example.

For details on editing registration tokens, see Editing an Entity.

  View Auth Tokens

Lists all the authorization (auth) tokens for the selected registration token.

Copy button Copy

Duplicates an existing registration token, enabling you to edit the copy and create a new registration token.

Enable button Enable

Enables a disabled registration token.

Disable button Disable

Disables a registration token.

Delete button Delete

Deletes a registration token.

You can delete a registration token even when the auth tokens created using this registration token are in use. This is because there is no role for registration tokens after the required auth tokens are generated.