Konfigurowanie niestandardowego dostawcy oświadczeń dla zdarzenia wystawiania tokenu

W tym artykule opisano sposób konfigurowania niestandardowego dostawcy oświadczeń dla zdarzenia rozpoczęcia wystawiania tokenu. Korzystając z istniejącego interfejsu API REST usługi Azure Functions, zarejestrujesz niestandardowe rozszerzenie uwierzytelniania i dodasz atrybuty, które będą analizowane z interfejsu API REST. Aby przetestować niestandardowe rozszerzenie uwierzytelniania, zarejestrujesz przykładową aplikację OpenID Connect, aby uzyskać token i wyświetlić oświadczenia.

Wymagania wstępne

• Subskrypcja platformy Azure z możliwością tworzenia usługi Azure Functions. Jeśli nie masz istniejącego konta platformy Azure, utwórz konto bezpłatnej wersji próbnej lub skorzystaj z korzyści z subskrypcji programu Visual Studio podczas tworzenia konta.
• Funkcja wyzwalacza HTTP skonfigurowana dla zdarzenia wystawiania tokenu wdrożonego w usłudze Azure Functions. Jeśli go nie masz, wykonaj kroki opisane w artykule Tworzenie interfejsu API REST dla zdarzenia uruchamiania wystawiania tokenu w usłudze Azure Functions.
• Podstawowa wiedza na temat pojęć omówionych w artykule Omówienie rozszerzeń uwierzytelniania niestandardowego.
• Dzierżawa identyfikatora entra firmy Microsoft. W tym przewodniku z instrukcjami możesz użyć dzierżawy klienta lub pracowników.
  • W przypadku dzierżaw zewnętrznych użyj przepływu rejestracji i logowania użytkownika.

Krok 1. Rejestrowanie niestandardowego rozszerzenia uwierzytelniania

Teraz skonfigurujesz niestandardowe rozszerzenie uwierzytelniania, które będzie używane przez identyfikator Entra firmy Microsoft do wywoływania funkcji platformy Azure. Rozszerzenie uwierzytelniania niestandardowego zawiera informacje o punkcie końcowym interfejsu API REST, oświadczeniach, które analizuje z interfejsu API REST i sposobie uwierzytelniania w interfejsie API REST. Wykonaj następujące kroki, aby zarejestrować niestandardowe rozszerzenie uwierzytelniania w aplikacji funkcji platformy Azure.

Uwaga

Można mieć maksymalnie 100 niestandardowych zasad rozszerzenia.

Witryna Azure Portal

Rejestrowanie niestandardowego rozszerzenia uwierzytelniania

1. Zaloguj się do witryny Azure Portal jako co najmniej administrator aplikacji i administrator uwierzytelniania.
2. Wyszukaj i wybierz pozycję Microsoft Entra ID i wybierz pozycję Aplikacje dla przedsiębiorstw.
3. Wybierz pozycję Niestandardowe rozszerzenia uwierzytelniania, a następnie wybierz pozycję Utwórz rozszerzenie niestandardowe.
4. W obszarze Podstawy wybierz typ zdarzenia TokenIssuanceStart i wybierz pozycję Dalej.
5. W obszarze Konfiguracja punktu końcowego wypełnij następujące właściwości:
   • Nazwa — nazwa niestandardowego rozszerzenia uwierzytelniania. Na przykład zdarzenie wystawiania tokenu.
   • Docelowy adres URL — adres {Function_Url} URL funkcji platformy Azure. Przejdź do strony Przegląd aplikacji funkcji platformy Azure, a następnie wybierz utworzoną funkcję. Na stronie Przegląd funkcji wybierz pozycję Pobierz adres URL funkcji i użyj ikony kopiowania, aby skopiować adres URL customauthenticationextension_extension (klucz systemowy).
   • Opis — opis niestandardowych rozszerzeń uwierzytelniania.
