Tunnel-Zertifikat erstellen

Deprecated

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

Abgekündigt. Dieser Admin-API-Endpunkt wird durch /v1/tunnels in der Claude API ersetzt und nach einem Migrationszeitraum entfernt. Neue Integrationen sollten /v1/tunnels mit dem Header anthropic-beta: mcp-tunnels-2026-06-22 und einem WIF-Token mit dem Scope workspace:manage_tunnels verwenden. Bestehende Integrationen funktionieren während des Migrationszeitraums weiterhin mit dem Header mcp-tunnels-2026-05-19 und dem Scope org:manage_tunnels.

Registriert ein öffentliches CA-Zertifikat für den Tunnel.

Anthropic verifiziert das Serverzertifikat des Gateways gegen diese CA, wenn es die innere TLS-Sitzung terminiert. Der PEM-Body muss genau ein X.509-Zertifikat und kein Private-Key-Material enthalten. Ein Tunnel hält höchstens zwei nicht archivierte Zertifikate.

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

Tunnel-Zertifikat erstellen

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"
        }'

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"
}

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"
}