ClaimsAuthenticationManager Classe

Definizione

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)
            {
                ((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, meglio gestito dall'applicazione rp. Ad esempio, una cronologia degli acquisti dei clienti in un'applicazione carrello acquisti potrebbe essere mantenuta in una data base gestita dall'applicazione RP e quindi aggiunta all'entità attestazioni restituita dal gestore di autenticazione delle attestazioni in base al valore di un'attestazione di nome trovata nell'entità in ingresso.

È possibile configurare l'applicazione per l'uso di un oggetto ClaimsAuthenticationManager a livello di codice usando la IdentityConfiguration classe o nella configurazione tramite l'elemento <claimsAuthenticationManager> , ovvero 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.