OAuth

Anmerkung

Auf dieser Seite wird nur auf die OAuth-Implementierung von Customa eingegangen. Wir gehen im weiteren Verlauf davon aus, dass Sie sich bereits mit den Grundlagen von OAuth befasst haben.

Mittels OAuth können Sie Ihrer Drittanwendung Zugriff auf Customa gewähren. Dabei wird der Authorization Code Flow benutzt, um die Drittanwendung zu Autorisieren.

Als erstes muss die OAuth-Anwendung in Customa registriert werden. Dies geschieht im Bereich “Meine Anwendungen”, welcher in der Navigation unterhalb der Accounteinstellungen zu finden ist.

Dort wird dann die Anwendung im Abschnitt OAuth angelegt.

Der Name, den Sie der Anwendung geben, wird später den Benutzern angezeigt, wenn diese ihren Account verbinden möchten. Die in Customa hinterlegte Redirect URI muss mit der übergebenen Redirect URI übereinstimmen, damit der OAuth-Prozess erfolgreich durchläuft.

Auf der folgenden Seite wird Ihnen die Client ID und das OAuth Secret angezeigt. Speichern Sie sofort das Secret, da diese später nicht mehr im Klartext vorhanden ist. Mit dem Secret kann Ihre Anwendung am Token-Endpunkt API-Tokens für die API v4 anfordern.