RousselTMLEARNING

Observabilité

Administration et sécurité de Grafana : organisations, équipes, RBAC, comptes de service et authentification

Administrer Grafana en entreprise : organisations, équipes, dossiers, rôles et RBAC, permissions des sources de données, comptes de service et jetons, LDAP, OIDC, SAML, auth proxy et protection des secrets.

1. Organisations, équipes et dossiers #

Les trois niveaux de rangement et de partage.

La hiérarchie #

Disponible dans : ✓ OSS ✓ Enterprise ✓ Cloud

Hiérarchie des objets Grafana
  • Organisation : un espace étanche (utilisateurs, sources de données, dashboards, alertes). À réserver aux vrais cloisonnements, par exemple des clients différents : rien n'est partagé entre organisations.
  • Équipe : un groupe d'utilisateurs d'une organisation, à qui l'on donne des droits. C'est le bon niveau pour « Production », « Infrastructure » ou « Développement ».
  • Dossier : range dashboards, règles d'alerte et panneaux de bibliothèque. Les dossiers s'imbriquent et les sous-dossiers héritent des permissions.

Une organisation ou des équipes ? #

Bonne Pratique : Commencez par une seule organisation, des équipes et des dossiers par équipe. Les organisations multiples dupliquent les sources de données et empêchent tout dashboard transverse.

2. Rôles, permissions et RBAC #

Du rôle de base au contrôle fin.

Rôles de base #

RôlePeut…
Grafana Adminadministrer l'instance : organisations, utilisateurs, réglages (rôle serveur)
Adminadministrer une organisation : sources de données, équipes, utilisateurs, plugins
Editorcréer et modifier dashboards et alertes, explorer les données
Viewerconsulter les dashboards autorisés
Aucun rôle de baserien par défaut : tous les droits viennent des permissions données (dossiers, équipes)

Permissions de dossiers et de dashboards #

Sur chaque dossier, on accorde Lecture, Modification ou Administration à un utilisateur, une équipe ou un rôle. Retirez la permission par défaut « Viewer : lecture » des dossiers sensibles, sinon tout le monde les voit.

RBAC et permissions des sources de données #

Disponible dans : ✕ OSS ✓ Enterprise ✓ Cloud

  • Le RBAC ajoute des rôles fixes (par exemple « Data sources reader », « Alerting writer ») et des rôles personnalisés, assignables aux utilisateurs, équipes et comptes de service.
  • Les permissions de sources de données limitent qui peut interroger une source : sans elles (Grafana OSS), tout utilisateur qui voit un dashboard peut interroger toutes les sources de l'organisation depuis Explore.
Attention : En OSS, une équipe qui ne doit pas voir certaines données doit être placée dans une autre organisation, avec ses propres sources : masquer un dashboard ne protège pas la source.

3. Comptes de service et jetons #

Les accès des scripts, de la CI et de Terraform.

Pourquoi des comptes de service ? #

Un compte de service est une identité technique avec un rôle et des permissions, qui porte un ou plusieurs jetons (préfixe glsa_). Il remplace les anciennes clés d'API, migrées automatiquement : n'utilisez jamais le compte d'une personne pour un script.

# Compte de service « ci-dashboards » avec le rôle Editor, puis un jeton valable 90 jours
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -X POST $GRAFANA/api/serviceaccounts -d '{"name":"ci-dashboards","role":"Editor"}'
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -X POST $GRAFANA/api/serviceaccounts/2/tokens -d '{"name":"gitlab-ci","secondsToLive":7776000}'

Règles de sécurité #

  • Un compte de service par usage (CI, Terraform, sauvegarde), avec le rôle le plus faible possible.
  • Des jetons à durée limitée, stockés dans un coffre de secrets et renouvelés.
  • Révoquez immédiatement un jeton exposé (dépôt Git, journal) : il donne les droits du compte de service.

Automatiser équipes et dossiers #

export GRAFANA=https://grafana.exemple.fr
export TOKEN=glsa_xxx          # jeton d'un compte de service avec le rôle Admin de l'organisation
# Créer une équipe
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -X POST $GRAFANA/api/teams -d '{"name":"Production"}'
# Créer un dossier et le réserver à l'équipe (permission 1 = lecture, 2 = modification, 4 = administration)
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -X POST $GRAFANA/api/folders -d '{"uid":"prod","title":"Production"}'
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -X POST $GRAFANA/api/folders/prod/permissions \
  -d '{"items":[{"teamId":1,"permission":2},{"role":"Viewer","permission":1}]}'

4. Authentification : LDAP, OIDC, SAML et auth proxy #

Brancher Grafana sur l'annuaire de l'entreprise.

Quelle méthode ? #

MéthodeÉditionsUsage
LDAP / Active DirectoryOSS, Enterpriseannuaire interne ; rôles déduits des groupes
OAuth 2 / OIDCOSS, Enterprise, CloudKeycloak, Microsoft Entra ID, Okta, Google, GitLab… : le choix par défaut aujourd'hui
SAMLEnterprise, Cloudfournisseurs d'identité d'entreprise sans OIDC
Auth proxyOSS, Enterpriseun reverse proxy déjà authentifié transmet l'identité dans un en-tête
Synchronisation des équipesEnterprise, Cloudappartenance aux équipes Grafana tirée des groupes du fournisseur

OIDC #

# grafana.ini : connexion via un fournisseur OIDC (ici Keycloak)
[auth.generic_oauth]
enabled = true
name = Keycloak
client_id = grafana
client_secret = $__file{/run/secrets/grafana_oidc_secret}
scopes = openid email profile groups
auth_url = https://sso.exemple.fr/realms/it/protocol/openid-connect/auth
token_url = https://sso.exemple.fr/realms/it/protocol/openid-connect/token
api_url = https://sso.exemple.fr/realms/it/protocol/openid-connect/userinfo
# Rôle Grafana déduit des groupes du fournisseur d'identité
role_attribute_path = contains(groups[*], 'grafana-admins') && 'Admin' || contains(groups[*], 'grafana-editors') && 'Editor' || 'Viewer'
allow_sign_up = true

LDAP #

# grafana.ini
[auth.ldap]
enabled = true
config_file = /etc/grafana/ldap.toml

# ldap.toml (extrait)
[[servers]]
host = "ldap.exemple.fr"
port = 636
use_ssl = true
bind_dn = "cn=grafana,ou=services,dc=exemple,dc=fr"
bind_password = "$__file{/run/secrets/ldap_password}"
search_filter = "(uid=%s)"
search_base_dns = ["ou=people,dc=exemple,dc=fr"]
[[servers.group_mappings]]
group_dn = "cn=supervision-admins,ou=groups,dc=exemple,dc=fr"
org_role = "Admin"
[[servers.group_mappings]]
group_dn = "*"
org_role = "Viewer"

Auth proxy #

# grafana.ini : le reverse proxy authentifie et transmet l'identifiant dans un en-tête
[auth.proxy]
enabled = true
header_name = X-WEBAUTH-USER
header_property = username
auto_sign_up = true
whitelist = 10.0.0.10, 10.0.0.11      # seules les adresses du proxy peuvent fournir l'en-tête
Attention : Sans liste blanche, n'importe qui pouvant joindre Grafana enverrait l'en-tête et se connecterait sous n'importe quelle identité. Grafana ne doit être joignable que par le proxy.

5. Protéger les secrets #

Mots de passe des sources, clés et jetons.

Ce que Grafana chiffre #

Les mots de passe et jetons des sources de données, des points de contact d'alerte et des plugins sont chiffrés dans la base de données avec la clé secret_key (chiffrement par enveloppe). Perdre cette clé rend ces secrets illisibles : sauvegardez-la à part, et utilisez la même sur toutes les instances.

Ne pas écrire les secrets en clair #

  • Dans grafana.ini et le provisioning, lisez les valeurs depuis un fichier ou l'environnement : $__file{/run/secrets/x}, $__env{VAR}.
  • Grafana Enterprise peut aussi lire les secrets dans HashiCorp Vault ($__vault{…}) et confier la clé de chiffrement à un KMS (AWS, Azure, Google Cloud, Vault).
  • Désactivez l'inscription libre (allow_sign_up = false pour la connexion locale) et changez le mot de passe admin initial.

Commandes à connaître #

Commandes à connaître
  • grafana cli admin reset-admin-password <mdp> : réinitialiser le mot de passe de l'administrateur
  • GET /api/org/users : lister les utilisateurs de l'organisation et leur rôle
  • POST /api/teams : créer une équipe
  • POST /api/folders/:uid/permissions : définir les permissions d'un dossier
  • POST /api/serviceaccounts : créer un compte de service
  • POST /api/serviceaccounts/:id/tokens : créer un jeton (secondsToLive)
  • $__file{/run/secrets/x} : lire un secret depuis un fichier dans la configuration

Articles liés

Dashboard engineering : visualisations d'état, annotations, panneaux de bibliothèque et navigation

Concevoir des dashboards professionnels : State timeline, Status history, Node graph, annotations, panneaux d…

Automatiser Grafana : API HTTP, Terraform et cycle de vie des dashboards

Industrialiser Grafana : API HTTP (dossiers, dashboards, utilisateurs, sources), fournisseur Terraform, dashb…

Exploiter Grafana : métriques internes, santé, logs, performances et sauvegardes

Savoir exploiter Grafana : endpoint /metrics et /api/health, logs, requêtes lentes, performances des dashboar…

Pour aller plus loin

Soutenir

♥ SOUTENIR

Soutenez RousselTM Learning

Les formations, articles, TP et attestations restent gratuits et sans publicité intrusive. Une contribution libre, du montant de votre choix, finance l’hébergement, les environnements de TP et l’écriture de nouveaux contenus.

Contribuer avec PayPal Montant libre · carte bancaire ou compte PayPalEn savoir plus
QR code PayPal
Ou scannez ce QR code avec votre téléphone

Merci, chaque contribution compte !