Egyéni parancsfájlok beágyazása

Külső parancsfájl-erőforrások hozzáadása

Először be kell ágyaznunk a külső parancsfájl helyét a megfelelő beállításban:

1. Menjen a Rendszerbeállítások képernyőre.

2. Keressen rá az ExternalFrontend::ExternalScripts beállításra.

3. Kattintson rá a beállításra a szerkesztéséhez.

4. Abban az esetben, ha egy érték már szerepel ott, kattintson a plusz gombra. Egyébként folytassa a továbbiakkal.

5. Adja meg a külső erőforrás teljes helyét a szövegmezőben. Például: https://www.example.com/track/js?id=UA-XXXXXX-Y.

6. Kattintson a pipa jelre a módosított beállítások elmentéséhez.

7. Állítsa üzembe a módosított rendszerbeállítást.

Sorközi kódrészletek hozzáadása

Ezután be kell ágyaznunk az eredeti kódrészlet sorközi részét is:

1. Menjen a Rendszerbeállítások képernyőre.

2. Keressen rá az ExternalFrontend::InlineScripts beállításra.

3. Kattintson rá a beállításra a szerkesztéséhez.

4. Abban az esetben, ha egy érték már szerepel ott, kattintson a plusz gombra. Egyébként folytassa a továbbiakkal.

5. Adja meg a teljes kódrészletet a szövegterületen a script címkék nélkül. Például:

   window.dataLayer = window.dataLayer || [];
   function track(){dataLayer.push(arguments);}
   track('js', new Date());
   
   track('config', 'UA-XXXXXX-Y');
   

6. Kattintson a pipa jelre a módosított beállítások elmentéséhez.

7. Állítsa üzembe a módosított rendszerbeállítást.

Az alkalmazás újraépítése

A változtatások alkalmazása érdekében az alkalmazást is újra kell építenünk. Váltson át a parancsértelmezőre, és hajtsa végre a következő parancsot:

bin/otrs.WebServer.pl --deploy-assets

További források fehér listára tétele a biztonsági fejlécekben

Ha most megpróbálja elérni a külső felület alkalmazást, akkor képes lesz leellenőrizni, hogy a parancsfájlok szerepelnek-e a kódban. Azonban a böngésző valószínűleg blokkolja az összes sorközi és külső erőforrás hozzáférését, ezért a kód sikertelen lehet néhány hibával.

Ez a viselkedés tervezési okok miatt van, mivel a külső erőforrások csak akkor tölthetők be, ha azok kifejezetten fehér listán vannak a Content Security Policy fejléceiben.

A blokkolt kód ellenőrzéséhez használjon megfelelő webböngésző ellenőrző eszközöket. A példánkban a Mozilla Firefoxot és annak webkonzolját fogjuk használni, amely az Eszközök → Webfejlesztő → Webkonzol menüpontban vagy az F12 gyorsbillentyűn keresztül érhető el.

A példában lévő kódrészletnél a következő hibákat kaphatja a konzolban, ha az alkalmazást eléri:

A konzolhibákból láthatjuk, hogy a külső parancsfájl-erőforrás betöltését megakadályozták (1. és 3. sor). Emellett két kiértékelési hívást is blokkoltak (2. és 5. sor). Minden hiba egy Content Security Policy szabályra hivatkozik a script-src neve alatt, amely a parancsfájl-erőforrásokat jelzi.

Mind a külső erőforrást, mind a kiértékelési hívásokat hozzá kell adnunk a Content Security Policy fejléceinek további forráslistájához:

1. Menjen a Rendszerbeállítások képernyőre.

2. Keressen rá a WebApp::Server::AdditionalOrigins beállításra.

3. Kattintson rá a beállításra a szerkesztéséhez.

4. Abban az esetben, ha egy script-src érték már szerepel ott, kattintson a mellette lévő plusz gombra. Egyébként folytassa a továbbiakkal.

5. Adja meg a blokkolt erőforrásnak csak a tartomány részét a szövegmezőben. Például: https://www.example.com. Ez lehetővé teszi a külső erőforrás betöltését.

6. Kattintson a mező mellett lévő plusz gombra, így egy másik érték lesz hozzáadva.

7. Adja meg a következő irányelvet az új mezőben, beleértve az idézést is: 'unsafe-eval'. Ez lehetővé teszi a kiértékelési hívások végrehajtását.

8. Kattintson a pipa jelre a módosított beállítások elmentéséhez.

9. Állítsa üzembe a módosított rendszerbeállítást.

Ezen a ponton nincs szükség a külső felület alkalmazás újraépítésére, mivel a további források beállításának azonnal érvényesülnie kell.

Ha újratölti a külső felület alkalmazást, akkor további hibákat is kaphat. A példánkban ez a következő lehet:

Ez a hiba azt jelzi, hogy egy további erőforrás szintén blokkolva volt, amely egy kép egy adott helyen (1. sor). Erre az img-src Content Security Policy szabály nevéből következtethetünk, amely egy képerőforrásra hivatkozik. Annak érdekében, hogy hozzáadja ezt a fehér listához, próbálja meg a következőt:

1. Menjen a Rendszerbeállítások képernyőre.

2. Keressen rá a WebApp::Server::AdditionalOrigins beállításra.

3. Kattintson rá a beállításra a szerkesztéséhez.

4. Abban az esetben, ha egy img-src érték már szerepel ott, kattintson a mellette lévő plusz gombra. Egyébként folytassa a továbbiakkal.

5. Adja meg a blokkolt erőforrásnak csak a tartomány részét a szövegmezőben. Például: https://www.example.com. Ez lehetővé teszi a külső képerőforrás betöltését.

6. Kattintson a pipa jelre a módosított beállítások elmentéséhez.

7. Állítsa üzembe a módosított rendszerbeállítást.

Próbálja meg újratölteni a külső felület alkalmazást, és ellenőrizze, hogy van-e további hiba. Ha nincs, akkor a parancsfájlok valószínűleg most már az elvárt módon működnek.

Sajnos nincs lehetőség előre megmondani, hogy milyen erőforrásokra lehet szükségük a parancsfájloknak. De nem kell aggódnia, a legtöbbjüket fehér listára teheti, csak győződj meg arról, hogy pontosan követi-e a böngésző konzolnaplójában megjelenő tanácsokat. Keressen egy megfelelő fejlécszabályt a beállításban, és ennek megfelelően frissítse.