Zelfstudie: Een Python-web-app registreren bij het Microsoft Identity Platform
Deze reeks zelfstudies laat zien hoe u een Python-web-app bouwt waarmee gebruikers worden aangemeld en een beveiligde web-API wordt aangeroepen. U gebruikt de Microsoft Authentication Library voor Python-bibliotheek om gebruikers in uw Microsoft Entra ID-tenant te verifiëren. Ten slotte voert u de app uit om zich aan te melden, een beveiligde API aan te roepen en gebruikers af te melden.
In deze zelfstudie hebt u:
- Een web-app registreren in het Microsoft Entra-beheercentrum en de id's ervan vastleggen
- Het platform en de URL's definiëren
- Een clientgeheim voor de web-app maken
- Machtigingen verlenen aan de web-app voor toegang tot de Microsoft Graph API
Vereisten
- Een Azure-account met een actief abonnement. Als u nog geen account hebt, maakt u gratis een account.
- Het Azure-account dat u gebruikt, moet machtigingen hebben voor het beheren van toepassingen. Een van de volgende Microsoft Entra-rollen omvat de vereiste machtigingen:
- Toepassingsbeheerder
- Toepassingsontwikkelaar
- Beheerder van de cloudtoepassing
De Python-web-app en record-id's registreren
Als u mogelijkheden voor identiteits- en toegangsbeheer in uw toepassing wilt integreren, begint u met het registreren van uw app bij het Microsoft Identity Platform. Volg deze stappen om uw toepassing te registreren in het Microsoft Entra-beheercentrum:
- Meld u aan bij het Microsoft Entra-beheercentrum.
- Als u toegang hebt tot meerdere tenants, gebruikt u het pictogram
Instellingen in het bovenste menu om over te schakelen naar de tenant waarin u de toepassing wilt registreren in het menu Mappen en abonnementen. - Blader naar Identiteitstoepassingen>> App-registraties en selecteer Nieuwe registratie.
- Voer een naam in voor uw toepassing, bijvoorbeeld python-flask-webapp. Gebruikers van uw toepassing zien mogelijk de weergavenaam wanneer ze de app gebruiken, bijvoorbeeld tijdens het aanmelden. U kunt de weergavenaam op elk gewenst moment wijzigen.
- Onder Ondersteunde accounttypen selecteert u Enkel accounts in deze organisatieadreslijst.
- Selecteer Registreren om de initiële app-registratie te voltooien.
Wanneer de registratie is voltooid, wordt in het Microsoft Entra-beheercentrum het deelvenster Overzicht van de app-registratie weergegeven. Noteer in het deelvenster Overzicht de map-id (tenant) en de toepassings-id (client) die in een latere stap moeten worden gebruikt.
Een omleidings-URI toevoegen
Volg deze stappen om een omleidings-URI toe te voegen voor uw Python Flask-web-app:
- Selecteer uw toepassing in het Microsoft Entra-beheercentrum in App-registraties.
- Selecteer Verificatie onder Beheren.
- Selecteer onder Platformconfiguraties een platform toevoegen en selecteer vervolgens Web.
- Wanneer u web selecteert als platform van uw app, wordt u gevraagd om een omleidings-URI in te voeren. Toevoegen
http://localhost:5000/getATokenals de omleidings-URI voor uw web-app. - Selecteer Configureren.
Referenties configureren
Voor deze zelfstudie gebruikt u een clientgeheim, ook wel een toepassingswachtwoord genoemd om de app te identificeren als een vertrouwelijke client. Volg deze stappen om een clientgeheim toe te voegen aan uw app-registratie:
- Selecteer uw toepassing in het Microsoft Entra-beheercentrum in App-registraties.
- Selecteer onder Beheren de optie Certificaten en geheimen.
- Selecteer in de sectie Clientgeheimen de optie Nieuw clientgeheim.
- Geef in het deelvenster Een clientgeheim toevoegen een beschrijving op voor uw clientgeheim.
- Selecteer een vervaldatum voor het geheim of geef een aangepaste levensduur op.
- De levensduur van het clientgeheim is beperkt tot twee jaar (24 maanden) of minder. U kunt geen aangepaste levensduur opgeven die langer is dan 24 maanden. Microsoft raadt u aan een verloopwaarde van minder dan 12 maanden in te stellen.
- Selecteer Toevoegen.
- Noteer de waarde van het clientgeheim (niet de id) voor gebruik in een latere stap. Deze geheime waarde wordt slechts eenmaal weergegeven wanneer u deze maakt en nooit wordt weergegeven nadat u deze pagina hebt verlaten.
Hoewel u in deze zelfstudie een clientgeheim hebt gebruikt, raden we u aan een certificaat te gebruiken voordat u de toepassing naar een productieomgeving verplaatst. Zie voor meer informatie over het gebruik van een certificaat deze instructies.
Een bereik toevoegen
Omdat deze app gebruikers aanmeldt, moet u gedelegeerde machtigingen toevoegen:
- Selecteer onder Beheren achtereenvolgens API-machtigingen>Een machtiging toevoegen.
- Zorg ervoor dat het tabblad Microsoft-API's is geselecteerd.
- Selecteer in de sectie Veelgebruikte Microsoft-API's de optie Microsoft Graph.
- Controleer in de sectie Gedelegeerde machtigingen of User.Read is geselecteerd. Gebruik het zoekvak indien nodig.
- Selecteer Machtigingen toevoegen.