web-terminal/relay-auth/test/capability.test.ts

import { describe, it, expect, beforeEach } from 'vitest'
import { issueCapabilityToken } from '../src/capability/issue.js'
import {
  verifyCapabilityToken,
  verifyDpopProof,
  buildDpopProof,
  readCnfJkt,
  subAccountId,
  hasRight,
  resetDpopCacheForTest,
} from '../src/capability/verify.js'
import { jwkThumbprint } from '../src/crypto/thumbprint.js'
import { CapabilityError } from '../src/capability/errors.js'
import { encodeBase64UrlBytes } from 'relay-contracts'
import { setupP5SigningKey, makeEphemeral, principal, uuid } from './_helpers.js'

const NOW = 1_700_000_000
const AUD = 'alice.term.example.com'

async function issueFor(
  signingKey: CryptoKey,
  opts: { accountId?: string; host?: string; rights?: readonly ('attach' | 'manage' | 'kill')[]; ttl?: number; cnfJkt?: string },
) {
  const cnfJkt = opts.cnfJkt ?? (await jwkThumbprint((await makeEphemeral()).publicRaw))
  return issueCapabilityToken(
    {
      principal: principal(opts.accountId ?? 'acct-A'),
      aud: AUD,
      host: opts.host ?? uuid(),
      rights: opts.rights ?? ['attach'],
      ttlSeconds: opts.ttl ?? 45,
      cnfJkt,
    },
    signingKey,
    NOW,
  )
}

