OpenLDAP 유지보수 태스크

Private Cloud용 Edge v4.19.01

로그 파일 위치

OpenLDAP 로그 파일은 /opt/apigee/var/log 디렉터리에 포함됩니다. 이러한 파일은 과도한 디스크 공간을 차지하지 않도록 주기적으로 보관처리하고 삭제할 수 있습니다. OpenLDAP 로그 유지관리, 보관처리, 삭제에 관한 정보는 OpenLDAP 매뉴얼의 19.2항(http://www.openldap.org/doc/admin24/maintenance.html)에서 확인할 수 있습니다.

수동으로 사용자 비밀번호 설정

사용자는 Edge UI에서 새 Edge 비밀번호를 요청할 수 있습니다. 그러면 사용자에게 비밀번호 설정에 관한 정보가 포함된 이메일이 전송됩니다. 그러나 SMTP 서버가 다운되었거나 사용자에게 어떤 이유로든 이메일을 받을 수 없는 경우 OpenLDAP 명령어를 사용하여 사용자의 비밀번호를 수동으로 설정할 수 있습니다.

사용자 비밀번호를 설정하려면 다음 단계를 따르세요.

  1. ldapsearch를 사용하여 사용자 정보를 다운로드합니다. 
    ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt
  2. ldap.txt 파일에서 사용자의 이메일 주소를 검색합니다. 다음과 같은 형식의 블록이 표시됩니다. 
    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. ldappasswd를 사용하여 사용자의 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"

    OpenLDAP 관리자 비밀번호를 입력하라는 메시지가 표시됩니다.

이제 사용자는 newPassWord를 사용하여 로그인할 수 있습니다.

OpenLDAP 시스템 비밀번호 수동 설정

Edge 비밀번호 재설정에서는 OpenLDAP 시스템 비밀번호를 변경하는 방법을 설명하지만 기존 비밀번호를 알고 있어야 합니다. 비밀번호를 분실했다면 다음 절차에 따라 재설정할 수 있습니다.

  1. slappasswd를 사용하여 새 비밀번호의 SSHA 암호화 비밀번호를 만듭니다. 
    slappasswd -h {SSHA} -s newPassWord

    이 명령어는 다음 형식의 문자열을 반환합니다. 

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6

  2. 편집기에서 /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif 파일을 엽니다. 
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif
  3. 다음 형식의 줄을 찾습니다. 
    olcRootPW:: OldPasswordString
  4. OldPasswordString를 slappasswd에서 반환된 문자열로 바꿉니다. olcRootPw 뒤에 콜론이 2개 있는 경우 하나를 삭제하고 콜론 뒤에 공백이 있는지 확인합니다. 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. OpenLDAP를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. ldapsearch를 사용하여 새 비밀번호가 작동하는지 확인합니다. 
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    OpenLDAP 관리자 비밀번호를 입력하라는 메시지가 표시됩니다.

  7. 복제에 사용 중인 다른 OpenLDAP 서버에서도 이 단계를 반복합니다.
  8. 새 비밀번호를 사용하도록 관리 서버를 업데이트합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Edge 관리자 비밀번호 수동 설정

Edge 비밀번호 재설정에서는 Edge 시스템 비밀번호를 변경하는 방법을 설명하지만 기존 비밀번호를 알고 있어야 합니다. Edge 시스템 비밀번호를 분실한 경우 다음 절차에 따라 비밀번호를 재설정할 수 있습니다.

  1. UI 노드에서 Edge UI를 중지합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. ldappasswd를 사용하여 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"

    OpenLDAP 관리자 비밀번호를 입력하라는 메시지가 표시됩니다.

  3. Edge UI를 설치하는 데 사용한 구성 파일을 새 Edge 시스템 비밀번호로 업데이트합니다. 
    APIGEE_ADMINPW=newPassWord
  4. 다음과 같이 Edge UI를 구성하고 다시 시작합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (UI에서 TLS가 사용 설정된 경우에만 해당) 관리 UI의 TLS 구성에 설명된 대로 Edge UI에서 TLS를 다시 사용 설정합니다.

SLAPD 잠금 파일 삭제

OpenLDAP를 시작하려고 할 때 slapd.pid 잠금 파일이 존재한다는 오류가 발생하면 파일을 삭제할 수 있습니다.

파일은 /opt/apigee/apigee-openldap/var/run/slapd.pid에 있습니다. 파일을 삭제하고 OpenLDAP를 다시 시작합니다.

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

OpenLDAP가 시작되지 않으면 디버그 모드로 시작해 오류가 있는지 확인합니다.

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

오류는 리소스 문제, 메모리 문제 또는 CPU 사용률 문제를 나타낼 수 있습니다.

OpenLDAP 복제 문제 해결

설치에서 여러 OpenLDAP 서버를 사용하는 경우 복제 설정을 확인하여 서버가 제대로 작동하는지 확인할 수 있습니다.

  1. ldapsearch가 각 OpenLDAP 서버에서 데이터를 반환하는지 확인합니다. 
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    OpenLDAP 관리자 비밀번호를 입력하라는 메시지가 표시됩니다.

  2. /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif 파일을 검사하여 복제 구성을 확인합니다.
  3. 각 OpenLDAP 서버에서 시스템 비밀번호가 동일한지 확인합니다.
  4. iptables 및 tcp 래퍼 설정을 확인합니다.