AuthorizationContext Klasa

Definicja

Przestrzeń nazw:

System.Security.Claims

Zestaw:

System.IdentityModel.dll

Zawiera informacje kontekstowe zdarzenia autoryzacji. Obejmuje to podmiot zabezpieczeń reprezentujący obiekt wywołujący, żądany zasób oraz wykonywaną akcję.

public ref class AuthorizationContext

public class AuthorizationContext

type AuthorizationContext = class

Public Class AuthorizationContext

Dziedziczenie

Object

AuthorizationContext

Przykłady

Przykładowy kod używany w AuthorizationContext temacie jest pobierany z przykładu Claims Based Authorization . Ten przykład zawiera niestandardowego menedżera autoryzacji oświadczeń, który może autoryzować podmioty na podstawie zasad określonych w konfiguracji. Ten menedżer niestandardowy składa się z trzech podstawowych składników: klasy pochodnej od ClaimsAuthorizationManager tego, która implementuje menedżera, ResourceAction klasę, która paruje zasób i akcję, oraz czytnik zasad, który odczytuje i kompiluje zasady określone w pliku konfiguracji. Te skompilowane zasady mogą być następnie używane przez menedżera autoryzacji oświadczeń do oceny podmiotu zabezpieczeń w celu autoryzowania dostępu do zasobów. Nie wszystkie elementy są wyświetlane ze względu na zwięzłość. Aby uzyskać informacje o tym przykładzie i innych przykładach dostępnych dla programu WIF oraz o tym, gdzie je pobrać, zobacz Przykładowy indeks kodu programu WIF.

Poniższy kod przedstawia metodę CheckAccess menedżera autoryzacji oświadczeń niestandardowych. Funkcja, która oblicza jednostkę na podstawie zasobu i akcji określonej w wywołaniu AuthorizationContext . Ta funkcja zwraca wartość true lub false, która udziela lub odmawia dostępu do podmiotu zabezpieczeń.

static Dictionary<ResourceAction, Func<ClaimsPrincipal, bool>> _policies = new Dictionary<ResourceAction, Func<ClaimsPrincipal, bool>>();
PolicyReader _policyReader = new PolicyReader();

    /// <summary>
    /// Checks if the principal specified in the authorization context is authorized to perform action specified in the authorization context 
    /// on the specified resoure
    /// </summary>
    /// <param name="pec">Authorization context</param>
    /// <returns>true if authorized, false otherwise</returns>
    public override bool CheckAccess(AuthorizationContext pec)
    {
        //
        // Evaluate the policy against the claims of the 
        // principal to determine access
        //
        bool access = false;
        try
        {
            ResourceAction ra = new ResourceAction(pec.Resource.First<Claim>().Value, pec.Action.First<Claim>().Value);

            access = _policies[ra](pec.Principal);
        }
        catch (Exception)
        {
            access = false;
        }

        return access;
    }
}

Poniższy kod XML przedstawia przykład zasad autoryzacji, które zostały określone w konfiguracji. W pierwszej zasadach podmiot zabezpieczeń musi posiadać jedno z określonych oświadczeń, aby wykonać określoną akcję dla określonego zasobu. W drugiej zasadach podmiot zabezpieczeń musi posiadać oba oświadczenia, aby móc wykonać określoną akcję w określonym zasobie. We wszystkich innych podmiotach podmiot zabezpieczeń jest automatycznie udzielany dostępu niezależnie od posiadanych roszczeń.

<system.identityModel>
  <identityConfiguration>
    <claimsAuthorizationManager type="ClaimsAuthorizationLibrary.MyClaimsAuthorizationManager, ClaimsAuthorizationLibrary">
      <policy resource="http://localhost:28491/Developers.aspx" action="GET">
        <or>
          <claim claimType="http://schemas.microsoft.com/ws/2008/06/identity/claims/role" claimValue="developer" />
          <claim claimType="http://schemas.xmlsoap.org/claims/Group" claimValue="Administrator" />
        </or>
      </policy>
      <policy resource="http://localhost:28491/Administrators.aspx" action="GET">
        <and>
          <claim claimType="http://schemas.xmlsoap.org/claims/Group" claimValue="Administrator" />
          <claim claimType="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country" claimValue="USA" />
        </and>
      </policy>
      <policy resource="http://localhost:28491/Default.aspx" action="GET">
      </policy>
      <policy resource="http://localhost:28491/" action="GET">
      </policy>
      <policy resource="http://localhost:28491/Claims.aspx" action="GET">
      </policy>
    </claimsAuthorizationManager>

    ...

  </identityConfiguration>
</system.identityModel>

Uwagi

Klasa AuthorizationContext reprezentuje kontekst używany przez menedżera autoryzacji oświadczeń, implementację ClaimsAuthorizationManager klasy, aby określić, czy podmiot (podmiot) powinien być upoważniony do wykonywania określonej akcji dla danego zasobu. Menedżer autoryzacji oświadczeń ocenia kontekst autoryzacji w CheckAccess metodzie i odmawia lub udziela dostępu na podstawie oświadczeń przedstawionych przez podmiot zabezpieczeń.

Właściwość Principal zawiera podmiot zabezpieczeń, dla którego żądano autoryzacji, Resource właściwość zawiera zasób, na którym podmiot zabezpieczeń jest autoryzowany, a Action właściwość zawiera akcje, które podmiot zabezpieczeń zamierza wykonać w zasobie. Zarówno zasób, jak i akcja są reprezentowane jako kolekcja oświadczeń; jednak w większości przypadków każda kolekcja zawiera pojedyncze oświadczenie.

Konstruktory

AuthorizationContext(ClaimsPrincipal, Collection<Claim>, Collection<Claim>)	Inicjuje AuthorizationContext nowe wystąpienie klasy z określonym podmiotem zabezpieczeń, oświadczeniem zasobu i oświadczeniem akcji.
AuthorizationContext(ClaimsPrincipal, String, String)	Inicjuje AuthorizationContext nowe wystąpienie klasy z określoną jednostką, nazwą zasobu i nazwą akcji.

Właściwości

Action	Pobiera akcję, dla której podmiot zabezpieczeń ma być autoryzowany.
Principal	Pobiera podmiot zabezpieczeń, dla którego żądano autoryzacji.
Resource	Pobiera zasób, na którym podmiot zabezpieczeń ma być autoryzowany.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)