OAuth ve Google ile Oturum Açma ile Basitleştirilmiş Bağlantı

Genel Bakış

OAuth tabanlı Google ile oturum açma ve basitleştirilmiş bağlantı oluşturma, OAuth bağlantısının üzerine Google ile oturum açma özelliğini ekler. Bu, Google kullanıcıları için sorunsuz bir bağlantı deneyimi sağlar ve isteğe bağlı olarak hesap oluşturmayı etkinleştirir. Bu sayede kullanıcı, Google Hesabı'nı kullanarak hizmetinizde yeni bir hesap oluşturabilir.

OAuth ve Google ile oturum açma kullanarak hesap bağlama işlemini gerçekleştirmek için aşağıdaki genel adımları uygulayın:

  1. Öncelikle kullanıcıdan Google profiline erişim izni vermesini isteyin.
  2. Kullanıcı hesabının mevcut olup olmadığını kontrol etmek için profilindeki bilgileri kullanın.
  3. Mevcut kullanıcılar için hesapları bağlayın.
  4. Kimlik doğrulama sisteminizde Google kullanıcısıyla eşleşen bir kullanıcı bulamıyorsanız Google'dan alınan kimlik jetonunu doğrulayın. Hizmetiniz hesap oluşturmayı destekliyorsa kimlik jetonunda yer alan profil bilgilerine göre kullanıcı oluşturabilirsiniz.
Bu şekil, kullanıcının basitleştirilmiş bağlantı akışını kullanarak Google Hesabı'nı bağlama adımlarını gösterir. İlk ekran görüntüsünde, kullanıcının bağlantı oluşturmak için uygulamanızı nasıl seçebileceği gösterilmektedir. İkinci ekran görüntüsü, kullanıcının hizmetinizde mevcut bir hesabı olup olmadığını onaylamasına olanak tanır. Üçüncü ekran görüntüsünde, kullanıcı bağlamak istediği Google Hesabı'nı seçebilir. Dördüncü ekran görüntüsünde, kullanıcının Google Hesabı'nı uygulamanıza bağlama onayı gösteriliyor. Beşinci ekran görüntüsünde ise Google uygulamasında başarıyla bağlanmış bir kullanıcı hesabı gösteriliyor.
Kolay Bağlama ile kullanıcının telefonunda Hesap Bağlama

Şekil 1. Basitleştirilmiş Bağlantı ile kullanıcının telefonunda hesap bağlama

Basitleştirilmiş Bağlama: OAuth + Google ile Oturum Açma Akışı

Aşağıdaki sıra şeması, Basitleştirilmiş Bağlantı için Kullanıcı, Google ve jeton değişimi uç noktanız arasındaki etkileşimleri ayrıntılı olarak açıklar.

Kullanıcı Google Uygulaması / Sunucu Jetonunuz Exchange Uç Noktası API'niz 1. Kullanıcı, bağlantı oluşturma işlemini başlatır 2. Google ile oturum açma isteğinde bulunun 3. Google ile oturum açma 4. check intent (JWT Assertion) 5. account_found: true/false If account found: 6. get intent If no account: 6. create intent 7. access_token, refresh_token 8. Kullanıcı jetonlarını saklama 9. Kullanıcı kaynaklarına erişme
Şekil 2. Basitleştirilmiş bağlantı akışındaki etkinlik sırası.

Roller ve sorumluluklar

Aşağıdaki tabloda, basitleştirilmiş bağlantı oluşturma akışındaki aktörlerin rolleri ve sorumlulukları tanımlanmaktadır.

İşlemi gerçekleştiren / Bileşen GAL Rolü Sorumluluklar
Google Uygulaması / Sunucusu OAuth İstemcisi Google ile oturum açma için kullanıcı izni alır, kimlik onaylarını (JWT) sunucunuza iletir ve sonuç jetonlarını güvenli bir şekilde depolar.
Jeton Değişimi Uç Noktanız Kimlik sağlayıcı / yetkilendirme sunucusu Kimlik onaylarını doğrular, mevcut hesapları kontrol eder, gerekli hesap bağlama amaçlarını (check, get) ve isteğe bağlı create amacını işler ve istenen amaçlara göre jetonlar verir.
Hizmet API'niz Kaynak Sunucusu Geçerli bir erişim jetonu sunulduğunda kullanıcı verilerine erişim sağlar.

