PassportIdentity Класс

Определение

Внимание!

This type is obsolete. The Passport authentication product is no longer supported and has been superseded by Live ID.

Предоставляет класс для использования модулем PassportAuthenticationModule.Provides a class to be used by PassportAuthenticationModule. Обеспечивает приложению способ доступа к методу Ticket(String).It provides a way for an application to access the Ticket(String) method. Этот класс не наследуется.This class cannot be inherited. Этот класс устарел.This class is deprecated.

public ref class PassportIdentity sealed : System::Security::Principal::IIdentity
public ref class PassportIdentity sealed : IDisposable, System::Security::Principal::IIdentity
public sealed class PassportIdentity : System.Security.Principal.IIdentity
public sealed class PassportIdentity : IDisposable, System.Security.Principal.IIdentity
[System.Obsolete("This type is obsolete. The Passport authentication product is no longer supported and has been superseded by Live ID.")]
public sealed class PassportIdentity : IDisposable, System.Security.Principal.IIdentity
type PassportIdentity = class
    interface IIdentity
type PassportIdentity = class
    interface IIdentity
    interface IDisposable
[<System.Obsolete("This type is obsolete. The Passport authentication product is no longer supported and has been superseded by Live ID.")>]
type PassportIdentity = class
    interface IIdentity
    interface IDisposable
Public NotInheritable Class PassportIdentity
Implements IIdentity
Public NotInheritable Class PassportIdentity
Implements IDisposable, IIdentity
Наследование
PassportIdentity
Атрибуты
Реализации

Примеры

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

Комментарии

Этот класс является устаревшим и больше не поддерживается.This class has been deprecated and is no longer supported. Microsoft Passport сеть заменена идентификатором Windows Live ID.Microsoft Passport Network has been replaced by Windows Live ID. Дополнительные сведения об использовании Windows Live ID для проверки подлинности пользователей в веб-приложении см. в статье Windows Live ID SDK.For more information about how to use Windows Live ID to authenticate users in a Web application, see Windows Live ID SDK.

Конструкторы

PassportIdentity()

Инициализирует новый экземпляр класса PassportIdentity.Initializes a new instance of the PassportIdentity class. Этот класс устарел.This class is deprecated.

Свойства

AuthenticationType

Возвращает тип проверки подлинности, применяемой для идентификации пользователя.Gets the type of authentication used to identify the user. Этот класс устарел.This class is deprecated.

Error

Получает значение, указывающее состояние ошибки, связанное с текущим билетом Passport.Gets a value indicating the error state associated with the current Passport ticket. Этот класс устарел.This class is deprecated.

GetFromNetworkServer

Получает сведения о соединении сервера службы Passport и о строке запроса.Gets information on a Passport server connection and query string. Этот класс устарел.This class is deprecated.

HasSavedPassword

Получает сведения о том, был ли сохранен пароль члена службы Passport.Gets information on whether the Passport member's password was saved. Этот класс устарел.This class is deprecated.

HasTicket

Получает значение, указывающее, включает ли строка запроса билет Passport в качестве файла cookie.Gets a value indicating whether the query string includes a Passport ticket as a cookie. Этот класс устарел.This class is deprecated.

HexPUID

Получает идентификатор PUID для пользователя, для которого была выполнена аутентификация, в шестнадцатеричной форме.Gets the Passport Unique Identifier (PUID) for the currently authenticated user, in hexadecimal form. Этот класс устарел.This class is deprecated.

IsAuthenticated

Получает значение, указывающее, прошел ли пользователь аутентификацию в центре Passport.Gets a value indicating whether the user is authenticated against a Passport authority. Этот класс устарел.This class is deprecated.

Item[String]

Получает атрибуты профиля в службе Passport.Gets Passport profile attributes. Этот класс устарел.This class is deprecated.

Name

Получает имя текущего пользователя.Gets the name of the current user. Этот класс устарел.This class is deprecated.

TicketAge

Получает время в секундах с момента выдачи или обновления последнего билета.Gets the time, in seconds, since the last ticket was issued or refreshed. Этот класс устарел.This class is deprecated.

TimeSinceSignIn

Получает время в секундах с момента входа члена на сервер входа службы Passport.Gets the time, in seconds, since a member's logon to the Passport logon server. Этот класс устарел.This class is deprecated.

Методы

AuthUrl()

Возвращает строку, содержащую URL-адрес сервера входа для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Returns a string containing the Login server URL for a member, as well as with optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

AuthUrl(String)

Возвращает строку, содержащую URL-адрес сервера входа для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Returns a string containing the Login server URL for a member, along with optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

