يمكنك السماح للمستخدمين بالمصادقة باستخدام Firebase من خلال حساباتهم على Twitter عن طريق دمج مصادقة Twitter في تطبيقك. يمكنك دمج مصادقة Twitter إما باستخدام Firebase SDK لتنفيذ عملية تسجيل الدخول، أو عن طريق تنفيذ عملية Twitter OAuth يدويًا وتمرير رمز الدخول الناتج والسر إلى Firebase.
قبل البدء
- أضِف Firebase إلى مشروع JavaScript.
- في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
- في علامة التبويب طريقة تسجيل الدخول (Sign-in method)، فعِّل موفّر خدمة تسجيل الدخول من خلال Twitter.
-
أضِف مفتاح واجهة برمجة التطبيقات ورمز واجهة برمجة التطبيقات السرّي من وحدة تحكّم المطوّرين لدى مقدّم الخدمة إلى إعدادات مقدّم الخدمة:
- سجِّل تطبيقك كتطبيق مطوّر على Twitter واحصل على مفتاح واجهة برمجة التطبيقات ورمز واجهة برمجة التطبيقات السرّي لبروتوكول OAuth الخاص بتطبيقك.
-
تأكَّد من ضبط معرّف الموارد المنتظم (URI) لإعادة توجيه OAuth في Firebase (على سبيل المثال،
my-app-12345.firebaseapp.com/__/auth/handler) ليكون عنوان URL لمعاودة الاتصال الخاص بالتفويض في صفحة إعدادات تطبيقك في إعدادات تطبيق Twitter.
- انقر على حفظ.
التعامل مع عملية تسجيل الدخول باستخدام حزمة تطوير البرامج (SDK) لمنصّة Firebase
إذا كنت بصدد إنشاء تطبيق ويب، فإن أسهل طريقة لمصادقة المستخدمين باستخدام Firebase من خلال حساباتهم على Twitter هي معالجة عملية تسجيل الدخول باستخدام Firebase JavaScript SDK. (إذا أردت مصادقة مستخدم في Node.js أو بيئة أخرى غير المتصفّح، عليك معالجة عملية تسجيل الدخول يدويًا).
للتعامل مع عملية تسجيل الدخول باستخدام حزمة تطوير البرامج (SDK) لبرنامج Firebase JavaScript، اتّبِع الخطوات التالية:
- أنشئ مثيلاً لكائن موفّر Twitter:
Web
import { TwitterAuthProvider } from "firebase/auth"; const provider = new TwitterAuthProvider();
Web
var provider = new firebase.auth.TwitterAuthProvider();
- اختياري: لترجمة مسار OAuth الخاص بمقدّم الخدمة إلى اللغة المفضّلة للمستخدم بدون تمرير مَعلمات OAuth المخصّصة ذات الصلة بشكل صريح، يجب تعديل رمز اللغة في مثيل المصادقة قبل بدء مسار OAuth. على سبيل المثال:
Web
import { getAuth } from "firebase/auth"; const auth = getAuth(); auth.languageCode = 'it'; // To apply the default browser preference instead of explicitly setting it. // auth.useDeviceLanguage();
Web
firebase.auth().languageCode = 'it'; // To apply the default browser preference instead of explicitly setting it. // firebase.auth().useDeviceLanguage();
- اختياري: حدِّد مَعلمات مخصّصة إضافية لمقدّم خدمة OAuth
التي تريد إرسالها مع طلب OAuth. لإضافة مَعلمة مخصّصة، يمكنك استدعاء
setCustomParametersعلى مقدّم الخدمة الذي تم إعداده باستخدام عنصر يحتوي على المفتاح كما هو محدّد في مستندات مقدّم خدمة OAuth والقيمة المقابلة. على سبيل المثال:لا يُسمح بمَعلمات OAuth المطلوبة المحجوزة وسيتم تجاهلها. يمكنك الاطّلاع على مرجع موفّر المصادقة لمزيد من التفاصيل.Web
provider.setCustomParameters({ 'lang': 'es' });
Web
provider.setCustomParameters({ 'lang': 'es' });
- المصادقة باستخدام Firebase من خلال عنصر موفّر Twitter يمكنك
مطالبة المستخدمين بتسجيل الدخول باستخدام حساباتهم على Twitter إما من خلال فتح
نافذة منبثقة أو من خلال إعادة التوجيه إلى صفحة تسجيل الدخول. يُفضَّل استخدام طريقة إعادة التوجيه على الأجهزة الجوّالة.
- لتسجيل الدخول باستخدام نافذة منبثقة، يمكنك استدعاء
signInWithPopup:لاحظ أيضًا أنه يمكنك استرداد رمز OAuth المميز لموفر Twitter والذي يمكن استخدامه لجلب بيانات إضافية باستخدام واجهات برمجة تطبيقات Twitter.Web
import { getAuth, signInWithPopup, TwitterAuthProvider } from "firebase/auth"; const auth = getAuth(); signInWithPopup(auth, provider) .then((result) => { // This gives you a the Twitter OAuth 1.0 Access Token and Secret. // You can use these server side with your app's credentials to access the Twitter API. const credential = TwitterAuthProvider.credentialFromResult(result); const token = credential.accessToken; const secret = credential.secret; // The signed-in user info. const user = result.user; // IdP data available using getAdditionalUserInfo(result) // ... }).catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; // The email of the user's account used. const email = error.customData.email; // The AuthCredential type that was used. const credential = TwitterAuthProvider.credentialFromError(error); // ... });
Web
firebase .auth() .signInWithPopup(provider) .then((result) => { /** @type {firebase.auth.OAuthCredential} */ var credential = result.credential; // This gives you a the Twitter OAuth 1.0 Access Token and Secret. // You can use these server side with your app's credentials to access the Twitter API. var token = credential.accessToken; var secret = credential.secret; // The signed-in user info. var user = result.user; // IdP data available in result.additionalUserInfo.profile. // ... }).catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; // The email of the user's account used. var email = error.email; // The firebase.auth.AuthCredential type that was used. var credential = error.credential; // ... });
هذا هو المكان الذي يمكنك فيه أيضًا رصد الأخطاء ومعالجتها. للاطّلاع على قائمة برموز الخطأ، يُرجى مراجعة مستندات مرجع المصادقة.
- لتسجيل الدخول من خلال إعادة التوجيه إلى صفحة تسجيل الدخول، يمكنك استدعاء
signInWithRedirect: اتّبِع أفضل الممارسات عند استخدام `signInWithRedirect`.بعد ذلك، يمكنك أيضًا استرداد الرمز المميّز لبروتوكول OAuth الخاص بموفّر Twitter من خلال طلبWeb
import { getAuth, signInWithRedirect } from "firebase/auth"; const auth = getAuth(); signInWithRedirect(auth, provider);
Web
firebase.auth().signInWithRedirect(provider);
getRedirectResultعند تحميل صفحتك:هذا هو المكان الذي يمكنك فيه أيضًا رصد الأخطاء ومعالجتها. للاطّلاع على قائمة برموز الخطأ، يُرجى مراجعة مستندات مرجع المصادقة.Web
import { getAuth, getRedirectResult, TwitterAuthProvider } from "firebase/auth"; const auth = getAuth(); getRedirectResult(auth) .then((result) => { // This gives you a the Twitter OAuth 1.0 Access Token and Secret. // You can use these server side with your app's credentials to access the Twitter API. const credential = TwitterAuthProvider.credentialFromResult(result); const token = credential.accessToken; const secret = credential.secret; // ... // The signed-in user info. const user = result.user; // IdP data available using getAdditionalUserInfo(result) // ... }).catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; // The email of the user's account used. const email = error.customData.email; // The AuthCredential type that was used. const credential = TwitterAuthProvider.credentialFromError(error); // ... });
Web
firebase.auth() .getRedirectResult() .then((result) => { if (result.credential) { /** @type {firebase.auth.OAuthCredential} */ var credential = result.credential; // This gives you a the Twitter OAuth 1.0 Access Token and Secret. // You can use these server side with your app's credentials to access the Twitter API. var token = credential.accessToken; var secret = credential.secret; // ... } // The signed-in user info. var user = result.user; // IdP data available in result.additionalUserInfo.profile. // ... }).catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; // The email of the user's account used. var email = error.email; // The firebase.auth.AuthCredential type that was used. var credential = error.credential; // ... });
- لتسجيل الدخول باستخدام نافذة منبثقة، يمكنك استدعاء
التعامل مع عملية تسجيل الدخول يدويًا
يمكنك أيضًا المصادقة باستخدام Firebase من خلال حساب Twitter عن طريق معالجة مسار تسجيل الدخول من خلال استدعاء نقاط نهاية Twitter OAuth:
- يمكنك دمج مصادقة Twitter في تطبيقك باتّباع مستندات المطوّرين. في نهاية عملية تسجيل الدخول إلى Twitter، ستتلقّى رمز دخول OAuth وسر OAuth.
- إذا كنت بحاجة إلى تسجيل الدخول إلى تطبيق Node.js، أرسِل رمز الدخول الخاص ببروتوكول OAuth وسر OAuth إلى تطبيق Node.js.
- بعد تسجيل المستخدم الدخول بنجاح باستخدام Twitter، يمكنك استبدال رمز الدخول المميز لبروتوكول OAuth
وسرّ OAuth ببيانات اعتماد Firebase:
var credential = firebase.auth.TwitterAuthProvider.credential(token, secret);
- المصادقة باستخدام Firebase من خلال بيانات اعتماد Firebase:
Web
import { getAuth, signInWithCredential, FacebookAuthProvider } from "firebase/auth"; // Sign in with the credential from the Facebook user. const auth = getAuth(); signInWithCredential(auth, credential) .then((result) => { // Signed in const credential = FacebookAuthProvider.credentialFromResult(result); }) .catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; // The email of the user's account used. const email = error.customData.email; // The AuthCredential type that was used. const credential = FacebookAuthProvider.credentialFromError(error); // ... });
Web
// Sign in with the credential from the Facebook user. firebase.auth().signInWithCredential(credential) .then((result) => { // Signed in var credential = result.credential; // ... }) .catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; // The email of the user's account used. var email = error.email; // The firebase.auth.AuthCredential type that was used. var credential = error.credential; // ... });
المصادقة باستخدام Firebase في إضافة Chrome
إذا كنت بصدد إنشاء تطبيق لإضافة Chrome، يُرجى الاطّلاع على دليل المستندات خارج الشاشة.
الخطوات التالية
بعد أن يسجّل المستخدم الدخول للمرة الأولى، يتم إنشاء حساب مستخدم جديد وربطه ببيانات الاعتماد التي استخدمها لتسجيل الدخول، أي اسم المستخدم وكلمة المرور أو رقم الهاتف أو معلومات مزوّد المصادقة. يتم تخزين هذا الحساب الجديد كجزء من مشروع Firebase، ويمكن استخدامه لتحديد هوية المستخدم في كل تطبيق في مشروعك، بغض النظر عن كيفية تسجيل المستخدم الدخول.
-
في تطبيقاتك، الطريقة المقترَحة لمعرفة حالة مصادقة المستخدم هي ضبط مراقِب على عنصر
Auth. يمكنك بعد ذلك الحصول على معلومات الملف الشخصي الأساسية للمستخدم من الكائنUser. يُرجى الاطّلاع على إدارة المستخدمين. في قواعد الأمان في Firebase Realtime Database وCloud Storage، يمكنك الحصول على رقم تعريف المستخدم الفريد للمستخدم الذي سجّل الدخول من المتغيّر
auth، واستخدامه للتحكّم في البيانات التي يمكن للمستخدم الوصول إليها.
يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام عدة موفّري مصادقة من خلال ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي.
لتسجيل خروج مستخدم، يمكنك استدعاء
signOut:
Web
import { getAuth, signOut } from "firebase/auth"; const auth = getAuth(); signOut(auth).then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });
Web
firebase.auth().signOut().then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });