Zimbra Destek Logo

Gmail ve Zimbra Takvimlerini Karşılıklı Senkronize Etme Rehberi

Gmail ve - Gmail ve Zimbra Takvimlerini Karşılıklı Senkronize Etme Rehberi

Gmail ve Zimbra Takvimlerini Karşılıklı Senkronize Etme Rehberi

Modern kurumsal ortamlarda birçok organizasyon ve çalışan hem Google Workspace (Gmail) hem de Zimbra Collaboration sistemlerini birlikte kullanmaktadır. Dış iş ortaklarınız Gmail üzerinden toplantı planlarken şirket içi işleyişinizi Zimbra üzerinde yürütüyorsanız, her iki platformdaki takvimlerin birbiriyle uyumlu çalışması kritik bir ihtiyaçtır. Bu kapsamlı kılavuzda, Gmail ve Zimbra takvimlerini çift yönlü olarak nasıl senkronize edebileceğinizi adım adım anlatıyoruz.

Entegrasyon tamamlandığında, Gmail takviminde oluşturduğunuz bir etkinlik anında Zimbra takviminize; Zimbra’da planladığınız bir toplantı ise otomatik olarak Gmail takviminize yansır. Süreç temel olarak üç adımdan oluşur: Google API yapılandırması, Zimbra sunucu tarafı komutları ve Zimbra Web Client kullanıcı yetkilendirmesi.

Kurulum İçin Ön Gereksinimler

Senkronizasyonu başarıyla yapılandırmak için aşağıdaki erişimlere sahip olmanız gerekir:

1. Aktif bir Google (Gmail) hesabı

2. Zimbra Collaboration Suite (ZCS) sunucusunda yönetici yetkileri

3. Google Developer Console erişim yetkisi

4. Zimbra sunucusuna SSH üzerinden komut satırı erişimi

Bu entegrasyon altyapısı, Google’ın modern OAuth 2.0 güvenlik protokolü üzerinden çalışır. Böylece kullanıcılar Gmail şifrelerini asla üçüncü taraflarla paylaşmak zorunda kalmaz; kimlik doğrulama belirteçler aracılığıyla güvenle yürütülür.

Adım 1: Google Developer Console Üzerinde Proje Açma

