PassportIdentity Klasse

Referenz

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Achtung

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

Stellt eine Klasse bereit, die von PassportAuthenticationModule verwendet wird. Sie stellt ein Verfahren bereit, mit dem eine Anwendung auf die Ticket(String)-Methode zugreifen kann. Diese Klasse kann nicht vererbt werden. Diese Klasse ist veraltet.

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

Vererbung: Object
PassportIdentity

Attribute: ObsoleteAttribute

Implementiert: IIdentity IDisposable

Beispiele

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

Hinweise

Diese Klasse wurde veraltet und wird nicht mehr unterstützt. Microsoft Passport Network wurde durch Windows Live ID ersetzt.

Konstruktoren

PassportIdentity()

Initialisiert eine neue Instanz der PassportIdentity-Klasse. Diese Klasse ist veraltet.

Eigenschaften

AuthenticationType	Ruft den zur Identifizierung des Benutzers verwendeten Authentifizierungstyp ab. Diese Klasse ist veraltet.
Error	Ruft einen Wert ab, der den dem aktuellen Passport-Ticket zugeordneten Fehlerstatus angibt. Diese Klasse ist veraltet.
GetFromNetworkServer	Ruft Informationen über eine Passport-Serververbindung und eine Abfragezeichenfolge ab. Diese Klasse ist veraltet.
HasSavedPassword	Ruft Information ab, die angeben, ob das Kennwort des Passport-Mitglieds gespeichert wurde. Diese Klasse ist veraltet.
HasTicket	Ruft einen Wert ab, der angibt, ob die Abfragezeichenfolge ein Passport-Ticket als Cookie enthält. Diese Klasse ist veraltet.
HexPUID	Ruft den eindeutigen Passport-Bezeichner (PUID, Passport Unique Identifier) für den derzeit authentifizierten Benutzer in hexadezimaler Form ab. Diese Klasse ist veraltet.
IsAuthenticated	Ruft einen Wert ab, der angibt, ob der Benutzer von einer Passport-Zertifizierungsstelle authentifiziert wurde. Diese Klasse ist veraltet.
Item[String]	Ruft Passport-Profilattribute ab. Diese Klasse ist veraltet.
Name	Ruft den Namen des aktuellen Benutzers ab. Diese Klasse ist veraltet.
TicketAge	Ruft die Zeit in Sekunden ab, die seit der Ausgabe oder Aktualisierung des letzten Tickets vergangen ist. Diese Klasse ist veraltet.
TimeSinceSignIn	Ruft die seit der Anmeldung eines Mitglieds am Passport-Anmeldeserver verstrichene Zeit in Sekunden ab. Diese Klasse ist veraltet.

Methoden

