Panduan Pengguna DRM-X 5.0 Encryption SDK

1Isi Paket SDK

Setelah mengekstrak arsip DRM-X5.0_Encryption_SDK, direktori berisi file-file berikut:

Argumen baris perintah identik di ketiga platform — hanya nama file program yang berbeda.

2Ikhtisar Alur Kerja Enkripsi

Mengapa memanggil Layanan Web DRM-X 5.0 terlebih dahulu?Argumen -profile program enkripsi bukanlah ID numerik dari profil lisensi — melainkan string terenkripsi yang terikat pada akun Anda (ProfileEncryptedParam). String ini tidak dapat dihasilkan secara lokal; hanya dapat diperoleh melalui Layanan Web. String ini dipetakan satu-ke-satu ke ProfileID, dan setelah diperoleh dapat disimpan dalam cache dan digunakan kembali — Anda tidak perlu memanggil Layanan Web untuk setiap file. Nilai Base64 dari jalur input / output, sebaliknya, harus dikodekan secara lokal di program Anda (lihat Bagian 6) — tidak perlu panggilan Layanan Web untuk itu.

3Prasyarat

3.1 Informasi Akun DRM-X 5.0 (diperoleh dari konsol admin DRM-X)

3.2 Persyaratan Lingkungan Server

Pengingat keamanan: WebServiceAuthStr setara dengan kunci akun. Harus disimpan hanya di sisi server — jangan pernah menempatkannya di halaman web front-end, perangkat lunak klien, atau repositori publik.

4Langkah Satu: Panggil Layanan Web DRM-X 5.0 untuk Mendapatkan Parameter Enkripsi

4.1 Informasi Layanan Web

Endpoint harus sesuai dengan edisi akun Anda: akun internasional menggunakan 5.drm-x.com (baris perintah: -server_domain com); akun China menggunakan 5.drm-x.cn (baris perintah: -server_domain cn). Menggunakan edisi yang salah akan menyebabkan autentikasi gagal, atau file terenkripsi tidak dapat diputar.

4.2 Parameter Permintaan

4.3 Pemetaan Antara Bidang Respons dan Argumen Baris Perintah (Inti)

4.4 Contoh Pemanggilan (PHP / SoapClient)

Layanan Web ini adalah layanan SOAP 1.1 standar yang dapat dipanggil dari bahasa apa pun, dengan cara yang sama dan seragam: POST envelope SOAP ke endpoint yang tercantum di 4.1 (atau minta klien SOAP menghasilkannya secara otomatis dari ?WSDL), lewati parameter dari 4.2, lalu baca tiga bidang dari 4.3 dalam respons. Pustaka klien SOAP umum berdasarkan bahasa:

Contoh berikut menggunakan SoapClient PHP untuk mendemonstrasikan panggilan lengkap. Simpan kode sebagai get_params.php di server Anda dan jalankan (PHP 7.4+ dengan ekstensi soap diaktifkan) — ini mencetak tiga nilai argumen baris perintah:

<?php
// ========== Configuration (edit to match your account) ==========
$wsdl              = 'https://5.drm-x.com/haihaisoftlicenseservice.asmx?WSDL';  // China edition: https://5.drm-x.cn/...
$adminEmail        = 'admin@example.com';
$webServiceAuthStr = 'YOUR_AUTH_STRING';
$profileID         = '1001';
$input             = '/home/video/course01.mp4';
$output            = '/home/video/encrypted/course01_P.mp4';

// ========== Create a SoapClient (WSDL mode; the SOAP envelope is generated automatically) ==========
$client = new SoapClient($wsdl, [
    'soap_version'       => SOAP_1_1,
    'connection_timeout' => 20,
    'trace'              => true,          // enables __getLastRequest() for inspecting the raw request
]);

// ========== Call the method: the method name is the WSDL operation; arguments are an associative array ==========
$resp = $client->GetPackagerEncryptedParams([
    'AdminEmail'            => $adminEmail,
    'WebServiceAuthStr'     => $webServiceAuthStr,
    'ProfileID'             => $profileID,
    'Input'                 => $input,
    'Output'                => $output,
    'ProfileEncryptedParam' => '',
    'enc_Input'             => '',
    'enc_Output'            => '',
]);

// ========== The response is mapped to a stdClass object; read the fields directly ==========
$result  = $resp->GetPackagerEncryptedParamsResult;
$profile = $resp->ProfileEncryptedParam;   // this is the -profile argument value

if ($profile === '') {
    die("Call failed: $result\n");   // e.g. authentication errors appear here
}

