User Tools

Site Tools


old revision restored (2026/11/03 08:13)
key

Table of Contents

Endpunkt /Key

Der Endpunkt /Key dient der Erstellung von neuen Schlüsseln, dem hochladen von vorhandenen Schlüsseln in die aktuelle Session oder dem abrufen des aktuellen Schlüssels aus der Session.

Hinweis alle Schlüssel, die von dieser API unterstützt werden sind binäre Schlüssel, welche Base64 encodiert ausgetauscht werden. Zur Verwendung eigener Schlüssel aus Simplecrypt müssen die Schlüssel Base64 encodiert werden. Bzw. umgekehrt.

Der Endpunkt unterstützt GET und POST Anfragen.

GET

Die Anfrage wird über den query String gesteuert das Item action steuert das Verhalten “create” erzeugt einen neuen Schlüssel, “Read” gibt den aktuellen Schlüssel der Sitzung zurück. Optional können beim “create” auch die Eigenschaften des Schlüssels angegeben werden: “walzen” für die Anzahl der Walzen und “Kerben” für die Anzahl der Kerben. Werden die Optionen nicht angegeben, wird ein Schlüssel mit 3 Walzen und 4 Kerben generiert. Die Werte für “Kerben sollen zwischen 1 und 255 liegen. Die Werte für die Walzen zwischen 1 und n. Wobei 3-10 Walzen bereits eine sehr hohe Schlüsselsicherheit bieten. siehe hierzu die Simplecrypt Doku unter: https://www.sanchofock.de/?page_id=77

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

Beispiel Request: http://sancho.hopto.org/scAPI/Key?action=create&Kerben=5&walzen=2 http://sancho.hopto.org/scAPI/Key?action=read

Response: {“code”:200,”message“:“OK”,”error“:0,”errorMsg“:”“,”key“:”[Base64 encodierter Schlüssel]“}

POST

Mit POST kann ein vorhandener Schlüssel in der API Session gesetzt werden. Dafür muss das folgende JSON im Post Body übermittelt werden: {“key”:”[Base64 encodierter Schlüssel]“}

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

Beispiel Request: POST http://sancho.hopto.org/scAPI/Key Body {“key”:“V1d7Q0NbAAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8gISIjJCUmJygpKissLS4vMDEyMzQ1Njpc4OTo7PD0+P0BBQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWltcXV5fYGFiY2RlZmdoaWprbG1ub3BxcnN0dXZ3eHl6e3x9fn+AgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqKmqq6ytrq+wsbKztLW2t7i5uru8vb6/wMHCw8TFxsfIycrLzM3Oz9DR0tPU1dbX2Nna29zd3t/g4eLj5OXm5+jp6uvs7e7v8PHy8/T19vf4+fr7/P3+/11DQ0VFW6S5C3npZwQibt+6JZX1OzAmtVo07Ju3b+dHc4Dg/muFq0h68vnu/dWRA5f7zlNsLHWivFUSE9tikjKc4/gCKLuW8IpKUT0kYxDJaveZzxoplI6nXpBgi1Y13T9tvoiT6Mvz/8JhRMgXWHisjy8GvXZFftzQrWZ9IJ93nU1AUCMRf7B7ZTwcgnymK4zXv1fDmtioiY3MDE5f6w04M0ax79K2rzcZzcU5oB7GBcdJ/HBL3riY9oSB+q4K6rJCDgghWaUbGEFk9B2pPvHhHzYH5WgJLmmj1g8BhjHEOsDk0S3Z2lJdTABxoVRbdMpcFMHmtNRy0yoVJ4Pih09DFqqznu1dRUVTU1s0Ml1TU0tLWzI2LDExMCwxMTEsMjU1XUtLfVdXV1d7Q0NbAAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8gISIjJCUmJygpKissLS4vMDEyMzQ1Njc4OTo7PD0+P0BBQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWltcXV5fYGFiY2RlZmdoaWprbG1ub3BxcnN0dXZ3eHl6e3x9fn+AgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqKmqq6ytrq+wsbKztLW2t7i5uru8vb6/wMHCw8TFxsfIycrLzM3Oz9DR0tPU1dbX2Nna29zd3t/g4eLj5OXm5+jp6uvs7e7v8PHy8/T19vf4+fr7/P3+/11DQ0VFW37qNUSs+N5JHp0WL6Jq7tfVPzLrSJ8t+yId4WKKhmfRkltjehBrWY2MCAcrTQq2kNkowvzzcN/kIz7MJUW9TufFGDim+asZHGxUZFEmIYgMtOl4Vmjg1AL/hLp3xl0q40PInku5OZWBsNy3ewMgBsFxdMvWCUHH/q+PBaB8EhRmaVy/w5oOrWG4LPd13W9g78mbCz2jvtpl/aVaU6fbMYOTlEYk9EJAdnn6NPaJ0wE2D6iL5fUfAA3tkVgEqhdygKkpGthM5jyHyjDPR0q8mV5zLlXQX67xV4XobRF/T6TwnLUTOuLNwFLSu1Cxl26hjuyCGxUzxLLOJzt9mJY38rNdRUVTU1sxMzBdU1NLS1syOSw2NSw2OSwxNjZdS0t9V1c=”}

Response: {“code”:202,”message“:“Accepted”,”error“:0,”errorMsg“:”“}

key.txt · Last modified: 2026/11/18 21:04 by 216.73.216.110