إثبات ملكية الرموز المميّزة للهوية

إذا كان تطبيق عميل Firebase يتواصل مع خادم خلفي مخصّص، قد تحتاج إلى تحديد المستخدم الذي سجّل الدخول حاليًا على هذا الخادم. لإجراء ذلك بأمان، أرسِل الرمز المميّز لتعريف المستخدم إلى الخادم باستخدام HTTPS بعد تسجيل الدخول بنجاح. بعد ذلك، تحقَّق على الخادم من سلامة الرمز المميز لتعريف الهوية وصحته واسترداد uid منه. يمكنك استخدام uid المرسَلة بهذه الطريقة لتحديد هوية المستخدم الذي سجّل الدخول حاليًا على خادمك بشكل آمن.

قبل البدء

لإثبات صحة رموز التعريف باستخدام حزمة تطوير البرامج (SDK) الخاصة بمسؤول Firebase، يجب أن يكون لديك حساب خدمة. اتّبِع تعليمات إعداد حزمة مدير SDK للحصول على مزيد من المعلومات حول كيفية إعداد حزمة مدير SDK باستخدام حساب الخدمة.

استرداد رموز التعريف على الأجهزة

عندما يسجّل مستخدم أو جهاز الدخول بنجاح، تنشئ Firebase رمزًا مميّزًا مطابقًا للمعرّف يحدّد هويته بشكل فريد ويمنحه إذن الوصول إلى العديد من الموارد، مثل Firebase Realtime Database وCloud Storage. يمكنك إعادة استخدام رمز التعريف هذا لتحديد المستخدم أو الجهاز على خادم الخلفية المخصّص. لاسترداد الرمز المميّز للمعرّف من العميل، تأكَّد من تسجيل دخول المستخدم، ثم احصل على الرمز المميّز للمعرّف من المستخدم الذي سجّل الدخول:

FIRUser *currentUser = [FIRAuth auth].currentUser;
[currentUser getIDTokenForcingRefresh:YES
                           completion:^(NSString *_Nullable idToken,
                                        NSError *_Nullable error) {
          if (error) {
            // Handle error
            return;
          }

          // Send token to your backend via HTTPS
          // ...
}];

let currentUser = FIRAuth.auth()?.currentUser
currentUser?.getIDTokenForcingRefresh(true) { idToken, error in
  if let error = error {
    // Handle error
    return;
  }

  // Send token to your backend via HTTPS
  // ...
}

FirebaseUser mUser = FirebaseAuth.getInstance().getCurrentUser();
mUser.getIdToken(true)
    .addOnCompleteListener(new OnCompleteListener<GetTokenResult>() {
        public void onComplete(@NonNull Task<GetTokenResult> task) {
            if (task.isSuccessful()) {
                String idToken = task.getResult().getToken();
                // Send token to your backend via HTTPS
                // ...
            } else {
                // Handle error -> task.getException();
            }
        }
    });

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
user.TokenAsync(true).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("TokenAsync was canceled.");
   return;
  }

  if (task.IsFaulted) {
    Debug.LogError("TokenAsync encountered an error: " + task.Exception);
    return;
  }

  string idToken = task.Result;

  // Send token to your backend via HTTPS
  // ...
});

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  firebase::Future<std::string> idToken = user.GetToken(true);

  // Send token to your backend via HTTPS
  // ...
}

firebase.auth().currentUser.getIdToken(/* forceRefresh */ true).then(function(idToken) {
  // Send token to your backend via HTTPS
  // ...
}).catch(function(error) {
  // Handle error
});

بعد الحصول على رمز مميّز للمعرّف، يمكنك إرسال رمز JSON المميّز للويب (JWT) إلى الخلفية والتحقّق منه باستخدام حزمة تطوير البرامج (SDK) الخاصة بمدير Firebase، أو باستخدام مكتبة رموز JWT مميّزة تابعة لجهة خارجية إذا كان الخادم مكتوبًا بلغة لا تتوافق مع Firebase بشكلٍ أصلي.

التحقّق من صحة الرموز المميّزة لتعريف الهوية باستخدام "مدير SDK في Firebase"

