Übersicht

Der Wrapper kann verwendet werden, um einen Windows-Dienst mit verschiedenen Aktionen wie START, STOP, RESUME, QUERY usw. zu steuern. Standardmäßig erfordern diese Aktionen Administratorrechte, und bei ihrer Ausführung kann eine Bestätigung der Benutzerkontensteuerung angezeigt werden.

Seit der Version 3.5.42 ermöglicht die Professional Edition des Wrappers das Gewähren von Berechtigungen für Windows-Dienste. Es können beliebig viele Berechtigungen konfiguriert werden, von denen jede einem Benutzer oder einer Gruppe erlaubt, eine Liste von Aktionen auf einem bestimmten Dienst auszuführen.

Es gibt eine Reihe von Fällen, in denen es nützlich sein kann, die Berechtigungen eines Dienstes zu ändern:

Die Berechtigungen werden entweder beim Installieren eines Dienstes oder beim Aktualisieren eines installierten Dienstes gesetzt. Im zweiten Fall muss sich der Dienst im gestoppten Zustand befinden.

Einen Dienst aktualisieren:
.\wrapper.exe -u ../conf/wrapper.conf

Diese Seite beschreibt den Satz von Konfigurationseigenschaften, die zur Verwaltung von Berechtigungen verwendet werden.

Die folgenden Eigenschaften können mit fortlaufenden Indizes aufgelistet werden:

Die folgenden einzelnen Eigenschaften können ebenfalls für erweiterte Konfigurationen verwendet werden:

Zusätzlich ist es möglich, die Berechtigungen eines Dienstes abzufragen.

Berechtigungen konfigurieren

wrapper.ntservice.permissions.<n>.account

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Legt das Konto oder die Gruppe fest, dem bzw. der Zugriffsrechte für den Zieldienst gewährt werden.

Gültige Formate sind:

  • <local_account_or_group_name>
  • .\<local_account_or_group_name>
  • <domain>\<account_or_group_name>

Es ist auch möglich, die Eigenschaft auf 'CURRENT_USER' zu setzen, um den aktuellen Benutzer auf dem Rechner anzugeben, auf dem die Berechtigung gesetzt wird. Dies kann nützlich sein, wenn dieselbe Konfiguration auf mehreren Rechnern mit unterschiedlichen Benutzernamen bereitgestellt wird.

Es gibt keinen Standardwert. Diese Eigenschaft muss zusammen mit wrapper.ntservice.permissions.<n>.allow gesetzt sein, damit eine Berechtigung gültig ist.

Beispiel:
wrapper.ntservice.permissions.1.account=.\mylocalaccount
wrapper.ntservice.permissions.1.allow=START, STOP

Wenn das Konto nicht existiert, zeigt der Wrapper standardmäßig einen Fehler an und bricht ab, bevor irgendwelche Berechtigungen gesetzt werden. Wenn jedoch ein nicht vorhandenes Konto in wrapper.ntservice.permissions.optional_accounts aufgeführt ist, wird die Berechtigung einfach übersprungen.

Sie können beliebig viele Berechtigungen konfigurieren, indem Sie die Komponente "<n>" des Eigenschaftsnamens hochzählen (beginnend bei "1"). Standardmäßig sollte die Nummerierung fortlaufend ohne Lücken erfolgen. Die Eigenschaft wrapper.ignore_sequence_gaps kann optional gesetzt werden, um Lücken in der Sequenz zuzulassen.

Wenn Sie mehrere Berechtigungen haben, die denselben Dienst und dasselbe Konto betreffen, werden die Berechtigungen zusammengeführt, indem der bitweise ODER-Operator verwendet wird. Das bedeutet zum Beispiel: Wenn Berechtigung #1 START gewährt und Berechtigung #2 STOP gewährt, gewährt die resultierende Berechtigung sowohl START als auch STOP. Dies kann verwendet werden, wenn eine Include-Datei eine Berechtigung um zusätzliche Zugriffsrechte erweitern muss.

NOTE

Aus Sicherheitsgründen erlaubt der Wrapper nicht, die Berechtigungen der Gruppe Administrators zu ändern. Dies könnte tatsächlich zu einer blockierten Situation führen, in der es nicht mehr möglich ist, den Dienst zu stoppen/deinstallieren oder sogar seine Berechtigungen zurückzusetzen.

