# Profili utente e attributi

Campi di profilo standard, attributi di profilo personalizzati e visibilità.

Il **profilo** di un utente è l'insieme dei campi che descrivono l'account. La piattaforma include un insieme fisso di campi standard e consente di estendere il profilo con **attributi personalizzati** propri, definiti una sola volta a livello centrale e assegnati alle directory che devono utilizzarli.

## Campi di profilo standard

Ogni directory mette a disposizione un insieme comune di campi standard. I più importanti sono:

| Campo | Note |
|---|---|
| **Email** | Contatto principale e, nella maggior parte delle directory, l'identificatore di accesso. Può essere verificata. |
| **Nome utente** | Identificatore secondario facoltativo. |
| **Nome completo** | Nome, cognome ed eventualmente un secondo nome. |
| **Numero di cellulare** | Numero di telefono, utilizzato per i fattori SMS; può essere verificato. È supportato un secondo numero facoltativo. |
| **Titolo**, **Reparto**, **Nome dell'azienda** | Attributi professionali. Nome dell'azienda è disattivato per impostazione predefinita e condivide l'archiviazione con il valore fornito da una sincronizzazione di directory. |
| Sede di lavoro, numero di matricola, data di assunzione | Ulteriori attributi professionali, disponibili dove la directory consente la modifica del profilo. |

