Αυτό το έγγραφο ορίζει την πολιτική ελέγχου προέλευσης για τα GitHub Actions σε αυτό το αποθετήριο.
Στόχος Φάσης 1: Περιορισμός των επιτρεπόμενων ενεργειών με ελάχιστη οργανωτική αναστάτωση, πριν από την πλήρη εφαρμογή του SHA pinning.
- Δικαιώματα Actions: Ενεργοποιημένα (Enabled).
- Περιορισμός Ενεργειών: Επιλεγμένες ενέργειες (Selected actions).
- Απαίτηση SHA Pinning: Απενεργοποιημένη (θα εφαρμοστεί στη Φάση 2).
Επιτρέπονται τα παρακάτω πρότυπα ενεργειών:
actions/*(επίσημα actions για cache, checkout, artifacts κ.λπ.)docker/*dtolnay/rust-toolchain@*DavidAnson/markdownlint-cli2-action@*lycheeverse/lychee-action@*EmbarkStudios/cargo-deny-action@*rustsec/audit-check@*rhysd/actionlint@*softprops/action-gh-release@*sigstore/cosign-installer@*Checkmarx/vorpal-reviewdog-github-action@*Swatinem/rust-cache@*
Χρησιμοποιήστε τις παρακάτω εντολές για να επαληθεύσετε την τρέχουσα πολιτική:
gh api repos/zeroclaw-labs/zeroclaw/actions/permissions
gh api repos/zeroclaw-labs/zeroclaw/actions/permissions/selected-actionsΚάθε αλλαγή στην πολιτική πρέπει να καταγράφει:
- Ημερομηνία και ώρα (UTC).
- Υπεύθυνος αλλαγής (Actor).
- Αιτιολογία.
- Μεταβολές στη λίστα επιτρεπόμενων.
- Οδηγίες επαναφοράς (Rollback).
- Μείωση του κινδύνου στην εφοδιαστική αλυσίδα (supply-chain risk) από μη ελεγμένες ενέργειες.
- Διατήρηση της λειτουργικότητας CI/CD με ελάχιστο κόστος μετάβασης.
- Προετοιμασία για το SHA pinning στη Φάση 2 χωρίς παρεμπόδιση της ανάπτυξης.
Λόγω του μεγάλου όγκου αλλαγών από αυτοματοποιημένους πράκτορες:
- Κάθε PR που τροποποιεί πηγές ενεργειών (
uses:) πρέπει να τεκμηριώνει την επίδραση στη λίστα επιτρεπόμενων. - Νέες ενέργειες τρίτων απαιτούν έγκριση από συντηρητή (maintainer).
- Αποφύγετε τη χρήση γενικών συμβόλων (wildcards) όπου είναι δυνατόν.
Μετά από κάθε αλλαγή, επιβεβαιώστε τη λειτουργία των παρακάτω:
- CI (Συνεχής Ενσωμάτωση).
- Docker builds.
- Έλεγχος Ασφαλείας (Security Audit).
- Ορθότητα Ροής Εργασιών (Workflow Sanity).
- Διαδικασία Έκδοσης (Release).
Σφάλμα προς παρακολούθηση: action is not allowed by policy.
Σε περίπτωση αυτού του σφάλματος, προσθέστε μόνο τη συγκεκριμένη έμπιστη ενέργεια και τεκμηριώστε την αλλαγή.
- 2026-02-21: Προσθήκη
Checkmarx/vorpal-reviewdog-github-action@*για στοχευμένους ελέγχους ασφαλείας. - 2026-02-26: Τυποποίηση cache Rust και Docker build actions.
- Προστέθηκε allowlist μοτίβο:
Swatinem/rust-cache@*. - Τα Docker build jobs χρησιμοποιούν
docker/setup-buildx-actionκαιdocker/build-push-action.
- Προστέθηκε allowlist μοτίβο:
- 2026-02-16: Προσθήκη
sigstore/cosign-installer@*για την υπογραφή εκδόσεων. - 2026-02-17: Αντικατάσταση του
cargo install cargo-auditμε την ενέργειαrustsec/audit-check@*.
Σε περίπτωση έκτακτης ανάγκης:
- Ορίστε προσωρινά την πολιτική σε
all. - Διορθώστε τη λίστα επιτρεπόμενων.
- Καταγράψτε το περιστατικό και την τελική λύση.