Merge pull request #6069 from influxdata/6056-fix-auth-token-env-var-docs

Clarify token usage and add CLI/HTTP auth examples

Author: MeelahMe

content/shared/influxdb3-admin/tokens/_index.md

@@ -1,4 +1,66 @@
-Manage tokens to authenticate and authorize access to resources and data in your
-{{< product-name >}} instance.
+Manage tokens to authenticate and authorize access to resources and data in your {{< product-name >}} instance.
+
+## Provide your token
+
+Before running CLI commands or making HTTP API requests, you must provide a valid token to authenticate.
+The mechanism for providing your token depends on the client you use to interact with {{% product-name %}}--for example:
+
+{{< tabs-wrapper >}}
+
+{{% tabs %}}
+[influxdb3 CLI](#influxdb3-cli-auth)
+[cURL](#curl-auth)
+{{% /tabs %}}
+
+{{% tab-content %}}
+
+When using the `influxdb3` CLI, you can use the `--token` option to provide your authorization token.
+
+{{% code-placeholders "YOUR_TOKEN" %}}
+```bash
+# Include the --token option in your influxdb3 command
+influxdb3 query \
+  --token YOUR_TOKEN \
+  --database example-db \
+  "SELECT * FROM 'example-table' WHERE time > now() - INTERVAL '10 minutes'"
+```
+{{% /code-placeholders %}}
+
+You can also set the `INFLUXDB3_AUTH_TOKEN` environment variable to automatically provide your
+authorization token to all `influxdb3` commands.
+
+{{% code-placeholders "YOUR_TOKEN" %}}
+```bash
+# Export your token as an environment variable
+export INFLUXDB3_AUTH_TOKEN=YOUR_TOKEN
+
+# Run an influxdb3 command without the --token option
+influxdb3 query \
+  --database example-db \
+  "SELECT * FROM 'example-table' WHERE time > now() - INTERVAL '10 minutes'"
+```
+{{% /code-placeholders %}}
+
+Replace `YOUR_TOKEN` with your authorization token.
+
+{{% /tab-content %}}
+
+{{% tab-content %}}
+
+{{% code-placeholders "AUTH_TOKEN" %}}
+```bash
+# Add your token to the HTTP Authorization header
+curl "http://{{< influxdb/host >}}/api/v3/query_sql" \
+  --header "Authorization: Bearer AUTH_TOKEN" \
+  --data-urlencode "db=example-db" \
+  --data-urlencode "q=SELECT * FROM 'example-table' WHERE time > now() - INTERVAL '10 minutes'"
+```
+{{% /code-placeholders %}}
+
+Replace `AUTH_TOKEN` with your actual InfluxDB 3 token.
+
+{{% /tab-content %}}
+
+{{< /tabs-wrapper >}}
 
 {{< children hlevel="h2" readmore=true hr=true >}}

content/shared/influxdb3-admin/tokens/admin/list.md

@@ -8,8 +8,12 @@ data and resources in your InfluxDB 3 instance.
 > Token metadata includes the hashed token string.
 > InfluxDB 3 does not store the raw token string.
 
-In the following examples, replace {{% code-placeholder-key %}}`AUTH_TOKEN`{{% /code-placeholder-key %}} with your InfluxDB {{% token-link "admin" %}}
-{{% show-in "enterprise" %}} or a token with read permission on the `_internal` system database`{{% /show-in %}}.
+> [!Important]
+> #### Required permissions
+>
+> Listing admin tokens requires a valid InfluxDB {{% token-link "admin" %}}{{% show-in "enterprise" %}} or a token with read access to the `_internal` system database{{% /show-in %}}.
+> For more information about providing a token, see [provide your token](/influxdb3/version/admin/tokens/#provide-your-token).
+
 
 ## List all tokens