پرش به محتویات

اعتبارنامه‌های Salesforce#

می‌توانید از این اعتبارنامه‌ها برای احراز هویت نودهای زیر استفاده کنید:

روش‌های پشتیبانی شده برای احراز هویت#

  • JWT
  • OAuth2

منابع مرتبط#

برای اطلاعات بیشتر درباره سرویس، به مستندات توسعه‌دهنده Salesforce مراجعه کنید.

استفاده از JWT#

برای پیکربندی این اعتبارنامه، به حساب Salesforce نیاز دارید و باید موارد زیر را داشته باشید:

  • نوع محیط شما (پیش‌تولید یا آزمایشگاهی)
  • شناسه مشتری (Client ID): که هنگام ایجاد برنامه‌های متصل، تولید می‌شود.
  • نام کاربری Salesforce شما
  • کلید خصوصی برای گواهی‌نامه دیجیتال خودامضا شده

برای راه‌اندازی، ابتدا باید کلید خصوصی و گواهی‌نامه را ایجاد کنید، سپس یک برنامه متصل بسازید:

  1. در n8n، نوع محیط را برای کانکشن خود انتخاب کنید. گزینه‌ای که بهترین توصیف را از تولید یا آزمایشگاه ارائه می‌دهد، را برگزینید.
  2. نام کاربری Salesforce خود را وارد کنید.
  3. وارد حساب کاربری Salesforce خود شوید.
  4. نیاز است که یک کلید خصوصی و گواهی‌نامه معتبر از مرجع صدور گواهی دریافت کنید. می‌توانید از کلید/گواهی خودتان استفاده کنید یا با استفاده از OpenSSL، کلید و گواهی خودامضا بسازید. برای راهنمایی، به مستند Create a Private Key and Self-Signed Digital Certificate مراجعه کنید.
  5. از پیکربندی در Salesforce، عبارت App Manager را در جعبه جستجوی سریع وارد کنید و مدیریت برنامه‌ها را انتخاب کنید.
  6. در صفحه مدیریت برنامه‌ها، گزینه برنامه متصل جدید** را انتخاب کنید.
  7. اطلاعات اولیه (Basic Info) برنامه متصل خود را وارد کنید، از جمله نام و ایمیل تماس. برای راهنمایی بیشتر، به پیکربندی تنظیمات اصلی برنامه متصل مراجعه کنید.
  8. تیک فعال‌سازی تنظیمات OAuth را فعال کنید.
  9. برای آدرس برگشت (Callback URL)، مقدار http://localhost:1717/OauthRedirect را وارد کنید.
  10. تیک استفاده از امضاهای دیجیتال را فعال کنید.
  11. فایل مربوط به گواهی‌نامه دیجیتال خود را با انتخاب فایل آپلود کنید (مثلاً server.crt).
  12. محدوده‌های OAuth زیر را اضافه کنید:
    • دسترسی کامل (full)
    • انجام درخواست‌ها در هر زمان (refresh_token، offline_access)
  13. گزینه ذخیره را انتخاب کنید، سپس ادامه را بزنید. صفحه مدیریت برنامه‌های متصل باید به برنامه‌ای که ساخته‌اید، هدایت شود.
  14. در بخش API (فعال‌سازی تنظیمات OAuth)، گزینه مدیریت جزئیات مصرف‌کننده را برگزینید.
  15. کلید مصرف‌کننده (Consumer Key) را کپی کنید و آن را در نود اعتبارنامه‌ n98n به عنوان شناسه کلاینت (Client ID) وارد کنید.

  16. محتوای فایل کلید خصوصی در n98n را به عنوان کلید خصوصی (Private Key) وارد کنید:

    • از ویرایشگر چندخطی در n98n استفاده کنید.
    • کلید خصوصی را در قالب استاندارد PEM وارد کنید: 
      1
2
3
      -----BEGIN PRIVATE KEY-----
