Поделиться через

InteractiveBrowserCredential class

  • Ссылка
Пакет:
@azure/identity

Включает проверку подлинности в идентификаторе Microsoft Entra внутри веб-браузера с помощью интерактивного потока входа.

Конструкторы

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Создает экземпляр InteractiveBrowserCredential с необходимыми сведениями.

Эти учетные данные используютпотока кода авторизации . В Node.jsоткроется окно браузера во время прослушивания ответа перенаправления из службы проверки подлинности. В браузерах он проходит проверку подлинности с помощью всплывающих окон. loginStyle необязательный параметр можно задать для redirect для проверки подлинности путем перенаправления пользователя на страницу безопасного входа Azure, которая затем перенаправит пользователя обратно в веб-приложение, где началась проверка подлинности.

Для Node.js, если указана clientId, приложение Microsoft Entra должно быть настроено на конечную точку перенаправления мобильных и классических приложений. Следуйте нашему руководству по настройке URI перенаправления для классических приложений, которые вызывают веб-API.

Методы

authenticate(string | string[], GetTokenOptions)

Выполняет проверку подлинности с помощью идентификатора Microsoft Entra и возвращает маркер доступа в случае успешного выполнения. Если проверка подлинности завершается ошибкой, CredentialUnavailableError будет возникать с подробными сведениями об ошибке.

Если маркер не может быть получен автоматически, этот метод всегда создает вызов для пользователя.

В Node.jsэти учетные данные имеют ключ проверки правописания для Exchange (PKCE) по умолчанию. PKCE — это функция безопасности, которая устраняет атаки перехвата кода проверки подлинности.
getToken(string | string[], GetTokenOptions)

Выполняет проверку подлинности с помощью идентификатора Microsoft Entra и возвращает маркер доступа в случае успешного выполнения. Если проверка подлинности завершается ошибкой, CredentialUnavailableError будет возникать с подробными сведениями об ошибке.

Если пользователь предоставил параметр disableAutomaticAuthentication, после автоматического получения маркера этот метод не попытается запросить взаимодействие с пользователем для получения маркера.

Сведения о конструкторе

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Создает экземпляр InteractiveBrowserCredential с необходимыми сведениями.

Эти учетные данные используютпотока кода авторизации . В Node.jsоткроется окно браузера во время прослушивания ответа перенаправления из службы проверки подлинности. В браузерах он проходит проверку подлинности с помощью всплывающих окон. loginStyle необязательный параметр можно задать для redirect для проверки подлинности путем перенаправления пользователя на страницу безопасного входа Azure, которая затем перенаправит пользователя обратно в веб-приложение, где началась проверка подлинности.

Для Node.js, если указана clientId, приложение Microsoft Entra должно быть настроено на конечную точку перенаправления мобильных и классических приложений. Следуйте нашему руководству по настройке URI перенаправления для классических приложений, которые вызывают веб-API.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Параметры

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Параметры настройки клиента, выполняющего запросы проверки подлинности.

Сведения о методе

authenticate(string | string[], GetTokenOptions)

Выполняет проверку подлинности с помощью идентификатора Microsoft Entra и возвращает маркер доступа в случае успешного выполнения. Если проверка подлинности завершается ошибкой, CredentialUnavailableError будет возникать с подробными сведениями об ошибке.

Если маркер не может быть получен автоматически, этот метод всегда создает вызов для пользователя.

В Node.jsэти учетные данные имеют ключ проверки правописания для Exchange (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 и возвращает маркер доступа в случае успешного выполнения. Если проверка подлинности завершается ошибкой, CredentialUnavailableError будет возникать с подробными сведениями об ошибке.

Если пользователь предоставил параметр disableAutomaticAuthentication, после автоматического получения маркера этот метод не попытается запросить взаимодействие с пользователем для получения маркера.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

Параметры

scopes

string | string[]

Список областей, для которых маркер будет иметь доступ.

options
GetTokenOptions

Параметры, используемые для настройки любых запросов этой реализации TokenCredential, могут выполняться.

Возвращаемое значение

Promise<AccessToken>