Método ISSONotification.SendNotification

 

Envía una notificación, como un cambio de contraseña, desde el adaptador al sistema ENTSSO.

Sintaxis

  
HRESULT SendNotification(  
SSendNotification SendNotification,  
GUID* pguidTrackingId  
);  

Parámetros

SendNotification
[in] Notificación para enviar a ENTSSO desde el adaptador.

pguidTrackingId
[out] Cuando se devuelve este método, contiene el Id. de seguimiento generado por ENTSSO. Puede usar el Id. de seguimiento para fines de auditoría o para correlacionar respuestas a solicitudes. Puede ser NULL.

Valor devuelto

Este método devuelve un HRESULT que indica si se completó correctamente. Para obtener más información, consulte la sección Valores de error.

Valores de error

Este método devuelve un HRESULT que contiene uno de los valores de la siguiente tabla.

Value Descripción
S_OK Método realizado correctamente.
E_ACCESSDENIED Deniega el acceso.
ENTSSO_E_NO_SERVER No se pudo establecer conexión con el servidor ENTSSO. Compruebe que el servicio ENTSSO está en ejecución.
ENTSSO_E_WRONG_STATE Este método se ha llamado en el estado incorrecto.
ENTSSO_E_INVALID_NOTIFICATION Tipo de notificación no válido

Observaciones

Puede usar SendNotification para enviar cambios de contraseña y otras notificaciones al sistema ENTSSO.

Si SendNotification devuelve S_OK, esto no significa que se haya completado un cambio de contraseña en el sistema de destino. Por el contrario, recibir S_OK significa que ENTSSO ha aceptado y llevará a cabo finalmente la solicitud.

El cambio de contraseña desde un sistema externo puede tener varias consecuencias:

  • Si se configura una sincronización de contraseñas parcial, puede actualizarse la base de datos de SSO si existe una asignación actual para la cuenta externa.

  • Si se configura una sincronización de contraseñas total, entonces el cambio de contraseña también podría hacerse para una cuenta de Windows.

Si la cuenta externa no dispone de una asignación actual en la base de datos de SSO, el cambio de contraseña podría no tener efecto.

La notificación de haber llevado a cabo el cambio de contraseña se envía cuando ENTSSO considera finalizado tal cambio, lo que, como se dijo anteriormente, puede tener diferentes significados. En determinadas circunstancias, eso puede significar que no se llevó a cabo ningún cambio, que únicamente se actualizó la base de datos de SSO, o que se cambió la contraseña de Windows.

Tenga en cuenta que las notificaciones de haber llevado a cabo el cambio de contraseña que se devuelven al adaptador no son totalmente confiables. En determinadas condiciones de error, el inicio de sesión único puede no recibir nunca las notificaciones solicitadas.

En ENTSSO, la definición de credenciales, como las enviadas por SendNotification para las actualizaciones de contraseñas, es más flexible que una contraseña simple. Cuando define una aplicación de SSO, también define los campos de credenciales. Los campos identifican las etiquetas que hay que usar en los campos de interfaz de usuario, y si tales campos están enmascarados o no. Además, existe también un indicador especial que especifica si el campo debe sincronizarse o no. El campo 0 es un caso especial y define la etiqueta para el identificador de usuario. Para más información, consulte la interfaz ISSOAdmin.

Requisitos

Plataformas: Windows

Consulte también

Interfaz ISSONotification
Miembros de ISSONotification
Programación con Enterprise Single Sign-On