Skip to content

Document relay authentication#59

Merged
okdistribute merged 3 commits into
mainfrom
rae/relay-authentication
Jun 4, 2026
Merged

Document relay authentication#59
okdistribute merged 3 commits into
mainfrom
rae/relay-authentication

Conversation

@okdistribute
Copy link
Copy Markdown
Contributor

Relays from Iroh Services now require authentication by default: only a project's own endpoints can connect, using a short-lived token the iroh_services::preset() builder mints from the project's API key.

  • concepts/relays: add an Authentication section explaining how it works (allow-set, per-endpoint token, live revocation, on/off toggle)
  • managed: authenticated-by-default framing + "Turn authentication off" section with dashboard screenshot
  • access: API keys now also authorize dedicated relay connections
  • add new authenticated preset config snippet; use it in add-a-relay and managed
  • reword public/private as authentication on/off (a relay with auth off is not discoverable)

Relays from Iroh Services now require authentication by default: only a
project's own endpoints can connect, using a short-lived token the
iroh_services::preset() builder mints from the project's API key.

- concepts/relays: add an Authentication section explaining how it works
  (allow-set, per-endpoint token, live revocation, on/off toggle)
- managed: authenticated-by-default framing + "Turn authentication off"
  section with dashboard screenshot
- access: API keys now also authorize dedicated relay connections
- add new authenticated preset config snippet; use it in add-a-relay and
  managed
- reword public/private as authentication on/off (a relay with auth off
  is not discoverable)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown

mintlify Bot commented Jun 4, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
number0 🟢 Ready View Preview Jun 4, 2026, 8:16 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

okdistribute and others added 2 commits June 4, 2026 13:17
The preset config flow uses the iroh-services crate, so show installing
it before the example.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread add-a-relay.mdx
<RelayEndpointConfig />
<RelayPresetConfig />

Relays you self-host outside of Iroh Services are configured directly with `RelayMode::Custom`; see [Dedicated Infrastructure](/deployment/dedicated-infrastructure).
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

probably should link to the rust doc instead

@okdistribute okdistribute merged commit 07ea25f into main Jun 4, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants