The Personal Tokens option is only available on the User Settings menu when using a non-Global repository.
The instructions below apply to XRay versions 1.6 through Track version 11.1 and Track version 11.2. For version 1.5 instructions, see Personal Tokens (v1.5) below.
Access Tokens v11.2 (Admin Settings or User Settings)
Select User Settings > Personal Tokens from the left toolbar.
For further information, refer to Access Tokens v1.6 and later (Admin Settings or User Settings).
Access Tokens v1.6 to v11.1 (Admin Settings or User Settings)
Users define and generate their own access tokens, or personal tokens, for the following scenarios:
- For yourself:
- Generate a token to be able to import data into a repository
- For others:
- Give someone else the right to stream data to your repository. This might be a 3rd party that you want to collect data from. Once they have provided the required data, you can set an Expire Time or remove the token to discontinue streaming access.
To set up an access token:
- Click Create.
- (Optional.) Enter a Token prefix to identify the type of token, if needed.
- Select the Repositories to which the token provides access. You can choose individual repositories, one at a time. (To remove a selection, click the X provided for that repository.)
- (Optional.) To set up the token to expire, use the Expire Time field to select a specific date and time.
- Update the Token Options as needed. By default, all objects are selected (the Select all checkbox is selected). You can clear the checkbox to choose individual items, one at a time. See Token Options below for a list of objects.
- Query (for getting data). Allows a user to access the repository data.
- Modify Allows users to modify non-administrative data in the repository. This includes the ability to both add and update items.
- Delete Allows users to delete non-administrative data in the repository
- Admin allows users to manipulate administrative data only (that is, the following items): Users, Organizations, Teams, Repositories, and Tokens (listed as "AccessTokens").
- Execute allows users to use Invoke commands (to invoke scripts, actions, or external actions).
- Click Create.
Token Options
Items marked with asterisks below are administrative items. These are controlled by the Admin token option.
Source Geolocation Address Server Process AppServer Application SourceUser Runtime VirtualSource Network Device DataCenter GenericSource Event Activity Resource Set Snapshot Dictionary Relative Variable Topic IpLocation Enumeration Item Value Field User* Organization* |
Team* Repository* AccessToken* Word Job Log DATASTORE Provider Action Trigger InputDataRules BayesSourceFields Parameter Keyword Function ProviderType Query Dataset Script Policy PolicyManager Sensor SensorFact MLModel License QuotaUsage View ViewTemplate Volume Feature |
Personal Tokens (v1.5)
Go to Main Menu > User Settings > Personal Tokens to view all tokens. Maintain existing tokens and generate new tokens with unique QR codes for repositories.
When Stream status is set to Active, real-time data will be supported. When Query status is set to Inactive, API users using this token will not have the ability to run queries.
To generate a new token with a unique QR code for a repository, from the bottom of the window select a repository from the Repositories drop-down menu and click Generate token.
Click on the blue square icon immediately to the left of the token code to display the QR code.