REST API による ISVA 複数値設定エントリの更新

Troubleshooting

Problem

IBM Security Verify Access（ISVA）Web サービス REST API を使って、ISVA 構成ファイルの単一スタンザ内で複数の値を持つエントリを更新するにはどうすればよいですか？

Symptom

ISVA 構成ファイル内の一部のエントリは、複数の値をサポートするために特定のスタンザ内に何度も存在する場合があります。
たとえば、Web Reverse Proxy の構成ファイルには、以下のようなエントリが存在することがあります。

[ssl-qop-mgmt-default]
default = AES-128
default = RC2-128
default = RC4-128
default = DES-168

「updating a configuration entry or entries by stanza - Reverse Proxy」用の REST API には、スタンザ内のエントリ名表現のみを許可する次の構文があります。

https://{appliance_hostname}/wga/reverseproxy/{reverseproxy_id}/configuration/stanza/{stanza_id}/entry_name/{entry_name_id}

結果として、この REST API 呼び出しを使用して特定の複数値エントリを変更することはできません。
これは、構文が更新するエントリのみを識別し、値を識別しないためです。

Resolving The Problem

「update」API 呼び出しではなく、明示的に「delete」を使用してから「add」REST API 呼び出しをします。
たとえば、既存のエントリ「default = AES-128」を「default = AES-256」に更新するには以下のようにします。

(1) 既存の明示的な値を削除します。

curl -k -v -H "Accept:application/json" --user admin:<password> -X DELETE https://<hostname>/wga/reverseproxy/<instance>/configuration/stanza/ssl-qop-mgmt-default/entry_name/default/value/AES-128

(2) 新しい値を追加します。

curl -k -v -H "Accept:application/json" --user admin:<password> -d@addParam.json -X POST https://<hostname>/wga/reverseproxy/<instance>/configuration/stanza/ssl-qop-mgmt-default/entry_name

addParam.json ファイルの内容：
{
entries: [
["default", "AES-256"],
]
}

Related Information

原文はこちらです。

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB24","label":"Security Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRGTL","label":"IBM Security Verify Access"},"ARM Category":[{"code":"a8m0z000000cxuNAAQ","label":"Security Verify Access-\u003EAppliance Administration"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0.0;and future releases"}]

Product Synonym

ISVA
ISAM
REST
API
update
modify
multi-value
parameter
entry_name_id

Was this topic helpful?

Document Information

Modified date:
27 December 2022

UID

ibm16851865

Tips