// -profile: one call per ProfileID is enough. Cache it and reuse it —
//           do not call the Web Service again for every file you encrypt.
echo "-profile = $profile\n";

// Input / output paths: Base64-encode them locally (UTF-8). No Web Service call needed.
// If your PHP source file is saved as UTF-8, the strings are already UTF-8.
// Other languages work the same way: convert to UTF-8 bytes first, then Base64.
// (The service also returns enc_Input / enc_Output with the same values — either source is fine.)
$encIn  = base64_encode($input);
$encOut = base64_encode($output);
echo "-input_file_utf8_base64_encoded = $encIn\n";
echo "-output_file_utf8_base64_encoded = $encOut\n";

5Langkah Dua: Jalankan Perintah Enkripsi

5.1 Penggunaan Pertama (Linux / macOS)

Di terminal, masuk ke direktori program dan berikan izin eksekusi terlebih dahulu:

# Linux
chmod +x drm-x5-encrypt-sdk-linux-x86_64

# macOS (pick the one matching your architecture)
chmod +x drm-x5-encrypt-sdk-macos-x86_64
chmod +x drm-x5-encrypt-sdk-macos-arm64

5.2 Templat Perintah Enkripsi File Tunggal

Windows (cmd / PowerShell):

drm-x5-encrypt-sdk.exe -server_domain com -profile <ProfileEncryptedParam value> -input_file_utf8_base64_encoded <Base64 of the input path> -output_file_utf8_base64_encoded <Base64 of the output path>

Linux:

./drm-x5-encrypt-sdk-linux-x86_64 -server_domain com -profile <ProfileEncryptedParam value> -input_file_utf8_base64_encoded <Base64 of the input path> -output_file_utf8_base64_encoded <Base64 of the output path>

macOS:

./drm-x5-encrypt-sdk-macos-arm64 -server_domain com -profile <ProfileEncryptedParam value> -input_file_utf8_base64_encoded <Base64 of the input path> -output_file_utf8_base64_encoded <Base64 of the output path>

5.3 Referensi Argumen

5.4 Contoh Lengkap

Windows:

drm-x5-encrypt-sdk.exe -server_domain com -profile UMuAZfLDToYGfmigBsRbklanDHRBoRrLrsTkI_W52KVnPcC-ZL-KU4UssGDA8Uja-4URQqsxw7WPsZL-CPWYQQj1jdwQsSbLri9_Q3YvPysCfMNtXKBHZvhrWlcsmNMg8FVqm7KFgr4ODrSQxAXgFV -input_file_utf8_base64_encoded RDpcSmFzb25caW5wdXRcMDEtdGVzdFZpZGVvLm1wNA== -output_file_utf8_base64_encoded RDpcSmFzb25cb3V0cHV0XDAxLXRlc3RWaWRlb19QLm1wNA==

Di sini RDpcSmFzb25c... didekode menjadi D:\Jason\input\01-testVideo.mp4.

Linux:

./drm-x5-encrypt-sdk-linux-x86_64 -server_domain com -profile s5Gls5QDAz4LyC_USkG9rY0fyDU4cN90HhgvOe6-67OUn92UFWRFdv4N_7Qx-Ipxa_M5d123ZQEesB1BPnGkUs-HkFTwI1pZEwaj133IRLhaxuUfOpBBROkKZpPk_QxBKvoxiX4NVL-Rs6g457jWsV -input_file_utf8_base64_encoded Li9pbnB1dC8wMS1saW51eC1lbmNyeXB0LXZpZGVvLm1wNA== -output_file_utf8_base64_encoded Li9vdXRwdXQvMDEtbGludXgtZW5jcnlwdC12aWRlbzJfUC5tcDQ=

Ini mengenkripsi ./input/01-linux-encrypt-video.mp4 → ./output/01-linux-encrypt-video2_P.mp4.

5.5 Memverifikasi Hasil

• Saat program selesai, periksa bahwa file terenkripsi telah dibuat di direktori output (sufiks _P disarankan untuk membedakannya, misalnya course01_P.mp4);
• Enkripsi memerlukan akses jaringan ke server DRM-X. Pastikan firewall / grup keamanan Anda mengizinkan akses keluar ke 5.drm-x.com atau 5.drm-x.cn;
• Disarankan untuk memverifikasi alur kerja lengkap dengan video uji kecil sebelum mengenkripsi konten produksi secara batch.

6Pengodean Base64 pada Jalur Input / Output (Pengodean Lokal Disarankan)

