[GNUnet-SVN] [taler-exchange] branch master updated: instructions for the auditor to sign the blob

[gnunet]

This is an automated email from the git hooks/post-receive script.

marcello pushed a commit to branch master
in repository exchange.

The following commit(s) were added to refs/heads/master by this push:
     new 7bfaa9b  instructions for the auditor to sign the blob
7bfaa9b is described below

commit 7bfaa9b5516f78f1c784ed0fc45fa3695e7bb8e5
Author: Marcello Stanisci <address@hidden>
AuthorDate: Wed May 17 11:39:03 2017 +0200

    instructions for the auditor to sign the blob
---
 doc/manual/manual.texi | 61 +++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 56 insertions(+), 5 deletions(-)

diff --git a/doc/manual/manual.texi b/doc/manual/manual.texi
index df61618..cf7da96 100644
--- a/doc/manual/manual.texi
+++ b/doc/manual/manual.texi
@@ -32,11 +32,10 @@ Texts.  A copy of the license is included in the section 
entitled
 @c Titlepage
 @c
 @titlepage
address@hidden The GNU Taler merchant backend operator tutorial
address@hidden The GNU Taler exchange operator tutorial
 @subtitle Version @value{VERSION}
 @subtitle @value{UPDATED}
 @author Marcello Stanisci (@email{marcello.stanisci@@inria.fr})
address@hidden Christian Grothoff (@email{christian.grothoff@@inria.fr})
 @page
 @vskip 0pt plus 1filll
 @insertcopying
@@ -53,8 +52,8 @@ Texts.  A copy of the license is included in the section 
entitled
 
 @menu
 * Introduction::            Whom this manual is addressed to
-* Installation::            Installing the Merchant backend
-* Configuration::           How to set up the Merchant backend
+* Installation::            Installing the exchange
+* Configuration::           How to set up the exchange
 
 
 Appendices
@@ -199,12 +198,64 @@ If you did not specify a prefix, the exchange will 
install to
 @node Configuration
 @chapter How to configure the exchange
 
address@hidden The configuration file
 @cindex taler-config
 @cindex taler.conf
 The installation already provides reasonable defaults.  The file
 @code{$HOME/.config/taler.conf} is responsible of overriding defaults
 values, or add new ones.  The format of the configuration file is
-the well-known INI file format.
+the well-known INI file format.  Nonetheless, the exchange takes a
address@hidden CONFIG} option that makes the file @code{CONFIG} ovveride
+the defaults.
+
address@hidden keys
address@hidden denomination keys
address@hidden auditor
address@hidden Configuring keys
+
address@hidden Denomination keys
address@hidden FIXME TBD - NOTE, docs.taler.net contains already some text on 
this
+
address@hidden Master key
address@hidden FIXME TBD - NOTE, docs.taler.net contains already some text on 
this
+
address@hidden Specifying auditors
+
+In order to "add" any auditor to the list of the auditors accepted by
+the exchange, it's required to (1) generate a cryptographic blob containing
+metadata about the denomination keys, (2) ask the auditor to sign this blob,
+and (3) copy the auditor signed blob to a exchange's dedicated directory.
+
+The following command accomplishes step (1).
+
address@hidden
+taler-exchange-keyup -o blob
address@hidden example
+
+In production, step (2) is accomplished thanks to each auditor providing a 
RESTful
+service that lets the exchange administrator upload the @code{blob} and get a 
signed
+version of it.
+
+Nonetheless, for testing purposes, the following command emulates a auditor's
+signature that a exchange administrator can run locally.
+
address@hidden
+taler-auditor-sign -m EXCHANGE_MASTER_PUB -r BLOB -u AUDITOR_URI -o OUTPUT_FILE
address@hidden example
+
+The shown arguments are all mandatory.
+
address@hidden
address@hidden @code{EXCHANGE_MASTER_PUB} the base32 Crockford-encoded 
exchange's master
+public key.  Tipically, this value lies in the configuration option
address@hidden/master_public_key}.
address@hidden @code{BLOB} the blob generated in step (1).
address@hidden @code{AUDITOR_URI} the URI that identifies the auditor.
address@hidden @code{OUTPUT_FILE} where on the disk the signed blob is to be 
saved.
address@hidden itemize
+
address@hidden Wire formats
address@hidden FIXME TBD - NOTE, docs.taler.net _might_ contain already some 
text on this
 
 
 @c **********************************************************

-- 
To stop receiving notification emails like this one, please contact
address@hidden