Lewati ke konten utama

Resep Skenario Klasik

Gabungkan konsep dan scripting menjadi alur kerja dunia nyata. Setiap skenario memberikan: tujuan → alur → skrip yang dapat langsung ditempel ke UI → hasil yang diharapkan. Seluruh logika skrip telah diverifikasi end-to-end di aplikasi sungguhan.

Contoh memakai server pengujian lokal (/oauth2/token, /protected, /echo, /json, dll.). Ganti dengan path dan Pre-URL milik Anda sendiri saat mengarah ke API Anda sendiri.


Skenario 1: Login untuk Token, Lampirkan Otomatis untuk Seluruh Grup​

Tujuan: memanggil API login, menyimpan token, dan memastikan setiap permintaan berikutnya melampirkannya secara otomatis — tanpa menyalin manual.

Permintaan A — login (skrip pasca-respons menyimpan token)​

POST /oauth2/token, body form: grant_type=password&username=qruser&password=qrpass&client_id=qr-client&client_secret=qr-secret

Tambahkan satu langkah skrip ke rantai pasca-respons:

async function onResponse(context, url, response) {
var j = response.body.parseJSON();
if (j && j.access_token) {
sdk.env.set('authToken', j.access_token); // store on the runtime blackboard
sdk.env.set('tokenType', j.token_type || 'Bearer');
}
return response;
}

Permintaan B — lampirkan token (skrip yang sama dapat disalin ke setiap API terotorisasi)​

GET /protected, tambahkan satu langkah skrip ke rantai pra-kirim:

async function onRequest(context, url, request) {
var tok = sdk.env.get('authToken'); // take from the blackboard
var ty = sdk.env.get('tokenType') || 'Bearer';
if (tok) { request.headers.set('Authorization', ty + ' ' + tok); }
return request;
}

Hasil yang diharapkan​

AksiHasil
Kirim A lebih dulu (login)200, respons berisi access_token, token tersimpan
Lalu kirim B (lampirkan)200, respons {authorized:true, ...}
Nonaktifkan skrip, kirim B lagi401 (rantai pra-kirim tidak berjalan → tidak ada token yang disuntikkan — bukti bahwa skrip-lah yang melampirkannya)

Kunci: A dan B harus berada di grup yang sama yang terikat ke lingkungan yang sama (variabel runtime bersifat per lingkungan), dan fragmen path diselesaikan oleh Pre-URL lingkungan.


Skenario 2: Enkripsi AES Body Permintaan, Dekripsi Respons (Rantai Multi-Skrip)​

Tujuan: mengenkripsi body dengan AES sebelum dikirim (hanya ciphertext di kawat), mendekripsi respons setelah tiba; juga mendemonstrasikan merangkai beberapa skrip dan berbagi data di antara mereka.

Mengapa bisa dipecah menjadi beberapa skrip? Skrip dalam rantai yang sama berbagi globalThis: skrip ① menyimpan kunci/plaintext, skrip ②③ mengambilnya. Setiap skrip tetap bertugas tunggal dan dapat diaktifkan/dinonaktifkan secara independen.

Rantai pra-kirim​

Skrip ① (siapkan konteks dan kunci):

async function onRequest(context, url, request) {
globalThis.__traceId = $uuid.v4();
globalThis.__aesKey = '0123456789abcdef'; // 16 bytes → AES-128
globalThis.__aesIv = 'abcdef0123456789';
globalThis.__plain = request.body.parseText();
request.headers.set('X-Trace-Id', globalThis.__traceId);
return request;
}

Skrip ② (enkripsi body):

async function onRequest(context, url, request) {
var cipher = $crypto.encryptAES(globalThis.__plain, globalThis.__aesKey, globalThis.__aesIv);
request.body = cipher; // only ciphertext on the wire
request.headers.set('X-Encrypt', 'AES-128-CBC');
return request;
}

(Opsional) skrip ③ menambahkan logika lampirkan token dari Skenario 1.

Rantai pasca-respons (dekripsi + tulis ulang respons)​

async function onResponse(context, url, response) {
var j = response.body.parseJSON();
var cipher = j && j.body && j.body.utf8; // /echo echoes the request body in body.utf8
var recovered = cipher ? $crypto.decryptAES(cipher, globalThis.__aesKey, globalThis.__aesIv) : '';
var obj = null; try { obj = JSON.parse(recovered); } catch (e) {}
response.body = JSON.stringify({
traceId: globalThis.__traceId, decrypted: recovered,
roundtripOk: recovered === globalThis.__plain, jsonValid: !!obj,
});
return response;
}

Body permintaan (sebelum enkripsi): {"order":123,"note":"secret-payload","amount":99.5}

Hasil yang diharapkan​

Setelah mengirim Anda mendapatkan:

{"traceId":"...","decrypted":"{\"order\":123,\"note\":\"secret-payload\",\"amount\":99.5}","roundtripOk":true,"jsonValid":true}
  • roundtripOk:true: hasil dekripsi cocok dengan plaintext asli byte demi byte
  • Body respons yang ditulis ulang terlihat di hasil (bukti bahwa penulisan ulang pasca-respons berfungsi)

