v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:08:00.000Z▲ 0 upvotes

Секреты в репозитории: gitleaks в pre-commit и CI и что делать при утечке

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Кілт әлдеқашан ағып кеткен болса, алдымен мынаны орындаңыз

Әрекеттердің реті құралдардан маңыздырақ, сондықтан соңынан бастайық.

  1. 1.Кілтті провайдерден қайтарып алыңыз және қайта шығарыңыз. Тарихты және талдауды өшірмес бұрын дереу. Қоғамдық репозиторийлер үнемі боттар арқылы сканерленеді және жалпыға ортақ міндеттемеде аяқталатын кілт итерілген сәттен бастап бұзылған деп есептелуі керек.
  2. 2.Барлық орталардағы кілтті жаңартыңыз (CI құпиялары, хостинг айнымалылары, құпиялар менеджері) және қызметтерді қайта іске қосыңыз.
  3. 3.Кілтті пайдалану журналын провайдеріңізбен тексеріңіз: бейтаныс мекенжайлардан келетін қоңыраулар, ерекше көлемдер, жасалған ресурстар. Бұлттық кілттер үшін - жаңа даналар және IAM пайдаланушылары.
  4. 4.Одан кейін ғана тарихты тазарту-тазарту туралы шешім қабылдаңыз. Сіз оны git filter-repo арқылы қайта жаза аласыз, бірақ клондарды, шанышқыларды, CI кэштерін және айна қызметтерінің көшірмелерін басқара алмайсыз. Тарихтан шығару ағып кетуді жою туралы емес, гигиена туралы. Егер кілт қайтарылып алынса, ол қай жерде болса да зиянсыз.

Жалпы қателік - файлды жаңа міндеттемемен жою және мәселені шешілген деп санау. Мән тарихта қалады және бір пәрмен git log -p арқылы табылады.

Алдын алу: жергілікті gitleaks

gitleaks ережелер жинағына сәйкес белгілі қызметтердің кілттеріне және жоғары энтропия мәндеріне ұқсас жолдар үшін код пен тарихтан іздейді. Алдын ала тапсыру шеңбері арқылы қосылу:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/gitleaks/gitleaks
    rev: v8.30.1   # конкретный тег; pre-commit autoupdate обновит его
    hooks:
      - id: gitleaks
pip install pre-commit      # или brew install pre-commit
pre-commit install          # ставит хук в .git/hooks
pre-commit run gitleaks --all-files

Ілмек тек сіз жасаған нәрсені тексереді, сондықтан ол жылдам. Бірақ бұл жергілікті: pre-commit install іске қосылмаған әріптесте ол жоқ және git commit --no-verify арқылы өшірілген. Сондықтан алдын ала міндеттеу әзірлеушіге ыңғайлылық болып табылады, ал нақты кедергі CI-де тексеру болып табылады.

Бар репозиторийдің бүкіл тарихын бір реттік тексеру (8.19 және одан кейінгі нұсқаларында пәрмендер git және dir деп аталады; ескі detect және protect үйлесімділік үшін сақталады):

gitleaks git --redact -v .

--redact жалаушасы табылған мәндерді шығыста жасырады - онсыз есептің өзі билетке көшірілген жағдайда ағып кетеді.

CI ішіндегі валидация

# .github/workflows/secrets.yml
name: secrets
on: [pull_request, push]
permissions:
  contents: read
jobs:
  gitleaks:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0       # полная история, иначе проверяется только последний коммит
      - uses: gitleaks/gitleaks-action@v2
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Ұйымдық репозиторийлер үшін gitleaks-action айнымалы GITLEAKS_LICENSE лицензиялық кілтін (тегін, сұрау бойынша қолжетімді) қажет етеді. Кілтсіз балама екілік жүйенің өзін немесе gitleaks Docker кескінін run қадамында іске қосу болып табылады.

Бұл тапсырманы филиалды қорғау ережелерінде міндетті тексеруге айналдырыңыз. Содан кейін жергілікті жерде ашылған құпия PR-да, тіпті негізгі филиалға жеткенше тоқтайды.

Жалған позитивтер

Сынақ құрылғылары, құжаттамадағы мысал кілттері және құлыптау файлдарындағы хэштер кейде құпияға ұқсайды. Опциялар:

  • Жолдағы gitleaks:allow түсініктемесі шолуда көрінетін мақсатты ерекшелік болып табылады.
  • Есептің нақты нәтижелерінің саусақ іздері бар .gitleaksignore файлы.
  • Меншік .gitleaks.toml, стандартты ережелерді кеңейту және жолдар бойындағы ерекшеліктерді орнату.

config/ сияқты толық каталогтарды алып тастамаңыз - құпиялар сонда аяқталады.

GitHub push қорғанысы

GitHub-да белгілі таңбалауыш пішімдері үшін push блоктауы бар кірістірілген құпия сканерлеу бар. Ол ақылы GitHub құпия қорғанысының бөлігі ретінде қоғамдық репозиторийлер үшін және жеке репозиторийлер үшін ақысыз қол жетімді. Ол gitleaks-ті толықтырады: ол сервер жағында жұмыс істейді және жалауша жіберіп алмайды, бірақ ол тек GitHub серіктестерінің пішімдерін біледі және сіздің жеке құпияларыңызды көрмейді.

Негізінде ағып кетуді қалай болдырмауға болады

  • .env* бірінші тапсырмадан .gitignore ішінде, репозиторийде бос мәндері бар тек .env.example бар.
  • Ең аз құқықтары бар және әрбір орта үшін бөлек кілттер: сынақ кілтінің ағып кетуі өндірісті ашпауы керек.
  • CI құпиялары - кірістірілген құпиялар дүкені арқылы, ешқашан YAML-де емес.
  • Журналдарға назар аударыңыз: құрастыруды жөндеу кезінде басып шығарылған ортаның айнымалы мәндері CI журналдарында қалады.

Не істеуге болмайды

  • Жасалмас бұрын base64 кілтін «шифрламаңыз». Сканерлер мұны әрқашан ұстай алмайды, бірақ шабуылдаушы оны секундта декодтайды.
  • Кілтті біреу пайдаланғаны анық болғанша айналдыруды кейінге қалдырмаңыз. Түсіндіру сағаттарды алады, айналдыру минуттарды алады.
  • Ортақ ағынның тарихын үнсіз қайта жазбаңыз. Жергілікті көшірмелері бар әріптестер келесі түрту арқылы ескі міндеттемелерді қайтарады; келісіп, репозиторийді қайта клондауды сұраңыз.

Обсуждение (0)

Ещё на vbcd4u.com