zuul-client/doc/source/configuration.rst
Matthieu Huin ced7a372a7 Support for "basic" authentication
If Zuul's identity provider supports Direct Access Grants, the
user can provide their credentials to zuul-client instead of
an auth token. The credentials can be passed as the --username
and --password CLI arguments, or as fields in the configuration file.

If no password is provided, zuul-client will prompt the user to
provide one.

Change-Id: Ief1a1e8d8f763239357d926dd10407a4ed5d8f37
2023-01-25 11:27:07 +01:00

922 B

title

Configuration

Configuration

The web client will look by default for a $HOME/.config/zuul/client.conf or a $HOME/.zuul.conf file for its configuration. The file should consist of a [webclient] section with at least the url attribute set. The optional verify_ssl can be set to False to disable SSL verifications when connecting to Zuul (defaults to True). An authentication token can also be stored in the configuration file under the attribute auth_token to avoid passing the token in the clear on the command line. A default tenant can also be set with the tenant attribute.

Here is an example of a configuration file that can be used with zuul-client:

/examples/zuul.conf

It is also possible to run the web client without a configuration file, by using the --zuul-url option to specify the base URL of the Zuul web server.