mirror of
https://github.com/grafana/grafana.git
synced 2025-07-27 21:42:13 +08:00
13cf67de53
* manually replce all shared relrefs * relref replace - grafana next * Merge branch 'master' into robbymilo/relref-replace-grafana-next * manual fixes * remove ref shortcode * Merge branch 'master' into robbymilo/relref-replace-grafana-next * prettier * fix test * update readme
136 lines
2.9 KiB
Markdown
136 lines
2.9 KiB
Markdown
---
|
|
aliases:
|
|
- ../../http_api/auth/
|
|
- ../../http_api/authentication/
|
|
canonical: /docs/grafana/latest/developers/http_api/auth/
|
|
description: Grafana Authentication HTTP API
|
|
keywords:
|
|
- grafana
|
|
- http
|
|
- documentation
|
|
- api
|
|
- authentication
|
|
labels:
|
|
products:
|
|
- enterprise
|
|
- oss
|
|
title: 'Authentication HTTP API '
|
|
---
|
|
|
|
# Authentication API
|
|
|
|
The Authentication HTTP API is used to manage API keys.
|
|
|
|
{{% admonition type="note" %}}
|
|
Grafana recommends using service accounts instead of API keys. For more information, refer to [Grafana service account API reference](../serviceaccount/).
|
|
{{% /admonition %}}
|
|
|
|
> If you are running Grafana Enterprise, for some endpoints you would need to have relevant permissions. Refer to [Role-based access control permissions](../../../administration/roles-and-permissions/access-control/custom-role-actions-scopes/) for more information.
|
|
|
|
## List API keys
|
|
|
|
{{% admonition type="warning" %}}
|
|
This endpoint is deprecated.
|
|
|
|
{{% /admonition %}}
|
|
|
|
`GET /api/auth/keys`
|
|
|
|
**Required permissions**
|
|
|
|
See note in the [introduction](#authentication-api) for an explanation.
|
|
|
|
| Action | Scope |
|
|
| -------------- | ----------- |
|
|
| `apikeys:read` | `apikeys:*` |
|
|
|
|
**Example Request**:
|
|
|
|
```http
|
|
GET /api/auth/keys HTTP/1.1
|
|
Accept: application/json
|
|
Content-Type: application/json
|
|
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
|
|
```
|
|
|
|
Query Parameters:
|
|
|
|
- `includeExpired`: boolean. enable listing of expired keys. Optional.
|
|
|
|
**Example Response**:
|
|
|
|
```http
|
|
HTTP/1.1 200
|
|
Content-Type: application/json
|
|
|
|
```
|
|
|
|
## Create API Key
|
|
|
|
{{% admonition type="warning" %}}
|
|
This endpoint has been made obsolete in Grafana 11.3.0.
|
|
|
|
{{% /admonition %}}
|
|
|
|
Endpoint is obsolete and has been moved to [Grafana service account API](../serviceaccount/). For more information, refer to [Migrate to Grafana service account API](/docs/grafana/<GRAFANA_VERSION>/administration/service-accounts/migrate-api-keys/).
|
|
|
|
`POST /api/auth/keys`
|
|
|
|
**Example Response**:
|
|
|
|
```http
|
|
HTTP/1.1 410
|
|
Content-Type: application/json
|
|
|
|
```
|
|
|
|
## Delete API Key
|
|
|
|
{{% admonition type="warning" %}}
|
|
|
|
### DEPRECATED
|
|
|
|
{{% /admonition %}}
|
|
|
|
`DELETE /api/auth/keys/:id`
|
|
|
|
**Required permissions**
|
|
|
|
See note in the [introduction](#authentication-api) for an explanation.
|
|
|
|
| Action | Scope |
|
|
| ---------------- | ---------- |
|
|
| `apikeys:delete` | apikeys:\* |
|
|
|
|
**Example Request**:
|
|
|
|
```http
|
|
DELETE /api/auth/keys/3 HTTP/1.1
|
|
Accept: application/json
|
|
Content-Type: application/json
|
|
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
|
|
```
|
|
|
|
**Example Response**:
|
|
|
|
```http
|
|
HTTP/1.1 200
|
|
Content-Type: application/json
|
|
|
|
```
|