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_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
HTTP/1.1 201 CREATED Location: https://my_waarp_gateway.net/api/authorities/local_tls_ca