Skip to Content

Branding & Personalizzazione

La sezione Branding della Console Auris controlla l’identità visiva di tutti i componenti rivolti agli utenti gestiti da Auris: la pagina di login hosted, le email transazionali e (opzionalmente) il dominio da cui sono serviti. La personalizzazione si applica per tenant, quindi ogni applicazione registrata nel tuo tenant eredita lo stesso branding.

Impostazioni Branding

La pagina Branding in Console include un pannello di anteprima live sul lato destro che si aggiorna in tempo reale mentre fai modifiche. Così vedi l’effetto di ogni impostazione prima di salvare.

Nome Azienda

Il nome azienda viene mostrato in:

  • Il titolo della pagina di login hosted (Accedi a [Nome Azienda])
  • Gli oggetti e i footer delle email transazionali
  • Il titolo della scheda del browser per le pagine di login hosted

Inserisci il nome della tua azienda o del tuo prodotto esattamente come vuoi che appaia agli utenti.

Carica un’immagine logo che appare nell’header della pagina di login hosted e nell’header delle email in uscita.

Formati supportati: PNG, SVG, WebP, JPEG

Specifiche consigliate:

UsoDimensione consigliataDimensione massima file
Header login hosted200 × 60 pixel o proporzionale500 KB
Header email600 × 200 pixel o proporzionale500 KB

I file SVG scalano senza perdita di qualità a qualsiasi dimensione e sono preferibili per i loghi con testo.

Dopo il caricamento, il logo appare subito nell’anteprima live. Clicca Rimuovi logo per tornare a mostrare il nome azienda come testo.

Colore Primario

Il colore primario viene applicato a:

  • Pulsanti di call-to-action (Accedi, Continua, Invia)
  • Testo dei link nella pagina di login
  • Indicatori di avanzamento e stati di caricamento
  • Anelli di focus sugli elementi interattivi

