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 を使用して Azure Communication Services トークンをフェッチして Teams の通話/チャットに参加できるようにすることで行われます。
注
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 Authentication Server サンプルを実行して何ができるかを確認する必要があります。
- ローカルデプロイガイドをご覧ください。
Azure Communication Services 認証サーバーのサンプルはどのように機能しますか?
- 概念設計に関するドキュメントをご覧ください。 このドキュメントでは、サービスの内部設計の概要を説明します。
エンドポイント
この Azure Communication Services ソリューション - 認証サーバーのサンプルでは、 ユーザー エンドポイントと トークン エンドポイントに対する応答が提供されます。 詳細については、 エンドポイントと応答の設計ドキュメントを参照してください。
次のステップ
追加の参考資料
- Azure Communication Services のドキュメント - 音声、ビデオ、チャット、テレフォニーを追加する方法の詳細については、公式ドキュメントを参照してください。
- Azure Communication Services のヒーロー サンプル - サンプルの概要ページで、Azure Communication Services のその他のサンプルと例を見つけます。
- オン-Behalf-Of ワークフロー - OBO ワークフローについて詳しく知る。
- 保護された API の作成 - 保護された API の作成の詳細な例。
- Graph Open Extensions - Microsoft Graph オープン拡張機能の詳細を確認します。
作業の開始
どこから始めればいいのか疑問に思う場合は、次のようなシナリオを参考にしてください。
"この Azure Communication Services Authentication Server サンプルを実行して何ができるかを確認する必要があります。
- ローカルデプロイガイドをご覧ください。
Azure Communication Services 認証サーバーのサンプルはどのように機能しますか?
- 概念設計に関するドキュメントをご覧ください。 このドキュメントでは、サービスの内部設計の概要を説明します。
エンドポイント
この Azure Communication Services ソリューション - 認証サーバーのサンプルでは、 ユーザー エンドポイントと トークン エンドポイントに対する応答が提供されます。 詳細については、 エンドポイントと応答の設計ドキュメントを参照してください。
次のステップ
追加の参考資料
- Azure Communication Services のドキュメント - 音声、ビデオ、チャット、テレフォニーを追加する方法の詳細については、公式ドキュメントを参照してください。
- Azure Communication Services のヒーロー サンプル - サンプルの概要ページで、Azure Communication Services のその他のサンプルと例を見つけます。
- オン-Behalf-Of ワークフロー - OBO ワークフローについて詳しく知る。
- 保護された API の作成 - 保護された API の作成の詳細な例。
- Graph Open Extensions - Microsoft Graph オープン拡張機能の詳細を確認します。