تسجيل تدقيق قاعدة بيانات Firebase في الوقت الفعلي

يصف هذا المستند تسجيل التدقيق لقاعدة بيانات Firebase في الوقت الفعلي، بما في ذلك طرق إنشاء سجلات تدقيق وتفاصيل حول سجلات التدقيق التي تنتجها كل طريقة ومعرفة الطرق التي لا تنتج سجلات التدقيق، إن وجدت. تُنشئ Google Cloud سجلات التدقيق التي تسجل الأنشطة الإدارية وأنشطة الوصول ضمن موارد Google Cloud. لمزيد من المعلومات، يُرجى مراجعة نظرة عامة على سجلات تدقيق Cloud

ملاحظات

يمكنك الاطّلاع على معلومات إضافية عن الحقول في "protoPayload.metadata" للعمليات DATA_READ وDATA_WRITEالعمليات في المستندات المرجعية.

اسم الخدمة

تستخدم سجلات تدقيق قاعدة بيانات Firebase في الوقت الفعلي اسم الخدمة firebasedatabase.googleapis.com.

الطرق حسب نوع الإذن

الطرق التي تتحقق من DATA_READ وDATA_WRITE و تنشئ أذونات ADMIN_READ سجلات مصنّفة كـ سجلات تدقيق الوصول إلى البيانات. تنشئ طُرق التحقّق من أذونات "ADMIN_WRITE" سجلّات. مصنفة كـ سجلات تدقيق نشاط المشرف.

نوع الإذن الطُرق
ADMIN_READ google.firebase.database.v1beta.RealtimeDatabaseService.GetDatabaseInstance
google.firebase.database.v1beta.RealtimeDatabaseService.ListDatabaseInstances
ADMIN_WRITE google.firebase.database.v1beta.RealtimeDatabaseService.CreateDatabaseInstance
google.firebase.database.v1beta.RealtimeDatabaseService.DeleteDatabaseInstance
google.firebase.database.v1beta.RealtimeDatabaseService.DisableDatabaseInstance
google.firebase.database.v1beta.RealtimeDatabaseService.ReenableDatabaseInstance
google.firebase.database.v1beta.RealtimeDatabaseService.UndeleteDatabaseInstance
DATA_READ google.firebase.database.v1.RealtimeDatabase.Connect
google.firebase.database.v1.RealtimeDatabase.Disconnect
google.firebase.database.v1.RealtimeDatabase.Listen
google.firebase.database.v1.RealtimeDatabase.OnDisconnectCancel
google.firebase.database.v1.RealtimeDatabase.Read
google.firebase.database.v1.RealtimeDatabase.Unlisten
DATA_WRITE google.firebase.database.v1.RealtimeDatabase.OnDisconnectPut
google.firebase.database.v1.RealtimeDatabase.OnDisconnectUpdate
google.firebase.database.v1.RealtimeDatabase.RunOnDisconnect
google.firebase.database.v1.RealtimeDatabase.Update
google.firebase.database.v1.RealtimeDatabase.Write

سجلات التدقيق لكل واجهة من واجهات برمجة التطبيقات

لمزيد من المعلومات عن كيفية تقييم الأذونات وما هي الأذونات التي يتم تقييمها لكل طريقة، الاطّلاع على مستندات إدارة Cloud Identity وإدارة الوصول لقاعدة بيانات Firebase في الوقت الفعلي.

google.firebase.database.v1.RealtimeDatabase

يحتوي القسم التالي على تفاصيل حول سجلات التدقيق المرتبطة الطرق التابعة لـ google.firebase.database.v1.RealtimeDatabase.

Connect

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Connect
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.connect - DATA_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Connect"

Disconnect

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Disconnect
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.connect - DATA_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Disconnect"

Listen

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Listen
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.get - DATA_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Listen"

OnDisconnectCancel

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.OnDisconnectCancel
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.cancel - DATA_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.OnDisconnectCancel"

OnDisconnectPut

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.OnDisconnectPut
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.update - DATA_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.OnDisconnectPut"

OnDisconnectUpdate

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.OnDisconnectUpdate
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.update - DATA_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.OnDisconnectUpdate"

Read

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Read
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.get - DATA_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Read"

RunOnDisconnect

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.RunOnDisconnect
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.update - DATA_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.RunOnDisconnect"

Unlisten

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Unlisten
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.cancel - DATA_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Unlisten"

Update

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Update
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.get - DATA_READ
    • firebasedatabase.data.get - DATA_WRITE
    • firebasedatabase.data.update - DATA_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Update"

