Terminal niet beschikbaar

Wat het betekent

Terminaltoegang is op deze installatie niet geconfigureerd: de relay-URL of het bijbehorende ondertekeningssecret ontbreekt, dus er kan geen bruikbaar ticket worden aangemaakt.

De API antwoordt met 503 in plaats van een correct opgebouwd ticket terug te geven dat niets zou accepteren. Een ticket dat zonder secret is ondertekend, ziet er voor een client geldig uit en wordt bij de relay geweigerd. Dat ziet eruit als “de knop werkt en de terminal gaat nooit open”, en dat is veel lastiger te diagnosticeren dan een expliciete weigering.

Voorbeelden van detail-berichten die met deze fout worden teruggegeven:

• Terminal access is not configured on this deployment.

Wat je kunt doen

Aan de clientkant valt niets opnieuw te proberen. Op abonnementen die door fremforge worden gehost, ligt dit bij ons: kijk op status.frem.sh of mail support@frem.sh. Op een installatie die je zelf host, moeten de relay-URL en het ondertekeningssecret allebei aanwezig zijn.

Vorm van het antwoord

Alle API-fouten van fremforge zijn RFC 9457 problem+json:

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

Baseer je logica op type, niet op title of detail: die zijn bedoeld voor mensen en kunnen anders worden geformuleerd.