عادی GitHub ٹاسک انحصار سے کیسے بچیں۔

آپ کے ورک فلو میں: actions/checkout@v4. فی الحال، اس ٹیگ سے مراد ایک جائزہ شدہ ریلیز ہے۔ کل، ایک سمجھوتہ کرنے والا منتظم یا حملہ آور ٹیگ کو میلویئر میں منتقل کر دے گا۔ پائپ لائن اسے رسائی کے ساتھ چلاتی ہے: GITHUB_TOKEN.

تیسری پارٹی کام انحصار ہیں۔. فلوٹنگ ٹیگز ان پن شدہ پیکیج پر انحصار کی طرح برتاؤ کرتے ہیں۔ اگر حوالہ تبدیل ہوتا ہے، تو ورک فلو مخزن کو تبدیل کیے بغیر مختلف کوڈ چلا سکتا ہے۔

یہ مضمون دکھاتا ہے کہ کس طرح ایک عالمی کمٹ SHA پر آپریشنز کو پن کرکے، ان کے پنوں کو ریلیز ٹیگز کے خلاف درست کرکے، اجازت شدہ کارروائیوں کو محدود کرکے، اور Didabot کا استعمال کرتے ہوئے نظرثانی شدہ اپ ڈیٹس کو خودکار کرکے مسلسل انضمام (CI) انحصار سے کیسے بچنا ہے۔

یہ کس کے لیے ہے: پلیٹ فارم اور DevSecOps انجینئرز GitHub ایکشن کے ورک فلو کو محفوظ کر رہے ہیں۔

شرائط:

فوری حوالہ:

اسے کرنے کا طریقہ یہاں ہے:

  • مقررہ وقفہ uses: کا حوالہ مکمل کمٹ SHAیہ اس طرح کا موو ٹیگ نہیں ہے: @v4.

  • تصدیق کریں کہ ہر SHA ریکارڈ شدہ ریلیز سے میل کھاتا ہے جس کا آپ نے منظوری دینے سے پہلے جائزہ لیا تھا۔

  • برقرار رکھنا وائٹ لسٹ تنظیم یا ذخیرہ کی سطح پر اجازت دی گئی کارروائیوں کی تعداد۔

  • فعال کریں یہ منحصر ہے گٹ ہب ایکشن ورژن اعتدال کے ذریعے ٹکراتا ہے۔

  • آفیشل یا تصدیق شدہ تخلیق کاروں کو ترجیح دیں۔ اگر ضروری ہو تو اہم کاموں کو اندرونی طور پر آئینہ دیں۔

  • ضم کرنے سے پہلے پل کی درخواست کے معائنہ میں اپنے پنوں کو چیک کریں۔

انڈیکس

GitHub ایکشنز آپ کو برانچ کا نام، ورژن ٹیگ، یا کمٹ SHA کے ذریعے انحصار کا حوالہ دینے دیتا ہے۔ یہ حوالہ جات ایک ہی سطح کی وشوسنییتا فراہم نہیں کرتے ہیں۔ شاخیں کسی بھی وقت تبدیل ہو سکتی ہیں، اور آپ ورژن ٹیگز کا جائزہ لینے کے بعد ایک مختلف کمٹ پر جا سکتے ہیں۔ ایک کمٹ SHA ایک مخصوص نظرثانی کی نشاندہی کرتا ہے۔

نیچے دی گئی جدول عام حوالہ جات کے اندازوں کا موازنہ کرتی ہے اور یہ بتاتی ہے کہ ٹیگز منتقل کرنے سے سپلائی چین کے خطرات کیوں پیدا ہوتے ہیں۔

حوالہ انداز خطرہ
@main جب ورک فلو شروع ہوتا ہے، تو یہ برانچ میں تمام کوڈ چلاتا ہے۔
@v4 چونکہ ٹیگز منتقل ہو سکتے ہیں، ایک ہی لیبل مختلف کوڈ چلا سکتا ہے۔
@v4.2.1 مزید مخصوص لیکن پھر بھی تبدیل ہونے والے ٹیگز۔
@abc1234... (مکمل SHA) ایک عہد کی شناخت کریں جسے تبدیل نہیں کیا جاسکتا۔

پہلے تین حوالہ جات ناکام ہو جاتے ہیں کیونکہ ان کے نام مستقل طور پر اس کوڈ کی شناخت نہیں کرتے ہیں جسے GitHub عمل میں لائے گا۔ مکمل SHA اس خاص مسئلے کو صرف ورک فلو کو تبدیل کر کے حل کرتا ہے جب کوئی ریپوزٹری میں حوالہ تبدیل کرتا ہے۔

