2.2 Installazione di OpenText Identity Console 1.8 e versioni precedenti

2.2.1 Installazione di OpenText Identity Console (non-Docker) come applicazione autonoma

È possibile installare OpenText Identity Console in uno dei seguenti modi:

NOTA:Si consiglia di installare OpenText Identity Console e OpenText eDirectory sullo stesso computer. È necessario che nel computer sia disponibile almeno un'istanza di OpenText eDirectory.

Esecuzione di un'installazione interattiva

In questa sezione viene illustrato come eseguire l’installazione di OpenText Identity Console come applicazione autonoma utilizzando il metodo di installazione interattiva.

  1. Eseguire il login al portale Software License and Download (Licenza software e download) e passare alla pagina per il download del software.

  2. Selezionare quanto segue:

    • Prodotto: OpenText eDirectory

    • Product Name (Nome prodotto): OpenText eDirectory per User Sub SW E-LTU

    • Version (Versione): 9.2

  3. Effettuare il download e l'estrazione dell'ultima build di OpenText Identity Console.

  4. Passare alla directory in cui è stata estratta la build di Identity Console > IdentityConsole_<version>_Linux.

  5. Eseguire il comando seguente dopo aver eseguito il login come utente root o equivalente:

    ./identityconsole_install

  6. Leggere l'Introduzione e fare clic su ENTER.

  7. Immettere y per accettare il contratto di licenza. Verranno installati tutti gli RPM necessari nel sistema.

  8. Immettere il nome host del server di Identity Console (FQDN)/l'indirizzo IP. Ad esempio, 10.10.33.100

    Se si preme Invio senza specificare un indirizzo IP, di default verrà utilizzato l'indirizzo IP o il nome host del sistema.

  9. Immettere il numero della porta di ascolto di Identity Console. Il valore di default è 9000.

  10. (Condizionale) A seconda delle proprie esigenze, eseguire una delle seguenti operazioni:

    • Se non si desidera integrare OSP con Identity Console, scegliere "n" e continuare con Passaggio 11.

    • Se si desidera integrare OSP con Identity Console, scegliere "y" e fornire gli input per i seguenti passaggi:

      1. Immettere il nome di dominio/l'indirizzo IP del server eDirectory/Identity Vault con il numero di porta LDAPS.

        Ad esempio:

        192.168.1.1:636

      2. Immettere il nome utente eDirectory/Identity Vault.

        Esempio:

        cn=admin,ou=org_unit,o=org

      3. Immettere la password di eDirectory/Identity Vault.

      4. Immettere nuovamente la password di eDirectory/Identity Vault per confermarla.

      5. Immettere il nome di dominio/indirizzo IP del server OSP con il numero di porta SSL del server SSO.

      6. Immettere l'ID client OSP e la password del client OSP.

      7. Immettere il nome dell'albero eDirectory/Identity Vault.

  11. Specificare gli host eDirectory da connettere. È possibile specificare l'indirizzo IP o il nome di dominio. Ad esempio: localhost:636,xx.xx.xx.xx:636 o edir.domain.com:636

    Se si desidera che OpenText Identity Console si connetta a più alberi eDirectory di OpenText, immettere i relativi indirizzi IP o nomi di dominio separati da virgole.

    NOTA:Se si desidera che OpenText Identity Console si connetta a più alberi OpenText eDirectory, immettere gli indirizzi IP o i nomi di dominio separati da virgole.

  12. (Condizionale) Per importare il certificato CA, eseguire una delle seguenti operazioni:

    • Se si desidera importare il certificato CA dal server, immettere "y" e premere Invio. Immettere quindi il nome di dominio/indirizzo IP del server eDirectory con il numero di porta LDAPS.

      Ad esempio: 10.10.10.10:636

    • Se non si desidera importare il certificato CA dal server, immettere "n" e premere Invio. Quindi, specificare manualmente il percorso della directory del certificato CA.

    • Se si immette "q", l'installazione verrà terminata.

  13. (Condizionale) Per generare un certificato del server, eseguire una delle seguenti operazioni:

    • Se si desidera generare il certificato del server, immettere "y" e premere Invio. Fornire gli input per i seguenti passaggi:

      1. Immettere il nome di dominio o l'indirizzo IP del server eDirectory con il numero di porta LDAPS.

      2. Immettere il nome utente eDirectory. Esempio: cn=admin,o=novell.

      3. Immettere la password dell'utente eDirectory.

      4. Immettere nuovamente la password dell’utente eDirectory.

      5. Immettere il nome del certificato server.

        Esempio: servercert

      6. Immettere la password del certificato server.

        Esempio: password@123

      7. Immettere nuovamente la password del certificato server.

        Esempio: password@123

    • Se si dispone già di un certificato del server che desidera utilizzare, immettere "n" e premere Invio. Fornire gli input per i seguenti passaggi:

      1. Specificare manualmente il percorso della directory del certificato del server.

        Ad esempio, /home/cert/keys.pfx

      2. Immettere la password del certificato server.

      3. Immettere nuovamente la password del certificato server.

