Skip to content

nanocoai/nanoclaw / .claude/skills/add-iron-proxy

add-iron-proxy

Flagged

Install or refresh Iron Proxy and its official Iron Control web console for NanoClaw. Use when selecting the Iron gateway, adding its management UI, configuring credentials and grants, or restoring the proxy, approval bridge, and agent guidance.

FileKindSize
REMOVE.mdmarkdown1.7 KB
SKILL.mdskill md18.4 KB
assets/entrypoint.shscript300 B
assets/managed-proxy.Dockerfileother1.0 KB
conformance/credential-scope-cases.goscript3.0 KB
conformance/credential-scope-cases.jsonconfig28.8 KB
evals/evals.jsonconfig983 B
front-proxy/go.modmanifest443 B
front-proxy/go.summanifest3.2 KB
front-proxy/main.goscript22.6 KB
front-proxy/security_test.goscript29.8 KB
gateway.jsonconfig128 B
payload/src/gateway-providers/iron-proxy-allowlist.tsscript2.9 KB
payload/src/gateway-providers/iron-proxy-approval.test.tsscript14.4 KB
payload/src/gateway-providers/iron-proxy-approval.tsscript12.2 KB
payload/src/gateway-providers/iron-proxy-credential-scope.test.tsscript23.6 KB
payload/src/gateway-providers/iron-proxy-credential-scope.tsscript14.1 KB
payload/src/gateway-providers/iron-proxy-local-model.test.tsscript2.3 KB
payload/src/gateway-providers/iron-proxy-local-model.tsscript1.8 KB
payload/src/gateway-providers/iron-proxy-transform.protoother1.4 KB
payload/src/gateway-providers/iron-proxy.test.tsscript16.5 KB
payload/src/gateway-providers/iron-proxy.tsscript21.5 KB
references/control-plane.mdmarkdown4.8 KB
scripts/allowed-hosts.test.tsscript4.0 KB
scripts/auth-resume.test.tsscript6.2 KB
scripts/auth.test.tsscript2.4 KB
scripts/auth.tsscript7.9 KB
scripts/build-managed-proxy.tsscript4.8 KB
scripts/capture-claude-token.shscript963 B
scripts/control-preflight.tsscript3.8 KB
scripts/control.test.tsscript4.5 KB
scripts/control.tsscript11.7 KB
scripts/credential-isolation.test.tsscript5.6 KB
scripts/credential-isolation.tsscript3.9 KB
scripts/credential-store.test.tsscript9.1 KB
scripts/credential-store.tsscript7.0 KB
scripts/detect.test.tsscript1.6 KB
scripts/detect.tsscript1.4 KB
scripts/install-claude.shexecutablescript1.8 KB
scripts/install-command.test.tsscript5.2 KB
scripts/install-command.tsscript4.8 KB
scripts/local-model.test.tsscript2.7 KB
scripts/provider-credentials.test.tsscript18.3 KB
scripts/provider-credentials.tsscript20.1 KB
scripts/setup.test.tsscript7.9 KB
scripts/setup.tsscript17.1 KB
versions.jsonconfig747 B

references/control-plane.md

View on GitHub
# Official Iron Control

Source of truth for this skill:

- [Iron Control README at the pinned revision](https://github.com/ironsh/iron-control/blob/6fe857654376d67d100400bbd26c31540effb127/README.md)
- [API at the same revision](https://github.com/ironsh/iron-control/blob/6fe857654376d67d100400bbd26c31540effb127/docs/API.md)
- [Console routes](https://github.com/ironsh/iron-control/blob/6fe857654376d67d100400bbd26c31540effb127/config/routes.rb)

The public deployment docs describe the separate console service. The pinned
source controls exact endpoints and available screens: API paths start with
`/api/v1`, and credential assignment uses principals and grants.

## Add an app credential and policy

For GitHub REST access, create a Static Secret in the official Secrets screen.
Use the Control Plane source to store the token encrypted in Iron Control, set
an Authorization header with formatter `Bearer {{ .Value }}`, and scope the
request rules to `api.github.com`, the intended repository paths, and the
needed HTTP methods. For example, `GET` and `/repos/OWNER/REPO/*` provide a
limited reading policy. This does not install a GitHub channel or MCP server.

Copy the secret's `ssr_…` identifier and run the skill's `control.ts grant static`
command. It uses Iron's native API and the local administrator credential file;
no token is passed as a command argument. To permit the destination at the
network boundary, run `setup.ts --allow-host api.github.com`. Refresh preserves
the console, principal, proxy token, and encryption keys.

Inspect Principals → NanoClaw to see its effective credential grants. The
current upstream UI edits secret rules but does not create principals or
grants; setup and the helper use the documented API for those operations.

Google consent apps are supported in OAuth Apps. This is separate from console
SSO. Do not describe it as a Codex or arbitrary app sign-in catalog. Codex uses the shared provider login flow and Iron’s native credential broker,
not an OAuth Apps entry. Its refresh token stays in Iron Control; only the
current access token and account header reach Iron Proxy.

## Verify

1. The console's `/up` endpoint returns HTTP 200 and `/login` shows the official
   Iron login form. Only the configured loopback port is published.
2. The proxy log reports managed mode and a successful initial sync. Its
   registered proxy and principal IDs match `registration.json`.
3. A request with an unknown signed session identity gets HTTP 403.
4. A known session app request waits for NanoClaw approval. Denial, an unavailable
   bridge, and invalid identity do not contact the upstream.
5. After approval, only a matching granted credential is injected. Repeat after
   a control-plane update to verify the local approval prefix still runs.
   Check both approval callbacks contain no headers, bodies, query strings,
   or transform traces; injected credentials must never return to NanoClaw.

Use an isolated local test upstream and a disposable credential for the last
two checks. Do not send test messages or writes to a real app.

## Data and upgrades

`control.env` holds the operator bootstrap and encryption keys; `proxy.env`
holds this proxy's control-plane token; `login.txt` holds operator sign-in
details. Files are mode 0600 inside a mode 0700 directory. Back up these files
and the install-scoped PostgreSQL volume together. Recreating containers does
not recreate keys or the database.

The control-plane image and database image are pinned by digest. The native
proxy build uses unmodified upstream source and is pinned by source commit plus the separate NanoClaw approval-front hash. Do not
replace it with a generic managed-mode image: managed updates would remove
NanoClaw's local identity and approval transforms.

On failure, keep the old proxy running where possible; inspect the isolated
Compose project's logs and fix the reported issue. Do not clear the database,
regenerate encryption keys, or fall back to open egress.

## Model traffic and human approval

Iron forwards default network holds to NanoClaw's shared approval coordinator.
Core uses the active agent provider's declared model domains for automatic
approval, including telemetry and provider-hosted MCP calls. The bridge keeps no
model-host or endpoint exemption list. See [the shared contract](../../../../docs/gateway-seam.md#default-model-traffic-approvals).

Identity verification, the destination allowlist, and Iron credential grants
remain enforced. Other app destinations retain human approval, unless the
operator enables uncredentialed reads: then a payload-free GET or HEAD that no
granted rule's host and methods cover is approved without a card. Rule paths are
not used to narrow that check. Explicit gateway
policy holds must be marked as policy holds and are never covered by the default
model exemption.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall