112 lines
3.5 KiB
Plaintext
112 lines
3.5 KiB
Plaintext
|
#!/bin/bash
|
||
|
|
||
|
# Copyright 2018 B. Persson, Bjorn@Rombobeorn.se
|
||
|
#
|
||
|
# This material is provided as is, with absolutely no warranty expressed
|
||
|
# or implied. Any use is at your own risk.
|
||
|
#
|
||
|
# Permission is hereby granted to use or copy this shellscript
|
||
|
# for any purpose, provided the above notices are retained on all copies.
|
||
|
# Permission to modify the code and to distribute modified code is granted,
|
||
|
# provided the above notices are retained, and a notice that the code was
|
||
|
# modified is included with the above copyright notice.
|
||
|
|
||
|
|
||
|
function print_help {
|
||
|
cat <<'EOF'
|
||
|
Usage: gpgverify --keyring=<pathname> --signature=<pathname> --data=<pathname>
|
||
|
|
||
|
gpgverify is a wrapper around gpgv designed for easy and safe scripting. It
|
||
|
verifies a file against a detached OpenPGP signature and a keyring. The keyring
|
||
|
shall contain all the keys that are trusted to certify the authenticity of the
|
||
|
file, and must not contain any untrusted keys.
|
||
|
|
||
|
The differences, compared to invoking gpgv directly, are that gpgverify accepts
|
||
|
the keyring in either ASCII-armored or unarmored form, and that it will not
|
||
|
accidentally use a default keyring in addition to the specified one.
|
||
|
|
||
|
Parameters:
|
||
|
--keyring=<pathname> keyring with all the trusted keys and no others
|
||
|
--signature=<pathname> detached signature to verify
|
||
|
--data=<pathname> file to verify against the signature
|
||
|
EOF
|
||
|
}
|
||
|
|
||
|
|
||
|
fatal_error() {
|
||
|
message="$1" # an error message
|
||
|
status=$2 # a number to use as the exit code
|
||
|
echo "gpgverify: $message" >&2
|
||
|
exit $status
|
||
|
}
|
||
|
|
||
|
|
||
|
require_parameter() {
|
||
|
term="$1" # a term for a required parameter
|
||
|
value="$2" # Complain and terminate if this value is empty.
|
||
|
if test -z "${value}" ; then
|
||
|
fatal_error "No ${term} was provided." 2
|
||
|
fi
|
||
|
}
|
||
|
|
||
|
|
||
|
check_status() {
|
||
|
action="$1" # a string that describes the action that was attempted
|
||
|
status=$2 # the exit code of the command
|
||
|
if test $status -ne 0 ; then
|
||
|
fatal_error "$action failed." $status
|
||
|
fi
|
||
|
}
|
||
|
|
||
|
|
||
|
# Parse the command line.
|
||
|
keyring=
|
||
|
signature=
|
||
|
data=
|
||
|
for parameter in "$@" ; do
|
||
|
case "${parameter}" in
|
||
|
(--help)
|
||
|
print_help
|
||
|
exit
|
||
|
;;
|
||
|
(--keyring=*)
|
||
|
keyring="${parameter#*=}"
|
||
|
;;
|
||
|
(--signature=*)
|
||
|
signature="${parameter#*=}"
|
||
|
;;
|
||
|
(--data=*)
|
||
|
data="${parameter#*=}"
|
||
|
;;
|
||
|
(*)
|
||
|
fatal_error "Unknown parameter: \"${parameter}\"" 2
|
||
|
;;
|
||
|
esac
|
||
|
done
|
||
|
require_parameter 'keyring' "${keyring}"
|
||
|
require_parameter 'signature' "${signature}"
|
||
|
require_parameter 'data file' "${data}"
|
||
|
|
||
|
# Make a temporary working directory.
|
||
|
workdir="$(mktemp --directory)"
|
||
|
check_status 'Making a temporary directory' $?
|
||
|
workring="${workdir}/keyring.gpg"
|
||
|
|
||
|
# Decode any ASCII armor on the keyring. This is harmless if the keyring isn't
|
||
|
# ASCII-armored.
|
||
|
gpg2 --homedir="${workdir}" --yes --output="${workring}" --dearmor "${keyring}"
|
||
|
check_status 'Decoding the keyring' $?
|
||
|
|
||
|
# Verify the signature using the decoded keyring.
|
||
|
gpgv2 --homedir="${workdir}" --keyring="${workring}" "${signature}" "${data}"
|
||
|
check_status 'Signature verification' $?
|
||
|
|
||
|
# (--homedir isn't actually necessary. --dearmor processes only the input file,
|
||
|
# and if --keyring is used and contains a slash, then gpgv2 uses only that
|
||
|
# keyring. Thus neither command will look for a default keyring, but --homedir
|
||
|
# makes extra double sure that no default keyring will be touched in case
|
||
|
# another version of GPG works differently.)
|
||
|
|
||
|
# Clean up. (This is not done in case of an error that may need inspection.)
|
||
|
rm --recursive --force ${workdir}
|