Ogni directory controlla, **per singolo campo**, se è abilitato, se funge da **identificatore di accesso**, se è **obbligatorio** e se compare durante la **registrazione** (off / optional / required). Almeno un identificatore deve essere sempre attivo. La configurazione avviene sulla directory stessa: vedere [Directory utenti → Schema del profilo](https://dts-identity.com/it/docs/directories/user-directories.md).

### Quale sistema è proprietario di un campo

Se un campo di profilo sia modificabile nella console dipende dalla directory:

- **Directory locali**: i campi sono sempre modificabili qui. La piattaforma è la fonte di verità.
- **Directory enterprise sincronizzate**: la sorgente Active Directory / LDAP a monte è responsabile dei propri campi. Nella console sono in **sola lettura**, a meno che per quella directory non sia attiva la **sincronizzazione verso l'alto (write-back)**; in tal caso le modifiche apportate qui vengono riscritte verso la sorgente. Con il write-back disattivato i campi del modulo vengono mostrati ma restano disabilitati.

Tutto ciò è direttamente collegato agli interruttori abilitato / obbligatorio per singolo campo e all'impostazione di sincronizzazione verso l'alto della directory: vedere [Directory utenti → Sincronizzazione](https://dts-identity.com/it/docs/directories/user-directories.md).

Per le directory **AD/LDAP** il profilo espone gli identificatori propri della directory (**common name**, **organizational unit**, scelta da un selettore di OU, e **user principal name**) al posto della modifica libera di email e nome utente.

### Dati di profilo e dati che determinano l'accesso

Un profilo porta con sé due tipi di dati, e la differenza decide chi può modificare un campo:

- I **dati di profilo** descrivono la persona e cambiano con la sua vita, non con il suo accesso: nome visualizzato, numero di telefono, lingua preferita, sede dell'ufficio, taglia della maglietta per il kit di onboarding. Dove una directory consente il self-service, **sono gli utenti stessi a mantenere questi campi**.
- I **dati che determinano l'accesso** sono tutto ciò che un sistema legge per decidere che cosa la persona può fare: appartenenza a gruppi, ruoli, stato dell'account, centro di costo o reparto quando un'applicazione ne deriva le autorizzazioni, un numero cliente di cui un'applicazione si fida. Un campo di questo tipo non viene **mai** aperto al self-service: un valore che l'utente può modificare è un valore che l'utente può concedere a se stesso. Va mantenuto sotto controllo dell'amministrazione oppure sincronizzato dal sistema che lo possiede.

Se un attributo esce dalla piattaforma viene deciso **per singola applicazione**, nella scheda **Attributi** dell'applicazione: un'applicazione OIDC seleziona gli attributi personalizzati che riceve come claim, un'applicazione SAML o WS-Federation li mappa nelle proprie attribute statement. Definire un attributo, di per sé, non lo espone quindi mai. Tutto ciò che finisce in un token o in un'Assertion va trattato come dato operativo: emettere solo ciò che serve all'applicazione ricevente e non esporre mai in questo modo valori interni o sensibili.

## Attributi di profilo personalizzati

> **Nota:** gli attributi di profilo personalizzati fanno parte della funzionalità **profile metadata**, disponibile dal livello Advanced in su (e durante il Trial).

Quando i campi standard non bastano, si definisce un **attributo personalizzato**. Gli attributi personalizzati vengono creati una sola volta in un catalogo centrale e poi **assegnati a ciascuna directory** che deve raccoglierli. Questo modello in due passaggi mantiene coerente un'unica definizione tra le directory, lasciando al tempo stesso che ogni directory decida se il campo è obbligatorio e se compare in fase di registrazione.

### Definire un attributo personalizzato

Gli attributi personalizzati si gestiscono nell'area delle directory, nella pagina **Attributi**.

1. Aprire **Attributi** e scegliere di aggiungere un nuovo attributo.
2. Assegnare un **nome** (l'identificatore stabile) e un'**etichetta** (ciò che vedono utenti e amministratori). I nomi dei campi di profilo standard e i nomi dei claim utilizzati nei token rilasciati (ad esempio `email`, `title`, `mobile`, `groups` o `sub`) sono **riservati**, indipendentemente da maiuscole e minuscole: un attributo personalizzato con un nome simile sembrerebbe il campo standard ma conterrebbe dati distinti, quindi la creazione viene rifiutata. Scegliere invece un nome distinto, ad esempio `jobRole` anziché `title`.
3. Scegliere un **tipo**:

   | Tipo | Da usare per |
   |---|---|
   | **Text** | Testo breve in formato libero. |
   | **Number** | Valori numerici. |
   | **Date** | Date di calendario. |
   | **Select** / **Choice** | Un elenco fisso di opzioni definite dall'amministratore (valore ed etichetta). |
   | **Password** | Un valore segreto. |

4. Facoltativamente, configurare:
   - **Descrizione**: testo libero mostrato come suggerimento sotto il campo, in fase di registrazione e nel profilo, esattamente come è stato inserito (non tradotto).
   - **Multiple values**: consente al campo di contenere un elenco.
   - **Valore predefinito**.
   - **Uniqueness**: per impostazione predefinita il valore di un attributo deve essere univoco tra gli account (due utenti non possono condividerlo, ad esempio un numero di matricola). Attivare **Consenti duplicati** per rimuovere questo vincolo e permettere a più account di avere lo stesso valore.
   - **Maintained via API only**: il valore viene visualizzato ma non è modificabile manualmente, né nel profilo dell'utente né nella Admin Console; solo l'API di management (un'integrazione o una sincronizzazione) lo scrive. Un attributo di questo tipo non viene inoltre mai raccolto in fase di registrazione.
5. Impostare la **visibilità** (vedere sotto) e salvare.

Ogni attributo personalizzato può essere usato come filtro tramite l'API di management; l'indice che supporta queste query viene mantenuto automaticamente.

### Partire da un modello

I modelli coprono attributi di cui la maggior parte dei tenant ha comunque bisogno, come dimensione aziendale, centro di costo, tipo di rapporto di lavoro o data di assunzione. Selezionandone uno in **Attribute template**, nome, tipo e opzioni vengono precompilati, insieme a un'etichetta. Nulla resta collegato al modello: ogni valore è modificabile e il risultato si comporta esattamente come un attributo definito da zero.

I modelli sono anche tradotti. Un'etichetta presa da un modello viene mostrata a ciascun utente nella propria lingua, quindi un utente tedesco legge "Unternehmensgröße" dove un utente inglese legge "Company size". Dopo la selezione di un modello, il campo **Etichetta** mostra il testo di riferimento in inglese, perché è da quel testo che viene ricercata la traduzione. Lasciarlo invariato per mantenere le traduzioni.

Un'etichetta inserita manualmente viene mostrata a tutti esattamente come è stata digitata, in ogni lingua. Lo stesso vale per un'etichetta di modello modificata successivamente: conviene quindi cambiarla solo se si preferisce la propria formulazione alle traduzioni. Le etichette delle opzioni di un attributo di tipo select seguono la stessa regola.

### Visibilità

La visibilità determina dove l'attributo viene mostrato e chi può modificarlo:

| Visibilità | Comportamento |
|---|---|
| **Nascosto** | Non viene mostrato nel profilo né nella Admin Console. Viene impostato tramite l'API oppure raccolto una sola volta in fase di registrazione, dove una directory lo richiede. |
| **Solo amministratori** | Visibile e modificabile nella Admin Console, non per l'utente finale. |
| **Profilo + Admin** | Viene mostrato anche all'utente nel suo profilo, dove può modificarlo autonomamente. |

> **Nota:** una volta che un attributo è **assegnato a una qualsiasi directory**, la sua visibilità viene **bloccata** e l'attributo non può essere eliminato finché non viene rimosso ovunque. Questo protegge i record utente esistenti e la resa della registrazione e del profilo da disallineamenti rispetto alla definizione.

### Assegnare a una directory

Qualsiasi attributo personalizzato può essere assegnato a una directory, il che lo rende disponibile sugli utenti di quella directory. Il punto in cui il valore viene impostato dipende dalla visibilità:

- un attributo **Profilo + Admin** compare nel profilo dell'utente e, dove è abilitato, in fase di registrazione; l'utente può compilarlo;
- un attributo **Solo amministratori** compare su quegli utenti nella Admin Console, dove viene impostato dall'amministratore; non viene mostrato all'utente;
- un attributo **Nascosto** viene impostato tramite l'API e non viene mostrato né nel profilo né nella Admin Console. Da usare per un valore consumato da un'applicazione (ad esempio un attributo SAML) e mantenuto da un'integrazione anziché da una persona.

Nella configurazione degli attributi della directory si sceglie, per ciascun attributo, se compare in fase di **registrazione** (lì facoltativo od obbligatorio) e se è **obbligatorio** nel profilo. La raccolta in fase di registrazione è indipendente dalla visibilità: un attributo **Solo amministratori** o **Nascosto** richiesto in fase di registrazione viene compilato una sola volta da chi si registra e successivamente è leggibile solo dove la sua visibilità lo consente. Utile per dati necessari al momento della registrazione ma che l'utente non deve rivedere, come un codice di segnalazione o un centro di costo. Un attributo con **Maintained via API only** non può essere raccolto in fase di registrazione, poiché chi si registra non potrebbe mai compilarne il campo. L'impostazione **obbligatorio** si applica dove l'attributo viene mostrato per la modifica.

Anche la definizione stessa è modificabile da questa scheda: **Aggiungi attributo → Create new attribute** crea un nuovo attributo e lo assegna subito alla directory, mentre **Edit attribute** nel menu delle azioni di una riga apre la finestra di definizione (etichetta, tipo, opzioni, impostazioni). **Configura** resta il punto in cui si trovano le impostazioni di raccolta per directory descritte sopra.

L'ordine dell'elenco è l'ordine di visualizzazione: la registrazione, il profilo dell'utente e la pagina di dettaglio dell'utente mostrano gli attributi esattamente come sono disposti qui. Trascinare la maniglia a destra di una riga per riordinarli.

## Vedere anche

- [Persone](https://dts-identity.com/it/docs/directories/people.md): dove si modificano i campi di profilo di un utente.
- [Directory utenti](https://dts-identity.com/it/docs/directories/user-directories.md): configurazione dei campi e impostazioni di registrazione per singola directory.
- [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md): disponibilità delle funzionalità per livello.
