Настройка поставщика проверки подлинности LinkedIn

Настройка средства обработки регистрации

Чтобы использовать поставщика проверки подлинности для единой регистрации, необходимо создать средство обработки регистрации. Средство обработки регистрации создает пользователей и обновляет существующих пользователей, входящих в Salesforce посредством поставщика удостоверений. Средство обработки регистрации можно настроить посредством Apex или Flow Builder. Дополнительную информацию см. в разделе Создание средства обработки регистрации поставщика проверки подлинности.

Ниже указан пример средства обработки регистрации Apex для поставщика проверки подлинности LinkedIn. Это средство обработки регистрации предполагает, что запрошенные области содержат r_liteprofile и r_emailaddress. Кроме того, оно предполагает, что пользователи входят на клиентский портал.

Примечание Стандартное средство обработки регистрации требует наличия адреса эл. почты. Используйте этот запрос на получение электронного адреса текущего проверенного пользователя. GET https://api.linkedin.com/v2/emailAddress?q=members&projection=(elements*(handle~)).

Пример

//TODO:This auto-generated class includes the basics for a Registration
//Handler class. You will need to customize it to ensure it meets your needs and
//the data provided by the third party.
global class LinkedInRegHandler implements Auth.RegistrationHandler {
    //Creates a Standard salesforce or a community user
    global User createUser(Id portalId, Auth.UserData data) {
        if (data.attributeMap.containsKey('sfdc_networkid')) {
            //We have a community id, so create a user with community access
            //TODO: Get an actual account
            Account a =[SELECT Id FROM account WHERE name = 'LinkedIn Account'];
            Contact c = new Contact();
            c.accountId = a.Id;
            c.email = data.email;
            c.firstName = data.firstName;
            c.lastName = data.lastName;
            insert(c);
            //TODO: Customize the username and profile. Also check that the username 
            //doesn't already exist and possibly ensure there are enough org licenses
            //to create a user. Must be 80 characters or less.
            User u = new User();
            Profile p =[SELECT Id FROM profile WHERE name = 'Customer Portal Manager'];
            u.username = data.firstName + '@sfdc.linkedin.com';
            u.email = data.email;
            u.lastName = data.lastName;
            u.firstName = data.firstName;
            String alias = data.firstName;
            //Alias must be 8 characters or less
            if (alias.length() > 8) {
                alias = alias.substring(0, 8);
            }
            u.alias = alias;
            u.languagelocalekey = UserInfo.getLocale();
            u.localesidkey = UserInfo.getLocale();
            u.emailEncodingKey = 'UTF-8';
            u.timeZoneSidKey = 'America/Los_Angeles';
            u.profileId = p.Id;
            u.contactId = c.Id;
            return u;
        } else {
            //This is not a community, so create a regular standard user
            User u = new User();
            Profile p =[SELECT Id FROM profile WHERE name = 'Standard User'];
            //TODO: Customize the username. Also check that the username doesn't
            //already exist and possibly ensure there are enough org licenses
            //to create a user. Must be 80 characters or less
            u.username = data.firstName + '@salesforce.com';
            u.email = data.email;
            u.lastName = data.lastName;
            u.firstName = data.firstName;
            String alias = data.firstName;
            //Alias must be 8 characters or less
            if (alias.length() > 8) {
                alias = alias.substring(0, 8);
            }
            u.alias = alias;
            u.languagelocalekey = UserInfo.getLocale();
            u.localesidkey = UserInfo.getLocale();
            u.emailEncodingKey = 'UTF-8';
            u.timeZoneSidKey = 'America/Los_Angeles';
            u.profileId = p.Id;
            return u;
        }
    }
    //Updates the user's first and last name
    global void updateUser(Id userId, Id portalId, Auth.UserData data) {
        User u = new User(id = userId);
        u.lastName = data.lastName;
        u.firstName = data.firstName;
        update(u);
    }
}

Просмотр областей LinkedIn

Настройте приложение LinkedIn

1. Войдите в учетную запись разработчика в LinkedIn.
2. В LinkedIn нажмите на изображение профиля вверху и выберите «Мои приложения».
3. Нажмите кнопку «Создать приложение».
4. Введите параметры приложения.
5. Запишите код клиента и секрет клиента.

Определение поставщика LinkedIn для организации Salesforce

