# White Label
Mit Enginsight haben Sie vielfältige Möglichkeiten, Ihre [On-Premises-Installation](#on-premises) an Ihre Corporate Identity anzupassen und ein white labeling durchzuführen. Bauen Sie zum Beispiel Ihr eigenes Logo ein oder passen Sie die Akzentfarbe an.
Auch auf unserer [SaaS-Plattform](#saas) stehen Ihnen Optionen zur Personalisierung zu Verfügung. Sie können die PDF-Berichte und die Plattform mit Ihrem Logo versehen.
## On-Premises
{% hint style="warning" %}
Wenn Sie auf dem Applikationsserver eine **Konfigurationsdatei anpassen**, muss im nachhinein immer die **`setup.sh` ausgeführt** werden. Erst dann werden die Einstellungen wirksam.
{% endhint %}
1\. Laden Sie unter Einstellungen → Organisation → Corporate Design Ihr eigenes Logo hoch.
{% hint style="info" %}
Das Logo, welches Sie innerhalb der Plattform hochladen wird für Ihre Berichte verwendet und auf dem Dashboard angezeigt. Außerdem wird das Logo oben links eingeblendet, sofern Sie kein Logo in der Konfigurationsdatei des UI-Moduls mit `logoIcon` hinterlegt haben.
{% endhint %}
2\. Hinterlegen Sie unter Einstellungen → Support die Kontaktdaten Ihres Supports.
3\. Loggen Sie sich auf dem Applikationsserver mit Root-Rechten ein (SSH oder Konsole).
```
su
```
4\. Öffnen Sie die Konfigurationsdatei des UI-Moduls mit `nano`.
```
sudo nano /opt/enginsight/enterprise/conf/ui-m1/environment.js
```
5\. Um die Enginsight Plattform gemäß Ihres Corporate Design anzupassen, fügen Sie den Abschnitt `corporateIdentity` hinzu.
```
corporateIdentity: {
colors: {
primaryH: '',
primaryS: '',
primaryL: ''
},
tabTitle: '',
favicon: '',
company: '',
companySlug: '',
about: '',
website: '',
logo: '',
logoIcon: '',
offlineBackgroundImage: '',
offlineBackgroundImageWithoutText: false
},
```
{% hint style="warning" %}
Achten Sie darauf, dass die Akzentfarbe **nicht zu hell ist und weiße Schrift auf ihr gut lesbar** dargestellt wird.\
Um eine HEX Farbcode in das HSL Modell umzuwandeln, finden Sie zahlreiche Konvertierter im Internet.
{% endhint %}
| Attributname | Format | Beschreibung |
| ----------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `colors` | HSL | Vergeben Sie die Akzentfarbe für die Enginsight Plattform im HSL-Farbmodell. |
| `tabTitle` | | Legen Sie den Titel fest, der im Tab des Browsers angezeigt werden soll. |
| `favicon` |
.ico
.png
| Passen Sie das Favicon an, dass im Tab des Browsers neben dem Seitentitel angegeben werden soll. Verwenden Sie einen direkten und vollständigen Pfad (nicht intern): z.B. `https://company.com/favicon.ico`. |
| `company` | | Geben Sie den Namen Ihrer Organisation an. |
| `companySlug` | | Geben Sie den Kurznamen Ihrer Organisation an. |
| `about` | | Geben Sie einen Beschreibungstext Ihrer Organisation an. |
| `website` | | Geben Sie die Webseite Ihrer Organisation an. |
| `logo` | .svg |
Hinterlegen Sie Ihr gesamtes Logo (z.B. Wort- und Bildmarke). Dazu fügen Sie das Logo als .svg-Datei direkt in die Konfigurationsdatei ein.
Das logo wird bspw. auf der Login-Seite angezeigt.
|
| `logoIcon` | .svg |
Hinterlegen Sie ein (annähernd) quadratisches Logo (z.B. nur Bildmarke). Dazu fügen Sie das Logo als .svg-Datei direkt in die Konfigurationsdatei ein.
Das logoIcon wird innerhalb der Plattform oben links angezeigt.
|
| `offlineBackgroundImage` |
.jpeg
.png
| Definieren Sie optional ein Hintergrundbild für die Login-Seite. Verwenden Sie einen direkten und vollständigen Pfad (nicht intern): z.B. `https://webseite.com/imges/background.png`. |
| `offlineBackgroundImageWithoutText` | |
Vergeben Sie entweder den Wert true oder false.
false: Logo, Name, Beschreibung und Webseite der Organisation sind vor dem Hintergrundbild platziert.
true: Logo, Name, Beschreibung und Webseite der Organisation werden nicht angezeigt. Stattdessen ist das Logo oberhalb der Loginmaske platziert.
|
### Beispiele für Coporate Identity
#### Beispiel: Login ohne Hintergrundbild
```
corporateIdentity: {
colors: {
primaryH: '208',
primaryS: '66%',
primaryL: '60%'
},
tabTitle: 'Company Security',
favicon: 'https://company.com/favicon.ico',
company: 'Company GmbH',
companySlug: 'Company',
about: 'Best Security Monitoring of the world',
website: 'www.company.com',
logo: '',
logoIcon: '',
offlineBackgroundImage: '',
offlineBackgroundImageWithoutText: false
},
```
#### Beispiel: Login mit Hintergrundbild und `offlineBackgroundImageWithoutText: true`
```
corporateIdentity: {
colors: {
primaryH: '208',
primaryS: '66%',
primaryL: '60%'
},
tabTitle: 'Company Security',
favicon: 'https://company.com/favicon.ico',
company: 'Company GmbH',
companySlug: 'Company',
about: 'Best Security Monitoring of the world',
website: 'www.company.com',
logo: '',
logoIcon: '',
offlineBackgroundImage: 'https://company.com/images/background.png',
offlineBackgroundImageWithoutText: true
},
```
#### Beispiel: Corporate Identity innerhalb der Enginsight-Plattform
### Links zu AGB, Datenschutzerklärung, Impressum und Auftragsverarbeitungsvertrag
6\. Erstellen Sie Links zu AGB, Datenschutzerklärung, Impressum und Auftragsverarbeitungsvertrag. Fügen Sie dazu den Abschnitt `legal` hinzu.
```
legal: {
dataProcessingAgreement: "https://...",
privacyPolicy: "https://...",
imprint: "https://...",
terms: "https://..."
},
```
Um einen oder mehrere Links auszublenden, setzen Sie den Wert einfach auf `null`, zum Beispiel:
```
legal: {
dataProcessingAgreement: null,
privacyPolicy: null,
imprint: "https://...",
terms: "https://..."
},
```
{% hint style="info" %}
Wenn Sie den Wert leer lassen, z.B. `terms: ""` oder Sie den Abschnitt `legal` nicht hinzufügen, wird weiterhin der entsprechende Link zu Enginsight angezeigt.
{% endhint %}
### Beispiel: Gesamte Konfigurationsdatei
Ihre Konfigurationsdatei sieht jetzt in etwa folgendermaßen aus:
```
module.exports = function (environment) {
var ENV = {
hinting: true,
modulePrefix: 'ngs-ui-m1',
environment: environment,
rootURL: '/',
locationType: 'auto',
corporateIdentity: {
colors: {
primaryH: '208',
primaryS: '66%',
primaryL: '60%'
},
tabTitle: 'Company Security',
favicon: 'https://company.com/favicon.ico',
company: 'Company GmbH',
companySlug: 'Company',
about: 'Best Security Monitoring of the world',
website: 'www.company.com',
logo: '',
logoIcon: '',
offlineBackgroundImage: 'https://company.com/images/background.png',
offlineBackgroundImageWithoutText: true
},
legal: {
dataProcessingAgreement: "https://company.com/data",
privacyPolicy: "https://company.com/privacy",
imprint: "https://company.com/imprint",
terms: "https://company.com/terms"
}
};
ENV.apiDomain = '%%API_URL%%';
ENV.onpremise = {
version: 1
};
return ENV;
};
```
7\. Speichern Sie Ihre Änderungen ab (Strg+O) und schließen Sie `nano` (Strg+X).
8\. Navigieren Sie in `/opt/enginsight/enterprise`
```
cd /opt/enginsight/enterprise
```
9\. Updaten Sie Ihre Installation, damit die Änderungen wirksam werden.
```
sudo ./setup.sh
```
## SaaS
1\. Laden Sie unter Einstellungen → Organisation → Corporate Design Ihr eigenes Logo hoch.
{% hint style="info" %}
Die besten Ergebnisse erhalten Sie mit einer .svg-Datei in einem annährend quadratischen Seitenverhältnis.
{% endhint %}
Ihr Firmenlogo wird nun automatisch auf allen PDF Berichten \*\*\*\* und in der Plattform oben links erscheinen\*\*.\*\*
Um Ihr Firmenlogo Ihrer Kunden innerhalb des Kundenaccounts (sofern dieser angelegt ist) hochzuladen, gehen Sie in der Kundenorganisation auf Einstellungen → Organisation.\
\
Somit erhält Ihr Kunde seine PDF-Reports mit seinem eigenen Logo.
2\. Tragen Sie Ihre Kontaktdaten ein, unter denen Ihre Kunden Sie bei Problemen erreichen können. Die Supportdaten können Sie unter Einstellungen -> Support ändern.
Ihr Kunde sieht diese Supportdaten dann in der verknüpften Kundenorganisation, wenn er auf das Headset im Top Menü rechts klickt.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.enginsight.com/docs/on-premises/konfiguration/white-label.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.