NOTA:

  • Nella directory /var/opt/novell/eDirAPI/log sono disponibili i seguenti file di log:

    • edirapi.log - Questo file registra gli eventi edirapi e i problemi di debug.

    • edirapi_audit.log - Questo file registra gli eventi di revisione edirapi. I log seguono il formato di revisione CEF.

    • identityconsole_install.log - Questo file registra gli eventi di OpenText Identity Console.

  • È possibile controllare i log per le operazioni di avvio e arresto di OpenText Identity Console nel file /var/log/messages.

  • Quando viene generato il certificato CA e il certificato del server, assicurarsi di eseguire il programma di installazione di OpenText Identity Console dalla directory IdentityConsole_<version>_Linux nell'ubicazione di estrazione.

  • Se l'installazione non va a buon fine, non è necessario disinstallare l’installazione di OpenText Identity Console esistente, ma l'utente può eseguire il seguente comando:

    /usr/bin/identityconsoleConfigure

Utility per la generazione di certificati

È possibile ottenere certificati CA e certificati del server per altri alberi utilizzando i seguenti strumenti o utility.

NOTA:Gli script per il certificato CA e del server sono disponibili nel percorso opt/novell/eDirAPI/sbin.

Generazione del certificato CA

  1. Effettuare il download e l'estrazione dell'ultima build di OpenText Identity Console.

  2. Passare alla directory in cui è stata estratta la build di OpenText Identity Console > IdentityConsole_<version>_Linux.

  3. Eseguire il comando seguente dopo aver eseguito il login come utente root o equivalente.

    ./get_cacert

  4. Immettere l'indirizzo IP di eDirectory con il numero di porta LDAPS. Ad esempio: 10.10.10.10:636.

I certificati fonte attendibile sono stati copiati dal server in /tmp/SSCert.pem.

Generazione del certificato del server

  1. Effettuare il download e l'estrazione dell'ultima build di OpenText Identity Console.

  2. Passare alla directory in cui è stata estratta la build di OpenText Identity Console > IdentityConsole_<version>_Linux.

  3. Eseguire il comando seguente dopo aver eseguito il login come utente root o equivalente.

    ./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>

    Esempio:

    ./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

Installazione in modalità automatica

L'installazione in modalità automatica consente di installare OpenText Identity Console senza alcun input interattivo. Per utilizzare questo metodo, è necessario definire le opzioni per l'installazione di OpenText Identity Console nel file silent_properties, quindi eseguire il processo di installazione dalla riga di comando. Per creare il file silent_properties, è possibile utilizzare l'utility create_silent_properties fornita con OpenText Identity Console versione 1.7.2 e successive. Dopo aver generato il file delle proprietà, il sistema utilizza le relative informazioni per completare l'installazione in modalità automatica.

