شارك المقالة
استخراج Access Token لإرسال FCM والفرق عن توكن الجهاز

استخراج Access Token لإرسال FCM والفرق عن توكن الجهاز

فهم Access Token في FCM HTTP v1 والفرق بينه وبين FCM registration token وFirebase ID token، مع استخراج التفويض على…

فهم Access Token في FCM HTTP v1 والفرق بينه وبين FCM registration token وFirebase ID token، مع استخراج التفويض على الخادم فقط.

أين يدخل FID في الإصدارات الحديثة؟

أضاف firebase_messaging 17 التسجيل عبر register وonRegistered، وأصبح FID المسجل هدف الإرسال الحديث باستخدام message.fid. أما registration token في الشروحات القديمة فله مسار انتقالي deprecated. كلاهما مختلف عن OAuth access token ومختلف عن Firebase ID token؛ لذلك خزّن نوع المعرّف وإصدار تدفق التسجيل بوضوح أثناء الانتقال. دالة هذا المقال تخص تفويض الخادم ولا تولد FID أو عنوان جهاز.

ثلاثة توكنات بوظائف مختلفة

FCM registration token يحدد تثبيت التطبيق المستهدف ويأتي من firebase_messaging على الجهاز. OAuth access token يفوض الخادم لإرسال الرسالة عبر HTTP v1، ويولد باستخدام هوية مخولة. أما Firebase ID token فيثبت هوية مستخدم مسجل الدخول عند مخاطبة خادمك. خلط هذه القيم يؤدي إلى أخطاء تفويض؛ لا ترسل ID token في مكان تفويض FCM ولا تستخدم access token كعنوان جهاز.

ما الذي يحويه ملف حساب الخدمة؟

ملف حساب الخدمة يحتوي بيانات اعتماد خاصة وقد يتضمن private_key، وليس مجرد إعداد عام لتطبيق Firebase. لا تسمه FCM Key بطريقة توحي بأنه يوضع في تطبيق الهاتف. الأفضل في خدمة مستضافة استخدام هوية مرفقة بالخادم متى كان ذلك متاحًا، ثم الاعتماد على مكتبة Google لتجديد التوكن. في التطوير اجعل ملف الاعتماد خارج مجلد الموقع العام ومستودع Git، ولا ترفعه مع Flutter assets.

توليد التفويض عند الحاجة

ثبت google-auth-library على خادم Node.js واضبط Application Default Credentials وفق بيئتك. يطلب المثال نطاق firebase.messaging ويحصل على قيمة مؤقتة دون طباعتها، ثم يمكنك استخدامها داخليًا في Authorization: Bearer. لا تبن واجهة عامة تعيد هذا التوكن إلى أي عميل. احتفظ بالمكتبة والعميل في خدمة الخادم بدل إعادة إنشاء ملف اعتماد لكل رسالة، واترك إدارة الصلاحية للمكتبة.

تشخيص رفض الإرسال

تحقق أولًا من تفعيل API وتطابق project ID مع المشروع الهدف وصلاحيات هوية الخادم. نجاح قراءة ملف JSON لا يثبت وجود صلاحية الإرسال. لا تعالج رفض الصلاحيات بمنح دور Owner شامل تلقائيًا. إذا تسرب ملف خاص فإخفاؤه من الصفحة لا يكفي؛ تتطلب الاستجابة إبطال المفتاح المكشوف من حسابك ومراجعة الاستخدام، ثم نشر اعتماد بديل بطريقة خاصة. لا تشارك التوكنات أو المفاتيح داخل لقطة شرح أو سجل أخطاء عام.

المثال التطبيقي وحدوده

import {GoogleAuth} from 'google-auth-library';

const auth = new GoogleAuth({scopes: ['https://www.googleapis.com/auth/firebase.messaging']});
const client = await auth.getClient();
export async function authorizationHeader() {
  const {token} = await client.getAccessToken();
  if (!token) throw new Error('Authorization unavailable');
  return {Authorization: `Bearer ${token}`};
}
// Use this function inside the trusted sender. Do not return it to Flutter.

الصور والفيديو من الشرح

المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.

كيفيه ارسال الاشعارات لتطبيقك من Firebase بالطريقه الجديده (Flutter & Android & IOS)كيفيه ارسال الاشعارات لتطبيقك من Firebase بالطريقه الجديده (Flutter & Android & IOS)كيفيه ارسال الاشعارات لتطبيقك من Firebase بالطريقه الجديده (Flutter & Android & IOS)كيفيه ارسال الاشعارات لتطبيقك من Firebase بالطريقه الجديده (Flutter & Android & IOS)كيفيه ارسال الاشعارات لتطبيقك من Firebase بالطريقه الجديده (Flutter & Android & IOS)كيفيه ارسال الاشعارات لتطبيقك من Firebase بالطريقه الجديده (Flutter & Android & IOS)

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع