Edge Security Acceleration:Konfigurasikan nama domain

Prasyarat

Baik Custom Domains maupun Routes memerlukan situs aktif di akun Anda.

Situs aktif memiliki paket yang telah dibeli dan terhubung menggunakan Rekaman NS atau CNAME.

Pilih metode konfigurasi

Bind domain kustom

Gunakan Custom Domains untuk mengarahkan seluruh trafik dari suatu domain ke satu instans Functions and Pages.

Hubungkan Functions and Pages ke domain situs Anda. Setelah binding, akses Functions and Pages melalui domain kustom tersebut. Domain yang di-bind ke Functions and Pages harus termasuk dalam situs yang tersedia. ESA secara otomatis menambahkan Rekaman DNS untuk domain yang di-bind tersebut.

1. Masuk ke ESA console. Di panel navigasi sebelah kiri, pilih Edge Computing > Functions and Pages. Klik instans Functions and Pages yang dituju.

2. Klik tab Domain Names. Di bagian Custom Domains, klik Add Domain Name.

3. Masukkan nama domain yang akan di-bind ke instans Functions and Pages Anda, misalnya pages.example.com. ESA secara otomatis membuat Rekaman DNS untuk domain tersebut pada situs yang sesuai.

   Catatan

   Domain baru mewarisi konfigurasi situsnya. Jika situs tidak memiliki Sertifikat SSL/TLS, domain tersebut tidak dapat diakses melalui HTTPS. Konfigurasikan SSL/TLS untuk mengaktifkan akses HTTPS.

   

4. Lanjutkan langkah berikutnya berdasarkan metode koneksi situs Anda.

   Rekaman NS

   Jika situs Anda menggunakan Rekaman NS, tunggu sekitar satu menit hingga Rekaman DNS berlaku. Kemudian, buka browser dan kunjungi domain kustom tersebut, misalnya pages.example.com, untuk melihat hasilnya.

   Rekaman CNAME

   Jika situs Anda menggunakan Rekaman CNAME, tambahkan Rekaman CNAME di penyedia DNS Anda untuk mengaktifkan domain tersebut.

   1. Di daftar domain kustom, temukan domain baru Anda dan klik View DNS Records.

      

   2. Salin nilai CNAME yang dihasilkan oleh ESA.

      

   3. Buka situs web penyedia DNS Anda dan tambahkan Rekaman CNAME dengan informasi berikut:

      • Host Record: Masukkan awalan domain kustom tersebut. Untuk contoh ini, masukkan pages.

      • Record Type: Pilih CNAME.

      • Record Value: Tempel nilai CNAME yang telah Anda salin pada langkah sebelumnya.

      

   4. Kembali ke Konsol ESA dan tunggu hingga CNAME Status menampilkan Configured.Anda kemudian dapat melihat halaman tersebut dengan mengunjungi domain kustom yang baru saja di-bind, misalnya pages.example.com, di browser.

Konfigurasikan Routes

Arahkan permintaan yang sesuai dengan path URL tertentu ke instans Functions and Pages untuk kontrol trafik detail halus. Permintaan yang sesuai diproses oleh Functions and Pages; permintaan yang tidak sesuai tetap mengikuti alur akselerasi dan cache standar ESA. Misalnya, route untuk example.com/a* pada situs example.com mengirim permintaan ke /a, /a1, dan /a2 ke Functions and Pages, sedangkan permintaan ke /b, /c, dan /d diarahkan ke origin atau cache.

1. Masuk ke ESA console. Di panel navigasi sebelah kiri, pilih Edge Computing > Functions and Pages. Klik instans Functions and Pages yang dituju.

2. Klik tab Domain Names. Di bagian Routes, klik Add Route.

3. Masukkan Route Name. Dari daftar Select Website, pilih situs target, misalnya example.com.

4. Pilih Route Mode.

   1. Simple Mode: Mencocokkan permintaan hanya berdasarkan URL (hostname dan path). Misalnya, Anda dapat mengonfigurasi aturan untuk mengarahkan semua permintaan dengan awalan URL pages.example.com ke instans Functions and Pages Anda.

   2. Custom Mode: Gabungkan beberapa kondisi seperti header permintaan, cookie, dan metode permintaan untuk pencocokan kompleks. Atur hubungan logis antar kondisi (Semua/Salah satu). Misalnya, teruskan permintaan ke Functions and Pages hanya jika Hostname sama dengan www.example.com dan header permintaan User-Agent berisi Mobile:

5. Buka browser dan kunjungi URL yang sesuai dengan route tersebut untuk melihat hasilnya.

   

Mode Bypass

Mengaktifkan Bypass mode untuk suatu route mengirimkan permintaan yang cocok ke layanan Functions and Pages sebagai subpermintaan. Gunakan mode ini untuk otentikasi atau pencatatan tanpa mengganggu alur permintaan utama ke origin:

1. Klien mengirim permintaan ke Titik kehadiran (POP) ESA.

2. Permintaan tersebut cocok dengan suatu route dan diteruskan ke Functions and Pages untuk operasi seperti logging atau otentikasi. Dalam mode bypass, badan permintaan tidak diteruskan ke Functions and Pages.

3. Jika Functions and Pages mengembalikan kode status 200, permintaan dilanjutkan ke langkah berikutnya. Jika mengembalikan kode status lain, ESA menghentikan pemrosesan dan mengembalikan kode status 403 ke klien.

4. Permintaan dilanjutkan melalui alur standar ESA, di mana permintaan tersebut diperiksa berdasarkan kebijakan cache atau diteruskan ke server origin.

5. Tanggapan dari cache hit atau server origin dikembalikan ke node ESA. Pada titik ini, tanggapan tidak lagi diproses oleh Functions and Pages.

6. Tanggapan dikirim ke klien.

Kasus penggunaan

• Pencatatan (Logging): Gunakan mode bypass untuk meneruskan permintaan tertentu ke Functions and Pages dan definisikan logika pencatatan kustom dalam fungsi Anda.

• Otentikasi untuk unduhan file besar: Meneruskan respons besar melalui fungsi menghabiskan waktu CPU yang signifikan dan meningkatkan biaya. Gunakan mode bypass untuk mengotentikasi dengan Functions and Pages terlebih dahulu, sehingga transfer file besar tidak melewati fungsi tersebut.

FAQ

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get('auth_key');

  const privateKey = 'your_secret_key'
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // Dalam skenario kegagalan otentikasi, node edge mengembalikan error 403 ke klien secara default.
    return new Response('Unauthorized', { 
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split('-');

  if (currentTimestamp > parseInt(timestamp)+ delta) {
    // Dalam skenario kegagalan otentikasi, node edge mengembalikan error 403 ke klien secara default.
    return new Response('Link expired', {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join('-');

  const md5 = createHash('md5').update(signString).digest('hex');

  if (md5 !== signature) {
  
    return new Response('Unauthorized', {
      status: 401
    });
  }

  // Jika resource berada di domain lain, ambil dan kembalikan responsnya.
  // const yourUrl = `https://your-dcdn-domain.com${path}${url.search}`
  // const cdnResponse = await fetch(yourUrl, request)
  // return new Response(cdnResponse.body, cdnResponse)

  // Dalam kebanyakan kasus, mengambil dari origin sudah cukup.
  return fetch(request.url)
}

export default {
  async fetch(request) {
    return handleRequest(request)
  }
}

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get("auth_key");

  const privateKey = "your_secret_key";
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // Otentikasi gagal. Jika Anda memberikan false, node edge mengembalikan error 403 ke klien secara default.
    return new ResponseBypass(false, {
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split("-");

  if (currentTimestamp > parseInt(timestamp) + delta) {
    // Otentikasi gagal. Jika Anda memberikan false, node edge mengembalikan error 403 ke klien secara default.
    return new ResponseBypass(false, {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join("-");

  const md5 = createHash("md5").update(signString).digest("hex");

  if (md5 !== signature) {
    // Otentikasi gagal. Jika Anda memberikan false, node edge mengembalikan error 403 ke klien secara default.
    return new ResponseBypass(false, {
      status: 401,
    });
  }

  // Otentikasi berhasil. Jika Anda memberikan true, permintaan dilanjutkan ke origin, dan respons tidak lagi diproses oleh fungsi ini.
  const resSuccess = new ResponseBypass(true);
  return resSuccess;
}

export default {
  async bypass(request) {
    return handleRequest(request);
  },
};