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 VALOR 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.
Valor | Descripción |
---|---|
S_OK | Método realizado correctamente. |
E_ACCESSDENIED | Acceso denegado. |
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 |
Comentarios
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ña, 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 obtener más información, consulte la interfaz ISSOAdmin.
Requisitos
Plataformas: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 y Windows 10
Consulte también
Interfaz ISSONotification
Miembros de ISSONotification
Programación con Enterprise Single Sign-On