10. Provisioning interfaces

The sip:provider CE provides two provisioning interfaces for easy interconnection with 3rd party tools. The user can access all the functionalities provided by the Admin interface or the CSC interface via SOAP or XMLRPC interfaces. The server provides online documentation about all the functions available. To access the online documentation for the first time, you need to follow the following instructions:

Generate a password for http access to the provisioning interfaces:

htpasswd -nbs myuser mypassword


	Also see `man 1 htpasswd` on how to generate crypt or MD5 passwords if you like. Of course you may use any other process to generate crypt, MD5 or SHA hashed passwords. But using `htpasswd` ensures the hashes are also understood by Apache.

Edit /etc/ngcp-config/config.yml. Under section ossbss→htpasswd, replace user and pass with your new values and execute ngcpcfg apply as usual.
Access https://<ip>:2443/SOAP/Provisioning.wsdl and login with your new credentials.


	The default port for provisioning interfaces is 2443. You can change it in /etc/ngcp-config/config.yml by modifying ossbss→apache→port and execute ngcpcfg apply.


	The displayed online API documentation shows all the currently available functionalities. Enabling or disabling features in /etc/ngcp-config/config.yml will directly reflect in the functions being available via the APIs.


	If your SOAP client throws errors because of the inline <documentation> tags (e.g. Visual Studio and the stock PHP SOAP client complain about this), try to use the WSDL URL https://<ip>:2443/SOAP/Provisioning.wsdl?plain instead, which supresses the output of these tags.