Android'de Apple'ı Kullanarak Kimlik Doğrulama

Uçtan uca OAuth 2.0 oturum açma akışını gerçekleştirmek için Firebase SDK'yı kullanarak kullanıcılarınızın Apple kimliklerini kullanarak Firebase ile kimlik doğrulamasına izin verebilirsiniz.

Sen başlamadan önce

Apple kullanarak kullanıcılarda oturum açmak için önce Apple'ın geliştirici sitesinde Apple ile Giriş Yap özelliğini yapılandırın, ardından Apple'ı Firebase projeniz için oturum açma sağlayıcısı olarak etkinleştirin.

Apple Geliştirici Programına katılın

Apple ile Giriş Yap, yalnızca Apple Geliştirici Programı üyeleri tarafından yapılandırılabilir.

Apple Developer sitesinde şunları yapın:

Web için Apple ile Giriş Yapmayı Yapılandır'ın ilk bölümünde açıklandığı gibi web sitenizi uygulamanızla ilişkilendirin. İstendiğinde, aşağıdaki URL'yi Dönüş URL'si olarak kaydedin:
```
https://YOUR_FIREBASE_PROJECT_ID.firebaseapp.com/__/auth/handler
```
Firebase proje kimliğinizi Firebase konsol ayarları sayfasından alabilirsiniz .
İşiniz bittiğinde, bir sonraki bölümde ihtiyaç duyacağınız yeni Servis Kimliğinizi not edin.
Apple özel anahtarıyla Giriş Yapın . Sonraki bölümde yeni özel anahtarınıza ve anahtar kimliğinize ihtiyacınız olacak.
Firebase Authentication'ın e-posta bağlantısı girişi, e-posta adresi doğrulama, hesap değişikliği iptali gibi kullanıcılara e-posta gönderen özelliklerinden herhangi birini kullanıyorsanız , Apple özel e-posta aktarma hizmetini yapılandırın ve noreply@ YOUR_FIREBASE_PROJECT_ID .firebaseapp.com (veya Apple'ın Firebase Authentication tarafından gönderilen e-postaları anonimleştirilmiş Apple e-posta adreslerine aktarabilmesi için özelleştirilmiş e-posta şablonu etki alanınız).

Firebase'i Android projenize ekleyin . Firebase konsolunda uygulamanızı kurarken uygulamanızın SHA-1 imzasını kaydettiğinizden emin olun.
In Firebase konsoluna , Auth bölümünü açın. Giriş yöntemi sekmesinde, Apple sağlayıcısını etkinleştirin. Önceki bölümde oluşturduğunuz Hizmet Kimliğini belirtin. Ayrıca, OAuth kod akışı yapılandırması bölümünde , Apple Ekip Kimliğinizi ve önceki bölümde oluşturduğunuz özel anahtarı ve anahtar kimliğini belirtin.

Apple'ın anonimleştirilmiş veri gereksinimlerine uyun

Apple ile Giriş Yap, kullanıcılara oturum açarken e-posta adresleri de dahil olmak üzere verilerini anonimleştirme seçeneği sunar. Bu seçeneği seçen kullanıcılar privaterelay.appleid.com etki alanı ile e-posta adreslerine sahiptir. Uygulamanızda Apple ile Giriş Yap özelliğini kullandığınızda, bu anonimleştirilmiş Apple Kimlikleriyle ilgili olarak Apple'ın geçerli geliştirici politikalarına veya hükümlerine uymanız gerekir.

Bu, kişisel bilgileri doğrudan anonimleştirilmiş bir Apple Kimliği ile ilişkilendirmeden önce gerekli tüm kullanıcı onayını almayı içerir. Firebase Kimlik Doğrulaması kullanılırken bu, aşağıdaki eylemleri içerebilir:

Bir e-posta adresini anonimleştirilmiş bir Apple Kimliğine bağlayın veya tersini yapın.
Bir telefon numarasını anonimleştirilmiş bir Apple Kimliğine bağlayın veya tam tersi
Anonim olmayan bir sosyal kimlik bilgilerini (Facebook, Google, vb.) Anonimleştirilmiş bir Apple Kimliğine bağlayın veya tam tersi.