Prima di avviare l'installazione in modalità automatica, assicurarsi che siano soddisfatti tutti i prerequisiti.

Per generare il file delle proprietà in modalità automatica:

  1. Passare alla directory IdentityConsole_<version>_Linux nell'ubicazione in cui è stata estratta la build di OpenText Identity Console.

  2. Eseguire il comando seguente per utilizzare l'utility create_silent_properties:

    ./create_silent_properties

  3. Immettere il nome host del server di Identity Console IP l'indirizzo IP. Ad esempio, 10.0.0.1.

  4. Immettere il numero di porta su cui si desidera che Identity Console sia in ascolto. Ad esempio, 9000.

  5. (Condizionale) A seconda delle proprie esigenze, eseguire una delle seguenti operazioni:

    • Se non si desidera integrare OSP con Identity Console, scegliere "n" e continuare con il passaggio 6.

    • Se si desidera integrare OSP con Identity Console, scegliere "y" e fornire gli input per i seguenti passaggi:

      1. Immettere il nome di dominio/l'indirizzo IP del server eDirectory/Identity Vault con il numero di porta LDAPS.

        Ad esempio:

        192.168.1.1:636

      2. Immettere il nome utente eDirectory/Identity Vault.

        Esempio:

        cn=admin,ou=org_unit,o=org

      3. Immettere la password di eDirectory/Identity Vault.

      4. Immettere nuovamente la password di eDirectory/Identity Vault per confermarla.

      5. Immettere il nome di dominio/indirizzo IP del server OSP con il numero di porta SSL del server SSO.

      6. Immettere l'ID client OSP e la password del client OSP.

      7. Immettere il nome dell'albero eDirectory/Identity Vault.

  6. Immettere i nomi host o l'indirizzo IP del server eDirectory a cui si desidera che Identity Console stabilisca una connessione. Ad esempio, 10.10.10.10:636.

  7. Immettere i nomi host o l'indirizzo IP del server eDirectory a cui si desidera che Identity Console stabilisca una connessione. Ad esempio, 10.10.10.10:636.

  8. Immettere il percorso della directory del certificato del server, incluso il nome del file. Ad esempio, /home/cert/keys.pfx.

  9. Immettere la password del certificato server.

  10. Immettere nuovamente la password del certificato server.

    Il file silent_properties viene generato correttamente in IdentityConsole_<version>_Linux.

Per eseguire un'installazione in modalità automatica:

  1. Dopo aver generato il file silent_properties, eseguire il comando seguente per eseguire il programma di installazione in modalità automatica:

    ./identityconsole_install -s silent_properties

  2. Immettere il nome di dominio/l'indirizzo IP del server eDirectory con il numero di porta LDAPS. Ad esempio: 10.10.10.10:636

I log relativi all'installazione sono presenti nel file installazione di Identity Console > identityconsole_install.log.

Alberi multipli con OpenText Identity Console come applicazione autonoma

Per connettere OpenText Identity Console a più alberi OpenText eDirectory, è necessario specificare l’IP di OpenText eDirectory e la porta LDAPS separati da virgola nel file edirapi.conf in /etc/opt/novell/eDirAPI/conf/. Inoltre, è necessario copiare i certificati CA da tutti gli alberi OpenText eDirectory nella directory /etc/opt/novell/eDirAPI/cert/.

Ad esempio, per connettere OpenText Identity Console a tre alberi OpenText eDirectory, specificare l'indirizzo IP nel seguente formato:

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

Copiare quindi i certificati CA come indicato di seguito:

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

Per riavviare OpenText Identity Console, eseguire uno dei comandi seguenti:

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

Modifica del certificato server in OpenText Identity Console come applicazione autonoma

Per modificare il certificato del server in OpenText Identity Console come applicazione autonoma, eseguire la procedura seguente:

  1. Eseguire NLPCERT per memorizzare le chiavi:

    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. Riavviare OpenText Identity Console:

    systemctl restart netiq-identityconsole.service

