Method: customers.policies.networks.defineCertificate

  • This page details how to create a certificate at a specified organizational unit for a customer.

  • The process involves making a POST request to a specific URL with required path parameters like the customer ID.

  • The request body necessitates the targetResource, raw certificate content, and optionally the certificate name and network settings.

  • A successful response will contain the affiliated settings, the certificate's GUID (networkId), and the target resource where the certificate is defined.

  • Creating a certificate requires the https://www.googleapis.com/auth/chrome.management.policy authorization scope.

Creates a certificate at a specified OU for a customer.

HTTP request

POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineCertificate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. The customer for which the certificate will apply.

Request body

The request body contains data with the following structure:

JSON representation
{
  "targetResource": string,
  "ceritificateName": string,
  "certificate": string,
  "settings": [
    {
      object (NetworkSetting)
    }
  ]
}
Fields
targetResource

string

Required. The target resource on which this certificate is applied. The following resources are supported: * Organizational Unit ("orgunits/{orgunit_id}")

ceritificateName

string

Optional. The optional name of the certificate. If not specified, the certificate issuer will be used as the name.

certificate

string

Required. The raw contents of the .PEM, .CRT, or .CER file.

settings[]

object (NetworkSetting)

Optional. Certificate settings within the chrome.networks.certificates namespace.

Response body

Response object for creating a certificate.

If successful, the response body contains data with the following structure:

JSON representation
{
  "settings": [
    {
      object (NetworkSetting)
    }
  ],
  "networkId": string,
  "targetResource": string
}
Fields
settings[]

object (NetworkSetting)

the affiliated settings of the certificate (NOT IMPLEMENTED)

networkId

string

The guid of the certificate created by the action.

targetResource

string

the resource at which the certificate is defined.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chrome.management.policy