Attività di manutenzione di SymasLDAP

Posizione dei file di log

I file di log di SymasLDAP sono contenuti nella directory /opt/apigee/var/log. Questi file possono essere archiviati e rimossi periodicamente per assicurarsi che non occupino spazio su disco eccessivo. Per informazioni su come gestire, archiviare e rimuovere i log di SymasLDAP, consulta la sezione 19.2 del manuale di SymasLDAP all'indirizzo https://kb.symas.com/configuration/logging-configuration.

Impostare manualmente la password di un utente

Gli utenti possono richiedere una nuova password Edge nella nuova UI di Edge. L'utente riceve quindi un'email con informazioni sull'impostazione di una password. Tuttavia, se il server SMTP non è attivo o se l'utente non può ricevere un'email per qualsiasi motivo, puoi impostare manualmente la password dell'utente utilizzando i comandi SymasLDAP.

Per impostare la password di un utente:

  1. Utilizza ldapsearch per scaricare le informazioni dell'utente: 
    /opt/symas/bin/ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389 > ldap.txt
  2. Cerca l'indirizzo email dell'utente nel file ldap.txt. Dovresti visualizzare un blocco nel formato: 
    dn: uid=29383a67-9279-4aa8-a75b-cfbf901578fc,ou=users,ou=global,dc=apigee,dc=com
mail: foo@bar.com
userPassword:: e1NTSEF9a01UUDdSd01BYXRuUURXdXN5OWNPRzBEWWlYZFBRTm14MHlNVWc9PQ==
uid: 29383a67-9279-4aa8-a75b-cfbf901578fc
  3. Utilizza ldappasswd per impostare la password dell'utente in base al relativo UID: 
    /opt/symas/bin/ldappasswd -x -H ldap://LDAP_IP:10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=29383a67-9279-4aa8-a75b-cfbf901578fc,ou=users,ou=global,dc=apigee,dc=com"

    Ti viene richiesta la password di amministratore di SymasLDAP.

L'utente può ora accedere utilizzando newPassWord.

Impostare manualmente la password di sistema di SymasLDAP

La reimpostazione delle password di Edge descrive come modificare la password di sistema di SymasLDAP, ma richiede di conoscere la password esistente. Se hai perso la password, puoi utilizzare la seguente procedura per reimpostarla.

  1. Utilizza slappasswd per creare la password criptata SSHA per una nuova password: 
    /opt/symas/sbin/slappasswd -h {SSHA} -s newPassWord

    Questo comando restituisce una stringa nel formato: 

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. Apri il /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif file in un editor: 
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. Trova la riga nel formato: 
    olcRootPW:: OldPasswordString
  4. Sostituisci OldPasswordString con la stringa restituita da slappasswd. Se dopo olcRootPw sono presenti due punti, rimuovine uno e assicurati che ci sia uno spazio dopo i due punti: 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Riavvia SymasLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Verifica utilizzando ldapsearch se la nuova password funziona: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

    Ti viene richiesta la password di amministratore di SymasLDAP.

  7. Ripeti questi passaggi su tutti gli altri server SymasLDAP utilizzati per la replica.
  8. Aggiorna il server di gestione in modo che utilizzi la nuova password: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Impostare manualmente la password di amministratore di Edge

La reimpostazione delle password di Edge descrive come modificare la password di sistema di Edge, ma richiede di conoscere la password esistente. Se hai perso la password di sistema di Edge, puoi utilizzare la seguente procedura per reimpostarla.

  1. Sul nodo della nuova UI di Edge, arresta la nuova UI di Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Utilizza ldappasswd per impostare la password di amministratore di sistema di Edge: 
    /opt/symas/bin/ldappasswd -x -H ldap://localhost:10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=admin,ou=users,ou=global,dc=apigee,dc=com"

    Ti viene richiesta la password di amministratore di SymasLDAP.

  3. Aggiorna il file di configurazione che hai utilizzato per installare la nuova UI di Edge con la nuova password di sistema di Edge: 
    APIGEE_ADMINPW=newPassWord
  4. Configura e riavvia la nuova UI di Edge: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
  5. (Solo se TLS è abilitato nella nuova UI di Edge) Riattiva TLS nella nuova UI di Edge come descritto in Configurare TLS per la nuova UI di Edge.

Eliminare il file di blocco SLAPD

Se viene visualizzato un errore quando provi ad avviare SymasLDAP che indica che esiste il file di blocco slapd.pid, puoi eliminare il file.

Il file si trova in /opt/apigee/apigee-openldap/var/run/slapd.pid. Elimina il file e prova a riavviare SymasLDAP:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart

Se SymasLDAP non si avvia, prova ad avviarlo in modalità di debug e controlla la presenza di errori:

/opt/symas/lib/slapd -h ldap://:10389/ -u apigee -d 255 -F /opt/apigee/data/apigee-openldap/slapd.d

Gli errori potrebbero indicare problemi di risorse, memoria o utilizzo della CPU.

Modificare la replica di SymasLDAP

Questa sezione spiega come modificare la replica di SymasLDAP.

Esegui i passaggi della seguente procedura sul nodo del replicatore SymasLDAP, che replica i dati nell' altro nodo SymasLDAP. Ad esempio, se stai configurando la replica da node1 a node2, esegui i comandi su node1.

  1. Controlla lo stato attuale: 
    /opt/symas/bin/ldapsearch -H ldap://HOST:PORT -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w PASSWORD -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

    L'output dovrebbe essere simile al seguente:

    olcSyncrepl: {0}rid=001 provider=ldap://HOST:PORT/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials=PASSWORD searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1
  2. Crea un file repl.ldif e incolla i seguenti comandi nel file: 
    dn: olcDatabase={2}mdb,cn=config
changetype: modify
replace: olcSyncRepl
    olcSyncRepl: rid=001
    provider=ldap://NEW_HOST:PORT/
    binddn="cn=manager,dc=apigee,dc=com"
    bindmethod=simple
    credentials=PASSWORD
    searchbase="dc=apigee,dc=com"
    attrs="*,+"
    type=refreshAndPersist
    retry="60 1 300 12 7200 +"
    timeout=1

    Assicurati di sostituire il valore appropriato per i seguenti segnaposto:

    • NEW_HOST: il nuovo host SymasLDAP a cui prevedi di eseguire la replica.
    • PORT: la porta SymasLDAP. La porta predefinita è 10389.
    • PASSWORD: la password SymasLDAP.
  3. Esegui il comando ldapmodify: 
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    L'output dovrebbe essere simile al seguente:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. Verifica la replica: 
    /opt/symas/bin/ldapsearch -H ldap://HOST:PORT -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w PASSWORD -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

    L'output dovrebbe essere simile al seguente: 

    olcSyncrepl: {0}rid=001 provider=ldap://NEW_HOST:PORT/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials=PASSWORD searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

    Puoi verificare che la replica funzioni correttamente leggendo e confrontando il contextCSN valore di ogni server e assicurandoti che corrispondano.

    /opt/symas/bin/ldapsearch -w PASSWORD -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://localhost:10389 contextCSN | grep contextCSN

Risolvere i problemi di replica di SymasLDAP

Se l'installazione utilizza più server SymasLDAP, puoi controllare le impostazioni di replica per assicurarti che i server funzionino correttamente.

  1. Assicurati che ldapsearch restituisca i dati da ogni server SymasLDAP: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

    Ti viene richiesta la password di amministratore di SymasLDAP.

  2. Controlla la configurazione della replica esaminando il /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif file.
  3. Assicurati che la password di sistema sia la stessa su ogni server OpenLDAP.
  4. Controlla le impostazioni di iptables e tcp wrapper.