Arresto e riavvio di OpenText Identity Console come applicazione autonoma

  • Per arrestare, eseguire uno dei seguenti comandi:

    /usr/bin/identityconsole stop

    oppure

    systemctl stop netiq-identityconsole.service

  • Per riavviare, eseguire uno dei seguenti comandi:

    /usr/bin/identityconsole restart

    oppure

    systemctl restart netiq-identityconsole.service

  • Per avviare, eseguire uno dei seguenti comandi:

    /usr/bin/identityconsole start

    oppure

    systemctl start netiq-identityconsole.service

2.2.2 Installazione di OpenText Identity Console Workstation su Windows

OpenText Identity Console (versione 1.5 e successive) può essere avviato su Windows come workstation e richiede l'esecuzione dei servizi REST. Pertanto, quando viene avviato, un processo eDirAPI viene eseguito nel prompt dei comandi edirapi.exe. Se si chiude il terminale edirapi.exe, OpenText Identity Console non funzionerà più.

Nella procedura seguente viene descritto come eseguire OpenText Identity Console su Windows.

  1. Eseguire il login al portale Software License and Download (Licenza software e download) e passare alla pagina per il download del software.

  2. Selezionare quanto segue:

    • Prodotto: OpenText eDirectory

    • Product Name (Nome prodotto): eDirectory per User Sub SW E-LTU

    • Version (Versione): 9.2

  3. Effettuare il download e l’estrazione del file IdentityConsole_<version>_workstation_win_x86_64.zip.

  4. Passare alla cartella estratta, installare NICI_w32 o NICI_wx64 in base alla configurazione del sistema.

  5. (Condizionale) Se si dispone già dei file keys.pfx e SSCert.pem che si desidera utilizzare, copiare manualmente i file nella cartella cert ubicata in C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert.

    Procedere quindi con il passaggio 9.

  6. (Condizionale) Se si desidera generare il certificato CA, passare alla cartella eDirAPI, eseguire il file binario get_cacert.exe in Power Shell, ubicato in C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI e fornire i seguenti dettagli:

    • Nome di dominio/l'indirizzo IP del server eDirectory/Identity Vault con il numero di porta LDAPS.

    • Percorso del certificato CA della fonte attendibile con il nome del certificato.

    Ad esempio:

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

    Viene generato un file SSCert.pem.

  7. (Condizionale) Se si desidera generare il certificato del server, eseguire il file binario get_servercert.exe tramite Power Shell insieme ai seguenti dettagli:

    • Nome di dominio/l'indirizzo IP del server eDirectory/Identity Vault con il numero di porta LDAPS.

    • Nome utente di eDirectory/Identity Vault.

    • Password di eDirectory/Identity Vault.

    • Nome del certificato del server.

    • Password del certificato del server.

    • Percorso del certificato CA della fonte attendibile con il nome del certificato.

    • Percorso del certificato del server fonte attendibile con nome di certificato (keys.pfx è hardcoded).

    Ad esempio:

    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

    Viene generato un file keys.pfx.

  8. Copiare manualmente i file keys.pfxe SSCert.pem (generati nei passaggi 6 e 7) nella cartella cert.

  9. Passare alla cartella estratta, fare doppio clic sul file configure.bat e immettere la password del certificato del server (keys.pfx) nel prompt dei comandi.

    NOTA:se il certificato del server viene modificato, eseguire nuovamente il file configure.bat con la password del nuovo certificato.

  10. Passare alla cartella estratta e fare doppio clic sul file run.bat.

    Il terminale del processo eDirAPI (edirapi.exe) viene avviato e viene visualizzata la pagina di login di Identity Console.