AuthUrl(String, Int32, Boolean, String, Int32, String, Int32, Boolean)

Возвращает URL-адрес сервера аутентификации для члена.Returns the authentication server URL for a member. Этот класс устарел.This class is deprecated.

AuthUrl(String, Int32, Int32, String, Int32, String, Int32, Int32)

Возвращает строку, содержащую URL-адрес сервера входа для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Returns a string containing the Login server URL for a member, along with the optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

AuthUrl2()

Возвращает строку, содержащую URL-адрес сервера входа для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Returns a string containing the Login server URL for a member, as well as optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

AuthUrl2(String)

Возвращает строку, содержащую URL-адрес сервера входа для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Returns a string containing the Login server URL for a member, as well as optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

AuthUrl2(String, Int32, Boolean, String, Int32, String, Int32, Boolean)

Возвращает строку, содержащую URL-адрес сервера вход для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Returns a string containing the Login server URL for a member, as well as the optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

AuthUrl2(String, Int32, Int32, String, Int32, String, Int32, Int32)

Загружает строку, содержащую адрес URL сервера входа для члена, а также дополнительные сведения, отправляемые серверу входа в строке запроса.Retrieves a string containing the Login server URL for a member, as well as the optional information sent to the Login server in the query string. Этот класс устарел.This class is deprecated.

Compress(String)

Сжимает данные.Compresses data. Этот класс устарел.This class is deprecated.

CryptIsValid()

Получает состояние флага, показывающее, находится ли диспетчер паспорта в состоянии, допустимом для шифрования.Gets the state of a flag indicating if the Passport Manager is in a valid state for encryption. Этот класс устарел.This class is deprecated.

CryptPutHost(String)

Задает ключ, используемый для шифрования и расшифровки паспорта.Sets the key being used for Passport encryption and decryption. Этот класс устарел.This class is deprecated.

CryptPutSite(String)

Задает ключ, используемый для шифрования и расшифровки паспорта и ссылающийся на метку с именем веб-сайта, присвоенную этому ключу при его первой установке.Sets the key being used for Passport encryption and decryption by referring to the site-name label assigned to that key when the key was first installed. Этот класс устарел.This class is deprecated.

Decompress(String)

Распаковывает данные, сжатые методом Compress(String).Decompresses data that has been compressed by the Compress(String) method. Этот класс устарел.This class is deprecated.

Decrypt(String)

Расшифровывает данные с помощью ключа участника Passport для текущего веб-сайта.Decrypts data using the Passport participant key for the current site. Этот класс устарел.This class is deprecated.

Encrypt(String)

Шифрует данные с помощью ключа участника Passport для текущего веб-сайта.Encrypts data using the Passport participant key for the current site. Этот класс устарел.This class is deprecated.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Finalize()

Позволяет этому удостоверению службы Passport предпринять попытку освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет освобожден в процессе сборки мусора.Allows this passport identity to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetCurrentConfig(String)

Получает содержимое ключа реестра куста HKLM\SW\Microsoft\Passport.Gets the contents of a registry key under the HKLM\SW\Microsoft\Passport hive. Этот класс устарел.This class is deprecated.

GetDomainAttribute(String, Int32, String)

Предоставляет сведения домену службы Passport, запрашивая требуемый атрибут домена у диспетчера паспорта.Provides information for a Passport domain by querying the Passport manager for the requested domain attribute. Этот класс устарел.This class is deprecated.

GetDomainFromMemberName(String)

Возвращает домен службы Passport из строки имени члена.Returns the Passport domain from the member name string. Этот класс устарел.This class is deprecated.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetIsAuthenticated(Int32, Boolean, Boolean)

Указывает, прошел ли пользователь аутентификацию на центральном сайте, ответственном за аутентификацию службы Passport.Indicates whether the user is authenticated by a central site responsible for Passport authentication. Этот класс устарел.This class is deprecated.

GetIsAuthenticated(Int32, Int32, Int32)

Указывает, прошел ли пользователь аутентификацию центром Passport.Indicates whether the user is authenticated by a Passport authority. Этот класс устарел.This class is deprecated.

GetLoginChallenge()

Осуществляет вход пользователя в систему, создавая перенаправление URL-адреса на 302 либо инициализируя обмен аутентификации для клиента, совместимого со службой Passport.Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

GetLoginChallenge(String)

Осуществляет вход пользователя в систему, выводя соответствующие заголовки перенаправления URL-адреса на 302 или инициализации обмена аутентификации для клиента, совместимого со службой Passport.Logs the user on by outputting the appropriate headers to either a 302 redirect URL or the initiation of a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

GetLoginChallenge(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)

