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

  • Artikel

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

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:

  1. Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.
  2. 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.
  3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi dan pilih Pendaftaran baru.
  4. Masukkan Nama untuk aplikasi Anda, contohnya msal-node-desktop. Pengguna aplikasi mungkin melihat nama ini, dan Anda dapat mengubahnya nanti.
  5. Pilih Daftar untuk membuat aplikasi.
  6. Di bagian Kelola, pilih Autentikasi.
  7. Pilih Tambahkan platform>Aplikasi seluler dan desktop.
  8. Di bagian URI Pengalihan, masukkan http://localhost.
  9. 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

  1. Anda harus menginstal dependensi sampel ini sekali:

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

  2. Kemudian, jalankan aplikasi melalui prompt perintah atau konsol:

    npm start

  3. 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