BatchUsageLogEvents

Log eventi in batch di events dal dispositivo.

Rappresentazione JSON
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
Campi
device

string

Se presente, il nome del dispositivo nel formato "enterprises/{enterpriseId}/devices/{deviceId}"

user

string

Se presente, il nome della risorsa dell'utente proprietario di questo dispositivo nel formato "enterprises/{enterpriseId}/users/{userId}".

retrievalTime

string (Timestamp format)

Il timestamp del dispositivo quando il gruppo di eventi è stato raccolto dal dispositivo.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

usageLogEvents[]

object (UsageLogEvent)

L'elenco di UsageLogEvent segnalati dal dispositivo, ordinati cronologicamente in base all'ora dell'evento.

UsageLogEvent

Un evento registrato sul dispositivo.

Rappresentazione JSON
{
  "eventId": string,
  "eventTime": string,
  "eventType": enum (EventType),

  // Union field event can be only one of the following:
  "adbShellCommandEvent": {
    object (AdbShellCommandEvent)
  },
  "adbShellInteractiveEvent": {
    object (AdbShellInteractiveEvent)
  },
  "appProcessStartEvent": {
    object (AppProcessStartEvent)
  },
  "keyguardDismissedEvent": {
    object (KeyguardDismissedEvent)
  },
  "keyguardDismissAuthAttemptEvent": {
    object (KeyguardDismissAuthAttemptEvent)
  },
  "keyguardSecuredEvent": {
    object (KeyguardSecuredEvent)
  },
  "filePulledEvent": {
    object (FilePulledEvent)
  },
  "filePushedEvent": {
    object (FilePushedEvent)
  },
  "certAuthorityInstalledEvent": {
    object (CertAuthorityInstalledEvent)
  },
  "certAuthorityRemovedEvent": {
    object (CertAuthorityRemovedEvent)
  },
  "certValidationFailureEvent": {
    object (CertValidationFailureEvent)
  },
  "cryptoSelfTestCompletedEvent": {
    object (CryptoSelfTestCompletedEvent)
  },
  "keyDestructionEvent": {
    object (KeyDestructionEvent)
  },
  "keyGeneratedEvent": {
    object (KeyGeneratedEvent)
  },
  "keyImportEvent": {
    object (KeyImportEvent)
  },
  "keyIntegrityViolationEvent": {
    object (KeyIntegrityViolationEvent)
  },
  "loggingStartedEvent": {
    object (LoggingStartedEvent)
  },
  "loggingStoppedEvent": {
    object (LoggingStoppedEvent)
  },
  "logBufferSizeCriticalEvent": {
    object (LogBufferSizeCriticalEvent)
  },
  "mediaMountEvent": {
    object (MediaMountEvent)
  },
  "mediaUnmountEvent": {
    object (MediaUnmountEvent)
  },
  "osShutdownEvent": {
    object (OsShutdownEvent)
  },
  "osStartupEvent": {
    object (OsStartupEvent)
  },
  "remoteLockEvent": {
    object (RemoteLockEvent)
  },
  "wipeFailureEvent": {
    object (WipeFailureEvent)
  },
  "connectEvent": {
    object (ConnectEvent)
  },
  "dnsEvent": {
    object (DnsEvent)
  },
  "stopLostModeUserAttemptEvent": {
    object (StopLostModeUserAttemptEvent)
  },
  "lostModeOutgoingPhoneCallEvent": {
    object (LostModeOutgoingPhoneCallEvent)
  },
  "lostModeLocationEvent": {
    object (LostModeLocationEvent)
  },
  "enrollmentCompleteEvent": {
    object (EnrollmentCompleteEvent)
  }
  // End of list of possible types for union field event.
}
Campi
eventId

string (int64 format)

ID univoco dell'evento.

eventTime

string (Timestamp format)

Timestamp del dispositivo nel momento in cui l'evento è stato registrato.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

eventType

enum (EventType)

Il tipo specifico di evento del log di utilizzo segnalato sul dispositivo. Utilizzalo per determinare a quale campo event accedere.

Campo unione event. Tipi di eventi registrati sul dispositivo. Vedi ciascun tipo di evento per maggiori dettagli su quando viene inviato e sulle restrizioni su quando viene registrato l'evento e su quali campi sono inclusi. event può essere solo uno dei seguenti:
adbShellCommandEvent

object (AdbShellCommandEvent)

Un comando shell è stato emesso su ADB tramite "comando adb shell". Parte di SECURITY_LOGS.

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

Una shell interattiva ADB è stata aperta tramite "adb shell". Parte di SECURITY_LOGS.

appProcessStartEvent

object (AppProcessStartEvent)

È stato avviato un processo dell'app. Parte di SECURITY_LOGS.

keyguardDismissedEvent

object (KeyguardDismissedEvent)

Il blocco tastiera è stato ignorato. Parte di SECURITY_LOGS.

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

È stato effettuato un tentativo di sbloccare il dispositivo. Parte di SECURITY_LOGS.

keyguardSecuredEvent

object (KeyguardSecuredEvent)

Il dispositivo è stato bloccato dall'utente o da un timeout. Parte di SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

È stato scaricato un file dal dispositivo. Parte di SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

Un file è stato caricato sul dispositivo. Parte di SECURITY_LOGS.

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Un nuovo certificato radice è stato installato nell'archivio credenziali attendibile del sistema. Parte di SECURITY_LOGS.

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

Un certificato radice è stato rimosso dall'archivio credenziali attendibile del sistema. Parte di SECURITY_LOGS.

certValidationFailureEvent

object (CertValidationFailureEvent)

Impossibile convalidare un certificato X.509v3. Attualmente questa convalida viene eseguita sul punto di accesso Wi-Fi. L'errore potrebbe essere dovuto a una mancata corrispondenza al momento della convalida del certificato del server. Tuttavia, in futuro potrebbe includere altri eventi di convalida di un certificato X.509v3. Parte di SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Consente di verificare se la libreria crittografica integrata di Android (BoringSSL) è valida. Dovrebbe sempre riuscire all'avvio del dispositivo. Se non riesce, il dispositivo deve essere considerato non attendibile. Parte di SECURITY_LOGS.

keyDestructionEvent

object (KeyDestructionEvent)

Una chiave di crittografia, che include una chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, viene rimossa dal dispositivo dall'utente o dal gestore. Parte di SECURITY_LOGS.

keyGeneratedEvent

object (KeyGeneratedEvent)

Una chiave di crittografia che include una chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema viene installata sul dispositivo dall'utente o dalla gestione. Parte di SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Una chiave di crittografia, che include la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, viene importata sul dispositivo dall'utente o dalla gestione. Parte di SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Una chiave di crittografia (che include una chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema) è danneggiata a causa di un danneggiamento dello spazio di archiviazione, un guasto dell'hardware o un problema del sistema operativo. Parte di SECURITY_LOGS.

loggingStartedEvent

object (LoggingStartedEvent)

Il criterio usageLog è stato attivato. Parte di SECURITY_LOGS.

loggingStoppedEvent

object (LoggingStoppedEvent)

Il criterio usageLog è stato disattivato. Parte di SECURITY_LOGS.

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

Il buffer degli audit log ha raggiunto il 90% della capacità, pertanto gli eventi meno recenti potrebbero essere eliminati. Parte di SECURITY_LOGS.

mediaMountEvent

object (MediaMountEvent)

È stato montato un supporto rimovibile. Parte di SECURITY_LOGS.

mediaUnmountEvent

object (MediaUnmountEvent)

Il supporto rimovibile è stato smontato. Parte di SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

Il dispositivo è stato spento. Parte di SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

Il dispositivo è stato avviato. Parte di SECURITY_LOGS.

remoteLockEvent

object (RemoteLockEvent)

Il dispositivo o il profilo è stato bloccato da remoto tramite il comando LOCK. Parte di SECURITY_LOGS.

wipeFailureEvent

object (WipeFailureEvent)

Non è stato possibile cancellare il profilo di lavoro o il dispositivo di proprietà dell'azienda quando richiesto. Può essere avviata dall'utente o dall'amministratore, ad esempio delete è stato ricevuto. Parte di SECURITY_LOGS.

connectEvent

object (ConnectEvent)

È stato avviato un evento di connessione TCP tramite lo stack di rete standard. Parte di NETWORK_ACTIVITY_LOGS.

dnsEvent

object (DnsEvent)

È stato avviato un evento di ricerca DNS tramite lo stack di rete standard. Parte di NETWORK_ACTIVITY_LOGS.

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Tentativo di disattivare la modalità Dispositivo smarrito.

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

È stata effettuata una chiamata in uscita quando un dispositivo in modalità Dispositivo smarrito.

lostModeLocationEvent

object (LostModeLocationEvent)

Un aggiornamento della posizione in modalità Dispositivo smarrito quando un dispositivo è in modalità Dispositivo smarrito.

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

