Registration Tokens
>What Are Registration Tokens? |
>New to Sentinel EMS?
>About 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.
An administrator or a standard user with Customer Management permissions or an administrator contact creates and shares registration tokens with the customers and contacts.
A single registration token can be used to create multiple authorizations (auth) tokens. This is useful for administrator contacts who want ease of use by using one registration token to enable multiple users/machines where the licensed applications will run to get their individual auth tokens. Note that it is not necessary to create a registration token for each user/machine.
Prerequisites for Creating a Registration Token
An administrator, or a standard user with Customer Management permissions, can create registration tokens using the vendor portal.
An administrator contact can create a registration token using the customer portal. For more information, see Contacts and the Sentinel EMS Customer Portal User Guide.
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 ID | The customer ID 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 |
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 |
Duplicates an existing registration token, enabling you to edit the copy and create a new registration token. |
|
Enable |
Enables a disabled registration token. |
|
Disable |
Disables a registration token. |
|
Delete |
Deletes a registration token. You can delete the 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 once the required auth tokens are generated. |