Partager via

WS_VALIDATE_SAML_CALLBACK fonction de rappel (webservices.h)

  • Article

Valide une assertion SAML. Si une assertion SAML reçue réussit les vérifications de vérification de signature qui garantissent que la signature SAML a été émise par un émetteur approuvé, ce rappel est appelé pour permettre à l’application d’effectuer une validation supplémentaire sur la forme XML de l’assertion SAML. Ce rappel est censé retourner S_OK si l’assertion SAML a été validée, S_FALSE lorsque l’assertion n’a pas pu être validée et une valeur d’erreur si une erreur inattendue s’est produite. Le renvoi d’un résultat autre que S_OK à partir de ce rappel entraîne l’échec du message de réception associé avec une erreur de sécurité.

Comme pour tous les rappels de sécurité, l’application doit s’attendre à recevoir ce rappel à tout moment entre l’ouverture et la fermeture de l’écouteur, mais il ne sera jamais appelé lorsqu’un écouteur n’est pas ouvert.

Syntaxe

WS_VALIDATE_SAML_CALLBACK WsValidateSamlCallback;

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

Paramètres

[in, optional] samlValidatorCallbackState

État à renvoyer lors de l’appel de ce rappel.

[in] samlAssertion

Assertion SAML reçue qui a subi une signature réussie case activée.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction de rappel ne retourne pas de valeur.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête webservices.h