設定の削除

CA Strong Authentication Web Services Guide › AuthMinder 設定の管理 › 設定の削除

設定の削除

AuthMinder 内の設定を削除するには、delete 操作を使用します。設定を削除した後も、その設定に関連する情報はシステムに保持されたままです。そのため、削除された設定プロファイルと同じ名前の設定プロファイルは作成できません。このセクションでは、設定の削除に関する以下のトピックについて説明します。

リクエストメッセージの準備
Web サービスの起動
レスポンスメッセージの解釈

注：設定を削除した後、変更を有効にするにはシステムキャッシュをリフレッシュする必要があります。システムキャッシュをリフレッシュする方法の詳細については、「組織キャッシュのリフレッシュ」を参照してください。

リクエストメッセージの準備

設定を削除するには、deleteRequest メッセージを使用します。以下の表に、すべての認証情報および認証ポリシーに適用可能な、このリクエストメッセージの共通の要素のリストを示します。

要素	必須	説明

clientTxId	いいえ	呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。この識別子は、関連するトランザクションの追跡に役立ちます。
追加入力（AdditionalInput）要素
pairs	いいえ	AuthMinder の additionalInput 要素を使用すると、追加情報を指定して AuthMinder の認証機能を拡張したい場合に、追加入力を設定できます。その場合、名前と値のペアで追加情報を設定する必要があります。 name （作成するキーペアの名前） value （名前に対応する値）注：これらの要素は複数追加できます。事前定義済みの追加入力パラメータの一部を以下に示します。 AR_WF_LOCALE_ID 呼び出し元アプリケーションにメッセージを返す際に AuthMinder で使用するロケールを指定します。 AR_WF_CALLER_ID トランザクションの追跡に役立ちます。この情報は、セッション ID またはクライアントトランザクション ID （clientTxnId）を使用して指定できます。
組織詳細（configurationNames/orgDetails）要素
orgName	はい	設定を適用した組織の名前を削除します。
または
isGlobal	はい	これらの設定をグローバルレベルで適用するかどうかを示します。
認証情報設定および認証設定の要素以下の要素は、すべての認証情報設定および認証ポリシー設定に適用できます。
configNames	いいえ	特定の組織の設定名を削除します。
isAllConfigs	いいえ	すべての設定を削除する必要があるかどうかを示します。

Web サービスの起動

設定の詳細を削除する方法

（オプション） SOAP ヘッダまたは delete 操作の additionalInput 要素に認証および許可の詳細を含めます。これらの詳細については、「Web サービスセキュリティの管理」の章を参照してください。
DeleteRequest 要素を使用して、上記の表に記載されている設定の詳細を削除します。
DeleteRequest メッセージを使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
ArcotWebFortAdminSvc サービスの delete 操作を呼び出して、設定の詳細を削除します。

レスポンスメッセージの解釈

成功したトランザクションでは、deleteResponse レスポンスメッセージに、以下の表で説明されている要素が返されます。これらの要素は SOAP本文に含まれます。エラーがある場合、エラーレスポンスは SOAP 本文に含まれます。 SOAP エラーメッセージの詳細については、付録「エラーコード」を参照してください。

要素	説明
message	トランザクションのステータスを示します。
reasonCode	操作の失敗時に AuthMinder サーバが送信する一意のコード。
responseCode	エラーの場合に SDK が返すコード。
transactionID	トランザクションの一意の識別子。
additionalOutput	追加入力に対応する戻り値。