Android uygulamaları ve web sitelerinde sorunsuz kimlik bilgisi paylaşımını ayarlayın

Uygulamalarınız ve web siteleriniz arasında platformlar arası sorunsuz kimlik bilgisi paylaşımını etkinleştirerek kullanıcıların rahatlığını en üst düzeye çıkarın. Birden fazla web sitesi ve Android uygulaması bir hesap yönetimi arka ucunu paylaştığı zaman bu özellik, kullanıcıların kimlik bilgilerini bir kez kaydetmesine ve bağlı herhangi bir web sitesinde veya Android uygulamasında otomatik olarak önerilmesine olanak tanır.

Kimlik bilgisi paylaşımını ayarlamak için desteklenen iki yöntem vardır:

  • Play Console: Android uygulamalarıyla kimlik bilgisi paylaşımı ayarlanırken çoğu geliştirici için önerilir. Bu yöntem, uygulamanızın yeni bir sürümünü yayınlamanıza gerek kalmadan kimlik bilgisi paylaşımını yapılandırmanıza olanak tanır. Play Console'u kullanırken bile web sitenizde geçerli bir assetlinks.json dosyası yayınlamanız gerektiğini unutmayın.
  • Dijital Öğe Bağlantıları (DAL'lar): Daha karmaşık yapılandırmalara sahip birden fazla uygulama veya alanı destekleme gibi gelişmiş kullanım alanları için uygundur.

En iyi uygulamalar

Optimum kullanıcı deneyimi ve güvenlik için aşağıdaki temas noktalarında sorunsuz kimlik bilgisi paylaşımı uygulayın:

  • Oturum açma formu: Otomatik kimlik bilgisi doldurma özelliğini etkinleştirin.
  • Kayıt formu: Platformlar arasında kullanılacak yeni kimlik bilgilerini güvenli bir şekilde saklayın.
  • Şifre değiştirme formu: Şifre güncellemelerini tüm platformlarda senkronize edin.
  • Şifre sıfırlama formu: Tüm platformların güncellenmesi için tek bir şifre sıfırlamasına izin verin.
  • Web görünümü alanları: Kimlik bilgisi paylaşımını, uygulamanızda hesap yönetimini (barındırma oturumu açma, kaydolma, şifre değiştirme veya şifre sıfırlama formları) yöneten web görünümü alanlarına genişletin.
  • Android uygulamaları

Bu yaklaşım, hem kullanıcı rahatlığını hem de güvenliği artıran birleşik bir kimlik bilgisi yönetim sistemi oluşturur.

Hesap yönetimi web sitelerinizi tasarlarken hesap yönetimi siteleriyle ilgili aşağıdaki en iyi uygulamaları uygulamanızı öneririz:

Android uygulamalarınızı tasarlarken uygulamanızı Android Kimlik Bilgisi Yöneticisi ile entegre etmenizi öneririz.

Play Console'u kullanarak kimlik bilgisi paylaşımını ayarlama

Artık Android uygulamanızın yeni bir sürümünü yayınlamadan doğrudan Play Console'dan sorunsuz kimlik bilgisi paylaşımını etkinleştirebilirsiniz. Bu yöntem, kimlik bilgisi paylaşımı yapılandırmalarınızı Play Console arayüzü üzerinden yöneterek süreci basitleştirir.

Ön koşullar

Play Console'u kullanarak kimlik bilgisi paylaşımını ayarlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • Derin bağlantılar ve Uygulama yapılandırması bölümlerine erişmek için gerekli Play Console izinleri. Hesap sahibi değilseniz Play Console yöneticinizden size uygun erişimi vermesini isteyin.
  • Digital Asset Links (DAL'ler) söz dizimini izleyerek her bir alanda bir /.well-known/assetlinks.json dosyası yayınlama olanağı.

Yeni bir alan için kimlik bilgisi paylaşımını etkinleştirme

Play Console'da yeni bir alan için sorunsuz kimlik bilgisi paylaşımını ayarlamak üzere aşağıdaki adımları uygulayın:

  1. Play Console'u açıp Derin bağlantılar sayfasına (Kullanıcı sayısını artırma > Derin bağlantılar) gidin.
  2. Uygulama yapılandırması sekmesinde Alan ekle'yi tıklayın.
  3. Web sitenizin alanını girin.
  4. Kimlik bilgisi paylaşımını etkinleştir düğmesini açın.
  5. Oluşturulan JSON dosyasını kopyalayın ve belirtilen konumda yayınlayın (https://YOUR_DOMAIN/.well-known/assetlinks.json protokole göre) veya ilgili bilgileri mevcut assetlinks.json dosyasına ekleyin.
  6. Web sitesi ilişkilendirmesi oluştur'u tıklayın.

İşlem başarılı olursa Derin bağlantılar sayfasına geri dönersiniz.

Mevcut bir alan için kimlik bilgisi paylaşımını etkinleştirme

Play Console'da mevcut bir alan için sorunsuz kimlik bilgisi paylaşımını ayarlamak üzere aşağıdaki adımları uygulayın:

  1. Uygulama yapılandırması sekmesini seçin.
  2. Alanlar bölümündeki Uygulama yapılandırması altında Kimlik bilgisi paylaşımı sütununda 'ı tıklayın.
  3. Oluşturulan JSON dosyasını kopyalayın ve belirtilen konumda yayınlayın (veya ilgili bilgileri mevcut assetlinks.json dosyasına ekleyin).
  4. Kimlik bilgisi paylaşımını etkinleştir'i tıklayın.

İşlem başarılı olursa Derin bağlantılar sayfasına geri dönersiniz.

Kimlik bilgisi paylaşımını yalnızca Digital Asset Links (DAL'ler) kullanarak ayarlama

Birden fazla uygulama veya web sitesini içeren karmaşık kurulumlarda, kimlik bilgisi paylaşımını manuel olarak yapılandırmak için Dijital Öğe Bağlantıları'nı (DAL'lar) kullanın.

Ön koşullar

Sorunsuz kimlik bilgisi paylaşımını ayarlamadan önce her platform için aşağıdakilere sahip olduğunuzdan emin olun:

Her Android uygulaması için:

Her web sitesi için:

  • Digital Asset Links (DAL'ler) söz dizimine uygun olarak her bir alanda bir /.well-known/assetlinks.json dosyası yayınlayabilme.
  • Tüm hesap yönetimi alanlarına (oturum açma, kaydolma, şifre değiştirme veya şifre sıfırlama formları) HTTPS üzerinden erişilebilmelidir.

Android uygulamaları ve web siteleri arasında sorunsuz kimlik bilgisi paylaşımını etkinleştirme

Uygulamalar ve web siteleri arasında sorunsuz kimlik bilgisi paylaşımını yapılandırmak için hangi öğelerin (web siteleri veya Android uygulamaları) kimlik bilgisi paylaşmasına izin verildiğini belirten Dijital Öğe Bağlantıları beyan listeleri oluşturup yayınlarsınız.

Kimlik bilgisi paylaşımı ilişkisi beyan etmek için:

  1. DALs ifade listesi söz dizimini izleyerek web sitesine ve Android uygulamasına bağlantı veren ifadeler içeren bir assetlinks.json dosyası oluşturun:

    [
      {
        "relation":[
          "delegate_permission/common.get_login_creds"
        ],
        "target":{
          "namespace":"web",
          "site":URL
        }
      },
      {
        "relation":[
          "delegate_permission/common.get_login_creds"
        ],
        "target":{
          "namespace":"android_app",
          "package_name":"APP_ID",
          "sha256_cert_fingerprints":[
            "SHA_HEX_VALUE"
          ]
        }
      }
    ]
    

    Burada URL sitenizin URL'si, APP_ID Android uygulama kimliğiniz ve SHA_HEX_VALUE Android uygulamanızın imza sertifikasının SHA256 parmak izidir.

    relation alanı, tanımlanan ilişkiyi açıklar. Uygulamaların ve sitelerin oturum açma kimliklerini paylaştığını belirtmek için ilişkileri delegate_permission/common.get_login_creds olarak belirtin. DAL'lardaki İlişki Dizelerini hakkında daha fazla bilgi edinin.

    target alanı, beyanın geçerli olduğu öğeyi belirten bir nesnedir.

    Aşağıdaki alanlar bir web sitesini tanımlar:

    namespace

    web

    site

    Web sitesinin URL'si (https://domain[:optional_port] biçiminde). Örneğin, https://www.example.com.

    HTTPS için 443 numaralı bağlantı noktası kullanılırken domain tam nitelikli olmalı ve optional_port atlanmalıdır.

    site hedefi yalnızca bir kök alan olabilir: Uygulama ilişkilendirmesini belirli bir alt dizinle sınırlayamazsınız. URL'ye yol (ör. son eğik çizgi) eklemeyin.

    Alt alan adlarının eşleştiği kabul edilmez. Yani domain'yi www.example.com olarak belirtirseniz www.counter.example.com alanı uygulamanızla ilişkilendirilmez.

    Aşağıdaki alanlar bir Android uygulamasını tanımlar:

    ad alanı

    android_app

    package_name

    Uygulamanın manifest dosyasında beyan edilen paket adı. Örneğin, com.example.android

    sha256_cert_fingerprints

    Uygulamanızın imzalama sertifikasının SHA256 parmak izleri.

  2. Digital Asset Links JSON dosyasını, oturum açma alanlarında aşağıdaki konumda barındırın: https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json . Burada DOMAIN tam nitelikli olmalıdır ve HTTPS için 443 bağlantı noktası kullanıldığında OPTIONAL_PORT atlanmalıdır.

  3. Android uygulamanızın res/values/strings.xml dosyasına, 1. adımda oluşturduğunuz beyan listesine bağlantı veren bir beyan yerleştirerek Android uygulamasında ilişkilendirmeyi beyan edin. Yüklenecek assetlinks.json dosyalarını belirten bir nesne ekleyin. Örneğin:

      <string name="asset_statements" translatable="false">
    [{
      \"include\": \"https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json\"
    }]
    </string>
    

    DOMAIN ve OPTIONAL_PORT'yi (HTTPS için 443 numaralı bağlantı noktası kullanılırken atlanması gerekir) https://www.example.com ile değiştirin. Dizide kullandığınız apostrofları ve tırnak işaretlerini kod dışına alın.

    DAL dokümanlarında gösterildiği gibi strings.xml dosyanıza JSON snippet'i de ekleyebilirsiniz ancak include ifadesini kullanmak, uygulamanızın yeni bir sürümünü yayınlamadan ifadeleri değiştirmenize olanak tanır.

  4. Uygulamanızın <application> altındaki AndroidManifest.xml dosyasına aşağıdaki satırı ekleyerek manifest'teki beyana referans verin:

    <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>
    
  5. Android uygulamanızın yeni sürümünü Google Play Console'da yayınlama

Bu adımları uyguladıktan sonra web siteniz ile Android uygulamanız arasında sorunsuz kimlik bilgisi paylaşımını başarıyla ayarlamış olursunuz.

Kimlik bilgisi paylaşımı için DAL'ları ayarlamayla ilgili tek geçerli yöntemin bu olmadığını ancak bu yaklaşımın, sorunsuz kimlik bilgisi paylaşımı ağınıza gelecekte yeni öğeler ekleme sürecini basitleştirdiğini, kodun yeniden kullanılabilirliğini desteklediğini ve güncellemeler sırasında hata olasılığını azalttığını unutmayın.