NOTA:

  • Per i login successivi all'applicazione OpenText Identity Console, fare doppio clic sul file run.bat. Verrà visualizzata la pagina di login.

    Se il terminale del processo eDirAPI (edirapi.exe) è già in esecuzione, eseguire identityconsole.exe dalla cartella estratta della build.

  • Gli utenti possono trovare i seguenti log in: \IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\log

    edirapi.log - Utilizzato per registrare diversi eventi in edirapi e per eseguire il debug dei problemi.

    edirapi_audit.log - Utilizzato per registrare gli eventi di revisione di edirapi. I log seguono il formato di revisione CEF.

  • Il login basato su OSP non è supportato in modalità workstation.

  • OpenText Identity Console Workstation è in ascolto sulla porta 9000. Non modificare il file edirapi_win.conf.

Utility per la generazione di certificati

È possibile ottenere certificati CA e certificati del server per altri alberi OpenText eDirectory utilizzando le seguenti utility.

NOTA:Gli script per il certificato CA e del server sono disponibili nel percorso opt/novell/eDirAPI/sbin.

Generazione del certificato CA

  1. Effettuare il download e l'estrazione dell'ultima build di OpenText Identity Console.

  2. Accedere alla directory in cui è stata estratta la build di OpenText Identity Console. Esempio: C:\IdentityConsole_<version>_workstation_win_x86_64\eDirAPI

  3. Eseguire il seguente file binario tramite il prompt dei comandi.

    get_cacert.exe

  4. Specificare l'indirizzo IP di eDirectory e il numero di porta LDAPS.

    Esempio: get_cacert.exe 10.10.10.125:636

    Viene generato un file SSCert.pem. Copiare manualmente SSCert.pem nella cartella cert.

Generazione del certificato del server

  1. Accedere alla cartella in cui è stata estratta la build di OpenText Identity Console.

    Esempio: IdentityConsole_<version>_win

  2. Eseguire get_servercert.exe help per ulteriori opzioni della guida tramite il prompt dei comandi.

    • Nome di dominio/l'indirizzo IP del server eDirectory/Identity Vault con il numero di porta LDAPS.

    • Nome utente di eDirectory/Identity Vault.

    • Password di eDirectory/Identity Vault.

    • Nome del certificato del server.

    • Password del certificato del server.

    • Percorso del certificato fonte attendibile con il nome del certificato.

      Per generare il certificato del server, eseguire il seguente comando dal prompt dei comandi:

      Esempio:

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

      Viene generato un file keys.pfx. Copiare manualmente keys.pfx nella cartella cert.

Alberi multipli con OpenText Identity Console come workstation

OpenText Identity Console consente all'utente di effettuare la connessione a più alberi ottenendo il certificato CA individuale dell'albero.

  1. Chiudere OpenText Identity Console Workstation e il terminale eDirAPI.

  2. Copiare i certificati CA SSCert.pem nell'ubicazione: <IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert.

    Ad esempio, se si desidera eseguire la connessione a tre alberi eDirectory, copiare i certificati CA rispettivamente come SSCert1.pem, SSCert2.pem e SSCert3.pem.

  3. Accedere alla cartella in cui viene estratta la build e fare doppio clic su run.bat (file batch di Windows).

Chiusura e riavvio di OpenText Identity Console Workstation

Per chiudere l'applicazione e il processo:

  1. Chiudere l'applicazione desktop Windows OpenText Identity Console.

  2. Arrestare il processo eDirAPI chiudendo il terminale del processo eDirAPI.

Per riavviare OpenText Identity Console Workstation, accedere alla cartella in cui viene estratta la build e fare doppio clic su run.bat (file batch di Windows).

NOTA:Se il terminale del processo eDirAPI è già in esecuzione, eseguire identityconsole.exe dalla cartella estratta della build per riavviare OpenText Identity Console Workstation.

2.2.3 Installazione di OpenText Identity Console come container di Docker

Vedere la sezione Installazione di OpenText Identity Console come container di Docker.

2.2.4 Installazione di OpenText Identity Console in Azure Kubernetes Service

Vedere la sezione Installazione di OpenText Identity Console in Azure Kubernetes Service.