> 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-1/how-to/how-to-configure-an-ssh-key-new-server.md).

# Como configurar uma chave SSH num novo servidor

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: tu crias a chave durante o registo do servidor e depois ligas-te com ela.

> 👍 O que obténs
>
> Um servidor criado com a sua chave SSH associada, e a chave privada em teu poder para te ligares em segurança.

### Como funciona o par de chaves

SSH trabalha com duas peças que andam juntas: uma chave pública e uma privada. A pública fica no servidor; a privada ficas tu a guardá-la e é a que prova a tua identidade ao ligar.

Por isso uma chave é mais segura do que uma Palavra-passe: não viaja, não se adivinha e não se reutiliza entre serviços.

| Peça          | Onde vive          | 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 Plenit.
* Ter Permissões para criar servidores.
* Estar a registar 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**, assinala **Gerar uma nova chave** e clica **Adicionar**.

{/\* 📸 CAPTURA 1 · campo "Escolhe uma chave SSH" com o botão + e o 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 uma única 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 **Confirmar**.
5. De volta no assistente, o campo **Escolhe uma chave SSH** fica com a chave recém-criada. Clica **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: 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\<Utilizador>\.ssh\plenit-srv01" /inheritance:r /grant:r "%USERNAME%:R"

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

> #### 📘 O Utilizador depende da imagem
>
> O nome de Utilizador para se 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 encaixa

| Sintoma                            | Causa provável                                       | O que fazer                                          |
| ---------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- |
| SSH rejeita a chave por 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ó era 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 correspondente ao Sistema operativo |

### Próximos passos

* [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-1/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.