workers-start 0.7.1 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/README.md +111 -10
- package/dist/access-testing.d.ts +29 -0
- package/dist/access-testing.d.ts.map +1 -0
- package/dist/access-testing.js +60 -0
- package/dist/access-testing.js.map +1 -0
- package/dist/access.d.ts +90 -0
- package/dist/access.d.ts.map +1 -0
- package/dist/access.js +213 -0
- package/dist/access.js.map +1 -0
- package/dist/google.d.ts +148 -0
- package/dist/google.d.ts.map +1 -0
- package/dist/google.js +224 -0
- package/dist/google.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/package.json +19 -2
- package/src/access-testing.ts +121 -0
- package/src/access.ts +313 -0
- package/src/google.ts +418 -0
- package/src/index.ts +43 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.9.0 (2026-11-20)
|
|
4
|
+
|
|
5
|
+
- `workers-start/google`: Google APIs as a service account on WebCrypto. `googleAccessToken(account, scopes)` signs the JWT and caches the access token per account and scope (shared exchanges, failures not cached), `parseServiceAccount` reads the key file JSON, and `importServiceAccountKey` names a PKCS#1 or non-PEM key. `ga4RunReport`, `ga4BatchRunReports`, `ga4Rows` and `inListFilter` for the GA4 Data API, and `searchConsoleQuery` (with `all: true` paging) for Search Console. Errors throw `GoogleApiError` with Google's status and message.
|
|
6
|
+
|
|
7
|
+
## 0.8.0 (2026-11-20)
|
|
8
|
+
|
|
9
|
+
- `workers-start/access`: `verifyAccessToken(token, config)` checks a Cloudflare Access JWT (RS256 against the team's certs, issuer, audience, `exp`, `nbf`, then an email or service token allowlist) and returns a result with a `code` of `unconfigured`, `unauthenticated`, `forbidden` or `unavailable` instead of throwing. `parseAccessConfig`, `accessToken` (header, then cookie) and `createAccessVerifier` for a verifier with its own key cache and clock.
|
|
10
|
+
- `workers-start/access/testing`: `createTestAccessTeam()` makes a key pair, serves its certs and signs tokens, for tests of code that checks Access.
|
|
11
|
+
|
|
3
12
|
## 0.7.1 (2026-11-20)
|
|
4
13
|
|
|
5
14
|
- Package metadata (`repository`, `homepage`, `bugs`) points at [ryanio/workers-kit](https://github.com/ryanio/workers-kit), where the package now lives. The first release published from there.
|
package/README.md
CHANGED
|
@@ -8,16 +8,19 @@ It has no runtime dependencies. Each piece is its own entry point, so an app tak
|
|
|
8
8
|
|
|
9
9
|
Check this list before writing a helper in an app. Anything generic to TanStack Start on Workers that is missing belongs here, with a test, rather than in one app.
|
|
10
10
|
|
|
11
|
-
| Entry point
|
|
12
|
-
|
|
|
13
|
-
| `workers-start/entry`
|
|
14
|
-
| `workers-start/head`
|
|
15
|
-
| `workers-start/scripts`
|
|
16
|
-
| `workers-start/cache`
|
|
17
|
-
| `workers-start/workers`
|
|
18
|
-
| `workers-start/
|
|
19
|
-
| `workers-start/
|
|
20
|
-
| `workers-start/
|
|
11
|
+
| Entry point | Exports | For |
|
|
12
|
+
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
|
|
13
|
+
| `workers-start/entry` | `createEntry`, `withHeaders`, `wantsMarkdown`, `acceptsHtml` | The Worker entry: Markdown for agents, Accept fixes, 405s, headers on every response |
|
|
14
|
+
| `workers-start/head` | `createPageHead`, `jsonLdScript` | Per-route head tags and escaped JSON-LD |
|
|
15
|
+
| `workers-start/scripts` | `themeScript`, `analyticsScript`, `tagManagerScript`, `gaEvent`, `inlineJson` | Inline bootstraps, analytics events, JSON safe inside a script tag |
|
|
16
|
+
| `workers-start/cache` | `withEdgeCache`, `sharedMaxAge`, `withoutBrowserMaxAge` | Rendered pages kept in the Workers Cache API |
|
|
17
|
+
| `workers-start/workers` | `getBinding`, `getEnvString`, `afterResponse`, `isKvNamespace` | Bindings and `waitUntil` without a static `cloudflare:workers` import |
|
|
18
|
+
| `workers-start/access` | `verifyAccessToken`, `createAccessVerifier`, `parseAccessConfig`, `accessToken` | Cloudflare Access sign-ins checked in the Worker, failing closed |
|
|
19
|
+
| `workers-start/access/testing` | `createTestAccessTeam` | A fake Access team for tests: keys, certs and signed tokens |
|
|
20
|
+
| `workers-start/google` | `googleAccessToken`, `parseServiceAccount`, `ga4RunReport`, `ga4BatchRunReports`, `ga4Rows`, `inListFilter`, `searchConsoleQuery` | Google APIs as a service account: cached tokens, GA4 reports, Search Console |
|
|
21
|
+
| `workers-start/seo` | `sitemapXml`, `robotsTxt`, `escapeXml` | `/sitemap.xml` and `/robots.txt` bodies |
|
|
22
|
+
| `workers-start/accept` | `parseAccept`, `quality` | Accept header parsing |
|
|
23
|
+
| `workers-start/check-bundle` | `workers-start-check-bundle` (bin) | Fails a build that would ship a local secret |
|
|
21
24
|
|
|
22
25
|
## Why
|
|
23
26
|
|
|
@@ -179,6 +182,104 @@ return withEdgeCache(request, () => handler.fetch(request), {
|
|
|
179
182
|
|
|
180
183
|
A cache hit has its browser `max-age` removed (the zone adds one, and a browser holding page HTML that long outlives the next deploy's assets). The store runs after the response through `afterResponse`; pass `waitUntil` or `cache` to override, as tests do. Outside workerd every request renders.
|
|
181
184
|
|
|
185
|
+
## Cloudflare Access
|
|
186
|
+
|
|
187
|
+
Access adds a signed JWT to every request it lets through, as the `Cf-Access-Jwt-Assertion` header and the `CF_Authorization` cookie. The header alone proves nothing: anyone can send it to the Worker's `workers.dev` or other hostnames, and paths Access does not cover (such as `/_serverFn`) never get one. `workers-start/access` checks the token itself, on WebCrypto with no dependencies: the RS256 signature against the team's published keys, the issuer, the audience, `exp` and `nbf` (60 seconds of leeway), then the email against an allowlist.
|
|
188
|
+
|
|
189
|
+
```ts
|
|
190
|
+
import {
|
|
191
|
+
accessToken,
|
|
192
|
+
parseAccessConfig,
|
|
193
|
+
verifyAccessToken,
|
|
194
|
+
} from "workers-start/access";
|
|
195
|
+
|
|
196
|
+
const config = parseAccessConfig({
|
|
197
|
+
teamDomain: env.ACCESS_TEAM_DOMAIN, // myteam.cloudflareaccess.com
|
|
198
|
+
aud: env.ACCESS_AUD,
|
|
199
|
+
emails: env.ADMIN_EMAILS, // comma or space separated
|
|
200
|
+
});
|
|
201
|
+
|
|
202
|
+
const result = await verifyAccessToken(accessToken(request), config);
|
|
203
|
+
if (!result.ok) {
|
|
204
|
+
return Response.json({ error: { code: result.code, message: result.reason } }, {
|
|
205
|
+
status: result.status,
|
|
206
|
+
});
|
|
207
|
+
}
|
|
208
|
+
// result.email is the signed-in address, lowercased.
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
Every failure is a result, never a throw:
|
|
212
|
+
|
|
213
|
+
| `code` | `status` | When |
|
|
214
|
+
| ----------------- | -------- | ----------------------------------------------------------------------- |
|
|
215
|
+
| `unconfigured` | 503 | `parseAccessConfig` returned null: a value is missing |
|
|
216
|
+
| `unauthenticated` | 401 | No token, a malformed one, or a bad signature, issuer, audience or time |
|
|
217
|
+
| `forbidden` | 403 | A valid token for an address or service token not on the list |
|
|
218
|
+
| `unavailable` | 503 | The team's certs could not be fetched and no keys are cached |
|
|
219
|
+
|
|
220
|
+
`parseAccessConfig` returns null unless it has a team domain, an audience and at least one allowed email or service token, so a missing secret refuses everyone instead of letting everyone in.
|
|
221
|
+
|
|
222
|
+
`verifyAccessToken` keeps the team's keys for an hour in the isolate. A token that names a key id it has not seen (Access rotates keys) refetches the certs, at most once a minute, so made-up key ids cannot hammer the certs URL. A failed fetch keeps the keys it already has. `createAccessVerifier({ fetch, now, ttlMs, refreshMs, timeoutMs, leewaySeconds })` makes a verifier with its own cache and clock, for tests or for a custom `fetch`.
|
|
223
|
+
|
|
224
|
+
Access service tokens carry no email. List their client ids in `serviceTokens` to let them in; a match returns `{ ok: true, service: clientId }`. Only a token Access issued for a service (`type: "app"`, empty `sub`, no email) counts, so a client certificate with the same name does not.
|
|
225
|
+
|
|
226
|
+
In tests, `workers-start/access/testing` stands in for the team:
|
|
227
|
+
|
|
228
|
+
```ts
|
|
229
|
+
import { createAccessVerifier } from "workers-start/access";
|
|
230
|
+
import { createTestAccessTeam } from "workers-start/access/testing";
|
|
231
|
+
|
|
232
|
+
const team = await createTestAccessTeam({ emails: ["admin@example.com"] });
|
|
233
|
+
const verify = createAccessVerifier({ fetch: team.fetch });
|
|
234
|
+
const result = await verify(await team.token("admin@example.com"), team.config);
|
|
235
|
+
// { ok: true, email: "admin@example.com" }
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
## Google APIs
|
|
239
|
+
|
|
240
|
+
`workers-start/google` calls Google as a service account with WebCrypto and `fetch`, so it runs in a Worker as well as in Node scripts. It covers the parts apps keep rewriting: the signed JWT exchanged for an access token, the GA4 Data API and Search Console.
|
|
241
|
+
|
|
242
|
+
```ts
|
|
243
|
+
import {
|
|
244
|
+
GA4_SCOPE,
|
|
245
|
+
ga4Rows,
|
|
246
|
+
ga4RunReport,
|
|
247
|
+
googleAccessToken,
|
|
248
|
+
parseServiceAccount,
|
|
249
|
+
SEARCH_CONSOLE_SCOPE,
|
|
250
|
+
searchConsoleQuery,
|
|
251
|
+
} from "workers-start/google";
|
|
252
|
+
|
|
253
|
+
const account = parseServiceAccount(env.GA_SA_JSON); // the key file JSON
|
|
254
|
+
if (!account) throw new Error("GA_SA_JSON is not a service account key");
|
|
255
|
+
const token = await googleAccessToken(account, [
|
|
256
|
+
GA4_SCOPE,
|
|
257
|
+
SEARCH_CONSOLE_SCOPE,
|
|
258
|
+
]);
|
|
259
|
+
|
|
260
|
+
const report = await ga4RunReport(token, env.GA_PROPERTY_ID, {
|
|
261
|
+
dimensions: [{ name: "pagePath" }],
|
|
262
|
+
metrics: [{ name: "screenPageViews" }],
|
|
263
|
+
dateRanges: [{ startDate: "28daysAgo", endDate: "today" }],
|
|
264
|
+
orderBys: [{ metric: { metricName: "screenPageViews" }, desc: true }],
|
|
265
|
+
limit: 10,
|
|
266
|
+
});
|
|
267
|
+
const pages = ga4Rows(report); // [{ pagePath: "/", screenPageViews: 120 }, ...]
|
|
268
|
+
|
|
269
|
+
const queries = await searchConsoleQuery(token, "sc-domain:example.com", {
|
|
270
|
+
startDate: "2026-10-20",
|
|
271
|
+
endDate: "2026-11-17",
|
|
272
|
+
dimensions: ["query"],
|
|
273
|
+
});
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
- An account comes from the key file JSON with `parseServiceAccount`, or from separate vars as `{ clientEmail, privateKey }`. Escaped `\n` in the key is fine. A PKCS#1 key (`BEGIN RSA PRIVATE KEY`) or a value that is not a PEM fails with an error that says so.
|
|
277
|
+
- `googleAccessToken` caches tokens in the isolate per account and scope until five minutes before they expire. Concurrent calls share one exchange, and a failed exchange is not cached. `createGoogleAuth({ fetch, now, marginSeconds })` makes a token source with its own cache, for tests.
|
|
278
|
+
- The API helpers take a token, not an account, so a token from anywhere (such as gcloud impersonation in a script) works too. Each takes `{ fetch, timeoutMs }` (10 seconds by default).
|
|
279
|
+
- `ga4Rows(report)` keys each row by header name, dimensions as strings and metrics as numbers; `{ totals: true }` reads the totals rows. `ga4BatchRunReports` sends up to five reports in one call. `inListFilter(field, values)` builds the common dimension filter.
|
|
280
|
+
- `searchConsoleQuery` fills missing fields with zeros and treats a reply with no `rows` as no rows. `{ all: true }` pages with `startRow` until a short page.
|
|
281
|
+
- A Google error status throws `GoogleApiError` with `status`, Google's message and its JSON `body`.
|
|
282
|
+
|
|
182
283
|
## Sitemap and robots.txt
|
|
183
284
|
|
|
184
285
|
`workers-start/seo` builds the bodies for `/sitemap.xml` and `/robots.txt` routes. The entries and options take the same shape as Next's `MetadataRoute.Sitemap` and `MetadataRoute.Robots`.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A stand-in for a Cloudflare Access team in tests: a key pair made on the
|
|
3
|
+
* spot, a `fetch` that serves its public key at the team's certs URL, and a
|
|
4
|
+
* signer for tokens shaped like the ones Access issues.
|
|
5
|
+
*/
|
|
6
|
+
import type { AccessConfig } from "./access.js";
|
|
7
|
+
export interface TestAccessTeam {
|
|
8
|
+
/** Config for `createAccessVerifier`, with `emails` allowed. */
|
|
9
|
+
config: AccessConfig;
|
|
10
|
+
/** Serves the team's certs; pass it as the verifier's `fetch`. */
|
|
11
|
+
fetch: (url: string) => Promise<Response>;
|
|
12
|
+
/** A signed token for `email`, valid for an hour, with `claims` on top. */
|
|
13
|
+
token: (email: string, claims?: Record<string, unknown>) => Promise<string>;
|
|
14
|
+
/** A signed token for a service token's client id. */
|
|
15
|
+
serviceToken: (clientId: string, claims?: Record<string, unknown>) => Promise<string>;
|
|
16
|
+
/** Signs any claims and header fields with the team's key. */
|
|
17
|
+
sign: (claims: Record<string, unknown>, header?: Record<string, unknown>) => Promise<string>;
|
|
18
|
+
}
|
|
19
|
+
export interface TestAccessTeamOptions {
|
|
20
|
+
teamDomain?: string;
|
|
21
|
+
aud?: string;
|
|
22
|
+
emails?: string[];
|
|
23
|
+
serviceTokens?: string[];
|
|
24
|
+
kid?: string;
|
|
25
|
+
/** Milliseconds since the epoch, for `iat`, `nbf` and `exp`. */
|
|
26
|
+
now?: () => number;
|
|
27
|
+
}
|
|
28
|
+
export declare function createTestAccessTeam(options?: TestAccessTeamOptions): Promise<TestAccessTeam>;
|
|
29
|
+
//# sourceMappingURL=access-testing.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access-testing.d.ts","sourceRoot":"","sources":["../src/access-testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,MAAM,EAAE,YAAY,CAAC;IACrB,kEAAkE;IAClE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,2EAA2E;IAC3E,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,sDAAsD;IACtD,YAAY,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,CACJ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CA0EzB"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
export async function createTestAccessTeam(options = {}) {
|
|
2
|
+
const { teamDomain = "test.cloudflareaccess.com", aud = "test-aud", emails = ["admin@example.com"], serviceTokens = [], kid = "test-key", now = Date.now, } = options;
|
|
3
|
+
const pair = (await crypto.subtle.generateKey({
|
|
4
|
+
name: "RSASSA-PKCS1-v1_5",
|
|
5
|
+
modulusLength: 2048,
|
|
6
|
+
publicExponent: new Uint8Array([1, 0, 1]),
|
|
7
|
+
hash: "SHA-256",
|
|
8
|
+
}, true, ["sign", "verify"]));
|
|
9
|
+
const jwk = {
|
|
10
|
+
...(await crypto.subtle.exportKey("jwk", pair.publicKey)),
|
|
11
|
+
kid,
|
|
12
|
+
alg: "RS256",
|
|
13
|
+
use: "sig",
|
|
14
|
+
};
|
|
15
|
+
const certsUrl = `https://${teamDomain}/cdn-cgi/access/certs`;
|
|
16
|
+
const sign = async (claims, header = {}) => {
|
|
17
|
+
const head = encode(JSON.stringify({ alg: "RS256", kid, ...header }));
|
|
18
|
+
const body = encode(JSON.stringify(claims));
|
|
19
|
+
const sig = await crypto.subtle.sign("RSASSA-PKCS1-v1_5", pair.privateKey, new TextEncoder().encode(`${head}.${body}`));
|
|
20
|
+
return `${head}.${body}.${encode(new Uint8Array(sig))}`;
|
|
21
|
+
};
|
|
22
|
+
const base = () => {
|
|
23
|
+
const iat = Math.floor(now() / 1000);
|
|
24
|
+
return {
|
|
25
|
+
aud: [aud],
|
|
26
|
+
iss: `https://${teamDomain}`,
|
|
27
|
+
iat,
|
|
28
|
+
nbf: iat,
|
|
29
|
+
exp: iat + 3600,
|
|
30
|
+
};
|
|
31
|
+
};
|
|
32
|
+
return {
|
|
33
|
+
config: {
|
|
34
|
+
teamDomain,
|
|
35
|
+
aud,
|
|
36
|
+
emails: emails.map((e) => e.toLowerCase()),
|
|
37
|
+
serviceTokens,
|
|
38
|
+
},
|
|
39
|
+
fetch: async (url) => url === certsUrl
|
|
40
|
+
? Response.json({ keys: [jwk] })
|
|
41
|
+
: new Response("not found", { status: 404 }),
|
|
42
|
+
token: (email, claims = {}) => sign({ ...base(), email, sub: "user-id", type: "app", ...claims }),
|
|
43
|
+
serviceToken: (clientId, claims = {}) => sign({
|
|
44
|
+
...base(),
|
|
45
|
+
sub: "",
|
|
46
|
+
type: "app",
|
|
47
|
+
common_name: clientId,
|
|
48
|
+
...claims,
|
|
49
|
+
}),
|
|
50
|
+
sign,
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
function encode(value) {
|
|
54
|
+
const bytes = typeof value === "string" ? new TextEncoder().encode(value) : value;
|
|
55
|
+
let bin = "";
|
|
56
|
+
for (const b of bytes)
|
|
57
|
+
bin += String.fromCharCode(b);
|
|
58
|
+
return btoa(bin).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=access-testing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access-testing.js","sourceRoot":"","sources":["../src/access-testing.ts"],"names":[],"mappings":"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"}
|
package/dist/access.d.ts
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cloudflare Access sign-ins. Access sits in front of an app (or a path of
|
|
3
|
+
* it) and adds a signed JWT to every request it lets through, as the
|
|
4
|
+
* `Cf-Access-Jwt-Assertion` header and the `CF_Authorization` cookie. The
|
|
5
|
+
* header alone proves nothing, since anyone can send it to the Worker's other
|
|
6
|
+
* hostnames, so this checks the token: RS256 signature against the team's
|
|
7
|
+
* published keys, issuer, audience, `exp` and `nbf`, then the email against an
|
|
8
|
+
* allowlist, or a service token's client id against its own list.
|
|
9
|
+
*
|
|
10
|
+
* WebCrypto only, so it runs in workerd, the browser and Node. Every failure
|
|
11
|
+
* is a result, never a throw, and a missing config refuses everything.
|
|
12
|
+
*/
|
|
13
|
+
export interface AccessConfig {
|
|
14
|
+
/** The team domain without scheme, such as `myteam.cloudflareaccess.com`. */
|
|
15
|
+
teamDomain: string;
|
|
16
|
+
/** The Access application's audience tag. */
|
|
17
|
+
aud: string;
|
|
18
|
+
/** Lowercased addresses allowed in. */
|
|
19
|
+
emails: readonly string[];
|
|
20
|
+
/** Client ids of Access service tokens allowed in. */
|
|
21
|
+
serviceTokens: readonly string[];
|
|
22
|
+
}
|
|
23
|
+
/** Raw config values, as they come from Worker vars or secrets. */
|
|
24
|
+
export interface AccessEnv {
|
|
25
|
+
teamDomain?: string | undefined;
|
|
26
|
+
aud?: string | undefined;
|
|
27
|
+
/** Comma or whitespace separated. */
|
|
28
|
+
emails?: string | undefined;
|
|
29
|
+
/** Comma or whitespace separated service token client ids. */
|
|
30
|
+
serviceTokens?: string | undefined;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* The parsed config, or null when the team domain or audience is missing, or
|
|
34
|
+
* when neither an email nor a service token is allowed. A null config makes
|
|
35
|
+
* every check fail with `unconfigured`.
|
|
36
|
+
*/
|
|
37
|
+
export declare function parseAccessConfig(env: AccessEnv): AccessConfig | null;
|
|
38
|
+
/** The Access token on a request: the header Access adds, else its cookie. */
|
|
39
|
+
export declare function accessToken(request: Request): string | null;
|
|
40
|
+
export type AccessFailure =
|
|
41
|
+
/** No config: 503. */
|
|
42
|
+
"unconfigured"
|
|
43
|
+
/** No token, or one that does not verify: 401. */
|
|
44
|
+
| "unauthenticated"
|
|
45
|
+
/** A valid token for someone not on the list: 403. */
|
|
46
|
+
| "forbidden"
|
|
47
|
+
/** The team's keys could not be fetched: 503. */
|
|
48
|
+
| "unavailable";
|
|
49
|
+
export type AccessResult = {
|
|
50
|
+
ok: true;
|
|
51
|
+
email: string;
|
|
52
|
+
service?: undefined;
|
|
53
|
+
} | {
|
|
54
|
+
ok: true;
|
|
55
|
+
service: string;
|
|
56
|
+
email?: undefined;
|
|
57
|
+
} | {
|
|
58
|
+
ok: false;
|
|
59
|
+
status: 401 | 403 | 503;
|
|
60
|
+
code: AccessFailure;
|
|
61
|
+
reason: string;
|
|
62
|
+
};
|
|
63
|
+
export interface AccessVerifierOptions {
|
|
64
|
+
/** Fetches the certs URL. Defaults to the global `fetch`. */
|
|
65
|
+
fetch?: (url: string, init?: RequestInit) => Promise<Response>;
|
|
66
|
+
/** Milliseconds since the epoch. Defaults to `Date.now`. */
|
|
67
|
+
now?: () => number;
|
|
68
|
+
/** How long fetched keys are trusted. Default one hour. */
|
|
69
|
+
ttlMs?: number;
|
|
70
|
+
/** An unknown key id refetches at most this often. Default one minute. */
|
|
71
|
+
refreshMs?: number;
|
|
72
|
+
/** Timeout on the certs fetch. Default 5 seconds. */
|
|
73
|
+
timeoutMs?: number;
|
|
74
|
+
/** Seconds of clock difference allowed on `exp` and `nbf`. Default 60. */
|
|
75
|
+
leewaySeconds?: number;
|
|
76
|
+
}
|
|
77
|
+
export type AccessVerifier = (token: string | null | undefined, config: AccessConfig | null) => Promise<AccessResult>;
|
|
78
|
+
/**
|
|
79
|
+
* A verifier with its own key cache. Keys are cached per team for `ttlMs`; a
|
|
80
|
+
* token naming a key id the cache lacks refetches at most once per
|
|
81
|
+
* `refreshMs`, so a stream of made-up key ids cannot hammer the certs URL. A
|
|
82
|
+
* failed or empty fetch keeps the keys already held.
|
|
83
|
+
*/
|
|
84
|
+
export declare function createAccessVerifier(options?: AccessVerifierOptions): AccessVerifier;
|
|
85
|
+
/**
|
|
86
|
+
* Checks a token with a verifier shared by the whole isolate, so the team's
|
|
87
|
+
* keys are fetched once per hour, not once per request.
|
|
88
|
+
*/
|
|
89
|
+
export declare function verifyAccessToken(token: string | null | undefined, config: AccessConfig | null): Promise<AccessResult>;
|
|
90
|
+
//# sourceMappingURL=access.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,CAarE;AAKD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO3D;AAED,MAAM,MAAM,aAAa;AACvB,sBAAsB;AACpB,cAAc;AAChB,kDAAkD;GAChD,iBAAiB;AACnB,sDAAsD;GACpD,WAAW;AACb,iDAAiD;GAC/C,aAAa,CAAC;AAElB,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAChD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,MAAM,EAAE,YAAY,GAAG,IAAI,KACxB,OAAO,CAAC,YAAY,CAAC,CAAC;AAmB3B;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,cAAc,CA+IhB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,MAAM,EAAE,YAAY,GAAG,IAAI,GAC1B,OAAO,CAAC,YAAY,CAAC,CAGvB"}
|
package/dist/access.js
ADDED
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cloudflare Access sign-ins. Access sits in front of an app (or a path of
|
|
3
|
+
* it) and adds a signed JWT to every request it lets through, as the
|
|
4
|
+
* `Cf-Access-Jwt-Assertion` header and the `CF_Authorization` cookie. The
|
|
5
|
+
* header alone proves nothing, since anyone can send it to the Worker's other
|
|
6
|
+
* hostnames, so this checks the token: RS256 signature against the team's
|
|
7
|
+
* published keys, issuer, audience, `exp` and `nbf`, then the email against an
|
|
8
|
+
* allowlist, or a service token's client id against its own list.
|
|
9
|
+
*
|
|
10
|
+
* WebCrypto only, so it runs in workerd, the browser and Node. Every failure
|
|
11
|
+
* is a result, never a throw, and a missing config refuses everything.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* The parsed config, or null when the team domain or audience is missing, or
|
|
15
|
+
* when neither an email nor a service token is allowed. A null config makes
|
|
16
|
+
* every check fail with `unconfigured`.
|
|
17
|
+
*/
|
|
18
|
+
export function parseAccessConfig(env) {
|
|
19
|
+
const teamDomain = (env.teamDomain ?? "")
|
|
20
|
+
.trim()
|
|
21
|
+
.replace(/^https?:\/\//, "")
|
|
22
|
+
.replace(/\/+$/, "");
|
|
23
|
+
const aud = (env.aud ?? "").trim();
|
|
24
|
+
const emails = list(env.emails)
|
|
25
|
+
.map((e) => e.toLowerCase())
|
|
26
|
+
.filter((e) => e.includes("@"));
|
|
27
|
+
const serviceTokens = list(env.serviceTokens);
|
|
28
|
+
if (!teamDomain || !aud)
|
|
29
|
+
return null;
|
|
30
|
+
if (emails.length === 0 && serviceTokens.length === 0)
|
|
31
|
+
return null;
|
|
32
|
+
return { teamDomain, aud, emails, serviceTokens };
|
|
33
|
+
}
|
|
34
|
+
const list = (value) => (value ?? "").split(/[\s,]+/).filter(Boolean);
|
|
35
|
+
/** The Access token on a request: the header Access adds, else its cookie. */
|
|
36
|
+
export function accessToken(request) {
|
|
37
|
+
const header = request.headers.get("cf-access-jwt-assertion");
|
|
38
|
+
if (header)
|
|
39
|
+
return header;
|
|
40
|
+
const cookie = /(?:^|;\s*)CF_Authorization=([^;]+)/.exec(request.headers.get("cookie") ?? "");
|
|
41
|
+
return cookie?.[1] ?? null;
|
|
42
|
+
}
|
|
43
|
+
const RS256 = { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" };
|
|
44
|
+
const deny = (status, code, reason) => ({ ok: false, status, code, reason });
|
|
45
|
+
/**
|
|
46
|
+
* A verifier with its own key cache. Keys are cached per team for `ttlMs`; a
|
|
47
|
+
* token naming a key id the cache lacks refetches at most once per
|
|
48
|
+
* `refreshMs`, so a stream of made-up key ids cannot hammer the certs URL. A
|
|
49
|
+
* failed or empty fetch keeps the keys already held.
|
|
50
|
+
*/
|
|
51
|
+
export function createAccessVerifier(options = {}) {
|
|
52
|
+
const { fetch: fetcher = (url, init) => fetch(url, init), now = Date.now, ttlMs = 60 * 60_000, refreshMs = 60_000, timeoutMs = 5_000, leewaySeconds = 60, } = options;
|
|
53
|
+
const sets = new Map();
|
|
54
|
+
async function refresh(url, set) {
|
|
55
|
+
set.fetchedAt = now();
|
|
56
|
+
set.ok = await load(url, set);
|
|
57
|
+
}
|
|
58
|
+
async function load(url, set) {
|
|
59
|
+
try {
|
|
60
|
+
const res = await fetcher(url, {
|
|
61
|
+
signal: AbortSignal.timeout(timeoutMs),
|
|
62
|
+
});
|
|
63
|
+
if (!res.ok)
|
|
64
|
+
return false;
|
|
65
|
+
const body = (await res.json());
|
|
66
|
+
const next = new Map();
|
|
67
|
+
for (const jwk of Array.isArray(body.keys) ? body.keys : []) {
|
|
68
|
+
const { kid, kty } = (jwk ?? {});
|
|
69
|
+
if (typeof kid !== "string" || kty !== "RSA")
|
|
70
|
+
continue;
|
|
71
|
+
try {
|
|
72
|
+
next.set(kid, await crypto.subtle.importKey("jwk", jwk, RS256, false, ["verify"]));
|
|
73
|
+
}
|
|
74
|
+
catch {
|
|
75
|
+
// A key that will not import is skipped; the others still work.
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
if (next.size === 0)
|
|
79
|
+
return false;
|
|
80
|
+
set.keys = next;
|
|
81
|
+
return true;
|
|
82
|
+
}
|
|
83
|
+
catch {
|
|
84
|
+
return false;
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
/** The key for `kid`, null when the team has none, or "unavailable". */
|
|
88
|
+
async function key(teamDomain, kid) {
|
|
89
|
+
const url = `https://${teamDomain}/cdn-cgi/access/certs`;
|
|
90
|
+
let set = sets.get(url);
|
|
91
|
+
if (!set) {
|
|
92
|
+
set = {
|
|
93
|
+
keys: new Map(),
|
|
94
|
+
fetchedAt: Number.NEGATIVE_INFINITY,
|
|
95
|
+
ok: false,
|
|
96
|
+
};
|
|
97
|
+
sets.set(url, set);
|
|
98
|
+
}
|
|
99
|
+
if (set.refreshing)
|
|
100
|
+
await set.refreshing;
|
|
101
|
+
const age = now() - set.fetchedAt;
|
|
102
|
+
if (age <= ttlMs && set.keys.has(kid))
|
|
103
|
+
return set.keys.get(kid) ?? null;
|
|
104
|
+
if (age > refreshMs) {
|
|
105
|
+
const current = set;
|
|
106
|
+
current.refreshing ??= refresh(url, current).finally(() => {
|
|
107
|
+
current.refreshing = undefined;
|
|
108
|
+
});
|
|
109
|
+
await current.refreshing;
|
|
110
|
+
}
|
|
111
|
+
const found = set.keys.get(kid);
|
|
112
|
+
if (found)
|
|
113
|
+
return found;
|
|
114
|
+
return !set.ok && set.keys.size === 0 ? "unavailable" : null;
|
|
115
|
+
}
|
|
116
|
+
return async (token, config) => {
|
|
117
|
+
if (!config)
|
|
118
|
+
return deny(503, "unconfigured", "Access is not configured.");
|
|
119
|
+
if (!token)
|
|
120
|
+
return deny(401, "unauthenticated", "No Access token.");
|
|
121
|
+
const parts = token.split(".");
|
|
122
|
+
if (parts.length !== 3)
|
|
123
|
+
return deny(401, "unauthenticated", "Malformed token.");
|
|
124
|
+
const [head, body, signature] = parts;
|
|
125
|
+
const header = decodeJson(head);
|
|
126
|
+
const claims = decodeJson(body);
|
|
127
|
+
if (!header || !claims)
|
|
128
|
+
return deny(401, "unauthenticated", "Malformed token.");
|
|
129
|
+
if (header.alg !== "RS256")
|
|
130
|
+
return deny(401, "unauthenticated", "Unexpected algorithm.");
|
|
131
|
+
if (typeof header.kid !== "string" || !header.kid)
|
|
132
|
+
return deny(401, "unauthenticated", "Token has no key id.");
|
|
133
|
+
const found = await key(config.teamDomain, header.kid);
|
|
134
|
+
if (found === "unavailable")
|
|
135
|
+
return deny(503, "unavailable", "Could not load the Access keys.");
|
|
136
|
+
if (!found)
|
|
137
|
+
return deny(401, "unauthenticated", "Unknown signing key.");
|
|
138
|
+
let valid = false;
|
|
139
|
+
try {
|
|
140
|
+
const sig = base64UrlDecode(signature);
|
|
141
|
+
valid =
|
|
142
|
+
sig !== null &&
|
|
143
|
+
(await crypto.subtle.verify(RS256, found, sig, new TextEncoder().encode(`${head}.${body}`)));
|
|
144
|
+
}
|
|
145
|
+
catch {
|
|
146
|
+
valid = false;
|
|
147
|
+
}
|
|
148
|
+
if (!valid)
|
|
149
|
+
return deny(401, "unauthenticated", "Bad signature.");
|
|
150
|
+
if (claims.iss !== `https://${config.teamDomain}`)
|
|
151
|
+
return deny(401, "unauthenticated", "Wrong issuer.");
|
|
152
|
+
const aud = Array.isArray(claims.aud) ? claims.aud : [claims.aud];
|
|
153
|
+
if (!aud.includes(config.aud))
|
|
154
|
+
return deny(401, "unauthenticated", "Wrong audience.");
|
|
155
|
+
const nowS = now() / 1000;
|
|
156
|
+
if (typeof claims.exp !== "number" || claims.exp + leewaySeconds < nowS)
|
|
157
|
+
return deny(401, "unauthenticated", "Token expired.");
|
|
158
|
+
if (typeof claims.nbf === "number" && claims.nbf - leewaySeconds > nowS)
|
|
159
|
+
return deny(401, "unauthenticated", "Token not valid yet.");
|
|
160
|
+
if (typeof claims.email === "string" && claims.email.includes("@")) {
|
|
161
|
+
const email = claims.email.trim().toLowerCase();
|
|
162
|
+
return config.emails.includes(email)
|
|
163
|
+
? { ok: true, email }
|
|
164
|
+
: deny(403, "forbidden", "This account is not on the allowed list.");
|
|
165
|
+
}
|
|
166
|
+
// A service token's sign-in: an app token for nobody, named by client id.
|
|
167
|
+
// A client certificate's sign-in also has a name and no email, so the
|
|
168
|
+
// name alone is not enough.
|
|
169
|
+
const service = claims.type === "app" &&
|
|
170
|
+
claims.sub === "" &&
|
|
171
|
+
claims.email === undefined &&
|
|
172
|
+
typeof claims.common_name === "string"
|
|
173
|
+
? claims.common_name
|
|
174
|
+
: null;
|
|
175
|
+
if (service && config.serviceTokens.includes(service))
|
|
176
|
+
return { ok: true, service };
|
|
177
|
+
return deny(403, "forbidden", "This sign-in is not on the allowed list.");
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
let shared;
|
|
181
|
+
/**
|
|
182
|
+
* Checks a token with a verifier shared by the whole isolate, so the team's
|
|
183
|
+
* keys are fetched once per hour, not once per request.
|
|
184
|
+
*/
|
|
185
|
+
export function verifyAccessToken(token, config) {
|
|
186
|
+
shared ??= createAccessVerifier();
|
|
187
|
+
return shared(token, config);
|
|
188
|
+
}
|
|
189
|
+
function base64UrlDecode(part) {
|
|
190
|
+
try {
|
|
191
|
+
const b64 = part.replace(/-/g, "+").replace(/_/g, "/");
|
|
192
|
+
const bin = atob(b64 + "=".repeat((4 - (b64.length % 4)) % 4));
|
|
193
|
+
return Uint8Array.from(bin, (ch) => ch.charCodeAt(0));
|
|
194
|
+
}
|
|
195
|
+
catch {
|
|
196
|
+
return null;
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
function decodeJson(part) {
|
|
200
|
+
const bytes = base64UrlDecode(part);
|
|
201
|
+
if (!bytes)
|
|
202
|
+
return null;
|
|
203
|
+
try {
|
|
204
|
+
const value = JSON.parse(new TextDecoder().decode(bytes));
|
|
205
|
+
return typeof value === "object" && value !== null && !Array.isArray(value)
|
|
206
|
+
? value
|
|
207
|
+
: null;
|
|
208
|
+
}
|
|
209
|
+
catch {
|
|
210
|
+
return null;
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
//# sourceMappingURL=access.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access.js","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"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"}
|