---
title: "PATCH /v1/{+name}/ldapssettings"
method: PATCH
path: "/v1/{+name}/ldapssettings"
tags: ["projects"]
---

# PATCH /v1/{+name}/ldapssettings

`PATCH /v1/{+name}/ldapssettings`

Patches a single ldaps settings.

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string

## Request body

- LDAPSSettings — LDAPSSettings represents the ldaps settings for domain resource. LDAP is the Lightweight Directory Access Protocol, defined in https://tools.ietf.org/html/rfc4511. The settings object configures LDAP over SSL/TLS, whether it is over port 636 or the StartTLS operation. If LDAPSSettings is being changed, it will be placed into the UPDATING state, which indicates that the resource is being reconciled. At this point, Get will reflect an intermediate state.
  - `certificatePfx` string, 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.
  - `updateTime` string, google-datetime — Output only. Last update time.
  - `name` string — 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.
  - `certificate` Certificate — Certificate used to configure LDAPS.
    - `thumbprint` string — The certificate thumbprint which uniquely identifies the certificate.
    - `expireTime` string, google-datetime — The certificate expire time.
    - `issuingCertificate` Certificate — recursive
    - `subject` string — The certificate subject.
    - `subjectAlternativeName` string[] — The additional hostnames for the domain.
  - `certificatePassword` string — Input only. The password used to encrypt the uploaded PFX certificate.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/managedidentities.md) · [All operations](https://skmtc.net/google/apis/managedidentities/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/managedidentities/versions/def2f0a79c2b/schema)