POST /management/auditors

This request will be used to enable an auditor.

Request:

The request must be a AuditorSetupMessage.

Response:

204 No content:

The auditor was successfully enabled.

403 Forbidden:

The master signature is invalid. Returned with an error code of TALER_EC_EXCHANGE_MANAGEMENT_AUDITOR_ADD_SIGNATURE_INVALID.

409 Conflict:

The exchange has a more recent request related to this auditor key (replay detected). Returned with an error code of TALER_EC_EXCHANGE_MANAGEMENT_AUDITOR_MORE_RECENT_PRESENT.

500 Internal Server Error:

The server experienced an internal error. This response comes with a standard ErrorDetail response. Possible error codes include TALER_EC_GENERIC_DB_FETCH_FAILED or TALER_EC_GENERIC_DB_STORE_FAILED.

Details:

interface AuditorSetupMessage {

  // Base URL of the auditor.
  auditor_url: string;

  // Human-readable name of the auditor.
  auditor_name: string;

  // The auditor's EdDSA signing public key.
  auditor_pub: EddsaPublicKey;

  // Signature by the exchange master ke yover a
  // TALER_MasterAddAuditorPS.
  // Must have purpose TALER_SIGNATURE_MASTER_ADD_AUDITOR.
  master_sig: EddsaSignature;

  // When does the auditor become active?
  // Should be the time when the signature was created,
  // using the (monotonic!) local time of the system
  // with the offline master public key. Note that
  // even if the time is in the future, the auditor will
  // become active immediately! Used ONLY to detect replay attacks.
  validity_start: Timestamp;

}