This page View Markdown Open in ChatGPT Open in Claude

Decrypt data¶

Decrypts what encrypt data produced, or what a client encrypted with encryptionAlgorithmFETransfer and secretFETransfer of the secret, and gives the original value back.


Method	POST
URL	`/api/system-api/admin/decrypt-data` : `admin` is the user path of your account
Body	`{ data, algorithm?, pass? }`
Answer	`data` : the decrypted value, parsed as JSON when it is JSON
From code	`g.sys.system.decrypt`

The call¶

Body

{ "data": "U2FsdGVkX19iIBA3FQy3OgFXeE4B2cC8lAfaJjCbMmUllceqb58YwvQqU33PkQEQ" }

Answer

{ "success": true, "statusCode": 200, "data": { "name": "Joseph", "card": "4111 1111 1111 1111" } }

algorithm and pass work as on encrypt data : give the same ones the text was encrypted with.
A text which does not decrypt with the key answers data: null.

From code¶

TypeScriptPythonPHPC#GoRustJavaKotlin

const encryptedText = g.req.body.encrypted;
const value = await g.sys.system.decrypt(encryptedText);                                       // with the transfer key of the secret
const mine = await g.sys.system.decrypt(encryptedText, T.EEncryptionAlgorithm.AES, 'my-own-key');  // with the algorithm and the key given

encrypted_text = g.req.body.encrypted
value = await g.sys.system.decrypt(encrypted_text)                           # with the transfer key of the secret
mine = await g.sys.system.decrypt_with(encrypted_text, 'AES', 'my-own-key')  # with the algorithm and the key given

$encryptedText = $g->req->body->encrypted;
$value = $g->sys->system->decrypt($encryptedText);                           // with the transfer key of the secret
$mine = $g->sys->system->decryptWith($encryptedText, 'AES', 'my-own-key');  // with the algorithm and the key given

var encryptedText = g.Req.Body.GetString("encrypted");
var value = await g.Sys.System.Decrypt(encryptedText);                           // with the transfer key of the secret
var mine = await g.Sys.System.DecryptWith(encryptedText, "AES", "my-own-key");  // with the algorithm and the key given

encryptedText := g.Req.Body().String("encrypted")
value, err := g.Sys.System.Decrypt(encryptedText) // with the transfer key of the secret
if err != nil {
    return nil, err
}
mine, err := g.Sys.System.DecryptWith(encryptedText, "AES", "my-own-key") // with the algorithm and the key given
if err != nil {
    return nil, err
}

let encrypted_text = g.req.body()["encrypted"].as_str().unwrap_or_default().to_owned();
let value = g.sys.system.decrypt(&encrypted_text)?;                                // with the transfer key of the secret
let mine = g.sys.system.decrypt_with(&encrypted_text, "AES", Some("my-own-key"))?;  // with the algorithm and the key given

String encryptedText = g.req.getBody().getString("encrypted");
Object value = g.sys.system.decrypt(encryptedText);                           // with the transfer key of the secret
Object mine = g.sys.system.decryptWith(encryptedText, "AES", "my-own-key");  // with the algorithm and the key given

val encryptedText = g.req.body.getString("encrypted")
val value = g.sys.system.decrypt(encryptedText)                           // with the transfer key of the secret
val mine = g.sys.system.decryptWith(encryptedText, "AES", "my-own-key")  // with the algorithm and the key given

Access, headers and errors¶

Over HTTP, a system API answers only once its settings open it : TOKEN_ACCESS (the token of an API user whose group grants this system API) or IS_PUBLIC. Without settings it is NO_ACCESS : only your code (g.sys) and the admin panel reach it.
The settings can also keep the answer in the cache, or ask for the token of a person (authProviders). Pre and post hooks run around it, as around any API.
It takes the request headers and answers the envelope. 401 : no valid token, or the API is NO_ACCESS. 403 : no group grants it. 400 : the body is wrong, and the message names the key.