fastpass-cli 0.1.0 → 0.1.1
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/README.md +17 -17
- package/package.json +2 -2
- package/skill/fastpass-skill.md +8 -8
- package/src/cli.js +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# fastpass
|
|
2
2
|
|
|
3
|
-
Cloudflare Access in 60 seconds.
|
|
3
|
+
Cloudflare Access in 60 seconds.
|
|
4
4
|
|
|
5
5
|
## What you want → What it does
|
|
6
6
|
|
|
@@ -16,7 +16,7 @@ Cloudflare Access in 60 seconds. No enterprise jargon.
|
|
|
16
16
|
## Quickstart
|
|
17
17
|
|
|
18
18
|
```sh
|
|
19
|
-
npx fastpass
|
|
19
|
+
npx fastpass-cli
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
That's it. The interactive wizard walks you through everything.
|
|
@@ -25,40 +25,40 @@ That's it. The interactive wizard walks you through everything.
|
|
|
25
25
|
|
|
26
26
|
```sh
|
|
27
27
|
# Protect with email login (zero config)
|
|
28
|
-
npx fastpass protect staging.myapp.com --auth email --allow "me@gmail.com"
|
|
28
|
+
npx fastpass-cli protect staging.myapp.com --auth email --allow "me@gmail.com"
|
|
29
29
|
|
|
30
30
|
# Protect with GitHub login, allow anyone at your company
|
|
31
|
-
npx fastpass protect staging.myapp.com --auth github --allow "*@company.com"
|
|
31
|
+
npx fastpass-cli protect staging.myapp.com --auth github --allow "*@company.com"
|
|
32
32
|
|
|
33
33
|
# Protect with GitHub login, restrict to a GitHub org
|
|
34
|
-
npx fastpass protect staging.myapp.com --auth github --allow "org:my-github-org"
|
|
34
|
+
npx fastpass-cli protect staging.myapp.com --auth github --allow "org:my-github-org"
|
|
35
35
|
|
|
36
36
|
# Protect with Google login, allow everyone (just require login)
|
|
37
|
-
npx fastpass protect admin.myapp.com --auth google --allow "everyone"
|
|
37
|
+
npx fastpass-cli protect admin.myapp.com --auth google --allow "everyone"
|
|
38
38
|
|
|
39
39
|
# List protected domains
|
|
40
|
-
npx fastpass list
|
|
40
|
+
npx fastpass-cli list
|
|
41
41
|
|
|
42
42
|
# Remove protection
|
|
43
|
-
npx fastpass remove staging.myapp.com
|
|
43
|
+
npx fastpass-cli remove staging.myapp.com
|
|
44
44
|
|
|
45
45
|
# Overview dashboard — team, apps, IdPs, recent activity
|
|
46
|
-
npx fastpass status
|
|
46
|
+
npx fastpass-cli status
|
|
47
47
|
|
|
48
48
|
# Recent access events (last 25)
|
|
49
|
-
npx fastpass logs
|
|
49
|
+
npx fastpass-cli logs
|
|
50
50
|
|
|
51
51
|
# Filter events to one domain, last 10
|
|
52
|
-
npx fastpass logs staging.myapp.com --limit 10
|
|
52
|
+
npx fastpass-cli logs staging.myapp.com --limit 10
|
|
53
53
|
|
|
54
54
|
# Events since a specific date
|
|
55
|
-
npx fastpass logs --since 2025-01-15
|
|
55
|
+
npx fastpass-cli logs --since 2025-01-15
|
|
56
56
|
|
|
57
57
|
# Detailed config for a specific app
|
|
58
|
-
npx fastpass inspect staging.myapp.com
|
|
58
|
+
npx fastpass-cli inspect staging.myapp.com
|
|
59
59
|
|
|
60
60
|
# Interactive app picker
|
|
61
|
-
npx fastpass inspect
|
|
61
|
+
npx fastpass-cli inspect
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
## Prerequisites
|
|
@@ -98,7 +98,7 @@ If you already use wrangler:
|
|
|
98
98
|
|
|
99
99
|
```sh
|
|
100
100
|
npx wrangler login
|
|
101
|
-
npx fastpass
|
|
101
|
+
npx fastpass-cli
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
> **Note:** Wrangler's default OAuth token does not include Access scopes. If you use `wrangler login` for deploying Workers but get permission errors from fastpass, you'll need a dedicated API token (Option A). The wrangler OAuth scopes cover Workers, KV, D1, Pages, etc. — but not Cloudflare Access.
|
|
@@ -128,7 +128,7 @@ Under the hood, fastpass calls the Cloudflare API to:
|
|
|
128
128
|
3. **Create an Access Application** on your domain with an allow policy
|
|
129
129
|
4. Your domain now shows a login page before granting access
|
|
130
130
|
|
|
131
|
-
All of this maps to Cloudflare's [Zero Trust Access](https://developers.cloudflare.com/cloudflare-one/policies/access/) product — fastpass just removes the
|
|
131
|
+
All of this maps to Cloudflare's [Zero Trust Access](https://developers.cloudflare.com/cloudflare-one/policies/access/) product — fastpass just removes the complexity.
|
|
132
132
|
|
|
133
133
|
## FAQ
|
|
134
134
|
|
|
@@ -142,7 +142,7 @@ Run `protect` again on the same domain with a different `--auth` flag, or config
|
|
|
142
142
|
fastpass detects existing identity providers and reuses them.
|
|
143
143
|
|
|
144
144
|
**How do I see what's going on?**
|
|
145
|
-
Run `npx fastpass status` for an overview, `npx fastpass logs` for recent events, or `npx fastpass inspect <domain>` for detailed app config.
|
|
145
|
+
Run `npx fastpass-cli status` for an overview, `npx fastpass-cli logs` for recent events, or `npx fastpass-cli inspect <domain>` for detailed app config.
|
|
146
146
|
|
|
147
147
|
**How do I manage users/policies after setup?**
|
|
148
148
|
Use the [Cloudflare Zero Trust dashboard](https://one.dash.cloudflare.com).
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fastpass-cli",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Cloudflare Access in 60 seconds.
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Cloudflare Access in 60 seconds.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"fastpass": "./bin/fastpass.js"
|
package/skill/fastpass-skill.md
CHANGED
|
@@ -22,13 +22,13 @@ You are helping the user set up Cloudflare Access on their domain using the `fas
|
|
|
22
22
|
### Interactive mode
|
|
23
23
|
Run the wizard and let the user answer prompts:
|
|
24
24
|
```bash
|
|
25
|
-
npx fastpass
|
|
25
|
+
npx fastpass-cli
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
### One-liner mode
|
|
29
29
|
If the user has already told you the domain, auth method, and who should have access:
|
|
30
30
|
```bash
|
|
31
|
-
npx fastpass protect <domain> --auth <email|github|google> --allow "<rule>"
|
|
31
|
+
npx fastpass-cli protect <domain> --auth <email|github|google> --allow "<rule>"
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
Allow rules:
|
|
@@ -39,22 +39,22 @@ Allow rules:
|
|
|
39
39
|
|
|
40
40
|
### List protected domains
|
|
41
41
|
```bash
|
|
42
|
-
npx fastpass list
|
|
42
|
+
npx fastpass-cli list
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
### Remove protection
|
|
46
46
|
```bash
|
|
47
|
-
npx fastpass remove <domain>
|
|
47
|
+
npx fastpass-cli remove <domain>
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
### Status dashboard
|
|
51
51
|
```bash
|
|
52
|
-
npx fastpass status
|
|
52
|
+
npx fastpass-cli status
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
### View recent access logs
|
|
56
56
|
```bash
|
|
57
|
-
npx fastpass logs [domain] --limit 25 --since 2025-01-15
|
|
57
|
+
npx fastpass-cli logs [domain] --limit 25 --since 2025-01-15
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
Options:
|
|
@@ -64,7 +64,7 @@ Options:
|
|
|
64
64
|
|
|
65
65
|
### Inspect app configuration
|
|
66
66
|
```bash
|
|
67
|
-
npx fastpass inspect [domain]
|
|
67
|
+
npx fastpass-cli inspect [domain]
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
If no domain is provided, shows an interactive picker. Displays: domain, type, session duration, allowed identity providers (resolved to names), and policy rules translated to plain English.
|
|
@@ -87,6 +87,6 @@ When the user asks to protect a domain, gather these three things:
|
|
|
87
87
|
2. **Auth method** — email (easiest), github, or google
|
|
88
88
|
3. **Access rule** — who should be allowed in
|
|
89
89
|
|
|
90
|
-
Then construct and run the appropriate `npx fastpass` command.
|
|
90
|
+
Then construct and run the appropriate `npx fastpass-cli` command.
|
|
91
91
|
|
|
92
92
|
If the user is unsure, recommend **email** auth — it requires zero external setup.
|
package/src/cli.js
CHANGED
|
@@ -14,7 +14,7 @@ export function run() {
|
|
|
14
14
|
|
|
15
15
|
program
|
|
16
16
|
.name('fastpass')
|
|
17
|
-
.description('Cloudflare Access in 60 seconds.
|
|
17
|
+
.description('Cloudflare Access in 60 seconds.')
|
|
18
18
|
.version('0.1.0');
|
|
19
19
|
|
|
20
20
|
// Default action (no subcommand) — run the protect wizard
|