Der Endpunkt /Encrypt dient der Verschlüsselung.

Der Endpunkt unterstützt POST und PUT Anfragen.

POST und PUT verschlüsseln Inhalte. Der Unterschied zwischen POST und PUT ist, dass der Schlüssel vor dem POST auf die Startposition zurückgesetzt wird. Beim PUT hingegen wird der Schlüssel (sofern kein neuer gesetzt wird) nicht zurückgesetzt, so dass man beispielsweise eine Serie von Texten oder Dateien mit einem fortlaufenden Schlüssel verschlüsseln kann. Aber natürlich muss beim entschlüsseln die gleiche Reihenfolge eingehalten werden. PUT und POST müssen das folgende JSON im Body übermitteln: {“key”:“[Base64 encodierter Schlüssel]”,“plainText”:“[zu verschlüsselner Text”,“plainBinary”:“[Base64 encodierter Daten]”}

Wenn der Wert von “key” gesetzt wird, wird dieser Schlüssel neu gesetzt. Ist der Wert leer, so wird der letzte in der Session gesetzte Schlüssel verwendet.

plainText und plainBinary können beide gesetzt werden, dann werden beide verschlüsselt. Es empfiehlt sich jedoch pro anfrage nur eine der beiden Optionen zu nutzen. Im plainText Feld können beliebige Text Informationen verschlüsselt werden. Wenn Binäre Daten verschlüsselt werden sollen, so müssen diese zuerst BASE64 encodiert werden und dann im plainBinary Feld übergeben werden

Header: Es müssen keine Informationen im Header mitgegeben werden, lediglich die JSession Cookies müssen beachtet werden.

Beispiel Request: POST /scAPI/Encrypt HTTP/1.1\r\n Cookie: JSESSIONID=node01cmcgnsvmj1u7hpof54o7zfgr8595.node0;\r\n User-Agent: Apache-HttpClient/4.5.12 (Java/1.8.0_281)\r\n Accept: */*\r\n Connection: Keep-Alive\r\n Host: sancho.hopto.org\r\n Content-Length: 52\r\n BODY {“key”:“”,“plainText”:“Test 1 2 3”,“plainBinary”:“”}

Response: {“code”:202,“message”:“Accepted”,“error”:0,“errorMsg”:“”,“cipherText”:“77+yQRDvv4k7d++/ju+/qQHvv74=”,“cipherBinary”:null}

Note that the returned result in cipherText is always Base 64 encoded. Because we are using always binary Keys