Create an API token
As a Debusine user
If you have regular user access to Debusine, you can generate your own token.
Automatic enrollment
With debusine-client
version 0.10.0 or newer, you can run debusine
setup
. If the server is one of those listed, you can select its number;
otherwise, select “new” and enter its name or URL. Then select “save” and
follow the prompts to confirm registration.
Manual generation
With older versions of debusine-client
, you need to connect to the web
interface of your Debusine instance (e.g. http://debusine.internal/
or
https://debusine.debian.net/), authenticate yourself, click on “Tokens” on
your user menu at the top right of the page, then follow the instructions to
create a new token.
You can enter a comment to document the expected use of the token and decide if you want to enable it immediately or not. After submission, you will receive the generated token, which you should save immediately as the token won’t be shown again.
As a Debusine administrator
If you are a Debusine administrator, then you can rely on the debusine-admin command to create a new token for any user:
$ sudo -u debusine-server debusine-admin create_token john-smith --comment "Testing Debusine"
The token will be printed to the standard output. The token can then be sent to the user.
Next steps
The token will generally be used to configure the Debusine client.