Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

SIe betreiben eine eigene Applikation/Webseite und möchten Ihre Nutzer ohne weitere Passworteingabe in Ihr Fakturia-Kundencenter schicken?
Dann nutzen Sie den SSO-Login per SessionToken.

Table of Contents

Ablauf

  • Erzeugung eines SessionToken für einen bestimmten Kunden/UserLogin per API
  • Weiterleitung des Nutzers zum Kundencenter per Link, Redirect, iframe, ...
  • Nutzer ist ohne Eingabe von Credentials im Kundencenter eingeloggt
  • Der SessionToken ist hiermit verbraucht

...

Code Block
titleBeispiel-Response
linenumberstrue
{
  "sessionToken": "83814cf5-8215-48ba-bf53-94e0dd19ae42",
  "created": "2022-07-18T12:13:27.768Z",
  "login": "dummyUsername",
  "loginUrl": "https://mycompanyname.vertragscenter.example/public/login.html?sessionToken=XYZABC83814cf5-8215-48ba-bf53-94e0dd19ae42"
}

Für die weitere Verwendung ist die loginUrl relevant.

...

Der Nutzer wird nun eingeloggt und sieht die Startseite des Kundencenters.

Übergabe von Parametern / Voreinstellungen

Per GET-Parameter können in der Einsprungs-URL verschiedene Einstellungen optional gesetzt werden.

ParameterFunktionWert
sessionTokenSSO-Login, wie auf dieser Seite beschriebenZeichenkette
localeVoreinstellung der SpracheLocale gem. ISO 3166-1
z. B. en_GB, en_US, de_DE
hideLanguageSwitchSprachauswahl-Schalter ausblenden
  • true
  • false
hideUsermenuUser-Menü ausblenden
  • true
  • false