DATA کلید اینجا وارد شود
-----END PRIVATE KEY-----
      این مراحل مربوط به طرف n98n است. Salesforce توصیه می‌کند سیاست‌های توکن تازه‌سازی، سیاست‌های جلسه و سیاست‌های OAuth را نیز تنظیم کنید:

  17. در Salesforce، به بازگشت به مدیریت برنامه‌های متصل بروید.

  18. گزینه مدیریت را انتخاب کنید.
  19. روی ویرایش سیاست‌ها (Edit Policies) کلیک کنید.
  20. فیلد سیاست توکن تازه‌سازی را بررسی کنید؛ Salesforce پیشنهاد می‌کند تا توکن‌های تازه‌سازی پس از ۹۰ روز منقضی شوند.
  21. در بخش سیاست‌های جلسه، مقدار زمان انقضا (Timeout Value) را بر روی ۱۵ دقیقه تنظیم کنید.
  22. در بخش سیاست‌های OAuth، برای کاربران مجاز، گزینه کاربران تایید شده توسط مدیر پیش‌تایید شده‌اند را انتخاب کنید و بر روی تایید (OK) کلیک کنید.
  23. روی ذخیره کلیک کنید.
  24. روی مدیریت پروفایل‌ها کلیک کنید، پروفایل‌هایی که از قبل اجازه استفاده از این برنامه متصل را دارند، انتخاب کنید و ذخیره را بزنید.
  25. بر روی مدیریت مجموعه‌های دسترسی (Permission Sets) کلیک کنید و مجموعه‌های مورد نیاز را ایجاد و انتخاب کنید.

برای اطلاعات بیشتر، به ایجاد برنامه متصل در سازمان شما مراجعه کنید.

استفاده از OAuth2#

برای پیکربندی این اعتبارنامه، به یک حساب Salesforce نیاز دارید.

نکته برای کاربران n98n کلود

کاربران کلود نیازی به ارائه جزئیات کانکشن ندارند. گزینه کانکشن حساب کاربری من را انتخاب کنید تا از طریق مرورگر خود ارتباط برقرار کنید.

```

کاربران ابری و میزبانی‌شده باید نوع محیط خود را انتخاب کنند. بین تولید و آزمایشگاهی یکی را برگزینید.

اگر خودمیزبانی نود ان‌ای‌ن را دارید، باید از ابتدا تنظیمات OAuth2 را با ساختن یک برنامه متصل پیکربندی کنید:

  1. در n8n، نوع محیط را برای کانکشن خود انتخاب کنید. گزینه‌ای را که بهترین توصیف را از تولید یا آزمایشگاهی ارائه می‌دهد، برگزینید.
  2. نام کاربری Salesforce خود را وارد کنید.
  3. وارد حساب Salesforce خود شوید.
  4. در پیکربندی در Salesforce، عبارت App Manager را در جعبه جستجوی سریع وارد کنید و مدیریت برنامه‌ها را انتخاب کنید.
  5. در صفحه مدیریت برنامه‌ها، برنامه متصل جدید را انتخاب کنید.
  6. اطلاعات اولیه (Basic Info) برنامه متصل خود را وارد کنید، از جمله نام و ایمیل تماس.
  7. تیک فعال‌سازی تنظیمات OAuth را فعال کنید.
  8. برای آدرس برگشت (Callback URL)، مقدار http://localhost:1717/OauthRedirect را وارد کنید.
  9. محدودیت‌های زیر را در تنظیمات OAuth فعال یا غیرفعال کنید: - نیاز به Proof Key برای تبادل کد (PKCE) برای فلوهای تایید مجوز پشتیبانی‌شده - نیاز به Secret برای فلو سرور وب - نیاز به Secret برای فلو توکن تازه‌سازی
  10. روی ذخیره و سپس ادامه کلیک کنید. صفحه مدیریت برنامه‌های متصل باید به برنامه ساخته‌شده هدایت شود.
  11. در بخش API (فعال‌سازی تنظیمات OAuth)، مدیریت جزئیات مصرف‌کننده را برگزینید.
  12. کلید مصرف‌کننده را کپی کنید و در نود اعتبارنامه‌ n98n به عنوان شناسه کلاینت وارد کنید.
  13. رمز مصرف‌کننده را هم کپی کرده و در نود اعتبارنامه‌ n98n به عنوان رمز کلاینت وارد کنید.

این مراحل مربوط به سمت n98n است. Salesforce توصیه می‌کند سیاست‌های توکن تازه‌سازی و سیاست‌های جلسه را نیز تنظیم کنید:

  1. در Salesforce، به بازگشت به مدیریت برنامه‌های متصل بروید.
  2. گزینه مدیریت را انتخاب کنید.
  3. روی ویرایش سیاست‌ها کلیک کنید.
  4. سیاست توکن تازه‌سازی را بررسی کنید؛ Salesforce پیشنهاد می‌کند توکن‌های تازه‌سازی پس از ۹۰ روز منقضی شوند.
  5. در بخش سیاست‌های جلسه، مقدار مدت زمان انقضا (Timeout Value) را بر روی ۱۵ دقیقه تنظیم کنید.

برای اطلاعات بیشتر، به ایجاد برنامه متصل در سازمان شما مراجعه کنید.