ويوضّح هذا الموضوع كيفية إنشاء مفتاح واجهة برمجة التطبيقات لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لأجهزة Android، وإضافته إلى تطبيقك، وتأمين التطبيق عن طريق حظر المفتاح. عليك إضافة مفتاح واجهة برمجة تطبيقات إلى أي تطبيق يستخدم حزمة تطوير البرامج (SDK).
قبل البدء
قبل أن تبدأ في استخدام حزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل Android، يجب أن يكون لديك مشروع يحتوي على حساب فوترة وأن يتم تفعيل حزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل Android. لمزيد من المعلومات، يُرجى الاطِّلاع على الإعداد في Cloud Console.
إنشاء مفاتيح واجهة برمجة التطبيقات
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح واجهة برمجة تطبيقات:
وحدة التحكّم
-
انتقِل إلى صفحة منصة خرائط Google > وبيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد >؛ مفتاح واجهة برمجة التطبيقات.
يعرض مربع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(تذكّر تقييد واجهة برمجة التطبيقات قبل استخدامها في الإنتاج).
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:
تقييد مفاتيح واجهة برمجة التطبيقات
تنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات من خلال حصر استخدامها على واجهات برمجة التطبيقات المطلوبة فقط لتطبيقك. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات إلى إضافة أمان إلى تطبيقك عن طريق حمايته من الطلبات غير المرغوب فيها. لمزيد من المعلومات، يُرجى الاطّلاع على أفضل ممارسات أمان واجهة برمجة التطبيقات.
عند حظر مفتاح واجهة برمجة التطبيقات، عليك تقديم الملف المرجعي لشهادة SHA-1 لمفتاح التوقيع الذي تم استخدامه لتوقيع التطبيق. هناك نوعان من الشهادات:
- شهادة تصحيح الأخطاء: استخدِم نوع الشهادة هذا فقط مع التطبيقات التي تختبرها أنت وغير ذلك من الرموز غير الإنتاجية. لا تحاول نشر تطبيق تم توقيعه باستخدام شهادة تصحيح أخطاء. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند تشغيل إنشاء تصحيح أخطاء.
- شهادة الإصدار: استخدِم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك إلى متجر تطبيقات. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند تشغيل إصدار إصدار.
ولمزيد من المعلومات حول الشهادات الرقمية، راجِع دليل توقيع تطبيقك.
للحصول على معلومات حول الحصول على بصمة إصبع شهادتك، راجع مصادقة البرنامج. إذا كنت تستخدم ميزة توقيع التطبيق من Play بدلاً من ذلك، عليك الانتقال إلى صفحة توقيع التطبيق على Play Console للحصول على الملف المرجعي للشهادة.
لتقييد مفتاح واجهة برمجة تطبيقات:
وحدة التحكّم
-
انتقِل إلى صفحة منصة خرائط Google > وبيانات الاعتماد.
- اختَر مفتاح واجهة برمجة التطبيقات الذي تريد إعداد قيود عليه. تظهر صفحة موقع مفتاح واجهة برمجة التطبيقات.
- ضمن القيود الرئيسية، اضبط القيود التالية:
- قيود التطبيق:
- اختَر تطبيقات Android.
- انقر على + إضافة اسم حزمة وبصمة إصبع.
- أدخِل اسم الحزمة وبصمة إصبع شهادة SHA-1. مثلاً:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- قيود واجهة برمجة التطبيقات:
- انقر على تقييد المفتاح.
- اختَر Maps SDK for Android من القائمة المنسدلة Select APIs (اختيار واجهات برمجة التطبيقات). إذا لم تكن حزمة تطوير البرامج (SDK) للخرائط متوفّرة لنظام التشغيل Android، يجب تفعيلها.
- لإنهاء التغييرات التي أجريتها، انقر على حفظ.
Cloud SDK
يمكنك إدراج المفاتيح الحالية.
gcloud services api-keys list --project="PROJECT"
محو القيود الحالية على المفتاح الحالي.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
يمكنك ضبط قيود جديدة على المفتاح الحالي.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --api_target="maps-android-backend.googleapis.com" --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية: