Conectar IFS Cloud: verificar credenciales IAM y listar proyecciones
Complete la URL de IFS Cloud, el IAM Client ID, el Client Secret y la IAM Token URL en Integration y pruebe: el sistema intercambia un token y lista proyecciones para probar que las credenciales funcionan. Esta conexión solo verifica la conectividad y no sincroniza pedidos, clientes ni inventario.
El conector de IFS Cloud verifica una sola cosa: que un cliente IAM de IFS Cloud (cuenta de servicio) con acceso a la API pueda iniciar sesión desde este sistema. Una prueba aprobada significa que el sistema intercambió su Client ID y Client Secret por un token de acceso en su IAM Token URL y listó proyecciones de su instancia de IFS Cloud. No trae pedidos, no trae clientes, no lee ni devuelve inventario y no sincroniza ningún otro documento: las proyecciones de negocio de IFS difieren según la versión y la personalización de cada cliente, así que en esta conexión no se ejecuta ninguna sincronización de documentos. Úsela para probar las credenciales y la dirección de la instancia antes de preparar cualquier trabajo con documentos para sus proyecciones concretas.
Requisitos previos#
- Una instancia de IFS Cloud a la que pueda llegar y su dirección base, por ejemplo https://myserver:48080. No hay una dirección predeterminada que copiar.
- Un cliente IAM de IFS Cloud (cuenta de servicio) con acceso a la API, y acceso a la configuración de ese cliente para poder leer su Client ID, Client Secret y endpoint de token.
- El endpoint de token de su propio IAM, tomado de la configuración de ese cliente IAM. Cada despliegue es distinto, así que el valor debe venir de su propia configuración.
- Si su despliegue usa un tenant, el valor del tenant; si no lo usa, dejará ese campo vacío.
Obtener credenciales#
- Abra la configuración del cliente IAM de IFS Cloud (cuenta de servicio) que tiene acceso a la API. El Client ID y el Client Secret de esta conexión vienen de ese cliente.
- Copie el Client ID tal como aparece en la configuración de ese cliente IAM.
- Copie el Client Secret del mismo cliente IAM. Guárdelo en privado: quien lo tenga puede solicitar tokens como esa cuenta de servicio.
- En la misma configuración del cliente IAM, copie el endpoint de token y úselo como valor de token_url. Sigue una forma de token openid-connect, pero la dirección exacta es propia de su despliegue: no copie un endpoint de otra empresa ni de un ejemplo.
- Anote al mismo tiempo la dirección base de su IFS Cloud y el valor del tenant si su despliegue usa uno.
Completar en Integration#
- Abra Integration → Marketplace → IFS → Nueva conexión.
- base_url, obligatorio, IFS Cloud URL: la dirección base de su IFS Cloud, por ejemplo https://myserver:48080.
- tenant, opcional, Tenant: complételo solo si su despliegue usa un tenant, por ejemplo TENANT1; en caso contrario déjelo vacío.
- client_id, obligatorio, IAM Client ID: el Client ID del cliente IAM (cuenta de servicio) con acceso a la API. Se guarda como secreto.
- client_secret, obligatorio, IAM Client Secret: el Client Secret del mismo cliente IAM. Es un campo de tipo contraseña y se guarda como secreto.
- token_url, obligatorio, IAM Token URL: el endpoint de token copiado de la configuración de su propio cliente IAM. No hay un endpoint predeterminado, así que este valor debe venir de su propio IAM de IFS Cloud.
Probar la conexión#
Haga clic en Probar la conexión. La prueba ejecuta dos pasos reales. Primero usa el flujo OAuth2 client credentials en la token_url que completó, intercambiando client_id y client_secret por un token de acceso. Después llama a su instancia con ese token para listar proyecciones — GET {base}/main/ifsapplications/projection/v1/AllProjections.svc/Projections?$top=1 — lo que prueba a la vez que el token funciona y que las proyecciones se pueden descubrir en su instancia. Una respuesta 200 cuenta como aprobado. Si falta base_url, la prueba se detiene con MISSING_BASE_URL; si falta client_id o client_secret, se detiene con MISSING_CREDENTIALS, y si falta token_url, se detiene con MISSING_CONFIG, sin enviar ninguna solicitud. La prueba espera 12 segundos antes de informar TEST_TIMEOUT.
Mapping / elegir plantilla#
Todavía no hay un mapping de documentos que elegir para esta conexión. Las proyecciones de negocio de IFS se nombran según la versión y la personalización de cada cliente, así que esta conexión no ofrece un mapping de pedidos, clientes ni inventario, y no ejecuta una plantilla que sincronice documentos. Lo que sí puede revisar tras una prueba aprobada es la propia lista de proyecciones: muestra qué proyecciones expone su instancia, que es el punto de partida si más adelante se prepara trabajo con documentos contra sus proyecciones concretas. No espere que elegir un mapping haga fluir pedidos o inventario: en esta conexión, no fluyen.
Activar#
Active la conexión solo después de que la prueba haya aprobado. La activación guarda esta conexión verificada — la dirección de la instancia, el tenant opcional y las credenciales IAM — para que la comprobación de conectividad pueda repetirse en cualquier momento, por ejemplo después de rotar un cliente IAM o de cambiar la dirección de la instancia.
Lo que la activación no pone en marcha: esta conexión no trae ni envía pedidos, clientes, inventario ni ningún otro documento, ni al activar ni por programación. Si necesita sincronizar documentos con IFS, ese trabajo debe prepararse contra las proyecciones de negocio reales de su instancia, partiendo de la lista de proyecciones que devuelve la prueba.
Preguntas frecuentes#
La prueba se detiene con MISSING_BASE_URL, MISSING_CREDENTIALS o MISSING_CONFIG
Falta un campo obligatorio y la prueba no envía ninguna solicitud hasta que estén todos. MISSING_BASE_URL significa que base_url está vacío, MISSING_CREDENTIALS que client_id o client_secret está vacío, y MISSING_CONFIG aquí significa que token_url está vacío.
Complete base_url, client_id, client_secret y token_url desde la configuración de su propio cliente IAM y su instancia, guarde y pruebe de nuevo. Añada tenant solo si su despliegue usa uno.
La prueba falla con INVALID_CREDENTIALS o AUTH_FAILED
Su IAM rechazó el intercambio: el endpoint de token respondió, pero no aceptó el Client ID y el Client Secret, o no devolvió ningún token de acceso. La causa habitual es un secreto copiado de otro cliente IAM, un secreto rotado o una token_url que pertenece a un IAM distinto del cliente.
Vuelva a abrir la configuración de ese único cliente IAM y copie client_id, client_secret y token_url juntos desde el mismo lugar, para que los tres pertenezcan al mismo cliente y al mismo IAM. Péguelos de nuevo completos y vuelva a probar.
La prueba falla con INVALID_TOKEN
Se obtuvo un token, pero su instancia de IFS Cloud no lo aceptó en la llamada de lista de proyecciones. Eso apunta a una falta de coincidencia entre el IAM que emitió el token y la instancia de base_url: por ejemplo, una token_url de otro despliegue o una base_url que apunta a otra instancia de IFS Cloud.
Compruebe que base_url es la dirección del mismo despliegue de IFS Cloud cuyo IAM emitió las credenciales, y que token_url se copió de la configuración del cliente IAM de ese despliegue. Corrija el valor que no coincide y vuelva a probar.
La prueba falla con MISSING_SCOPE
El token funciona, pero la cuenta de servicio detrás del cliente IAM no tiene permiso para acceder a las proyecciones de la instancia, así que la llamada de lista de proyecciones es rechazada.
En IFS Cloud, conceda a ese cliente IAM (cuenta de servicio) acceso a las proyecciones y vuelva a probar con los mismos valores. No cambie a una cuenta de usuario personal para esquivarlo: esta conexión está pensada para funcionar como la cuenta de servicio.
La prueba informa TEST_TIMEOUT o CONNECTION_FAILED
La solicitud no terminó. TEST_TIMEOUT significa que no llegó una respuesta completa en 12 segundos; CONNECTION_FAILED significa que la solicitud de red al endpoint de token o a la instancia falló. Con una dirección autoalojada, suele tratarse de una base_url o token_url que no se puede alcanzar desde fuera, o de un puerto que no está abierto.
Abra la base_url y el host de la token_url en un navegador para confirmar que ambos responden, compruebe que el puerto de la dirección (por ejemplo :48080) es alcanzable y vuelva a probar. Si ambos responden en el navegador y la prueba sigue agotando el tiempo, consulte con su administrador de IFS si el acceso externo al endpoint de proyecciones está permitido.
Una acción con documentos informa ERP_ENDPOINTS_PENDING, o no se sincroniza nada tras activar
Ese es el alcance actual de esta conexión, no un valor incorrecto. Las operaciones de negocio en IFS — traer pedidos o clientes, leer o enviar inventario — no las ejecuta esta conexión, porque los nombres de las proyecciones de negocio difieren por instancia de cliente. Una prueba aprobada solo prueba, siempre, que las credenciales IAM funcionan y que las proyecciones se pueden listar.
Siga usando la conexión para verificar la conectividad. Para sincronizar documentos, parta de la lista de proyecciones que devuelve la prueba y prepare el trabajo contra las proyecciones de Integration reales de su instancia: cambiar los cinco valores de la conexión no activará la sincronización de documentos.