6. Wybierz Dalej.
7. W obszarze Uwierzytelnianie interfejsu API wybierz opcję Utwórz nową rejestrację aplikacji, aby utworzyć rejestrację aplikacji reprezentującą aplikację funkcji.
8. Nadaj aplikacji nazwę, na przykład interfejs API zdarzeń uwierzytelniania usługi Azure Functions.
9. Wybierz Dalej.
10. W obszarze Oświadczenia wprowadź atrybuty, które oczekujesz, że niestandardowe rozszerzenie uwierzytelniania będzie analizowane z interfejsu API REST i zostanie scalone z tokenem. Dodaj następujące oświadczenia:
    • dateOfBirth
    • customRoles
    • apiVersion
    • correlationId
11. Wybierz pozycję Dalej, a następnie utwórz, co spowoduje zarejestrowanie niestandardowego rozszerzenia uwierzytelniania i skojarzonej rejestracji aplikacji.
12. Zanotuj identyfikator aplikacji w obszarze Uwierzytelnianie interfejsu API, który jest wymagany do skonfigurowania uwierzytelniania funkcji platformy Azure w aplikacji funkcji platformy Azure .

Microsoft Graph

Rejestrowanie aplikacji

1. Zaloguj się do Eksploratora programu Graph przy użyciu konta, którego dzierżawa domowa jest dzierżawą, w której chcesz zarządzać niestandardowym rozszerzeniem uwierzytelniania. To konto musi mieć uprawnienia do tworzenia rejestracji aplikacji i zarządzania nią w dzierżawie.

2. Uruchom następujące żądanie.

   POST https://graph.microsoft.com/v1.0/applications
   Content-type: application/json
   
   {
       "displayName": "authenticationeventsAPI"
   }
   

3. W odpowiedzi zapisz wartość identyfikatora i identyfikatora appId nowo utworzonej rejestracji aplikacji. Te wartości są przywołyne w tym artykule odpowiednio jako {authenticationeventsAPI_ObjectId} i {authenticationeventsAPI_AppId} .

Utwórz jednostkę usługi w dzierżawie na potrzeby rejestracji aplikacji authenticationeventsAPI.

W Eksploratorze programu Graph uruchom następujące żądanie. Zastąp {authenticationeventsAPI_AppId} ciąg wartością appId zarejestrowaną w poprzednim kroku.

POST https://graph.microsoft.com/v1.0/servicePrincipals
Content-type: application/json
    
{
    "appId": "{authenticationeventsAPI_AppId}"
}

Ustaw identyfikator URI identyfikatora aplikacji, wersję tokenu dostępu i wymagany dostęp do zasobów

Zaktualizuj nowo utworzoną aplikację, aby ustawić wartość identyfikatora URI aplikacji, wersję tokenu dostępu i wymagany dostęp do zasobów.

W Eksploratorze programu Graph uruchom następujące żądanie.

• Ustaw wartość identyfikatora URI aplikacji we właściwości identifierUris . Zastąp {Function_Url_Hostname} ciąg nazwą hosta zarejestrowanego {Function_Url} wcześniej.
• Ustaw wartość za {authenticationeventsAPI_AppId} pomocą identyfikatora appId zarejestrowanego wcześniej.
• Przykładowa wartość to api://authenticationeventsAPI.azurewebsites.net/00001111-aaaa-2222-bbbb-3333cccc4444. Zanotuj tę wartość, ponieważ użyjesz jej w dalszej części tego artykułu zamiast {functionApp_IdentifierUri}.

POST https://graph.microsoft.com/v1.0/applications/{authenticationeventsAPI_ObjectId}
Content-type: application/json

{
"identifierUris": [
    "api://{Function_Url_Hostname}/{authenticationeventsAPI_AppId}"
],    
"api": {
    "requestedAccessTokenVersion": 2,
    "acceptMappedClaims": null,
    "knownClientApplications": [],
    "oauth2PermissionScopes": [],
    "preAuthorizedApplications": []
},
"requiredResourceAccess": [
    {
        "resourceAppId": "00000003-0000-0000-c000-000000000000",
        "resourceAccess": [
            {
                "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
                "type": "Role"
            }
        ]
    }
]
}

Rejestrowanie niestandardowego rozszerzenia uwierzytelniania