Осуществляет вход пользователя в систему, создавая перенаправление URL-адреса на 302 либо инициализируя обмен аутентификации для клиента, совместимого со службой Passport.Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

GetOption(String)

Получает заданный вариант входа Passport.Gets a specific Passport logon option. Этот класс устарел.This class is deprecated.

GetProfileObject(String)

Возвращает сведения о профиле в службе Passport для заданного атрибута профиля.Returns Passport profile information for the specified profile attribute. Этот класс устарел.This class is deprecated.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HasFlag(Int32)

Указывает, задан ли в этом профиле пользователя данный флаг.Indicates whether a given flag is set in this user's profile. Этот класс устарел.This class is deprecated.

HasProfile(String)

Указывает, существует ли в этом профиле пользователя данный атрибут профиля.Indicates whether a given profile attribute exists in this user's profile. Этот класс устарел.This class is deprecated.

HaveConsent(Boolean, Boolean)

Указывает, предоставлены ли данному профилю пользователя все разрешения.Indicates whether full consent is granted in this user's profile. Этот класс устарел.This class is deprecated.

LoginUser()

Осуществляет вход пользователя в систему, создавая перенаправление URL-адреса на 302 либо инициализируя обмен аутентификации для клиента, совместимого со службой Passport.Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

LoginUser(String)

Осуществляет вход пользователя в систему, создавая перенаправление URL-адреса на 302 либо инициализируя обмен аутентификации для клиента, совместимого со службой Passport.Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

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

Осуществляет вход пользователя в систему, создавая перенаправление URL-адреса на 302 либо инициализируя обмен аутентификации для клиента, совместимого со службой Passport.Logs the user on, either by generating a 302 redirect URL or by initiating a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

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

Осуществляет вход пользователя в систему, создавая перенаправление URL-адреса на 302 либо инициализируя обмен аутентификации для клиента, совместимого со службой Passport.Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. Этот класс устарел.This class is deprecated.

LogoTag()

Возвращает фрагмент HTML, содержащий тег рисунка для ссылки службы Passport.Returns an HTML fragment containing an image tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag(String)

Возвращает фрагмент HTML, содержащий тег HTML <img> для ссылки службы Passport.Returns an HTML fragment containing an HTML <img> tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag(String, Int32, Boolean, String, Int32, Boolean, String, Int32, Boolean)

Возвращает фрагмент HTML, содержащий тег HTML <img> для ссылки службы Passport.Returns an HTML fragment containing an HTML <img> tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag(String, Int32, Int32, String, Int32, Int32, String, Int32, Int32)

Возвращает фрагмент HTML, содержащий тег HTML <img> для ссылки службы Passport.Returns an HTML fragment containing an HTML <img> tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag2()

Возвращает фрагмент HTML, содержащий тег рисунка для ссылки службы Passport.Returns an HTML fragment containing an image tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag2(String)

Возвращает фрагмент HTML, содержащий тег HTML <img> для ссылки службы Passport.Returns an HTML fragment containing an HTML <img> tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag2(String, Int32, Boolean, String, Int32, Boolean, String, Int32, Boolean)

Возвращает фрагмент HTML, содержащий тег HTML <img> для ссылки службы Passport.Returns an HTML fragment containing an HTML <img> tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoTag2(String, Int32, Int32, String, Int32, Int32, String, Int32, Int32)

Возвращает фрагмент HTML, содержащий тег HTML <img> для ссылки службы Passport.Returns an HTML fragment containing an HTML <img> tag for a Passport link. Этот класс устарел.This class is deprecated.

LogoutURL()

Возвращает строку, содержащую URL-адрес выхода службы Passport.Returns the Passport logout URL string. Этот класс устарел.This class is deprecated.

LogoutURL(String, String, Int32, String, Int32)

С помощью заданных параметров возвращает строку, содержащую URL-адрес выхода службы Passport.Returns the Passport logout URL string using the specified parameters. Этот класс устарел.This class is deprecated.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
SetOption(String, Object)

Задает определенный вариант входа службы Passport.Sets a specific Passport logon option. Этот класс устарел.This class is deprecated.

SignOut(String)

Выполняет выход данного члена Passport из текущего сеанса.Logs off the given Passport member from the current session. Этот класс устарел.This class is deprecated.

Ticket(String)

Получает сведения об указанном атрибуте билета аутентификации службы Passport.Gets information on a specific attribute of the Passport authentication ticket. Этот класс устарел.This class is deprecated.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

IDisposable.Dispose()

Освобождает все ресурсы, используемые классом PassportIdentity.Releases all resources used by the PassportIdentity class. Этот класс устарел.This class is deprecated.

Применяется к