Перекладено ШІ. Спільнота ще не перевірила. Читати англійською

Блог · 3 жовтня 2023 р. · Steve Simpson · Ідентичність

Покроковий посібник із налаштування Salesforce Connected App для простої інтеграції OAuth

Ласкаво просимо до цього посібника з налаштування Salesforce Connected App для безперешкодної інтеграції OAuth. У цьому покроковому туторіалі ви вивчите основи налаштування Connected App у Salesforce і доступу до нього через Postman за допомогою API. Заглибмося в OAuth, почавши з налаштування Connected App.

Крок 1: створіть новий Connected App

Перейдіть до App Manager: Почніть із відкриття App Manager у Salesforce.

Увімкніть доступ до API: Щоб забезпечити доступ із зовнішніх застосунків через API, створіть новий Connected App і назвіть його “App One”.

Налаштуйте застосунок: Вкажіть email для застосунку й увімкніть налаштування OAuth. Хоча деякі OAuth flows вимагають callback URL (про це в наступних посібниках), поки що введіть фіктивне значення, як-от “www.salesforce.com (opens in a new tab)”.

Скриншот: створення нового connected app в App Manager з увімкненими налаштуваннями OAuth Скриншот: вибір OAuth scopes для connected app і налаштування callback URL

Крок 2: задайте OAuth scopes

Scopes визначають можливості, доступні через API. Для цього туторіалу:

Manage User Data: Призначте scope, що дає змогу керувати даними користувачів через API.

Збережіть і зачекайте: Збережіть налаштування й зачекайте приблизно 10 хвилин, доки процес завершиться.

Крок 3: отримайте дані Consumer

Коли процес завершиться, вам знадобляться два важливі непублічні значення: Consumer Key і Consumer Secret. Натисніть відповідну кнопку, щоб автентифікуватися й отримати ці дані для “App One”.

Крок 4: автентифікуйтеся через Postman

Скриншот Postman: POST до endpoint токенів Salesforce OAuth, що повертає токен доступу

Почніть виклик POST: У Postman створіть виклик POST до сервера OAuth за адресою “login.salesforce.com/services/oauth2/token”.

Задайте параметри: Вставте параметри в тіло запиту, зокрема grant type (password), client ID (Consumer Key) і Client Secret.

Вставте облікові дані користувача: Додайте до параметрів ім’я користувача й пароль, а потім надішліть POST на endpoint OAuth, щоб автентифікуватися.

Крок 5: токен доступу й запити

Після успішної автентифікації:

Отримайте токен доступу: Ви отримаєте токен доступу, потрібний для викликів API.

Вставте токен: У Postman у вашому запиті вставте токен доступу в рядок authorization заголовка, поставивши перед ним слово ‘Bearer’.

Скриншот Postman: REST-запит із токеном доступу в заголовку authorization, що повертає записи в JSON

Виконуйте запити: Вставивши токен, надішліть запит, щоб виконати запити й успішно отримати дані.

Крок 6: версіонування endpoint і додаткові кроки

Тепер ви можете звертатися до версії endpoint вашого Connected App (наприклад, версії 58), щоб отримувати дані. Це базове налаштування не охоплює всіх додаткових елементів flow чи callbacks, але слугує основою для інтеграції OAuth із Postman і Salesforce.

Висновок і наступні кроки

Ви успішно налаштували Salesforce Connected App і автентифікували його за допомогою OAuth для доступу до API через Postman. Хоча цей посібник охоплює основи, наступні туторіали познайомлять із додатковими OAuth flows і функціональністю, що розширять можливості вашого застосунку.

Слідкуйте за новинами

Вирушайте в подорож API Salesforce впевнено! Більше думок і порад — тут, на www.SteveTechArc.com, і на YouTube-каналі @SteveTechArc (opens in a new tab). Підпишіться й поглиблюйте розуміння Salesforce і того, як інтегрувати його з іншими системами.

Допомагаю змінювати світ, ділячись знаннями про інтеграцію з колегами-архітекторами і тими, хто йде до архітектури!

Транскрипт оброблено за допомогою ШІ

STA 3.11