openits

Les projets qui suivent les meilleures pratiques ci-dessous peuvent s'auto-certifier et montrer qu'ils ont obtenu le badge de la Open Source Security Foundation (OpenSSF).

Il n'existe aucun ensemble de pratiques qui garantissent que ce logiciel n'aura jamais de défauts ou de vulnérabilités ; même les méthodes formelles peuvent échouer si les spécifications ou les hypothèses sont fausses. Il n'y a pas non plus de pratiques qui peuvent garantir qu'un projet permettra de maintenir une communauté de développement saine et qui fonctionne bien. Toutefois, suivre les meilleures pratiques peut contribuer à améliorer les résultats des projets. Par exemple, certaines pratiques permettent la revue par plusieurs personnes avant publication, ce qui peut aider à trouver des vulnérabilités techniques difficiles à trouver autrement et à renforcer la confiance et un désir d'interaction répétée entre les développeurs de différentes entreprises. Pour gagner un badge, tous les critères DOIT et NE DOIT PAS doivent être satisfaits, tous les critères DEVRAIT doivent être satisfaits OU non satisfaits avec justification, et tous les critères PROPOSÉ doivent être satisfaits OU non satisfaits (nous voulons au moins qu'ils soient considérés). Si vous voulez entrer un texte de justification pour un commentaire générique, au lieu d'une raison justifiant que la situation est acceptable, commencez le bloc de texte avec '//' suivi d'un espace. Les commentaires sont les bienvenus via le site GitHub en tant que problèmes ou pull requests. Il existe également une liste de diffusion pour discussion générale.

Nous fournissons volontiers l'information dans plusieurs langues, cependant, s'il existe un conflit ou une contradiction entre les traductions, la version anglaise est la version qui fait autorité.
Si c'est votre projet, veuillez indiquer votre statut de badge sur votre page de projet ! Le statut du badge ressemble à ceci : Le niveau de badge pour le projet 13354 est silver Voici comment l'intégrer :
Vous pouvez afficher votre statut de badge en incorporant ceci dans votre fichier markdown :
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13354/badge)](https://www.bestpractices.dev/projects/13354)
ou en incorporant ceci dans votre HTML :
<a href="https://www.bestpractices.dev/projects/13354"><img src="https://www.bestpractices.dev/projects/13354/badge"></a>


Ce sont les critères du niveau Argent. Vous pouvez également afficher les critères des niveaux Basique ou Or.

Baseline Series: Niveau de référence 1 Niveau de référence 2 Niveau de référence 3

        

 Notions de base 17/17

  • Général

    Notez que d'autres projets peuvent utiliser le même nom.

    Open-source enterprise architecture platform for documenting APIs, integrations, IT landscapes, and business domains.

    Utilisez un format d'expression de licence SPDX ; des exemples sont « Apache-2.0 », « BSD-2-Clause », « BSD-3-Clause », « GPL-2.0+ », « LGPL-3.0+ », « MIT » et « (BSD-2-Clause OU Ruby) ». Ne pas inclure des guillemets simples ou doubles.
    S'il y a plus d'un langage, listez-les en tant que valeurs séparées par des virgules (espaces facultatifs) et triez-les du plus au moins utilisé. S'il y a une longue liste, veuillez lister au moins les trois premiers. S'il n'y a pas de langage (par exemple, il s'agit d'un projet uniquement de documentation ou de test), utilisez le caractère unique « - ». Utilisez une capitalisation conventionnelle pour chaque langage, par exemple « JavaScript ».
    La plate-forme commune d'énumération (CPE) est un schéma de dénomination structuré pour les systèmes, les logiciels et les paquetages des technologies de l'information. Il est utilisé dans un certain nombre de systèmes et de bases de données pour signaler des vulnérabilités.

    OpenITS is a self-hosted, open-source enterprise architecture and integration documentation platform (Apache 2.0). It helps teams model IT landscapes, design C4 architecture diagrams, document multi-protocol APIs (REST, SOAP, GraphQL, gRPC, WebSocket, etc.), map cross-system integrations, capture ADRs, and govern a technology radar in one workspace.

    The project is implemented as a Laravel 11 (PHP 8.2+) web application with MySQL or SQLite, optional LDAP/Google OAuth authentication, and Sanctum API tokens. Security controls include bcrypt password hashing, login rate limiting, security headers, LDAPS/STARTTLS support, and private vulnerability reporting via SECURITY.md.

    Documentation includes README.md (installation, usage, build, test, security), CONTRIBUTING.md, SECURITY.md, and reference docs for API, CLI, and public service classes under docs/. Bug reports and feature requests use English GitHub issue templates. The test suite has 69 automated PHPUnit tests; code style is enforced with Laravel Pint (composer lint). The project does not yet have an official NIST CPE name.

  • Conditions préalables


    Le projet DOIT atteindre un badge de niveau basique. [achieve_passing]

  • Contenu basique du site Web du projet


    Les informations sur la façon de contribuer DOIVENT inclure les exigences pour des contributions acceptables (par exemple, une référence à toute règle de codage requise). (URL requise) [contribution_requirements]

    CONTRIBUTING.md defines acceptable contribution requirements, including the required coding standard (PSR-12, enforced with Laravel Pint), test policy, security rules, and a PR checklist. The README Contributing section links to this document.

    Key URLs:


  • Supervision du projet


    Le projet DEVRAIT avoir un mécanisme juridique par lequel tous les développeurs de quantités non triviales de logiciel du projet affirment qu'ils sont légalement autorisés à effectuer ces contributions. L'approche la plus commune et facilement mise en œuvre pour ce faire est d'utiliser un Certificat d'origine du développeur (DCO), où les utilisateurs ajoutent une information « sign-off-by » dans leurs commits et le projet pointe vers le site Web du DCO. Cependant, cela PEUT être mis en œuvre en tant que contrat de licence de contributeur (CLA), ou tout autre mécanisme juridique. (URL requise) [dco]
    Le DCO est le mécanisme recommandé, car il est facile à mettre en œuvre, suivi dans le code source, et git prend directement en charge une fonction « approuvé » en utilisant « commit -s ». Pour être plus efficace, il est préférable que la documentation du projet explique ce que signifie « approuvé » pour ce projet. Un CLA est un accord juridique qui définit les termes en vertu desquels des travaux intellectuels ont été licenciés à une organisation ou un projet. Un accord de cession (CAA) est un accord légal qui transfère les droits dans un travail intellectuel à une autre partie ; il n'est pas exigé d'avoir des CAA pour les projets, car un CAA augmente le risque que les contributeurs potentiels ne contribuent pas, en particulier si le destinataire est un organisme à but lucratif. Les CLA de la Fondation Apache (la licence de contributeur individuel et la CLA d'entreprise) sont des exemples de CLA pour des projets qui déterminent que les risques de ces types de CLA au projet sont inférieurs à leurs avantages.

    Le projet DOIT définir et documenter clairement son modèle de gouvernance de projet (la façon dont il prend ses décisions, y compris les rôles clés). (URL requise) [governance]
    Il doit y avoir une manière documentée bien établie de prendre des décisions et de résoudre les différends. Dans les petits projets, cela peut être aussi simple que « le propriétaire du projet et dirigeant prend toutes les décisions finales ». Il existe différents modèles de gouvernance, y compris le dictateur bienveillant et la méritocratie formelle ; pour plus de détails, voir Modèles de gouvernance. Les approches centralisées (par exemple, un seul mainteneur) et décentralisées (par exemple, les groupes de mainteneurs) ont été utilisées avec succès dans des projets. L'information sur la gouvernance n'a pas besoin de documenter la possibilité de créer une duplication de projet, car cela est toujours possible pour les projets FLOSS.

    Le projet DOIT adopter un code de conduite et le publier dans un lieu standard. (URL requise) [code_of_conduct]
    Les projets peuvent être en mesure d'améliorer la civilité de leur communauté et d'établir des attentes quant à une conduite acceptable en adoptant un code de conduite. Cela peut aider à éviter les problèmes avant leur apparition et faire du projet un lieu plus accueillant pour encourager les contributions. Cela devrait se concentrer uniquement sur le comportement au sein de la communauté / lieu de travail du projet. Des exemples de codes de conduite sont le code de conduite du noyau Linux, le code de conduite du pacte de contributeur, le code de conduite du projet Debian, le code de conduite du projet Ubuntu, le code de conduite du projet Fedora, le code de conduite du projet GNOME, le code de conduite de la communauté KDE", le code de conduite de la communauté Python, le guide de conduite de la communauté Ruby, et le code de conduite du projet Rust.

    Le projet DOIT clairement définir et documenter publiquement les rôles clés dans le projet et leurs responsabilités, y compris les tâches que ces rôles doivent accomplir. Il DOIT être clairement exprimé qui a quel(s) rôle(s), mais cela pourrait ne pas être documenté de la même manière. (URL requise) [roles_responsibilities]
    La documentation pour la gouvernance et les rôles et responsabilités peut être à un seul endroit.

    GOVERNANCE.md defines project roles (project lead, maintainer, contributor, user), their responsibilities, and who currently holds each role. SECURITY.md identifies the security contact for vulnerability reports.
    Key URLs:



    Le projet DOIT pouvoir continuer avec une interruption minimale si une personne décède, est invalidée ou ne peut/veut plus continuer à maintenir le projet. En particulier, le projet DOIT être en mesure de créer et de fermer des problèmes, d'accepter les modifications proposées et de publier des versions du logiciel, dans un délai d'une semaine après confirmation du retrait d'un individu du projet. Cela PEUT être fait en s'assurant que quelqu'un d'autre possède les clés, les mots de passe et les droits juridiques nécessaires pour poursuivre le projet. Les personnes qui exécutent un projet FLOSS PEUVENT faire cela en fournissant des clés dans un coffre-fort et un testament fournissant les droits légaux nécessaires (par exemple, pour les noms DNS). (URL requise) [access_continuity]

    Only one maintainer is listed and there is no documented backup access, succession plan, or continuity process for issues, merges, and releases.

    Key URL:
    https://github.com/imRezaAlie/openits/blob/main/GOVERNANCE.md



    Le projet DEVRAIT avoir un « bus factor » de 2 ou plus. (URL requise) [bus_factor]
    Un « bus factor » (aussi connu en tant que « truck factor ») est le nombre minimum de membres du projet qui doivent disparaître soudainement d'un projet (« écrasé par un bus ») avant que le projet ne se bloque en raison du manque de personnel compétent. L'outil truck-factor peut l'estimer pour des projets sur GitHub. Pour plus d'informations, voir Évaluation du « bus factor » des dépôts Git par Cosentino et al.

    The project currently has a bus factor of 1. Only one maintainer is documented.

    Key URL:
    https://github.com/imRezaAlie/openits/blob/main/GOVERNANCE.md#current-maintainers


  • Documentation


    Le projet DOIT avoir une feuille de route documentée qui décrit ce que le projet a l'intention de faire et ne pas faire pour au moins l'année suivante. (URL requise) [documentation_roadmap]
    Le projet pourrait ne pas atteindre la feuille de route, et c'est acceptable ; le but de la feuille de route est d'aider les utilisateurs et les contributeurs potentiels à comprendre l'orientation prévue du projet. Elle ne doit nécessairement pas être détaillée.

    ROADMAP.md documents planned work and out-of-scope items for the next 12 months (June 2026 – June 2027), including quarterly goals and an explicit "Out of scope (not planned)" section.

    Key URLs:
    https://github.com/imRezaAlie/openits/blob/main/ROADMAP.md
    https://github.com/imRezaAlie/openits/blob/main/ROADMAP.md#out-of-scope-not-planned



    Le projet DOIT inclure la documentation de l'architecture (aussi appelée conception de haut niveau) du logiciel produit par le projet. Si le projet ne produit pas de logiciel, sélectionnez « non applicable » (N/A). (URL requise) [documentation_architecture]
    Une architecture de logiciel explique les structures fondamentales d'un programme, c'est-à-dire les principaux composants du programme, les relations entre eux et les propriétés clés de ces composants et de ces relations.

    README.md documents the high-level software architecture with Mermaid diagrams: enterprise landscape model, entity-relationship diagram, integration flow, and tech stack. docs/SERVICES.md describes the application service layer.

    Key URLs:
    https://github.com/imRezaAlie/openits#architecture-model
    https://github.com/imRezaAlie/openits/blob/main/README.md#architecture-model
    https://github.com/imRezaAlie/openits/blob/main/docs/SERVICES.md



    Le projet DOIT documenter ce à quoi l'utilisateur peut et ne peut pas s'attendre en termes de sécurité à partir du logiciel produit par le projet (ses « exigences de sécurité »). (URL requise) [documentation_security]
    Ce sont les exigences de sécurité que le logiciel est supposé remplir.

    README.md Security section and SECURITY.md document what users can expect (bcrypt passwords, rate limiting, security headers, Sanctum tokens, LDAP/TLS options, crypto practices) and what they must configure or cannot expect (HTTPS required in production, no paid bug bounty, operator-managed secrets, supported versions only on latest main).

    Key URLs:
    https://github.com/imRezaAlie/openits#security
    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md
    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#cryptography-practices



    Le projet DOIT fournir un guide de « démarrage rapide » pour les nouveaux utilisateurs afin de les aider à faire rapidement quelque chose avec le logiciel. (URL requise) [documentation_quick_start]
    L'idée est de montrer aux utilisateurs comment démarrer et de faire en sorte que le logiciel fasse quelque chose. Ceci est d'une importance cruciale pour les utilisateurs potentiels pour les aider à démarrer.

    README.md includes a Quick start guide with clone, Composer install, .env setup, migrations, and php artisan serve so new users can run OpenITS locally.

    Key URLs:
    https://github.com/imRezaAlie/openits#quick-start
    https://github.com/imRezaAlie/openits/blob/main/README.md#quick-start



    Le projet DOIT faire un effort pour maintenir la documentation conforme à la version actuelle des résultats du projet (y compris les logiciels produits par le projet). Tous les défauts de la documentation connus la rendant incohérente DOIVENT être corrigés. Si la documentation est généralement à jour, mais inclut de manière erronée certaines informations antérieures qui ne sont plus vraies, considérez cela comme un défaut, puis faites le suivi et corrigez comme d'habitude. [documentation_current]
    La documentation PEUT inclure des informations sur les différences ou les modifications entre les versions du logiciel et/ou des liens vers les anciennes versions de la documentation. L'objectif de ce critère est de faire en sorte que la documentation soit cohérente et non pas que la documentation soit parfaite.

    Documentation is maintained alongside the codebase: README (quick start, architecture, security), CONTRIBUTING.md, SECURITY.md, GOVERNANCE.md, ROADMAP.md, and docs/ (API, CLI, services) match the current Laravel 11 application. The project policy in CONTRIBUTING.md requires updating docs when user-facing or interface changes land. Known inconsistencies are tracked via GitHub Issues and fixed (e.g. restored docs/README.md index linked from README).

    Key URLs:
    https://github.com/imRezaAlie/openits/blob/main/README.md
    https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#documentation
    https://github.com/imRezaAlie/openits/tree/main/docs



    La page d'accueil et/ou le site Web du dépôt du projet DOIVENT identifier et pointer tous les accomplissements, y compris ce badge sur les meilleures pratiques, dans les 48 heures suivant la reconnaissance publique que l'accomplissement a été atteint. (URL requise) [documentation_achievements]
    Un accomplissement est un ensemble de critères externes que le projet a spécifiquement cherché à atteindre, y compris certains badges. Cette information ne doit pas nécessairement être sur la page d'accueil du site Web du projet. Un projet utilisant GitHub peut mettre des accomplissements sur la page d'accueil du dépôt en les ajoutant au fichier README.

    The OpenSSF Best Practices badge is linked on the repository front page (README.md) and the project landing page (welcome.blade.php hero and footer), pointing to https://www.bestpractices.dev/projects/13354.

    Key URLs:
    https://github.com/imRezaAlie/openits#openits
    https://www.bestpractices.dev/projects/13354


  • Accessibilité et internationalisation


    Le projet (à la fois les sites du projet et les résultats du projet) DEVRAIT suivre les meilleures pratiques d'accessibilité afin que les personnes handicapées puissent encore participer au projet et utiliser les résultats du projet où il est raisonnable de le faire. [accessibility_best_practices]
    Pour les applications Web, consultez les Directives d'accessibilité des contenus Web (WCAG 2.0) et son document à l'appui Comprendre WCAG 2.0 ; voir aussi les informations d'accessibilité du W3C. Pour les applications IHM, envisagez d'utiliser les directives d'accessibilité spécifiques à l'environnement (telles que Gnome, KDE, XFCE, Android, IOS, Mac et Windows). Certaines applications IHM textuelles (par exemple, les programmes « ncurses ») peuvent faire certaines choses pour se rendre plus accessibles (par exemple, le paramètre « force-arrow-cursor » de « alpine »). La plupart des applications en ligne de commande sont assez accessibles telles quelles. Ce critère est souvent N/A, par exemple, pour les bibliothèques. Voici quelques exemples d'actions à prendre ou de questions à considérer :
    • Fournir des alternatives de texte pour tout contenu non textuel afin qu'il puisse être changé en d'autres formes dont les gens ont besoin, comme une plus grande taille, le braille, une sortie vocale, des symboles ou une langue plus simple (WCAG 2.0 directive 1.1)
    • La couleur n'est pas utilisée comme le seul moyen visuel de transmettre des informations, d'indiquer une action, de provoquer une réponse ou de distinguer un élément visuel. (WCAG 2.0 directive 1.4.1)
    • La présentation visuelle du texte et des images du texte a un taux de contraste d'au moins 4,5:1, à l'exception du grand texte, du texte incident, et des logotypes (WCAG 2.0 directive 1.4.3)
    • Rendez toutes les fonctionnalités disponibles à partir d'un clavier (WCAG directive 2.1)
    • Une IHM ou un projet basé sur le Web DEVRAIT tester avec au moins un lecteur d'écran sur la (les) plate-forme(s) cible(s) (par exemple NVDA, Jaws ou WindowEyes sur Windows ; VoiceOver sur Mac & iOS ; Orca sous Linux/BSD ; TalkBack sur Android). Les programmes IHM textuels PEUVENT travailler à réduire le retrait excessif pour éviter la lecture redondante par les lecteurs d'écran.

    OpenITS follows basic accessibility practices where practical: the landing page uses lang="en", navigation toggle aria-label, and descriptive image alt text; README diagrams include alt attributes; documentation and issue templates are in English. ROADMAP.md lists further keyboard and contrast improvements for the C4 editor (Q2 2027). Complex D3 visualizations remain a known limitation for screen-reader users.

    Key URLs:
    https://github.com/imRezaAlie/openits/blob/main/resources/views/welcome.blade.php
    https://github.com/imRezaAlie/openits/blob/main/ROADMAP.md
    https://github.com/imRezaAlie/openits#readme



    Le logiciel produit par le projet DEVRAIT être internationalisé pour permettre une localisation facile pour la culture, la région ou la langue du public cible. Si l'internationalisation (i18n) ne s'applique pas (par exemple, le logiciel ne génère pas de texte destiné aux utilisateurs finaux et ne trie pas de texte lisible par les humains), sélectionnez « non applicable » (N/A). [internationalization]
    La localisation « réfère à l'adaptation du contenu d'un produit, d'une application ou d'un document pour répondre aux exigences linguistiques, culturelles et autres d'un marché cible spécifique (un lieu). » L'internationalisation est la « conception et le développement du contenu d'un produit, d'une application ou d'un document qui permette une localisation facile pour les publics cibles qui varient en culture, en région ou en langue. » (Voir la page « Localisation ou Internationalisation » du W3C.) Le logiciel répond à ce critère simplement en étant internationalisé. Aucune localisation pour une autre langue spécifique n'est requise, car une fois que le logiciel a été internationalisé, d'autres peuvent travailler sur la localisation.

    OpenITS produces user-facing text and uses Laravel internationalization: lang/en/ translation files (auth, LDAP, Google), __() / @lang() in views and services, and APP_LOCALE in .env. Additional locales can be added under lang/. Most admin UI strings remain English-only; full multi-language support is not yet complete.

    Key URLs:
    https://github.com/imRezaAlie/openits/tree/main/lang
    https://github.com/imRezaAlie/openits/blob/main/.env.example
    https://github.com/imRezaAlie/openits/blob/main/config/app.php


  • Autre


    Si les sites du projet (site Web, dépôt et URL de téléchargement) entreposent des mots de passe pour l'authentification d'utilisateurs externes, les mots de passe DOIVENT être entreposés comme hachages itérés avec salage par utilisateur en utilisant un algorithme d'étirement des clés (itéré) (par exemple, Argon2id, Bcrypt, Scrypt, ou PBKDF2). Si les sites du projet n'entreposent pas de mots de passe à cette fin, sélectionnez « non applicable » (N/A). [sites_password_security]
    Notez que l'utilisation de GitHub répond à ce critère. Ce critère s'applique uniquement aux mots de passe utilisés pour l'authentification d'utilisateurs externes sur les sites du projet (càd l'authentification entrante). Si les sites du projet doivent se connecter à d'autres sites (càd l'authentification sortante), ils devront peut-être entreposer différemment des jetons d'identification à cette fin (puisque conserver un code de hachage serait inutile). Ceci applique le critère crypto_password_storage aux sites du projet, de manière similaire à sites_https.

    The GitHub repository and release downloads do not store user passwords (N/A). The live demo at openits.ir runs OpenITS, which stores local account passwords as bcrypt iterated hashes with per-user salts (Laravel Hash, BCRYPT_ROUNDS=12).

    Key URLs:
    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#cryptography-practices
    https://github.com/imRezaAlie/openits/blob/main/.env.example
    https://github.com/imRezaAlie/openits#security


 Contrôle des modifications 1/1

  • Versions précédentes


    Le projet DOIT maintenir les anciennes versions les plus utilisées du produit ou fournir un chemin de mise à niveau vers des versions plus récentes. Si le chemin de mise à niveau est difficile, le projet DOIT documenter comment effectuer la mise à niveau (par exemple, les interfaces qui ont changé et une suggestion d'étapes détaillées pour aider la mise à niveau). [maintenance_or_update]

    OpenITS does not maintain parallel long-term branches for older releases. Security fixes and active maintenance apply to the latest release on main (see SECURITY.md). Users on older deployments follow a documented upgrade path in UPGRADING.md: backup, fetch/checkout, composer install, php artisan migrate, cache rebuild, and verification. Version-specific notes (e.g. v1.1.0) list configuration, database, and public API interface changes. Release notes are published on GitHub Releases. README links to UPGRADING.md under Build & test and in the documentation table.

    URLs to cite:

    https://github.com/imRezaAlie/openits/blob/main/UPGRADING.md
    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#supported-versions
    https://github.com/imRezaAlie/openits/releases


 Compte-rendu 3/3

  • Procédure de signalement des bogues


    Le projet DOIT utiliser un suivi des problèmes pour le suivi des problèmes individuels. [report_tracker]

    The project uses GitHub Issues to track bugs, feature requests, and other work. English issue templates are provided for structured reports.

    Key URLs:


  • Processus de signalement de vulnérabilité


    Le projet DOIT créditer les auteurs de tous les signalements de vulnérabilité résolus au cours des 12 derniers mois, à l'exception des auteurs qui demandent l'anonymat. S'il n'y a pas eu de vulnérabilité résolue au cours des 12 derniers mois, sélectionnez « non applicable » (N/A). (URL requise) [vulnerability_report_credit]

    No security vulnerabilities were resolved in the 12 months before 24 June 2026. SECURITY.md documents our credit policy for future fixes (GitHub Security Advisories, release notes, and a rolling 12-month table) and states that reporters who request anonymity are not named publicly.

    tps://github.com/imRezaAlie/openits/blob/main/SECURITY.md#credit-for-security-reporters



    Le projet DOIT avoir un processus documenté pour répondre aux signalements de vulnérabilité. (URL requise) [vulnerability_response_process]
    Ceci est fortement lié à vulnerability_report_process, qui exige qu'il existe un moyen documenté de signaler les vulnérabilités. Il a également trait à la vulnerability_report_response, qui nécessite une réponse aux signalements de vulnérabilité dans un certain laps de temps.

    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#vulnerability-response-process

    SECURITY.md documents a full vulnerability response process: private reporting channels (email and GitHub private vulnerability reporting), maintainer steps from receipt through triage, fix, coordinated disclosure, and reporter credit, plus response timelines (48-hour acknowledgment, 7-day status update). Reporting instructions and supported versions are in the same file. README and CONTRIBUTING link to SECURITY.md for security reports.


 Qualité 19/19

  • Normes de codage


    Le projet DOIT identifier les guides de style de codage spécifiques pour les langages principaux qu'il utilise, et exiger que les contributions le respectent en général. (URL requise) [coding_standards]
    Dans la plupart des cas, cela se fait en se référant à certains guides de style existants, ce qui permet d'énumérer les différences. Ces guides de style peuvent inclure des moyens d'améliorer la lisibilité et les moyens de réduire la probabilité de défauts (y compris les vulnérabilités). Beaucoup de langages de programmation ont un ou plusieurs guides de style largement utilisés. Des exemples de guides de style incluent les guides de style de Google et les Règles de codage du SEI CERT.

    For coding_standards, answer Met. OpenITS already documents named style guides and requires compliance before merge.

    Badge form
    Field Value
    Status
    Met
    URL
    https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#coding-standards

    CONTRIBUTING.md identifies coding style guides for the project’s primary languages: PHP follows PSR-12, enforced with Laravel Pint (composer lint / composer lint:fix; config in pint.json). Blade, JavaScript, and database conventions are documented in the same section. Contributors must run the linter and tests before opening a PR; the PR checklist requires composer lint to pass. README links to CONTRIBUTING.md for coding standards.



    Le projet DOIT imposer automatiquement son ou ses styles de codage sélectionnés s'il existe au moins un outil FLOSS qui peut le faire dans le(s) langage(s) sélectionné(s). [coding_standards_enforced]
    Cela PEUT être mis en œuvre en utilisant des outils d'analyse statique et/ou en faisant passer le code à travers des outils de remise en forme. Dans de nombreux cas, la configuration de l'outil est incluse dans le dépôt du projet (car différents projets peuvent choisir différentes configurations). Les projets PEUVENT permettre des exceptions de style (et le font habituellement) ; là où les exceptions se produisent, elles DOIVENT être rares et documentées dans le code à leur emplacement, afin que ces exceptions puissent être revues et que les outils puissent les gérer automatiquement à l'avenir. Des exemples de tels outils incluent ESLint (JavaScript), Rubocop (Ruby) et devtools check (R).

    https://github.com/imRezaAlie/openits/blob/main/.github/workflows/lint.yml
    PHP style (PSR-12) is enforced automatically with Laravel Pint (FLOSS). pint.json configures the Laravel preset; composer lint runs vendor/bin/pint --test. GitHub Actions workflow lint.yml runs composer lint on every push and pull request to main. CONTRIBUTING.md and README document the tool and automatic enforcement.


  • Système de construction opérationnel


    Les systèmes de construction pour les binaires natifs DOIVENT honorer les variables (d'environnement) pertinentes du compilateur et du lieur qui leur sont transmises (par exemple, CC, CFLAGS, CXX, CXXFLAGS et LDFLAGS) et les transmettre aux invocations du compilateur et du lieur. Un système de construction PEUT les étendre avec des options supplémentaires ; il NE DOIT PAS simplement remplacer les valeurs fournies par les siennes. Si aucun fichier binaire natif n'est généré, sélectionnez « non applicable » (N/A). [build_standard_variables]
    Il devrait être facile d'activer des fonctionnalités de construction spéciales telles que Address Sanitizer (ASAN), ou de se conformer aux meilleures pratiques de durcissement de la distribution (par exemple, en activant facilement les options de compilation pour le faire).

    https://github.com/imRezaAlie/openits/blob/main/README.md#build--test

    OpenITS does not generate native binaries. It is a Laravel/PHP web application built with Composer (PHP dependencies) and optional Vite/npm (frontend assets). There is no Makefile, CMake, or autotools build; compiler/linker environment variables (CC, CFLAGS, CXX, CXXFLAGS, LDFLAGS) are not used. README documents the build process under Build & test.



    Le système de construction et d'installation DEVRAIT préserver les informations de débogage si elles sont demandées dans les options correspondants (par exemple, « install -s » n'est pas utilisé). S'il n'y a pas de système de construction ou d'installation (par exemple, les bibliothèques JavaScript typiques), sélectionnez « non applicable » (N/A). [build_preserve_debug]
    Par exemple, la définition de CFLAGS (C) ou CXXFLAGS (C++) devrait créer les informations de débogage pertinentes si ces langages sont utilisés et elles ne devraient pas être retirées pendant l'installation. Des informations de débogage sont nécessaires pour le support et l'analyse, et également utiles pour mesurer la présence de fonctionnalités de durcissement dans les binaires compilés.

    https://github.com/imRezaAlie/openits/blob/main/README.md#build--test

    OpenITS has no native binary build or installation system. The documented build uses Composer (PHP dependencies) and optional Vite/npm (frontend assets). The project does not compile C/C++ binaries or run install steps that strip debugging symbols (e.g. install -s). README Build & test states that native compiler flags and symbol stripping are not applicable.



    Le système de construction pour le logiciel produit par le projet NE DOIT PAS reconstruire de manière récursive des sous-répertoires s'il existe des dépendances croisées dans les sous-répertoires. S'il n'y a pas de système de construction ou d'installation (par exemple, les bibliothèques JavaScript typiques), sélectionnez « non applicable » (N/A). [build_non_recursive]
    Les informations de dépendance internes du système de construction du projet doivent être précises, sinon, les modifications apportées au projet peuvent ne pas s'effectuer correctement. Des constructions incorrectes peuvent entraîner des défauts (y compris des vulnérabilités). Une erreur courante dans les grands systèmes de construction est d'utiliser une « construction récursive », c'est-à-dire une hiérarchie de sous-répertoires contenant des fichiers source, chaque sous-répertoire étant construit de manière indépendante. Sauf si chaque sous-répertoire est entièrement indépendant, ceci est une erreur, car les informations de dépendance sont incorrectes.

    OpenITS has no native build or installation system that recursively builds subdirectories. The documented build uses Composer (PHP dependencies) and optional Vite/npm (frontend assets). There is no Makefile, CMake, or autotools with cross-dependent subdirectory recursion. README Build & test documents this.

    https://github.com/imRezaAlie/openits/blob/main/README.md#build--test



    Le projet DOIT pouvoir répéter le processus de génération d'informations à partir de fichiers source et obtenir exactement le même résultat bit-à-bit. Si aucune construction ne se produit (par exemple, dans les langages de script où le code source est utilisé directement au lieu d'être compilé), sélectionnez « non applicable » (N/A). [build_repeatable]
    Les utilisateurs GCC et Clang peuvent trouver l'option -frandom-seed utile ; dans certains cas, cela peut être résolu en forçant un ordre de tri. Plus de suggestions peuvent être trouvées sur le site pour une construction reproductible.

    https://github.com/imRezaAlie/openits/blob/main/README.md#build--test

    OpenITS is a PHP/Laravel application where PHP source is executed directly (scripting language). There is no compiled native binary build that must be bit-for-bit reproducible. Installation uses Composer for dependencies and optional Vite for frontend assets. README Build & test documents that reproducible compilation of shipped binaries is not applicable.


  • Système d'installation


    Le projet DOIT fournir un moyen d'installer et de désinstaller facilement le logiciel produit par le projet en utilisant une convention couramment utilisée. [installation_common]
    Des exemples comprennent l'utilisation d'un gestionnaire de paquets (au niveau du système ou du langage), « make/install/uninstall » (supportant DESTDIR), un conteneur dans un format standard ou une image de machine virtuelle dans un format standard. Le processus d'installation et de désinstallation (par exemple, son paquetage) PEUT être mis en œuvre par un tiers tant qu'il est FLOSS.

    https://github.com/imRezaAlie/openits/blob/main/README.md#quick-start

    OpenITS installs using the standard PHP/Laravel workflow: git clone, composer install, copy .env.example, php artisan key:generate, php artisan migrate, and php artisan serve. Quick start documents each step with commands. Uninstall is documented under the same README: stop services, optionally back up, drop the database, delete the application directory, and remove web server configuration — the usual approach for Composer-based Laravel deployments. CONTRIBUTING.md repeats the development install steps.



    Le système d'installation pour les utilisateurs finaux DOIT honorer les conventions standard pour sélectionner l'emplacement où les artefacts construits sont écrits au moment de l'installation. Par exemple, s'il installe des fichiers sur un système POSIX, il DOIT honorer la variable d'environnement DESTDIR. S'il n'y a pas de système d'installation ou pas de convention standard, sélectionnez « non applicable » (N/A). [installation_standard_variables]

    https://github.com/imRezaAlie/openits/blob/main/README.md#build--test

    OpenITS is a self-hosted PHP/Laravel application installed by cloning the repository and running Composer/Artisan commands. There is no POSIX make install or autotools installer that writes built artifacts using DESTDIR or similar standard variables. The deployment directory is chosen at clone time (Quick start). README Build & test documents that DESTDIR/prefix install conventions are not applicable.



    Le projet DOIT fournir un moyen pour les développeurs potentiels d'installer rapidement tous les résultats du projet ainsi que l'environnement nécessaire pour apporter des modifications, y compris les tests et l'environnement de test. Cela DOIT être effectué avec une convention couramment utilisée. [installation_development_quick]
    Cela PEUT être implémenté à l'aide d'un conteneur généré et/ou d'un script d'installation. Les dépendances externes sont généralement installées en invoquant des gestionnaires de paquets du système et/ou du langage, comme précisé dans external_dependencies.

    https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#development-setup

    CONTRIBUTING.md documents a quick developer setup using the standard PHP/Laravel convention: git clone, composer install (includes PHPUnit and Pint dev dependencies), cp .env.example .env, php artisan key:generate, php artisan migrate --seed, then composer test to verify the PHPUnit environment. A Test environment subsection explains phpunit.xml, RefreshDatabase, and optional SQLite for the fastest local setup. README Quick start and Build & test link to the same workflow and document composer test and composer lint.


  • Composants maintenus à l'extérieur


    Le projet DOIT afficher ses dépendances externes de manière analysable par ordinateur. (URL requise) [external_dependencies]
    Généralement, cela se fait en utilisant les conventions du gestionnaire de paquets et/ou du système de construction. Notez que cela permet d'implémenter installation_development_quick.

    https://github.com/imRezaAlie/openits/blob/main/composer.json

    External dependencies are listed in standard package-manager manifests: composer.json and composer.lock for PHP (Laravel and libraries), package.json and package-lock.json for optional frontend build tools. README Requirements links to these files and documents composer install / npm ci. This supports installation_development_quick via composer install.



    Les projets DOIVENT surveiller ou vérifier périodiquement leurs dépendances externes (y compris les copies de commodité) pour détecter les vulnérabilités connues, et corriger les vulnérabilités exploitables ou les vérifier comme inexploitables. [dependency_monitoring]
    Cela peut se faire à l'aide d'un outil d'analyse d'origine, de vérification de dépendance ou d'analyse de la composition du logiciel tel que Dependency-Check d'OWASP, Nexus Auditeur de Sonartype, Black Duck Software Composition Analysis de Synopsys, et Bundler-audit (pour Ruby). Certains gestionnaires de paquets comprennent des mécanismes pour le faire. Il est acceptable que la vulnérabilité des composants ne puisse pas être exploitée, mais cette analyse est difficile et il est parfois plus simple de mettre à jour ou de corriger la dépendance.

    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#dependency-monitoring

    OpenITS monitors third-party dependencies via GitHub Dependabot (weekly Composer and npm), a scheduled and on-push Dependency audit workflow (composer audit, npm audit), and GitHub dependency alerts. SECURITY.md documents triage: fix via dependency updates, or verify unexploitable with rationale. No vendored convenience copies; manifests are composer.lock and package-lock.json. Known remaining Laravel 11.x advisories without 11.x patches are tracked with mitigation notes pending Laravel 12 upgrade.



    Le projet DOIT :
    1. rendre facile l'identification et la mise à jour des composants maintenus extérieurement au projet ; ou
    2. utiliser des composants standards fournis par le système ou le langage de programmation.
    Ensuite, si une vulnérabilité se trouve dans un composant réutilisé, il sera facile de mettre à jour ce composant. [updateable_reused_components]
    Une façon typique de respecter ce critère est d'utiliser les systèmes de gestion des paquets du système et du langage de programmation. De nombreux programmes FLOSS sont distribués avec des « bibliothèques de commodité » qui sont des copies locales de bibliothèques standard (éventuellement dupliquées). En soi, c'est acceptable. Cependant, si le programme *doit* utiliser ces copies locales (dupliquées), la mise à jour des bibliothèques « standard » lors de mises à jour de sécurité laissera ces copies supplémentaires encore vulnérables. C'est particulièrement un problème pour les systèmes basés sur le cloud ; si le fournisseur du cloud met à jour ses librairies « standard » mais que le programme ne les utilise pas, les mises à jour ne vous aideront pas. Voir, par exemple, « Chromium : pourquoi il n'est pas encore un vrai paquet dans Fedora » par Tom Callaway.

    https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#updateable-reused-components

    Externally maintained components are listed in composer.json/composer.lock (PHP) and package.json/package-lock.json (npm). Updates use standard package managers and weekly Dependabot PRs; composer audit and npm audit run in CI. SECURITY.md documents identify/update steps for Composer and npm, and inventories committed static assets under public/vendor/ with upstream sources. vendor/ and node_modules/ are not committed. Vulnerability fixes are applied by merging dependency updates and running composer test.



    Le projet DEVRAIT éviter d'utiliser des fonctions et des API obsolètes quand des alternatives FLOSS sont disponibles dans l'ensemble de technologies qu'il utilise (sa « pile de technologies ») et disponibles à une large majorité des utilisateurs supportés par le projet (afin que les utilisateurs puissent avoir accès à l'alternative). [interfaces_current]

    https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#coding-standards

    OpenITS targets PHP 8.2+ and Laravel 11 (README Requirements). CONTRIBUTING.md instructs contributors to avoid deprecated or obsolete APIs when FLOSS alternatives exist in the stack: Eloquent and Form Requests instead of legacy database/validation patterns, Laravel Hash/random_bytes instead of weak crypto. The minimum PHP version excludes EOL runtimes for supported users. New code uses PHP 8.2 features (typed properties, return types).


  • Suite de tests automatisée


    Une suite de tests automatisée DOIT être appliquée à chaque commit dans un dépôt partagé pour au moins une branche. Cette suite de tests DOIT produire un rapport sur le succès ou l'échec du test. [automated_integration_testing]
    Cette exigence peut être considérée comme un sous-ensemble de test_continuous_integration, mais axée sur le simple test, sans nécessiter une intégration continue.

    https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#coding-standards

    OpenITS targets PHP 8.2+ and Laravel 11 (README Requirements). CONTRIBUTING.md instructs contributors to avoid deprecated or obsolete APIs when FLOSS alternatives exist in the stack: Eloquent and Form Requests instead of legacy database/validation patterns, Laravel Hash/random_bytes instead of weak crypto. The minimum PHP version excludes EOL runtimes for supported users. New code uses PHP 8.2 features (typed properties, return types).



    Le projet DOIT ajouter des tests de régression à une suite de tests automatisée pour au moins 50% des bogues corrigés au cours des six derniers mois. [regression_tests_added50]

    In the last six months there were multiple bug fixes (MySQL index length, asset paths, data-stack loading, integration tree, CRUD/UI, security hardening, etc.), but only some areas—mainly authentication/security—have automated regression tests. There is no evidence that ≥50% of those fixed bugs have corresponding regression tests in the suite, and several hotfixes have no dedicated tests at all.

    To reach Met, track fixed bugs from the last six months and add regression tests for at least half of them (or document a policy + evidence in CONTRIBUTING/issues linking each fix to a test).



    Le projet DOIT avoir une ou des suites de tests automatisées FLOSS qui fournissent une couverture d'instructions d'au moins 80% s'il existe au moins un outil FLOSS qui peut mesurer ce critère dans le langage sélectionné. [test_statement_coverage80]
    De nombreux outils FLOSS sont disponibles pour mesurer la couverture des tests, y compris gcov/lcov, Blanket.js, Istanbul, JCov et covr (R). Notez que respecter ce critère n'est pas une garantie que la suite de tests est complète, mais, à l'inverse, ne pas respecter ce critère est un indicateur fort d'une suite de tests insuffisante.

    PHP has FLOSS coverage tools (PHPUnit with PCOV or Xdebug), so this criterion applies.

    OpenITS does not currently meet or enforce 80% statement coverage: there is no coverage reporting in CI, no coverage threshold in phpunit.xml, and the existing 69 tests focus on auth/C4/settings—not enough to plausibly cover ≥80% of statements across app/.

    To work toward Met: add PCOV in the Tests workflow, run php artisan test --coverage --min=80 (or PHPUnit with a coverage report), and expand tests until coverage stays at or above 80%.


  • Nouveau test de fonctionnalité


    Le projet DOIT avoir une politique écrite formelle, que dès qu'une nouvelle fonctionnalité majeure est ajoutée, des tests pour la nouvelle fonctionnalité DOIVENT être ajoutés à une suite de tests automatisée. [test_policy_mandated]

    Formal policy is in CONTRIBUTING.md § Test policy: “New major functionality must include tests” (PHPUnit feature/unit tests in tests/Feature/ or tests/Unit/). It is also required in the contribution steps and PR checklist, and linked from README.

    URL: https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#test-policy



    Le projet DOIT inclure, dans ses instructions documentées pour les propositions de changement, la politique selon laquelle des tests doivent être ajoutés pour toute nouvelle fonctionnalité majeure. [tests_documented_added]
    Cependant, même une règle informelle est acceptable tant que les tests sont ajoutés dans la pratique.

    The test policy is documented in CONTRIBUTING.md, which is the project's change-proposal guide. It instructs contributors to add tests for new major functionality, describes where to place them, and includes a PR checklist item requiring tests for new features.

    Key URLs:


  • Options d'avertissement


    Les projets DOIVENT être maximalement stricts avec les avertissements dans le logiciel produit par le projet, quand cela est approprié. [warnings_strict]
    Certains avertissements ne peuvent être efficacement activés sur certains projets. Ce qui est nécessaire est la preuve que le projet s'efforce d'activer les options d'avertissements où il peut, de sorte que les erreurs soient détectées tôt.

    For PHP, the project applies practical strictness where compiler-style warning flags are not available: Laravel Pint enforces PSR-12 across the entire codebase (composer lint passes on 241 files with zero issues), CONTRIBUTING.md requires lint before pull requests, and coding standards encourage declare(strict_types=1), typed properties, and return types on PHP 8.2+.

    Key URLs:


 Sécurité 13/13

  • Connaissance du développement sécurisé


    Le projet DOIT implémenter des principes de conception sécurisés (à partir de « know_secure_design »), quand cela est approprié. Si le projet ne produit pas de logiciel, sélectionnez « non applicable » (N/A). [implement_secure_design]
    Par exemple, les résultats du projet devraient avoir des valeurs sécurisées par défaut (les décisions d'accès devraient être de refuser par défaut et l'installation des projets devrait être sécurisée par défaut). Ils devraient également avoir une médiation complète (tout accès qui pourrait être limité doit être vérifié pour l'autorité et être non contournable). Notez que, dans certains cas, ces principes entrent en conflit, auquel cas un choix doit être fait (par exemple, de nombreux mécanismes peuvent rendre les choses plus complexes, en contravention de « l'économie de mécanisme » / principe KISS).

    OpenITS applies secure-design practices in code and docs: secure defaults (REGISTRATION_ENABLED=false, APP_DEBUG=false in production), least privilege (admin-only settings), input validation (Form Requests), defense in depth (rate limiting, security headers, Sanctum, LDAPS/TLS), fail-secure login lockouts, and bcrypt/random_bytes() for secrets — documented under README Security and SECURITY.md (crypto, hardening, vulnerability process).

    URL: https://github.com/imRezaAlie/openits/blob/main/README.md#security
    (or https://github.com/imRezaAlie/openits/blob/main/SECURITY.md


  • Utiliser de bonnes pratiques de base de cryptographie

    Notez que certains logiciels n'ont pas besoin d'utiliser des mécanismes cryptographiques. Si votre projet produit un logiciel qui (1) inclut ou active la fonctionnalité de chiffrement, et (2) peut être publié des États-Unis (US) vers l'extérieur des États-Unis ou vers un citoyen autre qu'américain, vous pouvez être légalement obligé à faire quelques étapes supplémentaires. En règle générale, cela implique simplement l'envoi d'un email. Pour plus d'informations, consultez la section sur le chiffrement de Comprendre la technologie Open Source et les contrôles à l'exportation américains .

    Les mécanismes de sécurité par défaut dans le logiciel produit par le projet NE DOIVENT PAS dépendre d'algorithmes ou de modes cryptographiques avec des faiblesses sérieuses connues (par exemple, l'algorithme de hachage cryptographique SHA-1 ou le mode CBC en SSH). [crypto_weaknesses]
    Les préoccupations concernant le mode CBC en SSH sont discutées dans CERT : vulnérabilité SSH CBC.

    OpenITS avoids cryptographic algorithms and modes with known serious weaknesses in its default security mechanisms. Password hashing uses bcrypt (not SHA-1). Application encryption uses AES-256-CBC via Laravel (not SSH CBC). API tokens use Laravel Sanctum (SHA-256 class hashing). The project does not implement SSH or use MD5, SHA-1, DES, or RC4 for security-sensitive operations. SECURITY.md documents avoidance of weak algorithms.

    Key URLs: https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#cryptography-practices https://github.com/imRezaAlie/openits/blob/main/config/app.php https://github.com/imRezaAlie/openits#security



    Le projet DEVRAIT supporter plusieurs algorithmes cryptographiques, afin que les utilisateurs puissent rapidement changer si l'un deux est cassé. Les algorithmes à clés symétriques courants incluent AES, Twofish et Serpent. Les alternatives d'algorithme de hachage cryptographique courantes incluent SHA-2 (y compris SHA-224, SHA-256, SHA-384 ET SHA-512) et SHA-3. [crypto_algorithm_agility]

    OpenITS relies on fixed Laravel/PHP defaults—mainly bcrypt for passwords and AES-256-CBC for app encryption (config/app.php)—without documenting or exposing quick switching among multiple symmetric algorithms (e.g. AES / Twofish / Serpent) or hash families (SHA-2 variants / SHA-3). BCRYPT_ROUNDS adjusts strength, not algorithm. Laravel can use Argon2 via HASH_DRIVER, but OpenITS does not document that as a supported, user-facing agility option.

    URL (current crypto docs): https://github.com/imRezaAlie/openits/blob/main/SECURITY.md#cryptography-practices



    Le projet DOIT supporter le stockage des informations d'authentification (comme les mots de passe et les jetons dynamiques) et des clés cryptographiques privées dans des fichiers distincts des autres informations (fichiers de configuration, bases de données et journaux) et permettre aux utilisateurs de les mettre à jour et de les remplacer sans recompilation de code. Si le projet ne traite jamais d'informations d'authentification et de clés cryptographiques privées, sélectionnez « non applicable » (N/A). [crypto_credential_agility]

    Le logiciel produit par le projet DEVRAIT supporter des protocoles sécurisés pour toutes ses communications réseau, tels que SSHv2 ou ultérieur, TLS1.2 ou ultérieur (HTTPS), IPsec, SFTP et SNMPv3. Les protocoles non sûrs tels que FTP, HTTP, telnet, SSLv3 ou antérieur, et SSHv1 DEVRAIENT être désactivés par défaut et uniquement activés si l'utilisateur le configure spécifiquement. Si le logiciel produit par le projet ne prend pas en charge les communications réseau, sélectionnez « non applicable » (N/A). [crypto_used_network]

    Le logiciel produit par le projet DEVRAIT, s'il prend en charge ou utilise TLS, prendre en charge au moins TLS version 1.2. Notez que le prédécesseur de TLS s'appelait SSL. Si le logiciel n'utilise pas TLS, sélectionnez « non applicable » (N/A). [crypto_tls12]

    Le logiciel produit par le projet DOIT, s'il prend en charge TLS, effectuer la vérification des certificats TLS par défaut lors de l'utilisation de TLS, y compris sur les sous-ressources. Si le logiciel n'utilise pas TLS, sélectionnez « non applicable » (N/A). [crypto_certificate_verification]

    Le logiciel produit par le projet DOIT, s'il supporte TLS, effectuer une vérification de certificat avant d'envoyer des en-têtes HTTP avec des informations privées (telles que des cookies sécurisés). Si le logiciel n'utilise pas TLS, sélectionnez « non applicable » (N/A). [crypto_verification_private]
  • Livraison sécurisée


    Le projet DOIT signer cryptographiquement les versions des résultats du projet destinées à une utilisation répandue, et il DOIT y avoir un processus documenté expliquant aux utilisateurs comment ils peuvent obtenir les clés de signature publique et vérifier la ou les signatures. La clé privée pour ces signature(s) NE DOIT PAS être sur le(s) site(s) utilisé(s) pour distribuer directement le logiciel au public. Si les versions ne sont pas destinées à une utilisation répandue, sélectionnez « non applicable » (N/A). [signed_releases]
    Les résultats du projet incluent à la fois le code source et les produits livrés générés, le cas échéant (par exemple, les exécutables, les paquetages et les conteneurs). Les livrables générés PEUVENT être signés séparément du code source. Ces signatures PEUVENT être mises en œuvre sous forme de tags git signées (utilisant des signatures numériques cryptographiques). Les projets PEUVENT fournir des résultats générés séparément d'outils comme git, mais dans ce cas, les résultats distincts DOIVENT être signés séparément.

    OpenITS distributes software for public use (GitHub clone, GitHub Releases e.g. v1.1.0), so this is not N/A.

    What is missing for signed_releases:



    Il est PROPOSÉ que, dans le système de contrôle de la version, chaque tag d'une version importante (un tag faisant partie d'une version majeure, d'une version mineure ou qui corrige des vulnérabilités notées publiquement) soit cryptographiquement signé et vérifiable comme décrit dans signed_releases. [version_tags_signed]

    OpenITS publishes version tags (e.g. v1.1.0; see GOVERNANCE.md) and uses DCO commit sign-off (git commit -s), but release tags are not cryptographically GPG-signed or documented for verification per signed_releases.

    To meet it: sign important tags with GPG (git tag -s v1.2.0 -m "...") and document verification steps in RELEASE/SECURITY docs.


  • Autres problèmes de sécurité


    Les résultats du projet DOIVENT vérifier toutes les entrées provenant de sources potentiellement non fiables pour s'assurer qu'elles sont valides (une liste blanche) et rejeter les entrées non valides, en cas de restrictions sur les données. [input_validation]
    Notez que la comparaison de l'entrée par rapport à une liste de « mauvais formats » (aussi appelée liste noire) n'est normalement pas suffisante, car les attaquants peuvent souvent contourner une liste noire. En particulier, les nombres sont convertis en formats internes puis vérifiés pour s'assurer s'ils se situent entre leur minimum et maximum (inclus), et les chaînes de texte sont vérifiées pour s'assurer qu'elles sont des motifs de texte valides (par exemple, UTF-8 valide, longueur valide, syntaxe valide, etc.). Certaines données peuvent avoir besoin d'être « du tout venant » (par exemple, un téléchargement de fichier), mais celles-ci sont généralement rares.

    Untrusted input is validated with allowlists and rejected when invalid: Laravel Form Request classes (app/Http/Requests/) and $request->validate() across controllers use Rule::in(), in:…, type/length rules, and related constraints (e.g. API version status ∈ {active,deprecated,draft}, LDAP domain limited to configured domains, enum fields for data layers and diagram types). Invalid input is rejected by Laravel validation before business logic runs. Policy is documented in CONTRIBUTING (Form Requests required) and ASSURANCE_CASE (SR-4).

    URL: https://github.com/imRezaAlie/openits/blob/main/CONTRIBUTING.md#coding-standards
    Example code: https://github.com/imRezaAlie/openits/blob/main/app/Http/Requests/Auth/LdapLoginRequest.php



    Les mécanismes de durcissement DOIVENT être utilisés dans le logiciel produit par le projet afin que les défauts du logiciel soient moins susceptibles d'entraîner des vulnérabilités de sécurité. [hardening]
    Les mécanismes de durcissement peuvent inclure des en-têtes HTTP comme Content Security Policy (CSP), des options de compilation pour atténuer les attaques (telles que -fstack-protector) ou des options de compilation pour éliminer les comportements indéfinis. Pour nos besoins, le principe de plus faible privilège n'est pas considéré comme un mécanisme de durcissement (le principe de plus faible privilège est important, mais séparé).

    OpenITS uses several hardening mechanisms that limit the impact of defects: login rate limiting (LoginThrottleService), security headers middleware, secure production defaults (APP_DEBUG=false, SESSION_ENCRYPT, SESSION_SECURE_COOKIE), LDAPS/TLS and LDAP filter escaping, SSRF checks on LDAP host tests, CSRF protection, bcrypt password hashing, Sanctum token expiration, optional C4 share passwords, and deployment hardening (DEPLOYMENT_ENABLED=false, REGISTRATION_ENABLED=false by default).

    URL: https://github.com/imRezaAlie/openits/blob/main/README.md#security
    (or https://github.com/imRezaAlie/openits/blob/main/SEC



    Le projet DOIT fournir une analyse de fiabilité qui justifie pourquoi ses exigences de sécurité sont respectées. L'analyse de fiabilité DOIT inclure : une description du modèle de menace, une identification claire des limites de confiance, un argument selon lequel des principes de conception sécurisés ont été appliqués et un argument selon lequel les faiblesses de sécurité courantes de l'implémentation ont été contrées. (URL requise) [assurance_case]
    Une analyse de fiabilité est « une preuve documentée qui fournit un argumentaire convaincant et correct selon lequel un ensemble spécifié de revendications critiques concernant les propriétés d'un système est adéquatement justifié pour une application donnée dans un environnement donné » (« Software Assurance Using Structured Assurance Case Models », Thomas Rhodes et al, NIST Interagency Report 7608). Les limites de confiance sont des limites où les données ou l'exécution modifient leur niveau de confiance, par exemple, les limites d'un serveur dans une application Web typique. Il est fréquent d'énumérer des principes de conception sécurisés (tels que Saltzer et Schroeer) et des faiblesses de sécurité courantes de l'implémentation (comme le OWASP top 10 ou le CWE/SANS top 25) et de montrer comment chacun est contré. L'analyse de fiabilité de BadgeApp peut être un exemple utile. Ceci est lié à documentation_security, documentation_architecture et implement_secure_design.

    https://github.com/imRezaAlie/openits/blob/main/ASSURANCE_CASE.md

    ASSURANCE_CASE.md is the formal security assurance case. It defines security requirements (SR-1–SR-7), a STRIDE-oriented threat model (assets, adversaries, threats), trust boundaries (client/TLS, public vs authenticated vs admin, data plane), arguments that secure design principles are applied (secure defaults, least privilege, defense in depth, fail secure), and a mapping of common implementation weaknesses (SQLi, XSS, CSRF, broken auth, LDAP injection, SSRF, weak crypto, vulnerable dependencies) to concrete OpenITS controls and code/docs. Linked from SECURITY.md, README Security, and GOVERNANCE.md.


 Analyse 2/2

  • Analyse statique de code


    Le projet DOIT utiliser au moins un outil d'analyse statique avec des règles ou des approches pour rechercher des vulnérabilités courantes dans le langage ou l'environnement analysé, s'il existe au moins un outil FLOSS qui peut mettre en œuvre ce critère dans le langage sélectionné. [static_analysis_common_vulnerabilities]
    Les outils d'analyse statique spécialement conçus pour détecter les vulnérabilités les plus courantes sont plus susceptibles de les détecter. Cela dit, l'utilisation d'outils statiques aidera généralement à trouver des problèmes, nous suggérons donc, sans l'exiger, de le faire pour le badge de niveau « passant ».

    No static analysis tool with vulnerability-detection rules is configured. Adding Larastan/PHPStan with security-focused rules (e.g., phpstan/phpstan-strict-rules or a security plugin) would satisfy this criterion.
    Key URLs:
    https://github.com/imRezaAlie/openits/blob/main/composer.json
    https://github.com/imRezaAlie/openits/blob/main/pint.json


  • Analyse dynamique de code


    Si le logiciel produit par le projet inclut un logiciel écrit à l'aide d'un langage non sûr pour les accès mémoire (par exemple C ou C++), alors le projet DOIT utiliser au moins un outil dynamique (par exemple, un fuzzer ou un scanneur d'application Web) utilisé de manière routinière en combinaison avec un mécanisme permettant de détecter des problèmes de sécurité mémoire tels que les dépassement mémoire. Si le projet ne produit pas de logiciel écrit dans un langage non sûr pour les accès mémoire, sélectionnez « non applicable » (N/A). [dynamic_analysis_unsafe]
    Des exemples de mécanismes pour détecter les problèmes de sécurité de la mémoire comprennent Address Sanitizer (ASAN) (disponible dans GCC et LLVM), Memory Sanitizer et valgrind. D'autres outils potentiellement utilisés incluent thread sanitizer et undefined behavior sanitizer. La généralisation de l'utilisation des assertions fonctionnera également.

    The project is a Laravel (PHP) web application with JavaScript frontend assets. No C/C++ or other memory-unsafe language code is produced by the project.

    Key URL:
    https://github.com/imRezaAlie/openits/blob/main/composer.json



Ces données sont disponibles sous la licence Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0). Cela signifie qu'un destinataire de données peut partager les données, avec ou sans modifications, à condition que le destinataire de données rende disponible le texte de cet accord avec les données partagées. Veuillez créditer Reza et les contributeurs du badge des meilleures pratiques de la OpenSSF.

Soumission du badge du projet appartenant à : Reza.
Soumission créée le 2026-06-24 09:21:24 UTC, dernière mise à jour le 2026-06-24 12:36:55 UTC. Le dernier badge obtenu l'a été le 2026-06-24 11:07:00 UTC.