Merge pull request #141 from influxdata/update/manage-tokens

Update manage tokens
pull/154/head
Scott Anderson 2019-04-10 12:10:34 -06:00 committed by GitHub
commit 0d753723f4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 75 additions and 20 deletions

View File

@ -1,7 +1,7 @@
---
title: Create a token
seotitle: Create an authentication token in InfluxDB
description: Create an authentication token in InfluxDB using the InfluxDB UI or the influx CLI.
description: Create an authentication token in InfluxDB using the InfluxDB UI or the `influx` CLI.
menu:
v2_0:
name: Create a token
@ -10,20 +10,37 @@ weight: 201
draft: true
---
**To view tokens**:
Create authentication tokens using the InfluxDB user interface (UI) or the `influx`
command line interface (CLI).
1. Click the **Influx** tab in the navigation bar.
## Create a token in the InfluxDB UI
{{< nav-icon "admin" >}}
1. Click the **Settings** icon in the navigation bar.
2. In the right panel labeled **My Settings**, click **Tokens**. All of your account's tokens appear.
3. Click on a token name from the list to view the token and a summary of access permissions.
{{< nav-icon "settings" >}}
2. Click **Tokens**.
3. _Full instructions coming soon._
**To copy a token**:
## Create a token using the influx CLI
* From the token detail view, click **Copy**.
Use the [`influx auth create` command](/v2.0/reference/cli/influx/auth/create) to create a token.
Include flags with the command to grant specific permissions to the token.
See the [available flags](/v2.0/reference/cli/influx/auth/create#flags).
**To delete a token**:
```sh
# Pattern
influx auth create -o <org-name> [permission-flags]
* Hover over the name of a token in the list, then click **Delete**.
# Example
influx auth create -o my-org \
--read-buckets 03a2bbf46309a000 03ace3a87c269000 \
--read-dashboards \
--read-tasks \
--read-telegrafs \
--read-user
```
Filtering options such as filtering by authorization ID, username, or user ID are available.
See the [`influx auth find` documentation](/v2.0/reference/cli/influx/auth/find)
for information about other available flags.

View File

@ -0,0 +1,38 @@
---
title: Delete a token
seotitle: Delete an authentication token from InfluxDB
description: Delete an authentication token from InfluxDB using the InfluxDB UI or the `influx` CLI.
menu:
v2_0:
name: Delete a token
parent: Manage tokens
weight: 204
---
Delete authentication tokens from the InfluxDB user interface (UI) or the `influx` command line interface (CLI).
Once deleted, all users and external integrations using the token will no longer
have access to your InfluxDB instance.
## Delete tokens in the InfluxDB UI
1. Click the **Settings** icon in the navigation bar.
{{< nav-icon "settings" >}}
2. Click **Tokens**. All of your account's tokens appear.
3. Hover over the token you want to delete and click **Delete** and **Confirm**.
## Delete tokens using the influx CLI
Use the [`influx auth delete` command](/v2.0/reference/cli/influx/auth/delete)
to delete a token.
_This command requires an auth ID, which is available in the output of `influx auth find`._
```sh
# Pattern
influx auth delete -i <auth-id>
# Example
influx auth delete -i 03a2bee5a9c9a000
```

View File

@ -1,7 +1,7 @@
---
title: View tokens
seotitle: View authentication tokens in InfluxDB
description: View authentication tokens in InfluxDB using the InfluxDB UI or the influx CLI.
description: View authentication tokens in InfluxDB using the InfluxDB UI or the `influx` CLI.
menu:
v2_0:
name: View tokens
@ -9,16 +9,16 @@ menu:
weight: 202
---
Use the InfluxDB user interface (UI) or the `influx` command line interface (CLI)
to view tokens.
View authentication tokens using the InfluxDB user interface (UI) or the `influx`
command line interface (CLI).
## View tokens in the InfluxDB UI
1. Click the **Influx** icon in the navigation bar.
1. Click the **Settings** icon in the navigation bar.
{{< nav-icon "admin" >}}
{{< nav-icon "settings" >}}
2. In the right panel labeled **My Settings**, click **Tokens**. All of your account's tokens appear.
2. Click **Tokens**. All of your account's tokens appear.
3. Click on a token name from the list to view the token and a summary of access permissions.
## View tokens using the influx CLI

View File

@ -1,4 +1,4 @@
{{ $icon := .Get 0 | default "nav-admin" }}
{{ $icon := .Get 0 | default "influx" }}
{{ if or (eq $icon "nav-admin") (eq $icon "influx") (eq $icon "influx-icon") }}
<span class="inline icon-ui-influx-icon middle"></span>

View File

@ -1,7 +1,7 @@
{{ $navIcon := lower (.Get 0) | default "admin" }}
{{ if eq $navIcon "admin" }}
{{ $navIcon := lower (.Get 0) | default "influx" }}
{{ if or (eq $navIcon "admin") (eq $navIcon "influx") }}
{{ .Scratch.Set "icon" "influx-icon" }}
{{ .Scratch.Set "title" "admin" }}
{{ .Scratch.Set "title" "username (org-name)" }}
{{ else if or (eq $navIcon "data-explorer") (eq $navIcon "data explorer") }}
{{ .Scratch.Set "icon" "data-explorer" }}
{{ .Scratch.Set "title" "Data Explorer" }}