Quick BI は Microsoft Teams との連携をサポートしています。Quick BI を Teams と連携させるには、事前に Teams アプリケーションを構成する必要があります。このトピックでは、Teams アプリケーションの構成方法について説明します。
制限事項
ご利用の Teams アカウントには、Teams 開発者ポータルでの開発者権限が必要です。
操作手順
Teams アプリケーションを構成して、テナント ID、アプリケーション ID、およびクライアントシークレットを取得します。
ステップ 1：Microsoft Entra ID でのアプリケーションの構成
Web ブラウザーで Azure portal を開きます。
[アプリの登録] アイコンをクリックします。
新しいアプリケーションを登録します。
[アプリケーションの登録] ページが表示されます。
入力
説明
手順
表示名
アプリケーションの名前。
必須。
サポートされているアカウントの種類
サポートされているアカウントの種類。
必須。
最初のオプションを選択します。これにより、現在の組織内のアカウントのみがアプリケーションを使用できるようになります。
リダイレクト URI (オプション)
ログインリダイレクト URL。
必須。
フォーマット：`https://{host}/login/teams/callback`
注意：
HTTPS プロトコルのみがサポートされています。HTTP プロトコルはサポートされていません。
`{host}` を実際の Quick BI ドメイン名に置き換えてください。
説明タブアプリケーションでシングルサインオン (SSO) を有効にする場合、[リダイレクト URI] を入力する必要はありません。
[登録] をクリックします。ブラウザーに、アプリケーションが作成されたことを示すメッセージが表示されます。
アプリケーション ID とその他の構成が表示されたページが表示されます。
クライアントシークレットを生成します。
後で必要になるため、次のアプリケーション構成情報を記録しておきます。ディレクトリ (テナント) ID
アプリケーション (クライアント) ID
クライアントシークレット
アクセストークンのスコープを設定します ([API の公開])。
左側のナビゲーションウィンドウで、[管理] > [API の公開] を選択します。[API の公開] ページが表示されます。
次の 3 つの項目を構成する必要があります：
アプリケーション ID の URI
この API によって定義されたスコープ
承認済みのクライアントアプリケーション
アプリケーション ID の URI を構成します。
[追加] をクリックします。アプリケーション ID の URI を設定するセクションが表示されます。
[アプリケーション ID の URI] には、
api://{AppID}という形式でアプリケーション ID (GUID) が事前に入力されています。アプリケーション ID の URI は、
api://{Quick BI サービスドメイン名、タブアプリケーションのドメイン名}/{AppID：アプリケーション登録時に生成されたアプリケーション ID}という形式である必要があります。例：`api://quickbi-demo-2.aliyun.com/beef226-****-****-****baed49e5`
[保存] をクリックします。ブラウザーに、アプリケーション ID の URI が更新されたことを示すメッセージが表示されます。ページにアプリケーション ID の URI が表示されます。
後で Teams 開発者ポータルでアプリケーションマニフェストを更新するために、このアプリケーション ID の URI を記録しておきます。
API スコープを構成します ([この API によって定義されたスコープ])。
スコープ名を入力します。このフィールドは必須です。
このスコープに同意できるユーザーを選択します。デフォルトのオプションは [管理者のみ] です。
[管理者の同意の表示名] を入力します。このフィールドは必須です。
[管理者の同意の説明] を入力します。このフィールドは必須です。
[ユーザー同意の表示名] を入力してください。
[ユーザーの同意の説明] を入力します。
[状態] で [有効] を選択します。
[スコープの追加] をクリックします。
ブラウザーに、スコープが追加されたことを示すメッセージが表示されます。
定義した新しいスコープがページに表示されます。
承認済みのクライアントアプリケーションを構成します。
[API の公開] ページの [承認済みのクライアントアプリケーション] セクションで、[+ クライアントアプリケーションの追加] をクリックします。
[クライアントアプリケーションの追加] ページが表示されます。Web アプリケーションに対して承認するアプリケーションに適した Microsoft 365 クライアント ID を入力します。
詳細については、こちらの Microsoft ドキュメントをご参照ください。
[ClientID] を次の固定値に設定します：
Teams デスクトップおよびモバイルの場合：1fec8e78-bce4-4aaf-ab1b-5451cc387264
[承認されたスコープ] セクションで、アプリケーション用に作成したスコープを選択して、公開した Web API に追加します。[アプリケーションの追加] をクリックします。
ブラウザーに、承認済みのクライアントアプリケーションが追加されたことを示すメッセージが表示されます。
承認されたアプリケーションのクライアント ID がページに表示されます。
トークンアクセスバージョンを構成します ([マニフェスト])。
説明アプリケーションの登録時に [任意の組織ディレクトリ (任意の Microsoft Entra ディレクトリ - マルチテナント) 内のアカウントと、個人用の Microsoft アカウント (Skype、Xbox など)] を選択した場合は、
accessTokenAcceptedVersionプロパティの値を 2 に更新してください。API のアクセス許可を構成します。
必要に応じて、委任された API のアクセス許可を選択し、管理者の同意を付与します。
(オプション) 解析されたアクセストークンに必要なフィールド値が含まれていない場合は、トークンの構成で追加できます。
アプリケーションに必要な API のアクセス許可は次のとおりです：API/アクセス許可名
必須
目的
email
はい
ログイン認証
openid
はい
profile
はい
User.Read
はい
Organization.Read.All
はい
アドレス帳の同期。Teams と Teams メンバーを取得します。
User.Read.All
はい
Team.ReadBasic.All
はい
TeamMember.Read.All
はい
ステップ 2：Teams 開発者ポータルでのアプリケーションの構成
Azure portal で、新しいアプリケーションを選択してアプリケーション ID を表示します。
Teams アプリケーションのクライアント ID (ClientID またはアプリケーション ID とも呼ばれます) を取得します。
ステップ 3：Teams 管理センターでのアプリケーションの公開
新しいアプリを作成します。
Teams 開発者ポータルにログインします：https://dev.teams.microsoft.com/home
基本情報：アプリケーションの基本情報を入力します。
入力タイプ
フィールド
必須
説明
画像
アプリ名
短い名前 - 30 文字以下
はい
アプリケーションの名前。
完全な名前 - 100 文字まで (オプション)
はい
アプリ ID
いいえ
現在使用されていません。
説明
短い説明
長い説明
はい
アプリケーションの説明。
開発者情報
開発者または会社名
必須
アプリケーションを所有する開発会社の名前。
Web サイト (有効な HTTPS URL である必要があります)
必須
開発会社の Web サイトの URL。
アプリの URL
プライバシーポリシー
必須
アプリケーションのプライバシーポリシーの URL。
利用規約
必須
アプリケーションの利用規約の URL。
アプリケーション (クライアント) ID*
ApplicationID
必須
Microsoft Entra ID に登録されたアプリケーションの ApplicationID (ClientID)。
ブランド：アプリケーションのアイコンを含むブランド情報を入力します。
アプリの機能：個人用アプリとグループとチャネルのアプリの機能を構成する必要があります。
個人用タブを設定します。
コンテンツ URL と Web サイト URL のフォーマットは `https://{your-host}/home` です。`{your-host}` を特定のドメイン名に置き換えてください。
scope：personal を選択します。
context：personalTab を選択します。
シングルサインオンの設定：Teams 内でシングルサインオンを構成します。
[アプリケーション ID の URI] フィールドに、ログイン URL を入力します。フォーマットは `api://{your-host}/{アプリケーション ID}` です。
アプリのコンテンツを設定します：
[全画面表示モード] チェックボックスを選択します。これにより、アプリケーションが Teams クライアントで全画面表示されるようになります。
アプリの検証：アプリケーションを検証します。アプリケーションが検証に合格すると、公開できます。
組織に公開：アプリケーションを組織に公開します。アプリケーションが承認されると、組織の Teams ストアに表示されるようになります。
アプリケーションをレビューします。
Microsoft Teams 管理センターにログインします。
[アプリの管理] セクションで、公開された Teams アプリケーションを検索します。アプリケーションの状態は [ブロック済み] と表示されます。
アプリケーションをクリックして詳細を表示します。[公開] をクリックし、組織への公開を確認します。
説明ユーザーとグループ：アプリケーションの表示範囲を設定します。
アクセス許可：アプリケーションのアクセス許可情報を表示します。
Teams クライアントでアプリケーションを追加します。
Teams で [アプリ] をクリックし、[組織向けに構築] を選択します。公開されたアプリケーションが表示されます。
説明遅延：Teams アプリケーションの公開には遅延が発生する場合があります。公開直後に Teams クライアントにアプリケーションが表示されないことがあります。約 1 時間待つ必要がある場合があります。
キャッシュ：公開されたアプリケーションが Teams クライアントに表示されない場合は、一度ログアウトしてから再度ログインして、Teams クライアントのキャッシュをリフレッシュしてください。
ステップ 4：Quick BI での Office アプリケーション連携とログイン設定の構成
Azure portal で新しいアプリケーションのテナント ID、アプリケーション ID、クライアントシークレットを取得します。この情報は、「Teams マイクロアプリケーションの有効化」で説明されている手順で必要になります。
Azure portal にログインします。
新しいアプリケーションを選択して、その詳細を表示します。
次の情報を取得します：
テナント ID (ディレクトリ (テナント) ID)
アプリケーション ID (アプリケーション (クライアント) ID)
クライアント認証情報 (Client credentials)
