Edge para nuvem privada v. 4.17.09
O sistema da Apigee usa o OpenLDAP para autenticar usuários no ambiente de gerenciamento de APIs. O OpenLDAP disponibiliza essa funcionalidade de política de senha do LDAP.
Nesta seção, descrevemos como configurar a política de senha padrão do LDAP. Use essa política de senha para configurar várias opções de autenticação de senha, como o número de tentativas consecutivas de login com falha após as quais uma senha não pode mais ser usada para autenticar um usuário no diretório.
Esta seção também descreve como usar algumas APIs para desbloquear contas de usuário que foram bloqueadas de acordo com os atributos configurados na política de senha padrão.
Para mais informações, consulte:
Como configurar a política de senha padrão do LDAP
Para configurar a política de senha padrão do LDAP:
- Conecte-se ao servidor LDAP usando um cliente LDAP, como o Apache Studio ou o ldapmodify. Por
padrão, o servidor OpenLDAP detecta a porta 10389 no nó do OpenLDAP.
Para se conectar, especifique o DN de vinculação ou o usuário de cn=manager,dc=apigee,dc=com e a senha do OpenLDAP que você definiu no momento da instalação do Edge. - Use o cliente para navegar até os atributos da política de senha para:
- Usuários do Edge: cn=default,ou=pwpolicies,dc=apigee,dc=com
- Sysadmin do Edge: cn=sysadmin,ou=pwpolicies,dc=apigee,dc=com
- Edite os valores dos atributos da política de senha como quiser.
- Salve a configuração.
Atributos padrão da política de senha do LDAP
|
Attribute |
Descrição |
Padrão |
|---|---|---|
|
pwdExpireWarning |
O número máximo de segundos antes de uma senha expirar para que as mensagens de aviso de expiração sejam retornadas a um usuário que está se autenticando no diretório. |
604800 (Equivalente a 7 dias) |
|
pwdFailureCountInterval |
Número de segundos após os quais as tentativas de vinculação com falha consecutivas antigas são limpas do contador de falhas. Em outras palavras, esse é o número de segundos após o qual a contagem de tentativas de login com falha consecutivas é redefinida. Se pwdFailureCountInterval estiver definido como 0, somente uma autenticação bem-sucedida poderá redefinir o contador. Se pwdFailureCountInterval estiver definido como >0, o atributo definirá uma duração após a qual a contagem de tentativas de login com falha consecutivas será redefinida automaticamente, mesmo que nenhuma autenticação tenha sido realizada. Sugerimos que esse atributo seja definido com o mesmo valor do atributo pwdLockoutDuration. |
300 |
|
pwdInHistory |
Número máximo de senhas usadas ou anteriores de um usuário que serão armazenadas no atributo pwdHistory. Ao mudar a senha, o usuário não poderá usar nenhuma das senhas anteriores. |
3 |
|
pwdLockout |
Se for TRUE, especifica o bloqueio de um usuário quando a senha dele expirar para que ele não possa mais fazer login. |
Falso |
|
pwdLockoutDuration |
Número de segundos em que uma senha não pode ser usada para autenticar o usuário devido a muitas tentativas consecutivas de login com falha. Em outras palavras, esse é o período em que uma conta de usuário vai permanecer bloqueada por exceder o número de tentativas consecutivas de login malsucedidas definido pelo atributo pwdMaxFailure. Se pwdLockoutDuration estiver definido como 0, a conta de usuário vai permanecer bloqueada até que um administrador do sistema a desbloqueie. Consulte "Como desbloquear uma conta de usuário" abaixo. Se pwdLockoutDuration estiver definido como >0, o atributo vai definir um período em que a conta de usuário vai permanecer bloqueada. Quando esse período terminar, a conta de usuário será desbloqueada automaticamente. Sugerimos que esse atributo seja definido com o mesmo valor do atributo pwdFailureCountInterval. |
300 |
|
pwdMaxAge |
Número de segundos após o qual a senha de um usuário (não sysadmin) expira. O valor 0 significa que as senhas não expiram. O valor padrão de 2592000 corresponde a 30 dias a partir do momento em que a senha foi criada. |
user: 2592000 sysadmin: 0 |
|
pwdMaxFailure |
Número de tentativas consecutivas de login malsucedidas após as quais uma senha não pode ser usada para autenticar um usuário no diretório. |
3 |
|
pwdMinLength |
Especifica o número mínimo de caracteres necessários ao definir uma senha. |
8 |
Como desbloquear uma conta de usuário
A conta de um usuário pode ser bloqueada devido a atributos definidos na política de senha. Um usuário com o papel de sysadmin da Apigee atribuído pode usar a seguinte chamada de API para desbloquear a conta do usuário. Substitua os valores entre chaves pelos valores reais.
Para desbloquear um usuário:
/v1/users/{userEmail}/status?action=unlock -X POST -u {adminEmail}:{password}