Mainframe Connector をインストールする前に、初期構成の手順を行う必要があります。
- サービス アカウントに必要なロールを付与します。
- アセットのセキュリティを構成します。
- メインフレームと Google Cloudの間のネットワーク接続を構成します。
次に、インストール パッケージをダウンロードし、OpenSSL を使用してその信頼性を確認します。
以降のセクションでは、各タスクについて詳しく説明します。
サービス アカウントの権限を付与する
サービス アカウントに次のロールが付与されていることを確認します。コンソールを使用してサービス アカウントに複数のロールを付与することも、プログラムでロールを付与することもできます。 Google Cloud
- プロジェクト レベルで、次のロールを割り当てます。
- Cloud Storage バケットで、次のロールを割り当てます。
アセットのセキュリティを設定する
Java Cryptography Extension Common Cryptographic Architecture（IBMJCECCA）（Java 8 または Java 17）
に必要な次の権限がメインフレームに付与されていることを確認します。メインフレームから Google Cloud API へのすべての
リクエストで、トランスポート レイヤ セキュリティ（TLS）が使用されます。これらの権限が付与されていない場合は、INSUFFICIENT ACCESS AUTHORITY エラー メッセージが表示されます。
- ICSF Query Facility（CSFIQF）
- Random Number Generate（CSFRNG）
- Random Number Generate Long（CSFRNGL）
- PKA Key Import（CSFPKI）
- Digital Signature Generate（CSFDSG）
- Digital Signature Verify（CSFDSV）
ネットワーク接続を設定する
Mainframe Connector は、Cloud Storage、BigQuery、Cloud Logging API と連携します。Cloud Interconnect と VPC Service Controls（VPC-SC） が、エンタープライズ ポリシーに基づいて、指定された IP 範囲から特定の BigQuery、Cloud Storage、および Cloud Logging リソースへのアクセスを許可するように構成されていることを確認します。Pub/Sub、Dataflow、Managed Service for Apache Spark API を使用して、IBM z/OS バッチジョブとデータ パイプライン の間の統合を強化することもできます。 Google Cloud
ネットワーク管理チームが以下にアクセスできることを確認します。
- IBM z/OS 論理パーティション（LPAR）に割り当てられた IP サブネット
- Google Cloud IBM z/OS バッチジョブで使用されるサービス アカウント
- Google Cloud IBM z/OS バッチジョブがアクセスするリソースを含むプロジェクト ID
ファイアウォール、ルーター、ドメイン ネームシステムを構成する
メインフレーム IP ファイルを構成して、ファイアウォール、ルーター、および ドメイン ネームシステム（DNS）にルールを含め、 との間でトラフィックを許可します Google Cloud。標準の Cloud Storage API エンドポイントを VPC-SC エンドポイントとして解決するには、 userid.ETC.IPNODES または userid.HOSTS.LOCAL を hosts ファイルとしてインストールします。サンプル ファイル userid.TCPIP.DATA は、hosts ファイル エントリを使用するように DNS を構成するためにデプロイされます。
- ETC.IPNODES
- 199.36.153.4 www.googleapis.com
- 199.36.153.5 www.googleapis.com
- 199.36.153.6 www.googleapis.com
- 199.36.153.7 www.googleapis.com
- 199.36.153.4 oauth2.googleapis.com
- 199.36.153.5 oauth2.googleapis.com
- 199.36.153.6 oauth2.googleapis.com
- 199.36.153.7 oauth2.googleapis.com
- 127.0.0.1 LPAR1 (based on LPAR configuration)
- 127.0.0.1 LPAR2
- 127.0.0.1 LPAR3
- HOSTS.LOCAL
- HOST : 199.36.153.4, 199.36.153.5, 199.36.153.6, 199.36.153.7 : WWW.GOOGLEAPIS.COM ::::
- HOST : 199.36.153.4, 199.36.153.5, 199.36.153.6, 199.36.153.7 : OAUTH2.GOOGLEAPIS.COM ::::
- TCPIP.DATA
- LOOKUP LOCAL DNS
VPC-SC を適用するようにネットワークを構成する
オンプレミス ネットワークで VPC-SC を適用するには、次のように構成します。
- Cloud Interconnect またはバーチャル プライベート ネットワーク（VPN）を使用して、IBM z/OS の送信トラフィックを VPC ネットワーク内の宛先サブネットと
restricted.googleapis.com特別ドメインにルーティングするようにオンプレミス ルーターを構成します。 - VPC サブネットまたは VM インスタンスと Google API エンドポイント（
restricted.googleapis.com 199.36.153.4/30）への送信トラフィックを許可するようにオンプレミス ファイアウォールを構成します。 - VPC-SC のバイパスを防ぐため、他のすべての送信トラフィックを拒否するようにオンプレミス ファイアウォールを構成します。
https://www.google-analytics.comへの送信トラフィックを許可するようにオンプレミス ファイアウォールを構成します。
インストール パッケージをダウンロードして確認する
Mainframe Connector の使用を開始するには、最新のインストール パッケージをダウンロードします。次に、OpenSSL を使用して公式署名に対して整合性を確認します。
Mainframe Connector をダウンロードして確認する手順は次のとおりです。
ビルド済みの Mainframe Connector JAR ファイル を、ユーザー アカウントに書き込み権限があるディレクトリにダウンロードします。
重要
Mainframe Connector は Google アナリティクスを使用して使用状況データを収集します。これにより、ソフトウェアの改善とユーザー エクスペリエンスの向上に役立てることができます。デフォルトでは、Google アナリティクスは有効になっています。ただし、Mainframe Connector の実行時に 環境変数を 構成することで、オプトアウトできます。
Google アナリティクスの使用には、 Google アナリティクスの 利用規約とプライバシー ポリシーが適用されます。 Mainframe Connector をダウンロードすると、利用規約を読み、理解し、同意したことになります。公開鍵を
mfc-key.pubという名前のファイルに保存します。-----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw== -----END PUBLIC KEY-----ダウンロードしたリリース アーティファクトのデジタル署名 ファイル をダウンロードします。
OpenSSL コマンドを実行して署名を確認します。
openssl dgst -sha256 -verify mfc-key.pub \ -signature mainframe-connector.tgz.1.sig mainframe-connector.tgzこのコマンドの想定される出力は
Verified OKです。