1. Web tarayıcınızdan Google Developer Console adresine erişin (https://console.developers.google.com/).

2. Kurumsal veya kişisel Gmail hesabınızla oturum açın.

3. Üst konsol menüsünden “Yeni Proje” seçeneğine tıklayın ve projenize açıklayıcı bir isim verin (Örneğin: “Zimbra Takvim Entegrasyonu”).

Adım 2: OAuth Onay Ekranının Yapılandırılması

Proje tanımlandıktan sonra OAuth onay ekranını yapılandırmanız gerekir. Bu alan, son kullanıcıların takvim erişim onayı verirken göreceği kurumsal bilgileri barındırır.

1. Sol menü üzerinden “OAuth onay ekranı” bölümüne geçiş yapın.

2. Uygulama adını, destek e-posta adresinizi ve yetkilendirilmiş kurumsal alan adlarınızı girin.

3. Erişim kapsamları (Scopes) bölümüne gidin ve takvim yönetimi için Google Calendar API yetkisini seçip kaydedin.

Adım 3: API Kimlik Bilgilerinin (Credentials) Oluşturulması

1. Sol gezinme panelinden “Kimlik Bilgileri” (Credentials) sekmesine tıklayın.

2. Üstteki “Kimlik Bilgisi Oluştur” butonundan “OAuth istemci kimliği” seçeneğini belirleyin.

3. Uygulama türü alanında “Web uygulaması” tercihini yapın.

4. Yetkilendirilmiş yönlendirme URI’si olarak Zimbra sunucunuzun tam adresini belirtin (Örneğin: https://mail.zimbra.io).

5. Kaydetme işlemi tamamlandığında sistem size özel bir İstemci Kimliği (Client ID) ve İstemci Gizli Anahtarı (Client Secret) üretecektir. Bu parametreleri güvenli bir yere kaydedin; Zimbra sunucu yapılandırmasında kullanacaksınız.

Adım 4: Google Calendar API’yi Etkinleştirme

Senkronizasyonun haberleşebilmesi için ilgili projenin Calendar API erişimine açık olması şarttır.

1. Google Developer Console içerisinde “Kitaplık” (Library) menüsüne girin.

2. Arama kutucuğuna “Google Calendar API” yazarak aratın.

3. Gelen sonuçtan servisi seçip “Etkinleştir” butonuna basın.

Adım 5: Zimbra Sunucu Tarafı Yapılandırması

Google tarafındaki parametreleri hazırladıktan sonra, Zimbra sunucunuza SSH ile bağlanın ve zimbra kullanıcısına geçerek aşağıdaki zmprov komutlarını çalıştırın. Bu adımlar Zimbra’nın OAuth kimlik doğrulamasını Google ile bağlamasını sağlar.

Komut 1 — API Erişim Kapsamını Tanımlama:

zmprov md <alan_adi> zimbraOAuthConsumerAPIScope 'https://www.googleapis.com/auth/calendar:google_caldav'

Bu komut ile Zimbra’nın Google Calendar API üzerindeki yetki çerçevesi çizilir.

Komut 2 — İstemci Kimlik Bilgilerini Sunucuya İşleme:

zmprov md <alan_adi> zimbraOAuthConsumerCredentials <client_id>:<client_secret>:google

Google Console üzerinden oluşturduğunuz İstemci Kimliğini ve Gizli Anahtarını aralarında iki nokta üst üste olacak şekilde bu komuta girin.

Komut 3 — Geri Dönüş (Redirect) URI Tanımı:

zmprov md <alan_adi> zimbraOAuthConsumerRedirectUri 'https://<sunucu_adresi>/service/extension/oauth2/authenticate/google:google'

Uygulama Örneği:

zmprov md zimbra.io zimbraOAuthConsumerRedirectUri 'https://mail.zimbra.io/service/extension/oauth2/authenticate/google:google'

Komutlardaki <alan_adi> alanına kurumunuzun e-posta alan adını, <sunucu_adresi> bölümüne ise Zimbra sunucunuzun FQDN adresini yazınız.

Adım 6: Zimbra Web Client Kullanıcı Onayı

Sunucu tarafındaki global ayarların ardından, takvimini bağlamak isteyen kullanıcılar kendi web arayüzlerinden yetkilendirme işlemini tamamlamalıdır.

1. Zimbra Web Client oturumunuzu açın.

2. Tarayıcınızın adres çubuğuna şu URL kalıbını yazıp Enter tuşuna basın:

https://<sunucu_adresi>/service/extension/oauth2/authorize/google?type=caldav

3. Ekrana gelen Google oturum penceresinde takvimini eşitlemek istediğiniz Gmail hesabını seçin.

4. Google tarafından sunulan takvim erişim izinlerini inceleyip “İzin Ver” butonuna tıklayarak onayı tamamlayın.

Adım 7: Senkronizasyonun Test Edilmesi ve Doğrulama

Yetkilendirme başarıyla kaydedildiğinde, Gmail takviminiz Zimbra Takvim arabiriminde ayrı bir takvim katmanı olarak belirecektir.

Artık her iki takvim ortamında da etkinlik oluşturabilirsiniz. Zimbra üzerinde kaydettiğiniz bir randevu saniyeler içinde Google Takviminize, Google üzerinde açılan bir toplantı ise anında Zimbra takvim ekranınıza yansıyacaktır.

Sık Karşılaşılan Sorunlar ve Çözüm İpuçları

Senkronizasyon Başlamıyorsa: Google Console üzerinde CalDAV ve Calendar API’nin aktif durumda olduğunu, istemci kimlik bilgilerinin sunucuya eksiksiz girildiğini teyit edin.

Redirect URI Hatası Alınıyorsa: Zimbra sunucusuna tanımladığınız yönlendirme URI’si ile Google Console’a yazdığınız adresin harfi harfine aynı olduğundan emin olun (protokol ve port dahil).

Takvim Listede Görünmüyorsa: Zimbra Takvim sekmesinde sol menüdeki takvim adının yanındaki onay kutusunun işaretli olduğundan emin olun; bazı durumlarda takvim pasif işaretli olarak gelebilir.

Ağ ve Güvenlik Duvarı Engelleri: Zimbra sunucunuzun dışarıya doğru Google API sunucularına (googleapis.com) HTTPS (443) portu üzerinden serbestçe erişebildiğini kontrol edin.


Zimbra e-posta ve iş birliği çözümleri hakkında detaylı bilgi edinmek veya profesyonel destek almak için bilgi@zimbradestek.com adresinden ekibimize ulaşabilirsiniz.

Gmail ve: Kurumsal Kontrol Listesi ve Öneriler

Üretim ortamında Gmail ve adımlarını uygulamadan önce sistem yöneticilerinin aşağıdaki temel kontrolleri tamamlaması, olası servis kesintilerinin ve veri tutarsızlıklarının önüne geçer:

  • Yedekleme ve Anlık Görüntü: Yapılandırma değişikliği öncesinde Zimbra sunucusunun tam yedeğini veya sanal makine snapshot’ını alın.
  • Log ve Servis İzleme: Değişiklik sonrasında zmcontrol status ve /opt/zimbra/log/mailbox.log kayıtlarını kontrol ederek tüm servislerin sağlıklı çalıştığını doğrulayın.
  • Güvenlik ve Erişim Politikası: Gmail ve sürecinde kullanılan portların, SSL/TLS sertifikalarının ve kimlik doğrulama kurallarının güncel güvenlik standartlarıyla uyumlu olduğundan emin olun.

Konuyla bağlantılı diğer teknik makalemiz olan Zimbra’da Posta Kutusu Yönetimi: Klasörler, Etiketler ve Bayraklarla Düzenleme ile Acil Güncelleme: Zimbra 10.1.14 Sürümü ile IMAP Senkronizasyon Sorunu Çözüldü rehberlerimizi de inceleyebilirsiniz. Resmi ürün dokümantasyonu ve kurumsal çözümler için Zimbra Destek portalından yararlanabilirsiniz.

Yorum Bırakın

E-posta adresiniz yayınlanmayacaktır.