friendflix

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 na página do seu projeto! O status do selo se parece com isto: O nível do selo para o projeto 15445 é gold Aqui está como incorporá-lo:
Você pode mostrar o status do seu selo incorporando isto no seu arquivo markdown:
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/15445/badge)](https://www.bestpractices.dev/projects/15445)
ou incorporando isto no seu HTML:
<a href="https://www.bestpractices.dev/projects/15445"><img src="https://www.bestpractices.dev/projects/15445/badge"></a>


Estes são os critérios de nível Ouro. Você também pode visualizar os critérios de nível Aprovação ou Prata.

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

        

 Fundamentos 5/5 ●

  • Geral

    Observe que outros projetos podem usar o mesmo nome.

    FriendFlix is a self-hosted, private streaming portal for small groups of friends and family. It runs as a set of Docker containers in front of an existing Jellyfin media server. A Plex variant is maintained as a separate fork. Viewers get a modern web app and installable PWA for desktop, phone and TV browsers, and never talk to the media server directly.

    Features include viewer profiles with kids mode and age limits, role-based access per library, offline downloads, Chromecast and AirPlay with short-lived scoped tokens, watch parties, recommendations from friends, and an admin area for users, devices and settings. The interface is available in 7 languages.

    Architecture: a SvelteKit web front end, a Fastify/TypeScript backend with PostgreSQL and Redis, and a separate media gateway that authorizes every media request. Media server credentials never reach the browser.

    Security practices: OIDC single sign-on (e.g. Authentik), device approval, encrypted secrets at rest, CSP and hardened containers (read-only, no capabilities, non-root). CI runs on every pull request with CodeQL, Trivy image scanning, gitleaks secret scanning, a DAST baseline scan and OpenSSF Scorecard. Release images carry an SPDX SBOM and SLSA provenance. Vulnerabilities are reported privately via GitHub, as described in SECURITY.md.

    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.

    A Plex variant is maintained as a separate fork: https://github.com/LetsManu/friendflix-plex. It is maintained by a single developer and was released as open source under AGPL-3.0-or-later in October 2026.

    Security tooling in CI on every pull request: CodeQL, Trivy image scanning, gitleaks, OWASP ZAP baseline (DAST), OpenSSF Scorecard and Dependabot. Release images carry an SPDX SBOM and SLSA provenance. Vulnerability reports: see SECURITY.md.

    Development is assisted by AI coding tools; every change goes through a pull request with the full CI suite and is reviewed by the maintainer before merging.

  • Pré-requisitos


    Suficiente para um badge!

    O projeto DEVE alcançar um selo de nível prata. [achieve_silver]

  • Supervisão do projeto


    Suficiente para um badge!

    O projeto DEVE ter um "fator ônibus" de 2 ou mais. (URL obrigatória) [bus_factor]
    Um "bus factor" (também conhecido como "truck factor") é o número mínimo de membros do projeto que precisam desaparecer repentinamente de um projeto ("ser atropelados por um ônibus") antes que o projeto pare devido à falta de pessoal conhecedor ou competente. A ferramenta truck-factor pode estimar isso para projetos no GitHub. Para mais informações, consulte Assessing the Bus Factor of Git Repositories de Cosentino et al.

    Bus factor is currently 1. A second maintainer (a trusted friend of the maintainer) has agreed to join as co-maintainer; until then, all project knowledge is documented in the repository and builds/releases run fully in CI. See https://github.com/LetsManu/friendflix/blob/main/GOVERNANCE.md#bus-factor-and-succession


    Suficiente para um badge!

    O projeto DEVE ter pelo menos dois contribuidores significativos não associados. (URL obrigatória) [contributors_unassociated]
    Os contribuidores são associados se forem pagos para trabalhar pela mesma organização (como empregado ou contratado) e a organização se beneficia dos resultados do projeto. Concessões financeiras não contam como sendo da mesma organização se passarem por outras organizações (por exemplo, concessões científicas pagas a diferentes organizações de uma fonte governamental ou ONG comum não fazem com que os contribuidores sejam associados). Alguém é um contribuidor significativo se fez contribuições não triviais para o projeto no último ano. Exemplos de bons indicadores de um contribuidor significativo são: escreveu pelo menos 1.000 linhas de código, contribuiu com 50 commits, ou contribuiu com pelo menos 20 páginas de documentação.

    FriendFlix currently has one significant contributor (the maintainer). A second maintainer is planned (see https://github.com/LetsManu/friendflix/blob/main/GOVERNANCE.md#bus-factor-and-succession); contributions from others are welcome via CONTRIBUTING.md.


  • Outro


    Suficiente para um badge!

    O projeto DEVE incluir uma declaração de licença em cada arquivo-fonte. Isso PODE ser feito incluindo o seguinte dentro de um comentário perto do início de cada arquivo: SPDX-License-Identifier: [expressão de licença SPDX para o projeto]. [license_per_file]
    Isso PODE também ser feito incluindo uma declaração em linguagem natural identificando a licença. O projeto PODE também incluir uma URL estável apontando para o texto da licença, ou o texto completo da licença. Observe que o critério license_location requer que a licença do projeto esteja em um local padrão. Veja este tutorial SPDX para mais informações sobre expressões de licença SPDX. Observe a relação com copyright_per_file, cujo conteúdo normalmente precederia as informações de licença.

    Every source file carries SPDX-License-Identifier: AGPL-3.0-or-later, enforced in CI by npm run spdx:check. Example: https://github.com/LetsManu/friendflix/blob/main/backend/src/app.ts


 Controle de Mudanças 4/4 ●

  • Repositório de código-fonte público controlado por versão


    Suficiente para um badge!

    O repositório de código do projeto DEVE usar um software de controle de versão distribuído comum (por exemplo, git ou mercurial). [repo_distributed]
    O Git não é especificamente exigido e os projetos podem usar software de controle de versão centralizado (como subversion) com justificativa.

    Repository on GitHub, which uses git. git is distributed.


    Suficiente para um badge!

    O projeto DEVE identificar claramente pequenas tarefas que podem ser realizadas por novos colaboradores ou colaboradores casuais. (URL obrigatória) [small_tasks]
    Esta identificação é tipicamente feita marcando problemas selecionados em um rastreador de problemas com uma ou mais tags que o projeto usa para o propósito, por exemplo, up-for-grabs, first-timers-only, "Small fix", microtask ou IdealFirstBug. Essas novas tarefas não precisam envolver a adição de funcionalidade; elas podem ser melhorar a documentação, adicionar casos de teste ou qualquer outra coisa que ajude o projeto e ajude o colaborador a entender mais sobre o projeto.

    Issues can be labelled "good first issue"; CONTRIBUTING.md asks for small, single-topic PRs. https://github.com/LetsManu/friendflix/issues


    Suficiente para um badge!

    O projeto DEVE exigir autenticação de dois fatores (2FA) para desenvolvedores para alterar um repositório central ou acessar dados sensíveis (como relatórios de vulnerabilidade privados). Este mecanismo 2FA PODE usar mecanismos sem mecanismos criptográficos, como SMS, embora isso não seja recomendado. [require_2FA]

    GitHub requires 2FA as of March 2023. [osps_ac_01_01]


    Suficiente para um badge!

    A autenticação de dois fatores (2FA) do projeto DEVERIA usar mecanismos criptográficos para evitar personificação. A autenticação 2FA baseada em Short Message Service (SMS), por si só, NÃO atende a este critério, pois não é criptografada. [secure_2FA]
    Um mecanismo de 2FA que atende a este critério seria um aplicativo de Time-based One-Time Password (TOTP) que gera automaticamente um código de autenticação que muda após um determinado período de tempo. Observe que o GitHub suporta TOTP.

    The maintainer uses a passkey / TOTP authenticator for GitHub 2FA (not SMS).


 Qualidade 7/7 ●

  • Padrões de codificação


    Suficiente para um badge!

    O projeto DEVE documentar seus requisitos de revisão de código, incluindo como a revisão de código é conduzida, o que deve ser verificado e o que é necessário para ser aceitável. (URL obrigatória) [code_review_standards]
    Veja também two_person_review e contribution_requirements.

    Review standards are documented in CONTRIBUTING.md (requirements a PR must meet: tests, lint/typecheck, i18n, security rules, docs) and every change goes through a PR with the full CI suite.
    https://github.com/LetsManu/friendflix/blob/main/CONTRIBUTING.md


    Suficiente para um badge!

    O projeto DEVE ter pelo menos 50% de todas as modificações propostas revisadas antes do lançamento por uma pessoa diferente do autor, para determinar se é uma modificação que vale a pena e livre de problemas conhecidos que argumentariam contra sua inclusão [two_person_review]

    Single maintainer; PRs are reviewed by the maintainer plus automated reviews (CodeQL, CI), Secound person is Planned as stated in before questions.


  • Sistema de compilação funcional


    Suficiente para um badge!

    O projeto DEVE ter uma compilação reproduzível. Se nenhuma compilação ocorrer (por exemplo, linguagens de script onde o código fonte é usado diretamente em vez de ser compilado), selecione "não aplicável" (N/A). (URL obrigatória) [build_reproducible]
    Uma compilação reproduzível significa que várias partes podem refazer independentemente o processo de geração de informações a partir de arquivos fonte e obter exatamente o mesmo resultado bit a bit. Em alguns casos, isso pode ser resolvido forçando algum tipo de ordenação. Desenvolvedores JavaScript podem considerar usar npm shrinkwrap e webpack OccurrenceOrderPlugin. Usuários de GCC e clang podem achar útil a opção -frandom-seed. O ambiente de compilação (incluindo o conjunto de ferramentas) pode frequentemente ser definido para partes externas especificando o hash criptográfico de um contêiner específico ou máquina virtual que eles podem usar para recompilar. O projeto de compilações reproduzíveis tem documentação sobre como fazer isso.

    Container images are built reproducibly: SOURCE_DATE_EPOCH = commit time, BuildKit rewrite-timestamp, pinned base image digests and BuildKit version, lockfile installs (npm ci), no build timestamps or random values in the output, and Alpine packages only as minimum versions. The CI job reproducible builds every image twice from scratch on each PR and push and fails if the digests differ. Anyone can rebuild a published image and compare it bit for bit with scripts/reproduce-image.sh SERVICE --compare IMAGE. Procedure and limits are documented.

    URL: https://github.com/LetsManu/friendflix/blob/main/docs/reproducible-builds.md


  • Conjunto de testes automatizados


    Suficiente para um badge!

    Um conjunto de testes DEVE ser invocável de forma padrão para aquela linguagem. (URL obrigatória) [test_invocation]
    Por exemplo, "make check", "mvn test", ou "rake test" (Ruby).

    Tests run with the standard Node.js/npm command npm test from the repository root, which runs every workspace’s test script. End-to-end tests run with npm run e2e (Playwright).
    https://github.com/LetsManu/friendflix/blob/main/CONTRIBUTING.md


    Suficiente para um badge!

    O projeto DEVE implementar integração contínua, onde o código novo ou alterado é frequentemente integrado em um repositório de código central e testes automatizados são executados no resultado. (URL obrigatória) [test_continuous_integration]
    Na maioria dos casos, isso significa que cada desenvolvedor que trabalha em tempo integral no projeto integra pelo menos diariamente.

    GitHub Actions CI runs on every pull request and every push to main: lint, typecheck, unit tests on Node 22 and 26, Playwright end-to-end tests, Docker image builds with Trivy scanning, gitleaks secret scanning, a DAST baseline scan and CodeQL. Changes are integrated through small pull requests, several per day. https://github.com/LetsManu/friendflix/actions/workflows/ci.yml


    Suficiente para um badge!

    O projeto DEVE ter conjunto(s) de testes automatizados FLOSS que fornecem pelo menos 90% de cobertura de instrução se houver pelo menos uma ferramenta FLOSS que possa medir este critério na linguagem selecionada. [test_statement_coverage90]

    Statement coverage measured with Vitest (V8 provider), npm run coverage, shown in the CI job summary: backend 90.96 %, gateway 93.18 %, web 94.3 %, overall 92.3 %. Every TypeScript module counts, including ones no test imports. Each package’s vitest.config.ts sets a minimum threshold (90 / 93 / 94 %), and CI fails below it.

    URL: https://github.com/LetsManu/friendflix/blob/main/CONTRIBUTING.md#requirements-for-acceptable-contributions


    Suficiente para um badge!

    O projeto DEVE ter conjunto(s) de testes automatizados FLOSS que fornecem pelo menos 80% de cobertura de ramos se houver pelo menos uma ferramenta FLOSS que possa medir este critério na linguagem selecionada. [test_branch_coverage80]

    Branch coverage measured with Vitest (V8 provider), npm run coverage, shown in the CI job summary: backend 82.75 %, gateway 90.5 %, web 89.48 %, overall 85.5 %. Thresholds in each vitest.config.ts (82 / 90 / 89 %) make CI fail below them. The project rule (CONTRIBUTING.md) is to raise thresholds when coverage goes up and never to lower them.

    URL: same CONTRIBUTING link as above.


 Segurança 5/5 ●

  • Usar práticas criptográficas boas e básicas

    Observe que alguns softwares não precisam usar mecanismos criptográficos. Se o seu projeto produzir software que (1) inclui, ativa ou habilita funcionalidade de criptografia, e (2) pode ser liberado dos Estados Unidos (EUA) para fora dos EUA ou para um não cidadão dos EUA, você pode ser legalmente obrigado a tomar algumas etapas extras. Normalmente isso envolve apenas o envio de um e-mail. Para mais informações, consulte a seção de criptografia de Understanding Open Source Technology & US Export Controls.

    Suficiente para um badge!

    O software produzido pelo projeto DEVE suportar protocolos seguros para todas as suas comunicações de rede, como SSHv2 ou posterior, TLS1.2 ou posterior (HTTPS), IPsec, SFTP e SNMPv3. Protocolos inseguros como FTP, HTTP, telnet, SSLv3 ou anterior, e SSHv1 DEVEM estar desabilitados por padrão, e apenas habilitados se o usuário configurá-lo especificamente. Se o software produzido pelo projeto não suportar comunicações de rede, selecione "não aplicável" (N/A). [crypto_used_network]

    All network traffic to users is over HTTPS (casting requires an https PUBLIC_URL); internal container traffic stays on private Docker networks; outbound calls (TMDB, OMDb, OIDC, push) use HTTPS.


    Suficiente para um badge!

    O software produzido pelo projeto DEVE, se suportar ou usar TLS, suportar pelo menos a versão 1.2 do TLS. Observe que o predecessor do TLS foi chamado SSL. Se o software não usar TLS, selecione "não aplicável" (N/A). [crypto_tls12]

    TLS is terminated by the reverse proxy; the documented setups (Nginx Proxy Manager / Caddy / Traefik) default to TLS 1.2+ (TLS 1.3 preferred); docs/security.md recommends disabling older versions.


  • Entrega protegida contra ataques man-in-the-middle (MITM)


    Suficiente para um badge!

    O site do projeto, repositório (se acessível via web) e site de download (se separado) DEVEM incluir cabeçalhos de fortalecimento chave com valores não permissivos. (URL obrigatória) [hardened_site]
    Observe que o GitHub e o GitLab são conhecidos por atender a isso. Sites como https://securityheaders.com/ podem verificar isso rapidamente. Os principais cabeçalhos de proteção são: Content Security Policy (CSP), HTTP Strict Transport Security (HSTS), X-Content-Type-Options (como "nosniff") e X-Frame-Options. Sites web totalmente estáticos sem capacidade de fazer login por meio das páginas web poderiam omitir alguns cabeçalhos de proteção com menos risco, mas não há maneira confiável de detectar tais sites, portanto exigimos esses cabeçalhos mesmo se forem sites totalmente estáticos.

    The project site is GitHub (github.com / bestpractices.dev), which sends HSTS, X-Content-Type-Options, CSP and X-Frame-Options headers.
    https://github.com/LetsManu/friendflix/blob/main/SECURITY.md


  • Outras questões de segurança


    Suficiente para um badge!

    O projeto DEVE ter realizado uma revisão de segurança nos últimos 5 anos. Esta revisão DEVE considerar os requisitos de segurança e o limite de segurança. [security_review]
    Isso PODE ser feito pelos membros do projeto e/ou uma avaliação independente. Esta avaliação PODE ser apoiada por ferramentas de análise estática e dinâmica, mas também deve haver revisão humana para identificar problemas (particularmente no projeto) que as ferramentas não conseguem detectar.

    A security review was performed on 2026-10-XX by the project maintainer with AI-assisted code analysis. It covered every security requirement and every trust boundary in docs/security.md (assurance case), plus the threat model, dependencies and container hardening. Findings, their severity and their resolution are documented. The next review is planned within 12 months.

    URL: https://github.com/LetsManu/friendflix/blob/main/docs/security-review-2026-10.md


    Suficiente para um badge!

    Mecanismos de proteção DEVEM ser usados no software produzido pelo projeto para que defeitos de software tenham menos probabilidade de resultar em vulnerabilidades de segurança. (URL obrigatória) [hardening]
    Os mecanismos de proteção podem incluir cabeçalhos HTTP como Content Security Policy (CSP), flags de compilador para mitigar ataques (como -fstack-protector), ou flags de compilador para eliminar comportamento indefinido. Para nossos propósitos, o privilégio mínimo não é considerado um mecanismo de proteção (privilégio mínimo é importante, mas separado).

    Hardening: read-only root filesystems, cap_drop ALL, no-new-privileges, non-root users, npm removed from runtime images, CSP and security headers (nosniff, frame DENY, Referrer-Policy), HSTS at the proxy, rate limits, CI-enforced Trivy/CodeQL. See docs/security.md.
    https://github.com/LetsManu/friendflix/blob/main/SECURITY.md


 Análise 2/2 ●

  • Análise dinâmica de código


    Suficiente para um badge!

    O projeto DEVE aplicar pelo menos uma ferramenta de análise dinâmica a qualquer lançamento de produção proposto do software produzido pelo projeto antes de seu lançamento. [dynamic_analysis]
    Uma ferramenta de análise dinâmica examina o software executando-o com entradas específicas. Por exemplo, o projeto PODE usar uma ferramenta de fuzzing (por exemplo, American Fuzzy Lop) ou um scanner de aplicação web (por exemplo, OWASP ZAP ou w3af). Em alguns casos, o projeto OSS-Fuzz pode estar disposto a aplicar testes de fuzzing ao seu projeto. Para fins deste critério, a ferramenta de análise dinâmica precisa variar as entradas de alguma forma para procurar vários tipos de problemas ou ser um conjunto de testes automatizado com pelo menos 80% de cobertura de ramificação. A página da Wikipedia sobre análise dinâmica e a página da OWASP sobre fuzzing identificam algumas ferramentas de análise dinâmica. A(s) ferramenta(s) de análise PODEM estar focadas em procurar vulnerabilidades de segurança, mas isso não é obrigatório.

    Dynamic analysis runs on every pull request and every push to main, so on every release:

    OWASP ZAP baseline scan (DAST): runs against the built web app in CI (dast job in ci.yml).
    Playwright end-to-end tests: exercise the running application, including auth, access control and kids-mode restrictions.
    Integration tests: run the backend and gateway against real PostgreSQL/Redis and mocked upstreams.
    Trivy: scans the built container images.


    Suficiente para um badge!

    O projeto DEVERIA incluir muitas asserções em tempo de execução no software que produz e verificar essas asserções durante a análise dinâmica. [dynamic_analysis_enable_assertions]
    Este critério não sugere habilitar asserções durante a produção; isso é inteiramente decisão do projeto e de seus usuários. O foco deste critério é, em vez disso, melhorar a detecção de falhas durante a análise dinâmica antes da implantação. Habilitar asserções no uso em produção é completamente diferente de habilitar asserções durante a análise dinâmica (como testes). Em alguns casos, habilitar asserções no uso em produção é extremamente imprudente (especialmente em componentes de alta integridade). Existem muitos argumentos contra habilitar asserções em produção, por exemplo, bibliotecas não devem travar chamadores, sua presença pode causar rejeição por lojas de aplicativos e/ou ativar uma asserção em produção pode expor dados privados, como chaves privadas. Observe que em muitas distribuições Linux NDEBUG não é definido, então assert() em C/C++ será habilitado por padrão para produção nesses ambientes. Pode ser importante usar um mecanismo de asserção diferente ou definir NDEBUG para produção nesses ambientes.

    Tests run with many assertions enabled:

    Unit and integration tests (Vitest): assert results, error paths and security properties, for example that tokens never appear in logs and that access is denied across profiles.
    End-to-end tests (Playwright): assert UI state and network behaviour; the test build runs with development checks and source maps.
    Runtime validation: zod schemas validate every API input and fail loudly in tests.

    Production builds (NODE_ENV=production) leave out these test-only checks.



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/15445/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 Manuel Weißböck e aos contribuidores do selo de melhores práticas OpenSSF.

Entrada de selo do projeto de propriedade de: Manuel Weißböck.
Entrada criada em 2026-10-13 14:29:51 UTC, última atualização em 2026-10-13 16:48:13 UTC. Selo de aprovação alcançado pela última vez em 2026-10-13 14:57:13 UTC.