Sign inGet Started
Comenzar
Guías
Referencia de API
SDKs
CLI
Base de conocimientos
Registro de cambios

Create a webhook client certificate signing request

POST
/v1/workspace/webhook-client-certificate/signing-request
curl -X POST "https://us1.platform.bird.com/v1/workspace/webhook-client-certificate/signing-request" \
  -H "Authorization: Bearer $TOKEN"
Respuesta201
{
  "state": "disabled",
  "crl_check": "disabled",
  "certificate": {
    "subject": "CN=bird-webhooks,O=Example Inc.",
    "issuer": "CN=Example Client CA,O=Example Inc.",
    "serial_number": "4f2a91c0d3",
    "fingerprint_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
  },
  "signing_request": {
    "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIB...\n-----END CERTIFICATE REQUEST-----\n"
  }
}

Generates a new key pair and returns its certificate signing request (CSR). The private key stays with us. Get the CSR signed by your certificate authority, then upload the certificate. A new request replaces a waiting one. The certificate in use stays in use until you upload the new one. If webhook mTLS is not enabled for this workspace, this returns 422.

Carga de respuesta

state
string
obligatorio

Whether client certificates are off (disabled), checked while the previous behavior stays available (evaluating), or required (enforced).

Possible values: disabled, evaluating, enforced

crl_check
string
obligatorio

How a certificate chain is checked against the certificate revocation list (CRL) that each certificate names. With full_chain, the leaf certificate and each intermediate certificate below the trusted root are checked. A certificate that names no CRL is not checked.

Possible values: disabled, full_chain

certificate
nullable object
obligatorio

The certificate in use. null until you upload one.

Mostrar atributos secundarios
certificate.subject
string
obligatorio

The distinguished name of the certificate.

certificate.issuer
string
obligatorio

The distinguished name of the certificate authority that signed it.

certificate.serial_number
string
obligatorio

The serial number, in lowercase hexadecimal.

certificate.fingerprint_sha256
string
obligatorio

The SHA-256 fingerprint of the certificate, in lowercase hexadecimal.

certificate.not_before
string
obligatorio

Start of the validity period.

certificate.not_after
string
obligatorio

End of the validity period.

signing_request
nullable object
obligatorio

The signing request that waits for a signed certificate. null when none waits.

Mostrar atributos secundarios
updated_at
nullable string
obligatorio

When the certificate or its state last changed. null until the first change.

Recursos relacionados

Continúa con la documentación, guías y ejemplos de este tema.

Obtener un resumen de implementación