Google Chat'te GitHub uygulamasını kullanma

Google Chat'te GitHub etkinlikleriyle (sorunlar, pull istekleri, yorumlar vb.) ilgili bildirimler almak için GitHub uygulamasını kullanın.

Başlamadan önce

Chat için GitHub uygulamasını kullanmak üzere:

• Uygulamaları yüklemek için Google Workspace yöneticinizden izin almanız gerekir.
• Uygulamayı Chat'e ekleyin. Uygulamaları nasıl bulabileceğinizi ve Chat'e ekleyebileceğinizi öğrenin.
• Bir GitHub hesabınız olmalıdır.
• GitHub deponuz için Google Chat uygulamasını yüklemeniz gerekir.

GitHub uygulaması ve OAuth uygulaması kimlik doğrulama mekanizmalarını anlama

Bu dokümanda, üçüncü taraf hizmetlerinin GitHub kaynaklarıyla entegre olması ve bu kaynaklara erişmesi için temel mekanizmalar olarak kullanılan GitHub uygulamaları ile OAuth uygulamalarının farklı özellikleri ve operasyonel modelleri açıklanır. Bu farklılıkların kapsamlı bir şekilde anlaşılması, kuruluş içinde optimum güvenlik duruşunun korunması açısından kritik öneme sahiptir.

1. Karşılaştırmalı analiz: temel farklar

İki model arasındaki temel farklar, erişim için kullanılan kimlik (Sorumlu) ve kaynak yetkilendirmesini yöneten mekanizmadır.

Özellik	GitHub uygulaması (oturum açmak için önerilen yöntem)	OAuth uygulaması (eski oturum açma yöntemi)
Sorumlu kimlik	Kullanım alanına bağlı olarak, herhangi bir kullanıcıdan ayrı olarak veya yetkilendiren kullanıcı adına bağımsız bir Uygulama Kimliği olarak hareket eder.	Yetki veren kullanıcı adına hareket eder ve ayrıcalıklarını devralır.
Yetkilendirme modeli	Ayrıntılı izinler (Önerilir): En az ayrıcalık ilkesini kullanarak belirli depolara ve kaynak türlerine erişime izin verir. Örneğin: Yalnızca meta veriler için okuma erişimi.	Geniş kapsamlar: Erişim, yetkilendiren kullanıcının görebildiği tüm kaynaklara erişim izni verme gibi geniş kapsamlarla tanımlanır.
Kimlik bilgilerinin geçerlilik süresi	Kısa ömürlü jetonlar: Erişim jetonlarının ömrü sınırlıdır (genellikle 1 saat) ve sık sık yenilenmeleri gerekir. Bu sayede, güvenlik ihlali durumunda risk önemli ölçüde azaltılır.	Uzun ömürlü jetonlar: Erişim jetonları, kullanıcı tarafından manuel olarak iptal edilene kadar geçerliliğini korur ve uzun süreli bir risk oluşturur.
Yükleme koşulu	Uygulama, hesaba veya kuruluşa resmi bir bağlantı oluşturarak bir yönetici ya da kuruluş sahibi tarafından yüklenmeli ve uygulamanın kullanıcı adına işlem yaptığı kullanım alanlarında kullanıcı tarafından yetkilendirilmelidir.	Erişimi doğrudan kullanıcının kimliğine bağlayarak tek bir kullanıcı tarafından yetkilendirilmelidir.

Daha kapsamlı dokümanlar için GitHub uygulamaları ile OAuth uygulamaları arasındaki farklar başlıklı makaleyi inceleyin.

2. Öneri

Güvenlikle ilgili en iyi uygulamalara göre, tüm üçüncü taraf ve kuruluş entegrasyonları için GitHub uygulaması kimlik doğrulama mekanizması önerilir. Bu model, en az ayrıcalık ilkesini uygular ve güçlü, sınırlı süreli kimlik bilgileri kullanır. Böylece, OAuth uygulamalarının yetki devri modeline kıyasla daha yüksek bir güvenlik standardı ve operasyonel kararlılık sağlar.

GitHub depoları için Google Chat uygulamasını yükleyin.

