Tareas de mantenimiento de OpenLDAP

Ubicación del archivo de registro

Los archivos de registro de OpenLDAP se encuentran en el directorio /opt/apigee/var/log. Estos archivos se pueden archivar y quitar de forma periódica para garantizar que no ocupen demasiado espacio en el disco. Puedes encontrar información para mantener, archivar y quitar registros de OpenLDAP en la sección 19.2 del manual de OpenLDAP en http://www.openldap.org/doc/admin24/maintenance.html.

Configura manualmente la contraseña de un usuario

Los usuarios pueden solicitar una nueva contraseña de Edge en la IU de Edge. Luego, el usuario recibe un correo electrónico con información para establecer una contraseña. Sin embargo, si tu servidor SMTP está inactivo o el usuario no puede recibir un correo electrónico por algún motivo, puedes configurar la contraseña del usuario de forma manual con los comandos de OpenLDAP.

Para establecer la contraseña de un usuario, sigue estos pasos:

  1. Usa ldapsearch para descargar la información del usuario: 
    ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt
  2. Busca la dirección de correo electrónico del usuario en el archivo ldap.txt. Deberías ver un bloque con el siguiente 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. Usa ldappasswd para establecer la contraseña del usuario según su UID: 
    ldappasswd -h LDAP_IP -p 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"

    Se te solicitará la contraseña de administrador de OpenLDAP.

Ahora, el usuario puede acceder con newPassWord.

Establece manualmente la contraseña del sistema de OpenLDAP

En Restablece las contraseñas de Edge, se describe cómo cambiar la contraseña del sistema de OpenLDAP, pero requiere que conozcas la contraseña existente. Si perdiste esa contraseña, puedes usar el siguiente procedimiento para restablecerla.

  1. Usa slappasswd para crear la contraseña encriptada con SSHA para una contraseña nueva: 
    slappasswd -h {SSHA} -s newPassWord

    Este comando devuelve una cadena con el siguiente formato: 

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. Abre el archivo /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif en un editor: 
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif
  3. Busca la línea con el siguiente formato: 
    olcRootPW:: OldPasswordString
  4. Reemplaza OldPasswordString por la cadena que se muestra de slappasswd. Si hay 2 signos de dos puntos después de olcRootPw, quita uno y asegúrate de que haya un espacio después de los dos puntos: 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Reinicia OpenLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Verifica con ldapsearch si tu nueva contraseña funciona: 
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Se te solicitará la contraseña de administrador de OpenLDAP.

  7. Repite estos pasos en cualquier otro servidor de OpenLDAP que se use para la replicación.
  8. Actualiza el servidor de administración para que use la contraseña nueva: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Establece manualmente la contraseña de administrador de Edge

En Restablece las contraseñas de Edge, se describe cómo cambiar la contraseña del sistema de Edge, pero requiere que conozcas la contraseña existente. Si perdiste la contraseña del sistema de Edge, puedes usar el siguiente procedimiento para restablecerla.

  1. En el nodo de la IU, detén la IU de Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Usa ldappasswd para establecer la contraseña de administrador del sistema de Edge: 
    ldappasswd -h localhost -p 10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=admin,ou=users,ou=global,dc=apigee,dc=com"

    Se te solicitará la contraseña de administrador de OpenLDAP.

  3. Actualiza el archivo de configuración que usaste para instalar la IU de Edge con la nueva contraseña del sistema de Edge: 
    APIGEE_ADMINPW=newPassWord
  4. Configura y reinicia la IU de Edge: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (Solo si TLS está habilitado en la IU) Vuelve a habilitar TLS en la IU de Edge como se describe en Configura TLS para la IU de administración.

Borra el archivo de bloqueo de SLAPD

Si recibes un error cuando intentas iniciar OpenLDAP que indica que el archivo de bloqueo slapd.pid existe, puedes borrarlo.

El archivo se encuentra en /opt/apigee/apigee-openldap/var/run/slapd.pid. Borra el archivo y, luego, intenta reiniciar OpenLDAP:

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

Si OpenLDAP no se inicia, intenta iniciarlo en modo de depuración y verifica si hay errores:

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

Los errores pueden indicar problemas de recursos, memoria o uso de CPU.

Modifica la replicación de OpenLDAP

En esta sección, se explica cómo modificar la replicación de OpenLDAP.

Realiza los pasos del siguiente procedimiento en el nodo replicador de OpenLDAP, que replica sus datos en el otro nodo de OpenLDAP. Por ejemplo, si configuras la replicación de node1 a node2, ejecuta los comandos en node1.

  1. Verifica el estado actual: 
    ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {PASSWORD} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

    El resultado debería ser similar al siguiente ejemplo:

    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 archivo repl.lidf y pega los siguientes comandos en él: 
    dn: olcDatabase={2}bdb,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

    Asegúrate de reemplazar el valor adecuado para los siguientes marcadores de posición:

    • {NEW_HOST}: Es el nuevo host de OpenLDAP en el que planeas realizar la replicación.
    • {PORT}: Es el puerto de OpenLDAP. El puerto predeterminado es 10389.
    • {PASSWORD}: Es la contraseña de OpenLDAP.
  3. Ejecuta el comando ldapmodify: 
    ldapmodify -x -w {PASSWORD} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f repl.ldif
    
    The output should be similar to the following:
    
    
    modifying entry "olcDatabase={2}bdb,cn=config"
  4. Verifica la replicación: 
    ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {PASSWORD} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

    El resultado debería ser similar al siguiente ejemplo: 

    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

    Para verificar que la replicación funcione correctamente, lee y compara el valor de contextCSN de cada servidor y asegúrate de que coincidan.

    ldapsearch -w {PASSWORD} -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h localhost -p 10389 contextCSN | grep contextCSN

Soluciona problemas de replicación de OpenLDAP

Si tu instalación usa varios servidores de OpenLDAP, puedes verificar la configuración de replicación para asegurarte de que los servidores funcionen correctamente.

  1. Asegúrate de que ldapsearch devuelva datos de cada servidor de OpenLDAP: 
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Se te solicitará la contraseña de administrador de OpenLDAP.

  2. Verifica la configuración de la replicación examinando el archivo /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif.
  3. Asegúrate de que la contraseña del sistema sea la misma en cada servidor de OpenLDAP.
  4. Verifica la configuración de iptables y del wrapper de TCP.