Yukarıdaki liste kapsamlı değildir. Uygulamanızın Apple gereksinimlerini karşıladığından emin olmak için geliştirici hesabınızın Üyelik bölümündeki Apple Geliştirici Programı Lisans Sözleşmesine bakın.

Firebase SDK ile oturum açma akışını yönetin

Android'de Apple hesaplarını kullanarak Firebase ile kullanıcılarınızın kimliğini doğrulamanın en kolay yolu, tüm oturum açma akışını Firebase Android SDK ile işlemektir.

Firebase Android SDK ile oturum açma akışını yönetmek için şu adımları izleyin:

Bir örneğini Construct OAuthProvider sağlayıcı numarası ile Builder kullanarak apple.com :

Java

OAuthProvider.Builder provider = OAuthProvider.newBuilder("apple.com");

Kotlin + KTX

val provider = OAuthProvider.newBuilder("apple.com")

İsteğe bağlı: Kimlik doğrulama sağlayıcısından talep etmek istediğiniz varsayılanın ötesinde ek OAuth 2.0 kapsamları belirtin.
Java
```
List<String> scopes =
    new ArrayList<String>() {
      {
        add("email");
        add("name");
      }
    };
provider.setScopes(scopes);
```
Kotlin + KTX
```
provider.setScopes(arrayOf("email", "name"))
```
Varsayılan olarak, e-posta adresi başına bir hesap etkinleştirildiğinde, Firebase e-posta ve ad kapsamları ister. Bu ayarı e-posta adresi başına Birden çok hesap olarak değiştirirseniz Firebase, siz belirtmedikçe Apple'dan herhangi bir kapsam istemez.
İsteğe bağlı: Apple'ın oturum açma ekranını İngilizce dışında bir dilde görüntülemek istiyorsanız, locale parametresini ayarlayın. Desteklenen yerel ayarlar için Apple ile Giriş Yap belgelerine bakın.
Java
```
// Localize the Apple authentication screen in French.
provider.addCustomParameter("locale", "fr");
```
Kotlin + KTX
```
// Localize the Apple authentication screen in French.
provider.addCustomParameter("locale", "fr")
```

OAuth sağlayıcı nesnesini kullanarak Firebase ile kimlik doğrulayın. Diğer FirebaseAuth işlemlerinden farklı olarak, bunun bir Özel Chrome Sekmesi açarak kullanıcı arayüzünüzü kontrol altına alacağını unutmayın. Sonuç olarak, OnSuccessListener ve OnFailureListener Activity'inize OnSuccessListener çünkü bunlar işlem OnFailureListener hemen ayrılacaklardır.

Önce bir yanıt alıp almadığınızı kontrol etmelisiniz. Bu yöntemle oturum açmak, Etkinliğinizi arka plana koyar, bu da oturum açma akışı sırasında sistem tarafından geri alınabileceği anlamına gelir. Böyle bir durumda kullanıcının tekrar denemesini istemediğinizden emin olmak için, bir sonucun zaten mevcut olup olmadığını kontrol etmelisiniz.

Bekleyen bir sonuç olup olmadığını kontrol etmek için getPendingAuthResult() çağırın:

Java

mAuth = FirebaseAuth.getInstance();
Task<AuthResult> pending = mAuth.getPendingAuthResult();
if (pending != null) {
    pending.addOnSuccessListener(new OnSuccessListener<AuthResult>() {
        @Override
        public void onSuccess(AuthResult authResult) {
            Log.d(TAG, "checkPending:onSuccess:" + authResult);
            // Get the user profile with authResult.getUser() and
            // authResult.getAdditionalUserInfo(), and the ID
            // token from Apple with authResult.getCredential().
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            Log.w(TAG, "checkPending:onFailure", e);
        }
    });
} else {
    Log.d(TAG, "pending: null");
}

Kotlin + KTX

val pending = auth.pendingAuthResult
if (pending != null) {
    pending.addOnSuccessListener { authResult ->
        Log.d(TAG, "checkPending:onSuccess:$authResult")
        // Get the user profile with authResult.getUser() and
        // authResult.getAdditionalUserInfo(), and the ID
        // token from Apple with authResult.getCredential().
    }.addOnFailureListener { e ->
        Log.w(TAG, "checkPending:onFailure", e)
    }
} else {
    Log.d(TAG, "pending: null")
}

Bekleyen sonuç yoksa, startActivityForSignInWithProvider() çağırarak oturum açma akışını başlatın:

Java

mAuth.startActivityForSignInWithProvider(this, provider.build())
        .addOnSuccessListener(
                new OnSuccessListener<AuthResult>() {
                    @Override
                    public void onSuccess(AuthResult authResult) {
                        // Sign-in successful!
                        Log.d(TAG, "activitySignIn:onSuccess:" + authResult.getUser());
                        FirebaseUser user = authResult.getUser();
                        // ...
                    }
                })
        .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        Log.w(TAG, "activitySignIn:onFailure", e);
                    }
                });

Kotlin + KTX

auth.startActivityForSignInWithProvider(this, provider.build())
        .addOnSuccessListener { authResult ->
            // Sign-in successful!
            Log.d(TAG, "activitySignIn:onSuccess:${authResult.user}")
            val user = authResult.user
            // ...
        }
        .addOnFailureListener { e ->
            Log.w(TAG, "activitySignIn:onFailure", e)
        }

Firebase Auth tarafından desteklenen diğer sağlayıcıların aksine, Apple bir fotoğraf URL'si sağlamaz.

Ayrıca, kullanıcı e-postasını uygulamayla paylaşmamayı seçtiğinde, Apple bu kullanıcı için uygulamanızla paylaştığı benzersiz bir e-posta adresi ( xyz@privaterelay.appleid.com biçiminde) sağlar. Özel e-posta aktarma hizmetini yapılandırdıysanız Apple, anonimleştirilmiş adrese gönderilen e-postaları kullanıcının gerçek e-posta adresine iletir.

Apple, görünen ad gibi kullanıcı bilgilerini yalnızca bir kullanıcı ilk kez oturum açtığında uygulamalarla paylaşır. Genellikle Firebase, görünen adı bir kullanıcı Apple ile ilk kez oturum getCurrentUser().getDisplayName() ve bunu getCurrentUser().getDisplayName() ile alabilirsiniz getCurrentUser().getDisplayName() . Ancak, Apple'ı daha önce bir kullanıcıyı Firebase kullanmadan uygulamada oturum açmak için kullandıysanız, Apple Firebase'e kullanıcının görünen adını sağlamaz.

Yeniden kimlik doğrulama ve hesap bağlama

Aynı desen, yakın zamanda oturum açmayı gerektiren hassas işlemler için yeni bir kimlik bilgisi almak üzere kullanabileceğiniz startActivityForReauthenticateWithProvider() ile kullanılabilir:

Java

// The user is already signed-in.
FirebaseUser firebaseUser = mAuth.getCurrentUser();

firebaseUser
    .startActivityForReauthenticateWithProvider(/* activity= */ this, provider.build())
    .addOnSuccessListener(
        new OnSuccessListener<AuthResult>() {
          @Override
          public void onSuccess(AuthResult authResult) {
            // User is re-authenticated with fresh tokens and
            // should be able to perform sensitive operations
            // like account deletion and email or password
            // update.
          }
        })
    .addOnFailureListener(
        new OnFailureListener() {
          @Override
          public void onFailure(@NonNull Exception e) {
            // Handle failure.
          }
        });

Kotlin + KTX

// The user is already signed-in.
val firebaseUser = auth.getCurrentUser()

firebaseUser
    .startActivityForReauthenticateWithProvider(/* activity= */ this, provider.build())
    .addOnSuccessListener( authResult -> {
        // User is re-authenticated with fresh tokens and
        // should be able to perform sensitive operations
        // like account deletion and email or password
        // update.
    })
    .addOnFailureListener( e -> {
        // Handle failure.
    })

Ayrıca, farklı kimlik sağlayıcıları mevcut hesaplara bağlamak için linkWithCredential() kullanabilirsiniz.

Apple'ın, Apple hesaplarını diğer verilere bağlamadan önce kullanıcılardan açık izin almanızı gerektirdiğini unutmayın.

Örneğin, bir Facebook hesabını mevcut Firebase hesabına bağlamak için, kullanıcıyı Facebook'ta oturum açarak elde ettiğiniz erişim jetonunu kullanın:

Java

// Initialize a Facebook credential with a Facebook access token.
AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());

