Tareas de mantenimiento de SymasLDAP

Ubicación del archivo de registro

Los archivos de registro de SymasLDAP se encuentran en el directorio /opt/apigee/var/log. Estos archivos se pueden archivar y quitar periódicamente para garantizar que no ocupen demasiado espacio en el disco. Puedes encontrar información para mantener, archivar y quitar registros de SymasLDAP en la sección 19.2 del manual de SymasLDAP en https://kb.symas.com/configuration/logging-configuration.

Cómo configurar manualmente la contraseña de un usuario

Los usuarios pueden solicitar una contraseña nueva de Edge en la nueva IU de Edge. Luego, el usuario recibe un correo electrónico con información para configurar 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 manualmente la contraseña del usuario con comandos de SymasLDAP

Para configurar la contraseña de un usuario, haz lo siguiente:

  1. Usa ldapsearch para descargar la información del usuario: 
    /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. 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 configurar la contraseña del usuario según su 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"

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

Ahora el usuario puede acceder con newPassWord.

Cómo configurar manualmente la contraseña del sistema SymasLDAP

En Cómo restablecer contraseñas de Edge, se describe cómo cambiar la contraseña del sistema SymasLDAP, 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 SSHA para una contraseña nueva: 
    /opt/symas/sbin/slappasswd -h {SSHA} -s newPassWord

    Este comando muestra una cadena con el siguiente formato: 

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

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

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

Cómo configurar manualmente la contraseña de administrador de Edge

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

  1. En el nodo de la nueva IU de Edge, detén la nueva IU de Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Usa ldappasswd para configurar la contraseña de administrador del sistema 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"

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

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

Cómo borrar el archivo de bloqueo SLAPD

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

El archivo se encuentra en /opt/apigee/apigee-openldap/var/run/slapd.pid. Borra el archivo y vuelve a iniciar SymasLDAP:

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

Si SymasLDAP no se inicia, intenta iniciarlo en modo de depuración y busca errores:

/opt/symas/lib/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.

Cómo modificar la replicación de SymasLDAP

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

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

  1. Verifica el estado actual: 
    /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

    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.ldif y pega los siguientes comandos en el archivo: 
    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

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

    • NEW_HOST: Es el nuevo host de SymasLDAP al que planeas replicar.
    • PORT: Es el puerto de SymasLDAP. El puerto predeterminado es 10389.
    • PASSWORD: Es la contraseña de SymasLDAP.
  3. Ejecuta el comando ldapmodify: 
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    El resultado debería ser similar al siguiente ejemplo:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. Verifica la replicación: 
    /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

    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 contextCSN valor de cada servidor y asegúrate de que coincidan.

    /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

Soluciona problemas de replicación de SymasLDAP

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

  1. Asegúrate de que ldapsearch muestre datos de cada servidor 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

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

  2. Para verificar la configuración de replicación, examina el /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif archivo.
  3. Asegúrate de que la contraseña del sistema sea la misma en cada servidor OpenLDAP.
  4. Verifica la configuración de iptables y tcp wrapper.