Skip to content

matthewwong525/WongStack / .agents/plugins/access

access

Verified

See who can sign in and what each person may use; add, change or remove a person.

FileKindSize
README.mdmarkdown3.4 KB
SKILL.mdskill md2.3 KB
VERSIONother6 B
hooks/claude.jsonconfig251 B
hooks/codex.jsonconfig232 B
references/setup.mdmarkdown9.7 KB
screen/access.cssother10.5 KB
screen/address.mjsscript2.1 KB
screen/api.mjsscript11.6 KB
screen/api.test.mjsscript13.4 KB
screen/app.mjsscript1.2 KB
screen/app.test.mjsscript40.3 KB
screen/confirm.mjsscript1.1 KB
screen/context.mjsscript248 B
screen/copy-text.mjsscript1.3 KB
screen/fields.mjsscript1001 B
screen/hidden.test.mjsscript6.8 KB
screen/labels.mjsscript1.4 KB
screen/leaving.test.mjsscript14.6 KB
screen/level-choice.mjsscript1.3 KB
screen/levels.mjsscript3.7 KB
screen/levels.test.mjsscript7.9 KB
screen/loading.mjsscript457 B
screen/main.d.mtsother1.0 KB
screen/main.mjsscript1.3 KB
screen/note.mjsscript2.1 KB
screen/note.test.mjsscript4.1 KB
screen/notices.mjsscript4.3 KB
screen/notices.test.mjsscript2.2 KB
screen/own.mjsscript889 B
screen/owner.mjsscript2.7 KB
screen/page.mjsscript4.2 KB
screen/people.mjsscript4.5 KB
screen/person-page.mjsscript3.5 KB
screen/person-page.test.mjsscript37.2 KB
screen/project-step.mjsscript1.7 KB
screen/project-step.test.mjsscript5.4 KB
screen/pushers.mjsscript3.5 KB
screen/pushers.test.mjsscript5.2 KB
screen/role-page.mjsscript2.5 KB
screen/role-select.mjsscript1.6 KB
screen/roles.mjsscript1.5 KB
screen/roles.test.mjsscript22.2 KB
screen/router.mjsscript3.3 KB
screen/seal.d.mtsother470 B
screen/seal.mjsscript2.6 KB
screen/seal.test.mjsscript1.1 KB
screen/services.mjsscript4.3 KB
screen/services.test.mjsscript12.5 KB
screen/set-fields.mjsscript3.5 KB
screen/status.mjsscript2.4 KB
screen/status.test.mjsscript2.7 KB
screen/style.test.mjsscript11.5 KB
screen/subjects.mjsscript487 B
screen/subjects.test.mjsscript2.4 KB
screen/table.mjsscript4.5 KB
screen/test-dom.mjsscript9.4 KB
screen/ui.mjsscript14.2 KB
screen/view.mjsscript2.1 KB
screen/welcome.mjsscript2.3 KB
screen/welcome.test.mjsscript11.2 KB
scripts/check-definitions.mjsexecutablescript1.1 KB
scripts/lib/check-definitions.mjsscript1.2 KB
scripts/lib/client.mjsscript4.6 KB
scripts/lib/openapi.mjsscript20.6 KB
scripts/lib/scrub.mjsscript7.0 KB
scripts/lib/seal-keys.mjsscript1.1 KB
scripts/lib/services.mjsscript17.6 KB
scripts/services.mjsexecutablescript8.6 KB
scripts/session-start.mjsscript1.7 KB
server/errors.d.mtsother572 B
server/errors.mjsscript1.8 KB
server/errors.test.mjsscript1.3 KB
server/forward.d.mtsother1.6 KB
server/forward.mjsscript11.0 KB
server/forward.test.mjsscript9.4 KB
server/index.d.mtsother3.3 KB
server/index.mjsscript11.3 KB
server/index.test.mjsscript11.8 KB
server/key-rules.d.mtsother643 B
server/key-rules.mjsscript4.0 KB
server/key-rules.test.mjsscript5.2 KB
server/levels.d.mtsother2.3 KB
server/levels.mjsscript4.3 KB
server/levels.test.mjsscript2.4 KB
server/management.mjsscript2.8 KB
server/page.mjsscript1.3 KB
server/pass.d.mtsother213 B
server/pass.mjsscript3.5 KB
server/people.mjsscript5.3 KB
server/policy.d.mtsother1.5 KB
server/policy.mjsscript8.1 KB
server/roles.mjsscript2.4 KB
server/sealed.d.mtsother377 B
server/sealed.mjsscript3.2 KB
server/sealed.test.mjsscript4.9 KB
server/services.d.mtsother487 B
server/services.mjsscript3.1 KB
server/services.test.mjsscript4.5 KB
server/sets.mjsscript4.5 KB
server/start.mjsscript1.8 KB
server/tools.d.mtsother1.2 KB
server/tools.mjsscript8.7 KB
server/tools.test.mjsscript10.4 KB
signin/cloudflare-list.d.mtsother969 B
signin/cloudflare-list.mjsscript11.6 KB
signin/cloudflare-list.test.mjsscript1.4 KB
signin/cloudflare.d.mtsother1.5 KB
signin/cloudflare.mjsscript7.2 KB
signin/cloudflare.test.mjsscript1.4 KB
signin/computer.d.mtsother557 B
signin/computer.mjsscript2.4 KB
signin/computer.test.mjsscript1.0 KB
store/contract.d.mtsother293 B
store/contract.mjsscript14.3 KB
store/interface.d.mtsother4.2 KB
store/interface.mjsscript1.2 KB
store/stand-in.d.mtsother93 B
store/stand-in.mjsscript10.4 KB
store/stand-in.test.mjsscript202 B

