Come creare e usare gruppi per gestire account di sviluppatori in Gestione API di AzureHow to create and use groups to manage developer accounts in Azure API Management

In Gestione API i gruppi permettono di gestire quali prodotti sono visibili per gli sviluppatori.In API Management, groups are used to manage the visibility of products to developers. I prodotti vengono innanzitutto resi visibili ai gruppi, quindi gli sviluppatori in quei gruppi possono visualizzare e sottoscriversi ai prodotti associati ai gruppi.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.

In Gestione API sono inclusi i gruppi di sistema non modificabili seguenti.API Management has the following immutable system groups.

  • Amministratori : gli amministratori delle sottoscrizioni di Azure sono membri di questo gruppo.Administrators - Azure subscription administrators are members of this group. Gli amministratori gestiscono le istanze del servizio Gestione API e creano le API, le operazioni e i prodotti usati dagli sviluppatori.Administrators manage API Management service instances, creating the APIs, operations, and products that are used by developers.
  • Sviluppatori : gli utenti autenticati del portale per sviluppatori rientrano in questo gruppo.Developers - Authenticated developer portal users fall into this group. Gli sviluppatori sono i clienti che compilano applicazioni usando le API.Developers are the customers that build applications using your APIs. Agli sviluppatori viene concesso di accedere al portale per sviluppatori e di creare applicazioni che chiamano le operazioni di un'API.Developers are granted access to the developer portal and build applications that call the operations of an API.
  • Guest : gli utenti non autenticati del portale per sviluppatori, ad esempio i potenziali clienti, che visitano il portale per sviluppatori di un'istanza di Gestione API rientrano in questo gruppo.Guests - Unauthenticated developer portal users, such as prospective customers visiting the developer portal of an API Management instance fall into this group. È possibile concedere agli utenti guest un determinato livello di accesso di sola lettura, ad esempio la possibilità di visualizzare le API ma non di chiamarle.They can be granted certain read-only access, such as the ability to view APIs but not call them.

Oltre a questi gruppi di sistema, gli amministratori possono creare gruppi personalizzati oppure sfruttare i gruppi esterni nei tenant di Azure Active Directory associati.In addition to these system groups, administrators can create custom groups or leverage external groups in associated Azure Active Directory tenants. È possibile usare gruppi personalizzati ed esterni assieme ai gruppi di sistema per offrire agli sviluppatori visibilità e accesso ai prodotti API.Custom and external groups can be used alongside system groups in giving developers visibility and access to API products. Ad esempio, si può creare un gruppo personalizzato per gli sviluppatori affiliati a un'organizzazione partner specifica e consentire loro di accedere alle API da un prodotto che contiene solo le API pertinenti.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 utente può essere un membro di più gruppi.A user can be a member of more than one group.

Questa guida illustra come gli amministratori di un'istanza di Gestione API possono aggiungere nuovi gruppi e associarli a prodotti e sviluppatori.This guide shows how administrators of an API Management instance can add new groups and associate them with products and developers.

Nota

Oltre a creare e gestire gruppi nel portale di pubblicazione, è possibile creare e gestire i gruppi utilizzando l'entità API REST di gestione Gruppo .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.

Creare un gruppo Create a group

Per creare un nuovo gruppo, fare clic su Portale di pubblicazione nel portale di Azure per il servizio Gestione API.To create a new group, click Publisher portal in the Azure Portal for your API Management service. Verrà visualizzato il portale di pubblicazione di Gestione API.This takes you to the API Management publisher portal.

Portale di pubblicazione

Se non è ancora stata creata un'istanza del servizio Gestione API, vedere Creare un'istanza di Gestione API.If you have not yet created an API Management service instance, see Create an API Management service instance.

Fare clic su Gruppi dal menu Gestione API sulla sinistra, quindi scegliere Aggiungi gruppo.Click Groups from the API Management menu on the left, and then click Add Group.

Aggiungere un nuovo gruppo

Immettere un nome univoco per il gruppo e una descrizione facoltativa, quindi fare clic su Salva.Enter a unique name for the group and an optional description, and click Save.

Aggiungere un nuovo gruppo

Il nuovo gruppo viene visualizzato nella scheda relativa ai gruppi. Per modificare il Nome o la Descrizione del gruppo, fare clic sul nome del gruppo nell'elenco.The new group is displayed in the groups tab. To edit the Name or Description of the group, click the name of the group in the list. Per eliminare il gruppo, fare clic su Elimina.To delete the group, click Delete.

Gruppo aggiunto

Ora che il gruppo è stato creato, può essere associato a prodotti e sviluppatori.Now that the group is created, it can be associated with products and developers.

Associare un gruppo a un prodotto Associate a group with a product

Per associare un gruppo a un prodotto, fare clic su Prodotti dal menu Gestione API a sinistra, quindi fare clic sul nome del prodotto desiderato.To associate a group with a product, click Products from the API Management menu on the left, and then click the name of the desired product.

Visibilità dei prodotti

Selezionare la scheda Visibilità per aggiungere e rimuovere gruppi e per visualizzare gli attuali gruppi associati al prodotto.Select the Visibility tab to add and remove groups, and to view the current groups for the product. Per aggiungere o rimuovere gruppi, selezionare o deselezionare le caselle di controllo per i gruppi desiderati, quindi fare clic su Salva.To add or remove groups, check or uncheck the checkboxes for the desired groups and click Save.

Visibilità dei prodotti

Nota

Per aggiungere gruppi di Azure Active Directory, vedere Come autorizzare gli account per sviluppatore usando Azure Active Directory in Gestione API di Azure.To add Azure Active Directory groups, see How to authorize developer accounts using Azure Active Directory in Azure API Management.

Per configurare gruppi dalla scheda Visibilità per un prodotto, fare clic su Gestisci gruppi.To configure groups from the Visibility tab for a product, click Manage Groups.

Dopo che un prodotto è stato associato a un gruppo, gli sviluppatori in quel gruppo possono visualizzare il prodotto e sottoscriversi ad esso.Once a product is associated with a group, developers in that group can view and subscribe to the product.

Associare gruppi a sviluppatori Associate groups with developers

Per associare gruppi a sviluppatori, fare clic su Utenti dal menu Gestione API a sinistra, quindi selezionare la casella di controllo accanto agli sviluppatori da associare a un gruppo.To associate groups with developers, click Users from the API Management menu on the left, and then check the box beside the developers you wish to associate with a group.

Aggiungere uno sviluppatore a un gruppo

Dopo aver selezionato gli sviluppatori desiderati, fare clic sul gruppo desiderato nel menu a discesa Aggiungi gruppo .Once the desired developers are checked, click the desired group in the Add to Group drop-down. È possibile rimuovere sviluppatori dai gruppi usando l'elenco a discesa Rimuovi da gruppo .Developers can be removed from groups by using the Remove from Group drop-down.

Sviluppatori

Dopo l'aggiunta dell'associazione tra sviluppatore e gruppo, è possibile visualizzarla nella scheda Utenti .Once the association is added between the developer and the group, you can view it in the Users tab.

Passaggi successivi Next steps

  • Dopo che uno sviluppatore è stato associato a un gruppo, potrà visualizzare i prodotti associati a quel gruppo e sottoscriversi ad essi.Once a developer is added to a group, they can view and subscribe to the products associated with that group. Per altre informazioni, vedere Come creare e pubblicare un prodotto in Gestione API di Azure,For more information, see How create and publish a product in Azure API Management,
  • Oltre a creare e gestire gruppi nel portale di pubblicazione, è possibile creare e gestire i gruppi utilizzando l'entità API REST di gestione Gruppo .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.