AerolVM

Projetos que seguem as melhores práticas abaixo podem se autocertificar voluntariamente e mostrar que alcançaram um selo de melhores práticas da Open Source Security Foundation (OpenSSF).

Não existe um conjunto de práticas que possa garantir que o software nunca terá defeitos ou vulnerabilidades; mesmo métodos formais podem falhar se as especificações ou suposições estiverem erradas. Nem existe qualquer conjunto de práticas que possa garantir que um projeto sustentará uma comunidade de desenvolvimento saudável e bem-funcionada. No entanto, seguir as melhores práticas pode ajudar a melhorar os resultados dos projetos. Por exemplo, algumas práticas permitem revisão multipessoal antes do lançamento, o que pode ajudar a encontrar vulnerabilidades técnicas difíceis de encontrar e ajudar a construir confiança e desejo de interação repetida entre desenvolvedores de diferentes empresas. Para ganhar um selo, todos os critérios DEVE e NÃO DEVE devem ser atendidos, todos os critérios DEVERIA devem ser atendidos OU não atendidos com justificativa, e todos os critérios SUGERIDO devem ser atendidos OU não atendidos (queremos que sejam considerados pelo menos). Se você quiser inserir texto de justificativa como um comentário genérico, em vez de ser uma justificativa de que a situação é aceitável, inicie o bloco de texto com '//' seguido de um espaço. Feedback é bem-vindo via site do GitHub como questões ou pull requests Há também uma lista de discussão para discussão geral.

