Ana içeriğe geç

Setting Up Gmail OAuth Authentication

Bu kılavuz, Gmail ile OAuth kimlik doğrulaması için Google Cloud uygulaması oluşturma adımlarında size yol gösterecektir. OAuth, geleneksel parola kimlik doğrulamasına kıyasla Gmail hesabınıza daha güvenli erişim sağlar.

Prerequisites​

  • Google hesabı (kişisel veya Google Workspace)
  • Google Cloud Console erişimi
  • Perfex CRM kurulum URL'niz (redirect URI yapılandırması için)

Step-by-Step Setup​

Step 1: Create a Google Cloud Project​

  1. Google Cloud Console adresine gidin
  2. Sayfanın üstündeki proje açılır menüsüne tıklayın
  3. "New Project"'e tıklayın
  4. Proje adı girin (örn. "Perfex Mailbox OAuth")
  5. "Create"'e tıklayın
  6. Projenin oluşturulmasını bekleyin ve seçin

Step 2: Enable Gmail API​

  1. Google Cloud Console'da "APIs & Services" > "Library"'e gidin
  2. "Gmail API" arayın
  3. Sonuçlardan "Gmail API"'ye tıklayın
  4. "Enable"'e tıklayın
  5. API'nin etkinleşmesini bekleyin
  1. "APIs & Services" > "OAuth consent screen"'e gidin
  2. "External" kullanıcı türünü seçin (Google Workspace hesabınız varsa "Internal" seçebilirsiniz)
  3. "Create"'e tıklayın
  4. Zorunlu bilgileri doldurun:
    • App name: Uygulama adı (örn. "Perfex CRM Mailbox")
    • User support email: E-posta adresiniz
    • Developer contact information: E-posta adresiniz
  5. "Save and Continue"'e tıklayın
  6. "Scopes" sayfasında "Add or Remove Scopes"'e tıklayın
  7. Şu kapsamları ekleyin:
    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/gmail.send
    • https://www.googleapis.com/auth/gmail.modify
  8. "Update"'e tıklayın, ardından "Save and Continue"
  9. "Test users" sayfasında (External uygulama türü kullanıyorsanız):
    • Gmail adresinizi test kullanıcısı olarak ekleyin
    • "Save and Continue"'e tıklayın
  10. İnceleyin ve "Back to Dashboard"'a tıklayın

Step 4: Create OAuth 2.0 Credentials​

  1. "APIs & Services" > "Credentials"'e gidin
  2. "Create Credentials" > "OAuth client ID"'e tıklayın
  3. Uygulama türü olarak "Web application" seçin
  4. OAuth istemci adı girin (örn. "Perfex Mailbox Client")
  5. "Authorized redirect URIs" altında "Add URI"'e tıklayın
  6. Redirect URI'yi şu formatta ekleyin:
https://your-domain.com/admin/mailbox/oauth/callback?provider=gmail

your-domain.com değerini gerçek Perfex CRM etki alanınızla değiştirin.

  1. "Create"'e tıklayın
  2. ÖNEMLİ: Her ikisini de kopyalayıp kaydedin:
    • Client ID
    • Client Secret (göstermek için "Show"a tıklayın)

Step 5: Configure in Perfex CRM​

  1. Perfex CRM yönetim alanına gidin
  2. Mailbox > Configuration'a gidin
  3. Kimlik doğrulama yöntemi olarak "OAuth2" seçin
  4. Sağlayıcı olarak "Gmail" seçin
  5. "Gmail Client ID" alanına Client ID girin
  6. "Gmail Client Secret" alanına Client Secret girin
  7. "Save Configuration"'a tıklayın
  8. "Connect Gmail" düğmesine tıklayın
  9. Google açılır penceresinde uygulamayı yetkilendirin
  10. Bağlantıyı doğrulayan bir başarı mesajı görmelisiniz

Important Limitations & Considerations​

Google Test App Limitations​

