Here's the updated version: --- Title: Portage rsync tree verification Author: Michał Górny <mgo...@gentoo.org> Posted: 2018-01-xx Revision: 1 News-Item-Format: 2.0 Display-If-Installed: <sys-apps/portage-2.3.21
Starting with sys-apps/portage-2.3.22, Portage enables cryptographic verification of the Gentoo rsync repository distributed over rsync by default. This aims to prevent malicious third parties from altering the contents of the ebuild repository received by our users. This does not affect users syncing using git and other methods. Appropriate verification mechanisms for them will be provided in the future. The verification is implemented via using app-portage/gemato. Currently, the whole repository is verified after syncing. On systems with slow hard drives, this could take around 2 minutes. If you wish to disable it, you can disable the 'rsync-verify' USE flag on sys-apps/portage or set 'sync-rsync-verify-metamanifest = no' in your repos.conf. Please note that the verification currently does not prevent Portage from using the repository after syncing. If 'emerge --sync' fails, do not install any packages and retry syncing. In case of prolonged or frequent verification failures, please make sure to report a bug including the failing mirror addresses (found in emerge.log). The verification uses information from the binary keyring provided by the app-crypt/gentoo-keys package. The keys are refreshed from the keyserver before every use in order to check for revocation. The post-sync verification ensures that the key package is verified itself. However, manual verification is required before the first use. On Gentoo installations created using installation media that included portage-2.3.22, the keys will already be covered by the installation media signatures. On existing installations, you need to manually compare the primary key fingerprint (reported by gemato on every sync) against the official Gentoo keys [1]. An example gemato output is: INFO:root:Valid OpenPGP signature found: INFO:root:- primary key: 1234567890ABCDEF1234567890ABCDEF12345678 INFO:root:- subkey: FEDCBA0987654321FEDCBA0987654321FEDCBA09 The primary key printed must match 'Gentoo Portage Snapshot Signing Key' on the site. Please make sure to also check the certificate used for the secure connection to the site! [1]:https://www.gentoo.org/downloads/signatures/ --- -- Best regards, Michał Górny
