58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
|
|
Use the [`influxdb3 create token --admin` subcommand](/influxdb3/version/reference/cli/influxdb3/create/token/)
|
|
or the [HTTP API](/influxdb3/version/api/v3/)
|
|
to create an [admin token](/influxdb3/version/admin/tokens/admin/) for your {{< product-name omit="Clustered" >}} instance.
|
|
An admin token grants full access to all actions for your InfluxDB 3 instance.
|
|
|
|
> [!Note]
|
|
> #### Store secure tokens in a secret store
|
|
>
|
|
> Token strings are returned _only_ on token creation.
|
|
> We recommend storing database tokens in a **secure secret store**.
|
|
> Anyone with access to the admin token has full control over your {{< product-name >}} instance.
|
|
> If you lose the admin token string, you must regenerate the token.
|
|
|
|
## Create an admin token
|
|
|
|
{{< tabs-wrapper >}}
|
|
{{% tabs %}}
|
|
[CLI](#use-the-influxdb3-cli)
|
|
[HTTP API](#use-the-http-api)
|
|
{{% /tabs %}}
|
|
{{% tab-content %}}
|
|
|
|
Use the `influxdb3 create token --admin` command:
|
|
|
|
```bash
|
|
influxdb3 create token --admin
|
|
```
|
|
|
|
The output contains the token string in plain text.
|
|
|
|
To use the token as the default for later commands, and to persist the token
|
|
across sessions, assign the token string to the `INFLUXDB3_AUTH_TOKEN` environment variable.
|
|
{{% /tab-content %}}
|
|
{{% tab-content %}}
|
|
Use the following endpoint to create an admin token:
|
|
|
|
{{% show-in "core" %}}
|
|
{{% api-endpoint method="POST" endpoint="/api/v3/configure/token/admin" api-ref="/influxdb3/version/api/v3/#operation/PostCreateAdminToken" %}}
|
|
|
|
```bash
|
|
curl -X POST "http://{{< influxdb/host >}}/api/v3/configure/token/admin" \
|
|
--header 'Accept: application/json' \
|
|
--header 'Content-Type: application/json'
|
|
```
|
|
{{% /show-in %}}
|
|
{{% show-in "enterprise" %}}
|
|
{{% api-endpoint method="POST" endpoint="/api/v3/enterprise/configure/token/admin" api-ref="/influxdb3/version/api/v3/#operation/PostCreateAdminToken" %}}
|
|
|
|
```bash
|
|
curl -X POST "http://{{< influxdb/host >}}/api/v3/{{< product-key >}}/configure/token/admin" \
|
|
--header 'Accept: application/json' \
|
|
--header 'Content-Type: application/json'
|
|
```
|
|
{{% /show-in %}}
|
|
{{% /tab-content %}}
|
|
{{< /tabs-wrapper >}}
|