Freigeben über

WS_VALIDATE_SAML_CALLBACK Rückruffunktion (webservices.h)

  • Artikel

Überprüft eine SAML-Assertion. Wenn eine empfangene SAML-Assertion die Signaturüberprüfungen besteht, die sicherstellen, dass die SAML von einem vertrauenswürdigen Aussteller ausgestellt wurde, wird dieser Rückruf aufgerufen, damit die Anwendung zusätzliche Überprüfungen für die XML-Form der SAML-Assertion durchführen kann. Von diesem Rückruf wird erwartet, dass S_OK zurückgegeben wird, wenn die SAML-Assertion erfolgreich überprüft wurde, S_FALSE, wenn die Assertion nicht überprüft werden konnte, und einen Fehlerwert, wenn ein unerwarteter Fehler aufgetreten ist. Das Zurückgeben eines anderen Ergebnisses als S_OK aus diesem Rückruf führt dazu, dass die zugeordnete Empfangsnachricht mit einem Sicherheitsfehler fehlschlägt.

Wie bei allen Sicherheitsrückrufen sollte die Anwendung erwarten, dass dieser Rückruf jederzeit zwischen dem Öffnen und Schließen des Listeners empfangen wird, aber es wird nie aufgerufen, wenn ein Listener nicht geöffnet ist.

Syntax

WS_VALIDATE_SAML_CALLBACK WsValidateSamlCallback;

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

Parameter

[in, optional] samlValidatorCallbackState

Der Zustand, der beim Aufrufen dieses Rückrufs zurückgegeben werden soll.

[in] samlAssertion

Die empfangene SAML-Assertion, die einer erfolgreichen Signaturprüfung unterzogen wurde.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile webservices.h