Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -742,11 +742,11 @@ Com `VARANDA_PHONE_KEY` definida, todo membro hospedado confirma um celular bras

O que fica guardado: o `phone.json` no volume `account-data` (modo `0600`), com a chave do membro, o número selado (AES-256-GCM, preso à chave do membro), um índice com chave (HMAC) que serve para a unicidade e para os bloqueios, a data da verificação e, quando houver, o fim (`trocado`, `excluida`, `substituido`, `liberado`). O número nunca vai para os certificados, para a camada P2P, para respostas a outros membros, para os registros, para o painel de moderação nem para o `account export`. O serviço assina com a chave do emissor um atestado `phone-verified` (a chave do membro e a data, nunca o número), que o app guarda no nó, para a versão hospedada abrir sem rede; o atestado só é devolvido quando o serviço tem emissor (sem emissor, a verificação vale mas não vem atestado). Se a chave do emissor vazar e for revogada (`mod revoke-issuer`), os atestados que ela assinou também deixam de valer.

Backup: o `phone.json` e a `VARANDA_PHONE_KEY` vão juntos no backup, guardados em lugares separados. Perder a chave é perder todos os números e todos os bloqueios: o serviço falha fechado (o `phone.json` não abre, a etapa responde `indisponivel` e ninguém consegue se verificar) até a operação restaurar a chave certa. Trocar a chave não é suportado: com outra chave o arquivo não abre e nunca é regravado.
Backup: o `phone.json` e a `VARANDA_PHONE_KEY` vão juntos no backup, guardados em lugares separados. Perder a chave é perder todos os números e todos os bloqueios: o serviço falha fechado (o `phone.json` não abre, a etapa responde `indisponivel` e ninguém consegue se verificar) até a operação restaurar a chave certa. Trocar a chave não é suportado: com outra chave o arquivo não abre e nunca é regravado. O `phone.json` está na versão 2 (mapa `cleared`, #534): o serviço ainda abre um arquivo da versão 1, mas depois da primeira gravação na versão 2 um serviço anterior não o abre mais (a etapa responde `indisponivel`). Antes de atualizar, guarde um backup do arquivo, para poder voltar atrás.

Limites: 5 envios por membro por dia, 3 por número por dia, 60 s entre envios e o teto diário `VARANDA_PHONE_DAILY_LIMIT` (padrão 200, à parte para chaves vinculadas e não vinculadas). No dia em que os membros já vinculados passarem a verificar, suba o teto para esse dia. Um número já verificado por outra conta vinculada é recusado (`telefone-em-uso`); o de uma conta bloqueada pela moderação fica preso enquanto o bloqueio durar.
Limites: 5 envios por membro por dia, 3 por número por dia, 60 s entre envios e o teto diário `VARANDA_PHONE_DAILY_LIMIT` (padrão 200, à parte para chaves vinculadas e não vinculadas). No dia em que os membros já vinculados passarem a verificar, suba o teto para esse dia. Um número já verificado por outra conta vinculada é recusado (`telefone-em-uso`); o de uma conta bloqueada pela moderação fica preso enquanto o bloqueio durar. As tabelas desses limites e dos envios pendentes têm tamanho calculado a partir do teto diário e nunca apagam uma entrada ainda valendo: cheias, o envio recusa com `limite-telefone` e o registro mostra `tabela-cheia`. Limites aceitos pelo dono (2026-11-17, detalhes em `docs/design.md`): entre o envio e a conferência o número fica só na memória do serviço, sem cifra, por até 10 minutos; e, se o app não lê a política do celular e o nó ainda não guarda o atestado `phone-since`, o passo fica desligado naquela abertura.

Registros: o evento `telefone` traz só palavras fixas, nunca o número, o código ou a chave. Na partida, `ligada` ou `desligada`; `indisponivel` (o `phone.json` não abriu com esta chave, a verificação continua exigida e a etapa fica fechada); `arquivo-sem-chave` (há um `phone.json` mas a chave não está definida, então nenhuma retenção corre). Em uso: `enviado`, `verificado`, `em-uso`, `recusado-linha` (fixo, VoIP ou descartável), `tipo-desconhecido` (aceito, tipo de linha que o serviço não conhece), `teto-diario`, `armazenamento-indisponivel`, `gravacao-falhou`, `varredura-falhou`, `varredura-exclusao-falhou`, `resultado-desconhecido`, `didit-envio-bloqueado` e, para falhas do Didit, `didit-envio-` ou `didit-checagem-` seguido de `falha` (a resposta do Didit não foi aceita), `http-NNN`, `tempo`, `rede`, `formato` ou `entrada` (com `-campo-<nome>` para cada campo que o Didit apontou). Veja com `docker compose -f deploy/seeder/compose.yaml -f deploy/seeder/compose.web.yaml logs account | grep '"telefone"'`.
Registros: o evento `telefone` traz só palavras fixas, nunca o número, o código ou a chave. Na partida, `ligada` ou `desligada`; `indisponivel` (o `phone.json` não abriu com esta chave, a verificação continua exigida e a etapa fica fechada); `arquivo-sem-chave` (há um `phone.json` mas a chave não está definida, então nenhuma retenção corre). Em uso: `enviado`, `verificado`, `em-uso`, `recusado-linha` (fixo, VoIP ou descartável), `tipo-desconhecido` (aceito, tipo de linha que o serviço não conhece), `teto-diario`, `tabela-cheia`, `armazenamento-indisponivel`, `gravacao-falhou`, `varredura-falhou`, `varredura-exclusao-falhou`, `resultado-desconhecido`, `didit-envio-bloqueado` e, para falhas do Didit, `didit-envio-` ou `didit-checagem-` seguido de `falha` (a resposta do Didit não foi aceita), `http-NNN`, `tempo`, `rede`, `formato` ou `entrada` (com `-campo-<nome>` para cada campo que o Didit apontou). Veja com `docker compose -f deploy/seeder/compose.yaml -f deploy/seeder/compose.web.yaml logs account | grep '"telefone"'`.

O comando `account phone --member <chave>` mostra os números verificados de um membro, para uma ordem judicial ou para o pedido de acesso do próprio membro (LGPD). Precisa da `VARANDA_PHONE_KEY` no ambiente, roda só no servidor (pode rodar com o serviço no ar), não tem rota HTTP, não registra nada e imprime uma linha JSON `{ member, rows }`. Essa saída nunca é colada em issue, chat ou e-mail: entregue-a pelo canal que a ordem ou o pedido indicar. Quando a ordem traz um nome e não uma chave, `account phone --username <nome>` (com ou sem `@`) acha a conta que teve o nome, atual ou passada: um nome que já foi de um membro nunca vai para outro, então sai no máximo uma linha JSON `{ username, key, kind, current, deletedAt, phone }`, com `kind` `membro` ou `excluido`, `current` dizendo se a conta ainda usa o nome e `phone` com as mesmas linhas do `--member` (lista vazia se não houver número). Para uma página (`kind` `pagina`) a linha traz `owner`, a chave de quem a tem, e nenhum número, e a `VARANDA_PHONE_KEY` não é lida; se o `pages.json` registra a mudança de chave da página, vem também `movedTo` (a dona é a da época da mudança), e uma página sem registro no `pages.json` dá "página sem registro em pages.json". Um nome que nunca foi emitido dá "nome não encontrado".

Expand Down Expand Up @@ -786,7 +786,7 @@ Confira e anote:

##### Ordem judicial: desbloqueio e liberação do número

1. A conta ainda existe e a ordem levanta o bloqueio: rode `mod unblock <chave>` num terminal (ele publica a lista). O número deixa de ficar preso na próxima varredura, na partida ou em até uma hora, e, se o bloqueio durou menos de 180 dias, o membro fica com a conta e com o número; passados os 180 dias o número selado já foi apagado e o membro precisa verificar de novo (`telefone-pendente`). Um membro bloqueado pela operação continua com o número preso mesmo depois de excluir a conta; só `mod unblock` (ou um recurso aceito) seguido de uma varredura o solta.
1. A conta ainda existe e a ordem levanta o bloqueio: rode `mod unblock <chave>` num terminal (ele publica a lista). O número deixa de ficar preso na próxima varredura, na partida ou em até uma hora, e, se o bloqueio durou menos de 180 dias, o membro fica com a conta e com o número; passados os 180 dias o número selado já foi apagado e o membro precisa verificar de novo (`telefone-pendente`). Um membro bloqueado pela operação continua com o número preso mesmo depois de excluir a conta; só `mod unblock` (ou um recurso aceito) seguido de uma varredura o solta. Já um membro desbloqueado antes de excluir a conta não tem o número preso de novo pelas denúncias antigas: só uma denúncia decidida como bloquear depois do desbloqueio, ou um bloqueio ainda em vigor na exclusão, o prende.
2. A conta não pode voltar (a pessoa a excluiu, ou a ordem libera só o número): pare o serviço `account`, rode `account phone --release --member <chave>` com a `VARANDA_PHONE_KEY` no ambiente e suba o serviço de novo. O comando toma a mesma trava do serviço, então recusa com o serviço no ar ("pare o serviço de conta antes de liberar um número"), imprime só `{ member, released: true, rows }`, nunca o número, e não mexe na moderação. Rodar de novo para confirmar é seguro: um membro já liberado responde com `alreadyReleased: true`, mesmo depois que a retenção apagou as linhas dele, e só uma chave sem número nem liberação dá "sem telefone registrado". Se a gravação falhar, a liberação pode ou não ter valido: confira com `account phone --member <chave>` antes de rodar de novo e não conserte nem apague o `phone.json`. Depois disso o número pode ser confirmado por outra conta, a chave antiga continua bloqueada e o número selado fica guardado por até 180 dias. `account phone --member` precisa da chave do membro; `account reports --member` só filtra por uma chave que você já tem. Para descobrir a chave, use `account reports` sem `--member` (lista só quem foi denunciado) ou a lista pública de bloqueios (`mod show --json`), que traz também quem foi bloqueado sem denúncia.

#### Páginas (opcional, serviço `account`)
Expand Down
2 changes: 1 addition & 1 deletion apps/app/App.js
Original file line number Diff line number Diff line change
Expand Up @@ -4521,7 +4521,7 @@ function Member () {
showToast(text)
}}
/>
<Ajustes key={locked ? 'locked' : 'open'} screen={ajustes} onNavigate={navigateAjustes} onClose={() => setAjustes(null)} onInfo={ajustesInfo} termsInfo={termsInfo} onTermsReset={dropTermsAndSync} scheduledDeletion={scheduledDeletion} onDeletionChanged={refreshAccount} inviteNudge={inviteNudge} onOpenVarandinha={!deleteFromAviso && node.hosted === true && ownKey ? () => openVarandinha(ownKey) : undefined} onOpenPaginas={!deleteFromAviso && pagesOn({ hosted: node.hosted, accountOrigin: node.accountOrigin }) ? () => pushScreen({ screen: 'paginas' }) : undefined} node={node} member={member} phoneGate={phone.gate} phoneKey={phone.key} phoneChecking={phone.pending} phoneVerified={phone.state === 'verificado' && !phone.error} markVerified={markPhoneVerified} recheckPhone={recheckPhone} termsBeforeCreate={termsBeforeCreate} />
<Ajustes key={locked ? 'locked' : 'open'} screen={ajustes} onNavigate={navigateAjustes} onClose={() => setAjustes(null)} onInfo={ajustesInfo} termsInfo={termsInfo} onTermsReset={dropTermsAndSync} scheduledDeletion={scheduledDeletion} onDeletionChanged={refreshAccount} inviteNudge={inviteNudge} onOpenVarandinha={!deleteFromAviso && node.hosted === true && ownKey ? () => openVarandinha(ownKey) : undefined} onOpenPaginas={!deleteFromAviso && pagesOn({ hosted: node.hosted, accountOrigin: node.accountOrigin }) ? () => pushScreen({ screen: 'paginas' }) : undefined} node={node} member={member} phoneGate={phone.gate} phoneKey={phone.key} phoneChecking={phone.pending} phoneVerified={phone.state === 'verificado' && !phone.error} phoneProofDate={phone.proofDate} phoneKnownDate={phone.knownDate} markVerified={markPhoneVerified} recheckPhone={recheckPhone} termsBeforeCreate={termsBeforeCreate} />
{/* Mounted after the splash, so it wins: while the boot cover shows it
follows the splash, which stays cream on native (Splash.js). */}
<StatusBar style={coveringBoot ? statusBarStyle(Platform.OS === 'web' || previewOn ? scheme : 'light') : statusBarStyle(scheme, { overBand: light || viewerOnTop })} />
Expand Down
47 changes: 47 additions & 0 deletions apps/app/src/phone.js
Original file line number Diff line number Diff line change
Expand Up @@ -71,3 +71,50 @@ export function phoneErrorText (err) {

export const PHONE_SENT_TEXT = 'Enviamos um código para o seu celular.'
export const PHONE_UNCERTAIN_TEXT = 'Não deu para confirmar o envio. Se o código chegar, digite abaixo.'

// A canonical ISO date (Date#toISOString), the shape of an attestation's
// date and of node.info's phoneVerifiedDate.
export function isIsoDate (s) {
if (typeof s !== 'string' || s.length !== 24) return false
const d = new Date(s)
return !Number.isNaN(d.getTime()) && d.toISOString() === s
}

// Whether Ajustes shows 'Trocar o celular': an unlocked passkey account on a
// hosted node whose phone gate is open, for a known member (the shell's,
// which markVerified accepts a proof under). The same rule on the web page
// and on the app's in-app web node: both hold a passkey there.
export function phoneChangeShown ({ hosted, hasPasskey, unlocked, gate, member } = {}) {
return hosted === true && hasPasskey === true && unlocked === true && gate === 'ok' && typeof member === 'string'
}

// Trocar o celular: the service never returns the number, only the date of
// the live verification in a 'verificado' answer's proof (a recorded number
// is a new row with a new date). `before` is the date known when the screen
// opened, `after` the answer's. A doubtful date proves nothing.
export function phoneChange (before, after) {
if (!isIsoDate(before) || !isIsoDate(after)) return 'unknown'
const a = Date.parse(after)
const b = Date.parse(before)
if (a > b) return 'changed'
if (a === b) return 'same'
return 'unknown'
}

export const PHONE_CHANGED_TEXT = 'Celular atualizado.'
export const PHONE_SAME_TEXT = 'Esse já é o seu celular.'
export const PHONE_NOT_CHANGED_TEXT = 'O número ainda não mudou. Confirme o código de novo ou peça outro.'
export const PHONE_CHANGE_UNKNOWN_TEXT = 'Não deu para saber se o número mudou. Se precisar, troque de novo.'

// via: 'send' (the service answered 'verificado' to a send: the number typed
// is already the member's live one, so no code went, whatever the dates
// say), 'check' (to a code) or 'recheck' (the status read after a check
// whose outcome was unknown). stay: the Trocar screen keeps its code field,
// since the service holds an approved code that a new check can still record.
export function phoneChangeOutcome ({ via, before, after } = {}) {
if (via === 'send') return { stay: false, text: PHONE_SAME_TEXT }
const change = phoneChange(before, after)
if (change === 'changed') return { stay: false, text: PHONE_CHANGED_TEXT }
if (change === 'same' && via === 'recheck') return { stay: true, text: PHONE_NOT_CHANGED_TEXT }
return { stay: false, text: PHONE_CHANGE_UNKNOWN_TEXT }
}
16 changes: 9 additions & 7 deletions apps/app/src/screens/Ajustes.js
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ import Identidade from './Identidade'
import Passkeys from './Passkeys'
import Perfil, { KeyboardForm } from './Perfil'
import Telefone from './Telefone'
import { PHONE_CHANGE_UNKNOWN_TEXT, phoneChangeShown } from '../phone'
import Recurso from './Recurso'
import Bloqueados from './Bloqueados'
import Aparelhos from './Aparelhos'
Expand Down Expand Up @@ -195,7 +196,7 @@ function AccountCard ({ ownKey, profile, onPress }) {
)
}

