外部接続情報の取り込み
バックグラウンド
外部エンドポイントとのセキュリティ保護された MTLS 接続を設定するには、エンドポイントのベース URL、URL フラグメント、クライアントキー証明書、サーバー証明書などの必要条件が Windchill+ 内で準備されていることを確認します。この情報は CCD ユーティリティで SSL コンテキストを生成するために使用されます。
PTC と接続情報を共有する手順
materialAPI を設定した後、次の情報があることを確認します。
◦ ベース URL
◦ client-keycertchain
◦ server-certchain
また、BLOB_SAS_URL と暗号化用の公開キーを PTC から受け取っている必要があります。
2. 次のサンプル JSON ファイルに記載されているプレースホルダーを実際のパラメータに置き換えて、JSON ファイルを準備します。
MaterialAPI JSON
{
"blob_sas_url": "***replace with BLOB_SAS_URL received from PTC***",
"external_connections": {
"material_api": {
"baseurl": "***replace with your base-url***",
"secrets": {
"client_cert": "***replace with path to clientcertchain***",
"bearer_token": "Bearer ***replace with your bearer token***"
},
"server_cert": "***replace with path to server.certchain***",
"url_fragments": {
"get_material_number": "/api/material",
"get_material_data_stream": "/api/materialData/stream"
}
}
},
"public_key_for_encrypting_custom_secrets":"***replace with your public key for encryption received from PTC ***",
"apply_at":"***schedule atleast 1 hour after execution-time of utility***"
}
"blob_sas_url": "***replace with BLOB_SAS_URL received from PTC***",
"external_connections": {
"material_api": {
"baseurl": "***replace with your base-url***",
"secrets": {
"client_cert": "***replace with path to clientcertchain***",
"bearer_token": "Bearer ***replace with your bearer token***"
},
"server_cert": "***replace with path to server.certchain***",
"url_fragments": {
"get_material_number": "/api/material",
"get_material_data_stream": "/api/materialData/stream"
}
}
},
"public_key_for_encrypting_custom_secrets":"***replace with your public key for encryption received from PTC ***",
"apply_at":"***schedule atleast 1 hour after execution-time of utility***"
}
 |
bearer_token は予約済みのキーワードではなく、サンプル実装でのベアラートークン認証に対する特定の処理はありません。基本的には、関連する外部エンドポイントのリクエストを構築する際にカスタマイズコードが識別して利用できるその他の文字列を使用できます。
|
3. JSON ファイルへのパスを指定し、${WT_HOME}/prog_examples/IntegrationsExample/captureExternalConnections.sh から capturExternalConnections ユーティリティを実行します。
./captureExternalConnections.sh -f <***path-to-your-json***>
外部情報が正常に取り込まれた場合、"Connection information submitted successfully" というメッセージが表示されます。