winjs-plugin-security
WinJS projeleri için güvenlik artırma işlevleri sağlayan, özellikle SRI (Subresource Integrity) özniteliği üretmek için kullanılan bir eklenti.
Özellikler
- HTML dosyalarındaki
veetiketlerine otomatik olarak SRI özniteliği ekler - SHA-256, SHA-384, SHA-512 karma algoritmalarını destekler (yapılandırılabilir)
- SRI'nin düzgün çalışmasını sağlamak için otomatik olarak
crossorigin="anonymous"özniteliği ekler - Sadece üretim ortamında etkilidir, geliştirme ortamında otomatik olarak atlanır
Kurulum
pnpm add @winner-fed/plugin-security
Kullanım Yöntemi
.winrc.ts yapılandırma dosyanıza eklenti yapılandırmasını ekleyin:
import { defineConfig } from '@winner-fed/winjs';export default defineConfig({
plugins: ['@winner-fed/plugin-security'],
security: {
sri: true // 启用 SRI 功能
},
});
Yapılandırma Seçenekleri
sri
- Tür:
boolean | { algorithm: 'sha256' | 'sha384' | 'sha512' } - Varsayılan Değer: Elle ayarlanması gerekir
- Açıklama: SRI (Alt Kaynak Bütünlüğü) özelliğinin etkinleştirilip etkinleştirilmeyeceği ve isteğe bağlı olarak kullanılacak karma algoritması yapılandırması
true veya {} olarak ayarlandığında, eklenti:- Oluşturulan HTML dosyalarını tarar
srcniteliğine sahip tümetiketlerineintegrityniteliği eklerhrefniteliğine sahip tümetiketlerineintegrityniteliği ekler- Otomatik olarak
crossorigin="anonymous"niteliği ekler (eğer yoksa)
security: {
sri: {
algorithm: 'sha512' // 可选 'sha256' | 'sha384' | 'sha512',默认 'sha512'
}
}示例
输入 HTML
HTML çıktısı (SRI etkinleştirildikten sonra)
Güvenlik Açıklaması
SRI (Alt Kaynak Bütünlüğü), tarayıcıların alınan bir kaynağın (örneğin CDN'den alınan bir kaynağın) kötü niyetli olarak değiştirilmediğini doğrulamasını sağlayan bir güvenlik özelliğidir. Tarayıcı, kaynağı yüklerken, kaynağın bir hash değerini hesaplar ve bu değeri integrity özniteliğinde belirtilen hash değeriyle karşılaştırır. Eğer hash değerleri eşleşmezse, tarayıcı o kaynağı yüklemeyi reddeder.
etiketi için, sonuç olarak içindeki kodun çalıştırılması reddedilir; CSS bağlantıları için ise, sonuç olarak içindeki stiller yüklenmez.
SRI hakkında daha fazla bilgi için Alt Kaynak Bütünlüğü - MDN adresine bakabilirsiniz.
Dikkat Edilmesi Gerekenler
- Bu eklenti yalnızca üretim yapısında etkilidir, geliştirme ortamında otomatik olarak atlanır
- Kaynak dosyaların yapı çıktı dizininde erişilebilir olduğundan emin olunmalıdır
integrityözniteliğinin düzgün çalışması içincrossoriginözniteliği ile birlikte kullanılması gerekmektedir
Lisans
MIT
--- Tranlated By Open Ai Tx | Last indexed: 2025-08-06 ---