WSFederationAuthenticationModule.RedirectToIdentityProvider 메서드

정의

네임스페이스:

System.IdentityModel.Services

어셈블리:

System.IdentityModel.Services.dll

Issuer 속성에 지정된 사용자가 STS(보안 토큰 서비스)로 리디렉션하여 WS-Federation 프로토콜을 사용하여 보안 토큰을 받습니다.

public:
 virtual void RedirectToIdentityProvider(System::String ^ uniqueId, System::String ^ returnUrl, bool persist);

public virtual void RedirectToIdentityProvider (string uniqueId, string returnUrl, bool persist);

abstract member RedirectToIdentityProvider : string * string * bool -> unit
override this.RedirectToIdentityProvider : string * string * bool -> unit

Public Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)

매개 변수

uniqueId

String

WSFAM은 이 값을 WS 페더레이션 로그인 요청의 wctx 매개 변수에 저장하지만 모듈은 로그인 요청 또는 로그인 응답을 처리할 때는 이 값을 사용하지 않습니다. 임의의 값으로 설정할 수 있습니다. 중복되어도 문제가 없습니다. 자세한 내용은 CreateSignInRequest(String, String, Boolean) 메서드를 참조하세요.

returnUrl

String

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

persist

Boolean

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

예외

InvalidOperationException

Issuer이 null 또는 빈 문자열인 경우

또는

Realm이 null 또는 빈 문자열인 경우

또는

Current 속성이 null이거나 비어 있습니다.

또는

Response에서 반환된 컨텍스트의 Current 속성이 null이거나 비어 있습니다.

설명

메서드는 RedirectToIdentityProvider 요청이 RP(신뢰 당사자)가 제공하는 웹 페이지 또는 이벤트 처리기 대리자에서 요청이 발급될 때 메서드에서 OnEndRequest 호출 SignIn 되어 권한 부여 실패 시 ID 공급자에 수동 리디렉션을 수행합니다.

메서드에 전달된 매개 변수는 wctx 메시지 매개 변수를 만드는 데 사용됩니다. 유일한 중요한 매개 변수는 매개 변수입니다 returnUrl . 이렇게 하면 RP가 성공적인 인증을 수행하도록 브라우저에 지시해야 하는 URL이 지정됩니다. 속성에 의해 Reply 지정되고 STS(보안 토큰 서비스)가 응답을 지시해야 하는 RP에서 주소를 제공하는 wreply 메시지 매개 변수와 혼동해서는 안 됩니다.

메서드는 다음을 수행합니다.

1. 메서드를 VerifyProperties 호출하여 모듈에서 유효한 로그인 요청을 실행할 수 있는지 확인합니다.

2. 메서드를 CreateSignInRequest 호출하여 모듈에 구성된 속성에서 로그인 요청을 만듭니다.

3. 호출 하는 OnRedirectingToIdentityProvider 발생 하는 방법의 RedirectingToIdentityProvider 이벤트입니다. 이 이벤트에 대한 이벤트 처리기에서 리디렉션을 취소하거나 로그인 요청 메시지를 수정할 수 있습니다.