API Zugriff

Just Social verfügt über eine Public API, in der bestimmte Endpunkte aufgerufen werden. Sie wird in den nächsten Jahren erweitert werden. Die Berechtigungen für den Zugriff können in der Admin App unter "Anbindungen -> Public API" in Just Social freigegeben werden. Sofern der Punkt auf eurer Plattform noch nicht vorhanden ist, meldet euch bitte bei uns.

Über den Aufruf der folgenden URL

https://<Just-Platform>/public-api/swagger-ui/index.html

findet ihr die generelle als auch Endpunkt-spezifische öffentliche Dokumentation. Dazu müsst ihr euch aber zuvor in Just Social mit einem gültigen Account eingeloggt haben.

Dort findet ihr Informationen zu

• den verfügbaren Endpunkten
• der Art der bereitgestellten Daten
• Art und Weise des Logins
• den benötigten Scopes

Es ist möglich, mehrere Clients zu definieren, die jeweils nur für bestimmte Scopes Zugriff erhalten. Ihr könnt aber auch einem Client Zugriff zu mehreren Scopes geben.

Sofern ihr die Just Accounts als Login für andere Systeme nutzen wollt, wird euch das Kapitel unten weiterhelfen.

Login mit Just

Ihr könnt Just Social verwenden um für andere Anwendungen, die OIDC unterstützen, den Login zu übernehmen.

Just Social fungiert dabei als Open ID Provider. Mehr zu OpenID Connect (kurz OIDC) siehe z.B. 

https://auth0.com/de/intro-to-iam/what-is-openid-connect-oidc

In der Admin-App deines Just-Systems im Abschnitt "Anbindungen -> Public API" 
bzw. der URL https://DEIN_JUST/just/admin/public-api könnt ihr euch den dafür nötigen OAUTH-Client erzeugen. Klickt dazu zunächst auf

"Login mit Just hinzufügen". 

Im Nachfolgenden Popup gebt ihr den Namen der Anwendung ein, in der ihr euch einloggen wollt. Dieser Name dient dabei nur zur Wiedererkennnung für euch. Im Beispiel hier einfach "Externe Anwendung".

Damit eure externe Anwendung den eingeloggten Nutzer erkennen kann, wird meist die email-adresse verwendet. Daher müsst ihr neben dem zwingend nötigen "openid"-Scope auch den "email"-Scope anwählen. Benötigt ihr noch weitere Profilinformationen, um die Nutzer z.B. beim Login erst anzulegen, könnt ihr auch den "profile" scope dazu auswählen.

Damit Just den Nutzer nach dem Login zu eurer Anwendung zurückleiten kann, muss noch eine sog. redirect-uri / Redirect Url angegeben werden. Bitte tragt diese unten ein.

Danach könnt ihr speichern. Nun seht ihr die Daten, die ihr in der externen Anwendung für die weitere Konfiguration benötigt:

Über die Issuer URL sollte die Anwendung alle weiteren nötigen Informationen abrufen können. Falls nicht, sind diese über 

https://DEINE_JUST_URL/auth/.well-known/openid-configuration

abrufbar.

Wenn ihr nun eure externe Anwendung entsprechend konfiguriert, wird diese Just als OIDC Provider nutzen. Kommt dann ein nicht eingeloggter Nutzer, leitet die Anwenung den Nutzer weiter zu Just, dort loggt er sich ein (oder ist es bereits), wird dann zurückgeleitet und ist in der externen Anwendung eingeloggt.

Haftung & Support

Für Anbindungen/Integrationen von Drittsoftware an/in Just Social übernimmt Just Software keine Haftung und leistet keinen Support.