TYPO3 release integrity

TYPO3 release packages (the downloadable tarballs and zip files) as well as Git tags are signed using PGP signatures during the automated release process. SHA2-256, SHA1 and MD5 hashes are also generated for these files.

Release contents

Every release of TYPO3 is made available with the following files:

TYPO3 CMS 12.4.11 release as an example
typo3_src-12.4.11.tar.gz
typo3_src-12.4.11.tar.gz.sig
typo3_src-12.4.11.zip
typo3_src-12.4.11.zip.sig
Copied!
  • *.tar.gz and *.zip files are the actual release packages, containing the source code of TYPO3
  • *.sig files contain the corresponding signatures for each release package file

Checking file hashes

File hashes are used to check that a downloaded file was transferred and stored correctly on the local system. TYPO3 uses cryptographic hash methods including MD5 and SHA2-256.

The file hashes for each version are published on get.typo3.org and can be found on the corresponding release page, for example https://get.typo3.org/version/12#package-checksums contains:

TYPO3 v12.4.11 checksums
SHA256:
a93bb3e8ceae5f00c77f985438dd948d2a33426ccfd7c2e0e5706325c43533a3  typo3_src-12.4.11.tar.gz
8e0a8eaeed082e273289f3e17318817418c38c295833a12e7f94abb2845830ee  typo3_src-12.4.11.zip

SHA1:
9fcecf7b0e72074b060516c22115d57dd29fd5b0  typo3_src-12.4.11.tar.gz
3606bcc9331f2875812ddafd89ccc2ddf8922b63  typo3_src-12.4.11.zip

MD5:
a4fbb1da81411f350081872fe2ff2dac  typo3_src-12.4.11.tar.gz
c514ef9b7aad7c476fa4f36703e686fb  typo3_src-12.4.11.zip
Copied!

To verify file hashes, the hashes need to be generated locally for the packages downloaded and then compared to the published hashes on get.typo3.org. To generate the hashes locally, one of the following command line tools md5sum, sha1sum or shasum needs to be used.

The following commands generate hashes for the .tar.gz and .zip packages:

 $
shasum -a 256 typo3_src-*.tar.gz typo3_src-*.zip
a93bb3e8ceae5f00c77f985438dd948d2a33426ccfd7c2e0e5706325c43533a3  typo3_src-12.4.11.tar.gz
8e0a8eaeed082e273289f3e17318817418c38c295833a12e7f94abb2845830ee  typo3_src-12.4.11.zip
Copied!
 $
sha1sum -c typo3_src-*.tar.gz typo3_src-*.zip
9fcecf7b0e72074b060516c22115d57dd29fd5b0  typo3_src-12.4.11.tar.gz
3606bcc9331f2875812ddafd89ccc2ddf8922b63  typo3_src-12.4.11.zip
Copied!
 $
md5sum typo3_src-*.tar.gz typo3_src-*.zip
a4fbb1da81411f350081872fe2ff2dac  typo3_src-12.4.11.tar.gz
c514ef9b7aad7c476fa4f36703e686fb  typo3_src-12.4.11.zip
Copied!

These hashes must match the hashes published on get.typo3.org to ensure package integrity.

Checking file signatures

TYPO3 uses Pretty Good Privacy to sign release packages and Git release tags. To validate these signatures The GNU Privacy Guard is recommend, however any OpenPGP compliant tool can also be used.

The release packages are using a detached binary signature. This means that the file typo3_src-12.4.11.tar.gz has an additional signature file typo3_src-12.4.11.tar.gz.sig which is the detached signature.

 $
gpg --verify typo3_src-12.4.11.tar.gz.sig typo3_src-12.4.11.tar.gz
Copied!
gpg: Signature made 13 Feb 2024 10:56:11 CET
gpg:                using RSA key 2B1F3D58AEEFB6A7EE3241A0C19FAFD699012A5A
gpg: Can't check signature: No public key
Copied!

The warning means that the public key 2B1F3D58AEEFB6A7EE3241A0C19FAFD699012A5A is not yet available on the local system and cannot be used to validate the signature. The public key can be obtained by any key server - a popular one is pgpkeys.mit.edu.

 $
