Configurar un proveedor de autenticación de LinkedIn

Configurar un controlador de registro

Para utilizar un proveedor de autenticación para el inicio de sesión único, debe crear un controlador de registro. El controlador de registro crea usuarios y actualiza usuarios existentes que acceden a Salesforce a través del proveedor de identidad. Puede configurar un controlador de registro con Apex o Flow Builder. Para obtener más información, consulte Crear un gestor de registro de proveedor de autenticación.

Este es un controlador de registro Apex de ejemplo para el proveedor de autenticación LinkedIn. Este controlador de registro asume que los ámbitos solicitados incluyen r_liteprofile y r_emailaddress. También asume que los usuarios están iniciando sesión en un portal de clientes.

Nota El controlador de registro predeterminado requiere una dirección de email. Utilice esta solicitud para recuperar la dirección de email del miembro autenticado actualmente. GET https://api.linkedin.com/v2/emailAddress?q=members&projection=(elements*(handle~)).

Ejemplo

//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);
    }
}

Ver ámbitos de LinkedIn

Configurar una aplicación LinkedIn

1. Inicie sesión en su cuenta de desarrollador en LinkedIn.
2. Desde LinkedIn, haga clic en su imagen de perfil en la parte superior y seleccione Mis aplicaciones.
3. Haga clic en Crear aplicación.
4. Ingrese los ajustes de la aplicación.
5. Anote el Id. de cliente y la Pregunta secreta del cliente.

Definir un proveedor de LinkedIn en su organización de Salesforce

1. Desde Configuración, en el cuadro Búsqueda rápida, ingrese Proveedores de autenticación, haga clic en Proveedores de autenticación, y luego haga clic en Nuevo.
2. Para el tipo de proveedor, seleccione LinkedIn.
3. Ingrese un nombre para el proveedor.
4. Ingrese el Sufijo de URL, que se utiliza en las direcciones URL de configuración de cliente. Por ejemplo, si el sufijo de URL de su proveedor es MyLinkedInProvider, su URL de SSO tendrá una apariencia similar a https://mydomain_url or community_url/services/auth/sso/MyLinkedInProvider.
5. Para Pregunta secreta de consumidor, utilice el secreto del cliente de LinkedIn.
6. Para utilizar un controlador de registro Apex, siga estos pasos.
   1. Para Tipo de controlador de registro, seleccione Apex.
   2. Para Registration Handler, seleccione una clase Apex existente que implemente la interfaz de Auth.RegistrationHandler. O bien, para crear una plantilla para el controlador de registro, haga clic en Crear automáticamente una plantilla de controlador de registro. Modifique esta clase más adelante y modificar el contenido predeterminado antes de utilizarla.
7. Para utilizar un flujo para su controlador de registro, siga estos pasos.
   1. Para Tipo de controlador de registro, seleccione Flujo.
   2. Para Controlador de registro, seleccione un flujo existente del tipo de flujo Registro de usuario de identidad.
   3. Seleccione un perfil predeterminado. Se requiere un perfil predeterminado para ejecutar el controlador de registro. Si no especifica un perfil predeterminado aquí, establezca el perfil predeterminado en el flujo en sí.

      Si utiliza la plantilla de flujo Registro de usuario de proveedor de autenticación, el perfil que establece aquí se almacena automáticamente en la variable defaultProfileId.

   4. Seleccione una cuenta predeterminada. Si utiliza su proveedor de autenticación para sitios de Experience Cloud, esta cuenta almacena nuevos usuarios internos.

      Si utiliza la plantilla de flujo Registro de usuario de proveedor de autenticación, el perfil que establece aquí se almacena automáticamente en la variable defaultAccountId.

8. Para Ejecutar registro como, seleccione un usuario de ejecución para ejecutar la clase o el flujo Apex. El usuario debe tener el permiso Gestionar usuarios.

   Ejecutar registro como proporciona el contexto en que se ejecuta el controlador de registro. En producción, habitualmente crea un usuario del sistema para el usuario Ejecutar registro como. De este modo, las operaciones realizadas por el controlador se pueden seguir fácilmente de vuelta al proceso de registro. Por ejemplo, si se crea un contacto, el usuario del sistema lo crea.

9. Opcionalmente, establezca estos campos:
   • Para Autorizar URL de extremo, ingrese https://www.linkedin.com/oauth/v2/authorization.
   • Para URL de extremo de token, ingrese la URL de token de autorización de LinkedIn. Por ejemplo, https://www.linked.com/oauth/v2/accessToken. Para obtener más información, consulte Descripción general de Autenticación con OAuth 2.0.
   • Para cambiar los valores solicitados desde API de perfil de LinkedIn, ingrese la URL de extremo de información de usuario. Para obtener más información, consulte API de perfil. La URL debe comenzar con https://api.linkedin.com/v2/me, y los campos solicitados deben corresponder a los ámbitos solicitados.
   • Para Ámbitos predeterminados, ingrese un valor compatible o valores separados por espacio que representan la información que obtiene de LinkedIn.
   • Si ingresa una clave de consumidor y un secreto de consumidor, el secreto de consumidor se incluye en respuestas de API de SOAP de forma predeterminada. Para ocultar el secreto en respuestas de API de SOAP, anule la selección de Incluir secreto de consumidor en respuestas de API de SOAP. A partir de noviembre de 2022, el secreto se sustituye siempre en respuestas de la API de metadatos por un valor de marcador. En la implementación, sustituya el marcador de posición por su secreto de consumidor como texto normal, o modifique el valor más adelante a través de la interfaz de usuario.
   • Para URL personalizada del error, ingrese la URL para que la utilice el proveedor para informar sobre cualquier error.
   • Para URL de icono, agregue una ruta a un icono para que se muestre como un botón en la página de inicio de sesión para un sitio. Este icono se aplica únicamente a un sitio de Experience Cloud. No aparece en su página de inicio de sesión de Salesforce ni en su URL de inicio de sesión de Mi dominio. Los usuarios hacen clic en el botón para iniciar sesión con el proveedor de autenticación asociado para el sitio. Especifique una ruta a su propia imagen, o copiar la dirección URL de uno de nuestros iconos de muestra en el campo.
   • Para utilizar un portal para usuarios de LinkedIn, seleccione el portal en la lista desplegable Portal.
10. Para utilizar la función de autenticación de múltiples factores (MFA) de Salesforce en vez del servicio MFA de su proveedor de identidad, seleccione Utilizar MFA de Salesforce para este proveedor de SSO. Este parámetro desencadena MFA únicamente para usuarios que tienen MFA aplicada a ellos directamente. Para obtener más información, consulte Utilizar Salesforce MFA para SSO.
11. Guarde su trabajo.

Actualizar su aplicación de LinkedIn

Probar la conexión SSO

Agregar el proveedor de autenticación a su página de inicio de sesión