A join token is a special-purpose, system generated, alphanumeric string value used to authenticate a virtual on-prem host to automatically associate itself with its corresponding user account and establish a connection to the BloxOne services.
Note: A join token is necessary when you set up a virtual appliance; it is not required for BloxOne physical appliance deployment
To deploy a virtual appliance, you must first create a join token and issue it to the corresponding on-prem host when you set up your machine. You can use the same join token to deploy multiple virtual appliances. You can also create as many join tokens as you need and use them for different purposes. For example, you can create one join token to provision a set of remote devices and assign them to your Cloud Services Portal account. You can create another join token for an admin who will need to join on-prem hosts only for a short period of time. When the admin finishes the task, you can revoke the join token and they will not be able to provision any new hosts. You can also revoke a token if a join token has been compromised for any reason to prevent its use to provision new on-prem hosts. A host cannot establish a new connection to the cloud if you use a revoked token; however, it keeps an existing connection. Note that join tokens are valid until you revoke them through the Cloud Services Portal.
The Manage > Infrastructure > Join Tokens page displays the following information for each join token you have created:
TOKEN NAME: The name of the token.
STATUS: The current status of the token. This can be Active or Revoked.
COUNT: The number of times you have used this token to set up your virtual appliances. You can reuse the same token multiple times for different virtual appliances. This number is useful for security purposes. For example, if you have given a join token for a certain number of appliances using this token for connection, which does not match the number showing here, you might want to review the appliances that join your network.
LAST USED: The timestamp when the token was last used, in mm/dd/yy hh:mm:ss time zone format.
DESCRIPTION: Information about the join token.
For more information about join tokens, see the following: