Risolvere i problemi relativi all'API del provider di attestazioni personalizzato

1. Per scopi di sviluppo e test locali, aprire local.settings.json e sostituire il codice con il codice JSON seguente:

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

   Nota

   Se è stato usato il pacchetto NuGet Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents , assicurarsi di impostare "AuthenticationEvents__BypassTokenValidation" : true per scopi di test locali.

2. Usando lo strumento di test api preferito, creare una nuova richiesta HTTP e impostare il metodo HTTP su 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"
               }
           }
       }
   }
   

   Suggerimento

   Se si usa un token di accesso ottenuto da Microsoft Entra ID, selezionare Autorizzazione e quindi token di connessione, quindi incollare il token di accesso ricevuto da Microsoft Entra ID.

4. Selezionare Invia e si dovrebbe ricevere una risposta JSON simile alla seguente:

   {
       "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 almeno come Amministratore applicazione cloud.

2. Passare a Identità>Applicazioni>Registrazioni applicazioni.

3. Selezionare la registrazione dell'app per le API degli eventi di autenticazione Funzioni di Azure, configurata in precedenza in Configurare un provider di attestazioni personalizzato per un evento di rilascio del token.

4. Copiare l'ID applicazione.

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 client.
   3. Selezionare una scadenza per il segreto o specificare una durata personalizzata.
   4. Selezionare Aggiungi.
   5. Registrare il valore del segreto da usare nel codice dell'applicazione client. 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/00001111-aaaa-2222-bbbb-3333cccc4444.

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

8. Modificare il metodo HTTP in POST.

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

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

10. In Corpo selezionare form-data e aggiungere le chiavi seguenti:

    Chiave	valore
    grant_type	client_credentials
    client_id	ID client dell'applicazione.
    client_secret	Segreto client dell'applicazione.
    scope	URI ID applicazione dell'applicazione, quindi aggiungere .default. Ad esempio, api://contoso.azurewebsites.net/00001111-aaaa-2222-bbbb-3333cccc4444/.default

11. Eseguire la query HTTP e copiare l'oggetto access_token nell'app https://jwt.ms Web.

12. Confrontare con il nome dell'autorità iss di certificazione configurata nell'API.

13. Confrontare con l'ID aud client configurato nell'API.