2021/12/8 - 読み終える時間: 6 分

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を使用する方法を理解します。

Javaアプリケーション・クライアントでのZIETrans EJB Access Beansの使用

EJB Access BeansをJavaアプリケーション・クライアントで使用するには、以下の手順に従います。

1. 1つまたは複数のマクロ、Integration Objects、およびその他のリソースを含むZIETrans EJBプロジェクトを作成します。Integrationオブジェクトを右クリックし、以下のようにEJB AccessビーンをZIETransプロジェクトにエクスポートします。

グラフィカル・ユーザー・インターフェース、アプリケーション 説明が自動的に生成される

図 1: EJB Access Bean の ZIETrans プロジェクトへのエクスポート

2. 新しいApplication clientプロジェクトを作成し、Mainクラスと展開記述子の生成を選択する。この新しいプロジェクトを、ZIETrans EJBプロジェクトと同じエンタープライズ・アーカイブ(EARファイル)に入れます。

3. 以下の jar ファイルをマニフェストファイルに依存する jar として追加します。

   • ZIETrans EJB プロジェクトの EJB .jar ファイル。
   • hatscommon.jar

4. 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オブジェクトのコピー

5. EJB Access Bean をインスタンス化して実行するコードを実装して、アプリケーション・クライアントで生成された Main クラスでテスト・クライアントを構築します。

以下のスクリーンショットを参照してください。

図3：MainクラスでのEJBアクセスBeanのインスタンス化

6. EJB参照と環境変数をクライアント展開記述子に追加します。

• META-INF\application-client.xmlを開きます。
• Application Client Descriptor Editorの Design タブで以下の操作を行います。
  • Add をクリックして、環境変数の追加を選択します。
    • Name: EJB Access Bean の HPUBEJB2_REFERENCE 文字列の最後の部分の値をこのフィールドにコピーします。例えば、「HPUBEJB2_REFERENCE1318657356」というようになります。
    • Type： java.lang.String
    • Value: ejb/ejb_project_name, ejb_project_nameはZIETransのEJBプロジェクトの名前です。
  • Add をクリックして、EJB リファレンスの追加を選択します。
    • EJB Reference name: ejb /ejb_project_name, where ejb_project_name is the name of your ZIETrans EJB project.
    • EJB Reference type: Session
    • Home： com.ibm.HostPublisher.EJB.HPubEJB2Home
    • Remote: com.ibm.HostPublisher.EJB.HPubEJB2
    • EJB link: ejb_project_name, ejb_project_name は ZIETrans EJB プロジェクトの名前です。

詳細は以下の画面を参照してください。

図4：EJB参照名の追加

グラフィカル・ユーザー・インターフェース、テキスト、アプリケーション、電子メール 説明が自動的に生成されます。

図5：環境変数の追加

7. ワークスペースを保存し、プロジェクトをクリーンアップします。

WebSphere Server 上でのアプリケーション・クライアントの実行

• アプリケーション・クライアント・プロジェクトをエクスポートします。アプリケーション・クライアント・プロジェクトの名前を右クリックし、「エクスポート」を選択します。EAR ファイルとしてエクスポートします。

• EAR ファイルを WebSphere の bin ディレクトリにコピーします。以下の場所です。

  C:Program Files\WebSphere\AppServer%%bin

3. この EAR を WebSphere サーバーにインストールします。WAS の管理コンソールを開き、以下を選択します。

Application Types」→「WebSphere enterprise application」→「Install」を選択します。次へ」を選択し、以下のように 2 つのプロジェクトを追加します。

Graphical user interface, application Description automatically generated

図 6: WAS への EJB プロジェクトのインストール

4. JNDI 名を以下のように入力します。

   com/ibm/HostPublisher/EJB/EJBProj_name

図 7：JNDI 名の入力

「次へ」をクリックし、WASにインストールします。

5. コマンドプロンプトを開き、ear がコピーされた bin フォルダにディレクトリを変更します。以下のコマンドを実行します。

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

参考までにアプリケーションプライアントのコードを添付しておきます。

アプリケーションクライアント

2021/12/8 - 読み終える時間: 3 分

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から保護できるかを理解します。

ZIETransでCSRF保護を有効にする手順

• ZIETrans ツールキットを開きます。
• Project settings > other tab > Client settingsに移動します。
• 要件に応じて「Enable same origin policy protection」または「Enable token based protection」を選択します。

