OAuth 2.0 İstemci Kimliği alın

Genel bakış

Android için Google Fit'i kullanmak istiyorsanız Android uygulamalarına yönelik bir OAuth 2.0 istemci kimliğine ihtiyacınız vardır.

Tüm Android uygulamaları, özel anahtara sahip olduğunuz dijital bir sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için uygulamalarınızı imzalamayla ilgili Android kılavuzuna bakın.

Android OAuth istemci kimlikleri belirli sertifika/paket çiftlerine bağlanır. Uygulamanın kaç kullanıcınız olursa olsun, her sertifika için yalnızca bir kimliğe ihtiyacınız olur.

Uygulamanızın kimliğini almak için birkaç adım gerekir. Bu adımlar aşağıda özetlenmiştir.

1. Uygulamanızın sertifika bilgilerini bulun.
2. Google API Konsolu'nda bir proje oluşturun veya bir projeyi değiştirin.
3. OAuth 2.0 istemci kimliği isteyin.

Uygulamanızın sertifika bilgilerini bulma

API anahtarı, uygulamanızın SHA-1 parmak izi olarak bilinen dijital sertifikasının kısa biçimine dayanır. Sertifikanızın SHA-1 parmak izini görüntülemek için öncelikle doğru sertifikayı kullandığınızdan emin olun. İki sertifikanız olabilir:

• Hata ayıklama sertifikası: Android SDK araçları, bir hata ayıklama derlemesi yaptığınızda bu sertifikayı otomatik olarak oluşturur. Bu sertifikayı yalnızca test ettiğiniz uygulamalarla kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulama yayınlamayı denemeyin. Hata ayıklama sertifikası, Android Geliştirici Belgeleri'ndeki Hata Ayıklama Modunda Oturum Açma bölümünde daha ayrıntılı olarak açıklanmıştır.
• Sürüm sertifikası: Bir sürüm derlemesi yaptığınızda Android SDK araçları bu sertifikayı oluşturur. Bu sertifikayı keytool programını kullanarak da oluşturabilirsiniz. Uygulamanızı dünyaya yayınlamaya hazır olduğunuzda bu sertifikayı kullanın.

keytool programını -v parametresiyle kullanarak bir sertifikanın SHA-1 parmak izini görüntülemek için aşağıdaki adımları uygulayın. Keytool hakkında daha fazla bilgi için Oracle belgelerine bakın.

Hata ayıklama sertifikası

Hata ayıklama sertifikası parmak izini görüntüleme

1. Hata ayıklama anahtar deposu dosyanızı bulun. Dosya adı debug.keystore ve projenizi ilk oluşturduğunuzda oluşturulur. Varsayılan olarak Android Virtual Device (AVD) dosyalarınızla aynı dizinde depolanır:

   • macOS ve Linux: ~/.android/
   • Windows Vista ve Windows 7: C:\Users\your_user_name\.android\

2. SHA-1 parmak izini listeleyin:

   • Linux veya macOS'te bir terminal penceresi açıp aşağıdakileri girin:

     keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

   • Windows Vista ve Windows 7 için şu komutu çalıştırın:

     keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Şuna benzer bir çıkış alırsınız:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Sürüm sertifikası

Sürüm sertifikası parmak izi gösteriliyor

1. Sürüm sertifikası anahtar deposu dosyanızı bulun. Sürüm anahtar deposunun varsayılan konumu veya adı yoktur. Uygulamanızı yayınlanmak üzere derlerken bir kimlik belirtmezseniz derlemede .apk imzası kaldırılır ve yayınlamadan önce imzalamanız gerekir. Sürüm sertifikası için sertifika takma adı ve anahtar deposu ile sertifika şifreleri de gereklidir. Bir anahtar deposundaki tüm anahtarların takma adlarını aşağıdakileri girerek listeleyebilirsiniz:

   keytool -list -keystore your_keystore_name

   your_keystore_name değerini .keystore uzantısı dahil olmak üzere tam nitelikli yol ve anahtar deposu adıyla değiştirin. Anahtar deposunun şifresini girmeniz istenir. Ardından keytool, anahtar deposundaki tüm takma adları görüntüler.

2. Bir terminal veya komut istemine aşağıdaki komutu girin:

   keytool -list -v -keystore your_keystore_name -alias your_alias_name

   your_keystore_name değerini .keystore uzantısı dahil olmak üzere tam nitelikli yol ve anahtar deposu adıyla değiştirin. your_alias_name yerine, sertifikayı oluştururken atadığınız takma adla değiştirin.

Şuna benzer bir çıkış alırsınız:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 ile başlayan satır, sertifikanın SHA-1 parmak izini içerir. Parmak izi, iki noktayla ayrılmış 20 adet iki basamaklı onaltılık sayıdan oluşur.

Dikkat: Anahtar deponuzu ve anahtarınızı korumak için bilgisayarınızın güvenliğinden emin olmadığınız sürece komut satırına storepass veya keypass bağımsız değişkenlerini girmeyin. Örneğin, herkese açık bir bilgisayarda bir kullanıcı terminal penceresi geçmişinize veya çalışan işlemlerin listesine bakabilir, şifreyi alabilir ve ardından imzalama sertifikanıza yazma erişimi elde edebilir. Bu, söz konusu kişinin uygulamanızı değiştirmesine veya kendi uygulamasıyla değiştirmesine olanak sağlar.

Google API Konsolu'nda OAuth 2.0 istemci kimliği isteyin

Google API Konsolu'nda uygulamanız için bir proje oluşturmak veya mevcut bir projeyi değiştirmek, Fitness API'yi etkinleştirmek ve OAuth 2.0 istemci kimliği istemek için aşağıdaki adımları uygulayın.

Süreç boyunca yönlendirilmek ve Fitness API'yi otomatik olarak etkinleştirmek isterseniz

İstemci Kimliği edinin

Alternatif olarak, Google API Konsolu'nda Fitness API'yi etkinleştirmek ve OAuth 2.0 istemci kimliği almak için aşağıdaki adımları uygulayın.

1. Google API Konsolu'na gidin.
2. Bir proje seçin veya yeni bir proje oluşturun. Uygulamanızın Android ve REST sürümleri için de aynı projeyi kullanın.
3. Fitness API'yi etkinleştirmek için Devam'ı tıklayın.
4. Kimlik bilgilerine git'i tıklayın.
5. Yeni kimlik bilgileri'ni tıklayın, ardından OAuth İstemci Kimliği'ni seçin.
6. Uygulama türü altında Android'i seçin.

7. Açılan iletişim kutusunda, uygulamanızın SHA-1 parmak izini ve paket adını girin. Örneğin:

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

   com.example.android.fit-example

8. Oluştur'u tıklayın. Yeni Android OAuth 2.0 İstemci Kimliğiniz ve gizli anahtarınız, projenizin kimlikler listesinde görünür. OAuth 2.0 İstemci Kimliği, bir karakter dizesidir. Örnek:

   780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com