Article ID: 8861, created on Aug 20, 2010, last review on Dec 24, 2015

  • Applies to:
  • Business Automation 5.4
  • Business Automation 5.1


Is it possible to configure BA so that it accept APIs only from authorizated users?


If authentication is enabled, it is possible to allow access to BA from outside network provided that BA user login and password are passed. External connection then is allowed using the port specified.

Note: These instructions are for BA 5.0, 5.1 and 5.4. Insctructions for BA 5.5 can be found in documentation, for 6.0.x - (if version of BA is below 5.5.5 please also check the following article).

Perform the following actions on the BA Management Node to enable authentication:

  1. Stop BA:

    /etc/init.d/pba stop
  2. Copy the configuration file /usr/local/bm/etc/ssm.conf.d/.xmlrpcd.conf to the /usr/local/bm/etc/ssm.conf.d/.xmlrpcd_auth.conf file:

    cp /usr/local/bm/etc/ssm.conf.d/.xmlrpcd.conf /usr/local/bm/etc/ssm.conf.d/.xmlrpcd_auth.conf
  3. Copy the configuration file /usr/local/bm/etc/ssm.conf.d/.xrproxy.conf to the /usr/local/bm/etc/ssm.conf.d/.xrproxy_auth.conf file:

    cp /usr/local/bm/etc/ssm.conf.d/.xrproxy.conf /usr/local/bm/etc/ssm.conf.d/.xrproxy_auth.conf

Note: It is important that the copied files' names start with a dot.

  1. Create two new empty files:

  2. Add the following strings into the /usr/local/bm/etc/ssm.conf.d/xmlrpcd_auth.conf file:

    bin = xmlrpcd
    summary = Stellart XML RPC AUTH Server
    arguments = $(XMLRPCD_PORT)
  3. Add the following strings into the /usr/local/bm/etc/ssm.conf.d/xrproxy_auth.conf file:

    bin =
    summary = Stellart XML RPC AUTH Proxy Server
    arguments = 5924 5930 5931 5932 5933 5934
  4. To automatically start authentication on PBA-E start, edit the [options] section of the /usr/local/bm/etc/ssm.conf.d/global.conf file as follows:

    startdep = amt muxd www xmlrpcd xrproxy xmlrpcd_auth xrproxy_auth
  5. Start BA:

    /etc/init.d/pba start
  6. Allow access from outside network to the port 5924 at BA application server. This port will be used for incoming XML RPC requests with authorization.

  7. Optionally, consider to disable non-authorized access to BA XML RPC server by closing the port 5224 in firewall for outside network.

Note: BA 5.0.0-636 HOTFIX 007 must be installed.

Search Words

correcting privileges issue breaks xmlrpcd_auth port availability after BA restart

xmlrpcd_auth service enabled, but does not start on PBA restart

198398b282069eaf2d94a6af87dcb3ff caea8340e2d186a540518d08602aa065 210d017ddc3a076d22f0f865b1cf0730 92711db0799e8aefe8e51f12dace0496 dc47a2d05ec4d64fb099e4dab79ce579 e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF