InteractiveBrowserCredentialNodeOptions interface
Menentukan opsi umum untuk kelas InteractiveBrowserCredential.
- Extends
Properti
client |
ID klien (aplikasi) Pendaftaran Aplikasi di penyewa. |
login |
loginHint memungkinkan nama pengguna dipilih sebelumnya untuk login interaktif. Mengatur opsi ini melewati perintah pemilihan akun dan segera mencoba masuk dengan akun yang ditentukan. |
redirect |
Mendapatkan URI pengalihan aplikasi. Ini harus sama dengan nilai di portal pendaftaran aplikasi. Default ke |
tenant |
ID penyewa (direktori) Microsoft Entra. |
Properti yang Diwariskan
additionally |
Untuk aplikasi multi-penyewa, menentukan penyewa tambahan yang kredensialnya dapat memperoleh token. Tambahkan nilai kartubebas "*" untuk memungkinkan kredensial memperoleh token untuk penyewa mana pun yang diinstal aplikasi. |
additional |
Kebijakan tambahan untuk disertakan dalam alur HTTP. |
allow |
Atur ke true jika permintaan dikirim melalui HTTP alih-alih HTTPS |
authentication |
Hasil autentikasi sebelumnya yang dapat digunakan untuk mengambil kredensial yang di-cache dari setiap akun individu. Ini perlu disediakan jika aplikasi ingin bekerja dengan lebih dari satu akun per ID Klien dan pasangan ID Penyewa. Catatan ini dapat diambil dengan memanggil metode kredensial
|
authority |
Host otoritas yang digunakan untuk permintaan autentikasi. Nilai yang mungkin tersedia melalui AzureAuthorityHosts. Defaultnya adalah "https://login.microsoftonline.com". |
broker |
Opsi untuk mengizinkan autentikasi broker saat menggunakan InteractiveBrowserCredential |
browser |
Opsi konfigurasi bersama untuk kustomisasi browser |
disable |
Membuat getToken melempar jika autentikasi manual diperlukan.
Pengembang harus memanggil untuk |
disable |
Bidang menentukan apakah penemuan instans dilakukan saat mencoba mengautentikasi.
Mengatur ini ke |
http |
HttpClient yang akan digunakan untuk mengirim permintaan HTTP. |
logging |
Memungkinkan pengguna mengonfigurasi pengaturan untuk opsi kebijakan pengelogan, memungkinkan informasi akun pengelogan dan informasi pengidentifikasi pribadi untuk dukungan pelanggan. |
proxy |
Opsi untuk mengonfigurasi proksi untuk permintaan keluar. |
redirect |
Opsi tentang cara respons pengalihan ditangani. |
retry |
Opsi yang mengontrol cara mencoba kembali permintaan yang gagal. |
telemetry |
Opsi untuk mengatur telemetri umum dan melacak info ke permintaan keluar. |
tls |
Opsi untuk mengonfigurasi autentikasi TLS |
token |
Opsi untuk menyediakan lapisan persistensi (jika tersedia) saat menyimpan kredensial. Anda harus terlebih dahulu mendaftarkan plugin penyedia persistensi. Lihat paket di Contoh:
|
user |
Opsi untuk menambahkan detail agen pengguna ke permintaan keluar. |
Detail Properti
clientId
ID klien (aplikasi) Pendaftaran Aplikasi di penyewa.
clientId?: string
Nilai Properti
string
loginHint
loginHint memungkinkan nama pengguna dipilih sebelumnya untuk login interaktif. Mengatur opsi ini melewati perintah pemilihan akun dan segera mencoba masuk dengan akun yang ditentukan.
loginHint?: string
Nilai Properti
string
redirectUri
Mendapatkan URI pengalihan aplikasi. Ini harus sama dengan nilai di portal pendaftaran aplikasi. Default ke window.location.href
.
Bidang ini tidak lagi diperlukan untuk Node.js.
redirectUri?: string | () => string
Nilai Properti
string | () => string
tenantId
ID penyewa (direktori) Microsoft Entra.
tenantId?: string
Nilai Properti
string
Detail Properti yang Diwariskan
additionallyAllowedTenants
Untuk aplikasi multi-penyewa, menentukan penyewa tambahan yang kredensialnya dapat memperoleh token. Tambahkan nilai kartubebas "*" untuk memungkinkan kredensial memperoleh token untuk penyewa mana pun yang diinstal aplikasi.
additionallyAllowedTenants?: string[]
Nilai Properti
string[]
Diwarisi DariInteractiveCredentialOptions.additionallyAllowedTenants
additionalPolicies
Kebijakan tambahan untuk disertakan dalam alur HTTP.
additionalPolicies?: AdditionalPolicyConfig[]
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.additionalPolicies
allowInsecureConnection
Atur ke true jika permintaan dikirim melalui HTTP alih-alih HTTPS
allowInsecureConnection?: boolean
Nilai Properti
boolean
Diwarisi DariInteractiveCredentialOptions.allowInsecureConnection
authenticationRecord
Hasil autentikasi sebelumnya yang dapat digunakan untuk mengambil kredensial yang di-cache dari setiap akun individu. Ini perlu disediakan jika aplikasi ingin bekerja dengan lebih dari satu akun per ID Klien dan pasangan ID Penyewa.
Catatan ini dapat diambil dengan memanggil metode kredensial authenticate()
, sebagai berikut:
const authenticationRecord = await credential.authenticate();
authenticationRecord?: AuthenticationRecord
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.authenticationRecord
authorityHost
Host otoritas yang digunakan untuk permintaan autentikasi. Nilai yang mungkin tersedia melalui AzureAuthorityHosts. Defaultnya adalah "https://login.microsoftonline.com".
authorityHost?: string
Nilai Properti
string
Diwarisi DariInteractiveCredentialOptions.authorityHost
brokerOptions
Opsi untuk mengizinkan autentikasi broker saat menggunakan InteractiveBrowserCredential
brokerOptions?: BrokerOptions
Nilai Properti
Diwarisi DariBrokerAuthOptions.brokerOptions
browserCustomizationOptions
Opsi konfigurasi bersama untuk kustomisasi browser
browserCustomizationOptions?: { errorMessage?: string, successMessage?: string }
Nilai Properti
{ errorMessage?: string, successMessage?: string }
Diwarisi DariBrowserCustomizationOptions.browserCustomizationOptions
disableAutomaticAuthentication
Membuat getToken melempar jika autentikasi manual diperlukan.
Pengembang harus memanggil untuk authenticate()
mengontrol kapan harus mengautentikasi secara manual.
disableAutomaticAuthentication?: boolean
Nilai Properti
boolean
Diwarisi DariInteractiveCredentialOptions.disableAutomaticAuthentication
disableInstanceDiscovery
Bidang menentukan apakah penemuan instans dilakukan saat mencoba mengautentikasi.
Mengatur ini ke true
akan sepenuhnya menonaktifkan penemuan instans dan validasi otoritas.
Akibatnya, sangat penting untuk memastikan bahwa host otoritas yang dikonfigurasi valid dan dapat dipercaya.
Fungsionalitas ini ditujukan untuk digunakan dalam skenario di mana titik akhir metadata tidak dapat dicapai, seperti di cloud privat atau Azure Stack.
Proses penemuan instans memerlukan pengambilan metadata otoritas dari https://login.microsoft.com/ untuk memvalidasi otoritas.
disableInstanceDiscovery?: boolean
Nilai Properti
boolean
Diwarisi DariInteractiveCredentialOptions.disableInstanceDiscovery
httpClient
HttpClient yang akan digunakan untuk mengirim permintaan HTTP.
httpClient?: HttpClient
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.httpClient
loggingOptions
Memungkinkan pengguna mengonfigurasi pengaturan untuk opsi kebijakan pengelogan, memungkinkan informasi akun pengelogan dan informasi pengidentifikasi pribadi untuk dukungan pelanggan.
loggingOptions?: LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }
Nilai Properti
LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }
Diwarisi DariInteractiveCredentialOptions.loggingOptions
proxyOptions
Opsi untuk mengonfigurasi proksi untuk permintaan keluar.
proxyOptions?: ProxySettings
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.proxyOptions
redirectOptions
Opsi tentang cara respons pengalihan ditangani.
redirectOptions?: RedirectPolicyOptions
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.redirectOptions
retryOptions
Opsi yang mengontrol cara mencoba kembali permintaan yang gagal.
retryOptions?: PipelineRetryOptions
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.retryOptions
telemetryOptions
Opsi untuk mengatur telemetri umum dan melacak info ke permintaan keluar.
telemetryOptions?: TelemetryOptions
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.telemetryOptions
tlsOptions
Opsi untuk mengonfigurasi autentikasi TLS
tlsOptions?: TlsSettings
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.tlsOptions
tokenCachePersistenceOptions
Opsi untuk menyediakan lapisan persistensi (jika tersedia) saat menyimpan kredensial.
Anda harus terlebih dahulu mendaftarkan plugin penyedia persistensi. Lihat paket di @azure/identity-cache-persistence
NPM.
Contoh:
import { cachePersistencePlugin } from "@azure/identity-cache-persistence";
import { useIdentityPlugin, DeviceCodeCredential } from "@azure/identity";
useIdentityPlugin(cachePersistencePlugin);
async function main() {
const credential = new DeviceCodeCredential({
tokenCachePersistenceOptions: {
enabled: true
}
});
}
main().catch((error) => {
console.error("An error occurred:", error);
process.exit(1);
});
tokenCachePersistenceOptions?: TokenCachePersistenceOptions
Nilai Properti
Diwarisi DariCredentialPersistenceOptions.tokenCachePersistenceOptions
userAgentOptions
Opsi untuk menambahkan detail agen pengguna ke permintaan keluar.
userAgentOptions?: UserAgentPolicyOptions
Nilai Properti
Diwarisi DariInteractiveCredentialOptions.userAgentOptions