Ajouter une autorité¶

POST /api/authorities¶

Ajoute une nouvelle 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 l’autorité
type (string) – Le type d’autorité (TLS, SSH…)
publicIdentity (string) – La valeur d’identité publique (certificat, clé publique…) de l’autorité
validHosts (array) – La liste des hôtes que l’autorité est habilitée à authentifier. Si vide, l’autorité peut authentifier tous les hôtes.

Status Codes:

201 Created – L’autorité a été créée avec succès
400 Bad Request – Un ou plusieurs des paramètres de l’autorité sont invalides
401 Unauthorized – Authentification d’utilisateur invalide

En-têtes de réponse:

Location – Le chemin d’accès à la nouvelle autorité créée

Exemple de requête

POST https://my_waarp_gateway.net/api/authorities HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Content-Length: 979

{
  "name": "tls_ca",
  "type": "tls_authority",
  "publicIdentity": "-----BEGIN CERTIFICATE-----
    MIICMzCCAZygAwIBAgIRAJFIx3lh/L57UPaTaMcBJ8wwDQYJKoZIhvcNAQELBQAw
    EjEQMA4GA1UEChMHQWNtZSBDbzAgFw03MDAxMDEwMDAwMDBaGA8yMDg0MDEyOTE2
    MDAwMFowEjEQMA4GA1UEChMHQWNtZSBDbzCBnzANBgkqhkiG9w0BAQEFAAOBjQAw
    gYkCgYEAyLZU8wra4/hvLmEJWD/mdCq3BVW2zqmEa7gYZKyrNSN+iOzu9sLUR3fx
    oo5UYT87x6xi+762QI+yiwZOxkdkbKv2yQXqpF6CO1J2IuCjbdwV9ZLapGsLT2jt
    RUyR2w8qSQP7pl1Lk1K8mos+sdsRINX4VmsLG/pOukMyvUu7NTECAwEAAaOBhjCB
    gzAOBgNVHQ8BAf8EBAMCAqQwEwYDVR0lBAwwCgYIKwYBBQUHAwEwDwYDVR0TAQH/
    BAUwAwEB/zAdBgNVHQ4EFgQUMlkJ+EgiVFx6OlaVub4NQ9HgRwEwLAYDVR0RBCUw
    I4IJbG9jYWxob3N0hwR/AAABhxAAAAAAAAAAAAAAAAAAAAABMA0GCSqGSIb3DQEB
    CwUAA4GBAGnpw8im001qnW+e+V339MBTabqvXvsaMKIf75+sYkGsFhLOYw+kT4fg
    31bd3B7u5azc/FKfQdDOjjhvnGqoHtyjjVMhxLIN0fjugMTGxw4Er5xIC5RGuynB
    lqNcbCum94NGVmx0wDs3WOgcN0GCpiasPZcFs7VoVanerLOBIMXj
    -----END CERTIFICATE-----",
  "validHosts": ["1.2.3.4", "waarp.org"]
}

Exemple de réponse

HTTP/1.1 201 CREATED
Location: https://my_waarp_gateway.net/api/authorities/tls_ca