# التكوين المستند إلى شهادة iOS

<Aside type="caution" title="هام">
تتطلب [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> 

اتبع هذا الدليل لتكوين منصة iOS يدويًا.

<Aside type="note">
تأكد من أنك قمت بإنشاء ملف تعريف توفير (provisioning profile) لتطبيقك لإرساله إلى App Store. اقرأ المزيد في [وثائق مطوري Apple](https://developer.apple.com/help/account/provisioning-profiles/create-an-app-store-provisioning-profile).
</Aside>

## إنشاء ملف طلب شهادة

1. قم بتشغيل **Keychain Access**، اذهب إلى **Certificate Assistant** وانقر على **Request a Certificate From a Certificate Authority**:

<img src="/ios-configuration-ios-platform-configuration-1.webp"
     alt="تطبيق Keychain Access على macOS يعرض قائمة Certificate Assistant لطلب CSR لشهادة APNs"/>

2. أدخل المعلومات المطلوبة واختر **Saved to disk**. يجب أن تترك حقل البريد الإلكتروني لـ CA فارغًا. انقر على **Continue** و **Save** لطلب الشهادة باستخدام الاسم المقترح.

<img src="/ios-configuration-ios-platform-configuration-2.webp"
     alt="إنشاء CSR في Keychain Access"/>

## إنشاء شهادة APNs في بوابة مطوري Apple

1. قم بتسجيل الدخول إلى [بوابة مطوري Apple](https://developer.apple.com/account/) وافتح **Certificates, Identifiers & Profiles** في علامة التبويب **Account**. انقر على **Add**:

<img src="/ios-configuration-ios-platform-configuration-3.webp"
     alt="بوابة مطوري Apple—لوحة تحكم Certificates, Identifiers & Profiles مع زر Add certificate"/>

2. اختر نوع الشهادة الذي تحتاجه وانقر على **Continue** في أسفل الصفحة.

<Aside type="note">
يمكنك تحديد نوع شهادة **Sandbox & Production** الموضح في لقطة الشاشة أدناه ثم اختيار **Gateway** المناسب عند تكوين منصة iOS في لوحة تحكم Pushwoosh. يمكنك أيضًا إنشاء شهادات Sandbox و Production بشكل منفصل إذا لزم الأمر.
</Aside>

<img src="/ios-configuration-ios-platform-configuration-4.webp"
     alt="اختيار نوع شهادة APNs SSL (Sandbox & Production) في بوابة مطوري Apple"/>

3. حدد **App ID** لمشروعك في الصفحة التالية، ثم انقر على **Continue**.

<img src="/ios-configuration-ios-platform-configuration-5.webp"
     alt="اختيار App ID لإصدار شهادة APNs في بوابة مطوري Apple"/>

<Aside>
يمكنك تخطي **About Creating a Certificate Signing Request (CSR)** حيث أنك قمت بالفعل بإنشاء واحد.
</Aside>

4. اختر **Certificate Signing Request** الذي أنشأته سابقًا.

<img src="/ios-configuration-ios-platform-configuration-6.webp"
     alt="تحميل ملف CSR"/>

5. قم بتنزيل الشهادة وأضفها إلى **Keychain Access**. بمجرد النقر على الشهادة، سيتم تشغيل **Keychain Access**.

<img src="/ios-configuration-ios-platform-configuration-7.webp"
     alt="تنزيل الشهادة من بوابة مطوري Apple"/>

## تصدير المفتاح الخاص (.p12)

في **Keychain Access**، انقر بزر الماوس الأيمن على الشهادة التي أضفتها للتو واختر Export.

<img src="/ios-configuration-ios-platform-configuration-8.webp"
     alt="تصدير المفتاح الخاص كملف .p12 من Keychain Access"/>

احفظ ملف **Personal Information Exchange (.p12)**. سيُطلب منك إعداد كلمة مرور.

<Aside type="caution" title="هام">
تأكد من تذكر كلمة مرور المفتاح الخاص (Private Key Password)، ستحتاجها لاحقًا.
</Aside>

بعد إدخال كلمة المرور الخاصة بك، انقر على **Allow** لإنهاء تصدير المفتاح الخاص (Private Key).

## تكوين منصة iOS في Pushwoosh

في مشروع Pushwoosh الخاص بك، اذهب إلى قسم **Configure Platforms** وانقر على **Configure** في صف iOS:

<img src="/ios-configuration-ios-platform-configuration-9.webp" alt="لوحة تحكم Pushwoosh تظهر صف iOS مع زر Configure"/>

في النموذج المفتوح، اختر **certificate-based manual configuration** وانقر على **Next**:

<img src="/ios-configuration-ios-platform-configuration-10.webp" alt="نموذج Pushwoosh مع تحديد التكوين اليدوي المستند إلى الشهادة"/>

في النافذة المفتوحة، قم بما يلي:

* قم بتحميل ملف الشهادة (.p12)
* أدخل **كلمة مرور المفتاح الخاص (Private key password)**
* اختر **Gateway**

<img src="/ios-configuration-ios-platform-configuration-11.webp" alt="حقول لتحميل ملف .p12، وإدخال كلمة المرور، واختيار البوابة في Pushwoosh"/>

انقر على **Configure** لإكمال الإعداد.