Skip to content

fix(oidc): persist OIDC subject and avoid email local-part username collisions - #43

Open
devin-ai-integration[bot] wants to merge 3 commits into
mainfrom
devin/sfind-b275e480-oidc-subject-binding
Open

devin-ai-integration[bot] wants to merge 3 commits into
mainfrom
devin/sfind-b275e480-oidc-subject-binding

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

Description

Corrige o achado de code scan sfind-b275e4805c77462cbcb7852798cac2fb (low): contas OIDC eram identificadas apenas pela parte local do e-mail e o sub (subject) do provedor nunca era salvo.

Causa raiz: db.createUser recebia oidcId mas não o gravava no registro (o campo se perdeu na conversão para TypeScript). Por isso findUserByOIDC(sub) nunca encontrava ninguém, e:

  • todo usuário OIDC só conseguia logar uma vez; no segundo login caía em user <x> already exists (HTTP 500 no fluxo misto local+OIDC);
  • qualquer identidade com a mesma parte local (alice@partner.example) podia criar a conta alice primeiro e bloquear a dona legítima (alice@acme.example).

Mudanças

  • src/db/index.ts – createUser grava oidcId quando informado (registros de usuários locais ficam iguais, sem o campo).
  • src/service/passport/oidc.ts – handleUserAuthentication:
    • busca pelo sub primeiro e devolve a conta encontrada (login repetido funciona);
    • exige sub; rejeita criação de conta quando o provedor envia email_verified: false;
    • não vincula identidade OIDC a conta local/AD existente com o mesmo e-mail (erro explícito);
    • contas OIDC legadas (criadas antes deste fix: password === null, sem oidcId) são vinculadas ao sub quando o e-mail bate exatamente, para não trancar usuários existentes;
    • novo getAvailableUsername: usa a parte local se estiver livre; caso contrário usa <local>-<8 hex de sha256(sub)>, então uma segunda identidade recebe um username distinto em vez de erro.
    • A sessão guarda uma referência tipada: { oidcId } para contas OIDC e { username } para as demais (serializeSessionId/deserializeSessionId). Um username local nunca é resolvido como o sub de outra conta, e vice-versa. IDs string (sessões antigas) continuam resolvendo só por findUserByOIDC, como no main.
    • Vinculação de conta OIDC legada (sem oidcId, password === null) por e-mail exige email_verified: true; sem a claim, retorna "already exists" e o [REDACTED SECRET] precisa vincular manualmente.

Mudança de comportamento / contrato (sinalizado): nenhuma rota de API mudou. O username gerado para um novo usuário OIDC passa a ter sufixo quando a parte local já está em uso (antes: erro). Logins OIDC com email_verified: false não criam mais conta.

Risco residual: a parte local continua sendo "first come, first served" para o username sem sufixo – quem logar primeiro com alice@… fica com alice. A dona legítima não fica mais trancada (recebe alice-xxxxxxxx) e o e-mail real aparece na conta, mas [REDACTED SECRET]s devem conferir o e-mail antes de conceder permissões por username. Usar o e-mail completo como username eliminaria isso, mas mudaria todos os usernames OIDC; deixei fora do escopo.

Related Issue

Code scan finding sfind-b275e4805c77462cbcb7852798cac2fb (scan scan-70082f73b42b43fda8ae0a7ecbe7fedf). Não há issue no GitHub.

Como testar

  • npm test -- test/testOidc.test.ts test/testDb.test.ts
    • testDb: createUser(..., oidcId) persiste o sub e findUserByOIDC o encontra; usuários locais não ganham oidcId.
    • testOidc (novo bloco "OIDC user identity binding"): login repetido resolve a mesma conta; segunda identidade com mesma parte local recebe alice-<hash>; não toma username nem e-mail de conta local; vincula conta legada só com email_verified: true; IDs de sessão local/OIDC não colidem; rejeita email_verified: false e perfil sem sub.
  • Manual com um IdP: logar duas vezes com a mesma identidade (2º login deve funcionar) e depois com outra identidade de mesma parte local (deve receber username distinto).

