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.
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 |
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 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. |