ApsaraVideo Live では、アップストリーミングコールバック URL を設定および認証することで、不正アクセスによるライブストリーミングの例外を防ぐことができます。 このトピックでは、アップストリーミングコールバック URL の設定方法と認証方法について説明します。
ストリームインジェストコールバック URL
アップストリーミングに関するコールバックメッセージを受信するには、次の手順に従ってアップストリーミングコールバック URL を設定および認証します。
コールバックロジックとコールバック認証の詳細については、「コールバックロジック」および「コールバック認証」をご参照ください。
ApsaraVideo Live コンソールにログインします。
左側のナビゲーションウィンドウで、アップストリームミングまたはストリーミングのドメイン名管理 をクリックします。ドメイン管理 ページが表示されます。
設定するアップストリーミングドメインを見つけ、ドメイン設定 をクリックします。
ページに移動し、アップストリーミング情報 タブをクリックします。
コールバック URL の横にある編集アイコンをクリックして、コールバックの設定 ウィンドウを開きます。
コールバックの設定 ウィンドウで、アップストリーミングコールバック URL を設定します。
アップストリーミングコールバック URL を入力します。
コールバック URL の認証を有効にするかどうかを選択します。
認証を有効にするには、認証タイプ スイッチをオンにし、認証鍵 を入力して、OK をクリックします。
認証が不要な場合は、OK をクリックします。
コールバックロジック
アップストリーミングおよび中断コールバックにおける公開ステータスのコールバックロジック
RTMP アップストリーミングの場合、ApsaraVideo Live サービスが OnPublish メッセージを受信してから 2 秒以内にアップストリーミングクライアントが切断されない場合、サービスはアップストリーミング成功のコールバックを送信します。
アップストリーミングドメイン A とストリーミングドメイン B があるとします。ドメイン B でのストリームフェッチング (スケジュールされた back-to-origin フェッチングとトリガーされた back-to-origin フェッチングの両方) のコールバックを受信する場合は、ドメイン A の プッシュストリーミングコールバック を設定します。設定後、ドメイン B でのストリームフェッチングのコールバックロジックは、前の手順のロジックと同じです。接続が確立されてから 2 秒以内に能動的に切断されない場合、ストリームフェッチングは成功したと見なされます。
コールバックを使用してストリームステータスを確認することに加えて、DescribeLiveStreamsOnlineList 操作を呼び出してドメイン名のアクティブなアップストリーミングをクエリすることもできます。ストリームがアクティブであることを確認した後にのみ、再生 URL を配信してください。
10 秒以内にライブセンターにストリームデータがプッシュされない場合、ApsaraVideo Live サービスは自動的にアップストリーミングを切断します。
コールバック認証
デフォルトでは、アップストリーミングコールバックの認証は無効になっています。 この機能は、アップストリーミングコールバック URL を設定するときに有効にできます。 この機能を有効にすると、認証ロジックは次のようになります。
ApsaraVideo Live がコールバックリクエストを開始すると、HTTP または HTTPS リクエストヘッダーに
ALI-LIVE-TIMESTAMPフィールドとALI-LIVE-SIGNATUREフィールドが含まれます。 コールバックメッセージを受信するサーバーは、これらのフィールドを使用して署名認証を実行できます。ALI-LIVE-SIGNATUREの値は、次の数式を使用して計算されます。ALI-LIVE-SIGNATURE=MD5SUM(MD5CONTENT)MD5CONTENT=アップストリーミングドメイン|ALI-LIVE-TIMESTAMP の値|認証キー説明コールバックドメイン：コールバック URL が設定されているアップストリーミングドメイン。
認証キー：アップストリーミングコールバック URL に設定する認証キー。
リクエストヘッダーのフィールド名では、大文字と小文字は区別されません。
ご利用のサーバーがコールバックメッセージを受信したら、署名を検証する必要があります。 これを行うには、ご利用のサーバーはアップストリーミングドメイン、リクエストヘッダーの
ALI-LIVE-TIMESTAMPの値、および認証キーを連結します。 次に、ご利用のサーバーは連結された文字列の MD5 ハッシュを計算して署名を生成します。 最後に、ご利用のサーバーは生成された署名をリクエストヘッダーのALI-LIVE-SIGNATUREフィールドの値と比較します。 署名が一致しない場合、リクエストは無効と見なされます。