Funções e Permissões

Max PrilutskiyCEO e cofundador7 min de leitura

O controlo de acesso baseado em funções (RBAC) permite-lhe definir funções personalizadas e atribuir permissões granulares aos membros da sua equipa. Disponível no plano Enterprise.

Quando o RBAC está ativado, as permissões de cada membro vêm da função que lhe foi atribuída — um membro sem função continua na organização, mas não obtém qualquer acesso através de uma função até lhe ser atribuída uma. Sem RBAC, todas as pessoas que entram na organização são Proprietários com acesso total, e Definições → Funções mostra "As funções não estão a ser aplicadas" (consulte Equipa).

Ativar ou desativar o RBAC repõe as funções

Quando o RBAC é ativado ou desativado numa organização, todos os membros e todos os convites pendentes passam para a função Proprietário, pelo que todas as pessoas ficam com acesso total — incluindo faturação e eliminação da organização — até lhes atribuir funções mais restritas.

Permissões#

Cada função é composta por vinte permissões, divididas em três grupos. Definições → Funções apresenta-as com estes rótulos:

PermissãoGrupoConcede
Gerir equipa (org:manage_team)OrganizaçãoConvidar e remover membros, atribuir funções e gerir funções personalizadas
Gerir faturação (org:manage_billing)OrganizaçãoVer e alterar definições de faturação, métodos de pagamento e faturas
Gerir definições (org:manage_settings)OrganizaçãoAlterar o nome da organização, o fuso horário, as integrações e as feature flags
Gerir Chaves de API (org:manage_api_keys)OrganizaçãoCriar, definir o âmbito e eliminar as chaves de API de serviço da organização
Gerir integrações (org:manage_integrations)OrganizaçãoLigar, configurar e desligar integrações externas
Eliminar organização (org:delete)OrganizaçãoEliminar permanentemente toda a organização
Ver registos de auditoria (org:view_audit_logs)OrganizaçãoLer o rasto de auditoria da organização. Requer o direito Audit Logs
Gerir revisões (org:manage_reviews)OrganizaçãoVer o histórico e as estatísticas de revisão das revisões internas de tradução
Ver motores (engine:read)EnginesVer motores de localização e a respetiva configuração
Executar traduções (engine:translate)MotoresExecutar trabalhos de localização nos motores da organização
Criar motores (engine:create)MotoresCriar novos motores na organização
Editar motores (engine:edit)MotoresEditar a configuração do motor e as configurações dos modelos
Eliminar motores (engine:delete)MotoresEliminar permanentemente motores
Rever traduções (engine:review_translations)MotoresRever traduções por IA na fila de revisão interna
Ver glossários (org:glossary:read)ConteúdoVer os glossários da organização e os respetivos termos
Editar glossários (org:glossary:edit)ConteúdoCriar, alterar e eliminar glossários e termos, e aplicá-los aos motores
Ver vozes da marca (org:brandvoice:read)ConteúdoVer as vozes da marca da organização
Editar vozes da marca (org:brandvoice:edit)ConteúdoCriar, alterar e eliminar vozes da marca, e aplicá-las aos motores
Ver regras (org:ruleset:read)ConteúdoVer os conjuntos de regras da organização e as regras que incluem
Editar regras (org:ruleset:edit)ConteúdoCriar, alterar e eliminar conjuntos de regras e regras, e aplicá-los aos motores

Nenhuma permissão é reservada ao Proprietário. O que impede a escalada é que só pode atribuir o que já tem: criar ou editar uma função, atribuir uma função a um membro ou associar uma função a um convite é recusado se essa função incluir uma permissão que a sua própria função não tem.

Funções#

Existem dois tipos de funções:

  • Proprietário — a única predefinição da plataforma, assinalada como Predefinição da plataforma em Definições → Funções. Inclui todas as permissões e não pode ser alterada nem eliminada. A pessoa que cria a organização torna-se o seu primeiro Proprietário; uma organização pode ter vários Proprietários e mantém sempre pelo menos um.
  • Funções personalizadas — qualquer função que crie com Nova função em Definições → Funções: um nome, uma descrição opcional e qualquer conjunto de permissões dos três grupos. Criar, editar e eliminar funções requer RBAC e Gerir equipa.

Algumas organizações mais antigas também têm uma função Acesso total. É uma função personalizada normal — pode editá-la ou eliminá-la como qualquer outra.

As funções agrupam permissões

Um membro tem exatamente uma função ao nível da organização. Para dar acesso parcial, crie uma função com esse subconjunto exato de permissões e atribua-lha. As únicas permissões concedidas fora de uma função são o acesso por motor e o acesso por conteúdo, descritos abaixo.

