ParticleVE

Projekte, die den nachfolgenden Best Practices folgen, können sich freiwillig selbst zertifizieren und zeigen, dass sie einen Core-Infrastruktur-Initiative-/OpenSSF-Badge erhalten haben.

Es gibt keine Auswahl an Praktiken, die garantieren können, dass Software niemals Fehler oder Schwachstellen hat. Selbst formale Methoden können fehlschlagen, wenn die Spezifikationen oder Annahmen falsch sind. Auch gibt es keine Auswahl an Praktiken, die garantieren können, dass ein Projekt eine gesunde und gut funktionierende Entwicklungsgemeinschaft erhalten wird. Allerdings können Best Practices dabei helfen, die Ergebnisse von Projekten zu verbessern. Zum Beispiel ermöglichen einige Praktiken die Mehrpersonen-Überprüfung vor der Freigabe, die sowohl helfen können ansonsten schwer zu findende technische Schwachstellen zu finden und gleichzeitig dazu beitragen Vertrauen und den Wunsch nach wiederholter Zusammenarbeit zwischen Entwicklern verschiedener Unternehmen zu schaffen. Um ein Badge zu verdienen, müssen alle MÜSSEN und MÜSSEN NICHT Kriterien erfüllt sein, alle SOLLTEN Kriterien müssen erfüllt sein oder eine Rechtfertigung enthalten, und alle EMPFHOLEN Kriterien müssen erfüllt sein oder nicht (wir wollen sie zumindest berücksichtigt wissen). Wenn lediglich ein allgemeiner Kommentar angebeben werden soll, keine direkte Begründung, dann ist das erlaubt, wenn der Text mit "//" und einem Leerzeichen beginnt. Feedback ist willkommen auf derGitHub-Website als Issue oder Pull-Request. Es gibt auch eine E-Mail-Liste für allgemeine Diskussionen.