Aby zarejestrować rozszerzenie uwierzytelniania niestandardowego, należy skojarzyć je z rejestracją aplikacji dla funkcji platformy Azure i punktem końcowym {Function_Url}funkcji platformy Azure.

1. W Eksploratorze programu Graph uruchom następujące żądanie. Zastąp {Function_Url} ciąg nazwą hosta aplikacji funkcji platformy Azure. Zastąp {functionApp_IdentifierUri} element identyfikatorem identifierUri użytym w poprzednim kroku.

   • Potrzebujesz uprawnienia Delegowane CustomAuthenticationExtension.ReadWrite.All .

   POST https://graph.microsoft.com/beta/identity/customAuthenticationExtensions
   Content-type: application/json
   
   {
       "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension",
       "displayName": "onTokenIssuanceStartCustomExtension",
       "description": "Fetch additional claims from custom user store",
       "endpointConfiguration": {
           "@odata.type": "#microsoft.graph.httpRequestEndpoint",
           "targetUrl": "{Function_Url}"
       },
       "authenticationConfiguration": {
           "@odata.type": "#microsoft.graph.azureAdTokenAuthentication",
           "resourceId": "{functionApp_IdentifierUri}"
       },
       "claimsForTokenConfiguration": [
           {
               "claimIdInApiResponse": "DateOfBirth"
           },
           {
               "claimIdInApiResponse": "CustomRoles"
           }
       ]
   }
   

2. id Zarejestruj wartość utworzonego obiektu dostawcy oświadczeń niestandardowych. Użyjesz wartości w dalszej części tego samouczka {customExtensionObjectId}zamiast .

1.2 Udzielanie zgody administratora

Po utworzeniu niestandardowego rozszerzenia uwierzytelniania należy udzielić uprawnień do interfejsu API. Rozszerzenie uwierzytelniania niestandardowego używa client_credentials polecenia do uwierzytelniania w aplikacji funkcji platformy Receive custom authentication extension HTTP requests Azure przy użyciu uprawnienia.

1. Otwórz stronę Przegląd nowego niestandardowego rozszerzenia uwierzytelniania. Zanotuj identyfikator aplikacji w obszarze Uwierzytelnianie interfejsu API, ponieważ będzie on potrzebny podczas dodawania dostawcy tożsamości.

2. W obszarze Uwierzytelnianie interfejsu API wybierz pozycję Udziel uprawnień.

3. Zostanie otwarte nowe okno, a po zalogowaniu żąda uprawnień do odbierania niestandardowych żądań HTTP rozszerzenia uwierzytelniania. Dzięki temu rozszerzenie uwierzytelniania niestandardowego może uwierzytelniać się w interfejsie API. Wybierz pozycję Zaakceptuj.

   

Krok 2. Konfigurowanie aplikacji OpenID Connect w celu odbierania wzbogaconych tokenów

Aby uzyskać token i przetestować niestandardowe rozszerzenie uwierzytelniania, możesz użyć https://jwt.ms aplikacji. Jest to aplikacja internetowa należąca do firmy Microsoft, która wyświetla zdekodowana zawartość tokenu (zawartość tokenu nigdy nie opuszcza przeglądarki).

2.1 Rejestrowanie testowej aplikacji internetowej

Wykonaj następujące kroki, aby zarejestrować aplikację internetową jwt.ms :

1. Na stronie głównej w witrynie Azure Portal wybierz pozycję Microsoft Entra ID.

2. Wybierz pozycję Rejestracje aplikacji> Nowa rejestracja.

3. Wprowadź nazwę aplikacji. Na przykład Moja aplikacja testowa.

4. W obszarze Obsługiwane typy kont wybierz pozycję Konta tylko w tym katalogu organizacyjnym.

5. Na liście rozwijanej Wybierz platformę w polu Identyfikator URI przekierowania wybierz pozycję Sieć Web , a następnie wprowadź w https://jwt.ms polu tekstowym Adres URL.

6. Wybierz pozycję Zarejestruj, aby ukończyć rejestrację aplikacji.

   

