WS_USERNAME_MESSAGE_SECURITY_BINDING 구조체(webservices.h)

애플리케이션 제공 사용자 이름/암호 쌍을 직접(즉, 원샷) 보안 토큰으로 사용하도록 지정하기 위한 보안 바인딩 하위 형식입니다. 이 보안 바인딩은 메시지 보안에만 사용할 수 있습니다. 클라이언트 인증을 제공하지만 트래픽 서명 또는 암호화는 제공하지 않습니다. 따라서 메시지 보호를 제공하는 다른 전송 보안 또는 메시지 보안 바인딩과 함께 사용됩니다.

이 바인딩의 instance 보안 설명에 하나만 있을 수 있습니다. 이 보안 바인딩은 WS_NAMEDPIPE_CHANNEL_BINDING 지원되지 않습니다.

이 보안 바인딩을 사용하면 보안 바인딩 속성을 지정할 수 없습니다.

구문

typedef struct _WS_USERNAME_MESSAGE_SECURITY_BINDING {
  WS_SECURITY_BINDING           binding;
  WS_MESSAGE_SECURITY_USAGE     bindingUsage;
  WS_USERNAME_CREDENTIAL        *clientCredential;
  WS_VALIDATE_PASSWORD_CALLBACK passwordValidator;
  void                          *passwordValidatorCallbackState;
} WS_USERNAME_MESSAGE_SECURITY_BINDING;

멤버

binding

이 보안 바인딩 하위 형식 및 기타 모든 보안 바인딩 하위 형식이 파생되는 기본 형식입니다.

bindingUsage

이 보안 바인딩에 해당하는 보안 토큰을 메시지에 바인딩하는 방법

WS_SUPPORTING_MESSAGE_SECURITY_USAGE만 지원됩니다. 이 사용을 통해 이 보안 바인딩은 클라이언트 인증을 제공하지만 메시지 보호(예: 서명, 암호화, 재생 검색)는 제공하지 않습니다. 따라서 이 바인딩은 보호된 채널을 제공하는 WS_SSL_TRANSPORT_SECURITY_BINDING 같은 다른 보안 바인딩과 함께 사용해야 합니다.

SSL이 없는 HTTP에서 이 바인딩을 사용하려면 보안 설명 속성 WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL 명시적으로 WS_PROTECTION_LEVEL_NONE 설정해야 합니다. 클라이언트 또는 TCP에서는 지원되지 않습니다.

clientCredential

이 보안 바인딩에 사용할 사용자 이름 자격 증명입니다. 클라이언트에서 이 보안 바인딩을 사용할 때 지정해야 합니다.

passwordValidator

수신된 사용자 이름/암호 쌍을 검사 데 사용할 유효성 검사기입니다. 서비스에서 이 보안 바인딩을 사용할 때 지정해야 합니다.

passwordValidatorCallbackState

사용자 이름 유효성 검사기가 호출될 때 인수로 전달할 선택적 상태입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글	webservices.h