> 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 Servidor Novo

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

Em vez de uma Palavra-passe, utiliza um par de chaves: cria a chave durante a criação do servidor e liga-se a ela depois.

> 👍 O que obtém
>
> Um servidor criado com a respetiva chave SSH associada e a chave privada na sua posse para se ligar de forma segura.

### Como funciona o par de chaves

O SSH funciona com duas partes que andam juntas: uma chave pública e uma privada. A pública fica no servidor; a privada é guardada por si e é a que comprova a sua identidade ao ligar-se.

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

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

### Antes de começar

* Estar registado na plataforma 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. Gere a chave durante a criação do servidor

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

1. Indique o **nome** do servidor.
2. Em **Escolha uma chave SSH**, prima o botão **+**.
3. Na janela que se abre, introduza um **nome para a chave**, selecione **Gerar uma nova chave** e prima **Adicionar**.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-6ebe3478ca3e9017eb36727d1f1c96c7cbe57120%2FCAPTURA%201%20y%202%20%C2%B7%20asistente%20con%20la%20clave%20seleccionada%20y%20el%20bot%C3%B3n%20Crear%20servidor%20(1).jpg?alt=media" alt="Generación de una nueva clave SSH durante la creación del servidor"><figcaption><p>Geração de uma nova chave SSH durante a criação do servidor</p></figcaption></figure>

> #### ❗️ A chave privada é apresentada apenas uma vez
>
> Ao adicioná-la, a plataforma mostra-lhe a chave privada. Copie-a e guarde-a num local seguro nesse momento: não pode ser consultada novamente. Se a perder, gere uma nova.

4. Copie a chave privada e prima **Confirmar**.
5. De volta ao assistente, o campo **Escolha uma chave SSH** fica com a chave acabada de criar. Prima **Criar servidor**.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-87f1685ac61cd4da2d6d1f08a32e204a6916dd71%2FCAPTURA%201%20y%202%20%C2%B7%20asistente%20con%20la%20clave%20seleccionada%20y%20el%20bot%C3%B3n%20Crear%20servidor%20(3).jpg?alt=media" alt="Servidor con la clave SSH seleccionada, listo para crear"><figcaption><p>Servidor com a chave SSH selecionada, pronto a criar</p></figcaption></figure>

### Passo 2. Ligue-se com a chave

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

No Linux ou macOS:

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

# Ligue-se (utilizador e IP do seu servidor)
ssh -i ~/.ssh/plenit-srv01 <utilizador>@<IP-DO-SERVIDOR>
```

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

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

# Ligue-se
ssh -i "C:\Users\<o-seu-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 tiver a certeza, confirme-o de acordo com a imagem que implementou.

### Se algo não estiver correto

| 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 | Aplique `chmod 600` (Linux) ou `icacls` (Windows)        |
| Não tem a chave privada                    | Era apresentada apenas ao criá-la e não foi guardada | Gere uma chave nova e associe-a ao servidor              |
| A ligação é recusada                       | Utilizador incorreto para essa imagem                | Utilize o utilizador correspondente ao Sistema operativo |

### Próximos passos

* [Como configurar uma chave SSH num servidor existente](https://docs.plenit.com/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
