Signiertes pkg-Repository in der Forgejo-Paketregistry #27

Merged
jochen merged 3 commits from feat/pkg-repo into master 2026-11-11 07:28:29 +00:00
Collaborator

Closes #14 (letzter offener Punkt: signiertes Paket-Repository).

Aufbau

  • Ablage: generische Forgejo-Paketregistry, ein Kanal pro „Version“:
    https://git.bocc.de/api/packages/jochen/generic/mdns-bridge-freebsd15/{release,testing}
    • release ← Tags v*
    • testing ← jeder Push auf master
  • Signatur: pkg repo mit RSA-Schlüssel. Der private Schlüssel liegt nur als Secret vor, der Public Key wird nach packaging/freebsd/repo/mdns-bridge.pub committet.
  • Auf den Boxen: os-mdns-bridge installiert /usr/local/etc/pkg/repos/mdns-bridge.conf (Kanal des jeweiligen Builds) und den Public Key. Nach der ersten Installation per pkg add kommen Updates über pkg upgrade bzw. die Firmware-Updates.

packaging/freebsd/publish-repo.sh

  1. prüft, dass PKG_REPO_KEY zum committeten Public Key passt (sonst würden alle Clients das Repo ablehnen)
  2. baut das Repo flach (die Registry kennt keine Unterverzeichnisse) und signiert es
  3. löscht den Kanal und lädt alle Dateien neu hoch (eine Registry-Version lässt sich nicht dateiweise überschreiben)
  4. liest das Repo zurück wie ein Client: pkg update mit Signaturprüfung gegen den Public Key, pkg rquery muss genau die gebauten Pakete in der gebauten Version zeigen

Workflow build-freebsd

  • läuft jetzt auch bei Push auf master
  • Schritt „Paket-Repository veröffentlichen“ nur bei Push. Fehlen Secrets oder Public Key, gibt es eine Warnung, und der Lauf bleibt grün.

Getestet

  • shellcheck sauber
  • publish-repo.sh mit pkg-Stub gegen einen lokalen Mock der Registry: falscher Schlüssel und ungültiger Kanal werden abgelehnt; im Erfolgsfall DELETE des Kanals, PUT aller Dateien mit Token, Prüfung bestanden
  • build-plugin.sh mit Public Key: Repo-Konfiguration und Key im Paket, Kanal testing bzw. bei Tag release, korrekte URL. Ohne Key: Hinweis, Paket ohne Repo-Konfiguration.
  • Nicht lokal testbar: echtes pkg repo/pkg update und die Forgejo-API. Das zeigt der erste master-Lauf nach der Einrichtung.

