# Stato Dispositivo

# Panoramica dispositivo

 Apri un dispositivo da **Dashboard** → **Dispositivi** facendo clic sulla riga del dispositivo. Il titolo della pagina mostra il **Modello** del dispositivo (quando disponibile) e l'**ID** interno.

## Dati storici rispetto all'iscrizione attuale

 Quando un dispositivo ha più iscrizioni, Cerberus Enterprise può mostrare un registro storico di sola lettura. In quel caso, la pagina visualizza un banner **Dati storici** e un pulsante per tornare ai dati dell'iscrizione attuale.

## Campi superiori

 La sezione superiore riassume l'identità del dispositivo, l'assegnazione e lo stato di gestione. Alcuni campi sono specifici per la piattaforma e compaiono solo per i dispositivi Android o Apple.

- **ID** e **Modello**: identificatori di sola lettura.
- **Utente**: mostra l'utente attualmente assegnato (se presente). Dal menu utente è possibile **Aprire utente** o **Cambiare utente**, oppure assegnare un utente quando nessuno è impostato.
- **Modalità di gestione** e **Proprietà**: visualizzati con tooltip nell'interfaccia utente.
- **Stato**: stato attuale del dispositivo (con icona e dettagli tramite tooltip).
- **Profilo ADE** (solo Apple): mostra il profilo di iscrizione automatizzata dei dispositivi assegnato (se presente) e consente di aprirlo o modificarlo.
- **Policy**: mostra la policy assegnata e consente di aprirla o modificarla, oppure di assegnarne una quando nessuna è impostata.
- **Stato conformità policy** (quando è assegnata una policy): indica se il dispositivo è conforme.
- **Versione policy** (quando è assegnata una policy): indica se sul dispositivo è stata applicata l'ultima versione della policy.
- **Iscritto il** e **Ultimo rapporto di stato**: timestamp dell'iscrizione e dell'ultimo stato riportato.
- **Rimosso il**: mostrato quando il dispositivo è stato rimosso.

<p class="callout info"> Alcuni dati e pannelli sono disponibili solo quando la categoria corrispondente è abilitata nella policy del dispositivo. Per ulteriori informazioni, consulta le pagine [**Segnalazione dello stato**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/reporting-dello-stato "Status reporting") e [**Posizione e geofence**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/posizione-e-geofencing "Location and geofence"). </p>

## Pannelli

 L'editor del dispositivo è organizzato in sezioni espandibili. A seconda della piattaforma e dello stato, potresti visualizzare uno o più dei seguenti pannelli:

- **Mappa posizione**: un pannello a schede con la cronologia della **Posizione** per il dispositivo corrente e, sui dispositivi Android, una scheda **Geofence** per le transizioni di geofencing quando i dati sono disponibili.
- **Gestione SIM** (solo Android): EID del dispositivo, SIM ed eSIM installate e cronologia dei comandi eSIM. Consulta la pagina dedicata [**Gestione SIM**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/gestione-sim "SIMs management").
- **Comandi**: invia comandi al dispositivo e visualizza la cronologia dei comandi (specifico per piattaforma).
- **Stato di sicurezza** (solo Android): stato, verdetto Play Integrity e rischi di sicurezza.
- **Report app** (solo Android): app installate e report di feedback/errore.
- **App gestite** (solo Apple): stato delle app gestite e dettagli di installazione.
- **Dettagli non conformità**: mostrato quando un dispositivo non è conforme; elenca le impostazioni della policy che risultano non conformi.
- **Report di stato**: dati aggiuntivi riportati dal dispositivo, visualizzati come un albero di categorie e valori.
- **Cronologia iscrizioni**: iscrizioni precedenti per lo stesso dispositivo fisico, mostrate come un elenco.

## Schede del pannello posizione

 Il pannello **Mappa posizione** ora utilizza delle schede, in modo che la cronologia della posizione e le transizioni di geofencing rimangano separate.

- **Posizione**: mostra i filtri della cronologia, una ricerca per intervallo di date, i segnaposto di posizione, il cerchio di accuratezza e i controlli per il tracciamento in tempo reale del dispositivo corrente.
- **Geofence** (solo Android): mostra la cronologia delle transizioni di geofencing su una mappa dedicata, con filtri temporali, un interruttore opzionale per le geofence archiviate e un elenco laterale delle transizioni.

 Per il comportamento completo di queste schede, consulta [**Mappa posizione**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/mappa-posizione "Location map").

## Azioni

 In fondo alla pagina è possibile aggiornare i dati ed eseguire azioni a seconda della piattaforma, dello stato del dispositivo e dello stato della licenza.

