API 管理用のデフォルトの LDAP パスワード ポリシーの管理

Apigee システムは、OpenLDAP を使用して API 管理環境のユーザーを認証します。OpenLDAP では、この LDAP パスワード ポリシー機能を使用できます。

このセクションでは、提供されるデフォルトの LDAP パスワード ポリシーを構成する方法について説明します。このパスワード ポリシーを使用して、さまざまなパスワード認証オプションを構成します。たとえば、連続してログインに失敗した回数を指定して、その回数を超えるとパスワードを使用してユーザーをディレクトリに認証できなくなるように構成できます。

このセクションでは、デフォルトのパスワード ポリシーで構成された属性に従ってロックされたユーザー アカウントのロックを解除するために、いくつかの API を使用する方法についても説明します。

詳しくは以下をご覧ください。

デフォルトの LDAP パスワード ポリシーの構成

デフォルトの LDAP パスワード ポリシーを構成するには:

  1. LDAP クライアント(Apache Studio や ldapmodify など)を使用して LDAP サーバーに接続します。デフォルトでは、OpenLDAP サーバーは OpenLDAP ノードのポート 10389 でリッスンします。

    接続するには、cn=manager,dc=apigee,dc=com のバインド DN またはユーザーと、Edge のインストール時に設定した OpenLDAP パスワードを指定します。

  2. クライアントを使用して、次のパスワード ポリシー属性に移動します。
    • Edge ユーザー: cn=default,ou=pwpolicies,dc=apigee,dc=com
    • Edge sysadmin: cn=sysadmin,ou=pwpolicies,dc=apigee,dc=com
  3. 必要に応じて、パスワード ポリシーの属性値を編集します。
  4. 構成を保存します。

デフォルトの LDAP パスワード ポリシーの属性

属性 説明 デフォルト
pwdExpireWarning
パスワードの有効期限が切れる前に、ディレクトリに対して認証を行うユーザーに有効期限の警告メッセージが返されるまでの最大秒数。

604800

(7 日間に相当)

pwdFailureCountInterval

古い連続したバインド試行の失敗が失敗カウンタから消去されるまでの秒数。

つまり、この秒数が経過すると、連続したログイン試行の失敗回数がリセットされます。

pwdFailureCountInterval が 0 に設定されている場合、認証が成功した場合にのみカウンタをリセットできます。

pwdFailureCountInterval が 0 より大きい値に設定されている場合、この属性は、連続したログイン試行の失敗回数が自動的にリセットされるまでの期間を定義します。この期間が経過すると、認証が成功していなくても、失敗回数がリセットされます。

この属性は、pwdLockoutDuration 属性と同じ値に設定することをおすすめします。

300
pwdInHistory

pwdHistory 属性に保存される、ユーザーが使用したパスワードまたは過去のパスワードの最大数。

ユーザーがパスワードを変更する際、過去のパスワードに変更することはできません。

3
pwdLockout

TRUE の場合、パスワードの有効期限が切れたときにユーザーをロックアウトし、ユーザーがログインできないように指定します。

False
pwdLockoutDuration

ログイン試行の失敗が連続して多すぎるために、パスワードを使用してユーザーを認証できない秒数。

つまり、pwdMaxFailure 属性で設定されたログイン失敗回数の上限を超えたために、ユーザー アカウントがロックされたままになる期間です。

pwdLockoutDuration が 0 に設定されている場合、ユーザー アカウントはシステム管理者がロックを解除するまでロックされたままになります。

ユーザー アカウントのロック解除をご覧ください。

pwdLockoutDuration が 0 より大きい値に設定されている場合、この属性はユーザー アカウントがロックされたままになる期間を定義します。この期間が経過すると、ユーザー アカウントは自動的にロック解除されます。

この属性は、pwdFailureCountInterval 属性と同じ値に設定することをおすすめします。

300
pwdMaxAge

ユーザー(sysadmin 以外)のパスワードが期限切れになるまでの秒数。値が 0 の場合、パスワードの有効期限はありません。デフォルト値の 2592000 は、パスワードが作成されてから 30 日間に相当します。

user: 2592000

sysadmin: 0

pwdMaxFailure

ログイン試行の連続失敗回数。この回数を超えると、パスワードを使用してユーザーをディレクトリに認証できなくなります。

3
pwdMinLength

パスワードを設定する際に必要な最小文字数を指定します。

8

ユーザー アカウントのロック解除

パスワード ポリシーで設定された属性により、ユーザーのアカウントがロックされることがあります。sysadmin Apigee ロールが割り当てられているユーザーは、次の API 呼び出しを使用してユーザーのアカウントのロックを解除できます。userEmail、adminEmail、password は実際の値に置き換えます。

ユーザーのロックを解除するには:

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