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

  • Artikel

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

In API Management worden groepen gebruikt voor het beheren van de zichtbaarheid van producten voor ontwikkelaars. 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 systeemgroepen:

  • Beheerders - Azure-abonnementbeheerders zijn lid van deze groep. Beheerders beheren service-exemplaren van API Management, door het maken van de API's, bewerkingen en producten die door ontwikkelaars worden gebruikt. U kunt geen gebruikers toevoegen aan deze groep.

    Notitie

    U kunt de e-mailinstellingen van de beheerder wijzigen die worden gebruikt in meldingen die vanuit uw API Management-exemplaar naar ontwikkelaars worden verzonden.

  • 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, klikt u op 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 .

Volgende stappen

  • 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.