ClaimsAuthenticationManager Sınıf

Tanım

Ad Alanı:

System.Security.Claims

Bütünleştirilmiş Kod:

System.IdentityModel.dll

Talep kimlik doğrulama yöneticisi için temel uygulamayı tanımlar. Talep kimlik doğrulama yöneticisi, yürütme uygulama kodunuz ulaşmadan önce gelen sorumludaki talep koleksiyonuna işleme mantığı (filtreleme, doğrulama, uzantı) uygulamak için talep işleme işlem hattında bir yer sağlar.

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

Devralma

Object

ClaimsAuthenticationManager

Uygulamalar

ICustomIdentityConfiguration

Örnekler

Aşağıdaki kod, gelen talepler üzerinde herhangi bir denetim gerçekleştirmeden gelen sorumluya bir rol talebi ekleyen basit talep kimlik doğrulama yöneticisini gösterir.

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

Aşağıdaki XML öğesi gösterir <claimsAuthenticationManager> .

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

    ...  

  </identityConfiguration>  
</system.identityModel>  

Açıklamalar

Talep kimlik doğrulama yöneticisi, uygulamanın talep işleme işlem hattında, RP uygulama kodu yürütülmeden önce bir tarafından sunulan talep kümesine doğrulamak, filtrelemek, değiştirmek, gelen talepleri eklemek veya yeni talepler eklemek için kullanabileceğiniz bir ClaimsPrincipal genişletilebilirlik noktası sağlar. RP uygulamanız gerektiriyorsa özel ClaimsPrincipal uygulamasını bile döndürebilirsiniz. sınıfı tarafından ClaimsAuthenticationManager sağlanan varsayılan uygulama, değiştirilmemiş talepleri ClaimsPrincipal döndürür; ancak, bu sınıftan türetebilir ve içindeki talepleri ClaimsPrincipal değiştirmek (veya özel ClaimsPrincipalbir döndürmek için) yöntemini geçersiz kılabilirsinizAuthenticate.

Özel talep kimlik doğrulama yöneticisi oluşturmanın tipik bir nedeni, talepleri yalnızca RP uygulaması tarafından bilinen veya RP uygulaması tarafından daha iyi korunan bilgilere göre eklemek, kaldırmak veya dönüştürmektir. Örneğin, bir alışveriş sepeti uygulamasındaki müşteri satın almalarının geçmişi RP uygulaması tarafından tutulan bir veri tabanında tutulabilir ve ardından gelen sorumluda bulunan bir ad talebi değerine göre talep kimlik doğrulama yöneticisi tarafından döndürülen talep sorumlusuna eklenebilir.

Uygulamanızı, sınıfını kullanarak IdentityConfiguration veya claimsAuthenticationManager> öğesi (identityConfiguration öğesinin< alt öğesi<) aracılığıyla yapılandırmada program aracılığıyla kullanacak şekilde yapılandırabilirsiniz.>ClaimsAuthenticationManager Özel yöneticinizin LoadCustomConfiguration yapılandırılabildiği öğenin özel alt öğeleri <claimsAuthenticationManager> için işleme sağlamak üzere yöntemini geçersiz kılabilirsiniz. temel uygulaması ClaimsAuthenticationManager hiçbir alt öğeyi işlemez.

Uygulamanızı talep kimlik doğrulama yöneticisi kullanacak şekilde yapılandırmak, istek işlem hattından Windows Identity Foundation (WIF) tarafından çağrılmasını sağlar.

Oluşturucular

ClaimsAuthenticationManager()

ClaimsAuthenticationManager sınıfının yeni bir örneğini başlatır.

Yöntemler

Authenticate(String, ClaimsPrincipal)	Türetilmiş bir sınıfta geçersiz kılındığında, RP uygulamasının gereksinimleriyle tutarlı bir ClaimsPrincipal nesne döndürür. Varsayılan uygulama gelen ClaimsPrincipalöğesini değiştirmez.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadCustomConfiguration(XmlNodeList)	Türetilmiş bir sınıfta geçersiz kılındığında, XML'den özel yapılandırmayı yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)