Controle de acesso¶
Weblate vem com um sistema de privilégios refinado para atribuir permissões de usuário para toda a instância com funções predefinidas, ou atribuindo um ou mais grupos de permissões a usuários para tudo, ou projetos individuais, componentes, glossários e assim por diante.
Controle de acesso do projeto¶
Nota
Projetos operando o plano livre em Hosted Weblate são sempre Público. Você pode trocar para o plano pago se quer restringir o acesso para seu projeto.
Limite o acesso do usuário a projetos individuais selecionando uma configuração diferente de Controle de acesso. As opções disponíveis são:
- Público
Visível para todos.
Qualquer usuário autenticado pode contribuir.
O repositório VCS pode ser exposto para todo mundo.
Escolha essa opção para projetos em código aberto, ou quando sua instância Weblate é privada ou trancada.
- Protegido
Visível para todos.
Apenas usuários escolhidos podem contribuir.
Somente os usuários selecionados podem acessar o repositório VCS.
Escolha este para ganhar visibilidade, mas continuar tendo controle de quem pode contribuir.
- Particular
Visível apenas para os usuários escolhidos.
Apenas usuários escolhidos podem contribuir.
Somente os usuários selecionados podem acessar o repositório VCS.
Escolha esta opção para projetos que não devem ser expostos publicamente.
- Personalizado
Visível apenas para os usuários escolhidos.
Apenas usuários escolhidos podem contribuir.
Somente os usuários selecionados podem acessar o repositório VCS.
Não disponível em Hosted Weblate.
Você precisará definir todas as permissões usando Controle de acesso em todo o site.
Escolha isso na sua própria instância Weblate se desejar definir o acesso de maneira específica e bastante personalizável.
O Controle de acesso pode ser alterado na guia Acesso da configuração (Operações ↓ Configurações) de cada projeto.
O padrão também pode ser alterado configurando DEFAULT_ACCESS_CONTROL.
Private and Custom projects can make their Public sharing engage pages and status widgets anonymously accessible without making the rest of the project public. Public sharing is disabled by default for these projects.
Nota
Aggregate statistics include Private projects and restricted components, including in site-wide, language, and workspace summaries. Object listings, names, and actions in the web interface and API remain permission-filtered, so these aggregates do not grant access to the underlying projects or components.
Nota
Generic incoming notification hooks are an explicit compatibility exception to identifier confidentiality. When supplied with a matching repository URL, their diagnostic response includes match counts and, when an update is scheduled, the project/component slug and API URL. This also applies to Private projects and restricted components, except components managed through an authenticated integration. The API URL does not bypass access control, and no project content or credentials are included. See Matching webhook targets.
Nota
Os administradores da instância podem modificar os conjuntos de permissões padrão disponíveis para os usuários nos projetos Público, Protegido e Particular usando custom settings.
Ver também
Workspace access control¶
Workspace-scoped teams are documented in Workspace access control.
Gerenciando controle de acesso por projeto¶
Para projetos Públicos, Protegidos e Particulares:
Conceder aos usuários a capacidade de Gerenciar acesso ao projeto (consulte Lista de privilégios) permite que eles atribuam outros usuários em projetos Public, Protected e Private (mas não em projetos Custom) adicionando-os às equipes.
When enabling a project feature requires a built-in team name already used by a custom team, the custom team receives a numeric suffix. Its memberships and permissions are preserved, and the settings page reports the rename.
Existing teams with duplicate names can still be edited without changing their names. Saving the project settings repairs duplicate names: a built-in team keeps its name, and additional teams receive numeric suffixes. Additional built-in teams become editable custom teams. Memberships and permissions are preserved, and the settings page reports the renames.
Estas são as equipes padrão fornecidas com o Weblate; equipes podem ser adicionadas ou modificadas por usuários com privilégios suficientes:
- Administração
Todas as permissões disponíveis para o projeto.
- Revisar
Aprovar traduções em uma revisão.
Disponível somente se fluxo de revisão estiver ativado.
Para projetos Protegidos e Particulares apenas:
- Traduzir
Traduzir o projeto e carregar as traduções feitas offline.
- Fontes
Editar textos fonte (se permitido nas configurações do projeto) e as informações do texto-fonte.
- Idiomas
Gerenciar idiomas traduzidos (adicionar ou remover traduções).
- Glossário
Gerenciar glossário (adicionar, remover e carregar entradas).
- Memória
Gerenciar memória de tradução.
- Capturas de tela
Gerenciar capturas de tela (adicioná-las, removê-las e associá-las a textos fonte).
- Tradução automática
Pode usar tradução automática.
- VCS
Gerenciar VCS e acessar o repositório exportado.
- Cobrança
Acessar informações de cobrança e configurações (consulte Cobrança).
Essas funcionalidades estão disponíveis na página Controle de acesso, que pode ser acessada no projeto a partir do menu Operações ↓ Usuários.
Dica
Você pode limitar equipes a idiomas ou componentes e atribuir a elas funções de acesso designadas (consulte Lista de privilégios).
Before moving a component to another project, remove it from teams defined in its current project. Moving a category requires removing its components from such teams as well. Removing the last component from a team grants its roles to the whole project, so review the team’s membership and roles first.
Teams left with moved components by an earlier release show those assignments by component ID. The assignments grant no access to the destination project. You can remove them through the REST API after reviewing the effect of an empty component selection on the original project.
Administradores de equipe¶
Adicionado na versão 4.15.
Each team can have team administrators, who can add and remove users within the team. Administrators relying on this designation must satisfy the team’s enforced two-factor authentication. Their team management access is suspended while they are blocked in any project covered by the team, or while a covered project requires two-factor authentication they have not configured. For a team covering multiple projects, the restriction applies to the whole team.
Sendo útil caso queira montar equipes autônomas.
Site-wide team management¶
Site-wide team management is controlled by the global group.edit
permission. This is a trusted administrative permission which allows creating,
editing, and deleting site-wide teams, including changing their roles and
project, component, component list, and language selections.
Project and component assignments are not limited to projects the team manager can access directly. A team manager can therefore grant existing team members access to a private project without gaining direct access to that project.
Treat group.edit as instance-wide access management, not as permission to
manage only teams or projects already visible to the user. To delegate access
management within a narrower scope, use a project Administration team,
workspace administration, or a team administrator. Team
administrators can add and remove users, but cannot change the team’s access
scope.
Convidando novos usuários¶
A adição de usuários existentes enviará a eles um convite para confirmação. Com REGISTRATION_OPEN, o administrador também pode convidar novos usuários por e-mail. Os usuários convidados precisam concluir o processo de registro para obter acesso ao projeto.
An invitation can also include team administration. The invitation states this explicitly, and the user becomes a team administrator only after accepting it. Team administrators can add or remove team members.
Não é necessário ter nenhum privilégio em todo o site para fazer isso; a permissão de gerenciamento de acesso no escopo do projeto (por exemplo, ser membro da equipe de Administração) seria suficiente.
Dica
Caso o usuário convidado tenha perdido a validade do convite, um novo convite deverá ser criado.
O mesmo tipo de convites está disponível para todo o site em management interface, na aba Users. Tanto os administradores do projeto quanto os administradores do site podem convidar múltiplos usuários de uma vez só, colando endereços de e-mail separados por espaços. Todos os convites criados em uma ação em massa utilizam a equipe selecionada, e os convites em massa para o site inteiro também aplicam o marcador de superusuário selecionado.
Opening the Users page requires recent identity verification, including for users with read-only access. Weblate requests a second factor when configured, or an existing sign-in credential otherwise. Verification remains valid for ten minutes and is checked again when submitting changes.
Site-wide user management is controlled by the global user.edit
permission. Unlike project access management, this is a trusted administrative
permission which allows editing user accounts across the whole instance. It
includes adding or removing the managed account from any site-wide, workspace,
or project team, and granting or revoking superuser status, even for the
caller’s own account. These actions do not require the Manage teams
permission or separate authority over the affected team.
Treat user.edit as effectively equivalent to superuser access, not as a
limited helpdesk permission. To delegate access management within a narrower
scope, use a project Administration team or a team administrator instead.
Site administrators can also disable password authentication for a user. The Regenerate API key option is enabled by default so that the current personal API key stops working. Clear it only when the current API key should remain active.
Os convites em massa são processados individualmente. Endereços inválidos e endereços com convites já pendentes são ignorados, enquanto os convites válidos são criados e enviados normalmente.
Alterado na versão 5.0: O Weblate agora não cria contas ou adiciona usuários às equipes automaticamente. Isso só é feito após a confirmação do usuário.
Account security findings¶
In Manage → Users, select Validate leaked
passwords to upload a CSV report containing usernames or e-mail addresses and
passwords. This requires the global user.edit permission and recent identity
verification. Reports and findings are shared with other administrators who have
this permission. Opening the security report or an individual finding also
requires recent identity verification.
The CSV upload form opens on a separate page after identity verification. If verification expires before the upload is submitted, confirm your identity again and select the file for another upload. Weblate does not retain uploads rejected because verification expired.
Weblate detects common delimiters and credential column names automatically. If detection fails, configure the delimiter, whether the file has a header, and the column numbers, starting from one. Use UTF-8 files of at most 10 MiB and 50,000 data rows. The uploaded file remains available for configuration for one hour. Validation runs in the background and redirects to stored findings when complete. The summary counts unknown or ambiguous accounts, unusable passwords, malformed or duplicate entries, and matching or nonmatching passwords.
Identifiers are matched against exact usernames, primary e-mail addresses, and verified secondary e-mail addresses. E-mail matching uses the same normalization as account recovery. Inactive users and bot accounts are included. Ambiguous identifiers are not used for password resets. Only confirmed matches become findings. Passwords are never displayed or stored in findings; the uploaded credentials are temporarily encrypted and deleted after processing or expiry.
The Security report link appears once findings or validation reports exist. Findings remain available with their history after handling them. Filter by status, type, or scan. Select Validation reports to return to previous uploads, including reports with no matches and reports still running or that failed. Reports record the uploaded filename and the administrator who submitted it. Individual reports include resolved and dismissed findings by default. Finding history links to each report that detected the issue, and finding details list these reports under Detected in reports. Use the breadcrumbs to move between user management, the security report, validation reports, and findings.
Open findings on the current page are selected by default. Select or clear checkboxes in the browser, then submit an action. Actions apply only to checked findings shown on that page; selections do not carry across pages. Bulk actions require confirmation:
Reset passwords for selected accounts disables matching local passwords, invalidates sessions, revokes all API tokens, and notifies accounts with an e-mail address. Single sign-on and two-factor authentication settings are preserved. Passwords changed since validation are skipped and their obsolete findings resolved.
Dismiss selected findings records the administrator’s decision without changing credentials or notifying the account. A later upload confirming the exposure reopens the finding; retrying the same scan does not.
The deployment check weblate.W052 warns while open findings exist. Resolve or
dismiss them in the report to clear the warning. A matching credential establishes
that the current password was present in the report; it does not establish where
it was exposed.
An upgrade check also reports verified e-mail addresses that match their account’s primary address only under the database’s former locale-sensitive comparison. These findings indicate a possible earlier account compromise. The address remains usable until an administrator reviews the finding. The Remove lookalike e-mail identities and reset selected accounts action removes the suspect verified address and associated sign-in identity, disables the account password, invalidates sessions, revokes API tokens, and notifies the primary address. Dismiss a finding only after confirming that the address is intentionally linked to the account.
Bloqueando usuários¶
Adicionado na versão 4.7.
If users misbehave in your project, you can block them from contributing. Blocked users cannot access the project or use their project permissions, including project administration permissions. Site superusers are exempt.
Blocking preserves team memberships. Permissions granted by those memberships apply again when the block expires or is removed. Blocking does not cancel background work that was already authorized or remove existing administrative configuration, such as add-ons.
Remove a user’s project administration or team administration rights before blocking them. Weblate rejects new blocks on administrators and direct administrative team assignments to users blocked in a covered project. Changes to broader team roles or project scope can still create such a combination; the block continues to suppress project permissions in that case. Project blocks do not revoke independent workspace permissions.
Cleaning up user contributions¶
When blocking spam or abusive accounts, project administrators can also clean up the user’s existing contributions in that project. Use Operations ↓ Users, block the user, and select the cleanup actions in the block form. For users who are already blocked, use Clean up user contributions in the blocked users list.
The available cleanup actions are:
Revert user edits reverts the latest editable translations by the user.
Reject user suggestions rejects pending suggestions by the user.
Delete user comments deletes comments by the user.
Site administrators with the site-wide user.edit permission can perform
the same bulk cleanup across all projects from the
management interface on the Users
tab. Open the user’s profile, select the Edit tab, and use
Contribution cleanup.
Gerenciamento de permissões por projeto¶
Você pode definir seus projetos como Protegido ou Particular (consulte Controle de acesso do projeto) e manage users access por projeto.
Por padrão, isso impede que o Weblate conceda acesso fornecido por equipes padrão Usuários e Visualizadores devido à própria configuração dessas equipes. Isso não impede que você conceda permissões a esses projetos em todo o site, alterando equipes padrão, criando uma nova ou criando configurações personalizadas adicionais para componentes individuais, conforme descrito em Controle de acesso em todo o site abaixo.
Um dos principais benefícios de gerenciar permissões por meio da interface de usuário do Weblate é que você pode delegá-las a outros usuários sem dar a eles o privilégio de superusuário. Para isso, adicione-os à equipe Administração do projeto.
This project-scoped delegation is separate from the site-wide user.edit
permission. Membership in a project Administration team allows managing
access only for that project, while user.edit grants site-wide user
management in the Weblate UI and API and should be assigned only to fully
trusted site administrators.
Tokens de acesso por projeto¶
Adicionado na versão 4.10.
Você pode definir tokens de acesso no escopo do projeto na guia Acesso à API. Os tokens da API podem ter uma data de expiração definida e suas permissões podem ser personalizadas pelas associações da equipe, assim como pelos usuários.
Controle de acesso em todo o site¶
Nota
Este recurso não está disponível em Hosted Weblate.
O sistema de permissões baseia-se em funções que definem um conjunto de permissões e equipes que vinculam funções a usuários e traduções. Consulte Usuários, papéis, equipes e permissões para obter mais detalhes.
As funcionalidades mais avançadas do sistema de controle de acesso do Weblate podem ser configuradas na Interface de gerenciamento. Você pode usá-la para gerenciar as permissões de qualquer projeto. Você não precisa necessariamente alterá-la para Personalizado access control para utilizá-la. No entanto, é necessário ter privilégios de superusuário para utilizá-la.
Se você não está interessado em detalhes de implementação, e apenas deseja criar uma configuração simples o suficiente com base nos padrões, ou não tem um acesso de todo o site para toda a instalação do Weblate (como em Hosted Weblate), consulte a seção Gerenciando controle de acesso por projeto.
Gerenciamento de permissões para todo o site¶
Para gerenciar permissões para uma instância inteira de uma vez, adicione usuários às default teams:
Usuários (isso é feito por padrão pela automatic team assignment).
Revisores (se você estiver usando fluxo de revisão com revisores dedicados).
Gestores (se você deseja delegar a maioria das operações de gestão a outra pessoa).
Você deve manter todos os projetos configurados como Públicos (Consulte Controle de acesso do projeto), caso contrário as permissões de todo o site fornecidas pela participação nas equipes Usuários e Revisores não terão nenhum efeito.
You may also grant additional permissions to the default teams. To change a built-in role for every team using it, customize its permissions as described in Equipes e funções padrão. For example, adding screenshot permissions to Power user affects the Users team and any other teams assigned that role.
To change permissions for only one team, create a custom role and assign it to that team. Custom roles remain independent of upstream defaults. To reduce a team’s permissions, replace or remove its existing roles as needed; adding a narrower role does not revoke permissions granted by another role.
Você também pode definir algumas novas equipes personalizadas. Se você deseja continuar gerenciando suas permissões em todo o site para essas equipes, escolha um valor apropriado para Seleção de projeto (por exemplo Todos os projetos ou Todos os projetos públicos).
Permissões personalizadas a idiomas, componentes ou projetos¶
Você pode criar suas próprias equipes dedicadas para gerenciar permissões para objetos distintos, como linguagens, componentes e projetos. Embora essa equipes só possam conceder privilégios adicionais, você não pode revogar qualquer permissão concedida por equipes de todo o site ou por projeto adicionando outra equipe personalizada.
Exemplo:
Restringir a tradução para o Tcheco a um conjunto selecionado de tradutores (mantendo as traduções para outros idiomas públicas):
Remove the permission to translate Czech from all users. In the default configuration this can be done by altering the Users default team. Built-in teams reject this change in the team management UI, use the Django admin interface instead.
Grupo Usuários¶ Todos os idiomas
Desativado
Idiomas
Todos, exceto Tcheco
Adicionar uma equipe dedicada para tradutores(as) de Tcheco.
Grupo Tradutores(as) de tcheco¶ Funções
Usuários(as) avançados(as)
Seleção de projeto
Todos os projetos públicos
Todos os idiomas
Desativado
Idiomas
Tcheco
Adicione usuários aos quais deseja conceder permissões a esta equipe.
As permissões de gerenciamento dessa forma são poderosas, mas podem ser um trabalho bastante tedioso. Você só pode delegá-lo a outros usuários concedendo-lhes o status de Superusuário.
Usuários, papéis, equipes e permissões¶
Os modelos de autenticação consistem em vários objetos:
- Permissão
Permissão individual definida pela Weblate. As permissões não podem ser atribuídas aos usuários, somente por meio da atribuição de funções.
- Papel
Uma função define um conjunto de permissões (e pode ser reutilizada em vários lugares).
- Usuário
Um usuário pode pertencer a várias equipes.
- Grupo
Os grupos conectam funções e usuários a objetos de autenticação (projetos, idiomas, componentes e listas de componentes).
Nota
Uma equipe não pode ter papéis atribuídos a ela; nesse caso, o acesso para visualizar o projeto por qualquer pessoa é presumido (veja abaixo).
Acesso de navegação no projeto¶
Um usuário tem que ser um membro de uma equipe vinculada ao projeto ou qualquer componente dentro daquele projeto. Ser membro é suficiente, não são necessárias permissões específicas para visualizar o projeto (isso é usado na equipe padrão Visitantes, consulte Lista de equipes).
Acesso à navegação de componentes¶
Granting browsing access to a user in one project gives it access to any component with derived browsing permissions. With Acesso restrito on, ordinary component access requires an explicit grant. Users with Edit project settings permission can also browse all components in that project.
Âmbito das equipes¶
O âmbito da permissão atribuída pelas funções nas equipes é aplicado pelas seguintes regras:
Se a equipe especificar qualquer Lista de componentes, todas as permissões dadas aos membros dessa equipe serão concedidas para todos os componentes nas listas de componentes anexadas à equipe, e um acesso sem permissões adicionais é concedido para todos os projetos estes componentes estão contidos. Componentes e Projetos são ignorados.
O uso de grandes listas de componentes pode ter um impacto no desempenho; em vez disso, considere a possibilidade de fornecer acesso por meio de projetos.
Se a equipe especificar quaisquer Componentes, todas as permissões dadas aos membros dessa equipe são concedidas para todos os componentes anexados à equipe, e um acesso sem permissões adicionais é concedido para todos os projetos nos quais que esses componentes estão. Projetos são ignorados.
Otherwise, if the team specifies any Projects, either by directly listing them or by having Projects selection set to a value like All public projects, all those permissions are applied to all the projects, which effectively grants the same permissions to access all projects unrestricted components.
The restrictions imposed by a team’s Languages are applied separately, when it’s verified if a user has access to perform certain actions. Namely, it’s applied only to actions directly related to the translation process itself like reviewing, saving translations, adding suggestions, and creating new translations. Requesting a language from maintainers does not create a translation and remains available outside the team’s language selection.
Individual team memberships can further limit these permissions to selected languages. Leaving the per-member language limit empty applies no additional limit beyond the team language selection. The same language limit can be set when inviting new users to a project team. When a per-member language limit is set, the membership grants only permissions that can be evaluated for one of those languages. Project-wide, component-wide and global permissions from that team are not granted for that member.
Aggregate translation downloads apply these rules to each translation. Project, category, component, component-list, and workspace archives contain only components and languages for which the user has Download translation file permission. Restricted components therefore require an explicit component grant for this permission even when the user can download unrestricted components in the same project.
The VCS permissions to commit, push, reset, and update are evaluated on the component that owns the repository. A member needs component-wide permission on that owner, even when starting an operation from a linked component in another project. Permissions on linked components neither grant this authority nor restrict the owner’s authorized users. A per-member language limit cannot grant these permissions.
Linking a component accepts the owner’s authority over the shared checkout. Repository operations affect the whole checkout and its linked components. They do not grant access to otherwise inaccessible component pages.
Project-wide repository status and operations include repositories for which the member has permission on the owner. Other repositories are listed separately and are not inspected or changed. An operation is denied when none of the project’s repositories are available to it.
The Manage reports permission applies to the complete selected report scope. It grants access to report data from restricted components and, at workspace scope, private projects even when those descendants are not otherwise visible to the user. Grant it only to users trusted with all report data in that scope. Complete workspace reports are unavailable to regular users until they configure two-factor authentication when any project in the workspace enforces it. Superusers and bot accounts are exempt.
The Edit component settings permission allows administrative operations that can affect repository contents. For example, users can choose files through component settings or install and configure component add-ons. An automatic translation add-on can copy translations from an eligible restricted source component into a component its manager can access, even if that manager can not directly access the source; see Complementos. For a linked component, these operations use the complete shared checkout. Grant this permission only to users trusted by the repository owner with that checkout. Ordinary translation permissions do not grant this administrative access.
Repository-wide VCS permissions protect explicit commit, push, reset, and update operations. They are not required for Weblate’s normal background commit and push of translation changes made through an authorized component.
The Edit project settings permission authorizes persistent administration across the project. Project backups contain all components, including restricted ones. It also grants direct access to all project components and allows editing their settings, deleting them, and changing restricted access, subject to billing limits. It does not grant translation, review, or download permissions. On restricted components, these action permissions must come from a team scoped to the component or a component list containing it; project-scoped action permissions do not apply, including for project administrators. Project and category add-ons also operate on all compatible components in their configured scope. Grant this permission only to users trusted with the complete project data and these administrative effects.
Add-on configuration is stored system configuration rather than a delegation from the account which saved it. Component add-ons can consume inputs outside the destination component when the add-on documents such a source scope. The available configuration and the meaning of options such as all compatible components do not vary with the administrator who last saved the add-on. The add-on continues to run if the configuring user’s permissions or account later change; review or remove the configuration separately during access revocation.
Dica
Use All languages or Project selection to automate inclusion of all languages or projects.
Exemplo:
Um projeto
foocom os componentes:foo/barefoo/baz, com direitos de revisão e gerenciamento, na seguinte equipe:
Grupo Revisores-admins de espanhol¶ Funções
Review strings, Manage repository
Componentes
foo/bar
Idiomas
Espanhol
Os membros dessa equipe terão essas permissões (assumindo as configurações de função padrão):
Acesso geral (navegação) para todo o projeto
fooincluindo ambos componentes nele:foo/barefoo/baz.Revisar textos na tradução para espanhol de
foo/bar(não em outro lugar).Gerenciar VCS para todo o repositório
foo/bar, por exemplo, fazer commit de alterações pendentes feitas por tradutores de todos os idiomas.
Atribuições de equipe automáticas¶
While editing the Team, you can specify Automatic assignments, which is a list of regular expressions used to automatically assign newly created users to a team based on their e-mail addresses. Rules are evaluated only upon account creation, for every new user on the instance.
For project and workspace teams, matching rules create invitations. Users receive an e-mail identifying automatic team assignment as the source and must accept the invitation before joining. Pending invitations are also available in account settings. Accounts without an e-mail address see the invitation only in account settings. Team managers can see pending invitations.
For site-defined teams, matching users are added directly. This includes the default teams. Existing memberships are not changed by this behavior.
O caso de uso mais comum de funcionalidade é atribuir todos os novos usuários a alguma equipe padrão. Esse comportamento é usado para as equipes padrão Users e Guest (consulte Lista de equipes). Use a expressão regular ^.*$ para corresponder a todos os usuários.
Outro caso de uso para essa opção pode ser conceder alguns privilégios adicionais aos funcionários de sua empresa por padrão. Supondo que todos eles usem endereços de e-mail corporativos em seu domínio, isso pode ser feito com uma expressão como ^.*@mycompany.com.
Nota
Associação automática de equipe para Usuários e Visitantes sempre será recriada ao atualizar de uma versão anterior do Weblate para outra. Se você deseja desativá-los, defina a expressão regular para ^$ (que nunca corresponderá).
Nota
Bulk inviting through the user interface creates invitations. Existing users still have to confirm the invitation before they become team members.
Equipes e funções padrão¶
Após a instalação, um conjunto padrão de equipes é criado (consulte Lista de equipes).
These roles and teams are created upon installation. Administrators can edit built-in role permissions in the management interface or through the REST API. Built-in roles have fixed names and cannot be deleted. The role list identifies built-in roles and indicates whether their permissions are customized. Editing a role affects every team assigned that role. You no longer need to create a custom role solely to change built-in defaults; use a custom role when you need an independent permission set for selected teams.
During upgrades, database migrations merge changes to the built-in defaults with your assigned permissions. Locally added permissions remain assigned, and locally removed permissions remain excluded. New upstream permissions are added, and permissions removed from upstream defaults are removed. Custom roles are unchanged. The merge compares permission sets, not editing history: keeping an existing default permission does not record a separate local addition. If an upstream permission is removed and later reintroduced, it is treated as a new upstream addition. A previous local removal does not survive the permission’s intervening absence from upstream defaults.
To discard customizations, select built-in roles and use Reset built-in roles to defaults in the management interface, then confirm the reset. Resetting applies the current upstream defaults to all teams using those roles.
Alterado na versão 2026.11: Built-in role permissions became editable. On the first upgrade to this version, existing built-in roles are assumed to be synchronized and receive the current defaults. Earlier changes made through the API or database are replaced. Subsequent upgrades preserve local customizations.
Existing custom roles named Discover users or View user profiles are
renamed with a (custom) suffix before the new built-in roles are created.
A numbered suffix is used if that name is already taken. Their permissions
and team assignments are preserved.
Confidential collaboration¶
The resource permission contribution.view_author controls contributor
attribution in translation history, comments, suggestions, activity, feeds, and
the REST API. Built-in translation and review roles grant it by default,
including Administration. History and attribution remain stored;
hiding identities does not remove changes, timestamps, diffs, or revert actions.
Ver também
Configuring confidential collaboration for the combined role and team configuration.
Regenerated translation exports require translation.download and remain
available without contributor identity access when the exporter explicitly
supports identity-safe output. Original files, original-file archives, and
unclassified exporters also require contribution.view_author because their
metadata can contain contributor identities. The built-in Access
repository and Manage languages roles grant contributor identity
access to preserve their original-file download capability. Remove this grant
from those roles too when configuring confidential collaboration.
The following inventory summarizes independent identity disclosure paths:
Surface |
Authorization |
|---|---|
Editor attribution, history, comments, suggestions, feeds, notifications |
|
Regenerated content exports |
|
Original files and unclassified exports |
Download permission and contributor identity access |
Independent |
|
Full reports and change downloads |
Independent |
Own-data reports |
The report creator, limited to their own contributions |
Membership, directory, and profile information |
Existing access-management and user permissions |
Workspace-only attribution |
|
Unscoped global attribution |
Site administrators |
Administrator-configured add-on searches |
Persistent administrative configuration, independent of direct contributor access |
Administrator-configured integrations |
Trusted destinations; contributor identities are retained |
Author filters in full reports and change downloads use their independent
reports.view and change.download permissions, including when
contribution.view_author is removed.
Workspace grants do not override project, component, or language restrictions when a history entry has a more specific resource scope.
Original archives omit auxiliary files when their translation scope is not allowed. Auxiliary files without a translation scope require component-wide download and contributor identity permissions.
Configured add-ons retain their administrative search scope, just as they do for restricted components. Removing a configuring user’s contributor identity access does not disable the saved operation.
Individual notifications use the recipient’s permissions. Administrator-managed integrations, including webhooks and Slack, are trusted exports and can retain contributor identities. Configure their destinations for an appropriately restricted audience, or disable them. Weblate cannot control onward sharing or remove copies already delivered to mailboxes, downloaded files, or external systems.
This feature hides system-provided attribution, not identifying text entered by users in translations, comments, announcements, filenames, or other content. It does not provide comprehensive anonymity or prevent correlation using timing and content. See Privacy configuration for the separate Git commit identity, profile, and discovery controls.
Lista de privilégios¶
Escopo |
Permissão |
Funções integradas |
|---|---|---|
Colaboradores |
Visualizar identidades do colaborador |
Administração |
Edit source |
||
Adicionar sugestão |
||
Access repository |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Manage languages |
||
Alterações |
Baixar alterações |
Administração |
Comentários |
Publicar comentário |
Administração |
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Excluir comentário |
Administração |
|
Resolver comentário |
Administração |
|
Translation coordinator |
||
Revisar textos |
||
Componente |
Editar configurações do componente |
Administração |
Bloquear componente, evitando traduções |
Administração |
|
Manage repository |
||
Glossário |
Adicionar entrada no glossário |
Administração |
Manage glossary |
||
Power user |
||
Translation coordinator |
||
Adicionar terminologia ao Glossário |
Administração |
|
Manage glossary |
||
Translation coordinator |
||
Editar entrada do glossário |
Administração |
|
Manage glossary |
||
Power user |
||
Translation coordinator |
||
Excluir entrada do glossário |
Administração |
|
Manage glossary |
||
Power user |
||
Translation coordinator |
||
Enviar entradas ao glossário |
Administração |
|
Manage glossary |
||
Power user |
||
Translation coordinator |
||
Serviços de tradução |
Usar sugestões automáticas |
Administração |
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Memória de tradução |
Editar memória de tradução |
Administração |
Manage translation memory |
||
Excluir memória de tradução |
Administração |
|
Manage translation memory |
||
Projetos |
Editar configurações do projeto |
Administração |
Gerenciar acesso ao projeto |
Administração |
|
Relatórios |
Gerenciar relatórios |
Administração |
Workspace administration |
||
Capturas de tela |
Adicionar captura de tela |
Administração |
Translation coordinator |
||
Manage screenshots |
||
Editar captura de tela |
Administração |
|
Translation coordinator |
||
Manage screenshots |
||
Excluir captura de tela |
Administração |
|
Translation coordinator |
||
Manage screenshots |
||
Textos fonte |
Editar informações adicionais do texto |
Administração |
Edit source |
||
Textos |
Adicionar novo texto |
Administração |
Remover um texto |
Administração |
|
Descartar verificação com falha |
Administração |
|
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Editar textos |
Administração |
|
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Revisar textos |
Administração |
|
Translation coordinator |
||
Revisar textos |
||
Editar textos em massa |
Administração |
|
Bulk editing |
||
Editar texto quando as sugestões são forçadas |
Administração |
|
Translation coordinator |
||
Revisar textos |
||
Editar textos fonte |
Administração |
|
Edit source |
||
Power user |
||
Translation coordinator |
||
Sugestões |
Aceitar sugestão |
Administração |
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Adicionar sugestão |
Administração |
|
Edit source |
||
Adicionar sugestão |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Excluir sugestão |
Administração |
|
Power user |
||
Translation coordinator |
||
Votar na sugestão |
Administração |
|
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Traduções |
Adicionar idioma para tradução |
Administração |
Power user |
||
Translation coordinator |
||
Manage languages |
||
Executar tradução automática |
Administração |
|
Automatic translation |
||
Excluir tradução existente |
Administração |
|
Manage languages |
||
Baixar arquivo de tradução |
Administração |
|
Edit source |
||
Access repository |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Manage languages |
||
Adicionar vários idiomas para tradução |
Administração |
|
Manage languages |
||
Envios |
Definir autor da tradução enviada |
Administração |
Sobrescrever os textos existentes com os enviados |
Administração |
|
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
Enviar traduções |
Administração |
|
Edit source |
||
Power user |
||
Translation coordinator |
||
Revisar textos |
||
Translate |
||
VCS |
Acessar repositório interno |
Administração |
Access repository |
||
Power user |
||
Translation coordinator |
||
Manage repository |
||
Fazer commit das alterações para o repositório interno |
Administração |
|
Manage repository |
||
Enviar alteração do repositório interno |
Administração |
|
Manage repository |
||
Redefinir as alterações no repositório interno |
Administração |
|
Manage repository |
||
Visualizar local do repositório upstream |
Administração |
|
Access repository |
||
Power user |
||
Translation coordinator |
||
Manage repository |
||
Atualizar o repositório interno |
Administração |
|
Manage repository |
||
Novidades |
Publicar novidades |
Administração |
Translation coordinator |
||
Excluir novidades |
Administração |
|
Translation coordinator |
||
Workspaces |
Editar configurações do espaço de trabalho |
Workspace administration |
Adicionar projetos ao espaço de trabalho |
Workspace administration |
|
Add workspace projects |
||
Gerenciar acesso ao espaço de trabalho |
Workspace administration |
|
Privilégios para todo o site |
Explorar usuários |
Discover users |
Buscar colaboradores de recurso |
Discover users |
|
Ver perfis do usuário |
View user profiles |
|
Usar interface de gerenciamento |
||
Gerenciar configuração do site |
||
Adicionar novos projetos |
Adicionar novos projetos |
|
Adicionar novos espaços de trabalho |
Adicionar novos projetos |
|
Adicionar definições de idioma |
||
Gerenciar definições de idiomas |
||
Gerenciar equipes |
||
Visualizar informações de equipe |
||
Gerenciar usuários |
||
Visualizar informações de usuário |
||
Gerenciar funções |
||
Visualizar informações de função |
||
Gerenciar novidades |
||
Gerenciar memória de tradução |
||
Gerenciar serviços de tradução |
||
Gerenciar listas de componentes |
||
Gerenciar faturamento |
||
Gerenciar complementos para todo o site |
Aviso
Roles do not have a separate scope; the permissions in a role determine its scope. A role containing a permission listed under Site wide privileges grants that permission across the Weblate instance when assigned through a site-wide team. The team’s project selection does not narrow these permissions.
Site-wide privileges are not granted to any default role. Treat any roles
containing them, including customized built-in roles, as trusted administrative
access because some are effectively equivalent to superuser status. For example, group.edit
allows changing team scope to grant access to private projects, and
user.edit allows users to change their own team memberships and grant
themselves superuser status. See Site-wide team management and
site-wide user management for details.
Lista de funções integradas¶
Discover users |
|
View user profiles |
|
Administração |
|
Editar fonte |
|
Adicionar sugestão |
|
Acessar repositório |
|
Gerenciar glossário |
|
Usuário avançado |
|
Coordenador de tradução |
|
Revisar textos |
|
Traduzir |
|
Gerenciar idiomas |
|
Bulk editing |
|
Tradução automática |
|
Gerenciar memória de tradução |
|
Gerenciar capturas de tela |
|
Gerenciar repositório |
|
Workspace administration |
|
Add workspace projects |
|
Adicionar novos projetos |
|
Lista de equipes¶
As equipes a seguir são criadas na instalação (ou após a execução de setupgroups) e você pode modificá-las livremente. No entanto, a migração as recriará se você as excluir ou renomear.
- Convidados
Define permissões para usuários não autenticados.
Esta equipe contém apenas usuários anônimos (consulte
ANONYMOUS_USER_NAME).Remova funções desta equipe para limitar as permissões para usuários não autenticados.
Default roles: Add suggestion, Access repository, View user profiles
- Visitantes
Essa função garante a visibilidade dos projetos públicos para todos os usuários. Por padrão, todos os usuários são membros dessa equipe.
By default, automatic team assignment makes all new accounts members of this team when they join.
Funções padrão: nenhuma
- Usuários
Equipe padrão para todos os usuários.
By default, automatic team assignment makes all new accounts members of this team when they join.
Default roles: Power user, Discover users, View user profiles
- Revisores
Grupo para revisores (consulte Fluxos de tradução).
Funções padrão: Revisar textos
- Gerenciadores
Grupo para administradores.
Funções padrão: Administração
- Criadores do projeto
Adicionado na versão 5.1.
Usuários que podem criar novos projetos.
Funções padrão: Adicionar novos projetos
Aviso
Nunca remova as equipes e os usuários predefinidos do Weblate, pois isso pode levar a problemas inesperados! Se não tiver utilidade para eles, simplesmente remova todos os seus privilégios.
Restrições adicionais de acesso¶
If you want to use your Weblate installation in a less public manner, i.e. allow
new users on an invitational basis only, it can be done by configuring Weblate
in such a way that only known users have an access to it. In order to do so, you can set
REGISTRATION_OPEN to False to prevent registrations of any new
users, and set REQUIRE_LOGIN to True to require signing in to access
all the site pages. This is basically the way to lock your Weblate installation.
Additionally, changing DEFAULT_ACCESS_CONTROL to 100 will make
all newly created projects private, requiring explicit access to be granted.
Dica
Você pode usar Convidando novos usuários para adicionar novos usuários.
Expiration of user accounts¶
Each account can have an expiry set. After the expiration, the account will be automatically disabled. This is used for Tokens de acesso por projeto, but can be utilized for regular users as well.
See Privacy configuration to configure user discovery and profile access through roles.