プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Access Management管理者ガイド
11g リリース2 (11.1.2.3) for All Platforms
E61950-08
目次へ移動
目次
前
前 		次
次

25.16 ポリシーおよびアプリケーション・ドメインのリモート管理の理解

いくつかのリモート管理モードで、管理者は既存のエージェント登録を更新、検証または削除できます。

この項では次のトピックを記載しています:

25.16.1 リモート・ポリシー管理のモード、テンプレートおよびフラグ

Access Managerには、付属のエージェントを登録または変更せずにアプリケーション・ドメインとそのポリシーを管理する2つのモードがあります。リモート・ポリシーおよびアプリケーション・ドメイン管理でサポートされるのは、作成および更新の機能のみです。リモート管理では、アプリケーション・ドメインやポリシーの削除はサポートされていません。

ノート:

アプリケーション・ドメインの削除は手動のタスクであり、Oracle Access Managementコンソールを使用して実行する必要があります。

表25-32に、リモート・アプリケーション・ドメイン管理のモードを示します。ここでもコマンドのパラメータには、モード、$OAM_REG_HOMEに対する相対パスを使用する入力*Request.xmlファイル、入力ファイルの優先ロケーションが含まれます。 

./oamreg.sh <mode> <input_file> [prompt_flag] [component.oam.config_file] <mode> value

表25-32 リモート・ポリシー管理のモード、テンプレートおよびフラグ

モードおよびテンプレート 説明

policyCreate

$OAM_REG_HOME/input/

CreatePolicyRequest.xml

管理者が、エージェントを登録せずにホスト識別子とアプリケーション・ドメインを作成できます。

./bin/oamreg.sh policyCreate input/myCreatePolicyRequest.xml

関連項目: 「ポリシー作成のリクエスト・テンプレート」

policyUpdate

$OAM_REG_HOME/input/

UpdatePolicyRequest.xml

管理者が、エージェントを更新せずに既存のホスト識別子とアプリケーション・ドメインを更新できます。

./bin/oamreg.sh policyUpdate input/UpdatePolicyRequest.xml

関連項目: 「ポリシー更新のリクエスト・テンプレート」

フラグ

オプション

[prompt_flag] value: [-noprompt]

-nopromptフラグを使用すると、oamregはechoおよびpipeを使用してsystem.inから入力を読み取り、データを渡すことができます。

$OAM_REG_HOMEロケーションからの例

(echo username; echo password; echo webgate_password;) | ./bin/oamreg.sh inband input/Request.xml -noprompt component.oam.conf

(echo username; echo password; echo webgate_password; echo httpscert_trust_prompt;) | ./bin/oamreg.sh inband input/Request.xml -noprompt

(echo username; echo password; echo webgate_password; echo cert_password;) | ./bin/oamreg.sh inband input/Request.xml -noprompt

(echo username; echo password; echo webgate_password; echo httpscert_trust_prompt; echo cert_password;) | ./bin/oamreg.sh inband input/Request.xml -noprompt

component.oam.config_file

オプション。リモート登録は、URIリストを引数に持つ構成ファイルを受け取ります。component.oam.config_fileには、任意の数の保護URIまたはパブリックURIを含むファイルへのフルパスを定義します。このファイルでは次の構文および形式が使用されていることを確認します。

  • 少なくとも1つの保護URIが必要です。

  • 1ファイルごとに1つの製品ファミリのみ指定できます。

  • コメントは'#'で始めます。

  • キーワード'public_uris': このキーワードに続いて、パブリックURIを1行ごとにリストします。

  • キーワード'protected_uris': このキーワードに続いて、保護されるURIを1行ごとにリストします。

ノート: 次の形式を使用して、ポリシーに対して認証スキームを構成できます(ポリシー名と認証スキーム名はタブ文字で区切る必要があります)。 

<Policy Name> 'tab' <Authentication Scheme Name>

次に例を示します。

########################
protected_uris 
########################
protected policy1 Basic Over LDAP 
/finance/protected1/**
/finance/protected2/** 

protected policy2 Client Certificate
/finance/protected3/*.js,*.png,*.gif

########################
public_uris 
########################
/finance/public 
/finance/test1/public

25.16.2 ポリシー作成のリクエスト・テンプレート

CreatePolicyRequest.xmlファイルをリモートpolicyCreateモードで使用すると、管理者はエージェント登録を作成または更新することなく、ホスト識別子とアプリケーション・ドメインを作成できます。

  • 複数のhostPortVariations(ホストとポートのペア)を追加して、ホスト識別子を作成します。

  • アプリケーション・ドメインを作成します。

  • 複数の保護リソース、パブリック・リソース、除外リソースを追加します。リソースは、問合せ文字列の有無にかかわらずどちらもサポートされます。

  • カスタマイズしたポリシーを必要としないリソースに対するデフォルトの認証ポリシーおよび認可ポリシーを作成します。

前述のとおり、CreatePolicyRequest.xmlファイルと、拡張された(完全な)エージェント登録テンプレートには、同じパラメータが多数存在します。CreatePolicyRequest.xmlファイルには、認証および認可のポリシーおよびリソースの要素があります(<agentName>要素はない)。

CreatePolicyRequest.xmlファイルのパラメータの一部は新規であり、エージェント登録XMLファイル全体には含まれず、元のエージェント登録ファイルの特定の要素を使用して作成または更新されます。ただし、同じ要素もあります。CreatePolicyRequest.xml固有の主な違いは、次のとおりです。

  • 認証および認可のポリシーおよびリソースの要素があります。

  • <agentName>要素または関連する要素はありません。

関連項目:

「リモート・ポリシー管理テンプレートの要素」

25.16.3 ポリシー更新のリクエスト・テンプレート

UpdatePolicyRequest.xmlとCreatePolicyRequest.xmlの内容は、ほぼ同じです。どちらも同じ要素を提供しますが、例外は<protectedAuthnScheme>要素です。

関連項目:

「リモート・ポリシー管理テンプレートの要素」

UpdatePolicyRequest.xmlを使用して、管理者は次の操作が可能です。

  • 複数のhostPortVariations(ホストとポートのペア)を追加して、ホスト識別子を更新します。

  • アプリケーション・ドメインを更新します。

  • 問合せ文字列の有無にかかわらず、複数の保護リソース、パブリック・リソース、除外リソースを追加します。

  • カスタマイズしたポリシーを必要としないリソースに対するデフォルトの認証ポリシーおよび認可ポリシーを更新します。

  • 次を含む、カスタマイズしたポリシーを作成します。

    • ポリシーの表示名

    • ポリシーの説明

    • 認証スキーム(認証ポリシーのみ)およびポリシーに関連付けられるリソースのサブセット

25.16.4 リモート・ポリシー管理テンプレートの要素

このトピックでは、CreatePolicyRequest.xmlファイルおよびUpdatePolicyRequest.xmlファイルにある、アプリケーション・ドメイン管理に関する一意のリモート管理要素について説明します。

これらの要素の詳細は、表25-33を参照してください。

関連項目:

リモート登録とリモート管理に共通する要素の説明は、表15-8を参照してください。

表25-33 リモート管理テンプレートの要素

要素 説明 例 
 <rregAuthenticationPolicies>
  <rregAuthenticationPolicy>

認証ポリシーの名前と説明を指定します(新規ポリシーの作成または既存ポリシーの更新時に使用)。 

 <rregAuthenticationPolicies>
  <rregAuthenticationPolicy>
     <name>AuthenticationPolicy1</name>
     <description>Authentication policy 
     created using policyUpdate mode of  
     rreg tool</description>
  .
  .
  </rregAuthenticationPolicy>
 </rregAuthenticationPolicies>
 
    <authnSchemeName>

認証ポリシーで使用する認証スキームを指定します。 

 <rregAuthenticationPolicies>
  .
  .
      authnSchemeName>LDAPScheme
      </authnSchemeName> 
  .
  .
  </rregAuthenticationPolicy>
 </rregAuthenticationPolicies>

<uriList>

ポリシーを使用する認証を必要とするリソースを識別します。

 
 <rregAuthenticationPolicies>
  .
  .
     <uriList>
       - <uriResource>
           <uri>/res1</uri> 
           <queryString /> 
         </uriResource>
      </uriList>
  .
  .
  </rregAuthenticationPolicy>
 </rregAuthenticationPolicies>
 
 <rregAuthorizationPolicies>
  <rregAuthorizationPolicy>

認可ポリシーの名前と説明を指定します(新規作成または既存ポリシーの更新時に使用)。 

 <rregAuthorizationPolicies>
  <rregAuthorizationPolicy>
     <name>AuthorizationPolicy1</name>
     <description>Authorization policy 
     created using policyUpdate mode of  
     rreg tool</description>
  .
  .
  </rregAuthorizationPolicy>
 </rregAuthorizationPolicies>

<uriList>

認可ポリシーを使用する認可を必要とするリソースを識別します。

 
 <rregAuthorizationPolicies>
  .
  .
     <uriList>
       - <uriResource>
           <uri>/res1</uri> 
           <queryString /> 
         </uriResource>
      </uriList>
  .
  .
  </rregAuthorizationPolicy>
 </rregAuthorizationPolicies>
前
前 		次
次
目次へ移動
目次