製品をチェック

HCL Domino Driver の30日間無償トライアルをダウンロード

 ダウンロードはこちら

製品の詳細

HCL Domino アイコン HCL Domino JDBC Driver 相談したい

HCL Domino に連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

IntelliJ からHCL Domino データに連携

IntelliJ のウィザードを使用してHCL Domino への接続を統合します。

加藤龍彦
ウェブデベロッパー

最終更新日:2022-04-25
domino ロゴ

CData

jdbc ロゴ画像
IntelliJ ロゴ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for Domino を使用することで、JDBC データソースとしてHCL Domino にアクセスでき、IDE の迅速な開発ツールとの統合が可能になります。この記事では、データソース構成ウィザードを使用してIntelliJ のHCL Domino に接続する方法を示します。

JBDC Data Source for Domino の作成

以下のステップに従ってドライバーJAR を追加し、HCL Domino への接続に必要な接続プロパティを定義します。

  1. [Data Sources]ウィンドウで右クリックし、[Add Data Source]->[DB Data Source]と進みます。
  2. 表示される[Data Source Properties]ダイアログでは、次のプロパティが必要です。

    • JDBC Driver Files:このメニューの隣にあるボタンをクリックし、インストールディレクトリのJDBC ドライバーファイル(cdata.jdbc.domino.jar)を追加します。
    • JDBC Driver Class:このメニューで、リストからcdata.jdbc.domino.Domino ドライバーを選択します。
    • Database URL:JDBC URL プロパティで接続URL を入力します。URL は、jdbc:domino: で始まり、セミコロンで区切られた接続プロパティが含まれています。

      Domino 接続プロパティの取得・設定方法

      接続の前に

      CData 製品を経由してDomino に接続するには、「Proton コンポーネント」のインストールが必要です。通常、 Proton はAppDev パックの一部として配布されています。Proton またはAppDev パックの入手およびインストール方法については、HCL のドキュメントを参照してください。

      CData 製品は匿名アクセス、またはクライアント証明書の提供によりProton を認証できます。 これらのオプションは両方ともDomino で特定の設定が必要です。

      次の2セクションでは、接続に必要な事前設定について説明します。使用したい認証方法に対応するセクションを参照してください。

      クライアント証明書による認証の設定

      クライアント証明書による認証では、CData 製品は専用のユーザーアカウントとして接続します。このユーザーには、接続するすべてのデータベースに対するdesigner またはそれ以上のアクセス権が付与する必要があります。

      また、CData 製品を使用するためにはユーザーがインターネット証明書を取得する必要があります。サーバーコンソールで以下のコマンドを実行することで、Proton にこの証明書を作成させることができます。 APPUSER はCData 製品でアクセス設定するユーザーアカウント名、ADMINISTRATOR は証明書を受け取るユーザー名です。

      load proton --setupclient "APPUSER" --sendto "ADMINISTRATOR"

      新しい証明書は、Notes のADMINISTRATOR メールボックスから利用できます。証明書は、クライアント証明書(clientcert)およびキー(clientkey)の2ファイルに分けて送信される場合があります。 キーファイルのテキストを証明書ファイルの末尾にコピーアンドペーストして、2つのファイルを結合する必要があります。

      匿名認証の設定

      匿名アクセスでは、CData 製品はAnonymous という一般的なユーザーアカウントで接続します。 接続するすべてのデータベースには、次の2つの権限が設定される必要があります。

      • Anonymous ユーザーには、designer またはそれ以上のデータベースへのアクセス権が付与される必要があります。
      • データベースは、Maximum Internet name and password オプションがdesigner またはそれ以上のアクセスに設定される必要があります。 この設定は、データベースのAccess Control List オプションのAdvanced タブにあります。

      Domino への接続

      接続するには以下を設定します。

      • Server:Proton サービスを使ってDomino を実行中のサーバーのIP アドレス。
      • Port:Proton サービスがリッスンしているポート番号。
      • Database:.nsf 拡張子を含むデータベースファイル名。
      • SSLServerCert:サーバーが受け入れ可能なTLS/SSL 証明書に設定。コンピュータによって信頼されていない他の証明書はすべて拒否されます。または、"*" を設定するとすべての証明書を受け入れます。

      Domino への認証

      CData 製品は、クライアント証明書を使用してProton に認証することも、匿名アクセスで認証することも可能です。

      クライアント証明書による認証

      クライアント証明書で認証するには以下を設定します。

      • AuthSchemeSSLCertificate に設定。
      • SSLClientCertType:これは、証明書ファイルの形式と一致する必要があります。 通常、.pem 証明書の場合はPEMKEY_FILE、.pfx 証明書の場合はPFXFILE のいずれかになります。
      • SSLClientCert:証明書ファイルへのパス。

      匿名認証

      匿名認証を使用するには、AuthSchemeAnonymous に設定します。

      ビルトイン接続文字列デザイナ

      JDBC URL の構成については、HCL Domino JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

      java -jar cdata.jdbc.domino.jar

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。

      Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

      以下は一般的なJDBC URL です。

      jdbc:domino:Server=https://domino.corp.com;Database=names.nsf;Port=3002;SSLClientCertType=PEMKEY_FILE;SSLClientCert=full_path_of_certificate.pem;SSLServerCert=*
The JDBC data source.(Salesforce is shown.)

HCL Domino データの編集・保存

スキーマ情報を見つけるには、作成したデータソースを右クリックし、[Refresh Tables]をクリックします。 テーブルを右クリックし、[Open Tables Editor]をクリックして、テーブルをクエリします。

The results of a query in IntelliJ.(Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。