Bitbucket

Yalnızca Bitbucket Cloud desteklenir; AppArch api.bitbucket.org ile konuşur. Bitbucket Data Center / Server desteklenmez.

Bitbucket iki tür kimlik bilgisi kabul eder. App password seçeneği yoktur: Atlassian bunları kaldırdı.

Seçenek 1: OAuth istemcisi

1. Kimlik bilgileri → Bağlantı ekle → Bitbucket → Uygulama tanımla.
2. Bitbucket’ta workspace’inizin Workspace settings → OAuth clients → Create OAuth client sayfasını açın.
3. Authorization sekmesinde sihirbazın gösterdiği Callback URL’yi birebir yapıştırın.
4. Scopes sekmesinde şunları verin: Account, Repositories, Pull requests, Webhooks. Sihirbaz ayrıca Pipelines: Read and write ister; AppArch bunu runner’ın Pipelines değişkenlerini denetlemek ve yazmak için kullanır.
5. İstemcinin Client ID ve Secret değerlerini sihirbaza yapıştırıp kaydedin. Workspace slug’ı isteğe bağlıdır.
6. Yetkilendirmeyi kimlik bilgisindeki Bitbucket ile bağlan düğmesiyle tamamlayın.

Bu akışla alınan Bitbucket erişim token’ları yaklaşık iki saat yaşar. AppArch bunları saklanan refresh token ile otomatik yeniler.

Seçenek 2: Erişim token’ı

1. Kimlik bilgileri → Bağlantı ekle → Bitbucket → Erişim token’ı.
2. Bitbucket’ta repository ve pullrequest izinli bir workspace veya depo erişim token’ı oluşturun.
3. Sihirbaza yapıştırın. Workspace slug’ı isteğe bağlıdır.

Token saklanmadan önce AppArch neler yapabileceğini okur. Depo okuma yetkisi olmayan token reddedilir; pull request yazma yetkisi olmayan token salt okunur uyarısıyla kabul edilir (ArchPilot yorumu olmaz). AppArch erişim token’ını hiçbir zaman yenilemez.

Ne sağlar?

• ArchPilot pull request’lere yorum yazar.
• CI çalışmalarından gelen ArchScan / ArchSecurity sonuçları panelde görünür.

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 pull request çalışmasını Bitbucket’ın BITBUCKET_PR_ID değişkeninden tanır.