SMS-Gateway
| Siehe auch CS4OutlookAdminConfig.xml für die Variablen des SMS-Gateways. |
Es ist möglich, Cryptshare for Outlook (Classic) mit einem SMS-Gateway zu verbinden. Im konfigurierten Zustand erhält der Empfänger eine SMS mit den folgenden Daten: Name des Absenders, Betreff des Cryptshare-Transfers, Tracking-ID und das Transfer-Passwort.
Wir unterstützen SMS-Gateways, die eine HTTP/S-API bereitstellen, Anfragen vom Typ GET oder POST akzeptieren und eine Antwort vom Typ application/json oder text/plain senden.
Config Creator-Einstellungen
SMS-Gateway aktivieren
Dieses Kontrollkästchen aktiviert die Möglichkeit, das Transfer-Passwort per SMS-Nachricht zu senden. Dem Benutzer wird die Option zum Versenden des Transfer-Passworts per SMS-Nachricht angeboten, wenn er entweder die Passwort-Option Passwort generieren oder Passwort eingeben wählt.
Anfragtyp
Gibt den Anfragtyp an, der beim Versenden der SMS-Nachricht ausgeführt wird. Sie haben die Möglichkeit, zwischen GET (ohne Request-Body), POST_FORM (Request-Body vom Typ application/x-www-form-urlencoded) und POST_RAW (Request-Body vom Typ application/json) zu wählen.
Request-Body-Vorlage (nur bei POST_RAW)
Wenn das SMS-Gateway die Parameter in einem JSON-Request-Body übermittelt bekommen soll, können Sie hier die JSON-Body-Vorlage definieren. Die folgenden Platzhalter stehen zur Verfügung:
-
from: Der vollständige Name des Absenders im Format "Vorname Nachname".
-
to: Die Telefonnummer des Empfängers, wie vom Benutzer angegeben.
-
message: Die an den Empfänger zu sendende SMS-Nachricht.
Alle Platzhalter müssen zwischen zwei geschweiften Klammern eingefasst werden (z. B. CSOCurrent en). Beispiel:
{
"senderName": "CSOCurrent en",
"recipient": "CSOCurrent en",
"content": "CSOCurrent en",
"custom": "parameter"
}
Authentifizierungsdaten verwenden
Wenn das SMS-Gateway die Authentifizierung via Basic Authentication wie in RFC 7617 definiert erforderlich macht, können Sie hier die Zugangsdaten bereitstellen.
HTTP-Parameter
Ermöglicht es Ihnen, die SMS-Informationen als HTTP-Parameter zu übergeben, z. B. bei Verwendung des Anfragtyps GET oder POST_FORM. Bei POST_FORM wird die konstruierte Query-String im POST-Request-Body platziert. Für Parameter wie einen API-Schlüssel aktivieren Sie die Option Wert verschlüsseln, um sicherzustellen, dass dieser nicht im Klartext in der Konfigurationsdatei gespeichert wird.
| Beachten Sie, dass die Verschlüsselung nicht dazu bestimmt ist, sicher zu sein, sondern nur dem Zweck dient, den Zugriff auf den Parameter durch Benutzer zu verhindern. |
Antworttyp
Gibt die Form an, in der die HTTP-Antwort des SMS-Gateways erwartet wird. Die Optionen text/plain und application/json stehen zur Verfügung.
Erwartete Antwort bei Erfolg
Gibt die erwartete Antwort an, um eine erfolgreiche SMS-Versendung anzuzeigen. Wenn die tatsächliche Antwort nicht mit der erwarteten Antwort übereinstimmt, wird eine Fehlermeldung für den Benutzer angezeigt. Die Eingabe wird als regulärer Ausdruck ausgewertet. Daher führt sie eine reguläre Volltext-Suche für normale Eingaben wie 100 durch. Sie können komplexere Ausdrücke verwenden, z. B. 100|101, wenn beide Nummern eine erfolgreiche Operation anzeigen.
Speicherort der Antwortnachricht
(nur bei HTTP-Antworten vom Typ application/json)
Gibt die JSON-Eigenschaft an, die den Statuscode des SMS-Versendungsvorgangs enthält. Bitte geben Sie den Eigenschaftspfad in JsonPath an, um verschachtelte Strukturen zu erreichen. Beachten Sie, dass Sie das übliche "$." Präfix weglassen müssen, da die Antwort implizit als "Root-Member-Objekt" behandelt wird.
Speicherort der Fehlermeldung
(nur bei HTTP-Antworten vom Typ application/json)
Gibt die JSON-Eigenschaft an, die die Fehlermeldung im Falle einer fehlerbaften Antwort enthält. Bitte geben Sie den Eigenschaftspfad in JsonPath an, um verschachtelte Strukturen zu erreichen. Die angegebene Fehlermeldung wird dem Benutzer angezeigt, wenn die tatsächliche Antwort nicht mit der erwarteten Antwort übereinstimmt. Beachten Sie, dass Sie das übliche "$." Präfix weglassen müssen, da die Antwort implizit als "Root-Member-Objekt" behandelt wird.
