Skip to content

fix(acs): exclui os dados da transferência entre aparelhos (#152) - #162

Merged
hbgit merged 1 commit into
developfrom
fix/acs-data-extraction-rules
Nov 13, 2026
Merged

hbgit merged 1 commit into
developfrom
fix/acs-data-extraction-rules

Conversation

@Rosialdo

Copy link
Copy Markdown
Collaborator

Resumo

Exclui os dados do app do ACS da transferência entre aparelhos (Android 12+), além do backup em nuvem. Segue a mesma regra que o app do paciente já usa desde a #136 (PR #150).

Closes #152

Problema

O manifesto do ACS já tinha android:allowBackup="false", mas com targetSdk 31+ isso não desliga a transferência entre aparelhos. Sem regras de extração, iriam para o aparelho novo:

No aparelho de destino a chave do Keystore não existe. O resultado é a recuperação de chave perdida ou um estado inconsistente.

O que mudou

  • apps/acs/android/app/src/main/res/xml/data_extraction_rules.xml (novo): exclui root, file, database, sharedpref e external em <cloud-backup> e em <device-transfer>.
  • apps/acs/android/app/src/main/AndroidManifest.xml: o <application> ganha:
    • android:fullBackupContent="false" (API < 31);
    • android:dataExtractionRules="@xml/data_extraction_rules" (API 31+).
  • apps/acs/test/android_manifest_test.dart: três testes novos:
    • fullBackupContent="false" no <application>;
    • dataExtractionRules aponta para @xml/data_extraction_rules;
    • as regras excluem os cinco domínios nas duas seções e não têm nenhum <include>.

Testes

  • flutter analyze no ACS sem apontamentos.
  • test/android_manifest_test.dart: 14/14 passando.
  • Prova de que os testes pegam a regressão: com os atributos e duas regras removidos temporariamente, 3 testes falharam. Depois tudo foi restaurado.
  • A suíte completa do ACS não foi rodada, porque a mudança não toca em código Dart do app.

Verificação no emulador (API 37)

O aapt2 confirma que o APK gerado leva os três atributos no manifesto e as regras completas.

A transferência entre aparelhos foi simulada com o bmgr e o transporte local (is_device_transfer=true):

APK O que o Android mediu para copiar
Sem as regras (montado só para comparar) databases/sinalacs_acs.db, FlutterSecureStorage.xml, FlutterSharedPreferences.xml, sinalacs_keystore_vault.xml e outros, mesmo com allowBackup="false"
Com as regras (este PR) Nada da área do app em /data/data/...

Depois do teste, a configuração de backup do emulador foi restaurada. O app continua abrindo normalmente na tela de login.

Relação com a #81 (limpeza remota)

A identidade do aparelho na #81 é o deviceId da instalação (D1), guardado no flutter_secure_storage. O WipeJournal (D7) fica em shared_preferences em claro, com o orderId e o deviceId antigo. Sem estas regras, a transferência levaria os dois para o aparelho novo:

  • o diário chegaria legível. Como o deviceId antigo não seria legível no destino e o app criaria outro, o diário contaria como erased nas duas fases: o aparelho novo reenviaria a confirmação (devices.confirmWipe) de um pedido feito para o aparelho antigo;
  • o deviceId e a chave do certificado MQTT ([P1] Certificado de cliente MQTT por aparelho (STRIDE-S) #94) chegariam cifrados com uma chave do Keystore que não existe no destino.

Com a exclusão, o aparelho novo começa limpo e com deviceId próprio. Um pedido de limpeza continua valendo só para o aparelho a que se destina.

Critério de aceite

  • android:dataExtractionRules e android:fullBackupContent="false" no <application> do ACS
  • Regras que excluem os cinco domínios nas duas seções
  • O teste do manifesto do ACS cobre os dois atributos e as regras

Referências

RNF03, LGPD-RF09. Origem: achado da #136 (PR #150).

O manifesto do ACS já tinha android:allowBackup="false", mas com
targetSdk 31+ isso não desliga a transferência entre aparelhos do
Android 12+. Sem regras de extração, o banco SQLCipher da fila de
visitas e as SharedPreferences (WipeJournal da #81 e o
EncryptedSharedPreferences do flutter_secure_storage) iriam para o
aparelho novo, onde a chave do Keystore não existe: o resultado seria a
recuperação de chave perdida ou um estado inconsistente.

Mudanças, na mesma linha do app do paciente (#136, PR #150):
- res/xml/data_extraction_rules.xml (novo): exclui root, file,
  database, sharedpref e external em <cloud-backup> e em
  <device-transfer>;
- AndroidManifest.xml: android:fullBackupContent="false" (API < 31) e
  android:dataExtractionRules="@xml/data_extraction_rules" (API 31+);
- android_manifest_test.dart: três testes novos guardam os dois
  atributos e as regras (os cinco domínios nas duas seções, sem
  <include>).

Verificação no emulador (API 37), simulando a transferência com
bmgr e o transporte local (is_device_transfer=true):
- APK sem as regras: o Android mediu para cópia databases/sinalacs_acs.db,
  FlutterSecureStorage.xml, FlutterSharedPreferences.xml e
  sinalacs_keystore_vault.xml, apesar do allowBackup="false";
- APK com as regras: nada da área do app em /data/data foi medido.
O app segue abrindo normalmente na tela de login.

Refs: RNF03, LGPD-RF09

@hbgit hbgit left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Escopo: 3 arquivos, +64/−0. Reproduz no app do ACS a regra que o paciente já usa desde a #136.

Critério da issue → evidência

Critério da #152 Evidência
android:dataExtractionRules e android:fullBackupContent="false" no <application> apps/acs/android/app/src/main/AndroidManifest.xml linhas 13-14; testes "fullBackupContent="false"..." e "dataExtractionRules aponta para @xml/data_extraction_rules" em apps/acs/test/android_manifest_test.dart
Cinco domínios excluídos nas duas seções data_extraction_rules.xml: root, file, database, sharedpref, external em <cloud-backup> e <device-transfer>
Teste cobre atributos e regras e recusa <include> terceiro teste novo (regex por seção e por domínio; falha se houver <include)

O que rodei

  • flutter test test/android_manifest_test.dart (apps/acs): All tests passed! (14 testes).
  • flutter analyze (apps/acs): No issues found!.
  • Suíte completa do ACS (flutter test): +816: All tests passed! (segundo o corpo da PR o autor não a rodou; aqui passou).
  • diff do XML do ACS contra o do paciente: só o comentário de cabeçalho difere; as regras são idênticas.
  • bash scripts/qa/check_documentation_links.sh: só o aviso graphify-out ausente no worktree, que não é da PR (a PR não toca .md).
  • build.gradle.kts do ACS: minSdk = 24, targetSdk = 36, então o atributo dataExtractionRules vale e a premissa do texto (targetSdk 31+) é verdadeira.

Pontos que conferi e aprovo

  • Corpo da PR coerente: conforme descrito pelo autor, a tabela do bmgr (sem regras o Android mediu sinalacs_acs.db, FlutterSecureStorage.xml, FlutterSharedPreferences.xml, sinalacs_keystore_vault.xml; com regras, nada em /data/data/...) é o resultado esperado para as regras; não pude reproduzir (sem emulador).
  • flutter_secure_storage com encryptedSharedPreferences: true (secure_upload_token_store.dart, database_key_store.dart, secure_device_certificate_store.dart) fica fora da transferência. É o desejado: a chave do Keystore não migra, e um arquivo cifrado copiado sem ela seria inútil ou geraria estado inconsistente. O aparelho novo começa limpo, com deviceId próprio.
  • A relação com a #81 (diário de limpeza com deviceId antigo reenviando confirmWipe no aparelho novo) está bem descrita e é fechada pela exclusão.
  • Exclusão total de external e root não prejudica nada: o app não guarda dado que precise sobreviver à troca de aparelho (a fila offline é por aparelho; visitas pendentes não enviadas se perdem na troca, o que já é a política de dado local).

Pedidos

Nenhum.

Sugestões

  • O teste valida só texto do XML/manifesto. A prova real continua sendo o bmgr do corpo da PR; seria útil guardar esse roteiro (ou um script em scripts/qa/) para repetir após atualizações de AGP/targetSdk. Não bloqueia.

Registros

  • Não verifiquei em aparelho/emulador (nenhum ligado nesta máquina); a evidência do bmgr é a do autor.
  • apps/admin não tem res/xml/data_extraction_rules.xml nem allowBackup no manifesto (conferido só por ls/grep; fora do escopo da #152, fica como nota).

@hbgit

hbgit commented Nov 13, 2026

Copy link
Copy Markdown
Owner

aprovação

Aprovo com observações: regras idênticas às do paciente, atributos corretos, testes cobrindo atributos, cinco domínios nas duas seções e ausência de <include>; 14/14 no arquivo, suíte do ACS 816/816 e flutter analyze limpo. A única ressalva é a sugestão de registrar o roteiro bmgr para reaproveitar.

@hbgit
hbgit merged commit d18b6e7 into develop Nov 13, 2026
18 of 19 checks passed
@hbgit
hbgit deleted the fix/acs-data-extraction-rules branch November 13, 2026 13:11
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.

2 participants