ParticleVE

本サイトが提示する下記のベストプラクティスを実行するプロジェクトは、Open Source Security Foundation (OpenSSF) バッジを達成したことを自主的に自己認証し、そのことを外部に示すことができます。

ソフトウェアに欠陥や脆弱性がないことを保証する手立てはありません。形式論的な証明ができたとしても、仕様や前提が間違っていると誤動作の可能性があります。また、プロジェクトが健全で、かつ機能的な開発コミュニティであり続けることを保証する手立てもありません。しかし、ベストプラクティスの採用は、プロジェクトの成果の向上に寄与する可能性があります。たとえば、いくつものベストプラクティスがリリース前の複数人によるレビューを定めていますが、それによりレビュー以外では発見困難な技術的脆弱性を見つけるのを助け、同時に異なる企業の開発者間の信頼を築き、さらに交流を続けることに対する意欲を生んでいます。バッジを獲得するには、すべてのMUSTおよびMUST NOT基準を満たさなければなりません。すべてのSHOULD基準も満たさなければなりませんが、正当な理由がある場合は満たさなくても構いません。そしてすべてのSUGGESTED基準も満たさなければなりませんが、満たさないとしても、少なくとも考慮することが望まれます。フィードバックは、 GitHubサイトのissueまたはpull requestとして提示されれば歓迎します。また、議論のためのメールリストも用意されています。

