Solucionar problemas da API do provedor de declarações personalizado

1. Para fins de desenvolvimento local e testes, abra local.settings.json e substitua o código pelo seguinte JSON:

   {
     "IsEncrypted": false,
     "Values": {
       "AzureWebJobsStorage": "",
       "AzureWebJobsSecretStorageType": "files",
       "FUNCTIONS_WORKER_RUNTIME": "dotnet",
       "AuthenticationEvents__BypassTokenValidation" : false
     }
   }
   

   Nota

   Se você usou o pacote NuGet Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents, certifique-se de definir "AuthenticationEvents__BypassTokenValidation" : true para fins de teste local.

2. Usando sua ferramenta de teste de API preferida, crie uma nova solicitação HTTP e defina o método HTTP como POST.

3. Use o seguinte corpo JSON que imita a solicitação que o ID do Microsoft Entra envia para sua API REST.

   {
       "type": "microsoft.graph.authenticationEvent.tokenIssuanceStart",
       "source": "/tenants/aaaabbbb-0000-cccc-1111-dddd2222eeee/applications/00001111-aaaa-2222-bbbb-3333cccc4444",
       "data": {
           "@odata.type": "microsoft.graph.onTokenIssuanceStartCalloutData",
           "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
           "authenticationEventListenerId": "11112222-bbbb-3333-cccc-4444dddd5555",
           "customAuthenticationExtensionId": "22223333-cccc-4444-dddd-5555eeee6666",
           "authenticationContext": {
               "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
               "client": {
                   "ip": "127.0.0.1",
                   "locale": "en-us",
                   "market": "en-us"
               },
               "protocol": "OAUTH2.0",
               "clientServicePrincipal": {
                   "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
                   "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
                   "appDisplayName": "My Test application",
                   "displayName": "My Test application"
               },
               "resourceServicePrincipal": {
                   "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
                   "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
                   "appDisplayName": "My Test application",
                   "displayName": "My Test application"
               },
               "user": {
                   "companyName": "Casey Jensen",
                   "createdDateTime": "2023-08-16T00:00:00Z",
                   "displayName": "Casey Jensen",
                   "givenName": "Casey",
                   "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
                   "mail": "casey@contoso.com",
                   "onPremisesSamAccountName": "Casey Jensen",
                   "onPremisesSecurityIdentifier": "<Enter Security Identifier>",
                   "onPremisesUserPrincipalName": "Casey Jensen",
                   "preferredLanguage": "en-us",
                   "surname": "Jensen",
                   "userPrincipalName": "casey@contoso.com",
                   "userType": "Member"
               }
           }
       }
   }
   

   Gorjeta

   Se estiver a utilizar um token de acesso obtido a partir do Microsoft Entra ID, selecione Autorização e, em seguida, selecione Token de portador e, em seguida, cole o token de acesso que recebeu do Microsoft Entra ID.

4. Selecione Enviar e você deve receber uma resposta JSON semelhante à seguinte:

   {
       "data": {
           "@odata.type": "microsoft.graph.onTokenIssuanceStartResponseData",
           "actions": [
               {
                   "@odata.type": "microsoft.graph.tokenIssuanceStart.provideClaimsForToken",
                   "claims": {
                       "customClaim1": "customClaimValue1",
                       "customClaim2": [
                           "customClaimString1",
                           "customClaimString2" 
                       ]
                   }
               }
   
           ]
       }
   }
   

Depois de adquirir um token de acesso, passe-lhe o cabeçalho HTTP Authorization . Para obter um token de acesso, siga estes passos:

1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

2. Navegue até Registros de aplicativos de identidade>>.

3. Selecione o registro do aplicativo de API de eventos de autenticação do Azure Functions, configurado anteriormente em Configurar um provedor de declarações personalizado para um evento de emissão de token.

4. Copie o ID do aplicativo.

5. Se você não criou um segredo de aplicativo, siga estas etapas:

   1. Selecione Certificados & segredos Segredos do>cliente Novo segredo do>cliente.
   2. Adicione uma descrição do segredo do cliente.
   3. Selecione uma expiração para o segredo ou especifique um tempo de vida personalizado.
   4. Selecione Adicionar.
   5. Registre o valor do segredo para uso no código do aplicativo cliente. Este valor secreto nunca mais é apresentado depois de sair desta página.

6. No menu, selecione Expor uma API e copie o valor do URI da ID do aplicativo. Por exemplo, api://contoso.azurewebsites.net/00001111-aaaa-2222-bbbb-3333cccc4444.

7. Abra sua ferramenta de teste de API preferida e crie uma nova consulta HTTP.

8. Altere o método HTTP para POST.

9. Insira o seguinte URL. Substitua o {tenantID} pelo seu ID de locatário.

   https://login.microsoftonline.com/{tenantID}/oauth2/v2.0/token
   

10. Em Corpo, selecione dados de formulário e adicione as seguintes chaves:

    Key	valor
    grant_type	client_credentials
    client_id	A ID do Cliente da sua aplicação.
    client_secret	O segredo do cliente da sua aplicação.
    scope	O URI da ID do aplicativo do seu aplicativo e, em seguida, adicione .default. Por exemplo, api://contoso.azurewebsites.net/00001111-aaaa-2222-bbbb-3333cccc4444/.default

11. Execute a consulta HTTP e copie a access_token para o https://jwt.ms aplicativo Web.

12. Compare o iss com o nome do emissor que você configurou em sua API.

13. Compare o aud com o ID do cliente que você configurou em sua API.