Che cos'è il formato di file WSP?
.wsp è un SharePoint Solution Package - un file di distribuzione utilizzato per installare funzionalità personalizzate, assembly e modelli negli ambienti Microsoft SharePoint on-premises. Nonostante l'estensione .wsp, il file è un archivio standard Microsoft Cabinet (.cab), identificabile dai magic bytes MSCF (4D 53 43 46) all'offset 0. Rinominare un file .wsp in .cab consente di ispezionarlo in Esplora file di Windows o con 7-Zip.
All'interno dell'archivio, un file manifest.xml funge da descrittore radice, dichiarando l'identità della soluzione, le funzionalità, gli assembly .NET (DLL), i modelli di pagina ASPX/ASCX, JavaScript, CSS e le risorse immagine. La distribuzione viene eseguita tramite PowerShell (Add-SPSolution e poi Install-SPSolution) o l'Amministrazione centrale SharePoint - non aprendo direttamente il file.
Esistono due tipi di soluzioni: le soluzioni farm vengono eseguite con attendibilità totale e hanno accesso illimitato al server; le soluzioni sandbox operavano in un processo limitato e sono deprecate a partire da SharePoint 2013 e non supportate in SharePoint Online. Per SharePoint Online e Microsoft 365, il successore moderno è il formato di pacchetto SharePoint Framework .sppkg.
Visual Studio genera automaticamente i file .wsp durante la compilazione dei progetti SharePoint. La versione dello schema della soluzione dichiarata in manifest.xml è destinata a SharePoint 2007 fino a SharePoint Subscription Edition. Gli assembly .NET all'interno del pacchetto portano firme Strong Name per la verifica dell'integrità.
Sicurezza e incolumità
RISCHIO: MEDIUMUn file WSP (soluzione farm) è un pacchetto ad attendibilità totale che distribuisce assembly .NET compilati su un server SharePoint. Un file .wsp dannoso potrebbe contenere codice eseguito con l'identità del pool di applicazioni (spesso un account di servizio di dominio). Non distribuire mai un WSP da una fonte non attendibile senza aver prima esaminato il file manifest.xml e il contenuto delle DLL (usare 7-Zip per l'ispezione, quindi controllare gli assembly con un decompiler come ILSpy). Le soluzioni sandbox presentano un rischio minore grazie al processo isolato, ma sono deprecate. SharePoint Online non accetta file WSP - solo .sppkg verificati tramite il catalogo delle app.
Dettagli del formato
in sintesi- Microsoft Visual C++ Workspace Info File - Le versioni molto vecchie di Visual C++ (precedenti agli anni 2000) utilizzavano .wsp per i file di stato dell'area di lavoro; effettivamente obsoleti e raramente riscontrati.
- File WordPerfect Macro/Workspace - Le versioni precedenti di WordPerfect utilizzavano .wsp per l'archiviazione di aree di lavoro o macro; solo per sistemi legacy.
Programmi che aprono file WSP
Dettagli tecnici
specifiche approfondite| Formato contenitore | Microsoft Cabinet (CAB) - magic bytes 4D 53 43 46 (MSCF) all'offset 0 |
| Ordine dei byte | Little-endian (standard del formato CAB) |
| Compressione | MS-ZIP (basata su DEFLATE) o LZX per ogni voce di file all'interno del CAB |
| Descrittore radice | manifest.xml - file XML che dichiara l'ID della soluzione, le funzionalità, i percorsi degli assembly .NET e le mappature dei file |
| Integrità degli assembly | Le DLL .NET portano la firma Strong Name (token a chiave pubblica) per la verifica dell'integrità |
| Tipi di soluzione | Soluzione farm (attendibilità totale, accesso completo al server) vs. soluzione sandbox (processo limitato, deprecata in SharePoint 2019 e non supportata in SharePoint Online) |
| Comandi di distribuzione | Add-SPSolution (registra nella farm) e Install-SPSolution (attiva la distribuzione), tramite SharePoint Management Shell |
| Versione dello schema della soluzione | Dichiarata in manifest.xml; destinata a SharePoint 2007, 2010, 2013, 2016, 2019 o Subscription Edition |
| Contenuti tipici | manifest.xml, DLL .NET, file di definizione XML delle funzionalità, modelli ASPX/ASCX, risorse JS/CSS/immagine |
| Dimensione tipica del file | 10 KB - 500 MB (da una piccola funzionalità a una grande soluzione farm aziendale) |
| Strumento di sviluppo | Il tipo di progetto SharePoint di Microsoft Visual Studio genera file .wsp tramite il suo sistema di pacchetti |
| Successore moderno | .sppkg (pacchetto SharePoint Framework) per SharePoint Online e Microsoft 365 |
| Tipo MIME | application/octet-stream (nessun tipo MIME registrato; il contenuto CAB è talvolta identificato come application/x-cab) |
| Rilasciato | Windows SharePoint Services 3.0 / SharePoint 2007 |
| Ultima versione | SharePoint Server Subscription Edition (2024) / SharePoint Online |
| Specifica | learn.microsoft.com |
Conversioni WSP
Domande e risposte della community
chiesto dagli utentiAncora nessuna domanda - sii il primo a chiedere informazioni sui file WSP.