Terminal nicht verfügbar

Was das bedeutet

Der Terminalzugang ist in diesem Deployment nicht eingerichtet: Die Relay-URL oder ihr Signier-Secret fehlt, daher lässt sich kein brauchbares Ticket erzeugen.

Die API antwortet mit 503, statt ein formal korrektes Ticket zurückzugeben, das niemand annehmen würde. Ein ohne Secret signiertes Ticket sieht für einen Client gültig aus und wird am Relay abgelehnt. Das zeigt sich als „der Button funktioniert, aber das Terminal öffnet sich nie“ – viel schwerer zu diagnostizieren als eine ausdrückliche Ablehnung.

Beispiele für detail-Meldungen, die mit diesem Fehler zurückkommen:

• Terminal access is not configured on this deployment.

Was du tun kannst

Auf dem Client gibt es nichts zu wiederholen. In Tarifen, die fremforge hostet, liegt das bei uns: Prüfe status.frem.sh oder schreib an support@frem.sh. In einem selbst gehosteten Deployment müssen die Relay-URL und das Signier-Secret beide vorhanden sein.

Form der Antwort

Alle Fehler der fremforge-API sind RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/terminal-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "..."
}

Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.