Remplacer une autorité
======================

.. http:put:: /api/authorities/(string:authority_name)

   Remplace l'autorité demandé par celle renseignée en JSON.

   :reqheader Authorization: Les identifiants de l'utilisateur

   :reqjson string name: Le nom de l'autorité
   :reqjson string type: Le type d'autorité (TLS, SSH...)
   :reqjson string publicIdentity: La valeur d'identité publique (certificat,
      clé publique...) de l'autorité
   :reqjson array validHosts: La liste des hôtes que l'autorité est habilitée à
      authentifier. Si vide, l'autorité peut authentifier tous les hôtes.

   :statuscode 201: L'autorité a été remplacée avec succès
   :statuscode 400: Un ou plusieurs des paramètres de l'autorité sont invalides
   :statuscode 401: Authentification d'utilisateur invalide
   :statuscode 404: L'autorité demandée n'existe pas

   :resheader Location: Le chemin d'accès à l'autorité modifiée


   |

   **Exemple de requête**

      .. code-block:: http

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

         {
           "name": "local_tls_ca",
           "type": "tls_authority",
           "publicIdentity": "-----BEGIN CERTIFICATE-----
             MIICMjCCAZugAwIBAgIQZc/RAR/MfaG39KmM87xdejANBgkqhkiG9w0BAQsFADAS
             MRAwDgYDVQQKEwdBY21lIENvMCAXDTcwMDEwMTAwMDAwMFoYDzIwODQwMTI5MTYw
             MDAwWjASMRAwDgYDVQQKEwdBY21lIENvMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCB
             iQKBgQCpsUuT74yxJYZSojX8vFJK8Jha64EeLOz6ExW86VkdYa4wNocmbc6qxDms
             LAmyC1Li7Z02IKi+ssHHFoKDJ1MXkAHJFBjtlHECktImR7mE5ktFNKOqqpItBrUg
             8F9fU8iytljjrIc9UDLN2kF7t2cEOMuYfnBnWttDnmHd85vjkwIDAQABo4GGMIGD
             MA4GA1UdDwEB/wQEAwICpDATBgNVHSUEDDAKBggrBgEFBQcDATAPBgNVHRMBAf8E
             BTADAQH/MB0GA1UdDgQWBBTftkE6/G+N6LAmXiz25lNPNZDUbDAsBgNVHREEJTAj
             gglsb2NhbGhvc3SHBH8AAAGHEAAAAAAAAAAAAAAAAAAAAAEwDQYJKoZIhvcNAQEL
             BQADgYEAJjqFG/wPjPWBGWJk1jxxE+gp06kttQ1r/PrJDiIEzLdvl3egd9ewNgSj
             rg6YSHYJdUCsiWJn6p59FirqXq1TmkPx320YZJux5zwL/PdThcRsWGZe5WvQH97i
             1DenaJitih8P2oUx0z6oi3Z9J8CYO/kHb+f6nB4TJrF7pwjZ/TU=
             -----END CERTIFICATE-----",
           "validHosts": ["127.0.0.1"]
         }

   **Exemple de réponse**

      .. code-block:: http

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