IBM RACF Advanced ConnectorのReconciliation AgentおよびProvisioning Agentコンポーネントをメインフレームにインストールする必要があります。次の各項では、これらのエージェントのインストールと構成について説明します。
次の表には、Reconciliation AgentおよびProvisioning Agentをインストールするための、ハードウェア、ソフトウェアおよび認可の前提条件を示します。
Reconciliation AgentとProvisioning Agentは両方とも、メインフレーム・システムでIBM RACFシステム・コマンドを実行するために必要な権限を持つサービス・アカウントと初期タスクが必要です。
また、これらのエージェントは、メインフレーム・システムのユーザー・アカウントで機能します。このユーザー・アカウントは、エージェントをデプロイする前にシステム・プログラマが作成しておく必要があります。
注意: Reconciliation AgentおよびProvisioning Agentのどちらのユーザー・アカウントも、管理APF認可ライブラリに配置する必要があります。これらのユーザー・アカウントには、少なくともメインフレームのSystemAdministrators グループの権限が必要です。これらのユーザー・アカウントには、読取り、書込み、実行および変更権限を含む、メインフレームの通常の管理者を超える権限があります。 |
メインフレームで次の要件が満たされていることを確認します。
Reconciliation AgentおよびProvisioning Agentはそれぞれメモリー・サブプールを使用して最大負荷状態を管理します。これらのサブプールでは、操作用にメインフレームのメモリーが1.5〜2.0 MB必要です。これはReconciliation AgentとProvisioning Agentをインストールする際に構成します。
プログラム自体に加え、プログラムの実行元のユーザー・アカウントにも、ホスト・プラットフォームのサブプールにアクセスするための認可が必要です。これは、システム・プログラマが構成する必要があります。
メッセージ・トランスポート・レイヤーにMQ Seriesを使用している場合、MQ管理者は、コネクタに付属のスクリプトによってMQキューの作成を認可される必要があります。
Oracle Identity Managerには、送信キュー、受信キューおよびReconciliation Agent用の通信キューの3つが必要です。これらのキューはMQ管理者により作成され、通常はシステムで使用されているネーミング規則に基づいて名前が付けられます。これらの名前は、Reconciliation AgentおよびProvisioning Agentの起動のジョブ制御言語(JCL)プログラムに自動的に挿入されます。JCLプログラムは、メインフレーム・エージェントを起動するときにシステム・パラメータを構成する起動スクリプトです。
メッセージ・トランスポート・レイヤーにTCP/IPを使用している場合、管理者には、セキュリティ認可を指定するだけでなく、メインフレームにポートを作成するための認可も必要です。
Reconciliation Agentは、メインフレームのオペレーティング・システム外で、ユーザーのexitテクノロジを使用して動作します。つまり、オペレーティング・システムとは異なるLPARで稼働します。
特定のパスワード書式を維持することは、カスタムexitを使用する目的の1つです。Oracle Identity Managerのexitは、既存のexitが通常に機能できるよう、最後に呼び出されるexitとして開発されています。LPAR内のexitを編集した後には、LPARの初期プログラム・ロード(IPL)が必要な場合があります。
Reconciliation AgentおよびProvisioning Agentをデプロイするには、次のようにします。
インストール・メディアの次のファイルの内容を、任意のコンピュータの一時ディレクトリに抽出します。
etc/Provisioning and Reconciliation Connector/Mainframe_RACF.zip
jcl.xmi
およびlinklib.xmi
ファイルをメインフレーム宛に転送するかFTPでアップロードします。このとき、それぞれのファイルで、RECFM=FB
、LRECL=80
、BLKSIZE=3120
およびDSORG=PS
と指定します。
メインフレームのTSO環境にログインします。
CNTL
データセットを開き、ISPFコマンドラインから次のコマンドを実行します。
TSO RECEIVE INDA('IDF.CNTL.XMIT')
リストア・パラメータを指定するよう要求された場合には、次のように入力します。
DA('IDF.CNTL')
LINKLIB
データセットを開くには、ISPFコマンドラインから次のコマンドを実行します。
TSO RECEIVE INDA('IDF.LINKLIB.XMIT')
リストア・パラメータを入力するよう要求された場合には、次のように入力します。
DA('IDF.LINKLIB')
インストールを完了するには、Reconciliation AgentのIDF.CNTL
メンバー#INSTVOY
、およびProvisioning Agentのメンバー#INSTPIO
の手順に従います。
exitは、初期プログラム・ロード(IPL)の際に定義されるz/OSの記憶域であるlinklistにあります。LDAP Gatewayでイベントをすべて取得するためには、IBM RACF認証リポジトリを共有する各LPARに、Reconciliation Agentおよびexitがインストールされている必要があります。
Reconciliation Agentのexitをインストールするには、次のようにします。
注意: 次のステップに示すコンソール・コマンドで、XX は、メインフレームを起動するために使用されるライブラリの1つであるSYS1.PARMLIB のメンバーのPROG 接尾辞です。 |
動的exit機能を使用して、共通コマンドexitであるLOGRIX02
、LOGPWX01
およびLOGEVX01
をインストールします。LOGRIX02
、LOGOWX01
およびLOGEVX01
は、IBM RACFデータの操作または取得のための標準アセンブリ言語exitです。
関連項目: LOGRIX02 、LOGOWX01 およびLOGEVX01 exitの詳細は、IBM Security Serverのドキュメントを参照してください。 |
テスト用に、SYS1.PARMLIB
(または同等のライブラリ)内にexitの動的アクティブ化のためのPROGxx
メンバーを1つ以上設定し、必要な場合にはexitを簡単に削除できるようにすることをお薦めします。
SYS1.PARMLIB
に、次の動的exit定義を含むメンバーを作成します。
EXIT ADD EXITNAME(ICHRIX02) MODULE(LOGRIX02) EXIT ADD EXITNAME(ICHPWX01) MODULE(LOGPWX01) EXIT ADD EXITNAME(IRREVX01) MODULE(LOGEVX01)
LOGRIX02
、LOGOWX01
およびLOGEVX01
exitをシステムのPARMLIB
データセットにコピーします。
コンソール・コマンドSET PROG=XX
を使用して、LOGPWX01
をICHPWX01
exitポイントとしてアクティブ化します。
コンソール・コマンドSET PROG=XX
を使用して、LOGRIX02
をICHRIX02
exitポイントとしてアクティブ化します。
コンソール・コマンドSET PROG=XX
を使用して、LOGEVX01
をIRREVX01
exitポイントとしてアクティブ化します。
製品のexitがロード・ライブラリに含まれるlinklistにインストールされている場合は、SDSFを介したISPFで、またはz/OSマスター・コンソールから、次のコマンドを実行してlinklistルックアサイド領域(LLA)をリフレッシュします。
/F LLA,REFRESH
z/OSマスター・コンソールまたはISPF - SDSFから、次のコマンドを入力して、製品がインストールされているロード・ライブラリがAPF認可であることを確認します。
/D PROG,APF
デフォルトでは、インストール・ロード・ライブラリがlinklistにある場合はAPF認可です。次のコマンドをIPLライブラリから実行すると、インストール・ロード・ライブラリがlinklistにあるかどうかをIPLの際に判別することができます。
SYS1.PARMLIB, member = IEASYS
xx
ここで、xx
はSYS1.PARMIB内のz/OS起動メンバーに対するユーザー接尾辞です。
exitのロードを確認するコマンドとサンプル出力を次に示します。
D PROG,EXIT,EXITNAME=ICHPWX01 CSV461I 14.42.10 PROG,EXIT DISPLAY 398 EXIT MODULE STATE MODULE STATE MODULE STATE ICHPWX01 LOGPWX01 A D PROG,EXIT,EXITNAME=ICHRIX02 CSV461I 14.43.56 PROG,EXIT DISPLAY 400 EXIT MODULE STATE MODULE STATE MODULE STATE ICHRIX02 LOGRIX02 A D PROG,EXIT,EXITNAME=IRREVX01 CSV461I 14.46.59 PROG,EXIT DISPLAY 414 EXIT MODULE STATE MODULE STATE MODULE STATE IRREVX01 LOGEVX01 A
Reconciliation Agent exitをアンインストールする場合は、次のいずれかの方法を使用します。
exitごとにSET PROG=XX
コンソール・コマンドを実行します。このコマンドでは、XX
を、SYS1.PARMLIB
内のexit(メンバー)に対するPROG
接尾辞で置換します。
次のコマンドを実行します。
EXIT DELETE EXITNAME(ICHRIX02) MODULE(LOGRIX02) EXIT DELETE EXITNAME(ICHPWX01) MODULE(LOGPWX01) EXIT DELETE EXITNAME(IRREVX01) MODULE(LOGEVX01)
この項では、次に示す、TCP/IPおよびMQ Seriesに対するメッセージ・トランスポート・レイヤーの構成タスクを説明します。
注意: メッセージ・トランスポート・レイヤー・プロトコルとしてTCP/IPとMQ Seriesのいずれかを構成する必要があります。この項では、使用するプロトコルに対応するステップのみを実行してください。 |
この項では、メッセージ・トランスポート・レイヤーとしてTCP/IPを構成する方法を説明します。TCP/IPの使用方法の詳細はシステム・プログラマに確認してください。メッセージのプーリング、およびメインフレームやLDAP Gatewayサーバーの両方の負荷を大幅に減らすことができる、ステートフル接続の確立を目的とします。TCP/IP接続をLDAP Gatewayに対して確立するには、次のようにします。
Provisioning Agent初期タスクを開始します。このタスクも、指定されたIPアドレスおよびポート番号のLDAP Gatewayに対してTCP/IP接続を確立するよう事前に設定されています。
Reconciliation Agentにも同様の手順を適用します。LDAP Gatewayを起動し、Reconciliation Agent初期タスクを開始します。
TCP/IPをメッセージ・トランスポート・レイヤーとして使用するには、次のIPアドレスが必要です。
メインフレームで使用されるIPアドレス
ルーター用のIPアドレス
ドメイン・ネーム・サーバー用のIPアドレス
注意: TCP/IPをメッセージ・トランスポート・レイヤーとして使用する場合、データ構造のセキュリティ認可の指定だけでなく、メインフレームへのポートの作成のためにシステム・プログラマのサポートが必要な場合もあります。 |
Reconciliation AgentおよびProvisioning Agent JCLを編集するには、次のようにします。
インストール認証のジョブ・カードを挿入します。
PARM
='TCPN=TCPIP
'の値を実行中のTCP/IP初期タスクの名前に変更します。
IPアドレスを、LPAR(Provisioning Agentを起動するz/OSシステム)のアドレスに変更します。
ポート番号を、LPAR(Provisioning Agentを起動するz/OSシステム)に割り当てられたポートに変更します。
インストールにバッチ適用が必要な場合には、適切なVSAMGETU
文を挿入します。次のコードに、IBM RACF ACIDユーザーIDのバッチ・ロードを示します。
//USR98S01 JOB (,xxxxxxxx,,'PROVISIONING AGENT UPLOAD PROCESS FOR ACIDS'), // 'UPLOAD CATS TO XELLTE', // REGION=2M,CLASS=6,MSGCLASS=Q, // USER=RACF_USER_ID,TIME=1440, // NOTIFY=&SYSUID,TYPRUN=HOLD //* /*ROUTE PRINT CLE //* //PIONEERX EXEC PGM=PIONEERX,REGION=0M,TIME=1440, // PARM=('TCPN=TCPIP', // 'IPAD=HOST_IP_ADDRESS_OF_IBM_RACF', // 'PORT=6500', // 'DEBUG=Y') //STEPLIB DD DISP=SHR,DSN=PPRD.IDF.LINKLIB // DD DISP=SHR,DSN=SYS2.TCPACCES.V60.LINK // DD DISP=SHR,DSN=TCPIP.SEZATCP //SYSOUT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSDBOUT DD SYSOUT=* //SYSABOUT DD SYSOUT=* //ABENDAID DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //VSAMGETU DD DISP=SHR,DSN=LXT99S.FEEDFILE.SORTED //*
Reconciliation Agentの場合、ジョブ制御は実行カードの例外と同じです。次に例を示します。
//STEP1 EXEC PGM=VOYAGERX,REGION=0M,TIME=1440, // PARM=('TCPN=TCPIP', // 'IPAD=&SERVER', // 'PORT=&PORT', // 'DEBUG=Y', // 'ESIZE=16', // 'DELAY=00', // 'STARTDELAY=10', // 'PRTNCODE=SHUTRC')
各要素の意味は次のとおりです。
ESIZE=16
はAES暗号化を示すために使用されます。
DELAY
はこのコネクタでは使用されません。このプロパティのデフォルト値(00)を変更しないでください。
STARTDELAY=10
は推奨値です(秒単位)。
PRTNCODE=SHUTRC
を指定すると、Reconciliation Agentが停止した後ですべてのMVS条件コードが表示されます。
PRTNCODE=TERMRC
を指定すると、Reconciliation Agentが停止した後でMVS条件コード0000(正常終了を示す)が表示されます。
DEBUG
にはReconciliation AgentとProvisioning Agentの両方に対して次のいずれかを指定できます。
デバッグ内容を出力しない場合はN
デバッグ内容を出力する場合はY
詳しいデバッグ内容を出力する場合はZ
注意: メンバーの編集を試行した際に、「データセットは使用中です」 というメッセージが表示された場合には、[F1]キーを2回押して、編集対象のメンバーを表示します。例外の原因になったジョブの名前が表示されます。z/OSコンソールで、p またはc コマンドを使用してジョブを削除することができます。 |
Reconciliation Agentを操作する際には、次のガイドラインを適用してください。
Reconciliation Agentを起動する前に、サブプール(RUNSTART.JCL
)を起動する必要があります。サブプールは、メッセージ作成のためのメモリー内記憶域として使用されます。
TCP/IPを使用しているため、LDAP Gatewayを最初に起動する必要があります。Reconciliation Agentを最初に起動すると、LDAP Gatewayが使用できないためにRETCODE=-01
およびERRORNO=61
のエラーがスローされます。
この項では、Provisioning AgentおよびReconciliation Agentのインストール、およびIBM MQ Seriesを使用できるようそれらを構成する方法を説明します。
Provisioning Agentでは、MQインストールの次のメンバーが使用されます。
Provisioning Agentを構成するには、次のようにします。
QMGR PARM
フィールドのQMGR
をキュー・マネージャの名前に変更します。キュー・マネージャ名は、システムのMQキュー・マネージャに指定された実際のタスク名です。
必要な場合には、Debug
オプションをY
に設定してデバッグ・オプションを有効化します。
注意: この設定により、大量の出力が生成されます。テスト目的でのみ実行してください。 |
Idf.Linklib
をOracle Identity Manager Authorized Load Module Libraryに指定した名前に変更します。
インストール認証のジョブ・カードを挿入します。
IDF.CNTL
をOracle Identity Manager Control Libraryに指定した名前に変更します。IDF.CNTLの詳細は、「手順2: Reconciliation AgentおよびProvisioning Agentのデプロイ」を参照してください。
SYS1.PROCLIB
を、使用するJES2 PROCLIB
の名前に変更します。
Reconciliation Agent初期タスクを、初期タスクとして開始するよう変更します。
PIOCOPY
を発行します。選択したJES2 PROCLIB
にメンバーVOYAGER
が存在することを確認します。
すべてのQMGR
をキュー・マネージャの名前に変更します。キュー・マネージャ名は、システムのMQキュー・マネージャに指定された実際のタスク名です。
すべてのSTGCLASS
を、2つのProvisioning Agentキューの記憶域クラスの名前に変更します。
注意: パフォーマンス上の理由から、2つのProvisioning Agentキューを異なる記憶域クラスに割り当てる必要がある場合があります。Reconciliation Agentも使用している場合には、Reconciliation Agentキューに別の記憶域クラスを使用する場合もあります。 |
インストール認証のジョブ・カードを挿入します。
PARM
のQMGR
をキュー・マネージャの名前に変更します。
MQMHLQ
を、MQシステム・データセットの上位レベルの修飾子に変更します。
IDF.CNTL
をOracle Identity Manager Control Libraryに指定した名前に変更します。
注意: セキュリティ環境によっては、Provisioning Agentを初期タスクとして定義し、データセットおよびMQリソースへのアクセス権を付与する必要がある場合もあります。 |
Provisioning Agentを起動できます。
注意: Provisioning AgentはMQ Seriesに依存しているため、Provisioning Agentを開始する前にキュー・マネージャがアクティブであることを確認する必要があります。 |
Provisioning Agentが初期タスクの場合には、コンソールからS PIONEER
を実行してProvisioning Agentを起動します。Provisioning Agentがバッチ・タスクの場合には、PIONEER JCL
を発行します。
Control LibraryのReconciliation Agentインストールのメンバーは次のとおりです。
Reconciliation Agentを構成するには、次のようにします。
QMGR
PARM
フィールドのQMGR
をキュー・マネージャの名前に変更します。キュー・マネージャ名は、システムのMQキュー・マネージャに指定された実際のタスク名です。
必要な場合には、Debug
オプションをY
に設定してデバッグ・オプションを有効化します。
注意: この設定により、大量の出力が生成されます。テスト目的でのみ実行してください。 |
IDF.LINKLIB
をOracle Identity Manager Authorized Load Module Libraryに指定した名前に変更します。
メンバーVOYINIT
、VOYKILL
およびVOYSTOP
を編集します。
IDF.LINKLIB
をOracle Identity Manager Authorized Load Module Libraryに指定した名前に変更します。
インストール認証のジョブ・カードを挿入します。
IDF.CNTL
をOracle Identity Manager Control Libraryに指定した名前に変更します。
SYS1PROCLIB
を、VOYAGER
を初期タスクとして起動するJES2 PROCLIB
の名前に変更します。
注意: 選択したJES2 PROCLIB にメンバーVOYAGER 、VOYINIT 、VOYKILL およびVOYSTOP が存在することを確認します。 |
MQ Seriesのインストールでは、メンバーVOYMQ
を編集します。
すべてのQMGR
をキュー・マネージャの名前に変更します。キュー・マネージャ名は、システムのMQキュー・マネージャに指定された実際のタスク名です。
すべての+STGCLASS
+を、Reconciliation Agentキューの記憶域クラスの名前に変更します。
注意: Reconciliation Agentを、Provisioning Agentキューで使用しているのとは異なる記憶域クラスに割り当てることが必要な場合もあります。 |
インストール認証のジョブ・カードを挿入します。
パラメータのQMGR
をキュー・マネージャの名前に変更します。キュー・マネージャ名は、システムのMQキュー・マネージャに指定された実際のタスク名です。
+MQMHLQ+
を、MQシステム・データセットの上位レベルの修飾子に変更します。
IDF.CNTL
をOracle Identity Manager Control Libraryに指定した名前に変更します。
注意:
|
Reconciliation Agentを起動できます。
Reconciliation Agentの起動プロセス
Reconciliation Agentを起動するには、次のようにします。
コンソールからS VOYINIT
を実行してサブプールを作成することで、VOYINIT
タスクを開始します。
注意: VOYKILL が実行されないかぎり、これを実行する必要があるのは1回のみです。 |
VOYINIT
が終了したら、コンソールからS VOYAGER
を実行してReconciliation Agentを起動します。
サブプールをそのままの状態で維持しながらVOYAGER
を一時停止するには、コンソールからS VOYSTOP
を実行してVOYSTOP
を開始します。Reconciliation Agentを一時停止してサブプールを破棄するには、コンソールからS VOYKILL
を実行してVOYKILL
を開始します。VOYKILL
を使用すると、サブプールに保存されているメッセージがすべて失われます。
IBM RACFでは、サロゲート・ユーザーは、パスワードを知ることなく別のユーザーのかわりに操作を行うことが許可されます。Reconciliation AgentおよびProvisioning Agentでサロゲート・ユーザーIDのRACFアクセスを有効にするには、次のようにします。
IBM RACFコマンドの実行およびIBM RACFデータベースの変更に必要な認可のあるユーザー・アカウントを使用して、TSOにログインします。たとえば、IBMUSERには通常その認可があります。
TSOコマンドライン(またはISPFのオプション6)から、次のIBM RACFコマンドを実行します。
RDEFINE FACILITY IRR.RADMIN.* UACC(NONE)
このコマンドにより、FACILITY
クラスのIRR.RADMIN.*
という名前のIBM RACFリソースが定義されます。
TSOコマンドライン(またはISPFのオプション6)から、次のIBM RACFコマンドを実行します。
PERMIT IRR.RADMIN.* CLASS(FACILITY) ID(STARTER) ACCESS(READ)
このコマンドにより、ユーザー・アカウントSTARTER
(初期タスクのユーザー・アカウントの例)にリソースIRR.RADMIN.*
への読取りアクセス権が付与されます。これにより、初期タスクがRACFコマンドを実行できるようになります。
TSOコマンドライン(またはISPFのオプション6)から、次のIBM RACFコマンドを実行します。
ALTUSER STARTER SPECIAL
このコマンドにより、ユーザー・アカウントSTARTER
にSPECIAL
属性が付与され、初期タスクによるIBM RACFユーザー・プロファイルへのアクセスおよび変更が可能になります。
TSOコマンドライン(またはISPFのオプション6)から次のコマンドを実行します。
SETROPTS RACLIST(FACILITY) REFRESH
このコマンドにより、IBM RACFの記憶域内の表が更新され、作成した定義がすぐにアクティブ化されます。
ISPFを終了します。
Reconciliation AgentおよびProvisioning Agentの設定と実行には、2つの異なるJCLがあります。エージェントごとに1つのJCLメンバーがあります。RUNPIONXおよびRUNVOYAXは、初期タスクを設定する顧客のためのサンプルです。
RUNPIONX
のパラメータ:
TCPN
: TCPプロセスの名前
IPAD
: Provisioning Agentが稼働しているコンピュータのIPアドレス
PORT
: Provisioning Agentの着信接続ポート
DEBUG
: 診断出力を表示するためのデバッグ・スイッチ
RUNVOYAX
のパラメータ:
TCPN
: TCPプロセスの名前
IPAD
: Reconciliation Agentが接続しているコンピュータのIPアドレス
PORT
: Reconciliation Agentの発信接続ポート
DEBUG
: 診断出力を表示するためのデバッグ・スイッチ
各プログラムのソース・コードは次のとおりです。
RUNPIONX
:
//ADCDMPPT JOB SYSTEMS,MSGLEVEL=(1,1),MSGCLASS=X,CLASS=A,PRTY=8,
// NOTIFY=&SYSUID,REGION=4096K
//PIONEERX EXEC PGM=PIONEERX,REGION=0M,TIME=1440,
// PARM=('TCPN=TCPIP',
// 'IPAD=HOST_IP_ADDRESS_OF_IBM_RACF_SYSTEM',
// 'PORT=5790',
// 'DEBUG=Y')
//STEPLIB DD DISP=SHR,DSN=IDF.LINKLIB
// DD DISP=SHR,DSN=TCPIP.SEZATCP
//SYSPRINT DD SYSOUT=X
//SYSUDUMP DD SYSOUT=X
//
RUNVOYAX
:
//VOYAGER JOB SYSTEMS,MSGLEVEL=(1,1),MSGCLASS=X,CLASS=A,PRTY=8,
// NOTIFY=&SYSUID,REGION=4096K
//STEP1 EXEC PGM=VOYAGERX,REGION=0M,TIME=1440,
// PARM=('TCPN=TCPIP',
// 'IPAD=LDAP_GATEWAY_IP_ADDRESS',
// 'PORT=5190',
// 'DEBUG=Y',
// 'ESIZE=16',
// 'DELAY=00',
// 'STARTDELAY=10',
// 'PRTNCODE=SHUTRC')
//STEPLIB DD DSN=IDF.LINKLIB,DISP=SHR
//CACHESAV DD DSN=ADCDM.CACHESAV,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*