Delen via

Groepen maken en gebruiken voor beheer van ontwikkelaarsaccounts in Azure API Management

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar | Basic | Basic v2 | Standaard | Standard v2 | Premium | Premium v2

In API Management worden groepen gebruikt om de zichtbaarheid van producten voor ontwikkelaars in de ontwikkelaarsportal te beheren. Producten worden eerst zichtbaar gemaakt voor groepen. Ontwikkelaars in die groepen kunnen vervolgens de producten die aan de groepen zijn gekoppeld, bekijken en zich erop abonneren.

API Management heeft de volgende onveranderbare groepen:

  • Beheerders : ingebouwde groep met alleen het e-mailaccount van de beheerder dat is opgegeven op het moment dat de service is gemaakt. Het lidmaatschap wordt beheerd door het systeem; gebruikers kunnen niet worden toegevoegd aan of verwijderd uit de groep. Het primaire doel van het beheerdersaccount is om toegang te krijgen tot de beheerinterface van de ontwikkelaarsportal om de portalinhoud aan te passen en te publiceren . Elke gebruiker met Azure RBAC-machtigingen om de ontwikkelaarsportal aan te passen, kan worden geverifieerd als de beheerder om de portal aan te passen.

    Notitie

    Op elk gewenst moment kan een service-eigenaar de e-mailinstellingen van de beheerder bijwerken die worden gebruikt in meldingen van uw API Management-exemplaar.

  • Ontwikkelaars: geverifieerde gebruikers van de ontwikkelaarsportal vallen in deze groep. Ontwikkelaars zijn de klanten die toepassingen bouwen met uw API's. Ontwikkelaars krijgen toegang tot de ontwikkelaarsportal en bouwen toepassingen waarmee de bewerkingen van een API worden aangeroepen.

  • Gasten - Niet-geverifieerde gebruikers van de ontwikkelaarsportal, zoals potentiële klanten die de ontwikkelaarsportal van een API Management-exemplaar bezoeken, vallen in deze groep. Ze kunnen bepaalde alleen-lezentoegang krijgen, zoals de mogelijkheid om API's te bekijken maar niet om ze aan te roepen.

Naast deze systeemgroepen kunnen beheerders aangepaste groepen maken of externe groepen gebruiken in gekoppelde Microsoft Entra-tenants. Aangepaste en externe groepen kunnen naast systeemgroepen worden gebruikt om ontwikkelaars zichtbaarheid van en toegang tot API-producten te geven. U kunt bijvoorbeeld één aangepaste groep maken voor ontwikkelaars die zijn gekoppeld aan een specifieke partnerorganisatie en hen toegang geven tot de API's vanuit een product dat alleen relevante API's bevat. Een gebruiker kan lid zijn van meerdere groepen.

In deze handleiding ziet u hoe beheerders van een API Management-exemplaar nieuwe groepen kunnen toevoegen en deze kunnen koppelen aan producten en ontwikkelaars.

Naast het maken en beheren van groepen in Azure Portal, kunt u uw groepen maken en beheren met behulp van de API Management REST API Group-entiteit .

Vereisten

Voltooi taken in dit artikel: Een Azure API Management-exemplaar maken.

Ga naar uw API Management-exemplaar

  1. Zoek en selecteer API Management-services in Azure Portal.

    API Management-services selecteren

  2. Selecteer uw API Management-exemplaar op de pagina API Management-services.

    Uw API Management-exemplaar selecteren

Een groep maken

In deze sectie ziet u hoe u een nieuwe groep toevoegt aan uw API Management-account.

  1. Selecteer het tabblad Groepen links van het scherm.

  2. Klik op +Toevoegen.

  3. Voer een unieke naam in voor de groep en een optionele beschrijving.

  4. Druk op Maken.

    Schermopname van het maken van een groep in de portal. Zodra de groep is gemaakt, wordt deze toegevoegd aan de lijst Groepen .

    • Als u de naam of beschrijving van de groep wilt bewerken, klikt u op de naam van de groep en selecteert u Instellingen

    • Als u de groep wilt verwijderen, selecteert u de naam van de groep en drukt u op Delete.

Nu de groep is gemaakt, kan deze worden gekoppeld aan producten en ontwikkelaars.

Een groep koppelen aan een product

  1. Selecteer het tabblad Producten aan de linkerkant.

  2. Klik op de naam van het gewenste product.

  3. Druk op Access Control>+ Groep toevoegen.

  4. Selecteer de groep die u wilt toevoegen.

    Schermopname van het toevoegen van een groep aan een product in de portal.

Zodra een product is gekoppeld aan een groep, kunnen ontwikkelaars in die groep het product bekijken en erop abonneren.

Notitie

Zie Ontwikkelaarsaccounts autoriseren met behulp van Microsoft Entra ID in Azure API Management om Microsoft Entra-groepen toe te voegen.

Als u een groep uit het product wilt verwijderen, klikt u op Verwijderen.

Schermopname van het verwijderen van een groep uit een product in de portal.

Groepen koppelen aan ontwikkelaars

In deze sectie ziet u hoe u groepen koppelt aan leden.

  1. Selecteer het tabblad Groepen links van het scherm en selecteer vervolgens een groep.

  2. Selecteer Leden>+ Toevoegen.

  3. Selecteer een lid.

    Schermopname van het toevoegen van een lid aan een groep in de portal.

  4. Druk op Selecteren.

Zodra de koppeling is toegevoegd tussen de ontwikkelaar en de groep, kunt u deze bekijken op het tabblad Gebruikers .

Verwante inhoud

  • Zodra een ontwikkelaar is toegevoegd aan een groep, kunnen ze de producten bekijken en abonneren die aan die groep zijn gekoppeld. Zie Een product maken en publiceren in Azure API Management voor meer informatie.
  • U kunt bepalen hoe de inhoud van de ontwikkelaarsportal wordt weergegeven voor verschillende gebruikers en groepen die u hebt geconfigureerd. Meer informatie over zichtbaarheid en toegangsbeheer in de ontwikkelaarsportal.
  • Meer informatie over het beheren van de e-mailinstellingen van de beheerder die worden gebruikt in meldingen voor ontwikkelaars van uw API Management-exemplaar.