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.
- Skenario 1: login untuk token, lampirkan otomatis untuk seluruh grup
- Skenario 2: enkripsi AES body permintaan, dekripsi respons (rantai multi-skrip)
- Skenario 3: ekstraksi · assertion · variabel dinamis · signing
- Skenario 4: gunakan ulang logika bersama dengan pustaka skrip dan
require()
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
| Aksi | Hasil |
|---|---|
| Kirim A lebih dulu (login) | 200, respons berisi access_token, token tersimpan |
| Lalu kirim B (lampirkan) | 200, respons {authorized:true, ...} |
| Nonaktifkan skrip, kirim B lagi | 401 (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
$cryptoadalah string posisi; saat gagal ia hanya mengembalikan string yang diawaliError:— 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 tidakTypeErrordilempar); 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, sumberresponse 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.
✅
$hmacnative ($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$hashjuga standar. Hanya$jwtyang menurunkan payload objek menjadi[object Object](stringify dulu denganJSON.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/onResponsemiliknya sendiri — tambahkan sebagai langkah dan ia berjalan sesuai urutan, berbagiglobalThisdengan langkah lain. require(): simpan fungsi murni dalam pustaka skrip denganmodule.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 login | Skrip 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 berikutnya | Langkah extract + skrip yang membaca variabel |
| Memvalidasi kode status / bidang | Langkah assert |
| Menghasilkan nilai acak / stempel waktu setiap pengiriman | Variabel dinamis seperti {{$uuid}} |
| Menandatangani API terbuka | $hash.md5(...) (standar) |
| Menggunakan ulang logika yang sama di banyak tempat | Skrip pustaka, atau require('@libs/<key>') sebuah pustaka skrip |