📌 Hızlı Özet & Temel Çıkarım:
otonom deniz aracı (USV) ve benzeri öğrenci takımlarında güvenlik genelde “final haftası TODO” olarak kalır. Oysamain’e giren bir.env, sabit kodlanmış MQTT parolası veyashell=Trueile açılan komut, yarış alanında veya ortak VPS’te gerçek hasar üretir. Bu rehber; GitHub Actions ile hafif, tekrarlanabilir SAST + secret + bağımlılık taraması kurmayı anlatır — enterprise DevSecOps tiyatrosu değil, takımın gerçekten çalıştıracağı bir kapı.
Sahadan gelen sorun: “çalışıyor” yetmez
Yazılım geliştirme yaşam döngüsünde güvenlik açıklarını erkenden tespit etmek, OWASP Top 10 web ve sistem zafiyetleri karşısında en güçlü savunma hattıdır. Robotik repoda tipik manzara:
scripts/altındaos.system/subprocessile bag kaydı, mavlink köprüsü, Docker ayağa kaldırma.config/içinde birinin kişisel API anahtarı commit geçmişinde.- Python bağımlılıklarında yıllardır güncellenmeyen paketler.
- CI yok; herkes kendi makinesinde “bende çalışıyor” diyor.
SAST (Static Application Security Testing), kodu çalıştırmadan tehlikeli kalıpları arar. Dinamik test veya fuzz’ın yerine geçmez; ama PR aşamasında ucuz bir filtre sağlar. Shift-left’in öğrenci versiyonu: merge etmeden önce kırmızı ışık.
Ne taramalı, neyi bilerek dışarıda bırakmalı?
Üç katman yeter:
- Secret taraması — gitleaks / trufflehog: anahtar, token, private key.
- SAST — Semgrep veya Bandit: injection, insecure deserialization, tehlikeli API kullanımı.
- Bağımlılık / FS taraması — Trivy veya
pip-audit: bilinen CVE’ler.
Bilerek dışarıda bıraktıklarım (ilk iterasyonda):
- Tam OWASP enterprise policy seti (gürültü yüksek, takım ignore’a alışır).
- Container imaj imzalama (önce Dockerfile hardening; sonra supply chain).
- Her finding’de pipeline fail (önce CRITICAL, sonra sıkılaştır).
Minimal GitHub Actions iskeleti
.github/workflows/security.yml:
name: security-gate
on:
pull_request:
push:
branches: [main, humble-devel]
permissions:
contents: read
security-events: write
jobs:
secrets:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: gitleaks/gitleaks-action@v2
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
sast:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: semgrep/semgrep-action@v1
with:
config: |
p/python
p/security-audit
p/owasp-top-ten
deps:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Trivy filesystem scan
uses: aquasecurity/trivy-action@0.28.0
with:
scan-type: fs
severity: CRITICAL,HIGH
exit-code: "1"
ignore-unfixed: true
Notlar:
fetch-depth: 0secret taramasının history’de gezmesi için.- Trivy’de
ignore-unfixed: trueile henüz yaması olmayan gürültüyü azaltırsınız; risk bilincini kaybetmeyin, sadece gate’i yaşatın. - Action sürümlerini
@masteryerine pin’leyin; supply chain için ironik bir açık bırakmayın.
ROS / Python tarafında Semgrep’in yakaladığı gerçekler
Örnek tehlikeli kalıp (sık görülür):
# kötü: kullanıcıdan gelen topic/arg shell'e gidiyor
import subprocess
bag_name = request.args["bag"]
subprocess.run(f"ros2 bag play {bag_name}", shell=True)
Daha güvenli yaklaşım:
import subprocess
from pathlib import PurePosixPath
bag_name = PurePosixPath(request.args["bag"]).name # path traversal kırp
subprocess.run(
["ros2", "bag", "play", bag_name],
check=True,
shell=False,
)
Semgrep shell=True ve bazı eval / pickle.loads kalıplarını işaretler. Takım içi kural da ekleyebilirsiniz — örneğin paramiko ile hard-coded host key doğrulamasını kapatmayı yasaklamak.
semgrep.yml (opsiyonel özel kural özeti):
rules:
- id: no-shell-true-in-scripts
patterns:
- pattern: subprocess.$FN(..., shell=True, ...)
message: "shell=True kullanma; argüman listesi geç"
languages: [python]
severity: ERROR
paths:
include:
- scripts/
- src/
Branch koruması olmadan CI tiyatrodur
Workflow yeşil/kırmızı olsa bile main’e force push açıksa kapı yoktur. GitHub’da:
mainiçin required checks:secrets,sast,deps- Direct push kapalı; PR zorunlu
- En az bir reviewer (takımda 2–3 yazılım üyesi varsa)
otonom sistem ve robotik projeleri tempo döneminde “acil merge” baskısı olur. O an için continue-on-error: true ile job’ı bilgilendirici moda almak yerine, severity’yi düşürmek daha dürüst bir çözümdür: CRITICAL fail, MEDIUM comment.
Yerelde de aynı kapı: pre-commit
CI’ya güvenip local’de kör gitmek zaman kaybettirir. .pre-commit-config.yaml örneği:
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.21.2
hooks:
- id: gitleaks
- repo: https://github.com/astral-sh/ruff-pre-commit
rev: v0.8.0
hooks:
- id: ruff
args: [--select, "S", --fix]
Ruff’un S (flake8-bandit) kuralları Python güvenlik kokularını saniyeler içinde verir. Semgrep’i her commit’te koşturmak ağır olabilir; PR’da Semgrep, local’de Ruff+gitleaks dengesi iyi çalışır.
False positive ile baş etme
İlk hafta pipeline kırmızı yanacak. Yanlış pozitifleri iki yolla yönetin:
- Suppress with reason — Semgrep
nosemgrepveya# noqa: S603yanına kısa gerekçe. - Baseline — mevcut borç için
trivy/ Semgrep baseline dosyası; yeni finding’ler fail etsin.
“Ignore forever” listesi büyüyorsa takım aslında taramayı kapatmış demektir. Ayda bir ignore listesini gözden geçirin; robotik repoda scripts/legacy_ altına itilen kod çoğu zaman unutulur ve yarış öncesi geri döner.
Container ve firmware notu
Birçok USV reposu hem Python hem Dockerfile hem de gömülü araç zinciri taşır. İlk CI turunda:
- Rootfs /
.img/ büyük bag dosyalarınıpaths-ignoreveya Git LFS ile ayırın; taramayı şişirmesin. - Dockerfile için ayrı job:
trivy image(imaj build edilebiliyorsa). - Gizli anahtarları GitHub Actions secrets + runtime inject;
COLCON_IGNOREyanına.pemkoymayın.
Ölçülebilir başarı kriteri
“Güvenli olduk” iddiası yerine şunu hedefleyin:
- 30 gün içinde
main’e secrets finding sıfır. - Yeni PR’larda CRITICAL SAST finding merge edilemiyor.
- Bağımlılık HIGH/CRITICAL için ya güncelleme PR’si ya da risk kabul kaydı (issue + owner).
Bu üç madde, öğrenci takımında sürdürülebilir DevSecOps tanımıdır. Sonraki adım fuzz / chaos testleri olabilir; ama kapı olmadan kaos testi sadece kırılmayı belgelemek olur.
Yarış temposunda pipeline’ı yaşatmak
Robotik veya dönem projesi yetişme baskısında ilk ölen şey genelde kalite kapısıdır: “şimdilik required check’i kaldır, yarın bakarız.” Yarın gelmez. Bunun yerine yarış öncesi iki haftalık bir policy freeze tanımlayın: yeni MEDIUM kural eklemeyin, mevcut CRITICAL gate’i bozmayın, yalnızca hotfix branch’lerinde geçici exception issue açın ve owner yazın.
Exception’ın süresi bitiş tarihi olmadan açılması, ignore listesinin şişmesinin en hızlı yoludur. Ben takım chat’ine şunu yapıştırıyorum: “Exception issue numarası yoksa merge yok.” Soft kural gibi durur; iki sprint sonra soft kuralın fiilen hard olduğunu herkes anlar.
Monorepo kullanıyorsanız path filtreleri hayat kurtarır. Dokümantasyon-only PR’larda Trivy FS taramanın tamamını koşturmak hem dakika hem moral yer. paths / paths-ignore ile docs/** ve *.md değişikliklerini security job’dan ayırın; kod ve lockfile değişince tam tarama gelsin. Bu ayrım “CI yavaş” şikayetini yarıya indirir.
Secret sızdıktan sonra ne yapılır?
gitleaks geçmiş commit’te bir AWS veya MQTT anahtarı bulursa pipeline’ı yeşile boyamak yetmez. Sıra:
- Anahtarı sağlayıcıda hemen revoke / rotate edin.
- Yerine yenisini Actions secret veya sunucu env olarak koyun.
- Git history temizliği (
filter-repo) ayrı bir karar; public fork’lar eski commit’i çoktan çekmiş olabilir. Rotate birincil, history rewrite ikincildir. - Kısa bir postmortem: anahtar neden repo’ya girdi, pre-commit neden yoktu, kim bilgilendirildi?
Öğrenci takımlarında utanç reflekssi “sessizce silip push –force” olur. Sessizlik, aynı anahtarın Discord yedeğinde kalmasına engel olmaz. Rotate + yazılı not, utançtan ucuzdur.
Sonuç
CI’da SAST, robotik ve ders projelerinde lüks değil; paylaşılan VPS, ortak Jetson ve public GitHub yüzeyi için asgari hijyendir. Semgrep + gitleaks + Trivy üçlüsü, bir afternoon’da ayağa kalkar. Asıl iş kültürdedir: kırmızı pipeline’ı “CI bozuk” diye bypass etmek yerine finding’i okuyup düzeltmek. Kod sahaya inmeden önce statik kapıdan geçsin — denizde debug, IDE’deki kırmızıdan pahalıdır.
Bu alanda daha derin bir perspektif için ilgili rehberimize göz atabilirsiniz.
📌 Sonraki Rehber: OWASP Top 10 Web Güvenlik Zafiyetleri ve Savunma Stratejileri Web uygulama katmanındaki en kritik güvenlik açıklarını ve modern savunma prensiplerini inceleyin.