Rediacc kann vollständig auf eigener Infrastruktur betrieben werden. Das Standalone-Docker-Image enthält den Account-Server, das Webportal, die Marketing-Website und den CLI-Distributionsendpunkt. Externe Abhängigkeiten von Rediacccs gehosteten Diensten sind nicht erforderlich.
Installation mit rdc
rdc server install installiert den Account-Server als Repository auf einer Maschine, die die CLI per SSH erreicht. Ein Befehl deckt Maschinenprüfung, renet-Einrichtung, DNS, TLS, Schlüsselerzeugung, Lizenzierung, Start und das Owner-Konto ab. Jeder Wert hat ein Flag. Auf einem Terminal wird ein fehlender Wert abgefragt; mit --yes wird nichts abgefragt und ein fehlender Wert abgelehnt. Jeder Schritt wird festgehalten, ein erneuter Lauf überspringt daher, was schon erledigt ist.
Die Schritte in Reihenfolge: preflight (sudo ohne Passwort, Architektur, Ports 80 und 443, Speicherplatz, Zeitabweichung), setup (rdc machine setup, nur wenn renet fehlt), dns, tls, repo, keys, licence, image, up und owner.
Zuerst vorhandene Maschinen
Die Installation zielt auf eine bereits vorhandene Maschine: einen Server im Rechenzentrum oder ein Gerät im LAN. Eine konfigurierte Maschine wird als Argument genannt. Eine noch nicht registrierte Maschine wird über ihre Adresse hinzugefügt:
rdc server install --ip 203.0.113.10 --user admin --domain accounts.example.com
rdc server install server-1 --domain accounts.example.com --owner owner@example.com --yes
--port und --name setzen den SSH-Port und den Namen, unter dem die Maschine registriert wird. Eine Cloud-VM wird vorab mit rdc machine provision erstellt; die Installation legt nie eine an.
DNS
Die Installation gibt die A- und AAAA-Einträge für die Server-Domain und die Domain des Backup-Speichers aus (--store-domain, standardmäßig <name>-store.<Rest der Domain>) und wartet, bis beide auf die Maschine zeigen. Es wird nie ein Eintrag in eine Zone geschrieben. --no-dns-wait gibt die Einträge aus und macht weiter, passend für einen LAN-Namen, den ein lokaler Resolver bedient.
TLS
--tls wählt eine von drei Methoden:
| Methode | Voraussetzung | Hinweise |
|---|---|---|
letsencrypt | Ports 80 und 443 aus dem Internet erreichbar | HTTP-01-Challenge. --cert-email erhält Ablaufhinweise; Standard ist der Owner. |
cloudflare | --cf-token | DNS-01-Challenge über ein Cloudflare-API-Token. |
byo | --tls-cert und --tls-key | Ein vorhandenes PEM-Zertifikat für beide Domains. --tls-ca nennt die CA, der die Health-Prüfung vertraut. |
rdc server install lab --domain lab.example.internal --tls byo \
--tls-cert host.crt --tls-key host.key --tls-ca ca.crt \
--licence free --no-dns-wait --yes
Image
Der Image-Schritt zieht standardmäßig ghcr.io/rediacc/server:latest auf der Maschine. --image wählt eine andere Referenz. --image-file überträgt ein mit docker save geschriebenes Tar, und --local-image sichert das --image aus dem lokalen Docker und überträgt es. Beides kommt ohne Registry-Zugriff der Maschine aus.
Lizenzierung und Free-Tarif
--licence auto (Standard) nimmt ein Delegierungszertifikat des angemeldeten Kontos oder startet im Free-Tarif, wenn keines vorliegt. --licence free startet immer im Free-Tarif. Ein Konto, das sich vor Einführung des Installationsbefehls angemeldet hat, braucht erneut rdc subscription login, damit der passende Scope vorhanden ist.
Für eine Maschine ohne Verbindung zum Account-Server übernimmt --cert <file> ein anderswo bezogenes Delegierungszertifikat. Das Zertifikat muss den auf der Maschine erzeugten Schlüssel nennen; üblich ist daher erst eine Installation im Free-Tarif, danach das Zertifikat:
rdc server install server-1 --domain accounts.example.com --licence free --yes
rdc server licence accounts.example.com --cert delegation-cert.json
rdc server licence bringt einen Free-Tarif-Server auf ein Zertifikat des angemeldeten Kontos oder aus --cert. Was der Server prüft, beschreibt Schritt 3 im Lizenzierungsabschnitt weiter unten.
Recovery-Bundle
Alle Schlüssel entstehen auf der Maschine und landen nur in der secrets.env des Repositorys. Auf einem Terminal endet die Installation mit der einmaligen Ausgabe eines Recovery-Bundles: das delegierte Schlüsselpaar, der Account-Config-Server-Schlüssel und die Zugangsdaten des Objektspeichers. Das Bundle wird nie protokolliert und ist nie Teil von --output json. Ohne Terminal wird es nicht ausgegeben, und die Abschlusszeile nennt rdc server backup.
rdc server backup accounts.example.com --out elite-recovery.env
--out schreibt die Datei mit Modus 0600; ohne dieses Flag geht das Bundle auf stdout. --bws-project <id> bei der Installation kopiert die Schlüssel zusätzlich in ein Bitwarden-Secrets-Manager-Projekt, und --rotate ersetzt einen abweichenden gespeicherten Wert. Ohne --bws-project verlassen die Schlüssel den Server nur im Wiederherstellungs-Bundle, das die Installation ausgibt, und in dem, das rdc server backup erzeugt, in der --out-Datei oder auf stdout.
Status
rdc server status accounts.example.com
Der Status zeigt Health, Tarif, Zertifikat und Image des Servers. --machine und --repo nennen das Ziel, wenn das Gerät keinen Installationseintrag für die Domain hat.
Updates
| Komponente | Befehl |
|---|---|
| CLI | rdc update |
| renet auf der Maschine | rdc machine setup <machine> |
| Server-Image und Template | rdc server upgrade <domain> |
rdc server upgrade forkt das Repository als Rücksprungpunkt, legt das neue Image ab, wendet das Template erneut an, wenn das eingebaute neuer ist, und startet neu. Es kennt --image, --image-file und --local-image wie die Installation, sodass eine Air-Gapped-Maschine aus einem gespeicherten Image-Tar aktualisiert wird.
Docker-Image
Das Standalone-Image herunterladen:
docker pull ghcr.io/rediacc/server:stable
Mit Standardeinstellungen starten:
docker run -p 80:80 -p 443:443 ghcr.io/rediacc/server:stable
Das Image stellt Folgendes bereit:
- Account-API unter
/account/api/v1/ - Webportal unter
/account/ - Marketing-Website unter
/ - CLI-Artefakte unter
/releases/ - Renet-Binärdateien unter
/bin/
CLI vom eigenen Server installieren
Die CLI kann direkt vom On-Premise-Server installiert werden. Das Installationsskript erkennt den Update-Kanal automatisch und konfiguriert die CLI so, dass sie den eigenen Server auf Updates prüft.
curl -fsSL https://account.example.com/install.sh | \
REDIACC_SERVER_URL=https://account.example.com bash
Dieser einzelne Befehl:
- Lädt die CLI-Binärdatei vom
/releases/-Endpunkt des Servers herunter - Ruft
/account/api/v1/.well-known/server-infoab, um den Update-Kanal zu ermitteln - Schreibt die Standardkonfiguration (
rediacc.json) mit Ihrer Server-URL, dem Update-Kanal und den Verschlüsselungsschlüsseln unter derenaccount.*-Feldern - Konfiguriert
rdc updateso, dass der eigene Server auf zukünftige Updates geprüft wird
Die Variable REDIACC_CHANNEL wird nicht benötigt. Das Installationsskript liest den Kanal automatisch aus der Serverkonfiguration.
CLI-Konfiguration mit benannten Konfigurationen
Für Umgebungen, in denen sich mehrere Server verbunden werden (On-Premise, Produktion, Edge), isolieren benannte Konfigurationen jede Umgebung voneinander:
# Konfiguration für den On-Premise-Server erstellen
rdc config init myserver --server https://account.example.com
# Mit dieser Konfiguration anmelden
rdc --config myserver subscription login
# Alle Befehle mit --config verwenden den On-Premise-Server
rdc --config myserver machine status prod-1
Jede benannte Konfiguration speichert ihre eigene Account-Server-URL (unter account.*) und ihr eigenes Account-API-Token, das neben der Konfiguration unter api-token-<name>.json abgelegt wird. Das Wechseln der Konfiguration wechselt den gesamten Serverkontext.
Air-Gapped-Umgebungen
Für Umgebungen ohne Internetzugang werden sowohl die Server-URL als auch eine benutzerdefinierte Releases-URL gesetzt:
curl -fsSL https://account.example.com/install.sh | \
REDIACC_SERVER_URL=https://account.example.com \
REDIACC_RELEASES_URL=https://account.example.com/releases \
bash
Die CLI prüft dann account.example.com/releases/cli/stable/manifest.json auf Updates statt des öffentlichen Releases-CDN.
Wenn der Server vollständig offline ist, kann die CLI über npm aus dem mitgelieferten Tarball installiert werden:
npm install -g https://account.example.com/npm/rediacc-cli-latest.tgz
Umgebungsvariablen-Referenz
| Variable | Verwendet von | Zweck |
|---|---|---|
REDIACC_SERVER_URL | Installationsskript | Account-Server-URL. Erkennt Kanal und Verschlüsselungsschlüssel automatisch. |
REDIACC_RELEASES_URL | Installationsskript, CLI-Updater | Benutzerdefinierter Releases-Endpunkt für CLI-Binärdateien. Standard: https://releases.rediacc.com |
REDIACC_CHANNEL | Installationsskript | Update-Kanal überschreiben. Wird automatisch vom Server erkannt, wenn nicht gesetzt. |
REDIACC_ACCOUNT_SERVER | CLI-Laufzeit | Account-Server-URL für alle CLI-Befehle überschreiben. |
REDIACC_UPDATE_CHANNEL | CLI-Laufzeit | Update-Kanal für rdc update überschreiben. |
Serverkonfiguration
Das On-Premise-Docker-Image verwendet dieselbe Variable ENVIRONMENT wie der gehostete Dienst. Sie wird in der Docker-Umgebung oder der Orchestrierungskonfiguration gesetzt:
ENVIRONMENT=production(Standard): Standard-Ressourcenlimits; CLIs, die sich mit diesem Server verbinden, verwenden standardmäßig den stable Update-Kanal. Der Wertnameproductionist eine Legacy-Deploy-Kennung. Sowohlproduction- als auchedge-Modi sind produktionstauglich.ENVIRONMENT=edge: 2X Community-Limits; CLIs verwenden standardmäßig den edge Update-Kanal
Details zu den jeweiligen Umgebungen finden sich unter Release-Kanäle.
Was der Server der CLI mitteilt
Wenn die CLI sich mit dem Server verbindet, ruft sie /.well-known/server-info ab und ermittelt:
- E2E-Verschlüsselung öffentlicher Schlüssel: für Zero-Knowledge-Konfigurationsspeicher
- Minimale CLI-Version: blockiert veraltete CLIs beim Verbinden
- Update-Kanal: teilt der CLI mit, welchen Release-Kanal sie für Updates verwenden soll
- Umgebung: Welches Deploy-Profil der Server ausführt (Standard-Limits vs. Edge-mit-2X-Limits)
Diese automatische Konfiguration bedeutet, dass nur die Server-URL benötigt wird. Alles andere wird automatisch ermittelt.
Lizenzierung für Air-Gapped-Bereitstellungen
Air-Gapped- und selbst gehostete On-Premise-Server stellen Lizenzen lokal aus, mithilfe eines Delegierungszertifikats, das vom vorgelagerten Master-Schlüssel signiert wurde. Das Zertifikat beschränkt den On-Premise-Server auf seine Planlimits und erstellt eine manipulationssichere Kette. Weitere Informationen zum kryptografischen Design (Kettenintegrität, Fork-Erkennung, Prüfweise) finden sich unter Lizenz-Chain & Delegation.
Dieser Abschnitt beschreibt die operative Einrichtung: Schlüssel generieren, Zertifikat anfordern, automatische Erneuerung konfigurieren und den Offline-Erneuerungsablauf (Air-Gapped).
Ein Abonnement, eine On-Premise-Installation
Ein Abonnement darf höchstens ein aktives Delegierungszertifikat gleichzeitig haben. Jede On-Premise-Installation erzwingt Pro-Monat- und Pro-Maschinen-Limits gegen ihr eigenes lokales Ausstellungs-Ledger, sodass mehrere aktive Zertifikate das effektive Kontingent ohne mögliche Abstimmung vervielfachen würden.
Wenn separate Umgebungen benötigt werden (Produktion, Staging, DR, Multi-Region), kaufen Sie ein Abonnement pro Installation. Die Single-Active-Durchsetzung kodifiziert diesen Vertrag: Ein Versuch, ein zweites aktives Zertifikat zu erstellen, gibt 409 DELEGATION_CERT_ALREADY_ACTIVE mit der vorhandenen Zertifikat-ID und Anweisungen zur Erneuerung (bevorzugt, behält die Kette) oder zum Widerrufen und Neuerstellen (setzt die Kette zurück) zurück.
1. Ed25519-Schlüsselpaar für On-Premise generieren
Der On-Premise-Server verwendet ein separates Ed25519-Schlüsselpaar zum Signieren von Lizenzen. Das Delegierungszertifikat des vorgelagerten Systems autorisiert diesen spezifischen öffentlichen Schlüssel.
# Neues Schlüsselpaar generieren
openssl genpkey -algorithm Ed25519 -out onprem-private.pem
openssl pkey -in onprem-private.pem -pubout -out onprem-public.pem
# In base64 konvertieren (das Format, das On-Premise in Umgebungsvariablen erwartet)
ON_PREMISE_PRIVATE_KEY=$(openssl pkey -in onprem-private.pem -outform DER | base64 -w 0)
ON_PREMISE_PUBLIC_KEY=$(openssl pkey -in onprem-private.pem -pubout -outform DER | base64 -w 0)
Den privaten Schlüssel neben anderen Geheimnissen speichern (z. B. als Docker-Secret oder Kubernetes-Secret). Er verlässt den On-Premise-Server nie.
2. Delegierungszertifikat vom vorgelagerten System anfordern
Das Zertifikat kann auf drei Arten vom vorgelagerten Account-Portal angefordert werden:
Variante A: Kundenselbstbedienung (empfohlen). Als Org-Owner oder Admin in das vorgelagerte Portal einloggen und zu /account/delegation-certs navigieren. Auf Neu erstellen klicken, den öffentlichen On-Premise-Schlüssel (base64 SPKI) einfügen, eine Gültigkeit wählen (oder den planmäßigen Standard akzeptieren) und die resultierende .json-Datei herunterladen.
Variante B: Admin (kundenübergreifend). Rediacc-Support oder der vorgelagerte Systemadministrator kann POST /admin/delegation-certs mit denselben Parametern aufrufen.
Variante C: rdc-CLI (geplant). Ein künftiger CLI-Befehl wird den Portal-Ablauf vereinfachen.
Das zurückgegebene .json sieht wie folgt aus:
{
"payload": "eyJ2ZXJzaW9uIjoxLCJzdWJzY3JpcHRpb25JZCI6...",
"signature": "...",
"publicKeyId": "..."
}
Die Gültigkeit des Zertifikats wird durch die Gültigkeitsrichtlinie bestimmt (planmäßige Standards und Obergrenzen, abonnementbezogene Überschreibung, gedeckelt auf Abonnementende plus 3 Tage Nachfrist). Die Antwort enthält auch effectiveDays und reason, damit der Wert nachvollzogen werden kann. Die vollständigen Regeln finden sich unter Lizenz-Chain - Gültigkeitsrichtlinie.
3. Zertifikat auf dem On-Premise-Server installieren
Der Server liest sein Delegationszertifikat aus einer einzigen Datei auf seinem Datenvolume, /data/delegation-cert.json (DELEGATION_CERT_PATH benennt ihn). Keine Umgebungsvariable enthält das Zertifikat selbst. rdc server install legt das heruntergeladene Zertifikat dort ab, und rdc server licence ersetzt es später:
rdc server install <domain> --cert delegation-cert.json
rdc server licence <domain> --cert delegation-cert.json
rdc server status <domain>
Beide Befehle übergeben das Zertifikat über den Zertifikat-Posteingang (data/web/cert-inbox/new.json) an den laufenden Server. Der Server prüft es und antwortet mit applied.json oder rejected.json; der Befehl bestätigt die neue Zertifikat-ID mit rdc server status (dieselben cert-status-Daten wie in Schritt 6). rdc server upgrade nutzt denselben Posteingang. Der Server liest DELEGATION_CERT_BASE64 nicht mehr: Ein Upgrade-Schritt verschiebt einen übrig gebliebenen Wert aus secrets.env in den Posteingang, sodass eine vor dem Posteingang installierte Box ihr Zertifikat behält.
Der Server lädt das Zertifikat beim Start und gleicht es mit dem Schlüssel ab, mit dem er Lizenzen signiert: Der Fingerabdruck des Signaturschlüssels muss dem Fingerabdruck des delegatedPublicKey im Zertifikat entsprechen, weil unter einem vom Zertifikat nicht autorisierten Schlüssel signierte Lizenzen auf keiner Maschine validierbar wären. Signaturschlüsselpaar und delegatedPublicKey des Zertifikats müssen übereinstimmen.
Ein Zertifikat, das der Server beim Start ablehnt (ungültige Signatur, falscher Schlüssel, fehlender UPSTREAM_PUBLIC_KEY oder fehlerhafte Datei), stoppt ihn nicht. Der Server startet im Free-Tarif und verschiebt die fehlerhafte Datei nach delegation-cert.rejected.json neben dem Original. Die Repo-Lizenzsignierung antwortet mit 503 DELEGATION_CERT_REFUSED, bis ein gültiges Zertifikat vorliegt, und rdc server status zeigt cert REFUSED (reason). Mit rdc server licence und einem gültigen Zertifikat lässt sich das beheben. Ein abgelaufenes Zertifikat wird weiterhin geladen: Es wird weich herabgestuft statt abgelehnt.
4. Vorgelagerte Verifizierung und automatische Erneuerung konfigurieren (optional, aber empfohlen)
Wenn der On-Premise-Server ausgehenden HTTPS-Zugriff auf das vorgelagerte System hat, kann die automatische Erneuerung eingerichtet werden, sodass das Zertifikat vor dem Ablauf ohne manuellen Eingriff erneuert wird:
# Erforderlich für /onprem/cert-upload, um hochgeladene Zertifikate gegen den vorgelagerten Master-Schlüssel zu verifizieren.
# Schlägt beim Start fehl, wenn UPSTREAM_API_KEY ohne diesen Wert gesetzt ist.
UPSTREAM_PUBLIC_KEY="<upstream master Ed25519 SPKI public key, base64>"
# Erforderlich für die automatische Erneuerungsschleife. Über das Portal erstellen:
# Org-Owner/Admin -> /account/delegation-certs -> "Auto-Renew-Token abrufen"
# Dies ist die EINZIGE Möglichkeit, einen delegation:renew-bezogenen API-Token zu erhalten.
UPSTREAM_URL="https://www.rediacc.com"
UPSTREAM_API_KEY="rdt_..."
# Optionale Anpassung (Standardwerte angezeigt).
AUTO_RENEW_INTERVAL_HOURS=24
RENEW_THRESHOLD_DAYS=14
Die automatische Erneuerungsschleife des On-Premise-Servers läuft einmal beim Start und dann im konfigurierten Intervall. Sie verwendet einen adaptiven Schwellenwert (min(env.RENEW_THRESHOLD_DAYS, ceil(certValidityDays / 3))), sodass ein 15-tägiges COMMUNITY-Zertifikat bei 5 verbleibenden Tagen erneuert wird, anstatt die Erneuerung am ersten Tag auszulösen. Ein 90-tägiges BUSINESS-Zertifikat wird bei 14 verbleibenden Tagen erneuert (die konfigurierte Obergrenze).
Wenn die Erneuerung fehlschlägt, bleibt das Zertifikat bis zum natürlichen Ablauf in Verwendung. Der Fehler wird nach 1 Stunde wiederholt und in ${DELEGATION_CERT_PATH}.status.json aufgezeichnet sowie über GET /onprem/cert-status bereitgestellt.
5. Air-Gapped-Erneuerung (kein ausgehender HTTPS)
Wenn der On-Premise-Server das vorgelagerte System nicht erreichen kann, wird der manuelle Übertragungsablauf verwendet:
- Erneuerungsanforderung vom On-Premise-Adminportal herunterladen. Als On-Premise-Systemroot
GET /onprem/renewal-requestaufrufen. Dies gibt ein JSON-Manifest zurück, das den lokalen Kettenkopf, den delegierten öffentlichen Schlüssel und eine manipulationssichere Ed25519-Signatur des privaten On-Premise-Schlüssels enthält. - Das Manifest an das vorgelagerte System übertragen per USB, verschlüsselter E-Mail oder einem anderen Out-of-Band-Kanal. Das Manifest ist klein (einige KB) und enthält keine Geheimnisse.
- Das Manifest beim vorgelagerten System verarbeiten. Org-Owner/Admin öffnet /account/delegation-certs > Erneuerungsanforderung hochladen > wählt die Manifestdatei aus. Das vorgelagerte System verifiziert die Manifestsignatur gegen den
delegatedPublicKeydes aktiven Zertifikats (beweist, dass es von einem Inhaber des privaten On-Premise-Schlüssels stammt), prüft Anti-Replay (Manifeste älter als 7 Tage werden abgelehnt) und stellt dann ein neues Zertifikat aus. - Das neue Zertifikat vom vorgelagerten Portal als
.json-Datei herunterladen. - Das Zertifikat zurück auf den On-Premise-Server übertragen.
- Auf den On-Premise-Server hochladen über das lokale Adminportal (
POST /onprem/cert-upload). Der On-Premise-Server verifiziert das neue Zertifikat gegenUPSTREAM_PUBLIC_KEYund prüft, obgenesisSequencedes Zertifikats noch mit einem Eintrag im lokalen Ausstellungs-Ledger verbunden ist (Sequenzfortschritt während des Transits wird unterstützt - die Kette verlängert sich natürlich).
Diese gesamte Schleife erfordert keinen Netzwerkabgang vom On-Premise-Server.
Manifest-Fehlermodi
| Code | Ursache | Behebung |
|---|---|---|
NO_ACTIVE_CERT | Das vorgelagerte System hat kein aktives Zertifikat für dieses Abonnement | Ein neues Zertifikat über den Erstellungsablauf ausstellen statt zu erneuern |
DELEGATED_KEY_MISMATCH | delegatedPublicKey des Manifests weicht vom aktiven Zertifikat ab | Das Manifest könnte eine Wiederholung von einer anderen On-Prem-Installation sein |
MANIFEST_SIGNATURE_INVALID | Signatur kann nicht gegen den delegierten öffentlichen Schlüssel verifiziert werden | Das Manifest wurde während des Transits manipuliert, oder es wurde auf einer anderen On-Prem-Installation generiert |
MANIFEST_EXPIRED | Manifest ist älter als 7 Tage | Eine neue Erneuerungsanforderung vom On-Premise-Server generieren |
Zertifikat-Upload-Fehlermodi
POST /onprem/cert-upload antwortet bei Erfolg mit {uploaded: true, bootstrap, certId}. Ein abgelehntes Zertifikat liefert {error, code}; error enthält die Details, code ist einer der unten genannten Gründe. Jedes angewendete oder abgelehnte Zertifikat wird protokolliert und per E-Mail an den Eigentümer der Box gesendet.
rdc server licence legt das Zertifikat per SSH im Posteingang der Box (data/web/cert-inbox) ab und liest anschließend applied.json oder rejected.json zurück. Es bestätigt die neue Zertifikats-ID über cert-status. Eine Ablehnung nennt dieselben Gründe, dazu not-a-regular-file und too-large vom Posteingang selbst.
| Code | HTTP | Ursache |
|---|---|---|
malformed | 400 | Der Upload ist kein gültiges Zertifikat |
bad-signature | 400 | Das Zertifikat ist nicht mit dem konfigurierten UPSTREAM_PUBLIC_KEY signiert |
wrong-key | 400 | Das Zertifikat wurde für einen anderen Schlüssel ausgestellt als den dieser On-Premise-Installation |
expired | 400 | Das Zertifikat ist bereits über sein validUntil hinaus abgelaufen |
not-newer | 409 | Das Zertifikat ist nicht neuer als das aktuell gültige |
other-subscription | 409 | Das Zertifikat gehört zu einem anderen Abonnement |
chain-ahead | 409 | genesisSequence des Zertifikats liegt vor dem lokalen Kettenkopf |
chain-fork | 409 | Der Chain-Hash an genesisSequence des Zertifikats stimmt nicht mit dem lokalen Ledger überein |
no-upstream-key | 500 | UPSTREAM_PUBLIC_KEY ist nicht konfiguriert |
write-failed | 500 | Das Zertifikat konnte nicht auf die Festplatte geschrieben werden |
adoption-failed | 500 | Der Server konnte das geschriebene Zertifikat nicht laden |
Prüfen Sie bei bad-signature, ob UPSTREAM_PUBLIC_KEY dem öffentlichen Master-Schlüssel des Upstreams entspricht. Setzen Sie bei no-upstream-key UPSTREAM_PUBLIC_KEY.
6. Status und Monitoring
Den lokalen Zertifikatsstatus des On-Premise-Servers jederzeit abfragen:
curl https://onprem.example.com/account/api/v1/onprem/cert-status \
-H "Cookie: <admin session>"
Gibt subscriptionId, planCode, validUntil, daysUntilExpiry des geladenen Zertifikats zurück, sowie den autoRenew-Block (enabled, lastSuccessAt, lastErrorAt, lastError). Dies in den Monitoring-Stack einbinden, um bei veraltetem lastSuccessAt oder nicht-nullem lastError zu warnen.
Für Backup und Audit kann der On-Premise-Admin das aktuell geladene signierte Zertifikat auch über GET /onprem/cert-current herunterladen (erhöhte Sitzung erforderlich).
Delegierungszertifikat-Umgebungsvariablen-Referenz
| Variable | Erforderlich? | Zweck |
|---|---|---|
ON_PREMISE_MODE | Ja | Auf true setzen, um die On-Premise-Route-Teilmenge zu aktivieren |
ON_PREMISE_PRIVATE_KEY | Ja | Base64 PKCS8 Ed25519-Privatschlüssel für delegiertes Signieren |
ON_PREMISE_PUBLIC_KEY | Ja | Base64 SPKI Ed25519-Öffentlichschlüssel (muss mit delegatedPublicKey des Zertifikats übereinstimmen) |
DELEGATION_CERT_PATH | Optional | Dateisystempfad zur signierten Zertifikat-JSON-Datei. Standard /data/delegation-cert.json auf dem Datenvolume. Das Zertifikat mit rdc server licence ersetzen, nicht von Hand. |
UPSTREAM_PUBLIC_KEY | Erforderlich, wenn UPSTREAM_API_KEY gesetzt ist, oder damit /onprem/cert-upload funktioniert | Base64 SPKI des vorgelagerten Master-Public-Keys. Fehlt er, lehnt der Server beim Start jedes Zertifikat ab (no-upstream-key) und läuft im kostenlosen Tarif, wie Schritt 3 beschreibt. |
UPSTREAM_URL | Für automatische Erneuerung | Basis-URL des vorgelagerten Account-Servers, z. B. https://www.rediacc.com |
UPSTREAM_API_KEY | Für automatische Erneuerung | Ein delegation:renew-bezogener API-Token. Über das Portal erstellen - siehe Schritt 4. |
AUTO_RENEW_INTERVAL_HOURS | Optional | Standard 24. Wie oft geprüft wird, ob das Zertifikat erneuert werden muss. |
RENEW_THRESHOLD_DAYS | Optional | Standard 14. Dient als Obergrenze für den adaptiven 1/3-der-Gültigkeitsschwellenwert. |
Zusammenfassung des Bedrohungsmodells
Das Delegierungszertifikat-Modell schützt vor:
- Gefälschten Lizenzen: Der On-Premise-Server kann nur innerhalb seiner Planlimits signieren; renet lehnt alles ab, was außerhalb der Zertifikatsgrenzen liegt.
- Zertifikatsfreigabe zwischen Bereitstellungen: Kettenabweichung wird bei der Erneuerung erkannt (gibt
CHAIN_FORK_DETECTEDzurück). - Kontingentumgehung durch Multi-Installation: Wird vom vorgelagerten System durch Single-Active durchgesetzt (ein Zertifikat pro Abonnement).
- Ketten-Rollback: renet speichert die höchste gesehene Sequenz pro Abonnement und lehnt alle Blobs mit einer niedrigeren Sequenz ab.
- Kompromittierte vorgelagerte Anmeldeinformationen: Das Bootstrap-Token
delegation:renewkann nur über den dedizierten Portalendpunkt erstellt werden und ist admin-gesichert. Das Token gewährt nur Erneuerung - es kann keine anderen Ressourcen lesen oder anderweitig verändern. - Replay-Angriffe auf Manifeste: Manifeste älter als 7 Tage werden abgelehnt.
Was es nicht schützt:
- Kompromittierter privater On-Premise-Schlüssel: Ein geleakter privater Schlüssel ermöglicht es einem Angreifer, Lizenzen bis zum
validUntildes Zertifikats zu signieren. Abhilfe: Das Schlüsselpaar rotieren (altes Zertifikat widerrufen und neues mit neuem Schlüssel erstellen) und alle vom alten Schlüssel signierten Lizenzen als verdächtig behandeln. - Kompromittierter vorgelagerter Master-Schlüssel: Dies ist der Vertrauensanker. Rotationsverfahren sind hier nicht behandelt.