Einrichtung der API-Zugangsdaten in Personio

Einrichtungsanleitung

1. Öffnen Sie die Einstellungen in Personio über die URL https://ihr_unternehmensname.app.personio.com/configuration, oder durch klicken auf Einstellungen unten links auf der Personio Startseite.

2. Klicken Sie in der Übersicht der Einstellungen auf API-Zugriffsdaten im Bereich Integrationen:

3. Klicken sie in der Übersicht der Integrationen auf individuelle Integration erstellen.

4. Vergeben Sie einen aussagekräftigen Namen für die Integration. Nach der Eingabe des Namens scrollen Sie nach unten um rechts unten auf “Weiter” klicken zu können.

5. Vergeben Sie die Zugriffsrechte die für diese Integration gelten sollen. Im Beispiel sind alle Rechte ausgewählt die für das OCT Gateway Personio benötigt werden um alle Standardendpunkte abrufen zu können.

6. Klicken sie danach auf “Attribute wählen” um festzulegen welche Felder der Mitarbeiter über die API abgerufen werden können. (Empfehlung: Select all um alle auszuwählen).

7. Klicken Sie auf Gesellschaften auswählen. Die API-Integration wird nur Mitarbeiterdaten abrufen können die den ausgewählten Gesellschaften zugeordnet sind.

8. Sobald Sie alle drei Bereiche angepasst haben, klicken Sie auf “Integration erstellen”.

9. Eine Seite mit den Zugangsdaten der eben erstellten Integration öffnet sich. Kopieren Sie die Client-ID und das Secret. Diese Daten sind die API-Zugangsdaten für das OCT Gateway Personio. Nach dem Kopieren klicken Sie unten rechts auf “Abschließen”.

10. Ein Hinweisfenster öffnet sich. Klicken Sie auf “Ja, fortfahren” wenn Sie vorher die Daten kopiert haben.

11. Nach der Erstellung befinden Sie sich wieder auf der Übersichtsseite der Integrationen. Der Status der soeben erstellten Integration sollte “Ausstehend” anzeigen. Erst nach einer ersten erfolgreichen Verbindung (z.B. ein Datenabruf über das OCT Gateway Personio) wird sich der Status auf “Verbunden” ändern.

nach der ersten Verbindung:

Aktualisierung der Berechtigungen der API-Integration

Berechtigungen können einfach aktualisiert werden. Klicken Sie auf die Integration, passen sie die Berechtigungen entsprechend an und klicken Sie unten rechts auf “Aktualisieren”. Die Zugangsdaten ändern sich dadurch nicht.

Zurücksetzen der Zugangsdaten Client-ID und Secret

Falls Sie die Zugangsdaten verloren oder verlegt haben, oder aus Sicherheitsgründen eine Erneuerung notwendig ist, klicken sie auf die Integration, dann auf den Tab “Api credentials” und auf “Client-ID und API-Secret” zurücksetzen. Dadurch entsteht eine neue Client-ID und ein neues Secret, diese müssen dann kopiert werden und im OCT Gateway Personio ausgetauscht werden.

Integration deaktivieren oder löschen

So trennen(löschen) oder deaktivieren Sie API-Zugriffsdaten für individuelle Integrationen:

1. Gehen Sie zu Marketplace > Verbundene Integrationen.

2. Klicken Sie in der Spalte Aktion auf die drei Punkte.

3. Klicken Sie auf Integration deaktivieren, um die Integration vorübergehend zu deaktivieren.

4. Klicken Sie auf Integration trennen, um die Integration dauerhaft zu löschen.