v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132862102.5 KB
projects

Patches a single ldaps settings.

patch/v1/{+name}/ldapssettings

Path parameters

namestring required

The resource name of the LDAPS settings. Uses the form: projects/{project}/locations/{location}/domains/{domain}.

Query parameters

updateMaskstring

Required. Mask of fields to update. At least one path must be supplied in this field. For the FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask

Request body

certificatePfxstring byte

Input only. The uploaded PKCS12-formatted certificate to configure LDAPS with. It will enable the domain controllers in this domain to accept LDAPS connections (either LDAP over SSL/TLS or the StartTLS operation). A valid certificate chain must form a valid x.509 certificate chain (or be comprised of a single self-signed certificate. It must be encrypted with either: 1) PBES2 + PBKDF2 + AES256 encryption and SHA256 PRF; or 2) pbeWithSHA1And3-KeyTripleDES-CBC Private key must be included for the leaf / single self-signed certificate. Note: For a fqdn your-example-domain.com, the wildcard fqdn is *.your-example-domain.com. Specifically the leaf certificate must have: - Either a blank subject or a subject with CN matching the wildcard fqdn. - Exactly two SANs - the fqdn and wildcard fqdn. - Encipherment and digital key signature key usages. - Server authentication extended key usage (OID=1.3.6.1.5.5.7.3.1) - Private key must be in one of the following formats: RSA, ECDSA, ED25519. - Private key must have appropriate key length: 2048 for RSA, 256 for ECDSA - Signature algorithm of the leaf certificate cannot be MD2, MD5 or SHA1.

updateTimestring google-datetime

Output only. Last update time.

namestring

The resource name of the LDAPS settings. Uses the form: projects/{project}/locations/{location}/domains/{domain}.

state'STATE_UNSPECIFIED' | 'UPDATING' | 'ACTIVE' | 'FAILED'

Output only. The current state of this LDAPS settings.

certificatePasswordstring

Input only. The password used to encrypt the uploaded PFX certificate.

Response

Successful response