2.2 Installation d’OpenText Identity Console 1.8 et versions antérieures

2.2.1 Installation d'OpenText Identity Console en mode autonome (non-Docker)

Vous pouvez installer OpenText Identity Console de l’une des manières suivantes :

REMARQUE :Il est recommandé d’installer OpenText Identity Console et OpenText eDirectory sur la même machine, avec au moins une instance d’OpenText eDirectory disponible.

Exécution d'une installation interactive

Cette section traite de l’installation d’OpenText Identity Console en mode autonome à l’aide de la méthode d’installation interactive.

  1. Connectez-vous au portail de téléchargements et de licences de logiciels (Software License and Download) et accédez à la page de téléchargements de logiciels.

  2. Sélectionnez les éléments suivants :

    • Produit : OpenText eDirectory

    • Nom du produit : OpenText eDirectory per User Sub SW E-LTU

    • Version : 9.2

  3. Téléchargez et extrayez la dernière version d’OpenText Identity Console.

  4. Accédez au répertoire d'où vous avez extrait la version d'Identity Console > IdentityConsole_<version>_Linux.

  5. Exécutez la commande suivante lorsque vous êtes connecté en tant qu'utilisateur root ou équivalent :

    ./identityconsole_install

  6. Lisez l'introduction, puis cliquez sur ENTER (ENTRÉE).

  7. Entrez y pour accepter le contrat de licence. Tous les paquetages RPM requis sont alors installés sur votre système.

  8. Entrez le nom d'hôte (nom de domaine complet) ou l'adresse IP du serveur Identity Console. Par exemple, 10.10.33.100

    Si vous appuyez sur Entrée sans spécifier d’adresse IP, l’adresse IP/le nom d’hôte de votre système est utilisé par défaut.

  9. Entrez le numéro de port d'écoute d'Identity Console. La valeur par défaut est 9000.

  10. (Conditionnel) En fonction de vos besoins, effectuez l'une des opérations suivantes :

    • Si vous ne souhaitez pas intégrer OSP à Identity Console, choisissez n et passez à l'Étape 11.

    • Si vous souhaitez intégrer OSP à Identity Console, choisissez y et fournissez des entrées pour les étapes suivantes :

      1. Entrez le nom de domaine/l'adresse IP du serveur eDirectory/Coffre-fort d'identité avec le numéro de port LDAPS.

        Par exemple :

        192.168.1.1:636

      2. Entrez le nom d'utilisateur eDirectory/Coffre-fort d'identité.

        Exemple :

        cn=admin,ou=org_unit,o=org

      3. Entrez le mot de passe eDirectory/Coffre-fort d'identité.

      4. Entrez de nouveau le mot de passe eDirectory/Coffre-fort d'identité pour le confirmer.

      5. Entrez le nom de domaine/l'adresse IP du serveur OSP avec le numéro de port SSL du serveur SSO.

      6. Entrez l’identifiant et le mot de passe du client OSP.

      7. Entrez le nom de l'arborescence eDirectory/Coffre-fort d'identité.

  11. Spécifiez le paramètre eDirectory-hosts pour vous connecter. Vous pouvez fournir l’adresse IP ou le nom de domaine. Par exemple : localhost:636,xx.xx.xx.xx:636 ou edir.domain.com:636

    Si vous souhaitez qu'OpenText Identity Console se connecte à plusieurs arborescences OpenText eDirectory, entrez les adresses IP ou les noms de domaine en les séparant par des virgules.

    REMARQUE :Si vous souhaitez qu’OpenText Identity Console se connecte à plusieurs arborescences OpenText eDirectory, entrez les adresses IP ou les noms de domaine correspondants en les séparant par des virgules.

  12. (Conditionnel) Effectuez l'une des opérations suivantes pour importer le certificat CA :

    • Si vous souhaitez importer le certificat CA à partir du serveur, entrez y et appuyez sur Entrée. Entrez ensuite le nom de domaine/l'adresse IP du serveur eDirectory avec le numéro de port LDAPS.

      Par exemple : 10.10.10.10:636

    • Si vous ne souhaitez pas importer le certificat CA à partir du serveur, entrez n et appuyez sur Entrée. Indiquez manuellement le chemin de répertoire du certificat CA.

    • Si vous saisissez q, l'installation s'arrête.

  13. (Conditionnel) Effectuez l'une des opérations suivantes pour générer un certificat de serveur :

    • Si vous souhaitez générer le certificat de serveur, entrez y et appuyez sur Entrée. Fournissez des entrées pour les étapes suivantes :

      1. Entrez le nom de domaine ou l'adresse IP du serveur eDirectory avec le numéro de port LDAPS.

      2. Entrez le nom d'utilisateur eDirectory. Exemple : cn=admin,o=novell.

      3. Entrez le mot de passe d'utilisateur eDirectory.

      4. Entrez de nouveau le mot de passe d'utilisateur eDirectory.

      5. Entrez le nom du certificat de serveur.

        Exemple : servercert

      6. Entrez le mot de passe du certificat de serveur.

        Exemple : password@123

      7. Entrez de nouveau le mot de passe du certificat de serveur.

        Exemple : password@123

    • Si vous avez déjà un certificat de serveur à utiliser, entrez n et appuyez sur Entrée. Fournissez des entrées pour les étapes suivantes :

      1. Indiquez manuellement le chemin de répertoire du certificat de serveur.

        Par exemple, /home/cert/keys.pfx

      2. Entrez le mot de passe du certificat de serveur.

      3. Entrez de nouveau le mot de passe du certificat de serveur.

REMARQUE :

  • Vous trouverez les fichiers journaux suivants dans le répertoire /var/opt/novell/eDirAPI/log :

    • edirapi.log : ce fichier enregistre les événements edirapi et les problèmes de débogage.

    • edirapi_audit.log : ce fichier enregistre les événements d’audit edirapi. Les journaux respectent le format d'audit CEF.

    • identityconsole_install.log : ce fichier enregistre les événements OpenText Identity Console.

  • Vous pouvez vérifier les journaux des opérations de démarrage et d’arrêt d’OpenText Identity Console dans le fichier /var/log/messages.

  • Lorsque vous générez le certificat de l’autorité de certification et le certificat de serveur, veillez à exécuter le programme d’installation d’OpenText Identity Console à partir du répertoire IdentityConsole_<version>_Linux dans l’emplacement extrait.

  • En cas d’échec de l’installation, il n’est pas nécessaire de désinstaller l'instance OpenText Identity Console existante. En revanche, l’utilisateur peut exécuter la commande suivante :

    /usr/bin/identityconsoleConfigure

Utilitaires de génération des certificats

Vous avez la possibilité d’obtenir des certificats CA et de serveur pour d’autres arborescences à l’aide des outils ou utilitaires suivants.

REMARQUE :Les scripts du certificat CA et du serveur sont disponibles dans le chemin opt/novell/eDirAPI/sbin.

Générer un certificat CA

  1. Téléchargez et extrayez la dernière version d’OpenText Identity Console.

  2. Accédez au répertoire d'où vous avez extrait la version d'OpenText Identity Console > IdentityConsole_<version>_Linux.

  3. Exécutez la commande suivante lorsque vous êtes connecté en tant qu'utilisateur root ou équivalent.

    ./get_cacert

  4. Entrez l'adresse IP eDirectory avec le numéro de port LDAPS. Par exemple : 10.10.10.10:636.

Le ou les certificats racine approuvés sont copiés du serveur vers /tmp/SSCert.pem.

Générer un certificat de serveur

  1. Téléchargez et extrayez la dernière version d’OpenText Identity Console.

  2. Accédez au répertoire d'où vous avez extrait la version d'OpenText Identity Console > IdentityConsole_<version>_Linux.

  3. Exécutez la commande suivante lorsque vous êtes connecté en tant qu'utilisateur root ou équivalent.

    ./get_servercert <eDirectory IP address with LDAPS port number> <eDirectory/Identity Vault username> <userpassword> <server certificate name> <server certificate password> <path_of_CA _certificate with filename> <path of server certificate with filename>

    Exemple :

    ./get_servercert 10.10.10.10:636 cn=admin,ou=org_unit,o=org password keys password /var/opt/novell/eDirectory/data/SSCert.pem /home/user/keys.pfx

Installation silencieuse

L’installation en mode silencieux vous permet d’installer OpenText Identity Console sans aucune entrée interactive. Pour utiliser cette méthode, vous devez définir vos options d’installation d’OpenText Identity Console dans le fichier silent_properties, puis exécuter le processus d’installation à partir de la ligne de commande. Pour créer le fichier silent_properties, vous pouvez utiliser l’utilitaire create_silent_properties fourni avec OpenText Identity Console version 1.7.2 et ultérieures. Une fois le fichier de propriétés généré, le système utilise ses informations pour finaliser l’installation en mode silencieux.

Avant de lancer l’installation en mode silencieux, assurez-vous de respecter toutes les conditions préalables.

