Cover Image

Domino 管理者が Domino REST API について知っておくべきこと

2023/11/14 - 読み終える時間: 3 分

Domino Administrators - What You Need to Know About the Domino REST API の翻訳版です。

Domino 管理者が Domino REST API について知っておくべきこと

2023年10月27日

著者: Heather J Hottenstein / Technical Advisor

HCL Domino REST API は、外部システムが Domino アプリケーションデータに安全にアクセスする機能を提供します。また、開発者が好みのプログラミング言語を使用できるため、Domino との対話に必要なスキルセットが広がります。最終的に、Domino REST API は Domino アプリケーションの拡張、モダナイズ、変換を可能にします。

Domino REST API によって提供される機能は、アプリケーション開発に重点を置く人向けであることは事実ですが、Domino 管理者もこの新しい追加機能を理解する必要があります。管理者はサービスを保護するのが仕事です。Domino REST API は Domino サーバー上で実行されるため、それが適切にインストールされ、 設定され、監視されていることを確認するのは管理者の責任となります。

Domino REST APIは、Windows、Linux、またはDocker/Kubernetesコンテナ上で動作するDomino 12.0.2+サーバー上で実行されます。他のHCLSoftwareと同様に、HCL License and Download Portal にアクセスして、それぞれのプラットフォーム用のHCL Domino REST APIをダウンロードしてください。

ダウンロード・パッケージは tar.gz 形式で、圧縮ファイル形式です。ファイルを解凍する必要があります。例えば、7-Zip を使用する Windows OS では、次のようにします。

  • Windowsエクスプローラを開く
  • ダウンロードしたファイルをマウスで右クリックし、7-Zip -> Extract files を選択する。
  • 必要に応じてダイアログボックスのオプションを更新し、OKを押します。
  • ファイルを解凍したフォルダを開きます。
  • 抽出された.tarファイルについて、ステップ2-3を繰り返します。

restapiInstall-r12.jar ファイルはインストーラーファイルです。このファイルを Domino サーバーのプログラムフォルダー、つまり nserver.exe があるフォルダーにコピーします。

Windows サーバーに Domino REST API をインストールするには、管理者として Windows CMD プロンプトを実行し、ディレクトリを Domino プログラムフォルダーに変更して次のコマンドを実行します。

java -jar c:\domino\restapiinstall-r12.jar -d="C:\Domino\Data" -i="C:\Domino\notes.ini" -r= C:\Domino\restapi" -p="C:\Domino\restapi" -a

注:上記のパスを Domino サーバー上のパスに変更します。すべてのオプションのリストについては、以下のドキュメントを参照してください。

Domino RESTAPI のインストール (英語)

以下をインストールの一部として Domino サーバーに追加します。

\Domino REST API JAR ファイルが含まれているフォルダ
Notes.ini の更新
    ServerTasks=restapi
    KeepInstallDir=C:\Domino\restapi
    KeepManagementURL=http://localhost:8889

以下の 3 つの Domino データベースとそれぞれのテンプレートが Domino Data フォルダにインストールされます。

* Domino Keep 構成 (keepconfig.nsf)
* Domino Keep エージェントスケジュール (keepagents.nsf)
* Domino Keep OAuth (oauth.nsf)

注:Domino REST API のコンポーネント、設定、ログに KEEP への参照があります。

KEEP は Domino REST API の元のプロジェクト名です。

さらに、インストーラーは Domino REST API を起動し、nrestapi.exe を使用して Domino サーバー上のタスクとして実行します。

画像の説明

他の Domino サーバータスクと同様に、Domino サーバーコンソールで 'tell restapi action' を発行して Domino REST API と対話できます。例えば、'tell restapi help' は利用可能なアクションを出力する。

画像の説明

tell restapi status'を発行すると、サーバー・コンソールに restapi タスクに関する情報が書き込まれる。

画像の説明

この紹介を楽しみ、Domino REST API の基礎的なコンポーネントについて学んでいただけたなら幸いです。次回 は、Domino REST API を適切に設定し、セキュアにするために必要な手順を学びます。

このブログについて

HCL Japan の Software 部門の複数担当者で HCL Software 全般について記しています。

Tags

Academy Accelerate Accelerator Ambassador AoC AppDev Pack AppScan ASoC beta BigFix BigFix 9.5 BigFix_Wiki BigFix Workspace branding CAA Client Applicatin Access cloud Cloud Apps Cloud Native Commerce Common Local License Server community companion Compass compliance Connections Connections 6.5 ConnectionsDocs Connnections CVE-2021-44228 developerWorks DevOps DevOps Code ClearCase DevOps Deploy DevOps.Launch.AppScan DevOps Model RealTim DevOps Test DevOps Velocity Digital Experience document Doino Volt Domino Domino AppDev Pacl Domino Leap Domino Volt Domino管理者アップデート認定試験対策 DQL DRYiCE dW dx Enterprise Integrator event fix fix_list fixlist forum General guide HCAA HCL Ambassador HCL Ambassadors HCL Domino REST API HCL OneTest Embedded HCL Z and I Emulator HCL Z and I Emulator for Transformation HCLSoftware U hints_and_tips history HTMO IBM_i ID_Vault iNotes ios ios13 ipad iPhone IZSAM KEEP Launch Launch.DevOps Leap Link logo MarvelClient mobile mui nds2019 ndv12beta News Noets/Domino Nomad Nomad Mobile Nomad Web Notes Notes/Domino Notes/Domino 10 Notes/Domino 11 notes-domino-9-10-limited-supportability-as-of-202204 Notes/Domino V12 Notes/Domion Notes/Domno notescons Now on_premises OneDB OneTest OnTime osaka press_release relay REST RTist SafeLinx Sametime Sametime 11 SoFy support survey system_requirement techtek Traveler Traveler 10 Traveler for Microsoft Outlook traveler.zip Unica Unica Discover Unica Interact UrbanCode Deploy UrbanCode Velocity v11 V12 Verse Verse Mobile Verse On-Premises VersionVault Volt Volt MX Volt MX Go Volt MX サンプルアプリ Webinar win7 Wordload Automation Workload Automation youtube Z Z Abend Investigator Z and I Emulator Z and I Emulator for Transformation Z and I Emulator for Web Z and I Emulator for Web Client Z Asset Optimizer Z Data Tools Z Software Asset Manager ZAI ZAO ZIE ZIE for Transformation ZIE for Web ZIE for Windows ZIET ZIETrans ZIEWeb うるう年 イベント ウェビナー ガイド クラウド クラウド終了 サイジング サポート サポート技術情報 サポート期間 サポート終了 セキュリティ セキュリティー セキュリティー脆弱性 セミナー ダイバーシティー ダウンロード テクてく テクてく Lotus 技術者夜会 ニュース ノーツコンソーシアム バージョンアップ パフォーマンス パートナー ベータ ポートフォリオ ライセンス 九州地区 Notes パートナー会 互換性 出荷日 各種ご案内資料 研修