wrapper.ntservice.permissions.<n>.allow

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Legt eine durch Kommas getrennte Liste von Aktionen fest, die eine Berechtigung einem Benutzer oder einer Gruppe für einen Windows-Dienst gewährt.

Es gibt keinen Standardwert. Diese Eigenschaft muss zusammen mit wrapper.ntservice.permissions.<n>.account gesetzt sein, damit eine Berechtigung gültig ist. Sie können sie jedoch auf einen leeren Wert oder auf 'NONE' setzen, um alle Berechtigungen für einen bestimmten Benutzer oder eine bestimmte Gruppe zu entfernen.

Die folgenden Zugriffsrechte können aufgelistet werden:

  • QUERY_STATUS :

    Ermöglicht das Abfragen des Status des Dienstes.

  • QUERY_PERMISSIONS :

    Ermöglicht das Abfragen der Berechtigungen des Dienstes. Verwenden Sie diese Berechtigung zusammen mit UPDATE_CONFIG, wenn Sie einen Dienst aktualisieren.

  • UPDATE_CONFIG :

    Ermöglicht das Aktualisieren der Konfiguration des Dienstes.

  • UPDATE_PERMISSIONS :

    Ermöglicht das Aktualisieren der Berechtigungen des Dienstes.

  • START :

    Ermöglicht das Starten des Dienstes.

  • STOP :

    Ermöglicht das Stoppen des Dienstes.

  • PAUSE_RESUME :

    Ermöglicht das Anhalten/Fortsetzen des Dienstes.

  • INTERROGATE :

    Ermöglicht das Interrogieren des Dienstes. Diese Berechtigung sollte zusammen mit CONTROL_CODE verwendet werden, wenn ein Steuercode zum Interrogieren eines Dienstes gesendet wird.

  • CONTROL_CODE :

    Ermöglicht das Senden benutzerdefinierter Steuerbefehle an den Dienst.

  • ALL :

    Alle Zugriffsrechte.

  • NONE :

    Keine Zugriffsrechte.

Beispiel:
wrapper.ntservice.permissions.1.account=CURRENT_USER
wrapper.ntservice.permissions.1.allow=START, STOP, PAUSE_RESUME

Wenn ein Wert gefunden wird, der oben nicht aufgeführt ist, wird er übersprungen und eine Warnung ausgegeben.

NOTE

Auch wenn Berechtigungen während der Installation eines Dienstes gesetzt werden, werden sie tatsächlich erst nach dem Erstellen des Dienstes gesetzt. Daher gibt es keine Berechtigungen zum Installieren eines Dienstes, da der installierte Status eine Voraussetzung für das Setzen von Berechtigungen ist.

wrapper.ntservice.permissions.<n>.service

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Gibt den Namen des Dienstes an, auf den die Berechtigung angewendet werden soll.

Diese Eigenschaft ist optional. Wenn sie nicht angegeben ist, ist der Standardwert der Name des aktuellen Dienstes (der Wert von wrapper.name).

Beispiel:
wrapper.ntservice.permissions.1.account=CURRENT_USER
wrapper.ntservice.permissions.1.allow=START, STOP, PAUSE_RESUME

wrapper.ntservice.permissions.2.service=dependant_service
wrapper.ntservice.permissions.2.account=CURRENT_USER
wrapper.ntservice.permissions.2.allow=PAUSE_RESUME

Ein Dienst muss existieren, damit die Berechtigung gültig ist. Wenn der Wert mit keinem Namen der installierten Dienste übereinstimmt, zeigt der Wrapper standardmäßig einen Fehler an und bricht ab, bevor irgendwelche Berechtigungen gesetzt werden. Wenn jedoch ein nicht vorhandener Dienst in wrapper.ntservice.permissions.optional_services aufgeführt ist, wird die Berechtigung einfach übersprungen.

Optionale Berechtigungen (für Portabilität)

wrapper.ntservice.permissions.optional_accounts

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Ermöglicht das Auflisten optionaler Konten beim Setzen von Berechtigungen eines Windows-Dienstes. Wenn eine Berechtigung mit einem Konto gesetzt ist, das in dieser Liste enthalten ist, und dieses Konto auf dem Rechner, auf dem der Wrapper ausgeführt wird, nicht existiert, wird die Berechtigung übersprungen, anstatt einen FATAL-Fehler zu verursachen.

