java Sample

Você pode usar este código para começar a automatizar seus uploads de dados para Transparent Supply. A amostra Java™ (arquivo tar) utiliza a estrutura Spring Boot para gerenciar programaticamente o processo de autenticação do usuário do sistema de obter um token do IAM do IBM Cloud® e trocá-lo por um token do ID de serviço.

Com uma alteração de configuração nominal, o código (web service) pode ser implementado e executado em seu ambiente. Quando o serviço inicia, a chave API armazenada no arquivo de configuração é lida e a troca de token é executada. Quando a API é chamada, o tempo de expiração no token é verificado e renovado automaticamente se ele estiver expirado. A carga útil de entrada é então transmitida para Transparent Supply e o resultado é retornado.

O serviço utiliza o Spring Boot e o Gradle e foi construído para as seguintes versões:

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

Isenção de responsabilidade

Este código é fornecido para ajudá-lo a se levantar e a correr rapidamente com autenticação e envio de dados para Transparent Supply. Este código será mantido para qualquer alteração de autenticação futura, mas é não recomendado que este código seja usado "as-is". Em um ambiente corporativo, requisitos adicionais podem ser ditados por sua organização, como registro de registro, testes unitários, terminais de saúde, estatísticas e terminais.

Configuração

Deve-se configurar o serviço antes de executá-lo, usando um arquivo config.properties semelhante à amostra a seguir: O serviço analisa o valor da variável iftEnvironment ; se o valor for SANDBOX, as propriedades do ambiente de simulação serão usadas.. Em todos os outros casos, o ambiente PRODUÇÃO é assumido.

Especificamente, você deve configurar as seguintes variáveis:

Arquivo config.properties de amostra:

   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

Complete as seguintes etapas para configurar seus usuários do sistema para obter e renovar automaticamente os tokens de autenticação:

  1. Salve o arquivo tar e extraia o conteúdo em um diretório de trabalho.
  2. cd no diretório
  3. Modificar src/main/resource/config.properties (de acordo com as instruções anteriores)
  4. Executar gradle wrapper para construir o projeto
  5. Execute o pote: java -jar build/libs/IFT_authentication_sample-*.jar
  6. Poste uma carga útil XML para localhost:8080 e.g.:
    curl -X POST \  
    http://localhost:8080 \  
    -H 'Accept: application/json' \  
    -H 'Content-Type: application/xml' \  
    -d '<insert XML text here>'