taler-docs

commit 9202c59f1dc5aead6bdc4ade01ce1ad08af250d8
parent 029993cf592e6cf48cbd3f78d0cd21187df982b3
Author: Christian Grothoff <christian@grothoff.org>
Date:   Tue, 24 Nov 2020 22:22:10 +0100

add missing key revocation endpoints

Diffstat:
M
core/api-exchange.rst
 | 
59
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++--

1 file changed, 57 insertions(+), 2 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
@@ -499,6 +499,61 @@ Management operations authorized by master key
     }
 
 
+.. http:post:: /management/denominations/$H_DENOM_PUB/revoke
+
+  Revoke denomination key, prevending further use by the exchange.
+  Only to be used by the exchange's offline key management team. Not useful
+  for anyone else.
+
+  **Request:** The request body must be a `DenomRevocationSignature` object.
+
+  **Response:**
+
+  :http:statuscode:`204 No content`:
+    The request was successfully processed.
+  :http:statuscode:`403 Forbidden`:
+    The provided signature is invalid.
+
+  **Details:**
+
+  .. ts:def:: DenomRevocationSignature
+
+    interface DenomRevocationSignature {
+
+      // Signature by the exchange master key.
+      // Must have purpose TALER_SIGNATURE_MASTER_DENOMINATION_KEY_REVOKED
+      master_sig: EddsaSignature;
+
+    }
+
+.. http:post:: /management/signkeys/$EXCHANGE_PUB/revoke
+
+  Revoke exchange online signing key, prevending further use by the exchange.
+  Only to be used by the exchange's offline key management team. Not useful
+  for anyone else.
+
+  **Request:** The request body must be a `SignkeyRevocationSignature` object.
+
+  **Response:**
+
+  :http:statuscode:`204 No content`:
+    The request was successfully processed.
+  :http:statuscode:`403 Forbidden`:
+    The provided signature is invalid.
+
+  **Details:**
+
+  .. ts:def:: SignkeyRevocationSignature
+
+    interface SignkeyRevocationSignature {
+
+      // Signature by the exchange master key.
+      // Must have purpose TALER_SIGNATURE_MASTER_SIGN_KEY_REVOKED
+      master_sig: EddsaSignature;
+
+    }
+
+
 .. http:post:: /management/auditors
 
   This request will be used to enable an auditor.
@@ -590,7 +645,7 @@ Management operations authorized by master key
     }
 
 
-.. http:post:: /management/wire-methods
+.. http:post:: /management/wire
 
   This request will be used to enable a wire method (exchange bank account).
 
@@ -633,7 +688,7 @@ Management operations authorized by master key
 
     }
 
-.. http:post:: /management/wire-methods/disable
+.. http:post:: /management/wire/disable
 
   This request will be used to disable the use of the given wire method.
   We use POST instead of DELETE because the exchange will retain state