Guide pratique pour utiliser des comptes de service dans Azure Managed Grafana

1. Dans le portail Azure, sous Paramètres, sélectionnez Configuration, puis sous Clés API et comptes de service, sélectionnez Activer.

   

2. Sélectionnez Enregistrer pour confirmer que vous souhaitez activer les clés API et les comptes de service dans Azure Managed Grafana.

1. L’extension CLI d’Azure Managed Grafana 0.3.0 ou une version ultérieure est nécessaire. Pour mettre à jour votre extension, exécutez az extension update --name amg.

2. Exécutez la commande az grafana update pour activer la création de clés API et de comptes de service dans une instance Azure Managed Grafana existante. Dans la commande ci-dessous, remplacez <azure-managed-grafana-name> par le nom de l’instance Azure Managed Grafana à mettre à jour.

   az grafana update --name <azure-managed-grafana-name> ---service-account Enabled
   

1. Accédez à votre point de terminaison d’instance Grafana, puis sélectionnez Utilisateurs et accès>Comptes de service dans le menu de gauche, puis Ajouter un compte de service.

   

2. Entrez un Nom d’affichage et un Rôle pour votre nouveau compte de service Grafana à partir des options Aucun rôle de base, Viewer, Éditeur ou Administrateur, puis sélectionnez Créer. Aucun rôle n’est attribué par défaut.

3. Une fois le compte de service créé, Grafana affiche des informations sur le nouveau compte de service, notamment sa date de création, les jetons existants et les autorisations associées. Vous créez un premier jeton à l’étape suivante.

4. Vous pouvez sélectionner Comptes de service dans le menu de gauche pour voir la liste de tous les comptes de service dans votre instance Grafana.

1. Exécutez la commande az grafana service-account create pour créer un compte de service. Remplacez les espaces réservés <azure-managed-grafana-name>, <service-account-name> et <role> par vos propres informations.

   Rôles disponibles : Admin, Editor, Viewer.

   az grafana service-account create --name <azure-managed-grafana-name> --service-account <service-account-name> --role <role>
   

2. Exécutez la commande az grafana service-account list pour lister tous les comptes de service qui appartiennent à une instance Azure Managed Grafana donnée. Remplacez <azure-managed-grafana-name> par le nom de votre espace de travail Azure Managed Grafana.

   az grafana service-account list --name <azure-managed-grafana-name> --output table
   

   Exemple de sortie :

   AvatarUrl             IsDisabled    Login        Name        OrgId    Role    Tokens
   --------------------  ------------  -----------  ----------  -------  ------  --------
   /avatar/abc12345678   False         sa-account1  account1    1        Viewer  0
   

   1. Exécutez la commande az grafana service-account show pour obtenir les détails d’un compte de service. Remplacez <azure-managed-grafana-name> et <service-account-name> par vos propres informations.

   az grafana service-account show --name <azure-managed-grafana-name> --service-account <service-account-name>
   

Dans l’interface utilisateur de Grafana :

1. Pour créer un jeton de compte de service, sélectionnez Ajouter un jeton de compte de service.

2. Utilisez le Nom d’affichage généré automatiquement ou entrez le nom de votre choix. Par défaut, la date d’expiration est définie sur un jour après la date de création. Vous pouvez mettre à jour la Date d’expiration suggérée ou sélectionner Aucune expiration.

   

3. Sélectionnez Generate token. Comme le jeton est affiché une seule fois, copiez-le et enregistrez-le dans un endroit sûr. Si vous perdez ce jeton, vous devez en générer un nouveau.

4. Le jeton est maintenant listé dans les détails du compte de service.

Dans l’interface de ligne de commande Azure :

1. Créez un jeton de compte de service Grafana avec az grafana service-account token create. Remplacez les espaces réservés <azure-managed-grafana-name>, <service-account-name> et <token-name> par vos propres informations.

   Définissez éventuellement un délai d’expiration :

   Paramètre	Description	Exemple
   --time-to-live	Les jetons ont une durée d’expiration d’un jour par défaut. Vous pouvez désactiver ou modifier la durée d’expiration pour désactiver le jeton au bout d’une certaine durée. Utilisez s pour les secondes, m pour les minutes, h pour les heures, d pour les jours, w pour les semaines, M pour les mois ou y pour les années.	15d

   az grafana service-account token create --name <azure-managed-grafana-name> --service-account <service-account-name> --token <token-name> --time-to-live 15d
   

2. Notez le jeton généré et enregistrez-le dans un endroit sûr. Si vous perdez ce jeton, vous devez en générer un nouveau.

3. Exécutez la commande az grafana service-account token list pour lister tous les jetons appartenant à un compte de service donné. Remplacez les espaces réservés <azure-managed-grafana-name> et <service-account-name> par vos propres informations.

   az grafana service-account token list --name <azure-managed-grafana-name> --service-account <service-account-name> --output table
   

   Exemple de sortie :

   Created               Expiration            HasExpired    Name    SecondsUntilExpiration
   --------------------  --------------------  ------------  ------  ------------------------
   2024-11-05T15:09:24Z  2024-11-06T14:48:51Z  False         token1  84388.80530215
   

Actions :

• Pour modifier le nom, sélectionnez le compte de service, puis sous Informations, sélectionnez Modifier.
• Pour modifier le rôle, sélectionnez le compte de service, puis sous Informations, sélectionnez le rôle, et choisissez un autre nom de rôle.
• Pour désactiver un compte de service, sélectionnez celui-ci, puis en haut de la page, sélectionnez Désactiver le compte de service, et sélectionnez ensuite Désactiver le compte de service pour confirmer votre choix. Vous pouvez réactiver les comptes de service désactivés en sélectionnant Activer le compte de service.

La notification Compte de service mis à jour s’affiche instantanément.

Modifiez un compte de service avec az grafana service-account update. Remplacez les espaces réservés <azure-managed-grafana-name> et <service-account-name> par vos propres informations, puis utilisez un ou plusieurs des paramètres suivants :

az grafana service-account update --name <azure-managed-grafana-name> --service-account <service-account-name> --role <role> --enabled false

Pour désactiver un compte de service, exécutez la commande az grafana update, puis utilisez l’option --is-disabled true. Pour activer un compte de service, utilisez --is-disabled false.

az grafana update --service-account Disabled --name <service-account-name>

Pour supprimer un compte de service Grafana, sélectionnez celui-ci, puis en haut de la page, sélectionnez Supprimer le compte de service, et sélectionnez ensuite Supprimer le compte de service pour confirmer votre choix. La suppression d’un compte de service est définitive. Une fois qu’il a été supprimé, un compte de service ne peut plus être récupéré.

Pour supprimer un compte de service, exécutez la commande az grafana service-account delete. Remplacez les espaces réservés <azure-managed-grafana-name> et <service-account-name> par vos propres informations.

az grafana service-account delete --name <azure-managed-grafana-name> --service-account <service-account-name>

Pour supprimer un jeton de compte de service, sélectionnez un compte de service, puis sous Jetons, sélectionnez Supprimer (x). Sélectionnez Supprimer pour confirmer.

Pour supprimer un compte de service, exécutez la commande az grafana service-account token delete. Remplacez les espaces réservés <azure-managed-grafana-name>, <service-account-name> et <token-name> par vos propres informations.

az grafana service-account token delete --name <azure-managed-grafana-name> --service-account <service-account-name> --token <token-name>