DRM-X 5.0 暗号化 SDK ユーザーガイド

1SDK パッケージの内容

DRM-X5.0_Encryption_SDK アーカイブを展開すると、ディレクトリには以下のファイルが含まれています：

コマンドライン引数は 3 つのプラットフォームすべてで同一です — 異なるのはプログラムファイル名だけです。

2暗号化ワークフローの概要

なぜ最初に DRM-X 5.0 Web サービスを呼び出すのか？暗号化プログラムの -profile 引数は、ライセンスプロファイルの数値 ID ではありません — お客様のアカウントに紐づけられた暗号化文字列（ProfileEncryptedParam）です。この文字列はローカルで生成できません。Web サービスを通じてのみ取得できます。これは ProfileID に 1 対 1 で対応し、一度取得すればキャッシュして再利用できます — ファイルごとに Web サービスを呼び出す必要はありません。一方、入力 / 出力パスの Base64 値は、お客様のプログラムでローカルにエンコードする必要があります（セクション 6 参照）— それらのために Web サービスを呼び出す必要はありません。

3前提条件

3.1 DRM-X 5.0 アカウント情報（DRM-X 管理コンソールから取得）

3.2 サーバー環境の要件

セキュリティに関する注意： WebServiceAuthStr はアカウントキーと同等です。サーバー側にのみ保存する必要があります — フロントエンドの Web ページ、クライアントソフトウェア、公開リポジトリには絶対に置かないでください。

4ステップ 1：DRM-X 5.0 Web サービスを呼び出して暗号化パラメータを取得する

4.1 Web サービス情報

エンドポイントはアカウントのエディションと一致する必要があります：インターナショナルアカウントは 5.drm-x.com を使用します（コマンドライン：-server_domain com）。中国アカウントは 5.drm-x.cn を使用します（コマンドライン：-server_domain cn）。間違ったエディションを使用すると、認証が失敗するか、暗号化ファイルが再生できなくなります。

4.2 リクエストパラメータ

4.3 レスポンスフィールドとコマンドライン引数の対応（核心）

4.4 呼び出し例（PHP / SoapClient）

この Web サービスは標準の SOAP 1.1 サービスであり、どの言語からでも同じ統一された方法で呼び出すことができます：4.1 に記載されたエンドポイントに SOAP エンベロープを POST するか（または ?WSDL から SOAP クライアントに自動生成させる）、4.2 のパラメータを渡し、レスポンスの 4.3 の 3 つのフィールドを読み取ります。言語別の一般的な SOAP クライアントライブラリ：

次の例では PHP の SoapClient を使用して完全な呼び出しを示します。コードをサーバー上に get_params.php として保存して実行してください（PHP 7.4+ で soap 拡張機能を有効化）— 3 つのコマンドライン引数の値が出力されます：

<?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";

5ステップ 2：暗号化コマンドを実行する

5.1 初回使用時（Linux / macOS）

ターミナルでプログラムのディレクトリに移動し、まず実行権限を付与します：

# 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 単一ファイル暗号化コマンドテンプレート

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 引数のリファレンス

5.4 完全な例

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==

ここで RDpcSmFzb25c... は 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=

これは ./input/01-linux-encrypt-video.mp4 → ./output/01-linux-encrypt-video2_P.mp4 を暗号化します。

5.5 結果の確認

• プログラムが終了したら、出力ディレクトリに暗号化ファイルが作成されたことを確認します（区別するために _P サフィックスを推奨、例：course01_P.mp4）。
• 暗号化には DRM-X サーバーへのネットワークアクセスが必要です。ファイアウォール / セキュリティグループが 5.drm-x.com または 5.drm-x.cn へのアウトバウンドアクセスを許可していることを確認してください。
• 本番コンテンツをバッチ暗号化する前に、小さなテスト動画で完全なワークフローを検証することを推奨します。

6入力 / 出力パスの Base64 エンコード（ローカルエンコードを推奨）

推奨される方法： -input_file_utf8_base64_encoded / -output_file_utf8_base64_encoded の値を、お客様自身のプログラムでエンコードして生成します — ファイルごとに Web サービスを呼び出す必要はありません。エンコード規則：まずパス文字列を UTF-8 バイトに変換し、次に標準の Base64 エンコードを適用します。注意：ソースファイルは UTF-8 で保存する必要があります（これは特に非 ASCII パスで重要です。Windows では ANSI / GBK エンコードを使用しないでください）。言語別の例：

再度強調します：-profile 引数をローカルで生成する方法はありません。これはお客様のアカウントに紐づけられた暗号化文字列であり、GetPackagerEncryptedParams Web サービスを通じてのみ取得できます。

7サーバー側自動化の例

「パラメータの取得 + 暗号化プログラムの呼び出し」を連鎖させることで、Web サイトのバックオフィスからワンクリック暗号化、またはスケジュールされたバッチ暗号化が可能になります。次の PHP の例は Linux 暗号化プログラムを呼び出します（セクション 4.4 のコードの続き。実行時には $profile をまずキャッシュから読み取り、キャッシュされた値が存在しない場合にのみ 4.4 の Web サービスを呼び出す必要があります）：

<?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);

