Lizenzserver
Der Lizenzserver ist das zentrale Lizenzsystem, bei dem sich alle brandbox-Installationen mit einem Lizenzschlüssel registrieren müssen. Lizenzen werden einmalig aktiviert und dann in regelmäßigen Abständen verifiziert.
Eine nicht valide Lizenz führt zu eingeschränkten Bearbeitungsrechten im Administrationsbereich.
...
Lizenzprojekte
Lizenzprojekte sind die Entsprechung einer lizensierten Systeminstallation. Sie bilden die Schnittmenge von Lizenz, lizensierten Apps und Vertrag.
Jedes Lizenzprojekt muss einem Kunden zugeordnet sein.
Lizenzen
Lizenzen bestehen aus einem Lizenzschlüssel und einem Kommunikationstoken und werden in der Regel automatisch erstellt.
Der Lizenzschlüssel dient technisch zum Abholen von Composer-Paketen aus dem Lizenzsystem. Er muss in der composer.json des Client-Systems hinterlegt werden:
| Codeblock |
|---|
{
"type": "composer",
"url": "https://my.brandbox.host/repository",
"options": {
"http": {
"header": [
"License-Code: HIER-STEHT-DER-LIZENZSCHLÜSSEL"
]
}
}
} |
Lizenzstatus
Informationen zur Lizenz und ihrem Status lassen sich zu jeder Zeit in der Lizenzverwaltung einsehen.
- Öffnen Sie die Administration
- Öffnen Sie die Karte "Apps" und klicken Sie auf den Eintrag " Lizenzverwaltung"
Die Tabelle im sich öffnenden Tab stellt Informationen zum Lizenzstatus dar:
...
Aktivierung der Lizenz
Die Lizenz wird einmalig bei der initialen Installation des Systems automatisch aktiviert. In Fehlerfällen kann die Aktivierung auch manuell erfolgen.
- Öffnen Sie die Administration
- Öffnen Sie die Karte "Apps" und klicken Sie auf den Eintrag " Lizenzverwaltung"
- Klicken Sie in der Toolbar auf
- Hinweis: Der Button erscheint nur bei nicht aktivierter Lizenz
Folgende Fehler können beim Aktivieren der Lizenz auftreten und werden im Ereignisprotokoll geloggt:
...
Verifizierung der Lizenz
...
LIZENZSCHLUESSEL"
]
}
}
} |
Das Mitsenden des Lizenzcodes per Request-Header wird beim Anfragen von Paketen von Composer automatisch übernommen.
Der Kommunikationstoken wird beim Aktivieren einer Lizenz im Client-System gespeichert und zur regelmäßigen Verifikation der Lizenz verwendet.
Verträge
Verträge können in beliebiger Menge Kunden und Organisationen zugeordnet werden. Lizenzprojekten wird direkt über ein dediziertes Feld ein Vertrag für den Systembetrieb zugeordnet. Dieser wird beim Aktivieren der Lizenz oder dem Anfragen von App-Paketen aus Client-Systemen validiert (s.u. Lizensierung von Apps)
Lizensierung von Apps
Fragt ein Client-System über Composer ein Paket an, wird diese Anfrage wie folgt validiert:
Der mitgesendete Lizenzschlüssel wird geprüft.
Das Lizenzprojekt, dem der Lizenzschlüssel zugeordnet ist, wird auf Aktivität geprüft (Checkbox "aktiv").
Der dem ermittelten Lizenzprojekt zugeordnete Vertrag wird auf Gültigkeit geprüft (Checkbox "aktiv" und "Vertragsbeginn"/"Vertragsende").
Es wird geprüft, ob die App über die Lizenz validiert werden muss. Fall nein, wird sie direkt ausgeliefert.
Falls ja, wird geprüft, ob die App direkt unter "Lizensierte Apps" des Lizenzprojekts zugeordnet ist. Ist dies nicht der Fall, wird für die lizensierten Apps anhand des App-Baumes des Releases ermittelt, ob die angeforderte App darüber mit abgedeckt ist.
Falls ja, wird die App ausgeliefert.
In allen anderen Fällen erscheint eine Fehlermeldung, die sowohl im Ereignisprotokoll des Lizenzsystems als auch als Log-Datensatz bei der Lizenz geloggt wird, sofern sie anhand des mitgelieferten Lizenzschlüssels einer Lizenz zugeordnet werden kann.