La registrazione del dispositivo è stata completata. Parte di AMAPI_LOGS.

KeyguardDismissedEvent

Questo tipo non contiene campi.

Il blocco tastiera è stato ignorato. Volevolmente vuoto.

KeyguardDismissAuthAttemptEvent

È stato effettuato un tentativo di sbloccare il dispositivo.

Rappresentazione JSON
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
Campi
success

boolean

Se il tentativo di sblocco è riuscito.

strongAuthMethodUsed

boolean

Indica se è stata utilizzata una forma di autenticazione efficace (password, PIN o sequenza) per sbloccare il dispositivo.

KeyguardSecuredEvent

Questo tipo non contiene campi.

Il dispositivo è stato bloccato dall'utente o da un timeout. Volevolmente vuoto.

FilePulledEvent

È stato scaricato un file dal dispositivo.

Rappresentazione JSON
{
  "filePath": string
}
Campi
filePath

string

Il percorso del file di cui è stato eseguito il pull.

FilePushedEvent

Un file è stato caricato sul dispositivo.

Rappresentazione JSON
{
  "filePath": string
}
Campi
filePath

string

Il percorso del file di cui viene eseguito il push.

CertAuthorityInstalledEvent

Un nuovo certificato radice è stato installato nell'archivio credenziali attendibile del sistema. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Campi
certificate

string

Soggetto del certificato.

userId

integer

L'utente in cui si è verificato l'evento di installazione del certificato. Disponibile solo per i dispositivi con Android 11 e versioni successive.

success

boolean

Se l'evento di installazione è riuscito.

CertAuthorityRemovedEvent

Un certificato radice è stato rimosso dall'archivio credenziali attendibile del sistema. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Campi
certificate

string

Soggetto del certificato.

userId

integer

L'utente in cui si è verificato l'evento di rimozione del certificato. Disponibile solo per i dispositivi con Android 11 e versioni successive.

success

boolean

L'esito della rimozione.

CertValidationFailureEvent

Impossibile convalidare un certificato X.509v3. Attualmente questa convalida viene eseguita sul punto di accesso Wi-Fi. L'errore potrebbe essere dovuto a una mancata corrispondenza al momento della convalida del certificato del server. Tuttavia, in futuro potrebbe includere altri eventi di convalida di un certificato X.509v3.

Rappresentazione JSON
{
  "failureReason": string
}
Campi
failureReason

string

Il motivo per cui la convalida della certificazione non è riuscita.

CryptoSelfTestCompletedEvent

Consente di verificare se la libreria crittografica integrata di Android (BoringSSL) è valida. Dovrebbe sempre riuscire all'avvio del dispositivo. Se non riesce, il dispositivo deve essere considerato non attendibile.

Rappresentazione JSON
{
  "success": boolean
}
Campi
success

boolean

Se il test è riuscito.

KeyDestructionEvent

Una chiave di crittografia, che include una chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, viene rimossa dal dispositivo dall'utente o dal gestore. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campi
keyAlias

string

Alias della chiave.

applicationUid

integer

UID dell'applicazione proprietaria della chiave.

success

boolean

Se l'operazione è riuscita.

KeyGeneratedEvent

Una chiave di crittografia, che include una chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, viene installata sul dispositivo dall'utente o dalla gestione.È disponibile a livello di dispositivo sui dispositivi completamente gestiti e nel profilo di lavoro sui dispositivi di proprietà dell'organizzazione che dispongono di un profilo di lavoro.

Rappresentazione JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campi
keyAlias

string

Alias della chiave.

applicationUid

integer

UID dell'applicazione che ha generato la chiave.

success

boolean

Se l'operazione è riuscita.

KeyImportEvent

Una chiave di crittografia, che include la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, viene importata sul dispositivo dall'utente o dalla gestione. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campi
keyAlias

string

Alias della chiave.

applicationUid

integer

UID dell'applicazione che ha importato la chiave

success

boolean

Se l'operazione è riuscita.

KeyIntegrityViolationEvent

Una chiave di crittografia (che include una chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema) è danneggiata a causa di un danneggiamento dello spazio di archiviazione, un guasto dell'hardware o un problema del sistema operativo. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON
{
  "keyAlias": string,
  "applicationUid": integer
}
Campi
keyAlias

string

Alias della chiave.

applicationUid

integer

UID dell'applicazione proprietaria della chiave

LoggingStartedEvent

Questo tipo non contiene campi.

Il criterio usageLog è stato attivato. Volevolmente vuoto.

LoggingStoppedEvent

