Skip to main content

Tutorial: Changing the XML-RPC Function Support

Abstract

Change the XML-RPC function support in Access Server, which allows you to control Access Server functionalities remotely.

Overview

This tutorial explains how to change the XML-RPC function support in Access Server, which allows you to control Access Server functionalities remotely.

Prerequisites

  • An installed Access Server.

  • Console access with root privileges.

Step 1: Enable XML-RPC debugging

  • To see XML-RPC calls on the command line with the sacli VPNSummary function use:

    OPENVPN_AS_DEBUG_XML=1 ./sacli VPNSummary

  • This will display the XML query and response, helping you understand the necessary calls.

Step 2: Change XML-RPC function support

  • Use the following command to change the XML-RPC support level:

    ./sacli --key "xmlrpc.relay_level" --value <NUMBER>1 ConfigPut
./sacli start

    1

    Replace <NUMBER> with one of the following values:

    • 0 — Disable XML-RPC API entirely, which breaks server-locked profile-type connections.

    • 1 — Enable limited XML-RPC API for server-locked profile-type connections only (default).

    • 2 — Fully enable XML-RPC API, allowing full remote control of Access Server's functions.

Step 3: Restart the server

  • Ensure the changes take effect by restarting the Access Server service:

    ./sacli start

By following these steps, you can configure and utilize the XML-RPC interface on your Access Server, allowing for enhanced remote management capabilities.

In this section: