archive/netdata_netdata
0
0
Fork 0
mirror of https://github.com/netdata/netdata.git synced 2025-04-06 14:35:32 +00:00
Code Issues Projects Releases Wiki Activity
netdata_netdata/docs/netdata-cloud/authentication-and-authorization/api-tokens.md
Fotis Voutsas a5460023bf
Docs directory lint documentation and fix issues () 
* alerts-and-notifications broken link pass

* category-overview-pages pass

* dashboards and charts pass

* deployment-guides pass

* dev corner pass

* exporting metrics pass

* Netdata Agent pass

* Netdata Cloud pass

* observ centrl points pass

* sec and priv design pass

* final docs on docs/ folder

* web server readme fix

* fix broken link
2024-10-03 12:05:07 +03:00

1.1 KiB
Raw Blame History

API Tokens

Overview

Every single user can get access to the Netdata resource programmatically. It is done through the API Token which can be also called as Bearer Token. This token is used for authentication and authorization, it can be issued in the Netdata UI under the user Settings:

image

The API Tokens are not going to expire and can be limited to a few scopes:

  • scope:all

    this token is given the same level of action as the user has, the use-case for it is Netdata terraform provider

  • scope:agent-ui

    this token is mainly used by the local Netdata agent accessing the Cloud UI

  • scope:grafana-plugin

    this token is used for the Netdata Grafana plugin to access Netdata charts

Currently, the Netdata Cloud is not exposing stable API.

Example usage

  • get the cloud space list
curl -H 'Accept: application/json' -H "Authorization: Bearer <token>" https://app.netdata.cloud/api/v2/spaces