// Assuming the current user is an Apple user linking a Facebook provider.
mAuth.getCurrentUser().linkWithCredential(credential)
    .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
      @Override
      public void onComplete(@NonNull Task<AuthResult> task) {
        if (task.isSuccessful()) {
          // Facebook credential is linked to the current Apple user.
          // The user can now sign in to the same account
          // with either Apple or Facebook.
        }
      }
    });

Kotlin + KTX

// Initialize a Facebook credential with a Facebook access token.
val credential = FacebookAuthProvider.getCredential(token.getToken())

// Assuming the current user is an Apple user linking a Facebook provider.
mAuth.getCurrentUser().linkWithCredential(credential)
    .addOnCompleteListener(this, task -> {
        if (task.isSuccessful()) {
          // Facebook credential is linked to the current Apple user.
          // The user can now sign in to the same account
          // with either Apple or Facebook.
        }
      });

Gelişmiş: Oturum açma akışını manuel olarak gerçekleştirin

Ayrıca, Apple Sign-In JS SDK kullanarak, OAuth akışını manuel olarak oluşturarak veya AppAuth gibi bir OAuth kitaplığı kullanarak oturum açma akışını yöneterek bir Apple Hesabı kullanarak Firebase ile kimlik doğrulaması yapabilirsiniz.

Her oturum açma isteği için, aldığınız kimlik jetonunun özellikle uygulamanızın kimlik doğrulama isteğine yanıt olarak verildiğinden emin olmak için kullanacağınız rastgele bir dize ("nonce") oluşturun. Bu adım, tekrar saldırılarını önlemek için önemlidir.

Aşağıdaki örnekte olduğu gibi SecureRandom ile SecureRandom kriptografik olarak güvenli bir nonce oluşturabilirsiniz:

Java

private String generateNonce(int length) {
    SecureRandom generator = new SecureRandom();

    CharsetDecoder charsetDecoder = StandardCharsets.US_ASCII.newDecoder();
    charsetDecoder.onUnmappableCharacter(CodingErrorAction.IGNORE);
    charsetDecoder.onMalformedInput(CodingErrorAction.IGNORE);

    byte[] bytes = new byte[length];
    ByteBuffer inBuffer = ByteBuffer.wrap(bytes);
    CharBuffer outBuffer = CharBuffer.allocate(length);
    while (outBuffer.hasRemaining()) {
        generator.nextBytes(bytes);
        inBuffer.rewind();
        charsetDecoder.reset();
        charsetDecoder.decode(inBuffer, outBuffer, false);
    }
    outBuffer.flip();
    return outBuffer.toString();
}

Kotlin + KTX

private fun generateNonce(length: Int): String {
    val generator = SecureRandom()

    val charsetDecoder = StandardCharsets.US_ASCII.newDecoder()
    charsetDecoder.onUnmappableCharacter(CodingErrorAction.IGNORE)
    charsetDecoder.onMalformedInput(CodingErrorAction.IGNORE)

    val bytes = ByteArray(length)
    val inBuffer = ByteBuffer.wrap(bytes)
    val outBuffer = CharBuffer.allocate(length)
    while (outBuffer.hasRemaining()) {
        generator.nextBytes(bytes)
        inBuffer.rewind()
        charsetDecoder.reset()
        charsetDecoder.decode(inBuffer, outBuffer, false)
    }
    outBuffer.flip()
    return outBuffer.toString()
}

Ardından, nonce'nin SHA246 karmasını onaltılık dize olarak alın:

Java

private String sha256(String s) throws NoSuchAlgorithmException {
    MessageDigest md = MessageDigest.getInstance("SHA-256");
    byte[] digest = md.digest(s.getBytes());
    StringBuilder hash = new StringBuilder();
    for (byte c: digest) {
        hash.append(String.format("%02x", c));
    }
    return hash.toString();
}

Kotlin + KTX

private fun sha256(s: String): String {
    val md = MessageDigest.getInstance("SHA-256")
    val digest = md.digest(s.toByteArray())
    val hash = StringBuilder()
    for (c in digest) {
        hash.append(String.format("%02x", c))
    }
    return hash.toString()
}

Nonce'nin SHA256 hash'ini oturum açma talebinizle birlikte göndereceksiniz ve Apple, yanıtta değişmeden iletecektir. Firebase, orijinal nonce'ye hashing uygulayarak ve Apple tarafından iletilen değerle karşılaştırarak yanıtı doğrular.

OAuth kitaplığınızı veya başka bir yöntemi kullanarak Apple'ın oturum açma akışını başlatın. Hashing uygulanmış nonce'yi isteğinize parametre olarak eklediğinizden emin olun.

Apple'ın yanıtını aldıktan sonra, yanıttan kimlik jetonunu alın ve bir AuthCredential oluşturmak için bunu ve hash AuthCredential nonce kullanın:

Java

AuthCredential credential =  OAuthProvider.newCredentialBuilder("apple.com")
    .setIdTokenWithRawNonce(appleIdToken, rawUnhashedNonce)
    .build();

Kotlin + KTX

val credential =  OAuthProvider.newCredentialBuilder("apple.com")
    .setIdTokenWithRawNonce(appleIdToken, rawUnhashedNonce)
    .build()

Firebase kimlik bilgilerini kullanarak Firebase ile kimlik doğrulayın:

Java

mAuth.signInWithCredential(credential)
    .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
      @Override
      public void onComplete(@NonNull Task<AuthResult> task) {
        if (task.isSuccessful()) {
          // User successfully signed in with Apple ID token.
          // ...
        }
      }
    });

Kotlin + KTX

auth.signInWithCredential(credential)
      .addOnCompleteListener(this) { task ->
          if (task.isSuccessful) {
            // User successfully signed in with Apple ID token.
            // ...
          }
      }

signInWithCredential çağrısı başarılı olursa, kullanıcının hesap verilerini almak için getCurrentUser yöntemini kullanabilirsiniz.

Sonraki adımlar

Bir kullanıcı ilk kez oturum açtıktan sonra, yeni bir kullanıcı hesabı oluşturulur ve oturum açan kullanıcı kimlik bilgilerine (yani kullanıcı adı ve parolası, telefon numarası veya kimlik doğrulama sağlayıcı bilgileri) bağlanır. Bu yeni hesap, Firebase projenizin bir parçası olarak depolanır ve kullanıcının nasıl oturum açtığına bakılmaksızın projenizdeki her uygulamada bir kullanıcıyı tanımlamak için kullanılabilir.

Uygulamalarınızda, kullanıcının temel profil bilgilerini FirebaseUser nesnesinden alabilirsiniz. Kullanıcıları Yönetme konusuna bakın.
Firebase Realtime Database ve Cloud Storage Güvenlik Kurallarınızda , oturum açan kullanıcının benzersiz kullanıcı kimliğini auth değişkeninden alabilir ve bir kullanıcının hangi verilere erişebileceğini kontrol etmek için kullanabilirsiniz.

Yetkilendirme sağlayıcı kimlik bilgilerini mevcut bir kullanıcı hesabına bağlayarak , kullanıcıların birden çok kimlik doğrulama sağlayıcısı kullanarak uygulamanızda oturum açmasına izin verebilirsiniz .

Bir kullanıcının oturumunu kapatmak için signOut arayın:

Java

FirebaseAuth.getInstance().signOut();MainActivity.java

Kotlin + KTX

Firebase.auth.signOut()MainActivity.kt

Android'de Apple'ı Kullanarak Kimlik Doğrulama

Sen başlamadan önce

Apple Geliştirici Programına katılın

Apple ile Giriş Yapmayı Yapılandırma

Apple'ı oturum açma sağlayıcı olarak etkinleştirin

Apple'ın anonimleştirilmiş veri gereksinimlerine uyun

Firebase SDK ile oturum açma akışını yönetin

Java

Kotlin + KTX

Java

Kotlin + KTX

Java

Kotlin + KTX

Java

Kotlin + KTX

Java

Kotlin + KTX

Yeniden kimlik doğrulama ve hesap bağlama

Java

Kotlin + KTX

Java

Kotlin + KTX

Gelişmiş: Oturum açma akışını manuel olarak gerçekleştirin

Java

Kotlin + KTX

Java

Kotlin + KTX

Java

Kotlin + KTX

Java

Kotlin + KTX

Sonraki adımlar

Java

Kotlin + KTX