InteractiveBrowserCredential class
Memungkinkan autentikasi untuk Microsoft Entra ID di dalam browser web menggunakan alur masuk interaktif.
Konstruktor
| Interactive |
Membuat instans InteractiveBrowserCredential dengan detail yang diperlukan. Kredensial ini menggunakan Alur Kode Otorisasi.
Pada Node.js, itu akan membuka jendela browser saat mendengarkan respons pengalihan dari layanan autentikasi.
Pada browser, ini mengautentikasi melalui popup. Parameter Untuk Node.js, jika |
Metode
| authenticate(string | string[], Get |
Mengautentikasi dengan Microsoft Entra ID dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan. Jika token tidak dapat diambil secara diam-diam, metode ini akan mengharuskan interaksi pengguna untuk mengambil token. Pada Node.js, kredensial ini memiliki Proof Key for Code Exchange (PKCE) yang diaktifkan secara default. PKCE adalah fitur keamanan yang mengurangi serangan penyadapan kode autentikasi. |
| get |
Mengautentikasi dengan Microsoft Entra ID dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan. Jika pengguna memberikan opsi |
Detail Konstruktor
InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)
Membuat instans InteractiveBrowserCredential dengan detail yang diperlukan.
Kredensial ini menggunakan Alur Kode Otorisasi.
Pada Node.js, itu akan membuka jendela browser saat mendengarkan respons pengalihan dari layanan autentikasi.
Pada browser, ini mengautentikasi melalui popup. Parameter loginStyle opsional dapat diatur ke redirect untuk mengautentikasi dengan mengalihkan pengguna ke halaman masuk aman Azure, yang kemudian akan mengalihkan pengguna kembali ke aplikasi web tempat autentikasi dimulai.
Untuk Node.js, jika clientId disediakan, aplikasi Microsoft Entra perlu dikonfigurasi untuk memiliki titik akhir pengalihan "Aplikasi seluler dan desktop".
Ikuti panduan kami tentang menyiapkan URI Pengalihan untuk aplikasi Desktop yang memanggil API web.
new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)Parameter
Opsi untuk mengonfigurasi klien yang membuat permintaan autentikasi.
Detail Metode
authenticate(string | string[], GetTokenOptions)
Mengautentikasi dengan Microsoft Entra ID dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan.
Jika token tidak dapat diambil secara diam-diam, metode ini akan mengharuskan interaksi pengguna untuk mengambil token.
Pada Node.js, kredensial ini memiliki Proof Key for Code Exchange (PKCE) yang diaktifkan secara default. PKCE adalah fitur keamanan yang mengurangi serangan penyadapan kode autentikasi.
function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>Parameter
- scopes
-
string | string[]
Daftar cakupan yang tokennya akan memiliki akses.
- options
- GetTokenOptions
Opsi yang digunakan untuk mengonfigurasi permintaan apa pun yang mungkin dibuat oleh implementasi TokenCredential ini.
Mengembalikan
Promise<undefined | AuthenticationRecord>
getToken(string | string[], GetTokenOptions)
Mengautentikasi dengan Microsoft Entra ID dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan.
Jika pengguna memberikan opsi disableAutomaticAuthentication, setelah token tidak dapat diambil secara diam-diam, metode ini tidak akan mencoba meminta interaksi pengguna untuk mengambil token.
function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>Parameter
- scopes
-
string | string[]
Daftar cakupan yang tokennya akan memiliki akses.
- options
- GetTokenOptions
Opsi yang digunakan untuk mengonfigurasi permintaan apa pun yang mungkin dibuat oleh implementasi TokenCredential ini.
Mengembalikan
Promise<AccessToken>