Einrichtung (einmalig, durch dich)

  1. Schlüssel auf einem vertrauenswürdigen Rechner erzeugen:
    openssl genrsa -out mdns-bridge-repo.key 4096
    openssl rsa -in mdns-bridge-repo.key -pubout -out mdns-bridge.pub
    
  2. Repo-Secret PKG_REPO_KEY = Inhalt von mdns-bridge-repo.key
  3. Access Token mit Scope write:package als Repo-Secret PKG_REGISTRY_TOKEN
  4. Inhalt von mdns-bridge.pub schicken (öffentlich, unkritisch); ich committe ihn
  5. Auf dem FreeBSD-Runner curl sicherstellen (pkg install curl)

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Closes #14 (letzter offener Punkt: signiertes Paket-Repository). ## Aufbau - **Ablage:** generische Forgejo-Paketregistry, ein Kanal pro „Version“: `https://git.bocc.de/api/packages/jochen/generic/mdns-bridge-freebsd15/{release,testing}` - `release` ← Tags `v*` - `testing` ← jeder Push auf master - **Signatur:** `pkg repo` mit RSA-Schlüssel. Der private Schlüssel liegt nur als Secret vor, der Public Key wird nach `packaging/freebsd/repo/mdns-bridge.pub` committet. - **Auf den Boxen:** `os-mdns-bridge` installiert `/usr/local/etc/pkg/repos/mdns-bridge.conf` (Kanal des jeweiligen Builds) und den Public Key. Nach der ersten Installation per `pkg add` kommen Updates über `pkg upgrade` bzw. die Firmware-Updates. ## `packaging/freebsd/publish-repo.sh` 1. prüft, dass `PKG_REPO_KEY` zum committeten Public Key passt (sonst würden alle Clients das Repo ablehnen) 2. baut das Repo flach (die Registry kennt keine Unterverzeichnisse) und signiert es 3. löscht den Kanal und lädt alle Dateien neu hoch (eine Registry-Version lässt sich nicht dateiweise überschreiben) 4. liest das Repo zurück wie ein Client: `pkg update` mit Signaturprüfung gegen den Public Key, `pkg rquery` muss genau die gebauten Pakete in der gebauten Version zeigen ## Workflow `build-freebsd` - läuft jetzt auch bei Push auf master - Schritt „Paket-Repository veröffentlichen“ nur bei Push. Fehlen Secrets oder Public Key, gibt es eine Warnung, und der Lauf bleibt grün. ## Getestet - shellcheck sauber - `publish-repo.sh` mit `pkg`-Stub gegen einen lokalen Mock der Registry: falscher Schlüssel und ungültiger Kanal werden abgelehnt; im Erfolgsfall DELETE des Kanals, PUT aller Dateien mit Token, Prüfung bestanden - `build-plugin.sh` mit Public Key: Repo-Konfiguration und Key im Paket, Kanal `testing` bzw. bei Tag `release`, korrekte URL. Ohne Key: Hinweis, Paket ohne Repo-Konfiguration. - **Nicht lokal testbar:** echtes `pkg repo`/`pkg update` und die Forgejo-API. Das zeigt der erste master-Lauf nach der Einrichtung. ## Einrichtung (einmalig, durch dich) 1. Schlüssel auf einem vertrauenswürdigen Rechner erzeugen: ``` openssl genrsa -out mdns-bridge-repo.key 4096 openssl rsa -in mdns-bridge-repo.key -pubout -out mdns-bridge.pub ``` 2. Repo-Secret `PKG_REPO_KEY` = Inhalt von `mdns-bridge-repo.key` 3. Access Token mit Scope `write:package` als Repo-Secret `PKG_REGISTRY_TOKEN` 4. Inhalt von `mdns-bridge.pub` schicken (öffentlich, unkritisch); ich committe ihn 5. Auf dem FreeBSD-Runner `curl` sicherstellen (`pkg install curl`) 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Signed pkg repository in the Forgejo package registry
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m55s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m29s
ci / rust (pull_request) Successful in 3m30s
2edd27809a
- packaging/freebsd/publish-repo.sh: builds a pkg repository from the
  built packages, signs it (pkg repo with RSA key), replaces the channel
  in the generic registry (<owner>/generic/mdns-bridge-freebsd<major>/
  <channel>, files flat) and reads it back like a client: signature
  checked against the committed public key, both packages in the
  expected version. Refuses a signing key that does not match
  packaging/freebsd/repo/mdns-bridge.pub.
- build-freebsd: also runs on pushes to master; publishes master to
  channel testing, tags v* to release. Skipped with a warning until the
  secrets PKG_REPO_KEY, PKG_REGISTRY_TOKEN and the public key exist.
- build-plugin.sh: once the public key is committed, os-mdns-bridge
  installs /usr/local/etc/pkg/repos/mdns-bridge.conf (channel of the
  build) and the key, so firewalls get updates via pkg upgrade /
  firmware updates after the first manual install.
- README, opnsense/README.md: setup (key, secrets), channels, plain
  FreeBSD client configuration.

Closes #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Public key of the package repository
Some checks failed
build-freebsd / freebsd (pull_request) Successful in 3m1s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m26s
ci / rust (pull_request) Has been cancelled
4797cf15d4
RSA 4096. The matching private key is only in the secret PKG_REPO_KEY;
publish-repo.sh refuses to sign with any other key. From now on the
plugin package installs the repository configuration and this key.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Use the existing user secret REPO_REGISTRY_TOKEN
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m57s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m27s
ci / rust (pull_request) Successful in 3m28s
b32dc963d5
The registry token is the user secret REPO_REGISTRY_TOKEN of jochen
(shared with other repositories); the workflow passes it to
publish-repo.sh as PKG_REGISTRY_TOKEN. PKG_REPO_KEY stays a repository
secret.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-11 07:28:22 +00:00
jochen merged commit a3b6a662c5 into master 2026-11-11 07:28:29 +00:00
jochen deleted branch feat/pkg-repo 2026-11-11 07:28:29 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/mdns-bridge!27
No description provided.