Ajouter une clé cryptographique¶
- POST /api/keys¶
Ajoute une nouvelle clé cryptographique avec les informations renseignées en format JSON dans le corps de la requête.
- En-têtes de requête:
Authorization – Les identifiants de l’utilisateur
- Objet JSON de requête:
name (string) – Le nom de la clé cryptographique.
type (string) –
Le type de la clé cryptographique. Les valeurs acceptées sont :
AES
pour les clés de (dé)chiffrement AESHMAC
pour les clés de signature HMACPGP-PUBLIC
pour les clés PGP publiquesPGP-PRIVATE
pour les clés PGP privées
key (string) – La représentation textuelle de la clé. Si la clé n’est pas nativement en format textuel, celle-ci doit être convertie en Base64 avant son envoi.
- Status Codes:
201 Created – La clé a été créée avec succès
400 Bad Request – Un ou plusieurs des paramètres de la requête sont invalides
401 Unauthorized – Authentification d’utilisateur invalide
- En-têtes de réponse:
Location – Le chemin d’accès à la nouvelle clé créée
Exemple de requête
POST https://my_waarp_gateway.net/api/keys HTTP/1.1 Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== Content-Type: application/json Content-Length: 103 { "name": "aes-key", "type": "AES", "privateKey": "0123456789abcdefhijklABCDEFHIJKL" }
Exemple de réponse
HTTP/1.1 201 CREATED Location: https://my_waarp_gateway.net/api/keys/aes-key