Questo tipo non contiene campi.

Il criterio usageLog è stato disattivato. Volevolmente vuoto.

LogBufferSizeCriticalEvent

Questo tipo non contiene campi.

Il buffer di usageLog sul dispositivo ha raggiunto il 90% della sua capacità, pertanto gli eventi meno recenti potrebbero essere eliminati. Volevolmente vuoto.

MediaMountEvent

È stato montato un supporto rimovibile.

Rappresentazione JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Campi
mountPoint

string

Punto di montaggio.

volumeLabel

string

Etichetta del volume. Oscurato in stringa vuota sui dispositivi con profili gestiti di proprietà dell'organizzazione.

MediaUnmountEvent

Il supporto rimovibile è stato smontato.

Rappresentazione JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Campi
mountPoint

string

Punto di montaggio.

volumeLabel

string

Etichetta del volume. Oscurato in stringa vuota sui dispositivi con profili gestiti di proprietà dell'organizzazione.

OsShutdownEvent

Questo tipo non contiene campi.

Il dispositivo è stato spento. Volevolmente vuoto.

OsStartupEvent

Il dispositivo è stato avviato.

Rappresentazione JSON
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
Campi
verifiedBootState

enum (VerifiedBootState)

Stato di Avvio verificato.

verityMode

enum (DmVerityMode)

modalità DM-Verity.

RemoteLockEvent

Il dispositivo o il profilo è stato bloccato da remoto tramite il comando LOCK.

Rappresentazione JSON
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
Campi
adminPackageName

string

Nome del pacchetto dell'app di amministrazione che richiede la modifica.

adminUserId

integer

ID utente dell'app di amministrazione da cui è stata richiesta la modifica.

targetUserId

integer

ID utente in cui è stata richiesta la modifica.

WipeFailureEvent

Questo tipo non contiene campi.

Non è stato possibile cancellare il profilo di lavoro o il dispositivo di proprietà dell'azienda quando richiesto. Può essere avviata dall'utente o dall'amministratore, ad esempio delete è stato ricevuto. Volevolmente vuoto.

ConnectEvent

È stato avviato un evento di connessione TCP tramite lo stack di rete standard.

Rappresentazione JSON
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
Campi
destinationIpAddress

string

L'indirizzo IP di destinazione della chiamata di connessione.

destinationPort

integer

La porta di destinazione della chiamata di connessione.

packageName

string

Il nome del pacchetto dell'UID che ha eseguito la chiamata di connessione.

DnsEvent

È stato avviato un evento di ricerca DNS tramite lo stack di rete standard.

Rappresentazione JSON
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
Campi
hostname

string

Il nome host che è stato cercato.

ipAddresses[]

string

L'elenco (possibilmente troncato) degli indirizzi IP restituiti per la ricerca DNS (massimo 10 indirizzi IPv4 o IPv6).

totalIpAddressesReturned

string (int64 format)

Il numero di indirizzi IP restituiti dall'evento di ricerca DNS. Può essere superiore al numero di Indirizzi IP se erano presenti troppi indirizzi da registrare.

packageName

string

Il nome del pacchetto dell'UID che ha eseguito la ricerca DNS.

StopLostModeUserAttemptEvent

Un evento della modalità Dispositivo smarrito che indica che l'utente ha tentato di interrompere questa modalità.

Rappresentazione JSON
{
  "status": enum (Status)
}
Campi
status

enum (Status)

Lo stato del tentativo di interrompere la modalità Dispositivo smarrito.

LostModeOutgoingPhoneCallEvent

Questo tipo non contiene campi.

Un evento che indica che è stata effettuata una telefonata in uscita quando un dispositivo è in modalità Dispositivo smarrito. Volevolmente vuoto.

LostModeLocationEvent

Un evento di modalità Dispositivo smarrito che contiene la posizione del dispositivo e il livello della batteria in percentuale.

Rappresentazione JSON
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
Campi
location

object (Location)

La posizione del dispositivo

batteryLevel

integer

Il livello della batteria in un numero compreso tra 0 e 100 (inclusi)

Località

La posizione del dispositivo contenente la latitudine e la longitudine.

Rappresentazione JSON
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La posizione di latitudine della località

longitude

number

La longitudine della località

EnrollmentCompleteEvent

Questo tipo non contiene campi.

Rappresenta che il dispositivo ha completato la registrazione. L'utente dovrebbe essere in Avvio app a questo punto, il dispositivo sarà conforme e tutti i passaggi di configurazione sono stati completati. Volevolmente vuoto.