میتوانید به کاربران خود اجازه دهید بااستفاده از ارائهدهندگان OAuth مانند Yahoo، با Firebase اصالتسنجی کنند. این کار با ادغام «ورود به سیستم OAuth» عمومی مبتنی بر وب در برنامه شما بااستفاده از کیت توسعه نرمافزار Firebase برای اجرای جریان ورود به سیستم سرتاسر انجام میشود.
قبل از شروع
برای ورود به سیستم کاربران بااستفاده از حسابهای Yahoo، ابتدا باید Yahoo را بهعنوان ارائهدهنده ورود به سیستم برای پروژه Firebase خود فعال کنید:
- در کنسول Firebase، به امنیت > اصالتسنجی بروید.
- در برگه روش ورود به سیستم، ارائهدهنده ورود به سیستم Yahoo را فعال کنید.
-
شناسه کارخواه و رمز کارخواه را از کنسول توسعهدهنده آن ارائهدهنده به پیکربندی ارائهدهنده اضافه کنید:
-
برای ثبت کارخواه Yahoo OAuth، مستندات توسعهدهنده Yahoo را درباره ثبت برنامه وب با Yahoo دنبال کنید.
حتماً دو اجازه OpenID Connect API را انتخاب کنید:
profileوemail. -
هنگام ثبت برنامهها با این ارائهدهندگان، حتماً دامنه
*.firebaseapp.comرا برای پروژهتان بهعنوان دامنه تغییرمسیر برای برنامهتان ثبت کنید.
-
- روی ذخیره کردن کلیک کنید.
اگر قبلاً اثر انگشت SHA-1 برنامهتان را مشخص نکردهاید، آن را مشخص کنید.
در کنسول Firebase، به
تنظیمات > زبانه «کلی» بروید.بهپایین پیمایش کنید تا به کارت برنامههای شما برسید، برنامه Android خود را انتخاب کنید، و اثر انگشت اساچاِی-۱ خود را در فیلد اثر انگشتهای گواهینامه اساچاِی اضافه کنید.
برای جزئیات درباره نحوه دریافت اثر انگشت SHA برنامهتان، اصالتسنجی مشتری را ببینید.
مدیریت جریان ورود به سیستم با کیت توسعه نرمافزار Firebase
اگر درحال ساختن برنامه Android هستید، سادهترین راه برای اصالتسنجی کاربران با Firebase بااستفاده از حسابهای Yahoo آنها، مدیریت کل جریان ورود به سیستم با کیت توسعه نرمافزار Firebase ویژه Android است.
برای مدیریت جریان ورود به سیستم با کیت توسعه نرمافزار Firebase ویژه Android، این مراحل را دنبال کنید:
نمونهای از OAuthProvider را بااستفاده از Builder آن با شناسه ارائهدهنده yahoo.com بسازید.
Kotlin
val provider = OAuthProvider.newBuilder("yahoo.com")
Java
OAuthProvider.Builder provider = OAuthProvider.newBuilder("yahoo.com");
اختیاری: پارامترهای OAuth سفارشی دیگری را که میخواهید با درخواست OAuth ارسال شود مشخص کنید.
Kotlin
// Prompt user to re-authenticate to Yahoo. provider.addCustomParameter("prompt", "login") // Localize to French. provider.addCustomParameter("language", "fr")
Java
// Prompt user to re-authenticate to Yahoo. provider.addCustomParameter("prompt", "login"); // Localize to French. provider.addCustomParameter("language", "fr");
برای پارامترهایی که Yahoo پشتیبانی میکند، به اسناد Yahoo OAuth مراجعه کنید. توجه داشته باشید که نمیتوانید پارامترهای الزامی Firebase را با
setCustomParameters()ارسال کنید. این پارامترها عبارتند از client_id، redirect_uri، response_type، scope، و state.اختیاری: دامنههای OAuth 2.0 اضافی را فراتر از
profileوemailکه میخواهید از ارائهدهنده اصالتسنجی درخواست کنید مشخص کنید. اگر برنامه شما به دسترسی به دادههای خصوصی کاربر از Yahoo API نیاز دارد، باید در کنسول توسعهدهنده Yahoo در بخش اجازههای API، اجازههای Yahoo API را درخواست کنید. گسترههای OAuth درخواستشده باید دقیقاً با گسترههای ازپیش پیکربندیشده در اجازههای میانای برنامهسازی کاربردی برنامه مطابقت داشته باشند. برای مثال، اگر دسترسی خواندن/نوشتن به مخاطبین کاربر درخواست شده باشد و در اجازههای میانای برنامهسازی کاربردی برنامه ازپیش پیکربندی شده باشد، بهجای گستره OAuth فقط خواندنیsdct-rبایدsdct-wارسال شود. درغیراینصورت، جریان ناموفق خواهد بود و خطایی به کاربر نهایی نشان داده خواهد شد.Kotlin
// Request read access to a user's email addresses. // This must be preconfigured in the app's API permissions. provider.scopes = listOf("mail-r", "sdct-w")
Java
برای کسب اطلاعات بیشتر، به اسناد گسترههای Yahoo مراجعه کنید.// Request read access to a user's email addresses. // This must be preconfigured in the app's API permissions. List<String> scopes = new ArrayList<String>() { { // Request access to Yahoo Mail API. add("mail-r"); // This must be preconfigured in the app's API permissions. add("sdct-w"); } }; provider.setScopes(scopes);
بااستفاده از شیء ارائهدهنده OAuth، با Firebase اصالتسنجی کنید. توجه داشته باشید که برخلاف دیگر عملیات FirebaseAuth، این عملیات با باز کردن برگه سفارشی Chrome، کنترل میانای کاربر شما را بهدست میگیرد. درنتیجه، به «فعالیت» خود در OnSuccessListeners و OnFailureListeners که پیوست میکنید ارجاع ندهید، زیرا وقتی عملیات میانای کاربر را شروع میکند، بلافاصله جدا میشوند.
ابتدا باید بررسی کنید که آیا قبلاً پاسخی دریافت کردهاید یا نه. ورود به سیستم ازطریق این روش «فعالیت» شما را در پسزمینه قرار میدهد، یعنی ممکن است درطول جریان ورود به سیستم توسط سیستم بازیابی شود. برای اطمینان از اینکه درصورت وقوع این اتفاق، کاربر را مجبور به امتحان مجدد نکنید، باید بررسی کنید که آیا نتیجهای ازقبل وجود دارد یا نه.
برای بررسی اینکه آیا نتیجه معلقی وجود دارد یا نه،
getPendingAuthResultرا فراخوانی کنید:Kotlin
val pendingResultTask = firebaseAuth.pendingAuthResult if (pendingResultTask != null) { // There's something already here! Finish the sign-in for your user. pendingResultTask .addOnSuccessListener { // User is signed in. // IdP data available in // authResult.getAdditionalUserInfo().getProfile(). // The OAuth access token can also be retrieved: // ((OAuthCredential)authResult.getCredential()).getAccessToken(). // The OAuth secret can be retrieved by calling: // ((OAuthCredential)authResult.getCredential()).getSecret(). } .addOnFailureListener { // Handle failure. } } else { // There's no pending result so you need to start the sign-in flow. // See below. }
Java
Task<AuthResult> pendingResultTask = firebaseAuth.getPendingAuthResult(); if (pendingResultTask != null) { // There's something already here! Finish the sign-in for your user. pendingResultTask .addOnSuccessListener( new OnSuccessListener<AuthResult>() { @Override public void onSuccess(AuthResult authResult) { // User is signed in. // IdP data available in // authResult.getAdditionalUserInfo().getProfile(). // The OAuth access token can also be retrieved: // ((OAuthCredential)authResult.getCredential()).getAccessToken(). // The OAuth secret can be retrieved by calling: // ((OAuthCredential)authResult.getCredential()).getSecret(). } }) .addOnFailureListener( new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Handle failure. } }); } else { // There's no pending result so you need to start the sign-in flow. // See below. }
برای شروع جریان ورود به سیستم،
startActivityForSignInWithProviderرا فراخوانی کنید:Kotlin
firebaseAuth .startActivityForSignInWithProvider(activity, provider.build()) .addOnSuccessListener { // User is signed in. // IdP data available in // authResult.getAdditionalUserInfo().getProfile(). // The OAuth access token can also be retrieved: // ((OAuthCredential)authResult.getCredential()).getAccessToken(). // The OAuth secret can be retrieved by calling: // ((OAuthCredential)authResult.getCredential()).getSecret(). } .addOnFailureListener { // Handle failure. }
Java
firebaseAuth .startActivityForSignInWithProvider(/* activity= */ this, provider.build()) .addOnSuccessListener( new OnSuccessListener<AuthResult>() { @Override public void onSuccess(AuthResult authResult) { // User is signed in. // IdP data available in // authResult.getAdditionalUserInfo().getProfile(). // The OAuth access token can also be retrieved: // ((OAuthCredential)authResult.getCredential()).getAccessToken(). // The OAuth secret can be retrieved by calling: // ((OAuthCredential)authResult.getCredential()).getSecret(). } }) .addOnFailureListener( new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Handle failure. } });
پساز تکمیل موفقیتآمیز، کد دسترسی OAuth مرتبط با ارائهدهنده را میتوان از شیء
OAuthCredentialبرگرداندهشده بازیابی کرد.بااستفاده از کد دسترسی OAuth، میتوانید Yahoo API را فراخوانی کنید.
که
YAHOO_USER_UIDشناسه کاربر Yahoo است که میتواند از فیلدfirebaseAuth.getCurrentUser().getProviderData().get(0).getUid()یا ازauthResult.getAdditionalUserInfo().getProfile()تجزیه شود.درحالیکه مثالهای بالا بر جریانهای ورود به سیستم تمرکز دارند، شما همچنین میتوانید بااستفاده از
startActivityForLinkWithProvider، ارائهدهنده Yahoo را به کاربر موجود پیوند دهید. برای مثال، میتوانید چندین ارائهدهنده را به یک کاربر پیوند دهید تا بتواند با هرکدام از آنها به سیستم وارد شود.Kotlin
// The user is already signed-in. val firebaseUser = firebaseAuth.currentUser!! firebaseUser .startActivityForLinkWithProvider(activity, provider.build()) .addOnSuccessListener { // Provider credential is linked to the current user. // IdP data available in // authResult.getAdditionalUserInfo().getProfile(). // The OAuth access token can also be retrieved: // authResult.getCredential().getAccessToken(). // The OAuth secret can be retrieved by calling: // authResult.getCredential().getSecret(). } .addOnFailureListener { // Handle failure. }
Java
// The user is already signed-in. FirebaseUser firebaseUser = firebaseAuth.getCurrentUser(); firebaseUser .startActivityForLinkWithProvider(/* activity= */ this, provider.build()) .addOnSuccessListener( new OnSuccessListener<AuthResult>() { @Override public void onSuccess(AuthResult authResult) { // Provider credential is linked to the current user. // IdP data available in // authResult.getAdditionalUserInfo().getProfile(). // The OAuth access token can also be retrieved: // authResult.getCredential().getAccessToken(). // The OAuth secret can be retrieved by calling: // authResult.getCredential().getSecret(). } }) .addOnFailureListener( new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Handle failure. } });
از همین الگو میتوان با
startActivityForReauthenticateWithProviderاستفاده کرد که میتوان از آن برای بازیابی اعتبارنامههای جدید برای عملیات حساس که به ورود به سیستم اخیر نیاز دارند استفاده کرد.Kotlin
// The user is already signed-in. val firebaseUser = firebaseAuth.currentUser!! firebaseUser .startActivityForReauthenticateWithProvider(activity, provider.build()) .addOnSuccessListener { // User is re-authenticated with fresh tokens and // should be able to perform sensitive operations // like account deletion and email or password // update. } .addOnFailureListener { // Handle failure. }
Java
// The user is already signed-in. FirebaseUser firebaseUser = firebaseAuth.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. } });
مراحل بعدی
پساز اینکه کاربر برای اولینبار به سیستم وارد شد، حساب کاربری جدیدی ایجاد میشود و به اطلاعات اعتباری (یعنی نام کاربری و گذرواژه، شماره تلفن، یا اطلاعات ارائهدهنده احراز هویت) که کاربر با آن به سیستم وارد شده است پیوند داده میشود. این حساب جدید بهعنوان بخشی از پروژه Firebase شما ذخیره میشود و میتوان از آن برای شناسایی کاربر در هر برنامه در پروژه شما، صرفنظر از نحوه ورود کاربر به سیستم، استفاده کرد.
-
در برنامههایتان، میتوانید اطلاعات نمایه پایه کاربر را از شیء
FirebaseUserدریافت کنید. مدیریت کاربران را ببینید. در Firebase Realtime Database و Cloud Storage قوانین امنیتی، میتوانید شناسه کاربر منحصربهفرد کاربر واردشده به سیستم را از متغیر
authدریافت کنید، و از آن برای کنترل دادههایی که کاربر میتواند به آنها دسترسی داشته باشد استفاده کنید.
میتوانید به کاربران اجازه دهید بااستفاده از چند ارائهدهنده اصالتسنجی به سیستم برنامهتان وارد شوند. برای این کار، اعتبارنامههای ارائهدهنده اصالتسنجی را به حساب کاربری موجود پیوند دهید.
برای خارج کردن کاربر از سیستم،
signOut را فراخوانی کنید:
Kotlin
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();