Zum Hauptinhalt gehen

Installation und Konfiguration des Lizenzierungsagenten

Hinweis: Anstelle des Lizenzagenten empfehlen wir die Active Directory-Lizenzierung oder die Entra ID-Lizenzierung

 

Vorbereitende Schritte

Allgemein

  1. Stellen Sie sicher, dass Sie Ihren Lizenzschlüssel zur Hand haben.
  2. Stellen Sie sicher, dass Sie Ihre axes4 ID zur Hand haben, falls Sie bereits eine besitzen. Alternativ legen Sie eine axes4 ID an.
  3. Klären Sie, welchen Namen Sie dem Team-Lizenzkonto geben wollen – in der Regel wird dies der Name Ihrer Organisation sein.
  4. Stellen Sie sicher, dass Sie die Domänen-Benutzernamen aller Benutzer und / oder die Domänen zur Hand haben, denen Sie Lizenzen zuweisen wollen.

In Bezug auf den Server

  1. Hostname des Servers parat haben, auf dem der Lizenzierungsagent installiert werden soll
  2. Entscheiden, ob Sie den Standard-Port 29374 oder einen individuellen Port verwenden wollen. In der Windows-Firewall wird der Port während der Installation bereits freigeschaltet.
  3. Falls erforderlich: Konfigurieren Sie zusätzliche Firewalls in Ihrem Netzwerk, so dass die Clients auf den Lizenzierungsagenten zugreifen können.
  4. Falls nicht schon vorhanden: Erstellen Sie ein TLS-Zertifikat für Ihren Server.
  5. Stellen Sie sicher, dass Sie Ihren Lizenzschlüssel zur Hand haben.

Lizenzverwaltung: Team-Lizenzkonto anlegen oder auswählen

  1. Loggen Sie sich mit Ihrer axes4 ID in der Lizenzverwaltung ein.
    Bildschirmansicht: axes4 Login.

    Sie gelangen automatisch zur Lizenzverwaltung:
    Bildschirmfoto: Lizenzverwaltung mit der Übersichtsansicht der Lizenzen im Persönlichen Konto.

  2. Betätigen Sie die Schaltfläche über dem Persönlichen Lizenzkonto:
    Bildschirmfoto: Lizenzverwaltung mit der Übersichtsansicht der Lizenzen mit hervorgehobenem Konto-Aufklappmenü.

    Es öffnet sich das Kontenmenü:
    Bildschirmfoto: Lizenzverwaltung mit der Übersichtsansicht der Lizenzen mit aufgeklapptem Konto-Menü.

  3. Betätigen Sie die Schaltfläche + Lizenzkonto eröffnen. Es öffnet sich das Dialogfenster Lizenzkonto eröffnen:
    Bildschirmfoto: Dialogfenster 'Lizenzkonto eröffnen' mit Eingabefeld zum Eingeben der Bezeichnung des Lizenzkontos.

  4. In das Eingabefeld Lizenzkonto Bezeichnung geben Sie einen selbstgewählten Namen für das neue Team-Lizenzkonto (=Teamkonto) ein und bestätigen Sie mit der Schaltfläche Lizenzkonto erstellen. Sie gelangen zurück zur Hauptseite der Lizenzverwaltung und befinden sich gleich in Ihrem neuen Teamkonto:
    Bildschirmfoto: Lizenzverwaltung: mit neu angelegtem Teamkonto und noch leerer Übersichtsansicht der Lizenzen.

Lizenzierungsagent installieren

  1. Laden Sie den Lizenzierunsagenten hier herunter.
  2. Installieren Sie den Lizenzierungsagenten auf Ihrem eigenen Server.
  3. Tragen Sie während des Installationsprozesses den Hostnamen (oder die IP-Adresse) und den Port ein.

Lizenzierungsagent aktivieren

  1. Rufen Sie den Lizenzierungsagenten unter der konfigurierten Adresse im Browser auf: https://<hostname>:<port>/admin
  2. Loggen Sie sich als Administrator des Team-Lizenzkontos mit Ihrer axes4 ID im Lizenzierungsagenten ein.
  3. Aktivieren Sie den Lizenzierungsagent über die entsprechende Schaltfläche.
  4. Legen Sie den Namen des Lizenzierungsagenten fest. Wir empfehlen das Wort „Agent“ als Teil des Namens.

