セキュリティー構成プロパティー

以下のプロパティーは、BPMActionPolicy 構成オブジェクト内のプロパティーを除き、前の値を置き換えることによって変更できます。BPMActionPolicy のプロパティーについては、既存の値を変更せずに、ロールの追加と削除を行います。

BPMConsoleSection 構成オブジェクトを構成して、特定のユーザーに対して Process Admin Console に表示されるナビゲーター・エントリーを制御できます。どのユーザーが機能を使用する権限を持つかを制御することはできないことに注意してください。例えば、内部グループを作成する権限のためには、ユーザーを bpmAdminGroup (デフォルト設定は tw_admins) のメンバーにする必要があります。BPMConsoleSection のプロパティーについては、既存の値を変更せずに、制約の追加と削除を行います。

wsadmin の AdminConfig オブジェクト・コマンドを使用して、セキュリティー・プロパティーにアクセスし、変更することができます。 WebSphere Application Server が提供する AdminConfig コマンドのリストについては、『wsadmin スクリプトを使用する AdminConfig オブジェクトのコマンド』を参照してください。

• IBM Business Process Manager 固有のプロパティーのリストについては、表 1 を参照してください。
• Process Admin Console 固有のプロパティーのリストについては、表 2 を参照してください。

複数のデプロイメント環境の場合は、各クラスターを異なる機能でセットアップでき、それらの機能に基づいてクラスターのプロパティーが定義されます。プロパティーにアクセスし、変更する前に、正しいクラスターを見つける必要があります。

• デプロイメント環境を取得します。

  wsadmin>deIds = AdminUtilities.convertToList(AdminConfig.getid 
      ('/Cell:/BPMCellConfigExtension:/BPMDeploymentEnvironment:/'))
  wsadmin>deIds['De1(cells/Cell1|cell-bpm.xml#BPMDeploymentEnvironment_1366695378330)', 'De2
  (cells/Cell1|cell-bpm.xml#BPMDeploymentEnvironment_1366696771995)']
  wsadmin>AdminConfig.showAttribute(deIds[0], 'name')
  'De1'
  wsadmin>AdminConfig.showAttribute(deIds[1], 'name')
  'De2'

• 正しい機能を持つクラスターを取得します。

  wsadmin>clusterPath = "/Cell:<cellName>/BPMCellConfigExtension:
      /BPMDeploymentEnvironment:%s/BPMCluster:/" % "<De_name>"
  wsadmin>clusterId = AdminUtilities.convertToList(AdminConfig.getid (clusterPath))
  wsadmin>capabilities1 = AdminUtilities.convertToList(AdminConfig.showAttribute(clusterId[0], 'capabilities'))
  wsadmin>capabilities1['Application']
  wsadmin>capabilities2 = AdminUtilities.convertToList(AdminConfig.showAttribute(clusterId[1], 'capabilities'))
  wsadmin>capabilities2['Messaging']
  wsadmin>capabilities3 = AdminUtilities.convertToList(AdminConfig.showAttribute(clusterId[2], 'capabilities'))
  wsadmin>capabilities3['Support']

• 特定のタイプのオブジェクトをリストします。
  注: それぞれのプロパティーについて、表 1 を参照して構成オブジェクトおよび構成オブジェクトの内包パスを調べてください。例:

  wsadmin>path = "/ServerCluster:<clusterName>/BPMClusterConfigExtension:/BPMProcessServer:/BPMServerSecurity:/"
  wsadmin>b = AdminConfig.getid(path)
  wsadmin>b
  '(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMServerSecurity_1366695662779)'

• 値を持つオブジェクトの属性を表示します (ネストされたオブジェクトが構成 ID によってリストされます)。

  wsadmin>print AdminConfig.show(b)
  [deploySnapshotUsingHttps false][externalUserQueryLimit 100][ldapOptions 
      [twUserNameAttribute(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMLdapOption_1366695662779) 
      twUserDescriptionAttribute(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMLdapOption_1366695662780) 
      twGroupNameAttribute(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMLdapOption_1366695662781) 
      twGroupDescriptionAttribute(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMLdapOption_1366695662782)]]
      [securityGroups (cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMServerSecurityGroups_1366695662779)]
      [securityUsers (cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMServerSecurityUsers_1366695662779)]
      [wildcardProcessingOptimized false]

• 値を持つオブジェクトのすべての属性を表示します (ネストされたオブジェクトがリストされます)。

  wsadmin>print AdminConfig.showall(b)
  [deploySnapshotUsingHttps false]
  [externalUserQueryLimit 100]
  [ldapOptions [[[name twUserNameAttribute]
  [value sAMAccountName]] [[name twUserDescriptionAttribute]
  [value description]] [[name twGroupNameAttribute]
  [value cn]] [[name twGroupDescriptionAttribute]
  [value description]]]]
  [securityGroups [[bpmAdminGroup tw_admins]
  [bpmAuthorGroup tw_authors]
  [collaborationAdmin tw_admins]
  [debug Debug]
  [offlineInstall []]
  [processHelpAccess tw_admins]
  [showXmlMetadata Debug]]]
  [securityUsers [[notifyError bpmadmin2]
  [userToCloseTask bpmadmin2]
  [userToCreateTask bpmadmin2]]]
  [wildcardProcessingOptimized false]

• 特定の属性の値を表示します。

  wsadmin>print AdminConfig.showAttribute(b,'externalUserQueryLimit')
  100

• プロパティーの値を変更します。
  注: 構成変更が確実に保存されるように、プロパティーが変更されるたびに、AdminConfig.save コマンドを実行します。

  wsadmin>AdminConfig.modify(b,[['externalUserQueryLimit', '150']])
  ''
  wsadmin>AdminConfig.save()
  ''
  wsadmin>print AdminConfig.showAttribute(b,'externalUserQueryLimit')
  150

• コンソール・エレメントを取得します。

  wsadmin>consoleElements = AdminUtilities.convertToList(AdminConfig.getid ("/BPMConsoleElement:/"))
  wsadmin>elementName = AdminConfig.showAttribute((consoleElements[0]), 'name')
  wsadmin>print elementName
  'console.admin.tools'

• このコンソール・エレメントの制約オブジェクトの構成 ID を取得します。

  wsadmin>elementName = AdminConfig.showAttribute((consoleElements[4]), 'name')
  wsadmin>print elementName
  'console.bulk.user.attribute.assignment'

• この構成 ID を使用して、プロパティーの現在の値を検索します。

  wsadmin>constraintIds = AdminConfig.showAttribute((consoleElements[4]), 'constraints')
  wsadmin>print constraintIds
  [(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1366695662782)]
  wsadmin>constraint1 = "(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1366695662782)"
  wsadmin>val = AdminConfig.showAttribute(constraint1, 'value')
  wsadmin>print val
  'tw_admins'

• 制約を追加します。

  wsadmin>AdminConfig.create('BPMConsoleConstraint', consoleElements[4], [['type', 'role'],['value', 'admins']])
  '(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1367394007068)'
  wsadmin>AdminConfig.save()''

• 制約を削除します。
  ヒント: 索引を使用して、返された制約のリストを反復します。

  wsadmin>constraintIds = AdminConfig.showAttribute((consoleElements[4]), 'constraints')
  wsadmin>print constraintIds
  [(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1366695662782) 
  (cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1367394007068)]
  wsadmin>constraint1 = "(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1366695662782)"
  wsadmin>constraint2 = "(cells/Cell1/clusters/AppClusterDe1|cluster-bpm.xml#BPMConsoleConstraint_1367394007068)"
  wsadmin>val1= AdminConfig.showAttribute(constraint1, 'value')
  wsadmin>val2= AdminConfig.showAttribute(constraint2, 'value')
  wsadmin>print val1
  'tw_admins'
  wsadmin>print val2
  'admins'
  wsadmin>AdminConfig.remove(constraint2)
  wsamdin>AdminConfig.save()

より複雑なシナリオについては、wsadmin スクリプトを使用する AdminConfig オブジェクトのコマンドを参照してください。

Usage: Use this script to get/modify the configured security properties.
          -E|--de DE_name -option')
                          -g|--get property_name')
                          -s|--set property_name , new_value')
                          -a|--add console_property_name , constraint_value')
                                |action_policy_name , role to be added')
                          -r|--remove console_property_name , constraint_value')
                                |action_policy_name , role to be removed')

プロパティーの値にアクセスするには -g|get オプションを使用し、プロパティーの値を変更するには -s|set オプションを使用します。コンソール・プロパティーの場合、コンソール・セクションへのアクセスを制限するために制約を追加または削除することができます。これらのプロパティーには、上記のように、独自の -a|--addConstraint オプションおよび -r|--removeConstraint オプションがあります。

• 外部ユーザーの照会の制限値を取得します。

  install_root¥bin>wsadmin -conntype NONE -f <install-root>/util/Security/BPMSecurityConfig_sample.py 
  -E <de_name> -g externalUserQueryLimit
  
  WASX7357I: 要求により、このスクリプト・クライアントはどのサーバー・プロセスにも接続されていません。 
  特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。 
  WASX7303I: The following options are passed to the scripting environment and are available 
  as arguments that are stored in the argv variable: "[-E, De1, -g, externalUserQueryLimit]"
  Current value for property externalUserQueryLimit in DE De1 is:99

• アクション・ポリシーの値を取得します。

  INSTALL_ROOT¥bin>wsadmin -conntype NONE -f 
  <install-root>/util/Security/BPMSecurityConfig_sample.py -E <de_name> -g ACTION_ABORT_INSTANCE
  WASX7357I: 要求により、このスクリプト・クライアントはどのサーバー・プロセスにも接続されていません。 
  特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。 
  WASX7303I: The following options are passed to the scripting environment and are
   available as arguments that are stored in the argv variable: "[-E, De1, -g, ACTION_ABORT_INSTANCE]"
  Current value for property ACTION_ABORT_INSTANCE in DE De1 is:tw_admins

• 既存の値を変更します。
  注: 表 2 にリストされたセキュリティー・プロパティーは、すべて変更することができます。
  • 外部ユーザーの照会の制限値を設定します。

    install_root¥bin>wsadmin -conntype NONE -f 
    <install-root>/util/Security/BPMSecurityConfig_sample.py -E <de_name> -s externalUserQueryLimit,100
    WASX7357I: 要求により、このスクリプト・クライアントはどのサーバー・プロセスにも接続されていません。 
    特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。 
    WASX7303I: The following options are passed to the scripting environment and are 
    available as arguments that are stored in the argv variable: "[-E, De1, -s, externalUserQueryLimit,100]"
    Current value for property externalUserQueryLimit in DE De1 is:99
    INFO : The given value for the property was set successfully.
    Current value for property externalUserQueryLimit in DE De1 is:100

  • アクション・ポリシーにロールを追加します。

    install_root¥bin>wsadmin -conntype NONE -f <install-root>/util/Security/BPMSecurityConfig_sample.py 
        -E <de_name > -s ACTION_ABORT_INSTANCE,adminsWASX7357I: 
    By request, this scripting client is not connected to any server process. 特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。
    WASX7303I: The following options are passed to the scripting environment and are available 
    as arguments that are stored in the argv variable: "[-E, De1, -a, ACTION_ABORT_INSTANCE,admins]"
    Current value for property ACTION_ABORT_INSTANCE in DE De1 is:tw_admins
    Current value for property ACTION_ABORT_INSTANCE in DE De1 is:tw_admins;admins

• コンソール・プロパティーに制約を追加します。

  install_root¥bin>wsadmin -conntype NONE -f 
  <install-root>/util/Security/BPMSecurityConfig_sample.py -D <de_name> -a console.monitor,admins
  WASX7357I: 要求により、このスクリプト・クライアントはどのサーバー・プロセスにも接続されていません。 
  特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。 
  WASX7303I: The following options are passed to the scripting environment and are available as arguments 
  that are stored in the argv variable: "[-E, De1, -a, console.monitor,admins]"
  Current value for property console.monitor in DE De1 is:constraint 0 : tw_admins
  constraint 1 : tw_authors
  
  INFO : The given value for the property was set successfully.
  
  Current value for property console.monitor in DE De1 is:
  constraint 0 : tw_admins
  constraint 1 : tw_authors
  constraint 2 : admins

• コンソール・プロパティーから制約を削除します。

  install_root¥bin>wsadmin -conntype NONE -f BPMSecurityConfig_sample.py -r console.monitor,admins
  WASX7357I: 要求により、このスクリプト・クライアントはどのサーバー・プロセスにも接続されていません。 
  特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。 
  WASX7303I: The following options are passed to the scripting environment and are available 
  as arguments that are stored in the argv variable: "[-E, De1, -r, console.monitor,admins]"
  Current value for property console.monitor in DE De1 is:
  constraint 0 : tw_admins
  constraint 1 : tw_authors
  constraint 2 : admins
  
  The given constraint was removed successfully.
  
  Current value for property console.monitor in DE De1 is:
  constraint 0 : tw_admins
  constraint 1 : tw_authors

• Process Designer で開かれる URL へのユーザー・パスワードの組み込みを抑止するには、suppressRedirectUrlPasswd オプションを使用します。例えば、Process Designer でプレイバックを実行するたびに、新しい Process Portal ブラウザー・セッションが開かれます。これにより、Process Designer がユーザー ID とパスワードからなるユーザー資格情報をサブミットします。ブラウザー・セッションは、その資格情報をログインに使用します。suppressRedirectUrlPasswd オプションは、セキュリティーを強化するために、URL へのパスワードの組み込みを停止します。
  注: suppressRedirectUrlPasswd オプションを使用すると、Web で編集可能な成果物を初めて開くとき、または Process Designer で初めてプレイバックを実行するときにのみブラウザーへのログインが必要になります。このオプションは、Process Designer にのみ適用され、必要に応じてオン/オフを切り替えることができます。
  以下の例では Jython を使用しています。

  dmgr_profile_root>wsadmin.bat -connType NONE
  WASX7357I: 要求により、このスクリプト・クライアントはどのサーバー・プロセスにも接続されていません。 
  特定の構成とアプリケーションの操作は、ローカル・モードで使用できます。 
  WASX7031I: For help, enter: "print Help.help()"
  wsadmin>path='/ServerCluster:AppCluster/BPMClusterConfigExtension:/BPMAuthoringEnvironment:/'
  wsadmin>b=AdminConfig.getid(path)
  wsadmin>b
  '(cells/PCCell1/clusters/AppCluster|cluster-bpm.xml#BPMAuthoringEnvironment_1376890854832)'
  wsadmin>AdminConfig.modify(b,[['suppressRedirectUrlPasswd','true']])
  wsadmin>AdminConfig.save()