Configuración de tareas de SuccessFactors con credenciales OAuth
Acerca de la configuración de tareas de SuccessFactors con credenciales OAuth
Puede extraer datos de empleados directamente de SuccessFactors a la plataforma Qualtrics mediante el uso de tareas de extracción de flujos de trabajo. Sin embargo, SuccessFactors requiere la configuración de un cliente OAuth2 para que Qualtrics pueda recuperar datos de su sistema. Las acciones de requisitos previos deben realizarse a través del portal de administración de SuccessFactors para configurar las tareas de extracción de Qualtrics por primera vez.
Paso 1: Crear un certificado X.509
Para generar un certificado nuevo, SuccessFactors recomienda utilizar OpenSSL con el siguiente comando:
openssl req -node -x509 -sha256 -newkey rsa:2048 -keyout private.pem -out public.pem
Después de ejecutar este programa, se generarán dos archivos de texto: public.pem y private.pem, que se resaltan arriba. Para ver el contenido de estos archivos, puede abrirlos en cualquier editor de archivos de texto. Como alternativa, utilice los comandos “ls” y “cat” en el terminal OpenSSL.
- public.pem: contiene la clave pública del certificado X.509. Se utilizará en la configuración de cliente OAuth de SuccessFactors.
- private.pem: contiene la clave privada del certificado X.509. Se utilizará durante la configuración de las tareas de flujo de trabajo de Qualtrics.
Paso 2: Registrar una aplicación de cliente OAuth2
- Inicie sesión en su Centro de administración de SuccessFactors. Tenga en cuenta el dominio de API, el ID de empresa y el nombre de usuario.
- Haga clic en Centro de API.
- Haga clic en Configuración OAuth para OData.
- Haga clic en Registrar aplicación cliente.
- Pegue la clave pública generada a partir del certificado X.509 en el espacio proporcionado.
- Haga clic en Registrar.
- Visualice la aplicación de cliente OAuth2 recién registrada.
- Copie y guarde la clave API. Se utilizará en la tercera etapa.
Paso 3: Configurar la cuenta de SuccessFactors en la tarea de Qualtrics
Los pasos anteriores le han proporcionado la información necesaria para seguir las instrucciones del flujo de trabajo de extracción de datos de Qualtrics:
- Nombre: Nombre descriptivo de la conexión.
- Nombre de usuario: Su ID de usuario de SAP.
- Clave API: Generada por la aplicación OAuth2 registrada.
- Dominio de centro de datos: parte de dominio de la URL del centro de administración de SuccessFactors, que se muestra en el primer paso del registro de una aplicación OAuth2.
- Clave privada de certificado 509: Valor de clave privada generado por la configuración del certificado X.509. La clave privada debe tener el formato PKCS8.
- ID de empresa: ID de empresa para la instancia de SuccessFactors, que se muestra en el primer paso del registro de una aplicación OAuth2.
Actualizando credenciales de SuccessFactors
No puede editar una conexión una vez añadida al flujo de trabajo. Para actualizar las opciones de conexión, debe crear una cuenta nueva e incorporar las ediciones necesarias. Abra su tarea de workflow y haga clic en Añadir una cuenta de usuario.
Si ya no utiliza su conexión anterior, puede eliminarla haciendo clic en los tres puntos de la derecha y seleccionando Eliminar cuenta.
Resolución de problemas de errores de autenticación
Si las opciones de conexión OAuth están mal configuradas, aparecerá un mensaje de error cuando intente guardar sus credenciales. Para resolver estos problemas, vuelva a configurar la tarea con las credenciales corregidas siguiendo los pasos anteriores.
Código de error | Mensaje de error | Explicación |
SFSF_2 | No tiene permiso para acceder a las API utilizando OAuth o Autenticación básica en este servidor. Utilice el servidor API en su lugar. | El URL del servidor proporcionado en la configuración de la conexión no es compatible con las conexiones OAuth y es necesario actualizarlo. Las credenciales nuevas deberán configurarse utilizando un servidor de esta lista.
Si no ve su dominio en esta lista, póngase en contacto con el soporte de SuccessFactors. |
SFSF_3 | El dominio “{Domain}” asociado con la credencial de la tarea no es un dominio de SuccessFactors válido | El campo de dominio de la configuración de credenciales no es válido. Las credenciales nuevas deberán configurarse. |
SFSF_5 | Credenciales no encontradas | No se han encontrado las credenciales asociadas con la configuración. Se deben configurar las credenciales nuevas. |
SFSF_6 | Faltan campos de credenciales | Las credenciales no están configuradas correctamente. Para solucionarlo, cree una nueva configuración siguiendo los pasos anteriores. |
SFSF_7 | Esquema de autorización no admitido | Indica el uso de credenciales de esquema de autenticación básica. Las credenciales de autenticación básica son obsoletas y ya no funcionarán. Para resolverlas, cree nuevas credenciales siguiendo los pasos anteriores. |
SFSF_8 | La clave privada debe estar en formato PKCS8 | La clave privada del certificado X.509 proporcionada no tiene el formato PKCS8 necesario. La clave privada debe tener el formato:
Si la clave no tiene este fromat, copie y pegue el comando OpenSSL:
|
SFSF_8 | Código de respuesta inesperado de la solicitud a la URL: https://successfactors.com/oauth/token, estado de respuesta: 401, error: No se puede autenticar el cliente (Error de inicio de sesión – usuario no válido)
O Código de respuesta inesperado de la solicitud a la URL: https://successfactors.com/oauth/token, estado de la respuesta: 401, error: No se puede asignar “{ID de usuario” a un ID de usuario BizX válido |
El nombre de usuario proporcionado en la configuración de conexión no es un ID de usuario de SAP válido en la instancia de SuccessFactors de la empresa. En SAP, los nombres de usuario pueden ser diferentes del ID de usuario y el ID de persona, aunque suelen ser los mismos. |
SFSF_8 | Credenciales de cliente no válidas
OR No se puede validar “api_key” en la aserción SAML |
La clave API proporcionada en la configuración de la conexión es incorrecta. |
Resolución de problemas de errores que no son de autenticación
Si la ejecución del flujo de trabajo muestra un error diferente, podría indicar un problema de configuración errónea no relacionado con OAuth.
Código de error | Mensaje de error | Explicación |
SFSF_1 | Los mensajes de error pueden variar en función del contexto del problema | Se ha producido un error inesperado. Contacte con el soporte técnico de Qualtrics. |
SFSF_2 | Respuesta inesperada de SuccessFactors. Verifique su configuración e inténtelo de nuevo | Hemos recibido un error que no reconocemos de SuccessFactors. Esto indica un problema de configuración, por lo que compruebe su configuración y póngase en contacto con el soporte técnico de Qualtrics si el error persiste. |
SFSF_2 | No se puede acceder a las propiedades “{PropertyName}” | “{PropertyName}” en SuccessFactors no está disponible a través de la API OData de SuccessFactors. Para solucionarlo, elimine la propiedad de la configuración e inténtelo de nuevo. |
SFSF_2 | Nombres de propiedad no válidos: “{PropertyName}” | “{PropertyName}” no existe en su instancia de SuccessFactors. Elimine la propiedad de la configuración e inténtelo de nuevo. |