Chat'te GitHub uygulamasını ayarlama

1. Chat'i açın.
2. Uygulamayla doğrudan bir mesaj açın veya uygulamanın bulunduğu bir alana gidin.
3. Yapılandırma penceresini açmak için Sign in'i (Oturum aç) tıklayın.
4. Configure Access (Erişimi Yapılandır) Sign in to GitHub'ı (GitHub'da oturum aç) tıklayın.
5. Oturum açma işlemini tamamlayın ve pop-up'ı kapatın.
6. Chat iletişimini güncellemek için Refresh'i (Yenile) tıklayın.
7. Add Repositories (Depo Ekle) bölümünde, bildirim almak istediğiniz GitHub deposunu yazın.
8. Bildirim almak istediğiniz etkinliklerin kutularını işaretleyin.
9. Kaydet'i tıklayın.

İpucu: Uygulamayı eklediğiniz her alanda bildirim ayarlamanız gerekir. Uygulama, üyesi olduğu tüm alanlara bildirim gönderir.

OAuth uygulamasından (eski) GitHub uygulamasına (önerilen) geçiş yapma

Mevcut bağlantınızı eski OAuth uygulama kimlik doğrulama yönteminden önerilen GitHub uygulama yöntemine taşımak için:

1. Chat'i açın.
2. GitHub uygulamasıyla doğrudan mesaj veya alan açın.
3. İleti alanında Google Workspace araçları simgesini tıklayın.
4. Komut listesinde GitHub Reauthorize'ı seçin.
5. Taşıma ve yeniden yetkilendirme sürecini tamamlamak için Chat iletişim kutusunda ekrandaki talimatları uygulayın.

GitHub uygulamasını alanlarda kullanma

Uygulamayı alanlarda kullanmak için her mesajda ve uygulamadan gelen mesajlara verilen yanıtlarda uygulamadan @bahsetmeniz veya /bahsetmeniz gerekir.

@bahsetme veya /bahsetme işlemi, mesajı alandaki diğer kullanıcılara değil uygulamaya gönderdiğinizi onaylar.

1. Chat uygulamasını açın.
2. Bir alanda, @github veya /github ifadesini ve ardından komutu girin.
   • @github veya /github'dan bahsederek gönderdiğiniz mesajlar, alandaki diğer kullanıcılara değil uygulamaya gönderilir.

Uygulama ayarlarını değiştirme

Alanlarda ayarları yalnızca uygulamayı ekleyen kişi değiştirebilir.

1. Chat'i açın.
2. Uygulamayla doğrudan bir mesaj açın veya uygulamanın bulunduğu bir alana gidin.
3. Uygulamanın mevcut ayarlarını açmak için /github_settings komutunu girin.
4. Ayarları gereken şekilde değiştirin.
5. Kaydet'i tıklayın.

Uygulamanın bir alandan kaldırılması uygulama ayarlarının silinmesine neden olur.

Chat'te GitHub uygulamasının komutları hakkında bilgi edinme

Chat'te GitHub uygulamasının bulunduğu bir doğrudan mesajın veya alanın mesaj alanında şunları kullanabilirsiniz:

• Eğik çizgi komutları:
  • /github_settings: Ayarlar iletişim kutusunu açar.
  • /github_reminders: Kişisel veya ekip tarafından açılan pull isteklerinde planlanmış hatırlatıcılar oluşturup düzenlemenizi sağlar.
  • /github_subscribe: Bir GitHub <repoURL> veya <owner/repo> adresine abone olur.
  • /github_openIssue: Yeni bir GitHub sorunu açar.
  • /github_logout: GitHub hesabınızdan çıkış yapar.
  • /github_help: Yardım mesajını gösterir.
  • /github_feedback: GitHub uygulamasıyla ilgili geri bildirim göndermenizi sağlar.
• Hızlı komutlar: Hızlı komutlara erişmek için Google Workspace araçları simgesini tıklayın.
  • GitHub Connect: "Oturum aç" ve "Eski oturum açma" seçeneğini içeren bir mesaj gösterir.
  • GitHub'ı Reauthorize: Yeni bir bağlantı yöntemine geçmenize olanak tanır.

