Autenticación de Salesforce

Ediciones compatibles

Para autenticarte en Salesforce, debes tener una edición que incluya compatibilidad con API. El conector de Salesforce funciona con la siguiente edición (sin limitarse a):

• Salesforce Sales Cloud (Enterprise o Professional con soporte de API)

Para todas las demás ediciones no enumeradas, ponte en contacto con tu representante de UiPath para obtener ayuda.

Nota:

El conector utiliza la API REST de Salesforce. Confirma que tu edición de Salesforce incluye acceso a la API antes de continuar.

Requisitos previos

Para crear una conexión, necesita las siguientes credenciales:

• Código de autorización OAuth 2.0: nombre de usuario, contraseña.
• Contraseña OAuth 2.0: nombre de usuario, contraseña, token de seguridad.
• Traiga su propia aplicación OAuth 2.0: ID de cliente, Secreto de cliente.
• Token de acceso personal (PAT): clave codificada JWT base64, audiencia, emisor, asunto.

Además, es posible que necesites una aplicación de autenticación instalada en tu teléfono móvil si tu organización de Salesforce aplica la autenticación multifactor (MFA).

Antes de crear una conexión, asegúrate también de lo siguiente:

1. Tienes una edición Enterprise de Salesforce Sales Cloud, una edición Professional con soporte de API u otra edición compatible mencionada anteriormente.
2. Tienes privilegios de administrador en Salesforce Sales Cloud para configurar aplicaciones. Póngase en contacto con el administrador del sistema si no tiene estos privilegios.
3. El permiso API habilitada se activa para tu perfil de usuario de Salesforce. Para verificar: abre Salesforce y ve a Configuración > Administración > Usuarios > Perfiles, selecciona el perfil relevante y confirma que la API habilitada está marcada.

Consejo:

• Cómo comprobar tu perfil asignado: haz clic en tu avatar de perfil en la esquina superior derecha de Salesforce y, a continuación, haz clic en Configuración > Detalles avanzados de usuario. Tu nombre de perfil aparece en el campo Perfil . Como alternativa, ve a Configuración > Administración > Usuarios > Usuarios y comprueba la columna Perfil para tu nombre de usuario.
• Recomendamos aprovisionar y asignar un usuario de integración de Salesforce dedicado para las conexiones de UiPath. Las conexiones heredan los permisos de la cuenta utilizada para la autenticación, incluido el acceso a campos y objetos. El uso de un usuario dedicado garantiza un acceso coherente y auditable.

Métodos de autenticación

El conector de UiPath Salesforce admite los siguientes métodos de autenticación. Las credenciales necesarias dependen del método que elijas:

Método de autenticación	Descripción	Credenciales necesarias
Código de autorización OAuth 2.0	Redirige a Salesforce para iniciar sesión y dar consentimiento.	Nombre de usuario y contraseña de Salesforce
Contraseña OAuth 2.0	Autenticación heredada para cuentas/aplicaciones de Salesforce más antiguas. Bloqueado de forma predeterminada para las nuevas organizaciones según las notas de la versión de Salesforce. Úselo solo para escenarios especiales.	Nombre de usuario, contraseña, token de seguridad
Portador JWT (PAT)	Autenticación de servidor a servidor basada en token web JSON utilizando un certificado digital. Ideal para automatizaciones desatendidas en las que no es posible un inicio de sesión interactivo.	Clave privada codificada en base64 de JWT, audiencia, emisor (ID de cliente), asunto (nombre de usuario)
Traiga su propia aplicación (BYOA)	Utiliza una aplicación privada que creas en Salesforce. Recomendado por UiPath, ya que te da control total sobre los ámbitos, las políticas y la marca.	ID de cliente, secreto de cliente (de tu aplicación cliente externa de Salesforce)

Nota:

When registering your OAuth application in Salesforce, make sure to set the callback URL to the value displayed on the connection creation page, for example https://cloud.uipath.com/provisioning_/callback for Automation Cloud.

Para obtener más información sobre los diferentes tipos de autenticación disponibles para Salesforce, consulta la documentación oficial de Salesforce en Crear una aplicación cliente externa.

Código de autorización OAuth 2.0

