https://wiki.7kas.com/index.php?action=history&feed=atom&title=TuCloudAPI_authchallengeTuCloudAPI authchallenge - Revision history2026-11-07T04:43:32ZRevision history for this page on the wikiMediaWiki 1.43.9https://wiki.7kas.com/index.php?title=TuCloudAPI_authchallenge&diff=1241&oldid=prevMaintenance script: TuCloudAPI reference (generated from func=help; ringinuse 2026-10-31)2026-10-31T11:47:54Z<p>TuCloudAPI reference (generated from func=help; ringinuse 2026-10-31)</p>
<p><b>New page</b></p><div>''TuCloudAPI function to manage FuturePBX (the cloud PBX). Available to: '''SuperRoot, Operator, Client'''.''<br />
<br />
== Description ==<br />
A proof-of-work captcha challenge (ALTCHA protocol, SHA-256). PUBLIC. The browser finds the number in [0, maxnumber] such that sha256_hex(salt + number) = challenge, then sends base64(JSON {algorithm, challenge, number, salt, signature}) as `captcha` to authlogin or authrequest. A challenge lives 5 minutes (the expiry is inside the salt, signed) and is accepted once. Per IP 60 per window.<br />
<br />
== Call ==<br />
https://tucloudapi.7kas.com:9087/tucloud?func=authchallenge&ukey=YOUR_KEY<br />
GET, or POST with the parameters form-urlencoded in the body. Requires the <code>ukey</code> parameter.<br />
<br />
== Parameters ==<br />
None beyond <code>ukey</code> and <code>func=authchallenge</code>.<br />
<br />
== Example ==<br />
<nowiki>https://tucloudapi.7kas.com:9087/tucloud?func=authchallenge</nowiki><br />
<br />
== Response ==<br />
{ok, algorithm:"SHA-256", challenge (64 hex), maxnumber, salt ("<32 hex>?expires=<unix>"), signature (64 hex)}.<br />
<br />
----<br />
Back to [[TuCloudAPI]]<br />
[[Category:TuCloudAPI SuperRoot]][[Category:TuCloudAPI Operator]][[Category:TuCloudAPI Client]][[Category:TuCloudAPI]]</div>Maintenance script