[DOC] Update Authentication topic #4823
Open
+96
−57
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
JiriCtvrtka
reviewed
Dec 10, 2025
Comment on lines
+46
to
+56
| 1. Log into PMM. | ||
| 2. From the side menu, click **Administration > Users and access**. | ||
| 3. Click on the **Service accounts** card. | ||
| 4. Click **Add service account**. Specify a unique name for your service account, select a role from the drop-down menu, and click **Create** to display your newly created service account. | ||
| 5. Click **Add service account token**. | ||
| 6. In the pop-up dialog, provide a name for the new service token, or leave the field empty to generate an automatic name. | ||
| 7. Optionally, set an expiration date for the service account token. PMM cannot automatically rotate expired tokens, which means you will need to manually [update the PMM-agent configuration file](../use/commands/pmm-agent.md) with a new service account token. Permanent tokens remain valid indefinitely unless specifically revoked. | ||
| 8. Click **Generate Token**. A pop-up window will display the new token, which usually has a `glsa_` prefix. | ||
| 9. Copy your service token to the clipboard and store it securely. | ||
|
|
||
| Now you can use your new service token for authentication in PMM API calls or in your [pmm-agent configuration](../use/commands/pmm-agent.md). |
Contributor
There was a problem hiding this comment.
We should mention that when a new PMM client is added, a service account with a service token is created automatically. Like users dont need to do this manually if there is no other reason.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
PMM-0
Link to the Feature Build: SUBMODULES-0
If this PR adds, removes or alters one or more API endpoints, please review and add or update the relevant API documentation as well:
If this PR is related to some other PRs in this or other repositories, please provide links to those PRs: