> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-configure-an-ssh-key-new-server.md).

# Como configurar uma chave SSH num novo servidor

O SSH permite-te administrar um servidor remotamente por linha de comandos, com a ligação cifrada através da porta 22.

Em vez de uma palavra-passe, usa um par de chaves: crias a chave durante a criação do servidor e ligas-te com ela depois.

> 👍 O que consegues
>
> Um servidor criado com a sua chave SSH associada, e a chave privada na tua posse para te ligares de forma segura.

### Como funciona o par de chaves

O SSH funciona com duas peças que andam juntas: uma chave pública e uma privada. A pública fica no servidor; a privada guardas tu e é a que demonstra a tua identidade ao ligar-te.

Por isso, uma chave é mais segura do que uma palavra-passe: não é transmitida, não é adivinhada e não é reutilizada entre serviços.

| Peça          | Onde fica          | Para quê                                 |
| ------------- | ------------------ | ---------------------------------------- |
| Chave pública | No servidor        | Verifica quem se liga                    |
| Chave privada | No teu equipamento | Identifica-te ao ligar; não é partilhada |

### Antes de começar

* Estar registado na plataforma da Plenit.
* Ter permissões para criar servidores.
* Estar a criar um servidor numa subscrição de **Servidores** (a chave é configurada no último passo do assistente).

### Passo 1. Gera a chave na criação do servidor

Na última janela do assistente (a de **Nome**):

1. Indica o **nome** do servidor.
2. Em **Escolhe uma chave SSH**, clica no botão **+**.
3. Na janela que se abre, escreve um **nome para a chave**, seleciona **Gerar uma nova chave** e clica em **Adicionar**.

{/\* 📸 CAPTURA 1 · campo "Escolhe uma chave SSH" com o botão + e a caixa de diálogo de gerar chave \*/}

![Geração de uma nova chave SSH durante a criação do servidor](https://REEMPLAZA-URL/servidores-howto-ssh-01.png)

> #### ❗️ A chave privada é mostrada apenas uma vez
>
> Ao adicioná-la, a plataforma mostra-te a chave privada. Copia-a e guarda-a num local seguro nesse momento: não pode voltar a ser consultada. Se a perderes, gera uma nova.

4. Copia a chave privada e clica em **Confirmar**.
5. De volta ao assistente, o campo **Escolhe uma chave SSH** fica com a chave acabada de criar. Clica em **Criar servidor**.

{/\* 📸 CAPTURA 2 · assistente com a chave selecionada e o botão Criar servidor \*/}

![Servidor com a chave SSH selecionada, pronto para criar](https://REEMPLAZA-URL/servidores-howto-ssh-02.png)

### Passo 2. Liga-te com a chave

Guarda a chave privada num ficheiro e protege-a: o SSH rejeita uma chave privada com permissões demasiado abertas.

Em Linux ou macOS:

```bash
# Guarda a chave em ~/.ssh e restringe as suas permissões
chmod 600 ~/.ssh/plenit-srv01

# Liga-te (utilizador e IP do teu servidor)
ssh -i ~/.ssh/plenit-srv01 <utilizador>@<IP-DO-SERVIDOR>
```

No Windows, com o cliente OpenSSH a partir do PowerShell:

```powershell
# Restringe as permissões da chave ao utilizador atual
icacls "C:\Users\<teu-utilizador>\.ssh\plenit-srv01" /inheritance:r /grant:r "%USERNAME%:R"

# Liga-te
ssh -i "C:\Users\<teu-utilizador>\.ssh\plenit-srv01" <utilizador>@<IP-DO-SERVIDOR>
```

> #### 📘 O utilizador depende da imagem
>
> O nome do utilizador para ligar é determinado pelo sistema operativo do servidor. Se não tiveres a certeza, confirma-o de acordo com a imagem que implementaste.

### Se algo não encaixar

| Sintoma                                    | Causa provável                                       | O que fazer                                           |
| ------------------------------------------ | ---------------------------------------------------- | ----------------------------------------------------- |
| O SSH rejeita a chave devido às permissões | A chave privada está acessível a outros utilizadores | Aplica `chmod 600` (Linux) ou `icacls` (Windows)      |
| Não tens a chave privada                   | Só foi mostrada ao criá-la e não foi guardada        | Gera uma nova chave e associa-a ao servidor           |
| A ligação é rejeitada                      | Utilizador incorreto para essa imagem                | Usa o utilizador que corresponde ao sistema operativo |

### Passos seguintes

* [Como configurar uma chave SSH num servidor existente](/docs-pt/productos/servers/how-to/how-to-configure-an-ssh-key-existing-server.md)

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-configure-an-ssh-key-new-server.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.