# 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](/documentation/developer-guide/pt-br/development-cycle/build-overview/accounts.md#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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/troubleshooting/pt-br/authentication-and-security-guides/generate-convert-register-ssh-keys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.