Skip to content

Commit

Permalink
Fixes wso2#8439 and wso2#8597
Browse files Browse the repository at this point in the history
  • Loading branch information
RusJaI committed Nov 1, 2024
1 parent 42e7cc0 commit 07e621c
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 31 deletions.
Original file line number Diff line number Diff line change
@@ -1,15 +1,5 @@
# Configuring a Read-Only LDAP User Store

User management functionality is provided by default in all WSO2 Carbon-based products and is configured in the `deployment.toml` file found in the `<API-M_HOME>/repository/conf/` directory and the changes will be automatically applied to `user-mgt.xml` file in `<API-M_HOME>/repository/conf/` directory as well. This file is shipped with user store manager configurations for all possible user store types (JDBC, read-only LDAP/Active Directory, read-write LDAP and read-write Active directory). The instructions given below explains how to configure a read-only LDAP as the primary user store for the WSO2 server.

!!! info
The default User Store

The primary user store that is configured by default in the user-mgt.xml file is a JDBC user store, which reads/writes into the internal database of the product server. By default, the internal database is H2 for all WSO2 products excluding the Identity Server.
Note that the RDBMS used in the default configuration can remain as the database used for storing Authorization information.

Follow the given steps to configure a read-only LDAP/AD as the primary user store:

- [Step 1: Setting up the read-only LDAP/AD user store manager](#ConfiguringaRead-OnlyLDAPUserStore-Step1:Settinguptheread-onlyLDAP/ADuserstoremanager)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,5 @@
#Configuring a Read-Write Active Directory User Store

!!! info
The default User Store

The primary user store that is configured by default in the `user-mgt.xml` file is a JDBC user store, which reads/writes into the internal database of the product server. By default, the internal database is H2 for all WSO2 products excluding WSO2 Identity Server.

Note that the RDBMS used in the default configuration can remain as the database used for storing Authorization information.

Follow the given steps to configure an external Active Directory as the primary user store:

- [Step 1: Setting up the external AD user store manager](#step-1-setting-up-the-external-ad-user-store-manager)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,16 +1,13 @@
# Configuring a Read-Write LDAP User Store

User management functionality is provided by default in all WSO2 Carbon-based products and is configured in the `deployment.toml` file found in the `<PRODUCT_HOME>/repository/conf/` directory and the changes will be automatically applied to `user-mgt.xml` file in `<PRODUCT_HOME>/repository/conf/` directory as well. This file is shipped with user store manager configurations for all possible user store types (JDBC, read-only LDAP/Active Directory, read-write LDAP and read-write Active directory). The instructions given below explains how to configure a read-write LDAP as the primary user store for the WSO2 server.

!!! info
The default User Store

The primary user store that is configured by default in the user-mgt.xml file of WSO2 products is a JDBC user store, which reads/writes into the internal database of the product server. By default, the internal database is H2. This database is used by the Authorization Manager (for user authentication information) as well as the User Store Manager (for defining users and roles). In the case of the WSO2 Identity Server, the default user store is an LDAP (Apache DS) that is shipped with the product.
Follow the given steps to configure a read-write LDAP as the primary user store:

!!! info "Note"

Note that the RDBMS used in the default configuration can remain as the database used for storing Authorization information.
While the default primary user store of WSO2 API Manager is a JDBC usser store, WSO2 Identity server 5.11.0 is shipped with a Read-Write LDAP as the primary user store.
While the user has the freedom to choose any Read-Write LDAP, in this guide WSO2 Identity Server is used as the Read-Write LDAP.
Hence in this guide it is assumed that WSO2 Identity Server 5.11.0 is up and running with the port offset = 1.

Follow the given steps to configure a read-write LDAP as the primary user store:

- [Step 1: Setting up the read-write LDAP user store manager](#ConfiguringaRead-WriteLDAPUserStore-Step1:Settinguptheread-writeLDAPuserstoremanager)
- [Step 2: Updating the system administrator](#ConfiguringaRead-WriteLDAPUserStore-Step2:Updatingthesystemadministrator)
Expand Down Expand Up @@ -58,7 +55,7 @@ Before you begin
UserRolesCacheEnabled= "true"
ConnectionRetryDelay= "2m"
```
- The `class` attribute for a read-write LDAP is `<UserStoreManager class="org.wso2.carbon.user.core.ldap.ReadWriteLDAPUserStoreManager">`
- If you are using the WSO2 Identity server as the Read-Write LDAP, the `class` attribute is `<UserStoreManager class="org.wso2.carbon.user.core.ldap.ReadWriteLDAPUserStoreManager">`
```
[user_store]
class="org.wso2.carbon.user.core.ldap.ReadWriteLDAPUserStoreManager"
Expand Down Expand Up @@ -177,7 +174,7 @@ The configuration for the external read/write user store in the `user-mgt.xml` f
MembershipAttribute = "member"
```
To read roles based on a backlink attribute, use thefollowingcodesnipetinsteadofthe above:
To read roles based on a backlink attribute, use the following code snipet instead of the above:
```
ReadGroups = "false"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,14 @@

This documentation explains the process of setting up a primary user store for your system.

!!! info
**The default User Store**
!!! info "The default User Store"

The primary user store that is configured by default, is a JDBC user store, which reads/writes into an internal database. By default, the internal database is H2. This database is used by the Authorization Manager (for user authorization information) as well as, the User Store Manager (for defining users and roles).
The primary user store in of WSO2 products is configured by default as a JDBC user store in the user-mgt.xml file, which reads/writes into the internal database of the product server. This internal database is typically H2 by default. This database is used by both the Authorization Manager (for managing user authentication data) and the User Store Manager (for defining users and roles).
In the case of the WSO2 Identity Server 5.11.0, the default user store is an LDAP (Apache DS) that is shipped with the product.
Note that the RDBMS used in the default configuration can remain as the database used for storing Authorization information.


Instead of using the embedded database, you can set up a separate repository and configure it as your primary user store. Since the user store you want to connect to might have different schemas from the ones available in the embedded user store, it needs to go through an adaptation process. We do the necessary adaptations depending on the user store type. We support the following primary user store types.
Instead of using the embedded database in WSO2 API Manager, you can set up a separate repository and configure it as your primary user store. Since the user store you want to connect to might have different schemas from the ones available in the embedded user store, it needs to go through an adaptation process. We do the necessary adaptations depending on the user store type. We support the following primary user store types.

<table>
<colgroup>
Expand Down

0 comments on commit 07e621c

Please sign in to comment.