User Tools

Site Tools


key

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
key [2026/10/30 11:40]
216.244.66.230 old revision restored (2025/12/05 02:46)
key [2026/11/14 08:55] (current)
216.244.66.230 old revision restored (2026/03/18 02:09)
Line 1: Line 1:
-====== **Endpunkt /Key** ====== +Doku 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.1793356812.txt.gz · Last modified: 2026/10/30 11:40 by 216.244.66.230