APT Signing Key Folders and Other Development Notes

From Kicksecure
< Dev
Jump to navigation Jump to search
Design Previous page: Dev/apt-revoker Index page: Design Next page: Dev/About Debian Packaging APT Signing Key Folders and Other Development Notes

/etc/apt/trusted.gpg, /etc/apt/trusted.gpg.d, /usr/share/keyrings

APT Keyring Folders

[edit]

APT by default considers only signing keys in:

  • file /etc/apt/trusted.gpg
  • folder /etc/apt/trusted.gpg.d

Signing keys in folder /usr/share/keyrings are ignored by default by APT, unless the signed-by keyword is used in APT sources files (i.e. in configuration file /etc/apt/sources.list or in configuration snippet drop-in folder /etc/apt/sources.list.d).

Example signed-by keyword use in one-line-style sources:

[signed-by=/usr/share/keyrings/derivative.asc]

Example Signed-By keyword use in deb822-style sources:

Signed-By: /usr/share/keyrings/derivative.asc

Example of a complete one-line-style deb sources line with the signed-by keyword.

deb [signed-by=/usr/share/keyrings/derivative.asc] https://deb.kicksecure.com trixie main contrib non-free

Example of a complete deb822-style deb sources stanza with the signed-by keyword.

Types: deb
URIs: https://deb.kicksecure.com
Suites: trixie
Components: main contrib non-free
Enabled: yes
Signed-By: /usr/share/keyrings/derivative.asc

Repository Migration

[edit]

Background on Debian APT Origin and Label

[edit]

When Debian's APT sees a repository for the first time, it notes its Origin and Label fields. Should these change, Debian will show a warning and not proceed using any repository with a changed Origin or Label until the user accepts the change using sudo apt update --allow-releaseinfo-change.

deb822-style sources files

[edit]

The older one-line-style sources format has been deprecated and may be removed in the future. [1] Starting in Kicksecure 18, the deb822-style format is used.

Numerous upstream projects have not yet migrated to the new format, sometimes necessitating forking projects and attempting to contribute the feature upstream later. Some upstream PRs and issues related to this:

Forum Discussion

[edit]

https://forums.whonix.org/t/e-repository-tor-https-deb-kicksecure-com-bullseye-inrelease-changed-its-origin-value-from-kicksecure-to-whonix/13810archive.org iconarchive.today icon

See Also

[edit]

Footnotes

[edit]
  1. https://web.archive.org/web/20251029071653/https://manpages.debian.org/unstable/apt/sources.list.5.en.htmlarchive.org icon states under the section "ONE-LINE-STYLE FORMAT": "This format is deprecated and may eventually be removed, but not before 2029."

Design Previous page: Dev/apt-revoker Index page: Design Next page: Dev/About Debian Packaging

Notification image

We believe security software like Kicksecure needs to remain Open Source and independent. Would you help sustain and grow the project? Learn more about our 13 year success story and maybe DONATE!