mirror of
https://github.com/Unleash/unleash.git
synced 2024-12-28 00:06:53 +01:00
c224786f29
Co-authored-by: Ivar Conradi Østhus <ivarconr@gmail.com> Co-authored-by: Fredrik Oseberg <fredrik.no@gmail.com>
47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
---
|
|
id: api-token
|
|
title: API Tokens
|
|
---
|
|
|
|
In order to connect to Unleash clients will need an API token to grant access. A client SDK will need to token with "client privileges", which allows them to fetch feature toggle configuration and post usage metics back.
|
|
|
|
## Create API Token
|
|
|
|
### Permissions
|
|
|
|
To create an API token you'll need the CREATE_API_TOKEN permission level, at the time of writing (v4.0.0), this level is only set for instance admins.
|
|
|
|
Eventually one should be able to customize which users has access to create tokens.
|
|
|
|
All users are able to see tokens with CLIENT level access, but only instance admins can see tokens with ADMIN level access.
|
|
|
|
### Step-by-step
|
|
|
|
**1. Select `Admin` from the sidebar**
|
|
|
|
|
|
|
|
**2. Select `Api Access` from the tab menu**
|
|
|
|
|
|
|
|
**3. Click `Add new API key` at the bottom of the page**
|
|
|
|
**Client keys**
|
|
|
|
4a. If you're configuring an SDK select `Client` in the pop-up. And give the key an identifying name allowing you to recognize it later
|
|
|
|
|
|
|
|
5a. Copy the `Secret` column and add this to your client
|
|
|
|
|
|
|
|
**Admin operations**
|
|
|
|
4a. If you're going to be using the admin interface via CURL you'll need a key with `Admin` rights. Select `Admin` in the `Add new API key` popup.
|
|
|
|
Remember to give the key a username allowing you to recognize the key in audit logs later
|
|
|
|
5a. Copy the key in the `Secret` column and use it in your authorization header. For curl, that would be `-H "Authorization: <yoursecrethere>"`
|