mirror of
https://github.com/gocsaf/csaf.git
synced 2025-12-22 18:15:42 +01:00
bb0a30aba3
* Add issuing_authority and contact_details to publisher info example in docs/csaf_provider.md. * Add a link to toml's website.
30 lines
2.5 KiB
Markdown
30 lines
2.5 KiB
Markdown
`csaf_provider` implements the CGI interface for webservers
|
|
and reads its configuration from a [TOML](https://toml.io/en/) file.
|
|
The [setup docs](../README.md#setup-trusted-provider)
|
|
explain how to wire this up with nginx and where the config file lives.
|
|
|
|
## Provider options
|
|
|
|
Following options are supported in the config file:
|
|
|
|
- password: Authentication password for accessing the CSAF provider.
|
|
- openpgp_public_key: The public OpenPGP key. Default: `/ust/lib/csaf/openpgp_public.asc`
|
|
- openpgp_private_key: The private OpenPGP key. Default: `/ust/lib/csaf/openpgp_private.asc`
|
|
- folder: Specify the root folder. Default: `/var/www/`.
|
|
- web: Specify the web folder. Default: `/var/www/html`.
|
|
- upload_signature: Send signature with the request, an additional input-field in the web interface will be shown to let user enter an ascii armored signature. Default: `false`.
|
|
- canonical_url_prefix: start of the URL where contents shall be accessible from the internet. Default: `https://$SERVER_NAME`.
|
|
- no_passphrase: Let user send password with the request, if set to true the input-field in the web interface will be disappeared. Default: `false`.
|
|
- no_validation: Validate the uploaded CSAF document against the JSON schema. Default: `false`.
|
|
- no_web_ui: Disable the web interface. Default: `false`.
|
|
- dynamic_provider_metadata: Take the publisher from the CSAF document. Default: `false`.
|
|
- upload_limit: Set the upload limit size of a file in bytes. Default: `52428800` (aka 50 MiB).
|
|
- issuer: The issuer of the CA, which if set, restricts the writing permission and the accessing to the web-interface to only the client certificates signed with this CA.
|
|
- tlps: Set the allowed TLP comming with the upload request (one or more of "csaf", "white", "amber", "green", "red").
|
|
The "csaf" selection lets the provider takes the value from the CSAF document.
|
|
These affects the list items in the web interface.
|
|
Default: `["csaf", "white", "amber", "green", "red"]`.
|
|
- provider_metadata: Configure the provider metadata.
|
|
- provider_metadata.list_on_CSAF_aggregators: List on aggregators
|
|
- provider_metadata.mirror_on_CSAF_aggregators: Mirror on aggregators
|
|
- provider_metadata.publisher: Set the publisher. Default: `{"category"= "vendor", "name"= "Example Company", "namespace"= "https://example.com", "issuing_authority"= "We at Example Company are responsible for publishing and maintaining Product Y.", "contact_details"= "Example Company can be reached at contact_us@example.com, or via our website at https://www.example.com/contact."}`.
|