> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

# プロバイダーがホストするアプリをSharePoint Onlineに接続

> プロバイダーがホストするアプリをSharePoint Onlineに接続する方法です。

Auth0を使用すると、SharePointアプリの認証プロセスを大幅に簡素化できます。Auth0は、SharePoint APIを呼び出すために使用できるアクセストークンをネゴシエートします。

特別なライブラリは必要ありません。Auth0でサポートされているSDKのいずれかを使用できます。

<div id="step-1-register-your-application-in-auth0">
  ## 1.Auth0にアプリケーションを登録する
</div>

通常どおり、Auth0に新しいアプリケーションを登録するだけです。 **［Applications（アプリケーション）］ > ［NEW（新規）］** 。詳細なステップについては、利用可能なSDKのいずれかを選択してください。次のステップで必要になるので、`client_id`を手元に置いてください。

<div id="step-2-create-a-package-for-your-application">
  ## 2.アプリケーションのパッケージを作成する
</div>

アプリケーションの **クライアントID** と **クライアントシークレット** を取得する必要があります。想定される使用方法に応じて、アプリケーションを登録する方法は多数あります。

[SharePointアドインの登録（Microsoft Docs）](https://docs.microsoft.com/en-us/sharepoint/dev/sp-add-ins/register-sharepoint-add-ins)では、SharePointにアプリケーションを登録するさまざまな方法について説明しています。このチュートリアルステップでは、最も単純な形式、つまり特定のテナント（自分のテナント）での自己登録を使用します。

<div id="open-sharepoint-online">
  ### SharePoint Onlineを開く
</div>

ダッシュボードのURLは`https://{your Office365 tenant}.sharepoint.com/_layouts/15/appregnew.aspx`です。

<div id="generate-a-client_id-and-clientsecret">
  ### Client\_IdおよびClientSecretを生成します。
</div>

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/PUgbyUqJRl3iBJzI/docs/images/ja-jp/cdy7uua7fh8z/2BLGIJdnfbknayoyF4U5wP/70e66c7d10a001e0eb7ffa7aaebfb035/90SvG.png?fit=max&auto=format&n=PUgbyUqJRl3iBJzI&q=85&s=94e1eb7e780d2fdf65b0af9b2513e0be" alt="SharePoint - generate client id - generate client secret" width="750" height="671" data-path="docs/images/ja-jp/cdy7uua7fh8z/2BLGIJdnfbknayoyF4U5wP/70e66c7d10a001e0eb7ffa7aaebfb035/90SvG.png" />
</Frame>

<div id="complete-the-information-in-the-form">
  ### フォームに情報を入力します。
</div>

Auth0はアプリとOffice 365インフラストラクチャの間にあるため、アプリにはこのURLを使用する必要があります。

**アプリドメイン** :

{yourDomain}

**リダイレクトURI** :

`[https://{yourDomain}/login/callback?SP_APP_TOKEN&connection=CONNECTION&client_id={yourClientId}&redirect_uri={https://yourApp/callback}](https://{yourDomain}/login/callback?SP_APP_TOKEN&connection=CONNECTION&client_id={yourClientId}&redirect_uri={https://yourApp/callback})`

* `connection`は、Auth0の接続で使用する名前です（「sharepoint」など）。
* `client_id`は、Auth0でアプリを識別します（ステップ1で作成）。
* `redirect_uri`は、すべてのネゴシエーションが完了した後にユーザーが最終的にアクセスする実際のアプリ内の場所です。指定しない場合は、常にAuth0で定義されたアプリのコールバックURLになります（localhostの場合もあります）

<div id="package-the-app-and-upload-to-sharepoint">
  ### アプリをパッケージ化してSharePointにアップロードします。
</div>

Visual Studioでアプリマニフェストの情報を入力します:

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/fJ7FJkQ9-WdlT49P/docs/images/ja-jp/cdy7uua7fh8z/36dscLHlLHZjJx1rLgrQ7N/8d64ec7a51f4e053627ecb5dfd3c7707/90SEc.png?fit=max&auto=format&n=fJ7FJkQ9-WdlT49P&q=85&s=fdb00cd5748ccccc45f9d341ad9f6946" alt="SharePoint - Visual Studio - Application Manifest" width="750" height="587" data-path="docs/images/ja-jp/cdy7uua7fh8z/36dscLHlLHZjJx1rLgrQ7N/8d64ec7a51f4e053627ecb5dfd3c7707/90SEc.png" />
</Frame>

`Query文字列`は、前に入力した`リダイレクトURI`とまったく同じになることに注意してください。次に、プロジェクトを右クリックして`［Publish（発行）］`を選択します。

**Publishing Profile（発行プロファイル）** を作成します（SharePointダッシュボードで取得した同じ **クライアントID** と **クライアントシークレット** を入力する必要があります）。

**［Package（パッケージ）］** をクリックし、結果のファイルをSharePointにアップロードします。

<div id="step-3-create-the-connection-in-auth0">
  ## 3.Auth0で接続を作成する
</div>

統合の最後のステップは、Auth0でSharePoint接続を追加することです。

次のものが必要です。

* `Connection Name（接続名）`。これは任意の名前です。ステップ2で入力したものと一致する必要があります。
* `クライアントID`および`クライアントシークレット`。ステップ2で入力したものと一致する必要があります。
* `テスト用SharePointサイトURL`。これは、接続をテストするために使用されるSPサイトURLです。（ダッシュボードの［試す］ボタンを押したときなど）。ユーザーは常にSharePoint内からサイトへのリンクをたどるため、実行時には使用されません。

ユーザーはOffice Marketplaceからアプリをインストールします。リンクをクリックするとAuth0にリダイレクトされ、Auth0がアクセストークンをネゴシエートして、最終的にアプリにリダイレクトされます。アプリは次のような`ユーザープロファイル`を受け取ります。

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/xDgF_gm8-0tTk54s/docs/images/ja-jp/cdy7uua7fh8z/4piqwmx1ONWMd3kjTFMq4I/714545f5cda3ab1d1dd5c620bc96b083/8Xp6x.png?fit=max&auto=format&n=xDgF_gm8-0tTk54s&q=85&s=5a10137576202e5b60e0041ddabd41a4" alt="Office Marketplace - Redirect -  User Profile Example" width="705" height="750" data-path="docs/images/ja-jp/cdy7uua7fh8z/4piqwmx1ONWMd3kjTFMq4I/714545f5cda3ab1d1dd5c620bc96b083/8Xp6x.png" />
</Frame>

次のプロパティが含まれます。`cacheKey`、`refresh_token`、`host`、および`site`。これらにより、SharePoint API（リストなど）をコールバックできます。