Praktik yang disarankan: hasilkan nilai -input_file_utf8_base64_encoded / -output_file_utf8_base64_encoded dengan mengodekannya di program Anda sendiri — tidak perlu memanggil Layanan Web sekali per file. Aturan pengodean: pertama konversikan string jalur ke byte UTF-8, lalu terapkan pengodean Base64 standar. Catatan: file sumber Anda harus disimpan sebagai UTF-8 (ini penting terutama untuk jalur non-ASCII; di Windows, jangan gunakan pengodean ANSI / GBK). Contoh berdasarkan bahasa:

Untuk menegaskan kembali: tidak ada cara untuk menghasilkan argumen -profile secara lokal. Ini adalah string terenkripsi yang terikat pada akun Anda dan hanya dapat diperoleh melalui Layanan Web GetPackagerEncryptedParams.

7Contoh Otomatisasi Sisi Server

Merangkai "dapatkan parameter + panggil program enkripsi" memungkinkan enkripsi sekali klik dari back office situs web Anda, atau enkripsi batch terjadwal. Contoh PHP berikut memanggil program enkripsi Linux (melanjutkan dari kode di Bagian 4.4; saat runtime, $profile harus dibaca dari cache terlebih dahulu, dan Layanan Web di 4.4 hanya dipanggil bila tidak ada nilai yang di-cache):

<?php
// ...continuing from Section 4.4, with $profile / $encIn / $encOut already obtained:

$packager = '/opt/drmx5/drm-x5-encrypt-sdk-linux-x86_64';   // absolute path to the encryption program
$domain   = 'com';                                        // com = International, cn = China

// Make sure the output directory exists (the program does not create it)
$outDir = dirname(base64_decode($encOut));
if (!is_dir($outDir)) { mkdir($outDir, 0755, true); }

// Assemble and execute the command (escapeshellarg prevents injection; the argument
// values are Base64 and contain no spaces, so this is double protection)
$cmd = $packager
     . ' -server_domain '   . escapeshellarg($domain)
     . ' -profile '         . escapeshellarg($profile)
     . ' -input_file_utf8_base64_encoded '  . escapeshellarg($encIn)
     . ' -output_file_utf8_base64_encoded ' . escapeshellarg($encOut);

exec($cmd, $outLines, $exitCode);
echo 'Exit code: ' . $exitCode . PHP_EOL . implode(PHP_EOL, $outLines);

Contoh skrip shell enkripsi batch (Linux — mengodekan jalur secara lokal, lalu mengenkripsi setiap file):

#!/bin/bash
# batch_encrypt.sh — batch-encrypt all mp4 files under ./input into ./output
ADMIN_EMAIL="admin@example.com"
AUTH_STR="YOUR_AUTH_STRING"
PROFILE_ID="1001"
PACKAGER="./drm-x5-encrypt-sdk-linux-x86_64"
DOMAIN="com"   # China edition: change to cn

