Registration Tokens
A registration token enrolls the SparkLogs Agent during install. It scopes the agent to one workspace and one organization subtree (the token's organization and its children).
- Re-displayable. You can view a token again after creating it.
- Revocable. Revoke a token to stop new enrollments with it. Existing agents keep running.
- Expiry. Set an optional expiry so a token stops working after a date.
Token to organization relationship
Agents register under the token's organization. In client-org mode, each endpoint instead lands in an auto-created or linked child organization under that token's organization, keyed by the client identifiers you pass at install. See Deployment scope for how the token's organization combines with the install properties.
A device that enrolls again after a wipe returns to its device record when that record is in the organization the install lands in. A token never takes over, moves or reveals a device record that belongs to another organization: the endpoint enrolls as a new device in the organization the install lands in. See Agent identity and cloning.
Manage tokens in Configure > Agents
Create, label, set expiry, view, revoke, and delete tokens from Configure > Agents:
- Open Configure in the sidebar, then the Agents tab.
- Select the organization the token should belong to.
- Create a token, give it a label, and set an optional expiry.
- View, revoke, or delete a token from the same list.
Managing registration tokens on an organization needs the Administrator, Organization Administrator, Engineer or Deployment Manager role there. See Users, roles and groups.