InteractiveBrowserCredential class
Etkileşimli oturum açma akışını kullanarak web tarayıcısının içinde Microsoft Entra ID kimlik doğrulamasını etkinleştirir.
Oluşturucular
Interactive |
Gereken ayrıntıları içeren bir InteractiveBrowserCredential örneği oluşturur. Bu kimlik bilgisi Yetkilendirme Kodu Akışı'nı kullanır.
Node.js kimlik doğrulama hizmetinden yeniden yönlendirme yanıtı dinlerken bir tarayıcı penceresi açılır.
Tarayıcılarda açılır pencereler aracılığıyla kimlik doğrulaması yapar. İsteğe Node.js için, bir |
Yöntemler
authenticate(string | string[], Get |
Microsoft Entra ID ile kimlik doğrulaması yapar ve başarılı olursa bir erişim belirteci döndürür. Kimlik doğrulaması başarısız olursa, hatanın ayrıntılarıyla birlikte bir CredentialUnavailableError oluşturulur. Belirteç sessizce alınamazsa, bu yöntem belirteci almak için kullanıcı etkileşimi gerektirir. Node.js'da, bu kimlik bilgisi varsayılan olarak Kod Değişimi (PKCE) için Yazım Denetleme Anahtarı'na sahiptir. PKCE, kimlik doğrulama kodu kesme saldırılarını azaltan bir güvenlik özelliğidir. |
get |
Microsoft Entra ID ile kimlik doğrulaması yapar ve başarılı olursa bir erişim belirteci döndürür. Kimlik doğrulaması başarısız olursa, hatanın ayrıntılarıyla birlikte bir CredentialUnavailableError oluşturulur. Kullanıcı seçeneğini |
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ışı'nı kullanır.
Node.js kimlik doğrulama hizmetinden yeniden yönlendirme yanıtı dinlerken bir tarayıcı penceresi açılır.
Tarayıcılarda açılır pencereler aracılığıyla kimlik doğrulaması yapar. İsteğe loginStyle
bağlı parametresi, kullanıcıyı bir Azure güvenli oturum açma sayfasına yönlendirerek kimlik doğrulaması için olarak ayarlanabilir redirect
. Bu sayfa kullanıcıyı kimlik doğrulamasının başlatıldığı web uygulamasına geri yönlendirir.
Node.js için, bir clientId
sağlanırsa, Microsoft Entra uygulamasının "Mobil ve masaüstü uygulamaları" yeniden yönlendirme uç noktasına sahip olacak şekilde yapılandırılması 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
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ğrulaması yapar ve başarılı olursa bir erişim belirteci döndürür. Kimlik doğrulaması başarısız olursa, hatanın ayrıntılarıyla birlikte bir CredentialUnavailableError oluşturulur.
Belirteç sessizce alınamazsa, bu yöntem belirteci almak için kullanıcı etkileşimi gerektirir.
Node.js'da, bu kimlik bilgisi varsayılan olarak Kod Değişimi (PKCE) için Yazım Denetleme Anahtarı'na sahiptir. 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ğrulaması yapar ve başarılı olursa bir erişim belirteci döndürür. Kimlik doğrulaması başarısız olursa, hatanın ayrıntılarıyla birlikte bir CredentialUnavailableError oluşturulur.
Kullanıcı seçeneğini disableAutomaticAuthentication
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>