ssh-add

Adicionar, consultar e remover identidades de um agente existente.

Antes de executar

O agente deve estar acessível por SSH_AUTH_SOCK. Não haver identidades é diferente de não conseguir conectar ao agente. -t limita o tempo de carregamento, sem excluir nem expirar o arquivo da chave. Remover uma identidade do agente não revoga a autorização no servidor nem exclui itens das Chaves do macOS.

Exemplos

Carregar uma chave privada por uma hora e digitar a frase secreta se solicitado.

ssh-add -t 1h ~/.ssh/id_ed25519

Listar as impressões digitais das identidades carregadas.

ssh-add -l

Remover a identidade do agente sem excluir o arquivo.

ssh-add -d ~/.ssh/id_ed25519

Opções e exemplos

identity_fileComum

Adicione uma chave privada ao agente, solicitando sua senha quando necessário.

Exemplo

ssh-add ~/.ssh/id_ed25519

-l / -LComum

Liste impressões digitais ou chaves públicas atualmente em poder do agente.

Exemplo

ssh-add -l

-t lifeComum

Limitar quanto tempo a identidade permanece no agente; isso não expira nem revoga a chave em si.

Exemplo

ssh-add -t 1h ~/.ssh/id_ed25519

-d identity_fileComum

Remova uma identidade do agente; isso não o revoga no servidor.

Exemplo

ssh-add -d ~/.ssh/id_ed25519

-D

Remova todas as identidades do agente atual, sem excluir arquivos-chave.

Exemplo

ssh-add -D

-c

Exigir confirmação antes de uma identidade adicionada ser usada; é necessário um programa de confirmação apropriado.

Exemplo

ssh-add -c ~/.ssh/id_ed25519

-x / -X

Bloqueie ou desbloqueie o agente de forma interativa.

Exemplo

ssh-add -x

-T public_key

Teste se o agente pode usar a chave privada correspondente.

Exemplo

ssh-add -T ~/.ssh/id_ed25519.pub

Referências oficiais

Revisado em 27 de outubro de 2026