27.3 Configuration des services REST pour OpenText eDirectory

Procédez comme suit pour configurer les API REST pour OpenText eDirectory :

Téléchargez eDirAPI_<version>_Container.tar.gz à partir du portail de téléchargements et de licences de logiciels. Par exemple, eDirAPI_140_Container.tar.gz.

L'image doit être chargée dans le registre Docker local à l'aide des commandes suivantes :

tar -xvf eDirAPI_140_Container.tar.gz

docker load --input eDirAPI_140/eDirAPI_140.tar.gz

Créez un conteneur Docker à l'aide de la commande suivante :
```
docker create --name edirapi-container --volume <volume-name>:/config/ --network=<network-type> --env ACCEPT_EULA=Y edirapi:<version>
```
Exemple :
```
docker create --name edirapi-container --volume edirapi-volume:/config/ --network=host --env ACCEPT_EULA=Y edirapi:1.4.0.0000
```
REMARQUE :
- vous pouvez accepter l'accord de licence EULA en affectant la valeur Y à la variable d'environnement ACCEPT_EULA. Vous pouvez également accepter ce contrat dans l'invite qui s'affiche au démarrage du conteneur à l'aide de l'option -it de la commande Docker create en mode interactif.
- Le paramètre --volume de la commande ci-dessus crée un volume destiné au stockage des données de configuration et de journal. Dans ce cas, nous avons créé un exemple de volume nommé edirapi-volume.

Copiez le fichier de certificat de serveur (.pfx) de votre système de fichiers local vers le conteneur dans /etc/opt/novell/eDirAPI/cert/keys.pfx à l'aide de la commande suivante :

docker cp <absolute path of server certificate file> edirapi-container:/etc/opt/novell/eDirAPI/cert/keys.pfx

Exemple :

docker cp /home/user/keys.pfx edirapi-container:/etc/opt/novell/eDirAPI/cert/keys.pfx

Copiez le fichier de certificat d'autorité de certification (.pem) de votre système de fichiers local vers le conteneur dans /etc/opt/novell/eDirAPI/cert/SSCert.pem à l'aide de la commande suivante :
```
docker cp <absolute path of CA certificate file> edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert.pem
```
Exemple :
```
docker cp /home/user/SSCert.pem edirapi-container:/etc/opt/novell/eDirAPI/cert/SSCert.pem
```
Lorsque vous vous connectez à plusieurs arborescences OpenText eDirectory, vous devez veiller à obtenir un seul certificat CA pour toutes les arborescences connectées. Par exemple, si vous vous connectez à trois arborescences OpenText eDirectory, vous devez copier les trois certificats CA dans le conteneur 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
```
Copiez le fichier de configuration (edirapi.conf) de votre système de fichiers local vers le conteneur dans /etc/opt/novell/eDirAPI/conf/edirapi.conf à l'aide de la commande suivante :
```
docker cp <absolute path of CA certificate file> edirapi-container:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
Exemple
```
docker cp /home/user/edirapi.conf edirapi-container:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
REMARQUE :Pour déployer eDirAPI avec la désactivation d'une liaison anonyme, vous devez avoir les paramètres « ldapserver », « ldapuser » et « ldappassword » dans le fichier edirapi.conf.

Voici un exemple de fichier de configuration :
```
listen = ":9000"
pfxpassword = "novell"
bcert = "/etc/opt/novell/eDirAPI/cert/"
ospmode=false
edir-hosts = "<ip_address>:636"
```
REMARQUE :Pour accéder à OpenText eDirectory via OpenText Identity Console, il est nécessaire d'ajouter edir-hosts="x.x.x.x:ldaps_port" dans le fichier edirapi.conf.

Exemple

edir-hosts="10.10.10.10:636"
Démarrez le conteneur Docker à l'aide de la commande suivante :
```
docker start <edirapi-container-name>
```
Par exemple :
```
docker start edirapi-container
```

L'emplacement par défaut du fichier journal dans le conteneur REST sera /config/eDirAPI/var/log/. Les fichiers journaux suivants sont situés à cet emplacement :

container-startup.log
edirapi.log

REMARQUE :

Le certificat de l'autorité de certification du serveur REST doit commencer par BEGIN CERTIFICATE et se terminer par END CERTIFICATE. Si vous indiquez une autre valeur, le serveur REST affiche un message d'erreur.
Pour prendre en charge un nombre maximal de 42 000 connexions dans le conteneur REST, vous devez augmenter la plage de ports en exécutant les trois commandes suivantes :
```
ulimit -n 999999
cat /proc/sys/net/ipv4/ip_local_port_range
echo 1024 65535 > /proc/sys/net/ipv4/ip_local_port_range
```
Vous pouvez ignorer le message suivant dans le fichier journal de démarrage du conteneur :
```
Setting IDCONSOLEMODE from Environment to false
```