PassportIdentity.LoginUser Método

Referência

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Conecta o usuário, através da geração de uma URL redirecionamento 302 ou do início de uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.

Sobrecargas

LoginUser()	Conecta o usuário, gerando uma URL redirecionamento 302 ou iniciando uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.
LoginUser(String)	Conecta o usuário, gerando uma URL redirecionamento 302 ou iniciando uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)	Conecta o usuário, através da geração de uma URL redirecionamento 302 ou do início de uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	Conecta o usuário, gerando uma URL redirecionamento 302 ou iniciando uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.

Comentários

Essa classe foi preterida e não tem mais suporte. O Microsoft Passport Network foi substituído pelo Windows Live ID.

LoginUser()

Conecta o usuário, gerando uma URL redirecionamento 302 ou iniciando uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.

public:
 int LoginUser();

public int LoginUser ();

member this.LoginUser : unit -> int

Public Function LoginUser () As Integer

Retornos

Int32

Um código de resultado de inteiro.

Comentários

Essa classe foi preterida e não tem mais suporte. O Microsoft Passport Network foi substituído pelo Windows Live ID.

Aplica-se a

LoginUser(String)

Conecta o usuário, gerando uma URL redirecionamento 302 ou iniciando uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.

public:
 int LoginUser(System::String ^ strReturnUrl);

public int LoginUser (string strReturnUrl);

member this.LoginUser : string -> int

Public Function LoginUser (strReturnUrl As String) As Integer

Parâmetros

strReturnUrl: String

A URL para a qual o servidor de logon deve redirecionar os usuários após a conclusão da conexão. Passe null para indicar que o Passport deve usar o valor padrão.

Retornos

Int32

Um código de resultado de inteiro.

Comentários

Essa classe foi preterida e não tem mais suporte. O Microsoft Passport Network foi substituído pelo Windows Live ID.

Aplica-se a

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

Conecta o usuário, através da geração de uma URL redirecionamento 302 ou do início de uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.

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

Parâmetros

szRetURL: String

A URL para a qual o servidor de logon deve redirecionar os usuários após a conclusão da conexão. Passe null para indicar que o Passport deve usar o valor padrão.

iTimeWindow: Int32

O valor temporal, em segundos. Passe -1 para indicar que o Passport deve usar o valor padrão.

fForceLogin: Boolean

true para fazer com que o servidor de logon compare o parâmetro iTimeWindow com o tempo desde que o usuário se conectou pela última vez; false para que o servidor de logon compare iTimeWindow com a última vez em que o Tíquete foi atualizado. Passe -1 para indicar que o Passport deve usar o valor padrão.

szCOBrandArgs: String

Uma cadeia de caracteres especificando variáveis a serem acrescentadas como variáveis de cadeia de caracteres de consulta à URL da página de script de modelo de Co-branding do participante. Passe null para indicar que o Passport deve usar o valor padrão.

iLangID: Int32

Um LCID (ID de localidade) especificando o idioma no qual a página de logon deve ser exibida. Passe -1 para indicar que o Passport deve usar o valor padrão.

strNameSpace: String

Um namespace de domínio ao qual você deseja direcionar os usuários sem Passport para registrarem-se. O namespace especificado deve aparecer como uma entrada de "nome de domínio" no CCD (Component Configuration Document) do Partner.xml. O namespace típico padrão é "passport.com". Passe null para indicar que o Passport deve usar o valor padrão.

iKPP: Int32

Passe -1 para indicar que o Passport deve usar o valor padrão. Esse parâmetro só é relevante ao implementar o serviço Kids Passport, no entanto, atualmente o serviço Kids Passport não é compatível com o uso deste método.

fUseSecureAuth: Boolean

A conexão SSL não está disponível como uma opção em servidores de logon de versão atual. Os métodos do Passport Manager incluem parâmetros de conexão SSL e eles podem ser requeridos pela sintaxe, mas eles são ignorados no servidor atualmente. Verifique o site do Passport para atualizações sobre o status da conexão SSL. Passe -1 para indicar que o Passport deve usar o valor padrão.

oExtraParams: Object

Pares nome-valor a serem inseridos diretamente no cabeçalho de autenticação de desafio, especificamente para interação de autenticação com reconhecimento de Passport. Passe null para indicar que o Passport deve usar o valor padrão.

Retornos

Int32

Um código de resultado de inteiro.

Exemplos

<!-- 
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>

Comentários

Essa classe foi preterida e não tem mais suporte. O Microsoft Passport Network foi substituído pelo Windows Live ID.

Aplica-se a

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

Conecta o usuário, gerando uma URL redirecionamento 302 ou iniciando uma troca de autenticação de cliente com reconhecimento de Passport. Essa classe foi preterida.

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

Parâmetros

szRetURL: String

A URL para a qual o servidor de logon deve redirecionar os usuários após a conclusão da conexão. Passe null para indicar que o Passport deve usar o valor padrão.

iTimeWindow: Int32

O valor temporal, em segundos. Passe -1 para indicar que o Passport deve usar o valor padrão.

fForceLogin: Int32

Indica se o servidor de logon deve comparar o parâmetro iTimeWindow com o tempo desde que o usuário se conectou pela última vez ou com a última vez em que o Tíquete foi atualizado. Passe -1 para indicar que o Passport deve usar o valor padrão.

szCOBrandArgs: String

iLangID: Int32

Um LCID (ID de localidade) especificando o idioma no qual a página de logon deve ser exibida. Passe -1 para indicar que o Passport deve usar o valor padrão.

strNameSpace: String

iKPP: Int32

iUseSecureAuth: Int32

oExtraParams: Object

Retornos

Int32

Um código de resultado de inteiro.

Comentários

Essa classe foi preterida e não tem mais suporte. O Microsoft Passport Network foi substituído pelo Windows Live ID.

Aplica-se a

Compartilhar via

PassportIdentity.LoginUser Método

Definição

Sobrecargas

Comentários

LoginUser()

Retornos

Comentários

Aplica-se a

LoginUser(String)

Parâmetros

Retornos

Comentários

Aplica-se a

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

Parâmetros

Retornos

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Retornos

Comentários

Aplica-se a

Recursos adicionais