Keamanan

Postur keamanan Apothem dibangun di atas lima pilar: pengerasan rantai pasok, respons kerentanan, proteksi branch, penandatanganan rilis, dan analisis keamanan berkelanjutan. Bagian ini mendokumentasikan setiap permukaan.

Model ancamanCopy Anchor Link

Apothem adalah materializer konfigurasi. Apothem membaca profil bersama dan menulis berkas konfigurasi native-harness ke dalam direktori yang dibaca oleh setiap harness. Fungsi tunggal itu membatasi apa yang dipercayainya dan apa yang tidak.

• Apa yang dipercayai Apothem. Profil bersama yang Anda tulis dan pohon sumber terbundel yang ditempatkan oleh pemasang. Profil adalah niat yang Anda deklarasikan; mesin memperlakukannya sebagai masukan otoritatif setelah validasi skema.
• Apa yang tidak dipercayai Apothem. Isi profil mencapai sistem berkas hanya setelah validasi: kegagalan skema, ID harness yang tidak dikenal, jalur proyek yang tidak aman, sumber manifest yang hilang, traversal target, dan penyeberangan symlink semuanya berhenti sebelum penulisan apa pun dan mengembalikan diagnostik terstruktur dengan files_written: [].
• Apa yang tidak pernah dibawa keluaran termaterialisasi. Tidak ada rahasia. Diagnostik profil meredaksi kunci yang menyerupai rahasia dan nilai berbentuk token sebelum mencapai keluaran teks polos, JSON, log, cuplikan dokumentasi, atau pengujian, dan contoh publik menggunakan identitas dan domain placeholder palsu. Konfigurasi termaterialisasi dimaksudkan untuk di-commit dan dibagikan; konfigurasi itu tidak membawa kredensial.
• Lantai penolakan universal. settings.json Claude Code yang dimaterialisasikan Apothem membawa lantai penolakan yang tidak dapat ditawar, terlepas dari daftar-izin per-harness mana pun; pada harness lain, lantai yang sama berupa teks kebijakan dalam aturan yang dimaterialisasikan, bukan daftar penolakan tingkat-pengaturan — mencakup jalur rahasia (.env*, ~/.ssh/**, penyimpanan kredensial), operasi shell destruktif (rm -rf, sudo, force-push ke cabang terproteksi), dan eksekusi masukan yang tidak tepercaya. Tidak ada daftar-izin yang diam-diam memperluas lantai ini.
• Radius dampak. Penulisan dibatasi pada direktori harness dan pohon pendukung milik Apothem. Target terkelola yang ada dicadangkan sebelum penggantian dan direktori penemuan bersama digabungkan anak demi anak, sehingga berkas tak terkait yang ditulis operator tetap di tempatnya.

Postur keselamatan runtimeCopy Anchor Link

Perintah siklus hidup harness dan penulisan profil memvalidasi sebelum menulis. Kegagalan skema profil, ID harness yang tidak dikenal, jalur proyek yang tidak aman, sumber manifest yang hilang, traversal target, dan penyeberangan symlink berhenti sebelum penulisan sistem berkas dan mengembalikan diagnostik terstruktur dengan files_written: [].

Operasi pemasangan dan pembaruan mempertahankan target terkelola yang ada dengan mencadangkannya sebelum penggantian. Direktori penemuan bersama digabungkan anak demi anak sehingga berkas tak terkait yang ditulis operator tetap di tempatnya. --dry-run melakukan validasi yang sama dan melaporkan hasil yang direncanakan tanpa membuat direktori atau berkas.

Diagnostik profil meredaksi kunci yang menyerupai rahasia dan nilai berbentuk token sebelum mencapai keluaran teks polos, keluaran JSON, log, cuplikan dokumentasi, atau pengujian. Contoh publik menggunakan identitas dan domain placeholder palsu.

Tautan cepatCopy Anchor Link

• Postur OpenSSF Scorecard — bukti per pemeriksaan dan batasan platform yang diketahui
• Audit webhook — bukti higiene rahasia webhook
• Proteksi branch — persyaratan pull request, pemeriksaan status yang diwajibkan, serta pemblokiran force-push dan penghapusan
• Sapuan artefak biner — bukti bahwa pohon sumber tidak memuat berkas biner
• Kebijakan keamanan — pelaporan kerentanan & versi yang didukung
• Lencana OpenSSF Scorecard — skor langsung

Melaporkan kerentananCopy Anchor Link

Gunakan Pelaporan Kerentanan Privat pada tab Security repositori. Kebijakan lengkap, matriks versi yang didukung, dan lini masa respons ada di SECURITY.md.

Bukti pendukung rilis rantai pasokCopy Anchor Link

Setiap artefak rilis disertai:

• Provenance build SLSA-3 melalui slsa-framework/slsa-github-generator
• Tanda tangan Sigstore melalui sigstore/cosign-installer
• SBOM CycloneDX dari wheel dan sdist yang dirilis, ditulis oleh scripts/release/generate_sbom.py: paket apothem, setiap paket yang di-vendor di bawah apothem/_vendor beserta lisensinya, persyaratan runtime yang dideklarasikan, dan SHA-256 setiap distribusi. SBOM ditandatangani dan dicakup oleh provenance build seperti halnya distribusi
• Pernyataan provenance npm melalui OIDC Trusted Publishing pada @ahmed-g-gad/apothem
• Tag git bertanda tangan GPG (kunci EDDSA 70396FED9C634163)

Verifikasi rilisCopy Anchor Link

Unduh setiap aset dari sebuah rilis ke direktori kosong, lalu periksa tanda tangan dan provenance build. Ganti vX.Y.Z dan X.Y.Z dengan rilis yang Anda unduh.

gh release download vX.Y.Z --repo ahmed-g-gad/apothem
cosign verify-blob \
  --bundle apothem-X.Y.Z-py3-none-any.whl.cosign.bundle \
  --certificate-identity https://github.com/Ahmed-G-Gad/apothem/.github/workflows/release.yml@refs/tags/vX.Y.Z \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  apothem-X.Y.Z-py3-none-any.whl
slsa-verifier verify-artifact \
  --provenance-path provenance.intoto.jsonl \
  --source-uri github.com/Ahmed-G-Gad/apothem \
  --source-tag vX.Y.Z \
  apothem-X.Y.Z-py3-none-any.whl apothem-X.Y.Z.tar.gz

cosign mencetak Verified OK dan slsa-verifier mencetak PASSED: SLSA verification passed. Ulangi perintah cosign untuk aset lain mana pun dengan <asset>.cosign.bundle-nya (rilis sebelumnya menamai bundel arsip platform dan SHA256SUMS sebagai <asset>.sig). Arsip darwin dan linux adalah byte yang sama dengan dua nama, sehingga SHA256SUMS mencantumkan satu digest dua kali. Dari sebuah klon, bash scripts/release/verify-provenance.sh <download-dir> menjalankan ketiga pemeriksaan, termasuk manifest SHA256SUMS, dalam satu pass.

Dua detail menentukan apakah verifikasi bermakna:

• Huruf besar-kecil pemilik. Pemeriksaan identitas peka huruf besar-kecil, dan sertifikat membawa pemilik sebagaimana dilaporkan GitHub: Ahmed-G-Gad. Pemilik dengan huruf kecil gagal di kedua alat.

• Identitas persis. Utamakan --certificate-identity dengan subjek lengkap di atas. Untuk menerima tag rilis apa pun, jangkarkan pola di kedua ujungnya:

  Copy Text

  --certificate-identity-regexp '^https://github\.com/Ahmed-G-Gad/apothem/\.github/workflows/release\.yml@refs/tags/v[0-9]+\.[0-9]+\.[0-9]+$'

  Pola tanpa jangkar seperti github.com/Ahmed-G-Gad/apothem juga cocok dengan subjek palsu yang hanya memuat teks tersebut, misalnya alur kerja di repositori lain pada branch yang dinamai menurut repositori ini.

Runbook siklus rilis mencatat perintah yang sama sebagai pemeriksaan pascarilis pemelihara.

Bangun ulang rilis dan bandingkanCopy Anchor Link

Wheel dan sdist dapat direproduksi: membangun ulang tag dengan toolchain rilis menghasilkan digest SHA-256 yang dipublikasikan. Gunakan Python 3.12 di Linux, seperti yang dilakukan rilis:

git clone https://github.com/ahmed-g-gad/apothem && cd apothem
git checkout vX.Y.Z
python3.12 -m venv .build && . .build/bin/activate
pip install --require-hashes -r scripts/release/requirements-build-linux.txt
export SOURCE_DATE_EPOCH="$(git log -1 --pretty=%ct)"
python -m build --no-isolation
python scripts/release/normalize_sdist.py dist/*.tar.gz
sha256sum dist/*

Bandingkan digest tersebut dengan wheel dan sdist yang dipublikasikan. Build menggunakan setuptools yang dikunci-hash yang dipatok pyproject.toml, dan normalize_sdist.py menghapus waktu build, pemilik berkas, dan cap waktu checkout dari sdist.