PassportIdentity Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Attenzione
This type is obsolete. The Passport authentication product is no longer supported and has been superseded by Live ID.
Fornisce una classe usata da PassportAuthenticationModule. Rappresenta una delle modalità di accesso al metodo Ticket(String) da parte di un'applicazione. La classe non può essere ereditata. Questa classe è deprecata.
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
- Ereditarietà
-
PassportIdentity
- Attributi
- Implementazioni
Esempio
<!--
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>
Commenti
Questa classe è stata deprecata e non è più supportata. Microsoft Passport Network è stato sostituito da Windows Live ID.
Costruttori
PassportIdentity() |
Inizializza una nuova istanza della classe PassportIdentity. Questa classe è deprecata. |
Proprietà
AuthenticationType |
Ottiene il tipo di autenticazione usata per identificare l'utente. Questa classe è deprecata. |
Error |
Ottiene un valore che indica lo stato di errore associato al ticket Passport corrente. Questa classe è deprecata. |
GetFromNetworkServer |
Ottiene informazioni su una connessione al server Passport e sulla stringa di query. Questa classe è deprecata. |
HasSavedPassword |
Ottiene informazioni che indicano se la password di un membro Passport è stata salvata o meno. Questa classe è deprecata. |
HasTicket |
Ottiene un valore che indica se nella stringa di query è incluso un ticket Passport come cookie. Questa classe è deprecata. |
HexPUID |
Ottiene il PUID (Passport Unique Identifier) per l'utente attualmente autenticato, in formato esadecimale. Questa classe è deprecata. |
IsAuthenticated |
Ottiene un valore che indica se l'utente è autenticato presso un'autorità Passport. Questa classe è deprecata. |
Item[String] |
Ottiene gli attributi del profilo Passport. Questa classe è deprecata. |
Name |
Ottiene il nome dell'utente corrente. Questa classe è deprecata. |
TicketAge |
Ottiene il tempo trascorso, in secondi, dall'emissione o dall'aggiornamento dell'ultimo ticket. Questa classe è deprecata. |
TimeSinceSignIn |
Ottiene il tempo, in secondi, trascorso dal momento in cui un membro si è connesso al server di accesso Passport. Questa classe è deprecata. |
Metodi
AuthUrl() |
Restituisce una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
AuthUrl(String) |
Restituisce una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
AuthUrl(String, Int32, Boolean, String, Int32, String, Int32, Boolean) |
Restituisce l'URL del server di autenticazione per un membro. Questa classe è deprecata. |
AuthUrl(String, Int32, Int32, String, Int32, String, Int32, Int32) |
Restituisce una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
AuthUrl2() |
Restituisce una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
AuthUrl2(String) |
Restituisce una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
AuthUrl2(String, Int32, Boolean, String, Int32, String, Int32, Boolean) |
Restituisce una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
AuthUrl2(String, Int32, Int32, String, Int32, String, Int32, Int32) |
Recupera una stringa contenente l'URL del server di accesso per un membro, insieme a informazioni facoltative inviate al server di accesso nella stringa di query. Questa classe è deprecata. |
Compress(String) |
Comprime i dati. Questa classe è deprecata. |
CryptIsValid() |
Ottiene lo stato di un flag che indica se Passport Manager si trova in uno stato valido per la crittografia. Questa classe è deprecata. |
CryptPutHost(String) |
Imposta le chiavi usate per la crittografia e la decrittografia di Passport. Questa classe è deprecata. |
CryptPutSite(String) |
Imposta la chiave usata per la crittografia e la decrittografia di Passport, facendo riferimento all'etichetta del nome del sito assegnata a tale chiave durante la prima installazione della chiave. Questa classe è deprecata. |
Decompress(String) |
Decomprime i dati compressi dal il metodo Compress(String). Questa classe è deprecata. |
Decrypt(String) |
Decodifica i dati usando la chiave Passport per il sito corrente. Questa classe è deprecata. |
Encrypt(String) |
Crittografa i dati usando la chiave Passport per il sito corrente. Questa classe è deprecata. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Finalize() |
Consente a questa identità passport di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga recuperato da Garbage Collection. |
GetCurrentConfig(String) |
Ottiene i contenuti di una chiave del Registro di sistema nell'hive HKLM\SW\Microsoft\Passport. Questa classe è deprecata. |
GetDomainAttribute(String, Int32, String) |
Fornisce informazioni relative a un dominio Passport, inviando una query a Passport Manager per l'attributo del dominio richiesto. Questa classe è deprecata. |
GetDomainFromMemberName(String) |
Restituisce il dominio Passport dalla stringa dei nomi dei membri. Questa classe è deprecata. |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetIsAuthenticated(Int32, Boolean, Boolean) |
Indica se l'utente è autenticato da un sito centrale responsabile per l'autenticazione Passport. Questa classe è deprecata. |
GetIsAuthenticated(Int32, Int32, Int32) |
Indica se l'utente è stato autenticato da un'autorità Passport. Questa classe è deprecata. |
GetLoginChallenge() |
Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
GetLoginChallenge(String) |
Consente l'accesso all'utente mediante l'output delle intestazioni appropriate a un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
GetLoginChallenge(String, Int32, Int32, String, Int32, String, Int32, Int32, Object) |
Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
GetOption(String) |
Ottiene un'opzione di accesso Passport specifica. Questa classe è deprecata. |
GetProfileObject(String) |
Restituisce le informazioni del profilo Passport per l'attributo del profilo specificato. Questa classe è deprecata. |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
HasFlag(Int32) |
Indica se un determinato flag è stato impostato nel profilo utente. Questa classe è deprecata. |
HasProfile(String) |
Indica se un determinato attributo del profilo esiste o meno in questo profilo utente. Questa classe è deprecata. |
HaveConsent(Boolean, Boolean) |
Indica se nel profilo utente è stata concessa l'autorizzazione completa. Questa classe è deprecata. |
LoginUser() |
Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
LoginUser(String) |
Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object) |
Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object) |
Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata. |
LogoTag() |
Restituisce un frammento HTML contenente un tag di immagine per un collegamento Passport. Questa classe è deprecata. |
LogoTag(String) |
Restituisce un frammento HTML contenente un tag <img> HTML per un collegamento Passport. Questa classe è deprecata. |
LogoTag(String, Int32, Boolean, String, Int32, Boolean, String, Int32, Boolean) |
Restituisce un frammento HTML contenente un tag <img> HTML per un collegamento Passport. Questa classe è deprecata. |
LogoTag(String, Int32, Int32, String, Int32, Int32, String, Int32, Int32) |
Restituisce un frammento HTML contenente un tag <img> HTML per un collegamento Passport. Questa classe è deprecata. |
LogoTag2() |
Restituisce un frammento HTML contenente un tag di immagine per un collegamento Passport. Questa classe è deprecata. |
LogoTag2(String) |
Restituisce un frammento HTML contenente un tag <img> HTML per un collegamento Passport. Questa classe è deprecata. |
LogoTag2(String, Int32, Boolean, String, Int32, Boolean, String, Int32, Boolean) |
Restituisce un frammento HTML contenente un tag <img> HTML per un collegamento Passport. Questa classe è deprecata. |
LogoTag2(String, Int32, Int32, String, Int32, Int32, String, Int32, Int32) |
Restituisce un frammento HTML contenente un tag <img> HTML per un collegamento Passport. Questa classe è deprecata. |
LogoutURL() |
Restituisce la stringa URL di chiusura della sessione di Passport. Questa classe è deprecata. |
LogoutURL(String, String, Int32, String, Int32) |
Restituisce la stringa URL di chiusura della sessione di Passport usando i parametri specificati. Questa classe è deprecata. |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
SetOption(String, Object) |
Imposta un'opzione di accesso Passport specifica. Questa classe è deprecata. |
SignOut(String) |
Disconnette il membro Passport specificato dalla sessione corrente. Questa classe è deprecata. |
Ticket(String) |
Ottiene informazioni su un attributo specifico del ticket di autenticazione Passport. Questa classe è deprecata. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IDisposable.Dispose() |
Rilascia tutte le risorse usate dalla classe PassportIdentity. Questa classe è deprecata. |