Write

  • الطريقة: google.firebase.database.v1.RealtimeDatabase.Write
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.data.get - DATA_READ
    • firebasedatabase.data.get - DATA_WRITE
    • firebasedatabase.data.update - DATA_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1.RealtimeDatabase.Write"

google.firebase.database.v1beta.RealtimeDatabaseService

يحتوي القسم التالي على تفاصيل حول سجلات التدقيق المرتبطة الطرق التابعة لـ google.firebase.database.v1beta.RealtimeDatabaseService.

CreateDatabaseInstance

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.CreateDatabaseInstance
  • نوع سجلّ التدقيق: نشاط المشرف
  • الأذونات:
    • firebasedatabase.instances.create - ADMIN_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.CreateDatabaseInstance"

DeleteDatabaseInstance

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.DeleteDatabaseInstance
  • نوع سجلّ التدقيق: نشاط المشرف
  • الأذونات:
    • firebasedatabase.instances.delete - ADMIN_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.DeleteDatabaseInstance"

DisableDatabaseInstance

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.DisableDatabaseInstance
  • نوع سجلّ التدقيق: نشاط المشرف
  • الأذونات:
    • firebasedatabase.instances.disable - ADMIN_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.DisableDatabaseInstance"

GetDatabaseInstance

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.GetDatabaseInstance
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.instances.get - ADMIN_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.GetDatabaseInstance"

ListDatabaseInstances

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.ListDatabaseInstances
  • نوع سجلّ التدقيق: الوصول إلى البيانات
  • الأذونات:
    • firebasedatabase.instances.list - ADMIN_READ
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.ListDatabaseInstances"

ReenableDatabaseInstance

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.ReenableDatabaseInstance
  • نوع سجلّ التدقيق: نشاط المشرف
  • الأذونات:
    • firebasedatabase.instances.reenable - ADMIN_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.ReenableDatabaseInstance"

UndeleteDatabaseInstance

  • الطريقة: google.firebase.database.v1beta.RealtimeDatabaseService.UndeleteDatabaseInstance
  • نوع سجلّ التدقيق: نشاط المشرف
  • الأذونات:
    • firebasedatabase.instances.undelete - ADMIN_WRITE
  • الطريقة هي عملية طويلة الأمد أو عملية بث: رقم
  • الفلترة للحصول على هذه الطريقة: protoPayload.methodName="google.firebase.database.v1beta.RealtimeDatabaseService.UndeleteDatabaseInstance"

تدقيق معلومات المصادقة

إدخالات سجلّ التدقيق تتضمن معلومات عن الهوية التي أجريت العملية التي تم تسجيلها. لتحديد طلب المتصل، يُرجى الاطلاع على الحقول التالية ضمن كائن InspectLog:

  • إنشاء اتصالات في الوقت الفعلي: تُجري عمليات Connect لقاعدة بيانات الوقت الفعلي لا نسجل بيانات المصادقة نظرًا لأن قاعدة بيانات الوقت الفعلي تقوم بالمصادقة بعد يتم إنشاء اتصال. لذلك، لا يتضمّن Connect أي معلومات مصادقة. يحتوي الكائن AuthenticationInfo على العنصر النائب principalEmail audit-pending-auth@firebasedatabase-{REGION_CODE}-prod.iam.gserviceaccount.com

  • مصادقة Google: عمليات قاعدة البيانات في الوقت الفعلي التي تستخدم معايير Google المصادقة، مثل عدد الزيارات الواردة من حزمة SDK لمشرف Firebase أو طلبات REST مصادقتها باستخدام رمز OAuth مميز عادي، تحتوي على كائن AuthenticationInfo يحتوي على بيانات الاعتماد الفعلية البريد الإلكتروني.

  • مصادقة Firebase: تتمتع عمليات قاعدة البيانات في الوقت الفعلي التي تستخدم مصادقة Firebase عنصر AuthenticationInfo يحتوي على القيمة principalEmail audit-third-party-auth@firebasedatabase-{REGION_CODE}-prod.iam.gserviceaccount.com وينطبق الأمر نفسه إذا قمت بتنفيذ حل المصادقة الخاص بك عن طريق إنشاء ملفات JWT المخصصة.

    • في حال استخدام رمز JSON المميّز للويب (JWT) لمصادقة جهة خارجية، يتضمّن الحقل thirdPartyPrincipal عنوان الرمز المميّز وحمولةته. بالنسبة مثل، سجلات التدقيق للطلبات التي تمت مصادقتها باستخدام مصادقة Firebase. تضمين الرمز المميز لمصادقة Firebase لهذا الطلب.

  • بدون مصادقة. عمليات قاعدة البيانات في الوقت الفعلي التي لا تستخدم تتضمّن المصادقة عنصر AuthenticationInfo يحتوي على قيمة principalEmail لـ audit-no-auth@firebasedatabase-{REGION_CODE}-prod.iam.gserviceaccount.com ويمكن أن يمنح مثيل قاعدة البيانات في الوقت الفعلي الذي يتضمن قواعد أمان مفتوحة هذه الطلبات. أر أن توصي جميع المستخدمين بتأمين قواعد البيانات الخاصة بهم بشكل صحيح.

  • الرموز المميّزة القديمة للأسرار: عمليات قاعدة البيانات في الوقت الفعلي باستخدام الرموز المميّزة القديمة تحتوي على كائن AuthenticationInfo يحتوي على عنصر نائب principalEmail من audit-secret-auth@firebasedatabase-{REGION_CODE}-prod.iam.gserviceaccount.com بالنسبة إلى JWT الموقَّعة من بين الأسرار، يحتوي thirdPartyPrincipal على عناوين JWT حمولة البيانات.

