RousselTMLEARNING

Artículo · Grafana: del descubrimiento a la experiencia

Administración y seguridad: organizaciones, equipos, RBAC y autenticación

Este artículo está disponible en francés.

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

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

Mi seguimiento

  • ⏱ Duración estimada : ≈ 13 min

Inicia sesión para seguir tu progreso y tomar notas. Iniciar sesión

💬 Debates recientes del curso

Hacer una pregunta sobre esta lección →Ver todos los debates del curso

Glossaire de la formation

Observabilidad

La capacidad de conocer el estado interno de un sistema a partir de los datos que emite.Estos datos se clasifican en 3 pilares: logs (registros)métric...

Grafana

Plataforma de código abierto para la visualización de datos y el análisis de métricas interactivas.

Prometheus

Sistema de monitorización y alertas de código abierto, particularmente adaptado para la recopilación de métricas en entornos dinámicos (como Kubernete...

APM (Application Performance Monitoring)

Monitorización del rendimiento de aplicaciones para identificar, diagnosticar y resolver problemas complejos relacionados con el rendimiento y la disp...

k6

Herramienta de código abierto para pruebas de carga (load testing) diseñada para ingeniería de rendimiento, que permite evaluar la fiabilidad y escala...

Trazas distribuidas

Técnica (proveniente del pilar de Trazas) que permite seguir el recorrido completo de una solicitud a través de múltiples microservicios para identifi...

Métricas

Medidas numéricas recopiladas a intervalos regulares (ej: CPU, RAM, tiempo de respuesta) utilizadas para evaluar el estado de salud general de un sist...

Alerting (Alertas)

Proceso que consiste en notificar a los equipos (vía email, Slack, Teams) cuando se detecta un evento específico, un umbral superado o una anomalía.

Código HTTP (HTTP Code)

Códigos de estado HTTP estandarizados que indican el resultado del procesamiento de una solicitud.1xx (Información): 100 Continue, 101 Switching Proto...

Access Log (Registro de acceso)

Archivo de registro que guarda las solicitudes procesadas por un servidor web (Apache, Nginx, Lighttpd, etc.). Permite rastrear la actividad del servi...

Client IP (IP del Cliente)

La dirección IP del usuario que realiza la solicitud hacia el servidor web. Cuando un usuario pasa por un Load Balancer o un proxy (ej: Cloudflare), l...

Timestamp (Marca de tiempo)

La fecha y la hora exactas en las que el servidor recibió la solicitud.Configuración: %t en Apache, $time_local o $time_iso8601 en Nginx.

Request (Solicitud)

La línea de solicitud inicial del cliente. Generalmente incluye el método HTTP (ej: GET), la URL solicitada y la versión del protocolo HTTP.Configurac...

Status Code (Código de estado)

El código de estado HTTP final devuelto por el servidor al cliente (ej: 200 para un éxito, 404 para recurso no encontrado).Configuración: %>s en Apach...

Size (Tamaño)

El volumen de datos devuelto al cliente, medido en bytes (generalmente sin los encabezados HTTP).Configuración: %b u %O en Apache, $body_bytes_sent en...

Referrer (Referente)

La URL de la página web desde la que el cliente hizo clic o siguió un enlace para acceder al recurso actual.Configuración: %{Referer}i en Apache, $htt...

User-Agent

La información de identificación proporcionada por el cliente sobre su navegador, su sistema operativo y su dispositivo. Su estructura estándar a menu...

Response Time (Tiempo de respuesta)

El tiempo total que tarda el servidor en procesar la solicitud y devolver la respuesta al cliente.Configuración: %D (microsegundos) o %T (segundos) en...

Artículos recomendados

Les fonctions Enterprise

Les fonctions de Grafana Enterprise (et des offres payantes de Grafana Cloud) : RBAC fin, permiss...

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

Industrialiser Grafana : API HTTP (dossiers, dashboards, utilisateurs, sources), fournisseur Terr...

Banner de anuncio en Grafana: informar a todos los usuarios

Muestra un mensaje en la parte superior de todas las páginas de Grafana: activación, campo Messag...

Bonnes pratiques Grafana : dashboards, provisioning, performances et sécurité

Bonnes pratiques Grafana : conception de dashboards lisibles, variables, dashboards as code, prov...

Grafana Assistant : L'IA au service de l'observabilité

Découvrez Grafana Assistant, l'assistant d'IA de Grafana (Cloud, OSS et Enterprise). Apprenez com...

Grafana Provisioning : Automatisez la gestion de vos tableaux de bord et sources de données

Découvrez comment utiliser le provisioning de Grafana pour gérer vos configurations (dashboards, ...

Git Sync en Grafana: versionar los dashboards en GitHub

Sincroniza dashboards y carpetas de Grafana con un repositorio de GitHub: requisitos, token, conf...

La stack LGTM (Loki, Grafana, Tempo, Mimir) : architecture et mise en place

La stack LGTM de Grafana Labs : Loki pour les logs, Grafana pour la visualisation, Tempo pour les...

Cross-dashboard variables Grafana : partager des variables entre dashboards

Créez une fois vos variables Grafana et réutilisez-les partout : portée globale ou par dossier, a...

Apoyar

♥ APOYAR

Apoya RousselTM Learning

Los cursos, artículos, prácticas y certificados siguen siendo gratuitos y sin publicidad intrusiva. Una contribución libre, por el importe que elijas, financia el alojamiento, los entornos de prácticas y nuevos contenidos.

Contribuir con PayPal Importe libre · tarjeta o cuenta PayPalMás información
QR code PayPal
O escanea este código QR con tu teléfono

¡Gracias, cada contribución cuenta!