次の方法で共有


InteractiveBrowserCredential class

対話型ログイン フローを使用して、Web ブラウザー内の Microsoft Entra ID に対する認証を有効にします。

コンストラクター

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

必要な詳細を使用して InteractiveBrowserCredential のインスタンスを作成します。

この資格情報は、承認コード フローを使用します。 Node.jsでは、認証サービスからのリダイレクト応答をリッスンしている間にブラウザー ウィンドウが開きます。 ブラウザーでは、ポップアップを介して認証されます。 loginStyle 省略可能なパラメーターは、ユーザーを Azure のセキュリティで保護されたログイン ページにリダイレクトして認証を行う redirect に設定できます。これにより、認証が開始された Web アプリケーションにユーザーがリダイレクトされます。

Node.jsの場合、clientId が提供されている場合は、"モバイルおよびデスクトップ アプリケーション" リダイレクト エンドポイントを持つよう Microsoft Entra アプリケーションを構成する必要があります。 Web APIを呼び出すデスクトップ アプリのリダイレクト URI を設定する に関するガイドに従ってください。

メソッド

authenticate(string | string[], GetTokenOptions)

Microsoft Entra ID を使用して認証し、成功した場合はアクセス トークンを返します。 認証に失敗すると、CredentialUnavailableError がスローされ、エラーの詳細が表示されます。

トークンをサイレントで取得できない場合、このメソッドは常にユーザーにチャレンジを生成します。

Node.jsでは、この資格情報は既定で有効 Code Exchange (PKCE) の Proof Key (PKCE) を持っています。 PKCE は、認証コードの傍受攻撃を軽減するセキュリティ機能です。

getToken(string | string[], GetTokenOptions)

Microsoft Entra ID を使用して認証し、成功した場合はアクセス トークンを返します。 認証に失敗すると、CredentialUnavailableError がスローされ、エラーの詳細が表示されます。

ユーザーがオプション disableAutomaticAuthenticationを指定した場合、トークンをサイレントモードで取得できない場合、このメソッドはトークンを取得するためのユーザー操作を要求しません。

コンストラクターの詳細

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

必要な詳細を使用して InteractiveBrowserCredential のインスタンスを作成します。

この資格情報は、承認コード フローを使用します。 Node.jsでは、認証サービスからのリダイレクト応答をリッスンしている間にブラウザー ウィンドウが開きます。 ブラウザーでは、ポップアップを介して認証されます。 loginStyle 省略可能なパラメーターは、ユーザーを Azure のセキュリティで保護されたログイン ページにリダイレクトして認証を行う redirect に設定できます。これにより、認証が開始された Web アプリケーションにユーザーがリダイレクトされます。

Node.jsの場合、clientId が提供されている場合は、"モバイルおよびデスクトップ アプリケーション" リダイレクト エンドポイントを持つよう Microsoft Entra アプリケーションを構成する必要があります。 Web APIを呼び出すデスクトップ アプリのリダイレクト URI を設定する に関するガイドに従ってください。

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

パラメーター

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>