CDN-användning för MSAL Browser

Förutom npm kan msal hämtas från Microsoft-värdbaserade CDN:er.

OBSERVERA: Från och med MSAL.js v3 msal-browser inte längre finns på CDN. Om du använder msal-browser från CDN måste du ladda ned msal-browser från npm och välja något av följande alternativ innan du uppgraderar:

1. Använd ESM-versionen (rekommenderas)
2. Extrahera lib/msal-browser.js eller lib/msal-browser.min.js från det nedladdade paketet och hantera det som en statisk tillgång med din app eller värd för det på din egen CDN

Metodtips

• Använd den senaste versionen av MSAL.js v2.
• Använd den minifierade versionen i produktion, oförminserad version för utveckling.
• Använd Microsoft CDN i stället för CDN från tredje part.
• Använd DEN CDN-region som är närmast dina användare.
• Använd attributen async eller defer för att inte blockera sidåtergivning.
• Använd attributet integrity för att säkerställa integriteten för CDN-versioner.
• IE11-stöd kräver en Promise-polyfill (mer information om IE11-stöd).

Grundläggande användning

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

Oförminserade versioner

Förutom minifierade versioner är även oförminserade versioner för varje version tillgängliga (som msal-browser.js i stället för 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>

Alternativ region

Microsoft erbjuder CDN-versioner i två olika regioner, USA, västra och Europa, norra.

Reservlösning för CDN

I det osannolika fallet att ett CDN-bygge är trasigt eller att CDN:n själv är otillgänglig kan en applikation använda den andra CDN-regionen som reservlösning:

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

Observera: Den här metoden att använda document.write kan blockeras i vissa webbläsare i vissa situationer. Mer information finns här.

Underresursintegritet

Från MDN:

Subresource Integrity (SRI) är en säkerhetsfunktion som gör det möjligt för webbläsare att verifiera att resurser som de hämtar (till exempel från ett CDN) levereras utan oväntad manipulation. Det fungerar genom att du kan ange en kryptografisk hash som en hämtad resurs måste matcha.

Om du använder nätverk för innehållsleverans (CDN) som värd för filer som skript och formatmallar som delas mellan flera platser kan du förbättra webbplatsens prestanda och spara bandbredd. Men att använda CDN medför också en risk, eftersom om en angripare får kontroll över ett CDN kan angriparen mata in godtyckligt skadligt innehåll i filer på CDN (eller ersätta filerna helt) och därmed också potentiellt attackera alla webbplatser som hämtar filer från denna CDN.

Med subresource Integrity kan du minimera vissa risker för attacker som detta, genom att se till att filerna som ditt webbprogram eller webbdokument hämtar (från en CDN eller var som helst) har levererats utan att en tredje part har matat in ytterligare innehåll i dessa filer – och utan att några andra ändringar av något slag har gjorts i dessa filer.

Vi rekommenderar starkt att du använder SRI Hashes med CDN-versioner av MSAL.js för att skydda ditt program och de autentiseringsartefakter (t.ex. åtkomsttoken) som MSAL.js lagras i webbläsaren.

MSAL.js SRI Hash-exempel

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

SRI Hash-anteckningar

• Varje hash kommer att vara unik för versionen av MSAL.js v2 och ändras inte.
• SRI-hashanvändning är valfritt för MSAL.js CDN-versioner.
• Om attributet integrity används för MSAL.js v2 CDN-byggen, måste attributet crossorigin ställas in på "anonymous".
• Om du tror att våra CDN-versioner har komprometterats bör du informera oss omedelbart.

SRI Hash-historia