دليل خطوة بخطوة لإعداد تطبيق متصل في Salesforce لتكامل OAuth سهل
مرحبًا بك في هذا الدليل عن إعداد تطبيق متصل (Connected App) في Salesforce لتكامل OAuth سلس. في هذا الدرس خطوة بخطوة ستتعلم أساسيات إعداد تطبيق متصل في Salesforce والوصول إليه عبر Postman باستخدام API. لنتعمق في OAuth، بدءًا بإعداد تطبيق متصل.
الخطوة 1: إنشاء تطبيق متصل جديد
انتقل إلى App Manager: ابدأ بفتح App Manager في Salesforce.
فعّل الوصول عبر API: لتسهيل الوصول من التطبيقات الخارجية عبر API، أنشئ تطبيقًا متصلًا جديدًا وسمّه “App One”.
اضبط التطبيق: أدخل بريدًا إلكترونيًا للتطبيق وفعّل إعدادات OAuth. ومع أن بعض تدفقات OAuth تتطلب عنوان URL لرد الاستدعاء (callback URL)، وهو ما سنناقشه في أدلة لاحقة، أدخل الآن قيمة وهمية مثل “www.salesforce.com (opens in a new tab)”.
الخطوة 2: تحديد نطاقات OAuth
تحدد النطاقات (scopes) القدرات المتاحة عبر API. في هذا الدرس:
Manage User Data: عيّن النطاق الذي يتيح إدارة بيانات المستخدم عبر API.
احفظ وانتظر: احفظ إعداداتك وانتظر نحو 10 دقائق حتى تكتمل العملية.
الخطوة 3: استرجاع بيانات المستهلك (Consumer)
بعد اكتمال العملية، ستحتاج إلى معلومتين أساسيتين غير عامتين: Consumer Key وConsumer Secret. اضغط الزر المخصص لتُصادِق وتسترجع هاتين المعلومتين لـ “App One”.
الخطوة 4: المصادقة باستخدام Postman
ابدأ استدعاء POST: في Postman، أنشئ استدعاء POST إلى خادم OAuth على “login.salesforce.com/services/oauth2/token”.
اضبط المعاملات: أدخل المعاملات في جسم الطلب، ومنها نوع المنح grant type (password)، ومعرّف العميل client ID (Consumer Key)، وClient Secret.
أدخل بيانات اعتماد المستخدم: أضف اسم مستخدم وكلمة مرور إلى المعاملات، ثم أرسل طلب POST إلى نقطة نهاية OAuth للمصادقة.
الخطوة 5: رمز الوصول والاستعلامات
بعد نجاح المصادقة:
احصل على رمز الوصول: ستتلقى رمز وصول ضروريًا لإجراء استدعاءات API.
أدخل الرمز: في Postman، في طلب الاستعلام، أدخل رمز الوصول في سطر التفويض (authorization) في الترويسة، مسبوقًا بالكلمة ‘Bearer’.
شغّل الاستعلامات: بعد إدخال الرمز، أرسل الطلب لتشغيل الاستعلامات، فتسترجع البيانات بنجاح.
الخطوة 6: إصدارات نقطة النهاية وخطوات إضافية
يمكنك الآن الوصول إلى إصدار نقطة النهاية الخاصة بتطبيقك المتصل (مثل الإصدار 58) لاسترجاع البيانات. لن يشمل هذا الإعداد الأساسي كل عناصر التدفق الإضافية أو عمليات رد الاستدعاء، لكنه خطوة تأسيسية لتكامل OAuth بين Postman وSalesforce.
الخلاصة والخطوات التالية
لقد أعددت الآن بنجاح تطبيقًا متصلًا في Salesforce وصادقت عليه باستخدام OAuth للوصول عبر API من Postman. ومع أن هذا الدليل يغطي الأساسيات، ستقدّم الدروس اللاحقة تدفقات OAuth ووظائف إضافية تعزز قدرات تطبيقك.
تابعنا
انطلق في رحلتك مع واجهات Salesforce API بثقة! لمزيد من الأفكار والنصائح، تابعنا هنا على www.SteveTechArc.com وعلى قناة @SteveTechArc (opens in a new tab) على YouTube. اشترك وعمّق فهمك لـ Salesforce وكيف يمكنك دمجها مع أنظمة أخرى.
نساعد في تغيير العالم بمشاركة معلومات التكامل مع زملائنا المعماريين ومع من هم في رحلتهم نحو أن يصبحوا معماريين!
نص مكتوب بمساعدة الذكاء الاصطناعي
STA 3.11