7. Na stronie Przegląd rejestracji aplikacji skopiuj identyfikator aplikacji (klienta). Identyfikator aplikacji jest określany jako w {App_to_enrich_ID} kolejnych krokach. W programie Microsoft Graph odwołuje się do niej właściwość appId .

   

2.2 Włączanie przepływu niejawnego

Aplikacja testowa jwt.ms korzysta z niejawnego przepływu. Włącz niejawny przepływ w rejestracji aplikacji Mój test:

1. W obszarze Zarządzanie wybierz pozycję Uwierzytelnianie.
2. W obszarze Niejawne udzielanie i przepływy hybrydowe zaznacz pole wyboru Tokeny identyfikatorów (używane dla przepływów niejawnych i hybrydowych).
3. Wybierz pozycję Zapisz.

2.3 Włączanie aplikacji dla zasad mapowania oświadczeń

Zasady mapowania oświadczeń służą do wybierania atrybutów zwracanych z niestandardowego rozszerzenia uwierzytelniania są mapowane na token. Aby umożliwić rozszerzanie tokenów, należy jawnie włączyć rejestrację aplikacji w celu akceptowania zamapowanych oświadczeń:

1. W obszarze Zarządzanie w obszarze Zarządzanie w obszarze Rejestracja aplikacji Mój test wybierz pozycję Manifest.
2. W manifeście znajdź acceptMappedClaims atrybut i ustaw wartość na true.
3. Ustaw opcję accessTokenAcceptedVersion na 2.
4. Wybierz Zapisz, aby zapisać zmiany.

Poniższy fragment kodu JSON przedstawia sposób konfigurowania tych właściwości.

{
	"id": "22222222-0000-0000-0000-000000000000",
	"acceptMappedClaims": true,
	"accessTokenAcceptedVersion": 2,  
    ...
}

Ostrzeżenie

Nie należy ustawiać acceptMappedClaims true właściwości dla aplikacji wielodostępnych, co umożliwia złośliwym aktorom tworzenie zasad mapowania oświadczeń dla aplikacji. Zamiast tego skonfiguruj niestandardowy klucz podpisywania.

Dzierżawa pracowników

Przejdź do następnego kroku Przypisz niestandardowego dostawcę oświadczeń do aplikacji.

Dzierżawa zewnętrzna

3.4 Kojarzenie aplikacji z przepływem użytkownika

W przypadku dzierżaw zewnętrznych należy skojarzyć aplikację z przepływem użytkownika. Przepływ użytkownika definiuje metody uwierzytelniania, których klient może użyć do logowania się do aplikacji i informacji, które muszą podać podczas rejestracji. Przed kontynuowaniem dodawania aplikacji do przepływu użytkownika upewnij się, że wykonasz kroki opisane w artykule Dodawanie aplikacji Mój test do przepływu użytkownika.

Krok 3. Przypisywanie niestandardowego dostawcy oświadczeń do aplikacji

Aby tokeny, które mają być wystawiane z oświadczeniami przychodzącymi z niestandardowego rozszerzenia uwierzytelniania, należy przypisać niestandardowego dostawcę oświadczeń do aplikacji. Jest to oparte na odbiorcach tokenów, więc dostawca musi być przypisany do aplikacji klienckiej, aby odbierać oświadczenia w tokenie identyfikatora, oraz do aplikacji zasobów w celu odbierania oświadczeń w tokenie dostępu. Niestandardowy dostawca oświadczeń opiera się na niestandardowym rozszerzeniu uwierzytelniania skonfigurowanym za pomocą odbiornika zdarzeń uruchamiania wystawiania tokenu. Możesz wybrać, czy wszystkie lub podzestaw oświadczeń, z niestandardowego dostawcy oświadczeń są mapowane na token.

Uwaga

Można tworzyć tylko 250 unikatowych przypisań między aplikacjami i rozszerzeniami niestandardowymi. Jeśli chcesz zastosować to samo wywołanie rozszerzenia niestandardowego do wielu aplikacji, zalecamy użycie interfejsu API programu Microsoft Graph authenticationEventListeners w celu utworzenia odbiorników dla wielu aplikacji. Nie jest to obsługiwane w witrynie Azure Portal.

Wykonaj następujące kroki, aby połączyć aplikację My Test z niestandardowym rozszerzeniem uwierzytelniania:

Witryna Azure Portal

Aby przypisać niestandardowe rozszerzenie uwierzytelniania jako źródło niestandardowego dostawcy oświadczeń;

1. Na stronie głównej w witrynie Azure Portal wybierz pozycję Microsoft Entra ID.

2. Wybierz pozycjęAplikacje dla przedsiębiorstw, a następnie w obszarze Zarządzaj wybierz pozycję Wszystkie aplikacje. Znajdź i wybierz pozycję Moja aplikacja testowa z listy.

3. Na stronie Przegląd aplikacji Moja aplikacja testowa przejdź do pozycji Zarządzaj i wybierz pozycję Logowanie jednokrotne.

4. W obszarze Atrybuty i oświadczenia wybierz pozycję Edytuj.

   

5. Rozwiń menu Ustawienia zaawansowane.

6. Obok pozycji Dostawca oświadczeń niestandardowych wybierz pozycję Konfiguruj.

7. Rozwiń listę rozwijaną Dostawca oświadczeń niestandardowych i wybierz utworzone wcześniej zdarzenie wystawiania tokenu.

8. Wybierz pozycję Zapisz.

Następnie przypisz atrybuty z niestandardowego dostawcy oświadczeń, który powinien zostać wystawiony w tokenie jako oświadczenia:

1. Wybierz pozycję Dodaj nowe oświadczenie , aby dodać nowe oświadczenie. Podaj nazwę oświadczenia, które chcesz wydać, na przykład dateOfBirth.

2. W obszarze Źródło wybierz pozycję Atrybut i wybierz pozycję customClaimsProvider.dateOfBirth z listy rozwijanej Atrybut źródłowy.

   

3. Wybierz pozycję Zapisz.

4. Powtórz ten proces, aby dodać atrybuty customClaimsProvider.customRoles, customClaimsProvider.apiVersion i customClaimsProvider.correlationId oraz odpowiednią nazwę. Dobrym pomysłem jest dopasowanie nazwy oświadczenia do nazwy atrybutu.

Microsoft Graph

Najpierw utwórz odbiornik zdarzeń, aby wyzwolić niestandardowe rozszerzenie uwierzytelniania dla aplikacji Mój test przy użyciu zdarzenia uruchamiania wystawiania tokenu.

1. Zaloguj się do Eksploratora programu Graph przy użyciu konta, którego dzierżawa domowa jest dzierżawą, w której chcesz zarządzać niestandardowym rozszerzeniem uwierzytelniania.

2. Uruchom następujące żądanie. Zastąp {App_to_enrich_ID} element identyfikatorem aplikacji Moja aplikacja testowa zarejestrowana wcześniej. Zastąp {customExtensionObjectId} ciąg identyfikatorem niestandardowego rozszerzenia uwierzytelniania zarejestrowanym wcześniej.

   • Wymagane jest uprawnienie delegowane EventListener.ReadWrite.All .

   POST https://graph.microsoft.com/beta/identity/authenticationEventListeners
   Content-type: application/json
   
   {
       "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener",
       "conditions": {
           "applications": {
               "includeAllApplications": false,
               "includeApplications": [
                   {
                       "appId": "{App_to_enrich_ID}"
                   }
               ]
           }
       },
       "priority": 500,
       "handler": {
           "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtensionHandler",
           "customExtension": {
               "id": "{customExtensionObjectId}"
           }
       }
   }
   

Następnie utwórz zasady mapowania oświadczeń, które opisują oświadczenia, które można wydać do aplikacji od niestandardowego dostawcy oświadczeń.

1. Nadal w Eksploratorze programu Graph uruchom następujące żądanie. Będziesz potrzebować delegowanego uprawnienia Policy.ReadWrite.ApplicationConfiguration .

   POST https://graph.microsoft.com/v1.0/policies/claimsMappingPolicies
   Content-type: application/json
   
   {
       "definition": [
           "{\"ClaimsMappingPolicy\":{\"Version\":1,\"IncludeBasicClaimSet\":\"true\",\"ClaimsSchema\":[{\"Source\":\"CustomClaimsProvider\",\"ID\":\"DateOfBirth\",\"JwtClaimType\":\"dob\"},{\"Source\":\"CustomClaimsProvider\",\"ID\":\"CustomRoles\",\"JwtClaimType\":\"my_roles\"},{\"Source\":\"CustomClaimsProvider\",\"ID\":\"CorrelationId\",\"JwtClaimType\":\"correlationId\"},{\"Source\":\"CustomClaimsProvider\",\"ID\":\"ApiVersion\",\"JwtClaimType\":\"apiVersion \"},{\"Value\":\"tokenaug_V2\",\"JwtClaimType\":\"policy_version\"}]}}"
       ],
       "displayName": "MyClaimsMappingPolicy",
       "isOrganizationDefault": false
   }
   

2. Zarejestruj wygenerowany ID w odpowiedzi, później jest określany jako {claims_mapping_policy_ID}.

Pobierz identyfikator obiektu jednostki usługi:

1. Uruchom następujące żądanie w Eksploratorze programu Graph. Zastąp {App_to_enrich_ID} ciąg identyfikatorem appId mojej aplikacji testowej.

   GET https://graph.microsoft.com/v1.0/servicePrincipals(appId='{App_to_enrich_ID}')
   

Zarejestruj wartość identyfikatora.

Przypisz zasady mapowania oświadczeń do jednostki usługi Aplikacji testowej.

1. Uruchom następujące żądanie w Eksploratorze programu Graph. Będziesz potrzebować uprawnień delegowanych Policy.ReadWrite.ApplicationConfiguration i Application.ReadWrite.All .

   POST https://graph.microsoft.com/v1.0/servicePrincipals/{test_App_Service_Principal_ObjectId}/claimsMappingPolicies/$ref
   Content-type: application/json
   
   {
       "@odata.id": "https://graph.microsoft.com/v1.0/policies/claimsMappingPolicies/{claims_mapping_policy_ID}"
   }
   

Krok 4. Ochrona funkcji platformy Azure

Rozszerzenie uwierzytelniania niestandardowego firmy Microsoft używa serwera do przepływu serwera w celu uzyskania tokenu dostępu wysyłanego w nagłówku HTTP Authorization do funkcji platformy Azure. Podczas publikowania funkcji na platformie Azure, zwłaszcza w środowisku produkcyjnym, należy zweryfikować token wysłany w nagłówku autoryzacji.

Aby chronić funkcję platformy Azure, wykonaj następujące kroki, aby zintegrować uwierzytelnianie firmy Microsoft Entra, aby weryfikować tokeny przychodzące z rejestracją aplikacji interfejsu API zdarzeń uwierzytelniania usługi Azure Functions. Wybierz jedną z następujących kart na podstawie typu dzierżawy.

Uwaga

Jeśli aplikacja funkcji platformy Azure jest hostowana w innej dzierżawie platformy Azure niż dzierżawa, w której zarejestrowano rozszerzenie uwierzytelniania niestandardowego, wybierz kartę Open ID Connect .

4.1 Przy użyciu dostawcy tożsamości firmy Microsoft Entra

Wykonaj poniższe kroki, aby dodać firmę Microsoft Entra jako dostawcę tożsamości do aplikacji funkcji platformy Azure.

Dzierżawa pracowników

1. W witrynie Azure Portal znajdź i wybierz wcześniej opublikowaną aplikację funkcji.

2. W obszarze Ustawienia wybierz pozycję Uwierzytelnianie.

3. Wybierz pozycję Dodaj dostawcę tożsamości.

4. Wybierz pozycję Microsoft jako dostawcę tożsamości.

5. Wybierz pozycję Pracownicy jako typ dzierżawy.

6. W obszarze Rejestracja aplikacji wybierz pozycję Wybierz istniejącą rejestrację aplikacji w tym katalogu dla typu rejestracji aplikacji, a następnie wybierz rejestrację aplikacji interfejsu API zdarzeń uwierzytelniania usługi Azure Functions utworzoną wcześniej podczas rejestrowania niestandardowego dostawcy oświadczeń.

7. Wprowadź następujący adres URL wystawcy, https://login.microsoftonline.com/{tenantId}/v2.0, gdzie {tenantId} jest identyfikatorem dzierżawy pracowników.

8. W obszarze Wymaganie aplikacji klienckiej wybierz pozycję Zezwalaj na żądania z określonych aplikacji klienckich i wprowadź wartość 99045fe1-7639-4a75-9d4a-577b6ca3810f.

9. W obszarze Wymaganie dotyczące dzierżawy wybierz pozycję Zezwalaj na żądania z określonych dzierżaw i wprowadź identyfikator dzierżawy pracowników.

10. W obszarze Żądania nieuwierzytelnione wybierz pozycję HTTP 401 Brak autoryzacji jako dostawca tożsamości.

11. Usuń zaznaczenie opcji Magazyn tokenów.

12. Wybierz pozycję Dodaj , aby dodać uwierzytelnianie do funkcji platformy Azure.

    

Dzierżawa zewnętrzna

1. W witrynie Azure Portal znajdź i wybierz wcześniej opublikowaną aplikację funkcji.

2. W obszarze Ustawienia wybierz pozycję Uwierzytelnianie.

3. Wybierz pozycję Dodaj dostawcę tożsamości.

4. Wybierz pozycję Microsoft jako dostawcę tożsamości.

5. Wybierz pozycję Konfiguracja zewnętrzna jako typ dzierżawy.

6. W obszarze Rejestracja aplikacji wybierz pozycję Podaj szczegóły istniejącej rejestracji aplikacji dla typu rejestracji aplikacji, a następnie wprowadź client_id rejestrację aplikacji interfejsu API zdarzeń uwierzytelniania usługi Azure Functions utworzoną wcześniej podczas rejestrowania niestandardowego dostawcy oświadczeń.

7. W polu Adres URL wystawcy wprowadź następujący adres URL https://{domainName}.ciamlogin.com/{tenant_id}/v2.0, gdzie

   • {domainName} to nazwa domeny dzierżawy zewnętrznej w postaci {domainName}.contoso.com.
   • {tenantId} to identyfikator dzierżawy dzierżawy zewnętrznej.

8. W obszarze Wymaganie aplikacji klienckiej wybierz pozycję Zezwalaj na żądania z określonych aplikacji klienckich i wprowadź wartość 99045fe1-7639-4a75-9d4a-577b6ca3810f.

9. W obszarze Wymaganie dotyczące dzierżawy wybierz pozycję Zezwalaj na żądania z określonych dzierżaw i wprowadź identyfikator dzierżawy zewnętrznej.

10. W obszarze Żądania nieuwierzytelnione wybierz pozycję HTTP 401 Brak autoryzacji jako dostawca tożsamości.

11. Usuń zaznaczenie opcji Magazyn tokenów.

12. Wybierz pozycję Dodaj , aby dodać uwierzytelnianie do funkcji platformy Azure.

    

4.2 Używanie dostawcy tożsamości OpenID Connect

Jeśli skonfigurowano dostawcę tożsamości firmy Microsoft, pomiń ten krok. W przeciwnym razie, jeśli funkcja platformy Azure jest hostowana w innej dzierżawie niż dzierżawa, w której zarejestrowano rozszerzenie uwierzytelniania niestandardowego, wykonaj następujące kroki, aby chronić funkcję:

Tworzenie wpisu tajnego klienta

1. Na stronie głównej witryny Azure Portal wybierz pozycję Microsoft Entra ID> Rejestracje aplikacji.
2. Wybierz utworzoną wcześniej rejestrację aplikacji interfejsu API zdarzeń uwierzytelniania usługi Azure Functions.
3. Wybierz pozycję Certyfikaty i wpisy tajne Klienta Wpisy>tajne> Nowego klienta.
4. Wybierz wygaśnięcie wpisu tajnego lub określ okres istnienia niestandardowego, dodaj opis i wybierz pozycję Dodaj.
5. Zapisz wartość wpisu tajnego do użycia w kodzie aplikacji klienckiej. Po opuszczeniu tej strony wartość klucza tajnego nie jest nigdy wyświetlana ponowna.

Dodaj dostawcę tożsamości OpenID Connect do aplikacji funkcji platformy Azure.

1. Znajdź i wybierz opublikowaną wcześniej aplikację funkcji.

2. W obszarze Ustawienia wybierz pozycję Uwierzytelnianie.

3. Wybierz pozycję Dodaj dostawcę tożsamości.

4. Wybierz pozycję OpenID Connect jako dostawca tożsamości.

5. Podaj nazwę, taką jak Contoso Microsoft Entra ID.

6. W obszarze Wpis Metadane wprowadź następujący adres URL do adresu URL dokumentu. Zastąp element identyfikatorem {tenantId} dzierżawy firmy Microsoft Entra.

   https://login.microsoftonline.com/{tenantId}/v2.0/.well-known/openid-configuration
   

7. W obszarze Rejestracja aplikacji wprowadź identyfikator aplikacji (identyfikator klienta) utworzonej wcześniej rejestracji aplikacji interfejsu API uwierzytelniania usługi Azure Functions.

8. Wróć do funkcji platformy Azure w obszarze Rejestracja aplikacji wprowadź klucz tajny klienta.

9. Usuń zaznaczenie opcji Magazyn tokenów.

10. Wybierz pozycję Dodaj , aby dodać dostawcę tożsamości OpenID Connect.

Krok 5. Testowanie aplikacji

Aby przetestować niestandardowego dostawcę oświadczeń, wykonaj następujące kroki:

Dzierżawa pracowników

1. Otwórz nową prywatną przeglądarkę i przejdź do adresu URL i zaloguj się za pomocą następującego adresu URL.

   https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/authorize?client_id={App_to_enrich_ID}&response_type=id_token&redirect_uri=https://jwt.ms&scope=openid&state=12345&nonce=12345
   

2. Zastąp {tenantId} ciąg identyfikatorem dzierżawy, nazwą dzierżawy lub jedną ze zweryfikowanych nazw domen. Na przykład contoso.onmicrosoft.com.

3. Zastąp element {App_to_enrich_ID} identyfikatorem klienta aplikacji Moja aplikacja testowa.

4. Po zalogowaniu zostanie wyświetlony dekodowany token pod adresem https://jwt.ms. Sprawdź, czy oświadczenia z funkcji platformy Azure są prezentowane w zdekodowanym tokenie, na przykład dateOfBirth.

Dzierżawa zewnętrzna

1. Otwórz nową prywatną przeglądarkę i przejdź do adresu URL i zaloguj się za pomocą następującego adresu URL.

   https://{domainName}.ciamlogin.com/{tenantId}/oauth2/v2.0/authorize?client_id={App_to_enrich_ID}&response_type=id_token&redirect_uri=https://jwt.ms&scope=openid&state=12345&nonce=12345
   

2. Zastąp {domainName} ciąg nazwą domeny, na przykład contoso.

3. Zastąp {tenantId} ciąg identyfikatorem dzierżawy, nazwą dzierżawy lub jedną ze zweryfikowanych nazw domen. Na przykład contoso.onmicrosoft.com.

4. Zastąp element {App_to_enrich_ID} identyfikatorem klienta aplikacji Moja aplikacja testowa.

5. Przejdź przez skonfigurowany przepływ logowania użytkownika i zaakceptuj żądane uprawnienia.

6. Po zalogowaniu zostanie wyświetlony dekodowany token pod adresem https://jwt.ms. Sprawdź, czy oświadczenia z funkcji platformy Azure są prezentowane w zdekodowanym tokenie, na przykład dateOfBirth.

Zobacz też

• Konfigurowanie aplikacji SAML do odbierania tokenów z oświadczeniami ze sklepu zewnętrznego
• Dokumentacja dostawcy oświadczeń niestandardowych
• Rozwiązywanie problemów z niestandardowym interfejsem API rozszerzeń uwierzytelniania