> 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/fr/reference/servers-api/sshkeypair/addsshkeypairtoserver.md).

# Cas d’usage

* **Activer l’accès SSH sur un serveur nouvellement provisionné** Après avoir créé séparément un serveur et une paire de clés SSH, appelez cet endpoint pour associer la clé au serveur. Cela termine le flux de travail de provisioning en activant une authentification SSH sécurisée, sans mot de passe, dès que le serveur est accessible.
* **Déployer la même clé SSH sur plusieurs serveurs en une seule fois** Le `serverId` champ accepte un tableau d’ID de serveurs, ce qui vous permet d’attacher une seule paire de clés SSH à plusieurs serveurs en une seule requête. Utilisez cela pour déployer une clé d’équipe partagée ou une clé de déploiement sur l’ensemble de votre parc sans effectuer d’appels API répétés.
* **Accorder à un nouveau membre de l’équipe l’accès à l’infrastructure existante** Lorsqu’un nouveau développeur ou opérateur rejoint l’équipe, créez une paire de clés SSH avec sa clé publique puis attachez-la à tous les serveurs auxquels il doit accéder. Cela fournit un accès contrôlé et auditable sans modifier manuellement la configuration de chaque serveur.
* **Automatiser la distribution des clés dans les pipelines CI/CD** Intégrez cet endpoint à votre automatisation d’infrastructure afin d’attribuer programmatiquement des clés SSH aux serveurs lors du déploiement. Un pipeline peut créer une paire de clés, provisionner des serveurs et attacher la clé — garantissant que chaque instance déployée est accessible pour la configuration ou le débogage après déploiement.
* **Faire pivoter les clés SSH sur l’ensemble de votre parc de serveurs** Dans le cadre d’une politique de rotation des clés, créez une nouvelle paire de clés SSH et utilisez cet endpoint pour l’assigner à tous les serveurs concernés. Une fois la confirmation obtenue, supprimez l’ancienne paire de clés. La solution basée sur un tableau `serverId` de paramètres permet de mettre à jour efficacement plusieurs serveurs en un seul appel.

## Obtenir les paramètres requis

* **subscriptionId** (requête) : Récupérez les ID d’abonnement disponibles en utilisant le [Lister tous les abonnements](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/listallsubscriptions/README.md) point de terminaison. Passez votre `organizationId` comme paramètre de requête pour lister tous les abonnements, puis utilisez le `id` champ de la réponse.
* **sshId** (chemin) : récupérez les identifiants de paires de clés SSH disponibles à l’aide de la [Lister les paires de clés SSH par abonnement](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/listsshkeypairsbysubscription/README.md) endpoint. Passez le `subscriptionId` comme paramètre de requête pour obtenir toutes les paires de clés de cet abonnement, puis utilisez le `id` champ de la réponse.
* **serverId** (corps) : récupérez les identifiants de serveurs disponibles à l’aide de la [Obtenir tous les serveurs pour un ID d’abonnement](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/getallserversbysubscription/README.md) endpoint. Passez le `subscriptionId` comme paramètre de requête pour lister tous les serveurs, puis utilisez le `id` champ de chaque serveur cible. Ce paramètre accepte un tableau, vous pouvez donc inclure plusieurs ID de serveurs dans une seule requête.


---

# 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/fr/reference/servers-api/sshkeypair/addsshkeypairtoserver.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.