Verificação local feita: este ambiente não tem acesso ao registry do npm, então npm ci/npm test/npm run lint/check-types não rodaram aqui – ficam para o CI. Rodei um harness vitest isolado (vitest emprestado de outro repo) com o src/db/index.ts real e um sink em memória:

  • antes (main): 10/12 falham – o registro salvo não tem oidcId, o 2º login retorna user alice already exists, e a vítima é bloqueada depois que alice@partner.example loga primeiro.
  • depois (este branch, após revisão): 15/15 passam (inclui namespace de sessão e email_verified na vinculação legada) – registro {"username":"alice",…,"oidcId":"sub-alice"}, 2º login resolve a mesma conta, segunda identidade vira alice-2de72856, criação de usuário local inalterada.
    prettier --check passa nos arquivos alterados. Hooks do husky (commitlint + lint) não rodaram localmente pelo mesmo motivo.

Checklist

General

Documentation

  • Documentation has been added/updated for any new features

Configuration

  • If configuration schema (config.schema.json) was modified: (não modificado)

Tests

  • Tests have been added/updated for new functionality
  • Unit tests pass (npm test) – pendente no CI (npm indisponível localmente)
  • Linting and formatting pass (npm run lint and npm run format:check) – prettier ok localmente; eslint pendente no CI
  • Type checks pass (npm run check-types) – pendente no CI

CI (404ff08): test/testOidc.test.ts (19 testes) e test/testDb.test.ts passam em todas as matrizes Ubuntu e no Windows; Linting, CodeQL, e2e (vitest/cypress) passam. As únicas falhas são 2 testes em test/ConfigLoader.test.ts (loadRemoteConfig via git/http), que baixam o proxy.config.json ao vivo de finos/git-proxy@main e falham com Invalid value for key "sink": o arquivo upstream não bate com o schema deste fork. Não tem relação com este PR. O job build-ubuntu (24.x, 8.0) também falhou porque o container mongo:8.0 não subiu.

Devin-Org: engineering

Link to Devin session: https://devin-gtm.devinenterprise.com/sessions/66bb0bcb0719460bb35e8fd615cbd11f
Open in Devin Desktop: https://devin-gtm.devinenterprise.com/desktop/session/66bb0bcb0719460bb35e8fd615cbd11f?variant=devin


Devin Review

Status Commit
⚪ Not started —

Run Devin Review

Enable auto-review to review your pull requests automatically.

Devin Review (Staging)


Devin Review

…ollisions (bug)

createUser dropped the oidcId it was given, so findUserByOIDC never matched: repeat
OIDC logins failed with 'user X already exists' and any identity with a matching email
local part could claim a username first and lock the rightful owner out.

- db.createUser stores oidcId for OIDC accounts
- handleUserAuthentication resolves by subject first, rejects email_verified=false,
  refuses to bind to existing non-OIDC accounts by email, binds legacy OIDC accounts
  (password null, no oidcId) on exact email match, and suffixes the username with a
  hash of the subject when the local part is taken
- deserializeUser falls back to a username lookup for non-OIDC sessions

Refs: sfind-b275e4805c77462cbcb7852798cac2fb
@devin-ai-integration

Copy link
Copy Markdown
Author

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

devin-ai-integration[bot]

This comment was marked as resolved.

devin-ai-integration[bot]

This comment was marked as resolved.

@github-actions

github-actions Bot commented Nov 5, 2026

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@devin-ai-integration

Copy link
Copy Markdown
Author

CI on 404ff08: testOidc.test.ts (19 tests) and testDb.test.ts pass on all Ubuntu matrix jobs and on Windows. Linting, CodeQL and both e2e suites pass too.

The build-* jobs fail only on two tests in test/ConfigLoader.test.ts (loadRemoteConfig via git and http). Those tests download the live proxy.config.json from finos/git-proxy@main, and the downloaded file fails this fork's schema with Invalid value for key "sink" on GitProxyConfig. This PR doesn't touch config loading. Separately, build-ubuntu (24.x, 8.0) failed before any tests ran because the mongo:8.0 service container never started.

Written by Devin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants