Aracılığıyla paylaş


InteractiveBrowserCredentialNodeOptions interface

InteractiveBrowserCredential sınıfı için ortak seçenekleri tanımlar.

Extends

Özellikler

clientId

Kullanıcıların oturum açacağı Microsoft Entra uygulamasının İstemci Kimliği. Geliştiricilerin uygulamalarını kaydetmesi ve uygun roller ataması önerilir. Daha fazla bilgi için https://aka.ms/identity/AppRegistrationAndRoleAssignmentadresini ziyaret edin. Belirtilmezse, kullanıcılar üretim senaryoları için önerilmez bir Azure geliştirme uygulamasında kimlik doğrulaması yapar.

loginHint

loginHint, etkileşimli oturum açma işlemleri için kullanıcı adının önceden seçilmesine izin verir. Bu seçeneğin ayarlanması hesap seçim istemini atlar ve belirtilen hesapla hemen oturum açmayı dener.

redirectUri

Uygulamanın yeniden yönlendirme URI'sini alır. Bu, uygulama kayıt portalındaki değerle aynı olmalıdır. varsayılan olarak window.location.href. Bu alan artık Node.jsiçin gerekli değildir.

tenantId

Microsoft Entra kiracısı (dizin) kimliği.

Devralınan Özellikler

additionallyAllowedTenants

Çok kiracılı uygulamalar için, kimlik bilgilerinin belirteçleri edinebileceği ek kiracıları belirtir. Kimlik bilgilerinin uygulamanın yüklü olduğu herhangi bir kiracı için belirteç almasına izin vermek için "*" joker karakter değerini ekleyin.

additionalPolicies

HTTP işlem hattına eklenecek ek ilkeler.

agent

Giden istekler için Aracı örneğini yapılandırma seçenekleri

allowInsecureConnection

İstek HTTPS yerine HTTP üzerinden gönderiliyorsa true olarak ayarlayın

authenticationRecord

Her bir hesabın önbelleğe alınmış kimlik bilgilerini almak için kullanılabilecek önceki kimlik doğrulamasının sonucu. Bu, uygulamanın İstemci Kimliği ve Kiracı Kimliği çifti başına birden fazla hesapla çalışmak istemesi durumunda sağlamak için gereklidir.

Bu kayıt, kimlik bilgilerinin authenticate() yöntemine aşağıdaki gibi çağrılarak alınabilir:

const authenticationRecord = await credential.authenticate();
authorityHost

Kimlik doğrulama istekleri için kullanılacak yetkili ana bilgisayar. Olası değerler AzureAuthorityHostsaracılığıyla kullanılabilir. Varsayılan değer "https://login.microsoftonline.com".

brokerOptions

InteractiveBrowserCredential kullanırken aracı kimlik doğrulamasına izin verme seçenekleri

browserCustomizationOptions

Tarayıcı özelleştirmesi için paylaşılan yapılandırma seçenekleri

disableAutomaticAuthentication

El ile kimlik doğrulaması gerekiyorsa getToken throw yapar. Geliştiricilerin el ile kimlik doğrulamasının ne zaman olacağını denetlemek için authenticate() araması gerekir.

disableInstanceDiscovery

alanı, kimlik doğrulaması yapılırken örnek bulmanın gerçekleştirilip gerçekleştirilmeyeceğini belirler. Bunu true olarak ayarlamak hem örnek bulma hem de yetkili doğrulamayı tamamen devre dışı bırakır. Sonuç olarak, yapılandırılan yetkili konağın geçerli ve güvenilir olduğundan emin olmak çok önemlidir. Bu işlev, meta veri uç noktasına erişilemeyen özel bulutlar veya Azure Stack gibi senaryolarda kullanılmak üzere tasarlanmıştır. Örnek bulma işlemi, yetkiliyi doğrulamak için https://login.microsoft.com/ yetkili meta verilerini almayı gerektirir.

httpClient

HTTP istekleri göndermek için kullanılacak HttpClient.

loggingOptions

Kullanıcıların ilke seçeneklerini günlüğe kaydetme ayarlarını yapılandırmasına, günlük hesabı bilgilerine ve müşteri desteği için kişisel bilgilere izin vermesine olanak tanır.

proxyOptions

Giden istekler için ara sunucu yapılandırma seçenekleri.

redirectOptions

Yeniden yönlendirme yanıtlarının nasıl işleneceğini gösteren seçenekler.

retryOptions

