50 lines
2.0 KiB
Markdown
50 lines
2.0 KiB
Markdown
# OTRS Turbo
|
|
|
|
REST API client and ticket dashboard for OTRS / Znuny.
|
|
|
|
## Setup Customer User API Integration (LDAP support)
|
|
|
|
To retrieve customer users from external backends like LDAP or Active Directory, you must install custom Generic Interface operations on the OTRS server.
|
|
|
|
### 1. Copy Perl Backend Modules
|
|
Copy the custom Perl modules from the `otrs-backend-modules` folder to your OTRS server:
|
|
|
|
- Copy `otrs-backend-modules/CustomerUserSearch.pm` to:
|
|
`/opt/otrs/Kernel/GenericInterface/Operation/CustomerUser/CustomerUserSearch.pm`
|
|
|
|
- Copy `otrs-backend-modules/CustomerUserGet.pm` to:
|
|
`/opt/otrs/Kernel/GenericInterface/Operation/CustomerUser/CustomerUserGet.pm`
|
|
|
|
*(Note: Create the directory `/opt/otrs/Kernel/GenericInterface/Operation/CustomerUser/` if it does not exist).*
|
|
|
|
### 2. Copy XML Configuration Registration
|
|
Copy the configuration registration XML file to enable the new operation endpoints in OTRS system configuration:
|
|
|
|
- Copy `otrs-backend-modules/CustomerUserGenericInterface.xml` to:
|
|
`/opt/otrs/Kernel/Config/Files/XML/CustomerUserGenericInterface.xml`
|
|
|
|
### 3. Rebuild OTRS Configuration
|
|
Run the following commands on the OTRS server as the `otrs` user to apply the changes:
|
|
|
|
```bash
|
|
# Rebuild the system configuration database
|
|
/opt/otrs/bin/otrs.Console.pl Maint::Config::Rebuild
|
|
|
|
# Reset permissions (if needed)
|
|
/opt/otrs/bin/otrs.SetPermissions.pl
|
|
|
|
# Delete OTRS cache
|
|
/opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete
|
|
```
|
|
|
|
### 4. Enable Operations in your Web Service
|
|
1. Log in to the OTRS/Znuny Admin interface.
|
|
2. Go to **Web Service Management** and select your web service (e.g., `GenericTicketConnectorREST`).
|
|
3. Add the two operations:
|
|
- **`CustomerUserSearch`** (Controller: `CustomerUser::CustomerUserSearch`)
|
|
- **`CustomerUserGet`** (Controller: `CustomerUser::CustomerUserGet`)
|
|
4. Configure the route mappings for these operations:
|
|
- `CustomerUserSearch` -> RequestMethod: `POST`, Route: `/CustomerUserSearch`
|
|
- `CustomerUserGet` -> RequestMethod: `POST`, Route: `/CustomerUserGet`
|
|
5. Save the web service.
|