Skip to Content

Branding & Anpassung

Der Branding-Bereich der Auris-Konsole steuert die visuelle Identität aller benutzerseitigen Komponenten, die von Auris verwaltet werden: die gehostete Login-Seite, E-Mail-Vorlagen und (optional) die Domain, von der diese bereitgestellt werden. Anpassungen werden pro Tenant angewendet, sodass jede in deinem Tenant registrierte Anwendung dasselbe Branding erbt.

Branding-Einstellungen

Die Branding-Seite in der Konsole enthält ein Live-Vorschaufenster auf der rechten Seite, das sich in Echtzeit aktualisiert, wenn du Änderungen vornimmst. So kannst du den Effekt jeder Einstellung sehen, bevor du speicherst.

Firmenname

Der Firmenname wird angezeigt in:

  • Dem Titel der gehosteten Login-Seite (Anmelden bei [Firmenname])
  • Betreffzeilen und Fußzeilen von E-Mail-Vorlagen
  • Dem Browser-Tab-Titel für gehostete Login-Seiten

Gib deinen Firmen- oder Produktnamen genau so ein, wie er den Benutzern angezeigt werden soll.

Lade ein Logo-Bild hoch, das im Header der gehosteten Login-Seite und im Header aller ausgehenden E-Mail-Vorlagen erscheint.

Unterstützte Formate: PNG, SVG, WebP, JPEG

Empfohlene Spezifikationen:

VerwendungEmpfohlene GrößeMaximale Dateigröße
Gehosteter Login-Header200 × 60 Pixel oder proportional500 KB
E-Mail-Header600 × 200 Pixel oder proportional500 KB

SVG-Dateien skalieren ohne Qualitätsverlust in jeder Größe und werden für Logos mit Text bevorzugt.

Nach dem Hochladen erscheint das Logo sofort in der Live-Vorschau. Klicke auf Logo entfernen, um zum Anzeigen des Firmennamens als Text zurückzukehren.

Primärfarbe

Die Primärfarbe wird angewendet auf:

  • Call-to-Action-Schaltflächen (Anmelden, Weiter, Absenden)
  • Link-Text auf der Login-Seite
  • Fortschrittsanzeigen und Ladezustände
  • Fokusringe auf interaktiven Elementen