私たちは多言語で情報を提供していますが、翻訳版に矛盾や意味の不一致がある場合は、英語版を正式な記述とします。
これがあなたのプロジェクトである場合は、プロジェクトページにベースラインバッジステータスを表示してください!ベースラインバッジステータスは次のようになります: プロジェクト16493のベースラインバッジレベルはin_progressです ベースラインバッジを埋め込む方法は次のとおりです:
ベースラインバッジステータスを表示するには、マークダウンファイルに以下を埋め込みます:
[![OpenSSF Baseline](https://www.bestpractices.dev/projects/16493/baseline)](https://www.bestpractices.dev/projects/16493)
または、HTMLに以下を埋め込みます:
<a href="https://www.bestpractices.dev/projects/16493"><img src="https://www.bestpractices.dev/projects/16493/baseline"></a>


これらはベースラインレベル3の基準です。 これらは基準バージョン v2026.08.28 の評価項目です。

Baseline Series: ベースラインレベル1 ベースラインレベル2 ベースラインレベル3

        

 基本的情報

  • 一般

    他のプロジェクトが同じ名前を使用していないか注意してください。

    ⸭ An image-based, secure hypervisor, built on top of Fedora Linux.

    SPDXライセンスの表現形式を使用してください。 例:「Apache-2.0」、「BSD-2-Clause」、「BSD-3-Clause」、「GPL-2.0+」、「LGPL-3.0+」、「MIT」、「(BSD-2-Clause OR Ruby)」。一重引用符または二重引用符を含めないでください。
    複数の言語がある場合は、コンマを区切り(スペースを入れてもよい)としてリストし、使用頻度の高いものから順に並べます。使用言語が多くある場合は、少なくとも最初の3つの最も多く使われるものをリストアップしてください。言語がない場合(例:ドキュメントだけ、またはテスト専用のプロジェクトの場合)、1文字 " - "を使用します。言語ごとにある大文字・小文字の慣用を踏襲してください(例:「JavaScript」)。
    Common Platform Enumeration(CPE)は、情報技術(IT)システム、ソフトウェア、およびパッケージのための構造化された命名体系です。脆弱性を報告する際に、多くのシステムやデータベースで使用されています。

    ParticleVE is a ParticleOS-derived, image-based Fedora virtualization host. This repository contains its first-party source code, native package recipes, CI and documentation. Upstream dependencies and the public OBS build/signing configuration are linked from README.md and Documentation/Build.md.

 管理策 9/21 ●

  • 管理策


    CI/CDパイプラインでジョブに権限が割り当てられる場合、ソースコードまたは設定は、対応するアクティビティに必要な最小限の権限のみを割り当てる必要があります。 [OSPS-AC-04.02]
    プロジェクトのCI/CDパイプラインを構成して、デフォルトでユーザーとサービスに最小限の利用可能な権限を割り当て、特定のタスクに必要な場合にのみ権限を昇格させます。一部のバージョン管理システムでは、組織またはリポジトリレベルで設定できる場合があります。それができない場合は、パイプラインのトップレベルで権限を設定してください。

    The published source-check workflow defaults to contents: read; the main-only release/build-ref job requests only contents: write. Checkout does not persist credentials. OBS signing keys remain outside source checkouts and deployed hosts, and source-service tokens are package-scoped. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/.github/workflows/check.yml and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md



    信頼できる協力者の入力を受け付けるCI/CDパイプラインは、パイプラインで使用する前にその入力をサニタイズおよび検証しなければなりません。 [OSPS-BR-01.04]
    CI/CDパイプラインは、明示的なワークフロー実行時にすべての協力者の入力をサニタイズ(期待値の引用、エスケープ、または終了)する必要があります。協力者は一般的に信頼されていますが、ワークフローへの手動入力はレビューできず、アカウント乗っ取りや内部脅威によって悪用される可能性があります。

    Trusted pipeline metadata is quoted as environment variables and passed as subprocess arguments. The release planner validates the owner/repository identifier and canonical monotonic versions; build selection resolves exact commits and rejects divergent ancestry. Source locks/recipes and generated inputs have native verification. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Tools/source_releases.py and https://github.com/thefutureisprivate/ParticleVE/blob/main/Tools/build_source.py



    正式なリリースが作成される場合、そのリリース内のすべてのアセットは、リリース識別子またはアセットの他の一意の識別子と明確に関連付けられている必要があります。 [OSPS-BR-02.02]
    プロジェクトによって生成される各ソフトウェアアセットに一意のバージョン識別子を割り当て、一貫した命名規則または番号体系に従ってください。例としては、SemVer、CalVer、またはgitコミットIDなどがあります。

    Image filenames and signed manifests carry the full source version plus OBS check-in/build counters. Each indexed asset has a cryptographic hash; RPMs carry native EVRs and package identities, and GitHub source archives are associated with their version tag. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md and https://github.com/thefutureisprivate/ParticleVE/releases



    プロジェクトは、プロジェクトで使用されるシークレットと認証情報を管理するためのポリシーを定義する必要があります。このポリシーには、シークレットと認証情報を保存、アクセス、およびローテーションするためのガイドラインが含まれている必要があります。 [OSPS-BR-07.02]
    シークレットと認証情報がプロジェクト内でどのように管理され使用されているかを文書化してください。これには、シークレットがどのように保存されるか(例:シークレット管理ツールを使用)、アクセスがどのように制御されるか、シークレットがどのようにローテーションまたは更新されるかについての詳細が含まれている必要があります。機密情報がソースコードにハードコードされたり、バージョン管理システムに保存されたりしないようにしてください。

    Build.md, Development.md and Hardening.md define private signing material outside Git/deployed hosts, private mode-0600 OBS credential files, authenticated non-redirecting uploads, package-scoped automation credentials and owner-only publication access. Trust introduction/rotation/retirement requires an explicit reviewed overlap and recovery evidence. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Hardening.md#trust-rotation-and-old-image-retirement



    プロジェクトがリリースを作成した場合、プロジェクトのドキュメントには、リリースアセットの整合性と真正性を検証するための手順が含まれている必要があります。 [OSPS-DO-03.01]
    プロジェクトの手順には、使用されている技術、実行するコマンド、および期待される出力に関する情報が含まれている必要があります。可能であれば、このドキュメントをビルドおよびリリースパイプラインと同じ場所に保存しないようにして、単一の侵害によってソフトウェアとその整合性を検証するためのドキュメントの両方が侵害されることを避けてください。

    Partially documented. Build.md and ReleaseDiagnostics.md describe verification of the signed OBS feed, hashes and PE/verity assets using the authenticated release client. The GitHub automatic source archives do not have a documented complete archive-authentication procedure with corresponding archive signatures/signed hashes, so coverage of every release channel is incomplete. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md



    プロジェクトがリリースを作成した場合、プロジェクトのドキュメントには、ソフトウェアリリースを作成した人またはプロセスの期待されるIDを検証するための手順が含まれている必要があります。 [OSPS-DO-03.02]
    期待されるIDは、署名に使用される鍵ID、sigstore証明書からの発行者とID、または他の類似の形式である可能性があります。可能であれば、このドキュメントをビルドおよびリリースパイプラインと同じ場所に保存しないようにして、単一の侵害によってソフトウェアとその整合性を検証するためのドキュメントの両方が侵害されることを避けてください。

    Build.md publishes the expected OBS project, producer trust boundary, release-signing GPG fingerprint and EFI certificate fingerprint. The documented release client verifies these trust roots, and publication observation checks the declared owner-only maintainer identity. These are producer-authenticated claims, explicitly distinguished from independent attestation. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md#public-signing-trust



    プロジェクトがリリースを作成した場合、プロジェクトのドキュメントには、各リリースのサポートの範囲と期間に関する説明文が含まれている必要があります。 [OSPS-DO-04.01]
    プロジェクトのリリースされたソフトウェアアセットのサポートの範囲と期間を伝えるために、プロジェクトにはSUPPORT.mdファイル、SECURITY.mdの「サポート」セクション、または各リリースの予想されるサポート期間、提供されるサポートの種類(例:バグ修正、セキュリティ更新)、およびサポートを受けるための関連ポリシーや手順を説明する他のドキュメントが必要です。

    Not met. Documentation identifies the current Fedora/toolchain baseline and platform requirements, but does not state a support scope and support duration for each ParticleVE release. Evidence reviewed: SECURITY.md and Documentation/Toolchain.md.



    プロジェクトがリリースを作成した場合、プロジェクトのドキュメントには、リリースやバージョンがセキュリティ更新を受けなくなる時期について説明文が含まれている必要があります。 [OSPS-DO-05.01]
    セキュリティ修正のサポート範囲と期間を伝えるために、プロジェクトにはSUPPORT.mdまたはプロジェクトのセキュリティ更新に関するポリシーを説明する他のドキュメントが必要です。

    Not met. There is no documented per-version security-update end-of-life policy or schedule. Targeting the current Fedora/toolchain baseline is not a statement of when ParticleVE releases stop receiving security updates. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/SECURITY.md



    プロジェクトの文書には、機密リソースへの昇格された権限を付与する前に、コード共同作業者がレビューされるというポリシーを含めなければなりません(MUST)。 [OSPS-GV-04.01]
    マージ承認やシークレットへのアクセスなど、機密リソースへのエスカレートされた権限を付与される前に、コード共同作業者がレビューおよび承認される必要があるという実行可能なポリシーをプロジェクトのドキュメントに公開してください。審査には、既知の信頼できる組織との貢献者の関連性を確認するなど、正当化可能なIDの系統を確立することが推奨されます。

    The documentation calls for strong authentication and reviewed minimal access, but does not define a collaborator-vetting/review policy before granting escalated sensitive-resource permissions. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Hardening.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/CONTRIBUTING.md



    プロジェクトがリリースを作成した場合、リリースされたすべてのコンパイル済みソフトウェアアセットは、ソフトウェア部品表とともに配信される必要があります。 [OSPS-QA-02.02]
    ビルド時に精度が検証されたツールを使用してSBOMを自動生成することが推奨されます。これにより、ユーザーは環境内の他のプロジェクトと並行して、標準化されたアプローチでこのデータを取り込むことができます。

    Partial inventory exists: mkosi emits JSON package manifests and fwupd-efi includes an embedded SBOM. Complete delivered SBOM coverage for all released image and RPM assets has not been established. Package provenance/identity records alone are not a verified comprehensive SBOM delivery contract. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/mkosi.conf and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Toolchain.md



    プロジェクトが複数のソースコードリポジトリで構成されるリリースを作成した場合、すべてのサブプロジェクトは、プライマリコードベースと同等またはそれより厳しいセキュリティ要件を実施する必要があります。 [OSPS-QA-04.02]
    プロジェクトによって生成され、リリースにコンパイルされる追加のサブプロジェクトコードリポジトリは、それぞれのコードベースのステータスと意図に応じて、セキュリティ要件を実施する必要があります。対応するOSPS Baseline要件に従うことに加えて、これにはセキュリティレビューを要求すること、脆弱性がないこと、および既知のセキュリティ問題がないことを確認することが含まれる場合があります。

    Not applicable to project-owned subprojects: ParticleVE code and release recipes are maintained in one repository. Separately developed Fedora, ParticleOS, systemd, mkosi and fwupd components are upstream dependencies, rather than ParticleVE subproject repositories. Their origins, pins and downstream package verification are documented separately.



    プロジェクトの文書は、テストがいつ、どのように実行されるかを明確に文書化しなければなりません(MUST)。 [OSPS-QA-06.02]
    コントリビューションドキュメントに、ローカルでテストを実行する方法とCI/CDパイプラインでテストを実行する方法を説明するセクションを追加します。ドキュメントでは、テストが何をテストしているかと結果の解釈方法を説明する必要があります。

    CONTRIBUTING.md defines change-specific required verification. Development.md documents make check and targeted probes; ReleaseDiagnostics.md documents source, signed-image, native lifecycle/recovery and hardware acceptance execution and evidence. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/CONTRIBUTING.md#required-verification and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/ReleaseDiagnostics.md



    プロジェクトの文書には、プロジェクトが作成したソフトウェアへのすべての主要な変更が、自動テスト スイート内の該当機能のテストを追加または更新すべきであるというポリシーを含めなければなりません(MUST)。 [OSPS-QA-06.03]
    コントリビューションドキュメントに、テストの追加または更新に関するポリシーを説明するセクションを追加します。ポリシーでは、主要な変更とは何か、どのようなテストを追加または更新すべきかを説明する必要があります。

    The contributor verification matrix requires affected behavioral and failure-path checks for functional, privileged, storage, boot, parser and publication changes. CodingStandards.md requires the existing unittest framework and focused tests for changed boundaries, interruption, malformed input, races and partial completion; major functional changes must maintain that coverage. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/CONTRIBUTING.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/CodingStandards.md#performance-and-testing



    プライマリブランチにコミットが行われる場合、プロジェクトのバージョン管理システムは、マージする前に、作者以外の少なくとも1人の人間による変更の承認を要求しなければなりません(MUST)。 [OSPS-QA-07.01]
    プロジェクトのバージョン管理システムを構成し、リリースまたはプライマリブランチにマージする前に、作者以外の少なくとも1人の人間による変更の承認を要求します。これは、プルリクエストがマージされる前に、少なくとも1人の他のコラボレーターによってレビューおよび承認されることを要求することで実現できます。

    Not met. The active ruleset requires signed commits and prevents deletion/non-fast-forward updates, but does not require pull requests or non-author human approval before main changes are accepted. Evidence: https://github.com/thefutureisprivate/ParticleVE/rules/26840403



    プロジェクトがリリースを行った場合、プロジェクトは、システム内の重要なコードパス、関数、および相互作用に対する攻撃を理解して防御するために、脅威モデリングと攻撃面分析を実行しなければなりません(MUST)。 [OSPS-SA-03.02]
    脅威モデリングは、プロジェクトがコードベース、関連するプロセスとインフラストラクチャ、インターフェース、主要コンポーネントを調べ、「ハッカーのように考え」、システムがどのように破壊または侵害される可能性があるかをブレインストーミングする活動です。識別された各脅威をリストアップし、プロジェクトは、発生する可能性のあるギャップ/脆弱性を積極的に回避または閉じる方法を検討できます。新機能や破壊的変更に対して、これが更新されていることを確認してください。

    Architecture.md and Hardening.md provide project-maintained manual threat/attack-surface analysis: assets and trusted actors, hostile guests and network/artifact inputs, writable startup paths, bootloader trials, mirror admission, update/signing authority and guest/device confinement. They map critical interactions to defenses, residual risks and native positive/negative evidence; contributor policy requires updating affected contracts and checks with changes. This is not an independent audit claim. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Architecture.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Hardening.md



    プロジェクトに影響しないソフトウェア コンポーネント内の脆弱性は、VEX文書で説明され、悪用不可能性の詳細を伴って脆弱性レポートを補完しなければなりません(MUST)。 [OSPS-VM-04.02]
    既知の脆弱性の悪用可能性ステータスを伝達するVEXフィードを確立し、評価の詳細または脆弱なコードが実行されないようにする適切な緩和策を含めます。

    Not met. The repository does not contain or document a VEX publication process or VEX records identifying component vulnerabilities judged non-exploitable in ParticleVE. Dependency/source identity verification does not replace VEX non-exploitability records.



    プロジェクトの文書には、脆弱性やライセンスに関連するSCAの検出結果の修正に関するしきい値を定義するポリシーを含めなければなりません(MUST)。 [OSPS-VM-05.01]
    プロジェクト内に、脆弱性とライセンスに関連するSCA調査結果の修復のしきい値を定義するポリシーを文書化します。これらの調査結果を識別、優先順位付け、修復するプロセスを含めます。

    Not met. Dependency pins, package provenance and update mechanisms are documented, but no SCA policy defines remediation thresholds for vulnerability and license findings. Evidence reviewed: SECURITY.md, CONTRIBUTING.md, Documentation/Build.md and .github/workflows/check.yml.



    プロジェクトの文書には、リリース前にSCA違反に対処するポリシーを含めなければなりません(MUST)。 [OSPS-VM-05.02]
    プロジェクト内に、リリース前に該当するソフトウェア構成分析の結果に対処するポリシーを文書化し、リリース前にそのポリシーへの準拠を検証するステータスチェックを追加します。

    Not met. There is no documented pre-release requirement to resolve SCA vulnerability/license policy violations or record approved exceptions. Existing package-origin, source-pin and payload checks serve different purposes.



    プロジェクトのコードベースへのすべての変更は、悪意のある依存関係および依存関係内の既知の脆弱性に関する文書化されたポリシーに照らして自動的に評価され、悪用不可能であると宣言され抑制されている場合を除き、違反があった場合はブロックされなければなりません(MUST)。 [OSPS-VM-05.03]
    プロジェクトのバージョン管理システムにステータスチェックを作成し、コードベースへのすべての変更に対してソフトウェア構成分析ツールを実行します。変更がマージされる前に、ステータスチェックが合格することを要求します。

    Not met. CI verifies immutable upstream pins/patches, lint, tests and image configuration, but does not automatically evaluate every change against a malicious-dependency/known-vulnerability policy and block acceptance on violations. The active ruleset also lacks required checks. Renovate update PRs alone do not establish this control. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/.github/workflows/check.yml



    プロジェクトの文書には、SASTの検出結果の修正に関するしきい値を定義するポリシーを含めなければなりません(MUST)。 [OSPS-VM-06.01]
    プロジェクト内に、静的アプリケーションセキュリティテスト(SAST)調査結果の修復のしきい値を定義するポリシーを文書化します。これらの調査結果を識別、優先順位付け、修復するプロセスを含めます。

    Not met. CodingStandards.md treats warnings as errors for configured diagnostics, but the documentation does not define a security-specific SAST findings/remediation policy and threshold. The current source workflow uses Ruff lint and tests; Scorecard assesses repository practices rather than application-code security weaknesses.



    プロジェクトのコードベースへのすべての変更は、セキュリティ上の弱点に関する文書化されたポリシーに照らして自動的に評価され、悪用不可能であると宣言され抑制されている場合を除き、違反があった場合はブロックされなければなりません(MUST)。 [OSPS-VM-06.02]
    プロジェクトのバージョン管理システムにステータスチェックを作成し、コードベースへのすべての変更に対して静的アプリケーションセキュリティテスト(SAST)ツールを実行します。変更がマージされる前に、ステータスチェックが合格することを要求します。

    Not met. The repository does not enforce an automatic application-security weakness scan and documented exception policy on every accepted change. Ruff/tests are present, but no mandatory security-specific SAST acceptance gate is configured, and required branch checks are absent. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/.github/workflows/check.yml and https://github.com/thefutureisprivate/ParticleVE/rules/26840403



ツールやAIシステムを使って、https://www.bestpractices.dev/ja/projects/16493/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforcedのような簡単なURLで変更を提案できます。その方法については、自動化提案システムをご覧ください。 このデータは、Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0)のもとで利用可能です。これは、データ受領者が、データ受領者がこの契約のテキストを共有データとともに利用可能にする限り、変更の有無にかかわらずデータを共有できることを意味します。thefutureisprivateおよびOpenSSFベストプラクティスバッジのコントリビューターにクレジットを表示してください。

プロジェクト バッジ登録の所有者: thefutureisprivate.
エントリの作成日時 2026-11-09 10:51:34 UTC、 最終更新日 2026-11-09 11:59:01 UTC