Firebase Authentication with Identity Platform sürümüne yükselttiyseniz OpenID Connect (OIDC) uyumlu bir sağlayıcı seçerek kullanıcılarınızın kimliğini Firebase ile doğrulayabilirsiniz. Bu sayede, Firebase tarafından yerel olarak desteklenmeyen kimlik sağlayıcıları kullanabilirsiniz.
Başlamadan önce
Kullanıcıların bir OIDC sağlayıcı kullanarak oturum açması için öncelikle sağlayıcıdan bazı bilgiler toplamanız gerekir:
İstemci kimliği: Sağlayıcıya özgü, uygulamanızı tanımlayan bir dize. Sağlayıcınız, desteklediğiniz her platform için size farklı bir istemci kimliği atayabilir. Bu, sağlayıcınız tarafından verilen kimlik jetonlarındaki
audtalebinin değerlerinden biridir.İstemci gizli anahtarı: Sağlayıcının, istemci kimliğinin sahipliğini onaylamak için kullandığı gizli dize. Her istemci kimliği için eşleşen bir istemci gizli anahtarı gerekir. (Bu değer yalnızca, kesinlikle önerilen yetkilendirme kodu akışını kullanıyorsanız gereklidir.)
Veren: Sağlayıcınızı tanımlayan bir dize. Bu değer,
/.well-known/openid-configurationeklendiğinde sağlayıcının OIDC keşif belgesinin konumunu gösteren bir URL olmalıdır. Örneğin, verenhttps://auth.example.comise keşif belgesihttps://auth.example.com/.well-known/openid-configurationadresinde bulunmalıdır.
Yukarıdaki bilgileri edindikten sonra Firebase projeniz için oturum açma sağlayıcısı olarak OpenID Connect'i etkinleştirin:
Firebase Authentication with Identity Platform sürümüne yükseltme yapmadıysanız yükseltin. OpenID Connect kimlik doğrulaması yalnızca yükseltilmiş projelerde kullanılabilir.
Firebase konsolunda Güvenlik > Kimlik doğrulama'ya gidin.
Sign-in method (Oturum açma yöntemi) sekmesinde Add new provider'ı (Yeni sağlayıcı ekle) ve ardından OpenID Connect'i tıklayın.
Yetkilendirme kodu akışını mı yoksa dolaylı izin akışını mı kullanacağınızı seçin.
Sağlayıcınız destekliyorsa her zaman kod akışını kullanmanız gerekir. Dolaylı akış daha az güvenlidir ve kullanılması kesinlikle önerilmez.
Bu sağlayıcıya bir ad verin. Oluşturulan sağlayıcı kimliğini not edin:
oidc.example-providergibi bir kimlik oluşturulur. Uygulamanıza oturum açma kodu eklerken bu kimliğe ihtiyacınız olacak.İstemci kimliğinizi, istemci gizli anahtarınızı ve sağlayıcınızın veren dizesini belirtin. Bu değerler, sağlayıcınızın size atadığı değerlerle tam olarak eşleşmelidir.
Yaptığınız değişiklikleri kaydedin.
Firebase SDK'sı ile oturum açma akışını yönetme
OIDC sağlayıcınızı kullanarak kullanıcılarınızın Firebase ile kimlik doğrulamasını yapmanın en kolay yolu, tüm oturum açma akışını Firebase SDK'sı ile yönetmektir.
Firebase Apple platformları SDK'sı ile oturum açma akışını yönetmek için aşağıdaki adımları uygulayın:
Xcode projenize özel URL şemaları ekleyin:
- Proje yapılandırmanızı açın: Sol ağaç görünümünde proje adını çift tıklayın. TARGETS (HEDEFLER) bölümünden uygulamanızı seçin, ardından Info (Bilgi) sekmesini seçip URL Types (URL Türleri) bölümünü genişletin.
-
+ düğmesini tıklayın ve kodlanmış uygulama kimliğinizi URL şeması olarak ekleyin.
Diğer alanları boş bırakın.
Kodlanmış uygulama kimliğinizi Firebase konsolunda bulabilirsiniz:
Ayarlar > Genel sekmesine gidin, ardından iOS uygulamanızla ilgili ayrıntıları görüntülemek için Uygulamalarınız bölümüne gidin.İşlem tamamlandığında yapılandırmanız aşağıdakine benzer şekilde görünmelidir (ancak uygulamanıza özel değerler içermelidir):
Firebase konsolunda aldığınız sağlayıcı kimliğini kullanarak bir
OAuthProviderörneği oluşturun.Swift
var provider = OAuthProvider(providerID: "oidc.example-provider")Objective-C
FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"oidc.example-provider"];İsteğe bağlı: OAuth isteğiyle göndermek istediğiniz ek özel OAuth parametrelerini belirtin.
Swift
provider.customParameters = [ "login_hint": "user@example.com" ]Objective-C
[provider setCustomParameters:@{@"login_hint": @"user@example.com"}];Desteklediği parametreler için sağlayıcınızla iletişime geçin. Firebase için gerekli parametreleri
setCustomParametersile iletemeyeceğinizi unutmayın. Bu parametreler şunlardır:client_id,response_type,redirect_uri,state,scopeveresponse_mode.İsteğe bağlı: Kimlik doğrulama sağlayıcısından istemek istediğiniz, temel profilin dışındaki ek OAuth 2.0 kapsamlarını belirtin.
Swift
provider.scopes = ["mail.read", "calendars.read"]Objective-C
[provider setScopes:@[@"mail.read", @"calendars.read"]];Desteklediği kapsamlar için sağlayıcınıza danışın.
İsteğe bağlı: Uygulamanızın, kullanıcıya reCAPTCHA gösterirken
SFSafariViewControllerveyaUIWebViewöğesini sunma şeklini özelleştirmek istiyorsanızAuthUIDelegateprotokolüne uygun özel bir sınıf oluşturun.OAuth sağlayıcı nesnesini kullanarak Firebase ile kimlik doğrulama
Swift
// If you created a custom class that conforms to AuthUIDelegate, // pass it instead of nil: provider.getCredentialWith(nil) { credential, error in if error != nil { // Handle error. } if credential != nil { Auth().signIn(with: credential) { authResult, error in if error != nil { // Handle error. } // User is signed in. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // (authResult.credential as? OAuthCredential)?.accessToken // OAuth ID token can also be retrieved: // (authResult.credential as? OAuthCredential)?.idToken } } }Objective-C
// If you created a custom class that conforms to AuthUIDelegate, // pass it instead of nil: [provider getCredentialWithUIDelegate:nil completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) { if (error) { // Handle error. } if (credential) { [[FIRAuth auth] signInWithCredential:credential completion:^(FIRAuthDataResult *_Nullable authResult, NSError *_Nullable error) { if (error) { // Handle error. } // User is signed in. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).accessToken // OAuth ID token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).idToken }]; } }];Yukarıdaki örneklerde oturum açma akışlarına odaklanılmış olsa da
linkWithCredentialkullanarak bir OIDC sağlayıcısını mevcut bir kullanıcıya bağlayabilirsiniz. Örneğin, birden fazla sağlayıcıyı aynı kullanıcıya bağlayarak kullanıcının her ikisiyle de oturum açmasına izin verebilirsiniz.Swift
Auth().currentUser.link(withCredential: credential) { authResult, error in if error != nil { // Handle error. } // OIDC credential is linked to the current user. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // (authResult.credential as? OAuthCredential)?.accessToken // OAuth ID token can also be retrieved: // (authResult.credential as? OAuthCredential)?.idToken }Objective-C
[[FIRAuth auth].currentUser linkWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { // Handle error. } // OIDC credential is linked to the current user. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).accessToken // OAuth ID token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).idToken }];Aynı kalıp, yakın zamanda giriş yapılmasını gerektiren hassas işlemler için yeni kimlik bilgileri almak amacıyla kullanılabilecek
reauthenticateWithCredentialile de kullanılabilir.Swift
Auth().currentUser.reauthenticateWithCredential(withCredential: credential) { authResult, error in if error != nil { // Handle error. } // User is re-authenticated with fresh tokens minted and // should be able to perform sensitive operations like account // deletion and email or password update. // IdP data available in result.additionalUserInfo.profile. // Additional OAuth access token can also be retrieved: // (authResult.credential as? OAuthCredential)?.accessToken // OAuth ID token can also be retrieved: // (authResult.credential as? OAuthCredential)?.idToken }Objective-C
[[FIRAuth auth].currentUser reauthenticateWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { // Handle error. } // User is re-authenticated with fresh tokens minted and // should be able to perform sensitive operations like account // deletion and email or password update. // IdP data available in result.additionalUserInfo.profile. // Additional OAuth access token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).accessToken // OAuth ID token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).idToken }];
Oturum açma akışını manuel olarak yönetme
Uygulamanızda OpenID Connect oturum açma akışını zaten uyguladıysanız Firebase ile kimlik doğrulaması yapmak için kimlik jetonunu doğrudan kullanabilirsiniz:
Swift
let credential = OAuthProvider.credential(
withProviderID: "oidc.example-provider", // As registered in Firebase console.
idToken: idToken, // ID token from OpenID Connect flow.
rawNonce: nil
)
Auth.auth().signIn(with: credential) { authResult, error in
if error {
// Handle error.
return
}
// User is signed in.
// IdP data available in authResult?.additionalUserInfo?.profile
}
Objective-C
FIROAuthCredential *credential =
[FIROAuthProvider credentialWithProviderID:@"oidc.example-provider" // As registered in Firebase console.
IDToken:idToken // ID token from OpenID Connect flow.
rawNonce:nil];
[[FIRAuth auth] signInWithCredential:credential
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
if (error != nil) {
// Handle error.
return;
}
// User is signed in.
// IdP data available in authResult.additionalUserInfo.profile
}];
Sonraki adımlar
Kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve kullanıcının oturum açarken kullandığı kimlik bilgilerine (kullanıcı adı ve şifre, 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ığından bağımsız olarak projenizdeki her uygulamada kullanıcıyı tanımlamak için kullanılabilir.
-
Uygulamalarınızda, kullanıcının temel profil bilgilerini
Usernesnesinden alabilirsiniz. Kullanıcıları yönetme başlıklı makaleyi inceleyin. Firebase Realtime Database ve Cloud Storage Güvenlik Kurallarınızda, oturum açmış kullanıcının benzersiz kullanıcı kimliğini
authdeğişkeninden alabilir ve kullanıcının hangi verilere erişebileceğini kontrol etmek için kullanabilirsiniz.
Kimlik doğrulama sağlayıcı kimlik bilgilerini mevcut bir kullanıcı hesabına bağlayarak kullanıcıların birden fazla 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: yöntemini çağırın.
Swift
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
Objective-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
Tüm kimlik doğrulama hataları için hata işleme kodu da ekleyebilirsiniz. Hataları işleme başlıklı makaleyi inceleyin.