前のトピック: 組織の更新次のトピック: デフォルト組織の詳細の取得

CA Strong Authentication Web Services Guide › 組織の管理 › 組織キャッシュのリフレッシュ

組織キャッシュのリフレッシュ

キャッシュに格納されている組織設定をリフレッシュするには、refreshCache 操作を使用します。 このセクションでは、組織キャッシュのリフレッシュに関する以下のトピックについて説明します。

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

組織キャッシュをリフレッシュするには、refreshCacheRequest を使用します。 以下の表に、このリクエスト メッセージの要素のリストを示します。

要素

必須

説明

systemCache

いいえ

AuthMinder セットアップのすべてのキャッシュをリフレッシュするかどうかを指定します。 以下の値が使用可能です。

  • True： すべての組織キャッシュおよびサーバ キャッシュを含めて、すべてのキャッシュをリフレッシュすることを示します。
  • False： このオプションを選択すると、allOrganization または OrgName を選択して、組織キャッシュをリフレッシュできます。

注： 以下の要素のいずれか 1 つを設定できます。

allOrganizations

いいえ

すべての組織のキャッシュをリフレッシュする必要があるかどうかを指定します。 すべての組織のキャッシュをリフレッシュするには、この要素の値を TRUE に設定します。

OrgName

はい

組織を識別する一意の名前。

clientTxId

いいえ

呼び出し元アプリケーションが含めることができる一意のトランザクション識別子。 この識別子は、関連するトランザクションの追跡に役立ちます。

Web サービスの起動

組織キャッシュをリフレッシュする方法

  1. （オプション） refreshCache 操作のヘッダに認証および許可の詳細を含めます。 ヘッダ要素の詳細については、「Web サービス セキュリティの管理」の章を参照してください。
  2. 組織設定の更新には、efreshCacheRequest 要素を使用します。
  3. refreshCacheRequest メッセージを使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
  4. ArcorUserRegistryMgmtSvc サービスの refreshCache 操作を呼び出して、組織キャッシュをリフレッシュします。

    この操作では、トランザクション識別子および認証トークンが含まれる refreshCacheResponse メッセージが返されます。 レスポンス メッセージの詳細については、以下のセクションを参照してください。

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

refreshCacheResponse レスポンス メッセージでは、SOAP エンベロープ ヘッダでトランザクション識別子および認証トークンが返されます。 これらの要素については以下の表で説明します。 操作が正常に実行されると、SOAP 本文で成功のメッセージが返されます。 エラーがある場合は、エラー レスポンスが返されます。 SOAP エラー メッセージの詳細については、付録「エラー コード」を参照してください。

要素

説明

udsTransactionID

UDS を使用して実行されたトランザクションの一意の識別子。

authToken

Web サービスにアクセスするための認証情報の検証が成功した場合に返される認証トークン。 このトークンによって、その Web サービスへの後続のアクセスでは認証情報を提示する必要がなくなります。

デフォルトでは、認証は 1 日間有効で、その後は認証が再度必要になります。