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 AES

  • HMAC pour les clés de signature HMAC

  • PGP-PUBLIC pour les clés PGP publiques

  • PGP-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