java Sample

Puede utilizar este código para empezar a automatizar las cargas de datos en Transparent Supply. El ejemplo de Java™ (archivo tar) aprovecha la infraestructura de Spring Boot para gestionar mediante programación el proceso de autenticación de usuario del sistema de obtener una señal de IBM Cloud® IAM y cambiarla por una señal de ID de servicio.

Con un cambio de configuración nominal, el código (servicio web) se puede desplegar y ejecutar en el entorno. Cuando se inicia el servicio, se lee la clave de API almacenada en el archivo de configuración y se ejecuta el intercambio de señales. Cuando se llama a la API, la hora de caducidad de la señal se comprueba y se renueva automáticamente si ha caducado. A continuación, la carga útil de entrada se transmite a Transparent Supply y se devuelve el resultado.

El servicio utiliza Spring Boot y Gradle y se ha creado para las versiones siguientes:

  • Java 8
  • Gradle 4.2.1
  • Spring Boot 1.5.13.<release>

Limitación de garantías

Este código se proporciona para ayudarle a ponerse en marcha rápidamente con la autenticación y el envío de datos a Transparent Supply. Este código se mantendrá para cualquier cambio de autenticación futuro, pero no se recomienda que este código se utilice "tal cual". En un entorno empresarial, los requisitos adicionales pueden ser dictados por la organización, como el registro, las pruebas de unidad, los puntos finales de salud, las estadísticas y los puntos finales.

Configuración

Debe configurar el servicio antes de ejecutarlo, utilizando un archivo config.properties similar al ejemplo siguiente. El servicio analiza el valor de la variable iftEnvironment ; si el valor es SANDBOX, se utilizan las propiedades de entorno de recinto de pruebas. En todos los demás casos, se presupone el entorno PRODUCCIÓN .

Específicamente, debe configurar las variables siguientes:

Archivo config.properties de ejemplo:

   iftApiKey=8r...sv
   iftEnvironment=SANDBOX
   iftCloudIAMURL=https://iam.cloud.ibm.com/identity/token
   iftIntegrationOrgId=9dd5c...a1
   iftIntegrationAuthURL=https://sandbox.food.ibm.com/ift/api/identity-proxy/exchange_token/v1/organization/
   iftProductionOrgId=2af3b...d3
   iftProductionAuthURL=https://food.ibm.com/ift/api/identity-proxy/exchange_token/v1/organization/
   iftIntegrationURL=https://sandbox.food.ibm.com/ift/api/connector/v1/assets
   iftProductionURL=https://food.ibm.com/ift/api/connector/v1/assets

Uso

Realice los pasos siguientes para configurar los usuarios del sistema para obtener y renovar automáticamente las señales de autenticación:

  1. Guarde el archivo tar y extraiga el contenido en un directorio de trabajo.
  2. cd en el directorio
  3. Modificar src/main/resource/config.properties (según las instrucciones anteriores)
  4. Ejecute gradle wrapper para construir el proyecto
  5. Ejecute el jar: java -jar build/libs/IFT_authentication_sample-*.jar
  6. Publique una carga útil XML en localhost:8080 e.g.:
    curl -X POST \  
    http://localhost:8080 \  
    -H 'Accept: application/json' \  
    -H 'Content-Type: application/xml' \  
    -d '<insert XML text here>'