flfeders
d18ba16f8a
All checks were successful
Build and Push Docker Images / build-backend (push) Successful in 26s
Build and Push Docker Images / build-frontend (push) Successful in 16s
Build and Push Docker Images / build-website (push) Successful in 16s
Build and Push Docker Images / build-central-services-api (push) Successful in 21s
Build and Push Docker Images / build-central-services-admin (push) Successful in 41s
Build and Push Docker Images / build-docs (push) Successful in 16s
42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# Selfhost-Instanz an FEDEO Central Services anbinden
|
|
|
|
1. Instanz im Admin-Dashboard anlegen.
|
|
2. `instanceId` und den einmalig angezeigten `clientSecret` in der Selfhost-Instanz speichern.
|
|
3. Im Instanzdetail die benötigten Dienste `ai` und/oder `banking` freischalten und Limits festlegen.
|
|
4. Selfhost-Instanz sendet regelmäßig `POST /v1/instances/heartbeat`.
|
|
5. Geräte werden über `POST /v1/devices` registriert; weitere Dienste liegen unter `/v1/services`.
|
|
|
|
## Umgebungsvariablen der Selfhost-Instanz
|
|
|
|
```env
|
|
FEDEO_CENTRAL_SERVICES_ENABLED=true
|
|
PUSH_SERVER_URL=https://services.fedeo.de
|
|
PUSH_SERVER_INSTANCE_ID=inst_...
|
|
PUSH_SERVER_SECRET=fps_...
|
|
FEDEO_CENTRAL_HEARTBEAT_INTERVAL_MS=300000
|
|
```
|
|
|
|
Das Selfhost-Backend sendet direkt beim Start und anschließend standardmäßig alle fünf Minuten einen signierten Heartbeat. Im Backend-Log erscheinen erfolgreiche Meldungen als `Central Services Heartbeat: inst_... (active)`; Verbindungs-, Signatur- oder Freischaltungsfehler werden mit ihrer zentralen Fehlermeldung protokolliert. Werte unter 30 Sekunden werden aus Sicherheitsgründen ignoriert.
|
|
|
|
Wenn `FEDEO_CENTRAL_SERVICES_ENABLED=false` bleibt, verwendet FEDEO wie bisher direkt konfigurierte OpenAI- und GoCardless-Zugangsdaten. Damit bleibt ein vollständig unabhängiger Betrieb möglich.
|
|
|
|
## Minimaler Push-Auftrag
|
|
|
|
```json
|
|
{
|
|
"idempotencyKey": "notification-item-id:dev_...",
|
|
"devices": ["dev_..."],
|
|
"priority": "normal",
|
|
"ttlSeconds": 3600,
|
|
"collapseKey": "communication.message.new",
|
|
"notification": {
|
|
"title": "Neue FEDEO-Benachrichtigung",
|
|
"body": "Öffne FEDEO, um die Details anzusehen."
|
|
},
|
|
"data": {
|
|
"notificationId": "lokale-notification-id",
|
|
"link": "/communication"
|
|
}
|
|
}
|
|
```
|