27.3 OpenText eDirectory用の RESTサービスの設定

OpenText eDirectory向けのREST APIを設定するには、次の手順を実行します。

ソフトウェアライセンスおよびダウンロードポータルからeDirAPI_<バージョン>_Container.tar.gzをダウンロードします。たとえば、eDirAPI_140_Container.tar.gzのようになります。
次のコマンドを使用して、そのイメージをDockerのローカルレジストリにロードする必要があります。
```
tar -xvf eDirAPI_140_Container.tar.gz              
```
```
docker load --input eDirAPI_140/eDirAPI_140.tar.gz
```
次のコマンドを使用して、Dockerコンテナを作成します。
```
docker create --name edirapi-container --volume <volume-name>:/config/ --network=<network-type> --env ACCEPT_EULA=Y edirapi:<version>
```
次に例を示します。
```
docker create --name edirapi-container --volume edirapi-volume:/config/ --network=host --env ACCEPT_EULA=Y edirapi:1.4.0.0000
```
メモ:
- ACCEPT_EULA環境変数をYに設定することによって、EULAに同意することができます。対話型モードのDocker createコマンドで-itオプションを使用することにより、コンテナの起動中に画面のプロンプトからEULAに同意することもできます。
- 上のコマンドの--volumeパラメータによって、環境設定データとログデータを保存するボリュームが作成されます。本書では、edirapi-volumeというサンプルボリュームを作成しました。
次のコマンドを使用して、ローカルファイルシステムからコンテナの/etc/opt/novell/eDirAPI/cert/keys.pfxに、サーバ証明書ファイル(.pfx)をコピーします。
```
docker cp <absolute path of server certificate file> edirapi-container:/etc/opt/novell/eDirAPI/cert/keys.pfx
```
次に例を示します。
```
docker cp /home/user/keys.pfx edirapi-container:/etc/opt/novell/eDirAPI/cert/keys.pfx
```
次のコマンドを使用して、ローカルファイルシステムからコンテナの/etc/opt/novell/eDirAPI/cert/SSCert.pemに、認証局証明書ファイル(.pem)をコピーします。
```
docker cp <absolute path of CA certificate file> edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert.pem
```
次に例を示します。
```
docker cp /home/user/SSCert.pem edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert.pem
```
複数のOpenText eDirectoryツリーに接続する場合は、すべての接続ツリーに対して個々の認証局証明書を取得する必要があります。たとえば、3つのeDirectoryツリーに接続する場合、3つすべての認証局証明書をDockerコンテナにコピーする必要があります。
```
docker cp /home/user/SSCert.pem edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert.pem
docker cp /home/user/SSCert1.pem edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert1.pem
docker cp /home/user/SSCert2.pem edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert2.pem
```
次のコマンドを使用して、ローカルファイルシステムからコンテナの/etc/opt/novell/eDirAPI/conf/edirapi.confに、環境設定ファイル(edirapi.conf)をコピーします。
```
docker cp <absolute path of CA certificate file> edirapi-container:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
例:
```
docker cp /home/user/edirapi.conf edirapi-container:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
メモ:匿名バインドを無効にしたeDirAPIを展開するには、edirapi.confファイルに"ldapserver"、"ldapuser"、および"ldappassword"パラメータが必要です。

サンプルの環境設定ファイルを以下に示します。
```
listen = ":9000"
pfxpassword = "novell"
bcert = "/etc/opt/novell/eDirAPI/cert/"
ospmode=false
edir-hosts = "<ip_address>:636"
```
メモ:OpenText Identity ConsoleからOpenText eDirectoryにアクセスするには、「edir-hosts="x.x.x.x:ldaps_port"」をedirapi.confファイルに追加する必要があります。

例:

edir-hosts="10.10.10.10:636"
次のコマンドで、Dockerコンテナを起動します。
```
docker start <edirapi-container-name>
```
次に例を示します。
```
docker start edirapi-container
```

RESTコンテナ内のデフォルトのログファイルの場所は、/config/eDirAPI/var/log/です。この場所には、次のログファイルがあります。

container-startup.log
edirapi.log

メモ:

RESTサーバの認証局証明書は、BEGIN CERTIFICATEで始まり、END CERTIFICATEで終わる必要があります。それ以外の値を指定した場合は、RESTサーバはエラーメッセージを表示します。
RESTコンテナ内で最大42000の接続をサポートするには、次の3つのコマンドを実行して、ポートの範囲を拡大する必要があります。
```
ulimit -n 999999
cat /proc/sys/net/ipv4/ip_local_port_range
echo 1024 65535 > /proc/sys/net/ipv4/ip_local_port_range
```
コンテナ起動ログファイルでは、次のメッセージを無視できます。
```
Setting IDCONSOLEMODE from Environment to false
```