Başarısız isteklerin nasıl yeniden denendiğini denetleyebilen seçenekler.

telemetryOptions

Giden isteklere ortak telemetri ve izleme bilgilerini ayarlama seçenekleri.

tlsOptions

TLS kimlik doğrulamasını yapılandırma seçenekleri

tokenCachePersistenceOptions

Kimlik bilgilerini depolarken kalıcılık katmanına (varsa) sağlama seçenekleri.

Önce bir kalıcılık sağlayıcısı eklentisi kaydetmeniz gerekir. NPM'de @azure/identity-cache-persistence paketine bakın.

Örnek:

import { useIdentityPlugin, DeviceCodeCredential } from "@azure/identity";

useIdentityPlugin(cachePersistencePlugin);

const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});
userAgentOptions

Giden isteklere kullanıcı aracısı ayrıntılarını ekleme seçenekleri.

Özellik Ayrıntıları

clientId

Kullanıcıların oturum açacağı Microsoft Entra uygulamasının İstemci Kimliği. Geliştiricilerin uygulamalarını kaydetmesi ve uygun roller ataması önerilir. Daha fazla bilgi için https://aka.ms/identity/AppRegistrationAndRoleAssignmentadresini ziyaret edin. Belirtilmezse, kullanıcılar üretim senaryoları için önerilmez bir Azure geliştirme uygulamasında kimlik doğrulaması yapar.

clientId?: string

Özellik Değeri

string

loginHint

loginHint, etkileşimli oturum açma işlemleri için kullanıcı adının önceden seçilmesine izin verir. Bu seçeneğin ayarlanması hesap seçim istemini atlar ve belirtilen hesapla hemen oturum açmayı dener.

loginHint?: string

Özellik Değeri

string

redirectUri

Uygulamanın yeniden yönlendirme URI'sini alır. Bu, uygulama kayıt portalındaki değerle aynı olmalıdır. varsayılan olarak window.location.href. Bu alan artık Node.jsiçin gerekli değildir.

redirectUri?: string | () => string

Özellik Değeri

string | () => string

tenantId

Microsoft Entra kiracısı (dizin) kimliği.

tenantId?: string

Özellik Değeri

string

Devralınan Özellik Detayları

additionallyAllowedTenants

Çok kiracılı uygulamalar için, kimlik bilgilerinin belirteçleri edinebileceği ek kiracıları belirtir. Kimlik bilgilerinin uygulamanın yüklü olduğu herhangi bir kiracı için belirteç almasına izin vermek için "*" joker karakter değerini ekleyin.

additionallyAllowedTenants?: string[]

Özellik Değeri

string[]

InteractiveCredentialOptions.additionallyAllowedTenants

additionalPolicies

HTTP işlem hattına eklenecek ek ilkeler.

additionalPolicies?: AdditionalPolicyConfig[]

Özellik Değeri

InteractiveCredentialOptions.additionalPoliciesDevralındı

agent

Giden istekler için Aracı örneğini yapılandırma seçenekleri

agent?: Agent

Özellik Değeri

Devralındığı yer:InteractiveCredentialOptions.agent

allowInsecureConnection

İstek HTTPS yerine HTTP üzerinden gönderiliyorsa true olarak ayarlayın

allowInsecureConnection?: boolean

Özellik Değeri

boolean

DevralınanInteractiveCredentialOptions.allowInsecureConnection

authenticationRecord

Her bir hesabın önbelleğe alınmış kimlik bilgilerini almak için kullanılabilecek önceki kimlik doğrulamasının sonucu. Bu, uygulamanın İstemci Kimliği ve Kiracı Kimliği çifti başına birden fazla hesapla çalışmak istemesi durumunda sağlamak için gereklidir.

Bu kayıt, kimlik bilgilerinin authenticate() yöntemine aşağıdaki gibi çağrılarak alınabilir:

const authenticationRecord = await credential.authenticate();
authenticationRecord?: AuthenticationRecord

Özellik Değeri

InteractiveCredentialOptions.authenticationRecord'dan Devralındı

authorityHost

Kimlik doğrulama istekleri için kullanılacak yetkili ana bilgisayar. Olası değerler AzureAuthorityHostsaracılığıyla kullanılabilir. Varsayılan değer "https://login.microsoftonline.com".

authorityHost?: string

Özellik Değeri

string

InteractiveCredentialOptions.authorityHostDevralındı

brokerOptions

InteractiveBrowserCredential kullanırken aracı kimlik doğrulamasına izin verme seçenekleri