These limitations are imposed by Google, not by our software.

  1. Token Expiry (7 Days) - Doğrulanmamış uygulamalar (test modundaki uygulamalar) OAuth tokenleri 7 gün sonra sona erer. 7 gün sonra kullanıcılar bağlantıyı yeniden yetkilendirmelidir. Bu, Google'ın doğrulanmamış uygulamalar için güvenlik politikasıdır.

  2. Test User Restrictions - Yalnızca "Test users" listesine eklenen kullanıcılar OAuth uygulamasını kullanabilir. Maksimum 100 test kullanıcısı izin verilir. Bu kısıtlama uygulama doğrulanıp yayınlanana kadar geçerlidir.

  3. App Verification Process - 7 günlük token süresini kaldırmak için uygulamanızı Google doğrulamasına göndermeniz gerekir. Doğrulama birkaç hafta sürebilir (tipik olarak 4-8 hafta).

App Verification & Publishing​

Kısıtlamaları kaldırmak için:

  1. Submit for Verification

    • Google Cloud Console'da "OAuth consent screen"'e gidin
    • "PUBLISH APP" düğmesine tıklayın
    • Doğrulama formunu doldurun (uygulama amacı, işlevsellik, gizlilik politikası URL'si, hizmet koşulları URL'si, video gösterimi (opsiyonel ama önerilen))
    • İncelemeye gönderin

  2. Verification Timeline

    • İlk inceleme: 1-2 hafta
    • Ek bilgi talepleri: Değişken (Google açıklama gerektirirse)
    • Nihai onay: Toplam 4-8 hafta (tipik)

  3. After Verification

    • Tokenlar artık 7 günde sona ermez
    • Test kullanıcı kısıtlaması yok
    • Uygulama herhangi bir Gmail kullanıcısı tarafından kullanılabilir

Production vs Testing​

  • Testing Mode: Hızlı kurulum, ancak tokenler her 7 günde bir sona erer
  • Production Mode: Doğrulama gerekir, ancak tokenler sona ermez
  • Seçim sizin - yazılımımız her iki modda da çalışır

Token Refresh​

Modülümüz mümkün olduğunda token yenilemeyi otomatik olarak işler. Ancak:

  • Doğrulanmamış uygulamalar: Tokenler 7 günde sona erer ve manuel yeniden yetkilendirme gerekir
  • Doğrulanmış uygulamalar: Tokenler kullanıcı müdahalesi olmadan otomatik yenilenir

Notes​

  • Redirect URI, Google Cloud Console'da yapılandırdığınızla tam olarak eşleşmelidir
  • Client Secret'ı güvende tutun - asla herkese açık paylaşmayın
  • Etki alanını değiştirirseniz Google Cloud Console'daki redirect URI'yi güncelleyin
  • OAuth akışı tamamen Google tarafından işlenir - modülümüz yalnızca başlatır ve callback alır

Troubleshooting​

"Redirect URI mismatch" hatası:

  • Google Cloud Console'daki redirect URI'nin https://your-domain.com/admin/mailbox/oauth/callback?provider=gmail ile tam eşleştiğinden emin olun
  • Sondaki eğik çizgiler veya HTTP/HTTPS uyuşmazlıklarını kontrol edin

7 gün sonra "Token expired":

  • Doğrulanmamış uygulamalar için beklenen (Google politikası)
  • "Connect Gmail"e tekrar tıklayarak yeniden yetkilendirin
  • Bundan kaçınmak için uygulamanızı Google doğrulamasına gönderin

"Access blocked" hatası:

  • E-postanızın "Test users" listesine eklendiğinden emin olun (doğrulanmamış uygulamalar için)
  • Gmail API'nin Google Cloud projenizde etkin olduğunu kontrol edin

Gmail API bulunamıyor:

  • Doğru Google Cloud projesinde olduğunuzdan emin olun
  • API Library'de "Gmail" aramayı deneyin

Additional Resources​

bilgi

7 günlük token süresi ve test kullanıcı kısıtlamaları, doğrulanmamış uygulamalar için Google'ın güvenlik politikalarıdır. Bu kısıtlamalar yazılımımız tarafından uygulanmaz. Uygulamanız Google tarafından doğrulandıktan sonra bu kısıtlamalar kaldırılır.