事前共有鍵ファイルの適用

目的

IBM® IoT MessageSight で PreSharedKey 構成を作成して、以前にアップロードされた事前共有鍵ファイルを適用します。 事前共有鍵 (PSK) は 2 つのデバイス間 (例えば、クライアントとサーバー) で共有できる秘密鍵で、保護されたチャネルで接続されます。PSK はサーバーがクライアントを認証する場合に使用されます。

URI

以下の IBM IoT MessageSight 構成 URI を使用して、IBM IoT MessageSight REST API POST メソッドを使用します。

http://<admin-endpoint-IP:Port>/ima/v1/configuration/

オブジェクト構成データ

以下のスキーマを使用して、POST メソッドのペイロードに PreSharedKeyFile オブジェクト構成データを指定 します。Content-type は application/json に設定されます。

{  
  "PreSharedKey":"<PreSharedKeyFileName>"
}

PreSharedKeyFileName

必須。

事前共有鍵ファイルの名前を指定します。

使用上の注意

• 適用するには、その前に証明書をサーバーにアップロードしておく必要があります。 PSK ファイルをアップロードするには、 事前共有鍵ファイルのアップロード を実行します。
• 新しい PSK ファイルを適用すると、既存の PSK ファイルは警告なしに上書きされます。
• 大/小文字の区別および二重引用符は、以下に示すとおりに使用されている必要があります。

関連する REST 管理 API

• 事前共有鍵ファイルの構成の表示
• 事前共有鍵ファイルのアップロード
• 事前共有鍵の構成の削除

例

curl -X POST \
   -H 'Content-Type: application/json'  \
   -d  '{
         "PreSharedKey": "myPSKfile_201603016.csv"  
        }
      '  \
http://127.0.0.1:9089/ima/v1/configuration/

{        
  "Version": "v1",
  "Code": "CWLNA6011",
  "Message": "The requested configuration change has completed successfully."
}