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.

Gestione API include 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.

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.

prerequisitiPrerequisites

Completare le attività riportate in questo articolo: Creare un'istanza di Gestione API di Azure.Complete tasks in this article: Create an Azure API Management instance.

Per passare all'istanza di Gestione API, seguire questa procedura:To navigate to your APIM instance, follow these steps:

  1. Accedere al portale di Azure.Sign in to the Azure portal.
  2. In alto a sinistra sullo schermo selezionare Tutti i servizi.On the top-left of the screen, select All services.
  3. Nella casella di ricerca digitare "api".Type "api" in the search box.
  4. Fare clic su Servizi Gestione API.Click API Management services.

    Esplorare

  5. Selezionare l'istanza del servizio Gestione API.Select your APIM service instance.

Suggerimento

Aggiungere Gestione API ai Preferiti del portale di Azure facendo clic sulla stella.Add API Management (APIM) to your favorites in the Azure portal by clicking the star.
L'icona Gestione API viene aggiunta al menu disponibile nella parte sinistra del portale.This adds the APIM icon to the menu on the left of the portal. Per visualizzare tutti i servizi di Gestione API, fare clic sull'icona (icona Gestione API).To see all your APIM services, click the icon (APIM icon).

Creare un gruppo Create a group

In questa sezione viene illustrato come aggiungere un nuovo gruppo all'account di Gestione API.This section shows how to add a new group to your API Management account.

  1. Selezionare la scheda Gruppi a sinistra della schermata.Select the Groups tab to the left of the screen.
  2. Fare clic su +Aggiungi.Click +Add.
  3. Immettere un nome univoco per il gruppo e una descrizione facoltativa.Enter a unique name for the group and an optional description.
  4. Fare clic su Crea.Press Create.

    Aggiungere un nuovo gruppo

Dopo averlo creato, il gruppo viene aggiunto all'elenco Gruppi.Once the group is created, it is added to the Groups list.
Per modificare il nome o la descrizione del gruppo, fare clic sul nome del gruppo e quindi scegliere Impostazioni.To edit the Name or Description of the group, click the name of the group and Settings.
Per eliminare il gruppo, fare clic sul nome del gruppo e premere CANC.To delete the group, click the name of the group and press Delete.

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

  1. Selezionare la scheda Prodotti a sinistra.Select the Products tab to the left.
  2. Fare clic sul nome del prodotto desiderato.Click the name of the desired product.
  3. Premere Controllo di accesso.Press Access control.
  4. Fare clic su + Aggiungi gruppo.Click + Add group.

    Associare un gruppo a un prodotto

  5. Selezionare il gruppo a cui che si vuole aggiungere.Select the group you want to add.

    Associare un gruppo a un prodotto

    Per rimuovere un gruppo dal prodotto, fare clic su Elimina.To remove a group from the product, click Delete.

    Eliminare un gruppo

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

In questa sezione viene illustrato come associare gruppi ai membri.This section shows how to associate groups with members.

  1. Selezionare la scheda Gruppi a sinistra della schermata.Select the Groups tab to the left of the screen.
  2. Selezionare Membri.Select Members.

    Aggiungere un membro

  3. Premere +Aggiungi e selezionare un membro.Press +Add and select a member.

    Aggiungere un membro

  4. Fare clic su Seleziona.Press Select.

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.