Wissen
Einbettung freigeben: Signierseite und Formulare auf Ihrer Website
Wie Sie erlaubte Websites festlegen, damit die Signierseite oder ein Formular in einem Rahmen auf Ihrer Seite erscheint. Mit Regeln für Test und Live.
3 Min. Lesezeit · Stand: 07.10.2026
Sie können die Signierseite von OneSign und einzelne Formulare in einem Rahmen (iframe) auf Ihrer eigenen Website zeigen. Dafür muss Ihre Website zuvor ausdrücklich erlaubt sein. Eine leere Liste bedeutet: Einbettung aus.
Signierseite einbetten
- Öffnen Sie „Entwickler → Einbettung“. Nur Inhaber und Admins sehen und ändern die Liste.
- Tragen Sie bis zu 20 Websites ein, in der Form https://host[:port] oder https://*.ihre-domain.de für alle Unterdomains einer eigenen Domain. Kein Pfad, keine IP-Adresse, kein einzelnes *.
- Speichern Sie. Die Änderung gilt sofort für die Signierseite und für neue Einbettungs-Sitzungen; jede Änderung steht im Aktivitätsprotokoll.
- Ihr Server fordert je Empfänger eine Einbettungs-Sitzung an, sobald dieser an der Reihe ist; der Schlüssel braucht dafür envelopes:signing_urls (Standard aus). Die Sitzung gilt 5 Minuten und nur für die angegebene Website. Ihre Seite zeigt sie mit dem Widget.
Über die API ändern Sie die Liste mit PUT /v1/embed-settings (Scope org:manage, Standard aus); lesen können Sie sie mit org:read.
Formulare einbetten
Bei Formularen gilt die Liste je Formular (höchstens 10 Einträge, ohne *). Sie steht im Reiter „Teilen“ des Formulars; dort finden Sie auch den Einbettungscode. Ohne Eintrag zeigt der Browser das Formular nie in einem fremden Rahmen.
Regeln und Grenzen
- http://localhost:PORT und Testnamen sind nur im Testmodus erlaubt und gelten nie im Live-Modus. Dort zählen nur https-Einträge.
- Im Live-Modus ist die Einbettung noch ausgeschaltet, bis sie auf echten Geräten geprüft ist: Ein Live-Schlüssel erhält beim Anfordern einer Sitzung 403 / 9030. Im Testmodus können Sie alles ausprobieren. Zusätzlich braucht Ihre Organisation einen Tarif mit eingebettetem Signieren (sonst 403 / 9039).
- Qualifizierte Unterschriften (QES) werden nie eingebettet. Mitglieder mit Zertifikat unterschreiben im Dashboard oder über den Freigabe-Link.
- Maßgeblich für Ihre Geschäftslogik bleibt der Webhook. Die Nachrichten der eingebetteten Seite sind Hinweise für Ihre Oberfläche, keine Bestätigung.