Versions Compared

Version Old Version 11 New Version 12
Changes made by

Stefan Schöb

Stefan Schöb

Saved on

Key

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

Warum ist eine Authentifizierung nötig?

Über die Micromate Public API erhält der Aufrufer Zugriff auf Daten der entsprechenden Organisation resp. der Lernenden. Damit deine Daten von Zugriffen Dritter geschützt sind, ist bei jedem Aufruf der API eine Authentifizierung Pflicht.

Anleitung

Tip


Das Wichtigste in Kürze

  1. Mit jedem Aufruf auf die Micromate Public API muss ein gültiges Access Token mitgesendet werden

  2. Das Access Token kann über eine Schnittstelle mit einem signierten JWT abgefragt werden

...

Technologie

Library

NodeJS

jsonwebtoken

PHP

openssl_pkey_get_private

Ablauf

  1. Erstelle ein neues Token mit den Informationen aus dem Private-Key sowie gültigen Ausstell- sowie Ablaufzeiten

  2. Signiere das Token mit dem von uns erhaltenen private Key.

  3. Verwende das Token um über https://login.micromate.ai/oauth/v2/token ein Access Token abzufragen

  4. Verwende das erhaltene Access Token für jeden Aufruf an die Micromate Public API

Typescript Beispiel für NodeJS

Folgend eine Beispielimplementation in Typescript verwendet in einer NodeJS-Umgebung:

...