carbon-footprint-program

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 Badge-Status auf Ihrer Projektseite! Der Badge-Status sieht so aus: Badge-Level für Projekt 13873 ist passing So können Sie ihn einbetten:
Sie können Ihren Badge-Status anzeigen, indem Sie Folgendes in Ihre Markdown-Datei einbetten:
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13873/badge)](https://www.bestpractices.dev/projects/13873)
oder indem Sie Folgendes in Ihr HTML einbetten:
<a href="https://www.bestpractices.dev/projects/13873"><img src="https://www.bestpractices.dev/projects/13873/badge"></a>


Dies sind die Kriterien das Level Passing. Sie können auch die Kriterien für die Level Silber oder Gold sehen.

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

        

 Grundlagen 13/13

  • Allgemein

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

    Huella Latam is a digital public good for Latin America that lets organizations and governments measure, manage and reduce their carbon footprints. Organizations build greenhouse-gas inventories from activity data using country-configurable emission factors and methodologies, submit them for verification, and track reduction plans; national administrators manage catalogs, methodologies, users and sector-level reporting. It is a TypeScript monorepo — a Fastify + Prisma + PostgreSQL API, a React + Vite web app, shared libraries, and Azure Bicep infrastructure — released under AGPL-3.0 and owned by the United Nations Development Programme (UNDP). The platform is country-agnostic by design: country-specific values live in configuration and seed data so each adopting country can run its own deployment.

    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.
  • Grundlegende Informationen auf der Projektwebseite


    Die Projekt-Website MUSS prägnant beschreiben, was die Software tut (welches Problem löst sie?). [description_good]
    Dies MUSS in einer Sprache sein, die potenzielle Nutzer verstehen können (z. B. möglichst wenig Fachbegriffe verwenden).

    The README opens with a one-line description — "Huella Latam: a platform (digital public good for Latin America) for measuring, managing, and reducing carbon footprints" — followed by an architecture summary, an SDG-relevance section, and a documentation index. See https://github.com/undp/carbon-footprint-program#readme and https://github.com/undp/carbon-footprint-program/blob/main/docs/overview/project-overview.md



    Die Projekt-Website MUSS Informationen darüber enthalten, wie Feedback erhalten und gegeben werden kann (als Fehlerberichte oder Verbesserungsvorschläge), und wie man zur Softwareentwicklung beitragen kann. [interact]

    The README "Quick start" section explains how to obtain, build and run the software; CONTRIBUTING.md explains how to give feedback and contribute; .github/SUPPORT.md routes questions, bug reports, feature requests, security reports and privacy concerns to the right channel. https://github.com/undp/carbon-footprint-program/blob/main/.github/SUPPORT.md



    Die Informationen darüber, wie jemand beitragen kann, MÜSSEN den Prozess erklären (z.B. wie werden Pull-Requests verwendet?) (URL erforderlich) [contribution]
    Wir nehmen an, dass Projekte auf GitHub Issues und Pull-Requests verwenden, sofern nichts anders angegeben ist. Diese Information kann kurz sein, z. B., dass das Projekt Pull-Requests, einen Issue-Tracker oder eine Mailing-Liste verwendet (welche?)

    Non-trivial contribution file in repository: https://github.com/undp/carbon-footprint-program/blob/main/CONTRIBUTING.md. It covers the Code of Conduct, licensing of contributions (AGPL-3.0), how to report bugs and request features, development setup, and the pull-request process. A detailed technical workflow (branch naming, commit conventions, local database, testing) is at https://github.com/undp/carbon-footprint-program/blob/main/docs/development/contributing.md.



    Die Informationen darüber, wie jemand beitragen können, SOLLTEN die Anforderungen für akzeptable Beiträge (z. B. einen Hinweis auf jeden erforderlichen Programmierstandard) enthalten. (URL erforderlich) [contribution_requirements]

    CONTRIBUTING.md documents the acceptance criteria explicitly: https://github.com/undp/carbon-footprint-program/blob/main/CONTRIBUTING.md#contribution-acceptance-criteria — country-agnosticism, backward compatibility for existing country deployments, integration tests for new features, documentation updates, and an explicit maintainer security review for changes to auth, authorization, file upload or DB queries. It also requires branch prefixes (feat/fix/refactor/docs/chore/infra), Conventional Commits, small modular commits, and that CI (lint, type-check, format, test, build) pass. A pull-request template is provided at https://github.com/undp/carbon-footprint-program/blob/main/.github/PULL_REQUEST_TEMPLATE.md.


  • FLOSS-Lizenz


    Die vom Projekt entwickelte Software MUSS als FLOSS lizensiert veröffentlicht sein. [floss_license]
    FLOSS-Software erfüllt die Open Source Definition oder die Free Software Definition. Beispiele für solche Lizenzen sind die CC0 , MIT, BSD 2-clause, BSD 3-clause revised, Apache 2.0 , Lesser GNU General Public License (LGPL) und die GNU General Public License (GPL) . Für unsere Zwecke bedeutet dies, dass die Lizenz: Die Software kann auch über andere Wege lizenziert werden (z.B. "GPLv2 oder proprietär" ist akzeptabel).

    The project is released under the GNU Affero General Public License v3.0 only (SPDX: AGPL-3.0-only), declared in the root LICENSE file and in the "license" field of every package.json. AGPL-3.0 is approved by the Open Source Initiative (OSI) and by the Digital Public Goods Alliance.



    Es wird EMPFHOLEN, dass alle erforderlichen Lizenz(en) für die vom Projekt entwickelte Software von der Open Source Initiative (OSI) anerkannt werden. [floss_license_osi]
    Die OSI verwendet einen anspruchsvollen Genehmigungsprozess, um festzulegen, welche Lizenzen OSS sind.

    The AGPL-3.0 license is approved by the Open Source Initiative (OSI).



    Das Projekt MUSS die Lizenz(en) seiner Erzeugnisse an einem üblichen Ort in ihrem Quell-Repository veröffentlichen. (URL erforderlich) [license_location]
    Eine Konvention ist es die Lizenz als eine Top-Level-Datei mit der Bezeichnung LICENSE oder COPYING zu veröffentlichen. Lizenzdateinamen DÜRFEN eine Erweiterung wie ".txt" oder ".md" haben. Eine alternative Konvention ist es einen Ordern mit dem namen LICENSES zu erstellen und dort alle Lizenz(en) abzuspeicehrn; diese dateien sind typischerweise mit ihreren SPDX License Identifier benannt und einer passendend Dateiendung; siehe Beschreibung dieser Konvention in der REUSE Specification. Beachten Sie, dass dieses Kriterium nur eine Voraussetzung für das Quell-Repository ist. Sie müssen die Lizenzdatei NICHT hinzufügen, wenn Sie etwas aus dem Quellcode generieren (z. B. eine ausführbare Datei, ein Paket oder einen Container). Wenn Sie beispielsweise ein R-Paket für das Comprehensive R Archive Network (CRAN) generieren, befolgen Sie die Standard-CRAN-Praxis: Wenn die Lizenz eine Standardlizenz ist, verwenden Sie die Standard-Kurzlizenzspezifikation (um die Installation einer weiteren Kopie des Textes zu vermeiden) die LICENSE-Datei in einer Ausschlussdatei wie .Rbuildignore. Ebenso können Sie beim Erstellen eines Debian-Pakets einen Link in die Copyright-Datei zum Lizenztext in /usr/share/common-licenses einfügen und die Lizenzdatei vom erstellten Paket ausschließen (z.B. durch Löschen der Datei nach dem Aufruf von dh_auto_install). Wir empfehlen, maschinenlesbare Lizenzinformationen in generierten Formaten zu integrieren, wo dies praktisch ist.

    Non-trivial license location file in repository: https://github.com/undp/carbon-footprint-program/blob/main/LICENSE — the full AGPL-3.0 text in the standard root LICENSE file. GitHub detects the license as "GNU Affero General Public License v3.0".


  • Dokumentation


    Das Projekt MUSS eine grundlegende Dokumentation für die vom Projekt entwickelte Software liefern. [documentation_basics]
    Diese Dokumentation muss in irgendeinem Medium sein (z.B. Text oder Video), das Folgendes beinhaltet: wie man die Software installiert, wie man sie startet, wie man sie benutzt (evtl. ein Tutorial mit Beispielen) und wie man sie sicher benutzt (z. B. was zu tun und zu lassen ist), wenn das ein passendes Einsatzgebiet für die Software ist. Die Sicherheitsdokumentation muss nicht lange sein. Das Projekt DARF Hypertext-Links zu Nicht-Projekt-Materialien als Dokumentation verwenden. Wenn das Projekt keine Software entwickelt, wählen Sie "nicht anwendbar" (N/A) aus.

    Documentation lives under docs/ with an index at https://github.com/undp/carbon-footprint-program/blob/main/docs/README.md. It covers architecture (system-architecture.md, tech-stack.md, codebase-map.md, emission-calculation.md), the data model (developer-guide.md, ER diagram), development (local-setup.md, api-conventions.md, testing.md, environment-variables.md, contributing.md), operations (admin-guide.md, production-deployment.md, observability.md), infrastructure/deployment, security, and release/versioning. A separate end-user manual is maintained under user_manual/.



    Das Projekt MUSS Referenzdokumentationen enthalten, die externe Schnittstellen (beides, Eingabe und Ausgabe) der vom Projekt entwickelten Software beschreiben. [documentation_interface]
    Die Dokumentation einer externen Schnittstelle erklärt einem Endbenutzer oder Entwickler, wie man sie benutzt. Dies beinhaltet auch eine Programmierschnittstelle (API), falls die Software eine hat. Wenn es sich um eine Bibliothek handelt, dokumentieren Sie die wichtigsten Klassen/Typen und Methoden/Funktionen, die aufgerufen werden können. Wenn es sich um eine Webanwendung handelt, definieren Sie ihre URL-Schnittstelle (häufig eine REST-Schnittstelle). Wenn es sich um eine Befehlszeilenschnittstelle handelt, dokumentieren Sie die Parameter und Optionen, die sie unterstützt. In vielen Fällen ist es am besten, wenn die meisten dieser Dokumente automatisch generiert werden, so dass diese Dokumentation mit der sich ändernden Software synchronisiert bleibt, aber dies ist nicht erforderlich. Das Projekt DARF Hypertext-Links zu Nicht-Projekt-Materialien als Dokumentation verwenden. Dokumentation DARF automatisch generiert werden (falls möglich ist dies oft der beste Weg). Die Dokumentation einer REST-Schnittstelle kann mit Swagger/OpenAPI erzeugt werden. Code-Interface-Dokumentation kann mit Werkzeugen wie JSDoc (JavaScript), ESDoc (JavaScript), pydoc (Python), devtools (R), pkgdown (R) und Doxygen (verschiedene) generiert werden. Nur Kommentare im Quelltext reicht nicht aus, um dieses Kriterium zu erfüllen; Es muss einen einfacheren Weg geben, um die Informationen zu sehen, ohne den ganzen Quellcode durchzulesen. Wenn das Projekt keine Software entwickelt, wählen Sie "nicht anwendbar" (N/A) aus.

    The HTTP API is self-documenting via @fastify/swagger + @fastify/swagger-ui, which publish an OpenAPI specification and interactive docs at /api/docs (locally http://localhost:8080/api/docs). Route schemas are Zod-derived, so the published OpenAPI document is generated from the same schemas the API validates against. Conventions for the external interface are documented at https://github.com/undp/carbon-footprint-program/blob/main/docs/development/api-conventions.md.


  • Andere


    Die Projekt-Seiten (Website, Repository und Download-URLs) MÜSSEN HTTPS mit TLS unterstützen. [sites_https]
    Dies setzt voraus, dass die Projekt-Homepage-URL und die URL des Versionskontroll-Repositories mit "https:", nicht "http:" beginnt. Sie können kostenlose Zertifikate von Let's Encrypt erhalten. Projekte KÖNNEN dieses Kriterium implementieren, indem Sie (z. B.) GitHub-Pages verwenden, GitLab-Pages oder SourceForge project pages. Wenn Sie HTTP unterstützen, empfehlen wir Ihnen, den HTTP-Datenverkehr an HTTPS umzuleiten.

    All project sites are HTTPS-only. The repository and its documentation are served by GitHub over HTTPS (https://github.com/undp/carbon-footprint-program), and the demo site https://www.huellaslatam.org responds over HTTPS with a valid certificate (verified: HTTP 200, certificate chain validates). Note for accuracy: huellaslatam.org is a demonstration environment, not a production-grade deployment — it exists to show the platform, and its configuration should not be read as a production reference. There is no single canonical production instance: each adopting country provisions and operates its own. What the project guarantees across every topology is that TLS is enforced by the platform layer with minTlsVersion pinned to 1.2 in the Bicep templates (infra/modules/appService.bicep, storage.bicep, frontDoor.bicep), and that plain HTTP is rejected or redirected before a request reaches application code. See docs/security/hardening.md, "Deployment topology" and "Transport Security".



    Das Projekt MUSS einen oder mehrere Mechanismen zur Diskussion (einschließlich der vorgeschlagenen Änderungen und Issues) haben, die durchsuchbar sind, bei denen Nachrichten und Themen durch URL adressiert werden, neue Personen an einigen der Diskussionen teilnehmen können und keine lokale Installation von proprietärer Software erfordern. [discussion]
    Beispiele für akzeptable Mechanismen umfassen archivierte Mailingliste(n), GitHub Issues und Pull-Request-Diskussionen, Bugzilla, Mantis und Trac. Asynchrone Diskussionsmechanismen (wie IRC) sind akzeptabel, wenn sie diese Kriterien erfüllen; Stellen Sie sicher, dass es einen URL-adressierbaren Archivierungsmechanismus gibt. Proprietäres JavaScript ist ungern gesehen, aber erlaubt.

    GitHub supports discussions on issues and pull requests. The repository is public with GitHub Issues enabled (and issue templates), GitHub Discussions enabled, and pull-request review threads — all URL-addressable, searchable and archived.



    Das Projekt SOLLTE Dokumentationen in englischer Sprache zur Verfügung stellen und in der Lage sein, Fehlerberichte und Kommentare zum Code in Englisch zu akzeptieren. [english]
    Englisch ist derzeit die Lingua Franca der Computertechnik; Wenn Englisch unterstützt wird, erhöht das die Anzahl der verschiedenen potenziellen Entwickler und Reviewer weltweit. Ein Projekt kann dieses Kriterium auch dann erfüllen, wenn die Hauptsprache der Kernentwickler nicht Englisch ist.

    All maintainer-facing material is in English: README.md, CONTRIBUTING.md, GOVERNANCE.md, SECURITY.md, SUPPORT.md, CODE_OF_CONDUCT.md, PRIVACY.md, the whole docs/ tree, issue and pull-request templates, and code comments. The end-user product UI is Spanish by design, since the platform targets Latin American government and organizational users.



    Das Projekt MUSS gepflegt werden. [maintained]
    Als Minimum sollte das Projekt versuchen, auf wichtige Problem- und Schwachstellenberichte zu reagieren. Ein Projekt, das aktiv ein Badge anstrebt, wird wahrscheinlich gepflegt. Alle Projekte und Menschen haben begrenzte Ressourcen, und typische Projekte müssen einige vorgeschlagene Änderungen ablehnen, daher deuten begrenzte Ressourcen und Ablehnungen von Vorschlägen allein nicht auf ein ungepflegtes Projekt hin.

    Wenn ein Projekt weiß, dass es nicht mehr gepflegt wird, sollte es dieses Kriterium auf "Unerfüllt" setzen und die entsprechenden Mechanismen verwenden, um anderen anzuzeigen, dass es nicht gepflegt wird. Verwenden Sie zum Beispiel "DEPRECATED" als erste Überschrift seiner README, fügen Sie "DEPRECATED" am Anfang seiner Homepage hinzu, fügen Sie "DEPRECATED" am Anfang der Projektbeschreibung seines Code-Repositorys hinzu, fügen Sie ein no-maintenance-intended Badge in seiner README und/oder Homepage hinzu, markieren Sie es als veraltet in allen Paket-Repositories (z. B. npm deprecate) und/oder verwenden Sie das Markierungssystem des Code-Repositorys, um es zu archivieren (z. B. GitHubs "archive"-Einstellung, GitLabs "archived"-Markierung, Gerrits "readonly"-Status oder SourceForges "abandoned"-Projektstatus). Weitere Diskussionen finden Sie hier.

    The project is actively maintained. 519 commits on main, the most recent release 1.6.0 published 2026-07-27, and eleven releases (1.1.1 through 1.6.0) since 2026-05. Commits and merged pull requests land continuously (PR #550 merged the day of this assessment). Maintainer responsibilities and merge/release authority are defined in https://github.com/undp/carbon-footprint-program/blob/main/GOVERNANCE.md.


 Verbesserungs-/Nacharbeits-Kontrolle 9/9

  • Öffentliches Versionskontroll-Source-Repository


    Das Projekt MUSS ein versiongesteuertes Quell-Repository haben, das öffentlich lesbar ist und eine URL hat. [repo_public]
    Die URL KANN die gleiche wie die Projekt-URL sein. Das Projekt KANN in bestimmten Fällen private (nichtöffentliche) Zweige verwenden, während die Änderung nicht öffentlich freigegeben wird (z. B. für die Behebung einer Sicherheitslücke, bevor sie veröffentlicht wird).

    Repository on GitHub, which provides public git repositories with URLs: https://github.com/undp/carbon-footprint-program (visibility: public).



    Das Quell-Repository des Projekts MUSS verfolgen, welche Änderungen vorgenommen wurden, wer die Änderungen vorgenommen hat und wann die Änderungen vorgenommen wurden. [repo_track]

    Repository on GitHub, which uses git. git records the author, committer and timestamp of every change, together with the full parent history.



    Um eine kollaborative Überprüfung zu ermöglichen, MUSS das Quell-Repository des Projekts Zwischenversionen für die Überprüfung zwischen Releases enthalten. Es DARF NICHT nur endgültige Veröffentlichungen enthalten. [repo_interim]
    Projekte DÜRFEN sich entscheiden, bestimmte Zwischenversionen aus ihren öffentlichen Quell-Repositories auszulassen (z.B. diejenigen, die bestimmte nicht-öffentliche Sicherheitslücken beheben, niemals öffentlich freigegeben werden können, oder Material enthalten, das nicht legal veröffentlicht werden kann und nicht in der endgültigen Version enthalten ist).

    Development happens in the open between releases: every change lands as a pull request merged to main, and those interim commits are public immediately rather than only at release time. 519 commits, 505 pull requests (425 of them merged) and 49 issues are publicly visible, and each release is cut from already-public main history rather than from a private branch.



    Es ist EMPFOHLEN, dass eine gemeinsame genutzte Versionskontrollsoftware (z.B. git oder mercurial) für das Source-Repository des Projekts verwendet wird. [repo_distributed]
    Git ist nicht speziell gefordert und Projekte können andere zentralisierte Versionskontrollsoftware (wie z. B. Subversion) mit Rechtfertigung verwenden.

    Repository on GitHub, which uses git. git is a distributed version control system.


  • Einzigartige Versionsnummerierung


    Die für Endbenutzer vorgesehenen Projektergebnisse MÜSSEN eine eindeutige Versionskennung für jede Freigabe haben. [version_unique]
    Dies DARF durch einer Vielzahl von Möglichkeiten, einschließlich einer Commit-IDs (wie z. B. gits Commit-ID oder mercurials Changeset-ID) oder eine Versionsnummer, (einschließlich Versionsnummern, die semantische oder datumsbasierte Systeme wie YYYYMMDD verwenden) erfüllt werden.

    Every release has a unique identifier: an annotated git tag and a matching GitHub Release (1.1.1, 1.1.2, 1.2.0, 1.3.0, 1.3.1, 1.3.2, 1.4.0, 1.4.1, 1.4.2, 1.5.0, 1.6.0) — see https://github.com/undp/carbon-footprint-program/releases. The canonical version lives in the root package.json, is baked into the Docker image tag, and is exposed at runtime through the APP_VERSION value returned by the API health endpoint.



    Es ist EMPFHOLEN, dass ein Semantic Versioning (SemVer) oder Calendar Versioning (CalVer) Versionsnummerierungsformat für Releases verwendet wird. Es ist EMPFHOLEN, dass Anwender des CalVer Formates auch die Micro Ebene mit angeben. [version_semver]
    Andere Versionsnummerierungsschemata, wie z. B. Commit-IDs (wie z. B. gits Commit-ID oder mercurials Changeset-ID) oder datumsbasierte Schemata wie YYYYMMDD, DÜRFEN als Versionsnummern verwendet werden, da sie eindeutig sind. Einige Alternativen können zu Problemen führen, denn die Benutzer können nicht leicht feststellen, ob sie aktuell sind. SemVer kann weniger hilfreich sein, um Software-Releases zu identifizieren, wenn alle Empfänger nur die neueste Version ausführen (z.B. ist es der Code für eine einzelne Website oder Internet-Service, der ständig durch kontinuierliche Updates aktualisiert wird).

    The project uses Semantic Versioning (MAJOR.MINOR.PATCH) and documents the increment rules at https://github.com/undp/carbon-footprint-program/blob/main/docs/release/versioning.md. The published tags follow SemVer (e.g. 1.4.1 → 1.4.2 for fixes, 1.5.0 → 1.6.0 for backward-compatible features).



    Es wird erwartet, dass Projekte jedes Release innerhalb ihres Versionskontrollsystems identifizieren. Zum Beispiel wird erwartet, dass die Projekte, die git verwenden, jedes Release mit git-Tags identifizieren. [version_tags]

    Each release is identified by a git tag with the exact version number, and the tag is what the GitHub Release points at: https://github.com/undp/carbon-footprint-program/tags.


  • Versionshinweise


    Das Projekt MUSS zu jedem Update Releasenotes enthalten, die eine lesbare Zusammenfassung der wichtigsten Änderungen der Version sind, damit Benutzer/innen sehen können, ob sie aktualisieren sollten und was die Auswirkungen des Updades sind. Die Releasenotes DÜRFEN NICHT die Rohausgabe eines Versionskontrollprotokolls sein (z. B. die "git log"-Befehlsergebnisse sind keine Releasenotes). Für Projekte, deren Ergebnisse nicht für die Wiederverwendung an mehreren Standorten bestimmt sind (z. B. die Software für eine einzelne Website oder Dienstleistung) und eine kontinuierliche Lieferung verwenden, können Sie "N/A" auswählen. (URL erforderlich) [release_notes]
    Die Releasenotes DÜRFEN auf vielfältige Weise implementiert werden. Viele Projekte bieten sie in einer Datei namens "NEWS", "CHANGELOG" oder "ChangeLog", optional mit Erweiterungen wie ".txt", ".md" oder ".html" an. Historisch bedeutete der Begriff "Change Log" ein Protokoll, in dem jede Änderung festgehalten wird, aber um diese Kriterien zu erfüllen, benötigt es eine menschlich lesbare Zusammenfassung. Die Releasenotes können stattdessen von Versionskontrollsystemmechanismen wie dem GitHub Release Workflow zur Verfügung gestellt werden.

    Every release publishes human-readable release notes as a GitHub Release: https://github.com/undp/carbon-footprint-program/releases. Each entry has a "What's Changed" summary grouped by area (e.g. "User Modules", infrastructure, dependencies) listing each merged change with its author and pull-request link — for example https://github.com/undp/carbon-footprint-program/releases/tag/1.6.0. Notes are provided for all eleven releases, 1.1.1 through 1.6.0.



    Die Releasenotes MÜSSEN jede öffentlich bekannte Laufzeit-Sicherheitslücke mit einer CVE-Zuweisung oder Ähnlichem kennzeichnen, die in der aktuellen veröffentlichten Version behoben sind. Dieses Kriterium darf als nicht anwendbar (N/A) markiert werden, wenn Benutzer typischerweise nicht selbst die Software aktualisieren. Diese Kirterium trifft nur auf die Projektergebnisse zu, nicht auf Abhängikeiten. Wenn keine Releasenotes vorhanden sind oder keine öffentlich bekannten Sicherheitslücken bekannt sind, wählen Sie (N/A). [release_notes_vulns]
    Dieses Kiterium hilft Benutzer zu verstehen ob ein Update eine bestimmte öffentlich bekannte Sicherheitslücke schließt, und zu entscheiden ob das Update eingespielt wird oder nicht. Wenn Benutzer die Software normalerweise nicht selbst auf ihren Computern aktualisieren können, sondern stattdessen auf eine/n Mittelsfrau/mann angewiesen sind, um das Upgrade durchzuführen (wie es bei einem Kernel und einer Low-Level-Software häufig der Fall ist), wählen Sie stattdessen "nicht anwendbar" (N/A), da diese zusätzliche Information für den Benutzer nicht hilfreich ist. Ein Projekt kann auch N/A auswählen wenn alle Empfänger nur die neuste Version benutzen (z. B. wenn der Code für eine einzelne Webseite oder Internetdienst ist der continuierlich mittels Contious Delivery geupdated wird). Diese Kriterium betrifft nur die Projektergenbisse, nicht seine Abhängigkeiten. Alle Sicherheitslücken für alle Abhängigkeiten eines Projektes aufzulisten ist unhandlich weil Abhängikeiten sich regelmäßig ändern könen; außerdem ist es unnötig weil Tools die sich auf die Analyse von Abhängikeiten spezialisieren das viel skalierbarer hin bekommen.

    No publicly known, CVE-assigned vulnerability in this project's own code has been fixed in any release to date, so there is nothing of that kind to enumerate. Dependency vulnerabilities are handled by Dependabot security updates, and the resulting pull requests appear by name in the "What's Changed" list of the release that includes them (see https://github.com/undp/carbon-footprint-program/releases). Should a vulnerability in the project's own code ever be fixed, SECURITY.md commits the maintainers to coordinated disclosure and the release notes will call it out.


 Berichterstattung 8/8

  • Bug-Report-Prozess


    Das Projekt muss einen Prozess für Benutzer enthalten, um Fehlerberichte zu senden (z. B. mit einem Issue-Tracker oder eine Mailing-Liste). (URL erforderlich) [report_process]

    The bug-reporting process is documented in three places: CONTRIBUTING.md "Reporting bugs & requesting features" https://github.com/undp/carbon-footprint-program/blob/main/CONTRIBUTING.md, .github/SUPPORT.md, which routes each kind of report to the right channel https://github.com/undp/carbon-footprint-program/blob/main/.github/SUPPORT.md, and structured issue forms at https://github.com/undp/carbon-footprint-program/issues/new/choose (bug report, feature request, refactor, DPG compliance). Security vulnerabilities are explicitly excluded from public issues and routed to the private process in https://github.com/undp/carbon-footprint-program/blob/main/SECURITY.md.



    Das Projekt SOLLTE einen Issue-Tracker für die Nachverfolgung einzelner Issues verwenden. [report_tracker]

    GitHub Issues is used as the issue tracker: https://github.com/undp/carbon-footprint-program/issues. It is backed by structured issue forms in .github/ISSUE_TEMPLATE/ (bug_report.yml, feature_request.yml, refactor.yml, dpg_compliance.yml) and a namespaced label taxonomy maintained as code in .github/labels.yml (type:, area:, priority:, status:), so reports are consistently classified and triaged.



    Das Projekt MUSS eine Mehrheit der in den letzten 2-12 Monaten eingereichten Fehlerberichte berücksichtigen; Die Antwort muss keine Korrektur enthalten. [report_responses]

    Bug reports are consistently acknowledged and acted on. Of the 49 issues filed in the last 12 months, 18 are already closed, and bugs are typically triaged within a day — for example issue #547 (equivalence computed in the wrong unit) was filed 2026-07-28 and fixed and closed 2026-07-29 by PR #550. Every incoming report is labelled (type:bug, area:, priority:, status:triage), which is the acknowledgement step, and priority:critical bugs such as #395 and #391 were closed with fixes. To date no report has been left unanswered.



    Das Projekt SOLLTE auf eine Mehrheit (>50%) der Verbesserungsvorschläge in den letzten 2-12 Monaten (einschließlich) reagieren. [enhancement_responses]
    Die Antwort DARF "nein" oder eine Diskussion über ihre Vorzüge sein. Das Ziel ist einfach, dass es einige Antworten auf einige Anfragen gibt, was darauf hinweist, dass das Projekt noch am Leben ist. Für die Zwecke dieses Kriteriums müssen die Projekte keine falschen Anfragen (z.B. von Spammern oder automatisierten Systemen) zählen. Wenn ein Projekt keine weiteren Verbesserungen vornimmt, wählen Sie bitte "Unerfüllt" und geben Sie die URL ein, die diesen Zustand den Benutzern klar macht. Wenn ein Projekt von der Anzahl der Verbesserungsvorschläge überwältigt wird, wählen Sie bitte "Unerfüllt" und erklären Sie die Situation.

    Enhancement requests are triaged the same way as bugs: they are labelled type:feature (or type:refactor / type:tech-debt), given an area and a priority, and either scheduled or answered in the thread. Several have been implemented and shipped — for example the "optional comment on approving a submission" request (PR #409, released in 1.6.0) and the provider-agnostic backend auth refactor (#398, closed 2026-07-09). Requests that conflict with the project's country-agnosticism principle are answered with that rationale, as documented in .github/SUPPORT.md.



    Das Projekt MUSS ein öffentlich zugängliches Archiv für Berichte und Antworten für die spätere Suche haben. (URL erforderlich) [report_archive]

    The issue tracker is public, searchable and permanently archived at https://github.com/undp/carbon-footprint-program/issues?q=is%3Aissue, covering both open and closed issues. Pull-request discussions are similarly public at https://github.com/undp/carbon-footprint-program/pulls?q=is%3Apr, and GitHub Discussions is enabled for longer-form threads.


  • Anfälligkeits-Prozessbericht


    Das Projekt MUSS den Prozess für die Meldung von Schwachstellen auf der Projektseite veröffentlichen. (URL erforderlich) [vulnerability_report_process]
    z.B., eine klar benannte Mailing-Adresse auf https://PROJECTSITE/security, oft in der Form security@example.org. Dies KANN die gleiche sein wie die für den Fehlerberichtsprozess. Informationen über Schwachstellen können immer öffentlich sein, aber viele Projekte verfügen über einen privaten Schwachstellen-Berichtsmechanismus.

    The vulnerability reporting process is published in https://github.com/undp/carbon-footprint-program/blob/main/SECURITY.md. The declared security contact is the maintainer team collectively — the @undp/carbon-footprint-program-maintainers GitHub team (see https://github.com/undp/carbon-footprint-program/blob/main/.github/CODEOWNERS and https://github.com/undp/carbon-footprint-program/blob/main/GOVERNANCE.md) — so handling a report never depends on one individual's availability. SECURITY.md states that vulnerabilities must not be reported through public issues, discussions or pull requests, names GitHub private vulnerability reporting as the private channel, tells a reporter who cannot use it to open a detail-free issue requesting a private channel, and gives an escalation path to the maintainer team after 5 business days. It also lists what to include in a report and the in-scope and out-of-scope components.



    Falls das Projekt einen Kanal zur Übertragung von Schwachstellen besitzt, dann MUSS diese Informationsübertragung privat ablaufen. (URL erforderlich) [vulnerability_report_private]
    Beispiele hierfür sind ein privater Defektbericht, der im Internet über HTTPS (TLS) oder eine mit OpenPGP verschlüsselte E-Mail verschickt wird. Wenn die Informationsübertragung von Schwachstellen immer öffentlich sind (also gibt es niemals private Informationsübertragung von Schwachstellen), wählen Sie "nicht anwendbar" (N/A).

    Private reporting is available through GitHub Private Vulnerability Reporting, which is enabled on the repository and reachable from the Security tab at https://github.com/undp/carbon-footprint-program/security/advisories. It is documented as the preferred channel in https://github.com/undp/carbon-footprint-program/blob/main/SECURITY.md. Reports go privately to the maintainer team collectively (@undp/carbon-footprint-program-maintainers) rather than to a named individual, which keeps the report, the discussion, the fix and any resulting advisory in one private place with no single point of failure. SECURITY.md explicitly asks reporters not to use public issues, discussions or pull requests, and offers a detail-free public issue as a way to request a private channel for anyone who cannot use GitHub PVR.



    Das Projekts MUSS mindestens binnen 14 Tagen, auf jeden in den letzten 6 Monaten erhaltenen Anfälligkeitsbericht, reagieren. [vulnerability_report_response]
    Wenn in den letzten 6 Monaten keine Schwachstellen gemeldet wurden, wählen Sie "nicht anwendbar" (N/A).

    https://github.com/undp/carbon-footprint-program/blob/main/SECURITY.md publishes the maintainer team's commitment to acknowledge a vulnerability report within 3 business days — well inside the 14-day requirement — and tells reporters to escalate to the maintainer team if they have not heard back within 5 business days. It further commits to validating the issue, agreeing a remediation timeline with the reporter, and practising coordinated disclosure with credit unless the reporter prefers anonymity. In the interest of accuracy: this is the maintainer team's published working target, and formal ratification of the acknowledgement and remediation SLAs by UNDP as the owning organization is still in progress (tracked in issue #460).


 Qualität 13/13

  • Produktivsystem


    Falls die vom Projekt entwickelte Software vor Benutzung kompiliert werden muss, MUSS das Projekt ein funktionierendes Buildsystem bereitstellen, das den Quellcode automatisch in Software übersetzt. [build]
    Ein Build-System bestimmt, welche Aktionen durchgeführt werden müssen, um die Software neu zu bauen (und in welcher Reihenfolge) und führt dann diese Schritte aus. Zum Beispiel kann es einen Compiler aufrufen, um den Quellcode zu kompilieren. Wenn eine ausführbare Datei aus dem Quellcode erstellt wird, muss es möglich sein, den Quellcode des Projekts zu ändern und dann eine aktualisierte ausführbare Datei mit diesen Modifikationen zu erzeugen. Wenn die vom Projekt produzierte Software von externen Bibliotheken abhängt, muss das Build-System diese externen Bibliotheken nicht bauen. Wenn es keine Notwendigkeit gibt, irgendetwas zu bauen, um die Software zu verwenden, nachdem ihr Quellcode geändert wurde, wählen Sie "nicht anwendbar" (N/A).

    The software is built from source with two standard commands: "pnpm install" then "pnpm build". The root package.json "build" script drives Turborepo, which builds the shared packages (@repo/types, constants, utils, database, storage), the Fastify API and the React/Vite web app in dependency order. Prerequisites and exact toolchain versions are pinned in .tool-versions and .nvmrc and documented in https://github.com/undp/carbon-footprint-program/blob/main/docs/development/local-setup.md. CI proves the build works from a clean checkout on every pull request via the required "Build" job in .github/workflows/ci.yml.



    Es ist EMPFHOLEN, dass gewöhnliche Werkzeuge zum Kompilieren von Software benutzt wird. [build_common_tools]
    Beispielsweise, Maven, Ant, cmake, die Autotools, make, rake (Ruby) oder devtools (R).

    The build uses widely available, conventional tooling: Node.js, pnpm (workspaces), Turborepo, the TypeScript compiler (tsc), Vite for the web bundle, Prisma for schema/client generation, and Docker for containerization. There are no bespoke build tools to learn.



    Das Projekt SOLLTE allein mit FLOSS-Werkzeugen gebaut werden können. [build_floss_tools]

    Every tool required to build the project is FLOSS: Node.js, pnpm, Turborepo, TypeScript, Vite, Prisma, ESLint, Prettier, Vitest and Docker. The project can be built and tested end to end on a FLOSS platform with no proprietary software; a docker-compose setup provides Postgres, Keycloak and MinIO as open-source local dependencies.


  • Automatisierte Test-Suite


    Das Projekt MUSS mindestens eine automatisierte Test-Suite verwenden, die öffentlich als FLOSS veröffentlicht wird (diese Test-Suite kann als separates FLOSS-Projekt gepflegt werden). Das Project MUSS verständlich zeigen oder dokumentieren, wie die Test-Suite ausgeführt wird (z. B. durch ein Continuous Integration (CI) Script oder als Dokumentation in Dateien, wie z. B. BUILD.md, README.md oder CONTRIBUTING.md). [test]
    Das Projekt KANN mehrere automatisierte Test-Suiten benutzen (z. B. eine, die schnell läuft, eine andere, die gründlicher ist, aber spezielle Ausrüstung erfordert). Es gibt viele Test-Frameworks und Systeme die Tests unterstützten, einschließlich Selenium (web browser automation), Junit (JVM, Java), RUnit (R), testthat (R).

    The project has an automated test suite documented at https://github.com/undp/carbon-footprint-program/blob/main/docs/development/testing.md. apps/api has 199 test files, of which 161 are integration tests that exercise real HTTP routes through Fastify's app.inject() against a real PostgreSQL instance provisioned with Testcontainers (plus Azurite and MinIO for the storage legs). apps/web adds 37 Vitest suites running under jsdom with React Testing Library. tools/seed has its own unit suite. The whole suite runs in CI on every pull request.



    Eine Test-Suite SOLLTE in einer üblichen Weise für diese Programmiersprache aufrufbar sein. [test_invocation]
    Zum Beispiel, "make check", "mvn test", oder "rake test" (Ruby).

    The suite runs with the standard single command "pnpm test" from the repository root (Turborepo fans it out to every workspace). Narrower entry points exist for convenience: "pnpm test:api", "pnpm test:web", "pnpm test:seed", and "pnpm test:api -- /<feature>" for a single feature.



    Es wird erwartet, dass die Test-Suite die meisten (oder idealerweise alle) Code-Zweige, Eingabefelder und Funktionalitäten abdeckt. [test_most]

    The test suite covers most of the code and most of the functionality. apps/api — which holds essentially all of the business logic, including emission calculations, authorization, and the data layer — is gated in CI at 90% coverage for lines, statements, functions and branches, merged across the three test legs by the required "Coverage" job in .github/workflows/ci.yml. That gate is enforced on every pull request, so the figure is a floor rather than a snapshot, and every externally reachable endpoint has an integration test (161 integration test files exercising real HTTP routes against a real PostgreSQL instance via Testcontainers). Stated transparently: apps/web is covered by a smaller Vitest + jsdom + React Testing Library suite (37 files) over its logic layers — utils, hooks, stores, chatbot — behind an enforced floor that is deliberately ratcheted upward as tests are added, so a share of its render-heavy UI is not yet covered. The judgement recorded here is that a 90%-gated backend plus a growing frontend suite satisfies "most".



    Es wird erwartet, dass das Projekt eine kontinuierliche Integration durchführt (wo neuer oder geänderter Code häufig in ein zentrales Code-Repository integriert wird und automatisierte Tests auf diesen Ergebnissen durchgeführt werden). [test_continuous_integration]

    Continuous integration runs the full suite on every pull request to main via .github/workflows/ci.yml. "Test (base)", "Test (storage-azure)", "Test (storage-minio)", "Test (web)", "Seed Unit Tests" and "Coverage" are required status checks under branch protection, alongside Lint, Type Check, Format Check, Build, Audit, Zizmor, Secret Scan and Docs Link Check. See https://github.com/undp/carbon-footprint-program/actions/workflows/ci.yml.


  • Neue Funktionalitätsüberprüfung


    Das Projekt MUSS allgemeine Grundregeln (formal oder nicht) haben, die als wesentliche neue Funktionalität der Software des Projektes hinzugefügt werden. Tests dieser Funktionalität sollten zu einer automatisierten Test-Suite hinzugefügt werden. [test_policy]
    Solange Grundregeln vorhanden sind, selbst wenn durch Mundpropaganda, sollten die Entwickler/innen Tests für die automatisierte Test-Suite für große neue Funktionalität hinzufügen, wählen Sie "Met".

    The policy is written down in CONTRIBUTING.md under "Contribution acceptance criteria": "Test coverage — new features include integration tests" https://github.com/undp/carbon-footprint-program/blob/main/CONTRIBUTING.md#contribution-acceptance-criteria. docs/development/testing.md gives the concrete conventions for writing them, and the policy is mechanically enforced by the 90% merged-coverage gate in CI, which fails a pull request that adds logic without adding tests.



    Das Projekt MUSS nachweisen, dass die test_policy für das Hinzufügen von Tests in den jüngsten großen Änderungen an der Projektsoftware eingehalten wurde. [tests_are_added]
    Wichtige Funktionalitäten würden typischerweise in den Patchnotes erwähnt. Perfektion ist nicht erforderlich, nur Beweise dafür, dass Tests in der Praxis in der Regel der automatisierten Test-Suite hinzugefügt werden, wenn neue Hauptfunktionalität der Projektsoftware hinzugefügt wird.

    Tests accompany functional changes as a matter of course — apps/api currently carries 199 test files across 161 integration suites, grown alongside the features they cover, and apps/web has 37. The requirement is enforced rather than merely encouraged: the required "Coverage" check re-computes merged coverage across all three test legs and fails below 90% on lines, statements, functions and branches, so a feature pull request without matching tests cannot merge. Recent examples of test-only ratchets are PRs #509, #515 and #518.



    Es wird erwartet, dass diese Richtlinien zum Hinzufügen von Tests (siehe test_policy ) in den Anweisungen für Änderungsvorschläge dokumentiert werden. [tests_documented_added]
    Allerdings ist auch eine informelle Regel akzeptabel, solange die Tests in der Praxis hinzugefügt werden.

    The policy is documented in two places: the "Contribution acceptance criteria" section of https://github.com/undp/carbon-footprint-program/blob/main/CONTRIBUTING.md, and the testing guide at https://github.com/undp/carbon-footprint-program/blob/main/docs/development/testing.md, which explains the Vitest + Testcontainers setup, the app.inject() pattern, and the factory helpers a contributor should use when adding tests.


  • Warnhinweise


    Das Projekt MUSS einen oder mehrere Compiler-Warn-Flags, einen "sicheren" Sprachmodus oder ein separates "Linter" -Tool verwenden, um nach qualitativen Fehlern im Code oder gängigen einfachen Fehlern zu suchen, wenn es mindestens ein FLOSS-Tool gibt, das dieses Kriterium implementieren kann in der gewählten sprache [warnings]
    Beispiele für Compiler-Warn-Flags sind gcc / clang "-Wall". Beispiele für einen "sicheren" Sprachmodus beinhalten JavaScript "use strict" und perl5's "use warnings". Ein separates "Linter" -Tool ist einfach ein Werkzeug, das den Quellcode untersucht, um nach qualitativen Fehlern im Code oder gängigen einfachen Fehlern zu suchen. Diese werden in der Regel im Quellcode aktiviert oder in den Einstellungen.

    Compiler and linter warnings are enabled at a strict level. TypeScript runs with "strict": true (packages/typescript-config/base.json), and ESLint uses typescript-eslint's recommendedTypeChecked configuration (packages/eslint-config/base.ts), which requires full type information and therefore reports type-aware problems, not just syntactic ones. Both run over the whole monorepo via "pnpm lint" and "pnpm type-check".



    Das Projekt MUSS auf Warnungen reagieren. [warnings_fixed]
    Dies sind die Warnungen, die durch die Umsetzung des warnings Kriteriums identifiziert wurden. Das Projekt sollte Warnungen beheben oder im Quellcode als falsch positives Ergebnis markieren. Idealerweise gibt es keine Warnungen, aber ein Projekt DARF einige Warnungen akzeptieren (typischerweise weniger als 1 Warnung pro 100 Zeilen oder weniger als 10 Warnungen).

    There are no outstanding warnings, and the build enforces that: "pnpm lint" is invoked as "turbo run lint -- --max-warnings=0", so a single ESLint warning fails the required "Lint" status check, and "pnpm type-check" fails the required "Type Check" check on any TypeScript error. Both are required checks under branch protection, so warnings cannot accumulate on main.



    Es wird erwartet, dass Projekte Warnungen in der Software, die durch das Projekt produziert wird, sorgfältig berücksichtigen. [warnings_strict]
    Bei manchen Projekten können einige Warnungen effektiv nicht aktiviert werden. Was benötigt wird, ist ein Beleg dafür, dass das Projekt danach strebt, Warnungen zu aktivieren, wo es möglich ist, so dass Fehler frühzeitig erkannt werden.

    Maximally strict settings are enabled rather than the defaults: TypeScript "strict": true, and typescript-eslint's recommendedTypeChecked ruleset, which needs a full type-checked program and catches classes of bug (unsafe any flow, floating promises, unnecessary conditionals) that non-type-aware linting cannot see. Prettier formatting is separately enforced by a required "Format Check" job.


 Sicherheit 16/16

  • Wissen über sichere Entwicklungspraktiken


    Das Projekt MUSS mindestens einen primären Entwickler haben, der weiß, wie man sichere Software entwerfen kann. (Siehe "Details" für spezifische Anforderungen.) [know_secure_design]
    Dies erfordert das Verständnis der folgenden Designprinzipien, einschließlich der 8 Prinzipien von Saltzer und Schroeder:
    • Wirtschaftlichkeit des Mechanismus (halten Sie das Design so einfach und klein wie möglich, z. B. durch umfassende Vereinfachungen)
    • Fehlersichere Voreinstellungen (Zugriffsentscheidungen sollten standardmäßig verweigert werden und die Installation der Projekte sollte standardmäßig sicher sein)
    • Vollständige Vermittlung (jeder Zugang, der begrenzt werden kann, muss auf Berechtigungen überprüft werden und darf nicht umgangen werden können)
    • Offenes Design (Sicherheitsmechanismen sollten nicht von der Unkenntnis der Angreifer über das Designs abhängig gemacht werden, sondern stattdessen auf leichter schützbare und änderbare Informationen wie Schlüssel und Passwörter)
    • Trennung von Privilegien (Idealerweise sollte der Zugriff auf wichtige Objekte von mehr als einer Bedingung abhängen, so dass die Beseitigung eines Schutzsystems keinen vollständigen Zugriff ermöglicht. z. B., Multi-Faktor-Authentifizierung wie die Erfordernis eines Passwortes und eines Hardware-Token ist stärker als die Single-Faktor-Authentifizierung)
    • So wenige Privilegien wie möglich (Prozesse sollten nur mit den geringsten Privilegien laufen)
    • So wenig gemeinsame Mechanismen wie möglich (Das Design sollte die Mechanismen minimieren, die von mehreren Benutzern gemeinsam verwendet werden und von allen Benutzern abhängig sind, z.B. Verzeichnisse für temporäre Dateien)
    • Psychologische Akzeptanz (Die menschliche Schnittstelle muss benutzerfreundlich entworfen werden - Design für "geringeste Überraschung" kann dabei helfen)
    • Begrenzte Angriffsfläche (die Angriffsfläche - die Menge der verschiedenen Punkte, wo ein Angreifer versuchen kann, Daten einzugeben oder zu extrahieren - sollte begrenzt sein)
    • Eingabevalidierung mit Positivliste (Eingaben sollten in der Regel überprüft werden, um festzustellen, ob sie gültig sind, bevor sie akzeptiert werden; diese Validierung sollte Postitivlisten verwenden (die nur bekannte gute Werte akzeptieren), nicht Negativlisten (die versuchen, bekannte schlechte Werte aufzulisten)).
    Ein "Primärer Entwickler" in einem Projekt ist jedermann, der mit der Codebasis des Projekts vertraut ist, der in der Lage ist Änderungen daran vorzunehmen und von den meisten anderen Teilnehmern des Projekts als solches anerkannt wird. Ein primärer Entwickler hat üblicherweise im vergangen Jahr eine Reihe von Aufgaben übernommen (Code, Dokumentation oder Beantwortung von Fragen). Die Entwickler würden typischerweise als primäre Entwickler betrachtet, wenn sie das Projekt initiiert haben (und das Projekt nicht vor mehr als drei Jahre verlassen haben), die Möglichkeit haben, Informationen zu Schwachstellen über einen privaten Berichtskanal zu erhalten (falls vorhanden), neuen Code zum Projekt entgegennehmen zu können, oder die endgültige Freigaben der Projektsoftware durchzuführen. Wenn es nur einen Entwickler gibt, ist diese Person der primäre Entwickler. Es gibt viele Bücher und Kurse die Wissen vermitteln,wie sichere Software entwickelt und entworfen werden kann. Zum Beispiel bietet der kostenlose Kurs Secure Software Development Fundamentals drei Module an, die erklären wie man sichere Software entwickelt.

    The maintainer team collectively (@undp/carbon-footprint-program-maintainers — see https://github.com/undp/carbon-footprint-program/blob/main/.github/CODEOWNERS and https://github.com/undp/carbon-footprint-program/blob/main/GOVERNANCE.md) holds and applies the knowledge of how to design secure software; this is asserted for the team rather than for one individual, matching how the project is actually governed and reviewed. The design record is public under docs/security/ https://github.com/undp/carbon-footprint-program/tree/main/docs/security: authentication.md (OIDC/JWKS token verification), rbac.md and route-access-modes.md (role-based authorization applied per route), hardening.md (deployment topologies, TLS enforcement, HTTP security headers, input validation, upload controls), secrets.md (Azure Key Vault with managed identities, no credentials in code), sensitive-data.md, audit-logging.md, and github-actions-security.md. The principles are visible in the code, not just the docs: least privilege via per-route role guards; fail-closed defaults — the API refuses to boot in production unless JWKS_URI, JWKS_ISSUER and JWKS_AUDIENCE are set, rather than silently accepting tokens it cannot bind to this application (apps/api/src/config/environment.ts); defense in depth (helmet headers, then schema validation, then authorization, then audit logging); minimal attack surface; and no trust in client-supplied identity. CONTRIBUTING.md requires an explicit maintainer security review for any change to auth, authorization, file upload or database queries, which is how the knowledge is applied structurally rather than incidentally. Complementary documents are SECURITY.md and PRIVACY.md.



    Mindestens einer der primären Entwickler des Projekts MUSS über weitläufige Arten von Fehlern, die zu Schwachstellen in dieser Art von Software führen, Bescheid wissen sowie mindestens eine Methode, um jede von ihnen zu beseitigen oder zu mildern. [know_common_errors]
    Beispiele (je nach Art der Software) beinhalten SQL-Injektion, OS-Injektion, klassischer Pufferüberlauf, Cross-Site-Scripting, fehlende Authentifizierung und fehlende Autorisierung. Siehe die CWE/SANS top 25 oder OWASP Top 10 für häufig verwendete Listen. Es gibt viele Bücher und Kurse die Wissen vermitteln,wie sichere Software entwickelt und entworfen werden kann. Zum Beispiel bietet der kostenlose Kurs Secure Software Development Fundamentals drei Module an, die erklären wie man sichere Software entwickelt.

    The maintainer team collectively (@undp/carbon-footprint-program-maintainers) holds this knowledge, and the codebase reflects it. Injection: all database access goes through Prisma's parameterized query builder; there is no string-concatenated SQL. Input validation: every request body, query and parameter is validated against a Zod schema at the route boundary (schemas live in packages/types), so unvalidated input never reaches business logic. Broken access control: authorization is enforced server-side by explicit requireAuth / requireRoles / requireOrganizationRole hooks per route, documented in docs/security/rbac.md and route-access-modes.md and covered by integration tests. XSS and header attacks: @fastify/helmet applies secure headers globally and React escapes by default. Insecure direct object references: domain access hooks verify organization membership before returning records. Secrets in code: Azure Key Vault with managed identities, plus GitHub secret scanning with push protection and a betterleaks CI gate over full git history. Race conditions and partial writes: multi-step mutations run inside Prisma transactions. These classes are also checked mechanically by CodeQL's security-and-quality suite on every push and pull request. The team also files its own hardening findings publicly rather than leaving them implicit — see issue #559, which pins an explicit JWT algorithms allowlist to close an algorithm-confusion surface found while preparing this badge.


  • Verwende grundlegend gute kryptographische Praktiken

    Beachten Sie, dass einige Software keine kryptographischen Mechanismen verwenden muss. Wenn Ihr Project Software erstellt das (1) kryptographische funktionen einbindet, aktiviert, oder ermöglicht und (2) aus den USA heraus an nicht US-Bürger verteilt wird, dann könnten sie rechtlich zu weiterne Schritten gezwungen sein. Meistens beinhaltet dies lediglich das Senden einer E-Mail. Für mehr Informationen, siehe den Abschnitt zu Encryption in Understanding Open Source Technology & US Export Controls.

    Die vom Projekt entwickelte Software MUSS standardmäßig nur kryptografische Protokolle und Algorithmen verwenden, die öffentlich sind und von Experten überprüft wurden (falls kryptographische Protokolle und Algorithmen verwendet werden). [crypto_published]
    Diese kryptographischen Kriterien gelten nicht immer, da einige Software keine direkten kryptografischen Funktionen benötigt.

    The project uses only standard, published cryptographic protocols and algorithms: TLS 1.2+ for all transport, RSA/ECDSA signature verification of OIDC JWTs via JWKS (@fastify/jwt with jwks-rsa), SHA-2 family digests, and AES-256 for encryption at rest in Azure Storage. No proprietary or homegrown cryptography is used or implemented.



    Wenn die Software, die durch das Projekt produziert wird, eine Anwendung oder Bibliothek ist, und ihr Hauptzweck nicht die Kryptographie ist, dann SOLLTE sie lediglich Software einbinden, die speziell für kryptographische Funktionen entworfen ist; Sie SOLLTE NICHT eine eigene Implementierung vornehmen. [crypto_call]

    The project does not implement cryptography itself; it calls established, well-reviewed implementations: Node.js node:crypto (OpenSSL) for random values, @fastify/jwt and jwks-rsa for JWT signature verification and key retrieval, and the platform TLS stacks of Azure Front Door, App Service and Static Web Apps for transport. Password handling is delegated entirely to the external OIDC identity provider.



    Alle Funktionalitäten in der vom Projekt entwickelten Software, die von Kryptographie abhängigen, MÜSSEN mit FLOSS implementiert werden. [crypto_floss]

    All cryptographic functionality relies on FLOSS implementations: Node.js and its bundled OpenSSL, @fastify/jwt (MIT), jwks-rsa (MIT), and — in the fully open local/self-hosted configuration — Keycloak as the OIDC provider and MinIO for object storage. No proprietary crypto implementation is required to run the software.



    Die Sicherheitsmechanismen innerhalb der vom Projekt entwickelten Software, MÜSSEN Standard-Keylängen verwenden, die die NIST-Mindestanforderungen bis zum Jahr 2030 erfüllen (wie im Jahr 2012 festgelegt). Es MUSS möglich sein, die Software so zu konfigurieren, dass kürzere Keylängen vollständig deaktiviert werden können. [crypto_keylength]
    Diese minimalen Bitlängen sind: symmetric key 112, factoring modulus 2048, discrete logarithm key 224, discrete logarithmic group 2048, elliptic curve 224, und hash 224 (das Passworthashing ist nicht von dieser Bitlänge abgedeckt, weitere Informationen zum Passworthashing finden sich im crypto_password_storage Kriterium). Siehe https://www.keylength.com für einen Vergleich von Keylängen Empfehlungen von verschiedenen Organisationen. Die Software KANN kleinere Keylängen in einigen Konfigurationen erlauben (idealerweise nicht, da dies Downgrade-Angriffe erlaubt, aber kürzere Keylängen sind manchmal für die Interoperabilität notwendig).

    All default key lengths meet or exceed the NIST minimums, and the application never generates its own long-term asymmetric keys — every key it relies on is issued by a platform service or the identity provider. TLS certificates are issued and managed by the Azure services that terminate TLS (Static Web Apps for the frontend and App Service for the API; Azure Front Door additionally where an adopting country chooses to deploy it), using 2048-bit RSA or ECDSA P-256 keys; minTlsVersion is pinned to 1.2 in the Bicep templates, so only suites with 128-bit-or-better symmetric keys are negotiated. OIDC token-signing keys are fetched from the provider's JWKS endpoint: the demo environment uses Microsoft Entra ID, which signs with RSA-2048, and Keycloak — the open-source option documented for self-hosting — also defaults to RSA-2048. Encryption at rest in Azure Storage is AES-256. Symmetric secrets the project does control (cookie signing) are supplied from Azure Key Vault, never from a checked-in default.



    Die Standard-Sicherheitsmechanismen innerhalb der vom Projekt entwickelten Software DÜRFEN NICHT von defekten kryptographischen Algorithmen abhängen (z.B. MD4, MD5, Single DES, RC4, Dual_EC_DRBG) oder Chiffre-Modi verwenden, die dem Kontext unangemessen sind, außer sie sind notwendig, um kompatible Protokolle bereitzustellen (wenn das Protokoll in der neusten Version in der Zielumgebung zum Einsatz kommt, die Zielumgebung solch ein Protokoll erfordert und das Zielsystem keine sicherere Alternative anbietet). Die Dokumentation MUSS auf jegliche Sicherheitsrisiken hinweisen und bekannte Vorsichtsmaßnahmen beschreiben, sollten unsichere Protokolle unumgäglich sein. [crypto_working]
    Der EZB-Modus ist fast nie angemessen, da er identische Blöcke innerhalb des Geheimtextes aufdeckt, wie der ECB-Pinguin zeigt. Der CTR-Modus ist oft unangemessen, da er keine Authentifizierung durchführt und Duplikate verursacht, wenn eine Eingabe wiederholt wird. In vielen Fällen ist es am besten, einen Block-Chiffre-Algorithmus-Modus zu wählen, der entworfen wurde, um Geheimhaltung und Authentifizierung zu kombinieren, z.B. Galois/ Counter Mode (GCM) und EAX. Projekte KÖNNTEN Benutzern erlauben, defekte Mechanismen zu ermöglichen (z. B. während der Einrichtung), falls nötig für Kompatibilität, aber dann wissen die Benutzer, dass sie es tun.

    The default configuration uses no broken or known-weak cryptographic algorithm or mode. TLS is pinned to a 1.2 minimum at every tier (infra/modules/appService.bicep, storage.bicep, frontDoor.bicep), excluding SSLv3, TLS 1.0 and 1.1 and their weak suites. MD5, SHA-1, DES, 3DES, RC4 and ECB mode are not used anywhere in the codebase; digests are SHA-2 family. Token signatures are verified against asymmetric public keys fetched from the identity provider's JWKS endpoint, and in production the API refuses to boot unless JWKS_URI, JWKS_ISSUER and JWKS_AUDIENCE are all set, so a token whose issuer or audience does not bind to this application is rejected (apps/api/src/config/environment.ts). Stated precisely rather than generously: the verify options pin issuer and audience but do not yet pin an explicit "algorithms" allowlist, so the accepted signature-algorithm set is currently inherited from the JWT library's key-type inference rather than asserted by the project. No broken algorithm is reachable, but that guarantee should be ours and not a dependency default — it is tracked publicly as a hardening item in issue #559 https://github.com/undp/carbon-footprint-program/issues/559.



    Die Standard-Sicherheitsmechanismen innerhalb der vom Projekt entwickelten Software SOLLTEN NICHT nicht von kryptographischen Algorithmen oder Modi mit bekannten schweren Schwächen abhängen (z.B. SHA-1-Kryptographie-Hash-Algorithmus oder CBC-Modus in SSH). [crypto_weaknesses]
    Sorgen über den CBC-Modus in SSH werden in CERT: SSH CBC vulnerability erläutert.

    The default configuration does not depend on cryptographically broken primitives. MD5, SHA-1, DES, 3DES and RC4 are not used for any security purpose; digests are SHA-2 family, and TLS 1.2+ enforcement excludes SHA-1-signed handshake suites. Container base images and dependencies are pinned by SHA-256 digest, and pnpm verifies package integrity with SHA-512 hashes.



    Die Sicherheitsmechanismen innerhalb der vom Projekt entwickelten Software SOLLTEN Perfect Forward Secrecy für wichtige Vereinbarungsprotokolle implementieren, so dass ein Sitzungsschlüssel, der aus einer Reihe von Langzeitschlüsseln abgeleitet wird, nicht beeinträchtigt werden kann, wenn einer der Langzeitschlüssel in der Zukunft kompromittiert wird. [crypto_pfs]

    Forward secrecy is provided by the Azure platform services that terminate TLS; the application implements no TLS itself and ships no certificate or cipher-suite configuration. In the default topology TLS terminates at Azure Static Web Apps (frontend) and Azure App Service (API, which faces the public internet directly in the demo environment); an adopting country may additionally place Azure Front Door in front, which is optional per deployment rather than required by the platform. All of these negotiate TLS 1.2+ with ECDHE (ephemeral Diffie-Hellman) key exchange, which gives perfect forward secrecy, and the Bicep templates pin minTlsVersion to 1.2 so no non-PFS legacy suite can be selected. Because Front Door is optional, this property does not depend on it — it holds in every supported topology. See docs/security/hardening.md, "Deployment topology" and "Transport Security".



    Wenn die vom Projekt erzeugte Software Passwörter für die Authentifizierung von externen Benutzern speichert, MÜSSEN die Passwörter als iterierte Hashes mit einem per-User-Salt unter Verwendung eines Key-Stretching (iterierten) Algorithmus (z.B. Argon2id, Bcrypt, Scrypt, or PBKDF2). Siehe auch OWASP Password Storage Cheat Sheet). [crypto_password_storage]
    Dieses Kriterium gilt nur, wenn die Software die Authentifizierung von externan Benutzern mit Passwörtern erzwingt (inbound authentication), wie z. B. bei serverseitigen Webanwendungen. Es gilt nicht in Fällen, in denen die Software Kennwörter für die Authentifizierung in andere Systeme speichert (outbound authentication, z. B. die Software implementiert einen Client für ein anderes System), da zumindest Teile dieser Software oft Zugriff auf das Passwort im Klartext haben müssen.

    The project does not store passwords for authentication of external users, so there is nothing to hash or salt. Authentication is delegated entirely to an external OpenID Connect identity provider (Microsoft Entra ID in the reference deployment, Keycloak in the open-source/local configuration). The API only verifies signed JWTs against the provider JWKS and never sees, transmits or persists a user credential; there is no local password table, reset flow, or credential column in the Prisma schema. See docs/security/authentication.md.



    Die Sicherheitsmechanismen innerhalb der vom Projekt entwickelten Software MÜSSEN alle kryptographischen Schlüssel und Nonces mit einem kryptographisch sicheren Zufallszahlengenerator erzeugen und DÜRFEN NICHT mit Generatoren arbeiten, die kryptographisch unsicher sind. [crypto_random]
    Ein kryptographisch sicherer Zufallszahlengenerator kann ein Hardware-Zufallszahlengenerator sein oder es kann ein kryptographisch sicherer Pseudozufallszahlengenerator (CSPRNG) sein, der einen Algorithmus wie Hash_DRBG, HMAC_DRBG, CTR_DRBG, Yarrow oder Fortuna verwendet. Beispiele für Aufrufe von sicheren Zufallszahlengeneratoren umfassen Javas java.security.SecureRandom und JavaScripts window.crypto.getRandomValues. Beispiele für Anrufe von unsicheren Zufallszahlengeneratoren sind Javas java.util.Random und JavaScripts Math.random.

    All security-relevant random values come from a cryptographically secure PRNG: the project uses randomUUID() from Node.js node:crypto (backed by OpenSSL) for request identifiers (apps/api/src/app.ts), chatbot session identifiers, and the opaque UUIDs that name uploaded objects in storage (apps/api/src/features/files/requestUpload/service.ts and the carbon-inventory line-file equivalent). Math.random() is not used for any security purpose. Session and token generation itself is handled by the external OIDC provider.


  • Gesicherte Zustellung gegen Man-in-the-Middle-/MITM-Angriffe


    Das Projekt MUSS einen Auslieferungsmechanismus verwenden, der den MITM-Angriffen entgegenwirkt. Die Verwendung von https oder ssh + scp ist akzeptabel. [delivery_mitm]
    Ein noch stärkerer Mechanismus ist die Freigabe der Software mit digital signierten Paketen, da dies Angriffe auf das Verteilungssystem verringert, aber das funktioniert nur, wenn die Benutzer sicher sein können, dass die öffentlichen Schlüssel für Signaturen korrekt sind und wenn die Benutzer die Signatur tatsächlich überprüfen.

    Distribution channels use HTTPS exclusively. Source is distributed by GitHub over HTTPS or SSH, so the transport is authenticated and integrity-protected. Dependencies are installed from the registry over HTTPS with "pnpm install --frozen-lockfile", and pnpm-lock.yaml records an integrity hash for every package. Container base images are pinned by SHA-256 digest, and all GitHub Actions are pinned to full commit SHAs rather than mutable tags, so the CI supply chain cannot be silently redirected.



    Ein kryptographischer Hash (z.B. sha1sum) DARF NICHT über http abgerufen und ohne Überprüfung einer kryptographischen Signatur verwendet werden. [delivery_unsigned]
    Diese Hashes könnten bei der Übermittlung verändert werden.

    No cryptographic hash or signature is retrieved over an unprotected channel. Package integrity hashes are committed in pnpm-lock.yaml inside the repository itself and fetched from the registry only over HTTPS; container base-image digests are committed in the Dockerfiles; GitHub Action versions are committed as full commit SHAs. Nothing in the build downloads a checksum over plain HTTP or from an untrusted mirror.


  • Öffentlich bekannte Schwachstellen wurden behoben


    Es DARF KEINE ungepatchte Schwachstelle von mittlerer oder höherer Schwere enthalten sein, die seit mehr als 60 Tagen öffentlich bekannt ist. [vulnerabilities_fixed_60_days]
    Die Sicherheitslücke muss vom Projekt selbst gepatched und freigegeben werden (Patches dürfen woanders entwickelt werden). Eine Sicherheitsücke wird (für diesen Zweck) öffentlich bekannt, sobald es einen CVE mit öffentlich freigegebenen, nicht bezahlten Informationen hat (veröffentlicht beispielsweise in der National Vulnerability Database) oder wenn das Projekt informiert und die Informationen der Öffentlichkeit zugänglich gemacht wurden (evtl. durch das Projekt). Eine Sicherheitslücke ist hat einen mittlerem oder höheren Schweregrad, wenn ihr Common Vulnerability Scoring System (CVSS) Basis-Score 4 oder höher ist. In CVSS Versionen 2.0 bis 3.1 entspricht dies einem CVSS score von 4.0 oder höher. Projekte können einen CVSS Score der in einer viel verwendeten Schwachstellendatenbank (wie z.B. National Vulnerability Database) verwenden, wenn der Score entsprechend der aktuellsten CVSS Version in der Datenbank gelistet ist. Projekte können stattdessen den Schweregrad selbst berechnen, indem sie die neuste Version der CVSS zum Zeitpunkt der Schwachstellenmeldung verwendend, wenn die Eingaben für die Berechnung veröffentlicht werden sobald die Schwachstelle öffentlich bekannt gegeben wurde. Hinweis: Das bedeutet, dass Benutzer bis zu 60 Tage für alle Angreifer weltweit anfällig bleiben können. Dieses Kriterium ist oft viel einfacher zu treffen als das, was Google empfiehlt in Rebooting responsible disclosure, weil Google empfiehlt, dass die 60-Tage-Periode beginnen, wenn das Projekt benachrichtigt wird, selbst dann, wenn der Bericht nicht öffentlich ist. Beachten Sie auch, dass dieses Badge-Kriterium, wie andere Kriterien, auf einzelne Projekte zutrifft. Manche Projekte sind teil einer größeren Organisation oder eines größeren Projektes, möglicherweise als Teil mehrer Lagen, und manche Projekte füttern ihre Ergebnisse an andere Organisationen oder Projekte als teil einer möglicherweisen komplexen Lieferkette. Daher fokussieren wir uns auf die Antwortzeit einzelner Projekte. Wenn ein Projekt einen Patch bereitgestellt hat können andere entscheiden wie sie damit umgehen möchten (z. B. können sie auf eine neue Version upgraden oder nur einzelne Patches auswählen und einspielen).

    Known dependency vulnerabilities are surfaced and fixed continuously rather than on a 60-day clock. "pnpm audit --prod --audit-level moderate" runs as the required "Audit" status check on every pull request, so a moderate-or-higher advisory in the production dependency graph blocks merges until it is resolved. Dependabot security updates and alerts are enabled, with weekly version updates across the npm, docker and github-actions ecosystems (.github/dependabot.yml). A Trivy workflow scans dependencies and container images on pushes to main and on pull requests, and CodeQL runs on every push, pull request and weekly. Deliberate, time-boxed deferrals are tracked publicly in a periodic-review issue with an explicit re-check condition for each.



    Projekte SOLLTEN alle kritischen Schwachstellen schnell beheben, nachdem sie gemeldet wurden. [vulnerabilities_critical_fixed]

    Critical vulnerabilities are addressed promptly because the gates are blocking rather than advisory: the required "Audit" check fails the pull request on any moderate-or-higher advisory in the production dependency graph, so a critical one cannot reach main. Dependabot security updates open fix pull requests automatically, Trivy scans images and dependencies on push and pull request, and CodeQL findings land in GitHub code scanning for triage. Security-relevant issues are additionally labelled type:security and priority:critical in the tracker so they are visible and prioritized.


  • Andere Sicherheitsissues


    Die öffentlichen Repositorys DÜRFEN NICHT gültige private Zugriffsdaten enthalten (z. B. ein funktionierendes Passwort oder einen privaten Schlüssel), die den öffentlichen Zugriff einschränken sollen. [no_leaked_credentials]
    Ein Projekt DARF "Beispiel"-Zugriffsdaten für Tests und unwichtige Datenbanken herausgeben, solange sie nicht den öffentlichen Zugang einschränken sollen.

    No valid credential intended to limit public access is present in the repository, and three independent controls enforce that: GitHub secret scanning with push protection is enabled; a betterleaks job (the maintained gitleaks successor) runs on every pull request with fetch-depth 0, scanning the entire git history against .gitleaks.toml, and reports zero findings; and all .env* files are gitignored, with runtime secrets supplied from Azure Key Vault via managed identities (docs/security/secrets.md). Reported precisely: on main, apps/api/src/config/environment.ts still carries one hardcoded literal — a local-development HMAC fallback for JWT_SECRET. It is not a credential for any deployed system, because production fails closed and refuses to boot unless JWKS_URI, JWKS_ISSUER and JWKS_AUDIENCE are set, so the fallback cannot be used to accept forged tokens in a real deployment. It is nonetheless being removed outright for defense in depth: the change deletes the built-in default, makes AUTH_PROVIDER=jwks without JWKS_URI refuse to boot unless JWT_SECRET is set explicitly, and ships a throwaway value in .envrc.template and .env.dockercompose.example so local setup configures one deliberately. This entry will be tightened once that change is merged.


 Analyse 8/8

  • Statische Codeanalyse


    Mindestens ein Tool zur Analyse statischer Codes (über Compiler-Warnungen und "sichere" Sprachmodi hinaus) MUSS vor der Veröffentlichung auf jede vorgeschlagene größere Produktionsversion der Software angewendet werden, wenn mindestens ein FLOSS-Tool dieses Kriterium in der ausgewählten Sprache implementiert. [static_analysis]
    Ein Tool zur statischen Codeanalyse untersucht den Softwarecode (als Quellcode, Zwischencode oder ausführbare Datei), ohne ihn mit bestimmten Eingaben auszuführen. Für dieses Kriterium zählen Compilerwarnungen und "sichere" Sprachmodi nicht als statische Codeanalyse-Tools (diese vermeiden typischerweise eine tiefgreifende Analyse, da Geschwindigkeit entscheidend ist). Manche statischen Codeanalyse-Tools spezialisieren sich auf das Auffinden von generischen Defekten, andere spezialisieren sich auf das Finden von bestimmte Arten von Defekten (z.B. Schwachstellen) und manche können beides. Beispiele für solche Tools zur statischen Codeanalyse sind cppcheck (C, C++), clang static analyzer (C, C++), SpotBugs (Java), FindBugs (Java) (including FindSecurityBugs), PMD (Java), Brakeman (Ruby on Rails), lintr (R), goodpractice (R), Coverity Quality Analyzer, SonarQube, Codacy, und HP Enterprise Fortify Static Code Analyzer.. Mehr Tools finden Sie beispielsweise in der Wikipedia-Liste von Tools zur statischen Codeanalyse, OWASP Informationen zur statischen Code-Analyse , NIST-Liste der Quellcode-Sicherheitsanalyse-Tools und Wheelers Liste der statischen Analyse-Tools. Das SWAMP ist eine kostenlose Plattform zur Bewertung von Schwachstellen in Software mit einer Vielzahl von Tools. Wenn für die verwendete(n) Implementierungssprache(n) keine statischen FLOSS-Analysewerkzeuge verfügbar sind, wählen Sie "N/V".

    At least one static analysis tool with security relevance is applied to every proposed major production release, and in fact to every pull request. CodeQL runs the "security-and-quality" query suite on every push to main, every pull request, and on a weekly schedule, uploading results to GitHub code scanning (.github/workflows/codeql.yml). Alongside it: ESLint with typescript-eslint recommendedTypeChecked (full type-aware analysis), tsc --strict, zizmor auditing the GitHub Actions workflows for supply-chain and template-injection issues, Trivy scanning dependencies and container images, and betterleaks scanning git history for secrets. All of these are required status checks on pull requests to main. See https://github.com/undp/carbon-footprint-program/actions/workflows/codeql.yml.



    Es wird davon ausgegangen, dass mindestens eines der statischen Analysewerkzeuge, die für das statische Analysekriterium verwendet wurde, Regeln oder Ansätze einschließt, um nach häufigen Schwachstellen in der analysierten Sprache oder Umgebung zu suchen. [static_analysis_common_vulnerabilities]
    Statische Analysetools, die speziell dafür entwickelt wurden, nach Schwachstellen zu suchen, finden diese eher. Das heißt, dass die Verwendung von statischen Tools in der Regel helfen wird einige Probleme zu finden. Wir schlagen dies vor, aber erwarten es für das "passing" -Level-Badge nicht.

    CodeQL is configured with the "security-and-quality" query suite, which is explicitly a look for common vulnerability patterns — injection, path traversal, unsafe deserialization, SSRF, hardcoded credentials, prototype pollution and the rest of the JavaScript/TypeScript CWE coverage — rather than style-only checks. Results are uploaded to GitHub code scanning. It is complemented by Trivy for known-CVE scanning of dependencies and images and zizmor for GitHub Actions-specific vulnerability classes.



    Alle mittel- und höhergradig ausnutzbaren Schwachstellen, die mit statischer Codeanalyse entdeckt wurden, MÜSSEN nach der Entdeckung rechtzeitig behoben werden. [static_analysis_fixed]
    Eine Sicherheitslücke ist hat einen mittlerem oder höheren Schweregrad, wenn ihr Common Vulnerability Scoring System (CVSS) Basis-Score 4 oder höher ist. In CVSS Versionen 2.0 bis 3.1 entspricht dies einem CVSS score von 4.0 oder höher. Projekte können einen CVSS Score der in einer viel verwendeten Schwachstellendatenbank (wie z.B. National Vulnerability Database) verwenden, wenn der Score entsprechend der aktuellsten CVSS Version in der Datenbank gelistet ist. Projekte können stattdessen den Schweregrad selbst berechnen, indem sie die neuste Version der CVSS zum Zeitpunkt der Schwachstellenmeldung verwendend, wenn die Eingaben für die Berechnung veröffentlicht werden sobald die Schwachstelle öffentlich bekannt gegeben wurde. Beachten Sie, dass das Kriterium vulnerabilities_fixed_60_days verlangt, dass alle diese Schwachstellen innerhalb 60 Tagen nach Bekanntgabe gefixt werden.

    Findings are fixed rather than accumulated, because the analyzers are blocking gates. "Lint" runs with --max-warnings=0 and "Type Check" fails on any error; both are required checks. The zizmor and Secret Scan jobs fail the build on any finding. CodeQL alerts appear in GitHub code scanning and are triaged by the maintainer team, with security-relevant work tracked as type:security issues. Where a Trivy finding cannot yet be acted on, it is recorded as an explicit, reviewed exception in .trivyignore.yaml rather than silently ignored.



    Es wird EMPFOHLEN, dass eine statische Quellcode-Analyse bei jedem Commit oder zumindest täglich ausgeführt wird. [static_analysis_often]

    Static analysis runs far more often than at each release: CodeQL on every push to main, every pull request, and weekly on a schedule; ESLint, tsc, zizmor, betterleaks and Trivy on every pull request; and the OpenSSF Scorecard workflow weekly and whenever branch protection changes. So every proposed change is analyzed before it can merge, and the scheduled runs catch newly published advisories against unchanged code.


  • Dynamische Codeanalyse


    Es ist EMPFHOLEN, dass mindestens ein dynamisches Analyse-Tool auf jede vorgeschlagene größere Veröffentlichung der Software vor seiner Freigabe angewendet wird. [dynamic_analysis]
    Ein dynamisches Analyse-Tool untersucht die Software, indem es sie mit bestimmten Eingaben ausführt. Beispielsweise DARF das Projekt ein Fuzzing-Tool verwenden (z.B. American Fuzzy Lop) oder einen Web Application Scanner (z.B. OWASP ZAP oder w3af). In einigen Fällen ist das OSS-Fuzz Projekt bereit, Fuzz-Tests auf Ihr Projekt anzuwenden. Für die Zwecke dieses Kriteriums muss das dynamische Analyse-Tool die Eingaben in irgendeiner Weise variieren, um nach verschiedenen Arten von Problemen zu suchen oder eine automatisierte Test-Suite mit mindestens 80% Zweig-Abdeckung sein. Die Englische Wikipedia-Seite zur dynamischen Analysen und die OWASP Seite über Fuzzing nennen einige dynamische Analyse-Tools. Das Analyse-Tool(s) DARF für der Suche nach Sicherheitslücken eingesetzt werden, aber das ist nicht erforderlich.

    No dedicated dynamic security analysis tool is applied yet. The project does exercise the running system extensively — 161 integration tests drive real HTTP requests through the API against a real PostgreSQL instance (Testcontainers), plus Azurite and MinIO for the storage paths, and Zod schemas validate every request and response at runtime — but that is a functional suite, not a fuzzer or web-application scanner. Adding a DAST scan or fuzzing of the HTTP surface is recognized as future work; this criterion is SUGGESTED, not required, for the passing level.



    Es ist EMPFHOLEN, dass die vom Projekt entwickelte Software, falls sie Software von einer Speicher-unsicheren Sprache (z. B. C oder C ++) enthält, regelmäßig mindestens ein dynamisches Werkzeug (z.B. ein Fuzzer oder ein Web-Anwendungs-Scanner) in Kombination mit einem Mechanismus zur Erkennung von Speichersicherheitsproblemen wie Puffer-Overwrites verwendet. Wenn das Projekt keine Software entwickelt, die in einer Speicher-unsicheren Sprache geschrieben ist, wählen Sie "nicht anwendbar" (N/A). [dynamic_analysis_unsafe]
    Beispiele für Mechanismen zur Erkennung von Arbeitsspeicher Sicherheitsproblemen sind Adresse Sanitizer (ASAN) (verfügbar in GCC und LLVM), Memory Sanitizer und valgrind. Andere möglicherweise verwendete Werkzeuge sind Thread Sanitizer und Undefined Behavior Sanitizer. Weit verbreitete Assertions würden auch funktionieren.

    The project is written in TypeScript running on Node.js (with a small amount of shell and Bicep). These are memory-safe, garbage-collected environments with no manual memory management, no pointer arithmetic and no unchecked buffer access, so the memory-safety checkers this criterion refers to (ASan/valgrind-class tools) do not apply. There is no C, C++ or other unsafe-language code in the codebase.



    Es ist EMPFHOLEN, dass das Projekt eine Konfigurations benutzt, die zumindest etwas dynamischen Analyse nutzt (wie z.B. testing oder fuzzing), welche Assertions erlauben. In vielen Fällen sollten diese Assertions nicht in Production Builds aktiviert sein. [dynamic_analysis_enable_assertions]
    Dieses Kriterium schlägt nicht vor, Assertions in der Produktionsumgebung zu aktivieren; das liegt ganz beim Projekt und seinen Benutzern. Stattdessen liegt der Fokus dieses Kriteriums darauf, die Fehlererkennung während der dynamischen Analyse vor der Bereitstellung zu verbessern. Das Aktivieren von Assertions im Produktionseinsatz unterscheidet sich völlig vom Aktivieren von Assertions während der dynamischen Analyse (wie z.B. Tests). In einigen Fällen ist das Aktivieren von Assertions im Produktionseinsatz äußerst unklug (insbesondere bei hochintegren Komponenten). Es gibt viele Argumente gegen das Aktivieren von Assertions in der Produktion, z.B. sollten Bibliotheken keine Aufrufer zum Absturz bringen, ihre Anwesenheit kann zur Ablehnung durch App Stores führen und/oder das Auslösen einer Assertion in der Produktion kann private Daten wie private Schlüssel offenlegen. Beachten Sie, dass in vielen Linux-Distributionen NDEBUG nicht definiert ist, sodass C/C++ assert() standardmäßig für die Produktion in diesen Umgebungen aktiviert wird. Es kann wichtig sein, einen anderen Assertion-Mechanismus zu verwenden oder NDEBUG für die Produktion in diesen Umgebungen zu definieren.

    Runtime checks are enabled during test execution rather than compiled out. Every API request and response is validated against a Zod schema at the route boundary, and a schema violation throws — so the integration suite fails loudly on any contract breach, which is exactly the assertion behaviour this criterion asks for. TypeScript runs in strict mode, and the test environment additionally exercises the fail-closed configuration guards in apps/api/src/config/environment.ts. No assertion or validation layer is disabled in the test configuration.



    Alle mittel- und höhergradig ausnutzbaren Schwachstellen, die mit dynamischer Codeanalyse entdeckt werden, MÜSSEN zügig behoben werden, nachdem sie bestätigt wurden. [dynamic_analysis_fixed]
    Wenn Sie keine dynamische Codeanalyse ausführen und somit keine Schwachstellen auf diese Weise finden, wählen Sie "nicht anwendbar" (N/A). Eine Sicherheitslücke ist hat einen mittlerem oder höheren Schweregrad, wenn ihr Common Vulnerability Scoring System (CVSS) Basis-Score 4 oder höher ist. In CVSS Versionen 2.0 bis 3.1 entspricht dies einem CVSS score von 4.0 oder höher. Projekte können einen CVSS Score der in einer viel verwendeten Schwachstellendatenbank (wie z.B. National Vulnerability Database) verwenden, wenn der Score entsprechend der aktuellsten CVSS Version in der Datenbank gelistet ist. Projekte können stattdessen den Schweregrad selbst berechnen, indem sie die neuste Version der CVSS zum Zeitpunkt der Schwachstellenmeldung verwendend, wenn die Eingaben für die Berechnung veröffentlicht werden sobald die Schwachstelle öffentlich bekannt gegeben wurde.

    No dedicated dynamic analysis (fuzzing or DAST) is currently performed — see the dynamic_analysis criterion — so there are no dynamic-analysis findings, of medium severity or otherwise, outstanding to fix. Vulnerabilities discovered by any other route (CodeQL, Trivy, pnpm audit, Dependabot, or a private report under SECURITY.md) are triaged and fixed under the processes described in those criteria.



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 Kevin Johnson und die OpenSSF Best Practices Badge-Mitwirkenden als Urheber.

Projekt-Badge-Eintrag im Besitz von: Kevin Johnson.
Eintrag erstellt: 2026-07-29 16:37:34 UTC, zuletzt aktualisiert: 2026-07-30 01:15:24 UTC. Letztes erreichtes Badge: 2026-07-29 16:59:38 UTC.