Developer Tools: CLI, distribuições e chaves de API

Selecione a distribuição publicada correta, confira integridade e assinatura e use credenciais somente no escopo autorizado.

Objetivo e pré-requisitos

Developer Tools reúne o catálogo publicado da Dova CLI, orientações de plataforma e ferramentas de chaves de API. Abrir a tela ou baixar uma distribuição não concede acesso a um tenant e não autoriza comandos administrativos. A versão do pacote CLI pode diferir da versão Dova 22.0.5; confira a versão específica do artefato selecionado.

Escolha o sistema operacional da máquina de destino, que pode ser diferente do computador do navegador. Antes de executar uma ferramenta, identifique o workspace de laboratório, a operação permitida e o escopo necessário. Mantenha credenciais fora de repositórios, capturas, histórico de terminal e documentação compartilhada.

Baixar uma distribuição publicada

Abra Developer Tools e aguarde o catálogo de releases.
Consulte as plataformas disponíveis e selecione a correspondente à máquina de destino.
Confirme que o download principal e Quick start pertencem à mesma distribuição.
Leia versão, disponibilidade, checksum e informação de assinatura publicados para aquele artefato.
Baixe pelo link apresentado e confira a integridade usando o checksum do arquivo exato.
Siga o Quick start incluído na distribuição em um ambiente autorizado.

Propriedade	O que comprova
Disponibilidade	O artefato pode ser obtido pelo catálogo no momento da consulta.
Integridade	O arquivo obtido corresponde ao checksum publicado para aquela distribuição.
Assinatura	A origem foi validada pelo mecanismo de assinatura explicitamente disponibilizado; não assuma assinatura se o catálogo não a informa.
Autorização	A operação autenticada é permitida pelo escopo efetivo do tenant e do papel; as propriedades do download não concedem esse acesso.

Configurar acesso autorizado

Use o fluxo de API Keys apenas se o papel e o ciclo de vida da conta permitirem. Antes de criar ou selecionar uma chave, confirme tenant e escopo disponíveis. Se uma credencial for apresentada uma única vez, transfira-a diretamente ao armazenamento seguro aprovado. O material não deve aparecer em exemplos, notas, logs ou capturas.

As chaves preservam o escopo autorizado e não substituem as verificações do servidor. Um acesso revogado ou um vínculo não verificável deve ser tratado pelo ciclo de vida suportado; não altere o armazenamento para recuperar uma chave. Quando a automação deixar de ser necessária, revogue ou retire a credencial pelo fluxo correspondente.

Copie comandos do Quick start da distribuição atual ou da referência CLI vinculada. Não adivinhe subcomandos, flags, nomes de pacote ou URLs. Registre a versão da ferramenta e a finalidade de uma automação, substituindo valores sensíveis por descrições. Um exemplo de configuração não autoriza executar uma mutação em produção.

Exercício de validação

Em um catálogo de laboratório, selecione uma entrada Linux e confira se download, metadados e instruções correspondem à mesma plataforma.
Selecione uma entrada Windows disponível e repita a comparação, sem instalar arquivos ou criar chaves reais nessa revisão de navegação.
Para um teste funcional autorizado, obtenha a distribuição verificada e execute uma única leitura permitida sobre um recurso sintético.
Registre separadamente disponibilidade, integridade e resultado de autorização. O sucesso em uma etapa não comprova as outras.

Falhas e recuperação

Se a plataforma não estiver disponível, leia o aviso do catálogo e use uma distribuição suportada, sem inventar o endereço de download. Se o checksum divergir, não execute o arquivo e obtenha o artefato correto pelo processo autorizado. Em erros de autenticação, confira validade da credencial, tenant e escopo. Criar uma chave mais poderosa não deve ser o primeiro passo de diagnóstico.

Consulte também: Instalação de workers, Papéis e permissões, Preferences.