Klicke auf das Farbfeld, um den Farbwähler zu öffnen. Du kannst eine Farbe visuell auswählen, einen Hex-Wert eingeben (#1a73e8) oder aus der Voreinstellungspalette wählen.

Voreinstellungspalette: Die Konsole bietet einen Satz von 12 Voreinstellungsfarben, die gängige Markenfarben repräsentieren. Das Klicken auf eine Voreinstellung füllt das Hex-Feld und aktualisiert die Vorschau.

Stelle sicher, dass deine Primärfarbe ausreichend Kontrast gegenüber einem weißen Hintergrund hat, um die WCAG 2.1 AA Barrierefreiheitsstandards zu erfüllen (Mindestkontrastverhältnis 4,5:1 für normalen Text). Die Konsole zeigt eine Kontrastwarnung an, wenn die gewählte Farbe diesen Schwellenwert nicht erreicht.

Hintergrundfarbe

Die Hintergrundfarbe wird auf den äußeren Hintergrundbereich der Login-Seite angewendet (auf großen Bildschirmen als der Bereich rund um die Login-Karte sichtbar).

Für ein professionelles Erscheinungsbild verwende eine Farbe, die deine Primärfarbe ergänzt. Gängige Optionen sind:

  • Ein sehr heller Ton der Primärfarbe (z. B. #f0f4ff für ein blaues Primär)
  • Ein neutrales Nahezu-Weiß (#f8f9fa)
  • Deine Marken-Sekundär-/Neutralfarbe

Favicon

Lade eine .ico-, .png- oder .svg-Datei als Browser-Tab-Symbol für gehostete Login-Seiten hoch. Empfohlene Größe: 32 × 32 Pixel. Das Favicon wird in Browser-Tabs, Lesezeichen und dem Browser-Verlauf angezeigt.

Transaktions-E-Mails

Auris sendet Transaktions-E-Mails für dreizehn Ereignistypen — Verifizierung, Passwort-Reset, Einladung, MFA-Code, Magic Link, Anmeldewarnung, Willkommen, Passwort geändert, Konto gesperrt, verdächtige Anmeldung, E-Mail geändert, Lizenz ausgestellt und CIBA-Anmeldebestätigung. Den vollständigen Katalog und die Variablen pro Typ findest du unter E-Mail-Vorlagen.

Tenant-Branding auf Standard-E-Mails

Solange du keine eigene Vorlage gespeichert hast, rendert Auris die integrierten Vorlagen mit deinem Tenant-Branding: deinem Firmennamen, deinem Logo (mit Rückfall auf den Namen als Text, wenn kein Logo gesetzt ist) und deiner Primärfarbe. Eine eigene Vorlage ersetzt das gesamte HTML — das Branding darin liegt vollständig in deiner Hand.

Zwei Schalter unter Konsole → Einstellungen → E-Mail steuern den Footer der Standard-E-Mails:

  • White-Label-E-Mails — entfernt den Hinweis “Powered by Altovar”; der Footer zeigt nur noch deine eigene Copyright-Zeile. White-Label-Tenants ohne eigene Primärfarbe erhalten eine neutrale Akzentfarbe statt des Plattform-Standards, damit kein Plattform-Branding in deine E-Mails gelangt.
  • Footer ausblenden — lässt den Footer-Bereich komplett weg.

Eine Vorlage bearbeiten

  1. Gehe zu Konsole → Einstellungen → E-Mail-Vorlagen
  2. Klicke auf die Vorlage, um den Editor zu öffnen, und wähle einen Modus: Theme-Editor, visueller Builder oder Code-Editor
  3. Bearbeite die Betreffzeile und den Inhalt — beide unterstützen Variablen mit {{variable}}-Syntax
  4. Klicke auf Test senden, um die aktuelle Vorlage, gerendert mit Beispieldaten, an deine eigene Admin-E-Mail-Adresse zu senden (Betreff mit Präfix [TEST])
  5. Klicke auf Speichern, um Änderungen zu übernehmen; Auf Standard zurücksetzen stellt für die aktuelle Sprache die integrierte Vorlage wieder her

Vorlagenvariablen

Variablen verwenden die {{variable}}-Syntax und werden beim Senden durch tatsächliche Werte ersetzt — zum Beispiel {{link}}, {{email}}, {{expiresIn}}. Jeder Vorlagentyp hat sein eigenes Variablen-Set, und die Datumsvariablen {{year}}, {{month}}, {{day}}, {{date}} sind immer verfügbar. Punktnotation wird nicht unterstützt. Bedingte Blöcke ({{#if variable}}...{{/if}}) behalten Inhalt nur, wenn die Variable einen Wert hat.

Entferne nicht den primären Aktionslink oder -code aus einer Vorlage ({{link}}, {{code}}, {{approveUrl}}, …). Das Entfernen macht die E-Mail funktionsunfähig.

Benutzerdefinierte Domains

Standardmäßig werden die gehosteten Auris-Login-Seiten von der Auris-Plattformdomain bereitgestellt. Benutzerdefinierte Domains ermöglichen es dir, die Authentifizierung als White-Label unter deiner eigenen Domain anzubieten — beispielsweise auth.ihredomain.de statt der Plattformvoreinstellung.

Wenn eine benutzerdefinierte Domain aktiv ist, referenzieren alle gehosteten Login-Seiten, E-Mail-Links und das OIDC-Discovery-Dokument deine benutzerdefinierte Domain. Aus Sicht des Benutzers scheint der gesamte Authentifizierungsablauf von dir betrieben zu werden.

Eine benutzerdefinierte Domain einrichten

Deine Domain hinzufügen

  1. Gehe zu Konsole → Einstellungen → Benutzerdefinierte Domains
  2. Klicke auf Domain hinzufügen
  3. Gib die vollständige Subdomain ein, die du verwenden möchtest (z. B. auth.ihredomain.de)
  4. Klicke auf Hinzufügen

DNS konfigurieren

Nach dem Hinzufügen der Domain generiert Auris DNS-Verifizierungsanweisungen. Du musst einen CNAME-Eintrag bei deinem DNS-Anbieter hinzufügen, der deine Subdomain auf die Auris-Plattform zeigt:

Typ:   CNAME
Name:  auth         (oder die von dir angegebene Subdomain ohne Root-Domain)
Wert:  [auris-plattform-hostname]
TTL:   300

Der genaue Ziel-Hostname wird in der Konsole angezeigt, nachdem du die Domain hinzugefügt hast. Die DNS-Propagation dauert typischerweise 5–30 Minuten, kann aber in manchen Fällen bis zu 48 Stunden dauern.

Domainbesitz verifizieren

Nachdem deine DNS-Einträge propagiert wurden:

  1. Kehre zu Einstellungen → Benutzerdefinierte Domains zurück
  2. Klicke auf Verifizieren neben deiner Domain
  3. Auris führt einen DNS-Lookup durch, um zu bestätigen, dass der CNAME-Eintrag vorhanden ist

Der Status ändert sich von Ausstehend zu Aktiv, sobald die Verifizierung erfolgreich ist. Die SSL/TLS-Zertifikatsprovisionierung erfolgt automatisch über Let’s Encrypt.

Als primäre Domain festlegen

Nachdem die Domain verifiziert und aktiv ist, klicke auf Als primär festlegen, um sie zur Domain zu machen, die für alle gehosteten Login-Seiten und E-Mail-Links verwendet wird.

Du kannst mehrere Domains registrieren (z. B. für verschiedene Umgebungen), aber nur eine kann gleichzeitig primär sein.

Hinweis: SSL-Zertifikate werden automatisch über Let’s Encrypt nach erfolgreicher DNS-Verifizierung provisioniert. Die Zertifikatserneuerung wird automatisch durchgeführt. Du musst keine SSL-Zertifikate hochladen oder verwalten.

Domain-Verifizierungsstatus

StatusBedeutung
AusstehendDomain hinzugefügt, aber DNS-Einträge noch nicht überprüft
VerifizierungDNS-Lookup läuft
AktivDNS verifiziert, SSL provisioniert, Domain ist bereit
FehlgeschlagenDNS-Lookup fehlgeschlagen — überprüfe deinen CNAME-Eintrag und versuche es erneut
GelöschtDomain wurde aus der Konsole entfernt

Branding auf bestimmte Anwendungen anwenden

Standardmäßig teilen alle Anwendungen in deinem Tenant dasselbe Branding. Für Multi-Produkt-Tenants, bei denen verschiedene Anwendungen unterschiedliche Branding-Anforderungen haben, kannst du das Branding auf Anwendungsebene überschreiben.

Branding auf Anwendungsebene wird auf dem Tab Einstellungen der Anwendung im Abschnitt Anwendungen der Konsole konfiguriert. Verfügbare Overrides:

  • Primärfarbe
  • Logo-URL
  • Anzeigename der Anwendung (wird auf der gehosteten Login-Seite angezeigt)

Wenn ein Benutzer zur gehosteten Login-Seite für eine bestimmte Anwendung weitergeleitet wird (über den Parameter client_id), wendet Auris die Branding-Overrides auf Anwendungsebene zusätzlich zu den Tenant-Standardwerten an.

Das Anwendungs-Branding gilt auch für E-Mails: Wird eine Standard-E-Mail (nicht angepasst) von einer bestimmten Anwendung ausgelöst — zum Beispiel ein Magic Link, der von der Login-Seite dieser Anwendung angefordert wurde — wird die E-Mail mit Name, Logo und Farbe der Anwendung statt denen des Tenants gerendert. Das Footer-Verhalten (White-Label, ausgeblendeter Footer) bleibt immer das des Tenants, dem die Anwendung gehört.

Zugehörige Anleitungen

Architektur