信頼された認証サービスのヒーロー サンプルの使用を開始する

重要

このサンプルの node.JS および C# 版は GitHub で入手できます。

概要

Azure Communication Services では、開発者は、信頼された認証サービス内にユーザーとアクセス トークンの資格情報を生成する必要があります。 Azure Communication Services は ID に依存しません。詳細については、概念に関するドキュメントを参照してください。

このリポジトリには、Azure Communication Services の認証サービスのサーバー実装のサンプルが用意されています。 ベスト プラクティスを使用して、Azure Communication Services の資格情報を発行し、Microsoft Entra ID にマップする信頼されたバックエンド サービスを構築します。

このサンプルは、次のシナリオで役に立ちます。

• 開発者は、認証フローを有効にして、Microsoft Entra ID にマップされた Azure Communication Services ユーザー ID を生成する必要があります。 この ID を使用して、通話やチャットのエクスペリエンスに使用するアクセス トークンをプロビジョニングします。
• 開発者は、Azure Communication Services サポート Teams ID の認証フローを有効にする必要があります。これは、Teams のユーザーの Microsoft 365 Microsoft Entra ID を使用して、Teams の通話/チャットに参加できるように Azure Communication Services トークンをフェッチすることによって行われます。

Note

Azure Communication Services の使用を開始する予定ではあるものの、学習/プロトタイプ作成フェーズが終了していない場合は、Azure Communication Services のユーザーとアクセス トークンの概要に関するクイックスタートを参照してださい。

このサンプルではサーバー API にのみ焦点を当てているため、クライアント アプリケーションはその一部ではありません。 Microsoft Entra ID を使用してログイン ユーザーにクライアント アプリケーションを追加する場合は、こちらの MSAL サンプルに従ってください。

前提条件

このサンプルを実行できるようにするには、次の操作を行う必要があります。

• On Behalf Of ワークフローの一部として Microsoft Entra ID にクライアントとサーバー (Web API) アプリケーションを登録します。 登録の設定に関するガイドラインに従います
• デプロイ済みの Azure Communication Services リソース。 Azure Communication Services リソースを作成します。
• アプリの登録の情報を使用して、サーバー (Web API) アプリケーションを更新します。

作業の開始

開始する場所がわからない場合は、次のシナリオを参考にしてください。

• "この Azure Communication Services の認証サーバーのサンプルで何ができるのか、実際に動かして試してみたい"

  • ローカル デプロイ ガイドを参照してください。

• "Azure Communication Services の認証サーバーのサンプルはどのように動作しますか?"

  • 概念設計のドキュメントを参照してください。 このドキュメントでは、サービスの内部設計の概要について説明します。
    • アーキテクチャの概要
    • セキュリティで保護された Web API アーキテクチャの設計。
    • ID マッピング アーキテクチャの設計。
    • トークン Exchange アーキテクチャの設計

エンドポイント

この Azure Communication Services Solutions - 認証サーバーのサンプルは、ユーザー と トークン のエンドポイントに対する応答を提供します。 詳細については、エンドポイントと応答の設計ドキュメントを参照してください。

次の手順

GitHub からサンプルをダウンロードする

その他の参考資料

• Azure Communication Services のドキュメント - 音声、ビデオ、チャット、テレフォニーを追加する方法については、公式ドキュメントを参照してください。
• Azure Communication Services のヒーロー サンプル - その他の Azure Communication Services のサンプルと例については、サンプルの概要ページを参照してください。
• On Behalf Of ワークフロー - OBO ワークフローの詳細を確認します。
• 保護 された API の作成 - 保護された API の作成の詳細な例。
• Graph で開いている拡張機能 - Microsoft Graph で開いている拡張機能の詳細を確認してください。

作業の開始

開始する場所がわからない場合は、次のシナリオを参考にしてください。

• "この Azure Communication Services の認証サーバーのサンプルで何ができるのか、実際に動かして試してみたい"

  • ローカル デプロイ ガイドを参照してください。

• "Azure Communication Services の認証サーバーのサンプルはどのように動作しますか?"

  • 概念設計のドキュメントを参照してください。 このドキュメントでは、サービスの内部設計の概要について説明します。
    • Azure Communication Services 認証サーバーのサンプル アーキテクチャの設計。
    • セキュリティで保護された Web API アーキテクチャの設計。
    • ID マッピング アーキテクチャの設計。
    • トークン Exchange アーキテクチャの設計

エンドポイント

この Azure Communication Services Solutions - 認証サーバーのサンプルは、ユーザー と トークン のエンドポイントに対する応答を提供します。 詳細については、エンドポイントと応答の設計ドキュメントを参照してください。

次の手順

GitHub からサンプルをダウンロードする

その他の参考資料

• Azure Communication Services のドキュメント - 音声、ビデオ、チャット、テレフォニーを追加する方法については、公式ドキュメントを参照してください。
• Azure Communication Services のヒーロー サンプル - その他の Azure Communication Services のサンプルと例については、サンプルの概要ページを参照してください。
• On Behalf Of ワークフロー - OBO ワークフローの詳細を確認します。
• 保護 された API の作成 - 保護された API の作成の詳細な例。
• Graph で開いている拡張機能 - Microsoft Graph で開いている拡張機能の詳細を確認してください。