java Sample

このコードを使用して、 Transparent Supplyへのデータ・アップロードの自動化を開始できます。 Java™ サンプル (tar ファイル) は、 Spring Boot フレームワークを利用して、 IBM Cloud® IAM トークンを取得し、それをサービス ID トークンと交換するシステム・ユーザー認証プロセスをプログラマチックに管理します。

公称構成変更を使用すると、ご使用の環境にコード (Web サービス) をデプロイして実行することができます。サービスが開始すると、構成ファイルに保管されている API キーが読み取られ、トークン交換が実行されます。 API が呼び出されると、トークンの有効期限が検査され、有効期限が切れている場合は自動的に更新されます。その後、インバウンド・ペイロードが Transparent Supply に送信され、結果が返されます。

このサービスは、 Spring Boot および Gradle を使用し、以下のバージョン用にビルドされました。

Java 8
Gradle 4.2.1
Spring Boot 1.5.13.<release>

特記事項

このコードは、 Transparent Supplyへの認証とデータ送信を素早く稼働させるのに役立つように提供されています。このコードは今後の認証変更に備えて維持されますが、 このコードを「現状のまま」使用することは推奨されません。エンタープライズ環境では、ロギング、単体テスト、正常性エンドポイント、統計、およびエンドポイントなどの追加要件が組織によって決定される場合があります。

構成

サービスを実行する前に、以下のサンプルのような config.properties ファイルを使用して、サービスを構成する必要があります。サービスは、 iftEnvironment 変数の値を分析します。値が SANDBOXの場合は、サンドボックス環境プロパティーが使用されます。それ以外の場合はすべて、 PRODUCTION 環境が想定されます。

具体的には、以下の変数を構成する必要があります。

初期トークン・セットアップ・ステップで使用された API キーと組織 ID。
Transparent Supply 環境 (「SANDBOX」または「PRODUCTION」)

サンプル config.properties ファイル:

   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

使用法

認証トークンを自動的に取得および更新するようにシステム・ユーザーを構成するには、以下のステップを実行します。

tar ファイルを保存し、内容を作業ディレクトリーに解凍します。
ディレクトリーへの cd
src/main/resource/config.properties の変更 (前の手順に従う)
gradle wrapper を実行してプロジェクトをビルドします。
jar を実行します。 java -jar build/libs/IFT_authentication_sample-*.jar

XML ペイロードを localhost:8080 e.g.: にポストします。

curl -X POST \  
http://localhost:8080 \  
-H 'Accept: application/json' \  
-H 'Content-Type: application/xml' \  
-d '<insert XML text here>'