1. В настройках используйте поле быстрого поиска, чтобы найти и выбрать «Поставщики проверки подлинности».
2. Щелкните «Создать».
3. Выберите LinkedIn в качестве типа поставщика.
4. Введите имя поставщика.
5. Заполните поле «Индекс URL-адреса». Данное значение используется в URL-адресах конфигурации клиента. Например, если суффикс URL-адреса поставщика будет MyLinkedInProvider, то URL-адрес SSO выглядит так: https://mydomain_url или community_url/services/auth/sso/MyLinkedInProvider.
6. Для секрета пользователя введите секрет клиента LinkedIn.
7. Чтобы использовать средство обработки регистрации Apex, выполните данные действия.
   1. В поле «Тип средства обработки регистрации» выберите Apex.
   2. В средстве обработки регистрации выберите существующий класс Apex, реализующий интерфейс Auth.RegistrationHandler. Или, чтобы создать шаблон для средства обработки регистрации, нажмите «Автоматически создавать шаблон средства обработки регистрации». Прежде чем использовать данный класс, внесите изменения в стандартное содержимое.
8. Чтобы использовать поток для средства обработки регистрации, выполните данные действия.
   1. В поле «Тип средства обработки регистрации» выберите «Поток».
   2. В средстве обработки регистрации выберите существующий поток типа потока регистрации пользователя удостоверения.
   3. Выберите профиль по умолчанию. Стандартный профиль обязателен для запуска средства обработки регистрации. Если вы не укажете стандартный профиль здесь, задайте стандартный профиль в самом потоке.

      Если вы используете шаблон потока регистрации пользователя поставщика проверки подлинности, заданный здесь профиль автоматически сохраняется в переменной defaultProfileId.

   4. Выберите организацию по умолчанию. Если вы используете поставщика проверки подлинности для сайтов Experience Cloud, эта организация хранит новых внутренних пользователей.

      Если вы используете шаблон потока регистрации пользователя поставщика проверки подлинности, заданный здесь профиль автоматически сохраняется в переменной defaultAccountId.

9. В поле «Выполнить регистрацию как» выберите пользователя выполнения для запуска класса или потока Apex. Пользователю должно быть предоставлено полномочие «Управление пользователями».

   Параметр «Выполнить регистрацию как» предоставляет контекст, в котором запускается средство обработки регистрации. В производственной среде обычно создается системный пользователь в качестве пользователя «Выполнить регистрацию как». Таким образом, операции, выполняемые средством обработки, легко отслеживаются в обратном порядке к процессу регистрации. Например, если контакт создан, системный пользователь его создает.

10. По желанию, задайте данные поля:
    • Для URL-адреса конечной точки проверки подлинности введите https://www.linkedin.com/oauth/v2/authorization.
    • Для URL-адреса конечной точки маркера введите URL-адрес маркера OAuth из LinkedIn. Например, https://www.linked.com/oauth/v2/accessToken. Для получения дополнительных сведений см. Проверка подлинности посредством OAuth 2.0: Обзор.
    • Для изменения значений, запрошенных из профиля API LinkedIn введите URL-адрес конечной точки сведений о пользователе. Дополнительную информацию см. в разделе «Профиль API». URL-адрес должен начинаться с компонента https://api.linkedin.com/v2/me, а запрошенные поля должны соответствовать запрошенным областям.
    • В поле «Стандартные области», введите поддерживаемое значение или значения, разделенные посредством пробела, которые соответствуют информации, извлеченной из LinkedIn.
    • Если вы введете ключ пользователя и секрет пользователя, секрет пользователя включен в ответы SOAP API по умолчанию. Чтобы скрыть секрет в ответах SOAP API, снимите флажок «Добавить секрет пользователя в ответы SOAP API». Начиная с ноября 2022 года, секрет всегда заменяется в ответах Metadata API значением структурного нуля. При развертывании замените структурный нуль секретом пользователя в виде обычного текста или внесите изменения в значение позже в пользовательском интерфейсе.
    • В поле «URL-адрес настраиваемой ошибки» введите URI-адрес, значение которого должно использоваться поставщиком для уведомления об ошибках.
    • В поле «URL-адрес значка» добавьте путь в значок для отображения в виде кнопки на странице входа для сайта. Этот значок применяется только к сайту Experience Cloud. Оно не отображается на вашей странице входа Salesforce или в URL-адресе входа «Моего домена». Кнопка позволяет пользователям выполнять вход посредством связанного поставщика проверки подлинности для сайта. Укажите путь к собственному изображению или скопируйте URL-адрес одного из тестовых значков.
    • Чтобы использовать портал для пользователей LinkedIn, выберите нужный портал в раскрывающемся списке «Портал».
11. Чтобы использовать функцию многофакторной проверки подлинности (MFA) Salesforce вместо службы MFA поставщика удостоверений, выберите «Использовать MFA Salesforce для данного поставщика SSO». Данный параметр инициирует MFA только для пользователей, которые напрямую применяли MFA. Дополнительную информацию см. в разделе Использование Salesforce MFA для SSO (организации Salesforce).
12. Сохраните выполненную работу.

Обновление приложения LinkedIn

Тестирование подключения SSO

Добавление поставщика проверки подлинности на страницу входа