Questa pagina è stata tradotta dall'API Cloud Translation.

Method: challenge.verify

Verifica la risposta alla sfida.

Richiesta HTTP

POST https://verifiedaccess.googleapis.com/v2/challenge:verify

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{ "challengeResponse": string, "expectedIdentity": string }

Campi

Campi
`challengeResponse`	`string (bytes format)` Obbligatorio. La risposta generata alla richiesta, la rappresentazione in byte di SignedData. Una stringa con codifica base64.
`expectedIdentity`	`string` (Facoltativo) Il servizio può facoltativamente fornire informazioni sull'identità del dispositivo o dell'utente associato alla chiave. Per un EMK, questo valore è il dominio registrato. Per EUK, questo valore è l'indirizzo email dell'utente. Se presente, questo valore verrà controllato in base ai contenuti della risposta e, in assenza di corrispondenze, la verifica avrà esito negativo.

challengeResponse

string (bytes format)

Obbligatorio. La risposta generata alla richiesta, la rappresentazione in byte di SignedData.

Una stringa con codifica base64.

expectedIdentity

string

(Facoltativo) Il servizio può facoltativamente fornire informazioni sull'identità del dispositivo o dell'utente associato alla chiave. Per un EMK, questo valore è il dominio registrato. Per EUK, questo valore è l'indirizzo email dell'utente. Se presente, questo valore verrà controllato in base ai contenuti della risposta e, in assenza di corrispondenze, la verifica avrà esito negativo.

Corpo della risposta

Messaggio del risultato per VerifiedAccess.VerifyChallengeResponse.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON

Rappresentazione JSON
{ "devicePermanentId": string, "virtualDeviceId": string, "customerId": string, "signedPublicKeyAndChallenge": string, "deviceSignal": string, "deviceSignals": { object (`DeviceSignals`) }, "keyTrustLevel": enum (`KeyTrustLevel`), "profileCustomerId": string, "virtualProfileId": string, "profileKeyTrustLevel": enum (`KeyTrustLevel`), "attestedDeviceId": string, "deviceEnrollmentId": string }

{
  "devicePermanentId": string,
  "virtualDeviceId": string,
  "customerId": string,
  "signedPublicKeyAndChallenge": string,
  "deviceSignal": string,
  "deviceSignals": {
    object (DeviceSignals)
  },
  "keyTrustLevel": enum (KeyTrustLevel),
  "profileCustomerId": string,
  "virtualProfileId": string,
  "profileKeyTrustLevel": enum (KeyTrustLevel),
  "attestedDeviceId": string,
  "deviceEnrollmentId": string
}

