Single Sign-On einrichten

Die Adobe Acrobat Sign-Dokument-API wurde für die nahtlose Integration in Ihre bestehende Anwendung entwickelt, ohne dass Sie einen separaten von Acrobat Sign verwalteten Registrierungsprozess durchlaufen müssen. Daher muss die zugehörige Anwendung sicherstellen, dass der Absender ein registrierter Acrobat Sign-Benutzer ist. Falls nicht, werden sie programmgesteuert durch die API registriert. Empfänger werden nie aufgefordert, sich zu registrieren und alle auf Empfängerseite erforderlichen Interaktionen werden von Acrobat Sign verwaltet.

Dokumentabsender angeben

Es gibt mehrere Möglichkeiten, einen Absender anzugeben, wenn Sie eine neue Transaktion mit der Methode sendDocument starten. Das Verhalten hängt davon ab, welche Werte über den optionalen Parameter SenderInfo übergeben werden.

• Null-SenderInfo: In diesem Fall ist der Absender des Dokuments der spezielle eindeutige Benutzer, der mit dem verwendeten API-Schlüssel verknüpft ist. Diese Methode eignet sich für Testimplementierungen und bestimmte Implementierungen mit begrenztem Geltungsbereich, ist jedoch normalerweise nicht für umfangreiche Integrationen mit vorhandenen Benutzersätzen geeignet.

• SenderInfo mit E-Mail-Adresse und Passwor: In diesem Fall ist der Absender des Dokuments der Benutzer, der im E-Mail-Parameter angegeben ist. Das angegebene Kennwort muss mit dem Acrobat Sign-Kennwort des Benutzers übereinstimmen. Zur Integration können die E-Mail und das Kennwort im Kontext der übergeordneten Anwendung vom Benutzer angefordert werden, bevor das Dokument gesendet wird. Alternativ dazu kann die übergeordnete Anwendung die E-Mail und das Kennwort speichern, entweder weil die übergeordnete Anwendung den Benutzer erstellt hat oder weil der Benutzer diese Informationen zuvor angegeben hat und sie zwischengespeichert wurden.

• SenderInfo mit email, aber ohne Kennwort: In diesem Fall ist der Absender des Dokuments der Benutzer, der im E-Mail-Parameter angegeben ist. Der Kennwortwert muss null sein. Acrobat Sign prüft, ob der API-Aufrufer und der gewünschte Absender zum gleichen Konto gehören. Das Kennwort wird dabei aber nicht angefordert oder geprüft. Diese Methode eignet sich gelegentlich für API-Integrationen innerhalb eines bestimmten Unternehmens, aber die individuelle Sicherheit wird dabei reduziert. Dieses Authentifizierungsmodell muss explizit vom Masterkontoinhaber angefordert werden, um für die Acrobat Sign-API verfügbar zu sein.

Acrobat Sign-Kontoverwaltung

Wie oben beschrieben geben Sie in den meisten Fällen die E-Mail-Adresse und das Kennwort des Benutzers an, in dessen Namen Sie das Dokument senden. Im folgenden Abschnitt werden die verschiedenen Methoden beschrieben, mit denen Informationen abgerufen werden können.

Benutzer auffordern

Fordern Sie den Benutzer auf, seine E-Mail-Adresse und sein Kennwort für Acrobat Sign beim Senden anzugeben. Sie können die Methode verifyUser verwenden, um zu prüfen, ob der Benutzer bei Acrobat Sign registriert und das Kennwort gültig ist. Wenn der Benutzer nicht registriert ist, können Sie ihn entweder auffordern, sein eigenes Konto für Acrobat Sign zu erstellen, oder ein Konto für ihn erstellen (siehe unten).

Konto erstellen

Wenn ein Aufruf von verifyUser ergibt, dass kein Benutzer mit dieser E-Mail-Adresse vorhanden ist, können Sie programmgesteuert einen Acrobat Sign-Benutzer erstellen, indem Sie createUser aufrufen. Wenn die Benutzererstellung erfolgreich ist, können die angegebene E-Mail-Adresse und das angegebene Kennwort als SenderInfo für Ihr Dokument verwendet werden.

Konto speichern

Im Anschluss an die oben beschriebenen Szenarien können Sie die E-Mail-Adresse und das Kennwort des Benutzers speichern und als SenderInfo beim Senden nachfolgender Dokumente im Namen dieses Benutzers verwenden. Der Benutzer kann sich jederzeit bei seinem Acrobat Sign-Konto anmelden und sein Kennwort ändern. Die Anwendung muss daher damit umgehen können, wenn ein zuvor gespeichertes Kennwort ungültig ist.

Zusammenfassung

Es gibt verschiedene Möglichkeiten, die Absenderidentität zu ermitteln, wenn Sie die Dokument-API von Acrobat Sign verwenden. Lesen Sie die oben angegebenen Informationen sorgfältig durch, um zu entscheiden, welche Methode für Ihre Anwendung geeignet ist. Wenn Sie Fragen haben, können Sie sich jederzeit an uns wenden.