IBM LDAP統合リファレンス
このトピックは、IBM Lightweight Directory Access Protocol (LDAP) の統合に固有のリファレンス情報を提供します。Okta LDAP エージェントをインストールする際に、この情報を使用してIBMディレクトリとOktaを統合する必要があります。Okta LDAP エージェントのインストールを参照してください。
推奨されるバージョン
IBM Security Directory Server 6.3.1
既知の問題
- パスワードの有効期限が切れているユーザーは、パスワードを更新できません。管理者がリセットする必要があります。
- ユーザーが非アクティブ化され、プロビジョニング設定がDo nothing(何もしない)と示されているときに、ユーザーがOktaでアクティブ状態のまま残ります。単一ソースがユーザー プロファイル属性を提供している場合、非アクティブ化されたユーザーはソースから切断されOktaがユーザー プロファイル属性のソースとなります。
統合構成
Okta LDAP エージェントのインストールで説明するエージェントの初期インストールと構成中、IBM統合には以下の属性があります。
- 一意の識別子の属性-ibm-entryuuid
- DN属性- distinguishedname
- ユーザー オブジェクト クラス— inetorgperson
- ユーザー オブジェクト フィルター ― (objectclass=inetorgperson)
- *アカウントで無効化されている属性 - ibm-pwdAccountLocked
- *アカウントで無効になっている値 - TRUE
- *アカウントで有効になっている値 - FALSE
- パスワード属性 - userpassword
- グループ オブジェクト クラス — groupofuniquenames
- グループ オブジェクト フィルター — (objectclass=groupofuniquenames)
- メンバー属性 — uniquemember
アカウントをロックするには、ユーザーのパスワードを削除するか、pwdLockout属性を「TRUE」に設定してください。プロファイルエディターを使用して、追加のユーザープロファイル属性を選択します。
スキーマ読み出し
IBM LDAP 統合のための特別な考慮事項はありません。
パスワード変更
ユーザーはOktaエンドユーザー ダッシュボードで[Settings(設定)]を選択することでパスワードを変更できます。
ユーザーがパスワードを変更またはリセットできるようにするには、[Security (セキュリティ)]>[Delegated Authentication (代理認証)]をクリックし、[LDAP]タブを選択して、[Users can change their LDAP passwords in Okta (ユーザーはOktaでのLDAPパスワードを変更できます)] を選択します。
検証のエラーメッセージは、[Delegated Authentication (代理認証)]ページに表示されます。
パスワードはデフォルトではテキスト形式です。パスワードを保存する前に暗号化するには、IBM Security Directory Serverのドキュメントの「パスワード暗号化」を参照してください。
パスワードリセット
パスワード リセットは管理者またはユーザーがパスワードを忘れた場合のフローでトリガされます。
IBM パスワードポリシーはOktaにレプリケートされません。LDAPパスワードポリシーの基準を満たさないパスワードが生成され、認証失敗の原因となることがあります。これを防ぐためには、Oktaによるパスワードリセットを許可する前に、IBM Directory Serverのパスワードポリシーを確認し、競合を特定して修正する必要があります。
ユーザーが期限切れのパスワードを更新することはできません。期限切れのパスワードは、管理者がリセットする必要があります。
IBMのLDAP統合は、パスワードの有効期限の警告をサポートしていないため、LDAPグループパスワードポリシーでパスワードの有効期間の値を設定しても効果はありません。
インポート
IBM LDAP 統合のための特別な考慮事項はありません。
JITプロビジョニング
IBMのジャストインタイム(JIT)プロビジョニングについては、特別な考慮事項はありません。ユーザー識別(UID)に対しては、Oktaユーザー名のデフォルト設定と一致するようメールアドレスの形式を使用します。外部IDプロバイダー (IDP)を使用してサインインをトリガしないでください。
初めての場合でも、JITプロビジョニングを間違いなく行うには
- 設定された名付け属性(UIDなど)の値がOktaに存在しないこと
- 設定された名付け属性(UIDなど)の値がJIT対応のディレクトリで一意であること
- 必要な属性が存在していることOktaデフォルト値はメール、givenName、sn、およびuid。
- パスワードが間違っていないこと
- アカウント無効化属性がLDAPサーバーでfalseに設定されていること
JITプロビジョニングが問題なく完了すると、LDAP設定ページとプロファイル エディターでで指定されたすべてのユーザー属性がインポートされます。追加の必須属性を選択するには、プロファイル エディターを使用します。
プロビジョニング
IBM パスワードポリシーはOktaにレプリケートされません。LDAPパスワードポリシーの基準を満たさないパスワードが生成され、認証失敗の原因となることがあります。これを防ぐためには、Oktaによるパスワードリセットを許可する前に、IBM Directory Serverのパスワードポリシーを確認し、競合を特定して修正する必要があります。
ユーザー プロファイルを作成する際にパスワードを作成して割り当てるには
- Oktaカスタマーサポートに連絡してLDAPプッシュ パスワードのアップデートを有効化します。
- 代理認証を無効化します。
- 管理コンソールで、[セキュリティー] > に移動します [Delegated Authentication(代理認証)]>[LDAP]に進みます。
- [Delegated Authentication(代理認証)]ペインで[Edit(編集)]をクリックします。
- [Enable delegated authentication to LDAP(LDAPの代理認証を有効化)] チェック ボックスをオフにします。
- [Save(保存)]をクリックします。
- デフォルト設定を受け入れ、すべてのLDAP ユーザーパスワードをリセットし、[Disable LDAP Authentication(LDAP認証を無効化)]をクリックします。
- デフォルト設定を受け入れ、すべてのLDAP ユーザーパスワードをリセットし、[Disable LDAP Authentication(LDAP認証を無効化)]をクリックします。
- Okta管理コンソールで、[Directory(ディレクトリ)]>[Directory Integrations(ディレクトリ統合)]>[LDAP]>[Provisioning (プロビジョニング)]>[To App (アプリへ)]の順に進みます。
- [Edit(編集)]をクリックして[Sync Password(パスワードを同期化)]の隣の[Enable(有効化)]をクリックし、[Save(保存)]をクリックします。
[Sync Password(パスワードを同期化)]を有効にすると、ユーザーが初めてサインインした時にLDAPエージェントはアクションPASSWORD_UPDATEを送信します。
既存のOktaユーザーをLDAPに割り当てるには
- 管理コンソールで、[ディレクトリー] > に移動します [Directory Integrations(ディレクトリ統合)]>[LDAP]>[Provisioning(プロビジョニング)]>[To App(アプリへ)]に進みます。
- [Edit(編集)]をクリックし、[Create Users(ユーザーの作成)]の隣にある[Enable(有効化)]を選択して[Save(保存)]をクリックします。
- [Directory(ディレクトリ)]>[Groups(グループ)]をクリックします。
- ユーザーの割り当て先となるOktaグループを選択します。
- [Manage Directories(ディレクトリを管理)]をクリックします。
- 左ペインでLDAPインスタンスを選択し、[Next(次へ)]をクリックします。
- [Provisioning Destination DN(プロビジョニング先のDN)]フィールドに新規ユーザーLDAPコンテナの完全識別名を入力します。
- [Confirm Changes(変更を確定)]をクリックします。
トラブルシューティング
LDAP ディレクトリ認証が失敗した場合、エージェントは診断と解決に役立てるために以下のような画面メッセージを記録します。
Agent: Success (成功)
scanResults are sent with user and group info
POST initiated with result status=SUCCESS, actionType=USER_AUTH_AND_UPDATE, actionId=ADSx27FqYtCqky2Wv0g3, diagnostic message=, error code=, matched dn=, message=SUCCESS, result code=, vendor=IBM
Agent:Delauth failure(代理認証が失敗)
POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADSx1f9Wa5VsAmx8g0g3, diagnostic message=, error code=49, matched dn=cn=DelAuth,ou=Automation,O=FOX, message=LDAPException(resultCode=49 (invalid credentials), errorMessage='invalid credentials'), result code=invalid credentials, vendor=IBM
Agent: No user(ユーザーなし)
POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADSx1zLU1yUw7hcKM0g3, diagnostic message=, error code=, matched dn=, message=User not found while executing query: (&(objectclass=inetorgperson)(uid=asdfasdf)), result code=, vendor=IBM
Agent: Password expired(パスワード期限切れ)
POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADSydvdqGivWZ2eBN0g3, diagnostic message=, error code=508, matched dn=cn=PasswordExpired,ou=Automation,o=FOX, message=LDAPException(resultCode=508, errorMessage='508'), result code=508, vendor=IBM
Agent: Locked Out (ロックアウト)
POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADSyhmxo2EEQAPJTu0g3, diagnostic message=Error, Account is locked, error code=53, matched dn=cn=smith117 newman,ou=automation,o=fox, message=LDAPException(resultCode=53 (unwilling to perform), errorMessage='Error, Account is locked', diagnosticMessage='Error, Account is locked'), result code=unwilling to perform, vendor=IBM