Google Kimlik Hizmetleri JavaScript kitaplığını (google.accounts.oauth2) kullanarak web uygulamanızda Google API'lerine erişim yetkisi vermek için öncelikle şunları yapmanız gerekir:
- OAuth 2.0 istemci kimliği alma
- OAuth kullanıcı rızası ekranınızı ve kapsamlarınızı yapılandırın.
- İstemci kitaplığını yükleyin.
- İsteğe bağlı olarak İçerik Güvenliği Politikası (İGP) ve Çapraz Kaynak Açıcı Politikası (COOP) oluşturun.
Google API istemci kimliğinizi alma
Web sitenizde Google Hesabı Yetkilendirmesi'ni etkinleştirmek için öncelikle bir Google API istemci kimliği oluşturmanız gerekir. Aşağıdaki adımları tamamlayın:
- Google Cloud Console'un İstemciler sayfasını açın.
- Bir Cloud Console projesi oluşturun veya seçin. Üretim uygulamaları oluştururken birden fazla proje gerekebilir. Yönettiğiniz her proje için bu bölümün kalan adımlarını tekrarlayın.
- Yeni bir istemci kimliği oluşturmak için İstemci oluştur'u tıklayın ve Uygulama türü olarak Web uygulaması'nı seçin. Mevcut bir istemci kimliğini kullanmak için Web uygulaması türünde bir kimlik seçin.
Web sitenizin URI'sini Yetkilendirilmiş JavaScript kaynakları'na ekleyin. URI yalnızca şemayı ve tam ana makine adını içerir. Örneğin,
https://www.example.com.ux_mode: 'redirect'ile yetkilendirme kodu modelini kullanıyorsanız (veya arka uç uç noktasında yetkilendirme kodlarını değiştiriyorsanız) yönlendirme URI'lerinizi Yetkilendirilmiş yönlendirme URI'leri bölümüne ekleyin. Yönlendirme URI'leri şemayı, tam nitelikli ana makine adını ve yolu içerir ve yönlendirme URI'si doğrulama kurallarına uygun olmalıdır. Örneğin,https://www.example.com/oauth2callback.
Yapılandırma tamamlandıktan sonra, oluşturulan istemci kimliğini not edin.
initCodeClient() veya initTokenClient() başlatılırken bu değeri client_id özelliğinde iletirsiniz. (Ayrıca, gizli tutmanız ve yalnızca sunucu tarafı jeton değişimi işlemleri için kullanmanız gereken bir istemci gizli anahtarı da oluşturulur.)
OAuth kullanıcı rızası ekranınızı yapılandırma
Web uygulamanız OAuth 2.0 kapsamlarını kullanarak kullanıcı verilerine erişim isteğinde bulunduğunda Google, kullanıcılara hangi uygulamanın erişim istediğini, hangi veri kapsamlarının istendiğini ve geçerli şartları belirten bir kullanıcı rızası ekranı gösterir.
- Cloud Console'un Google Auth Platform bölümündeki Markalama sayfasını açın.
- İstenirse yapılandırdığınız projeyi seçin.
- Markalama formunu (Uygulama adı, Uygulama logosu, Destek e-postası, Yetkili alanlar, Uygulama ana sayfası bağlantısı ve Gizlilik Politikası bağlantısı) doldurup Kaydet'i tıklayın.
- Uygulamanızın gerektirdiği Google API'leri kapsamlarını yapılandırmak için Veri Erişimi sayfasına gidin. En iyi uygulama, kapsamları önceden değil, erişim gerektiğinde kademeli olarak istemektir.
- Doğrulama durumunuzu kontrol edin. Uygulamanız hassas veya kısıtlanmış kapsamlar istiyorsa uygulamanızı doğrulama için gönderin. Ayrıntılar için OAuth doğrulama koşulları başlıklı makaleyi inceleyin.
İçerik Güvenliği Politikası ve COOP
Web uygulamanızda İçerik Güvenliği Politikası (İGP) uygulanıyorsa aşağıdaki Google Kimlik Hizmetleri kaynaklarına izin verin:
script-src:https://accounts.google.com/gsi/clientframe-src:https://accounts.google.com/gsi/connect-src:https://accounts.google.com/gsi/
Pop-up yetkilendirme akışları için (ux_mode: 'popup' ile initTokenClient veya initCodeClient), iletişim kutusu penceresinin yetkilendirme yanıtını sayfanıza geri iletebilmesi için Cross-Origin-Opener-Policy (COOP) HTTP yanıt başlığınızı same-origin-allow-popups olarak yapılandırın.
Sonraki adımlar
Ardından, yetkilendirme istemcinizi başlatmak için web sayfanıza istemci kitaplığını yükleyin.