ClaimsAuthenticationManager Klasa

Definicja

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

Dziedziczenie

Object

ClaimsAuthenticationManager

Implementuje

ICustomIdentityConfiguration

Przykłady

Poniższy kod przedstawia prostego menedżera uwierzytelniania oświadczeń, który dodaje oświadczenie roli do podmiotu zabezpieczeń przychodzących bez przeprowadzania sprawdzania oświadczeń przychodzących.

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; 
        }
    }
}

Poniższy kod XML przedstawia <claimsAuthenticationManager> element .

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

    ...

  </identityConfiguration>
</system.identityModel>

Uwagi

Menedżer uwierzytelniania oświadczeń zapewnia punkt rozszerzalności w potoku przetwarzania oświadczeń aplikacji, którego można użyć do sprawdzania poprawności, filtrowania, modyfikowania, oświadczeń przychodzących lub wstrzykiwania nowych oświadczeń do zestawu oświadczeń przedstawionych przed ClaimsPrincipal wykonaniem kodu aplikacji rp. Możesz nawet zwrócić niestandardową implementację ClaimsPrincipal , jeśli aplikacja RP wymaga jej. Domyślna implementacja dostarczana przez klasę ClaimsAuthenticationManager zwraca oświadczenia w ClaimsPrincipal niezmodyfikowanych elementach; można jednak pochodzić z tej klasy i zastąpić Authenticate metodę modyfikowania oświadczeń w ClaimsPrincipal obiekcie (lub zwracania niestandardowego ClaimsPrincipal).

Typowym powodem tworzenia niestandardowego menedżera uwierzytelniania oświadczeń jest dodawanie, usuwanie lub przekształcanie oświadczeń na podstawie informacji, które są znane tylko przez lub jest, być może, lepiej obsługiwane przez aplikację RP. Na przykład historia zakupów klientów w aplikacji koszyka może być przechowywana w bazie danych obsługiwanej przez aplikację RP, a następnie dodawana do podmiotu zabezpieczeń oświadczeń zwróconego przez menedżera uwierzytelniania oświadczeń na podstawie wartości oświadczenia oświadczenia znalezionego w podmiotu zabezpieczeń przychodzących.

Aplikację można skonfigurować tak, aby korzystała ClaimsAuthenticationManager programowo przy użyciu klasy lub w konfiguracji za pomocą IdentityConfiguration<elementu claimsAuthenticationManager> (który jest elementem <podrzędnym elementu identityConfiguration> ). Można zastąpić metodę LoadCustomConfiguration w celu zapewnienia przetwarzania niestandardowych elementów podrzędnych <claimsAuthenticationManager> elementu, za pomocą którego można skonfigurować menedżera niestandardowego. Podstawowa implementacja programu nie obsługuje żadnych elementów podrzędnych ClaimsAuthenticationManager .

Skonfigurowanie aplikacji w celu korzystania z menedżera uwierzytelniania oświadczeń gwarantuje, że zostanie ona wywołana przez program Windows Identity Foundation (WIF) z potoku żądania.