Eliminar uma função deixa todas as pessoas que a tinham na organização sem função, e os convites pendentes associados a essa função chegam sem função. Não é possível eliminar uma função que uma chave de API da organização ainda tenha — atribua primeiro uma função diferente à chave ou revogue-a.

Atribuir uma função#

Abra Definições → Equipa e, no separador Membros, escolha uma função para o membro. Escolher Sem função mantém essa pessoa como membro, mas sem permissões — continua a poder iniciar sessão, mas nenhuma função lhe dá acesso a motores, definições ou faturação. Para atribuir uma função a alguém antes de essa pessoa entrar, defina Função à chegada quando a convidar no separador Convites. Atribuir funções requer RBAC e Gerir equipa; enviar convites requer Gerir equipa.

Só um Proprietário pode atribuir a alguém a função de Proprietário ou retirá-la, e o último Proprietário remanescente não pode ser despromovido nem removido. Um convite não pode incluir a função de Proprietário.

Acesso ao motor#

As permissões de motor de uma função — Ver motores, Executar traduções, Editar motores, Eliminar motores — aplicam-se a todos os motores de localização da organização. Criar motores aplica-se apenas ao nível da organização.

Para restringir o acesso, conceda motores específicos a utilizadores específicos. Uma concessão por motor dá a esse membro permissões para ver, traduzir, editar e eliminar nesse único motor. As concessões são aditivas — uma função que já inclua uma permissão de motor abrange todos os motores de qualquer forma. Para limitar um utilizador a um único motor, atribua-lhe uma função sem as permissões de motor e depois conceda-lhe esse motor.

O dashboard não permite gerir concessões por motor; defina-as através da API ou do servidor MCP:

ChamadaFerramenta MCPRequer
PUT /organizations/:id/users/:userId/engine-accesspermissions_setUserEngineAccessGerir equipa. Substitui a lista de motores do membro
POST /engines/:id/memberspermissions_addEngineMemberEditar motores nesse motor
DELETE /engines/:id/members/:userIdpermissions_removeEngineMemberEditar motores nesse motor

As concessões só funcionam enquanto a pessoa for membro da organização e apenas quando o RBAC estiver ativado.

Acesso ao conteúdo#

Glossários, vozes da marca e conjuntos de regras funcionam da mesma forma. Uma concessão por item dá a um membro permissões de visualização e edição nesse único glossário, voz da marca ou conjunto de regras, para além da respetiva função. Em separado, qualquer pessoa que possa ver um motor pode ler o conteúdo aplicado a esse motor, para compreender o respetivo resultado.

Defina concessões por item com PUT /organizations/:id/users/:userId/content-access (MCP: permissions_setUserContentAccess), o que requer Gerir equipa e substitui toda a lista de conteúdos do membro.

Chaves de API da organização#

Definições → Chaves de API tem dois separadores. As chaves Pessoais existem em todos os planos e atuam como a pessoa que as criou, com exatamente o mesmo acesso. As chaves da Organização pertencem à organização, continuam a funcionar quando as pessoas saem e requerem RBAC — sem isso, o separador mostra "As chaves da organização requerem controlo de acesso baseado em funções".

  • Criar uma chave da organização e alterar a sua função ou o seu âmbito requer Gerir Chaves de API (org:manage_api_keys).
  • A Função é opcional. Só podem ser atribuídas a uma chave funções limitadas a Ver motores e Executar traduções. Uma função com Executar traduções dá acesso a todos os motores.
  • Com Sem função, a chave "Alcança apenas os motores que escolher abaixo" — o acesso vem inteiramente dos motores nela indicados. Só pode indicar motores nos quais possa executar traduções.
  • Depois de criar uma chave, edite-a para indicar os glossários, as vozes da marca e os conjuntos de regras que pode usar. Uma chave só acede ao conteúdo aí indicado, e só pode indicar conteúdo que possa editar.
  • Se o plano Enterprise terminar, todas as chaves da organização são desativadas com um 403 que identifica o direito, para que a pessoa responsável saiba que deve restaurar o plano ou mudar para uma chave Pessoal, em vez de perder tempo à procura de um suposto erro de âmbito do motor.

Consulte Chaves de API para criar e revogar chaves.

Propriedade#

Não existe uma etapa separada para transferir a propriedade. Um Proprietário transfere a propriedade para outra pessoa ao escolher Proprietário para essa pessoa em Definições → Equipa, e a organização tem sempre de manter pelo menos um Proprietário. Como um convite não pode incluir a função de Proprietário, convide primeiro a pessoa com outra função e depois torne-a Proprietário quando tiver aceite. Para deixar o cargo, promova outro membro a Proprietário e depois reduza a sua própria função (com RBAC ativado) ou remova-se.

Próximos passos#