アプリ プロファイルの管理
テナント所有者またはサービス管理者は、アプリ プロファイルの作成 を参照して、AvePoint Online Services でアプリ プロファイルを作成することができます。
アプリ プロファイルの作成中にセットアップ方法を選択することができます。
-
モダン モード は、AvePoint のすべての既定アプリに推奨されます。このモードを選択すると、AvePoint MyHub アプリは自動的に作成されます。
サービス アプリを承認する際に承諾が必要な権限については、MyHub を参照してください。
NOTEアプリ プロファイルの同意または再承認を実行するユーザー アカウントには、Microsoft 365 グローバル管理者 または 特権ロール管理者 ロールが割り当てられている必要があります。
-
カスタム モード は、必要な権限が極端に制限されている組織に推奨されます。
AvePoint Online Services でカスタム モードでアプリ プロファイルを作成する前に、環境に接続するための Azure アプリが作成されていることを確認してください。Microsoft Entra ID でのアプリの作成方法については、カスタム Azure アプリの作成 を参照してください。
カスタム Azure アプリが必要な権限については、MyHub エクスペリエンス設定に基づいて 新しい MyHub が必要とする API アクセス許可 または レガシ MyHub が必要とする API アクセス許可 を参照してください。
AvePoint Online Services でカスタム アプリ プロファイルを作成する際に、カスタム アプリ タイプとして Azure アプリ または 委任されたアクセス許可を持つ Azure アプリ を選択することができます。いずれかのカスタム アプリ プロファイルも Azure アプリに接続することができます。
アプリ プロファイルに対して、編集・再承認・削除・他の管理アクションを実行するには、アプリ プロファイルの管理 を参照してください。
カスタム Azure アプリの作成
カスタム アプリの作成方法については、以下の説明を参照してください。
-
Azure アプリを作成します。このアプリは、MyHub の Microsoft 365 テナントへの接続に使用されます。
-
Microsoft Entra 管理センター (または Microsoft Azure ポータル) に移動します。
-
ID > アプリケーション > アプリの登録 (または Microsoft Entra ID > アプリの登録) に移動します。
-
[新規登録] をクリックします。アプリケーションの登録 ページが表示されます。
-
アプリケーションの登録情報を入力し、[登録] をクリックしてカスタム アプリケーションを作成します。システム情報ページが表示されます。
-
-
Azure アプリにパブリック証明書をアップロードします。
-
左ナビゲーションの [証明書とシークレット] をクリックします。証明書 タブで、[証明書のアップロード] をクリックします。
NOTEアプリケーションが証明書認証を使用しているため、所属する組織のパブリック証明書 (.cer または .crt ファイル タイプを推奨する) をアップロードする必要があります。所属する組織が証明書を持っていない場合、カスタム Azure アプリ用の証明書の準備 を参照して自己署名証明書を準備することができます。
-
証明書のアップロード パネルで、フォルダー ボタンをクリックして、組織の証明書を参照して選択します。この証明書の説明を入力して (必須ではありません)、[追加] をクリックします。
-
証明書が正常にアップロードされると、証明書 タブに一覧表示されます。
-
-
Azure アプリに必要なアクセス許可を付与します。
-
左ナビゲーションの [API のアクセス許可] をクリックします。
-
[アクセス許可の追加] をクリックします。API アクセス許可の要求 パネルで、MyHub が必要な API アクセス許可を選択し、[アクセス許可の追加] をクリックして選択したアクセス許可をアプリに追加します。
MyHub が必要な API アクセス許可については、MyHub エクスペリエンス設定に基づいて 新しい MyHub が必要とする API アクセス許可 または レガシ MyHub が必要とする API アクセス許可 を参照してください。
-
[[テナント名] に管理者の同意を与えます] をクリックして、管理者の同意を付与します。必要なアクセス許可の管理者の同意が付与された後、状態 は [テナント名] に付与されました になります。
-
-
Azure アプリ API を MyHub に公開します。
-
左ナビゲーションの [API の公開] をクリックします。
-
アプリケーション ID URI の横にある [追加] をクリックします。アプリケーション ID URI の編集 パネルで、必要に応じてアプリケーション ID URI を編集して、[保存] をクリックします。
-
この API で定義されているスコープ セクションで、[スコープの追加] をクリックします。
-
スコープの追加 パネルで、スコープ名として myhub.fullcontrol を入力し、その他の設定を完了して [スコープの追加] をクリックします。
NOTE追加したスコープ名は api://{application Id}/myhub.fullcontrol 形式であることを確認してください。
-
承認済みのクライアント アプリケーション セクションで、[クライアント アプリケーションの追加] をクリックします。
-
クライアント アプリケーションの追加 パネルで、クライアント ID を入力し、上記で追加したスコープを選択して [アプリケーションの追加] をクリックします。上記のステップを繰り返して複数のクライアント アプリケーションを追加することができます。
Azure アプリが MyHub を信頼し、エンド ユーザーが MyHub ポータルおよび MyHub Teams アプリにログインできるようにするには、AvePoint Online Services ログイン アプリおよび MyHub アプリをクライアント アプリケーションとして追加する必要があります。環境に基づいて追加される両アプリのクライアント ID については、以下の表を参照してください。
環境 AvePoint Online Services ログイン アプリ クライアント ID MyHub アプリ クライアント ID インサイダー環境 36f960bc-7411-4cb0-a3f6-241dd13bdf6b f716a8a2-ca4b-4a15-99fc-644649e19dd9 本番環境 ae16e128-c76e-4a38-8e06-0927912b59d9 478c769e-bab3-4049-9cfc-302d08a232bf 21Vianet 2fc9dbc4-22ca-4bf8-a082-7c3e7fa04e1d 5fae81e4-f99b-4f20-870b-37b58000d1aa
-
その後、カスタム アプリへの同意 セクションを参照して、作成された Azure アプリの情報を使用して カスタム モード でアプリ プロファイルを作成します。
AvePoint Online Services でカスタム アプリ プロファイルを作成する際に、カスタム アプリ タイプとして Azure アプリ または 委任されたアクセス許可を持つ Azure アプリ を選択することができます。いずれかのカスタム アプリ プロファイルも Azure アプリに接続することができます。
新しい MyHub が必要とする API アクセス許可
新しい MyHub エクスペリエンスが必要とする API アクセス許可の詳細については、以下の表を参照してください。
| API | アクセス許可 | タイプ | 目的 |
|---|---|---|---|
| Microsoft Graph | email (View users' email address) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | Mail.Send (Send mail as a user) | 委任済み | 組織のユーザーとしてのメールの送信 |
| Microsoft Graph | offline_access (Maintain access to data you have given it access to) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | openid (Sign users in) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | profile (View users' basic profile) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | Calendars.ReadBasic (Read basic details of user calendars) | 委任済み | ダッシュボードに表示するユーザーのイベント リストの取得 |
| Microsoft Graph | Channel.ReadBasic.All (Read the names and descriptions of channels) | 委任済み | チーム チャネルの一覧 |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | 委任済み | ユーザーのグループ メンバーシップ情報の取得 グループの作成・削除 グループからのチームの作成 グループ / コミュニティ メンバーの追加・削除 |
| Microsoft Graph | InformationProtectionPolicy.Read (Read user sensitivity labels and label policies.) | 委任済み | ユーザーがアクセス権を持つ秘密度ラベルの取得 |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | 委任済み | ユーザーの SharePoint サイトに対する権限の取得 |
| Microsoft Graph | Tasks.ReadWrite (Create, read, update, and delete user's tasks and task lists) | 委任済み | Microsoft To Do の取得・完了 |
| Microsoft Graph | User.Invite.All (Invite guest users to the organization) | 委任済み | ゲスト ユーザーのグループ・チーム・コミュニティ メンバーとしての招待 |
| Microsoft Graph | User.Read (Sign in and read user profile) | 委任済み | ユーザーの検索およびユーザー情報の取得 |
| Microsoft Graph | User.Read.All (Read all users' full profiles) | 委任済み | ユーザー プロファイルの取得 |
| Microsoft Graph | Community.Read.All (Read all Viva Engage communities) | アプリケーション | Viva Engage コミュニティ ID の取得 |
| Microsoft Graph | Group.Read.All (Read all groups) | アプリケーション | グループ・チーム・コミュニティの基本情報およびメンバーシップの取得 チームの作成 |
| Microsoft Graph | Reports.Read.All (Read all usage reports) | アプリケーション | グループ・チーム・コミュニティ・サイト コレクションの最終アクティビティの取得 |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | アプリケーション | SharePoint サイトに関する基本情報の取得 グループの作成 |
| Microsoft Graph | User.Read.All (Read all users' full profiles) | アプリケーション | ユーザー プロファイルの取得 |
| SharePoint | Sites.FullControl.All (Have full control of all site collections) | アプリケーション | SharePoint サイトの作成 |
レガシ MyHub が必要とする API アクセス許可
レガシ MyHub エクスペリエンスが必要とする API アクセス許可の詳細については、以下の表を参照してください。
| API | アクセス許可 | タイプ | 目的 |
|---|---|---|---|
| Microsoft Graph | email (View users' email address) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | Mail.Send (Send mail as a user) | 委任済み | 組織のユーザーとしてのメールの送信 |
| Microsoft Graph | offline_access (Maintain access to data you have given it access to) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | openid (Sign users in) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | profile (View users' basic profile) | 委任済み | MyHub Teams アプリのシングル サインオン |
| Microsoft Graph | Channel.ReadBasic.All (Read the names and descriptions of channels) | 委任済み | チーム チャネルの一覧 |
| Microsoft Graph | Directory.Read.All (Read directory data) | 委任済み | グループ・チーム・コミュニティの情報の取得 グループとチームの作成 |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | 委任済み | ユーザーのグループ メンバーシップ情報の取得 グループの作成・削除 グループからのチームの作成 グループ / コミュニティ メンバーの追加・削除 |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | 委任済み | ユーザーの SharePoint サイトに対する権限の取得 |
| Microsoft Graph | TeamMemberReadWrite.All (Add and remove members from teams) | 委任済み | コミュニティ メンバーの追加・削除 |
| Microsoft Graph | User.Invite.All (Invite guest users to the organization) | 委任済み | ゲスト ユーザーのグループ・チーム・コミュニティ メンバーとしての招待 |
| Microsoft Graph | User.Read (Sign in and read user profile) | 委任済み | ユーザーの検索およびユーザー情報の取得 |
| Microsoft Graph | User.Read.All (Read all users' full profiles) | 委任済み | ユーザー プロファイルの取得 |
| Microsoft Graph | Directory.Read.All (Read directory data) | アプリケーション | グループの作成 |
| Microsoft Graph | Group.Read.All (Read all groups) | アプリケーション | グループ・チーム・コミュニティの情報およびメンバーシップの取得 チームの作成 グループ メンバーの追加 共有ハブでのメール通知の送信 |
| Microsoft Graph | GroupMember.ReadWrite.All (Read and write all group memberships) | アプリケーション | グループ メンバーの追加 |
| Microsoft Graph | Reports.Read.All (Read all usage reports) | アプリケーション | アクティブなワークスペースをフィルターするためにグループ・チーム・コミュニティ・サイトの最終アクティビティの取得 |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | アプリケーション | SharePoint サイトの基本情報の取得グループの作成 グループの作成 |
| Microsoft Graph | Team.Create (Create teams) | アプリケーション | チームの作成 |
| Microsoft Graph | User.Read.All (Read all users' full profiles) | アプリケーション | グループ メンバーの追加 共有ハブでのメール通知の送信 |
| SharePoint | Sites.FullControl.All (Have full control of all site collections) | アプリケーション | SharePoint サイトの作成 |