OneDrive および SharePoint データ コネクタの認証導入
OneDriveおよびSharePointデータコネクタアドインがJMP 19 EA6以降でご利用いただけるようになりました。このブログ投稿では、これらの新しいデータコネクタを使用してMicrosoftアカウントに接続し、データにアクセスする方法について詳しく説明します。
まだインストールされていない場合は、 JMPマーケットプレイスでアドインを探すか、 こちらからダウンロードしてください。インストール手順と簡単な概要は、JMPマーケットプレイスのリストに記載されています。アドインをインストールしたら、このページにアクセスして接続してください。
このガイドでは、次の内容を説明します。
- 認証オプション
- 認可サーバーの構成
- トラブルシューティングのヒント
OneDrive および SharePoint データ コネクタは、 OAuth2と呼ばれる認証および承認プロトコルに依存しており、これにより、Microsoft アカウントを使用してデータを認証およびアクセスできるようになります。
データに接続したら、他のデータコネクタと同様にデータのインポートやクエリを実行できます。そこから、JMPが提供するすべての機能をデータに対して活用できます。
承認オプション
データ コネクタの認証には 2 つのオプションがあります。
- JMPホスト認証サーバー
- カスタム認証サーバー
これらのオプションを使用した接続の詳細については、以下を参照してください。
これらのオプションは、テナント ID およびクライアント ID パラメータが含まれているかどうかに依存します。
willmorgan_0-1740585689093.pngwillmorgan_0-1740585689093.png
オプション1: JMPホスト認証サーバー
コネクタエディタでテナントIDとクライアントIDを指定しない場合、このオプションが自動的に使用されます。接続すると、JMPはデフォルトのブラウザを開き、希望するMicrosoftアカウントへのログインを求めます。その後、SharePointデータコネクタアプリケーションへのアクセスを許可するよう求められます。
個人のMicrosoftアカウントをご利用の場合など、Azureへのアクセス権がない場合は、このオプションのみが利用可能です。権限に関する問題がある場合は、IT部門に連絡してアプリへのアクセスを許可してください。
オプション2: 認可サーバーの構成
注:Azure認証アプリを作成するには、Microsoft Azureへのアクセス権限とアプリケーション作成権限が必要です。Azureへのアクセス権限がない場合は、IT部門に連絡してアプリの作成またはアクセス権限の付与を依頼してください。このプロセスは会社(テナント)ごとに1回のみ完了する必要があります。職場の誰かが既にこのプロセスを完了している場合は、既存のアプリケーションから必要な認証情報を受け取れる可能性があります。
オプション1を試してみたものの、必要なアクセス権限の取得が難しい場合は、独自のAzureアプリケーションを設定してコネクタへのアクセスを許可することもできます。このオプションにはOAuth2標準に関する技術的な詳細が含まれているため、続行する前にこちらで詳細を確認することをお勧めします。
Azure アプリの登録の詳細については、 ここにある Microsoft のドキュメントをご覧ください。
これらの資料を読んだ後、続行する前に内容を理解していることを確認してください。
OAuth2 と Microsoft Azure アプリの登録プロセスについて理解できたので、次に OneDrive または SharePoint データに接続するための重要な手順を説明します。
アプリを登録したら、コネクタが正しく動作するように、アプリケーションへのリダイレクトURIを追加してください。「モバイルおよびデスクトップアプリケーション」のリストに「 http://ローカルホスト 」というURIを追加してください。詳しくは、Microsoftドキュメントの「プラットフォーム設定の構成」セクションをご覧ください。
次に、アプリにAPI権限を追加します。これを行うには、アプリポータルで「管理」>「API権限」に移動します。 「権限を追加」をクリックし、以下のAPI権限を検索して追加します。
- ファイル.読み取り/書き込み
- サイト.Read.All
- サイト選択
- ユーザー.読み取り
これにより、アプリが OneDrive および SharePoint ファイルへのアクセスを許可できるように、必要な API アクセス許可が追加されます。
接続テスト
正しく接続されていることを確認するには、データコネクタエディターの「テスト」ボタンを選択してください。ブラウザが開き、Microsoftアカウントの資格情報の入力を求められた後に、OneDriveまたはSharePointに対して基本的なAPI呼び出しが実行され、接続が正常であるかどうかが確認されます。
トラブルシューティングのヒント
Microsoftフェデレーションはアクセス要件が非常に厳しいため、オプション1を使用している場合、コネクタ経由でアカウントにアクセスする際に問題が発生する可能性があります。認証サーバーはJMPによってホストされているため、外部のテナントがアプリケーションにアクセスするには、IT部門からの明示的な許可が必要です。このような場合は、IT部門にコネクタへのアクセスを許可する許可を申請するか、オプション2に進んで独自の認証サーバーを作成してください。
ログイン時のブラウザ操作に関する注意事項:認証シーケンスが完了する前にブラウザが閉じられた場合でも、JMPが永久にハングアップしないように、150秒のタイムアウトが設定されています。誤ってブラウザを閉じてしまった場合は、タイムアウトが切れるまで150秒待つか、JMPを一度閉じて再度開き、再度接続をお試しください。
このブログ投稿は、OneDrive および SharePoint データ コネクタの認証プロセスを理解し、トラブルシューティングするのに役立つことを目的としています。
データアクセスOneDrive と SharePoint データ コネクタの認証についてすごい!これをずっと待っていました!
OneDrive と SharePoint データ コネクタの認証についてこんにちは、
オプション 2 を試しましたが、Sites.Read.All が存在する場合、Sites.Selected は他のサイトへのアクセスを制限しません。
アプリを作成し、記事に記載されている権限を追加しました。PowerShellを使用してアプリを制限しました。OneDriveなどのURLは利用可能のようです。
権限から Sites.Read.All を削除すると、同意を求めるメッセージが表示されます。
Sitese.Read.All を削除して同意を処理せずに済む方法はありますか?
OneDrive と SharePoint データ コネクタの認証について@computerhabitさん、コメントありがとうございます!SharePointデータコネクタのアクセスレベルを制限したい場合は、Sites.Selected API権限のみを使用してください。Sites.Selected権限のみの同意をバイパスする方法は現時点ではありません。これは、選択されたサイトコレクションに対する管理者の同意と承認が必要となるためです。コネクタがユーザーがアクセス権限を持つすべてのサイトにアクセスできるように、Sites.Read.All権限を追加しました。SharePointサイトAPI権限の詳細については、 こちらをご覧ください。お役に立てれば幸いです。
最高、
意思
OneDrive と SharePoint データ コネクタの認証についてこんにちは、ウィル。
ご返信ありがとうございます。
通常、このようなアプリを作成する際には、認証にアプリシークレットまたは証明書を使用します。上記では詳細について触れていません。
TenantIDとAppIDを入力して接続すると、必ず管理者の同意を求められます。面白半分で承認してどうなるか見てみました。すると、Sites.Read.Allと、ハイライト表示されているその他の権限が追加されました。
computerhabit_0-1761918181174.pngcomputerhabit_0-1761918181174.png
アプリの作成手順を間違えている可能性があります。アドバイスをいただけますか?シナリオ2を使用してこのアプリを制限したいのですが。
よろしくお願いします
OneDrive と SharePoint データ コネクタの認証について@コンピュータ習慣おそらく、アプリが「アプリケーション」レベルのAPI権限を要求しているのに、「委任」レベルのAPI権限を要求する必要があるのが原因でしょう。Sites.Selectedを「委任」に変更してから、もう一度お試しください。API権限が「委任」に設定され、承認されている限り、必要な権限はこれで問題ありません。問題が解決したかどうかお知らせください。さらにサポートさせていただきます。
最高、
意思
OneDrive と SharePoint データ コネクタの認証についてこんにちは、
以下の設定を試しましたが、管理者の同意を求められます。
computerhabit_0-1761924504575.pngcomputerhabit_0-1761924504575.png
よろしくお願いします
OneDrive と SharePoint データ コネクタの認証について@コンピュータ習慣おそらく、アクセスしたいサイトコレクションへのアクセス許可をアプリに追加する必要があるでしょう。PowerShellでこれらのアクセス許可を追加する方法については、 こちらの記事をご覧ください。お役に立てば幸いです。
最高、
意思
OneDrive と SharePoint データ コネクタの認証についてこんにちは、ウィル。
今後ともよろしくお願いいたします。サイトへのアプリケーションの適用例を以下に示します。
computerhabit_0-1761927202345.pngcomputerhabit_0-1761927202345.png
読み取り権限のみ付与しましたが、それが適切だと思いました。下記の通り、権限は付与されています。
computerhabit_1-1761927345833.pngcomputerhabit_1-1761927345833.png
よろしくお願いします
OneDrive と SharePoint データ コネクタの認証について@コンピュータ習慣情報ありがとうございます。データコネクタを使ってサイトに接続しようとした際に、ログインページで同意を求められているのでしょうか?もしそうであれば、そのページのスクリーンショットを見せていただけますか?ありがとうございます。
OneDrive と SharePoint データ コネクタの認証についてこの接続を確立するための短いワークショップを開催しても良いでしょうか?あるいは、少人数のグループで1対1のZoom通話を数回開催して、この手順を丁寧に説明していただくのはいかがでしょうか?私は防衛関連企業で働いており、データ制限が非常に厳しく、ポップアップや警告が表示されるのは私だけのものです。メタデータの多くはExcelやSharePointに保存されているその他のテーブルから取得しているので、この作業グループに参加できれば嬉しいです。
OneDrive と SharePoint データ コネクタの認証についてShare Pointへのコネクタの使い方を学ぶワークショップやデモは素晴らしいアイデアですね。この新しい機能を試してみたいと思っています。
OneDrive と SharePoint データ コネクタの認証についてこんにちは、 @chris_dennis さん。素晴らしいアイデアですね。 @Jordan_Hiller さんと@Jed_Campbell さんも同じ考えで、このウェビナーで取り上げる予定でした。必要に応じてセッションの拡大も検討します。https
/community.jmp.com/t5/Learn-JMP-Events/Accessing-Querying-and-Importing-Data-from-Databases/ec-p/919219
OneDrive と SharePoint データ コネクタの認証について4月10日 - もっと早ければ最高です!
Re: OneDriveとSharePointデータコネクタの認証こんにちは、 @willmorgan さん。ブログ記事とアプリをありがとうございます。アプリの導入と権限付与についてIT部門と話し合いましたが、ユーザーファイルへのアクセス、すべてのサイトコレクション内のアイテムの読み取りと管理アクセスが必要となるため、彼らは少し躊躇しています。
データセキュリティに関して、このアプリの使用はどの程度安全かご存知ですか?リスク(もしあれば)や接続の安全性についてIT部門に周知させるために、追加の資料やリンクを送付することは可能でしょうか?あるいは、特定のSharePoint内の特定のフォルダのみにアクセスを制限する方法はありますか?
再度、感謝します!
Re: OneDrive および SharePoint データ コネクタの認証こんにちは、 @Thibarely さん、コメントありがとうございます!SharePointデータコネクタのセキュリティについて、さらに詳しくご説明させていただきます。JMPのデータコネクタを支えるPythonコードは、お客様のシステム上で完全にローカルに実行されるため、JMPはお客様の会社のSharePointデータに一切アクセスできません。
弊社がホストする認証アプリは、Microsoft アカウントでログインするための仕組みを提供するものです。このアプリは、JMP のテナントではなく、お客様自身のテナント内で、お客様が名乗っている人物であることを確認し(認証)、要求された API 権限へのアクセスを許可します(認可)。その後、そのトークンがお客様のローカル マシン上で使用され、お客様の会社の SharePoint サーバーに対してリクエストが送信され、SharePoint サイトや OneDrive などへのアクセスが可能になります。お客様は、Microsoft アカウントが既にアクセス権限を持っているデータのみにアクセスできます。
特定のフォルダーへのアクセスを制限する点についてですが、コネクタはユーザーがアクセスできるすべてのデータにアクセスできるため、現時点ではコネクタがユーザーがアクセスできるデータにアクセスすることを禁止する方法はありません。ただし、必要に応じてフォルダーパラメーターを使用することで、コネクタがSharePointライブラリ全体を読み取ることを防ぐことができます。
OAuth2については、以下の図を参照してください。
willmorgan_0-1788196856428.png
この場合、JMPの認証アプリがOAuthサーバーとして機能します。ご覧のとおり、リソースサーバー(SharePointサイト)に対してリクエストを送信したり、アクセスを試みたりすることはありません。
さらに詳しい情報については、 こちらのページもご覧ください。お役に立てれば幸いです。ご不明な点がありましたら、お気軽にお問い合わせください。
よろしく、ウィル。