--- title: 'Pessoas, papéis e escopo' description: >- Gerencie associações, perfis e escopos da empresa sem confundir o papel, a capacidade e o escopo de cada pessoa. audiencia: >- Administrador | Responsável pelos dados | Curador de dados | Engenheiro de dados | Superadministrador roles: >- Administrador para gerenciar acessos do tenant; Superadministrador para a administração permitida da plataforma modulo: Acessos e governança revision: '2026-10-19' section: administrar-empresa order: 20 sources: - CONTEXT.md - ARCHITECTURE.md - Modelodeobjetosyrelaciones.md - 'Roles,capacidadesyalcance.md' locale: pt-br --- # Pessoas, papéis e escopo Gerenciar pessoas significa administrar sua relação com uma empresa específica. Uma pessoa pode pertencer a várias empresas, com associação, perfil e estado diferentes. Para atribuir acesso, diferencie **perfil do tenant**, **capacidade** e **escopo**. ## Antes de começar - **Papel:** o **Administrador** gerencia pessoas e acessos da sua empresa por meio de `access.manage`. O **Superadministrador** usa as autorizações permitidas da plataforma; isso não o transforma em um papel do tenant nem contorna as proteções do tenant. - **Módulo:** Acessos e governança. As ações sobre objetos governados continuam sujeitas ao módulo correspondente. - **Pré-condições:** trabalhe na empresa efetiva e com uma associação ativa. Identifique previamente os Domínios, Subdomínios ou Repositórios que comporão o escopo. Uma empresa que não está ativa não deve operar normalmente. O backend calcula a empresa, a associação, as capacidades e o escopo a partir da sessão e dos objetos registrados, e não de valores enviados pelo navegador. ## A diferença entre perfil, capacidade e escopo O **perfil do tenant** expressa uma responsabilidade básica. Há cinco perfis: Usuário, Curador de dados, Responsável pelos dados, Engenheiro de dados e Administrador. As capacidades são as ações autorizadas; o escopo delimita os Domínios, Subdomínios ou Repositórios em que são exercidas. | Perfil | Responsabilidade principal | Escopo operacional documentado | |---|---|---| | Usuário | Consulta e participação em gestões autorizadas. | De acordo com as visualizações e solicitações permitidas pela empresa. | | Curador de dados | Manter definições e objetos de negócio; atender às atividades de curadoria. | Domínios e Subdomínios atribuídos. | | Responsável pelos dados | Responder pela governança do seu escopo e aprovar decisões. | Domínios e Subdomínios atribuídos; pode ser global quando aplicável. | | Engenheiro de dados | Administrar conectores, repositórios, metadados, snapshots e agendas. | Somente Repositórios com escopo técnico atribuído. | | Administrador | Administrar pessoas, acessos, taxonomia, governança e configuração do tenant. | Global dentro da empresa ativa. | Um Responsável pelos dados ou Curador de dados pode consultar mais do que pode editar: criar, editar, associar ou aprovar exige capacidade e escopo autorizados. A Engenharia de dados opera por meio de escopos de Repositório, não por um escopo geral de negócio. Um **Papel de governança** representa o papel de Responsável pelos dados, Curador de dados ou outra responsabilidade de catálogo em um Domínio ou Entidade, e pode estar relacionado a Produtos, Contratos ou Workflows. Não é o perfil de associação que autoriza a sessão. ## Percurso recomendado 1. **Determine a responsabilidade.** Escolha o perfil de participação, curadoria, responsabilidade pelos dados, engenharia de dados ou administração. Os perfis e suas capacidades básicas constituem o contrato atual; não existe edição livre das capacidades por pessoa. 2. **Atribua a associação correta.** Inclua a pessoa no tenant desejado ou atualize sua associação. A associação não concede acesso a outras empresas. 3. **Delimite o escopo.** Atribua Domínios/Subdomínios aos Responsáveis pelos dados e Curadores de dados, ou Repositórios à Engenharia de dados. As atribuições podem ter estado e vigência; use as que estiverem ativas. 4. **Registre a responsabilidade quando aplicável.** Vincule o Responsável pelos dados ou Curador de dados ao nó taxonômico, se ele precisar aparecer no catálogo. Isso complementa, mas não substitui, o perfil nem os controles da sessão. 5. **Revise os módulos e o efeito.** Uma pessoa não pode operar um módulo desativado. Verifique a empresa, o escopo e o objeto; a visibilidade de um botão não comprova autorização. 6. **Trate as alterações como sensíveis.** As alterações de papel ou escopo revogam sessões. A pessoa deve prosseguir com uma sessão válida; não há duração específica documentada. > **Exemplo sintético:** Lucía recebe o perfil de Curador de dados e o Domínio “Atendimento ao cidadão”. Ela pode manter objetos nesse Domínio se o módulo e a capacidade permitirem. Uma solicitação de outro Domínio não amplia sua autorização: é necessária uma atribuição registrada. ## Controles e limites da atribuição A empresa pode atribuir Domínios, Subdomínios e Repositórios, criar responsabilidades e definir papéis para Workflows. Isso não equivale a permissões arbitrárias: as capacidades básicas do backend permanecem. As visualizações temporárias são somente para leitura, exceto pelas mutações de Solicitações de acesso permitidas. A associação ativa, o estado da empresa e o módulo são verificados além da capacidade e do escopo. Um identificador ou nome compartilhado não autoriza uma ação; um vínculo de nível superior não associa nem autoriza todos os campos de uma fonte. ## Resultado esperado Cada pessoa tem uma associação válida, um perfil adequado e um escopo explícito de negócio ou técnico. As responsabilidades visíveis complementam a autorização, mas não a substituem. A escrita fica limitada ao escopo efetivo e à empresa correta. ## Referências para continuar - [Papéis, capacidades e escopo](/pt-br/referencia/roles-capacidades-y-alcance/) - [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/) - [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/) - [Como ler o mapa de relações](/pt-br/guias/como-leer-mapa-de-relaciones/)