---
title: Segurança e sessões
description: >-
  Como o GovFrame protege o isolamento por empresa, verifica o acesso e revoga
  sessões diante de mudanças sensíveis.
audiencia: >-
  Administrador | Responsável pelos dados | Curador de dados | Engenheiro de
  dados | Usuário | Superadministrador
roles: >-
  Administração de acessos para Administrador; operações globais autorizadas
  para Superadministrador ou Administrador de plataforma
modulo: Acessos e administração de empresa
revision: '2026-10-19'
section: seguridad
order: 10
sources:
  - CONTEXT.md
  - ARCHITECTURE.md
  - TESTING_GUIDE.md
  - AGENTS.md
  - Modelodeobjetosyrelaciones.md
  - Módulosydependencias.md
  - 'Roles,capacidadesyalcance.md'
locale: pt-br
---
# Segurança e sessões

O GovFrame é um serviço de governança de dados **multiempresa**. A segurança funcional parte de uma regra simples: os dados, as configurações, as relações, a auditoria e as operações de uma empresa permanecem separados dos das demais. O aplicativo determina o contexto da empresa antes de autorizar uma consulta ou ação; alterar um identificador no navegador não concede acesso a outra empresa.

A proteção combina identidade, vínculo, função, capacidade, escopo e módulo. O serviço a aplica mesmo quando uma opção não está visível. Por exemplo, um Curador de dados só pode manter objetos de negócio nos Domínios ou Subdomínios atribuídos.

## Antes de começar

- **Função:** o Administrador revisa os acessos da sua empresa. As operações globais cabem ao Superadministrador ou Administrador de plataforma autorizados; os demais perfis operam dentro de suas responsabilidades e escopo.
- **Módulo:** a administração de acessos e o módulo de negócio envolvido devem estar habilitados. Um módulo desativado não pode ser operado por meio do conhecimento de uma rota ou da alteração de parâmetros.
- **Pré-condições:** confirme uma sessão válida, um vínculo vigente, uma empresa em condição de operar normalmente e, quando aplicável, o Domínio, Subdomínio ou Repositório da ação.

## Percurso recomendado

1. **Confirme o contexto efetivo da empresa.** Normalmente, o GovFrame o resolve com base no hostname normalizado. Uma pessoa Superadministradora pode selecionar uma empresa disponível para operação normal em uma tarefa de plataforma; as pessoas usuárias comuns não escolhem livremente outra empresa. Uma mesma identidade pode ter vínculos diferentes por empresa.

2. **Revise toda a autorização antes de agir.** O GovFrame verifica vínculo, função, capacidade, escopo do objeto e módulo. O Administrador tem escopo global na sua empresa; o Engenheiro de dados, escopo técnico de Repositórios; e o Responsável pelos dados ou Curador de dados, escopo taxonômico atribuído. A função global de Superadministrador não elimina essas verificações.

3. **Mantenha o isolamento nas associações.** Todo objeto e toda relação devem pertencer à empresa efetiva. Uma associação entre Atributo, campo técnico, Regra ou Contrato documenta rastreabilidade, não permissões. Verifique o contexto taxonômico e as relações registradas antes de atribuir uma dependência.

4. **Use os fluxos de identidade previstos.** O GovFrame aceita início de sessão local, recuperação de acesso e autenticação federada. As senhas locais são armazenadas como hashes, nunca em texto simples. Para uma identidade federada, a verificação de e-mail confirmado é feita de forma rigorosa; um sinal ambíguo não deve ser aceito como confirmação. Não compartilhe senhas, tokens, links de recuperação nem dados de autenticação em comentários, evidências ou registros operacionais.

5. **Trate as mudanças sensíveis como eventos de sessão.** As sessões são transportadas por meio de um cookie HTTP-only e verificadas em relação ao estado vigente da conta. Ao alterar a própria senha, o fluxo pode renovar apenas a sessão atual. Já uma redefinição por token, uma redefinição administrativa, a suspensão, a rejeição do cadastro ou uma alteração de função ou escopo revoga as sessões afetadas. Após uma dessas mudanças, peça à pessoa que se autentique novamente, em vez de tentar reutilizar uma sessão anterior.

6. **Aplique as mesmas precauções a conectores e arquivos.** As credenciais não são devolvidas ao cliente; segredos e arquivos privados permanecem em armazenamento seguro, e o banco de dados conserva referências e metadados. Os conectores validam destinos e verificam TLS por padrão. Isso não autoriza conexões de clientes nem garante explorações programadas: elas dependem de configuração e escopo técnico.

> **Exemplo sintético:** uma pessoa fictícia passa de Curador de dados a Usuário para um Domínio. A alteração da função ou do escopo invalida as sessões anteriores afetadas. Ao iniciar sessão novamente, a pessoa só poderá participar das fichas e tarefas permitidas pelo seu novo perfil, escopo e módulos habilitados; não recupera a capacidade de edição por manter uma URL antiga.

## Limites e controles do estado atual

- A segurança não se baseia em ocultar opções: o serviço rejeita operações sem vínculo, capacidade, escopo ou módulo permitido.
- A desativação de um módulo bloqueia sua operação e pode ocultar seus acessos, mas não elimina automaticamente os dados já registrados. Reativar um módulo continua sujeito à função, ao escopo e à condição dos dados.
- Riscos, alertas ou controles podem ser exibidos como informações derivadas de regras de qualidade, políticas, workflows, tarefas, contratos, classificações ou certificações. **Não existe um catálogo independente de Riscos ou Controles** que substitua esses objetos.
- Este guia descreve controles funcionais documentados; não publica segredos, identificadores pessoais, detalhes de infraestrutura, duração de credenciais nem procedimentos internos de autenticação.

## Resultado esperado

Ao concluir a revisão, cada ação estará vinculada a uma empresa efetiva e a uma autorização verificável. As pessoas acessam somente os objetos e módulos que lhes cabem, e as mudanças sensíveis exigem a renovação do acesso quando aplicável.

Para aprofundar o contexto dos objetos e das responsabilidades, consulte [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/), [Como ler o mapa de relações](/pt-br/guias/como-leer-mapa-de-relaciones/), [Funções, capacidades e escopo](/pt-br/referencia/roles-capacidades-y-alcance/) e [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/).