challenger-admin.1.rst (2544B)
1 challenger-admin(1) 2 ################### 3 4 .. only:: html 5 6 Name 7 ==== 8 9 **challenger-admin** - manipulate clients registered in Challenger database 10 11 12 Synopsis 13 ======== 14 15 **challenger-admin** 16 [**-a** *CLIENT_SECRET* | **--add=**\ \ *CLIENT_SECRET*] 17 [**-c** *FILENAME* | **--config=**\ \ *FILENAME*] 18 [**-d** | **--delete**] 19 [**-h** | **--help**] 20 [**-L** *LOGLEVEL* | **--log=**\ \ *LOGLEVEL*] 21 [**-l** *FILENAME* | **--logfile=**\ \ *FILENAME*] 22 [**-m** *CLIENT_ID* | **--modify-client=**\ \ *CLIENT_ID*] 23 [**-q** | **--quiet**] 24 [**-v** | **--version**] 25 CLIENT_REDIRECT_URL 26 27 28 Description 29 =========== 30 31 **challenger-admin** is a command-line tool to add or delete clients from the Challenger database. 32 33 Its options are as follows: 34 35 **-a** *CLIENT_SECRET* \| **--add=**\ \ *CLIENT_SECRET* 36 Add the client with the given *CLIENT_REDIRECT_URL setting the client secret to *CLIENT_SECRET*. Prints the *CLIENT_ID* of the added client. The *CLIENT_SECRET* must begin with "secret-token:" as per RFC 8959. 37 38 Passing the client secret via the command-line exposes it to other 39 users on the same host. If that is a concern, it is also possible 40 to set the client secret via the 41 ``CHALLENGER_CLIENT_SECRET`` environment variable. If both are 42 set, the command-line version is preferred. 43 44 **-c** *FILENAME* \| **--config=**\ \ *FILENAME* 45 Use the configuration and other resources for the Challenger commands 46 to operate from *FILENAME*. 47 48 **-d** \| **--delete** 49 Delete the client with the given *CLIENT_REDIRECT_URL*. Note that deletion by *CLIENT_ID* is not possible. 50 51 **-h** \| **--help** 52 Print short help on options. 53 54 **-L** *LOGLEVEL* \| **--log=**\ \ *LOGLEVEL* 55 Configure logging to use *LOGLEVEL*. 56 57 **-l** *FILENAME* \| **--logfile=**\ \ *FILENAME* 58 Configure logging to write logs to *FILENAME*. 59 60 **-m** *CLIENT_ID* \| **--modify-client=**\ \ *CLIENT_ID* 61 Modify the client with the given ID. Always updates the *CLIENT_REDIRECT_URL*, and optionally modifies the client secret if the **-a** option is also given or the ``CHALLENGER_CLIENT_SECRET`` environment variable is set. The client must already exist. The option cannot be used together with **-d**. 62 63 **-q** \| **–-quiet** 64 Be less verbose in the output. Useful in shell scripts. 65 66 **-v** \| **–-version** 67 Print version information. 68 69 70 See Also 71 ======== 72 73 challenger-config(1), challenger-httpd(1), challenger.conf(5). 74 75 76 Bugs 77 ==== 78 79 Report bugs by using https://bugs.taler.net or by sending electronic 80 mail to <taler@gnu.org>.