REST Resource: customers.certificateProvisioningProcesses

Risorsa: CertificateProvisioningProcess

Una procedura di provisioning dei certificati.

Rappresentazione JSON
{
  "name": string,
  "provisioningProfileId": string,
  "subjectPublicKeyInfo": string,
  "startTime": string,
  "signData": string,
  "signatureAlgorithm": enum (SignatureAlgorithm),
  "signature": string,
  "issuedCertificate": string,
  "failureMessage": string,

  // Union field ca_connection_type can be only one of the following:
  "genericCaConnection": {
    object (GenericCaConnection)
  },
  "scepCaConnection": {
    object (ScepCaConnection)
  }
  // End of list of possible types for union field ca_connection_type.

  // Union field profile_type can be only one of the following:
  "genericProfile": {
    object (GenericProfile)
  },
  "scepProfile": {
    object (ScepProfile)
  }
  // End of list of possible types for union field profile_type.

  // Union field subject can be only one of the following:
  "chromeOsDevice": {
    object (ChromeOsDevice)
  },
  "chromeOsUserSession": {
    object (ChromeOsUserSession)
  }
  // End of list of possible types for union field subject.
}
Campi
name

string

Identificatore. Nome risorsa di CertificateProvisioningProcess. Il pattern del nome è customers/{customer}/certificateProvisioningProcesses/{certificateProvisioningProcess}, dove {customer} è l'ID cliente offuscato e {certificateProvisioningProcess} è l'ID della procedura di provisioning dei certificati.

provisioningProfileId

string

Solo output. L'ID del profilo di provisioning dei certificati.

subjectPublicKeyInfo

string (bytes format)

Solo output. La chiave pubblica per cui deve essere eseguito il provisioning di un certificato. Rappresentato come SubjectPublicKeyInfo X.509 con codifica DER.

Una stringa con codifica Base64.

startTime

string (Timestamp format)

Solo output. Timestamp generato dal server della creazione del processo di provisioning dei certificati.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

signData

string (bytes format)

Solo output. I dati che è stato chiesto al client di firmare. Questo campo è presente solo dopo l'avvio dell'operazione certificateProvisioningProcesses.signData.

Una stringa con codifica Base64.

signatureAlgorithm

enum (SignatureAlgorithm)

Solo output. L'algoritmo di firma utilizzato dai componenti client e di backend durante l'elaborazione di signData. Se profile_type è un GenericProfile, questo campo sarà presente solo dopo l'avvio dell'operazione certificateProvisioningProcesses.signData. Se profile_type è un ScepProfile, il campo sarà sempre presente.

signature

string (bytes format)

Solo output. La firma di signatureAlgorithm, generata utilizzando la chiave privata del cliente tramite signatureAlgorithm. Questo campo è presente solo al termine dell'operazione certificateProvisioningProcesses.signData.

Una stringa con codifica Base64.

issuedCertificate

string

Solo output. Il certificato emesso per questo CertificateProvisioningProcess in formato PEM.

failureMessage

string

Solo output. Un messaggio che descrive il motivo per cui questo CertificateProvisioningProcess non è riuscito. La presenza di questo campo indica che il CertificateProvisioningProcess non è riuscito.

Campo unione ca_connection_type. Il tipo di connessione dell'autorità di certificazione utilizzato per questo processo di provisioning dei certificati. ca_connection_type può essere solo uno dei seguenti:
genericCaConnection

object (GenericCaConnection)

Solo output. La connessione CA è una connessione CA generica.

scepCaConnection

object (ScepCaConnection)

Solo output. La connessione CA è una connessione CA SCEP.

Campo unione profile_type. Il tipo di profilo di provisioning dei certificati utilizzato per questa procedura di provisioning dei certificati. profile_type può essere solo uno dei seguenti:
genericProfile

object (GenericProfile)

Solo output. Il profilo è un profilo di provisioning dei certificati generico.

scepProfile

object (ScepProfile)

Solo output. Il profilo è un profilo di provisioning dei certificati SCEP.

Campo unione subject. Il tipo di entità per cui viene eseguito il provisioning di un certificato client (soggetto). subject può essere solo uno dei seguenti:
chromeOsDevice

object (ChromeOsDevice)

Solo output. Il provisioning del certificato client è in corso per un dispositivo ChromeOS. Contiene informazioni sul dispositivo.

chromeOsUserSession

object (ChromeOsUserSession)

Solo output. Il certificato client viene sottoposto al provisioning per un utente ChromeOS. Contiene informazioni sulla sessione utente corrente.

Metodi

claim

Richiede una procedura di provisioning dei certificati.

get

Recupera una procedura di provisioning dei certificati.

setFailure

Contrassegna un processo di provisioning dei certificati come non riuscito.

signData

Richiede al client che ha avviato una procedura di provisioning dei certificati di firmare i dati.

uploadCertificate

Carica un certificato emesso correttamente per una procedura di provisioning dei certificati.