# خيارات تكوين iOS

يقدم هذا القسم إرشادات خطوة بخطوة لتكوين تطبيق iOS الخاص بك لتمكين خدمات المراسلة باستخدام Pushwoosh. اختر بين التكوين المستند إلى الشهادة أو التكوين المستند إلى الرمز المميز حسب متطلبات مشروعك.

<Aside type="tip">
بغض النظر عن الطريقة المختارة، حافظ على أمان شهاداتك ومفاتيحك. يمكن أن يؤدي الوصول غير المصرح به إلى إساءة استخدام إمكانيات إشعارات الدفع الخاصة بك.
</Aside>
## تكوين iOS المستند إلى الشهادة
تعرف على كيفية تكوين Pushwoosh لنظام iOS باستخدام المصادقة المستندة إلى الشهادة لـ APNs (خدمة إشعارات الدفع من Apple).

<LinkCard title="اعرف المزيد" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/" />

## تكوين iOS المستند إلى الرمز المميز
قم بإعداد Pushwoosh مع المصادقة المستندة إلى الرمز المميز لـ APNs، مما يوفر بديلاً أكثر أمانًا وفعالية للشهادات.

<LinkCard title="اعرف المزيد" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/" />  

## تكوين شهادة VoIP لنظام iOS
قم بتمكين Pushwoosh لتقديم إشعارات دفع VoIP إلى تطبيق iOS الخاص بك حتى تتمكن من إرسال تنبيهات المكالمات الواردة وأحداث VoIP الأخرى إلى أجهزة المستخدمين.

<LinkCard title="اعرف المزيد" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-voip-certificate-configuration/" />

## تكوين بطاقة Apple Wallet لنظام iOS
قم بتحميل شهادة توقيع معرف نوع البطاقة (Pass Type ID) الخاص بك حتى يتمكن Pushwoosh من توقيع وتحديث بطاقات Apple Wallet (`.pkpass`) لتطبيقك.

<LinkCard title="اعرف المزيد" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/" />

## الاختيار بين شهادات .p12 ومفاتيح .p8 لإشعارات الدفع في iOS

عند تكوين إشعارات الدفع لنظام iOS في Pushwoosh، يجب عليك المصادقة مع خدمة إشعارات الدفع من Apple (APNs). هناك طريقتان مدعومتان:

1. **شهادة `.p12`**: النهج التقليدي المستند إلى الشهادة.
2. **مفتاح `.p8`**: الطريقة الحديثة المستندة إلى الرمز المميز التي توصي بها Apple.

سيساعدك هذا الدليل في تحديد الطريقة الأنسب لحالة استخدامك.
<Aside type="caution" title="Important">
تتطلب [Live Activities](/ar/developer/pushwoosh-sdk/ios-sdk/ios-live-activities/) في Pushwoosh [تكوينًا مستندًا إلى الرمز المميز](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/). إذا كنت تنوي استخدام Live Activities، فتأكد من أن تكوين iOS الخاص بك يستخدم هذه الطريقة، حيث أن التكوين المستند إلى الشهادة غير مدعوم.
</Aside> 


## فهم الخيارات

| الميزة               | شهادة `.p12`                                         | مفتاح مصادقة `.p8`                                        |
|----------------------|------------------------------------------------------------|------------------------------------------------------------------|
| **كيف تعمل**     | تستخدم شهادة تشفير لإنشاء الثقة.       | تستخدم رمزًا مميزًا دائمًا موقعًا بمفتاح خاص.                |
| **الملف**             | ملف `.p12` يحتوي على الشهادة والمفتاح الخاص.    | ملف `.p8` يحتوي على مفتاح خاص.                            |
| **انتهاء الصلاحية**       | تنتهي صلاحيتها (عادةً سنويًا)؛ تتطلب التجديد.          | لا تنتهي صلاحيتها تلقائيًا.                                           |
| **الإعداد**            | أكثر تعقيدًا في الإنشاء والإدارة.                       | أبسط بشكل عام في الإعداد.                                    |
| **الاستخدام**            | شهادة واحدة لكل Bundle ID لكل بيئة.        | مفتاح واحد يدعم تطبيقات متعددة وكلتا البيئتين.           |
| **التوصية**   | طريقة قديمة. استخدمها فقط للإعدادات الحالية.               | موصى بها من قبل Apple و Pushwoosh.                        |


## إيجابيات وسلبيات كل طريقة

### شهادة `.p12`: النهج التقليدي

**الإيجابيات:**
- مدعومة على نطاق واسع.
- تسمح بشهادات منفصلة للتطوير والإنتاج.

**السلبيات:**
- تنتهي صلاحية الشهادات وتتطلب التجديد. يمكن أن يؤدي عدم التجديد إلى تعطيل تسليم الإشعارات.
- أكثر تعقيدًا في الإدارة.


### مفتاح `.p8`: النهج الحديث الموصى به

**الإيجابيات:**
- لا تتطلب تجديدًا، مما يقلل من عبء الصيانة.
- أسهل في الإنشاء والتكامل.
- مفتاح واحد يعمل عبر المشاريع.
- موصى به من قبل Apple و Pushwoosh.

**السلبيات:**
- في حالة اختراقها، تكون جميع التطبيقات المرتبطة بها في خطر. قم بتأمين مفتاح `.p8` الخاص بك بشكل صحيح.


## أي طريقة يجب أن تختار؟

<Aside type="caution" title="Important security note">
بغض النظر عن الطريقة التي تختارها، قم دائمًا بتأمين شهاداتك ومفاتيحك. يمكن أن يؤدي الوصول غير المصرح به إلى تعريض البنية التحتية لإشعارات الدفع الخاصة بك للخطر.
</Aside>

نوصي باستخدام **طريقة مفتاح `.p8`** لجميع المشاريع الجديدة. إنها أبسط وأكثر قابلية للتوسع وتتوافق مع أفضل ممارسات Apple.

استخدم شهادات `.p12` فقط إذا:

- لديك بنية تحتية حالية تعتمد على شهادات `.p12`.
- تتطلب فصلًا صارمًا للبيئة لا يمكن تحقيقه باستخدام مفتاح `.p8`.


## أدلة التكوين

<CardGrid>
  <LinkCard title="التكوين المستند إلى الشهادة" href="ios-platform-configuration" />
  <LinkCard title="التكوين المستند إلى الرمز المميز" href="ios-token-based-configuration" />
  <LinkCard title="تكوين شهادة VoIP لنظام iOS" href="ios-voip-certificate-configuration" />
  <LinkCard title="تكوين بطاقة Apple Wallet لنظام iOS" href="ios-wallet-pass-configuration" />
</CardGrid>