パッケージ jakarta.security.enterprise.identitystore

アノテーションインターフェース LdapIdentityStoreDefinition

@RetentionSE(RUNTIMESE) @TargetSE(TYPESE) public @interface LdapIdentityStoreDefinition
コンテナーの提供する IdentityStore を定義するために使用されるアノテーション。これは、呼び出し元の資格情報と ID 属性（まとめて呼び出し元の ID）を LDAP ストアに格納し、その実装を有効な CDI Bean として利用できるようにします。

コンテナーが提供する IdentityStore は、UsernamePasswordCredential の検証をサポートする必要があり、他の資格型の検証をサポートする場合があります。

  • 要素の詳細

    • url

      StringSE url
      LDAP サーバーにアクセスできる URL。

      E.g .: ldap://localhost:33389

      戻り値:
      LDAP サーバーにアクセスできる URL
      デフォルト:
      ""

    • bindDn

      StringSE bindDn
      LDAP への初期接続を確立し、検索とルックアップを実行するために使用されるアプリケーションまたは管理ユーザーの識別名。

      この値は、呼び出し元またはグループの検索が行われる場合に必要です。ストアが直接バインディングを使用して呼び出し元を認証するためにのみ使用される場合、この値は必要ありません (callerBaseDn を参照)。

      このユーザーには、LDAP での個人やグループの検索権限が必要です。

      E.g .: uid=ldap,ou=apps,dc=eclipse,dc=net

      戻り値:
      アプリケーションユーザーの識別名。
      デフォルト:
      ""

    • bindDnPassword

      StringSE bindDnPassword
      bindDn メンバーによって定義されたアプリケーション / 管理者ユーザーのパスワード。メンバー bindDn が入力されている場合にのみ使用されます。
      戻り値:
      アプリケーションユーザーのパスワード。
      デフォルト:
      ""

    • callerBaseDn

      StringSE callerBaseDn
      LDAP ストア内の呼び出し元の基本識別名（ "ou=caller,dc=eclipse,dc=net" など）。

      このメンバー値が指定され、callerSearchBase が指定されていない場合は、直接バインディングが試行されます。

      ランタイムが、呼び出し元の完全な DN を作成するためにベース DN と連結するために必要な「リーフ」 RDN を作成できるように、この属性とともに callerNameAttribute を指定する必要があります。

      戻り値:
      呼び出し元の基本識別名。
      デフォルト:
      ""

    • callerNameAttribute

      StringSE callerNameAttribute
      個人オブジェクトの呼び出し元名を含む属性の名前（例: "uid" ）。

      この属性は、callerBaseDn とともに、直接バインド用の呼び出し元 DN を構築するために使用されます。また、検索を使用して呼び出し元オブジェクトを検索するときに、呼び出し元の名前を取得するためにも使用されます。

      この属性の値は、資格情報の検証が成功した場合の呼び出し元のプリンシパル名として返されます。

      以下に、ldif 形式の例を示します。

       
 dn: uid=peter,ou=caller,dc=eclipse,dc=net
 objectclass: top
 objectclass: uidObject
 objectclass: person
 uid: peter
 cn: Peter Smith
 sn: Peter
 userPassword: secret1
      戻り値:
      呼び出し元名を表す属性の名前
      デフォルト:
      "uid"

    • callerSearchBase

      StringSE callerSearchBase
      呼び出し元を検索するための検索ベース（ "ou=caller,dc=eclipse,dc=net" など）。

      構成されている場合は、callerBaseDn を上書きして、直接バインディングの代わりに呼び出し元検索を使用するようにします。bindDn メンバーを入力する必要があります。

      戻り値:
      LDAP ツリーで呼び出し元を検索するためのベース DN。
      デフォルト:
      ""

    • callerSearchFilter

      StringSE callerSearchFilter
      callerSearchBase が設定されている場合に呼び出し元を検索するための検索フィルター。検索は、callerSearchScope で指定された範囲で、callerSearchBase DN から実行されます。
      戻り値:
      式を検索して呼び出し元を見つけます。
      デフォルト:
      ""

    • callerSearchScope

      LdapIdentityStoreDefinition.LdapSearchScope callerSearchScope
      呼び出し元検索の検索範囲: LDAP ツリーでの検索の深さを決定します。
      戻り値:
      検索範囲
      デフォルト:
      SUBTREE

    • callerSearchScopeExpression

      StringSE callerSearchScopeExpression
      callerSearchScope を Jakarta Expression Language 式として指定できるようにします。設定すると、callerSearchScope で設定された値が上書きされます。
      戻り値:
      callerSearchScope Jakarta Expression Language 表現
      デフォルト:
      ""

    • groupSearchBase

      StringSE groupSearchBase
      グループを検索するための検索ベース（ "ou=group,dc=eclipse,dc=net" など）。

      グループ検索を実行するストアにのみ必要です。bindDn メンバーを入力する必要があります。

      戻り値:
      LDAP ツリーでグループを検索するためのベース DN。
      デフォルト:
      ""

    • groupSearchFilter

      StringSE groupSearchFilter
      groupSearchBase が設定されている場合にグループを検索するための検索フィルター。検索は、groupSearchScope で指定された範囲で、groupSearchBase DN から開始して実行されます。
      戻り値:
      式を検索してグループを見つけます。
      デフォルト:
      ""

    • groupSearchScope

      LdapIdentityStoreDefinition.LdapSearchScope groupSearchScope
      グループ検索の検索範囲は、LDAP ツリーでの検索の深さを決定します。
      戻り値:
      検索範囲
      デフォルト:
      SUBTREE

    • groupSearchScopeExpression

      StringSE groupSearchScopeExpression
      groupSearchScope を Jakarta Expression Language 式として指定できるようにします。設定すると、groupSearchScope で設定された値が上書きされます。
      戻り値:
      groupSearchScope Jakarta Expression Language 表現
      デフォルト:
      ""

    • groupNameAttribute

      StringSE groupNameAttribute
      グループ名を表すグループオブジェクトの属性の名前 (例: "cn" )
      戻り値:
      グループ名を表す属性の名前
      デフォルト:
      "cn"

    • groupMemberAttribute

      StringSE groupMemberAttribute
      グループのメンバーを識別するグループオブジェクト内の属性の名前（例: "member" ）。

      この属性の値は、呼び出し元の完全な DN である必要があります。以下に、ldif 形式のエントリの例を示します。

       
 dn: cn=foo,ou=group,dc=eclipse,dc=net
 objectclass: top
 objectclass: groupOfNames
 cn: foo
 member: uid=pete,ou=caller,dc=eclipse,dc=net
 member: uid=john,ou=caller,dc=eclipse,dc=net
      戻り値:
      グループメンバーの属性
      デフォルト:
      " メンバー "

    • groupMemberOfAttribute

      StringSE groupMemberOfAttribute
      呼び出し元が属するグループを識別する個人オブジェクトの属性の名前（例: "memberOf" ）。

      この属性は、a) グループ検索が構成されていない (つまり、groupSearchBase と groupSearchFilter が構成されていない) 場合にのみ使用されます。また、b) 認証情報検証フェーズ中に、検証とグループ検索の両方を実行する ID ストアによってグループが返されているか、IdentityStore.getCallerGroups(CredentialValidationResult) メソッドに渡される CredentialValidationResult で DN が使用可能であるため、呼び出し元の DN が使用可能です。

      この属性の値は、グループの完全な DN である必要があります。以下に、ldif 形式のエントリの例を示します。

       
 dn: uid=peter,ou=caller,dc=eclipse,dc=net
 objectclass: top
 objectclass: uidObject
 objectclass: person
 uid: peter
 cn: Peter Smith
 memberOf: cn=foo,ou=group,dc=eclipse,dc=net
 memberOf: cn=bar,ou=group,dc=eclipse,dc=net
      戻り値:
      グループメンバーシップの属性
      デフォルト:
      "memberOf"

    • readTimeout

      int readTimeout
      LDAP サーバーが結果を返すのを待つときに使用するタイムアウト値を設定します。これは、基礎となるソケット接続の接続タイムアウトとは異なることに注意してください。

      デフォルト値の 0 は、永久に待機することを意味します（接続自体がタイムアウトしないと想定）。

      戻り値:
      readTimeout 値。
      デフォルト:
      0

    • readTimeoutExpression

      StringSE readTimeoutExpression
      readTimeout を Jakarta Expression Language 式として指定できるようにします。設定すると、readTimeout で設定された値が上書きされます。
      戻り値:
      readTimeout Jakarta Expression Language 表現
      デフォルト:
      ""

    • maxResults

      int maxResults
      検索にレスポンスしてサーバーが返す結果（オブジェクト）の最大数を設定します。

      デフォルト値は 1000 に設定されています。これは、ほとんどの LDAP サーバーが 1 回のレスポンスで返す結果の最大数に対応します。ほとんどの LDAP サーバーは、1000 を超える結果セットを介したページングをサポートしていますが、通常の検証およびグループルックアップのユースケースでは、そうする必要はほとんどありません。組み込みの LDAP IdentityStore の実装は、より大きな結果セットを介したページングをサポートする場合がありますが、必須ではありません。

      戻り値:
      LDAP サーバーが返す必要のある結果の最大数。
      デフォルト:
      1000

    • maxResultsExpression

      StringSE maxResultsExpression
      maxResults を Jakarta Expression Language 式として指定できるようにします。設定すると、maxResults で設定された値が上書きされます。
      戻り値:
      maxResults Jakarta Expression Language 表現
      デフォルト:
      ""

    • priority

      int priority
      複数の IdentityStores が見つかった場合の順序を決定します。
      戻り値:
      優先順位。
      デフォルト:
      80

    • priorityExpression

      StringSE priorityExpression
      優先度を Jakarta Expression Language 式として指定できるようにします。設定されている場合、優先度で設定された値を上書きします。
      戻り値:
      優先 Jakarta Expression Language 式
      デフォルト:
      ""

    • useFor

      IdentityStore.ValidationType[] useFor
      ID ストアの用途を決定します
      戻り値:
      ID ストアが使用される型
      デフォルト:
      {VALIDATE, PROVIDE_GROUPS}

    • useForExpression

      StringSE useForExpression
      useFor を Jakarta Expression Language 式として指定できるようにします。設定すると、useFor で設定された値が上書きされます。
      戻り値:
      useFor Jakarta Expression Language 表現
      デフォルト:
      ""