إنتقل إلى المحتوى الرئيسي

المتطلبات المسبقة

تكوين المتطلبات المسبقة

تكوين مكوّنات Salesforce لتكامل DuoKey BYOK

معاينة

تكامل Salesforce Shield في مرحلة المعاينة وغير مفعّل بعد على مستأجري DuoKey Cockpit القياسيين. يشرح هذا الدليل طريقة عمله وإعداده. تواصل مع DuoKey لمناقشة إتاحته لمشروعك.

ينطبق على:
Salesforce SetupConnected AppSelf-Signed CertificateREST API Credentials

نظرة عامة​

تشمل المتطلبات المسبقة ما يلي:

  1. إنشاء Connected App في Salesforce
  2. توليد شهادة موقّعة ذاتيًا
  3. الحصول على اعتمادات REST API

الخطوة 1: إنشاء Connected App​

يُنشئ Connected App اتصالًا آمنًا بين DuoKey وSalesforce عبر REST API.

1

الانتقال إلى App Manager

  1. سجّل الدخول إلى حساب Salesforce الخاص بك
  2. انقر أيقونة الترس Setup
  3. في Quick Find، ابحث عن "App Manager"
  4. انتقل إلى Apps ← App Manager
2

إنشاء Connected App جديد

  1. انقر زر New Connected App
  2. املأ المعلومات الأساسية:
الحقلالقيمة
Connected App NameDuoKey BYOK Integration
API Name(معبّأ تلقائيًا)
Contact Email[email protected]
3

تكوين إعدادات OAuth

  1. حدد Enable OAuth Settings
  2. عيّن Callback URL: sfdc://oauth/restapi/success
  3. في Selected OAuth Scopes، أضف: Full access (full)
  4. انقر Save
ملاحظة

عنوان رد النداء sfdc://oauth/restapi/success قياسي لتكاملات Salesforce REST API.

4

الحصول على Consumer Key وSecret

  1. من App Manager، اعثر على Connected App الذي أنشأته حديثًا
  2. انقر سهم القائمة المنسدلة (▼) واختر View
  3. في قسم API (Enable OAuth Settings)، انقر Manage Consumer Details
  4. أدخل رمز التحقق المُرسَل إلى بريدك الإلكتروني
  5. انسخ واحفظ بشكل آمن:
    • Consumer Key (Client ID)
    • Consumer Secret (Client Secret)
تحذير

حافظ على أمان هذه الاعتمادات. ستحتاج إليها عند تكوين تطبيق DuoKey.

الخطوة 2: توليد شهادة موقّعة ذاتيًا​

يتطلب Salesforce شهادة موقّعة ذاتيًا لتكامل BYOK مع خدمة Cache-Only Key.

1

الانتقال إلى إدارة الشهادات

  1. في إعداد Salesforce، ابحث عن "Certificate" في Quick Find
  2. انتقل إلى Security ← Certificate and Key Management
2

إنشاء شهادة موقّعة ذاتيًا

  1. انقر Create Self-Signed Certificate
  2. املأ تفاصيل الشهادة:
الحقلالقيمةملاحظة
LabelDuoKey BYOK Certificateاسم وصفي
Unique Name(معبّأ تلقائيًا)أو أدخله يدويًا
Key Size4096مُوصى به للأمان
Exportable Private Keyمحدد يتيح النسخ الاحتياطي/الترحيل
نصيحة

يتيح لك تفعيل "Exportable Private Key" تصدير الشهادة إذا لزم الأمر لأغراض النسخ الاحتياطي أو الترحيل.

انقر Save

الخطوة 3: الحصول على اعتمادات REST API​

اسم مستخدم وكلمة مرور Salesforce​

هذه هي اعتمادات تسجيل الدخول القياسية إلى Salesforce:

  • اسم المستخدم: بريد حساب Salesforce الخاص بك
  • كلمة المرور: كلمة مرور حساب Salesforce الخاص بك

توليد Security Token​

1

إعادة تعيين Security Token

  1. انقر على أيقونة ملفك الشخصي في أعلى اليمين
  2. اختر Settings
  3. في Quick Find، ابحث عن "Reset My Security Token"
  4. انتقل إلى My Personal Information ← Reset My Security Token
  5. انقر Reset Security Token
  6. تحقق من بريدك الإلكتروني بحثًا عن الرمز الأمني الجديد
  7. انسخ واحفظ الرمز الأمني بشكل آمن
تنبيه
  • يُرسَل الرمز الأمني عبر البريد الإلكتروني ويجب الحفاظ على سريّته
  • إذا غيّرت كلمة المرور، تتم إعادة تعيين رمزك الأمني تلقائيًا
  • ستحتاج إلى استخدام أحدث رمز أمني لمصادقة API

نطاق/مثيل Salesforce​

  1. انتقل إلى Setup Home ← Company Settings ← My Domain
  2. دوّن اسم نطاقك (مثال: yourcompany.develop.lightning.force.com)
  3. استخرج الاسم المستعار للمثيل (مثال: yourcompany)

ملخص الاعتمادات​

الاعتمادالوصفمثال
Consumer Keyمن إعدادات OAuth في Connected App3MVG9... (سلسلة طويلة)
Consumer Secretمن إعدادات OAuth في Connected App12345... (سلسلة رقمية)
Salesforce Usernameبريد تسجيل الدخول إلى Salesforce[email protected]
Salesforce Passwordكلمة مرور حساب Salesforce الخاص بكYourP@ssw0rd
Security Tokenمن Reset My Security TokenABC123... (أبجدي رقمي)
Domain/Instanceالاسم المستعار لنطاق Salesforce الخاص بكyourcompany
Certificateاسم الشهادة الموقّعة ذاتيًاDuoKey BYOK Certificate
نصيحة

فكّر في استخدام مدير كلمات مرور آمن لتخزين هذه الاعتمادات بأمان.

قائمة التحقق​

اكتمال المتطلبات المسبقة

Connected Appمُنشأ مع تفعيل OAuth
اعتمادات Consumerتم الحصول على Key وSecret
الشهادةمفتاح بطول 4096 بت مُنشأ
Security Tokenتم الحصول عليه عبر البريد الإلكتروني

استكشاف الأخطاء وإصلاحها​

الخطوات التالية​

إنشاء تطبيق Salesforce

كوّن تطبيق DuoKey

اختبار التكامل

تحقق من أن الإعداد يعمل

انظر أيضًا