Artemis

遵循以下最佳实践的项目将能够自愿的自我认证,并显示他们已经实现了核心基础设施计划(OpenSSF)徽章。

没有一套可以保证软件永远不会有缺陷或漏洞的做法;如果规范或假设是错误的,即使合适的方法也可能失败。也没有哪些做法可以保证一个项目能够维持健康和运作良好的开发者社区。但是,遵循最佳做法可以帮助改善项目的成果。例如,一些做法可以在发布之前进行多人评估,这可以帮助您找到其他难以找到的技术漏洞,并帮助建立信任,并希望不同公司的开发人员之间进行重复的交互。要获得徽章,必须满足所有“必须”和“禁止”的条款,满足所有“应该”条款或有合适的理由,和所有“建议”条款必须满足或未满足(至少希望考虑)。欢迎通过 GitHub网站创建问题或提出请求进行反馈。另外还有一个一般讨论邮件列表。

如果这是您的项目,请在您的项目页面上显示您的徽章状态!徽章状态如下所示: 项目14163的徽章级别为silver 这里是如何嵌入它:
您可以通过将其嵌入在您的Markdown文件中:
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14163/badge)](https://www.bestpractices.dev/projects/14163)
或将其嵌入到HTML中来显示您的徽章状态:
<a href="https://www.bestpractices.dev/projects/14163"><img src="https://www.bestpractices.dev/projects/14163/badge"></a>


这些是黄金级别条款。您还可以查看通过或白银级别条款。

Baseline Series: 基准等级1 基准等级2 基准等级3

        

 基本 3/5 ●

  • 常规

    请注意,其他项目可能使用相同的名称。

    Artemis - Interactive Learning with Automated Feedback

    请使用 SPDX许可证表达格式;例子包括“Apache-2.0”,“BSD-2-Clause”,“BSD-3-Clause”,“GPL-2.0+”,“LGPL-3.0 +”,“MIT”和“(BSD-2-Clause OR Ruby)”。
    如果有多种语言,请将它们列为逗号分隔值(可选空格),并将它们从最多到最少使用。如果有长列表,请至少列出前三个最常见的列表。如果没有语言(例如,这是仅文档或仅测试项目),请使用单个字符“ - ”。请使用每种语言的常规大小写,例如“JavaScript”。
    通用平台枚举(CPE)是用于信息技术系统,软件和软件包的结构化命名方案。在报告漏洞时,它可用于多个系统和数据库。
  • 先决条件


    该项目必须拥有银级徽章。 [achieve_silver]

  • 项目监督


    项目必须具有2个或更多的“公交车因子”。 (需要网址) [bus_factor]
    “公交车系数”(又名“卡车因子”)是指最少数量的项目成员,如果突然离开项目(“被公交车撞了”),项目会由于缺乏具备知识的或有能力的人员而暂停。 卡车因子 工具可以对GitHub上的项目进行估计。有关详细信息,请参阅Cosentino等人的评估Git存储库的卡车因子。

    Multiple active maintainers share development, review, merge, and release responsibilities. The maintainer confirmed independent continuity access for at least two people. https://docs.artemis.tum.de/about/governance



    该项目必须至少有两个不相关的重要贡献者。 (需要网址) [contributors_unassociated]
    如果同一组织(作为雇员或承包商)支付工作费用,并且组织将从项目的结果中受益,则贡献者是相关联的。如果通过其他组织得到财务补助(例如,源自政府或非政府组织,支付给不同组织的科学补助金不会导致捐助者关联),不视为来自同一组织。重要贡献者定义为过去一年对项目做出了不平凡的贡献。一个重要贡献者的良好指标的例子是:编写至少1,000行代码,贡献50个提交或至少提交20页的文档。

    Reviewed 2025-10-19 through 2026-10-19. Benedikt Fein (University of Passau, b-fein) made substantive merged documentation and programming-exercise changes: https://github.com/ls1intum/Artemis/pull/11583 and https://github.com/ls1intum/Artemis/pull/12661 . Eduard Frankford (University of Innsbruck, eduardfrankford) contributed a websocket deadlock fix and regression tests, lecture form improvements and a coverage-tooling correction: https://github.com/ls1intum/Artemis/pull/13834 , https://github.com/ls1intum/Artemis/pull/13965 and https://github.com/ls1intum/Artemis/pull/14243 . The maintainer confirmed the distinct university affiliations on 2026-10-19; staff listings corroborate them: https://www.fim.uni-passau.de/en/chair-for-software-engineering-ii/team and https://www.uibk.ac.at/de/informatik/team/ . These are non-trivial contributions; the numerical examples are not mandatory minimums.


  • 其他


    项目必须在每个源文件中包含许可证声明。这可以通过在每个文件开头附近的注释中加入以下内容来实现: SPDX-License-Identifier: [SPDX license expression for project]。 [license_per_file]
    这可以通过在自然语言中包含许可证标识来完成。该项目还可以包括完整许可证文本,或者指向许可证文本的稳定URL。请注意,license_location条款要求项目许可证在标准位置。有关SPDX许可证表达式的更多信息,请参阅SPDX教程。请注意与 copyright_per_file 的关系,其内容通常在许可证信息之前。

    The repository has an MIT LICENSE, but source files do not uniformly carry a license statement or SPDX identifier. Generated source needs a generator-level solution. https://github.com/ls1intum/Artemis/blob/develop/LICENSE


 变更控制 2/4 ●

  • 公开的版本控制的源代码存储库


    必须使用通用的分布式版本控制软件(例如,git,mercurial)作为项目的源代码存储库。 [repo_distributed]
    Git不是必须,项目在合适场景可以使用集中版本控制软件(如subversion)。

    The public repository uses Git with complete clone/fork support. https://github.com/ls1intum/Artemis



    该项目必须清楚地识别新的或临时贡献者可以执行的小型任务。 (需要网址) [small_tasks]
    此标识通常通过在项目使用的一个或多个标签的问题跟踪器中标记所选问题来完成,例如 up- for-grabs ,仅限第一时间,“小修复”,微任务或IdealFirstBug。这些新任务不需要添加功能;他们可以改进文档,添加测试用例或其他有助于项目的内容,并帮助贡献者更了解项目。

    The good first issue label identifies tasks for new contributors, and CONTRIBUTING links it. https://github.com/ls1intum/Artemis/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22



    项目必须要求开发人员使用双因素身份验证(2FA)来更改中央存储库或访问敏感数据(如私密漏洞报告)。这种2FA机制可以使用没有密码学机制的方案,如SMS(短消息),尽管不推荐。 [require_2FA]

    The authenticated GitHub organization API still reported two_factor_requirement_enabled=false for ls1intum on 2026-10-19. No alternative requirement covering all central-repository changes and private-vulnerability-report access has been verified. Individual accounts using 2FA do not establish mandatory enforcement. Coordinate any account-access changes with authorized organization administrators. https://github.com/ls1intum



    项目的双因素身份认证(2FA)应该使用加密机制来防止仿冒。基于短消息服务(SMS)的2FA本身不符合此标准,因为它不被加密。 [secure_2FA]
    满足此条款的2FA机制将是一种基于时间的一次性密码(TOTP)应用程序,可自动生成在一段时间后更改的验证码。请注意, GitHub支持TOTP 。

 质量 7/7 ●

  • 编码标准


    该项目必须记录其代码检视需求,包括代码检视是如何进行的,必须检查的内容以及哪些是可接纳的内容。 (需要网址) [code_review_standards]
    另请参阅 two_person_review 和contribution_requirements 条款。

    Contribution and reviewer guidelines document author tasks, four-reviewer expectations, feature-maintainer approval, final review, and CI readiness. https://docs.artemis.tum.de/developer/reviewer-guidelines and https://github.com/ls1intum/Artemis/blob/develop/.github/CONTRIBUTING.md



    该项目必须至少有50%的修改(作者之外的人提出的)在发布之前审查,以确定是否是一个有价值的修改,并且没有已知的问题,会反对其包含 [two_person_review]

    The 2026-10-19 OpenSSF Scorecard scan at merged revision 3d0bd7dfb4cd077394cc7cc22293855ed0dad9d5 found 27 of 30 changesets approved by reviewers, above the 50% threshold (Code-Review 9/10; overall Scorecard 9.0). An independent check of the 28 PR merges among the latest 30 first-parent commits found 27 had a non-author human approval before merge, including all three coverage PRs. This records recent practice; reassess the preceding release interval when updating the criterion. https://api.securityscorecards.dev/projects/github.com/ls1intum/Artemis ; https://github.com/ls1intum/Artemis/pull/14286 ; https://github.com/ls1intum/Artemis/pull/14280 ; https://github.com/ls1intum/Artemis/pull/14279


  • 可工作的构建系统


    该项目必须具有可重复构建。如果没有发生构建(例如,直接使用源代码而不是编译的脚本语言),请选择“不适用”(N/A)。 (需要网址) [build_reproducible]
    可重复的构建意味着多方可以独立地重做从源文件生成信息的过程,并获得每比特完全相同的结果。在某些情况下,这可以通过强制某种排序来解决。 JavaScript开发人员可能会考虑使用npm shrinkwrap和webpack的OccurenceOrderPlugin。 GCC和clang用户可能会发现-frandom-seed选项有用。通常可以通过指定可用于重新构建的特定容器或虚拟机的加密散列来为外部方定义构建环境(包括工具集)。 可重复构建项目具有文档指导如何执行此操作。

    On 2026-10-19 the project maintainer confirmed that another maintainer independently built the same source revision in a separate build and obtained the identical complete WAR SHA-256. This records the maintainer attestation of independent bit-for-bit reproduction. The documented release-build procedure regenerates the production client, compiled server and bundled SBOMs using -Preproducible, frozen dependencies, controlled toolchain inputs and no reused build output: https://docs.artemis.tum.de/developer/best-practices#repeatable-builds . Implementation and the earlier controlled-environment build pair are documented in https://github.com/ls1intum/Artemis/pull/14258 . The earlier same-checkout pair establishes repeatability; the separately confirmed independent rebuild supplies the Gold evidence. A container image is one possible way to describe a build environment, not a mandatory form of this criterion.


  • 自动测试套件


    测试套件必须以该语言的标准方式进行调用。 (需要网址) [test_invocation]
    例如“make check”,“mvn test”或“rake test”。

    The standard Gradle wrapper test and pnpm Vitest commands are documented. https://docs.artemis.tum.de/developer/setup



    该项目必须实施持续集成,将新的或更改的代码经常集成到中央代码库中,并对结果进行自动化测试。 (需要网址) [test_continuous_integration]
    在大多数情况下,这意味着每个在项目上全职工作的开发人员至少每天都会整合。

    The CI workflow tests pull requests and protected-branch pushes and publishes test reports. https://github.com/ls1intum/Artemis/blob/develop/.github/workflows/ci.yml



    如果有至少一个FLOSS工具可以以所选语言度量此条款,该项目的FLOSS自动测试套件必须具有至少90%语句覆盖率。 [test_statement_coverage90]

    Client Vitest statements: 82,875/90,018 (92.06%) in complete successful CI https://github.com/ls1intum/Artemis/actions/runs/39163316687 . Client production sources match merged develop 3d0bd7dfb4cd077394cc7cc22293855ed0dad9d5. Complete successful seven-shard server CI for merged PR #14286 reports 91.98% JaCoCo instructions, the Java statement proxy: https://github.com/ls1intum/Artemis/actions/runs/39164068412 . Recombining all seven passing execution artifacts from that run and https://github.com/ls1intum/Artemis/actions/runs/39163868255 plus https://github.com/ls1intum/Artemis/actions/runs/39160461237 against the merged production classes gives 534,108/577,958 instructions (92.41%) and 99,314/107,851 lines (92.08%), preserving existing exclusions. This is a recomputed union of complete successful CI runs, not a new standalone develop run. The README weighted line badge is not used as statement evidence.



    如果有至少一个FLOSS工具可以以所选语言度量此条款,该项目的FLOSS自动测试套件必须具有至少80%分支覆盖率。 [test_branch_coverage80]

    Client Vitest branches: 33,791/42,138 (80.19%) in complete successful CI https://github.com/ls1intum/Artemis/actions/runs/39163316687 ; client production sources match merged develop 3d0bd7dfb4cd077394cc7cc22293855ed0dad9d5. Complete successful seven-shard server CI for merged PR #14286 reports 38,456/47,889 branches (80.30%): https://github.com/ls1intum/Artemis/actions/runs/39164068412 . Recombining passing execution data from all seven shards of that run plus https://github.com/ls1intum/Artemis/actions/runs/39163868255 and https://github.com/ls1intum/Artemis/actions/runs/39160461237 against merged production classes gives 38,842/47,897 branches (81.09%), with existing exclusions. The recomputation is not a new standalone CI run. Both application language suites exceed 80%.


 安全 3/5 ●

  • 使用基础的良好加密实践

    请注意,某些软件不需要使用加密机制。

    项目生成的软件必须支持所有网络通信的安全协议,如SSHv2或更高版本,TLS1.2或更高版本(HTTPS),IPsec,SFTP和SNMPv3。默认情况下,FTP,HTTP,Telnet,SSLv3或更早版本以及SSHv1等不安全协议必须被禁用,只有在用户专门配置时才启用。如果项目生成的软件不支持网络通信,请选择“不适用”(N/A)。 [crypto_used_network]

    HTTPS and SSH are supported, and operators must protect external traffic. Some distributed deployment links use plaintext protocols inside an operator-controlled private network; secure deployment requires isolation or additional TLS termination. This exception is documented rather than claiming universal TLS defaults. https://github.com/ls1intum/Artemis/blob/develop/.github/SECURITY.md#infrastructure-and-transport-security



    由项目生成的软件必须,如果支持或使用TLS,至少支持TLS版本1.2。请注意,TLS的前身称为SSL。如果软件不使用TLS,请选择“不适用”(N/A)。 [crypto_tls12]

    Supported Java/Node runtimes and the documented production TLS configuration support TLS 1.2 and later; external reverse-proxy TLS configuration remains the operator responsibility. https://github.com/ls1intum/Artemis/blob/develop/src/main/resources/config/application-prod.yml


  • 安全交付防御中间人(MITM)的攻击


    项目网站,存储库(如果可通过网络访问)和下载站点(如果单独)必须包括具有非允许值的密钥加固头。 (需要网址) [hardened_site]
    请注意,GitHub是已知满足的。 https://securityheaders.io/ 等网站可以快速查看。主要头加固包含:内容安全策略(CSP),HTTP严格传输安全性(HSTS),X-Content-Type-Options(“nosniff”),X-Frame-Options和X-XSS-Protection。

    Rechecked HTTPS GET responses on 2026-10-19. https://artemis.tum.de/ now returns HSTS, X-Content-Type-Options: nosniff, X-Frame-Options: DENY, and Content-Security-Policy. https://docs.artemis.tum.de/ returns none of those four headers. Gold explicitly requires them even for fully static sites. Configure the documentation hosting/proxy response headers and verify all project, repository and download endpoints before marking Met.


  • 其他安全问题


    该项目必须在过去5年内进行安全审查。此审查必须考虑安全需求和安全边界。 [security_review]
    这可以由项目成员完成和/或独立评估。此评估可能由静态和动态分析工具支持,但还必须进行人工审查,以确定工具无法检测到的问题(特别是设计问题)。

    On 2026-10-19 the project maintainer confirmed monthly internal human security reviews by the core maintainer team, including the documented security requirements and trust boundaries. This meets the five-year window. The reviewed requirements and boundaries are documented at https://docs.artemis.tum.de/developer/security-assurance and https://github.com/ls1intum/Artemis/blob/develop/.github/SECURITY.md#security-audits-and-open-source-transparency . The confirmation concerns actual human reviews; an assurance document or automated scans alone are not treated as substitutes. Confidential findings need not be published in this entry.



    加固机制必须用于项目生产的软件,以便软件缺陷不太可能导致安全漏洞。 (需要网址) [hardening]
    加固机制可能包括HTTP头,如内容安全策略(CSP),用于减轻攻击的编译器标志(如-fstack-protector)或用以消除未定义行为的编译器标志。对于此条款的目的,最小权限不被认为是一种加固机制(最少权限是重要的,但是另有条款)。

    Production startup rejects published default credentials; documented headers, rendering restrictions, build isolation and security analysis provide defense in depth. https://github.com/ls1intum/Artemis/blob/develop/.github/SECURITY.md


 分析 2/2 ●


您可以使用工具和AI系统通过简单的URL提交变更建议,例如 https://www.bestpractices.dev/zh-CN/projects/14163/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforced。请参阅我们的自动化提案系统,了解具体操作方法。 该数据可在社区数据许可协议 – 许可性,版本 2.0 (CDLA-Permissive-2.0)下获取。这意味着数据接收方可以共享数据,无论是否经过修改,只要数据接收方在共享数据时提供本协议文本。请注明Stephan Krusche和OpenSSF最佳实践徽章贡献者。

项目徽章条目拥有者: Stephan Krusche.
最后更新于 2026-08-19 23:37:57 UTC, 最后更新于 2026-10-19 12:17:00 UTC。 最后在2026-10-17 11:01:01 UTC丢失通过徽章。 最后在 2026-10-17 11:03:02 UTC 获得通过徽章。