Compartir a través de

WS_VALIDATE_SAML_CALLBACK función de devolución de llamada (webservices.h)

  • Artículo

Valida una aserción de SAML. Si una aserción de SAML recibida pasa las comprobaciones de comprobación de firma que garantizan que un emisor de confianza emitió samL, se invoca esta devolución de llamada para permitir que la aplicación realice una validación adicional en el formulario XML de la aserción de SAML. Se espera que esta devolución de llamada devuelva S_OK si la aserción de SAML se validó correctamente, S_FALSE cuando no se pudo validar la aserción y un valor de error si se produjo un error inesperado. Devolver cualquier resultado distinto de S_OK de esta devolución de llamada producirá un error de seguridad en el mensaje de recepción asociado.

Al igual que con todas las devoluciones de llamada de seguridad, la aplicación debe esperar recibir esta devolución de llamada en cualquier momento entre el agente de escucha abierto y el cierre, pero nunca se invocará cuando un agente de escucha no esté abierto.

Sintaxis

WS_VALIDATE_SAML_CALLBACK WsValidateSamlCallback;

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

Parámetros

[in, optional] samlValidatorCallbackState

Estado que se va a devolver al invocar esta devolución de llamada.

[in] samlAssertion

La aserción de SAML recibida que se ha sometido a una comprobación de firma correcta.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función de devolución de llamada no devuelve un valor.

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado webservices.h