Risolvere i problemi di convalida delle sottoscrizioni di Griglia di eventi di Azure

Durante la creazione di una sottoscrizione evento, se viene visualizzato un messaggio di errore, The attempt to validate the provided endpoint https://your-endpoint-here failed. For more details, visit https://aka.ms/esvalidationad esempio , indica che si verifica un errore nell'handshake di convalida. Per risolvere questo errore, verificare gli aspetti seguenti:

  • Eseguire un POST HTTP all'URL webhook con un corpo della richiesta SubscriptionValidationEvent di esempio usando Postman o curl o strumento simile.
  • Se il webhook implementa il meccanismo handshake di convalida sincrona, verificare che Il codice di convalida venga restituito come parte della risposta.
  • Se il webhook implementa il meccanismo handshake di convalida asincrona, verificare che il post HTTP restituisca 200 OK.
  • Se il webhook viene restituito 403 (Forbidden) nella risposta, verificare se il webhook è dietro un gateway applicazione di Azure o Web application firewall. In caso affermativo, è necessario disabilitare queste regole del firewall e eseguire di nuovo un POST HTTP:
    • 920300 (Richiesta mancante di un'intestazione di accettazione)
    • 942430 (rilevamento anomalie di caratteri con restrizioni SQL): # di caratteri speciali superati (12))
    • 920230 (è stata rilevata più codifica URL)
    • 942130 (attacco di inserimento SQL: SQL tautologia rilevata.
    • 931130 (possibile attacco RFI (Remote File Inclusion) = Riferimenti al dominio non valido/collegamento)

Importante

Per informazioni dettagliate sulla convalida degli endpoint per webhook, vedere Recapito di eventi webhook.

Le sezioni seguenti illustrano come convalidare le sottoscrizioni di un evento usando Postman e Curl.

Convalidare la sottoscrizione di eventi di Griglia di eventi con Postman

Di seguito è riportato un esempio d'uso di Postman per la convalida di una sottoscrizione webhook di un evento di Griglia di eventi:

Event grid event subscription validation using Postman

Viene riportato un file .json SubscriptionValidationEvent di evento:

[
  {
    "id": "2d1781af-3a4c-4d7c-bd0c-e34b19da4e66",
    "topic": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "subject": "",
    "data": {
      "validationCode": "512d38b6-c7b8-40c8-89fe-f46f9e9622b6",
    },
    "eventType": "Microsoft.EventGrid.SubscriptionValidationEvent",
    "eventTime": "2018-01-25T22:12:19.4556811Z",
    "metadataVersion": "1",
    "dataVersion": "1"
  }
]

Di seguito è riportato l'esempio di risposta riuscita:

{
  "validationResponse": "512d38b6-c7b8-40c8-89fe-f46f9e9622b6"
}

Per altre informazioni sulla convalida degli eventi di Griglia di eventi per webhook, vedere Convalida dell'endpoint con eventi di Griglia di eventi.

Convalidare la sottoscrizione di eventi di Griglia di eventi con Curl

Di seguito è riportato un comando Curl di esempio per la convalida di una sottoscrizione webhook di un evento di Griglia di eventi:

curl -X POST -d '[{"id": "2d1781af-3a4c-4d7c-bd0c-e34b19da4e66","topic": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","subject": "","data": {"validationCode": "512d38b6-c7b8-40c8-89fe-f46f9e9622b6"},"eventType": "Microsoft.EventGrid.SubscriptionValidationEvent","eventTime": "2018-01-25T22:12:19.4556811Z", "metadataVersion": "1","dataVersion": "1"}]' -H 'Content-Type: application/json' https://{your-webhook-url.com}

Convalidare la sottoscrizione di eventi cloud con Postman

Di seguito è riportato un esempio d'uso di Postman per la convalida di una sottoscrizione webhook di un evento cloud:

Cloud event subscription validation using Postman

Usare il metodo HTTP OPTIONS per la convalida con eventi cloud. Per altre informazioni sulla convalida di eventi cloud per webhook, vedere Convalida dell'endpoint con eventi cloud.

Risolvere i problemi relativi alla convalida della sottoscrizione di eventi

Passaggi successivi

Per altre informazioni, pubblicare il problema nel Forum Stack Overflow oppure aprire un ticket di supporto.