waiverdb-cli Configuration
**************************


Description
===========

The file "/etc/waiverdb/client.conf" contains configuration for
waiverdb-cli(1), a tool for reading and modifying WaiverDB.


Options
=======

"[waiverdb]" - Configuration section for "waiverdb-cli"

"api_url" - Base URL for WaiverDB API

"auth_method" - Authentication method - "OIDC" (OpenID Connect) or
"Kerberos"

Following options are valid only if "auth_method" is set to "OIDC".

"oidc_id_provider" - URL of the identity provider for OIDC to get
tokens from

"oidc_client_id" - OIDC client ID to request credentials

"oidc_client_secret" - OIDC client “secret” to request credentials

"oidc_scopes" - A list of scopes required for OIDC client


Files
=====

"/usr/share/doc/waiverdb/client.conf.example"

   Template for configuration file.


Example
=======

   [waiverdb]
   # Specify OIDC or Kerberos for authentication
   auth_method=OIDC
   api_url=https://waiverdb-web-waiverdb.app.os.fedoraproject.org/api/v1.0
   oidc_id_provider=https://id.fedoraproject.org/openidc/
   oidc_client_id=waiverdb-authorizer
   oidc_client_secret=notsecret
   oidc_scopes=
       openid
       https://waiverdb.fedoraproject.org/oidc/create-waiver
