Using ZIETrans EJB の翻訳版です。
HCL Z and I Emulator for Transformation の EJB について
2021年12月7日
著者: Soumya Mallappa / Senior Software Engineer at HCL Software
EJB(Enterprise java bean)は、特定のアプリケーションのビジネスロジックをまとめるためのサーバーサイドソフトウェアです。EJBを使用することで、安全で堅牢、かつ拡張性のある分散型アプリケーションを開発することができます。
ZIETrans EJBプロジェクトは、Integration Objectsでカプセル化されたホストのインタラクションへのアクセスを提供します。EJB プロジェクトには、1 つ以上の Integration Objects が含まれます。これらの統合オブジェクトは、ホスト データを EJB クライアント、つまり、別の ZIETrans アプリケーション、ユーザーが書いた Java プログラム、Web アプリケーション、または別の EJB に提供します。ZIETrans EJB プロジェクトでは、ホスト・データの収集とその表示を分離することができます。
このブログでは、アプリケーション・クライアント・プロジェクトでZIETrans EJB Beansを使用する方法を理解します。
EJB Access BeansをJavaアプリケーション・クライアントで使用するには、以下の手順に従います。
グラフィカル・ユーザー・インターフェース、アプリケーション 説明が自動的に生成される
図 1: EJB Access Bean の ZIETrans プロジェクトへのエクスポート
新しいApplication clientプロジェクトを作成し、Mainクラスと展開記述子の生成を選択する。この新しいプロジェクトを、ZIETrans EJBプロジェクトと同じエンタープライズ・アーカイブ(EARファイル)に入れます。
以下の jar ファイルをマニフェストファイルに依存する jar として追加します。
ZIETransプロジェクトのEJB .jarファイル * hatscommon.jar 4.EJB Access Beansをapplication clientプロジェクトに移動します。ZIETransプロジェクトのEJB Access Beansを格納するIntegration Objectフォルダをapplication clientプロジェクトのappClientModuleディレクトリにコピーします。
ZIETransプロジェクトのEJB Access Beansが格納されているIntegration Objectフォルダをapplication clientプロジェクトの appClientModule ディレクトリにコピーします。
コンピュータのスクリーンショット 自動生成された説明
図2:ZIETransプロジェクトからの依存関係にあるjarの追加とIntegrationオブジェクトのコピー
以下のスクリーンショットを参照してください。
図3:MainクラスでのEJBアクセスBeanのインスタンス化
詳細は以下の画面を参照してください。
図4:EJB参照名の追加
グラフィカル・ユーザー・インターフェース、テキスト、アプリケーション、電子メール 説明が自動的に生成されます。
図5:環境変数の追加
アプリケーション・クライアント・プロジェクトをエクスポートします。アプリケーション・クライアント・プロジェクトの名前を右クリックし、「エクスポート」を選択します。EAR ファイルとしてエクスポートします。
EAR ファイルを WebSphere の bin ディレクトリにコピーします。以下の場所です。
C:Program Files\WebSphere\AppServer%%bin
Application Types」→「WebSphere enterprise application」→「Install」を選択します。次へ」を選択し、以下のように 2 つのプロジェクトを追加します。
Graphical user interface, application Description automatically generated
図 6: WAS への EJB プロジェクトのインストール
JNDI 名を以下のように入力します。
com/ibm/HostPublisher/EJB/EJBProj_name
図 7:JNDI 名の入力
「次へ」をクリックし、WASにインストールします。
launchClient EAR_name -CCBootstrapPort=bootstrap_address_of_server
例: launchClient ZIETran_EAR.ear -CCBootstrapPort=2812
注:サーバーのブートストラップアドレスは、以下の場所で確認できます。
WebSphere application server > Server > communications > ports.
ZIETrans EJBについての理解を深め、EJBプロジェクトを作成するには、以下のZIETransのリンクを参照してください。
https://zietrans.hcldoc.com/help/index.jsp
参考までにアプリケーションプライアントのコードを添付しておきます。
Enabling CSRF and XSS protections in ZIETrans の翻訳版です。
HCL Z and I Emulator for Transformation での CSRF および XSS 保護の有効化
2021年12月8日
著者: Soumya Mallappa / Senior Software Engineer at HCL Software
クロスサイトリクエストフォージェリ(CSRF)とは、悪意のあるWebサイト、メール、ブログ、インスタントメッセージ、プログラムが、ユーザーのWebブラウザに、ユーザーが認証された信頼できるサイト上で望ましくないアクションを実行させることで発生する攻撃の一種です。例えば、この攻撃では、ユーザーのコンテキストで、資金の送金、パスワードの変更、アイテムの購入などが行われる可能性があります。
CSRFトークンと同一オリジンポリシーは、ZIETransでCSRF攻撃を防止する2つの異なる方法です。ユーザーは要件に応じて、これらのいずれか、または両方を選択することができます。
CSRFトークンとは、サーバーサイドのアプリケーションによって生成され、クライアントが発行する後続のHTTPリクエストに含めるためにクライアントに送信される、ユニークで予測不可能な秘密の値です。トークンが発行されると、サーバーは、クライアントからのリクエストに期待通りのトークンが含まれているかどうかをチェックします。トークンがない場合や無効な場合、そのリクエストは拒否されます。
同じオリジンポリシーにより、不正なオリジン/ウェブサイトから発信されたプロトコルを持たないURLから発信されたリクエストは破棄されます。
クロスサイトスクリプティング(XSS) は、クライアントサイドのコードインジェクション攻撃です。攻撃者は、正当なWebページやWebアプリケーションに悪意のあるコードを含めることで、被害者のWebブラウザで悪意のあるスクリプトを実行することを目的としています。ユーザーは、ZIETransプロジェクトでいくつかのXSSセキュリティパラメータを設定することで、ZIETransでこの攻撃を回避することができます。
このブログでは、ZIETransでどのようにCSRFとXSSから保護できるかを理解します。
`
図1: 同一生成元ポリシーおよびトークンベースの保護の有効化
変更内容を保存します。
「ナビゲーター」タブ >「Web Content」フォルダ >「Web-INF」フォルダを開きます。web.xml ファイルを開きます。
HatsCSRFValidationFilter」という記述を探します。target.origin "と "source.origin "のパラメータを、以下のようにお客様のZIETransのURLに更新してください。デフォルトでは、空白になっています。
<filter>
<description>このフィルターはcsrf攻撃を検証するために起動されます</description>
<display-name>HatsCSRFValidationFilter</display-name>
<filter-name>HatsCSRFValidationFilter</filter-name>
<filter-class>
com.ibm.hats.runtime.filters.HatsCSRFValidationFilter
</filter-class>
<async-supported>false</async-supported>
<init-param>
<param-name>source.origin</param-name>
<param-value>https://localhost:9083/ZIETrans/</param-value>
</init-param>
<init-param>
<param-name>target.origin</param-name>
<param-value>https://localhost:9083/ZIETrans/</param-value>
</init-param>
</filter>
URLをカンマで区切ることで、以下のようにparam-valueに複数のURLを指定することができます。
<param-value>https://localhost:9083/ZIETrans/, https://zietransapp.com/</param-value>
ZIETransのweb.xmlファイルを開き、以下のパラメータをNOからYESに更新します。デフォルトでは、これらのパラメーターはNOに設定されています。
<init-param>
<param-name>Content-Security-Policy</param-name>
<param-value>YES</param-value>
</init-param>
<init-param>
<param-name>X-XSS-Protection</param-name>
<param-value>YES</param-value>
</init-param>
<init-param>
<param-name>X-Content-Type-Options</param-name>
<param-value>YES</param-value>
</init-param>
``
2021年11月17日、HCL Software は、Eclipse Oxygen IDE をベースにした、Webアプリケーションやリッチクライアントアプリケーションを作成するための ZIETrans 2.0 の一般提供を開始しました。HCL ZIETrans 2.0 は、IBM z Systems プラットフォーム上で動作する 3270 アプリケーションや IBM i OS プラットフォーム上で動作する5250アプリケーションのAPI統合を可能にする、使いやすいグラフィカル・ユーザー・インターフェース (GUI) を提供します。詳細は以下をご覧ください。
HCL Software は 2021年11月17日、IBM System Z(メインフレーム)プラットフォーム上のソフトウェア資産を発見・監視するための市場をリードするソリューション HCL Z Asset Optimizer (ZAO) v2.1.1 の一般提供を発表しました。IBM/ISVのソフトウェア製品や社内のアプリケーションを管理するソリューションを探している場合でも、ZAO はそれらを効果的に管理するために必要なインサイトを提供します。
詳細は以下をご覧ください。
Z and I Emulator for Web Desktop Client の翻訳版です。
Z and I Emulator for Web Desktop Client
2021年11月23日
著者: Madhavi L / Software Developer at HCL Software
Z and I Emulator for Web (ZIEWeb) Desktop Client は、新しいZIEWebクライアントであり、ZIEWebでサポートされているすべてのクライアントプラットフォームにインストールすることができます。システムJREを使用する代わりに、ZIEWeb Desktop Clientは独自のOpenJDKを搭載しており、ZIEWebデスクトップをより速くロードします。これは、ZIEWebサーバに接続するために使用することができます。
備考
Windowsクライアントの場合、.msiパッケージがダウンロードされます。
RHELクライアントの場合、.rpmパッケージがダウンロードされます。
Ubuntuクライアントの場合は、Debianパッケージがダウンロードされます。
ZIEWebデスクトップクライアントをインストールした後、アプリケーションを起動すると、ユーザーには以下の2つのオプションを持つ "Welcome "ページが表示されます。
ユーザーがウェルカムページで「ローカルプロファイル」を選択すると、ZIEWebのローカルプロファイルが表示されます。ユーザーが以前にZIEWebローカルプロファイルを使用したことがあれば、全ての設定が読み込まれ、セッションはそのまま表示され、ユーザーは以前のように操作することができます。
ユーザーは、アクセスモードを変更したい場合、「ホーム」ボタンをクリックしてウェルカムページに戻ることができます。
ウェルカムページで「リモートプロファイル」を選択すると、ユーザーは設定ページに移動します。
設定ページでは、以下の情報を入力する必要があります。
次のページに移動するには、3つのフィールドすべてが必須です。すべてのフィールドが入力されていないと、「Next」ボタンは有効になりません。
注:「Web Server Port」フィールドでは、最大5桁の数字のみ入力可能です。
このページでは、ユーザーは2つのオプションから選択することになります。
選択したオプションに基づいて、リモートプロファイルは既存のHTMLページまたは設定ページに接続します。
キャンセル - 操作をキャンセルしてウィザードを閉じるプロンプトが表示されます。
戻る - 前のページに戻ることができます。
Next - 次のページに移動します。
事前に設定されたHTMLページで作業する」オプションを選択して「次へ」ボタンをクリックすると、リモートプロファイルは「最近開いたページ」セクションに、以前にアクセスしたページの履歴リストを最大10件まで表示します。ユーザーは、表示されたリストからページを選択するか、検索ボックスを使って必要なページを検索することができます。
必要なページを選択した後、「Next」ボタンをクリックすると、選択したページが起動し、このページに設定されているセッションに接続されます。
ユーザーが「サーバーに直接接続」を選択して「次へ」ボタンをクリックすると、「Z & I Emulator for Web」のログインページが表示され、ログイン資格情報を使用して設定されたセッションにログオンしたり、「ホーム」ページに戻ったりすることができます。
Modification of session properties dynamically in ZIE for Web Client の翻訳版です。
HCL ZIE for Web Client でセッションのプロパティを動的に変更する方法
2021年11月23日
著者: Vijayalakshmi / Lead Engineer at HCL Software
セッション定義は管理者によって定義されます。ユーザーは、HTMLパラメータを上書きすることで、クライアント側でセッション・プロパティを変更することができます。オーバーライドされた値は、管理者によって設定された初期のセッション・プロパティよりも優先されます。オーバーライドされたプロパティはロックされるので、ユーザーは変更できません。
オーバーライド可能な具体的なセッション・プロパティの一覧は以下のとおりです。
パラメータ名 | 説明 | 有効な値 |
Host | ターゲット・サーバーのホスト名またはIPアドレス。プロパティパネルでは「宛先アドレス」と表示されます。すべてのセッションタイプに適用されます。 | ホスト名またはIPアドレス |
HostBackup1 | backup1サーバーのホスト名またはIPアドレス。プロパティパネルには、backup1の「宛先アドレス」として表示されます。すべてのセッションタイプに適用されます。 | ホスト名またはIPアドレス |
HostBackup2 | バックアップ2サーバーのホスト名またはIPアドレス。プロパティパネルでは、backup2の「宛先アドレス」として表示されます。すべてのセッションタイプに適用されます。 | ホスト名またはIPアドレス |
Port | ターゲットサーバーが待ち受けているポート番号。プロパティパネルでは「送信先ポート」として表示されます。すべてのセッションタイプに適用されます。 | 任意の有効なTCP/IPポート番号です。 |
PortBackup1 | backup1サーバーが待ち受けているポート番号です。プロパティパネルには、backup1の「Destination port」として表示されます。すべてのセッションタイプに適用されます。 | 任意の有効なTCP/IPポート番号です。 |
PortBackup2 | backup2サーバーが待ち受けているポート番号です。プロパティパネルには、backup2の「Destination port(送信先ポート)」として表示されます。すべてのセッションタイプに適用されます。 | 任意の有効なTCP/IPポート番号です。 |
CodePage | セッションの接続先となるサーバーのコードページです。プロパティパネルには「Host Code-Page」と表示されます。FTP以外のすべてのセッションタイプに適用されます。 | セッションのプロパティパネルに表示されている、サポートされているホストコードページの数字部分(例:037)です。 |
LUName | ターゲットサーバーで定義された、このセッションの接続先となるLUまたはLUプールの名前です。プロパティパネルに「LUまたはプール名」として表示されます。3270 Displayおよび3270 Printerのセッションタイプに適用されます。 | LUまたはLUプールの名前です。 |
LUNameBackup1 | LUまたはプール名:このセッションの接続先となる、バックアップ1サーバーで定義されたLUまたはLUプールの名前です。プロパティパネルに、backup1の「LUまたはプール名」として表示されます。3270ディスプレイおよび3270プリンタのセッションタイプに適用されます。 | LUまたはLUプールの名前です。 |
LUNameBackup2 | LUまたはLUプールの名前。プロパティ・パネル上ではbackup2の “LU or Pool Name”として表示されます。 | LUまたはLUプールの名前です。 |
WorkstationID | このワークステーションの名前。プロパティパネルに「Workstation ID」と表示される。5250 Displayと5250 Printのセッションタイプに適用されます。 | このワークステーションの固有の名前。 |
ScreenSize | 画面の行数、列数を指定する。プロパティパネルに「画面サイズ」と表示されます。3270 Display、5250 Display、VT Displayのセッションタイプに適用されます。 | ・ value=rows x columns
・ 2=24×80 (3270, 5250, VT) ・ 3=32×80 (3270) ・ 4=43×80 (3270) ・ 5=27×132 (3270, 5250) ・ 6=24×132 (VT) ・ 7=36×80 (VT) ・ 8=36×132 (VT) ・ 9=48×80 (VT) ・ 10=48×132 (VT) ・ 11=72×80 (VT) ・ 12=72×132 (VT) ・ 13=144×80 (VT) ・ 14=144×132 (VT) ・ 15=25×80 (VT) ・ 16=25×132 (VT) ・ 17 = 62×160 |
管理者は、以下の3つの方法でセッションのプロパティを設定することができます。
1. 展開ウィザードでパラメータを設定する
2. セッションマネージャAPIを介してパラメータを設定する(以下のオプションのいずれかを使用)
A) json配列を作成して、以下のメソッドに渡します。例を示します。
Var hod_applet = new hod_session();
Var json_object = {“host”:”host_address”,”port”:”23”}
hod_applet.setHTMLParametersToOverride(json_object);
B) 以下の関数を繰り返し呼び出してjson配列を作成し、以下のAPIを使ってjsonオブジェクトをWebクライアント用のZIEに渡します。例を示します。
Var hod_applet = new hod_session();
hod_applet.setHTMLParametersToOverride(“HOST”,”HOST ADDRESS”);
hod_applet.setHTMLParametersToOverride (“port”,”12175”); etc
hod_applet.setHTMLParametersToOverride(); //最終的にはsetメソッドを呼び出します。
3. カスタムJSPコードの使用 (Custom UX)
テンプレートファイルで、hHod_AppletParams変数を更新し、すべてのカスタムパラメータを設定します。例を示します。
hHod_AppletParams[“host”] = “host_address”;
hHod_AppletParams[“port”] = “port_number”;
制限事項: 管理者が作成したJSON配列は、カスタムJSPでは動作しません。
Launching Z and I Emulator for Transformation in Japanese Language の翻訳版です。
HCL Z and I Emulator for Transformation の日本語環境での起動
2021年11月19日
著者: Tejaswini R / Developer at HCL Software
バージョン2.0から、ZIETransは以下のいずれかの方法でインストールできます。
"パッケージ配布/プラグインリポジトリともに、日本語を有効にするには、 ?vmargsの下に ?Duser.language=jaを追加する必要があります。"
注:ただし、OSのデフォルト言語が日本語の場合は、.iniファイルに-vmargsパラメータを設定する必要はありません。
注:パッケージ配布の場合は、ZIETrans.iniで以下のように日本語を設定してください。
図1:ZIETrans.iniに日本語を追加する
図2:日本語リポジトリの追加
グラフィカル・ユーザー・インターフェース、テキスト 説明が自動的に生成されます。
図3:日本語機能の選択
完了をクリックして、Babel日本語サポートアップデートサイトを日食にインストールします。
インストール後、変更を適用するためにeclipseを再起動してください。
製品が日本語で起動します。
図4:日本語での起動
注:Note: プラグイン・リポジトリでは、eclipse.iniファイルで日本語を有効にしてください。
図5: eclipse.iniに日本語サポートを追加する
Flexera configuration on ZIETrans の翻訳版です。
ZIETrans 上での Flexera の設定
2021年10月7日
著者: Sathiya priya / QA Engineer
ZIETrans Toolkit は、Eclipse ベースの IBM RationalR Software Delivery Platform (Rational SDP) 用のプラグインのセットで、IBMR System zR プラットフォーム上で実行される 3270 アプリケーションおよび IBM i オペレーティング・システム・プラットフォーム上で実行される 5250 アプリケーション用に、使いやすいグラフィカル・ユーザー・インターフェース (GUI) を提供する Web アプリケーションを作成することができます。
HCL ZIETransに統合されたZIETransプロジェクトのライセンス目的のためのライセンス・ツールはFlexeraであり、Flexera REST APIクライアントを使用してフローティング・ライセンス・モデルを提供しています。
HCL ZIETransのセッションとリクエストの使用状況は、Flexeraのライセンシングによって追跡され、付与されます。HCL ZIETrans アプリケーションでライセンスが機能するためには、Flexera サーバーと必要なランタイム・プロパティが事前に設定されている必要があります。
以下は、ZIE Trans で Flexera を構成するための手順です。
設定したサーバー上でプロジェクトを実行し、ユーザーは任意のブラウザを使用できます。
Flexera のコマンドを実行し、消費されたライセンスを確認します。
このFlexera の場所からコマンドプロンプトを開き、以下のコマンドを実行します。
flexnetlsadmin.bat -server