Auth für Entwickler:innen
DIC trennt welches Produkt ruft von welcher Mensch gemeint ist.
Drei Akteure
| Akteur | Beweis | Typischer Ort |
|---|---|---|
| Browser-User | Session / Bearer | Login deiner App |
| Produkt (Maschine) | X-Service-Secret | Server-Env |
| Viewer auf Maschinen-Call | X-Plexon-User-Id + Secret | BFF nach Session |
Contract-Header:
X-Plexon-Contract-Version: 2026-05-plexon-federation-v3
BFF-Pfad (die meisten Integrationen)
import { buildFederationHeaders, FEDERATION_CONTRACT_VERSION } from '@chbrdk/plexon-federation'
const headers = buildFederationHeaders({
contractVersion: FEDERATION_CONTRACT_VERSION,
serviceSecret: process.env.PLEXON_SERVICE_SECRET!,
userId: dicUserId,
})
Was du nie tun darfst
- Service-Secret in den Browser legen
- Eine „Gott“-User-Id für alle Kund:innen wiederverwenden
- Contract-Header weglassen
| Status | Bedeutung |
|---|---|
| 401 | Auth/Actor fehlt |
| 403 | Authentifiziert, aber nicht erlaubt |
Weiter: Collections und Zugriff · Quickstart