`

図1: 同一生成元ポリシーおよびトークンベースの保護の有効化

4. 変更内容を保存します。

5. 「ナビゲーター」タブ ＞「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のXSS保護機能を有効にする手順

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/12/2 - 読み終える時間: ~1 分

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) を提供します。詳細は以下をご覧ください。

• 2021年11月17日: HCL Software、メインフレームソフトウェア ZIE for Transformation SOLUTION の最新版をリリース

2021/12/2 - 読み終える時間: ~1 分

HCL Software は 2021年11月17日、IBM System Z（メインフレーム）プラットフォーム上のソフトウェア資産を発見・監視するための市場をリードするソリューション HCL Z Asset Optimizer (ZAO) v2.1.1 の一般提供を発表しました。IBM/ISVのソフトウェア製品や社内のアプリケーションを管理するソリューションを探している場合でも、ZAO はそれらを効果的に管理するために必要なインサイトを提供します。

詳細は以下をご覧ください。

• 2021年11月17日: HCLソフトウェア、メインフレーム向けソフトウェア資産管理ソリューションの最新版をリリース

2021/11/24 - 読み終える時間: 5 分

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サーバに接続するために使用することができます。

• ローカルプロファイル - ローカルモードでは、ネイティブで独立したアプリケーションとして使用することができます。ユーザーは自分のセッションを作ることができます。
• リモートプロファイル - リモートモードでは、セッション定義が維持され、デプロイメントウィザードを使ってHTMLページが作成される集中型サーバーに接続できます。

備考

• ZIEWeb Desktop Clientのパネル(About PanelとJava console)内に表示されるバージョン番号は、ZIEWeb Desktop Clientのバージョンを示し、ZIEWeb Serverを示しません。
• ZIEWeb デスクトップクライアントのパッケージは、使用するクライアントの種類に基づいて、以下のようにユーザーのシステムにダウンロードされます。

Windowsクライアントの場合、.msiパッケージがダウンロードされます。

RHELクライアントの場合、.rpmパッケージがダウンロードされます。

Ubuntuクライアントの場合は、Debianパッケージがダウンロードされます。

ZIEWebデスクトップクライアントの使用

ZIEWebデスクトップクライアントをインストールした後、アプリケーションを起動すると、ユーザーには以下の2つのオプションを持つ "Welcome "ページが表示されます。

• ローカルプロファイル - ユーザーがZIEWebのローカルプロファイルにアクセスすることを可能にします。
• リモートプロファイル - HTMLベースのモデル、設定サーバーベースのモデル、及び複合モデルなどの管理者が管理するページにアクセスすることができます。

ローカルプロファイル

ユーザーがウェルカムページで「ローカルプロファイル」を選択すると、ZIEWebのローカルプロファイルが表示されます。ユーザーが以前にZIEWebローカルプロファイルを使用したことがあれば、全ての設定が読み込まれ、セッションはそのまま表示され、ユーザーは以前のように操作することができます。

ユーザーは、アクセスモードを変更したい場合、「ホーム」ボタンをクリックしてウェルカムページに戻ることができます。

リモートプロファイル

ウェルカムページで「リモートプロファイル」を選択すると、ユーザーは設定ページに移動します。

設定ページでは、以下の情報を入力する必要があります。

• Server Address - HTMLや設定ページが利用できるサーバーのアドレス。(例 - https://localhost)
• zie_alias は、公開ディレクトリのエイリアス（またはパス）です。
• Webサーバーポート - Webサーバーが設定されているポート番号です。

次のページに移動するには、3つのフィールドすべてが必須です。すべてのフィールドが入力されていないと、「Next」ボタンは有効になりません。

注：「Web Server Port」フィールドでは、最大5桁の数字のみ入力可能です。

ページタイプ

このページでは、ユーザーは2つのオプションから選択することになります。

選択したオプションに基づいて、リモートプロファイルは既存のHTMLページまたは設定ページに接続します。

• 事前に設定されたHTMLページと連携
• サーバーに直接接続する

ウィザードボタン

• キャンセル - 操作をキャンセルしてウィザードを閉じるプロンプトが表示されます。

• 戻る - 前のページに戻ることができます。

• Next - 次のページに移動します。

事前に設定されたHTMLページとの連携

事前に設定されたHTMLページで作業する」オプションを選択して「次へ」ボタンをクリックすると、リモートプロファイルは「最近開いたページ」セクションに、以前にアクセスしたページの履歴リストを最大10件まで表示します。ユーザーは、表示されたリストからページを選択するか、検索ボックスを使って必要なページを検索することができます。

必要なページを選択した後、「Next」ボタンをクリックすると、選択したページが起動し、このページに設定されているセッションに接続されます。

サーバーに直接接続する

ユーザーが「サーバーに直接接続」を選択して「次へ」ボタンをクリックすると、「Z & I Emulator for Web」のログインページが表示され、ログイン資格情報を使用して設定されたセッションにログオンしたり、「ホーム」ページに戻ったりすることができます。

制限事項

• Linuxベースのオペレーティングシステムにインストールした場合、デスクトップ上のZIEWeb Desktop Clientショートカットは作成されません。
• ZIEWebデスクトップクライアントは64ビットのオペレーティングシステムでのみ動作します。
• ユーザーが入力したサーバーアドレス、エイリアス、ポート番号は検証されません。詳細が正しければ、そのページが表示されます。そうでない場合は、適切なエラーがユーザーに表示されます。

2021/11/24 - 読み終える時間: 4 分

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パラメータを上書きすることで、クライアント側でセッション・プロパティを変更することができます。オーバーライドされた値は、管理者によって設定された初期のセッション・プロパティよりも優先されます。オーバーライドされたプロパティはロックされるので、ユーザーは変更できません。

オーバーライド可能な具体的なセッション・プロパティの一覧は以下のとおりです。

セッションのプロパティを変更する手順

管理者は、以下の3つの方法でセッションのプロパティを設定することができます。

1. 展開ウィザードでパラメータを設定する

• HTMLパラメータEnableHTMLOverridesを設定し、trueにする。(DWの[詳細オプション]→[HTMLパラメータ]で設定します)。
• HTMLパラメータTargettedSessionListに、オーバーライドを受け付けるセッションの正確な名前を値として入れます。(DWの「詳細オプション」→「HTMLパラメータ」)。

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メソッドを呼び出します。

• 制限事項: セッションマネージャーAPI(Application Programming Interfaces)では、自動開始セッションでは動作しません。

3. カスタムJSPコードの使用 (Custom UX)

テンプレートファイルで、hHod_AppletParams変数を更新し、すべてのカスタムパラメータを設定します。例を示します。

hHod_AppletParams[“host”] = “host_address”;
hHod_AppletParams[“port”] = “port_number”;

制限事項: 管理者が作成したJSON配列は、カスタムJSPでは動作しません。

2021/11/22 - 読み終える時間: 3 分

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は以下のいずれかの方法でインストールできます。

• パッケージ配布: パッケージ配布：ZIETransおよび依存するすべてのツールがインストールされたeclipseを含む。
• プラグインリポジトリ: Eclipse（バージョン名：Oxygen）が既にインストールされている場合、ZIETransのプラグイン・リポジトリを使用して、必要なZIETransツールキットをインストールすることができます。WDT、JBoss、EMF、Window Builderなどの依存するプラグインは、ZIETransと一緒にインストールする必要があります。

"パッケージ配布/プラグインリポジトリともに、日本語を有効にするには、 ?vmargsの下に ?Duser.language=jaを追加する必要があります。"

注：ただし、OSのデフォルト言語が日本語の場合は、.iniファイルに-vmargsパラメータを設定する必要はありません。

注：パッケージ配布の場合は、ZIETrans.iniで以下のように日本語を設定してください。

図1：ZIETrans.iniに日本語を追加する

ZIETrans.iniに日本語を追加する手順は以下の通りです

1. https://archive.eclipse.org/technology/babel/index.php にアクセスしてください。
2. Babel Language Pack Update Site for Oxygen」-R0.16.0をダウンロードします。
3. eclipseの「Help」→「Install new Software」をクリックします。
4. 「Add」をクリックして、リポジトリの「Name」を指定し、「OK」をクリックします。

図2：日本語リポジトリの追加

5. 検索ボックスで日本語のテキストをフィルタリングします。

グラフィカル・ユーザー・インターフェース、テキスト 説明が自動的に生成されます。

図3：日本語機能の選択

6. 完了をクリックして、Babel日本語サポートアップデートサイトを日食にインストールします。

7. インストール後、変更を適用するためにeclipseを再起動してください。

8. 製品が日本語で起動します。

図4：日本語での起動

注：Note: プラグイン・リポジトリでは、eclipse.iniファイルで日本語を有効にしてください。

図5: eclipse.iniに日本語サポートを追加する

2021/10/7 - 読み終える時間: 2 分

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 を構成するための手順です。

前提条件

• ユーザーは HCL ZIETrans をインストールし、ツールキットに ZIETrans プロジェクトを作成する必要があります。
• ツールキットで WAS、WebSphere Liberty Profile、JBOSS などのサポートされているアプリケーションサーバーを構成します。

• Project.ear の runtime.properties ファイルで、「Flexera Server URL」と「Private key path」を設定します。アプリケーションをデバッグ・モードで実行する場合は、ランタイム・デバッグ・プロパ ティ・ファイルで同じ設定を行います。
• flx_PrivateKey_Absolute_Path= Drive\: \PrivateKey.pem
• flx_ServerURL=https\:///Feature ID

• 設定したサーバー上でプロジェクトを実行し、ユーザーは任意のブラウザを使用できます。

  

• Flexera のコマンドを実行し、消費されたライセンスを確認します。

このFlexera の場所からコマンドプロンプトを開き、以下のコマンドを実行します。

flexnetlsadmin.bat -server -authorize -licenses -verbose