wget -qO- https://get.typo3.org/KEYS | gpg --import
Copied!
gpg: requesting key 59BC94C4 from hkp server pgpkeys.mit.edu
gpg: key 59BC94C4: public key "TYPO3 Release Team (RELEASE) <typo3cms@typo3.org>" imported
gpg: key FA9613D1: public key "Benjamin Mack <benni@typo3.org>" imported
gpg: key 16490937: public key "Oliver Hader <oliver@typo3.org>" imported
gpg: no ultimately trusted keys found
gpg: Total number processed: 3
gpg:               imported: 3  (RSA: 3)
Copied!

Once the public key has been imported, the previous command on verifying the signature of the typo3_src-12.4.11.tar.gz file can be repeated.

 $
gpg --verify typo3_src-12.4.11.tar.gz.sig typo3_src-12.4.11.tar.gz
Copied!
gpg: Signature made Tue Feb 13 10:56:11 2024 CET
gpg:                using RSA key 2B1F3D58AEEFB6A7EE3241A0C19FAFD699012A5A
gpg: Good signature from "Oliver Hader <oliver@typo3.org>" [unknown]
gpg:                 aka "Oliver Hader <oliver.hader@typo3.org>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 0C4E 4936 2CFA CA0B BFCE  5D16 A36E 4D1F 1649 0937
     Subkey fingerprint: 2B1F 3D58 AEEF B6A7 EE32  41A0 C19F AFD6 9901 2A5A
Copied!

The new warning is expected since everybody could have created the public key and uploaded it to the key server. The important point here is to validate the key fingerprint 0C4E 4936 2CFA CA0B BFCE 5D16 A36E 4D1F 1649 0937 which is in this case the correct one for TYPO3 CMS release packages (see below for a list of currently used keys or access the https://get.typo3.org/KEYS file directly).

 $
gpg --fingerprint 0C4E49362CFACA0BBFCE5D16A36E4D1F16490937
Copied!
pub   rsa4096 2017-08-10 [SC] [expires: 2024-08-14]
     0C4E 4936 2CFA CA0B BFCE  5D16 A36E 4D1F 1649 0937
uid           [ unknown] Oliver Hader <oliver@typo3.org>
uid           [ unknown] Oliver Hader <oliver.hader@typo3.org>
sub   rsa4096 2017-08-10 [E] [expires: 2024-08-14]
sub   rsa4096 2017-08-10 [S] [expires: 2024-08-14]
Copied!

Checking tag signature

Checking signatures on Git tags works similar to verifying the results using the gpg tool, but with using the git tag --verify command directly.

 $
git tag --verify v12.4.11
Copied!
object 3f83ff31e72053761f33b975410fa2881174e0e5
type commit
tag v12.4.11
tagger Oliver Hader <oliver@typo3.org> 1707818102 +0100

Release of TYPO3 12.4.11
gpg: Signature made Tue Feb 13 10:55:02 2024 CET
gpg:                using RSA key 2B1F3D58AEEFB6A7EE3241A0C19FAFD699012A5A
gpg: Good signature from "Oliver Hader <oliver@typo3.org>" [unknown]
gpg:                 aka "Oliver Hader <oliver.hader@typo3.org>" [unknown]
Primary key fingerprint: 0C4E 4936 2CFA CA0B BFCE  5D16 A36E 4D1F 1649 0937
     Subkey fingerprint: 2B1F 3D58 AEEF B6A7 EE32  41A0 C19F AFD6 9901 2A5A
Copied!

The git show command on the name of the tag reveals more details.

 $
git show v12.4.11
Copied!
tag v12.4.11
Tagger: Oliver Hader <oliver@typo3.org>
Date:   Tue Feb 13 10:55:02 2024 +0100

Release of TYPO3 12.4.11
-----BEGIN PGP SIGNATURE-----
...
-----END PGP SIGNATURE-----
Copied!

Public keys

You can download the used public keys from get.typo3.org.keys