Risolvere i problemi relativi all'estensione di autenticazione personalizzata

1. For local development and testing purposes, open local.settings.json and replace the code with the following JSON:

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

   Note

   If you used the Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents NuGet package, be sure to set "AuthenticationEvents__BypassTokenValidation" : true for local testing purposes.

2. Using your preferred API testing tool, create a new HTTP request and set the HTTP method to POST.

3. Usare il corpo JSON seguente che imita la richiesta inviata da Microsoft Entra ID all'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"
               }
           }
       }
   }
   

   Tip

   If you're using an access token obtained from Microsoft Entra ID, select Authorization and then select Bearer token, then paste the access token you received from Microsoft Entra ID.

4. Select Send, and you should receive a JSON response similar to the following:

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

Dopo aver acquisito un token di accesso, passarlo all'intestazione HTTP Authorization . Per ottenere un token di accesso, seguire questa procedura:

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un amministratore di applicazioni cloud.

2. Browse to Entra ID>App registrations.

3. Seleziona la registrazione dell'app API degli eventi di autenticazione di Funzioni di Azure, precedentemente configurata in configurare un provider di attestazioni personalizzato per un evento di rilascio di token.

4. Copy the application ID.

5. Se non è stato creato un segreto dell'app, seguire questa procedura:

   1. Selezionare Certificati e segreti>Segreti client>Nuovo segreto client.
   2. Aggiungere una descrizione per il segreto del cliente.
   3. Selezionare una scadenza per il segreto o specificare una durata personalizzata.
   4. Select Add.
   5. Record the secret's value for use in your client application code. Questo valore del segreto non viene mai più visualizzato dopo aver lasciato questa pagina.

6. Dal menu selezionare Esporre un'API e copiare il valore dell'URI ID applicazione. Ad esempio: api://contoso.azurewebsites.net/aaaabbbb-0000-cccc-1111-dddd2222eeee.

7. Aprire lo strumento di test api preferito e creare una nuova query HTTP.

8. Change the HTTP method to POST.

9. Immettere l'URL seguente. Sostituire il {tenantID} con l'ID tenant.

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

10. Under the Body, select form-data and add the following keys:

    Key	Value
    grant_type	client_credentials
    client_id	The Client ID of your application.
    client_secret	The Client Secret of your application.
    scope	URI ID applicazione dell'applicazione, quindi aggiungere .default. Ad esempio, api://contoso.azurewebsites.net/aaaabbbb-0000-cccc-1111-dddd2222eeee/.default

11. Esegui la query HTTP e copia il access_token nella app Web https://jwt.ms.

12. Confronta il iss con il nome dell'emittente che hai configurato nella tua API.

13. Confronta il aud con l'ID client che hai configurato nella tua API.