تتضمّن حزمة تطوير البرامج (SDK) لمشرفي Firebase طريقة مدمجة للتحقّق من رموز التعريف المميزة وفك تشفيرها. إذا كان رمز التعريف المميّز المقدَّم بالتنسيق الصحيح ولم تنتهِ صلاحيته وتم توقيعه بشكل صحيح، ستعرض الطريقة رمز التعريف المميّز الذي تم فك ترميزه. يمكنك الحصول على uid الخاص بالمستخدم أو الجهاز من الرمز المميّز الذي تم فك ترميزه.

اتّبِع تعليمات إعداد حزمة SDK للمشرف لتهيئة حزمة SDK للمشرف باستخدام حساب خدمة. بعد ذلك، استخدِم الطريقة verifyIdToken() للتحقّق من صحة رمز تعريف:

// idToken comes from the client app
getAuth()
  .verifyIdToken(idToken)
  .then((decodedToken) => {
    const uid = decodedToken.uid;
    // ...
  })
  .catch((error) => {
    // Handle error
  });

// idToken comes from the client app (shown above)
FirebaseToken decodedToken = FirebaseAuth.getInstance().verifyIdToken(idToken);
String uid = decodedToken.getUid();

# id_token comes from the client app (shown above)

decoded_token = auth.verify_id_token(id_token)
uid = decoded_token['uid']

client, err := app.Auth(ctx)
if err != nil {
	log.Fatalf("error getting Auth client: %v\n", err)
}

token, err := client.VerifyIDToken(ctx, idToken)
if err != nil {
	log.Fatalf("error verifying ID token: %v\n", err)
}

log.Printf("Verified ID token: %v\n", token)
auth.go

FirebaseToken decodedToken = await FirebaseAuth.DefaultInstance
    .VerifyIdTokenAsync(idToken);
string uid = decodedToken.Uid;

يتطلّب إثبات صحة الرمز المميّز لمعرّف المستخدم توفّر رقم تعريف المشروع. تحاول حزمة تطوير البرامج (SDK) الخاصة بـ Firebase Admin الحصول على رقم تعريف المشروع بإحدى الطرق التالية:

• إذا تمّت تهيئة حزمة SDK باستخدام خيار تطبيق projectId صريح، تستخدم حزمة SDK قيمة هذا الخيار.
• إذا تم إعداد حزمة SDK باستخدام بيانات اعتماد حساب الخدمة، ستستخدم حزمة SDK الحقل project_id من عنصر JSON الخاص بحساب الخدمة.
• إذا تم ضبط متغيّر البيئة GOOGLE_CLOUD_PROJECT، سيستخدم حزمة تطوير البرامج (SDK) قيمته كرقم تعريف المشروع. تتوفّر متغيّرات البيئة هذه للرموز التي يتم تشغيلها على بنية Google التحتية، مثل App Engine وCompute Engine.

التحقّق من صحة رموز التعريف باستخدام مكتبة JWT تابعة لجهة خارجية

إذا كانت الخلفية بلغة غير متوافقة مع حزمة تطوير البرامج (SDK) الخاصة بـ Firebase Admin، سيظل بإمكانك إثبات صحة رموز التعريف. أولاً، ابحث عن مكتبة JWT تابعة لجهة خارجية للغتك. بعد ذلك، تحقَّق من صحة العنوان والحمولة والتوقيع الخاص برمز التعريف.

تأكَّد من أنّ عنوان رمز التعريف يستوفي القيود التالية:

تأكَّد من أنّ حمولة رمز التعريف المميز تتوافق مع القيود التالية:

أخيرًا، تأكَّد من أنّ رمز التعريف قد تم توقيعه باستخدام المفتاح الخاص المطابق لمطالبة kid في الرمز المميز. احصل على المفتاح العام من https://www.googleapis.com/robot/v1/metadata/x509/securetoken@system.gserviceaccount.com واستخدِم مكتبة JWT للتحقّق من صحة التوقيع. استخدِم قيمة max-age في عنوان Cache-Control للاستجابة من نقطة النهاية هذه لمعرفة الوقت المناسب لإعادة تحميل المفاتيح العامة.

في حال نجاح جميع عمليات التحقّق المذكورة أعلاه، يمكنك استخدام الموضوع (sub) لرمز التعريف المميز كـ uid للمستخدم أو الجهاز المعنيّ.