다음을 통해 공유


PassportIdentity.LoginUser 메서드

정의

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

오버로드

LoginUser()

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

LoginUser(String)

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

설명

이 클래스는 않으며는 지원 되지 않습니다. Microsoft Passport Network가 Windows Live ID로 대체되었습니다.

LoginUser()

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

public:
 int LoginUser();
public int LoginUser ();
member this.LoginUser : unit -> int
Public Function LoginUser () As Integer

반환

Int32

정수 결과 코드입니다.

설명

이 클래스는 않으며는 지원 되지 않습니다. Microsoft Passport Network가 Windows Live ID로 대체되었습니다.

적용 대상

LoginUser(String)

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

public:
 int LoginUser(System::String ^ strReturnUrl);
public int LoginUser (string strReturnUrl);
member this.LoginUser : string -> int
Public Function LoginUser (strReturnUrl As String) As Integer

매개 변수

strReturnUrl
String

로그인이 완료된 후 로그인 서버가 사용자를 리디렉션할 URL입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

반환

Int32

정수 결과 코드입니다.

설명

이 클래스는 않으며는 지원 되지 않습니다. Microsoft Passport Network가 Windows Live ID로 대체되었습니다.

적용 대상

LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

public:
 int LoginUser(System::String ^ szRetURL, int iTimeWindow, bool fForceLogin, System::String ^ szCOBrandArgs, int iLangID, System::String ^ strNameSpace, int iKPP, bool fUseSecureAuth, System::Object ^ oExtraParams);
public int LoginUser (string szRetURL, int iTimeWindow, bool fForceLogin, string szCOBrandArgs, int iLangID, string strNameSpace, int iKPP, bool fUseSecureAuth, object oExtraParams);
member this.LoginUser : string * int * bool * string * int * string * int * bool * obj -> int
Public Function LoginUser (szRetURL As String, iTimeWindow As Integer, fForceLogin As Boolean, szCOBrandArgs As String, iLangID As Integer, strNameSpace As String, iKPP As Integer, fUseSecureAuth As Boolean, oExtraParams As Object) As Integer

매개 변수

szRetURL
String

로그인이 완료된 후 로그인 서버가 사용자를 리디렉션할 URL입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

iTimeWindow
Int32

시간 값(초)입니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

fForceLogin
Boolean

로그인 서버에서 사용자가 마지막으로 로그인한 이후 시간과 iTimeWindow 매개 변수를 비교하도록 하려면 true이고, 마지막으로 티켓을 새로 고친 시간과 iTimeWindow를 비교하도록 하려면 false입니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

szCOBrandArgs
String

참가 요소의 Cobranding Template 스크립트 페이지 URL에 쿼리 문자열 변수로 추가할 변수를 지정하는 문자열입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

iLangID
Int32

로그인 페이지를 표시할 언어를 지정하는 LCID(로캘 식별자)입니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

strNameSpace
String

Passport 계정이 없는 사용자가 등록하도록 할 도메인 네임스페이스입니다. 지정된 네임스페이스는 Partner.xml CCD(Component Configuration Document)에 "도메인 이름" 항목으로 표시되어야 합니다. 일반적인 기본 네임스페이스는 "passport.com"입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

iKPP
Int32

-1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다. 이 매개 변수는 Kids Passport 서비스를 구현할 때만 사용됩니다. 그러나 Kids Passport 서비스는 현재 이 메서드의 사용을 지원할 수 없습니다.

fUseSecureAuth
Boolean

SSL 로그인은 로그인 서버 현재 버전에서 옵션으로 사용할 수 없습니다. Passport 관리자 메서드에는 SSL 로그인 매개 변수가 포함되고 구문에 필요하지만 현재 서버에서는 무시됩니다. SSL 로그인 상태에 대한 업데이트가 있는지 Passport 웹 사이트를 검사합니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

oExtraParams
Object

특히 Passport 인식 인증 상호 작용을 위해 요구 인증 헤더에 직접 삽입할 이름-값 쌍입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

반환

Int32

정수 결과 코드입니다.

예제

<!-- 
This example demonstrates implementing the soft sign-in authentication approach. 
In order for the example to work, the following requirements must be met. 
You can find details on these requirements in the Passport SDK documentation.

1. You must modify the Web.config file associated with this page so that 
authentication mode is set to "Passport".
2. You must have the Passport SDK installed.
3. You must have a Passport Site ID for the site where your page resides. 
If your Site ID is in the PREP environment, you will also need a PREP Passport.
4. You must have installed the encryption key you received after registering 
your site and receiving a site ID.
5. You must have the Passport Manager object settings correctly configured for 
your site.
-->

<!-- 
This example demonstrates implementing the soft sign-in authentication approach. 
In order for the example to work, the following requirements must be met. 
You can find details on these requirements in the Passport SDK documentation.

1. You must modify the Web.config file associated with this page so that 
authentication mode is set to "Passport".
2. You must have the Passport SDK installed.
3. You must have a Passport Site ID for the site where your page resides. 
If your Site ID is in the PREP environment, you will also need a PREP Passport.
4. You must have installed the encryption key you received after registering your 
site and receiving a site ID.
5. You must have the Passport Manager object settings correctly configured for your site.
-->

<%@ Page language="c#" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Runtime.InteropServices" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    private void Page_Load(object sender, System.EventArgs e)
    {
        try 
        {
            // Determine whether Passport is the type of authentication
            // this page is set to use. (Authentication information
            // is set in the Web.config file.)
            if (!(this.Context.User.Identity is PassportIdentity))
            {
                // If this page isn't set to use Passport authentication,
                // quit now.
                this.Response.Write("Error: Passport authentication failed. " + 
                    "Make sure that the Passport SDK is installed " +
                    "and your Web.config file is configured correctly.");
                return;
            }

            // Expire the page to avoid the browser's cache.
           Response.Cache.SetNoStore(); 


            // Get a version of the Identity value that is cast as type
            // PassportIdentity. 
//<Snippet4>
//<Snippet5>
//<Snippet6>
            PassportIdentity identity = (this.Context.User.Identity as PassportIdentity);    
            // Determine whether the user is already signed in with a valid
            // and current ticket. Passing -1 for the parameter values 
            // indicates the default values will be used.
            if (identity.GetIsAuthenticated(-1, -1, -1))
            {
                this.Response.Write("Welcome to the site.<br /><br />");
                // Print the Passport sign in button on the screen.
                this.Response.Write(identity.LogoTag2());
//</Snippet6>
                // Make sure the user has core profile information before
                // trying to access it.
                if (identity.HasProfile("core"))
                {
                    this.Response.Write("<b>You have been authenticated as " + 
                        "Passport identity:" + identity.Name + "</b></p>");
                }
            }
//</Snippet5>            
    
            // Determine whether the user has a ticket.
            else if (identity.HasTicket)
            {
                // If the user has a ticket but wasn't authenticated, that 
                // means the ticket is stale, so the login needs to be refreshed.
                // Passing true as the fForceLogin parameter value indicates that 
                // silent refresh will be accepted.
                identity.LoginUser(null, -1, true, null, -1, null, -1, true, null);
            }
//</Snippet4>

            // If the user does not already have a ticket, ask the user
            // to sign in.
            else
            {
                this.Response.Write("Please sign in using the link below.<br /><br />");
                // Print the Passport sign in button on the screen.
                this.Response.Write(identity.LogoTag2());
            }
        }
        catch (System.Runtime.InteropServices.COMException comError)
        {
            this.Response.Write("An error occurred while working with the " +
                "Passport SDK.");
        }
    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
    <title>ASP.NET Example</title>
</head>
    <body>
        <form id="form1" runat="server">
        </form>
    </body>
</html>
<%@ Page language="VB" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Runtime.InteropServices" %>


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Private Sub Page_Load(sender As Object, e As System.EventArgs)
        Try 
            ' Determine whether Passport is the type of authentication
            ' this page is set to use. (Authentication information
            ' is set in the Web.config file.)
            If Not TypeOf(Me.Context.User.Identity) Is PassportIdentity Then
                ' If this page isn't set to use Passport authentication,
                ' quit now.
                 Me.Response.Write("Error: Passport authentication failed. " & _
                     "Make sure that the Passport SDK is installed and your " & _
                     "Web.config file is configured correctly.")
                Return
            End If

            ' Expire the page to avoid the browser's cache.
            Response.Cache.SetNoStore()
            
            ' Get a version of the Identity value that is cast as type
            ' PassportIdentity. 
'<Snippet4>
'<Snippet5>
'<Snippet6>
            Dim identity As PassportIdentity = Me.Context.User.Identity
            ' Determine whether the user is already signed in with a valid
            ' and current ticket. Passing -1 for the parameter values 
            ' indicates the default values will be used.
            If (identity.GetIsAuthenticated(-1, -1, -1)) Then
                Me.Response.Write("Welcome to the site.<br /><br />")
                ' Print the Passport sign in button on the screen.
                Me.Response.Write(identity.LogoTag2())
'</Snippet6>
                ' Make sure the user has core profile information before
                ' trying to access it.
                If (identity.HasProfile("core")) Then
                    Me.Response.Write("<b>You have been authenticated as " & _ 
                    "Passport identity:" & identity.Name & "</b></p>")
                End If
'</Snippet5>            
    
            ' Determine whether the user has a ticket.
            ElseIf identity.HasTicket Then
                ' If the user has a ticket but wasn't authenticated, that 
                ' means the ticket is stale, so the login needs to be refreshed.
                ' Passing true as the fForceLogin parameter value indicates that 
                ' silent refresh will be accepted.
                identity.LoginUser(Nothing, -1, True, Nothing, -1, Nothing, _
                    -1, True, Nothing)
'</Snippet4>

            ' If the user does not already have a ticket, ask the user
            ' to sign in.
            Else
                Me.Response.Write("Please sign in using the link below.<br /><br />")
                ' Print the Passport sign in button on the screen.
                Me.Response.Write(identity.LogoTag2())
            End If

        Catch comError As System.Runtime.InteropServices.COMException
            Me.Response.Write("An error occurred while working with the " & _
                "Passport SDK. The following result was returned: " & _
                comError.ErrorCode)
        End Try
    End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
    <title>ASP.NET Example</title>
</head>

    <body>
        <form id="form1" runat="server">
        </form>
    </body>
</html>

설명

이 클래스는 않으며는 지원 되지 않습니다. Microsoft Passport Network가 Windows Live ID로 대체되었습니다.

적용 대상

LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)

302 리디렉션 URL을 생성하거나 Passport 인식 클라이언트 인증 교환을 초기화하여 사용자가 로그온합니다. 이 클래스는 사용되지 않습니다.

public:
 int LoginUser(System::String ^ szRetURL, int iTimeWindow, int fForceLogin, System::String ^ szCOBrandArgs, int iLangID, System::String ^ strNameSpace, int iKPP, int iUseSecureAuth, System::Object ^ oExtraParams);
public int LoginUser (string szRetURL, int iTimeWindow, int fForceLogin, string szCOBrandArgs, int iLangID, string strNameSpace, int iKPP, int iUseSecureAuth, object oExtraParams);
member this.LoginUser : string * int * int * string * int * string * int * int * obj -> int
Public Function LoginUser (szRetURL As String, iTimeWindow As Integer, fForceLogin As Integer, szCOBrandArgs As String, iLangID As Integer, strNameSpace As String, iKPP As Integer, iUseSecureAuth As Integer, oExtraParams As Object) As Integer

매개 변수

szRetURL
String

로그인이 완료된 후 로그인 서버가 사용자를 리디렉션할 URL입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

iTimeWindow
Int32

시간 값(초)입니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

fForceLogin
Int32

로그인 서버에서 사용자가 마지막으로 로그인하거나 마지막으로 티켓을 새로 고친 이후의 시간과 iTimeWindow를 비교하는지 여부를 나타냅니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

szCOBrandArgs
String

참가 요소의 Cobranding Template 스크립트 페이지 URL에 쿼리 문자열 변수로 추가할 변수를 지정하는 문자열입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

iLangID
Int32

로그인 페이지를 표시할 언어를 지정하는 LCID(로캘 식별자)입니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

strNameSpace
String

Passport 계정이 없는 사용자가 등록하도록 할 도메인 네임스페이스입니다. 지정된 네임스페이스는 Partner.xml CCD(Component Configuration Document)에 "도메인 이름" 항목으로 표시되어야 합니다. 일반적인 기본 네임스페이스는 "passport.com"입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

iKPP
Int32

-1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다. 이 매개 변수는 Kids Passport 서비스를 구현할 때만 사용됩니다. 그러나 Kids Passport 서비스는 현재 이 메서드의 사용을 지원할 수 없습니다.

iUseSecureAuth
Int32

SSL 로그인은 로그인 서버 현재 버전에서 옵션으로 사용할 수 없습니다. Passport 관리자 메서드에는 SSL 로그인 매개 변수가 포함되고 구문에 필요하지만 현재 서버에서는 무시됩니다. SSL 로그인 상태에 대한 업데이트가 있는지 Passport 웹 사이트를 검사합니다. -1을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

oExtraParams
Object

특히 Passport 인식 인증 상호 작용을 위해 요구 인증 헤더에 직접 삽입할 이름-값 쌍입니다. null을 전달하여 Passport에서 기본값을 사용한다는 것을 나타냅니다.

반환

Int32

정수 결과 코드입니다.

설명

이 클래스는 않으며는 지원 되지 않습니다. Microsoft Passport Network가 Windows Live ID로 대체되었습니다.

적용 대상