Delen via

Aanbeveling voor Microsoft Entra: Migreren van Azure AD Graph-API's naar Microsoft Graph

  • Artikel

Microsoft Entra-aanbevelingen u persoonlijke inzichten en bruikbare richtlijnen bieden om uw tenant af te stemmen op aanbevolen procedures.

In dit artikel worden twee aanbevelingen behandeld voor het migreren van toepassingen en service-principals van Azure AD Graph-API's naar Microsoft Graph. Deze aanbevelingen worden aadGraphDeprecationApplication en aadGraphDeprecationServicePrincipal genoemd in de aanbevelingen-API in Microsoft Graph.

Beschrijving

De veroudering van de Graph API's van Azure Active Directory (Azure AD) werd aangekondigd in 2020 en bevindt zich nu in de uitfasering. Alle toepassingen en service-principals moeten migreren naar de nieuwe Microsoft Graph-API's.

Over het algemeen zijn toepassingen en service-principals die nog steeds gebruikmaken van Azure AD Graph API's ontwikkeld door uw organisatie of een leverancier. Deze toepassingen moeten waarschijnlijk worden bijgewerkt door uw ontwikkelaars of moeten worden bijgewerkt naar een nieuwe versie.

Er zijn twee aanbevelingen gekoppeld aan de afschaffing van Azure AD Graph. Een biedt een lijst met toepassingen en één biedt een lijst met service-principals. Beide aanbevelingen moeten afzonderlijk worden aangepakt.

Toepassingen en service-principalen

De applicatieversie van deze aanbeveling verstrekt details over toepassingen die in uw tenant zijn geregistreerd en die Azure AD Graph-API's aanroepen. Denk na over app-registraties in het Microsoft Entra-beheercentrum.

De versie van de service-principals van deze aanbeveling bevat informatie over toepassingen die zijn geregistreerd in een andere tenant, maar waarvoor toestemming is gegeven voor gebruik in uw tenant. Denk na over bedrijfstoepassingen in het Microsoft Entra-beheercentrum. Deze toepassingen kunnen worden geleverd door een ontwikkelaar in uw bedrijf met meerdere tenants of een softwareleverancier. Voor service-principals moet u waarschijnlijk contact opnemen met de leverancier om te bepalen hoe u een update naar een nieuwere versie van de toepassing krijgt.

Waarde

Microsoft Graph biedt één geïntegreerd eindpunt voor toegang tot Microsoft Entra- en Microsoft 365-services. Microsoft Graph API's hebben alle mogelijkheden van Azure AD Graph API's, plus veel nieuwere API-functies. De Microsoft Graph-clientbibliotheken bieden ingebouwde ondersteuning voor functies, zoals het opnieuw afhandelen van pogingen, veilige omleidingen, transparante verificatie en compressie van nettoladingen. Deze mogelijkheden waren niet beschikbaar met Azure AD Graph.

Alle toepassingen of service-principals die nog steeds Azure AD Graph aanroepen, worden beïnvloed door toekomstige buitengebruikstellingsactiviteiten. Om verlies van functionaliteit te voorkomen, wordt u aangeraden te migreren naar Microsoft Graph.

Actieplan

Beide aanbevelingen bevatten een lijst met betrokken resources. Het proces voor het controleren en bijwerken van toepassingen en service-principals is vergelijkbaar.

Schermopname van de betrokken toepassingen.

  1. Bekijk de lijst met toepassingen en service-principals die Azure AD Graph aanroepen onder aangedane resources in de details van de aanbevelingen.

  2. Selecteer de Meer details koppeling om verdere details over de Azure AD Graph API-activiteit weer te geven.

    • bewerkingsnaam: beschrijving van de API-bewerking, zoals Lijsttoepassing, Gebruiker maken of Groep verwijderen
    • aanvragen - 30 dagen: het aantal aanvragen dat door deze toepassing is ingediend in de afgelopen 30 dagen
    • Laatste aanvraagdatum: de datum en tijd waarop de bewerking voor het laatst is uitgevoerd door het systeem.

    Schermopname van de aanvullende details voor de geselecteerde app.

  3. Neem contact op met de eigenaar of uitgever van de bijbehorende toepassing om de stappen te identificeren die nodig zijn om de toepassing bij te werken.

Deze aanbevelingen worden weergegeven als Active totdat er gedurende 30 dagen geen Azure AD Graph API-activiteit is geweest. Na 30 dagen zonder Azure AD Graph API-activiteit wordt die toepassing of service-principal gemarkeerd als Voltooid. Zodra alle resources zijn geadresseerd, wordt de aanbeveling gemarkeerd als Voltooid.

Verwante inhoud