⚠️ Argumen $crypto adalah string posisi; saat gagal ia hanya mengembalikan string yang diawali Error: — tidak melempar atau membatalkan (terverifikasi: ciphertext buruk → Invalid ciphertext, key/iv salah → CryptoKit error). Plaintext Mandarin / non-ASCII dapat dienkripsi dan didekripsi dengan benar (klaim lama bahwa "non-ASCII membatalkan" telah terbantahkan). Jika Anda perlu menulis hasil dekripsi ke header HTTP, pastikan nilainya ASCII (nilai header menolak non-ASCII, jika tidak TypeError dilempar); letakkan konten UTF-8 di body atau query params.


Skenario 3: Ekstraksi · Assertion · Variabel Dinamis · Signing​

Sekumpulan otomatisasi ringan — sebagian besar tidak butuh JS sama sekali, memakai langkah deklaratif extract / assert.

3.1 Meneruskan bidang respons ke permintaan berikutnya (extract)​

  • Tambahkan langkah extract ke rantai pasca-respons permintaan A: variabel author, sumber response body JSON, ekspresi $.slideshow.author.
  • Tambahkan langkah skrip ke rantai pra-kirim permintaan B: var v=sdk.env.get('author'); if(v){ request.headers.set('X-Extracted', v); } return request;

Terverifikasi: /echo milik permintaan B menggemakan header X-Extracted yang cocok dengan author di respons permintaan A.

3.2 Assertion​

Tambahkan langkah assert ke rantai pasca-respons: kode status = 200, $.slideshow.title exists. Hasil didaftarkan satu per satu (lulus/gagal, harapan vs aktual).

3.3 Variabel dinamis​

Tuliskan langsung di params / headers / URL:

GET /echo?ts={{$timestamp}}&r={{$randomInt}}&u={{$uuid}}

Terverifikasi: setiap pengiriman menggemakan ts sebagai stempel waktu saat ini, r sebagai bilangan bulat acak yang berbeda, dan u sebagai UUID yang valid. Daftar lengkap: konsep, variabel dinamis.

3.4 Signing (MD5, standar dan interoperabel)​

Banyak API terbuka menandatangani dengan MD5(param concatenation + secret). Gunakan $hash.md5 standar terverifikasi:

async function onRequest(context, url, request) {
var appId = sdk.env.get('appId');
var secret = sdk.env.get('appSecret'); // keep secrets in environment variables
var ts = String(Math.floor(Date.now() / 1000));
var sign = $hash.md5(appId + ts + secret); // concatenation order per your backend's convention
request.queries.set('appId', appId);
request.queries.set('ts', ts);
request.queries.set('sign', sign);
return request;
}

Terverifikasi: $hash.md5('abc') = 900150983cd24fb0d6963f7d28e17f72, cocok dengan backend.

✅ $hmac native ($hmac.sha256(message, key) dll.) telah diverifikasi vektor demi vektor cocok dengan HMAC RFC standar (perhatikan urutan argumen: data dulu, key kedua) dan dapat digunakan untuk signing eksternal; keluarga $hash juga standar. Hanya $jwt yang menurunkan payload objek menjadi [object Object] (stringify dulu dengan JSON.stringify, atau lakukan signing di server).


Skenario 4: Gunakan Ulang Logika Bersama dengan Pustaka Skrip dan require()​

Tujuan: mengekstrak "injeksi token", "signing terpadu", dan "logging" menjadi unit yang dapat digunakan ulang — dirujuk di banyak tempat, dipelihara di satu tempat.

Dua cara untuk menggunakan ulang:

  • Langkah skrip pustaka: skrip lengkap dengan onRequest/onResponse miliknya sendiri — tambahkan sebagai langkah dan ia berjalan sesuai urutan, berbagi globalThis dengan langkah lain.
  • require(): simpan fungsi murni dalam pustaka skrip dengan module.exports, lalu muat dari skrip mana pun — paling cocok untuk helper signing, codec, dan utilitas bersama lainnya:
// script library "sign-lib" (no entry function needed)
function sign(method, path, body, secret) {
return $hmac.sha256(method + path + body, secret);
}
module.exports = { sign };
// any request script
async function onRequest(context, url, request) {
const { sign } = require('@libs/sign-lib');
request.headers.set('X-Sign', sign('POST', request.path, request.body.parseText(), sdk.env.get('appSecret')));
return request;
}

Gunakan Copy require statement di pengelola pustaka untuk bentuk identifier yang stabil. Pustaka bawaan (@libs/base64, @libs/hex) tersedia di mana saja tanpa pengaturan. Mekanika lengkap: scripting, Pustaka Skrip require.


Lembar Contekan Skenario​

Saya ingin…Langkah mana
Melampirkan token otomatis di setiap API setelah loginSkrip pasca-respons menyimpan + skrip pra-kirim membaca dan menyuntikkan header
Mengenkripsi body permintaan / mendekripsi respons$crypto.encryptAES pra-kirim + decryptAES pasca-respons
Meneruskan bidang respons ke permintaan berikutnyaLangkah extract + skrip yang membaca variabel
Memvalidasi kode status / bidangLangkah assert
Menghasilkan nilai acak / stempel waktu setiap pengirimanVariabel dinamis seperti {{$uuid}}
Menandatangani API terbuka$hash.md5(...) (standar)
Menggunakan ulang logika yang sama di banyak tempatSkrip pustaka, atau require('@libs/<key>') sebuah pustaka skrip