describe('capability token (§4.3)', () => {
  let signingKey: CryptoKey
  beforeEach(async () => {
    ;({ signingKey } = await setupP5SigningKey())
    resetDpopCacheForTest()
  })

  it('round-trips issue → verify preserving host/rights/jti and sub===accountId', async () => {
    const host = uuid()
    const raw = await issueFor(signingKey, { accountId: 'acct-A', host, rights: ['attach', 'manage'] })
    const tok = await verifyCapabilityToken(raw, AUD, NOW + 1)
    expect(tok.host).toBe(host)
    expect(tok.rights).toEqual(['attach', 'manage'])
    expect(tok.jti.length).toBeGreaterThan(0)
    expect(subAccountId(tok)).toBe('acct-A')
  })

  it('sets sub to principal.accountId, never a client value', async () => {
    const raw = await issueFor(signingKey, { accountId: 'acct-A' })
    const tok = await verifyCapabilityToken(raw, AUD, NOW)
    expect(tok.sub).toBe('acct-A')
  })

  it('rejects an expired token', async () => {
    const raw = await issueFor(signingKey, { ttl: 30 })
    await expect(verifyCapabilityToken(raw, AUD, NOW + 31)).rejects.toMatchObject({ reason: 'expired' })
  })

  it('rejects a not-yet-valid token (iat in the future beyond skew)', async () => {
    const raw = await issueFor(signingKey, {})
    await expect(verifyCapabilityToken(raw, AUD, NOW - 100)).rejects.toMatchObject({
      reason: 'not_yet_valid',
    })
  })

  it('refuses an over-long TTL at issue (no long-lived reusable token)', async () => {
    await expect(issueFor(signingKey, { ttl: 61 })).rejects.toMatchObject({ reason: 'ttl_too_long' })
  })

  it('clamps a too-short TTL up to the 30s floor', async () => {
    const raw = await issueFor(signingKey, { ttl: 5 })
    const tok = await verifyCapabilityToken(raw, AUD, NOW)
    expect(tok.exp - tok.iat).toBe(30)
  })

  it('rejects a wildcard host at issue', async () => {
    await expect(issueFor(signingKey, { host: '*' })).rejects.toMatchObject({ reason: 'wildcard_host' })
  })

  it('rejects wrong aud (Host-confusion, INV1)', async () => {
    const raw = await issueFor(signingKey, {})
    await expect(verifyCapabilityToken(raw, 'bob.term.example.com', NOW)).rejects.toMatchObject({
      reason: 'aud_mismatch',
    })
  })

  it('rejects a tampered payload (signature fails)', async () => {
    const raw = await issueFor(signingKey, {})
    const tampered = raw.slice(0, -4) + (raw.endsWith('AAAA') ? 'BBBB' : 'AAAA')
    await expect(verifyCapabilityToken(tampered, AUD, NOW)).rejects.toBeInstanceOf(CapabilityError)
  })

  it('rejects a token signed by a different key', async () => {
    const other = await setupP5SigningKey() // reconfigures verify key to a DIFFERENT pair
    const raw = await issueFor(other.signingKey, {})
    // reconfigure back to the original key so the verifier uses the wrong public key
    await setupP5SigningKey()
    await expect(verifyCapabilityToken(raw, AUD, NOW)).rejects.toMatchObject({ reason: 'bad_signature' })
  })

  it('enforces least-privilege rights (INV15)', async () => {
    const raw = await issueFor(signingKey, { rights: ['attach'] })
    const tok = await verifyCapabilityToken(raw, AUD, NOW)
    expect(hasRight(tok, 'attach')).toBe(true)
    expect(hasRight(tok, 'kill')).toBe(false)
  })

  describe('DPoP proof-of-possession', () => {
    it('accepts a proof from the bound ephemeral key and rejects a different key', async () => {
      const eph = await makeEphemeral()
      const cnfJkt = await jwkThumbprint(eph.publicRaw)
      const raw = await issueFor(signingKey, { cnfJkt })
      const tok = await verifyCapabilityToken(raw, AUD, NOW)
      expect(readCnfJkt(tok)).toBe(cnfJkt)

      const htu = 'https://alice.term.example.com/ws'
      const good = await buildDpopProof(eph.privateKey, eph.publicRaw, {
        htu,
        htm: 'GET',
        jti: uuid(),
        iat: NOW,
      })
      expect(await verifyDpopProof(tok, { proofJws: good, htu, htm: 'GET' }, NOW)).toBe(true)

      const wrong = await makeEphemeral()
      const bad = await buildDpopProof(wrong.privateKey, wrong.publicRaw, {
        htu,
        htm: 'GET',
        jti: uuid(),
        iat: NOW,
      })
      expect(await verifyDpopProof(tok, { proofJws: bad, htu, htm: 'GET' }, NOW)).toBe(false)
    })

    it('rejects a replayed DPoP proof (same jti reused)', async () => {
      const eph = await makeEphemeral()
      const cnfJkt = await jwkThumbprint(eph.publicRaw)
      const raw = await issueFor(signingKey, { cnfJkt })
      const tok = await verifyCapabilityToken(raw, AUD, NOW)
      const htu = 'https://alice.term.example.com/ws'
      const jti = uuid()
      const proof = await buildDpopProof(eph.privateKey, eph.publicRaw, { htu, htm: 'GET', jti, iat: NOW })
      expect(await verifyDpopProof(tok, { proofJws: proof, htu, htm: 'GET' }, NOW)).toBe(true)
      expect(await verifyDpopProof(tok, { proofJws: proof, htu, htm: 'GET' }, NOW)).toBe(false)
    })

    // F4: a proof whose jwk.x decodes to a NON-32-byte blob makes importEd25519PublicRaw throw.
    // verifyDpopProof must be TOTALLY fail-safe and RESOLVE to false, never reject.
    it('resolves false (never throws) when the proof key is not a valid 32-byte Ed25519 key', async () => {
      // A 16-byte "key" — importEd25519PublicRaw will reject this raw length.
      const shortBlob = new Uint8Array(16).fill(7)
      // cnf.jkt is computed over the SAME 16-byte blob so the thumbprint check passes and
      // execution reaches the risky importEd25519PublicRaw call.
      const cnfJkt = await jwkThumbprint(shortBlob)
      const raw = await issueFor(signingKey, { cnfJkt })
      const tok = await verifyCapabilityToken(raw, AUD, NOW)

      const htu = 'https://alice.term.example.com/ws'
      const enc = (o: unknown) => encodeBase64UrlBytes(new TextEncoder().encode(JSON.stringify(o)))
      const h = enc({ typ: 'dpop+ed25519', jwk: { crv: 'Ed25519', kty: 'OKP', x: encodeBase64UrlBytes(shortBlob) } })
      const p = enc({ htu, htm: 'GET', jti: uuid(), iat: NOW })
      const s = encodeBase64UrlBytes(new Uint8Array(64)) // any signature bytes
      const proofJws = `${h}.${p}.${s}`

      const verify = verifyDpopProof(tok, { proofJws, htu, htm: 'GET' }, NOW)
      await expect(verify).resolves.toBe(false)
    })
  })

  it('rejects a malformed cnf.jkt at issue (not a 43-char base64url thumbprint)', async () => {
    await expect(issueFor(signingKey, { cnfJkt: 'short' })).rejects.toMatchObject({ reason: 'bad_cnf' })
  })
})