Differences

This shows you the differences between two versions of the page.

Link to this comparison view

documentation:2.1:soapconfbackend [2019/01/15 15:55] (current)
Line 1: Line 1:
 +====== SOAP configuration backend (deprecated) ======
  
 +You can share your configuration over the network using SOAP proxy system.
 +
 +<note tip>Note that SOAP is not a real configuration backend, but just a proxy system to access to your configuration over the network</​note>​
 +
 +<note important>​SOAP has been deprecated. Prefer to use [[restconfbackend|REST configuration backend]]</​note>​
 +===== Configuration =====
 +
 +==== First, configure your real backend ====
 +
 +  * On your main server, configure a [[documentation:​1.0:​fileconfbackend|File]],​ [[documentation:​1.0:​sqlconfbackend|SQL]] or [[documentation:​1.0:​ldapconfbackend|LDAP]] backend
 +  * Set SOAP parameter to true in the configuration using the manager: the portal will become a SOAP server
 +  * Configure your web server to allow remote access. Remote SOAP access is disabled by default. You must change it as follow :
 +
 +* in ''​portal-apache2.conf''​ : 
 +<code apache>
 +# SOAP functions for configuration access (disabled by default)
 +<​Location /​index.fcgi/​config>​
 +    Require ip 192.168.2.0/​24
 +</​Location>​
 +</​code>​
 +
 +* in ''​portal-nginx.conf''​ :
 +<code nginx>
 +# SOAP functions for configuration access (disabled by default)
 +location /​index.psgi/​config {
 +  allow 192.168.2.0/​24;​
 +}
 +</​code>​
 +
 +==== Next, configure SOAP for your remote servers ====
 +
 +Change configuration in lemonldap-ng.ini :
 +<file ini>
 +type         = SOAP
 +; Apache
 +proxy        = https://​auth.example.com/​index.fcgi/​config
 +; Nginx
 +proxy        = https://​auth.example.com/​index.pcgi/​config
 +</​file>​
 +You can also add some other parameters
 +<file ini>
 +User         = lemonldap
 +Password ​    = mypassword
 +# LWP::​UserAgent parameters
 +proxyOptions = { timeout => 5 }
 +</​file>​