Verifikasi identitas sesi di lingkungan yang di-host sendiri

​

Token sesi

​

Apa yang dibuktikan token

• Membuktikan: Anthropic mengeluarkan token untuk sesi tertentu di lingkungan tertentu, dan bagaimana sesi dibuat: oleh pengguna di organisasi Anda, atau oleh identitas layanan organisasi Anda, yang merupakan cara sesi saluran Claude Tag dimulai
• Tidak membuktikan: proses mana di host runner yang menyajikannya. Token berada di variabel lingkungan di dalam sesi, jadi kode apa pun yang Claude jalankan, dan alat atau server MCP apa pun yang dimulai sesi, dapat membaca dan menyajikannya.

• Verifikasi klaim aud terhadap ID lingkungan Anda, nilai ccpool_... yang ditampilkan dengan lingkungan Anda di halaman admin Cloud environments, untuk menolak token yang dikeluarkan untuk lingkungan organisasi lain.
• Batasi kredensial yang Anda turunkan dari token ke apa yang dapat dilakukan sesi coding tunggal, bukan ke semua yang dapat dilakukan pembuat sesi. Lihat Scope derived credentials.

​

Format token

sk-ant-cc-<base64url header>.<base64url payload>.<base64url signature>

​

Verifikasi token

​

Verifikasi token dari layanan Anda

https://api.anthropic.com/v1/code/.well-known/jwks.json

import { createRemoteJWKSet, jwtVerify } from "jose";

const JWKS = createRemoteJWKSet(
  new URL("https://api.anthropic.com/v1/code/.well-known/jwks.json")
);

const PREFIX = "sk-ant-cc-";
const EXPECTED_POOL_ID = "ccpool_...";

export async function verifySessionToken(raw: string) {
  if (!raw.startsWith(PREFIX)) {
    throw new Error("not a self-hosted runner session token");
  }
  const jwt = raw.slice(PREFIX.length);

  const { payload } = await jwtVerify(jwt, JWKS, {
    issuer: "ccr",
    audience: EXPECTED_POOL_ID,
    algorithms: ["ES256"],
  });

  if (payload["ccr:role"] !== "session_worker") {
    throw new Error("token is not a session_worker token");
  }

  const act = payload.act as { email?: string; sub?: string };
  return {
    sessionId: payload["ccr:session_id"] as string,
    poolId: payload["ccr:pool_id"] as string,
    orgId: payload["ccr:org_id"] as string,
    creatorEmail: act?.email,
    creatorSub: act?.sub,
  };
}

import jwt
from jwt import PyJWKClient

JWKS_URL = "https://api.anthropic.com/v1/code/.well-known/jwks.json"
PREFIX = "sk-ant-cc-"
EXPECTED_POOL_ID = "ccpool_..."

jwks = PyJWKClient(JWKS_URL)


def verify_session_token(raw: str) -> dict:
    if not raw.startswith(PREFIX):
        raise ValueError("not a self-hosted runner session token")
    token = raw.removeprefix(PREFIX)

    signing_key = jwks.get_signing_key_from_jwt(token)
    payload = jwt.decode(
        token,
        signing_key.key,
        algorithms=["ES256"],
        issuer="ccr",
        audience=EXPECTED_POOL_ID,
    )

    if payload.get("ccr:role") != "session_worker":
        raise ValueError("token is not a session_worker token")

    act = payload.get("act") or {}
    return {
        "session_id": payload["ccr:session_id"],
        "pool_id": payload["ccr:pool_id"],
        "org_id": payload["ccr:org_id"],
        "creator_email": act.get("email"),
        "creator_sub": act.get("sub"),
    }

​

Verifikasi token di dalam sesi

"$CLAUDE_RUNNER_CLAUDE_BIN" self-hosted-runner decode-token | jq -re '.act.attested_by.sub // .act.email // .act.sub'

​

Referensi klaim

​

Rantai act

​

Scope derived credentials

• Batasi kemampuan: berikan akses baca dan tulis ke sumber daya yang dibutuhkan sesi untuk tugas coding, bukan kemampuan administratif yang dimiliki pembuat di tempat lain.
• Batasi masa pakai: ikat kredensial yang diturunkan ke exp token, atau lebih pendek.
• Audit sebagai sesi: catat ccr:session_id dan jti bersama identitas pembuat sehingga Anda dapat melacak tindakan kembali ke sesi tertentu.

​

Variabel lingkungan terkait

• Hook spawn-runner, di orchestrator: hook berjalan sebelum ada runner untuk sesi antrian dan menerima identitas pembuat dalam variabel seperti CLAUDE_RUNNER_ACCOUNT_EMAIL dan CLAUDE_RUNNER_ACCOUNT_ID. Orchestrator membacanya dari pesanan kerja, token sekali pakai yang ditandatangani yang mengotorisasi pemunculan satu runner, tanpa memverifikasi tanda tangan pesanan kerja itu sendiri; klaim dipercaya karena pesanan kerja tiba melalui koneksi orchestrator ke Anthropic, yang rahasia lingkungan autentikasi.
• Skrip wrapper, di dalam sesi: wrapper menerima CCR_SESSION_ACCOUNT_EMAIL, email pembuat yang telah diekstrak sebelumnya dari token tanpa verifikasi tanda tangan. Variabel cocok untuk pelabelan, seperti trailer commit, bukan untuk keputusan auth.

​

Apa selanjutnya

• Lingkungan yang di-host sendiri: lingkungan, runner, dan model sesi; quickstart dan Deploy to production memegang setup dan operasi
• Sesuaikan sesi: skrip wrapper yang menggunakan token, dan hook spawn-runner
• Referensi: flag CLI, variabel lingkungan, dan metrik