Desteklenen komutların tam listesini almak için:

1. Bilgisayarınızda Chat'i açın.
2. Doğrudan mesaj açın veya GitHub uygulamasının yüklü olduğu bir alana gidin.
3. /github_help komutunu girin.

Chat'te GitHub uygulamasıyla ilgili sorunları giderme

Anlık bildirimlere abone olurken hata alırsanız

GitHub uygulaması

Alanlarda anlık bildirimleri ayarlamak için:

1. Tarayıcınızda GitHub profil ayarlarına gidin.
2. "Integrations" (Entegrasyonlar) bölümünde Applications (Uygulamalar) Authorized GitHub apps'i (Yetkilendirilmiş GitHub uygulamaları) tıklayın.
   • Google Chat'te GitHub uygulamasını bağladıktan sonra, yetkili uygulamalar listenizde "Google Chat" gösterilir.
3. GitHub deposu için Google Chat uygulamasını yükleyin.
   • Alternatif olarak, kuruluş/depo sahibinden yükleme isteğinde bulunabilirsiniz.
4. Yükleme tamamlanana kadar bekleyin.
5. Google Chat'te GitHub uygulamasıyla doğrudan bir mesaj veya alan açın.
6. Mesaj alanında, abonelik oluşturmak için /github_subscribe [kuruluş/repo] veya /github_settings komutunu girin.

OAuth uygulaması

Alanlarda anlık bildirimleri ayarlamak için:

• Önerilen deponun kuruluş sahibi olmanız gerekir.
• Uygulamayı GitHub kuruluşunda yetkilendirin.
  1. Tarayıcınızda GitHub profil ayarlarına gidin.
  2. "Integrations" (Entegrasyonlar) bölümünde Applications (Uygulamalar) Authorized OAuth apps'i (Yetkilendirilmiş OAuth uygulamaları) tıklayın.
     • Google Chat'te GitHub uygulamasını bağladıktan sonra, yetkilendirilmiş uygulamalar listenizde "Google Chat" gösterilir.
  3. Uygulamaya, erişmek istediğiniz kuruluşa erişim izni verin.

GitHub uygulamasından çok fazla bildirim alıyorsanız

1. İleti alanına /github_settings komutunu girin.
2. Depo bildirim ayarlarınızı düzenlemek için Bildirim ayarları'nı tıklayın.
3. Bildirimleri filtrelemek için her bir bildirim türünün yanındaki aşağı oku tıklayın.
   • Bildirimleri filtrelemek için ek seçenekler gösterilir.
4. İstediğiniz bildirimlerin kutularını işaretleyin.
5. Kaydet'i tıklayın.

Planlanmış hatırlatıcılarda @bahsetme almıyorsanız

Planlanmış hatırlatıcılarda sizden bahsedilmesi için Google Chat hesabınızı GitHub hesabına bağlamış olmanız gerekir.

1. İleti alanına /github_settings komutunu girin.
2. Hesabınızı bağlamak için:
   1. Pop-up'ta Configure access (Erişimi yapılandır) Sign in to GitHub'ı (GitHub'da oturum aç) tıklayın.
   2. GitHub hesabınızda oturum açın.
   3. Uygulamayı yetkilendirin.
3. GitHub uygulamasından aldığınız mesajda Schedule reminders for your team'i (Ekibiniz için hatırlatıcı planla) seçin.
4. Pop-up'ta:
   1. Create new reminder'ı (Yeni hatırlatıcı oluştur) tıklayın.
   2. Hatırlatıcı ayarlarını yapılandırın.
   3. Kaydet'i tıklayın.

GitHub uygulamasıyla hatırlatıcı almıyorsanız

Hatırlatıcı almak istediğiniz depoda Google Chat App for GitHub'ın yüklendiğini doğrulayın.

_{Google, Google Workspace ve ilgili markalarla logolar Google LLC'nin ticari markalarıdır. Diğer tüm şirket ve ürün adları, ilişkili oldukları şirketlerin ticari markalarıdır.}