Das Auflisten optionaler Konten kann nützlich sein, wenn eine einzelne Konfigurationsdatei auf mehreren Rechnern mit unterschiedlichen Konten bereitgestellt wird. Die Berechtigungen, für die die Konten nicht existieren, werden ignoriert, sodass andere Berechtigungen normal gesetzt werden können.

wrapper.ntservice.permissions.optional_services

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Ermöglicht das Auflisten optionaler Dienste beim Setzen von Berechtigungen eines Windows-Dienstes. Wenn eine Berechtigung mit einem Dienst gesetzt ist, der in dieser Liste enthalten ist, und dieser Dienst auf dem Rechner, auf dem der Wrapper ausgeführt wird, nicht existiert, wird die Berechtigung übersprungen, anstatt einen FATAL-Fehler zu verursachen.

Das Auflisten optionaler Dienste kann nützlich sein, wenn eine einzelne Konfigurationsdatei auf mehreren Rechnern bereitgestellt wird, auf denen unterschiedliche Dienste installiert sind. Die Berechtigungen, für die die Dienste nicht existieren, werden ignoriert, sodass andere Berechtigungen normal gesetzt werden können.

Debuggen

wrapper.ntservice.permissions.check.loglevel

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Steuert den Log-Level, auf dem Debug-Ausgaben beim Prüfen von Berechtigungen ausgegeben werden.

Eine Berechtigung für eine Operation, die der Wrapper auf einem Dienst ausführt, besteht tatsächlich aus mehreren grundlegenden Zugriffsrechten, die vom Windows-Sicherheitsmodell bereitgestellt werden. Bevor eine Operation ausgeführt wird, prüft der Wrapper, ob der aktuelle Benutzer die Berechtigung dafür hat, und prüft somit, ob die grundlegenden Zugriffsrechte gewährt sind. Dabei wird eine Meldung ausgegeben, die den Status (gewährt oder nicht) jedes Zugriffsrechts anzeigt. Diese Eigenschaft ermöglicht die Steuerung des Log-Levels dieser Meldungen.

Der Standardwert ist DEBUG.

Beispiel:
Permission check for testwrapper - QUERY_PERMISSIONS (SERVICE_QUERY_STATUS=TRUE, READ_CONTROL=TRUE) -> OK

Im obigen Beispiel sehen Sie, dass QUERY_PERMISSIONS tatsächlich aus SERVICE_QUERY_STATUS und READ_CONTROL besteht. Beide grundlegenden Zugriffsrechte sind TRUE, was dazu führt, dass QUERY_PERMISSIONS dem aktuellen Benutzer gewährt wird.

Berechtigungen eines Windows-Dienstes abfragen

Kompatibel :3.5.42
Editionen :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Es ist möglich, die Berechtigungen eines Dienstes mit dem folgenden Befehl abzufragen:

Berechtigungen des aktuellen Dienstes abfragen:
.\wrapper.exe -qp ../conf/wrapper.conf
wrapperm | Current user: mypc\myuser
wrapperm |   Is member of: NT AUTHORITY\INTERACTIVE
wrapperm |
wrapperm | Permissions for the testwrapper service:
wrapperm |
wrapperm |   mypc\myuser:
wrapperm |     START, STOP, PAUSE_RESUME
wrapperm |
wrapperm |   NT AUTHORITY\SYSTEM:
wrapperm |     QUERY_STATUS, QUERY_PERMISSIONS, START, STOP, PAUSE_RESUME, INTERROGATE, CONTROL_CODE
wrapperm |
wrapperm |   NT AUTHORITY\INTERACTIVE:
wrapperm |     QUERY_STATUS, QUERY_PERMISSIONS, INTERROGATE, CONTROL_CODE
wrapperm |
wrapperm |   NT AUTHORITY\SERVICE:
wrapperm |     QUERY_STATUS, QUERY_PERMISSIONS, INTERROGATE, CONTROL_CODE

In der Ausgabe des obigen Beispiels sehen Sie, dass myuser Mitglied von NT AUTHORITY\INTERACTIVE ist und somit dessen Berechtigungen erbt. Zusätzlich werden START, STOP, PAUSE_RESUME dem Benutzer speziell gewährt.

Sie können auch die Berechtigungen eines anderen Dienstes abfragen, indem Sie '-qp=serviceName' verwenden.

Berechtigungen eines anderen Dienstes anhand seines Namens abfragen:
.\wrapper.exe -qp=otherservice ../conf/wrapper.conf

Referenz - Windows-Dienste

[Ansicht]

[Start/Stop]