Skip to content

tired-runner/CRLSet-Mirror

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CRLSet-Mirror

Pulls down and installs CRLSet component for ungoogled-chromium users who want certificate revocation

Note that this does pull the latest CRLSet file directly from google. Not a terribly exciting bit of traffic, but its worth noting since this is for ungoogled-chromium users. The connections to google are two get requests: one to retrieve the latest version information and another to pull down the actual file if the currently installed version is out of date.

Usage

Install once without auto update

  1. Locate your ungoogled-chromium CertificateRevocation folder location.
  2. Go to the releases tab and download the mirror-crl artifact
  3. Make it executable with chmod u+x mirror-crl
  4. Run it with ./mirror-crl --path <your CertificateRevocation location>
  5. Open ungoogled-chromium and navigate to https://revoked.badssl.com/. You should see an error from the revoked certificate!

Set up auto updates with systemd

You could additionally create a timer file or use whatever other mechanism systemd provides to schedule this however frequently you want. For this example, I am updating once on startup, which works for me because I turn off my computer at the end of the day. If you are putting it on a timer, once every couple of hours would also be reasonable and roughly match Chrome's behavior.

  1. Locate your ungoogled-chromium CertificateRevocation folder location.
  2. Go to the releases tab and download the mirror-crl artifact
  3. Move it to where you want to keep it, for the purposes of these instructions will use ~/CRLUpdater
  4. Make it executable with chmod u+x mirror-crl
  5. navigate to the ~/.config/systemd/user directory or create it if it does not exist
  6. Run touch mirror-crl.service and then edit it with your text editor of choice
  7. [Unit]
    Description=Update CRL list in ungoogled-chromium
    After=network.service
    
    [Service]
    Type=oneshot
    ExecStart=<your home path>/CRLUpdater/mirror-crl --path <your CertificateRevocation location>
    
    [Install]
    WantedBy=default.target
    
  8. Run systemctl --user enable mirror-crl.service
  9. reboot, and confirm with systemctl --user status mirror-crl that the crl updated successfully
  10. Open ungoogled-chromium and navigate to https://revoked.badssl.com/. You should see an error from the revoked certificate!

Non systemd auto updates

  1. Locate your ungoogled-chromium CertificateRevocation folder location.
  2. Go to the releases tab and download the mirror-crl artifact
  3. Move it to where you want to keep it, and make it executable with chmod u+x mirror-crl
  4. Use cron or whatever other task scheduling mechanism to run mirror-crl --path <your CertificateRevocation location> with whatever frequency you want

Non Linux systems

This Python script should be cross platform, but I haven't tested it on Windows or MacOS. If you'd like to try it out, build an executable for your platform running the following commands:

pip install -r requirements.txt
python -m PyInstaller --onefile mirror-crl.py
python -m PyInstaller mirror-crl.spec

If you run into problems or come up with platform‑specific instructions, please file an issue or submit a pull request. If I get confirmation the script works on Windows or MacOS, I’ll add CI to build executables for those systems.

Locating your CertificateRevocation folder

This folder's location is platform dependent. Places to look include:

  • ~/.config/chromium/CertificateRevocation
  • ~/.var/app/io.github.ungoogled_software.ungoogled_chromium/config/chromium/CertificateRevocation This is where it is for me, since I am using a flatpak installation

About

Pulls down and installs CRLSet component for ungoogled-chromium users who want certificate revocation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages