ClaimsAuthenticationManager Classe

Definizione

Spazio dei nomi:

System.Security.Claims

Assembly:

System.IdentityModel.dll

Definisce l'implementazione di base per un gestore di autenticazione delle attestazioni. Il gestore di autenticazione delle attestazioni fornisce un punto nelle attestazioni che elaborano la pipeline per applicare la logica di elaborazione (filtro, convalida, estensione) alla raccolta di attestazioni nell'entità in arrivo prima che l'esecuzione raggiunga il codice dell'applicazione.

public ref class ClaimsAuthenticationManager : System::IdentityModel::Configuration::ICustomIdentityConfiguration

public class ClaimsAuthenticationManager : System.IdentityModel.Configuration.ICustomIdentityConfiguration

type ClaimsAuthenticationManager = class
    interface ICustomIdentityConfiguration

Public Class ClaimsAuthenticationManager
Implements ICustomIdentityConfiguration

Ereditarietà

Object

ClaimsAuthenticationManager

Implementazioni

ICustomIdentityConfiguration

Esempio

Il codice seguente illustra un semplice gestore di autenticazione delle attestazioni che aggiunge un'attestazione di ruolo all'entità in ingresso senza eseguire alcun controllo sulle attestazioni in ingresso.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

using System.Security.Claims;

namespace MyClaimsAuthenticationManager
{
    class SimpleClaimsAuthenticatonManager : ClaimsAuthenticationManager
    {
        public override ClaimsPrincipal Authenticate(string resourceName, ClaimsPrincipal incomingPrincipal)
        {
            if (incomingPrincipal != null && incomingPrincipal.Identity.IsAuthenticated == true)
            {
                ((ClaimsIdentity)incomingPrincipal.Identity).AddClaim(new Claim(ClaimTypes.Role, "User"));
            }
            return incomingPrincipal; 
        }
    }
}

Il codice XML seguente mostra l'elemento <claimsAuthenticationManager> .

<system.identityModel>  
  <identityConfiguration>  
    <claimsAuthenticationManager type="MyClaimsAuthenticationManager.SimpleClaimsAuthenticatonManager, MyClaimsAuthenticationManager" />  

    ...  

  </identityConfiguration>  
</system.identityModel>  

Commenti

Gestione autenticazione attestazioni fornisce un punto di estendibilità nella pipeline di elaborazione delle attestazioni dell'applicazione che è possibile usare per convalidare, filtrare, modificare, attestazioni in ingresso o inserire nuove attestazioni nel set di attestazioni presentate da prima ClaimsPrincipal dell'esecuzione del codice dell'applicazione rp. È anche possibile restituire un'implementazione personalizzata di ClaimsPrincipal se l'applicazione rp lo richiede. L'implementazione predefinita fornita dalla ClaimsAuthenticationManager classe restituisce le attestazioni nell'oggetto ClaimsPrincipal non modificato. È tuttavia possibile derivare da questa classe ed eseguire l'override del Authenticate metodo per modificare le attestazioni in ClaimsPrincipal o per restituire un oggetto personalizzato ClaimsPrincipal.

Un motivo tipico per la creazione di un gestore di autenticazione delle attestazioni personalizzato consiste nell'aggiungere, rimuovere o trasformare le attestazioni in base alle informazioni note solo da o, ad esempio, gestite meglio dall'applicazione rp. Ad esempio, una cronologia degli acquisti dei clienti in un'applicazione del carrello acquisti può essere mantenuta in una base dati gestita dall'applicazione RP e quindi aggiunta all'entità attestazioni restituita dal gestore di autenticazione delle attestazioni in base al valore di un'attestazione nome trovata nell'entità in ingresso.

È possibile configurare l'applicazione per l'uso di un ClaimsAuthenticationManager oggetto a livello di codice usando la IdentityConfiguration classe o nella configurazione tramite l'elemento <claimsAuthenticationManager> , che è un elemento figlio dell'elemento <identityConfiguration> . È possibile eseguire l'override del LoadCustomConfiguration metodo per fornire l'elaborazione per gli elementi figlio personalizzati dell'elemento <claimsAuthenticationManager> tramite cui è possibile configurare il gestore personalizzato. L'implementazione di base di ClaimsAuthenticationManager non gestisce alcun elemento figlio.

La configurazione dell'applicazione per l'uso di un gestore di autenticazione delle attestazioni garantisce che venga richiamata da Windows Identity Foundation (WIF) dalla pipeline di richiesta.

Costruttori

ClaimsAuthenticationManager()

Inizializza una nuova istanza della classe ClaimsAuthenticationManager.

Metodi

Authenticate(String, ClaimsPrincipal)	Quando sottoposto a override in una classe derivata, restituisce un oggetto ClaimsPrincipal consistente con i requisiti dell'applicazione RP. L'implementazione predefinita non modifica l'elemento ClaimsPrincipal in ingresso.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadCustomConfiguration(XmlNodeList)	Quando sottoposto a override in una classe derivata, carica la configurazione personalizzata dall'XML.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)