# Utenti

La pagina Utenti offre agli amministratori una panoramica di tutti gli utenti registrati nell'organizzazione. Da qui è possibile consultare i dettagli degli utenti e aggiornare le informazioni del loro profilo.

Per accedervi, andare su **Impostazioni** → **Utenti** → **Utenti**, nella sezione Impostazioni dell'organizzazione della barra laterale.

## Aggiunta di utenti

Gli utenti possono essere aggiunti singolarmente oppure in blocco importando un file CSV.

### Aggiungere un singolo utente

1. Fare clic su **Aggiungi nuovo utente** sopra l'elenco degli utenti.
2. Compilare i dettagli dell'utente nel modulo.
3. Salvare per creare l'utente.


### Importare utenti da CSV

Gli amministratori possono aggiungere più utenti contemporaneamente caricando un file CSV, anziché creare ogni utente singolarmente.

1. Fare clic su **Importa utenti da CSV** sopra l'elenco degli utenti.
2. Se necessario, scaricare il modello CSV: viene generato dinamicamente in base ai campi utente configurati per l'organizzazione, quindi corrisponde sempre al formato previsto.
3. Compilare il modello con gli utenti da aggiungere e caricare il file.
4. La piattaforma convalida ogni riga e ogni campo. Se vengono rilevati errori, vengono restituiti messaggi precisi a livello di riga e di campo, così da poter individuare e correggere i problemi prima dell'importazione.
5. Una volta completata l'importazione, i risultati vengono comunicati immediatamente e l'elenco degli utenti si aggiorna automaticamente mostrando gli utenti appena aggiunti.


#### Formati dei campi CSV

Alcuni campi del modello CSV devono rispettare un formato specifico:

| Campo | Formato previsto |
|  --- | --- |
| **timeZone** | Formato IANA (ad es. `Europe/Rome`) |
| **dateTimeFormat** | Uno tra: `dd/MM/yyyy | HH:mm`, `dd/MM/yy | HH:mm`, `dd-MMM-yy | HH:mm`, `dd-MMM-yyyy | HH:mm`, `dd MMMM yyyy | HH:mm`, `yyyy-MM-dd | HH:mm`, `yyyy-MMM-dd | HH:mm`, `yyyy MMMM dd | HH:mm`, `MMM d, yyyy | HH:mm`, `MMM-dd-yyyy | HH:mm`, `MMMM d, yyyy | HH:mm`, `MM/d/yyyy | HH:mm`, `dd.MM.yyyy | HH:mm`, `dd. MMMM yyyy | HH:mm`, `dd.MM.yy | HH:mm` |
| **languageCountry** | Codice lingua BCP 47 (ad es. `en-US`) |
| **phoneNumber** | Deve includere il prefisso internazionale (ad es. `+39...`) |


## Come visualizzare i dettagli di un utente

1. Individuare l'utente nell'elenco (utilizzare il campo **Cerca utenti** per filtrare per nome o e-mail).
2. Fare clic su **Dettagli** nella riga dell'utente.
3. La pagina Dettagli utente mostra le informazioni seguenti:
  - **Nome** e **Cognome**
  - **Email**
  - **Numero di telefono**
  - **Lingua interfaccia** — la lingua dell'interfaccia configurata dall'utente
  - **Fuso orario**
  - **Formato data e ora**
  - **Nazione**
  - **Ruoli**


## Come modificare le informazioni di un utente

1. Aprire la pagina di dettaglio dell'utente facendo clic su **Dettagli**.
2. Fare clic su **Modifica** (icona a forma di matita) nella parte superiore del modulo.
3. Aggiornare i campi pertinenti.
  1. È possibile modificare anche i ruoli. Rimuovere ruoli da un utente oppure aggiungerne per concedere ulteriori autorizzazioni.
4. Salvare le modifiche.


## Ricerca di utenti

