DocumentaçãoCommerceGuia do Commerce na nuvem

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Chaves de autenticação

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Desenvolvedor

Você deve ter uma chave de autenticação para acessar o repositório do Adobe Commerce e habilitar os comandos instalar e atualizar para o projeto do Adobe Commerce na infraestrutura em nuvem. Há dois métodos para especificar credenciais de autorização do Composer.

  • arquivo de autenticação — Um arquivo que contém suas credenciais de autorização do Adobe Commerce no diretório raiz da infraestrutura em nuvem do Adobe Commerce.
  • Variável de ambiente — Uma variável de ambiente para configurar chaves de autenticação no projeto Adobe Commerce na infraestrutura em nuvem para evitar exposição acidental.
recommendation-more-help

Nota de segurança

A Adobe recomenda usar o método variável de ambiente com seu projeto de nuvem para evitar a exposição acidental de suas credenciais de autorização.

O método de arquivo de autenticação é ideal ao usar o Cloud Docker para Commerce como uma ferramenta de desenvolvimento local, mas tenha cuidado para não carregar o arquivo auth.json para um repositório público baseado em Git. Você pode adicionar o arquivo auth.json ao arquivo .gitignore ​.

style
shade-box

Arquivo de autenticação

Para criar um auth.json arquivo:

  1. Se você não tiver um arquivo auth.json no diretório raiz do projeto, crie um.

    • Usando um editor de texto, crie um arquivo auth.json no diretório raiz do projeto.
    • Copie o conteúdo da amostra auth.json para o novo arquivo auth.json.

  2. Substitua <public-key> e <private-key> pelas credenciais de autenticação da Adobe Commerce.

    code language-json 
    {
    "http-basic": {
        "repo.magento.com": {
            "username": "<public-key>",
            "password": "<private-key>"
        }
    }
}

  3. Salve as alterações e saia do editor de texto.

Variável de ambiente de autenticação do Composer

O método a seguir é a melhor maneira de evitar a exposição acidental de credenciais confidenciais em um repositório público baseado em Git.

Para adicionar chaves de autenticação usando uma variável de ambiente:

  1. No Cloud Console, clique no ícone de configuração no lado direito da navegação do projeto.

    Configurar projeto {width="36"}

  2. Na lista Configurações do projeto, clique em Variables.

  3. Clique em Create variable.

  4. No campo Variable name, digite env:COMPOSER_AUTH.

  5. No campo Valor, adicione o seguinte e substitua <public-key> e <private-key> pelas credenciais de autenticação da Adobe Commerce:

    code language-json 
    {
    "http-basic": {
        "repo.magento.com": {
            "username": "<public-key>",
            "password": "<private-key>"
        }
    }
}

  6. Selecione Available during buildtime e desmarque Available during runtime.

  7. Clique em Create variable.

  8. Remova o arquivo auth.json de cada ambiente.

7c2b03ac-000c-497d-aba3-2c6dc720a938