تخطَّ إلى المحتوى
AppArch AppArch Docs

Bitbucket

يُدعم Bitbucket Cloud فقط - يتواصل AppArch مع api.bitbucket.org. لا يُدعم Bitbucket Data Center / Server.

يقبل Bitbucket نوعين من بيانات الاعتماد. لا تُعرض كلمات مرور التطبيقات: فقد أوقفتها Atlassian.

الخيار 1: عميل OAuth

Section titled “الخيار 1: عميل OAuth”
  1. Credentials ← Add credential ← Bitbucket ← Register an application.
  2. في Bitbucket افتح Workspace settings ← OAuth clients ← Create OAuth client لمساحة العمل.
  3. في تبويب Authorization الصق عنوان Callback URL الذي يعرضه المعالج كما هو تمامًا.
  4. في تبويب Scopes امنح: Account وRepositories وPull requests وWebhooks. يطلب المعالج أيضًا Pipelines: Read and write، ويستخدمه AppArch للتحقق من متغيّرات Pipelines الخاصة بالـ runner وكتابتها.
  5. انسخ Client ID وSecret إلى المعالج واحفظ. معرّف مساحة العمل (slug) اختياري.
  6. أكمل التفويض بزر Connect with Bitbucket على بيانات الاعتماد.

تعيش رموز الوصول الناتجة عن هذا المسار نحو ساعتين، ويجدّدها AppArch تلقائيًا برمز التحديث المخزّن.

الخيار 2: رمز وصول

Section titled “الخيار 2: رمز وصول”
  1. Credentials ← Add credential ← Bitbucket ← Access token.
  2. في Bitbucket أنشئ رمز وصول لمساحة العمل أو للمستودع بصلاحيتَي repository وpullrequest.
  3. الصقه في المعالج. معرّف مساحة العمل اختياري.

قبل تخزين الرمز يقرأ AppArch ما يُسمح له به. يُرفض الرمز الذي لا يقرأ المستودعات؛ ويُقبل الرمز الذي لا يكتب على طلبات السحب مع تحذير “قراءة فقط” (بلا تعليقات ArchPilot). لا يجدّد AppArch رمز الوصول أبدًا.

ما الذي يتيحه

Section titled “ما الذي يتيحه”
  • يعلّق ArchPilot على طلبات السحب.
  • تظهر نتائج ArchScan / ArchSecurity من تشغيلات CI في اللوحة.

CI (Bitbucket Pipelines)

Section titled “CI (Bitbucket Pipelines)”
pipelines:
  pull-requests:
    '**':
      - step:
          image:
            name: hub.apparch.io/collectors/dotnet:latest
            username: $APPARCH_INSTALLATION_ID
            password: $APPARCH_INSTALLATION_KEY
            run-as-user: 0   # the clone belongs to root; a PR run fetches the target branch into it
          script:
            - export APPARCH_Collector__Token="$APPARCH_TOKEN"
            - export APPARCH_Collector__ApiUrl="https://api.yourdomain.com"
            - apparch "$BITBUCKET_CLONE_DIR"

يتعرّف الـ runner على تشغيل طلب السحب من متغيّر Bitbucket BITBUCKET_PR_ID.