Ders 1 · Bağlantıyı kurmak
Erişim anahtarı, GitHub App ya da anahtarsız bağlantı; gerekli izinler ve yalnız yazılır gizli bilgiler.
Bu dersin hedefiPORTWARE'i GitHub hesabınıza ya da organizasyonunuza güvenle bağlamak.
Üç bağlantı yolu
| Yol | Ne zaman | Sınır |
|---|---|---|
| İnce ayarlı erişim anahtarı | Küçük ekip, tek hesap; en hızlı kurulum. | Saatte 5 000 istek; anahtarı oluşturan kişiye bağlı. |
| GitHub App | Organizasyon; kişiden bağımsız kimlik. | Saatte 15 000 istek; depo bazında izin. |
| Yalnız açık depolar (anahtarsız) | Açık kaynak bağımlılıkları izlemek. | Saatte 60 istek; özel depo okunmaz. |
Erişim anahtarını GitHub'da oluşturun
GitHub'da Settings › Developer settings › Fine-grained tokens › Generate new token yolunu izleyin. Depo erişimini yalnız bağlayacağınız depolarla sınırlayın ve şu izinleri verin:
| İzin | Erişim | PORTWARE'de ne açar |
|---|---|---|
| Metadata | okuma (zorunlu) | Depo bilgisi |
| Contents | okuma | Dallar, commit'ler, sürümler, README |
| Pull requests | okuma | PR durumu ve inceleme |
| Issues | okuma | GitHub kayıtları |
| Actions · Checks | okuma | Derlemeler ve kontrol sonucu |
| Webhooks | okuma ve yazma | PORTWARE'den webhook kurmak |
| Contents | yazma (isteğe bağlı) | Görevden dal açmak |
Eksik izin bir şeyi bozmaz
Anahtarın okuyamadığı bölüm depo ekranında sarı uyarıyla ve eklenmesi gereken izinle yazılır; diğer bölümler eşitlenmeye devam eder. İzni sonradan eklediğinizde o bölümün geçmişi de gelir.
PORTWARE'de bağlantıyı kurun
Bağlantı formunu açın
Proje › GitHub › Bağlantılar menüsünden Yeni'ye basın, bağlantıya bir ad verin, kimlik doğrulama yolunu seçin ve hesap ya da organizasyon adını yazın.
12345- Kimlik doğrulama: erişim anahtarı, GitHub App ya da yalnız açık depolar.
- Bağlantıyı Sına: GitHub'a bağlanır ve oturum açan hesabı yazar.
- Depoları Bul: anahtarın okuyabildiği depoları arşivde listeler; kullandıklarınızı etkinleştirin.
- Webhook adresi: GitHub'daki webhook bu adrese gönderir; kopyala düğmesiyle alın.
- Kalan istek: GitHub'ın saatlik bütçesinden kalan.
Anahtarı girin ve sınayın
Erişim anahtarı seçiliyse Erişim Anahtarı alanına anahtarı yapıştırın ve Bağlantıyı Sına'ya basın. Durum Bağlı olur.
Webhook gizli anahtarını üretin
Gizli Anahtar Üret bir kez basılır; webhook'u PORTWARE'den kurduğunuzda GitHub'a kendisi iletilir.
Gizli bilgiler yalnız yazılır
Anahtar ve gizli anahtar bir kez girilir ve bir daha gösterilmez; formda yalnız son dört karakter görünür. Değiştirmek için yeni değeri yazmanız yeterlidir. Yalnız sistem yöneticileri bu alanları görür.
Vaka: kişisel anahtardan GitHub App'e
- Durum
- Anahtarı oluşturan geliştirici şirketten ayrılıyor.
- Yapılan
- Organizasyonda bir GitHub App kuruldu; bağlantıda kimlik doğrulama GitHub App'e çevrildi, App ID, kurulum kimliği ve özel anahtar girildi.
- Sonuç
- Bağlantı kişiye bağlı değil; depolar ve geçmiş olduğu gibi kaldı.
Kendini sına
Hangi izin olmadan bağlantı hiç kurulamaz?
Metadata: okuma.
Pull requests izni yoksa ne olur?
Commit, dal ve sürümler gelir; PR bölümü sarı uyarıyla adlandırılır.
Kaydedilmiş anahtarı nasıl görürsünüz?
Göremezsiniz; yalnız son dört karakter görünür. Yeni değer yazılabilir.