Autenticação¶

Registo de utilizador¶

A configuração predefinida para o Weblate é utilizar python-social-auth, um formulário no “”site”” da Web para lidar com o registo de novos utilizadores. Depois de confirmar os seus “”e-mails””, um novo utilizador pode contribuir ou autenticar para utilizar um dos serviços de terceiros.

Também pode desativar o registo de novos utilizadores configurando REGISTRATION_OPEN.

As tentativas de autenticação estão sujeitas a Limitação de taxa.

Backends de autenticação¶

O Weblate utiliza Django para autenticação. Isto inclui autenticação integrada baseada em palavra-passe, autenticação social e backends de autenticação de terceiros para Django.

Utilizar a autenticação integrada do Django signfica que pode importar a base de dados dos utilizadores de outros projetos baseados no Django (consulte Migrando de Pootle).

Veja também

Configurações de autenticação descreve como configurar a autenticação na imagem oficial do Docker.

Autenticação por palavra-passe¶

O settings.py padrão vem com um conjunto razoável de AUTH_PASSWORD_VALIDATORS que garante que palavras-passe fracas não sejam permitidas. Pode personalizar esta configuração para corresponder à sua política de palavra-passe.

Além disso, também pode instalar o django-zxcvbn-password-validator que fornece estimativas bastante realistas para dificuldade da palavra-passe e permite rejeitar palavras-passe abaixo de um determinado limite.

Veja também

Autenticação por SAML¶

Added in version 4.1.1.

Alterado na versão 5.12: As dependências para autenticação SAML não estão mais incluídas nos extras padrão all. Precisa incluir saml ao instalar o pacote Weblate usando pip (uv pip install Weblate[all,saml]).

Por favor, siga as instruções do Python Social Auth para configuração. Diferenças notáveis:

O Weblate suporta a única IDP que tem de ser chamada de weblate em SOCIAL_AUTH_SAML_ENABLED_IDPS.
The SAML XML metadata URL is /accounts/metadata/saml/, which is also an entity ID.
The sign-in URL is /accounts/complete/saml/ (also known as ACS URL).
As definições a seguir são preenchidas automaticamente: SOCIAL_AUTH_SAML_SP_ENTITY_ID, SOCIAL_AUTH_SAML_TECHNICAL_CONTACT, SOCIAL_AUTH_SAML_SUPPORT_CONTACT

Exemplo de configuração:

# Authentication configuration
AUTHENTICATION_BACKENDS = (
    "social_core.backends.email.EmailAuth",
    "social_core.backends.saml.SAMLAuth",
    "weblate.accounts.auth.WeblateUserBackend",
)

# Social auth backends setup
SOCIAL_AUTH_SAML_SP_ENTITY_ID = f"https://{SITE_DOMAIN}/accounts/metadata/saml/"
SOCIAL_AUTH_SAML_SP_PUBLIC_CERT = "-----BEGIN CERTIFICATE-----"
SOCIAL_AUTH_SAML_SP_PRIVATE_KEY = "-----BEGIN PRIVATE KEY-----"
SOCIAL_AUTH_SAML_ENABLED_IDPS = {
    "weblate": {
        "entity_id": "https://idp.testshib.org/idp/shibboleth",
        "url": "https://idp.testshib.org/idp/profile/SAML2/Redirect/SSO",
        "x509cert": "MIIEDjCCAvagAwIBAgIBADA ... 8Bbnl+ev0peYzxFyF5sQA==",
    }
}
SOCIAL_AUTH_SAML_ORG_INFO = {
    "en-US": {
        "name": "example",
        "displayname": "Example Inc.",
        "url": "http://example.com"
    }
}
SOCIAL_AUTH_SAML_TECHNICAL_CONTACT = {
    "givenName": "Tech Gal",
    "emailAddress": "technical@example.com"
}
SOCIAL_AUTH_SAML_SUPPORT_CONTACT = {
    "givenName": "Support Guy",
    "emailAddress": "support@example.com"
}

You can generate a new pair of keys using:

openssl req -newkey rsa:4096 -new -x509 -days 3652 -nodes -out saml.crt -keyout saml.key

The default configuration extracts user details from following attributes, configure your IdP to provide them:

Atributo	Referência de URI SAML
Nome completo	`urn:oid:2.5.4.3`
Primeiro nome	`urn:oid:2.5.4.42`
Nome familiar	`urn:oid:2.5.4.4`
E-mail	`urn:oid:0.9.2342.19200300.100.1.3`
Nome de utilizador	`urn:oid:0.9.2342.19200300.100.1.1`

When configuring Weblate SP in your IdP, it is recommended to choose persistent Name ID format.

Dica

The example above and the Docker image define an IdP called weblate. You might need to configure this string as Relay in your IdP.

Nota

Weblate authentication relies on the RelayState parameter to be passed through the authentication process. This needs to be configured with some identity providers:

How to Send a Custom RelayState with Okta

Veja também

Autenticação por LDAP¶

A autenticação por LDAP pode ser melhor alcançada utilizando o pacote django-auth-ldap. Pode instalá-lo através dos meios habituais:

# Using PyPI
uv pip install 'django-auth-ldap>=1.3.0'

# Using apt-get
apt-get install python-django-auth-ldap

Dica

Este pacote está incluído no contentor Docker, consulte Instalar utilizando Docker.

Nota

Há algumas incompatibilidades no módulo Python LDAP 3.1.0, o que o pode impedir de usar essa versão. Se obter o erro AttributeError: “module” object has no attribute “_trace_level”, fayendo o downgrade para python-ldap 3.0.0 pode ajudar.

Assim que tenha instalado o pacote, pode ligá-lo à autenticação do Django:

# Add LDAP backed, keep Django one if you want to be able to sign in
# even without LDAP for admin account
AUTHENTICATION_BACKENDS = (
    "django_auth_ldap.backend.LDAPBackend",
    "weblate.accounts.auth.WeblateUserBackend",
)

# LDAP server address
AUTH_LDAP_SERVER_URI = "ldaps://ldap.example.net"

# DN to use for authentication
AUTH_LDAP_USER_DN_TEMPLATE = "cn=%(user)s,o=Example"
# Depending on your LDAP server, you might use a different DN
# like:
# AUTH_LDAP_USER_DN_TEMPLATE = 'ou=users,dc=example,dc=com'

# List of attributes to import from LDAP upon sign in
# Weblate stores full name of the user in the full_name attribute
AUTH_LDAP_USER_ATTR_MAP = {
    "full_name": "name",
    # Use the following if your LDAP server does not have full name
    # Weblate will merge them later
    # 'first_name': 'givenName',
    # 'last_name': 'sn',
    # Email is required for Weblate (used in VCS commits)
    "email": "mail",
}
# Optional: route "Forgot your password?" to your LDAP self-service page
PASSWORD_RESET_URL = "https://id.example.net/password-reset/"


# Hide the registration form
REGISTRATION_OPEN = False

Nota

Deve remover 'social_core.backends.email.EmailAuth' da configuração AUTHENTICATION_BACKENDS; caso contrário, os utilizadores poderão definir a sua palavra-passe no Weblate e autenticar usando-o. Manter 'weblate.accounts.auth.WeblateUserBackend' ainda é necessário para fazer permissões e facilitar utilizadores anônimos. Ele também permitirá que faça login usando uma conta administrativa local, se a criou (por exemplo, usando createadmin).

Usando palavra-passe associada¶

Se não puder utilizar a associação direta para autenticação, terá de utilizar a procura, e fornecer um utilizador para associar à mesma. Por exemplo:

import ldap
from django_auth_ldap.config import LDAPSearch

AUTH_LDAP_BIND_DN = ""
AUTH_LDAP_BIND_PASSWORD = ""
AUTH_LDAP_USER_SEARCH = LDAPSearch(
    "ou=users,dc=example,dc=com", ldap.SCOPE_SUBTREE, "(uid=%(user)s)"
)

Integração com o Active Directory¶

import ldap
from django_auth_ldap.config import LDAPSearch, NestedActiveDirectoryGroupType

AUTH_LDAP_BIND_DN = "CN=ldap,CN=Users,DC=example,DC=com"
AUTH_LDAP_BIND_PASSWORD = "password"

# User and group search objects and types
AUTH_LDAP_USER_SEARCH = LDAPSearch(
    "CN=Users,DC=example,DC=com", ldap.SCOPE_SUBTREE, "(sAMAccountName=%(user)s)"
)

# Make selected group a superuser in Weblate
AUTH_LDAP_USER_FLAGS_BY_GROUP = {
    # is_superuser means user has all permissions
    "is_superuser": "CN=weblate_AdminUsers,OU=Groups,DC=example,DC=com",
}

# Map groups from AD to Weblate
AUTH_LDAP_GROUP_SEARCH = LDAPSearch(
    "OU=Groups,DC=example,DC=com", ldap.SCOPE_SUBTREE, "(objectClass=group)"
)
AUTH_LDAP_GROUP_TYPE = NestedActiveDirectoryGroupType()
AUTH_LDAP_FIND_GROUP_PERMS = True

# Optionally enable group mirroring from LDAP to Weblate
# AUTH_LDAP_MIRROR_GROUPS = True

Veja também

Autenticação por CAS¶

Autenticação por CAS pode ser obtida através de um pacote como o Django CAS NG.

O primeiro passo é divulgar o campo de “”e-mail”” do utilizador via CAS. Isto tem que ser configurado no próprio servidor CAS e requer que utilize pelo menos CAS v2, já que o CAS v1 não suporta atributos.

O segundo passo é atualizar o Weblate para utilizar o seu servidor CAS e os atributos.

Para instalar Django CAS NG:

uv pip install django-cas-ng

Assim que tiver instalado o pacote, pode ligá-lo ao sistema de autenticação do Django modificando o ficheiro settings.py:

# Add CAS backed, keep the Django one if you want to be able to sign in
# even without LDAP for the admin account
AUTHENTICATION_BACKENDS = (
    "django_cas_ng.backends.CASBackend",
    "weblate.accounts.auth.WeblateUserBackend",
)

# CAS server address
CAS_SERVER_URL = "https://cas.example.net/cas/"

# Add django_cas_ng somewhere in the list of INSTALLED_APPS
INSTALLED_APPS = (..., "django_cas_ng")

Finalmente, um sinal pode ser usado para mapear o campo de e-mail para o objeto do utilizador. Para que isso funcione, tem que importar o sinal do pacote django-cas-ng e conectar o seu código com este sinal. Fazer isto em configurações de ficheiro pode causar problemas, portanto, é sugerido pôr-lo:

No método django.apps.AppConfig.ready() da configuração do seu app
No ficheiro urls.py do projeto (quando não há modelos)

from django_cas_ng.signals import cas_user_authenticated
from django.dispatch import receiver


@receiver(cas_user_authenticated)
def update_user_email_address(sender, user=None, attributes=None, **kwargs):
    # If your CAS server does not always include the email attribute
    # you can wrap the next two lines of code in a try/catch block.
    user.email = attributes["email"]
    user.save()

Configurando autenticação por Django de terceiros¶

Geralmente, qualquer “”plug-in”” de autenticação Django deveria funcionar com o Weblate. Basta seguir as instruções para o “”plug-in””, lembre-se de manter o “”backend”” do utilizador Weblate instalado.

Veja também

Autenticação por LDAP
Autenticação por CAS

Normalmente, a instalação consiste em adicionar uma autenticação de «backend» para AUTHENTICATION_BACKENDS e a instalação de uma aplicação de autenticação (se existir uma) em INSTALLED_APPS:

AUTHENTICATION_BACKENDS = (
    # Add authentication backend here
    "weblate.accounts.auth.WeblateUserBackend",
)

INSTALLED_APPS += (
    # Install authentication app here
)

Autenticação de dois fatores¶

Added in version 5.7.

Dica

A autenticação de dois fatores adiciona outra camada de segurança à sua conta, exigindo mais do que apenas uma senha para a autenticação.

Weblate suporta os seguintes fatores secundários:

Chaves de segurança (WebAuthn)

São suportados ambos, códigos de acesso e de segurança.

Os Passkeys validam a sua identidade usando toque, reconhecimento facial, uma palavra-passe de dispositivo ou um PIN, pois incluem a verificação do utilizador.

As chaves de segurança são credenciais do WebAuthn que só podem ser usadas como um segundo fator de autenticação e que validam apenas a presença do utilizador.

Aplicações de autenticação (TOTP)

As aplicações de autenticação e as extensões de navegador, tais como Aegis, Bitwarden, Google Authenticator, 1Password, Authy, Microsoft Authenticator, etc. geram palavras-passe temporizadas de utilização única que são utilizadas como um segundo fator para verificar a sua identidade quando solicitado durante a autenticação.

Códigos de recuperação

Os códigos de recuperação podem ser usados para aceder à sua conta caso perca o acesso ao seu dispositivo e não consiga receber os códigos de autenticação a dois fatores.

Guarde os seus códigos de recuperação de forma tão segura quanto a sua senha. Recomendamos que os guarde num gestor de senhas como Bitwarden, 1Password, Authy ou Keeper.

Cada utilizador pode configurar isto no Conta e o segundo fator será necessário para se autenticar, para além do método de autenticação existente.

This can be enforced for users at the project (see Autenticação de dois fatores obrigatória) or team level. In site-wide deployments, this can also be used to enforce two-factor authentication for all users by enabling it on the default Users team, which is assigned automatically to new users by automatic team assignment.

As permissões de uma equipa com autenticação de dois fatores aplicada não serão aplicadas a utilizadores que não a tenham configurado.

Autenticação¶

Registo de utilizador¶

Backends de autenticação¶

Autenticação social¶

Autenticação por OpenID¶

Autenticação por GitHub¶

Autenticação por GitHub EE¶

Autenticação por Bitbucket¶

Google OAuth 2¶

OAuth 2 do Facebook¶

OAuth 2 do GitLab¶

OAuth 2 do Gitea¶

Microsoft Entra ID¶

Slack¶

A substituir nomes e ícones de métodos de autenticação¶

Desativar autenticação por palavra-passe¶

Autenticação por palavra-passe¶

Autenticação por SAML¶

Autenticação por LDAP¶

Usando palavra-passe associada¶

Integração com o Active Directory¶

Autenticação por CAS¶

Configurando autenticação por Django de terceiros¶

Autenticação de dois fatores¶