Campi
`devicePermanentId`	`string` In questo campo viene restituito l'ID permanente del dispositivo (solo per la risposta della macchina).
`virtualDeviceId`	`string` ID dispositivo virtuale del dispositivo. La definizione di ID dispositivo virtuale è specifica della piattaforma.
`customerId`	`string` ID cliente univoco a cui appartiene questo dispositivo, come definito dall'SDK della Console di amministrazione Google all'indirizzo https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers
`signedPublicKeyAndChallenge`	`string` In questo campo viene restituita la richiesta di firma del certificato (nel formato SPKAC, con codifica base64). Questo campo verrà impostato solo se il dispositivo ha incluso CSR nella risposta alla sfida. (l'opzione per includere CSR è ora disponibile sia per le risposte degli utenti che per quelle automatiche)
`deviceSignal`	`string` Deprecato. Indicatore del dispositivo nella rappresentazione stringa json. Preferisci usare invece `deviceSignals`.
`deviceSignals`	`object (DeviceSignals)` Indicatori relativi ai dispositivi.
`keyTrustLevel`	`enum (KeyTrustLevel)` Livello di attendibilità della chiave attestato dal dispositivo.
`profileCustomerId`	`string` ID cliente univoco a cui appartiene questo profilo, come definito dall'SDK della Console di amministrazione Google all'indirizzo https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers
`virtualProfileId`	`string` L'ID di un profilo sul dispositivo.
`profileKeyTrustLevel`	`enum (KeyTrustLevel)` Il profilo ha attestato il livello di attendibilità della chiave.
`attestedDeviceId`	`string` ID dispositivo attestato (ADID).
`deviceEnrollmentId`	`string` ID di registrazione per i dispositivi ChromeOS.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

https://www.googleapis.com/auth/verifiedaccess

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

DeviceSignals

Il dispositivo segnala come segnalato da Chrome. Se non diversamente specificato, gli indicatori sono disponibili su tutte le piattaforme.

Rappresentazione JSON

Rappresentazione JSON
{ "deviceManufacturer": string, "deviceModel": string, "operatingSystem": enum (`OperatingSystem`), "osVersion": string, "displayName": string, "diskEncryption": enum (`DiskEncryption`), "serialNumber": string, "osFirewall": enum (`OsFirewall`), "systemDnsServers": [ string ], "hostname": string, "macAddresses": [ string ], "screenLockSecured": enum (`ScreenLockSecured`), "allowScreenLock": boolean, "imei": [ string ], "meid": [ string ], "secureBootMode": enum (`SecureBootMode`), "windowsMachineDomain": string, "windowsUserDomain": string, "deviceEnrollmentDomain": string, "browserVersion": string, "deviceAffiliationIds": [ string ], "profileAffiliationIds": [ string ], "builtInDnsClientEnabled": boolean, "chromeRemoteDesktopAppBlocked": boolean, "safeBrowsingProtectionLevel": enum (`SafeBrowsingProtectionLevel`), "siteIsolationEnabled": boolean, "passwordProtectionWarningTrigger": enum (`PasswordProtectionWarningTrigger`), "realtimeUrlCheckMode": enum (`RealtimeUrlCheckMode`), "thirdPartyBlockingEnabled": boolean, "trigger": enum (`Trigger`), "profileEnrollmentDomain": string, "crowdStrikeAgent": { object (`CrowdStrikeAgent`) } }

{
  "deviceManufacturer": string,
  "deviceModel": string,
  "operatingSystem": enum (OperatingSystem),
  "osVersion": string,
  "displayName": string,
  "diskEncryption": enum (DiskEncryption),
  "serialNumber": string,
  "osFirewall": enum (OsFirewall),
  "systemDnsServers": [
    string
  ],
  "hostname": string,
  "macAddresses": [
    string
  ],
  "screenLockSecured": enum (ScreenLockSecured),
  "allowScreenLock": boolean,
  "imei": [
    string
  ],
  "meid": [
    string
  ],
  "secureBootMode": enum (SecureBootMode),
  "windowsMachineDomain": string,
  "windowsUserDomain": string,
  "deviceEnrollmentDomain": string,
  "browserVersion": string,
  "deviceAffiliationIds": [
    string
  ],
  "profileAffiliationIds": [
    string
  ],
  "builtInDnsClientEnabled": boolean,
  "chromeRemoteDesktopAppBlocked": boolean,
  "safeBrowsingProtectionLevel": enum (SafeBrowsingProtectionLevel),
  "siteIsolationEnabled": boolean,
  "passwordProtectionWarningTrigger": enum (PasswordProtectionWarningTrigger),
  "realtimeUrlCheckMode": enum (RealtimeUrlCheckMode),
  "thirdPartyBlockingEnabled": boolean,
  "trigger": enum (Trigger),
  "profileEnrollmentDomain": string,
  "crowdStrikeAgent": {
    object (CrowdStrikeAgent)
  }
}

Campi
`deviceManufacturer`	`string` Il nome del produttore del dispositivo.
`deviceModel`	`string` Il nome del modello del dispositivo.
`operatingSystem`	`enum (OperatingSystem)` Il tipo di sistema operativo attualmente in esecuzione sul dispositivo.
`osVersion`	`string` La versione attuale del sistema operativo. Su Windows e Linux, il valore includerà anche le informazioni sulla patch di sicurezza.
`displayName`	`string` Il nome visualizzato del dispositivo, come definito dall'utente.
`diskEncryption`	`enum (DiskEncryption)` Lo stato della crittografia del disco. Su ChromeOS, il disco principale viene sempre CRIPTO.
`serialNumber`	`string` Il numero di serie del dispositivo. Su Windows, rappresenta il numero di serie del BIOS. Non disponibile sulla maggior parte delle distribuzioni Linux.
`osFirewall`	`enum (OsFirewall)` Lo stato del firewall a livello di sistema operativo. Su ChromeOS, il valore sarà sempre ATTIVATO sui dispositivi normali e SCONOSCIUTO sui dispositivi in modalità sviluppatore.
`systemDnsServers[]`	`string` Elenco degli indirizzi di tutti i server DNS a livello di sistema operativo configurati nelle impostazioni di rete del dispositivo.
`hostname`	`string` Nome host del dispositivo.
`macAddresses[]`	`string` Gli indirizzi MAC del dispositivo.
`screenLockSecured`	`enum (ScreenLockSecured)` Lo stato della protezione tramite password di blocco schermo. Su ChromeOS, questo valore sarà sempre ATTIVATO perché non è possibile disattivare la richiesta di una password o di un PIN durante lo sblocco del dispositivo.
`allowScreenLock`	`boolean` Valore del criterio allowScreenLock sul dispositivo. Per maggiori dettagli, visita la pagina https://chromeenterprise.google/policies/?policy=AllowScreenLock. Disponibile solo su ChromeOS.
`imei[]`	`string` L'IMEI (International Mobile Equipment Identity) del dispositivo. Disponibile solo su ChromeOS.
`meid[]`	`string` MEID (Mobile Equipment Identifier) del dispositivo. Disponibile solo su ChromeOS.
`secureBootMode`	`enum (SecureBootMode)` Indica se per il software di avvio del dispositivo è attiva la funzionalità Avvio protetto. Disponibile solo su Windows.
`windowsMachineDomain`	`string` Dominio Windows a cui è unita la macchina attuale. Disponibile solo su Windows.
`windowsUserDomain`	`string` Dominio Windows per l'utente corrente del sistema operativo. Disponibile solo su Windows.
`deviceEnrollmentDomain`	`string` Dominio di registrazione del cliente che attualmente gestisce il dispositivo.
`browserVersion`	`string` La versione attuale del browser Chrome che ha generato questo insieme di indicatori. Valore di esempio: "107.0.5286.0".
`deviceAffiliationIds[]`	`string` Gli ID di affiliazione delle organizzazioni affiliate all'organizzazione che attualmente gestisce il dispositivo. Quando gli insiemi di ID affiliazione dispositivo e profilo si sovrappongono, significa che le organizzazioni che gestiscono il dispositivo e l'utente sono affiliate. Per ulteriori informazioni sull'affiliazione degli utenti, visita la pagina https://support.google.com/chrome/a/answer/12801245?ref_topic=9027936.
`profileAffiliationIds[]`	`string` Gli ID di affiliazione delle organizzazioni affiliate all'organizzazione che attualmente gestisce l'utente del profilo Chrome o l'utente di ChromeOS.
`builtInDnsClientEnabled`	`boolean` Indica se viene utilizzato il client DNS integrato di Chrome. In caso contrario viene utilizzato il client DNS del sistema operativo. Questo valore può essere controllato da un criterio aziendale: https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled.
`chromeRemoteDesktopAppBlocked`	`boolean` Indica se l'accesso all'applicazione Chrome Remote Desktop è bloccato tramite un criterio.
`safeBrowsingProtectionLevel`	`enum (SafeBrowsingProtectionLevel)` Livello di protezione di Navigazione sicura. Questa impostazione potrebbe essere controllata da un criterio aziendale: https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel.
`siteIsolationEnabled`	`boolean` Indica se l'impostazione di isolamento dei siti (noto anche come sito per processo) è attivata. Questa impostazione può essere controllata da un criterio aziendale: https://chromeenterprise.google/policies/#SitePerProcess
`passwordProtectionWarningTrigger`	`enum (PasswordProtectionWarningTrigger)` Indica se la funzionalità Avviso di protezione tramite password è attivata o meno. La protezione tramite password avvisa gli utenti quando riutilizzano la propria password protetta su siti potenzialmente sospetti. Questa impostazione è controllata da un criterio aziendale: https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger. Tieni presente che la mancata configurazione del criterio non ha gli stessi effetti dell'impostazione esplicita del criterio su `PASSWORD_PROTECTION_OFF`.
`realtimeUrlCheckMode`	`enum (RealtimeUrlCheckMode)` Indica se la scansione di URL non sicuri di livello aziendale (ovvero personalizzata) è attivata o meno. Questa impostazione può essere controllata da un criterio aziendale: https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode
`thirdPartyBlockingEnabled`	`boolean` Indica se Chrome blocca o meno l'inserimento di software di terze parti. Questa impostazione potrebbe essere controllata da un criterio aziendale: https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled. Disponibile solo su Windows.
`trigger`	`enum (Trigger)` L'attivatore che ha generato questo insieme di indicatori.
`profileEnrollmentDomain`	`string` Dominio di registrazione del cliente che attualmente gestisce il profilo.
`crowdStrikeAgent`	`object (CrowdStrikeAgent)` Proprietà dell'agente CrowdStrike installate sul dispositivo, se presenti. Disponibile solo su Windows e MacOS.

Sistema operativo

Sistemi operativi supportati.

Enum
`OPERATING_SYSTEM_UNSPECIFIED`	NON SPECIFICATO.
`CHROME_OS`	ChromeOS
`CHROMIUM_OS`	ChromiumOS.
`WINDOWS`	Windows.
`MAC_OS_X`	Mac Os X.
`LINUX`	Linux

DiskEncryption

Possibili stati di crittografia per il disco principale.

Enum
`DISK_ENCRYPTION_UNSPECIFIED`	Non specificato.
`DISK_ENCRYPTION_UNKNOWN`	Chrome non può valutare lo stato della crittografia.
`DISK_ENCRYPTION_DISABLED`	Il disco principale non è criptato.
`DISK_ENCRYPTION_ENCRYPTED`	Il disco principale è criptato.

OsFirewall

Possibili stati del firewall a livello di sistema operativo.

Enum
`OS_FIREWALL_UNSPECIFIED`	Non specificato.
`OS_FIREWALL_UNKNOWN`	Chrome non è riuscito a valutare lo stato del firewall del sistema operativo.
`OS_FIREWALL_DISABLED`	Il firewall del sistema operativo è disabilitato.
`OS_FIREWALL_ENABLED`	Il firewall del sistema operativo è abilitato.

ScreenLockSecured

Possibili stati della protezione tramite password di blocco schermo.

Enum
`SCREEN_LOCK_SECURED_UNSPECIFIED`	Non specificato.
`SCREEN_LOCK_SECURED_UNKNOWN`	Chrome non ha potuto valutare lo stato del meccanismo di blocco schermo.
`SCREEN_LOCK_SECURED_DISABLED`	Il blocco schermo non è protetto da password.
`SCREEN_LOCK_SECURED_ENABLED`	Il blocco schermo è protetto da password.

SecureBootMode

Possibili stati della modalità Avvio protetto del dispositivo.

Enum
`SECURE_BOOT_MODE_UNSPECIFIED`	Non specificato.
`SECURE_BOOT_MODE_UNKNOWN`	Chrome non è riuscito a determinare la modalità di avvio protetto.
`SECURE_BOOT_MODE_DISABLED`	Avvio protetto disattivato sul software di avvio.
`SECURE_BOOT_MODE_ENABLED`	Avvio protetto abilitato sul software di avvio.

SafeBrowsingProtectionLevel

Possibili valori per il livello di protezione di Navigazione sicura.

Enum
`SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED`	Non specificato.
`INACTIVE`	Navigazione sicura è disattivata.
`STANDARD`	Navigazione sicura è attiva in modalità standard.
`ENHANCED`	Navigazione sicura è attiva in modalità avanzata.

PasswordProtectionWarningTrigger

Valori possibili per il trigger di avviso di protezione tramite password.

Enum
`PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED`	Non specificato.
`POLICY_UNSET`	Il criterio non è configurato.
`PASSWORD_PROTECTION_OFF`	Non verrà mostrato alcun avviso di protezione tramite password.
`PASSWORD_REUSE`	Se una password protetta viene riutilizzata, viene mostrato un avviso di protezione tramite password.
`PHISHING_REUSE`	L'avviso di protezione tramite password viene mostrato se una password protetta viene riutilizzata su un noto sito web di phishing.

RealtimeUrlCheckMode

Valori possibili per la modalità di controllo degli URL in tempo reale.

Enum
`REALTIME_URL_CHECK_MODE_UNSPECIFIED`	Non specificato.
`REALTIME_URL_CHECK_MODE_DISABLED`	Disabilitata. Vengono applicati i controlli consumer di Navigazione sicura.
`REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME`	Il controllo in tempo reale degli URL del frame principale è attivato.

CrowdStrikeAgent

Proprietà dell'agente CrowdStrike installato su un dispositivo.

Rappresentazione JSON
{ "agentId": string, "customerId": string }

Campi

Campi
`agentId`	`string` L'ID agente dell'agente Crowdstrike.
`customerId`	`string` L'ID cliente a cui appartiene l'agente.

agentId

string

L'ID agente dell'agente Crowdstrike.

customerId

string

L'ID cliente a cui appartiene l'agente.

Trigger

Valori possibili per il trigger.

Enum
`TRIGGER_UNSPECIFIED`	Non specificato.
`TRIGGER_BROWSER_NAVIGATION`	Quando si accede a un URL all'interno di un browser.
`TRIGGER_LOGIN_SCREEN`	Quando accedi a un account nella schermata di accesso di ChromeOS.

KeyTrustLevel

Il livello di attendibilità della chiave attestata.

Enum
`KEY_TRUST_LEVEL_UNSPECIFIED`	NON SPECIFICATO.
`CHROME_OS_VERIFIED_MODE`	Dispositivo ChromeOS in modalità verificata.
`CHROME_OS_DEVELOPER_MODE`	Dispositivo ChromeOS in modalità sviluppatore.
`CHROME_BROWSER_HW_KEY`	Browser Chrome con la chiave memorizzata nell'hardware del dispositivo.
`CHROME_BROWSER_OS_KEY`	Browser Chrome con la chiave archiviata a livello di sistema operativo.
`CHROME_BROWSER_NO_KEY`	Browser Chrome senza una chiave di attestazione.