brokerOptions?: BrokerOptions

Özellik Değeri

BrokerAuthOptions.brokerOptionsDevralındı

browserCustomizationOptions

Tarayıcı özelleştirmesi için paylaşılan yapılandırma seçenekleri

browserCustomizationOptions?: { errorMessage?: string, successMessage?: string }

Özellik Değeri

{ errorMessage?: string, successMessage?: string }

Tarayıcıdan Devralınan CustomizationOptions.browserCustomizationOptions

disableAutomaticAuthentication

El ile kimlik doğrulaması gerekiyorsa getToken throw yapar. Geliştiricilerin el ile kimlik doğrulamasının ne zaman olacağını denetlemek için authenticate() araması gerekir.

disableAutomaticAuthentication?: boolean

Özellik Değeri

boolean

InteractiveCredentialOptions.disableAutomaticAuthentication'dan Devralınmış

disableInstanceDiscovery

alanı, kimlik doğrulaması yapılırken örnek bulmanın gerçekleştirilip gerçekleştirilmeyeceğini belirler. Bunu true olarak ayarlamak hem örnek bulma hem de yetkili doğrulamayı tamamen devre dışı bırakır. Sonuç olarak, yapılandırılan yetkili konağın geçerli ve güvenilir olduğundan emin olmak çok önemlidir. Bu işlev, meta veri uç noktasına erişilemeyen özel bulutlar veya Azure Stack gibi senaryolarda kullanılmak üzere tasarlanmıştır. Örnek bulma işlemi, yetkiliyi doğrulamak için https://login.microsoft.com/ yetkili meta verilerini almayı gerektirir.

disableInstanceDiscovery?: boolean

Özellik Değeri

boolean

InteractiveCredentialOptions.disableInstanceDiscoveryDevralındı

httpClient

HTTP istekleri göndermek için kullanılacak HttpClient.

httpClient?: HttpClient

Özellik Değeri

InteractiveCredentialOptions.httpClient'dan Devralınan

loggingOptions

Kullanıcıların ilke seçeneklerini günlüğe kaydetme ayarlarını yapılandırmasına, günlük hesabı bilgilerine ve müşteri desteği için kişisel bilgilere izin vermesine olanak tanır.

loggingOptions?: LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }

Özellik Değeri

LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }

InteractiveCredentialOptions.loggingOptions Devralınmış

proxyOptions

Giden istekler için ara sunucu yapılandırma seçenekleri.

proxyOptions?: ProxySettings

Özellik Değeri

InteractiveCredentialOptions.proxyOptionsDevralındı

redirectOptions

Yeniden yönlendirme yanıtlarının nasıl işleneceğini gösteren seçenekler.

redirectOptions?: RedirectPolicyOptions

Özellik Değeri

InteractiveCredentialOptions.redirectOptionsDevralındı

retryOptions

Başarısız isteklerin nasıl yeniden denendiğini denetleyebilen seçenekler.

retryOptions?: PipelineRetryOptions

Özellik Değeri

InteractiveCredentialOptions.retryOptions Devralınmış

telemetryOptions

Giden isteklere ortak telemetri ve izleme bilgilerini ayarlama seçenekleri.

telemetryOptions?: TelemetryOptions

Özellik Değeri

InteractiveCredentialOptions.telemetryOptionsDevralındı

tlsOptions

TLS kimlik doğrulamasını yapılandırma seçenekleri

tlsOptions?: TlsSettings

Özellik Değeri

InteractiveCredentialOptions.tlsOptionsDevralındı

tokenCachePersistenceOptions

Kimlik bilgilerini depolarken kalıcılık katmanına (varsa) sağlama seçenekleri.

Önce bir kalıcılık sağlayıcısı eklentisi kaydetmeniz gerekir. NPM'de @azure/identity-cache-persistence paketine bakın.

Örnek:

import { useIdentityPlugin, DeviceCodeCredential } from "@azure/identity";

useIdentityPlugin(cachePersistencePlugin);

const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});
tokenCachePersistenceOptions?: TokenCachePersistenceOptions

Özellik Değeri

CredentialPersistenceOptions.tokenCachePersistenceOptionsDevralındı

userAgentOptions

Giden isteklere kullanıcı aracısı ayrıntılarını ekleme seçenekleri.

userAgentOptions?: UserAgentPolicyOptions

Özellik Değeri

InteractiveCredentialOptions.userAgentOptions Devralınmış