Skip to main content

SharePoint & OneDrive — Add from SharePoint

この連携により、ユーザーは添付ボタンの Add from SharePoint オプションから、SharePoint サイト(Teams のサイトを含む)、OneDrive、共有アイテムのファイルをチャットから直接添付できます。 設定はセルフサービスです。組織の管理者が自社の Microsoft Entra ID ディレクトリに SecureAI をアプリケーションとして登録し、識別子を Admin → Integrations → Files に登録します。チケットを起票したり、Hiper AI の対応を待ったりする必要はありません。設定を保存すると、すぐにチャットにオプションが表示されます。 所要時間の目安: 10 分。

仕組み

  1. ユーザーが Attach → Add from SharePoint をクリックします。初回は、Microsoft からご自身の Microsoft 365 アカウントでのログインを求められます。
  2. Microsoft Graph 上の SecureAI のブラウザが開き、サイト、ライブラリ、フォルダー、検索、ユーザーと共有されているファイルが表示されます。ユーザーは 1 つ以上のファイルを選択します。
  3. ユーザーのブラウザが、ユーザー自身のトークンを使って選択したファイルのみをダウンロードし、メッセージに添付します。
  4. ファイルは他の添付ファイルと同じ経路をたどります。モデルに到達する前に、DLP と組織のポリシーを通過します。
委任されたアクセス許可のみを使用し、アプリケーションのアクセス許可は使用しません。 SecureAI は常にログインしているユーザーの代理として動作します。ユーザーが表示・添付できるのは、SharePoint で自分がすでに開けるものだけです。アプリケーションはクライアント シークレットを持たない「シングルページ アプリケーション」(SPA)であり、SecureAI がバックグラウンドで何かを読み取ることはありません。

前提条件

  • アプリケーションを登録でき、Microsoft Graph のアクセス許可に対して管理者の同意を付与できる Entra ID のロール(たとえばクラウド アプリケーション管理者またはグローバル管理者)。
  • SecureAI の管理者アクセス権(Integrations セクションに対する Administrator 権限)。
  • Attach from Drive / SharePoint を含む SecureAI のプラン。含まれていない場合でも設定を済ませておくことはできますが、ユーザーにはオプションが表示されません。

ステップ 1: SecureAI からリダイレクト URI をコピーする

  1. 管理者として SecureAI にログインします。
  2. Admin → Integrations に移動し、カテゴリ Files で絞り込みます。
  3. SharePoint & OneDrive カードで Connect integration をクリックします。
  4. 1. Register SecureAI in Microsoft Entra ID セクションで、Redirect URI の横にある Copy をクリックします。
SecureAI のサイドパネルに表示されたリダイレクト URI
URI はインスタンスのアドレスです。例: https://<貴社名>.hiperai.ai。必ずご利用のインスタンスに表示されるものを使用してください。完全に一致している必要があります。

ステップ 2: Entra ID にアプリケーションを登録する

  1. Microsoft Entra 管理センターを開き、ID → アプリケーション → アプリの登録(Identity → Applications → App registrations)に移動します。
  2. 新規登録(New registration)をクリックします。
アプリの登録 → 新規登録
  1. 次の項目を入力します。
    • 名前(Name): 例: SecureAI — Add from SharePoint
    • サポートされているアカウントの種類(Supported account types): この組織ディレクトリのみに含まれるアカウント(Accounts in this organizational directory only。シングル テナント)
    • リダイレクト URI(Redirect URI): ドロップダウンで シングルページ アプリケーション (SPA)(Single-page application)を選択し、ステップ 1 でコピーした URI を貼り付けます。
  2. 登録(Register)をクリックします。
プラットフォームは Web ではなく、シングルページ アプリケーション (SPA) にする必要があります。Web の場合、ログインはエラー AADSTS9002326 で失敗します。すでに Web として登録した場合は、認証(Authentication)に移動し、同じ URI で シングルページ アプリケーション プラットフォームを追加して、Web のものを削除してください。
  1. アプリケーションの概要(Overview)で、アプリケーション (クライアント) ID(Application (client) ID)とディレクトリ (テナント) ID(Directory (tenant) ID)をコピーします。クライアント シークレットを作成する必要はありません。
