commit 351693ff63564039d19efb21ca846403eaced576
parent 0ff642bbd5ea9383543f6b7d2ab8df1e0f5ff784
Author: Florian Dold <dold@taler.net>
Date: Thu, 27 Aug 2026 23:45:34 +0200
challenger docs: document AUTH_COMMAND arguments
Diffstat:
2 files changed, 12 insertions(+), 5 deletions(-)
diff --git a/manpages/challenger.conf.5.rst b/manpages/challenger.conf.5.rst
@@ -78,7 +78,13 @@ PIN_RETRANSMISSION_FREQUENCY
Minimum time that must pass before the same challenge code (TAN) is (re)transmitted to the same address again. Users may ask the challenger to re-send the challenge, but such requests are ignored if the last transmission happened more recently than this. Should be (much) smaller than ``VALIDATION_DURATION``. Optional, defaults to 5 minutes if not given.
AUTH_COMMAND
- Which command should we execute to transmit the challenge code to the address. The address is given as the first argument, while the message to send is provided on stdin. Templates (possibly without the necessary credentials) for such commands are provided as challenger-send-email.sh, challenger-send-post.sh and challenger-send-sms.sh.
+ Command to execute to transmit the challenge code to the address. The value
+ may include arguments separated by spaces. Quoting and escaping are not
+ supported. The address is appended as the final argument, while the message
+ to send is provided on standard input. Templates (possibly without the
+ necessary credentials) for such commands are provided as
+ challenger-send-email.sh, challenger-send-post.sh and
+ challenger-send-sms.sh.
ADDRESS_TYPE
Type of the address that is being collected, returned as part of the ``address_type`` in the ``/info`` endpoint. Examples include ``email`` or ``phone``.
diff --git a/taler-challenger-manual.rst b/taler-challenger-manual.rst
@@ -237,10 +237,11 @@ configuration contains two configuration options.
shown to the user.
(2) The ``AUTH_COMMAND`` configuration option specifies which command
- Challenger should run to send a challenge to an address. The actual
- address is given to this subcommand as the first argument (``$1``),
- while the text with the challenge is passed to standard input.
- The subcommand should terminate with a status code of 0 on success.
+ Challenger should run to send a challenge to an address. The value may
+ include arguments separated by spaces; quoting and escaping are not
+ supported. The actual address is appended as the final argument, while
+ the text with the challenge is passed to standard input. The command
+ should terminate with a status code of 0 on success.
.. code-block:: ini
:caption: /etc/challenger/challenger.conf