シェルバッチ暗号化スクリプトの例（Linux — パスをローカルでエンコードしてから各ファイルを暗号化）：

#!/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

推奨される方法：特定の ProfileID の ProfileEncryptedParam を Web サービス経由で一度取得し、再利用のためにキャッシュします — 暗号化ファイルごとに Web サービスを呼び出さないでください。サーバー上でパスを Base64（UTF-8）エンコードして enc_Input / enc_Output の相当値を直接生成します（PHP の場合：base64_encode($path)、セクション 6 参照）— Web サービス呼び出しは不要です。バッチ暗号化の際は、帯域幅と CPU の飽和を避けるために同時実行数を制限してください（例：サーバーあたり 2〜4 の暗号化プロセス）。

8よくある質問（FAQ）

Q1：Web サービスが「Your XML web service login info is not correct...」を返す

AdminEmail または WebServiceAuthStr が正しくありません。DRM-X 管理コンソールで両方を再確認してください。値の前後にスペースがないことを確認してください。また、このエラーでも HTTP ステータスコードは 200 のままです — プログラムは HTTP ステータスコードではなく、レスポンスフィールドを検査して成功を判断する必要があります。

Q2：数値 ID（例：1001）を -profile に直接渡すとエラーになる

-profile は Web サービスが返した完全な ProfileEncryptedParam 暗号化文字列でなければなりません — 数値の Profile ID ではありません。数値 ID は Web サービスを呼び出すときにのみ使用されます。

Q3：パスに非 ASCII 文字やスペースが含まれていて暗号化が失敗する？

パスは Base64 として転送され、非 ASCII 文字とスペースは完全にサポートされています。重要なのは、エンコードに UTF-8 を使用する必要があることです。Windows では、メモ帳 / cmd がデフォルトで ANSI（GBK）エンコードを使用する場合があり、Base64 デコード後にパスが破損します。セクション 6 に記載されているように、プログラムでパスを UTF-8 としてエンコードしてください（PHP ソースファイルが UTF-8 で保存されている場合、通常の base64_encode() がそのまま機能します。レガシーな GBK エンコード文字列は、エンコード前に iconv('GBK', 'UTF-8', $path) または mb_convert_encoding() で変換できます）。

Q4：プログラムが出力失敗を報告する / 出力ディレクトリが見つからない

出力ファイルの親ディレクトリを事前に作成する必要があります（例：mkdir -p ./output）。また、プログラムを実行するユーザーがそのディレクトリへの書き込み権限を持っていることを確認してください。

Q5：macOS がプログラムを「cannot be opened because the developer cannot be verified」と表示する

プログラムは Apple の公証を受けていないため、Gatekeeper が初回起動をブロックします。次のいずれかの方法を選んでください： ① ターミナルで xattr -d com.apple.quarantine ./drm-x5-encrypt-sdk-macos-arm64 を実行して隔離フラグを削除する； ② またはシステム設定 → プライバシーとセキュリティで「このまま開く」をクリックする。

Q6：Linux でプログラムが実行できない（Permission denied またはフォーマットエラー）

まず chmod +x drm-x5-encrypt-sdk-linux-x86_64 を実行してください。「cannot execute binary file」が表示される場合は、サーバーが x86_64 であることを確認してください（uname -m）。現在のパッケージは x86_64 ビルドのみを提供しています。ARM サーバーについては Haihaisoft にお問い合わせください。

Q7：com と cn のどちらを使用すべきですか？間違った方を選ぶとどうなりますか？

DRM-X アカウントのプラットフォームと一致する必要があります：インターナショナルアカウントは com を使用し（5.drm-x.com を呼び出す）、中国アカウントは cn を使用します（5.drm-x.cn を呼び出す）。不一致は認証失敗、またはプラットフォームに一致しない暗号化パラメータを引き起こします。

Q8：暗号化ファイルを確認するにはどうすればよいですか？

DRM-X 5.0 デモプレーヤー / 統合プレーヤーで出力ファイルを開き、確認します：ライセンスなしでは再生がブロックされ、管理コンソールでテストユーザーを承認すると正常に再生されます。大量の本番暗号化の前に小規模で検証してください。

9注意事項とベストプラクティス

• 元のファイルを保持する：出力を新しい場所または新しいファイル名（例：_P サフィックス付き）に書き込み、元の動画が上書きされないようにします。
• 小さく始めてから大きく：新しいプロファイルや新しいサーバーを初めて使用する場合、バッチ処理の前に短いテスト動画で「パラメータ取得 → 暗号化 → ライセンス付き再生」の完全なフローを実行してください。
• 引数を手で編集しない： -profile は Base64 暗号化文字列です — 完全にコピーしてください（余分な前後のスペースや行折り返しによる切り捨てがないように）。
• 認証文字列を秘密に保つ： WebServiceAuthStr はサーバー側の設定にのみ属します。GetPackagerEncryptedParams.php のようなデモ Web ツールを公開インターネットに配備しないでください。
• ネットワーク要件：暗号化中、サーバーは DRM-X サーバー（インターナショナル 5.drm-x.com / 中国 5.drm-x.cn）に到達できる必要があります。ファイアウォールがある場合はアウトバウンドポート 443 を許可してください。