WsRequestSecurityToken 함수(webservices.h)

페더레이션 시나리오에서 토큰 발급자 역할을 하는 STS(보안 토큰 서비스)에서 보안 토큰을 가져옵니다. 이 함수는 클라이언트 쪽에서 사용되며 보안 토큰을 가져오거나 협상 프로세스가 실패할 때까지 STS와 WS-Trust 기반 협상 단계를 수행합니다.

구문

HRESULT WsRequestSecurityToken(
  [in]           WS_CHANNEL                               *channel,
                 const WS_REQUEST_SECURITY_TOKEN_PROPERTY *properties,
  [in]           ULONG                                    propertyCount,
                 WS_SECURITY_TOKEN                        **token,
  [in, optional] const WS_ASYNC_CONTEXT                   *asyncContext,
  [in, optional] WS_ERROR                                 *error
);

매개 변수

[in] channel

보안 토큰을 얻기 위한 협상이 이뤄져야 하는 채널입니다.

제공된 채널은 발급자의 보안 요구 사항을 충족하기 위해 적절한 WS_SECURITY_DESCRIPTION만든 다음 발급자의 WS_ENDPOINT_ADDRESS열어야 합니다. 호출자는 이 함수가 완료된 후 채널을 닫 고 해제하는 작업도 담당합니다.

따라서 채널은 이 함수가 호출될 때 WS_CHANNEL_STATE_OPEN 상태여야 합니다. 이 함수를 성공적으로 완료하면 채널이 WS_CHANNEL_STATE_OPEN 상태가 됩니다. 완료에 실패하면 상태 WS_CHANNEL_STATE_OPEN 또는 상태 WS_CHANNEL_STATE_FAULTED.

properties

발급자와의 협상 프로세스에 사용할 선택적 설정 그룹입니다.

[in] propertyCount

속성 배열의 항목 수입니다.

token

가져온 XML 보안 토큰입니다. 함수 호출이 성공적으로 완료되면 설정되며 함수를 실행하는 동안 오류가 발생하면 수정되지 않습니다.

반환된 보안 토큰은 서비스에 제공될 경우 WS_XML_TOKEN_MESSAGE_SECURITY_BINDING 함께 사용할 수 있습니다. 토큰은 더 이상 필요하지 않은 경우 WsFreeSecurityToken 을 사용하여 해제해야 합니다.

[in, optional] asyncContext

함수를 비동기적으로 호출하는 방법 또는 동기적으로 호출하는 경우 NULL 에 대한 정보입니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
WS_S_ASYNC	비동기 작업은 아직 보류 중입니다.

설명

Windows 7 및 Windows Server 2008 R2: WWSAPI는 LWSSP(경량 웹 서비스 보안 프로필)에 정의된 Ws-Trust 및 Ws-SecureConversation만 지원합니다. Microsoft의 구현에 대한 자세한 내용은 LWSSP의 MESSAGE 구문 섹션을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	webservices.h
라이브러리	WebServices.lib
DLL	WebServices.dll