การป้องกันการนำลิงก์ไปใช้ด้วย Signed URL

ByteArk Qoder ได้หยุดการพัฒนาและการให้บริการแล้ว

แนะนำให้ใช้ ByteArk Stream เพื่อรับการอัปเดตฟีเจอร์ใหม่ ๆ

หากคุณยังใช้งาน ByteArk Qoder อยู่ สามารถติดต่อ support@byteark.com เพื่อย้ายมาใช้งาน ByteArk Stream

หากคุณไม่ต้องการให้ผู้อื่น นำลิงก์ของคอนเทนต์ไปใช้บนเว็บหรือแอพลิเคชันอื่นโดยตรง โดยที่ไม่ได้รับอนุญาต สามารถบังคับให้ผู้ใช้ต้องเรียกผ่าน Signed URL ได้

Signed URL คือ URL ที่ถูกสร้างขึ้นจาก URL ปกติ แต่เพิ่มคิวรีสตริงบังคับลงไป โดย Signed URL นั้นจะเรียกใช้ได้ตามปกติ เมื่อมีการเรียกใช้ถูกต้องตามเงื่อนไขที่ผู้สร้างกำหนดไว้ และ Signed URL นั้นยังไม่หมดอายุแล้วเท่านั้น

การสร้าง Signed URL ด้วย SDK

เราได้จัดเตรียม SDK สำหรับสร้าง Signed URL ด้วยภาษาโปรแกรมยอดนิยมไว้ให้ใช้ได้ดังนี้

• NodeJS (byteark/byteark-sdk-js) (opens new window)
• PHP (byteark/byteark-sdk-php) (opens new window)
• Go (byteark/byteark-sdk-go) (opens new window)

ตัวอย่างโค้ดวิธีการสร้าง Signed URL

WARNING

สำหรับการสร้าง Signed URL เพื่อใช้กับ Live Streaming นั้นจะต้องระบุออพชัน path_prefix เสมอ

วิธีการติดตั้ง

npm install --save byteark-sdk

ตัวอย่างโค้ด

import { ByteArkV2UrlSigner } from 'byteark-sdk';
const signer = new ByteArkV2UrlSigner({
  access_id: '<your-signing-key>',
  access_secret: '<your-signing-secret>',
});
// This sample will making a 1-day expired signed URL
const expireTimestamp = Math.floor(Date.now() / 1000) + 86400;
const signedUrl = signer.sign(
  'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
  expireTimestamp,
  {
    path_prefix: '/streams/UPXgozvHr2gj/'
  }
);
console.log(signedUrl);
/*
Output:
https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8?
  x_ark_access_id=key-SzNuhsi9wWvbH326&
  x_ark_auth_type=ark-v2&
  x_ark_expires=1731547121&
  x_ark_path_prefix=%2Fstreams%2FUPXgozvHr2gj%2F&
  x_ark_signature=raG4MjvGqyzgWLvOcIUVjQ
*/

วิธีการติดตั้ง

composer install byteark-sdk

ตัวอย่างโค้ด

<?php
// Creating a signer instance
// TODO: Please replace signing key and secret with your own
$signer = new \ByteArk\Signer\ByteArkV2UrlSigner([
  access_id => '<your-signing-key>',
  access_secret => '<your-signing-secret>'
]);
// This sample will making a 1-day expired signed URL
$expireTimestamp = time() + 86400;
$signedUrl = $signer->sign(
  'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
  $expireTimestamp,
  [
    'method' => 'GET',
    path_prefix: '/streams/UPXgozvHr2gj/'
  ]
);
echo($signedUrl);
/*
Output:
https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8?
  x_ark_access_id=key-SzNuhsi9wWvbH326&
  x_ark_auth_type=ark-v2&
  x_ark_expires=1731547121&
  x_ark_path_prefix=%2Fstreams%2FUPXgozvHr2gj%2F&
  x_ark_signature=raG4MjvGqyzgWLvOcIUVjQ
*/

เงื่อนไขการใช้งาน Signed URL ที่สามารถบังคับได้

x_ark_expires (จำเป็นต้องใช้)

กำหนดเวลาหมดอายุของลิงก์เป็น Unix Timestamp หากมีผู้เรียกใช้ลิงก์เมื่อพ้นเวลาที่ระบุไปแล้ว จะได้ Error Response โดยมี Status เป็น 410 Gone

x_ark_path_prefix (จำเป็นต้องใช้)

กำหนดให้ Signature ที่สร้างขึ้นสามารถใช้ได้กับ Signed URL นี้ และ Signed URL อื่นๆ ที่มีพาธขึ้นต้นตรงกับที่ระบุไว้ มักใช้เพื่อสร้าง Signed URL ครั้งเดียวเพื่อให้สิทธิ์เรียก URL ในไดเรกทอรีนั้นๆ ทั้งหมด

ให้ระบุ path_prefix เป็นพาธตั้งต้นก่อนถึงส่วนที่เป็น playlist.m3u8

x_ark_geo_allow

กำหนดให้ URL นี้เรียกได้จากประเทศที่ระบุเท่านั้น หากต้องการระบุหลายประเทศให้คั่นด้วย ,

x_ark_geo_block

กำหนดให้ URL นี้ไม่สามารถเรียกได้จากประเทศที่ระบุ หากต้องการระบุหลายประเทศให้คั่นด้วย ,