API Tokens

In addition to the temporary jwts the API issues on login, it's possible to create persistent access tokens to access the API.  This is also the common way credentials are managed when using the plural CLI, with the plural login command either creating or fetching a recent access token to use for all API calls.
Creating a Token
You can create a token manually using the web interface here: https://app.plural.sh/me/edit/tokens or you can simply run:
1
plural login
2
plural config read
Copied!
to grab the token configured at login.
Token Security
Plural captures access logs for all token usage, including IP information, available by inspecting the token in the access tokens page.  You are also free to revoke a token at any time, although this might require you to rotate the keys used by your plural installations manually, so it's recommended to check the logs for that token before doing so to understand your exposure
Revoking a token while an instance of the plural console is using it will prevent it from receiving upgrades, but once the token is rotated, it will pick back up and apply the upgrades as normal.

Identity and Access Management - Previous

OpenID Connect

Next - Identity and Access Management

Advanced Topics

Last modified 9mo ago

Copy link

Edit on GitHub

Contents

Creating a Token

Token Security