Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Esta documentación es para la versión 4 y posteriores de App Builder, el nuevo nombre de Vinyl. Accede a la documentación de Vinyl aquí.

✕

Configuración de la autenticación de la API OData de SuccessFactors en Jitterbit App Builder

SuccessFactors admite el flujo de aserción de portador SAML de OAuth 2.0. Este flujo proporciona autorización limitada por el usuario, intercambiando aserciones SAML por tokens de acceso, como se describe en la siguiente especificación:

https://tools.ietf.org/html/draft-ietf-oauth-saml2-bearer-23

Este documento cubre las siguientes tareas:

  1. Registre App Builder como una aplicación cliente OAuth2 de SuccessFactors
  2. Registre a SuccessFactors como proveedor de seguridad de App Builder.
  3. Registre el servidor de origen de datos del servicio SAP Servicio OData.

Requisitos

Para continuar, necesitará lo siguiente:

  • Una cuenta de SuccessFactors existente.
  • Acceso de administrador a la cuenta de SuccessFactors.
  • Acceso de administrador a App Builder.

Registrar App Builder como una aplicación cliente OAuth2 de SuccessFactors

App Builder App Builder deberá registrarse en SuccessFactors como una aplicación cliente OAuth2. Para ello, necesitará la siguiente información:

Ejemplo Notas
Nombre de la aplicación App Builder El nombre de la aplicación es arbitrario. Si se registran varias instancias de App Builder como aplicaciones cliente OAuth2, asigne a cada una un nombre distintivo.
URL de la aplicación https://example.com/App Builder/ Esta es la raíz web de App Builder. La URL debe incluir la barra diagonal final.
Nombre común ejemplo.com Esta es la parte del nombre de alojar de la raíz web.

Para registrar App Builder como una aplicación cliente OAuth2 de SuccessFactors:

  1. Inicie sesión en SuccessFactors como administrador
  2. Vaya al Centro de administración
  3. Seleccione Configuración de la empresa → Administrar aplicaciones cliente OAuth 2
  4. Haga clic en el botón Registrar aplicación de cliente
  5. Proporcione el Nombre de la aplicación y la URL de la aplicación
  6. Haga clic en el botón Generar certificado X.509
  7. Proporcione el Nombre común (CN)
  8. Haga clic en el botón Generar
  9. Haga clic en el botón Descargar para guardar el certificado.
  10. Haga clic en el botón Registrarse

Una vez registrado, SuccessFactors le asignará una clave API. Esta API, junto con el certificado, será necesaria para completar los trámites restantes.

Convertir certificado

SuccessFactors genera un certificado con formato PEM; App Builder requiere un certificado codificado en base64 con formato PKCS#12. Este documento no aborda este tema en detalle. Sin embargo, a modo de ejemplo, se puede usar la utilidad de línea de comandos de OpenSSL para convertir un certificado de PEM a PKCS#12:

openssl pkcs12 -in certificate.pem -export -out certificate.pfxSe le solicitará una contraseña. Guárdela, ya que la necesitará más adelante.

Para codificar el certificado en base64:

openssl base64 -in certificate.pfx -out certificate.txt -APara obtener más información sobre los certificados de aplicación cliente OAuth2 de SuccessFactors, consulte el siguiente documento:

http://help.sap.com/saphelpiis_cloud4hr/EN/SuccessFactors_HCM_Suite_OData_API_Handbook_en.pdf

Nota

Al momento de escribir este artículo, SuccessFactors no genera un certificado compatible con OpenSSL. Para que el certificado sea compatible, ábralo en un editor de texto y realice los siguientes cambios:

Reemplace ambas ocurrencias de "CLAVE PRIVADA CIFRADA" con "CLAVE PRIVADA".

Inserte saltos de línea de modo que ninguna supere los 76 caracteres. Tenga en cuenta que deben ser saltos de línea de estilo Unix (salto de línea), no de estilo Windows o Internet (pares salto de línea/retorno de carro).

Registrar a SuccessFactors como proveedor de seguridad de App Builder

Para registrar a SuccessFactors como proveedor de seguridad de App Builder, necesitará la siguiente información:

Ejemplo Notas
Clave API La clave API es asignada por SuccessFactors al registrar la aplicación cliente OAuth2 (ver arriba).
Certificado de firma El certificado de firma debe ser un certificado PKCS#12 codificado en base64 que contenga la clave privada. El certificado puede generarse manualmente o durante el proceso de registro de la aplicación cliente OAuth2 de SuccessFactors (ver arriba).
Contraseña del certificado de firma La contraseña del certificado de firma se asigna al generar el certificado con formato PKCS#12.
ID de la empresa El identificador de la empresa de SuccessFactors.
URL de la API de instancia https://api8.successfactors.com/ URL de la API de SuccessFactors: "Las URLs de los extremo para acceder a las APIs de OData dependen del centro de datos que aloja su instancia de SuccessFactors". Consulte http://help.sap.com/saphelpiis_cloud4hr/EN/SuccessFactors_HCM_Suite_OData_API_Handbook_en.pdf para obtener información adicional.

Nota

La URL no contiene la ruta /odata/v2. App Builder la añadirá.

Para registrar a SuccessFactors como proveedor de seguridad de App Builder:

  1. Inicie sesión en App Builder como administrador
  2. Navegue hasta el IDE
  3. Haga clic en el botón Proveedores de seguridad
  4. Desde el panel Autenticación de fuente de datos, haga clic en el botón + Autenticación de fuente de datos

  5. Proporcione lo siguiente:

    • Nombre: Un nombre de proveedor de seguridad único.
    • Ejemplo: SuccessFactors
    • Tipo: SuccessFactors OData

    • Prioridad: Un entero único entre 10 y 100. Tenga en cuenta que este valor debe ser único.

      Ejemplo: 40

  6. Haga clic en el botón Guardar

  7. Configure las siguientes propiedades (en el panel Propiedades, haga clic en el botón + Propiedad → Seleccione el Parámetro → Proporcione el Valor → Haga clic en el icono Guardar):

    • Tipo de autenticación: Saml
    • ID de la empresa: ID de la empresa
    • ApiKey: * Clave API *
    • InstanceApiUrl: * URL de la API de instancia*
    • Certificado de firma: Certificado de firma
    • Contraseña del certificado de firma: Contraseña del certificado de firma

  8. Haga clic en el botón Editar en el panel Proveedores

  9. Marque la opción Habilitado
  10. Haga clic en el botón Guardar

Registrar el servidor de origen de datos del servicio SAP OData

Para registrar SuccessFactors como servidor de origen de datos de App Builder, necesitará la siguiente información:

Ejemplo Notas
Extremo de OData https://api8.successfactors.com/odata/v2/ URL de la API de SuccessFactors: " Las URLs de sus extremo para acceder a las APIs de OData dependen del centro de datos que aloja su instancia de SuccessFactors". Consulte http://help.sap.com/saphelpiis_cloud4hr/EN/SuccessFactors_HCM_Suite_OData_API_Handbook_en.pdf para obtener información adicional.
Nombre del proveedor de seguridad SuccessFactors El nombre del proveedor de seguridad proporcionado anteriormente.

Nota

A partir de marzo de 2016, el Extremo de OData parece requerir una barra diagonal final.

Para registrar SuccessFactors como un servidor de origen de datos de App Builder:

  1. Inicie sesión en App Builder como administrador.
  2. Navegue hasta el IDE
  3. Seleccione el botón Servidores de datos
  4. En el panel Servidores de datos, haga clic en el botón + Servidor

  5. Proporcione lo siguiente:

    • Nombre: Un nombre de servidor único y lógico.
    • Ejemplo: SuccessFactors
    • Tipo: Factores de éxito

    • URL: {OData Endpoint}

      Example: https://api8.successfactors.com/odata/v2

    • Ejemplo: https://api8.successfactors.com/odata/v2

    • Proveedor de seguridad: {Security Provider Name}

  6. Haga clic en el botón Guardar

Una vez registrado el servidor de origen de datos, haga clic en el botón Probar conexión para comprobar que todo esté configurado correctamente. Es posible que se le solicite iniciar sesión en Okta en este momento.

Solución de problemas

Puede encontrar una lista de respuestas de error de OAuth 2.0 de SuccessFactors en la siguiente página:

http://help.sap.com/saphelpiis_cloud4hr/EN/SuccessFactors_HCM_Suite_OData_API_Handbook_en.pdf el siguiente apéndice "Mensajes de error relacionados con OAuth 2.0" contiene errores adicionales:

http://help.sap.com/saphelpiis_cloud4hr/EN/SF_HCMS_OData_API_User_en/2ff9b29c3b774ebdaf367526a5444072.html

Consulte lo siguiente para obtener información adicional sobre solución de problemas:

Proveedor de seguridad - SuccessFactors OData

"El servidor no está disponible o la información de conexión es incorrecta." al probar la conexión

Asegúrese de que la URL del servidor de origen de datos termine con una barra diagonal final. Por ejemplo:

https://api8.successfactors.com/odata/v2/

A partir de marzo de 2016, SuccessFactors requiere una barra diagonal final.

"Está prohibido acceder a la API de OData mediante autenticación básica u OAuth externa en servidores que no sean API ." al probar la conexión

Es posible que el extremo de la API se haya reemplazado por extremo nuevo. Por ejemplo, se han reemplazado los siguientes extremos:

  • En noviembre de 2015, el extremo de la API https://salesdemo4.successfactors.com/ fue reemplazado por https://apisalesdemo4.successfactors.com/.
  • En marzo de 2016, el extremo de la API https://hcm8preview.sapsf.com/ fue reemplazado por https://api8preview.sapsf.com/.