Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

chore(v2): Explain v1-compatible auth and add a troubleshooting section with a negative example. Putting a bow on #4393. Verified that Kapa.ai knows how to authenticate to v1 endpoints in each version

pull/6188/head
Jason Stirnaman 2025-07-03 14:26:37 -05:00
parent e94257a47a
commit f7a538d2d1
2 changed files with 48 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
content/shared/influxdb-v2/api-guide/api_intro.md
View File

@ -5,9 +5,9 @@ This section guides you through the most commonly used API methods.
For detailed documentation on the entire API, see the [InfluxDB v2 API Reference](/influxdb/version/reference/api/#influxdb-v2-api-documentation).
{{% note %}}
If you need to use InfluxDB {{< current-version >}} with **InfluxDB 1.x** API clients and integrations, see the [1.x compatibility API](/influxdb/version/reference/api/#influxdb-v1-compatibility-api-reference-documentation).
{{% /note %}}
> [!Tip]
> #### Use {{< current-version >}} API with InfluxDB 1.x clients
> If you need to use InfluxDB {{< current-version >}} with **InfluxDB 1.x** API clients and integrations, see the [1.x compatibility guide](/influxdb/version/reference/api/influxdb-1x/).
## Bootstrap your application

48
content/shared/influxdb-v2/api-guide/influxdb-1x/_index.md
View File

@ -10,8 +10,13 @@ InfluxDB 1.x compatibility endpoints require all query and write requests to be
[API token](/influxdb/version/admin/tokens/) or 1.x-compatible
credentials.
* [Authenticate with the Token scheme](#authenticate-with-the-token-scheme)
* [Authenticate with a 1.x username and password scheme](#authenticate-with-a-username-and-password-scheme)
> [!Important]
> #### Authenticate with an API token or 1.x-compatible credentials
> You can't use an InfluxDB 2.x username and password to authenticate with the InfluxDB 1.x compatibility API.
- [Authenticate with the Token scheme](#authenticate-with-the-token-scheme)
- [Authenticate with a 1.x username and password scheme](#authenticate-with-a-username-and-password-scheme)
- [Troubleshoot authentication issues](#troubleshoot-authentication-issues)
### Authenticate with the Token scheme
Token authentication requires the following credential:
@ -259,7 +264,44 @@ Replace the following:
{{% /show-in %}}
##### InfluxQL support
### Troubleshoot authentication issues
#### Unauthorized when using the initial username and password
You can't use the InfluxDB 2.x username and password to authenticate with the InfluxDB 1.x compatibility API.
For example, given the following Docker Compose configuration:
```yaml
# Docker compose example
influx2:
image: influxdb:2.4.0
volumes:
- ./dev/influxdb2:/var/lib/influxdb2
ports:
- "8086:8086"
environment:
DOCKER_INFLUXDB_INIT_USERNAME: dev
DOCKER_INFLUXDB_INIT_PASSWORD: 12345678
DOCKER_INFLUXDB_INIT_ORG: com.some
DOCKER_INFLUXDB_INIT_BUCKET: m2_dev
DOCKER_INFLUXDB_INIT_MODE: setup
```
The following query using the v1 `/query` endpoint and v2 initial username and password returns an `unauthorized` error:
```bash
# Using the initial username and password
curl --get "http://localhost:8086/query" \
--data-urlencode "u=dev" \
--data-urlencode "p=12345678" \
--data-urlencode "db=m2_dev" \
--data-urlencode "q=SELECT * FROM default"
```
Instead, [authenticate with a token](#authenticate-with-the-token-scheme) or a [1.x username and password scheme](#authenticate-with-a-username-and-password-scheme).
## InfluxQL support
The compatibility API supports InfluxQL, with the following caveats: