OAuth2 API

Das API von Artfilm erlaubt es anderen Websites, ihren Benutzer/innen Zugang zum Streaming auf Artfilm zu geben. Die Authentifizierung erfolgt auf dem Website, Artfilm erfährt den Benutzernamen, aber nicht das Benutzerpasswort. Es wird lediglich ein Hash des Benutzernamens gespeichert, nicht aber der Benutzername selber.

Der Zugang erfolgt in mehreren Schritten:

• Benutzerin Alice wählt den Link zum OAuth2-Client von Artfilm https://www.artfilm.ch/oauthclient.php?server=SERVER
• Artfilm leitet die Seite weiter an den Server des Websites SERVER.
• Alice meldet sich an.
• Der Website SERVER fragt Alice nach Erlaubnis, den Benutzernamen an Artfilm weiterzugeben.
• Der Website SERVER sendet den Code an Artfilm https://www.artfilm.ch/oauth.php?server=SERVER
• Artfilm fragt den Website SERVER mit dem Code nach dem Access Token.
• Der Website SERVER antwortet mit dem Access Token.
• Artfilm fragt den Website SERVER mit dem Access Token nach der Ressource Benutzernamen.
• Der Website SERVER antwortet mit der Ressource

Ist der Prozess erfolgreich, meldet Artfilm Alice über das interne Token API an.

Für das Einrichten der API für einen Website müssen folgende Parameter eingerichtet werden:

• ID des Website SERVER
• URL des Website für Code, Token und Ressource Benutzernamen
• Struktur der Ressource Benutzernamen