WSFederationAuthenticationModule.CreateSignInRequest 메서드

정의

모듈에 구성된 WS-Federation 매개 변수를 사용하여 WS-Federation 로그인 요청 메시지를 만듭니다.

public:
 System::IdentityModel::Services::SignInRequestMessage ^ CreateSignInRequest(System::String ^ uniqueId, System::String ^ returnUrl, bool rememberMeSet);
public System.IdentityModel.Services.SignInRequestMessage CreateSignInRequest (string uniqueId, string returnUrl, bool rememberMeSet);
member this.CreateSignInRequest : string * string * bool -> System.IdentityModel.Services.SignInRequestMessage
Public Function CreateSignInRequest (uniqueId As String, returnUrl As String, rememberMeSet As Boolean) As SignInRequestMessage

매개 변수

uniqueId
String

WSFAM은 이 값을 WS 페더레이션 로그인 요청의 wctx 매개 변수에 저장하지만 모듈은 로그인 요청 또는 로그인 응답을 처리할 때는 이 값을 사용하지 않습니다. 임의의 값으로 설정할 수 있습니다. 중복되어도 문제가 없습니다.

returnUrl
String

인증 시 모듈이 반환되어야 하는 URL입니다.

rememberMeSet
Boolean

WSFAM은 이 값을 WS 페더레이션 로그인 요청의 wctx 매개 변수에 저장하지만 모듈은 로그인 요청 또는 로그인 응답을 처리할 때는 이 값을 사용하지 않습니다. true 또는 false로 설정할 수 있습니다.

반환

WS-Federation 로그인 요청 메시지입니다.

예외

Issuer속성이 null이거나 빈 문자열입니다.

또는

Realm속성이 null이거나 빈 문자열입니다.

설명

개체로 표시되는 SignInRequestMessage WS-Federation 로그인 요청을 만듭니다. 새 SignInRequestMessage 개체의 속성은 다음과 같이 설정됩니다.

  • Context 속성(wctx 매개 변수)은 메서드 매개 변수를 사용하여 만든 값으로 설정됩니다.

  • CurrentTime 속성(wct 매개 변수)은 현재 시간으로 설정됩니다.

  • 다른 모든 속성은 현재 instance 해당하는 속성을 사용하여 설정됩니다.

메서드에 전달된 매개 변수는 wctx 메시지 매개 변수를 만드는 데 사용됩니다. 형식이 인 ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId문자열입니다.

  • 값은 ru 메서드에 전달된 매개 변수의 returnUrl 값으로 설정되며 모듈이 성공적인 인증을 수행하도록 브라우저에 지시해야 하는 URL을 지정합니다. WSFAM에서 사용하는 wctx 문자열에 저장된 유일한 값입니다. 모듈은 메서드를 GetReturnUrlFromResponse 호출하여 WS-Federation 로그인 응답을 처리할 때 wctx 매개 변수에서 이 값을 추출합니다. 속성에 의해 Reply 지정되고 STS(보안 토큰 서비스)가 응답을 지시해야 하는 RP에서 주소를 제공하는 wreply 메시지 매개 변수와 혼동해서는 안 됩니다.

  • cx 매개 변수는 속성 값으로 설정됩니다SignInContext. Wctx 문자열에 저장 되어야 하는 모든 애플리케이션 정의 컨텍스트를 설정 하는 데 사용할 수 있도록이 속성은 그러나 WSFAM은 응답에서이 값을 추출 하는 메서드를 노출 하지 않습니다. 값은 애플리케이션에서 필요한 경우 wctx 문자열을 구문 분석 하 고 응답을 처리할 때이 값을 읽는 코드를 제공 해야 합니다. 메서드를 재정의 GetReturnUrlFromResponse 하여 이 작업을 수행할 수 있습니다.

  • 매개 변수 값 rm 으로 설정된 값이나 id 매개 변수 값 rememberMeSet 으로 uniqueId 설정된 매개 변수는 WSFAM에서 사용되지 않습니다. 이러한 값은 모든 값으로 설정할 수 있습니다.

합니다 CreateSignInRequest 에서 메서드를 호출 합니다 RedirectToIdentityProvider 메서드.

적용 대상

추가 정보