Lizenzverwaltung: Lizenz dem Team-Lizenzkonto hinzufügen

  1. Loggen Sie sich in die axes4 Lizenzverwaltung ein
  2. Rufen Sie das oben angelegte Teamkonto auf
  3. Stellen Sie sicher, dass Sie sich wirklich im richtigen Team-Lizenzkonto befinden (und nicht in Ihrem persönlichen Lizenzkonto).

  4. Betätigen Sie die Schaltfläche Lizenz hinzufügen
    Bildschirmfoto: Lizenzverwaltung: mit neu angelegtem Teamkonto und noch leerer Übersichtsansicht der Lizenzen. Über die Schltfläche 'Lizenz hinzufügen' lässt sich eine Lizenz dem Konto hinzufügen.

  5. Geben Sie im Dialogfenster Lizenz hinzufügen Ihren Lizenzschlüssel in das Eingabefeld ein und betätigen Sie die Schaltfläche Bestätigen.
    Bildschirmfoto: Dialogfenster 'Lizenz hinzufügen' mit Eingabefeld zum Eingeben des Lizenzschlüssels.

  6. Im nächsten Dialogfenster werden Sie um eine Bestätigung Ihrer Eingabe gebeten, da Sie den Lizenzschlüssel nur einmal eingeben können. Betätigen Sie die Schaltfläche Bestätigen:
    Bildschirmfoto: Dialogfenster 'Lizenz hinzufügen' mit der Rückmeldung, dass der Lizenzschlüssel gefunden wurde. Über die Schaltfläche 'Bestätigen' lässt sich das Hinzufügen abschließen.

    Ihre Lizenz erscheint nun in der Lizenzübersicht:
    Bildschirmfoto: Lizenzverwaltung mit der Übersichtsansicht aller Lizenzen.

Zuweisen der Lizenz(en) zu dem Lizenzierungsagenten

  1. Rufen Sie die Detailansicht der hinzugefügten Lizenz auf, indem Sie den entsprechenden Link betätigen. Es öffnet sich die Karte mit den Lizenzinformationen:
    Bildschirmfoto: Lizenzverwaltung mit der Detailansicht zu einer Lizenz.

  2. Wechseln Sie In der Karte Zuordnungen per Klick auf die Stift-Schaltfläche oben rechts in den Bearbeitungsmodus:
    Screenshot der Lizenzverwaltung: Diese Ansicht zeigt die Karte 'Zuordnung', die es erlaubt, Benutzer zu einer Lizenz hinzuzufügen.

  3. Wenn Sie die Schaltfläche Benutzer zuordnen betätigen, öffnet sich das Dialogfenster Dieser Lizenz einen Benutzer zuordnen:
    Bildschirmfoto: Dialogfenster 'Dieser Lizenz einen Benutzer zuordnen' mit Eingabefeld zum Eingeben einer E-Mail-Adresse.

  4. Beginnen Sie, im Eingabefeld E-Mail den Namen des Agenten einzutippen und wählen Sie ihn dann aus der Liste aus.
  5. Klicken Sie auf Benutzer hinzufügen.
  6. Klicken Sie auf Speichern.

Lizenzierungsagent: Zuweisen der Lizenzen zu den Benutzern

  • Rufen Sie Im Browser den Lizenzierungsagenten auf: https://<hostname>:<port>/admin
  • Wählen Sie im Hauptmenü Lizenzen aus.
  • Ordnen Sie Domänen oder Domänenbenutzern die gewünschten Anwendungen aus den erworbenen Lizenzen zu. Die Karte Zuordnungen ist über das Stiftsymbol oben rechts editierbar.

TLS/SSL-Zertifikat konfigurieren

Beim Installieren des Agenten wird ein selbstsigniertes Zertifikat erstellt. Für den produktiven Betrieb empfehlen wir, ein eigenes Zertifikat zu erstellen, das von den Clients als vertrauenswürdig angesehen wird.

Hinweis: Ein selbstsigniertes Zertifikat wird von den Clients nicht automatisch als vertrauenswürdig betrachtet. Dadurch funktioniert die Kommunikation von Manager zum Agenten zunächst nicht. Wenn Sie das selbstsignierte Zertifikat verwenden wollen, dann finden Sie hier eine Anleitung, wie Sie dieses bei den Clients als vertrauenswürdig hinterlegen können.

In der Datei appsettings.json des Lizenzierungsservers kann ein eigenes Zertifikat per Windows Certificate Store oder als PBX-Datei konfiguriert werden:

Konfiguration für den Windows Certificate Store

"Kestrel": {
"EndPoints": {
"Https": {
"Url": "https://*:@@PORT@@",
"Certificate": {
        "Subject": "<subject>",   // Required; example: "ad.axes4.com"
      "Store": "My | TrustedPublisher | <etc.>", // Required
      "Location": "<CurrentUser | LocalMachine>", // Optional, defaults isLocalMachine
      "AllowInvalid": "true | false" // Optional, defaults is false
    }
  }
}
}

Konfiguration für eine PFX-Datei

"Kestrel": {
"EndPoints": {
"Https": {
"Url": "https://*:29374",
"Certificate": {
      "Path": "<path to .pfx file>",
"Password": "<certificate password>"
}
}
 }
}

Die Änderung wird wirksam, sobald der Agent-Service neu gestartet wird.

axes4-Produkte auf den Clients installieren

Unsere Produkte finden Sie hier zum Download: axesWord | axesSlide | axesPDF

Mit dem jeweiligen Setup werden alle erforderlichen Komponenten installiert. Das schließt den axes4 Lizenzmanager sowie alle erforderlichen .NET-Komponenten mit ein.