Pour générer le fichier des propriétés silencieuses :

  1. Accédez au répertoire IdentityConsole_<version>_Linux dans l’emplacement d'où vous avez extrait la version d’OpenText Identity Console.

  2. Exécutez la commande suivante pour utiliser l'utilitaire create_silent_properties :

    ./create_silent_properties

  3. Entrez le nom d'hôte ou l'adresse IP du serveur Identity Console. Par exemple, 10.0.0.1.

  4. Entrez le numéro de port sur lequel vous souhaitez qu'Identity Console écoute. Par exemple, 9000.

  5. (Conditionnel) En fonction de vos besoins, effectuez l'une des opérations suivantes :

    • Si vous ne souhaitez pas intégrer OSP à Identity Console, choisissez n et passez à l'étape 6.

    • Si vous souhaitez intégrer OSP à Identity Console, choisissez y et fournissez des entrées pour les étapes suivantes :

      1. Entrez le nom de domaine/l'adresse IP du serveur eDirectory/Coffre-fort d'identité avec le numéro de port LDAPS.

        Par exemple :

        192.168.1.1:636

      2. Entrez le nom d'utilisateur eDirectory/Coffre-fort d'identité.

        Exemple :

        cn=admin,ou=org_unit,o=org

      3. Entrez le mot de passe eDirectory/Coffre-fort d'identité.

      4. Entrez de nouveau le mot de passe eDirectory/Coffre-fort d'identité pour le confirmer.

      5. Entrez le nom de domaine/l'adresse IP du serveur OSP avec le numéro de port SSL du serveur SSO.

      6. Entrez l’identifiant et le mot de passe du client OSP.

      7. Entrez le nom de l'arborescence eDirectory/Coffre-fort d'identité.

  6. Entrez les noms d’hôte ou l’adresse IP du serveur eDirectory avec lesquels vous souhaitez qu’Identity Console établisse une connexion. Par exemple, 10.10.10.10:636.

  7. Entrez les noms d’hôte ou l’adresse IP du serveur eDirectory avec lesquels vous souhaitez qu’Identity Console établisse une connexion. Par exemple, 10.10.10.10:636.

  8. Entrez le le chemin de répertoire du certificat de serveur en incluant le nom de fichier. Par exemple, /home/cert/keys.pfx.

  9. Entrez le mot de passe du certificat de serveur.

  10. Entrez de nouveau le mot de passe du certificat de serveur.

    Le fichier silent_properties est généré correctement dans l'emplacement IdentityConsole_<version>_Linux.

Pour effectuer une installation en mode silencieux:

  1. Après avoir généré le fichier silent_properties, exécutez la commande suivante pour exécuter le programme d’installation en mode silencieux :

    ./identityconsole_install -s silent_properties

  2. Entrez le nom de domaine/l'adresse IP du serveur eDirectory avec le numéro de port LDAPS. Par exemple : 10.10.10.10:636

Vous trouverez les journaux relatifs à l’installation dans le fichier d’installation Identity Console > identityconsole_install.log.

Arborescences multiples avec OpenText Identity Console en mode autonome

Pour connecter OpenText Identity Console à plusieurs arborescences OpenText eDirectory, vous devez fournir l'adresse IP d'OpenText eDirectory et le port LDAPS en les séparant par des virgules dans le fichier edirapi.conf situé dans /etc/opt/novell/eDirAPI/conf/. En outre, vous devez copier les certificats de l’autorité de certification de toutes les arborescences OpenText eDirectory dans le répertoire /etc/opt/novell/eDirAPI/cert/.

Par exemple, pour connecter OpenText Identity Console à trois arborescences OpenText eDirectory, fournissez l’adresse IP au format suivant :

edir-hosts="10.0.0.1:636,10.0.0.2:636,10.0.0.3:636"

Copiez ensuite les certificats CA en procédant comme suit :

cp /home/user/SSCert1.pem /etc/opt/novell/eDirAPI/cert/SSCert1.pem
cp /home/user/SSCert2.pem /etc/opt/novell/eDirAPI/cert/SSCert2.pem
cp /home/user/SSCert3.pem /etc/opt/novell/eDirAPI/cert/SSCert3.pem

Exécutez l'une des commandes suivantes pour redémarrer OpenText Identity Console :

  • /usr/bin/identityconsole restart
  • systemctl restart netiq-identityconsole.service

Modification du certificat de serveur dans OpenText Identity Console en mode autonome

Pour modifier le certificat de serveur dans OpenText Identity Console en mode autonome, procédez comme suit :

  1. Exécutez NLPCERT pour stocker les clés:

    su - nds -c "LD_LIBRARY_PATH=/opt/novell/lib64/:/opt/novell/eDirectory/lib64/:/opt/netiq/common/openssl/lib64/ /opt/novell/eDirAPI/sbin/nlpcert -i /Expiredcert/noexpire/new-keys.pfx -o /etc/opt/novell/eDirAPI/conf/ssl/private/cert.pem"

  2. Redémarrez OpenText Identity Console :

    systemctl restart netiq-identityconsole.service

Arrêt et redémarrage d'OpenText Identity Console en mode autonome

  • Pour arrêter, exécutez l’une des commandes suivantes :

    /usr/bin/identityconsole stop

    ou

    systemctl stop netiq-identityconsole.service

  • Pour redémarrer, exécutez l’une des commandes suivantes :

    /usr/bin/identityconsole restart

    ou

    systemctl restart netiq-identityconsole.service

  • Pour démarrer, exécutez l’une des commandes suivantes :

    /usr/bin/identityconsole start

    ou

    systemctl start netiq-identityconsole.service

2.2.2 Installation d'OpenText Identity Console Workstation sous Windows

OpenText Identity Console (1.5 et versions ultérieures) peut être lancé sous Windows en tant que poste de travail et nécessite l'exécution des services REST. Par conséquent, lorsqu'il est lancé, un processus eDirAPI s'exécute à l'invite de commande edirapi.exe. Si vous fermez le terminal edirapi.exe, OpenText Identity Console ne fonctionnera plus.

La procédure ci-dessous explique comment exécuter OpenText Identity Console sous Windows.

  1. Connectez-vous au portail de téléchargements et de licences de logiciels (Software License and Download) et accédez à la page de téléchargements de logiciels.

  2. Sélectionnez les éléments suivants :

    • Produit : OpenText eDirectory

    • Nom du produit : eDirectory per User Sub SW E-LTU

    • Version : 9.2

  3. Téléchargez et extrayez le fichier IdentityConsole_<version>_workstation_win_x86_64.zip.

  4. Accédez au dossier extrait, installez NICI_w32 ou NICI_wx64 selon la configuration de votre système.

  5. (Conditionnel) Si vous avez déjà les fichiers keys.pfx et SSCert.pem que vous souhaitez utiliser, copiez-les manuellement dans le dossier cert situé dans C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert.

    Passez ensuite à l’étape 9.

  6. (Conditionnel) Si vous souhaitez générer le certificat CA, accédez au dossier eDirAPI, exécutez le fichier binaire get_cacert.exe dans PowerShell, situé dans C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI, et fournissez les détails suivants :

    • Nom de domaine/adresse IP du serveur eDirectory/Coffre-fort d'identité avec le numéro de port LDAPS.

    • Chemin d’accès au certificat racine approuvé CA avec le nom du certificat.

    Exemple

    get_cacert.exe 10.10.10.125:636 C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\SSCert.pem

    Un fichier SSCert.pem est généré.

  7. (Conditionnel) Si vous souhaitez générer le certificat de serveur, exécutez le fichier binaire d'aide get_servercert.exe via PowerShell en indiquant les détails suivants :

    • Nom de domaine/adresse IP du serveur eDirectory/Coffre-fort d'identité avec le numéro de port LDAPS.

    • Nom d’utilisateur eDirectory/Coffre-fort d’identité.

    • Mot de passe eDirectory/Coffre-fort d’identité.

    • Nom du certificat de serveur.

    • Mot de passe du certificat de serveur.

    • Chemin d’accès au certificat racine approuvé CA avec le nom du certificat.

    • Chemin d'accès au certificat racine approuvé serveur avec nom de certificat (keys.pfx est codé en dur).

    Exemple

    get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\SSCert.pem C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert\keys.pfx

    Un fichier keys.pfx est généré.

  8. Copiez manuellement les fichiers keys.pfx et SSCert.pem (générés à l’étape 6 et à l’étape 7) dans le dossier cert.

  9. Accédez au dossier extrait, double-cliquez sur le fichier configure.bat et entrez le mot de passe du certificat de serveur (keys.pfx) à l’invite de commande.

    REMARQUE :en cas de modification du certificat de serveur, réexécutez le fichier configure.bat avec le mot de passe du nouveau certificat.

  10. Accédez au dossier extrait et double-cliquez sur le fichier run.bat.

    Le terminal de processus eDirAPI (edirapi.exe) démarre, et la page de connexion d'Identity Console s'affiche.

REMARQUE :

  • Pour les connexions ultérieures à l'application OpenText Identity Console, double-cliquez sur run.bat. La page de connexion s'affiche.

    Si le terminal de processus eDirAPI (edirapi.exe) est déjà en cours d'exécution, exécutez identityconsole.exe à partir du dossier dans lequel la version est extraite.

  • Vous trouverez les journaux suivants dans \IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\log

    edirapi.log : ce fichier sert à consigner les différents événements dans edirapi et à déboguer les problèmes.

    edirapi_audit.log : ce fichier sert à consigner les événements d'audit d'edirapi. Ce journal respecte le format d'audit CEF.

  • Les connexions OSP ne sont pas prises en charge en mode Poste de travail.

  • OpenText Identity Console Workstation écoute le port 9000. Ne modifiez pas le fichier edirapi_win.conf.

Utilitaires de génération des certificats

Vous avez la possibilité d’obtenir des certificats CA et de serveur pour d’autres arborescences OpenText eDirectory à l’aide des utilitaires suivants.

REMARQUE :Les scripts du certificat CA et du serveur sont disponibles dans le chemin opt/novell/eDirAPI/sbin.

Générer un certificat CA

  1. Téléchargez et extrayez la dernière version d’OpenText Identity Console.

  2. Accédez au répertoire d'où vous avez extrait la version d'OpenText Identity Console. Exemple : C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI

  3. Exécutez le fichier binaire suivant à l’invite de commande.

    get_cacert.exe

  4. Fournissez l'adresse IP eDirectory et le numéro de port LDAPS.

    Exemple : get_cacert.exe 10.10.10.125:636

    Un fichier SSCert.pem est généré. Copiez le fichier SSCert.pem manuellement dans le dossier cert.

Générer un certificat de serveur

  1. Accédez au dossier d'où vous avez extrait la version d'OpenText Identity Console.

    Exemple : IdentityConsole_<version>_win

  2. Exécutez get_servercert.exe help pour obtenir d'autres options d’aide via l’invite de commande.

    • Nom de domaine/adresse IP du serveur eDirectory/Coffre-fort d'identité avec le numéro de port LDAPS.

    • Nom d’utilisateur eDirectory/Coffre-fort d’identité.

    • Mot de passe eDirectory/Coffre-fort d’identité.

    • Nom du certificat de serveur.

    • Mot de passe du certificat de serveur.

    • Chemin d’accès au certificat racine approuvé avec le nom du certificat.

      Pour générer le certificat de serveur, exécutez la commande suivante à l’invite de commande :

      Exemple :

      get_servercert.exe 10.10.10.125:636 cn=admin,o=novell novell keys novell SSCert.pem

      Un fichier keys.pfx est généré. Copiez le fichier keys.pfx manuellement dans le dossier cert.

Arborescences multiples avec OpenText Identity Console en mode Poste de travail

OpenText Identity Console permet de se connecter à plusieurs arborescences en obtenant un seul certificat CA de l'arborescence.

  1. Fermez OpenText Identity Console Workstation et le terminal eDirAPI.

  2. Copiez les certificats CA SSCert.pem à l'emplacement IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert.

    Par exemple, si vous souhaitez vous connecter à trois arborescences eDirectory, copiez respectivement les certificats CA en tant que SSCert1.pem, SSCert2.pem et SSCert3.pem.

  3. Accédez au dossier duquel la version est extraite, puis double-cliquez sur le fichier run.bat (fichier de traitement par lots Windows).

Fermeture et redémarrage d'OpenText Identity Console Workstation

Pour fermer l’application et le processus :

  1. Fermez l'application Windows de bureau OpenText Identity Console.

  2. Arrêtez le processus eDirAPI en fermant le terminal de processus eDirAPI.

Pour relancer OpenText Identity Console Workstation, accédez au dossier dans lequel la version est extraite, puis double-cliquez sur le fichier run.bat (fichier de traitement par lots Windows).

REMARQUE :si le terminal de processus eDirAPI est déjà en cours d'exécution, exécutez identityconsole.exe à partir du dossier dans lequel la version est extraite pour relancer OpenText Identity Console Workstation.

2.2.3 Installation d'OpenText Identity Console en tant que conteneur Docker

Reportez-vous à la section Installation d'OpenText Identity Console en tant que conteneur Docker.

2.2.4 Installation d'OpenText Identity Console dans Azure Kubernetes Service

Reportez-vous à la section Installation d'OpenText Identity Console dans Azure Kubernetes Service.