signin/cloudflare.mjs

View on GitHub
// Cloudflare Access sign-in: verify the signed assertion, not a header; a service token gets no email header. The
// project's `signIn` slot is `signIn(env)`. wiki/stack/cloudflare-access.md#turning-it-on
import { isEmail } from '../server/sets.mjs';

/** True where Cloudflare's sign-in stands in front of the site, so a caller has a session to end. False while the
 *  site is open until the card, and on a local run, where the stand-in identity has none. */
export const hasSignIn = env => !!env.CF_ACCESS_TEAM_DOMAIN && !!env.CF_ACCESS_AUD && env.WONG_ENVIRONMENT !== 'local';

/** The stand-in person for local work, used ONLY on a local run with SKIP_AUTH set, from this computer. It has a
 *  subject and an hour left, so person-only routes take it there. */
const devIdentity = () => ({
  id: 'dev@example.com',
  kind: 'user',
  claims: { aud: '', iss: '', sub: 'local', exp: Math.floor(Date.now() / 1000) + 3600, email: 'dev@example.com' },
});

/** Cloudflare rotates the signing keys, so they are fetched and cached, not pinned. An unknown `kid` refetches at
 *  once, which is what handles a rotation; the time limit only bounds a stale set. */
const KEY_CACHE_TTL_MS = 60 * 60 * 1000;
let keyCache = null;

async function getSigningKeys(teamDomain, forceRefresh = false) {
  const fresh = keyCache && keyCache.teamDomain === teamDomain && Date.now() - keyCache.fetchedAt < KEY_CACHE_TTL_MS;
  if (fresh && !forceRefresh) return keyCache.keys;
  const response = await fetch(`https://${teamDomain}/cdn-cgi/access/certs`);
  if (!response.ok) return new Map();
  const { keys } = await response.json();
  const imported = new Map();
  for (const jwk of keys) {
    if (!jwk.kid) continue;
    imported.set(jwk.kid, await crypto.subtle.importKey('jwk', jwk, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['verify']));
  }
  keyCache = { teamDomain, fetchedAt: Date.now(), keys: imported };
  return imported;
}

function base64UrlDecode(segment) {
  // atob decodes forgiving base64, so the missing padding needs no restoring.
  const binary = atob(segment.replace(/-/g, '+').replace(/_/g, '/'));
  return Uint8Array.from(binary, c => c.charCodeAt(0));
}
const decodeJson = segment => JSON.parse(new TextDecoder().decode(base64UrlDecode(segment)));

function identityFromClaims(claims, audience, teamDomain) {
  // Audience: this assertion must be for THIS application, not any other app in the same organization.
  const audiences = Array.isArray(claims.aud) ? claims.aud : [claims.aud];
  if (!audiences.includes(audience)) return null;
  // Issuer: our own Access organization.
  if (claims.iss !== `https://${teamDomain}`) return null;
  const now = Math.floor(Date.now() / 1000);
  if (typeof claims.exp !== 'number' || claims.exp <= now) return null;
  if (typeof claims.nbf === 'number' && claims.nbf > now) return null;
  // One path, both callers: `email` for a person, `common_name` for a service token, which has no email.
  if (claims.email) return { id: claims.email, kind: 'user', claims };
  if (claims.common_name) return { id: claims.common_name, kind: 'service', claims };
  return null;
}

