Skip to main content

How can we help you?

Search

help Knowledge Base
forum Community
checklist Release Notes
event Events

Add extra security with PGP/GPG programs

Minetta Gould
  • Updated

    In this article

Follow this guide to deploy the Windows or macOS Roaming Client with a PGP/GPG program.

PGP/GPG programs offer an additional layer of security to protect electronic communications. These optional installation steps that can be done if extra security is needed.  

Customized Checksum Files

If customers require a specific version of the .asc checksum files, contact DNSFilter Support with the request.

Windows PGP/GPG Installation 

Step one: Download the PGP/GPG 

  1. Download PGP/GPG

Optionally, add the installation directory to the path. This creates a shortcut to type just "gpg" from the command line rather than C:\Program Files\GnuPG\gpg

  1. From the Windows device, navigate to the Settings Control Panel and open System
  2. Select Advanced
  3. Select Environment Variables 
  4. Edit Path
    1. Add this value to the end of the path: ; C:\Program Files\GnuPG
  5. Select OK until the System dialog closes

Step two: Download the DNSFilter public key

  1. Download the public key
  2. Save the key, e.g. C:\Users\Joe\Desktop\dnsfilter-public-key.asc
  3. Import the public key 
    gpg --import C:\Users\Joe\Desktop\dnsfilter-public-key.asc

Step three: Download the Roaming Client Installer and Checksum file

  1. From the DNSFilter dashboard, navigate to Deployments and select Roaming Clients
  2. Tab to Install
  3. Download the installer

    Optionally, download the installer.sha256sum.asc checksum file to verify the file integrity.
  4. Verify the checksum against the downloaded installer. 💡 Pro Tip: If the file has a space in it, the command should wrap the entire filename in quotes:
    gpg -o - --verify DNSFilter_Agent_Setup.msi.sha256sum.asc | "C:\Program Files (x86)\Gpg4Win\bin\sha256sum.exe" -c -

Successful MSI installer line return: DNSFilter_Agent_Setup.msi OK

Unsuccessful MSI installer line return: DNSFilter_Agent_Setup.msi FAILED

If the verification fails, re-download and try running the commands again to verify.

macOS PGP/GPG Installation

Similar steps can be followed for verifying the file checksum via PGP on Linux.

Step one: Download and install brew gpg

  1. Download brew gpg 
  2. From Terminal, use these commands to install GPG: brew install gpg or brew install gnupg

Step two: Download the DNSFilter public key

  1. Download the public key
  2. Save the key to dnsfilter_public.asc
  3. Import the public key
    gpg --import dnsfilter_public.asc

Step three: Download the Roaming Client Installer and Checksum file

  1. From the DNSFilter dashboard, navigate to Deployments and select Roaming Clients
  2. Tab to Install
  3. Download the installer

    Optionally, download the installer.sha256sum.asc checksum file to verify the file integrity.
  4. Verify the checksum against the downloaded installer
  5. From Terminal, run this command: brew install sha3sum
    Example:
    gpg -o - --verify DNSFilter Agent-Installer.pkg.sha256sum.asc | shasum -a 256 -c

Successful MSI installer line return: DNSFilter_Agent_Setup.msi OK

Unsuccessful MSI installer line return: DNSFilter_Agent_Setup.msi FAILED

If the verification fails, re-download and try running the commands again to verify.

Was this article helpful?
0 out of 0 found this helpful
Return to top

Comments

0 comments

Article is closed for comments.