AuthUrl()	Gibt eine Zeichenfolge zurück, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
AuthUrl(String)	Gibt eine Zeichenfolge zurück, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
AuthUrl(String, Int32, Boolean, String, Int32, String, Int32, Boolean)	Gibt die URL des Authentifizierungsservers für ein Mitglied zurück. Diese Klasse ist veraltet.
AuthUrl(String, Int32, Int32, String, Int32, String, Int32, Int32)	Gibt eine Zeichenfolge zurück, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
AuthUrl2()	Gibt eine Zeichenfolge zurück, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
AuthUrl2(String)	Gibt eine Zeichenfolge zurück, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
AuthUrl2(String, Int32, Boolean, String, Int32, String, Int32, Boolean)	Gibt eine Zeichenfolge zurück, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
AuthUrl2(String, Int32, Int32, String, Int32, String, Int32, Int32)	Ruft eine Zeichenfolge ab, die die Anmeldeserver-URL für ein Mitglied sowie optionale Informationen enthält, die in der Abfragezeichenfolge an den Anmeldeserver gesendet wurden. Diese Klasse ist veraltet.
Compress(String)	Komprimiert Daten. Diese Klasse ist veraltet.
CryptIsValid()	Ruft den Zustand eines Flags ab, das angibt, ob sich der Passport-Manager in einem für die Verschlüsselung gültigen Zustand befindet. Diese Klasse ist veraltet.
CryptPutHost(String)	Legt den Schlüssel fest, der zur Passport-Ver- und Entschlüsselung verwendet wird. Diese Klasse ist veraltet.
CryptPutSite(String)	Legt den zur Passport-Ver- und Entschlüsselung verwendeten Schlüssel fest, indem auf die Sitenamenbezeichnung verwiesen wird, die diesem Schlüssel bei seiner ersten Installation zugeordnet wurde. Diese Klasse ist veraltet.
Decompress(String)	Dekomprimiert Daten, die mit der Compress(String)-Methode komprimiert wurden. Diese Klasse ist veraltet.
Decrypt(String)	Entschlüsselt Daten mit dem Passport-Teilnehmerschlüssel für die aktuelle Site. Diese Klasse ist veraltet.
Encrypt(String)	Verschlüsselt Daten mit dem Passport-Teilnehmerschlüssel für die aktuelle Site. Diese Klasse ist veraltet.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Finalize()	Ermöglicht der Passport-ID den Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.
GetCurrentConfig(String)	Ruft den Inhalt eines Registrierungsschlüssels unter der Struktur HKLM\SW\Microsoft\Passport ab. Diese Klasse ist veraltet.
GetDomainAttribute(String, Int32, String)	Stellt Informationen für eine Passport-Domäne bereit, indem der Passport-Manager nach dem angeforderten Domänenattribut abgefragt wird. Diese Klasse ist veraltet.
GetDomainFromMemberName(String)	Gibt die Passport-Domäne aus der Zeichenfolge mit dem Mitgliedsnamen zurück. Diese Klasse ist veraltet.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetIsAuthenticated(Int32, Boolean, Boolean)	Gibt an, ob der Benutzer durch eine für die Passport-Authentifizierung verantwortliche, zentrale Site authentifiziert wurde. Diese Klasse ist veraltet.
GetIsAuthenticated(Int32, Int32, Int32)	Gibt an, ob der Benutzer von einer Passport-Zertifizierungsstelle authentifiziert wurde. Diese Klasse ist veraltet.
GetLoginChallenge()	Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
GetLoginChallenge(String)	Meldet den Benutzer an, indem entweder der entsprechenden Header an eine 302-Umleitungs-URL ausgegeben oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
GetLoginChallenge(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
GetOption(String)	Ruft eine bestimmte Passport-Anmeldeoption auf. Diese Klasse ist veraltet.
GetProfileObject(String)	Gibt Informationen zum Passport-Profil für das angegebene Profilattribut zurück. Diese Klasse ist veraltet.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HasFlag(Int32)	Gibt an, ob ein angegebenes Flag im Profil dieses Benutzers festgelegt ist. Diese Klasse ist veraltet.
HasProfile(String)	Gibt an, ob ein angegebenes Profilattribut im Profil dieses Benutzers vorhanden ist. Diese Klasse ist veraltet.
HaveConsent(Boolean, Boolean)	Gibt an, ob im Profil dieses Benutzers volle Zustimmung erteilt wurde. Diese Klasse ist veraltet.
LoginUser()	Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
LoginUser(String)	Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)	Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert wird oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.
LogoTag()	Gibt ein HTML-Fragment mit einem Bildtag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag(String)	Gibt ein HTML-Fragment mit einem <img>-HTML-Tag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag(String, Int32, Boolean, String, Int32, Boolean, String, Int32, Boolean)	Gibt ein HTML-Fragment mit einem <img>-HTML-Tag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag(String, Int32, Int32, String, Int32, Int32, String, Int32, Int32)	Gibt ein HTML-Fragment mit einem <img>-HTML-Tag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag2()	Gibt ein HTML-Fragment mit einem Bildtag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag2(String)	Gibt ein HTML-Fragment mit einem <img>-HTML-Tag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag2(String, Int32, Boolean, String, Int32, Boolean, String, Int32, Boolean)	Gibt ein HTML-Fragment mit einem <img>-HTML-Tag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoTag2(String, Int32, Int32, String, Int32, Int32, String, Int32, Int32)	Gibt ein HTML-Fragment mit einem <img>-HTML-Tag für einen Passport-Link zurück. Diese Klasse ist veraltet.
LogoutURL()	Gibt die URL-Zeichenfolge für die Passport-Abmeldung zurück. Diese Klasse ist veraltet.
LogoutURL(String, String, Int32, String, Int32)	Gibt die URL-Zeichenfolge für die Passport-Abmeldung unter Verwendung der angegebenen Parameter zurück. Diese Klasse ist veraltet.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SetOption(String, Object)	Legt eine bestimmte Passport-Anmeldeoption fest. Diese Klasse ist veraltet.
SignOut(String)	Meldet das angegebene Passport-Mitglied von der aktuellen Sitzung ab. Diese Klasse ist veraltet.
Ticket(String)	Ruft Informationen über ein bestimmtes Attribut des Passport-Authentifizierungstickets ab. Diese Klasse ist veraltet.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Gibt alle von der PassportIdentity-Klasse verwendeten Ressourcen frei. Diese Klasse ist veraltet.

Gilt für

Freigeben über