- **Aggiorna dati**: ricarica il record del dispositivo.
- **Disabilita dispositivo** / **Abilita dispositivo** (solo Android): disponibile negli stati supportati.
- **Rimuovi iscrizione dispositivo**: rimuove la gestione dal dispositivo. Il comportamento esatto dipende dalla piattaforma e dalla proprietà (ad esempio, su Android potrebbe essere effettuata l'inizializzazione di un profilo di lavoro o il ripristino ai dati di fabbrica).
- **Elimina dispositivo**: disponibile quando il dispositivo è già stato rimosso e il suo record può essere eliminato.

# Gestione SIM

 Sui dispositivi Android, l'editor Dispositivo fornisce un pannello **Gestione SIM** per gestire i profili SIM ed eSIM installati sul dispositivo, aggiungere o rimuovere profili eSIM e visualizzare la cronologia dei comandi eSIM inviati al dispositivo. Questo pannello è disponibile solo per i dispositivi Android.

<p class="callout info"> Le informazioni sulla SIM vengono riportate dai dispositivi completamente gestiti quando la segnalazione delle **info di rete** è abilitata nella policy del dispositivo (questa opzione è sempre abilitata da Cerberus Enterprise). Consulta la pagina [**Segnalazione dello stato**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/reporting-dello-stato "Status reporting"). </p>

## EID del dispositivo

 L'EID (identificatore eUICC) identifica l'hardware eSIM del dispositivo. Gli operatori lo utilizzano per associare i profili eSIM al dispositivo, pertanto il suo recupero è solitamente il primo passo di un flusso di lavoro per l'attivazione delle eSIM.

- **Dispositivi di proprietà dell'azienda** (Android 13 e versioni successive): l'EID viene riportato automaticamente con lo stato del dispositivo e non è richiesta alcuna interazione da parte dell'utente.
- **Dispositivi di proprietà personale** (Android 13 e versioni successive): utilizza il pulsante **Richiedi EID**. L'utente vedrà una notifica sul dispositivo che richiede di condividere l'EID e potrà approvare o rifiutare la richiesta. L'EID viene mostrato solo se l'utente approva. Mentre la richiesta è in sospeso, il pulsante rimane disabilitato.

<p class="callout warning"> L'invio di una richiesta EID mostra prima una finestra di dialogo di conferma, poiché l'utente visualizzerà una notifica sul dispositivo. </p>

## SIM installate

 La tabella **SIM installate** elenca le SIM attualmente note per il dispositivo, inclusi le SIM fisiche e i profili eSIM. Sui dispositivi di proprietà personale, i profili eSIM installati con il comando **Aggiungi eSIM** vengono mostrati anche quando il dispositivo non riporta informazioni sulla SIM.

- **Operatore**: il nome dell'operatore associato alla SIM (quando riportato).
- **Numero di telefono**: il numero di telefono associato alla SIM (quando riportato).
- **ICCID**: l'Integrated Circuit Card Identifier della SIM.
- **Stato di attivazione**: indica se l'eSIM è attiva o meno. Riportato solo per le eSIM su Android 15 e versioni successive.
- **Modalità di configurazione**: indica se l'eSIM è stata configurata da un amministratore o dall'utente. Riportato solo per le eSIM su Android 15 e versioni successive.
- **Tipo di SIM**: mostra se il dispositivo riporta la voce come eSIM.

<p class="callout info"> Le eSIM con un comando di rimozione in corso o eseguito (non fallito) mostrano uno stato di attivazione temporaneo **In rimozione**. La voce scompare dall'elenco quando il dispositivo riporta l'elenco SIM aggiornato. Mentre una rimozione è in corso, il pulsante rimuovi non è disponibile per evitare di inviare lo stesso comando due volte. </p>

### Rimuovi eSIM

 Utilizza il pulsante rimuovi accanto a una eSIM installata per rimuovere il suo profilo dal dispositivo. Una finestra di dialogo ti chiederà di confermare l'ICCID della eSIM da rimuovere prima dell'invio del comando. La rimozione di una eSIM è supportata su Android 15 e versioni successive.

## Aggiungi eSIM

 La sezione **Aggiungi eSIM** installa un nuovo profilo eSIM sul dispositivo (supportato su Android 15 e versioni successive). Richiede:

- **Validità**: per quanto tempo il comando rimane valido se non può essere eseguito immediatamente.
- **Codice di attivazione**: il codice di attivazione per il profilo eSIM, fornito dall'operatore. È possibile inserire il codice completo o solo l'indirizzo SM-DP+ per consentire al dispositivo di scoprire un profilo che l'operatore ha già collegato al proprio EID.
- **Stato di attivazione**: indica se il profilo eSIM debba essere attivato automaticamente dopo il download o lasciato non attivato per un'attivazione manuale da parte dell'utente.

## Cronologia comandi

 Sotto la sezione Aggiungi eSIM, il pannello mostra la cronologia dei comandi eSIM inviati al dispositivo: **Aggiungi eSIM**, **Rimuovi eSIM** e **Richiedi EID**. La tabella è ordinabile e supporta la paginazione. Alcune righe possono essere espanse per visualizzare i parametri del comando (ad esempio il codice di attivazione o l'ICCID) e lo stato di esecuzione, inclusi i dettagli dell'errore eSIM quando un'operazione fallisce sul dispositivo.

- **Data di creazione**
- **Comando**
- **Validità**
- **Stato**
- **Errore**: mostra lo stato dell'errore eSIM (ad esempio *L'utente ha negato l'accesso*, *Codice di attivazione non valido* o *ICCID non trovato*) quando l'esecuzione del comando lo riporta.
- **Data di esecuzione**

## Inizializza eSIM durante l'inizializzazione e la rimozione dell'iscrizione

 Quando inizializzi il dispositivo dal pannello Comandi, il flag **Inizializza eSIM** determina se i profili eSIM debbano essere rimossi con l'inizializzazione. Sui dispositivi di proprietà personale con un profilo di lavoro, questo flag è abilitato per impostazione predefinita (le eSIM gestite vengono rimosse, le eSIM di proprietà personale non vengono interessate). Lo stesso flag è disponibile nella finestra di dialogo di conferma **Rimuovi iscrizione dispositivo**.

# Comandi

 L'editor del dispositivo fornisce un pannello **Comandi** per inviare comandi remoti a un dispositivo gestito. I comandi disponibili dipendono dalla piattaforma (Android o Apple) e dallo stato del dispositivo.

<p class="callout info"> Se il dispositivo non è attualmente online, il comando verrà consegnato ed eseguito non appena il dispositivo si connetterà a Internet. Per i comandi Android, puoi impostare il parametro **Validità** per determinare per quanto tempo un comando non consegnato rimanga valido. </p>

## Comandi Android (AMAPI)

 Per i dispositivi Android, il pannello Comandi include un campo **Validità** (valore + unità) e un selettore **Comando**. Alcuni comandi richiedono parametri aggiuntivi, che compaiono dinamicamente quando si seleziona il comando.

### Parametri comuni

- **Validità**: per quanto tempo il comando rimane valido se non può essere eseguito immediatamente.
- **Comando**: scegli quale azione inviare al dispositivo.

### Comandi con campi aggiuntivi

- **Reimposta password**: richiede **Nuova password** e **Conferma nuova password**. Gli interruttori opzionali includono **Blocca ora**, **Richiedi inserimento** e **Non richiedere credenziali all'avvio**.
- **Cancella dati app**: richiede il **Nome pacchetto** di destinazione.
- **Avvia modalità smarrito**: richiede un **Messaggio di smarrimento** e supporta campi di contatto opzionali (indirizzo, organizzazione, numero di telefono, email).
- **Inizializzazione**: supporta un **messaggio sul motivo dell'inizializzazione** (mostrato agli utenti sui dispositivi personali) e flag di inizializzazione opzionali, inclusa l'opzione **Inizializza eSIM**.

<p class="callout info"> I comandi eSIM (**Aggiungi eSIM**, **Rimuovi eSIM**, **Richiedi EID**) sono disponibili nel pannello dedicato [**Gestione SIM**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/gestione-sim "SIMs management"). </p>

### Cronologia comandi

 Sotto i controlli di invio, la dashboard mostra una tabella con la cronologia dei comandi. La tabella è ordinabile e supporta la paginazione. Alcune righe possono essere espanse per visualizzare parametri aggiuntivi o dettagli di esecuzione.

#### Colonne cronologia Android

- **Data di creazione**
- **Comando**
- **Validità**
- **Stato**
- **Errore**
- **Data di esecuzione**

## Comandi Apple (MDM)

 Per i dispositivi Apple, il pannello Comandi fornisce un selettore **Comando**. Alcuni comandi richiedono input aggiuntivi. Come per Android, viene mostrata una tabella con la cronologia dei comandi qui sotto.

### Comandi con campi aggiuntivi

- **InstallApplication**: richiede l'**Bundle ID** dell'applicazione.
- **SendNotification**: richiede un **Messaggio di notifica** (lunghezza massima 200 caratteri).

#### Colonne cronologia Apple

- **Data di creazione**
- **Comando**
- **Stato**
- **Ora dello stato**

## Aggiorna

 Utilizza l'azione aggiorna nel pannello Comandi per ricaricare la cronologia dei comandi.

# Mappa posizione

 Questa pagina documenta gli strumenti di localizzazione specifici per il dispositivo disponibili in [**Panoramica dispositivo**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/panoramica-dispositivo "Device overview"). Il pannello contiene una scheda **Posizione** per la cronologia della posizione e, sui dispositivi Android, una scheda **Geofence** per le transizioni di geofencing.

## Prerequisiti

 I dati sulla posizione del dispositivo vengono mostrati solo quando la segnalazione della posizione è abilitata nella policy del dispositivo. Per abilitarla, apri la policy e attiva **Posizione e geofence** → **Segnala posizione**. Per ulteriori dettagli, consulta [**Posizione e geofence**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/posizione-e-geofencing "Location and geofence").

<p class="callout info"> Sui dispositivi che non sono completamente gestiti, i dati sulla posizione possono comunque dipendere dal fatto che l'app Cerberus Enterprise abbia i permessi di posizione richiesti e che i servizi di localizzazione siano abilitati sul dispositivo. </p>

<p class="callout info"> Per la mappa globale multi-dispositivo disponibile dalla dashboard, consulta [**Mappa posizione dashboard**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/mappa-della-posizione-nella-dashboard "Dashboard location map"). </p>

## Stato di caricamento e assenza di dati

- Mentre i dati sulla posizione vengono caricati, il pannello mostra un overlay di caricamento sulla mappa.
- Se il dispositivo non ha dati sulla posizione disponibili, il pannello mostra un messaggio che indica **Nessun dato sulla posizione disponibile** insieme a un promemoria per abilitare la segnalazione della posizione nella policy assegnata.
- Se un filtro per data è attivo e non ci sono campioni corrispondenti, il pannello mostra **Nessun dato disponibile nell'intervallo di date selezionato**.

## Scheda Posizione

 Apri la scheda **Posizione** per ispezionare la cronologia di un singolo dispositivo. I filtri disponibili includono l'ultima posizione nota, intervalli di cronologia recenti, un intervallo di date personalizzato e il tracciamento in tempo reale.

- **Ultima**: mostra l'ultima posizione nota.
- **Oggi**, **Ultimi 7 giorni** e **Ultimi 30 giorni**: mostrano le posizioni registrate per il periodo selezionato.
- **Cerca**: consente di scegliere un intervallo di date personalizzato.
- **Live**: avvia o interrompe il tracciamento in tempo reale per il dispositivo corrente.

## Dettagli del segnaposto

 Quando si fa clic su un segnaposto di posizione, si apre una finestra informativa con:

- Il timestamp del record di posizione.
- L'**accuratezza** riportata (in metri).
- La **velocità** riportata, quando il dispositivo la fornisce.
- L'**heading** o direzione riportati, quando il dispositivo li fornisce.

## Cerchio di accuratezza

 Quando la finestra informativa è aperta, viene visualizzato un cerchio di accuratezza attorno al segnaposto. Il raggio del cerchio corrisponde all'accuratezza riportata (in metri). Chiudendo la finestra informativa, il cerchio viene nascosto.

## Tracciamento in tempo reale

 Nella visualizzazione della cronologia del dispositivo, selezionando il filtro **Live** si avvia una richiesta di tracciamento in tempo reale per quel dispositivo specifico. Cerberus Enterprise richiede una conferma prima di avviare la richiesta.

- Il tracciamento in tempo reale dura fino a **15 minuti**.
- Il dispositivo mostra una notifica mentre il tracciamento in tempo reale è attivo.
- Mentre il tracciamento in tempo reale è attivo, il pannello continua ad aggiornare l'ultima posizione e l'indicatore live rimane visibile.
- Selezionare nuovamente il filtro live consente di interrompere il tracciamento in tempo reale prima della scadenza del timeout.

## Scheda Geofence

 Sui dispositivi Android, la seconda scheda mostra le transizioni di geofencing generate dalle geofence definite nella policy assegnata. Questa scheda è disponibile quando sono presenti dati di geofencing per il dispositivo.

- La mappa mostra le aree di geofencing correnti insieme ai punti di transizione registrati.
- L'elenco delle transizioni sulla destra consente di ispezionare gli eventi di **ingresso** e **uscita**.
- I filtri disponibili sono **Oggi**, **Ultimi 7 giorni**, **Ultimi 30 giorni** e una ricerca personalizzata per intervallo di date.
- **Includi archiviati** mostra anche le transizioni relative a vecchie definizioni di geofence che non sono più presenti nella policy attuale.

## Dettagli transizione geofence

 Selezionando una transizione si aprono i relativi dettagli sulla mappa e viene evidenziata la voce corrispondente nell'elenco. Quando disponibili, Cerberus Enterprise mostra anche le coordinate del dispositivo e l'accuratezza riportata per quella transizione.