- Ana sayfa
- Dokümantasyon
- Git izinleri ve kapsamları
Git izinleri ve kapsamları
Son güncelleme
AI CodeOps'un GitHub, GitLab, Bitbucket, Gitea ve Forgejo'da istediği OAuth kapsamları ve token izinleri, her birinin ne için kullanıldığı ve erişimin nasıl iptal edileceği.
AI CodeOps, repolarınıza Configure → Settings → Git Providers altında kurduğunuz bir Git bağlantısı üzerinden ulaşır. Bu sayfa her bağlantının tam olarak ne istediğini, AI CodeOps'un onunla ne yaptığını ve erişimin nasıl geri alınacağını listeler.
AI CodeOps bir bağlantıyla neler yapar
Token'ınızla AI CodeOps:
- hangi hesabın bağlı olduğunu göstermek ve bağladığınızda token'ı kontrol etmek için kullanıcı profilinizi okur;
- erişebildiğiniz repoları branch'leri, dosyaları, commit'leri ve pull request'leriyle birlikte listeler ve arar (Develop → Repositories);
- bir oturumun üzerinde çalışabilmesi için projenin reposunu klonlar;
codeops/run-<id>adlı bir branch'i push eder ve projenin varsayılan branch'ine bir pull request açar;- konsoldan merge ettiğinizde bir pull request'i merge eder.
Repo oluşturmaz ve pull request'lere yorum yazmaz; oturumlar da webhook kaydetmez ve commit durumu göndermez. Build & Test → Builds altında bağladığınız bir repo bunun istisnasıdır: bir push veya pull request'in build başlatabilmesi için bir webhook, her build'in sonucuyla birlikte de bir commit durumu alır.
Platforma göre OAuth kapsamları
OAuth ile bağlanmak için bir platformun kartında Connect (GitLab'de Connect via OAuth) düğmesini seçin.
| Platform | İstenen kapsamlar | Ne için |
|---|---|---|
| GitHub | repo, read:user, user:email | repo: özel olanlar dahil repolarınızı okuma ve yazma; klonlamak, branch push etmek ve pull request açıp merge etmek için. read:user: bağlı hesabı göstermek. user:email istenir ama bağlantı tarafından kullanılmaz. |
| GitLab | api, read_user | api: repoları okuma, branch push etme, merge request açma ve merge etme. read_user: bağlı hesabı göstermek. |
| Bitbucket | Platformun OAuth consumer'ı tarafından belirlenir | Bitbucket bunları kendi onay ekranında listeler. Yukarıdakilerle aynı işlemler için kullanılırlar. |
| Gitea, Forgejo | İstekte yok | Sunucunun OAuth uygulaması için varsayılanı geçerlidir. |
GitHub için bir GitHub App değil, bir OAuth uygulaması kullanılır. GitLab, Gitea ve Forgejo için OAuth yalnızca platformun OAuth uygulamasının kayıtlı olduğu sunucuyla çalışır (GitLab için GitLab.com). Başka her sunucu için token ile bağlanın: kart, OAuth'u yalnızca çalışabildiği yerde sunar.
Kişisel erişim token'ları
Her platformun kartında bir token alanı vardır: or access token (GitHub ve Bitbucket'ta or access token (no OAuth app)). Bir token yapıştırın ve Connect with token düğmesini seçin.
Kendi sunucunuzdaki GitLab, Gitea ve Forgejo için Instance URL alanını da doldurun. Bu, sunucunun herkese açık https adresi olmalıdır. Platform operatörü o sunucuya izin vermedikçe özel ağ adresleri ve localhost reddedilir.
Token'ın profilinizi okuyabilmesi, repoları okuyabilmesi, branch push edebilmesi ve pull request oluşturup merge edebilmesi gerekir:
| Platform | Token izinleri |
|---|---|
| GitHub | repo kapsamına sahip bir classic token veya Contents ve Pull requests izinleri okuma ve yazma olarak ayarlanmış bir fine-grained token. |
| GitLab | api kapsamına sahip bir kişisel, proje veya grup erişim token'ı. Proje ve grup token'ları için Developer rolü veya daha üstü gerekir. |
| Gitea, Forgejo | repository üzerinde okuma ve yazma, user üzerinde okuma. |
| Bitbucket | Bir Bearer token olarak gönderilir. Yanında kullanıcı adı gerektiren token'lar çalışmaz; bunun yerine OAuth ile bağlanın. |
Bağlandığınızda AI CodeOps token'ı profilinizi okuyarak kontrol eder. Bu başarısız olursa mesaj nedenini söyler: platform token'ı tanımadı, token'ın hesabınızı okuma izni yok veya adreste hiçbir API yanıt vermedi. O sırada token'ın diğer kapsamlarını kontrol etmez; dolayısıyla fazla dar bir token bağlanır, ardından bir oturum push etmeye veya pull request açmaya çalıştığında başarısız olur. Bir projedeki Verify access düğmesi bunu tek bir repo için kontrol eder.
Token'lar yenilenmez. Bir token'ın süresi platformunuzda dolduğunda bağlantıyı kesin ve yeni bir token ile yeniden bağlanın. Platform kılavuzları: GitHub, GitLab, Bitbucket, Gitea, Forgejo.
Kimin bağlantısı kullanılır
Bir bağlantı çalışma alanına değil, onu kuran kişiye aittir. Her kişinin onunla neler yapabileceğine yine çalışma alanı rolleri karar verir. Bir değişiklik onaylandığında pull request'i, onaylayanın o platform için olan bağlantısıyla açılır. Konsoldan merge ettiğinizde kendi bağlantınız kullanılır.
Platform türü başına bir bağlantınız olabilir. Başka bir hesaba veya sunucuya geçmek için önce bağlantıyı kesin.
Token'lar nasıl saklanır
Token'lar depolanırken AES-256-GCM ile şifrelenir. Git'e bir istek başlığı olarak iletilirler; asla reponun URL'sine veya Git yapılandırmasına yazılmazlar.
Erişimi iptal etme
- Configure → Settings sayfasını açın ve Git Providers bölümüne kaydırın.
- Hesabın yanındaki Disconnect düğmesini, ardından onaylamak için Disconnect account düğmesini seçin.
- Git platformunuzda token'ı veya yetkili uygulamalarınız altındaki AI CodeOps uygulamasını iptal edin.
Üçüncü adım önemlidir: Disconnect, bağlantıyı AI CodeOps'tan kaldırır ama token'ı platformunuzda iptal etmez.
Sonraki adımlar
Sık sorulan sorular
Bağlantıyı kesmek, Git platformumdaki token'ı iptal eder mi?
Hayır. Disconnect, bağlantıyı AI CodeOps'tan kaldırır. Token'ın kendisini iptal etmek için onu veya uygulamayı Git platformunuzun ayarlarından iptal edin.
AI CodeOps repolarıma webhook ekler mi?
Oturumlar için hayır. Build & Test → Builds altında bağladığınız bir repo, bir push veya pull request'in build başlatabilmesi için bir webhook, her build'in sonucuyla birlikte de bir commit durumu alır. AI CodeOps pull request'lere yorum yazmaz.
GitHub ile giriş yapmak, GitHub'ı bağlamakla aynı şey mi?
Hayır. Giriş yalnızca profilinizi ve doğrulanmış e-postanızı okur. Repo erişimi, Settings sayfasındaki ayrı Git bağlantısından gelir.