#!/usr/bin/env python3 """Restore the CI signing key and verify its public certificate before publishing.""" import argparse import base64 import hashlib import os from pathlib import Path import re import shutil import subprocess import sys ROOT = Path(__file__).resolve().parents[2] PIN = ROOT / '.gitea/release-signing.sha256' KEYSTORE = ROOT / '.secrets/ci-release.p12' REQUIRED = ('ANDROID_KEYSTORE_BASE64', 'ANDROID_KEYSTORE_PASSWORD', 'ANDROID_KEY_ALIAS', 'ANDROID_KEY_PASSWORD') def expected_fingerprint(): value = PIN.read_text().strip().lower() if not re.fullmatch(r'[0-9a-f]{64}', value): raise ValueError('Invalid pinned release certificate SHA-256') return value def keytool(): home = os.environ.get('JAVA_HOME') return str(Path(home) / 'bin/keytool') if home else 'keytool' def apksigner(): executable = shutil.which('apksigner') if executable: return executable sdk = os.environ.get('ANDROID_HOME') or os.environ.get('ANDROID_SDK_ROOT') tools = list((Path(sdk) / 'build-tools').glob('*/apksigner')) if sdk else [] if not tools: raise ValueError('apksigner not found; set ANDROID_HOME or PATH') return str(max(tools, key=lambda p: tuple(map(int, re.findall(r'\d+', p.parent.name))))) def prepare(): missing = [name for name in REQUIRED if not os.environ.get(name)] if missing: raise ValueError('Missing signing secrets: ' + ', '.join(missing)) expected = expected_fingerprint() try: data = base64.b64decode(''.join(os.environ[REQUIRED[0]].split()), validate=True) except ValueError: raise ValueError('ANDROID_KEYSTORE_BASE64 is not valid base64') from None KEYSTORE.parent.mkdir(mode=0o700, exist_ok=True) # Never leave a partially decoded or unverified signing key behind. try: with open(KEYSTORE, 'wb', opener=lambda p, flags: os.open(p, flags, 0o600)) as stream: os.chmod(KEYSTORE, 0o600) stream.write(data) certificate = subprocess.check_output([ keytool(), '-exportcert', '-keystore', str(KEYSTORE), '-alias', os.environ['ANDROID_KEY_ALIAS'], '-storepass:env', 'ANDROID_KEYSTORE_PASSWORD' ], stderr=subprocess.PIPE) actual = hashlib.sha256(certificate).hexdigest() if actual != expected: raise ValueError('Signing key does not match the pinned release certificate') with open(os.environ['GITHUB_ENV'], 'a') as stream: stream.write(f'ANDROID_KEYSTORE_PATH={KEYSTORE}\n') print(f'Release signing certificate verified: {actual}') except Exception: KEYSTORE.unlink(missing_ok=True) raise def verify(apks): expected = expected_fingerprint() for apk in apks: output = subprocess.check_output( [apksigner(), 'verify', '--print-certs', apk], text=True, stderr=subprocess.PIPE) fingerprints = re.findall(r'Signer #\d+ certificate SHA-256 digest: ([0-9a-f]+)', output) if fingerprints != [expected]: raise ValueError(f'{Path(apk).name}: APK signer does not match the pinned release certificate') print(f'{Path(apk).name}: release signature verified ({expected})') def main(): parser = argparse.ArgumentParser(description=__doc__) commands = parser.add_subparsers(dest='command', required=True) commands.add_parser('prepare') commands.add_parser('cleanup') commands.add_parser('verify').add_argument('apks', nargs='+') args = parser.parse_args() try: if args.command == 'prepare': prepare() elif args.command == 'verify': verify(args.apks) else: KEYSTORE.unlink(missing_ok=True) except subprocess.CalledProcessError: print('Signing tool failed. Check the keystore, alias and passwords.', file=sys.stderr) return 1 except (OSError, ValueError) as error: print(str(error), file=sys.stderr) return 1 return 0 if __name__ == '__main__': sys.exit(main())