Fornecemos com prazer as informações em vários idiomas, no entanto, se houver qualquer conflito ou inconsistência entre as traduções, a versão em inglês é a versão autoritativa.
Se este é o seu projeto, por favor mostre o status do seu selo básico na página do seu projeto! O status do selo básico se parece com isto: O nível do selo básico para o projeto 15170 é baseline-3 Aqui está como incorporar o selo básico:
Você pode mostrar o status do seu selo básico incorporando isto no seu arquivo markdown:
[![OpenSSF Baseline](https://www.bestpractices.dev/projects/15170/baseline)](https://www.bestpractices.dev/projects/15170)
ou incorporando isto no seu HTML:
<a href="https://www.bestpractices.dev/projects/15170"><img src="https://www.bestpractices.dev/projects/15170/baseline"></a>


Estes são os critérios de Nível Básico 2. Estes são critérios da versão v2026.08.28.

Baseline Series: Nível Básico 1 Nível Básico 2 Nível Básico 3

        

 Fundamentos

  • Geral

    Observe que outros projetos podem usar o mesmo nome.

    AerolVM is a self-hosted platform for creating isolated Docker-backed sandboxes on a single Linux host.

    Use o formato de expressão de licença SPDX; exemplos incluem "Apache-2.0", "BSD-2-Clause", "BSD-3-Clause", "GPL-2.0+", "LGPL-3.0+", "MIT" e "(BSD-2-Clause OR Ruby)". Não inclua aspas simples ou aspas duplas.
    Se houver mais de uma linguagem, liste-as como valores separados por vírgula (espaços opcionais) e ordene-as da mais usada para a menos usada. Se houver uma longa lista, liste pelo menos as três primeiras mais comuns. Se não houver linguagem (por exemplo, este é um projeto apenas de documentação ou apenas de teste), use o caractere único "-". Use uma capitalização convencional para cada linguagem, por exemplo, "JavaScript".
    O Common Platform Enumeration (CPE) é um esquema de nomenclatura estruturado para sistemas de tecnologia da informação, software e pacotes. Ele é usado em vários sistemas e bancos de dados ao relatar vulnerabilidades.

    AerolVM is a self-hosted platform for isolated Linux sandboxes, with Docker, Firecracker, WASM, and V8 isolate runtimes, plus optional multi-node cluster mode.

 Controles 19/19 ●

  • Controles


    Quando uma tarefa de CI/CD é executada sem permissões especificadas, o sistema de CI/CD DEVE definir como padrão as permissões da tarefa para as menores permissões concedidas no pipeline. [OSPS-AC-04.01]
    Configure as definições do projeto para atribuir as menores permissões disponíveis a novos pipelines por padrão, concedendo permissões adicionais somente quando necessário para tarefas específicas.

    The repository Actions setting "Workflow permissions" is "Read repository contents and packages permissions". A job with no permissions block receives that read-only GITHUB_TOKEN. Workflows also set permissions explicitly, usually contents: read.
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/test.yml
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/release.yml



    Quando um lançamento oficial é criado, esse lançamento DEVE receber um identificador de versão único. [OSPS-BR-02.01]
    Atribua um identificador de versão único a cada versão de lançamento produzida pelo projeto, seguindo uma convenção de nomenclatura ou esquema de numeração consistente. Exemplos incluem SemVer, CalVer ou id de commit git.

    Official releases are GitHub releases identified by a unique git tag (v0.6.3, v0.6.2, v0.6.1, v0.6.0). The release workflow publishes assets to that tag. GitHub rejects a second release with the same tag.
    https://github.com/aerol-ai/microvm/releases/tag/v0.6.3
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/release.yml



    Quando um lançamento oficial é criado, esse lançamento DEVE conter um registro descritivo de modificações funcionais e de segurança. [OSPS-BR-04.01]
    Certifique-se de que todos os lançamentos incluam um registro de alterações descritivo. É recomendado garantir que o registro de alterações seja legível por humanos e inclua detalhes além das mensagens de commit, como descrições do impacto de segurança ou relevância para diferentes casos de uso. Para garantir a legibilidade por máquina, coloque o conteúdo sob um cabeçalho markdown como \"## Changelog\"."

    Non-trivial release notes file in repository: https://github.com/aerol-ai/microvm/blob/main/CHANGELOG.md. [release_notes]



    Quando um pipeline de compilação e lançamento ingere dependências, ele DEVE usar ferramentas padronizadas quando disponíveis. [OSPS-BR-05.01]
    Use ferramentas comuns para o seu ecossistema, como gerenciadores de pacotes ou ferramentas de gerenciamento de dependências para ingerir dependências no momento da compilação. Isso pode incluir o uso de um arquivo de dependências, arquivo de bloqueio ou manifesto para especificar as dependências necessárias, que são então incorporadas pelo sistema de compilação.

    Release and CI install dependencies with the language's standard tool: Go modules (go build / go test), npm ci, Maven (mvn), pip (python -m pip install --require-hashes), and Cargo (cargo test --locked / cargo publish). Each reads the committed manifest and lockfile (go.mod, package-lock.json, pom.xml, requirements-ci.txt, Cargo.lock).
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/release.yml
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/test.yml
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/publish-sdks.yml



    Quando um lançamento oficial é criado, esse lançamento DEVE ser assinado ou contabilizado em um manifesto assinado incluindo os hashes criptográficos de cada ativo. [OSPS-BR-06.01]
    Assine todos os ativos de software lançados no momento da construção com uma assinatura criptográfica ou atestados, como assinatura GPG ou PGP, assinaturas Sigstore, proveniência SLSA ou VSAs SLSA. Inclua os hashes criptográficos de cada ativo em um manifesto assinado ou arquivo de metadados.

    The release workflow writes checksums.txt (sha256sum of every asset), then signs those assets with actions/attest-build-provenance. The signed SLSA provenance bundle is published as v0.6.3.intoto.jsonl and stored in GitHub's attestation API. The bundle is copied in after signing so it is not a subject of itself.
    https://github.com/aerol-ai/microvm/releases/download/v0.6.3/checksums.txt
    https://github.com/aerol-ai/microvm/releases/download/v0.6.3/v0.6.3.intoto.jsonl
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/release.yml



    Quando o projeto tiver feito um lançamento, a documentação do projeto DEVE incluir uma descrição de como o projeto seleciona, obtém e rastreia suas dependências. [OSPS-DO-06.01]
    É recomendado publicar essas informações juntamente com a documentação técnica e de design do projeto em um recurso publicamente visível, como o repositório de código-fonte, site do projeto ou outro canal.


    A documentação do projeto DEVE incluir instruções sobre como compilar o software, incluindo bibliotecas, frameworks, SDKs e dependências necessários. [OSPS-DO-07.01]
    Recomenda-se publicar essas informações junto com a documentação de colaboradores do projeto, como em CONTRIBUTING.md ou outra documentação de tarefas de desenvolvimento. Isso também pode ser documentado usando alvos de Makefile ou outros scripts de automação.

    Released versions record dependencies in committed manifests and lockfiles. A new dependency is added only in a reviewed pull request. CI obtains them with Go modules, npm ci, pip install --require-hashes, Maven, and cargo --locked. Dependabot opens a weekly update pull request for Go, GitHub Actions, npm, pip, Maven, and Cargo, and security updates are enabled. The Go CI job runs govulncheck.
    https://github.com/aerol-ai/microvm/blob/main/README.md#dependencies
    https://github.com/aerol-ai/microvm/blob/main/.github/dependabot.yml



    A documentação do projeto DEVE incluir uma lista dos membros do projeto com acesso a recursos sensíveis. [OSPS-GV-01.01]
    Documente os participantes do projeto e seus papéis através de artefatos como members.md, governance.md, maintainers.md ou arquivo similar dentro do repositório de código-fonte do projeto. Isso pode ser tão simples quanto incluir nomes ou identificadores de conta em uma lista de mantenedores, ou mais complexo dependendo da governança do projeto.

    The README lists every GitHub account that can reach sensitive resources. sumansaurabh is the organization owner and repository admin (branch rules, Actions secrets, security settings, releases). akanshasinha19 and sumansaurabh-slice have write access (push, open pull requests, publish a release, dispatch the SDK publish workflow). Registry publish tokens are GitHub Actions secrets, read by the release and SDK publish workflows, and are not in the git tree.
    https://github.com/aerol-ai/microvm/blob/main/README.md#access-to-sensitive-resources



    A documentação do projeto DEVE incluir descrições dos papéis e responsabilidades dos membros do projeto [OSPS-GV-01.02]
    Documente os participantes do projeto e seus papéis através de artefatos como members.md, governance.md, maintainers.md ou arquivo similar dentro do repositório de código-fonte do projeto.

    The README describes four roles. The maintainer (sumansaurabh) approves pull requests, publishes official releases and SDK packages, changes branch rules and Actions secrets, and triages reports sent to security@aerol.ai and GitHub private advisories. Code owners (sumansaurabh, akanshasinha19) review pull requests; a code owner other than the author approves changes to the default branch. Write collaborators (akanshasinha19, sumansaurabh-slice) push branches and open pull requests. Anyone else contributes through issues and pull requests and has no access to secrets, branch rules, or release publishing.
    https://github.com/aerol-ai/microvm/blob/main/README.md#roles-and-responsibilities
    https://github.com/aerol-ai/microvm/blob/main/.github/CODEOWNERS



    A documentação do projeto DEVE incluir um guia para contribuidores de código que inclua os requisitos para contribuições aceitáveis. [OSPS-GV-03.02]
    Estenda o conteúdo de CONTRIBUTING.md ou CONTRIBUTING/ na documentação do projeto para delinear os requisitos para contribuições aceitáveis, incluindo padrões de codificação, requisitos de testes e diretrizes de submissão para contribuidores de código. É recomendado que este guia seja a fonte da verdade tanto para contribuidores quanto para aprovadores.

    CONTRIBUTING.md is the contributor guide. A change is acceptable when it is a pull request approved by a code owner other than the author, the pull request description fills every template section, Go changes are formatted and tested (new code keeps the package at or above 85% line coverage), a user-facing API change updates each SDK that exposes it, and the diff contains no secrets. Changes to the service, store, Caddy client, API, or SDKs must address pr-review.md. The README Contributing section links to that guide.
    https://github.com/aerol-ai/microvm/blob/main/CONTRIBUTING.md
    https://github.com/aerol-ai/microvm/blob/main/README.md#contributing



    O sistema de controle de versão DEVE exigir que todos os contribuidores de código afirmem que estão legalmente autorizados a fazer as contribuições associadas em cada commit. [OSPS-LE-01.01]
    Inclua um DCO no repositório do projeto, exigindo que os contribuidores de código afirmem que estão legalmente autorizados a confirmar as contribuições associadas em cada commit. Use uma verificação de status para garantir que a afirmação seja feita. Um CLA também satisfaz este requisito. Alguns sistemas de controle de versão, como o GitHub, podem incluir isso nos termos de serviço da plataforma.

    Every pull request commit must include a Signed-off-by trailer (git commit -s). CONTRIBUTING.md defines that trailer as the Developer Certificate of Origin 1.1, the contributor's assertion that they are legally allowed to submit the change. The trailer is checked inside the changes job, which the default-branch ruleset requires to pass before merge. There are no bypass actors on that ruleset.
    https://github.com/aerol-ai/microvm/blob/main/CONTRIBUTING.md#developer-certificate-of-origin
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/test.yml
    https://github.com/aerol-ai/microvm/rules/16186085



    Quando um commit é feito na branch primária, quaisquer verificações de status automatizadas para commits DEVEM passar ou ser manualmente ignoradas. [OSPS-QA-03.01]
    Configure o sistema de controle de versão do projeto para exigir que todas as verificações de status automatizadas passem ou exijam reconhecimento manual antes que um commit possa ser mesclado na branch primária. É recomendado que quaisquer verificações de status opcionais NÃO sejam configuradas como um requisito de aprovação ou reprovação que os aprovadores possam ser tentados a ignorar.

    The default-branch ruleset requires the changes status check, with strict status checks and no bypass actors. A commit reaches main only through a pull request whose required checks passed.
    https://github.com/aerol-ai/microvm/rules/16186085
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/test.yml



    Antes de um commit ser aceito, os pipelines de CI/CD do projeto DEVEM executar pelo menos um conjunto de testes automatizados para garantir que as alterações atendam às expectativas. [OSPS-QA-06.01]
    Testes automatizados devem ser executados antes de cada mesclagem na branch primária. O conjunto de testes deve ser executado em um pipeline de CI/CD e os resultados devem ser visíveis a todos os contribuidores. O conjunto de testes deve ser executado em um ambiente consistente e deve ser executado de uma maneira que permita aos contribuidores executar os testes localmente. Exemplos de conjuntos de testes incluem testes unitários, testes de integração e testes de ponta a ponta.

    The default-branch ruleset requires the changes status check and has no bypass actors. That job fails unless the Go SDK test suite passed on the pull request, and unless every suite selected by the changed paths passed (daemon unit tests, race tests, govulncheck, and the TypeScript, Python, Java, Rust, and Go SDK suites). The merge queue re-runs the same check.
    https://github.com/aerol-ai/microvm/blob/main/.github/workflows/test.yml
    https://github.com/aerol-ai/microvm/rules/16186085



    Quando o projeto tiver feito um lançamento, a documentação do projeto DEVE incluir documentação de design demonstrando todas as ações e atores dentro do sistema. [OSPS-SA-01.01]
    Inclua designs na documentação do projeto que expliquem as ações e atores. Atores incluem qualquer subsistema ou entidade que possa influenciar outro segmento no sistema. Certifique-se de que isso seja atualizado para novos recursos ou mudanças que quebrem compatibilidade.

    DESIGN.md is the design of a released node. It lists every actor (operator, API client, sandbox guest, preview or TCP client, SSH client, cluster peer, external storage) and the action each one can cause, with the component that carries the action out. Cluster peer actions do not run when cluster mode is off.
    https://github.com/aerol-ai/microvm/blob/main/DESIGN.md
    https://github.com/aerol-ai/microvm/blob/main/README.md#documentation



    Quando o projeto tiver feito um lançamento, a documentação do projeto DEVE incluir descrições de todas as interfaces de software externas dos ativos de software lançados. [OSPS-SA-02.01]
    Documente todas as interfaces de software (APIs) dos ativos de software lançados, explicando como os usuários podem interagir com o software e quais dados são esperados ou produzidos. Certifique-se de que isso seja atualizado para novos recursos ou mudanças que quebrem compatibilidade.

    The docs describe the external interfaces of the released software: the HTTP API and SDKs, the Daytona and E2B facades, HTTP preview URLs, TCP/TLS ports, SSH, filesystem and exec, external storage, and the installer.
    https://microvm.aerol.ai/sandboxes
    https://microvm.aerol.ai/sdk-setup
    https://microvm.aerol.ai/preview
    https://microvm.aerol.ai/tcp-ports
    https://microvm.aerol.ai/ssh-access
    https://microvm.aerol.ai/getting-started



    Quando o projeto tiver feito um lançamento, o projeto DEVE realizar uma avaliação de segurança para compreender os problemas de segurança potenciais mais prováveis e impactantes que poderiam ocorrer dentro do software. [OSPS-SA-03.01]
    Realizar uma avaliação de segurança informa tanto os membros do projeto quanto os consumidores a jusante que o projeto compreende quais problemas poderiam surgir dentro do software. Compreender quais ameaças poderiam se concretizar ajuda o projeto a gerenciar e tratar riscos. Essa informação é útil para os consumidores a jusante demonstrarem a perspicácia e as práticas de segurança do projeto. Certifique-se de que isso seja atualizado para novos recursos ou mudanças disruptivas.

    SECURITY-ASSESSMENT.md records the assessment for the 0.6.3 release and the standing model. The most severe problems are host command execution, host path traversal, cross-tenant access, API or SSH authentication bypass, egress bypass, and a tampered release. The 0.6.3 review fixed the mount-source and WASM toolhost command-execution bugs and the path-traversal bugs. Releases are covered by checksums and a signed provenance bundle. Running code inside a sandbox the caller owns is intended.
    https://github.com/aerol-ai/microvm/blob/main/SECURITY-ASSESSMENT.md
    https://github.com/aerol-ai/microvm/blob/main/CHANGELOG.md



    A documentação do projeto DEVE incluir uma política de divulgação coordenada de vulnerabilidades (CVD), com um prazo claro para resposta. [OSPS-VM-01.01]
    Crie um arquivo SECURITY.md na raiz do diretório, descrevendo a política do projeto para divulgação coordenada de vulnerabilidades. Inclua um método para relatar vulnerabilidades. Estabeleça expectativas sobre como o projeto responderá e tratará problemas relatados.

    SECURITY.md is the coordinated disclosure policy. Acknowledgement within 3 business days, initial assessment within 7 business days, a fix for a critical issue in about 14 days, a high issue in about 30 days, and other issues in the next release. The fix is published as a GitHub Security Advisory with the release.
    https://github.com/aerol-ai/microvm/blob/main/SECURITY.md



    A documentação do projeto DEVE fornecer um meio de relatar vulnerabilidades de forma privada diretamente aos contatos de segurança do projeto. [OSPS-VM-03.01]
    Forneça um meio para que pesquisadores de segurança relatem vulnerabilidades privadamente ao projeto. Isso pode ser um endereço de e-mail dedicado, um formulário web, ferramentas especializadas do VCS, endereços de e-mail para contatos de segurança ou outros métodos.

    Private reports go directly to the security contacts: a GitHub private advisory, or email to security@aerol.ai. Discord is first contact only and must not contain vulnerability details.
    https://github.com/aerol-ai/microvm/security/advisories/new
    https://github.com/aerol-ai/microvm/blob/main/SECURITY.md



    A documentação do projeto DEVE publicar publicamente dados sobre vulnerabilidades descobertas. [OSPS-VM-04.01]
    Forneça informações sobre vulnerabilidades conhecidas em um canal público previsível, como uma entrada CVE, postagem em blog ou outro meio. Na medida do possível, essa informação deve incluir versão(ões) afetada(s), como um consumidor pode determinar se está vulnerável e instruções para mitigação ou remediação.

    Discovered vulnerabilities are published as GitHub Security Advisories and in the changelog. The critical mount-source bug fixed in 0.6.3 is GHSA-5pqm-4fh4-585q.
    https://github.com/aerol-ai/microvm/security/advisories/GHSA-5pqm-4fh4-585q
    https://github.com/aerol-ai/microvm/blob/main/CHANGELOG.md



Você pode usar ferramentas e sistemas de IA para propor alterações por meio de uma URL simples, como https://www.bestpractices.dev/pt-BR/projects/15170/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforced. Veja nosso sistema de propostas de automação para saber como fazer isso. Estes dados estão disponíveis sob o Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0). Isso significa que um Destinatário de Dados pode compartilhar os Dados, com ou sem modificações, desde que o Destinatário de Dados disponibilize o texto deste acordo com os Dados compartilhados. Por favor, dê crédito a Suman e aos contribuidores do selo de melhores práticas OpenSSF.

Entrada de selo do projeto de propriedade de: Suman.
Entrada criada em 2026-10-02 15:43:29 UTC, última atualização em 2026-10-03 09:07:55 UTC. Selo de aprovação alcançado pela última vez em 2026-10-02 22:18:41 UTC.