/** The app token as the edge, a browser, `cloudflared access token`, or git's Basic password sends it. Every source
 *  is verified the same way, so reading more of them widens no one's access. */
function accessToken(request) {
  const { headers } = request;
  return headers.get('Cf-Access-Jwt-Assertion') ?? headers.get('Cookie')?.match(/(?:^|;\s*)CF_Authorization=([^;]+)/)?.[1] ??
    headers.get('cf-access-token') ?? basicPassword(headers.get('Authorization'));
}

/** Git sends the credential helper's password as HTTP Basic; the username is ignored. */
function basicPassword(authorization) {
  const encoded = authorization?.match(/^Basic\s+(\S+)$/i)?.[1];
  if (!encoded) return undefined;
  try {
    const decoded = atob(encoded);
    return decoded.slice(decoded.indexOf(':') + 1) || undefined;
  } catch {
    return undefined;
  }
}

/** The Access-verified identity behind this request, or null. FAILS CLOSED: every failure path returns null. Treat
 *  null as 401; never fall through to an anonymous default. */
export async function getAccessIdentity(request, env) {
  // Local development: an explicit opt-in from the environment; a request can not reach this branch on its own.
  if (env.WONG_ENVIRONMENT === 'local' && ['localhost', '127.0.0.1', '[::1]'].includes(new URL(request.url).hostname) &&
    (env.SKIP_AUTH === true || env.SKIP_AUTH === 'true')) return devIdentity();
  const teamDomain = env.CF_ACCESS_TEAM_DOMAIN;
  const audience = env.CF_ACCESS_AUD;
  // Unconfigured is not "allow": a server that knows no application to verify against can verify nothing.
  if (!teamDomain || !audience) return null;
  const token = accessToken(request);
  if (!token) return null;
  const segments = token.split('.');
  if (segments.length !== 3) return null;
  const [headerSegment, payloadSegment, signatureSegment] = segments;
  if (!headerSegment || !payloadSegment || !signatureSegment) return null;
  try {
    const { kid, alg } = decodeJson(headerSegment);
    if (!kid || alg !== 'RS256') return null;
    let keys = await getSigningKeys(teamDomain);
    // An unknown kid means the keys rotated since they were cached: refetch once before refusing.
    let key = keys.get(kid);
    if (!key) {
      keys = await getSigningKeys(teamDomain, true);
      key = keys.get(kid);
    }
    if (!key) return null;
    const verified = await crypto.subtle.verify('RSASSA-PKCS1-v1_5', key, base64UrlDecode(signatureSegment),
      new TextEncoder().encode(`${headerSegment}.${payloadSegment}`));
    if (!verified) return null;
    return identityFromClaims(decodeJson(payloadSegment), audience, teamDomain);
  } catch {
    // A malformed token, an unreachable certs address, bad JSON: all fail closed.
    return null;
  }
}

/** A verified person's email. A service token, a missing subject or a stale assertion is no person. */
export function personOf(identity) {
  const now = Math.floor(Date.now() / 1000);
  if (!identity || identity.kind !== 'user' || identity.claims.common_name || !identity.claims.sub ||
    identity.claims.exp <= now || (identity.claims.nbf !== undefined && identity.claims.nbf > now)) return null;
  const email = identity.id.trim().toLowerCase();
  return isEmail(email) && identity.claims.email?.trim().toLowerCase() === email ? email : null;
}

/** A service token the sign-in wall admits: a machine, never a person. */
export const machineOf = identity => identity?.kind === 'service' && !identity.claims.email && !!identity.claims.common_name &&
  identity.id === identity.claims.common_name ? identity.id : null;

/** The slot's shape for a verified identity: a person, a machine, or nobody. A sign-in that is neither, such as a
 *  user with no subject, is a caller with no name: refused as a stranger is, never taken for no sign-in at all. */
export function callerOf(identity) {
  const email = personOf(identity);
  if (email) return { email, subject: identity.claims.sub };
  const machine = machineOf(identity);
  return machine ? { machine } : identity ? { machine: '' } : null;
}

/** The `signIn` slot over Cloudflare Access with the project's settings. */
export const signIn = env => async request => callerOf(await getAccessIdentity(request, env));
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall