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

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

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

ขั้นตอนการเปิดใช้คุณสมบัติ Signed URL ใน ByteArk Stream

ขั้นตอนการเปิดใช้คุณสมบัติ Signed URL ใน ByteArk Stream ประกอบด้วย 3 ขั้นตอนหลักดังนี้

1. สร้าง URL signing key ที่จะต้องใช้
2. แก้ไขซอร์สโค้ดเพื่อสร้าง Signed URL สำหรับเล่นวิดีโอ
3. เปิดบังคับใช้ Signed URL

(1) สร้าง URL signing key ที่จะต้องใช้

หลังจากมีการเข้าใช้ ByteArk Stream และสร้าง Project สำหรับจัดการวิดีโอแล้ว ให้ไปที่เมนู Management เพื่อตั้งค่า Secure & Protect และ Signed URL เพื่อเปิดใช้งานคุณสมบัติ Signed-URL

การเปิดใช้ Signed URL จะเป็นการตั้งค่าสำหรับแต่ละ Playback Channel ที่กำหนด ให้เลือกที่ Playback Channel ที่ใช้งานอยู่ แล้วไปที่เมนู "การบังคับใช้ Signed URL" แล้วกด "เพิ่ม URL Signing Key" เพื่อสร้าง Access Key และ Secret Key สำหรับใช้ในขั้นตอนการสร้าง Signed URL ถัดไป

WARNING

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

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

(2) แก้ไขซอร์สโค้ดเพื่อสร้าง Signed URL สำหรับเล่นวิดีโอ

แก้ไขซอร์สโค้ดของแอปพลิเคชันของท่าน เพื่อให้เล่นวิดีโอจาก URL ที่สร้างด้วยวิธีการ Signed URL แทนการเล่นจาก URL แบบปกติ

เราได้จัดเตรียม 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

สำหรับโปรเจกต์ที่ใช้ NodeJS และใช้ระบบโมดูลแบบ CommonJS (import library ต่างๆ โดยใช้ฟังก์ชัน require)

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

npm install --save byteark-sdk

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

const { ByteArkV2UrlSigner } = require('byteark-sdk');
// Creating a signer instance
// TODO: Please replace signing key and secret with your own
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;
// Creating a signed URL
const signedUrl = signer.sign(
  'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
  expireTimestamp
);
// We'll just print the signed URL here.
// You may use this URL in your video player.
console.log(signedUrl)
/*
Output:
'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
    ?x_ark_access_id=2Aj6Wkge4hi1ZYLp0DBG
    &x_ark_auth_type=ark-v2
    &x_ark_expires=1514764800
    &x_ark_signature=OsBgZpn9LTAJowa0UUhlYQ
*/

สำหรับโปรเจกต์ที่ใช้ NodeJS และใช้ระบบโมดูลแบบ ESM (import library ต่างๆ โดยใช้คำสั่ง import)

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

npm install --save byteark-sdk

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

import { ByteArkV2UrlSigner } from 'byteark-sdk';
// Creating a signer instance
// TODO: Please replace signing key and secret with your own
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;
// Creating a signed URL
const signedUrl = signer.sign(
  'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
  expireTimestamp
);
// We'll just print the signed URL here.
// You may use this URL in your video player.
console.log(signedUrl)
/*
Output:
'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
    ?x_ark_access_id=2Aj6Wkge4hi1ZYLp0DBG
    &x_ark_auth_type=ark-v2
    &x_ark_expires=1514764800
    &x_ark_signature=OsBgZpn9LTAJowa0UUhlYQ
*/

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

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;
// Creating a signed URL
$signedUrl = $signer->sign(
  'https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8',
  $expireTimestamp
);
// We'll just print the signed URL here.
// You may use this URL in your video player.
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_signature=raG4MjvGqyzgWLvOcIUVjQ
*/

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

go get github.com/byteark/byteark-sdk-go

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

import (
  "fmt"
  "time"
  bytearkSignedURL "github.com/byteark/byteark-sdk-go"
)
// Creating a signer instance
// TODO: Please replace signing key and secret with your own
signerOptions :=  bytearkSignedURL.SignerOptions{
  AccessID:     "<your-signing-key>",
  AccessSecret: "<your-signing-secret>",
}
createSignerErr := bytearkSignedURL.CreateSigner(signerOptions)
if createSignerErr != nil {
  panic(createSignerErr)
}
// This sample will making a 1-day expired signed URL
expireTimestamp := time.Now().Add(time.Hour * 24).Unix()
// Creating a signed URL
signedURL, err := bytearkSignedURL.Sign(
  "https://byteark-slehxnn9ug5e.stream-playlist.byteark.com/streams/UPXgozvHr2gj/playlist.m3u8",
  expireTimestamp,
  signOptions,
)
// We'll just print the signed URL here.
// You may use this URL in your video player.
fmt.Println(signedURL)
/*
Output:
https://example.cdn.byteark.com/path/to/file.png
    ?x_ark_access_id=2Aj6Wkge4hi1ZYLp0DBG
    &x_ark_auth_type=ark-v2
    &x_ark_expires=1514764800
    &x_ark_signature=OsBgZpn9LTAJowa0UUhlYQ
*/

(3) เปิดบังคับใช้ Signed URL

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

TIP

เมื่อเปิดบังคับใช้งานแล้ว การบังคับใช้จะมีผลภายใน 1-2 นาที