Developer Tools: CLI e chaves pessoais de API

Objetivo e modelo

Developer Tools reúne distribuições da Dova CLI por plataforma, checksum, informação de assinatura, instruções iniciais e notas de versão. Também fornece acesso ao gerenciamento autorizado de chaves pessoais. A CLI acessa os mesmos objetos e ciclos de execução permitidos ao usuário; não contorna tenant, papéis, limites ou regras da interface.

A versão da CLI pode diferir da versão Dova 22.0.5. Nome do pacote, disponibilidade, integridade e assinatura são propriedades distintas. Use um equipamento de laboratório e a distribuição publicada para seu sistema de destino, que pode diferir do sistema do navegador.

O que conferir antes de instalar

Preparar a CLI com acesso mínimo

1. Abra Developer Tools ou Downloads no menu da conta e selecione a distribuição do sistema de destino.
2. Revise versão, estado de assinatura e checksum; baixe pelo Download apresentado.
3. Calcule SHA-256 com a ferramenta da plataforma e compare exatamente com o catálogo antes de instalar.
4. Siga as instruções do pacote e confira a versão do executável. Se outra instalação existir no PATH, identifique qual está sendo usada.
5. Em API keys, use Create API key somente quando permitido e para uma finalidade definida. Proteja o valor apresentado pelo mecanismo apropriado.
6. Siga o Quick start para autenticar no serviço de laboratório autorizado. Use o prompt interativo para a chave, sem incluí-la em argumentos compartilhados.
7. Confira identidade e tenant e comece por leituras. Compare resultados com o módulo equivalente da interface.
8. Ao terminar, diferencie logout local de revogação no servidor e revise outras automações antes de revogar uma chave em uso.

O inventário pode apresentar nome, prefixo e uso da chave. O prefixo identifica o registro sem expor o valor completo. A credencial permanece sujeita à identidade, ao tenant e aos direitos efetivos; criar outra chave não concede permissões ausentes. Não prometa configuração de expiração ou escopo que o formulário não ofereça.

Exemplo de verificação de integridade e leitura

Em PowerShell, calcule o hash do arquivo obtido, substituindo o nome ilustrativo pelo arquivo real:

Get-FileHash -Algorithm SHA256 -LiteralPath .\dova-cli-baixado.zip

Compare o valor completo, não apenas alguns caracteres. Um hash diferente exige interromper o uso e verificar a origem. Depois de instalar conforme o pacote atual, um ensaio mínimo de leitura documentado é:

dova --version
dova login --url https://dova-lab.example.test
dova status --output json

https://dova-lab.example.test é um marcador reservado e não funciona como serviço. Substitua pela URL HTTPS do laboratório autorizado e introduza a chave no prompt. Confira a ajuda da distribuição instalada antes de adicionar opções ou subcomandos. O resultado esperado é a CLI correta informando a versão e uma consulta autorizada coerente com a identidade e o tenant da interface. Uma lista vazia válida não é um erro de autenticação.

Execuções e ciclo de vida da chave

Comece por status e pelas listas de leitura oferecidas no Quick start. Execuções com arquivos, variáveis, bindings ou recuperação por identificador produzem efeitos e exigem um exercício separado com fontes e destinos exclusivos do laboratório. Revise Sessions, Workflows e Monitor antes de automatizar escrita ou repetição de uma execução.

dova logout limpa o estado de autenticação local conforme a ferramenta. Revoke no gerenciamento do servidor impede novos usos da chave em outros equipamentos. As ações têm escopos diferentes; sair localmente não revoga uma credencial usada por outra automação. Proteja também o perfil local porque ele pode reter autenticação.

Erros e recuperação

Se o download não estiver disponível, leia a mensagem do catálogo sem adivinhar uma URL. Se SHA-256 não coincidir, não execute o pacote. Em 401 ou 403, confira chave ativa, validade informada, identidade, tenant e permissão; não trate a resposta como uma lista vazia. Renovar uma chave não corrige uma autorização ausente.

Um timeout pode deixar trabalho ativo no servidor. Consulte o identificador existente no Monitor antes de repetir um comando com efeitos. Após atualizar a CLI, confira novamente versão e ajuda do pacote. Para suporte, utilize o formulário Cloudata sem enviar chaves, perfis ou tokens.

Leituras relacionadas

Administração de distribuições e chaves · Repository · Sessions · Workflows · Monitor.

Filtros de leitura da CLI

Essas formas correspondem aos comandos de leitura publicados. Confira a ajuda da versão instalada antes de adicionar opções. Não confunda workflow list com workflow run: o segundo executa trabalho e exige um exercício de laboratório autorizado separado.

Exemplo de consultas filtradas

Após autenticar no laboratório e conferir a identidade, as consultas abaixo apenas leem recursos autorizados. Substitua Domain, nomes e filtros pelos valores sintéticos do seu ambiente:

dova repository list --domain "Laboratório ETL" --output json
dova mapping list --name sample --limit 50 --output json
dova workflow list --status published --name customer --limit 50
dova run list --status failed,cancelled --sort createdAt --descending --output csv

Compare identificadores com Repository e Monitor. Um resultado vazio pode significar que o filtro não corresponde a nenhum registro. Não inclua a chave em nenhum comando compartilhado.