Mit unseren Setups sind auch sogenannte Silent Installations bzw. Headless Installations möglich. Weitere Infos dazu finden Sie hier.

Hinweis: Der axes4 Lizenzmanager ist kein Dienst, sondern eine Anwendung, die im Hintergrund im User-Kontext läuft. Standardmäßig wird der axes4 Lizenzmanager dementsprechend installiert und für den Autostart hinterlegt. Dies sollten Sie bei Anpassungen am Setup berücksichtigen.

Anpassung des Registry Values für den Lizenzmanager

Damit der Client den Agenten findet, müssen Sie in der Registry hinterlegen, wo der Lizenzierungsagent zu finden ist.

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\axes4\Licensing\Manager
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\axes4\Licensing\Manager
Computer\HKEY_CURRENT_USER\Software\Policies\axes4\Licensing\Manager
Computer\HKEY_CURRENT_USER\Software\axes4\Licensing\Manager
  • Erstellen Sie einen String Value mit dem Namen ActiveConnections und dem Wert agent.
  • Erstellen Sie einen String Value mit dem Namen AgentBaseUri und der Adresse des Lizenzierungsagent in Ihrem Netzwerk.

Netzwerk-Kommunikation

Firewall(s) für den Lizenzierungsagenten konfigurieren

  • Inbound (Kommunikation der Clients zum Lizenzierungsagenten): https TCP-Port 29374 (Default Port).
    Der Lizenzierungsagent empfängt keine Kommunikation, die von außerhalb Ihres Netzwerks initiiert ist. Er erhält nur Antworten auf Anfragen, die er selbst gestellt hat. Unsere Empfehlung ist es deswegen, komplett jede Art von außen initiierter Kommunikation zu blocken.
  • Outbound (Kommunikation des Lizenzierungsagenten zu den axes4-Lizenzierungsservern): TCP-Port 443.

Kommunikationswege

  • Anfragen an den axes4 Lizenzserver gehen immer vom lokalen Lizenzierungsagenten an die Adresse: https://api.axes4.com
  • Autorisierungsanfragen gehen immer an dieselbe Adresse: https://auth.axes4.com
  • Damit sich der Lizensierungsadministrator am Lizensierungsagenten anmelden kann, muss folgende URI offen sein: https://id.axes4.com
  • Die axes4 Software (Client) muss nicht zwingend eine Verbindung zum Internet aufbauen. Sämtliche Kommunikation nach außen kann über den Lizenzierungsagenten erfolgen.

Proxy für den Lizenzierungsagenten konfigurieren

In der Datei appsettings.json des Lizenzierungsservers können folgende Proxyeinstellungen konfiguriert werden:

"proxy": {
   "policy": "wininet | winhttp | noproxy | custom",
"address": "https://<host>:<port>, [nur bei custom proxy]
"credentials": {
"policy": "none | default | custom",
"username": "<username>", [nur bei custom credentials]
"password": "<password>", [nur bei custom credentials]
"domain": "<domain>" [nur bei custom credentials]
}

Die Änderung wird wirksam, sobald der Agent-Service neu gestartet wird.

Optionale Features des Lizenzierungsagenten

In der Datei appsettings.json des Lizenzierungsservers können folgende optionalen Features konfiguriert werden.

ActivatedUserMapping

Der Agent merkt sich, welche Benutzer eine gültige Produktaktivierung haben und zeigt diese im Agent an. Diese Daten werden nicht an die axes4 Server übermittelt.

"Features": {
"EnableActivatedUserMapping": true|false, // default is true
...
},

LogPII (personal identifying information)

Im lokalen Logfile des Agenten wird geloggt, wenn ein Benutzer den Agenten für eine Lizenz anfragt.

Mögliche, enthaltene Werte sind: Benutzername, Domainname, Gerätename.
Diese Informationen sind lokal auf dem Agenten und werden nicht an axes4 übermittelt.

Bei deaktiviertem Feature werden die Werte im lokalen Logfile Werte mit * ersetzt.

"Features": {
...
"EnableLogPII": true|false // default is true
},

Die Änderung wird wirksam, sobald der Agent-Service neu gestartet wird.

Log-Dateien

Das Log für den axes4 Lizenzierungsagenten finden Sie unter

C:\Windows\System32\config\systemprofile\AppData\Local\axes4\Licensing Agent

In der Datei appsettings.json des Lizenzierungsservers kann das Loglevel konfiguriert werden (ab Version 1.3):

"Logging": {
   "LogLevel": {
     "Default": "Trace | Debug | Information | Warning | Error | Critical | None",
     "Microsoft": "Trace | Debug | Information | Warning | Error | Critical | None",
     "Microsoft.Hosting.Lifetime": "Trace | Debug | Information | Warning | Error | Critical | None",
     "System.Net.Http": "Information"
   }
}

Das Log für den axes4 Lizenzmanager finden Sie unter

%appdata%\axes4\Licensing\manager.log

Das Loglevel des Lizenzmanagers kann nicht gesteuert werden.