Media Services API にアクセスするための資格情報を取得する

  • [アーティクル]

Media Services ロゴ v3

警告

Azure Media Services は、2024 年 6 月 30 日に廃止されます。 詳細については、 AMS 廃止ガイドを参照してください。

Azure AD 認証を使用して Azure Media Services API にアクセスする場合、次の 2 つの認証オプションがあります。

  • サービス プリンシパルの認証

    サービスが認証を受けます。 この認証方法がよく使用されるアプリケーションは、デーモン サービス、中間層サービス、またはスケジュールされたジョブを実行するアプリ (Web アプリ、関数アプリ、ロジック アプリ、API、マイクロサービス) です。

  • ユーザー認証

    Media Services リソースを操作するアプリを使用しているユーザーが認証を受けます。 ユーザーは最初にその操作アプリケーションから資格情報の入力を求められます。 例として、承認済みユーザーがエンコード ジョブまたはライブ ストリーミングを監視するために使用する管理コンソール アプリがあります。

この記事では、Media Services API にアクセスするための資格情報を取得する手順について説明します。 以下のタブから選択します。

前提条件

API アクセス

[API アクセス] ページでは、API への接続に使用する認証方法を選択できます。 このページには、API に接続するために必要な値も表示されます。

  1. Azure Portal で Media Services アカウントを選択します。
  2. 左側のナビゲーション バーで [API アクセス] ブレードを選択します。
  3. [Media Services API に接続する] で、接続する Media Services API のバージョンを選択します (V3 がサービスの最新バージョンです)。

サービス プリンシパルの認証

Azure Active Directory (Azure AD) アプリとシークレットを使用してサービスを認証します。

Azure AD アプリとシークレットの管理

[AAD アプリとシークレットの管理] セクションでは、新しい Azure AD アプリを選択または作成し、シークレットを生成できます。 セキュリティ上の理由により、ブレードを閉じた後にシークレットを表示することはできません。 アプリケーションでは、認証にアプリケーション ID とシークレットを使用して、メディア サービスの有効なトークンを取得します。

Azure AD テナントにアプリケーションを登録し、アプリケーションを Azure サブスクリプションのロールに割り当てるための十分なアクセス許可があることを確認してください。 詳細については、「必要なアクセス許可」を参照してください。

Media Services API に接続する

[Media Services API に接続する] では、サービス プリンシパル アプリケーションへの接続に使用する値が提供されます。 テキスト値を取得したり、JSON または XML ブロックをコピーしたりできます。

ユーザー認証

このオプションは、アプリを使用して Media Services リソースを操作している Azure Active Directory の従業員またはメンバーを認証するために使用できます。 ユーザーは最初に、対話型アプリケーションからユーザー資格情報の入力を求められます。 この認証方法は、管理アプリケーションに対してのみ使用してください。

Media Services API に接続する

[Media Services API に接続する] セクションから、ユーザー アプリケーションに接続するための資格情報をコピーします。 テキスト値を取得したり、JSON または XML ブロックをコピーしたりできます。

ヘルプとサポート

質問がある場合は Media Services に問い合わせるか、次のいずれかの方法で更新内容に従ってください。