کلیدی خیال: CI پائپ لائنز درخواست کوڈ کی طرح انحصار کے نظم و ضبط کی مستحق ہیں۔

SHA کمٹ کے لیے پننگ آپریشنز

کسی کام کو پن کرنے کا مطلب ہے اس کی برانچ یا ورژن ٹیگ کو اس کمٹ کے مکمل SHA سے ​​تبدیل کرنا جس کا آپ نے جائزہ لیا ہے۔ GitHub پھر درست نظرثانی کو یقینی بناتا ہے، چاہے پبلشر بعد میں اصل ٹیگ کو منتقل کرے۔

یہ پہلی مثال ہے۔ برا اس کی وجہ یہ ہے کہ دونوں حوالہ جات تغیر پذیر ورژن کے ٹیگز استعمال کرتے ہیں۔ ورک فلو بعد میں ریپوزٹری میں متعلقہ تبدیلیوں کے بغیر دوسرے ٹاسک کوڈ کو چلا سکتا ہے۔

- uses: actions/checkout@v4
- uses: actions/setup-node@v4

یہ دوسری مثال ہے۔ اچھا اس کی وجہ یہ ہے کہ ہر حوالہ مکمل 40 حروف کی کمٹ SHA استعمال کرتا ہے۔ تبصرے ریلیز ورژن کو دیکھ بھال کرنے والوں کے ذریعہ پڑھنے کے قابل رکھتے ہیں، لیکن GitHub تبصروں کے بجائے SHA استعمال کرتا ہے۔

- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
- uses: actions/setup-node@4992456781334f2795ae9dd169f5041797d85689 # v4.4.0

ٹاسک کے GitHub ریلیز پیج پر SHA تلاش کریں، یا درج ذیل کریں:

gh api repos/actions/checkout/git/ref/tags/v4.2.2 --jq '.object.sha'

براہ کرم بالکل وہی ریلیز ٹیگز استعمال کریں جن کا آپ نے جائزہ لیا ہے۔ دیکھ بھال کے مقاصد کے لیے براہ کرم انسانی پڑھنے کے قابل ورژن میں تبصرے شامل کریں۔ تبصرے جائزہ لینے والوں کے لیے مددگار ہیں، لیکن ہمارے سیکیورٹی کنٹرولز کا حصہ نہیں ہیں۔ GitHub SHA کے ذریعہ شناخت شدہ کمٹ کو انجام دیتا ہے۔

مختصر SHA استعمال نہ کریں۔ ایک مکمل 40 حروف والا SHA حادثاتی تنازعات اور مبہم جائزوں کے امکانات کو کم کرتا ہے۔

SHA توثیق کا ارتکاب کریں۔

ایک مکمل SHA انضمام کے بعد آپ کے ورک فلو کو ٹیگ کی نقل و حرکت سے بچاتا ہے، لیکن پھر بھی آپ کو SHA کو منظور کرنے سے پہلے اس کی تصدیق کرنی ہوگی۔ آپ کو ریلیز ٹیگز اور کمٹ کا ایک ساتھ جائزہ لینا چاہیے۔ یہ چیک جائزہ شدہ ٹیگ کے پیچھے کمٹ کا موازنہ ورک فلو میں ریکارڈ کردہ کمٹ سے کرتا ہے۔

#!/usr/bin/env bash
set -euo pipefail

repository="actions/checkout"
release_tag="v4.2.2"
expected_sha="11bd71901bbe5b1630ceea73d27597364c9af683"

actual_sha="$({
  git ls-remote "https://github.com/${repository}.git" \
    "refs/tags/${release_tag}" "refs/tags/${release_tag}^{}"
} | awk -v tag="refs/tags/${release_tag}" '
  $2 == tag "^{}" { print $1; found = 1 }
  $2 == tag { fallback = $1 }
  END { if (!found) print fallback }
')"

if [[ "${actual_sha}" != "${expected_sha}" ]]; then
  printf 'SHA mismatch for %s %s\n' "${repository}" "${release_tag}" >&2
  printf 'Expected: %s\nActual:   %s\n' "${expected_sha}" "${actual_sha}" >&2
  exit 1
fi

printf 'Validated %s@%s\n' "${repository}" "${expected_sha}"

