InteractiveBrowserCredential class
対話型ログイン フローを使用して、Web ブラウザー内の Microsoft Entra ID に対する認証を有効にします。
コンストラクター
Interactive |
必要な詳細を使用して InteractiveBrowserCredential のインスタンスを作成します。 この資格情報は、承認コード フローを使用します。
Node.jsでは、認証サービスからのリダイレクト応答をリッスンしている間にブラウザー ウィンドウが開きます。
ブラウザーでは、ポップアップを介して認証されます。
Node.jsの場合、 |
メソッド
authenticate(string | string[], Get |
Microsoft Entra ID を使用して認証し、成功した場合はアクセス トークンを返します。 認証に失敗すると、CredentialUnavailableError がスローされ、エラーの詳細が表示されます。 トークンをサイレントで取得できない場合、このメソッドは常にユーザーにチャレンジを生成します。 Node.jsでは、この資格情報は既定で有効 Code Exchange (PKCE) の Proof Key (PKCE) を持っています。 PKCE は、認証コードの傍受攻撃を軽減するセキュリティ機能です。 |
get |
Microsoft Entra ID を使用して認証し、成功した場合はアクセス トークンを返します。 認証に失敗すると、CredentialUnavailableError がスローされ、エラーの詳細が表示されます。 ユーザーがオプション |
コンストラクターの詳細
InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)
必要な詳細を使用して InteractiveBrowserCredential のインスタンスを作成します。
この資格情報は、承認コード フローを使用します。
Node.jsでは、認証サービスからのリダイレクト応答をリッスンしている間にブラウザー ウィンドウが開きます。
ブラウザーでは、ポップアップを介して認証されます。
loginStyle
省略可能なパラメーターは、ユーザーを Azure のセキュリティで保護されたログイン ページにリダイレクトして認証を行う redirect
に設定できます。これにより、認証が開始された Web アプリケーションにユーザーがリダイレクトされます。
Node.jsの場合、clientId
が提供されている場合は、"モバイルおよびデスクトップ アプリケーション" リダイレクト エンドポイントを持つよう Microsoft Entra アプリケーションを構成する必要があります。
Web APIを呼び出すデスクトップ アプリのリダイレクト URI を設定する
new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)
パラメーター
認証要求を行うクライアントを構成するためのオプション。
メソッドの詳細
authenticate(string | string[], GetTokenOptions)
Microsoft Entra ID を使用して認証し、成功した場合はアクセス トークンを返します。 認証に失敗すると、CredentialUnavailableError がスローされ、エラーの詳細が表示されます。
トークンをサイレントで取得できない場合、このメソッドは常にユーザーにチャレンジを生成します。
Node.jsでは、この資格情報は既定で有効 Code Exchange (PKCE) の Proof Key (PKCE) を持っています。 PKCE は、認証コードの傍受攻撃を軽減するセキュリティ機能です。
function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>
パラメーター
- scopes
-
string | string[]
トークンがアクセスできるスコープの一覧。
- options
- GetTokenOptions
この TokenCredential 実装が行う可能性がある要求を構成するために使用されるオプション。
戻り値
Promise<undefined | AuthenticationRecord>
getToken(string | string[], GetTokenOptions)
Microsoft Entra ID を使用して認証し、成功した場合はアクセス トークンを返します。 認証に失敗すると、CredentialUnavailableError がスローされ、エラーの詳細が表示されます。
ユーザーがオプション disableAutomaticAuthentication
を指定した場合、トークンをサイレントモードで取得できない場合、このメソッドはトークンを取得するためのユーザー操作を要求しません。
function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>
パラメーター
- scopes
-
string | string[]
トークンがアクセスできるスコープの一覧。
- options
- GetTokenOptions
この TokenCredential 実装が行う可能性がある要求を構成するために使用されるオプション。
戻り値
Promise<AccessToken>