Skip to content

Commit 8a1e1b0

Browse files
committed
docs(mission-control): show new chatty enroll output in Chapter 5
The Python QA agent's Day 0 report flagged 'aster enroll' as the first painful moment in the walkthrough. The CLI now prints a rich explanatory summary by default; the guide shows that output inline so users know what the credential file is and how to use it. Added: - Sample output block from `aster enroll node` - Tip callout explaining the [node] + [[peers]] TOML structure - Note about the new --quiet/-q flag for scripts/CI
1 parent 48d2447 commit 8a1e1b0

1 file changed

Lines changed: 53 additions & 2 deletions

File tree

docs/quickstart/mission-control.mdx

Lines changed: 53 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -848,14 +848,65 @@ await server.serve();
848848
# Edge agent — status and ingest only
849849
aster enroll node --role consumer --name "edge-node-7" \
850850
--capabilities ops.status,ops.ingest \
851-
--root-key ~/.aster/root.key
851+
--root-key ~/.aster/root.key \
852+
--out edge-node-7.cred
853+
```
854+
855+
`aster enroll node` will print a summary like this:
856+
857+
```
858+
✓ Enrollment credential created
859+
860+
File: /home/you/work/edge-node-7.cred
861+
Format: TOML (.aster-identity) with [node] + [[peers]] sections
862+
863+
Peer: edge-node-7
864+
Role: consumer (policy)
865+
Capabilities: ops.status,ops.ingest
866+
Endpoint ID: 142179f10b7bc606...
867+
Trust root: cd948e4c1456cdbe...
868+
Expires: 2026-05-10T20:20:12+00:00
869+
870+
This file lets a consumer connect to your trusted-mode servers.
871+
It contains a node identity (secret key) AND a signed enrollment
872+
credential. The server validates the credential and grants the
873+
capabilities listed below.
874+
875+
Use it:
876+
aster shell <peer-addr> --rcan edge-node-7.cred
877+
aster call <peer-addr> Service.method '<json>' --rcan edge-node-7.cred
852878
879+
⚠ Keep this file secret -- it is both an identity AND a credential.
880+
```
881+
882+
:::tip What's in the file?
883+
Despite the `.cred` extension, it's a regular `.aster-identity` TOML
884+
file with two sections:
885+
886+
- **`[node]`** — the consumer's secret key + endpoint ID. Used by
887+
the QUIC layer to prove the consumer's identity.
888+
- **`[[peers]]`** — the signed enrollment credential. Presented to
889+
servers to claim capabilities.
890+
891+
Both sections live in the same file because they're paired: the
892+
server checks that the QUIC peer ID matches the credential's
893+
`endpoint_id`. If they don't match, admission fails.
894+
:::
895+
896+
```bash
853897
# Operator — full access including admin
854898
aster enroll node --role consumer --name "ops-team" \
855899
--capabilities ops.status,ops.logs,ops.admin,ops.ingest \
856-
--root-key ~/.aster/root.key
900+
--root-key ~/.aster/root.key \
901+
--out ops-team.cred
857902
```
858903

904+
:::note Quiet mode for scripts
905+
Pass `--quiet` (or `-q`) to suppress the educational output. The
906+
command prints exactly one line: `<path> <endpoint_id> <expires_iso>`
907+
on success and exits non-zero on failure. Easy to parse from CI.
908+
:::
909+
859910
### Step 5: Connect with credentials
860911

861912
<LanguageTabs>

0 commit comments

Comments
 (0)