/
Changing the FreeSWITCH mod_event_socket Password in ASTPP

Changing the FreeSWITCH mod_event_socket Password in ASTPP

Overview

mod_event_socket is a TCP-based interface that allows external applications to communicate with FreeSWITCH. ASTPP uses this interface to:

  • Retrieve live data from FreeSWITCH's command line into the ASTPP GUI.

  • Send commands from the GUI to FreeSWITCH.

This interface is password-protected for security reasons. The default password is ClueCon, but for better security practices, it’s recommended to change it periodically or upon customer request.

This guide explains how to safely change the mod_event_socket password and ensure ASTPP remains connected to FreeSWITCH.

🛠️ Step-by-Step Instructions

1️⃣ Update the Password in FreeSWITCH Configuration

Edit the event_socket.conf.xml file to update the password.

Path to config file:

/usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml

Modify the following line:

<param name="password" value="Your_Secure_P@ssword"/>

 

Make sure to choose a strong password that combines uppercase, lowercase, numbers, and symbols.

2️⃣ Restart the FreeSWITCH Service

After changing the password in the config file, you must restart FreeSWITCH to apply the changes.

sudo systemctl restart freeswitch

 

3️⃣ Update Password in ASTPP GUI

To ensure ASTPP can continue communicating with FreeSWITCH using the new password:

  1. Log in to ASTPP as an admin user.

  2. Go to:
    Switch → FreeSWITCH Servers

    image-20250411-134852.png

  3. Update the password to match the one you just configured in event_socket.conf.xml.

  4. Save the changes.

4️⃣ Test Connection with New Password (Optional)

You can manually test the new password using fs_cli:

fs_cli -pYour_Secure_P@ssword

If successful, you will enter the FreeSWITCH CLI prompt.

🔒 Security Best Practices

  • Avoid weak passwords like "123456", "ClueCon", or "password".

  • Store passwords securely, preferably in a password manager.

  • Change the password periodically and after any security incidents.

  • Do not share the password over insecure channels like plain email.

👥 Who Should Use This Guide?

This guide is intended for:

  • ASTPP technical support engineers

  • Internal system administrators

  • Customers with admin-level access to ASTPP and FreeSWITCH