https://github.com/eip-work/kuboard-v4-ldap-example
Integrate Kuboard v4 with LDAP
https://github.com/eip-work/kuboard-v4-ldap-example
Last synced: about 1 year ago
JSON representation
Integrate Kuboard v4 with LDAP
- Host: GitHub
- URL: https://github.com/eip-work/kuboard-v4-ldap-example
- Owner: eip-work
- License: mit
- Created: 2024-05-12T04:14:50.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-03T10:09:34.000Z (over 1 year ago)
- Last Synced: 2024-11-03T11:18:09.552Z (over 1 year ago)
- Language: Java
- Size: 1.1 MB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kuboard v4 Ldap example
This project is a example to show how to authenticate Kuboard v4 via LDAP server.
Kuboard v4 has a Service Provider Interface to authenticate user and load user details info.
## Prerequisit
To run the example, you have to prepare:
* docker engine >= 20.01
## Run the example
* Execute the following command in the source code root directory.
```sh
git clone https://github.com/eip-work/kuboard-v4-ldap-example.git
cd kuboard-v4-ldap-example
docker compose up -d
```
* Open the following url in your browser
`http://localhost:8000`
* Login with admin user:
* username: `admin`
* password: `Kuboard123`
* Navigate to `系统设置` -> `用户登录设置`:
Navigate to `System Settings` -> `User Authentication Settings` Menu:
* Enable `启用外部用户 Webhook`
Enable `Enable External User Respository`
* Fill in `外部用户 Webhook`
Fill in `External User Respository Webhook`
with value `http://ldap-example:9090/api/kuboard/example/ldap-users`
* Click `保存` button
Click `Save` button
* Logout with the button on the top right of the screen.
* Login with Ldap user:
* username: `user01`
* password: `password1`
or
* username: `user02`
* password: `password2`
* Navigate to `个人信息` -> `所属分组`:
Navigate to `Profile` -> `User Groups` Menu:
We can see that `user01` derives two group bindings from webhook api, `test-group` and `group1`. We could also get to know from menu `个人信息` -> `权限信息` (`Profile` -> `Privileges`) that `user01` has no privilege to do anything at the moment.
To grant `user01` with privileges, take the following actions:
* Login with user `admin`
* Navigate to menu `用户与权限` -> `用户组` (`Users and Roles` -> `Groups`)
* Create a group named `test-group` (or `group1`)
* Bind the group with proper roles.
You can also grant `user01` with privileges by taking following actions:
* Login with user `admin`
* Navigate to menu `用户与权限` -> `用户组` (`Users and Roles` -> `Groups`)
* Click a existing group which has proper privileges
* Bind the group with user `user01`
## Build the example
* Execute the following command in the source code root directory.
```sh
docker build -t eipwork/kuboard-v4-ldap-example:v4 .
```