Tarefas de manutenção do SymasLDAP

Localização do arquivo de registro

Os arquivos de registro do SymasLDAP estão contidos no diretório /opt/apigee/var/log. Esses arquivos podem ser arquivados e removidos periodicamente para garantir que não ocupem muito espaço em disco. As informações sobre como manter, arquivar e remover registros do SymasLDAP podem ser encontradas na seção 19.2 do manual do SymasLDAP em https://kb.symas.com/configuration/logging-configuration (link em inglês).

Definir manualmente a senha de um usuário

Os usuários podem solicitar uma nova senha do Edge na nova interface. O usuário recebe um e-mail com informações sobre como definir uma senha. No entanto, se o servidor SMTP estiver inativo ou se o usuário não puder receber um e-mail por qualquer motivo, você poderá definir manualmente a senha do usuário usando comandos do SymasLDAP.

Para definir a senha de um usuário:

  1. Use ldapsearch para fazer o download das informações do usuário:
    /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. Pesquise o endereço de e-mail do usuário no arquivo ldap.txt. Você verá um bloco no 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. Use ldappasswd para definir a senha do usuário com base no uid dele:
    /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"

    Você precisará informar a senha de administrador do SymasLDAP.

Agora o usuário pode fazer login usando newPassWord.

Definir manualmente a senha do sistema SymasLDAP

A redefinição de senhas do Edge descreve como mudar a senha do sistema SymasLDAP, mas exige que você saiba a senha atual. Se você perdeu essa senha, use o procedimento a seguir para redefini-la.

  1. Use slappasswd para criar a senha criptografada SSHA para uma nova senha:
    /opt/symas/sbin/slappasswd -h {SSHA} -s newPassWord

    Esse comando retorna uma string no formato:

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. Abra o /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif arquivo em um editor:
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. Encontre a linha no formato:
    olcRootPW:: OldPasswordString
  4. Substitua OldPasswordString pela string retornada de slappasswd. Se houver dois pontos após olcRootPw, remova um e verifique se há um espaço após os dois pontos:
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Reinicie o SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Verifique se a nova senha funciona usando ldapsearch:
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

    Você precisará informar a senha de administrador do SymasLDAP.

  7. Repita essas etapas em outros servidores SymasLDAP que estão sendo usados para replicação.
  8. Atualize o servidor de gerenciamento para usar a nova senha:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Definir manualmente a senha de administrador do Edge

A redefinição de senhas do Edge descreve como mudar a senha do sistema Edge, mas exige que você saiba a senha atual. Se você perdeu a senha do sistema Edge, use o procedimento a seguir para redefini-la.

  1. No nó da nova interface do Edge, interrompa a nova interface:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Use ldappasswd para definir a senha de administrador do 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"

    Você precisará informar a senha de administrador do SymasLDAP.

  3. Atualize o arquivo de configuração que você usou para instalar a nova interface do Edge com a nova senha do sistema Edge:
    APIGEE_ADMINPW=newPassWord
  4. Configure e reinicie a nova interface do Edge:
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
  5. (Somente se o TLS estiver ativado na nova interface do Edge) Reative o TLS na nova interface do Edge, conforme descrito em Configurar o TLS para a nova interface do Edge.

Excluir o arquivo de bloqueio SLAPD

Se você receber um erro ao tentar iniciar o SymasLDAP informando que o arquivo de bloqueio slapd.pid existe, exclua o arquivo.

O arquivo está localizado em /opt/apigee/apigee-openldap/var/run/slapd.pid. Exclua o arquivo e tente reiniciar o SymasLDAP:

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

Se o SymasLDAP não for iniciado, tente iniciá-lo no modo de depuração e verifique se há erros:

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

Os erros podem indicar problemas de recursos, memória ou utilização da CPU.

Como modificar a replicação do SymasLDAP

Esta seção explica como modificar a replicação do SymasLDAP.

Execute as etapas no procedimento a seguir no nó do replicador do SymasLDAP, que replica os dados para o outro nó do SymasLDAP. Por exemplo, se você estiver definindo a replicação do nó 1 para o nó 2, execute os comandos no nó 1.

  1. Verifique o estado atual:
    /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

    A saída será semelhante a esta:

    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. Crie um arquivo repl.ldif e cole os comandos a seguir no arquivo:
    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

    Substitua o valor apropriado para os seguintes marcadores:

    • NEW_HOST: o novo host do SymasLDAP para o qual você planeja replicar.
    • PORT: a porta do SymasLDAP. A porta padrão é 10389.
    • PASSWORD: a senha do SymasLDAP.
  3. Execute o comando ldapmodify:
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    A saída será semelhante a esta:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. Verifique a replicação:
    /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

    A saída será semelhante a esta:

    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 se a replicação está funcionando corretamente, leia e compare o contextCSN valor de cada servidor e verifique se eles correspondem.

    /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

Solução de problemas de replicação do SymasLDAP problemas

Se a instalação usar vários servidores SymasLDAP, verifique as configurações de replicação para garantir que os servidores estejam funcionando corretamente.

  1. Verifique se ldapsearch retorna dados 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

    Você precisará informar a senha de administrador do SymasLDAP.

  2. Verifique a configuração de replicação examinando o /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif arquivo.
  3. Verifique se a senha do sistema é a mesma em cada servidor OpenLDAP.
  4. Verifique as configurações do iptables e do wrapper TCP.