# 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