swarmvia
Log inGet started

Settings

Introduction

Source Settings cover the source's identity and upstream wiring: name, origins, and custody mode. Open Sources → Settings for a source to edit them.

Custody modes

Pass-through

Your client authenticates to the upstream. swarmvia relays the request (and headers such as Authorization) after admitting a slot. Use X-Swarmvia-Key for the access key. Do not put the access key in Authorization.

Managed

swarmvia attaches an encrypted upstream credential on each proxied request (for example static bearer, basic, API key, OAuth 1.0, OAuth2 client-credentials, or OAuth2 refresh token). Callers authenticate only with an access key.

Origins

Each source pins 1-8 origins. Per request, origin selection is:

  1. X-Swarmvia-Origin if present (must exactly match a configured origin)
  2. Otherwise the longest matching pathPrefix
  3. Otherwise the first origin without a path prefix
  4. Otherwise 400. Send X-Swarmvia-Origin

Managed sources never call hosts outside the pinned set.

Next steps