Démarrage rapide : Créer un groupe d’administration avec Go

Article
10/16/2024

Les groupes d’administration sont des conteneurs qui vous aident à gérer l’accès, la stratégie et la conformité dans plusieurs abonnements. Créez ces conteneurs pour construire une hiérarchie efficace utilisable avec Azure Policy et les contrôles d’accès en fonction du rôle Azure. Pour plus d’informations sur les groupes d’administration, consultez Organiser vos ressources avec des groupes d’administration Azure.

La création du premier groupe d’administration dans l’annuaire peut nécessiter jusqu’à 15 minutes. En effet, des processus s’exécutent la première fois pour configurer le service des groupes d’administration dans Azure pour votre annuaire. Vous recevez une notification quand le processus est terminé. Pour plus d’informations, consultez la configuration initiale des groupes d’administration.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Un principal de service Azure, y compris les clientId et clientSecret. Si vous n’avez pas de principal de service à utiliser avec Azure Policy ou si souhaitez en créer un, consultez Authentification des bibliothèques de gestion Azure pour .NET. Ignorez l’étape d’installation des packages .NET Core, car nous l’effectuerons dans les prochaines étapes.
Tout(e) utilisateur(-trice) Microsoft Entra ID dans le locataire peut créer un groupe d’administration sans l’autorisation d’écriture du groupe d’administration attribuée à cet(te) utilisateur(-trice) si la protection de la hiérarchie n’est pas activée. Ce nouveau groupe d’administration devient un enfant du groupe d’administration racine ou du groupe d’administration par défaut, et le créateur se voit attribuer le rôle Propriétaire. Le service de groupe d’administration offre cette possibilité afin que les attributions de rôles ne soient pas nécessaires au niveau de la racine. Quand le groupe d’administration racine est créé, les utilisateurs n’y ont pas accès. Pour commencer à utiliser les groupes d’administration, le service permet de créer les groupes d’administration initiaux au niveau racine. Pour plus d’informations, consultez Groupe d’administration racine pour chaque annuaire.

Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Option	Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure.

Pour utiliser Azure Cloud Shell :

Démarrez Cloud Shell.
Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.
Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.
Sélectionnez Entrer pour exécuter le code ou la commande.

Ajouter le package de groupes d’administration

Pour permettre à Go de gérer des groupes d’administration, le package doit être ajouté. Ce package fonctionne partout où Go peut être utilisé, notamment avec bash sur Windows 10 ou par le biais d’une installation locale.

Vérifiez que la version la plus récente de Go est installée (1.15 au minimum). Si ce n’est pas le cas, téléchargez-la à l’adresse Golang.org.
Vérifiez que la version la plus récente d’Azure CLI est installée (2.5.1 au minimum). Si ce n’est pas le cas, consultez Installer Azure CLI.

Notes

Azure CLI est nécessaire pour permettre à Go d’utiliser la méthode auth.NewAuthorizerFromCLI() dans l’exemple suivant. Pour plus d’informations sur les autres options, consultez Azure SDK pour Go - Autres détails d’authentification.
S’authentifier par le biais d’Azure CLI.
```
az login
```

Dans l’environnement Go de votre choix, installez les packages nécessaires pour les groupes d’administration :

# Add the management group package for Go
go install github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups@latest

# Add the Azure auth package for Go
go install github.com/Azure/go-autorest/autorest/azure/auth@latest

Configuration des applications

Les packages Go étant ajoutés à l’environnement de votre choix, il est temps de configurer l’application Go qui peut créer un groupe d’administration.

Créez l’application Go et enregistrez la source suivante sous mgCreate.go :

package main

import (
  "context"
  "fmt"
  "os"

  mg "github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups"
  "github.com/Azure/go-autorest/autorest/azure/auth"
)

func main() {
  // Get variables from command line arguments
  var mgName = os.Args[1]

  // Create and authorize a client
  mgClient := mg.NewClient()
  authorizer, err := auth.NewAuthorizerFromCLI()
  if err == nil {
    mgClient.Authorizer = authorizer
  } else {
    fmt.Printf(err.Error())
  }

  // Create the request
  Request := mg.CreateManagementGroupRequest{
    Name: &mgName,
  }

  // Run the query and get the results
  var results, queryErr = mgClient.CreateOrUpdate(context.Background(), mgName, Request, "no-cache")
  if queryErr == nil {
    fmt.Printf("Results: " + fmt.Sprint(results) + "\n")
  } else {
    fmt.Printf(queryErr.Error())
  }
}

Générez l’application Go :
```
go build mgCreate.go
```
Créez un groupe d’administration à l’aide de l’application Go compilée. Remplacez <Name> par le nom de votre nouveau groupe d’administration :
```
mgCreate "<Name>"
```

Le résultat est un nouveau groupe d’administration dans le groupe d’administration racine.

Nettoyer les ressources

Si vous souhaitez supprimer les packages installés de votre environnement Python, vous pouvez utiliser la commande suivante :

# Remove the installed packages from the Go environment
go clean -i github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups
go clean -i github.com/Azure/go-autorest/autorest/azure/auth

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé un groupe d’administration pour organiser votre hiérarchie de ressources. Le groupe d’administration peut contenir des abonnements ou d’autres groupes d’administration.

Pour en savoir plus sur les groupes d’administration et sur la gestion de votre hiérarchie de ressources, consultez :

Gérer vos ressources avec des groupes d’administration

Partager via