InteractiveBrowserCredential class

Etkileşimli giriş akışı kullanılarak web tarayıcısının içinde Microsoft Entra ID'ye kimlik doğrulama sağlanmasını sağlar.

Oluşturucular

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Gereken ayrıntıları içeren bir InteractiveBrowserCredential örneği oluşturur.

Bu kimlik bilgisi Yetkilendirme Kodu Akışıkullanır. Node.jskimlik doğrulama hizmetinden bir yeniden yönlendirme yanıtı dinlerken bir tarayıcı penceresi açar. Tarayıcılarda, açılır pencereler aracılığıyla kimlik doğrulaması yapar. loginStyle isteğe bağlı parametresi, kullanıcıyı Azure güvenli bir giriş sayfasına yönlendirerek kimlik doğrulama için redirect olarak ayarlanabilir; bu da kullanıcıyı doğrulamanın başladığı web uygulamasına yönlendirir.

Node.jsiçin, eğer clientId sağlanırsa, Microsoft Entra uygulamasının "Mobil ve masaüstü uygulamaları" yönlendirme uç noktasına sahip olması gerekir. web API'lerine çağrıda bulunan Masaüstü uygulamaları için Yeniden Yönlendirme URI'lerini ayarlama kılavuzumuzu izleyin.

Yöntemler

authenticate(string | string[], GetTokenOptions)

Microsoft Entra ID ile kimlik doğrulama yapar ve başarılı olursa erişim tokenı döndürür. Kimlik doğrulaması başarısız olursa, CredentialUnavailableError hatanın ayrıntılarıyla birlikte oluşturulur.

Belirteç sessizce alınamazsa, bu yöntem her zaman kullanıcı için bir sınama oluşturur.

Node.jsile bu kimlik bilgisi varsayılan olarak Proof Key for Code Exchange (PKCE) etkindir. PKCE, kimlik doğrulama kodu kesme saldırılarını azaltan bir güvenlik özelliğidir.

getToken(string | string[], GetTokenOptions)

Microsoft Entra ID ile kimlik doğrulama yapar ve başarılı olursa erişim tokenı döndürür. Kimlik doğrulaması başarısız olursa, CredentialUnavailableError hatanın ayrıntılarıyla birlikte oluşturulur.

Kullanıcı disableAutomaticAuthenticationseçeneğini sağladıysa, belirteç sessizce alınamadıktan sonra, bu yöntem belirteci almak için kullanıcı etkileşimi istemeye çalışmaz.

Oluşturucu Ayrıntıları

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Gereken ayrıntıları içeren bir InteractiveBrowserCredential örneği oluşturur.

Bu kimlik bilgisi Yetkilendirme Kodu Akışıkullanır. Node.jskimlik doğrulama hizmetinden bir yeniden yönlendirme yanıtı dinlerken bir tarayıcı penceresi açar. Tarayıcılarda, açılır pencereler aracılığıyla kimlik doğrulaması yapar. loginStyle isteğe bağlı parametresi, kullanıcıyı Azure güvenli bir giriş sayfasına yönlendirerek kimlik doğrulama için redirect olarak ayarlanabilir; bu da kullanıcıyı doğrulamanın başladığı web uygulamasına yönlendirir.

Node.jsiçin, eğer clientId sağlanırsa, Microsoft Entra uygulamasının "Mobil ve masaüstü uygulamaları" yönlendirme uç noktasına sahip olması gerekir. web API'lerine çağrıda bulunan Masaüstü uygulamaları için Yeniden Yönlendirme URI'lerini ayarlama kılavuzumuzu izleyin.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Parametreler

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Kimlik doğrulama isteklerini yapan istemciyi yapılandırma seçenekleri.

Yöntem Ayrıntıları

authenticate(string | string[], GetTokenOptions)

Microsoft Entra ID ile kimlik doğrulama yapar ve başarılı olursa erişim tokenı döndürür. Kimlik doğrulaması başarısız olursa, CredentialUnavailableError hatanın ayrıntılarıyla birlikte oluşturulur.

Belirteç sessizce alınamazsa, bu yöntem her zaman kullanıcı için bir sınama oluşturur.

Node.jsile bu kimlik bilgisi varsayılan olarak Proof Key for Code Exchange (PKCE) etkindir. PKCE, kimlik doğrulama kodu kesme saldırılarını azaltan bir güvenlik özelliğidir.

function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>

Parametreler

scopes

string | string[]

Belirtecin erişeceği kapsamların listesi.

options
GetTokenOptions

Bu TokenCredential uygulamasının gerçekleştirebileceği istekleri yapılandırmak için kullanılan seçenekler.

Döndürülenler

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Microsoft Entra ID ile kimlik doğrulama yapar ve başarılı olursa erişim tokenı döndürür. Kimlik doğrulaması başarısız olursa, CredentialUnavailableError hatanın ayrıntılarıyla birlikte oluşturulur.

Kullanıcı disableAutomaticAuthenticationseçeneğini sağladıysa, belirteç sessizce alınamadıktan sonra, bu yöntem belirteci almak için kullanıcı etkileşimi istemeye çalışmaz.

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

Parametreler

scopes

string | string[]

Belirtecin erişeceği kapsamların listesi.

options
GetTokenOptions

Bu TokenCredential uygulamasının gerçekleştirebileceği istekleri yapılandırmak için kullanılan seçenekler.

Döndürülenler

Promise<AccessToken>