Utilizzare il campo **Cerca utenti** (in alto a destra dell'elenco) per filtrare gli utenti per nome o e-mail. I risultati si aggiornano durante la digitazione.

## Eliminazione di utenti

Facendo clic sull'icona del cestino è possibile eliminare utenti dall'organizzazione. Questa azione è permanente e non può essere annullata.

## Colonne dell'elenco utenti

| Colonna | Descrizione |
|  --- | --- |
| **Nome** | Il nome dell'utente |
| **Cognome** | Il cognome dell'utente |
| **Email** | L'indirizzo e-mail dell'utente, utilizzato per l'accesso e le notifiche |
| **Numero di telefono** | Il numero di telefono dell'utente, utilizzato per l'autenticazione SMS-OTP |
| **Abilitato** | Selezionato se l'utente è abilitato |


### Colonna Abilitato

L'elenco Utenti nelle impostazioni dell'organizzazione mostra una colonna Abilitato per ogni utente. Indica se l'account dell'utente è attualmente attivo (abilitato) o bloccato (disabilitato).

| Valore | Significato |
|  --- | --- |
| Abilitato | L'account è attivo. L'utente può accedere e utilizzare il sistema. |
| Disabilitato | L'account è bloccato. L'utente non può accedere. |


La colonna è solo informativa. Non è possibile abilitare o disabilitare un utente dall'elenco Utenti.

Attualmente, un utente può essere abilitato o disabilitato solo tramite il portale di amministrazione Namirial, accessibile esclusivamente al personale Namirial autorizzato.

## Dettagli utente

## Account di servizio

La scheda **Account di servizio**, accanto a **Utenti**, consente alle organizzazioni di generare, rinnovare e revocare le credenziali di accesso alle API per le proprie integrazioni direttamente dall'interfaccia NSE, senza necessità di configurazioni nel Back Office.

Un account di servizio è un account utilizzato per autenticare integrazioni e processi automatizzati verso l'Integration API. A differenza di un utente normale, un account di servizio non accede tramite il flusso di login standard: si autentica utilizzando un **ID client** e le credenziali generate al momento della creazione dell'account.

L'elenco **Account di servizio** mostra tutti gli account di servizio configurati per l'organizzazione:

| Colonna | Descrizione |
|  --- | --- |
| **ID client** | L'identificativo univoco utilizzato dall'account di servizio per autenticarsi verso l'API |
| **Email** | L'indirizzo e-mail associato all'account di servizio |
| **Abilitato** | Indica se questo specifico account di servizio è abilitato o disabilitato |
| **Azioni** | Azioni contestuali disponibili per l'account di servizio (menu ⋯) |


Se non è ancora stato creato alcun account di servizio, l'elenco mostra **Nessun account di servizio presente.**

### Creazione di un account di servizio

1. Dalla scheda **Account di servizio**, fare clic su **Nuovo account di servizio**.
2. Nella finestra di dialogo **Crea account di servizio**, inserire:
  - **Nome** (obbligatorio) — un nome interno e descrittivo per l'account di servizio (ad es. `my-service-account`).
  - **Email** (obbligatorio) — un indirizzo e-mail associato all'account di servizio (ad es. `service@example.com`).
3. Fare clic su **Crea** per generare l'account di servizio oppure su **Annulla** per annullare.


Una volta creato, l'account di servizio compare nell'elenco con l'**ID client** generato, pronto per essere utilizzato per autenticare le chiamate API.

### Ricerca di account di servizio

Utilizzare il campo **Cerca** (in alto a destra dell'elenco) per individuare rapidamente un account di servizio per nome, ID client o e-mail.

### Gestione degli account di servizio

Nell'ultima colonna **Azioni** è possibile ruotare il segreto e disabilitare l'accesso quando un account di servizio non è più necessario. Facendo clic su **Ruota segreto** viene visualizzata una finestra di dialogo che avvisa che il segreto attuale dell'ID client smetterà di funzionare immediatamente. Ciò significa che ogni integrazione che lo utilizza deve essere aggiornata con il nuovo segreto. Dopo aver confermato la finestra di dialogo, viene visualizzato il nuovo segreto.

> **Nota:** la rotazione del segreto o la disabilitazione di un account di servizio invalida immediatamente le relative credenziali. Qualsiasi integrazione che le utilizzi ancora non potrà più autenticarsi verso l'API.