Basitleştirilmiş bağlantı oluşturma için şartlar

  • Temel OAuth bağlantısı akışını uygulayın. Hizmetiniz, OAuth 2.0 uyumlu yetkilendirme ve jeton değişimi uç noktalarını desteklemelidir.
  • Jeton değişimi uç noktanız JSON Web Token (JWT) onaylarını desteklemeli, gerekli check ve get amaçlarını, isteğe bağlı olarak da create amacını uygulamalıdır.

Basitleştirilmiş Bağlantı İçin Karar Mantığı

Aşağıdaki mantık, Basitleştirilmiş Bağlantı oluşturma akışı sırasında amaçların nasıl çağrılacağını belirler:

  1. Kullanıcının kimlik doğrulama sisteminizde hesabı var mı? (Kullanıcı EVET veya HAYIR'ı seçerek karar verir)
    1. EVET : Kullanıcı, platformunuzda oturum açmak için Google Hesabı ile ilişkili e-posta adresini kullanıyor mu? (Kullanıcı EVET veya HAYIR'ı seçerek karar verir)
      1. EVET : Kullanıcının kimlik doğrulama sisteminizde eşleşen bir hesabı var mı? (Onaylamak için check amacı çağrılır)
        1. EVET : get intent çağrılır ve get intent başarılı bir şekilde döndürülürse hesap bağlanır.
        2. HAYIR : Yeni Hesap Oluşturulsun mu? (Kullanıcı EVET veya HAYIR'ı seçerek karar verir; yalnızca hizmetiniz hesap oluşturmayı destekliyorsa geçerlidir)
          1. EVET : create intent çağrılır ve create intent başarılı bir şekilde döndürülürse hesap bağlanır.
          2. HAYIR : OAuth bağlantı akışı tetiklenir, kullanıcı tarayıcısına yönlendirilir ve farklı bir e-posta adresiyle bağlantı oluşturma seçeneği sunulur.
      2. HAYIR : OAuth bağlantı akışı tetiklenir, kullanıcı tarayıcısına yönlendirilir ve farklı bir e-postayla bağlantı oluşturma seçeneği sunulur.
    2. HAYIR : Kullanıcının kimlik doğrulama sisteminizde eşleşen bir hesabı var mı? (Onaylamak için check amacı çağrılır)
      1. EVET : getintent çağrılır ve get intent başarılı bir şekilde döndürülürse hesap bağlanır.
      2. HAYIR : Hizmetiniz hesap oluşturmayı destekliyorsa create amacı çağrılır ve oluşturma amacı başarılı bir şekilde döndürülürse hesap bağlanır. Hesap oluşturma desteklenmiyorsa yedek OAuth bağlantı akışını tetiklemek için uç noktanız HTTP 401 linking_error döndürmelidir.

Uygulama Tarifi

Jeton değişimi uç noktanız, gerekli check ve get amaçlarını ve isteğe bağlı olarak Basitleştirilmiş Bağlantı'yı desteklemek için create amacını uygulamalıdır.

Farklı amaçları işlemek için aşağıdaki adımları uygulayın:

Check for an existing user account (check intent)

Google calls your token exchange endpoint to verify if the Google user exists in your system. For parameter details, see Streamlined Linking Intents.

Implementation Recipe

To handle the required check intent, perform the following actions:

  1. Validate the request:

    • Verify client_id, client_secret, and grant_type (must be urn:ietf:params:oauth:grant-type:jwt-bearer).
    • Validate the assertion (JWT) using the criteria in JWT Validation.

  2. Lookup user:

    • Check if the Google Account ID (sub) or email address in the JWT matches a user in your database.

  3. Respond:

    • If found: Return HTTP 200 OK with {"account_found": "true"}.
    • If not found: Return HTTP 404 Not Found with {"account_found": "false"}.

Otomatik bağlamayı işleme (amaç alma)

Hesap varsa Google, jetonları almak için intent=get ile uç noktanızı arar. Parametre ayrıntıları için Basitleştirilmiş Bağlantı Amaçları başlıklı makaleyi inceleyin.

Uygulama Tarifi

Gerekli get amacını işlemek için aşağıdaki işlemleri yapın:

  1. İsteği doğrulayın:

    • client_id, client_secret ve grant_type uygulamalarını doğrulayın.
    • assertion (JWT) öğesini doğrulayın.

  2. Kullanıcıyı arama:

    • Kullanıcının sub veya email talebini kullanarak mevcut olduğunu doğrulayın.

  3. Yanıtla:

    • Başarılı olursa: JSON yanıtında (HTTP 200 OK) access_token, refresh_token ve expires_in oluşturup döndürün.
    • Bağlama işlemi başarısız olursa: 401 Unauthorized ile HTTP {"error": "linking_error"} döndürün ve standart OAuth bağlamaya geri dönmek için isteğe bağlı bir login_hint ekleyin.

Google ile oturum açma özelliğini kullanarak hesap oluşturma işlemini gerçekleştirme (oluşturma amaçlı)

Hizmetiniz hesap oluşturmayı destekliyorsa ve mevcut bir hesap yoksa Google, yeni bir kullanıcı oluşturmak için intent=create ile uç noktanızı çağırır. Parametre ayrıntıları için Basitleştirilmiş Bağlantı Amaçları başlıklı makaleyi inceleyin.

Uygulama Tarifi

İsteğe bağlı create amacını işlemek için aşağıdaki işlemleri yapın:

  1. İsteği doğrulayın:

    • client_id, client_secret ve grant_type uygulamalarını doğrulayın.
    • assertion (JWT) öğesini doğrulayın.

  2. Kullanıcının mevcut olmadığını doğrulayın:

    • sub veya email karakterinin veritabanınızda olup olmadığını kontrol edin.
    • Kullanıcı varsa: OAuth bağlantısına geri dönüşü zorlamak için HTTP 401 Unauthorized ile {"error": "linking_error", "login_hint": "USER_EMAIL"} döndürün.

  3. Hesap oluşturma:

    • Yeni bir kullanıcı kaydı oluşturmak için JWT'deki sub, email, name ve picture taleplerini kullanın.

  4. Yanıtla:

    • JSON yanıtında jeton oluşturma ve döndürme (HTTP 200 OK).

Google API'si istemci kimliğinizi alma

Hesap bağlama kayıt işlemi sırasında Google API istemci kimliğinizi sağlamanız gerekir. OAuth bağlantısı oluşturma adımlarını tamamlarken oluşturduğunuz projeyi kullanarak API istemci kimliğinizi almak için. Bunun için aşağıdaki adımları uygulayın:

  1. Müşteriler sayfasına gidin.

  2. Bir Google API'leri projesi oluşturun veya seçin.

    Projenizde Web uygulaması türü için istemci kimliği yoksa istemci kimliği oluşturmak üzere İstemci oluştur'u tıklayın. Sitenizin alan adını Yetkilendirilmiş JavaScript kaynakları kutusuna eklediğinizden emin olun. Yerel testler veya geliştirme yaparken http://localhost ve http://localhost:<port_number> öğelerini Yetkilendirilmiş JavaScript kaynakları alanına eklemeniz gerekir.

Uygulamanızı doğrulama

您可以使用 OAuth 2.0 Playground 工具验证您的实现。

在该工具中，执行以下步骤：

  1. 点击配置 以打开“OAuth 2.0 配置”窗口。
  2. 在 OAuth flow（OAuth 流程）字段中，选择 Client-side（客户端）。
  3. 在 OAuth Endpoints 字段中，选择 Custom。
  4. 在相应字段中指定您的 OAuth 2.0 端点以及您分配给 Google 的客户端 ID。
  5. 在第 1 步部分中，请勿选择任何 Google 范围。请将此字段留空，或输入适用于您服务器的范围（如果您不使用 OAuth 范围，则输入任意字符串）。完成后，点击 Authorize APIs。
  6. 在第 2 步和第 3 步部分中，完成 OAuth 2.0 流程，并验证每个步骤是否按预期运行。

您可以使用 Google 账号关联演示工具验证您的实现。

在该工具中，执行以下步骤：

  1. 点击使用 Google 账号登录按钮。
  2. 选择您要关联的账号。
  3. 输入服务 ID。
  4. （可选）输入您将请求访问的一个或多个范围。
  5. 点击开始演示。
  6. 当系统提示时，请确认您可以同意或拒绝关联请求。
  7. 确认您已重定向到相应平台。