Todos os produtos
Search
Central de documentação

Function Compute:Configure autenticação Basic para um nome de domínio personalizado

Última atualização: Jun 29, 2026

A autenticação Basic permite restringir o acesso a um nome de domínio personalizado do Function Compute por meio de usuário e senha. O sistema rejeita solicitações sem credenciais válidas antes que elas cheguem à sua função.

Pré-requisitos

Antes de começar, verifique se você já:

Antes de ativar

Consideração

Detalhes

Limite de usuários

Até 20 usuários por nome de domínio personalizado

Formato do nome de usuário

12 a 128 caracteres; deve começar com uma letra; permite hifens (-), sublinhados (_) e pontos (.)

Requisitos de senha

12 a 128 caracteres; deve incluir letras maiúsculas, minúsculas, dígitos e pelo menos um destes caracteres especiais: ! @ # $ % ^ & * ( )

Boas práticas de senha

Evite reutilizar senhas ou usar combinações simples; altere-as regularmente

Protocolo

Utilize HTTPS em produção. O http serve apenas para testes — você é responsável por qualquer vazamento de credenciais via http

Atraso na configuração

Aguarde 1 minuto para que as alterações entrem em vigor

Configure autenticação Basic

  1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Advanced Features > Custom Domains.

  2. Na barra de menus superior, selecione uma região. Na página Domain Names, localize seu nome de domínio personalizado e clique em Edit na coluna Actions.

  3. Na página de configurações, expanda Authentication Settings e defina Authentication Method como Basic Authentication.

  4. Em User List, clique em Add User e insira um Username e uma Password.

    Para os requisitos de formato, consulte Antes de ativar.

  5. Clique em Save.

    image

    Aguarde 1 minuto para que a configuração entre em vigor.

Verifique a autenticação Basic

Após a configuração entrar em vigor, teste se a autenticação funciona corretamente.

  1. Gere uma credencial codificada em Base64. Execute o comando abaixo e use o parâmetro -n para evitar que uma nova linha ao final seja incluída na codificação:

    # Linux/macOS
    echo -n "username:password" | base64

    Exemplo de saída:

    dXNlcm5hbWU6cGFzc3dvcmQ=
  2. Envie uma solicitação de teste com a credencial codificada:

    curl -X GET "yourCustomdomain" -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ="

    Substitua yourCustomdomain pelo seu nome de domínio personalizado real.

Solução de problemas

authorization required

A solicitação chegou ao domínio, mas o cabeçalho Authorization está ausente ou seu valor está incorreto. Verifique se o cabeçalho está presente e se as credenciais codificadas correspondem a um usuário configurado.

basic authorization xxx is not a Base64-encoded string

O valor no cabeçalho Authorization não é um Base64 válido. Execute novamente o comando de codificação e copie a saída exatamente como apresentada.

Authorization header must start with Basic

Conforme a RFC 7617, o valor do cabeçalho Authorization deve começar com Basic seguido de um espaço — por exemplo, Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=. Verifique se há espaços faltando ou caracteres extras.

Perguntas frequentes

Ative a autenticação Basic gera cobranças adicionais?

Não. O faturamento do Function Compute baseia-se no número de invocações de função, portanto, ative a autenticação Basic não afeta sua fatura.