Création et utilisation de groupes pour gérer les comptes de développeurs dans Gestion des API AzureHow to create and use groups to manage developer accounts in Azure API Management

Dans Gestion des API, les groupes permettent de gérer la visibilité des produits pour les développeurs.In API Management, groups are used to manage the visibility of products to developers. Les produits sont d'abord visibles pour les groupes. Les développeurs de ces groupes peuvent afficher les produits associés aux groupes et s'y abonner.Products are first made visible to groups, and then developers in those groups can view and subscribe to the products that are associated with the groups.

Le service Gestion des API possède les groupes système suivants, qui ne sont pas modifiables :API Management has the following immutable system groups:

  • Administrateurs : les administrateurs d’abonnements Azure sont membres de ce groupe.Administrators - Azure subscription administrators are members of this group. Les administrateurs gèrent les instances du service Gestion des API, créant les API, opérations et produits qui sont utilisés par les développeurs.Administrators manage API Management service instances, creating the APIs, operations, and products that are used by developers.
  • Développeurs : les utilisateurs authentifiés du portail des développeurs appartiennent à ce groupe.Developers - Authenticated developer portal users fall into this group. Les développeurs sont les clients qui génèrent des applications grâce à vos API.Developers are the customers that build applications using your APIs. Les développeurs bénéficient d'un accès au portail des développeurs et génèrent des applications qui appellent les opérations d'une API.Developers are granted access to the developer portal and build applications that call the operations of an API.
  • Invités : les utilisateurs non authentifiés du portail des développeurs, comme les prospects, qui consultent le portail des développeurs d’une instance d’API Management appartiennent à ce groupe.Guests - Unauthenticated developer portal users, such as prospective customers visiting the developer portal of an API Management instance fall into this group. Ils peuvent recevoir certains accès en lecture seule, comme la possibilité d'afficher les API, mais pas de les appeler.They can be granted certain read-only access, such as the ability to view APIs but not call them.

Outre ces groupes système, les administrateurs peuvent créer des groupes personnalisés ou utiliser des groupes externes dans des locataires Azure Active Directory qui leur sont associés.In addition to these system groups, administrators can create custom groups or leverage external groups in associated Azure Active Directory tenants. Des groupes externes et personnalisés peuvent être utilisés avec des groupes système offrant une certaine visibilité aux développeurs et un accès aux produits d’API.Custom and external groups can be used alongside system groups in giving developers visibility and access to API products. Vous pourriez, par exemple, créer un groupe personnalisé pour les développeurs affiliés à une organisation partenaire spécifique et leur permettre d’accéder aux API à partir d’un produit contenant uniquement des API pertinentes.For example, you could create one custom group for developers affiliated with a specific partner organization and allow them access to the APIs from a product containing relevant APIs only. Un utilisateur peut être membre de plusieurs groupes.A user can be a member of more than one group.

Ce guide explique comment les administrateurs de l'instance Gestion des API peuvent ajouter de nouveaux groupes et les associer à des produits et des développeurs.This guide shows how administrators of an API Management instance can add new groups and associate them with products and developers.

En plus de créer et gérer des groupes dans le portail de publication, vous pouvez créer et gérer vos groupes à l'aide de l’entité Groupe de l’API REST de gestion des API.In addition to creating and managing groups in the publisher portal, you can create and manage your groups using the API Management REST API Group entity.

DisponibilitéAvailability

Important

Cette fonctionnalité est disponible dans les niveaux Premium, Standard, De base et Développeur de Gestion des API.This feature is available in the Premium, Standard, Basic and Developer tiers of API Management.

Conditions préalables requisesPrerequisites

Effectuez les tâches indiquées dans cet article : Créer une instance du service Gestion des API Azure.Complete tasks in this article: Create an Azure API Management instance.

Accéder à votre instance Gestion des APIGo to your API Management instance

  1. Sur le portail Azure, recherchez et sélectionnez Services Gestion des API.In the Azure portal, search for and select API Management services.

    Sélectionnez les services Gestion des API

  2. Dans l’écran Gestion des API, sélectionnez votre instance Gestion des API.On the API Management screen, select your API Management instance.

    Sélectionnez votre instance Gestion des API

Créer un groupe Create a group

Cette section montre comment ajouter un nouveau groupe à votre compte Gestion des API.This section shows how to add a new group to your API Management account.

  1. Sélectionnez l’onglet Groupes à gauche de l’écran.Select the Groups tab to the left of the screen.

  2. Cliquez sur +Ajouter.Click +Add.

  3. Entrez un nom unique pour le groupe, et éventuellement une description.Enter a unique name for the group and an optional description.

  4. Appuyez sur Créer.Press Create.

    Ajouter un groupe

Une fois le groupe créé, il est ajouté à la liste Groupes.Once the group is created, it is added to the Groups list.
Pour modifier le nom ou la description du groupe, cliquez sur le nom du groupe, puis sur Paramètres.To edit the Name or Description of the group, click the name of the group and Settings.
Pour supprimer le groupe, cliquez sur son nom, puis appuyez sur Supprimer.To delete the group, click the name of the group and press Delete.

Maintenant que le groupe est créé, il peut être associé à des produits et des développeurs.Now that the group is created, it can be associated with products and developers.

Associer un groupe à un produit Associate a group with a product

  1. Sélectionnez l’onglet Produits vers la gauche.Select the Products tab to the left.

  2. Cliquez sur le nom du produit souhaité.Click the name of the desired product.

  3. Appuyez sur Contrôle d’accès.Press Access control.

  4. Cliquez sur + Ajouter un groupe.Click + Add group.

    Associer un groupe à un produit

  5. Sélectionnez le groupe que vous souhaitez ajouter.Select the group you want to add.

    Associer un groupe à un produit

    Pour supprimer un groupe du produit, cliquez sur Supprimer.To remove a group from the product, click Delete.

    Supprimer un groupe

Une fois le produit associé à un groupe, les développeurs de ce groupe peuvent le voir et s'y abonner.Once a product is associated with a group, developers in that group can view and subscribe to the product.

Associer des groupes aux développeurs Associate groups with developers

Cette section montre comment associer des groupes à des membres.This section shows how to associate groups with members.

  1. Sélectionnez l’onglet Groupes à gauche de l’écran.Select the Groups tab to the left of the screen.

  2. Sélectionnez Membres.Select Members.

    Ajouter un membre

  3. Appuyez sur +Ajouter et sélectionnez un membre.Press +Add and select a member.

    Ajouter un membre

  4. Appuyez sur Sélectionner.Press Select.

Une fois l’association entre le développeur et le groupe ajoutée, vous pouvez la consulter dans l’onglet Utilisateurs .Once the association is added between the developer and the group, you can view it in the Users tab.

Étapes suivantes Next steps

  • Une fois le développeur ajouté à un groupe, il peut voir tous les produits associés à ce groupe et s'y abonner.Once a developer is added to a group, they can view and subscribe to the products associated with that group. Pour plus d'informations, consultez la page Création et publication d'un produit dans Gestion des API Azure.For more information, see How create and publish a product in Azure API Management,
  • En plus de créer et gérer des groupes dans le portail de publication, vous pouvez créer et gérer vos groupes à l'aide de l’entité Groupe de l’API REST de gestion des API.In addition to creating and managing groups in the publisher portal, you can create and manage your groups using the API Management REST API Group entity.