Gestione del criterio della password LDAP predefinita per la gestione delle API

Il sistema Apigee utilizza OpenLDAP per autenticare gli utenti nell'ambiente di gestione delle API. OpenLDAP rende disponibile questa funzionalità dei criteri delle password LDAP.

Questa sezione descrive come configurare i criteri predefiniti per le password LDAP forniti. Utilizza questo criterio per le password per configurare varie opzioni di autenticazione delle password, ad esempio il numero di tentativi di accesso consecutivi non riusciti dopo i quali una password non può più essere utilizzata per autenticare un utente per la directory.

Questa sezione descrive inoltre come utilizzare un paio di API per sbloccare gli account utente che sono stati bloccati in base agli attributi configurati nel criterio delle password predefinito.

Per ulteriori informazioni, consulta:

Configurazione del criterio per le password LDAP predefinito

Per configurare i criteri predefiniti per le password LDAP:

  1. Connettiti al server LDAP utilizzando un client LDAP, come Apache Studio o ldapmodify. Per impostazione predefinita, il server OpenLDAP rimane in ascolto sulla porta 10389 del nodo OpenLDAP.

    Per eseguire la connessione, specifica il Bind DN o l'utente di cn=manager,dc=apigee,dc=com e la password OpenLDAP che hai impostato al momento dell'installazione di Edge.

  2. Utilizza il client per accedere agli attributi dei criteri relativi alle password per:
    • Utenti Edge: cn=default,ou=pwpolicies,dc=apigee,dc=com
    • Amministratore di sistema perimetrale: cn=sysadmin,ou=pwpolicies,dc=apigee,dc=com
  3. Modifica i valori degli attributi dei criteri per le password come preferisci.
  4. Salva la configurazione.

Attributi dei criteri predefiniti per le password LDAP

Attributo Descrizione Predefinito 
pwdExpireWarning
 Il numero massimo di secondi prima che una password scada, durante il quale verranno restituiti messaggi di avviso di scadenza a un utente che esegue l'autenticazione nella directory.

604800

(Equivalente a 7 giorni)

 
pwdFailureCountInterval

Numero di secondi dopo i quali i vecchi tentativi di associazione non riusciti consecutivi vengono eliminati definitivamente dal contatore degli errori.

In altre parole, si tratta del numero di secondi dopo i quali viene reimpostato il numero di tentativi di accesso non riusciti consecutivi.

Se pwdFailureCountInterval è impostato su 0, solo un'autenticazione riuscita può reimpostare il contatore.

Se pwdFailureCountInterval è impostato su > 0, l'attributo definisce una durata dopo la quale il numero di tentativi di accesso non riusciti consecutivi viene reimpostato automaticamente, anche se non si è verificata alcuna autenticazione riuscita.

Ti consigliamo di impostare questo attributo sullo stesso valore dell'attributo pwdLockoutDuration.

 300 
pwdInHistory

Numero massimo di password utilizzate, o passate, per un utente che verrà archiviato nell'attributo pwdHistory.

Quando si cambia la password, all'utente viene impedito di passare a una qualsiasi delle password precedenti.

 3 
pwdLockout

Se TRUE, consente di specificare di bloccare un utente alla scadenza della password, in modo che l'utente non possa più accedere.

 falso 
pwdLockoutDuration

Numero di secondi durante i quali non è possibile utilizzare una password per autenticare l'utente a causa di troppi tentativi di accesso non riusciti consecutivi.

In altre parole, si tratta del periodo di tempo durante il quale un account utente rimarrà bloccato a causa del superamento del numero di tentativi di accesso non riusciti consecutivi impostato dall'attributo pwdMaxFailure.

Se pwdLockoutDuration è impostato su 0, l'account utente rimarrà bloccato finché un amministratore di sistema non lo sbloccherà.

Vedi Sblocco di un account utente.

Se pwdLockoutDuration è impostato su > 0, l'attributo definisce un periodo di tempo per il quale l'account utente rimarrà bloccato. Una volta trascorso questo periodo di tempo, l'account utente verrà sbloccato automaticamente.

Ti consigliamo di impostare questo attributo sullo stesso valore dell'attributo pwdFailureCountInterval.

 300 
pwdMaxAge

Numero di secondi dopo i quali scade la password di un utente (non amministratore di sistema). Il valore 0 indica che le password non scadono. Il valore predefinito 2592000 corrisponde a 30 giorni dalla creazione della password.

utente: 2592000

amministratore di sistema: 0

 
pwdMaxFailure

Numero di tentativi di accesso non riusciti consecutivi dopo i quali non è possibile utilizzare una password per autenticare un utente alla directory.

 3 
pwdMinLength

Consente di specificare il numero minimo di caratteri richiesti per l'impostazione di una password.

 8

Sblocco di un account utente

L'account di un utente potrebbe essere bloccato a causa degli attributi impostati nel criterio relativo alle password. Un utente con il ruolo Apigee sysadmin assegnato può utilizzare la seguente chiamata API per sbloccare l'account dell'utente. Sostituisci userEmail, adminEmail e password con valori reali.

Per sbloccare un utente:

/v1/users/userEmail/status?action=unlock -X POST -u adminEmail:password