Update README

This commit is contained in:
~lucidiot 2022-11-12 22:49:02 +01:00
parent 740aa3c646
commit b5635ca0fc
1 changed files with 22 additions and 1 deletions

View File

@ -12,4 +12,25 @@ CertBoat connects to the modern Windows Update endpoints to retrieve Certificate
## Usage
If you have enabled the relevant option in the installer, then CertBoat has been installed as a scheduled task, and you no longer have to care about it. If you still want to manually update, you can do so by running `CertBoat.exe` at the nearest command prompt.
CertBoat has been installed as a scheduled task through its `.msi` installer, and you no longer have to care about it. If you still want to manually update, you can do so by running `Lucidiot.CertBoat.exe` at the nearest command prompt, or you can manually execute the CertBoat scheduled task from the Scheduled Tasks folder. Run `Lucidiot.CertBoat.exe /help` to learn more about the available options.
## Configuration
A few settings can be configured using an XML file located next to the executable, for example at `C:\Program Files\lucidiot\CertBoat\Lucidiot.CertBoat.exe.config`:
`UserAgent`
: The User-Agent header sent in HTTP requests to the certificate trust list download URLs. `{0}` will be replaced by the version number of the program. By default, `CertBoat/{0}` will be used, which results in `CertBoat/1.0.0` for the initial release.
`CabinetUris`
: A list of whatever amount of URIs you want pointing to `.cab` archive files. Each file must contain only one file, a certificate trust list in `.stl` extension. HTTP should be preferred as HTTPS might not work if the local machine's root certificates are very badly out of date.
`SystemStoreName`
: Name of the system certificate store that CertBoat will store the certificate trust lists into. This defaults to `trust`, which appears to be where Windows Update used to put the CTLs when it still managed the updates. You can find a list of existing system stores in the Registry, under `HKEY_CURRENT_USER\Software\Microsoft\SystemCertificates\`. Each key inside of that key is a separate store, and you can also specify a non-existing name to create a new store.
If you wish to reset to the default settings, just delete the `.config` file. It will be recreated on the next execution of CertBoat.
## Translations
Translations of this tool are welcome! Copy and paste the `Lucidiot.CertBoat/Strings.resx` and `Strings.Designer.cs` files and append a language code to it, for example `Strings.de.resx` and `Strings.de.Designer.cs` for a German translation, then edit `Strings.de.resx` to update all the `<value>` tags to translated values. The `<comment>` tags should help you understand in which context each string is used to make better translations.
If you have Visual Studio installed, you can copy and paste `Strings.resx` and add the language code from within the **Project Explorer** panel, then open the GUI editor to get a cleaner overview of the translations to create.