# Como gerar, converter e cadastrar SSH Keys

As chaves SSH são mecanismos de autenticação, semelhante a um nome de usuário e senha, para o protocolo de rede SSH (Secure Shell). Na Digibee, elas são usadas geralmente na utilização de serviços AWS. 

Nesse artigo você aprenderá como: 

* Gerar Chaves SSH. 
* Cadastrar essas chaves na AWS para serem usadas na Digibee Integration Platform. 
* Criar os arquivos em formato .ppk. 
* Realizar a conversão dos arquivo .ppk para o formato .pem.

## Etapa 1: Geração das Chaves SSH 

1. Utilize uma ferramenta externa de geração de Chave SSH de sua confiança com os parâmetros citados logo abaixo:

* Algoritmo: Selecione RSA.
* RSA Key Size: Selecione 2048.

2. No campo Passphrase, insira a senha a ser usada para geração de chaves. Certifique-se de salvar essa passphrase, pois você precisará dela em etapas posteriores.
3. Copie e salve os valores de Private Key e Public Key. 
4. Cole o valor de Private Key em um arquivo texto e salve no formato .pem.

## Etapa 2: Registro das Chaves na Digibee Integration Platform

Depois de criar a Private Key (ou certificado) no formato .pem, é necessário registrá-la na Digibee Integration Platform como uma conta do tipo [Private Key](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/platform-administration/settings/accounts#tipos-de-contas). 

1. Na página inicial da Plataforma, clique em Configurações no canto superior direito e depois clique em Contas no menu do lado esquerdo. 
2. Clique no botão Criar.
3. Selecione o Tipo de conta como private-key.
4. Cole o valor da Passphrase no campo de mesmo nome. 
5. No campo KEY, cole todo o conteúdo da Private Key no formato .pem.
6. Preencha os valores de ambos os ambientes (Test e Prod) e clique em Salvar

Ao utilizar o conector que requer a Private Key, basta selecionar a conta criada.

## Etapa 3: Criando os arquivos.ppk

Em alguns casos, como por exemplo no FileZilla, as chaves são utilizadas no formato .ppk.

{% hint style="info" %}
Para executar este passo, você deve fazer o download e instalar o PuTTYgen em sua máquina.
{% endhint %}

1. Abra o PuTTYgen.
2. Clique em Load e, na janela de busca, altere para All Files no campo ao lado de File Name.
3. Selecione o arquivo no formato.pem que contém a Private Key e clique em Open.
4. Cole o valor da Passphrase na nova janela e clique em OK.
5. Uma mensagem informando que a chave foi importada com sucesso deve aparecer na página. Clique em OK.
6. Agora, você precisa exportar a chave no formato .ppk. Clique em Save private key e/ou Save public key.
7. Nomeie o arquivo (por exemplo, privateKey.ppk) e clique em Save.

## Convertendo arquivos.ppk em formato.pem

Se você possui um arquivo no formato.ppk, é necessário convertê-lo para o formato.pem antes de registrar as chaves SSH na Digibee Integration Platform. 

1. Abra o PuTTYgen e clique no menu Conversions.
2. Selecione Import Key e localize seu arquivo no formato .ppk.
3. Insira a Passphrase na janela que abrir e clique em OK.
4. No menu Conversions, clique em Export OpenSSH Key.
5. Nomeie o arquivo e clique em Save.