Willkommen Anmelden
Microsoft Developer Network
Vorgehensweise: Verwenden von rollenbasierter Sicherheit mit Enterprise Services
Aktualisiert: 05. Mai 2004

* * *

Auf dieser Seite

Zielsetzung Zielsetzung
Betrifft Betrifft
Verwendung dieses Moduls Verwendung dieses Moduls
Zusammenfassung Zusammenfassung
Benötigte Kenntnisse Benötigte Kenntnisse
Erstellen einer Klassenbibliotheksanwendung als Host für die Serviced Component Erstellen einer Klassenbibliotheksanwendung als Host für die Serviced Component
Erstellen der Serviced Component Erstellen der Serviced Component
Konfigurieren der Serviced Component Konfigurieren der Serviced Component
Erzeugen eines starken Namens für die Assembly Erzeugen eines starken Namens für die Assembly
Erstellen der Assembly und Hinzufügen zum globalen Assemblycache Erstellen der Assembly und Hinzufügen zum globalen Assemblycache
Manuelles Registrieren der Serviced Component Manuelles Registrieren der Serviced Component
Prüfen der konfigurierten Anwendung Prüfen der konfigurierten Anwendung
Erstellen einer Test-Clientanwendung Erstellen einer Test-Clientanwendung

Zielsetzung

Themenbereiche:

  • Erstellen einer Serviced Component, die Enterprise Services-Rollen verwendet, um den Personenkreis einzuschränken, der Zugriff auf die Funktionalität des Computers haben soll.

Betrifft

Die Informationen in diesem Modul gelten für folgende Produkte und Technologien:

  • Microsoft® Windows® XP oder Windows 2000 Server (mit Service Pack 3) und höhere Betriebssysteme

  • Microsoft .NET Framework Version 1.0 (mit Service Pack 2) und höhere Versionen

  • Microsoft Visual C#® .NET

Verwendung dieses Moduls

Empfehlungen für eine erfolgreiche Arbeit mit diesem Modul:

  • Sie müssen über Erfahrung in Visual C# .NET und Microsoft Visual Studio® .NET verfügen.

  • Sie müssen über Erfahrung in der Entwicklung und Implementierung von Serviced Components verfügen, die im Kontext von Enterprise Services (COM+) ausgeführt werden.

  • Sie müssen Erfahrung in der Verwaltung von Serviced Components mit dem Verwaltungsprogramm für Komponentendienste haben.

  • Sie müssen mit der Verwaltung der Gruppenmitgliedschaft bei Windows-Benutzerkonten mithilfe der Windows-Verwaltungsprogramme vertraut sein.

  • Lesen Sie Modul 9, "Enterprise Services-Sicherheit". In diesem Modul werden die Sicherheitsfunktionen von Enterprise Services und die speziellen Funktionen beschrieben, die für sichere Serviced Components zur Verfügung stehen.

Zusammenfassung

Enterprise Services (COM+) bieten ein umfassendes Sicherheitsframework, das Sie für die Implementierung einer differenzierten Steuerung der Zugriffsberechtigungen für die Funktionen der von Ihnen entwickelten Serviced Components nutzen können.

In diesem Modul wird erläutert, wie eine einfache Serviced Component erstellt wird, die Enterprise Services-Rollen für die Autorisierung auf Methodenebene verwendet.

Benötigte Kenntnisse

Bevor Sie mit diesem Modul beginnen, sollten Sie sich über folgende Punkte im Klaren sein:

  • Enterprise Services-Rollen sind nicht dasselbe wie .NET-Rollen.

  • Enterprise Services-Rollen können Windows-Gruppen- oder -Benutzerkonten enthalten.

  • Enterprise Services-Rollen werden im COM+-Katalog verwaltet.

  • Enterprise Services-Rollen können auf der Enterprise Services-Anwendungsebene, auf Schnittstellen-, Klassen- oder Methodenebene zugewiesen werden.

  • Enterprise Services-Rollen können teilweise deklarativ unter Verwendung von .NET-Attributen in der Assembly der Serviced Component konfiguriert werden.

  • Windows-Gruppen- und Benutzerkonten müssen zum Zeitpunkt der Entwicklung von einem Administrator hinzugefügt werden.

  • Administratoren können das Verwaltungsprogramm oder -skript für Komponentendienste verwenden.

  • Für einen effektiven Einsatz der von Enterprise Services gebotenen rollenbasierten Sicherheit in einer ASP.NET-Webanwendung muss diese die Windows-Authentifizierung verwenden und die Identität der Benutzer vor dem Start der Serviced Components wechseln.

Erstellen einer Klassenbibliotheksanwendung als Host für die Serviced Component

Mit dem nachstehenden Verfahren wird eine neue C#-Klassenbibliotheksanwendung erstellt, die die Serviced Component enthält.

  • So erstellen Sie eine C#-Klassenbibliotheksanwendung als Host für die Serviced Component

    1. Starten Sie Visual Studio .NET und öffnen Sie in C# eine neue Klassenbibliotheksanwendung mit Namen ServicedCom.

    2. Benennen Sie die standardmäßige Klassendatei Class1.cs in SimpleComponent.cs um.

    3. Doppelklicken Sie auf SimpleComponent.cs, um die Datei zu öffnen, und benennen Sie den Typ Class1 in SimpleComponent um. Aktualisieren Sie auch den Namen des Standardkonstruktors der Klasse entsprechend.

Erstellen der Serviced Component

In diesem Verfahren wird die SimpleComponent-Klasse von der EnterpriseServices.ServicedComponent-Klasse abgeleitet, um diesen Typ in eine Serviced Component umzuwandeln. Anschließend wird eine Schnittstelle erstellt und diese in der SimpleComponent-Klasse implementiert. Um Sicherheit auf Schnittstellen- und Methodenebene gewährleisten zu können, müssen Sie Schnittstellen definieren und implementieren.

  • So erstellen Sie die Serviced Component

    1. Fügen Sie einen Verweis auf die System.EnterpriseServices-Assembly hinzu.

    2. Fügen Sie am Anfang der Datei SimpleComponent.cs unterhalb der vorhandenen using-Anweisungen die folgende using-Anweisung hinzu.

      using System.EnterpriseServices;

    3. Leiten Sie die SimpleComponent-Klasse von ServicedComponent ab.

      public class SimpleComponent : ServicedComponent

    4. Fügen Sie innerhalb des ServicedCom-Namespaces die folgende Schnittstellendefinition hinzu.

      public interface ISomeInterface
{
  int Add( int operand1, int operand2 );
}

    5. Leiten Sie SimpleComponent von dieser Schnittstelle ab.

      public class SimpleComponent : ServicedComponent, ISomeInterface

    6. Implementieren Sie die Schnittstelle wie folgt in der SimpleComponent-Klasse:

      public int Add( int operand1, int operand2 )
{
    return operand1 + operand2;
}

Konfigurieren der Serviced Component

Mit diesem Verfahren wird die Serviced Component für die rollenbasierte Sicherheit auf Methodenebene konfiguriert.

  • So konfigurieren Sie die Serviced Component

    1. Fügen Sie die folgenden Attribute direkt oberhalb der SimpleComponent-Klasse hinzu. Das ComponentAccessControl-Attribut ermöglicht Zugriffsüberprüfungen auf Komponentenebene, das SecureMethod-Attribut ermöglicht Zugriffsüberprüfungen auf Methodenebene.

      [ComponentAccessControl]
[SecureMethod]
public class SimpleComponent : ServicedComponent, ISomeInterface

    2. Fügen Sie oberhalb der Addieren-Methode das folgende Attribut hinzu, um die Manager-Rolle zu erstellen und diese der Methode zuzuordnen.

      [SecurityRole("Manager")]
public int Add( int operand1, int operand2 )
{
  return operand1 + operand2;
}

    3. Öffnen Sie Assemblyinfo.cs und fügen Sie am Anfang der Datei unterhalb der vorhandenen using-Anweisungen die folgende using-Anweisung hinzu.

      using System.EnterpriseServices;

    4. Wechseln Sie zum Ende der Datei und fügen Sie die nachstehenden Attribute hinzu. Diese werden verwendet, um die Enterprise Services-Anwendung zu konfigurieren, die als Host für die Serviced Component dient. 

      // Konfigurieren der Anwendung als Serveranwendung (Out-of-Process)
[assembly: ApplicationActivation(ActivationOption.Server)]
// Um eine sinnvolle rollenbasierte Sicherheit zu erreichen, müssen Sie Zugriffsprüfungen auf Prozess- 
// und Komponentenebene aktivieren, indem Sie das folgende .NET-Attribut verwenden.
[assembly: ApplicationAccessControl(AccessChecksLevel= 
                        AccessChecksLevelOption.ApplicationComponent)]
// Set the name and description for the application
[assembly: ApplicationName("SimpleRoles")]
[assembly: Description("Einfache Anwendung zum Zeigen von ES-Rollen")]
// Add some additional roles
[assembly:SecurityRole("Mitarbeiter")]
[assembly:SecurityRole("Senior Manager")]

Erzeugen eines starken Namens für die Assembly

Assemblys, die als Host für Serviced Components fungieren, müssen über einen starken Namen verfügen. Mit diesem Verfahren wird ein Schlüsselpaar aus öffentlichem und privatem Schlüssel erzeugt, das für die Vergabe eines starken Namens für die Assembly herangezogen wird.

  • So erzeugen Sie einen starken Namen für die Assembly

    1. Öffnen Sie ein Befehlsfenster und wechseln Sie in das aktuelle Projektverzeichnis.

    2. Erzeugen Sie mithilfe des Dienstprogramms Sn.exe eine Schlüsseldatei, die ein Schlüsselpaar enthält, das aus einem öffentlichen und einem privaten Schlüssel besteht.

      sn.exe -k SimpleComponent.snk

    3. Öffnen Sie Assemblyinfo.cs in Visual Studio.

    4. Suchen Sie das Attribut [AssemblyKeyFile] und ändern Sie es so, dass es auf die Schlüsseldatei im Projektverzeichnis verweist:

      [assembly: AssemblyKeyFile(@"..\..\SimpleComponent.snk")]

Erstellen der Assembly und Hinzufügen zum globalen Assemblycache

In diesem Verfahren wird die Assembly erstellt, die die Serviced Component enthält. Anschließend wird die Assembly dem globalen Assemblycache hinzugefügt. Serviced Components sollten generell im globalen Assemblycache registriert werden, da es sich um Ressourcen auf Systemebene handelt. Im Gegensatz zu Bibliotheksanwendungen (für die diese Vorgehensweise allerdings ebenfalls zu empfehlen ist) MÜSSEN Serviced Components, für die COM+-Serveranwendungen als Host fungieren, im globalen Assemblycache installiert werden.

  • So erstellen Sie die Assembly und fügen sie dem globalen Assemblycache hinzu

    1. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

    2. Kehren Sie zum Befehlsfenster zurück und führen Sie den folgenden Befehl aus, um die Assembly dem globalen Assemblycache hinzuzufügen.

      gacutil -i bin\debug\ServicedCom.dll

Manuelles Registrieren der Serviced Component

Serviced Components können entweder manuell mit dem Tool Regsvcs.exe oder automatisch mithilfe der "verzögerten" Registrierung registriert werden. Bei der "verzögerten" Registrierung wird die Komponente (und die als Host fungierende COM+-Anwendung, die mithilfe der Metadaten der Assembly entwickelt und konfiguriert wurde) beim erstmaligen Aufbau einer Instanz der Serviced Component registriert.

Um den - allerdings einmaligen - Leistungsabfall zu vermeiden, der mit diesem Ansatz einhergeht, wird die Serviced Component in diesem Verfahren manuell registriert.

So registrieren Sie die Serviced Component manuell

  1. Kehren Sie zum Befehlsfenster zurück.

  2. Führen Sie Regsvcs.exe aus, um die Komponente zu registrieren.

    regsvcs bin\debug\ServicedCom.dll

Prüfen der konfigurierten Anwendung

In diesem Verfahren wird das Tool für Komponentendienste verwendet, um die Katalogeinstellungen zu prüfen, die als Ergebnis der zuvor verwendeten .NET-Attribute erstellt wurden.

  • So prüfen Sie die konfigurierte Anwendung

    1. Starten Sie die Komponentendienste aus der Programmgruppe Verwaltung.

    2. Erweitern Sie die Ordner Komponentendienste, Computer, Arbeitsplatz und COM+-Anwendungen.

    3. Klicken Sie mit der rechten Maustaste auf SimpleRoles und dann auf Eigenschaften.

    4. Klicken Sie auf die Registerkarte Sicherheit und vergewissern Sie sich, dass Zugriffsüberprüfung für diese Anwendung erzwingen aktiviert ist und dass die Sicherheitsebene so eingestellt ist, dass Zugriffsüberprüfungen auf Prozess- und Komponentenebene durchgeführt werden. Diese Konfiguration ist das Ergebnis der im Vorfeld zugewiesenen .NET-Attribute.

    5. Klicken Sie auf OK, um das Dialogfeld Eigenschaften zu schließen.

    6. Erweitern Sie die Anwendung SimpleRoles sowie anschließend den Ordner Components und die ServicedCom.SimpleComponent-Klasse.

    7. Suchen Sie die Addieren-Methode unterhalb der ISomeInterface-Methode im Ordner Interfaces.

    8. Klicken Sie mit der rechten Maustaste auf Addieren und dann auf Eigenschaften.

    9. Klicken Sie auf die Registerkarte Sicherheit. Beachten Sie, dass die Manager-Rolle dieser Methode zugeordnet ist.

    10. Klicken Sie auf OK, um das Dialogfeld Eigenschaften zu schließen.

    11. Erweitern Sie den Ordner Roles unterhalb der SimpleRoles-Anwendung. Beachten Sie die Rollen, die Sie im Vorfeld mit .NET-Attributen erstellt haben. Beachten Sie zudem die Marshaler-Rolle. Diese wird als ein direktes Ergebnis des zuvor hinzugefügten [SecureMethod]-Attributs erstellt und ist für die Sicherheit auf Methodenebene zwingend erforderlich.