تدقيق تقييمات قواعد أمان Firebase

يمكن استخدام سجلات تدقيق السحابة الإلكترونية لتحديد الطلبات التي من المحتمل المتأثر بتغييرات القواعد.

في العنصر PermissionInfo، يمكن أن يكون authorization.permission واحدًا مما يلي:

  • firebasedatabase.data.get: تم منح الإذن بالقراءة في المسار المحدد في resource
  • firebasedatabase.data.update: تم منح الإذن بالتعديل في المسار المحدد في resource
  • firebasedatabase.data.connect: عنصر نائب لـ "Connect" و"Disconnect" لا يلزم الحصول على إذن للاتصال بمثيل قاعدة البيانات في الوقت الفعلي.
  • firebasedatabase.data.cancel: يُستخدَم في Unlisten وOnDisconnectCancel. لا يتطلب إلغاء أو إلغاء عملية مصرّح بها سابقًا التفويض.

ربط سجلّات تدقيق Cloud بنتائج أداة تحليل قاعدة البيانات في الوقت الفعلي

يمكنك إجراء تحليل متعمق للأداء في Realtime Database باستخدام محلل قاعدة البيانات في الوقت الفعلي إلى جانب تسجيل تدقيق قاعدة البيانات في الوقت الفعلي. لكل أداة نقاط قوتها.

Cloud Audit Logging محلّل قاعدة البيانات في الوقت الفعلي
  • تدقيق الوصول إلى قواعد البيانات
  • تسجيل جميع الطلبات باستمرار
  • السماح بالاستعلام عن جلسة المراجعة
  • يحتوي على معلومات تفصيلية عن الرمز المميّز للمصادقة
  • يزيد تكلفة الاستخدام
  • تُستخدَم لتحليل الأداء
  • توفر أدوات مفيدة لتحديد نقطة الاتصال وبالتالي تحسين أدائها التحسين
  • يمكنه قياس الاستماع-البث، وهي غير متوفرة في سجلات التدقيق بسبب حجم البيانات المُحتمَل
  • وهو خفيف وفي الوقت الفعلي، ما يجعله مناسبًا لاختبار التحميل المباشر. التدقيق قد يستغرق ظهور إدخالات السجلّ بضع دقائق.

يتوافق محتوى سجلّ التدقيق مع مقاييس محلّل كما هو موضّح أدناه.

اسم عملية تسجيل التدقيق قيم خاصة في
RealtimeDatabaseAuditMetadata		 اسم عملية المحلّل
اتصال RequestType هو REALTIME الاتصال المتزامن
قطع الاتصال RequestType هو REALTIME انقطاع الاتصال المتزامن
قراءة RequestType هو REALTIME القراءة في الوقت الفعلي
قراءة RequestType هو REST قراءة البقية
كتابة RequestType هو REALTIME الكتابة في الوقت الفعلي
كتابة RequestType هو REST الاستراحة-الكتابة
تعديل تم REALTIME ميزة RequestType.
تحقق من PreconditionType.		 تعديل في الوقت الفعلي
realtime-transaction
تعديل تم REST ميزة RequestType.
تحقق من PreconditionType.		 rest-update
rest-transaction
المستمع RequestType هو REALTIME استمِع إلى أغانيك
الاستماع إلى المستمع RequestType هو REALTIME عدم الاستماع إلى المستمعين
موقع OnConnectedPut RequestType هو REALTIME عند قطع الاتصال
عند إلغاء الربط بالتحديث RequestType هو REALTIME تحديث عند انقطاع الاتصال
عند إلغاء الربط RequestType هو REALTIME إلغاء الربط عند إلغاء الاتصال
تشغيل عند إلغاء الربط RequestType هو REALTIME تشغيل عند قطع الاتصال