WS_VALIDATE_SAML_CALLBACK funzione di callback (webservices.h)

Convalida un'asserzione SAML. Se un'asserzione SAML ricevuta supera i controlli di verifica della firma che assicurano che SAML sia stato emesso da un'autorità di certificazione attendibile, questo callback viene richiamato per consentire all'applicazione di eseguire una convalida aggiuntiva nel formato XML dell'asserzione SAML. Questo callback dovrebbe restituire S_OK se l'asserzione SAML è stata convalidata correttamente, S_FALSE quando non è stato possibile convalidare l'asserzione e un valore di errore se si è verificato un errore imprevisto. La restituzione di qualsiasi risultato diverso da S_OK da questo callback comporterà l'esito negativo del messaggio di ricezione associato con un errore di sicurezza.

Come per tutti i callback di sicurezza, l'applicazione dovrebbe aspettarsi di ricevere questo callback in qualsiasi momento tra l'apertura e la chiusura del listener, ma non verrà mai richiamata quando un listener non è aperto.

Sintassi

WS_VALIDATE_SAML_CALLBACK WsValidateSamlCallback;

HRESULT WsValidateSamlCallback(
  [in, optional] void *samlValidatorCallbackState,
  [in]           WS_XML_BUFFER *samlAssertion,
  [in, optional] WS_ERROR *error
)
{...}

Parametri

[in, optional] samlValidatorCallbackState

Stato da passare di nuovo quando si richiama questo callback.

[in] samlAssertion

Asserzione SAML ricevuta che ha subito un controllo della firma riuscito.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback non restituisce un valore.

Requisiti