Claude Platform Docs

Crear certificado de túnel

Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/certificates

Obsoleto. Este endpoint de la Admin API ha sido reemplazado por /v1/tunnels en la Claude API y se eliminará tras un período de migración. Las integraciones nuevas deben usar /v1/tunnels con el encabezado anthropic-beta: mcp-tunnels-2026-06-22 y un token WIF que incluya el alcance workspace:manage_tunnels. Las integraciones existentes siguen funcionando con el encabezado mcp-tunnels-2026-05-19 y el alcance org:manage_tunnels durante el período de migración.

Registra un certificado de CA público para el túnel.

Anthropic verifica el certificado de servidor del gateway contra esta CA cuando termina la sesión TLS interna. El cuerpo PEM debe contener exactamente un certificado X.509 y ningún material de clave privada. Un túnel tiene como máximo dos certificados no archivados.

Path parameters
tunnel_id: string

ID of the Tunnel.

Headers
"anthropic-beta": array of "mcp-tunnels-2026-05-19"

Required for all Tunnel endpoints.

Body
ca_certificate_pem: string

PEM-encoded X.509 CA certificate. Must contain exactly one certificate and no private-key material.

maxLength8192
Returns
id: string

ID of the Tunnel Certificate.

archived_at: string or null

RFC 3339 datetime string indicating when the certificate was archived, or null if it is not archived.

formatdate-time
created_at: string

RFC 3339 datetime string indicating when the certificate was registered.

formatdate-time
expires_at: string or null

RFC 3339 datetime string indicating when the certificate expires, or null if it does not expire.

formatdate-time
fingerprint: string

The certificate's SHA-256 fingerprint, as a lowercase hex string.

tunnel_id: string

ID of the Tunnel this certificate is registered against.

type: "tunnel_certificate"

Object type. Always tunnel_certificate for Tunnel Certificates.

defaulttunnel_certificate
Crear certificado de túnel
cURL
curl https://api.anthropic.com/v1/organizations/tunnels/$TUNNEL_ID/certificates \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
    -d '{
          "ca_certificate_pem": "-----BEGIN CERTIFICATE-----\nMIIBexampleEXAMPLEexampleEXAMPLEexampleEXAMPLEexampleEXAMPLEexa\n...illustrative placeholder, not a real certificate...\n-----END CERTIFICATE-----\n"
        }'
Returns Examples
Response 200
{
  "id": "tcrt_01JmWq4ZxnBvR7tKpY2sLdH9",
  "archived_at": "2024-11-01T23:59:27.427722Z",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "expires_at": "2024-10-30T23:58:27.427722Z",
  "fingerprint": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "tunnel_id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
  "type": "tunnel_certificate"
}