OfficeRuntime.Auth interface
承認関連 API を含むインターフェイス。
注釈
このインターフェイスのメソッドは、インターフェイス内のメソッドと同 Office.auth じです。 将来新しい認証の種類が追加された場合、その認証の種類はインターフェイスにのみ追加 Office.auth されます。 わかりやすくするために、ドキュメントの使用全体のコード例 Office.auth.
メソッド
| get |
Azure Active Directory V 2.0 のエンドポイントを呼び出して、アドインの Web アプリケーションへのアクセス トークンを取得します。 アドインがユーザーを識別できます。 サーバー側のコードは、このトークンを使用して、"代理" OAuth フローを使用してアドインの web アプリケーションGraph Microsoft Graph にアクセスできます。. この API では、アドインを Azure アプリケーションにブリッジするシングル サインオン構成が必要です。 Office ユーザーは、組織アカウントと Microsoft アカウントを使用してサインインします。 Microsoft Azure では、Microsoft Graph のリソースにアクセスするために、両方のユーザー アカウントの種類を対象にしたトークンを返します。 重要: Outlook、アドインが Outlook.com または Gmail メールボックスに読み込まれている場合、この API はサポートされません。 |
メソッドの詳細
getAccessToken(options)
Azure Active Directory V 2.0 のエンドポイントを呼び出して、アドインの Web アプリケーションへのアクセス トークンを取得します。 アドインがユーザーを識別できます。 サーバー側のコードは、このトークンを使用して、"代理" OAuth フローを使用してアドインの web アプリケーションGraph Microsoft Graph にアクセスできます。. この API では、アドインを Azure アプリケーションにブリッジするシングル サインオン構成が必要です。 Office ユーザーは、組織アカウントと Microsoft アカウントを使用してサインインします。 Microsoft Azure では、Microsoft Graph のリソースにアクセスするために、両方のユーザー アカウントの種類を対象にしたトークンを返します。
重要: Outlook、アドインが Outlook.com または Gmail メールボックスに読み込まれている場合、この API はサポートされません。
getAccessToken(options?: AuthOptions): Promise<string>;
パラメーター
- options
- OfficeRuntime.AuthOptions
オプション。 サインオン動作 AuthOptions を定義するオブジェクトを受け入れる。
戻り値
Promise<string>
アクセス トークンを約束します。
注釈
ホスト: Excel、Outlook、PowerPoint、Word