다음을 통해 공유


ISSONotification.SendNotification 메서드

어댑터에서 ENTSSO 시스템으로 암호 변경과 같은 알림을 보냅니다.

문법

  
HRESULT SendNotification(  
SSendNotification SendNotification,  
GUID* pguidTrackingId  
);  

매개 변수

SendNotification
[in] 어댑터에서 ENTSSO로 보낼 알림입니다.

pguidTrackingId
[out] 이 메서드가 반환될 때 ENTSSO에서 생성된 추적 ID를 포함합니다. 추적 ID를 감사 목적으로 사용하거나 요청 응답의 상관 관계를 지정할 수 있습니다. NULL일 수 있습니다.

반환 값

이 메서드는 올바르게 완료되었는지 여부를 나타내는 HRESULT를 반환합니다. 자세한 내용은 오류 값 섹션을 참조하세요.

오류 값

이 메서드는 다음 표의 값 중 하나를 포함하는 HRESULT를 반환합니다.

가치 설명
S_OK 메서드가 성공했습니다.
E_ACCESSDENIED 액세스가 거부되었습니다.
ENTSSO_E_NO_SERVER ENTSSO 서버에 연결할 수 없습니다. ENTSSO 서비스가 실행 중인지 확인합니다.
ENTSSO_E_WRONG_STATE 이 메서드가 잘못된 상태에서 호출되었습니다.
ENTSSO_E_INVALID_NOTIFICATION 잘못된 알림 유형입니다.

비고

SendNotification을 사용하여 암호 변경 내용 및 기타 알림을 ENTSSO 시스템에 보낼 수 있습니다.

SendNotification이 S_OK 반환하는 경우 이는 대상 시스템에서 암호 변경이 완료되었음을 의미하지는 않습니다. 대신, S_OK 수신한다는 것은 ENTSSO가 수락하고 결국 요청을 완료한다는 것을 의미합니다.

외부 시스템에서 암호를 변경하면 다음과 같은 몇 가지 결과가 발생할 수 있습니다.

  • 부분 암호 동기화가 구성된 경우 외부 계정에 대한 현재 매핑이 있는 경우 SSO 데이터베이스가 업데이트될 수 있습니다.

  • 전체 암호 동기화가 구성된 경우 Windows 계정에서도 암호가 변경될 수 있습니다.

    외부 계정에 SSO 데이터베이스에 현재 매핑이 없으면 암호 변경이 적용되지 않을 수 있습니다.

    암호 변경 완료 알림은 위에서 설명한 대로 다른 항목을 의미할 수 있는 ENTSSO 관점에서 암호 변경이 완료된 것으로 간주될 때 발생합니다. 경우에 따라 변경이 수행되지 않거나 SSO 데이터베이스만 업데이트되었거나 Windows 암호가 변경되었음을 의미할 수 있습니다.

    어댑터로 다시 전송된 암호 변경 전체 알림은 완전히 신뢰할 수 없습니다. 일부 오류 조건에서는 Single Sign-On 요청된 알림을 실제로 받지 못할 수 있습니다.

    ENTSSO에서 암호 업데이트를 위해 SendNotification 에서 보낸 자격 증명과 같은 자격 증명의 정의는 간단한 암호보다 더 유연합니다. SSO 애플리케이션을 정의할 때 자격 증명 필드도 정의합니다. 필드는 UI 필드에 사용할 레이블과 해당 필드가 마스킹되었는지 여부를 식별합니다. 또한 필드를 동기화할지 여부를 지정하는 특수 플래그도 있습니다. 필드 0은 특수한 경우이며 사용자 ID에 대한 레이블을 정의합니다. 자세한 내용은 ISSOAdmin 인터페이스를 참조하세요.

요구 사항

플랫폼: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 및 Windows 10

또한 참조하십시오

ISSONotification 인터페이스(COM)
ISSONotification 멤버
Enterprise Single Sign-On을 사용한 프로그래밍