アプリケーション ID とディレクトリ ID

ステップ 3: Microsoft Graph のアクセス許可を追加する

  1. アプリケーションで API のアクセス許可 → アクセス許可の追加 → Microsoft Graph → 委任されたアクセス許可(API permissions → Add a permission → Microsoft Graph → Delegated permissions)に移動します。
  2. 次のものを検索して選択します。
    • Files.Read.All — ユーザーがアクセスできるファイルを読み取ります。
    • Sites.Read.All — ユーザーがアクセスできる SharePoint サイトを一覧表示および検索します。
  3. アクセス許可の追加(Add permissions)をクリックします。User.Read は既定で追加済みです。そのままにしてください。
Microsoft Graph の委任されたアクセス許可

ステップ 4: 管理者の同意を付与する

  1. API のアクセス許可で、<組織名> に管理者の同意を与えます(Grant admin consent for <org>)をクリックし、はいで確定します。
  2. 3 つのアクセス許可すべての状態が <組織名> に付与されました になっている必要があります。
付与された管理者の同意
この手順を行わない場合、各ユーザーに同意の要求が表示されます(組織がユーザーによる同意を許可していない場合は、エラー AADSTS65001 が表示されます)。

ステップ 5: SecureAI に登録、テスト、有効化する

  1. SecureAI の SharePoint & OneDrive のサイドパネルに戻ります。
  2. 2. Paste the identifiers で、Directory (tenant) ID と Application (client) ID を貼り付けます。
  3. 3. Test it で次を実行します。
    • Test connection は、SecureAI のサーバーから、ディレクトリが存在することを確認します。
    • Try signing in は、ユーザーに表示されるものと同じ Microsoft のウィンドウを開きます。ご自身のアカウントでログインしてください。SecureAI は、リダイレクト URI が SPA タイプであること、Files.Read.All と Sites.Read.All に同意が付与されていること、Microsoft Graph が応答することを確認します。
SecureAI のサイドパネルで成功したテスト
  1. 4. で、Show “Add from SharePoint” to users を有効のままにして Save をクリックします。
カードが Available in the chat に変わります。

ステップ 6: ユーザーの使い方

  1. チャットで、ユーザーが添付ボタンをクリックし、Add from SharePoint を選択します。
添付メニューの Add from SharePoint
  1. 初回は、Sign in with Microsoft をクリックし、組織のアカウントを選択します。
  2. Sites、Shared、または検索で移動し、1 つ以上のファイルを選択して Add をクリックします。
  3. ファイルが SharePoint のアイコン付きでメッセージに添付されます。

利用できるユーザーを制限する(任意)

一部のユーザーまたはグループのみが Add from SharePoint を使用できるようにするには、次の手順を行います。
  1. Entra で エンタープライズ アプリケーション(Enterprise applications)に移動し、登録したアプリケーションを開きます。
  2. プロパティ(Properties)で 割り当てが必要ですか?(Assignment required?)を有効にして保存します。
  3. ユーザーとグループ(Users and groups)で、利用を許可するユーザーまたはグループを割り当てます。
割り当てられていないユーザーは、ログイン時にエラー AADSTS50105 が表示され、ファイルを添付できません。

トラブルシューティング

よくある質問

SecureAI は何を読み取れますか? ログインしているユーザーがすでに読み取れるものだけで、かつユーザーがブラウザでファイルを選択したときだけです。アクセス許可は委任されたものであり、SecureAI が「アプリケーションとして」お客様の SharePoint にアクセスすることはありません。 条件付きアクセス ポリシーは機能しますか? はい。ログインは通常の Microsoft 365 のログインであり、MFA、管理対象デバイス、その他のポリシーが適用されます。 無効にするには? Show “Add from SharePoint” to users を無効にして保存するか、Remove configuration をクリックします。すでに発行されたトークンも失効させるには、Entra ID でアプリ登録を削除するか、エンタープライズ アプリケーションのサインインを無効にしてください。 Hiper AI がすでに SharePoint を設定済みです。何か対応が必要ですか? いいえ。独自の設定を保存しない限り、カードには Configured by Hiper AI と表示され、これまでどおり動作します。独自の設定を保存すると、それに置き換わります。