یہ ریلیز ریفرنس کی توثیق ہے، یہ دعویٰ نہیں کہ ذخیرہ پر بھروسہ کیا جا سکتا ہے۔ ورکنگ سورس کو پڑھیں، اس کی اجازتوں کا جائزہ لیں، اور نوٹ کریں کہ آپ نے انحصار کو کیوں منظور کیا۔ اعلی یقین دہانی والے ماحول کے لیے، اندرونی طور پر تنقیدی کارروائیوں کی عکس بندی کریں اور عام ریپوزٹری کنٹرولز کے ذریعے آئینہ دار نمونوں کی توثیق کریں۔

کاموں کے لیے منحصر بوٹس کو فعال کریں۔

انحصاریابوٹ GitHub کی خودکار انحصار اپ ڈیٹ سروس ہے۔ GitHub ایکشنز کے لیے، تازہ ترین ریلیز کے لیے ورک فلو کا حوالہ چیک کریں اور اسے اپ ڈیٹ کرنے کے لیے پل کی درخواست کھولیں۔ یہ پنوں کو دستی طور پر تبدیل کرنے یا فلوٹنگ ٹیگز استعمال کرنے کے بجائے ٹاسک اپ ڈیٹس کا معائنہ اور منظوری دینے کے لیے قابلِ جائزہ مقام فراہم کرتا ہے۔

بنانا .github/dependabot.yml:

version: 2
updates:
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    groups:
      actions:
        patterns:
          - "*"

اگر پن کی گئی SHA میں ایک نئی ریلیز ہے، تو سلیو بوٹ پل کی درخواست کھولتا ہے۔ درخواست کے انحصار کا جائزہ لیں اور انضمام کریں۔

ان اپ ڈیٹس کو خودکار طور پر ضم کرنے کے لیے اپنے منحصر بوٹ کو کنفیگر نہ کریں جب تک کہ کام کی تبدیلیوں کا جائزہ لینے کا عمل مکمل نہ ہو جائے۔ اپ ڈیٹس میں نئی ​​اجازتیں، تبدیل شدہ اسکرپٹس، یا نئے عبوری انحصار شامل ہو سکتے ہیں۔

ہر اپ ڈیٹ پل کی درخواست کے لیے، ہم پرانے اور نئے وعدوں کا موازنہ کرتے ہیں، کام کے ریلیز نوٹس کا معائنہ کرتے ہیں، اور تبدیلیوں کا جائزہ لیتے ہیں۔ action.yml جاوا اسکرپٹ بنڈل، شیل اسکرپٹ، اور ورک فلو کی اجازتیں۔ یقینی بنائیں کہ نئی کمٹ اس ریلیز سے تعلق رکھتی ہے جسے آپ اپنانا چاہتے ہیں۔ اگر آپ کا کام تعیناتی، اشاعت، اسناد، یا دیگر اعلیٰ اثر والے کاموں کو سنبھالتا ہے، تو ورک فلو کو ٹیسٹ ریپوزٹری یا ماحول میں چلائیں۔

مقصد تمام اپ ڈیٹس کو مسترد کرنا نہیں ہے۔ مقصد یہ ہے کہ اعتماد کے فیصلوں کو مرئی اور دہرایا جا سکے۔ ضم ہونے سے پہلے جائزہ لینے والوں کو تین سوالوں کے جواب دینے کے قابل ہونا چاہیے: کون سا کوڈ تبدیل ہوا ہے، نئے ورژن کی ضرورت کیوں ہے، اور اس کوڈ میں کون سی اجازتیں دستیاب ہیں۔

وائٹ لسٹ آپریشنز

ایکشن وائٹ لسٹ ایک ریپوزٹری یا تنظیم کی پالیسی ہے جو اس بات کو محدود کرتی ہے کہ کن پبلشرز اور ریپوزٹری ورک فلو کو کال کرنے کی اجازت ہے۔ اس امکان کو کم کرتا ہے کہ تعاون کنندگان نامعلوم یا غیر جائزہ شدہ کام کو بھروسہ مند پائپ لائن میں متعارف کرائیں گے۔

تنظیم کے منتظمین ترتیب دے سکتے ہیں: ترتیبات → آپریشنز → پالیسیاں → مخصوص کارروائیوں کی اجازت دیں۔. آپ کے ورک فلو سے مماثل تنگ ترین پالیسی منتخب کریں، پھر صرف وہی کام کے ذخیرے شامل کریں جن کا آپ کی ٹیم نے جائزہ لیا ہے۔

وائٹ لسٹ پیٹرن کی مثال:

actions/checkout@*
actions/setup-node@*
actions/cache@*
docker/*
my-org/*

اگر آپ اس پالیسی کو فعال کرتے ہیں، تو منظور شدہ نمونوں سے مماثل کارروائیوں کو مسترد کر دیا جائے گا۔ تنظیم کے تحت ریپوزٹریز تنظیم کے GitHub پلان اور مخزن کی ترتیبات پر مبنی پالیسیوں کو وراثت میں حاصل کرتی ہیں۔

تنظیم کی پالیسی کے بغیر واحد ذخیرہ کے لیے، استعمال کریں: ترتیبات → آپریشنز → جنرل → GitHub میں بنائے گئے کاموں کی اجازت دیں اور غیر GitHub کاموں کو منتخب کریں صرف تصدیق شدہ تخلیق کاروں تک محدود۔

وائٹ لسٹنگ ان ٹاسک IDs کو محدود کرتی ہے جو چل سکتی ہیں۔ یہ SHA پننگ کو تبدیل نہیں کرتا ہے۔ تمام ورک فلوز میں مکمل SHA کا جائزہ لینے کے لیے اجازت شدہ کارروائیوں کا حوالہ دیا جانا ضروری ہے۔

درخواستوں کو کھینچنے کے لیے پن لگائیں۔

اپنے CI پر ورک فلو لنٹر چلائیں اور ایک ریپوزٹری چیک شامل کریں جو اس وقت ناکام ہو جائے گا جب ورک فلو غیر SHA حوالہ متعارف کرائے گا۔ سکینر کو محفوظ ورک فلو میں استعمال کرنے سے پہلے اسے خود محفوظ کریں۔ نیچے دیے گئے پلیس ہولڈرز کو مکمل کمٹ SHA کے ساتھ تبدیل کریں جس کی آپ نے منتخب ایکشن لینٹ ریلیز کے لیے تصدیق کی ہے۔

name: actionlint

on:
  pull_request:

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
      - uses: rhysd/actionlint@03d0035246f3e81f36aed592ffb4bebf33a03106 # v1.7.7
        with:
          args: -color

ریلیز ٹیگز کو حل کریں، کمٹ کا جائزہ لیں، اور مکمل 40-حروف SHA ریکارڈ کریں۔ actions/checkout.

آپ عام فلوٹنگ حوالہ جات کو پکڑنے کے لیے ایک چھوٹا سا چیک بھی استعمال کر سکتے ہیں: اسے YAML پارسر یا مجموعی سپلائی چین پالیسی کے بجائے بیک اپ سگنل کے طور پر سمجھیں۔

      - name: Reject floating action tags
        run: |
          if grep -RInE '^[[:space:]]*-?[[:space:]]*uses:[[:space:]]*[^#]+@(main|master|v[0-9]+)([[:space:]]|$)' .github/workflows/; then
            echo "Floating action refs found. Pin to full SHA."
            exit 1
          fi

پل کی درخواستوں اور محفوظ شاخوں کے لیے چیک چلائے جائیں۔ پل کی درخواستیں اس ٹیسٹ کو پاس کر سکتی ہیں اور پھر بھی ان میں نقصان دہ کمٹ شامل ہیں، لہذا اسے اپنے کوڈ کے جائزے، وائٹ لسٹنگ، اور SHA کی توثیق کے عمل کے ساتھ جوڑیں۔

جانوروں کے ڈاکٹر کی طرف سے تیسری پارٹی کی کارروائی

اپنی اجازت کی فہرست میں کمیونٹی کی کارروائیاں شامل کرنے سے پہلے:

  1. ایکشن پڑھیں action.yml اور ان پٹ اسکرپٹ۔

  2. ستارے کی تاریخ، منتظم کی ساکھ، اور عوامی سلامتی کے مسائل کو چیک کریں۔

  3. SHA کو پن اور فورک کریں۔ my-org/action-name جب عمل اہم ہے لیکن بیرونی طور پر برقرار ہے۔

یہ ورک فلو کے لیے دستیاب اجازتوں کو بھی چیک کرتا ہے۔ وہ آپریشنز جو ریپوزٹری کے راز کو پڑھ سکتے ہیں یا ریلیز لکھ سکتے ہیں ان آپریشنز کے مقابلے میں زیادہ قریب سے تفتیش کے قابل ہیں جو صرف فائل کی قسم کی وضاحت کرتے ہیں۔ اپنے ورک فلو کی اعلیٰ سطح کی اجازتوں کو کم از کم ضروری سطح پر سیٹ کریں، پھر انفرادی کاموں کے لیے صرف ضروری ہونے پر اضافی اجازتیں دیں۔

کیسے چیک کریں کہ آیا یہ کام کرتا ہے۔

  1. ہم ہر اس آپریشن کے لیے SHA توثیق کا اسکرپٹ چلاتے ہیں جسے ہم منظور کرتے ہیں اور توقع کرتے ہیں کہ تمام موازنہ پاس ہو جائیں گے۔

  2. ٹاسک کو تبدیل کرتے ہوئے ایک ٹیسٹ پل کی درخواست کھولیں:@mainکلک کریں اور دیکھیں کہ آیا CI گیٹ ناکام ہو جاتا ہے۔

  3. فلوٹنگ ٹیگ کے بعد پیچھے آنے والا تبصرہ شامل کرنے کی کوشش کریں اور دیکھیں کہ آیا آپ کا تجزیہ کار یا لنٹر اب بھی اسے مسترد کرتا ہے۔

  4. یقینی بنائیں کہ آپ کی تنظیم کی پالیسیاں ایسی کارروائیوں کو روکتی ہیں جن کی آپ کے ٹیسٹنگ ورک فلو میں اجازت نہیں ہے۔

  5. Didabot ایک ٹاسک اپ ڈیٹ پل کی درخواست کھولتا ہے اور اس بات کو یقینی بناتا ہے کہ تبدیلیوں کا عام جائزہ لیا جائے۔

  6. اپنے ورک فلو پر عمل درآمد کی اجازتوں کا جائزہ لیں اور اس بات کو یقینی بنائیں کہ آپ کو ان اسناد تک رسائی نہیں ہے جن کے لیے کارروائی کی ضرورت نہیں ہے۔

اگر یہ ٹوٹ جائے۔

  1. فوری پیچ: SHA پننگ ہاٹ فکس کو سست کر دیتی ہے۔ Didabot کے ساتھ آن کال کا جائزہ فلوٹنگ ٹیگز استعمال کرنے سے عارضی طور پر زیادہ محفوظ ہے۔

  2. نجی ذخیروں پر کمپاؤنڈ آپریشنز: عوامی سرگرمیوں کی طرح اندرونی سرگرمیوں کو محفوظ بنائیں۔

  3. دوبارہ قابل استعمال ورک فلو: اینکر دوبارہ قابل استعمال ورک فلو SHA اور اس کے اندرونی مراحل کے حوالے۔

  4. تشریح شدہ ٹیگز اور آئینہ: SHA کو ریکارڈ کرنے سے پہلے، کمٹ کے ساتھ تشریح شدہ ٹیگز کی تصدیق کریں اور اپنے تبدیلی کے کنٹرول کے عمل کے ذریعے اندرونی عکس کی توثیق کریں۔

  5. تحفظ کا غلط احساس: یہاں تک کہ اگر آپ کوڈ کو پڑھے بغیر منجمد کر دیتے ہیں، تب بھی منجمد کے وقت دیکھ بھال کرنے والا اس پر بھروسہ کرتا ہے۔ پننگ کو وائٹ لسٹنگ، کم از کم استحقاق کی اجازتوں اور اعتدال کے ساتھ جوڑتا ہے۔

نتیجہ

اس ٹیوٹوریل میں، آپ نے سیکھا کہ GitHub ایکشنز کو نظرثانی شدہ کمٹ SHAs میں پن لگا کر، ان کے حوالہ جات کی توثیق کر کے، بھروسہ مند کارروائیوں کو وائٹ لسٹ کر کے، Didabot اپ ڈیٹس کو فعال کر کے، اور درخواست کے چیکس کو کھینچنے کے لیے پننگ کو لاگو کر کے ٹوٹے ہوئے CI انحصار کو کیسے روکا جائے۔

نتیجہ پرتوں والے کنٹرولز ہیں، بشمول جانچ شدہ ناقابل تغیر حوالہ جات، قابل اجازت آپریشنز کا ایک محدود سیٹ، خودکار اپ ڈیٹ کی تجاویز، اور ضم ہونے سے پہلے رجعت کو پکڑنے کے لیے پل کی درخواست کا معائنہ۔

حوالہ جات

اوپر تک سکرول کریں۔