Configuring Private RPS Account

PortSIP PBX allows customers to configure their own private Remote Provisioning Server (RPS) accounts for automatic IP phone provisioning. Using a private RPS simplifies device management and improves security by giving you direct control over IP phone provisioning credentials and workflows.

---

Prerequisites

• Administrator access to the PBX host

• RPS credentials provided by the IP phone vendor(s) you plan to use

• Permission to restart PBX services

---

Step 1: Locate the Configuration File

Open the system.ini file on your PBX server:

• Linux: /var/lib/portsip/pbx/system.ini

---

Step 2: Add RPS Configuration

Append the relevant sections below to system.ini, based on the IP phone brands you want to configure. Save the file after making your changes.

Yealink

[yealink]
accesskey_id = xxxx
accesskey_secret = xxxx

ALE (Alcatel-Lucent Enterprise)

[ale]
accesskey_id = xxxx
accesskey_secret = xxxx

Grandstream

[grandstream]
username = xxxx
password = xxxx
# The value of the password field must be: sha256(md5(password))
api_id = xxxx
api_secret = xxxx
site_id = xxxx

Fanvil

[fanvil]
username = xxxx
password = xxxx
# The value of the password field must be: md5(md5(password))

Htek

[htek]
username = xxxx
password = xxxx

Snom

[snom]
username = xxxx
password = xxxx

---

Security Note Always follow the vendor-specific password hashing requirements exactly. Storing improperly hashed passwords will cause provisioning failures.

---

Step 3: Restart the Provisioning Service

After updating the configuration file, restart the provisioning service to apply the changes.

Linux

1. Open a terminal.

2. Navigate to the PortSIP directory:

   cd /opt/portsip

3. Restart the provisioning service:

   sudo /bin/sh pbx_ctl.sh restart -s portsip.provision