mkdir -p ./output
for f in ./input/*.mp4; do
  name=$(basename "$f" .mp4)
  out="./output/${name}_P.mp4"
  # Base64-encode the paths locally (UTF-8)
  in_b64=$(printf '%s' "$f"  | base64 -w0)
  out_b64=$(printf '%s' "$out" | base64 -w0)
  # The -profile string should be obtained once by your server via the Web Service
  # and cached — the same ProfileID's value can be reused for every file.
  "$PACKAGER" -server_domain "$DOMAIN" -profile "$PROFILE_ENC" \
      -input_file_utf8_base64_encoded "$in_b64" \
      -output_file_utf8_base64_encoded "$out_b64"
  echo "[done] $out"
done

Praktik yang disarankan: ambil ProfileEncryptedParam untuk ProfileID tertentu sekali melalui Layanan Web dan simpan dalam cache untuk digunakan kembali — jangan memanggil Layanan Web sekali per file terenkripsi. Hasilkan padanan enc_Input / enc_Output secara langsung dengan mengodekan Base64 (UTF-8) jalur di server Anda (di PHP: base64_encode($path), lihat Bagian 6) — tidak perlu panggilan Layanan Web. Saat mengenkripsi secara batch, batasi konkurensi (misalnya 2-4 proses enkripsi per server) untuk menghindari kejenuhan bandwidth dan CPU.

8Pertanyaan yang Sering Diajukan (FAQ)

Q1: Layanan Web mengembalikan "Your XML web service login info is not correct..."

AdminEmail atau WebServiceAuthStr salah. Periksa keduanya di konsol admin DRM-X; pastikan nilainya tidak memiliki spasi di awal atau akhir. Perhatikan juga bahwa bahkan untuk kesalahan ini kode status HTTP masih 200 — program Anda harus menentukan keberhasilan dengan memeriksa bidang respons, bukan kode status HTTP.

Q2: Memberikan ID numerik (misalnya 1001) langsung ke -profile menyebabkan kesalahan

-profile harus berupa string terenkripsi ProfileEncryptedParam lengkap yang dikembalikan oleh Layanan Web — bukan ID Profil numerik. ID numerik hanya digunakan saat memanggil Layanan Web.

Q3: Jalur berisi karakter non-ASCII atau spasi dan enkripsi gagal?

Jalur ditransportasikan sebagai Base64, dan karakter non-ASCII serta spasi didukung sepenuhnya. Kuncinya adalah pengodean harus menggunakan UTF-8: di Windows, Notepad / cmd mungkin default ke pengodean ANSI (GBK), yang merusak jalur setelah dekode Base64. Kodekan jalur sebagai UTF-8 di program Anda seperti yang dijelaskan di Bagian 6 (dengan file sumber PHP yang disimpan sebagai UTF-8, base64_encode() biasa berfungsi langsung; string lama yang dikodekan GBK dapat dikonversi terlebih dahulu dengan iconv('GBK', 'UTF-8', $path) atau mb_convert_encoding() sebelum pengodean).

Q4: Program melaporkan kegagalan output / tidak dapat menemukan direktori output

Direktori induk file output harus dibuat terlebih dahulu (misalnya mkdir -p ./output). Juga verifikasi bahwa pengguna yang menjalankan program memiliki izin tulis untuk direktori tersebut.

Q5: macOS mengatakan program "cannot be opened because the developer cannot be verified"

Program ini tidak dinotarisasi oleh Apple, sehingga Gatekeeper memblokir peluncuran pertama. Pilih salah satu solusi: ① Jalankan xattr -d com.apple.quarantine ./drm-x5-encrypt-sdk-macos-arm64 di terminal untuk menghapus tanda karantina; ② Atau klik "Open Anyway" di System Settings → Privacy & Security.

Q6: Di Linux program tidak dapat dieksekusi (Permission denied atau kesalahan format)

Jalankan chmod +x drm-x5-encrypt-sdk-linux-x86_64 terlebih dahulu. Jika Anda mendapatkan "cannot execute binary file", konfirmasi bahwa server adalah x86_64 (uname -m). Paket saat ini hanya menyertakan build x86_64; untuk server ARM silakan hubungi Haihaisoft.

Q7: Haruskah saya menggunakan com atau cn? Apa yang terjadi jika saya memilih yang salah?

Harus sesuai dengan platform akun DRM-X Anda: akun internasional menggunakan com (dan memanggil 5.drm-x.com), akun China menggunakan cn (dan memanggil 5.drm-x.cn). Ketidakcocokan menyebabkan kegagalan autentikasi, atau parameter enkripsi yang tidak sesuai dengan platform.

Q8: Bagaimana cara memverifikasi file terenkripsi?

Buka file output di pemutar demo DRM-X 5.0 / pemutar terintegrasi Anda dan konfirmasi: pemutaran diblokir tanpa lisensi, dan berputar normal setelah mengotorisasi pengguna uji di konsol admin. Verifikasi dalam skala kecil sebelum enkripsi produksi massal.

9Catatan dan Praktik Terbaik

• Simpan file asli: tulis output ke lokasi baru atau nama file baru (misalnya dengan sufiks _P) sehingga video asli tidak pernah ditimpa.
• Kecil sebelum besar: saat menggunakan profil baru atau server baru untuk pertama kalinya, jalankan satu video uji pendek melalui seluruh alur "ambil parameter → enkripsi → pemutaran berlisensi" sebelum pemrosesan batch.
• Jangan pernah mengedit argumen secara manual: -profile adalah string terenkripsi Base64 — salin sepenuhnya (tanpa spasi ekstra di awal/akhir, tanpa pemotongan akibat pembungkusan baris).
• Jaga kerahasiaan string autentikasi: WebServiceAuthStr hanya boleh ada dalam konfigurasi sisi server; jangan menyebarkan alat web demo seperti GetPackagerEncryptedParams.php ke internet publik.
• Persyaratan jaringan: selama enkripsi, server harus dapat menjangkau server DRM-X (Internasional 5.drm-x.com / China 5.drm-x.cn); izinkan port keluar 443 jika ada firewall.