Penggunaan CDN untuk Browser MSAL

Selain npm, msal dapat dikonsumsi dari CDN yang dihosting Microsoft.

CATATAN: Mulai dari MSAL.js v3 msal-browser tidak lagi dihosting di CDN. Jika Anda mengonsumsi msal-browser dari CDN, Anda harus mengunduh msal-browser dari npm dan memilih salah satu alternatif berikut sebelum memutakhirkan:

1. Gunakan build ESM (lebih disukai)
2. Ekstrak lib/msal-browser.js atau lib/msal-browser.min.js dari paket yang diunduh dan layani sebagai aset statis dengan aplikasi Anda atau host di CDN Anda sendiri

Praktik Terbaik

• Gunakan versi terbaru MSAL.js v2.
• Gunakan build yang diminifikasi untuk produksi, build tanpa minifikasi untuk pengembangan.
• Gunakan CDN Microsoft alih-alih CDN pihak ketiga.
• Gunakan wilayah CDN terdekat dengan pengguna Anda.
• async Gunakan atribut atau defer untuk tidak memblokir penyajian halaman.
• integrity Gunakan atribut untuk memastikan integritas build CDN.
• Dukungan IE11 memerlukan Promise polyfill (informasi selengkapnya tentang dukungan IE11).

Penggunaan Dasar

<script type="text/javascript" src="https://alcdn.msauth.net/browser/2.35.0/js/msal-browser.min.js"></script>

Build yang belum diminifikasi

Selain build yang diminifikasi, build yang tidak diminifikasi untuk setiap versi juga tersedia (dengan nama msal-browser.js alih-alih msal-browser.min.js)

<!-- Replace <version> with desired version, e.g. 2.3.0 -->
<script type="text/javascript" src="https://alcdn.msauth.net/browser/<version>/js/msal-browser.js"></script>

Wilayah alternatif

Microsoft menawarkan build CDN yang dihosting di dua wilayah berbeda, AS Barat dan Eropa Utara.

Penggantian Sementara CDN

Dalam kejadian yang kecil kemungkinannya, jika build CDN mengalami kerusakan atau CDN itu sendiri tidak dapat diakses, aplikasi dapat menggunakan wilayah CDN lain sebagai cadangan:

<script type="text/javascript" src="https://alcdn.msauth.net/browser/2.3.0/js/msal-browser.min.js"></script>
<script type="text/javascript">
    if(typeof msal === 'undefined')document.write(unescape("%3Cscript src='https://alcdn.msftauth.net/browser/2.3.0/js/msal-browser.min.js' type='text/javascript' %3E%3C/script%3E"));
</script>

Catatan: Metode penggunaan document.write ini dapat diblokir di browser tertentu dalam situasi tertentu. Informasi selengkapnya dapat ditemukan di sini.

Subresource Integrity

Dari MDN:

Subresource Integrity (SRI) adalah fitur keamanan yang memungkinkan browser memverifikasi bahwa sumber daya yang mereka ambil (misalnya, dari CDN) dikirimkan tanpa manipulasi yang tidak terduga. Ini berfungsi dengan memungkinkan Anda untuk memberikan hash kriptografi yang harus cocok dengan sumber daya yang diambil.

Menggunakan Content Delivery Networks (CDN) untuk menghosting file seperti skrip dan lembar gaya yang dibagikan di antara beberapa situs dapat meningkatkan performa situs dan menghemat bandwidth. Namun, menggunakan CDN juga dilengkapi dengan risiko, dalam hal itu jika penyerang mendapatkan kontrol atas CDN, penyerang dapat menyuntikkan konten berbahaya sewenang-wenang ke dalam file di CDN (atau mengganti file sepenuhnya) dan dengan demikian juga berpotensi menyerang semua situs yang mengambil file dari CDN tersebut.

Integritas Subresource memungkinkan Anda untuk mengurangi beberapa risiko serangan seperti ini, dengan memastikan bahwa file yang diambil aplikasi web atau dokumen web Anda (dari CDN atau di mana saja) telah dikirimkan tanpa pihak ketiga yang telah menyuntikkan konten tambahan apa pun ke dalam file-file tersebut — dan tanpa perubahan lain dari semua jenis file tersebut.

Sangat disarankan untuk menggunakan hash SRI dengan build CDN untuk MSAL.js guna membantu mengamankan aplikasi Anda dan artefak autentikasi (misalnya token akses) yang disimpan MSAL.js di browser.

Contoh Hash SRI MSAL.js

<script
    type="text/javascript"
    src="https://alcdn.msauth.net/browser/2.3.0/js/msal-browser.min.js"
    integrity="sha384-o+Sncs5XJ3NEAeriM/FV8YGZrh7mZk4GfNutRTbYjsDNJxb7caCLeqiDabistgwW"
    crossorigin="anonymous"></script>

Catatan Hash SRI

• Setiap hash akan unik untuk versi MSAL.js v2, dan tidak akan berubah.
• Penggunaan hash SRI bersifat opsional untuk build CDN MSAL.js.
• Jika atribut integrity digunakan untuk build CDN MSAL.js v2, atribut crossorigin harus diatur ke "anonymous".
• Jika Anda yakin build CDN kami telah disusupi, harap segera informasikan kepada kami .

Riwayat Hash SRI