Anfragen terminieren

Manchmal ist es notwendig, dass HTTP-Anfragen ohne weitere Verarbeitung zurückgewiesen werden müssen.

Das ist zum Beispiel bei der Verwendung von Basic Authentication der Fall, wenn die anfragende Seite erwartet, dass die angefragte Seite mit 401 antwortet, bevor die Zugangsdaten des Nutzers gesendet werden. (Siehe auch HTTP authentication in mdn web docs)

Für diese Fälle gibt es innerhalb des @soda-sync/app-sdk eine hook SodaSync.hooks.TerminateRequest(). Sobald diese Funktion aufgerufen wird, wird die weitere Verarbeitung abgebrochen und der anfragenden Seite wird die übergebene HTTP Antwort zurückgegeben.

Beispiel:

// Beendet die weitere ausführung der App und gibt 
// eine 401 Response inkl. des WWW-Authenticate Header an den Client zurück.
SodaSync.hooks.terminateRequest({
    statusCode: 401,
    body: "Authorization is required",
    headers: {
        'WWW-Authenticate': 'Basic realm="Realm"'
    },
});