Ihre Vorteile
Als Unternehmen mit über 100 Benutzern ist es möglicherweise umständlich, Benutzer in Showpad zu verwalten. Sie könnten auf die Herausforderung stoßen,
- Extrahieren Sie Informationen aus Ihrer eigenen zentralen Benutzerverwaltungsumgebung und verfolgen Sie, wer bereits hinzugefügt wurde
- Geben Sie die Benutzerdaten manuell ein
- Verfolgen Sie die Benutzerberechtigungen an mehreren Standorten (Was ist, wenn ein Benutzer das Unternehmen verlässt oder seine Berechtigungen widerrufen werden müssen?)
Dadurch geht viel Zeit und Mühe in der Benutzerverwaltung verloren. In diesem Anwendungsfall besprechen wir, wie Sie Ihre eigene Benutzer Managementumgebung mit Showpad mit unserem API integrieren können.
Hauptmerkmale
Wir glauben, dass die 'Wahrheit' nur an einem Ort liegen sollte. Bei der Benutzerverwaltung bedeutet dies, dass es nur ein Hauptverzeichnis geben sollte, in dem nicht nur alle Benutzerinformationen gespeichert, sondern auch verwaltet werden. Integrierende Systeme wie Showpad sollten nur auf Statusänderungen in diesem Masterverzeichnis reagieren. Sie dürfen niemals Zustandsänderungen veranlassen, wie z. B. das Erstellen, Aktualisieren oder Löschen.
Was Sie für den Erfolg benötigen
- Showpads ultimativer Preisplan
- Zugriff auf die Online Platform von Showpad
- Kenntnisse über APIs
- Showpad, REST-Clients und Befehlszeilen von API Explorer sind für Sie kein Rätsel
Sehen Sie dies im Detail
Ablauf der Benutzerverwaltung
In den meisten Fällen wird nicht jedem Benutzer Showpad zugewiesen. Wir empfehlen daher, dass sich alle Showpad- berechtigten Benutzer in einer speziellen Showpad- Gruppe befinden und dass das Hinzufügen / Aktualisieren / Entfernen eines Benutzers innerhalb von Showpad durch das Hinzufügen / Aktualisieren / Entfernen dieses Benutzers in dieser Gruppe bestimmt wird. Zum Beispiel, wenn Sie einen Benutzer zur Showpad Gruppe hinzufügen, kann ein vom Benutzer erstelltes Ereignis ausgelöst und von einem Showpad Plugin aufgefangen werden. Dieses Plugin könnte wiederum einen Showpad API Aufruf zum Erstellen der Bennutzer tätigen.
Erstellen
Die Erstellung eines oder mehrerer Benutzer erfolgt über den POST /users.JSON API-Aufruf. Geben Sie die Benutzerdetails als Anwendungs-/JSON-Feld mit Schlüssel-/Wertobjekten an. Wenn die Benutzer erfolgreich erstellt wurden, erhalten Sie einen 201-Antwortcode. Wenn ein Problem mit den Benutzerdaten aufgetreten ist, erhalten Sie einen 40-fachen Antwortcode. Sie erhalten höchstwahrscheinlich einen 409-Antwortcode, der signalisiert, dass die Entität oder Entitäten, die Sie übermitteln wollten, ungültig waren.
Das externalId-Attribut wird beim Erstellen eines Benutzers verwendet. Dieses Attribut ist in der Regel die ID des Benutzers im Benutzerverzeichnis des Kunden und kann verwendet werden, um zu überprüfen, ob ein Benutzer bereits hinzugefügt wurde. Insbesondere kann es verwendet werden, um einen authentifizierten Benutzer über einen Authentifizierungsmechanismus wie SAML einem Showpad-Benutzer zuzuordnen (siehe unten).
Aktualisierung
Sie können einen Benutzer über PUT /users/{id}.json aktualisieren, wobei {id} durch die von der API abgerufene Benutzer-ID ersetzt werden sollte. Sie können ein application/JSON-Schlüssel / Wert Array im Hauptteil verwenden, um anzugeben, welche Werte aktualisiert werden sollen.
Deaktivieren
Sie können einen Benutzer über PUT / users / {id}.JSON deaktivieren, wobei {id} durch die Benutzer- ID ersetzt werden sollte, wie sie von der API abgerufen wurde. Sie können ein application/JSON-Feld mit "isActive" als Schlüssel und "false" als Wert verwenden. Nehmen Sie die gleiche Anfrage vor, aber mit dem Schlüssel auf 'true' eingestellt, um den Benutzer wieder zu aktivieren.
Wird gelöscht
Sie können einen Benutzer einfach über DELETE / users / {id}.json, wobei {id} durch die Benutzer- ID ersetzt werden sollte, wie sie von der API abgerufen wurde. Löschen eines Nutzers wird die Benutzer vollständig entfernen und alle zugehörigen Daten von Showpad. Daher könnte es gut sein, nur dann einen Benutzer zu löschen, wenn er endgültig aus dem Master-Benutzerverzeichnis entfernt wird. Verwenden Sie die Deaktivierung für alle anderen Zwecke.
Bestätigung
Aus Sicherheitsgründen wird natürlich davon abgeraten, das Benutzerkennwort beim Erstellen eines neuen Benutzers über die Showpad- API zu senden. Wenn kein Passwort eingegeben wird, wird eine Einladungsmail an den Benutzer gesendet, damit der Benutzer sein eigenes Passwort privat eingeben kann.
Die Authentifizierung kann auch über einen Single Sign-On-Dienst erfolgen. Auf diese Weise können sich Benutzer mit ihren Unternehmenskonten anmelden. Weitere Informationen zur Authentifizierung mit API und zur Implementierung von Single Sign-On finden Sie in diesem Help Center.