Mulai cepat: Memasukkan pengguna dan memanggil Microsoft Graph dari aplikasi desktop Node.js - Microsoft identity platform

Artikel
04/12/2024

Di mulai cepat ini, Anda mengunduh dan menjalankan sampel kode yang menunjukkan bagaimana aplikasi desktop Electron dapat memasukkan pengguna dan memperoleh token akses untuk memanggil Microsoft Graph API.

Mulai cepat ini menggunakan Microsoft Authentication Library for Node.js (MSAL Node) dengan alur kode otorisasi dengan PKCE.

Prasyarat

Node.js
Visual Studio Code atau editor kode lainnya

Mendaftar dan mengunduh aplikasi sampel

Ikuti langkah-langkah di bawah ini untuk memulai.

Langkah 1: Daftarkan aplikasi

Tip

Langkah-langkah dalam artikel ini mungkin sedikit berbeda berdasarkan portal tempat Anda memulai.

Untuk mendaftarkan aplikasi Anda dan menambahkan informasi pendaftaran aplikasi ke solusi Anda secara manual, ikuti langkah-langkah ini:

Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.
Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa tempat Anda ingin mendaftarkan aplikasi dari menu Direktori + langganan.
Telusuri Aplikasi >Identitas>Pendaftaran aplikasi dan pilih Pendaftaran baru.
Masukkan Nama untuk aplikasi Anda, contohnya msal-node-desktop. Pengguna aplikasi mungkin melihat nama ini, dan Anda dapat mengubahnya nanti.
Pilih Daftar untuk membuat aplikasi.
Di bagian Kelola, pilih Autentikasi.
Pilih Tambahkan platform>Aplikasi seluler dan desktop.
Di bagian URI Pengalihan, masukkan http://localhost.
Pilih Konfigurasikan.

Langkah 2: Unduh proyek sampel Electron

Unduh sampel kode

Langkah 3: Konfigurasikan proyek sampel Electron

*Ekstrak proyek, buka folder ms-identity-JavaScript-nodejs-desktop-main, kemudian buka file .authConfig.js. Ganti nilai sebagai berikut:

Variabel	Deskripsi	Misalnya
`Enter_the_Cloud_Instance_Id_Here`	Instans cloud Azure tempat aplikasi Anda terdaftar	`https://login.microsoftonline.com/` (termasuk garis miring berikutnya)
`Enter_the_Tenant_Id_Here`	ID Penyewa atau Domain primer	`contoso.microsoft.com` atau `aaaabbbb-0000-cccc-1111-dddd2222eeee`
`Enter_the_Application_Id_Here`	ID Klien dari aplikasi yang Anda daftarkan	`00001111-aaaa-2222-bbbb-3333cccc4444`
`Enter_the_Redirect_Uri_Here`	Uri pengalihan dari aplikasi yang Anda daftarkan	`msal00001111-aaaa-2222-bbbb-3333cccc4444://auth`
`Enter_the_Graph_Endpoint_Here`	Instans cloud Microsoft Graph API yang akan dipanggil oleh aplikasi Anda	`https://graph.microsoft.com/` (termasuk garis miring berikutnya)

File Anda akan terlihat seperti di bawah ini:

const AAD_ENDPOINT_HOST = "https://login.microsoftonline.com/"; // include the trailing slash

const msalConfig = {
    auth: {
        clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
        authority: `${AAD_ENDPOINT_HOST}/aaaabbbb-0000-cccc-1111-dddd2222eeee`,
    },
    system: {
        loggerOptions: {
            loggerCallback(loglevel, message, containsPii) {
                 console.log(message);
             },
             piiLoggingEnabled: false,
             logLevel: LogLevel.Verbose,
        }
    }
}

const GRAPH_ENDPOINT_HOST = "https://graph.microsoft.com/"; // include the trailing slash

const protectedResources = {
     graphMe: {
         endpoint: `${GRAPH_ENDPOINT_HOST}v1.0/me`,
         scopes: ["User.Read"],
     }
};

module.exports = {
     msalConfig: msalConfig,
     protectedResources: protectedResources,
 };

Langkah 4: Jalankan aplikasi

Anda harus menginstal dependensi sampel ini sekali:

cd ms-identity-javascript-nodejs-desktop-main
npm install

Kemudian, jalankan aplikasi melalui prompt perintah atau konsol:
```
npm start
```
Pilih Masuk untuk memulai proses masuk.

Saat pertama kali masuk, Anda akan diminta untuk memberikan persetujuan untuk mengizinkan aplikasi memasukkan Anda dan mengakses profil Anda. Setelah berhasil masuk, Anda akan dialihkan kembali ke aplikasi.

Informasi selengkapnya

Cara kerja sampel

Saat pengguna memilih tombol Masuk untuk pertama kalinya, acquireTokenInteractive metode MSAL Node dipanggil. Metode ini mengalihkan pengguna untuk masuk dengan titik akhir platform identitas Microsoft, mendapatkan kode otorisasi, lalu menukarnya dengan token akses.

Simpul MSAL

MSAL Node adalah lpustaka yang digunakan untuk memasukkan pengguna dan meminta token yang digunakan untuk mengakses API yang dilindungi oleh platform identitas Microsoft. Untuk informasi selengkapnya tentang cara menggunakan MSAL Node dengan aplikasi desktop, lihat artikel ini.

Anda dapat menginstal Node MSAL dengan menjalankan perintah npm berikut.

npm install @azure/msal-node --save

Langkah berikutnya

Untuk mempelajari selengkapnya tentang pengembangan aplikasi desktop Electron dengan MSAL Node, lihat tutorial:

Tutorial: Memasukkan pengguna dan memanggil Microsoft Graph API di aplikasi desktop Electron

Bagikan melalui