Nasıl yapılır: Özel Yetkilendirme İlkesi Oluşturma
Windows Communication Foundation'daki (WCF) Kimlik Modeli altyapısı, talep tabanlı yetkilendirme modelini destekler. Talepler belirteçlerden ayıklanır, isteğe bağlı olarak özel yetkilendirme ilkesi tarafından işlenir ve daha sonra yetkilendirme kararları almak için incelenebilen bir AuthorizationContext içine yerleştirilir. Özel bir ilke, gelen belirteçlerden gelen talepleri uygulama tarafından beklenen taleplere dönüştürmek için kullanılabilir. Bu şekilde uygulama katmanı, WCF'nin desteklediği farklı belirteç türleri tarafından sunulan farklı taleplerle ilgili ayrıntılardan yalıtılabilir. Bu konuda, özel yetkilendirme ilkesinin nasıl uygulandığı ve bu ilkenin bir hizmet tarafından kullanılan ilke koleksiyonuna nasıl ekleneceği gösterilmektedir.
Özel yetkilendirme ilkesi uygulamak için
öğesinden IAuthorizationPolicytüretilen yeni bir sınıf tanımlayın.
sınıfı için oluşturucuda benzersiz bir dize oluşturarak ve özelliğe her erişildiğinde bu dizeyi döndürerek salt okunur Id özelliğini uygulayın.
İlke vereni temsil eden bir ClaimSet döndürerek salt okunur Issuer özelliğini uygulayın. Bu, uygulamayı temsil eden bir veya yerleşik
ClaimSet
(örneğin,ClaimSet
statik System özellik tarafından döndürülen) olabilirClaimSet
.Evaluate(EvaluationContext, Object) yöntemini aşağıdaki yordamda açıklandığı gibi uygulayın.
Evaluate yöntemini uygulamak için
Bu yönteme iki parametre geçirilir: sınıfın EvaluationContext bir örneği ve bir nesne başvurusu.
Özel yetkilendirme ilkesi geçerli içeriğine EvaluationContextbakılmaksızın örnekler eklerseClaimSet, yöntemini çağırarak AddClaimSet(IAuthorizationPolicy, ClaimSet) ve yönteminden Evaluate döndürerek
true
herClaimSet
birini ekleyin. döndürmetrue
, yetkilendirme altyapısına yetkilendirme ilkesinin çalışmasını gerçekleştirdiğini ve yeniden çağrılması gerekmediğini gösterir.Özel yetkilendirme ilkesi yalnızca içinde belirli talepler zaten mevcutsa
EvaluationContext
talep kümeleri eklerse, özelliği tarafından ClaimSets döndürülen örnekleri inceleyerekClaimSet
bu talepleri arayın. Talepler varsa yöntemini çağırarak AddClaimSet(IAuthorizationPolicy, ClaimSet) yeni talep kümelerini ekleyin ve daha fazla talep kümesi eklenmezse, yetkilendirme ilkesinin çalışmasını tamamlandığını yetkilendirme altyapısına belirten değerini döndürürtrue
. Talepler mevcut değilse, diğer yetkilendirme ilkeleri öğesine daha fazla talep kümesiEvaluationContext
eklerse yetkilendirme ilkesinin yeniden çağrılması gerektiğini belirten döndürürfalse
.Daha karmaşık işleme senaryolarında, yöntemin Evaluate(EvaluationContext, Object) ikinci parametresi, yetkilendirme altyapısının belirli bir değerlendirme için yöntemine sonraki her çağrı sırasında geri geçireceği bir durum değişkenini Evaluate(EvaluationContext, Object) depolamak için kullanılır.
Yapılandırma aracılığıyla özel yetkilendirme ilkesi belirtmek için
öğesindeki öğesindeki özniteliğindeki
policyType
özel yetkilendirme ilkesininadd
authorizationPolicies
serviceAuthorization
türünü belirtin.<configuration> <system.serviceModel> <behaviors> <serviceAuthorization serviceAuthorizationManagerType= "Samples.MyServiceAuthorizationManager" > <authorizationPolicies> <add policyType="Samples.MyAuthorizationPolicy" /> </authorizationPolicies> </serviceAuthorization> </behaviors> </system.serviceModel> </configuration>
Kod aracılığıyla özel yetkilendirme ilkesi belirtmek için
bir List<T> oluşturun IAuthorizationPolicy.
Özel yetkilendirme ilkesinin bir örneğini oluşturun.
Yetkilendirme ilkesi örneğini listeye ekleyin.
Her özel yetkilendirme ilkesi için 2. ve 3. adımları yineleyin.
Özelliğine listenin salt okunur bir sürümünü atayın ExternalAuthorizationPolicies .
// Add a custom authorization policy to the service authorization behavior. List<IAuthorizationPolicy> policies = new List<IAuthorizationPolicy>(); policies.Add(new MyAuthorizationPolicy()); serviceHost.Authorization.ExternalAuthorizationPolicies = policies.AsReadOnly();
' Add custom authorization policy to service authorization behavior. Dim policies As List(Of IAuthorizationPolicy) = New List(Of IAuthorizationPolicy)() policies.Add(New MyAuthorizationPolicy()) serviceHost.Authorization.ExternalAuthorizationPolicies = policies.AsReadOnly()
Örnek
Aşağıdaki örnekte eksiksiz IAuthorizationPolicy bir uygulama gösterilmektedir.
public class MyAuthorizationPolicy : IAuthorizationPolicy
{
string id;
public MyAuthorizationPolicy()
{
id = Guid.NewGuid().ToString();
}
public bool Evaluate(EvaluationContext evaluationContext, ref object state)
{
bool bRet = false;
CustomAuthState customstate = null;
// If the state is null, then this has not been called before so
// set up a custom state.
if (state == null)
{
customstate = new CustomAuthState();
state = customstate;
}
else
{
customstate = (CustomAuthState)state;
}
// If claims have not been added yet...
if (!customstate.ClaimsAdded)
{
// Create an empty list of claims.
IList<Claim> claims = new List<Claim>();
// Iterate through each of the claim sets in the evaluation context.
foreach (ClaimSet cs in evaluationContext.ClaimSets)
// Look for Name claims in the current claimset.
foreach (Claim c in cs.FindClaims(ClaimTypes.Name, Rights.PossessProperty))
// Get the list of operations the given username is allowed to call.
foreach (string s in GetAllowedOpList(c.Resource.ToString()))
{
// Add claims to the list.
claims.Add(new Claim("http://example.org/claims/allowedoperation", s, Rights.PossessProperty));
Console.WriteLine("Claim added {0}", s);
}
// Add claims to the evaluation context.
evaluationContext.AddClaimSet(this, new DefaultClaimSet(this.Issuer, claims));
// Record that claims were added.
customstate.ClaimsAdded = true;
// Return true, indicating that this method does not need to be called again.
bRet = true;
}
else
{
// Should never get here, but just in case, return true.
bRet = true;
}
return bRet;
}
public ClaimSet Issuer
{
get { return ClaimSet.System; }
}
public string Id
{
get { return id; }
}
// This method returns a collection of action strings that indicate the
// operations the specified username is allowed to call.
private IEnumerable<string> GetAllowedOpList(string username)
{
IList<string> ret = new List<string>();
if (username == "test1")
{
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Add");
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Multiply");
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Subtract");
}
else if (username == "test2")
{
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Add");
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Subtract");
}
return ret;
}
// Internal class for keeping track of state.
class CustomAuthState
{
bool bClaimsAdded;
public CustomAuthState()
{
bClaimsAdded = false;
}
public bool ClaimsAdded
{
get { return bClaimsAdded; }
set { bClaimsAdded = value; }
}
}
}
Public Class MyAuthorizationPolicy
Implements IAuthorizationPolicy
Private id_Value As String
Public Sub New()
id_Value = Guid.NewGuid().ToString()
End Sub
Public Function Evaluate(ByVal evaluationContext As EvaluationContext, ByRef state As Object) As Boolean _
Implements IAuthorizationPolicy.Evaluate
Dim bRet As Boolean = False
Dim customstate As CustomAuthState = Nothing
' If the state is null, then this has not been called before, so set up
' our custom state.
If state Is Nothing Then
customstate = New CustomAuthState()
state = customstate
Else
customstate = CType(state, CustomAuthState)
End If
' If claims have not been added yet...
If Not customstate.ClaimsAdded Then
' Create an empty list of Claims.
Dim claims as IList(Of Claim) = New List(Of Claim)()
' Iterate through each of the claimsets in the evaluation context.
Dim cs As ClaimSet
For Each cs In evaluationContext.ClaimSets
' Look for Name claims in the current claimset...
Dim c As Claim
For Each c In cs.FindClaims(ClaimTypes.Name, Rights.PossessProperty)
' Get the list of operations that the given username is allowed to call.
Dim s As String
For Each s In GetAllowedOpList(c.Resource.ToString())
' Add claims to the list.
claims.Add(New Claim("http://example.org/claims/allowedoperation", s, Rights.PossessProperty))
Console.WriteLine("Claim added {0}", s)
Next s
Next c
Next cs ' Add claims to the evaluation context.
evaluationContext.AddClaimSet(Me, New DefaultClaimSet(Me.Issuer, claims))
' Record that claims were added.
customstate.ClaimsAdded = True
' Return true, indicating that this does not need to be called again.
bRet = True
Else
' Should never get here, but just in case...
bRet = True
End If
Return bRet
End Function
Public ReadOnly Property Issuer() As ClaimSet Implements IAuthorizationPolicy.Issuer
Get
Return ClaimSet.System
End Get
End Property
Public ReadOnly Property Id() As String Implements IAuthorizationPolicy.Id
Get
Return id_Value
End Get
End Property
' This method returns a collection of action strings that indicate the
' operations the specified username is allowed to call.
' Operations the specified username is allowed to call.
Private Function GetAllowedOpList(ByVal userName As String) As IEnumerable(Of String)
Dim ret As IList(Of String) = new List(Of String)()
If username = "test1" Then
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Add")
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Multiply")
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Subtract")
ElseIf username = "test2" Then
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Add")
ret.Add("http://Microsoft.ServiceModel.Samples/ICalculator/Subtract")
End If
Return ret
End Function
' internal class for keeping track of state
Class CustomAuthState
Private bClaimsAdded As Boolean
Public Sub New()
bClaimsAdded = False
End Sub
Public Property ClaimsAdded() As Boolean
Get
Return bClaimsAdded
End Get
Set
bClaimsAdded = value
End Set
End Property
End Class
End Class