# Remplacer une autorité

PUT /api/authorities/(string: authority_name)

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

  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é remplacée avec succès

    - 400 Bad Request – Un ou plusieurs des paramètres de l’autorité sont invalides

    - 401 Unauthorized – Authentification d’utilisateur invalide

    - 404 Not Found – L’autorité demandée n’existe pas

  En-têtes de réponse:

    - Location – Le chemin d’accès à l’autorité modifiée

  Exemple de requête

  >     PUT https://my_waarp_transfer.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

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