Pular para o conteúdo principal

Logto CLI

O Logto CLI oferece uma maneira conveniente de instalar, manter e atualizar sua instância Logto sem lidar manualmente com aquelas tarefas técnicas entediantes.

nota:

Atualmente, não fornecemos binários, portanto é necessário ter Node.js ^18.12.0 no ambiente.

Instalar o CLI globalmente​

Instale via seu gerenciador de pacotes preferido para usar o comando logto globalmente:

npm i @logto/cli -g

Você sempre pode adicionar --help para exibir as informações de ajuda de cada comando:

logto --help
logto db seed --help

CLI local​

Uma versão embutida do CLI é fornecida com cada lançamento do Logto desde a v1.0.0-beta.11. Suponha que você já tenha uma instância Logto em ~/logto, então você pode executar os comandos abaixo:

cd ~/logto
npm run cli # Invoca o CLI local

Observe que, se quiser executar com opções, você precisa adicionar um -- ANTES das opções para o Logto CLI, por exemplo:

npm run cli db seed -- --db-url postgresql://your-database-url

Usar o CLI via npx​

Outra maneira de usar o Logto CLI é com npx, que pode executar um pacote sem instalação.

npx @logto/cli

Isso será útil para execuções pontuais, por exemplo:

npx @logto/cli db seed --db-url postgresql://your-database-url

Seed para implantações isoladas ou offline​

Desde o Logto v1.40.0, tanto os comandos init (instalação) quanto db seed aceitam uma flag extra para ambientes que não conseguem acessar a internet pública durante a instalação:

--disable-admin-pwned-password-check, --dapc

Quando ativada, a política de senha semeada no tenant admin desativa a verificação de violação do Have I Been Pwned (HIBP) por padrão. Isso significa que criar o admin inicial a partir da página de boas-vindas não ficará mais travado quando api.pwnedpasswords.com estiver inacessível (por exemplo, em data centers isolados ou atrás de firewalls de saída restritos).

A flag é aplicada apenas ao tenant admin. A política de senha do tenant padrão permanece inalterada, e fica sob seu controle através do Admin Console > Experiência de login > Política de senha após o primeiro admin fazer login.

Instalação em um passo (recomendado para novas implantações OSS):

logto init --disable-admin-pwned-password-check

Seed em um banco de dados existente (quando o Logto já está extraído, ou ao refazer o seed):

logto db seed --disable-admin-pwned-password-check

--dapc e --disable-admin-pwned-password-check são aliases; qualquer um funciona.