Modifier une autorité

PATCH /api/authorities/(string: authority_name)

Met à jour l’autorité demandée avec les informations renseignées en JSON. Les champs non-spécifiés resteront inchangés.

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

PATCH https://my_waarp_transfer.net/api/authorities/tls_ca HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Content-Length: 123

{
  "name": "local_tls_ca",
  "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