Clicca sul campione di colore per aprire il color picker. Puoi selezionare un colore visivamente, inserire un valore esadecimale (#1a73e8) o scegliere dalla palette di preset.

Palette di preset: la Console offre un set di 12 colori predefiniti che rappresentano colori brand comuni. Cliccando un preset il campo esadecimale si compila e l’anteprima si aggiorna.

Assicurati che il tuo colore primario abbia un contrasto sufficiente rispetto a uno sfondo bianco per soddisfare gli standard di accessibilità WCAG 2.1 AA (rapporto di contrasto minimo 4.5:1 per il testo normale). La Console mostra un avviso di contrasto se il colore selezionato non raggiunge questa soglia.

Colore di Sfondo

Il colore di sfondo viene applicato all’area esterna della pagina di login (visibile sugli schermi grandi come l’area attorno alla card di login).

Per un aspetto professionale, usa un colore che si abbini al tuo colore primario. Scelte comuni:

  • Una tinta molto chiara del colore primario (per esempio #f0f4ff per un primario blu)
  • Un quasi-bianco neutro (#f8f9fa)
  • Il colore secondario/neutro del tuo brand

Favicon

Carica un file .ico, .png o .svg da usare come icona della scheda del browser per le pagine di login hosted. Dimensione consigliata: 32 × 32 pixel. La favicon appare nelle schede, nei preferiti e nella cronologia del browser.

Email Transazionali

Auris invia email transazionali per tredici tipi di evento — verifica, reset password, invito, codice MFA, magic link, avviso di accesso, benvenuto, password cambiata, account bloccato, accesso sospetto, email cambiata, licenza emessa e approvazione accesso CIBA. Vedi Template Email per il catalogo completo e le variabili per tipo.

Branding del Tenant sulle Email Predefinite

Finché non salvi un template personalizzato, Auris renderizza i template integrati con il branding del tuo tenant: il nome azienda, il tuo logo (con fallback al nome come testo quando non c’è un logo) e il tuo colore primario. Un template personalizzato sostituisce l’intero HTML, quindi il branding al suo interno è completamente sotto il tuo controllo.

Due interruttori in Console → Impostazioni → Email controllano il footer delle email predefinite:

  • Email white-label — rimuove l’attribuzione “Powered by Altovar”; il footer mostra solo la tua riga di copyright. I tenant white-label senza un colore primario personalizzato ottengono un colore d’accento neutro al posto del default della piattaforma, così nessun branding della piattaforma trapela nelle tue email.
  • Nascondi footer — omette del tutto la fascia del footer.

Modificare un Template

  1. Vai in Console → Impostazioni → Template Email
  2. Clicca sul template per aprire l’editor e scegli una modalità: editor tema, builder visuale o editor codice
  3. Modifica l’Oggetto e il corpo — entrambi supportano le variabili con sintassi {{variabile}}
  4. Clicca Invia test per inviare il template corrente, renderizzato con dati di esempio, al tuo indirizzo email di amministratore (oggetto prefissato [TEST])
  5. Clicca Salva per applicare le modifiche; Ripristina default riporta la lingua corrente al template integrato

Variabili dei Template

Le variabili usano la sintassi {{variabile}} e vengono sostituite all’invio con i valori reali — per esempio {{link}}, {{email}}, {{expiresIn}}. Ogni tipo di template ha il suo set di variabili, e le variabili di data {{year}}, {{month}}, {{day}}, {{date}} sono sempre disponibili. La dot notation non è supportata. I blocchi condizionali ({{#if variabile}}...{{/if}}) mantengono il contenuto solo quando la variabile ha un valore.

Non rimuovere il link o il codice d’azione primario da nessun template ({{link}}, {{code}}, {{approveUrl}}, …). Rimuoverlo rende l’email inutilizzabile.

Domini Personalizzati

Di default le pagine di login hosted di Auris sono servite dal dominio della piattaforma Auris. I domini personalizzati ti permettono di offrire l’autenticazione in white-label sotto il tuo dominio — per esempio auth.tuodominio.com invece del default della piattaforma.

Quando un dominio personalizzato è attivo, tutte le pagine di login hosted, i link nelle email e il documento OIDC Discovery fanno riferimento al tuo dominio. Dal punto di vista dell’utente, l’intero flusso di autenticazione sembra gestito da te.

Configurare un Dominio Personalizzato

Aggiungi il tuo dominio

  1. Vai in Console → Impostazioni → Domini Personalizzati
  2. Clicca Aggiungi dominio
  3. Inserisci il sottodominio completo che vuoi usare (per esempio auth.tuodominio.com)
  4. Clicca Aggiungi

Configura il DNS

Dopo aver aggiunto il dominio, Auris genera le istruzioni di verifica DNS. Devi aggiungere un record CNAME presso il tuo provider DNS che punta il tuo sottodominio alla piattaforma Auris:

Tipo:   CNAME
Nome:   auth         (o il sottodominio specificato, senza il dominio root)
Valore: [hostname-piattaforma-auris]
TTL:    300

L’hostname di destinazione esatto viene mostrato in Console dopo aver aggiunto il dominio. La propagazione DNS richiede in genere 5–30 minuti ma in alcuni casi può arrivare a 48 ore.

Verifica la proprietà del dominio

Una volta propagati i record DNS:

  1. Torna in Impostazioni → Domini Personalizzati
  2. Clicca Verifica accanto al tuo dominio
  3. Auris esegue un lookup DNS per confermare che il record CNAME sia presente

Lo stato passa da In attesa ad Attivo quando la verifica riesce. Il provisioning del certificato SSL/TLS avviene automaticamente tramite Let’s Encrypt.

Imposta come dominio primario

Dopo che il dominio è verificato e attivo, clicca Imposta come primario per renderlo il dominio usato per tutte le pagine di login hosted e i link nelle email.

Puoi registrare più domini (per esempio per ambienti diversi) ma solo uno alla volta può essere primario.

Nota: i certificati SSL vengono emessi automaticamente via Let’s Encrypt dopo la verifica DNS. Il rinnovo è automatico. Non devi caricare o gestire certificati SSL.

Stati di Verifica del Dominio

StatoSignificato
In attesaDominio aggiunto ma record DNS non ancora controllati
In verificaLookup DNS in corso
AttivoDNS verificato, SSL emesso, dominio pronto
FallitoLookup DNS fallito — controlla il record CNAME e riprova
EliminatoDominio rimosso dalla Console

Applicare il Branding a Specifiche Applicazioni

Di default tutte le applicazioni del tuo tenant condividono lo stesso branding. Per i tenant multi-prodotto in cui applicazioni diverse hanno esigenze di branding diverse, puoi sovrascrivere il branding a livello di applicazione.

Il branding a livello di applicazione si configura nella scheda Impostazioni dell’applicazione, nella sezione Applicazioni della Console. Override disponibili:

  • Colore primario
  • URL del logo
  • Nome visualizzato dell’applicazione (mostrato nella pagina di login hosted)

Quando un utente viene reindirizzato alla pagina di login hosted di una specifica applicazione (tramite il parametro client_id), Auris applica gli override di branding dell’applicazione sopra i default del tenant.

Il branding dell’applicazione si estende anche alle email: quando un’email predefinita (non personalizzata) viene attivata da una specifica applicazione — per esempio un magic link richiesto dalla pagina di login di quell’app — l’email viene renderizzata con nome, logo e colore dell’applicazione invece che del tenant. Il chrome del footer (white-label, footer nascosto) resta sempre quello del tenant proprietario dell’applicazione.

Guide Correlate

Architettura