憑證 - Claude API Reference

建立通道憑證

client.beta.tunnels.certificates.create(tunnelID, params, options?): BetaTunnelCertificate

POST/v1/tunnels/{tunnel_id}/certificates

Tunnels API 目前為研究預覽版。它需要 anthropic-beta: mcp-tunnels-2026-06-22 標頭，且可能在沒有棄用期的情況下變更。它取代了位於 /v1/organizations/tunnels 的 Admin API 端點，這些端點在遷移期間內仍可使用。

取得通道憑證

client.beta.tunnels.certificates.retrieve(certificateID, params, options?): BetaTunnelCertificate

GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

列出通道憑證

client.beta.tunnels.certificates.list(tunnelID, params?, options?): PageCursor<BetaTunnelCertificate>

GET/v1/tunnels/{tunnel_id}/certificates

封存通道憑證

client.beta.tunnels.certificates.archive(certificateID, params, options?): BetaTunnelCertificate

POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

Models

interface BetaTunnelCertificate { type: "tunnel_certificate"; id; archived_at; /* 4 more */ }

A CA certificate attached to a tunnel.

type: "tunnel_certificate"

id: string

Unique identifier for the certificate, prefixed with tcrt_.

archived_at: string | null

RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.

formatdate-time

created_at: string

RFC 3339 datetime string indicating when the certificate was registered.

formatdate-time

expires_at: string | null

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

formatdate-time

fingerprint: string

Lowercase hex SHA-256 fingerprint of the certificate's DER encoding.

tunnel_id: string

ID of the tunnel the certificate is registered against.