export default function Ajustes ({ screen, onNavigate, onClose, onInfo, termsInfo = null, onTermsReset, scheduledDeletion = null, onDeletionChanged, onOpenPaginas, onOpenVarandinha, inviteNudge = 0, node: nodeProp = null, member: gateMember = null, phoneGate = 'off', phoneKey = null, phoneChecking = false, phoneVerified = false, markVerified, recheckPhone, termsBeforeCreate = null }) {
export default function Ajustes ({ screen, onNavigate, onClose, onInfo, termsInfo = null, onTermsReset, scheduledDeletion = null, onDeletionChanged, onOpenPaginas, onOpenVarandinha, inviteNudge = 0, node: nodeProp = null, member: gateMember = null, phoneGate = 'off', phoneKey = null, phoneChecking = false, phoneVerified = false, phoneProofDate = null, phoneKnownDate = null, markVerified, recheckPhone, termsBeforeCreate = null }) {
const styles = useStyles(makeStyles)
const { colors, mode, setMode } = useTheme()
const node = useNode()
Expand Down Expand Up @@ -438,12 +439,11 @@ export default function Ajustes ({ screen, onNavigate, onClose, onInfo, termsInf

// gateKey is the shell's phone-gate key: markVerified stores the proof only
// for the session the request started under, which keeps the gate open.
// No proof means the sheet closed on a status recheck after a lost check:
// the status says 'verificado' for the old number too, so it cannot tell
// whether the new one was recorded.
const onPhoneVerified = (proof, key) => {
// text: Telefone's verdict from the proof dates (src/phone.js
// phoneChangeOutcome); without one, nothing tells the numbers apart.
const onPhoneVerified = (proof, key, text) => {
if (typeof markVerified === 'function') markVerified(proof, key)
setSaved(proof === undefined ? 'Não deu para saber se o número mudou. Se precisar, troque de novo.' : 'Celular atualizado.')
setSaved(typeof text === 'string' && text !== '' ? text : PHONE_CHANGE_UNKNOWN_TEXT)
onNavigate('lista')
}
const askPhoneAgain = typeof recheckPhone === 'function' ? recheckPhone : undefined
Expand Down Expand Up @@ -487,7 +487,7 @@ export default function Ajustes ({ screen, onNavigate, onClose, onInfo, termsInf
// Prefer the shell member: markVerified only accepts a proof under that key.
const phoneMember = typeof gateMember === 'string' ? gateMember : member
const phoneNode = nodeProp || node
const showChangePhone = account && phoneNode.hosted === true && unlocked && phoneGate === 'ok' && typeof phoneMember === 'string'
const showChangePhone = phoneChangeShown({ hosted: node.hosted === true && phoneNode.hosted === true, hasPasskey, unlocked, gate: phoneGate, member: phoneMember })
const { ui: pushUi, row: pushRow, trailing: pushTrailing, note: pushNote } = pushRowView({ push, pending: pushPending, error: pushError })
const inviting = account && policy !== null && policy.required === true
const lines = versionLines({ app: BUILD, server })
Expand Down Expand Up @@ -727,6 +727,8 @@ export default function Ajustes ({ screen, onNavigate, onClose, onInfo, termsInf
offline={phoneNode.online === false}
statusBusy={phoneChecking}
statusVerified={phoneVerified}
statusDate={phoneProofDate}
knownDate={phoneKnownDate}
/>
</Page>
</KeyboardForm>
Expand Down
Loading
Loading