WSP ファイル形式とは?
.wsp は SharePoint ソリューション パッケージであり、Microsoft SharePoint のオンプレミス環境にカスタム機能、アセンブリ、テンプレートをインストールするために使用される展開ファイルです。.wsp 拡張子ですが、ファイルの実体は標準的な Microsoft Cabinet (.cab) アーカイブであり、オフセット 0 にあるマジックバイト MSCF (4D 53 43 46) によって識別できます。.wsp を .cab にリネームすることで、Windows エクスプローラーや 7-Zip で内容を検査できます。
アーカイブ内では、manifest.xml ファイルがルート記述子として機能し、ソリューションの識別子、機能(フィーチャー)、.NET アセンブリ(DLL)、ASPX/ASCX ページテンプレート、JavaScript、CSS、および画像リソースを宣言します。展開は PowerShell (Add-SPSolution の後に Install-SPSolution) または SharePoint 中央管理を介して実行され、ファイルを直接開いて行うものではありません。
ソリューションには 2 つのタイプがあります。ファーム ソリューションは完全な信頼で実行され、サーバーへの無制限のアクセス権を持ちます。サンドボックス ソリューションは制限されたプロセスで動作していましたが、SharePoint 2013 以降は非推奨となり、SharePoint Online ではサポートされていません。SharePoint Online および Microsoft 365 の場合、現代の後継形式は .sppkg (SharePoint Framework パッケージ) 形式です。
Visual Studio は、SharePoint プロジェクトをビルドするときに .wsp ファイルを自動的に生成します。manifest.xml で宣言されるソリューション スキーマ バージョンは、SharePoint 2007 から SharePoint Subscription Edition までを対象としています。パッケージ内の .NET アセンブリには、整合性検証のための「厳密な名前 (Strong Name)」署名が付与されています。
セキュリティと安全性
リスク: MEDIUMWSP(ファーム ソリューション)は、コンパイル済みの .NET アセンブリを SharePoint サーバーに展開する完全信頼パッケージです。悪意のある .wsp には、アプリケーション プールの ID(多くの場合ドメイン サービス アカウント)として実行されるコードが含まれている可能性があります。信頼できないソースからの WSP は、manifest.xml と DLL の内容を確認(まず 7-Zip で検査し、次に ILSpy などのデコンパイラでアセンブリを確認)せずに展開しないでください。サンドボックス ソリューションはプロセスが隔離されているためリスクは低いですが、現在は非推奨です。SharePoint Online は WSP ファイルを受け入れず、アプリ カタログを介した審査済みの .sppkg のみを受け入れます。
形式の詳細
概要- Microsoft Visual C++ ワークスペース情報ファイル - 2000年代以前の非常に古い Visual C++ バージョンでワークスペースの状態ファイルに .wsp が使用されていました。現在は事実上廃止されており、遭遇することは稀です。
- WordPerfect マクロ/ワークスペース ファイル - 古いバージョンの WordPerfect でワークスペースやマクロの保存に使用されていました。レガシーのみです。
WSP ファイルを開くプログラム
技術的詳細
詳細仕様| コンテナ形式 | Microsoft Cabinet (CAB) - オフセット 0 にマジックバイト 4D 53 43 46 (MSCF) |
| バイト順序 | リトルエンディアン (CAB 形式標準) |
| 圧縮 | CAB 内の各ファイルエントリごとに MS-ZIP (DEFLATE ベース) または LZX |
| ルート記述子 | manifest.xml - ソリューション ID、機能、.NET アセンブリ パス、およびファイル マッピングを宣言する XML ファイル |
| アセンブリの整合性 | .NET DLL は整合性検証のために「厳密な名前」署名(公開キー トークン)を保持 |
| ソリューション タイプ | ファーム ソリューション(完全な信頼、サーバーへのフルアクセス) vs. サンドボックス ソリューション(制限されたプロセス、SharePoint 2019 で非推奨、SharePoint Online では非サポート) |
| 展開コマンド | SharePoint 管理シェルを介した Add-SPSolution(ファームへの登録)および Install-SPSolution(展開のアクティブ化) |
| ソリューション スキーマ バージョン | manifest.xml で宣言。SharePoint 2007, 2010, 2013, 2016, 2019, または Subscription Edition を対象 |
| 一般的な内容 | manifest.xml, .NET DLL, フィーチャー XML 定義ファイル, ASPX/ASCX テンプレート, JS/CSS/画像リソース |
| 一般的なファイルサイズ | 10 KB - 500 MB(小規模な機能から大規模なエンタープライズ ファーム ソリューションまで) |
| 開発ツール | Microsoft Visual Studio の SharePoint プロジェクト タイプがパッケージ システムを介して .wsp ファイルを生成 |
| 現代の後継形式 | .sppkg (SharePoint Framework パッケージ) - SharePoint Online および Microsoft 365 用 |
| MIME タイプ | application/octet-stream(登録された MIME タイプはありません。CAB コンテンツは application/x-cab として識別されることがあります) |
| リリース日 | Windows SharePoint Services 3.0 / SharePoint 2007 |
| 最新バージョン | SharePoint Server Subscription Edition (2024) / SharePoint Online |
| 仕様書 | learn.microsoft.com |
WSP の変換
コミュニティ Q&A
ユーザーからの質問まだ質問はありません。WSP ファイルについて最初の質問をしてみましょう。