Edge para nuvem privada v. 4.17.05
Local do arquivo de registro
Os arquivos de registro do OpenLDAP estão 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 OpenLDAP podem ser encontradas na Seção 19.2 do manual do OpenLDAP em http://www.openldap.org/doc/admin24/maintenance.html.
Definir manualmente a senha de um usuário
Os usuários podem solicitar uma nova senha do Edge na interface do Edge. O usuário recebe um e-mail com informações sobre como definir uma senha. No entanto, se o servidor SMTP estiver inativo ou 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 OpenLDAP.
Para definir a senha de um usuário:
- Use ldapsearch para
fazer o download das informações do usuário:
> ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt - Pesquise o endereço de e-mail do usuário no arquivo ldap.txt. Você verá um bloco no
formulário:
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 - Use ldappasswd para definir
a senha do usuário com base no uid do usuário:
> 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"
A senha de administrador do OpenLDAP será solicitada.
Agora o usuário pode fazer login usando newPassWord.
Definir manualmente a senha do sistema OpenLDAP
Como redefinir senhas do Edge descreve como alterar a senha do sistema OpenLDAP, mas exige que você saiba a senha atual. Se você perdeu essa senha, use o procedimento a seguir para redefini-la.
- Use slappasswd para
criar a senha criptografada SSHA para uma nova senha:
> slappasswd -h {SSHA} -s newPassWord
Esse comando retorna uma string no formato:
{SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6 - Abra o arquivo /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif
em um editor:
> vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif - Encontre a linha no formulário:
olcRootPW:: OldPasswordString - 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 - Reinicie o OpenLDAP:
> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart - Verifique se a nova senha funciona usando ldapsearch.
> ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389
Será solicitada a senha de administrador do OpenLDAP. - Repita essas etapas em todos os outros servidores OpenLDAP que estão sendo usados para replicação.
- 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
Como redefinir senhas do Edge descreve como alterar a senha do sistema do Edge, mas exige que você saiba a senha atual. Se você perdeu a senha do sistema do Edge, use o procedimento a seguir para redefini-la.
- No nó da IU, interrompa a IU do Edge:
> /opt/apigee/apigee-service/bin/apigee-service edge-ui stop - Use ldappasswd para definir a
senha de administrador do sistema do 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"
Será solicitada a senha de administrador do OpenLDAP. - Atualize o arquivo de configuração usado para instalar a IU do Edge com a nova senha do sistema
do Edge:
APIGEE_ADMINPW=newPassWord - Configure e reinicie a IU do Edge:
> /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile - (Somente se o TLS estiver ativado na IU) Reative o TLS na IU do Edge, conforme descrito em Como configurar o TLS para a IU de gerenciamento.
Excluir o arquivo de bloqueio do SLAPD
Se você receber um erro ao tentar iniciar o OpenLDAP 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 OpenLDAP:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
Se o OpenLDAP não iniciar, tente iniciá-lo no modo de depuração e verifique se há erros:
> slapd -h ldap://:10389/ -u apigee -F /opt/apigee/apigee-openldap/var/run -d 255
Os erros podem indicar problemas de recursos, memória ou utilização da CPU.
Solução de problemas de replicação do OpenLDAP
Se a instalação usar vários servidores OpenLDAP, verifique as configurações de replicação para garantir que os servidores estejam funcionando corretamente.
- Verifique se ldapsearch
retorna dados de cada servidor OpenLDAP:
> ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389
Será solicitada a senha de administrador do OpenLDAP. - Verifique a configuração de replicação examinando o arquivo /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif.
- Verifique se a senha do sistema é a mesma em cada servidor OpenLDAP.
- Verifique as configurações de iptables e tcp wrapper.