API-Zugang für andere Systeme einrichten

Soll ein anderes System (zum Beispiel Ihr ERP) Anfragen in actaSIGN erstellen oder abfragen, braucht es Zugangsdaten. Diese legen Sie hier als Anwendung an und geben sie Ihrem Integrator.

Nur für Administratoren

Sie brauchen Administratorrechte für das Firmenkonto oder den Mandanten.

So finden Sie es

my.actapass.com → Firmenkonten → ⋮ → Mandanten → ⋮ beim Mandanten → Anwendungen

Eine Anwendung anlegen

1. Klicken Sie auf Hinzufügen und geben Sie einen Name ein, optional eine Beschreibung.
2. Client ID: erzeugt actaPASS selbst. Kopieren Sie sie mit dem Symbol daneben.
3. Client Secret: ebenfalls erzeugt. Kopieren Sie es jetzt: Es wird nur einmal angezeigt.
4. Erlaubte Umleitungs-URLs: Adressen, zu denen actaPASS nach der Anmeldung zurückleiten darf. Jede URL mit der Eingabetaste oder + zur Liste hinzufügen.
5. Gültigkeitsdauer (ISO 8601 Format): wie lange ein Zugangstoken gilt, z. B. PT1H für eine Stunde (Standard).
6. Gültige Anwendungsbereiche (Scope): vorbelegt mit openid profile email mobile.
7. Klicken Sie auf Speichern.

Gut zu wissen

Secret nur einmal sichtbar

Nach dem Speichern zeigt actaPASS das Client Secret nie wieder. Geht es verloren, öffnen Sie ⋮ → Details und klicken auf Geheimnis neu erzeugen. Das alte Secret gilt danach nicht mehr; passen Sie das andere System an.

• Geben Sie Client ID und Secret nur über einen sicheren Weg weiter, nie per gewöhnlicher E-Mail.
• ⋮ → Löschen entfernt die Anwendung unmittelbar; das andere System hat dann keinen Zugang mehr.
• Die Liste heisst in actaPASS «Applikationen».

Siehe auch

• Webhooks in actaSIGN