Erstellen einer Test-Clientanwendung

In diesem Verfahren wird eine Test-Clientanwendung basierend auf Windows-Formularen erstellt, um die Serviced Component zu instanziieren und aufzurufen.

  • So erstellen Sie eine Test-Clientanwendung

    1. Fügen Sie dem aktuellen Projekt mit C# eine neue Windows-basierte Anwendung mit Namen TestClient hinzu.

    2. Fügen Sie dem ServicedCom-Projekt einen neuen Projektverweis hinzu.

      1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise und dann auf Verweis hinzufügen.

      2. Klicken Sie auf die Registerkarte Projekte.

      3. Wählen Sie ServicedCom und klicken Sie auf Auswählen sowie auf OK.

    3. Fügen Sie einen Verweis auf System.EnterpriseServices hinzu.

    4. Fügen Sie dem Hauptformular der Anwendung eine Schaltfläche hinzu.

    5. Doppelklicken Sie auf die Schaltfläche, um einen Ereignishandler für das Klickereignis der Schaltfläche zu erstellen.

    6. Fügen Sie am Anfang von form1.cs unterhalb der vorhandenen using-Anweisungen die folgende using-Anweisung hinzu.

      using ServicedCom;

    7. Kehren Sie zum Ereignishandler für das Klickereignis zurück und fügen Sie den folgenden Code hinzu, um die Serviced Component zu instanziieren und aufzurufen.

      SimpleComponent comp = new SimpleComponent();
MessageBox.Show( "Ergebnis: " + comp.Add(1, 2));

    8. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

    9. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt TestClient und dann auf Als Startprojekt festlegen.

    10. Drücken Sie Strg+F5, um die Anwendung TestClient auszuführen.
      Nun sollte eine unbehandelte Ausnahme erzeugt werden.

    11. Klicken Sie im Meldungsfenster auf die Schaltfläche Details, um weitere Informationen zu der Ausnahmebedingung anzuzeigen.
      Wie Sie sehen, wurde die Ausnahme System.UnauthorizedAccessExecption erzeugt. Der Grund hierfür ist, dass Ihr interaktives Anmeldekonto, das zum Ausführen der Anwendung TestClient verwendet wurde, kein Mitglied der Manager-Rolle ist. Das ist notwendig, um die Addieren-Methode für die Serviced Component aufzurufen.

    12. Klicken Sie auf Quit, um die Anwendung zu beenden.

    13. Kehren Sie zu den Komponentendiensten zurück und fügen Sie Ihr aktuelles (interaktives) Konto der Manager- und der Marshaler-Rolle hinzu.

      Hinweis: Die Enterprise Services-Infrastruktur verwendet eine Reihe von Schnittstellen auf Systemebene, die von allen Serviced Components bereitgestellt werden. Hierzu gehören IManagedObject, IDisposable und IServiceComponentInfo. Wenn Zugriffsüberprüfungen auf Schnittstellen- oder Methodenebene aktiviert sind, wird der Enterprise Services-Infrastruktur der Zugriff auf diese Schnittstellen verweigert.

      Infolgedessen erzeugt Enterprise Services eine spezielle Rolle mit Namen Marshaler und verbindet diese Rolle mit den Schnittstellen. Zur Bereitstellungszeit muss der Anwendungsadministrator also alle Benutzer der Marshaler-Rolle hinzufügen, die Zugriff auf beliebige Methoden oder Schnittstellen dieser Klasse benötigen. Hierfür gibt es zwei unterschiedliche Automatisierungsmöglichkeiten:

      1. Schreiben Sie ein Skript, das das Objektmodell der Komponentendienste zugrunde legt, um alle Benutzer aus anderen Rollen in die Marshaler-Rolle zu kopieren.

      2. Schreiben Sie ein Skript, das alle anderen Rollen diesen drei speziellen Schnittstellen zuordnet, und löschen Sie die Marshaler-Rolle.

    14. Schließen Sie die SimpleRoles-Anwendung, damit die Änderungen wirksam werden können. Klicken Sie hierzu auf den Namen der Anwendung und dann auf Shut down.

    15. Kehren Sie zu Visual Studio .NET zurück und drücken Sie STRG+F5, um die TestClient-Anwendung erneut auszuführen.

    16. Klicken Sie auf die entsprechende Schaltfläche im Formular und vergewissern Sie sich, dass die Methode erfolgreich aufgerufen wird.


Page view tracker