Este método utiliza la aplicación pública conectada a UiPath y te redirige a Salesforce para la autenticación. Sigue estos pasos:

1. Selecciona Orchestrator en el lanzador de productos de UiPath.
2. Selecciona una carpeta y luego ve a la pestaña Conexiones .
3. Selecciona Añadir conexión.
4. Busca y selecciona el conector de Salesforce en la lista.
5. Selecciona el entorno: Producción o Sandbox.
6. Selecciona Código de autorización OAuth 2.0 como método de autenticación.
7. Selecciona Conectar. Se te redirigirá a la página de inicio de sesión de Salesforce.
8. Introduce tu nombre de usuario y contraseña de Salesforce.
9. Si MFA lo solicita, introduce el código de verificación de tu aplicación de autenticación.
10. Revisa los permisos solicitados por UiPath y haz clic en Permitir.
11. Se te redirigirá de nuevo a Orchestrator. El estado de la conexión debe mostrarse como Conectado.

Dominio personalizado: si tu organización de Salesforce utiliza un dominio personalizado, haz clic en Utilizar dominio personalizado en la pantalla de inicio de sesión de Salesforce, introduce la URL de tu dominio personalizado (por ejemplo, tuempresa.my.salesforce.com), a continuación, haz clic en Continuar e introduce tus credenciales.

Nota:

Este método utiliza la aplicación pública UiPath Connected. Si te encuentras con un error OAUTH_APPROVAL_ERROR_GENERIC , consulta la sección Resolución de problemas .

Contraseña de OAuth 2.0 (heredado)

ADVERTENCIA:

Este método de autenticación está bloqueado de forma predeterminada para las nuevas organizaciones de Salesforce. Salesforce ha declarado obsoleto el flujo OAuth de nombre de usuario y contraseña para la mayoría de los casos de uso. Utiliza este método solo si tu organización lo requiere explícitamente para la compatibilidad con versiones anteriores.

Si necesitas utilizar este método, habilítalo primero siguiendo la documentación de Salesforce: OAuth 2.0 Flujo de nombre de usuario-contraseña para escenarios especiales. Entonces:

1. Sigue los pasos 1 a 5 de las instrucciones del Código de autorización OAuth 2.0 anteriores.
2. Selecciona Contraseña OAuth 2.0 como método de autenticación.
3. Introduce tu nombre de usuario, contraseña y token de seguridad de Salesforce.
4. Select Connect.

Obtener tu token de seguridad: en Salesforce, ve a la configuración de tu perfil > Restablecer mi token de seguridad. El token se envía a su correo electrónico. Añádela a tu contraseña al conectarte.

Autenticación de portador JWT (PAT)

La autenticación de portador JWT utiliza un certificado digital para firmar una solicitud JWT, lo que permite la integración de servidor a servidor sin inicio de sesión interactivo. Esto es ideal para automatizaciones unattended. Sigue estos pasos:

1. Crea una clave privada y un certificado digital autofirmado. Consulta la guía de Salesforce: Crear una clave privada y un certificado digital autofirmado.
2. Crea una aplicación cliente externa en Salesforce. Ve a Configuración > Apps > Aplicaciones cliente externas > Gestor de aplicaciones cliente externas y haz clic en Nueva aplicación cliente externa. Carga tu certificado digital en la configuración de la aplicación. (Consulta la sección BYOA/Configuración de la aplicación de cliente externo a continuación para ver los pasos detallados).
3. Configura el flujo portador de JWT. En la configuración de la aplicación cliente externa, habilita el flujo portador JWT en Habilitación de flujo. Asigna los ámbitos OAuth necesarios.
4. Preautoriza la aplicación para tu usuario de integración. Ve a Configuración > Connected Apps > Gestionar Connected Apps, busca tu aplicación y, en Políticas, establece Usuarios permitidos en "Los usuarios aprobados por el administrador están preautorizados". A continuación, añade el perfil o conjunto de permisos correspondiente.
5. En UiPath Orchestrator, selecciona Orchestrator > carpeta > Conexiones > Añadir conexión > Salesforce.
6. Selecciona el entorno (Producción o Sandbox).
7. Selecciona Token de acceso personal (PAT) como método de autenticación.
8. Introduce las credenciales necesarias:
   • Clave codificada JWT base64: tu clave privada en formato base64.
   • Emisor: el ID de cliente OAuth (Clave de consumidor) de tu aplicación cliente externa.
   • Asunto: el nombre de usuario del usuario de Salesforce con el que quieres autenticarte.
   • Audiencia: la URL del punto final del token de Salesforce (por ejemplo, https://login.salesforce.com para producción o https://test.salesforce.com para sandbox).
9. Select Connect.

Para obtener más información sobre la habilitación de tokens JWT, consulta la documentación de Salesforce: Flujo de portador OAuth 2.0 JWT para la integración de servidor a servidor, Habilitar tokens de acceso basados en token web JSON (JWT) y Tokens de acceso basados en JWT.

Traiga su propia aplicación (BYOA) (recomendado)

Importante:

Salesforce ha declarado obsoleto el modelo de aplicación conectada heredado. Todas las aplicaciones nuevas deben crearse como External Client Apps. Las Apps conectadas existentes siguen funcionando, pero Salesforce recomienda migrar a aplicaciones cliente externas. Los siguientes pasos reflejan el nuevo flujo de trabajo de la aplicación cliente externa.

Este método utiliza una aplicación privada que creas y gestionas en Salesforce, lo que te da control total sobre los ámbitos OAuth y las políticas de seguridad. Sigue estos pasos:

Paso A: crear una aplicación cliente externa en Salesforce

1. Inicia sesión en tu cuenta de Salesforce y ve a Configuración.
2. Dirígete a Apps > Aplicaciones cliente externas > Gestor de aplicaciones cliente externas.
3. Haz clic en Nueva aplicación cliente externa.
4. Rellene los campos obligatorios:
   • Nombre de la aplicación cliente externa: un nombre descriptivo (por ejemplo, "Integración de UiPath").
   • Nombre de API: debe contener solo guiones bajos y caracteres alfanuméricos, ser único, comenzar con una letra y no terminar con un guion bajo ni contener guiones bajos consecutivos.
   • Correo electrónico de contacto: la dirección de correo electrónico del propietario de la aplicación.
   • Estado de distribución: selecciona Local (para uso en una sola organización) o Empaquetado.
5. Expande la sección API (Habilitar configuración de OAuth) y marca Habilitar OAuth.
6. En el campo URL de devolución de llamada , introduce la URL de devolución de llamada OAuth de UiPath proporcionada en la pantalla de configuración de la conexión de Orchestrator.
7. Selecciona los ámbitos OAuth necesarios y muévelos a Ámbitos OAuth seleccionados. Como mínimo, incluye: Acceder al servicio de URL de identidad, Gestionar datos de usuario a través de API y Realizar solicitudes en cualquier momento.
8. En Habilitación de flujo, selecciona Habilitar código de autorización y flujo de credenciales.
9. En Seguridad, marca tanto Requerir secreto para flujo de servidor web como Requerir secreto para flujo de token de actualización.
10. Haz clic en Crear.

Paso A.1: Configurar políticas (obligatorio)

Después de crear la aplicación cliente externa, debes configurar sus políticas:

1. Ve a Configuración > Connected Apps > Gestionar Connected Apps.
2. Busca tu aplicación cliente externa y haz clic en Editar políticas.
3. Establece lo siguiente:
   • Usuarios permitidos: "Todos los usuarios pueden autoautorizarse"
   • Relajación de IP: "Relajar las restricciones de IP"
   • Política de token de actualización: "El token de actualización es válido hasta que se revoque"
4. Haz clic en Guardar.

Paso B: recuperar el ID de cliente y el secreto de cliente

1. En la aplicación cliente externa, ve a la pestaña Configuración .
2. Expande Configuración de OAuth.
3. Haz clic en Clave y secreto del consumidor.
4. Introduce tus credenciales (y OTP si se te solicita).
5. Copia la clave de consumidor (este es tu ID de cliente) y el secreto de consumidor (este es tu secreto de cliente). Guárdalos de forma segura.

Nota:

Después de crear o modificar una aplicación cliente externa, Salesforce puede tardar hasta 10 minutos en propagar los cambios. Espere antes de intentar conectarse.

Paso C: conectarse en UiPath Orchestrator

1. En Orchestrator, ve a tu carpeta > Conexiones > Añadir conexión > Salesforce.
2. Selecciona el entorno (Producción o Sandbox).
3. Selecciona Trae tu propia aplicación OAuth 2.0 como método de autenticación.
4. Introduce el ID de cliente y el Secreto de cliente del paso B.
5. Select Connect.
6. Complete el inicio de sesión de Salesforce y autorice la aplicación.

Para obtener más información, consulta la documentación de Salesforce: Configurar los ajustes de OAuth de la aplicación cliente externa y Habilitar los ajustes de OAuth para la integración de la API.

Caducidad y actualización del token

Los tokens OAuth pueden caducar tras un tiempo determinado en función de tu configuración de Salesforce. Para evitar desconexiones inesperadas en los flujos de trabajo de producción:

• Establece la Política de token de actualización en "El token de actualización es válido hasta que se revoque" en la configuración de tu aplicación conectada de Salesforce o aplicación cliente externa.
• Asegúrate de que se concede el ámbito "Realizar solicitudes en cualquier momento". Este ámbito permite la actualización sin conexión y no está incluido en el ámbito de "acceso completo": debe configurarse de forma independiente.

Consulta las guías de Salesforce: Gestionar políticas de acceso OAuth para una aplicación conectada y Tokens y ámbitos de OAuth para conocer los pasos de configuración detallados.

Configuración de Sandbox

Para configurar una cuenta de Sandbox, sigue los pasos descritos en la documentación oficial de Salesforce: Consideraciones de configuración de Sandbox.

Los sandbox de Salesforce están aislados de tu organización de producción. Las operaciones realizadas en un Sandbox no afectan a los datos de producción, y viceversa. Los Sandboxes son casi idénticos a los de producción, pero existen algunas diferencias. Consulta la documentación de Salesforce para obtener más detalles.

Consejo:

Al empezar a utilizar UiPath con Salesforce, recomendamos probar en una cuenta de Sandbox o con datos no esenciales. Esto evita cualquier pérdida de datos cruciales, especialmente porque las acciones realizadas a través de automatizaciones no se pueden deshacer fácilmente.

Permisos

Las conexiones de Salesforce en UiPath heredan los permisos de la cuenta utilizada para la autenticación. A continuación se muestra una guía completa de los permisos necesarios.

Ámbitos OAuth necesarios (aplicación pública de UiPath)

Al crear una conexión a través de la aplicación pública de UiPath, el conector solicita los siguientes permisos:

Permiso/Ámbito	Propósito
Acceder al servicio de URL de identidad	Recuperar información de identidad del usuario
Gestionar datos de usuario a través de API	Leer y escribir registros de Salesforce a través de la API
Gestionar datos de usuario a través de navegadores web	Acceso a datos basado en navegador
Acceder a los recursos de la API REST de Connect	Acceso a la API de Chatter y Connect
Acceder a las aplicaciones de Visualforce	Interactuar con páginas de Visualforce
Acceder a identificadores únicos de usuario	Acceso de ID de usuario único para la asignación
Acceder a permisos personalizados	Leer asignaciones de permisos personalizados
Acceder a los recursos de la API REST de análisis	Informes y paneles a través de API
Acceder a los recursos de geodatos de gráficos de la API de REST de análisis	Datos geográficos en análisis
Administrar conexiones de hub	Gestión de conexiones de hub
Administrar los servicios de Pardot	Acceso a la automatización de marketing de Pardot
Acceder a aplicaciones Lightning	Acceso a Lightning Experience
Acceder a recursos de contenido	Acceso a la biblioteca de contenido
Gestionar los datos de la API de ingestión de Salesforce CDP	Ingestión de datos CDP
Gestionar los datos del perfil de Salesforce CDP	Gestión de perfiles CDP
Realizar consultas ANSI SQL en datos de Salesforce CDP	Consulta de datos CDP
Acceder a los servicios de chatbot	Servicios de Bot de Einstein
Realizar solicitudes en cualquier momento	Acceso al token de actualización sin conexión
Realizar la segmentación de los datos de Salesforce CDP	Segmentación de CDP

Permiso de API habilitada

Debes tener el permiso API habilitada en Salesforce. Para configurar: ve a Configuración > Administración > Usuarios > Perfiles, selecciona el perfil relevante y asegúrate de que API habilitada esté marcada en Permisos administrativos.

Permisos de objetos estándar y personalizados

Recomendamos que la cuenta del usuario conectado tenga permisos para leer, escribir, editar, eliminar, ver todo y modificar todo para los objetos estándar o personalizados con los que interactúan tus automatizaciones. Para configurar:

• Ve a Configuración > Administración > Usuarios > Perfiles (o Conjuntos de permisos).
• Localiza los objetos estándar o personalizados relevantes y asigna los permisos necesarios.
• La seguridad a nivel de objeto es la forma más amplia de controlar el acceso a los datos. Configura la capacidad de un usuario para ver, crear, editar o eliminar registros de un tipo de objeto específico (por ejemplo, clientes potenciales, oportunidades). Si un objeto está oculto para el usuario de integración, no aparecerá en UiPath.

Nota:

Si los objetos de Salesforce esperados no aparecen en UiPath, consulta con tu administrador de Salesforce para confirmar que el usuario de integración tiene acceso a todos los objetos necesarios.

Seguridad a nivel de campo

La seguridad a nivel de campo controla la visibilidad de los campos individuales dentro de los objetos, incluso en listas relacionadas, vistas de lista, informes y resultados de búsqueda. También determina si los usuarios pueden ver o editar valores de campo. Esto te permite proteger los datos confidenciales sin ocultar objetos completos.

Configura la seguridad a nivel de campo a través de perfiles o conjuntos de permisos en Salesforce. Si los campos esperados no aparecen en UiPath, consulta con tu administrador de Salesforce para confirmar que el usuario de integración tiene acceso a los campos necesarios.

Perfiles y conjuntos de permisos

Los permisos de usuario y la configuración de acceso controlan lo que los usuarios pueden hacer en tu organización de Salesforce:

• Perfiles: define los permisos de referencia para un grupo de usuarios. A cada usuario se le asigna un perfil. Utiliza perfiles para asignar los permisos mínimos necesarios.
• Conjuntos de permisos: añade permisos adicionales sobre un perfil. Un usuario puede tener varios conjuntos de permisos. Utilízalos para añadir capas de acceso adicional según sea necesario para las integraciones.

Solución de problemas

Error/síntoma	Resolución
OAUTH_APPROVAL_ERROR_GENERIC	Salesforce está bloqueando la aplicación UiPath porque no está instalada. Esto se aplica solo a la aplicación pública UiPath Connected (no a las aplicaciones cliente externas BYOA, que son seguras por defecto y están exentas de esta restricción). Para resolver: Instala la aplicación: un administrador de Salesforce debe ir a Configuración > Uso de OAuth de las Apps conectadas, localizar el conector UiPath y hacer clic en Instalar. Una vez instalado, configura las políticas de OAuth según sea necesario. Assign bypass permissions: A Salesforce admin can assign Approve Uninstalled Connected Apps (available when API Access Control is not enabled) or Use Any API Client (works when API Access Control is enabled).
invalid_client_id / "identificador de cliente no válido"	No se reconoce la clave del consumidor (ID de cliente). Causas comunes: Retraso de propagación: después de crear o modificar una aplicación cliente externa, espera hasta 10 minutos para que Salesforce propague los cambios. Clave de consumidor incorrecta: vuelve a copiarla desde la pestaña Configuración de la aplicación de cliente externo > Configuración OAuth > Clave y secreto del consumidor. Falta de coincidencia entre Sandbox y producción: asegúrate de que el entorno seleccionado en UiPath coincide con el lugar donde se creó la aplicación (Sandbox usa test.salesforce.com, Production usa login.salesforce.com).
falta el desafío del código requerido	Se aplica PKCE (Clave de prueba para el intercambio de códigos). Desactívela en dos lugares: Nivel de organización: Configuración > Identidad > Configuración de OAuth y OpenID Connect: desactiva "Requerir clave de prueba para la extensión de intercambio de código (PKCE) para los flujos de autorización compatibles". Nivel de aplicación: en la configuración de OAuth de la aplicación cliente externa, desmarca el requisito PKCE. La configuración a nivel de organización anula la configuración a nivel de aplicación; ambas deben estar desactivadas. Después de deshabilitar, espere unos minutos y borre la caché del navegador antes de volver a intentarlo.
Error al intercambiar el código OAuth por el token	Se emitió el código de autorización, pero el intercambio de tokens falló. Causas comunes para las External Client Apps: Falta de coincidencia de la URL de devolución de llamada: verifique que la URL de su aplicación cliente externa coincida exactamente con lo que envía UiPath (compruebe http frente a https, barras finales, mayúsculas y minúsculas). Secreto de cliente incorrecto: vuelve a copiar desde Configuración > Configuración OAuth > Clave y secreto del consumidor. Políticas no configuradas: ve a Configuración > Connected Apps > Gestionar Connected Apps, busca la aplicación, haz clic en Editar políticas y establece Usuarios permitidos en "Todos los usuarios pueden autoautorizarse", Relajación de IP en "Relajar restricciones de IP" y Política de token de actualización a "El token de actualización es válido hasta que se revoque". Límite de tokens: Salesforce permite un máximo de 5 tokens simultáneos por usuario y aplicación; revoca los tokens antiguos a través de Configuración > Seguridad > Gestión de sesiones.
La conexión se desconecta inesperadamente	Es posible que el token de actualización haya caducado. Establece la Política de token de actualización en "El token de actualización es válido hasta que se revoque" y asegúrate de que se concede el ámbito "Realizar solicitudes en cualquier momento". Consulta la sección Caducidad y actualización del token .
Faltan objetos o campos en UiPath	La configuración de seguridad a nivel de objeto o de campo impide la visibilidad. Consulta con tu administrador de Salesforce para confirmar que el perfil del usuario de integración tiene acceso de lectura/escritura a los objetos y campos necesarios.
Error de API habilitada/privilegios insuficientes	El perfil del usuario conectado no tiene el permiso API habilitada. Ve a Configuración > Perfiles, selecciona el perfil y habilítalo en Permisos administrativos.
Solicitud de MFA durante la conexión	Su organización requiere autenticación multifactor. Utiliza una aplicación de autenticación para completar el paso de verificación. Para escenarios automatizados (desatendidos), considera utilizar la autenticación de portador JWT que no requiere MFA interactivo.
Dominio personalizado no reconocido	Haz clic en "Usar dominio personalizado" en la pantalla de inicio de sesión de Salesforce, introduce la URL completa del dominio personalizado (por ejemplo, tuempresa.my.salesforce.com), y haz clic en Continuar antes de introducir las credenciales.

Mejores prácticas

• Utiliza un usuario de integración dedicado. Crea un usuario de Salesforce dedicado para las integraciones de UiPath en lugar de utilizar cuentas personales. Esto garantiza permisos coherentes, simplifica la auditoría y evita interrupciones cuando los usuarios individuales cambian de rol.
• Prueba primero en un Sandbox. Pruebe siempre las nuevas conexiones y automatizaciones en un entorno de pruebas de Salesforce antes de implementarlas en producción. Las acciones realizadas a través de UiPath no siempre se pueden deshacer.
• Aplicar permisos de privilegios mínimos. Otorgue solo el acceso al objeto y al campo que sus automatizaciones realmente necesitan. Utiliza perfiles para el acceso de referencia y conjuntos de permisos para ámbitos adicionales.
• Configura las políticas de actualización de tokens. Establezca la política de token de actualización en "válida hasta que se revoque" y otorgue el ámbito "Realizar solicitudes en cualquier momento" para evitar desconexiones inesperadas.
• Utiliza nombres de conexión significativos. Al crear conexiones en Orchestrator, utiliza nombres descriptivos que indiquen el entorno y el propósito (por ejemplo, "Salesforce-Production-OrderSync") para facilitar la gestión.
• Plan para la migración de la aplicación cliente externa de Salesforce. Salesforce ha declarado obsoleto el modelo de aplicación conectada heredado. Todas las nuevas Apps deben crearse como aplicaciones cliente externas. Planifique la migración de las Connected Apps existentes según las instrucciones de Salesforce.