Ciao!

Ho bisogno di aiuto? Siamo proprio qui!

Icona di supporto
Supporto e-mail miniOrange
il successo

Grazie per la tua richiesta. Il nostro team ti contatterà presto.

Se non ricevi nostre notizie entro 24 ore, non esitare a inviare un'e-mail di follow-up a info@xecurify.com

Risultati di Ricerca:

×

Procedura per configurare un IDP locale su Linux


Migliori miniOrange Provider di identità (IdP) on-premise gestisce e verifica in modo sicuro le identità degli utenti all'interno del tuo ambiente locale per SSO e IAM. Questa guida rapida ti illustra come distribuire un'istanza di miniarancione IAM (V5.2.2) su Linux. Progettata per una valutazione e un test rapidi, questa configurazione utilizza un server Tomcat preconfigurato.

Per l'architettura, i comandi dell'utilità moctl e i dettagli sulla licenza, utilizzare i collegamenti in Ulteriori riferimenti.


Requisiti di sistema

Assicurati che il tuo server soddisfi queste specifiche di base prima di iniziare. Il programma di installazione miniOrange è autonomo e ti chiederà automaticamente di installarlo. Java 17, Redis, RabbitMQ e un database predefinito (PostgreSQL) se non sono già presenti sul tuo sistema.

OS Qualsiasi sistema operativo (Linux preferibile) con supporto fino a Java 17 (OpenJDK)
Hardware CPU quad-core | 16 GB di RAM | 32 GB di spazio di archiviazione
Ambiente JAVA JAVA_17
Criteri di accesso al server
  • Porta 80 - HTTP
  • Porta 1812 e 1813 - Radius UDP (facoltativo)
  • Porta 22 - SSH (server Linux) - Per l'accesso
Database supportati
  • MySQL 8.4 / 9.1
  • PostgreSQL 14 / 15 / 16 / 17 / 18 (consigliato)
  • Microsoft SQL Server 2016 / 2017 / 2019 / 2022 / 2025
  • Oracle Database 18c / 19c / 21c / 23ai
Altre dipendenze software
  • Redis: porta 6379
  • RabbitMQ: porta 5672

Le porte RADIUS 1812 e 1813 sono facoltative; apritele solo se intendete utilizzare l'autenticazione basata su RADIUS.

Installa il server locale

1: Scarica il programma di installazione

  • Opzione 1: Installazione online (consigliata)
    Scarica il pacchetto di installazione standard direttamente sul tuo server: Scarica il programma di installazione v5.2.2
  • Opzione 2: Installazione offline (ambienti isolati dalla rete)
    Per i server senza accesso a Internet o in ambienti isolati dalla rete, è disponibile su richiesta un programma di installazione offline. Contattateci indicando il nome e la versione del vostro sistema operativo e vi forniremo il pacchetto di installazione appropriato.

2: Eseguire il programma di installazione

Estraete il pacchetto ed eseguite lo script di installazione tramite i seguenti comandi nel terminale:

tar -xzf mo-installer-5.2.2.tar.gz
cd mo-installer-online-5.2.2
chmod +x *.sh
sudo sh mo-installer.sh

3: Rispondere alle richieste interattive

Durante l'esecuzione, il programma di installazione rileverà le dipendenze mancanti e ti chiederà di installarle Redis, RabbitMQ e database PostgreSQL localmente.

  • Per configurazioni di valutazione/POC: Tipo SI Installarli entrambi localmente. Questo è il modo più rapido per ottenere un'istanza completamente funzionante e avviarla subito.
  • Per le configurazioni esterne: Tipo NO se preferisci ospitare Redis, RabbitMQ o il tuo database su un server separato.

4: Configurazione esterna (opzionale)

Se hai risposto NO Grazie all'installazione integrata di PostgreSQL, Redis e RabbitMQ, è possibile scaricare e utilizzare qualsiasi servizio esterno a propria scelta.

Servizio Ubuntu / Debian CentOS/RedHat
PostgreSQL Ubuntu / Debian CentOS/RedHat
MySQL Ubuntu / Debian CentOS/RedHat
RabbitMQ Ubuntu / Debian CentOS/RedHat
Redis Ubuntu / Debian CentOS/RedHat

L'unico requisito: Prima di procedere con la procedura guidata di configurazione di miniOrange, è necessario creare manualmente un nuovo database (schema) vuoto all'interno del server di database.

Esempio per PostgreSQL:

# Access your database CLI
sudo -u postgres psql

# Create a fresh, empty database
CREATE DATABASE <databasename>;

Nota: (Sostituire con il tuo identificativo preferito. Dovrai inserire questo nome nella schermata di configurazione di miniOrange in seguito.


Configurazione del provider di identità (IdP)

1. Avvia il IAM Servizi

Avvia il miniOrange IAM piattaforma eseguendo l'utilità di servizio. Questo comando inizializza automaticamente tutti i servizi sottostanti necessari.

moctl service start

Nota: La riga di comando mostrerà l'avanzamento dell'inizializzazione. Potrebbero essere necessari un paio di minuti prima che tutti i servizi in background si avviino completamente.


2. Accedere alla procedura guidata di configurazione

  • Apri il tuo browser web e vai a: https://<YOUR_SERVER_IP_OR_DNS> ad esempio, ([https://192.168.1.2], [http://localhost:8080]).
  • Ignora l'avviso SSL: Poiché la configurazione iniziale utilizza un certificato temporaneo autofirmato, il browser visualizzerà un avviso di sicurezza. Fai clic Filtri e recarsi all'indirizzo.

3. Completare la procedura guidata di installazione

Segui le 3 istruzioni visualizzate sullo schermo per completare l'installazione:

  • Infrastruttura di servizio: Fornisci i dettagli di connessione per il tuo Database, RabbitMQ e Redis impostazioni, quindi fai clic Avanti(Se riscontri problemi, consulta le FAQ o contatta l'assistenza).
  • Crea un account amministratore: Inserisci un amministratore valido Email e sicuro PasswordQueste saranno le tue credenziali di root per la dashboard di amministrazione. Fai clic su Avanti.
  • Selezione dei casi d'uso: Scegli un modello di autenticazione predefinito che corrisponda agli obiettivi della tua organizzazione oppure fai clic Saltare per andare direttamente alla dashboard.

  • Procedura guidata di configurazione del server IDP locale


4. Verificare lo stato del servizio

Una volta raggiunta la dashboard, verifica che tutti i microservizi ausiliari funzionino correttamente utilizzando uno dei seguenti metodi:

Metodo A: Tramite riga di comando (consigliato)

Eseguire l'utilità di controllo dello stato per assicurarsi che i servizi chiave come app, idps e directory siano elencati come UP:

moctl service status


Metodo B: Tramite browser web

Accedere al motore del registro dei servizi interni all'indirizzo http:// :8070 o http://localhost:8070 per verificare che tutti i componenti siano stati registrati correttamente. Dovresti vedere voci per i componenti principali come APP, CONFIGSERVER, DIRECTORY, IDPS, LICENZEe altri servizi distribuiti elencati nel registro.

Se alcuni servizi non sono disponibili o non sono registrati, riavvia i servizi della piattaforma e verifica nuovamente il loro stato:

moctl service restart


5. Importare il certificato SSL in JDK Truststore (obbligatorio per i flussi di lavoro)

I flussi di lavoro richiedono una comunicazione sicura tramite HTTPS.

  • Per garantire che il servizio Workflow consideri attendibile il certificato del tuo dominio, devi importare il certificato nel JDK cacerti negozio di fiducia.
  • Password predefinita del keystore: cambiarlo

    [Nota: La posizione del file cacerts dipende dall'installazione del JDK.]

  • Utilizzare il comando seguente per importare il certificato di dominio nel truststore JDK:
    sudo keytool -import \
      -alias miniorange-wildcard \
      -file /home/abhishek/Downloads/certificates/domain.crt \
      -keystore /usr/lib/jvm/java-8-openjdk/jre/lib/security/cacerts \
      -storepass changeit
  • Se il tuo JDK è installato in un percorso diverso, aggiornalo -archivio chiavi posizione di conseguenza.
  • Percorsi alternativi comuni:
    /usr/lib/jvm/java-17-openjdk-amd64/jre/lib/security/cacerts
    /usr/lib/jvm/java-17-openjdk/lib/security/cacerts
    /opt/jdk/jre/lib/security/cacerts

6. Registrare il modulo del flusso di lavoro con lo scheduler

Per abilitare l'esecuzione del flusso di lavoro, è necessario registrare il modulo Workflow presso il servizio Scheduler. Seguire i passaggi in base al sistema operativo in uso.

  • Vai alla directory miniOrange installata.
  • Passare a:
    /services/linux/scheduler-mq-register.sh
  • Esempio di navigazione:
    cd /opt/mo-idp-server/services/linux/
  • Eseguire lo script di registrazione:
    sudo ./scheduler-mq-register.sh

Esegui il server miniOrange IDP su SSL



Come applicare un certificato SSL per Nginx:

  • Formati di certificato supportati per Nginx:
    • Formato PEM (consigliato: .crt, .cer, .pem)
    • La chiave privata deve essere in formato PEM (.key).
    • Nginx non supporta direttamente i certificati nei formati DER o PFX. Utilizza OpenSSL per convertirli prima dell'uso.

Genera certificato SSL (facoltativo se non si dispone di un certificato firmato da una CA)

1. Requisiti

Assicurati di averlo OpenSSL installato sul tuo sistema:

sudo apt install openssl

2. Generare un certificato autofirmato
  • Esegui questo comando nel tuo terminale:
    openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout nginx-selfsigned.key -out nginx-selfsigned.crt \
      -subj "/C=US/ST=State/L=City/O=Company/OU=Org/CN=example.com"

    Analisi dei comandi:

    Bandiera Descrizione
    -x509 Genera un certificato autofirmato
    -nodi Nessuna password per la chiave privata
    -giorni 365 Certificato valido per 1 anno
    -keyout Percorso per salvare la chiave privata
    -su Percorso per salvare il certificato
    -sott Imposta i dettagli del certificato senza richieste

  • -subj Formato:
    /C=US/ST=State/L=City/O=Company/OU=Org/CN=example.com
    Settore Significato Esempio
    C Codice paese (2 lettere) Stati Uniti, Indiana, Delaware
    ST Stato/Provincia California, Karnataka
    L Città San Francisco, Bangalore
    O Organizzazione Acme Corp
    OU Shirts Department Informatica, Ingegneria
    CN Nome del dominio example.com
  • Applicare il certificato SSL in Nginx

    1. Individua il file nginx.conf

    • Esegui:
      /etc/nginx/nginx.conf

    2. Modifica il blocco server

    server {
      listen 443 ssl;
      server_name example.com;  # Replace with your domain
    
      ssl_certificate     /path/to/nginx-selfsigned.crt;
      ssl_certificate_key /path/to/nginx-selfsigned.key;
    
      location / {
        # Your application settings
      }
    }

    3. Riavvia Nginx

    • Esegui:
      sudo nginx -t # Test configuration
        sudo systemctl restart nginx

Nota: I certificati autofirmati mostreranno un avviso nel browser perché non sono emessi da un'autorità di certificazione (CA) attendibile. Utilizzarli solo per lo sviluppo locale o per test interni.


    1. Generare un archivio chiavi
    • Apri un prompt dei comandi o un terminale. E vai a percorso e immettere il comando riportato di seguito.
      keytool -genkey -alias onpremssoidp -keyalg RSA -keystore onpremssoidp.jks
    • Se in questo passaggio si verifica un errore di autorizzazione, modificare la posizione nel prompt dei comandi o nel terminale in Desktop o in qualsiasi altra posizione di propria scelta.
    • Inserisci la password che preferisci e ricordala. (Se la password inserita non funziona, conservala come "changeit").
    2. Generare il certificato SSL
    • Dopo aver premuto il tasto Invio verrà richiesta una password per Premi Invio per continuare.
      (Nota: nome e cognome devono essere il nome DNS/nome host del server)
    • generare certificato ssl

    • Il certificato SSL autofirmato viene generato nella posizione indicata.
    3. Configurare Tomcat con il Keystore generato sopra
    1. 1. Aprire la configurazione di Tomcat:
      • Passare alla conf directory all'interno della cartella di installazione di miniOrange.
      • Aprire il server.xml file in un editor di testo.
    2. 2. Modifica server.xml:
      • Individuare la lineaNome del servizio="Catalina">.
      • Subito dopo questa riga, inserisci il seguente frammento:
        <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreFile="<JKS Keystore Path>" ciphers="ALL" keystorePass="<Password while keystore generation>"/>
      • SostituirePercorso del Keystore JKS> con il percorso del file del tuo archivio chiavi ePassword durante la generazione del keystore> con la password del tuo archivio chiavi.

        Nota: Assicurarsi che il file .jks abbia le autorizzazioni appropriate/eseguire il prompt dei comandi come amministratore.

Utilizzando un certificato di CA attendibili come LetsEncrypt, GoDaddy, Comodo SSL.

  • I passaggi seguenti presuppongono che tu disponga di un certificato valido generato tramite Certbot. In caso contrario, puoi utilizzare i comandi Certbot riportati di seguito per generare il certificato per il tuo dominio.
    certbot certonly --standalone -d.example.com
  • Una volta generato il certificato, si otterrà la seguente struttura di cartelle.
    #:/etc/letsencrypt/live/example.com# ls
    cert.pem  chain.pem  fullchain.pem  privkey.pem  README
  • Copiare cert.pem, chain.pem, fullchain.pem e privkey.pem nella directory conf dell'IdP.
  • Modificare il file conf/server.xml e aggiungere il seguente elemento connettore.
    <Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
      maxThreads="150" SSLEnabled="true">
      <SSLHostConfig>
        <Certificate certificateFile="conf/cert.pem"
          certificateKeyFile="conf/privkey.pem"
          certificateChainFile="conf/chain.pem" />
      </SSLHostConfig>
    </Connector>
  • Riavvia l'IdP. L'IdP dovrebbe ora utilizzare il certificato valido di LetsEncrypt.
  • I passaggi seguenti presuppongono che tu abbia scaricato i certificati SSL validi da GoDaddy. I certificati devono essere importati in un Java Keystore (JKS). Per creare un JKS, è possibile utilizzare l'utilità keytool.
    keytool -genkey -alias onpremssoidp -keyalg RSA -keystore onpremssoidp.jks
  • I certificati originali devono essere rimossi dal keystore. Questo può essere fatto utilizzando il comando seguente.
    keytool -delete -alias onpremssoidp -keystore onpremssoidp.jks
  • I comandi OpenSSL possono essere utilizzati per importare i certificati scaricati da GoDaddy nel Java Keystore.
    openssl pkcs12 -export -in <GoDaddyCertificate>.crt -inkey <PrivateKey>.key \
      -out <PublicPrivateKeyPair>.p12 -name tomcat -CAfile gd_bundle-g2-g1.crt -caname root
  • Il keystore può ora essere utilizzato per configurare il connettore in conf/server.xml.
    <Connector port="443"
      protocol="HTTP/1.1"
      SSLEnabled="true"
      maxThreads="150"
      scheme="https"
      secure="true"
      clientAuth="false"
      sslProtocol="TLS"
      keystoreFile="<JKS Keystore Path>"
      ciphers="ALL"
      keystorePass="<Password while keystore generation>
      "/>
  • Riavvia l'IdP. L'IdP dovrebbe ora utilizzare il certificato valido di GoDaddy.

    Creazione di un nuovo archivio chiavi

  • Passare alla directory in cui si intende posizionare il nuovo archivio chiavi.
  • Immettere il seguente comando:
    keytool -genkey -alias server -keyalg RSA -keysize 2048 -keystore your_site_name.jks
  • Quando richiesto, crea una password per il tuo nuovo Keystore.
  • Inserisci le informazioni richieste (Nota: non digitare il tuo nome nel campo Nome, digita il tuo FQDN).
  • Al termine, verifica le tue informazioni digitando "Y" o "Sì".
  • Infine, inserisci la password appena creata nel passaggio tre.

  • Creazione di un CSR sui server Tomcat

  • Eseguire il seguente comando:
    keytool -certreq -alias server -file csr.txt -keystore your_site_name.jks
  • Una volta richiesto, inserisci la password creata nel passaggio tre delle istruzioni del Keystore
  • Utilizza le informazioni fornite durante la creazione del keystore. Il CSR verrà generato e salvato nella directory scelta come "CSR.txt".
  • Si consiglia di salvare ed eseguire il backup del file keystore una volta completata la generazione del CSR. Una volta completata la generazione del CSR, selezionare il certificato SSL che si desidera installare sul server Tomcat e acquistarlo, copiando e incollando il CSR (aprire il file .txt) nel campo appropriato (solitamente quello etichettato CSR).
  • Una volta completati l'acquisto e la convalida, la CA ti invierà via e-mail un pacchetto che include il tuo certificato SSL e un certificato intermedio che deve essere installato con esso.

  • Come installare un certificato SSL sul tuo server Tomcat

  • Salva i tuoi certificati nella directory Keystore che hai creato.
  • Utilizzare il seguente comando per importare il keystore:
    keytool -import -alias server -file your_site_name.p7b -keystore your_site_name.jks
  • Dovresti vedere un messaggio di conferma che dice: "La risposta del certificato è stata installata nel keystore".
  • Digitare "Y" o "Sì" per considerare attendibile il certificato.
  • Ora, infine, non ci resta che configurare il server Tomcat per servire il sito web tramite HTTPS.

  • Configurazione del connettore SSL/TLS

  • Utilizzando un editor di testo, apri il file Tomcat server.xml.
  • Individua il connettore che desideri proteggere con il tuo nuovo archivio chiavi.
  • Configura il connettore per utilizzare la porta 443 (HTTPS); il file di configurazione dovrebbe avere un aspetto simile a questo:
    <Connector port="443"
      maxHttpHeaderSize="8192"
      maxThreads="100"
      minSpareThreads="25"
      maxSpareThreads="75"
      enableLookups="false"
      disableUploadTimeout="true"
      acceptCount="100"
      scheme="https"
      secure="true"
      SSLEnabled="true"
      clientAuth="false"
      sslProtocol="TLS"
      keyAlias="server"
      keystoreFile="/home/user_name/your_site_name.jks"
      keystorePass="your_keystore_password" />
  • Salva le modifiche nel file server.xml.
  • Riavvia il server Tomcat.
  • Se i metodi sopra indicati non funzionano, seguire il link indicato di seguito
  • CLICCA QUI per seguire i passaggi se si dispone di altri certificati CA.

Configura la rotazione dei log

I componenti principali di miniOrange generano log di runtime continui. Per evitare che lo spazio di archiviazione del server si riempia completamente e causi arresti anomali del servizio nel tempo, è necessario è necessario configurare la rotazione dei log.

Si prega di rivedere e implementare i passaggi di configurazione dettagliati nel nostro documento autonomo. Guida alla configurazione della rotazione dei registri subito dopo la configurazione iniziale.


Aggiorna IDP locale

Nota: Durante l'aggiornamento di miniOrange a un runtime Java 17, tutti i certificati personalizzati presenti in Java 8 cacerti Il truststore deve essere esportato e importato manualmente in Java 17 cacerti Truststore per mantenere connessioni SSL affidabili con sistemi esterni.


    Prerequisiti:

    • Accedi al tuo account amministratore e andare a Impostazioni>>Impostazioni prodottoCopia il tuo URL di base del server.
    • Esegui un backup del database miniorange nella tua istanza del database.
    • Eseguire un backup dei seguenti file sul server.
      • mo-idp-server-*/moas/WEB-INF/classi/db.properties
      • mo-idp-server-*/moas/WEB-INF/classi/licenza
    • Vai su mo-idp-server-*/bin e chiudere l'istanza di Tomcat in esecuzione. (puoi usare sh shutdown.sh)

    Passaggi per l'aggiornamento:

    • Scarica l'ultima versione sul tuo server Linux e decomprimila.
    • Troverai la cartella moas all'interno della cartella non compressa. Sostituisci mo-idp-server-3.3.*/moas con la nuova cartella moas
    • Sostituisci i backup di db.properties e del file di licenza nello stesso percorso indicato sopra.
    • Vai a mo-idp-server-*/bin e chiudi l'istanza di Tomcat in esecuzione. (puoi usare sh spegnimento.sh)
    • Riavviare l'istanza di Tomcat utilizzando avvio sh
    • Apri un browser e vai su <URL-base-del-tuo-server >/inizializza

Disinstallare IDP on-premise

Per rimuovere completamente miniOrange IAM Dal tuo server, accedi alla directory di installazione ed esegui:

# 1. Stop all active services
moctl service stop

# 2. Run the uninstaller script
sudo sh uninstall.sh

Domande frequenti

Se si verifica l'errore: "keytool error: java.lang.Exception: coppia di chiavi non generata, alias esiste già"

Ciò indica che il file keystore esiste già. Per risolvere il problema, segui questi passaggi:

  • Elimina il file keystore esistente che si trova nel percorso file denominato "onpremssoidp.jks"
  • Eseguire nuovamente il comando di generazione della chiave.
    keytool -genkey -alias onpremssoidp -keyalg RSA -keystore onpremssoidp.jks
    e compilare i dettagli.

Ulteriori riferimenti

Architettura e gestione operativa:

Gestione del servizio:

Licensing:

  

x

Email di lavoro *


Nome *


Caso d'uso*


Facendo clic su Scarica, accetti i nostri Termini di Servizio

Vuoi programmare una demo?

Richiedi un demo
  




I nostri altri prodotti di gestione dell'identità e dell'accesso