Využití CDN pro prohlížeč MSAL

Vedle npm lze msal načítat i z CDN hostovaných společností Microsoft.

POZNÁMKA: Počínaje MSAL.js v3 msal-browser už není hostovaný v síti CDN. Pokud využíváte msal-browser cdN, budete si muset stáhnout msal-browser z npm a před upgradem zvolit jednu z následujících alternativ:

1. Využívání sestavení ESM (upřednostňované)
2. Extrahujte lib/msal-browser.js nebo lib/msal-browser.min.js ze staženého balíčku a poskytujte jej jako statický asset ve své aplikaci nebo jej hostujte na vlastní síti CDN.

Osvědčené postupy

• Použijte nejnovější verzi MSAL.js v2.
• Použijte minifikované sestavení v produkci, sestavení bez minimalizace pro vývoj.
• Místo sítí CDN třetích stran použijte Microsoft CDN.
• Použijte oblast CDN nejbližší vašim uživatelům.
• Použijte atributy async nebo defer, aby se neblokovalo vykreslování stránky.
• integrity Tento atribut použijte k zajištění integrity sestavení CDN.
• Podpora pro IE11 vyžaduje polyfill pro Promise (další informace o podpoře IE11).

Základní použití

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

Neminifikované buildy

Kromě minifikovaných buildů jsou k dispozici i neminifikované buildy pro každou verzi (místo msal-browser.jsmsal-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>

Alternativní oblast

Microsoft nabízí buildy CDN hostované ve dvou různých oblastech, USA – západ a Evropa – sever.

Záložní CDN

V nepravděpodobném případě, že je sestavení CDN přerušené nebo je samotné CDN nedostupné, může aplikace jako záložní oblast použít jinou oblast CDN:

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

Poznámka: Tato metoda použití document.write může být v některých prohlížečích v určitých situacích blokovaná. Další informace najdete tady.

Integrita podsourců

Z dokumentace MDN:

Subresource Integrity (SRI) je bezpečnostní funkce, která umožňuje prohlížečům ověřit, že zdroje, které načítají (například z CDN), jsou doručeny bez neočekávané manipulace. Funguje to tak, že vám umožňuje poskytnout kryptografický haš, kterému musí načtený prostředek odpovídat.

Použití sítí pro doručování obsahu (CDN) k hostování souborů, jako jsou skripty a šablony stylů sdílené mezi více lokalitami, může zlepšit výkon webu a ušetřit šířku pásma. Použití sítí CDN ale přináší také riziko, že pokud útočník získá kontrolu nad sítí CDN, může útočník do souborů CDN vložit libovolný škodlivý obsah (nebo je zcela nahradit) a může také potenciálně napadnout všechny weby, které načítají soubory z této sítě CDN.

Subresource Integrity vám umožňuje zmírnit některá rizika útoků, jako jsou tyto, tím, že zajišťuje, aby soubory, které vaše webová aplikace nebo webový dokument načítá (z CDN nebo odkudkoli), byly doručeny bez toho, aby do nich třetí strana vložila jakýkoli další obsah — a aby v nich zároveň nebyly provedeny vůbec žádné jiné změny.

Důrazně doporučujeme používat hash hodnoty SRI u CDN buildů knihovny MSAL.js, abyste pomohli zabezpečit svou aplikaci i ověřovací artefakty (např. přístupové tokeny), které MSAL.js ukládá do prohlížeče.

Příklad hashe SRI pro 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>

Poznámky k hashům SRI

• Každá hodnota hash bude jedinečná pro verzi MSAL.js v2 a nezmění se.
• Použití otisku SRI je u CDN buildů MSAL.js volitelné.
• Pokud se atribut integrity používá pro CDN buildy MSAL.js v2, atribut crossorigin musí být nastaven na "anonymous".
• Pokud se domníváte, že naše buildy CDN byly ohroženy, neprodleně nás informujte .

Historie hashů SRI