Wir stellen Ihnen gerne die Informationen in mehreren Sprachen zur Verfügung, allerdings ist die englische Version maßgeblich, insbesondere wenn es Konflikte oder Inkonsistenzen zwischen den Übersetzungen gibt.
Wenn dies Ihr Projekt ist, zeigen Sie bitte Ihren Baseline-Badge-Status auf Ihrer Projektseite! Der Baseline-Badge-Status sieht so aus: Baseline-Badge-Level für Projekt 16493 ist in_progress So betten Sie das Baseline-Badge ein:
Sie können Ihren Baseline-Badge-Status anzeigen, indem Sie Folgendes in Ihre Markdown-Datei einbetten:
[![OpenSSF Baseline](https://www.bestpractices.dev/projects/16493/baseline)](https://www.bestpractices.dev/projects/16493)
oder indem Sie Folgendes in Ihr HTML einbetten:
<a href="https://www.bestpractices.dev/projects/16493"><img src="https://www.bestpractices.dev/projects/16493/baseline"></a>


Dies sind die Baseline Niveau 2 Kriterien. Dies sind Kriterienversion v2026.08.28.

Baseline Series: Baseline Niveau 1 Baseline Niveau 2 Baseline Niveau 3

        

 Grundlagen

  • Allgemein

    Hinweis: Andere Projekte können den selben Namen benutzen.

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

    Bitte verwenden Sie das SPDX-License-Expression-Format; Beispiele sind "Apache-2.0", "BSD-2-Clause", "BSD-3-Clause", "GPL-2.0+", "LGPL-3.0+", "MIT" und "(BSD-2-Clause OR Ruby)". Geben sie nicht die einfachen oder doppelten Anführungszeichen mit an.
    Wenn es mehr als eine Programmiersprache gibt, listen Sie sie als kommagetrennte Werte (Leerzeichen sind optional) auf und sortieren Sie sie von am häufigsten zum am wenigsten verwendeten. Wenn es eine lange Liste gibt, bitte mindestens die ersten drei häufigsten auflisten. Wenn es keine Programmiersprache gibt (z. B. ist dies nur ein Dokumentations- oder Testprojekt), verwenden Sie das einzelne Zeichen "-". Bitte verwenden Sie eine herkömmliche Großschreibung für jede Sprache, z.B. "JavaScript".
    Das Common Platform Enumeration (CPE) ist ein strukturiertes Namensschema für IT-Systeme, Software und Pakete. Es wird in diversen Systemen und Datenbanken bei der Meldung von Schwachstellen verwendet.

    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.

 Steuerelemente 9/19 ●

  • Steuerelemente


    Wenn eine CI/CD-Aufgabe ohne angegebene Berechtigungen ausgeführt wird, MUSS das CI/CD-System die Berechtigungen der Aufgabe standardmäßig auf die niedrigsten in der Pipeline gewährten Berechtigungen setzen. [OSPS-AC-04.01]
    Konfigurieren Sie die Einstellungen des Projekts so, dass neuen Pipelines standardmäßig die niedrigsten verfügbaren Berechtigungen zugewiesen werden, wobei zusätzliche Berechtigungen nur bei Bedarf für bestimmte Aufgaben gewährt werden.

    The source-check workflow declares contents: read at workflow scope, so jobs without their own permissions inherit that restricted default. Only the separate main-branch publication job explicitly requests contents: write. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/.github/workflows/check.yml



    Wenn ein offizieller Release erstellt wird, MUSS diesem Release eine eindeutige Versionskennung zugewiesen werden. [OSPS-BR-02.01]
    Weisen Sie jedem vom Projekt erstellten Release eine eindeutige Versionskennung zu und folgen Sie dabei einer konsistenten Namenskonvention oder einem Nummerierungsschema. Beispiele sind SemVer, CalVer oder Git-Commit-ID.

    Source releases use unique four-component Fedora/PVE version tags, for example v45.0.1.2. Signed images append both native OBS counters, for example 45.0.1.2-6.1. The version parser and release planner reject noncanonical, reused or decreasing source versions. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Tools/source_releases.py and https://github.com/thefutureisprivate/ParticleVE/releases



    Wenn ein offizieller Release erstellt wird, MUSS dieser Release ein beschreibendes Protokoll funktionaler und sicherheitsrelevanter Änderungen enthalten. [OSPS-BR-04.01]
    Stellen Sie sicher, dass alle Releases ein beschreibendes Änderungsprotokoll enthalten. Es wird empfohlen sicherzustellen, dass das Änderungsprotokoll von Menschen lesbar ist und Details über Commit-Nachrichten hinaus enthält, wie z.B. Beschreibungen der Sicherheitsauswirkung oder Relevanz für verschiedene Anwendungsfälle. Um Maschinenlesbarkeit zu gewährleisten, platzieren Sie den Inhalt unter einer Markdown-Überschrift wie "## Changelog".

    Partially implemented, not met for every official release. GitHub source releases include generated commit-range notes and a full changelog link. ReleaseDiagnostics.md requires functional, security and dependency notes, but the published OBS dependency-only image rebuilds do not have a verified per-build descriptive change log. The signed package inventory alone is not such a log. Evidence: https://github.com/thefutureisprivate/ParticleVE/releases and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/ReleaseDiagnostics.md



    Wenn eine Build- und Release-Pipeline Abhängigkeiten einbindet, MUSS sie standardisierte Tools verwenden, wo verfügbar. [OSPS-BR-05.01]
    Verwenden Sie ein gängiges Tool für Ihr Ökosystem, wie z.B. Paketmanager oder Abhängigkeits-Management-Tools, um Abhängigkeiten zur Build-Zeit einzubinden. Dies kann die Verwendung einer Abhängigkeitsdatei, Lock-Datei oder Manifest umfassen, um die erforderlichen Abhängigkeiten zu spezifizieren, die dann vom Build-System eingezogen werden.

    Dependencies are obtained through native Fedora RPM/DNF repositories, OBS and mkosi; native RPM recipes declare build/runtime requirements. Pinned source tools are fetched from immutable upstream Git commits, verified against sources.lock.json and reviewed patches. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/sources.lock.json



    Wenn ein offizieller Release erstellt wird, MUSS dieser Release signiert sein oder in einem signierten Manifest erfasst werden, das die kryptographischen Hashes jedes Assets enthält. [OSPS-BR-06.01]
    Signieren Sie alle freigegebenen Software-Assets zur Build-Zeit mit einer kryptographischen Signatur oder Attestierungen, wie z.B. GPG- oder PGP-Signatur, Sigstore-Signaturen, SLSA-Provenance oder SLSA-VSAs. Fügen Sie die kryptographischen Hashes jedes Assets in eine signierte Manifest- oder Metadaten-Datei ein.

    Partially implemented, not met across all release channels. OBS RPMs and image assets are signed or covered by the signed SHA256SUMS index. Source commits are signed, but GitHub source releases currently provide automatic source archives without detached archive signatures or a signed archive-hash manifest. The v45.0.1.2 release has no uploaded signature/manifest assets and its tag is lightweight. Evidence: https://github.com/thefutureisprivate/ParticleVE/releases/tag/v45.0.1.2 and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md



    Wenn das Projekt ein Release erstellt hat, MUSS die Projektdokumentation eine Beschreibung enthalten, wie das Projekt seine Abhängigkeiten auswählt, bezieht und verfolgt. [OSPS-DO-06.01]
    Es wird empfohlen, diese Informationen zusammen mit der technischen und Design-Dokumentation des Projekts auf einer öffentlich zugänglichen Ressource wie dem Quellcode-Repository, der Projektwebsite oder einem anderen Kanal zu veröffentlichen.

    Toolchain.md and Build.md explain the Fedora/stable-systemd repository policy, immutable mkosi/fwupd pins, dependency refresh, downstream patch verification, package origins and per-release source/package identities. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Toolchain.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md



    Die Projektdokumentation MUSS Anweisungen enthalten, wie die Software gebaut wird, einschließlich erforderlicher Bibliotheken, Frameworks, SDKs und Abhängigkeiten. [OSPS-DO-07.01]
    Es wird empfohlen, diese Informationen zusammen mit der Beiträgerdokumentation des Projekts zu veröffentlichen, z. B. in CONTRIBUTING.md oder anderen Entwickleraufgabendokumentationen. Dies kann auch mithilfe von Makefile-Zielen oder anderen Automatisierungsskripten dokumentiert werden.

    README.md, Development.md, Toolchain.md and Build.md document prerequisites, source fetching, configuration, mkosi summary/build commands, native RPM dependencies, signing inputs and OBS reproduction. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Development.md



    Die Projektdokumentation MUSS eine Liste der Projektmitglieder mit Zugriff auf sensible Ressourcen enthalten. [OSPS-GV-01.01]
    Dokumentieren Sie Projektteilnehmer und ihre Rollen durch Artefakte wie members.md, governance.md, maintainers.md oder eine ähnliche Datei im Quellcode-Repository des Projekts. Dies kann so einfach sein wie die Aufnahme von Namen oder Account-Handles in einer Liste von Maintainern, oder komplexer sein, abhängig von der Governance des Projekts.

    Not fully documented. Build.md and .obs/site.json identify the OBS owner and owner-only publication policy, and SECURITY.md links the maintainer. There is no complete documented roster covering all people with sensitive repository, CI, source-update and signing/publication access. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Build.md



    Die Projektdokumentation MUSS Beschreibungen der Rollen und Verantwortlichkeiten der Projektmitglieder enthalten. [OSPS-GV-01.02]
    Dokumentieren Sie Projektteilnehmer und ihre Rollen durch Artefakte wie members.md, governance.md, maintainers.md oder ähnliche Dateien im Quellcode-Repository des Projekts.

    Contributor requirements and technical build authority are documented, but there is no complete project-member role/responsibility description covering maintenance, review, releases, security response and sensitive-resource administration. Evidence reviewed: CONTRIBUTING.md, SECURITY.md and Documentation/Build.md.



    Die Projektdokumentation MUSS einen Leitfaden für Code-Mitwirkende enthalten, der die Anforderungen für akzeptable Beiträge beschreibt. [OSPS-GV-03.02]
    Erweitern Sie die Inhalte von CONTRIBUTING.md oder CONTRIBUTING/ in der Projektdokumentation, um die Anforderungen für akzeptable Beiträge zu beschreiben, einschließlich Codierungsstandards, Testanforderungen und Einreichungsrichtlinien für Code-Beitragende. Es wird empfohlen, dass dieser Leitfaden die verbindliche Quelle sowohl für Beitragende als auch für Genehmiger ist.

    CONTRIBUTING.md specifies acceptable design, compatibility and migration policy, required checks and documentation responsibilities. CodingStandards.md adds language, diagnostics, privilege-boundary and test requirements. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/CONTRIBUTING.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/CodingStandards.md



    Das Versionskontrollsystem MUSS bei jedem Commit von allen Code-Mitwirkenden verlangen zu bestätigen, dass sie rechtlich befugt sind, die zugehörigen Beiträge zu leisten. [OSPS-LE-01.01]
    Fügen Sie ein DCO in das Repository des Projekts ein, das Code-Beitragende dazu verpflichtet zu bestätigen, dass sie rechtlich berechtigt sind, die zugehörigen Beiträge bei jedem Commit zu leisten. Verwenden Sie eine Statusüberprüfung, um sicherzustellen, dass die Bestätigung erfolgt ist. Ein CLA erfüllt diese Anforderung ebenfalls. Einige Versionskontrollsysteme, wie GitHub, können dies in den Nutzungsbedingungen der Plattform enthalten.

    Not met. The active ruleset requires cryptographic commit signatures, but neither a DCO Signed-off-by assertion nor a CLA/legal-authorization check is required on every contribution. A signature authenticates the author; it does not itself assert legal authority to contribute. Evidence: https://github.com/thefutureisprivate/ParticleVE/rules/26840403 and https://github.com/thefutureisprivate/ParticleVE/blob/main/CONTRIBUTING.md



    Wenn ein Commit in den primären Branch erfolgt, MÜSSEN alle automatisierten Statusüberprüfungen für Commits bestanden werden oder manuell umgangen werden. [OSPS-QA-03.01]
    Konfigurieren Sie das Versionskontrollsystem des Projekts so, dass alle automatisierten Statusüberprüfungen bestanden werden müssen oder eine manuelle Bestätigung erforderlich ist, bevor ein Commit in den primären Branch zusammengeführt werden kann. Es wird empfohlen, dass optionale Statusüberprüfungen NICHT als Bestehen-oder-Durchfallen-Anforderung konfiguriert werden, die Genehmiger versucht sein könnten zu umgehen.

    CI runs checks, but the active ruleset has no required-status-check rule. Direct signed pushes to main can be accepted before checks complete; publication-job gating is not primary-branch acceptance enforcement. Evidence: https://github.com/thefutureisprivate/ParticleVE/rules/26840403



    Bevor ein Commit akzeptiert wird, MÜSSEN die CI/CD-Pipelines des Projekts mindestens eine automatisierte Test-Suite ausführen, um sicherzustellen, dass die Änderungen den Erwartungen entsprechen. [OSPS-QA-06.01]
    Automatisierte Tests sollten vor jedem Merge in den primären Branch ausgeführt werden. Die Test-Suite sollte in einer CI/CD-Pipeline ausgeführt werden und die Ergebnisse sollten für alle Beitragenden sichtbar sein. Die Test-Suite sollte in einer konsistenten Umgebung ausgeführt werden und so ausgeführt werden, dass Beitragende die Tests lokal ausführen können. Beispiele für Test-Suites sind Unit-Tests, Integrationstests und End-to-End-Tests.

    The source-check workflow runs make check, upstream verification and mkosi summary on pull requests and main pushes. However, a passing test suite is not enforced before every commit is accepted onto main, because direct pushes remain permitted and no required-check rule is configured. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/.github/workflows/check.yml and https://github.com/thefutureisprivate/ParticleVE/rules/26840403



    Wenn das Projekt eine Veröffentlichung vorgenommen hat, MUSS die Projektdokumentation Design-Dokumentation enthalten, die alle Aktionen und Akteure innerhalb des Systems demonstriert. [OSPS-SA-01.01]
    Fügen Sie Designs in die Projektdokumentation ein, die die Aktionen und Akteure erklären. Akteure umfassen jedes Subsystem oder jede Entität, die ein anderes Segment im System beeinflussen kann. Stellen Sie sicher, dass dies für neue Funktionen oder Breaking Changes aktualisiert wird.

    Architecture.md documents actors, trusted/untrusted boundaries, ownership, boot/storage/update transactions, guest isolation, administration and external observations. Its responsibility table and invariants cover the system actions and authorities. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Architecture.md



    Wenn das Projekt eine Veröffentlichung vorgenommen hat, MUSS die Projektdokumentation Beschreibungen aller externen Software-Schnittstellen der veröffentlichten Software-Assets enthalten. [OSPS-SA-02.01]
    Dokumentieren Sie alle Software-Schnittstellen (APIs) der veröffentlichten Software-Assets und erklären Sie, wie Benutzer mit der Software interagieren können und welche Daten erwartet oder produziert werden. Stellen Sie sicher, dass dies für neue Funktionen oder Breaking Changes aktualisiert wird.

    The operations, commissioning, architecture and reporting sections describe the public CLI, native systemd/VM interfaces, host configuration, signed release/feed contract and health-report receiver interface. The public CLI parser supplies the option/command reference via --help. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Operations.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Sources/particleve/cli.py



    Wenn das Projekt eine Veröffentlichung vorgenommen hat, MUSS das Projekt eine Sicherheitsbewertung durchführen, um die wahrscheinlichsten und folgenschwersten potenziellen Sicherheitsprobleme zu verstehen, die innerhalb der Software auftreten könnten. [OSPS-SA-03.01]
    Die Durchführung einer Sicherheitsbewertung informiert sowohl Projektmitglieder als auch nachgelagerte Verbraucher darüber, dass das Projekt versteht, welche Probleme innerhalb der Software auftreten könnten. Das Verständnis darüber, welche Bedrohungen realisiert werden könnten, hilft dem Projekt, Risiken zu verwalten und anzugehen. Diese Informationen sind für nachgelagerte Verbraucher nützlich, um den Sicherheitssachverstand und die Praktiken des Projekts zu demonstrieren. Stellen Sie sicher, dass dies für neue Funktionen oder Breaking Changes aktualisiert wird.

    The manual architectural security assessment in Architecture.md and Hardening.md identifies trusted actors, assets, hostile guest/network/artifact inputs, writable-startup risks, stale storage and compromised producer assumptions. It maps these risks to controls and release-specific positive/negative acceptance evidence. This is project-maintained assessment material, not a claim of independent certification. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Architecture.md and https://github.com/thefutureisprivate/ParticleVE/blob/main/Documentation/Hardening.md



    Die Projektdokumentation MUSS eine Richtlinie für die koordinierte Offenlegung von Schwachstellen (Coordinated Vulnerability Disclosure, CVD) mit einem klaren Zeitrahmen für die Reaktion enthalten. [OSPS-VM-01.01]
    Erstellen Sie eine SECURITY.md-Datei im Stammverzeichnis, die die Richtlinie des Projekts für koordinierte Offenlegung von Schwachstellen beschreibt. Fügen Sie eine Methode zur Meldung von Schwachstellen hinzu. Setzen Sie Erwartungen dafür, wie das Projekt reagieren und gemeldete Probleme angehen wird.

    Not met. SECURITY.md allows public disclosure and appreciates coordinated disclosure, but does not commit to a clear vulnerability-report response timeframe or define a complete CVD response procedure. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/SECURITY.md



    Die Projektdokumentation MUSS eine Möglichkeit zur privaten Meldung von Schwachstellen direkt an die Sicherheitskontakte des Projekts bereitstellen. [OSPS-VM-03.01]
    Bieten Sie Sicherheitsforschern eine Möglichkeit, Schwachstellen privat an das Projekt zu melden. Dies kann eine dedizierte E-Mail-Adresse, ein Webformular, spezialisierte VCS-Tools, E-Mail-Adressen für Sicherheitskontakte oder andere Methoden sein.

    A documented private intake is not established. SECURITY.md points to public issues and the maintainer profile, but does not identify an explicit private security email address or document an enabled private reporting form/advisory intake. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/SECURITY.md



    Die Projektdokumentation MUSS Daten über entdeckte Schwachstellen öffentlich veröffentlichen. [OSPS-VM-04.01]
    Bereitstellen von Informationen über bekannte Schwachstellen in einem vorhersehbaren öffentlichen Kanal, wie z.B. einem CVE-Eintrag, Blogbeitrag oder einem anderen Medium. Soweit möglich sollten diese Informationen betroffene Version(en) enthalten, wie ein Verbraucher feststellen kann, ob er betroffen ist, und Anweisungen zur Schadensbegrenzung oder Behebung.

    A public vulnerability-disclosure record is not established by the current documentation. SECURITY.md describes reporting routes, but does not identify a maintained public advisory register with affected versions, impact and remediation information for discovered vulnerabilities. Evidence: https://github.com/thefutureisprivate/ParticleVE/blob/main/SECURITY.md



Sie können Tools und KI-Systeme nutzen, um Änderungen über eine einfache URL vorzuschlagen, z. B. https://www.bestpractices.dev/de/projects/16493/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforced. Wie das geht, erfahren Sie in unserem Automatisierungsvorschlagssystem. Diese Daten sind unter der Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0) verfügbar. Dies bedeutet, dass ein Datenempfänger die Daten mit oder ohne Änderungen weitergeben darf, solange der Datenempfänger den Text dieser Vereinbarung mit den weitergegebenen Daten zur Verfügung stellt. Bitte nennen Sie thefutureisprivate und die OpenSSF Best Practices Badge-Mitwirkenden als Urheber.

Projekt-Badge-Eintrag im Besitz von: thefutureisprivate.
Eintrag erstellt: 2026-11-09 10:51:34 UTC, zuletzt aktualisiert: 2026-11-09 11:59:01 UTC.