public static void EnableEventSocket()
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", ModulesFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "/configuration/modules//load[@module='mod_event_socket']";
XmlNode node = doc.SelectSingleNode(xpath);
if (node == null)
{
XmlNode new_node = doc.CreateNode(XmlNodeType.Element, "load", null);
XmlAttribute attribute = doc.CreateAttribute("module");
attribute.Value = "mod_event_socket";
new_node.Attributes.Append(attribute);
//找到正確的節點後把新創的node掛在它底下...
xpath = "/configuration/modules";
node = doc.SelectSingleNode(xpath);
node.AppendChild(new_node);
XMLUtils.SaveXML(doc, file);
}
}
public static void AddACL(string list_name, string cidr_ip, FS_ACL action)
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", AclFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = string.Format("/configuration/network-lists/list[@name='{0}']", list_name);
XmlNode node = doc.SelectSingleNode(xpath);
//只找現有的ACL_List來增加 acl node....沒找到就不做了
//ACL node範例 <node type="allow" cidr="192.168.0.0/16" />
if (node != null)
{
XmlNode new_node = doc.CreateNode(XmlNodeType.Element, "node", null);
XmlAttribute attribute = doc.CreateAttribute("cidr");
attribute.Value = cidr_ip;
new_node.Attributes.Append(attribute);
attribute = doc.CreateAttribute("type");
attribute.Value = action.ToString();
new_node.Attributes.Append(attribute);
node.AppendChild(new_node);
XMLUtils.SaveXML(doc, file);
}
}
//增加一個ACL List
public static void AddAclList(string list_name, FS_ACL action)
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", AclFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = string.Format("/configuration/network-lists/list[@name='{0}']", list_name);
XmlNode node = null;
XmlNode acl_list = doc.SelectSingleNode(xpath);
if (null == acl_list)
{
xpath = string.Format("/configuration/network-lists");
node = doc.SelectSingleNode(xpath);
acl_list = doc.CreateNode(XmlNodeType.Element, "list", null);
XmlAttribute attribute = doc.CreateAttribute("name");
attribute.Value = list_name;
acl_list.Attributes.Append(attribute);
attribute = doc.CreateAttribute("default");
attribute.Value = action.ToString();
acl_list.Attributes.Append(attribute);
node.AppendChild(acl_list);
XMLUtils.SaveXML(doc, file);
}
}
//SMS設定 (SIP Message)
public static void EnableSipMessage()
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", SMSFile });
if (System.IO.File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "/configuration/modules/load[@module='mod_sms']";
XmlNode node = doc.SelectSingleNode(xpath);
if (node == null)
{
xpath = "/configuration/modules";
node = doc.SelectSingleNode(xpath);
XmlNode new_node = doc.CreateNode(XmlNodeType.Element, "load", null);
XmlAttribute attribute = doc.CreateAttribute("module");
attribute.Value = "mod_sms";
new_node.Attributes.Append(attribute);
new_node.Attributes.Append(attribute);
node.AppendChild(new_node);
XMLUtils.SaveXML(doc, file);
}
else
{
Log.Error($"node [{xpath}] not found, skip...");
}
}
public static void ResetFreeSwitchIP()
{
string file = Path.Combine(new string[] { ConfigPath, GlobalVarsFile });
if (System.IO.File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
//用XPath找 include下的X-PRE-PROCESS 節點，並且該節點attribute為 cmd='set' 與 data='local_ip_v4=$${force_local_ip_v4}'
//資料樣本 <X-PRE-PROCESS cmd="set" data="local_ip_v4=$${force_local_ip_v4}"/>
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "/include/X-PRE-PROCESS[@cmd='set'][@data='local_ip_v4=$${force_local_ip_v4}']";
XmlNode node = doc.SelectSingleNode(xpath);
if (null != node)
{
node.ParentNode.RemoveChild(node);
}
xpath = "/include/X-PRE-PROCESS[@cmd='set'][contains(@data, 'local_ip_v4=')]";
node = doc.SelectSingleNode(xpath);
if (node != null)
{
node.ParentNode.RemoveChild(node);
}
XMLUtils.SaveXML(doc, file);
}
//在指定的ACL List裡增加幾個allow與deny的 node (List裡的 string必須為CIDR格式)
public static void AddACL(string list_name, List <string> allow_list, List <string> deny_list)
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", AclFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = string.Format("/configuration/network-lists/list[@name='{0}']", list_name);
XmlNode acl_list = null;
XmlNode node = null;
acl_list = doc.SelectSingleNode(xpath);
//去找名為 %list_name 的ACL List，如果沒找到就不做事了....
if (acl_list == null)
{
return;
}
foreach (var cidr_ip in allow_list)
{
//每個ACL node 放在 configuration/network-lists/list 下
//範例： <node type="allow" cidr="192.168.0.0/16" />
XmlNode new_node = doc.CreateNode(XmlNodeType.Element, "node", null);
XmlAttribute attribute = doc.CreateAttribute("cidr");
attribute.Value = cidr_ip;
new_node.Attributes.Append(attribute);
attribute = doc.CreateAttribute("type");
attribute.Value = FS_ACL.allow.ToString();
new_node.Attributes.Append(attribute);
acl_list.AppendChild(new_node);
}
foreach (var cidr_ip in deny_list)
{
//每個ACL node 放在 configuration/network-lists/list 下
//範例： <node type="allow" cidr="192.168.0.0/16" />
XmlNode new_node = doc.CreateNode(XmlNodeType.Element, "node", null);
XmlAttribute attribute = doc.CreateAttribute("cidr");
attribute.Value = cidr_ip;
new_node.Attributes.Append(attribute);
attribute = doc.CreateAttribute("type");
attribute.Value = FS_ACL.deny.ToString();
new_node.Attributes.Append(attribute);
acl_list.AppendChild(new_node);
}
XMLUtils.SaveXML(doc, file);
}
public static void RemoveAclList(string list_name)
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", AclFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = string.Format("/configuration/network-lists/list[@name='{0}']", list_name);
XmlNode node = doc.SelectSingleNode(xpath);
if (node != null)
{
node.ParentNode.RemoveChild(node);
XMLUtils.SaveXML(doc, file);
}
}
public static void DisableEventSocket()
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", ModulesFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "/configuration/modules//load[@module='mod_event_socket']";
XmlNode node = doc.SelectSingleNode(xpath);
if (node != null)
{
node.ParentNode.RemoveChild(node);
XMLUtils.SaveXML(doc, file);
}
}
public static void SetEventSocketPwd(string pwd)
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", EventSocketFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = string.Format("/configuration/settings/param[@name='password']");
XmlNode node = doc.SelectSingleNode(xpath);
if (node != null)
{
node.Attributes["value"].Value = pwd;
XMLUtils.SaveXML(doc, file);
}
}
public static void SetLogLevel(FS_LOG_LEVEL level)
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", MainFile });
if (File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
//XML的節點查詢用xpath語法....
string xpath = "/configuration/settings//param[@name='loglevel']";
XmlNode node = doc.SelectSingleNode(xpath);
node.Attributes["value"].Value = level.ToString();
XMLUtils.SaveXML(doc, file);
}
public static void DisableSipMessage()
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", SMSFile });
if (System.IO.File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "/configuration/modules/load[@module='mod_sms']";
XmlNode node = doc.SelectSingleNode(xpath);
if (node != null)
{
node.ParentNode.RemoveChild(node);
XMLUtils.SaveXML(doc, file);
}
else
{
Log.Error($"node [{xpath}] not found, skip...");
}
}
// vars.xml內的資料樣本
// <X-PRE-PROCESS cmd="set" data="force_local_ip_v4=172.16.65.145"/>
// <X-PRE-PROCESS cmd="set" data="local_ip_v4=$${force_local_ip_v4}"/>
//FreeSwitch不能直接改 local_ip_v4 變數，它每分鐘會refresh一次
//要用這種方法去強迫它變更，這API必須用在FreeSwitch Server有多IP或多網卡的狀況。
//如果不強迫指定，它只會抓OS回報的第一個IP(順序不定)
/// <summary>
/// 在vars.xml裡設定 force_local_ip_v4 變數，以強迫指定 FreeSwitch的local ip
/// </summary>
/// <param name="config_path">
/// FreeSwitch Config Path，包括 conf 目錄。例如 "/usr/local/freeswitch/conf"
/// 或 "C:\Program Files\FreeSwitch\conf"
/// </param>
/// <param name="ip">要指定的IP</param>
public static void SetFreeSwitchIP(string ip)
{
string file = Path.Combine(new string[] { ConfigPath, GlobalVarsFile });
if (System.IO.File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
//用XPath找 include下的X-PRE-PROCESS 節點，並且該節點attribute為 cmd='set' 與 data='local_ip_v4=$${force_local_ip_v4}'
//資料樣本 <X-PRE-PROCESS cmd="set" data="local_ip_v4=$${force_local_ip_v4}"/>
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "";
XmlNode node = null;
XmlNode child = null;
XmlAttribute attribute = null;
//20190804 Roy: 這邊有個詭異的Bug，原本以為變數設定不需考慮順序，但其實必須照順序來設
//如果在XML檔先寫 local_ip_v4=$${force_local_ip_v4} 這行，後面才寫 force_local_ip_v4=192.168.20.18
//這樣會造成sofia(sip module)錯亂，不是無法啟動就是直接跑去執行 external profile.....
xpath = "/include/X-PRE-PROCESS[@cmd='set'][contains(@data, 'force_local_ip_v4=')]";
node = doc.SelectSingleNode(xpath);
if (node == null)
{
Log.Debug("node force_local_ip_v4 not found, add it");
child = doc.CreateNode(XmlNodeType.Element, "X-PRE-PROCESS", null);
attribute = doc.CreateAttribute("cmd");
attribute.Value = "set";
child.Attributes.Append(attribute);
attribute = doc.CreateAttribute("data");
attribute.Value = string.Format("force_local_ip_v4={0}", ip);
child.Attributes.Append(attribute);
xpath = "/include";
node = doc.SelectSingleNode(xpath);
node.AppendChild(child);
}
else
{
Log.Debug($"node force_local_ip_v4 modify to {ip}");
node.Attributes["data"].Value = string.Format("force_local_ip_v4={0}", ip);
}
xpath = "/include/X-PRE-PROCESS[@cmd='set'][@data='local_ip_v4=$${force_local_ip_v4}']";
node = doc.SelectSingleNode(xpath);
if (null == node)
{
//create node
child = doc.CreateNode(XmlNodeType.Element, "X-PRE-PROCESS", null);
attribute = doc.CreateAttribute("cmd");
attribute.Value = "set";
child.Attributes.Append(attribute);
attribute = doc.CreateAttribute("data");
attribute.Value = "local_ip_v4=$${force_local_ip_v4}";
child.Attributes.Append(attribute);
xpath = "/include";
node = doc.SelectSingleNode(xpath);
node.AppendChild(child);
}
else
{
Log.Error("local_ip_v4=$${force_local_ip_v4} exists, skip add node");
}
XMLUtils.SaveXML(doc, file);
}
//FreeSwitch的SIP Profile預設分為internal與external，因為欄位太多太複雜所以不做清除，只做修改。
//裡面的 <param name='context' value='xxxx'> 欄位 xxxx要指定 dialplan名稱，
// 例如<param name="context" value="sip_call"/>
// <param name="apply-inbound-acl" value="xxxxx"/> 欄位 xxxxx要指定ACL list 名稱，
// 例如 <param name="apply-inbound-acl" value="domains"/>
public static void SetSipProfileInternal(string dialplan, string acl_list)
{
string file = Path.Combine(new string[] { ConfigPath, "sip_profiles", SipProfileInternalFile });
if (System.IO.File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = "/profile/settings/param[@name='context']";
XmlNode node = doc.SelectSingleNode(xpath);
XmlAttribute attribute = null;
XmlNode parent = null;
if (node != null)
{
node.Attributes["value"].Value = dialplan;
}
else
{
xpath = "/profile/settings";
parent = doc.SelectSingleNode(xpath);
XmlNode child = doc.CreateNode(XmlNodeType.Element, "param", null);
attribute = doc.CreateAttribute("name");
attribute.Value = "context";
child.Attributes.Append(attribute);
attribute = doc.CreateAttribute("value");
attribute.Value = dialplan;
child.Attributes.Append(attribute);
parent.AppendChild(child);
}
//綁定ACL，不然預設是會reject incoming connection
//注意ACL那邊也要設定好同名的ACL list，並加入allow ip range(CIDR)
xpath = "/profile/settings/param[@name='apply-inbound-acl']";
node = doc.SelectSingleNode(xpath);
if (node == null)
{
//這個inbound acl好像預設是關掉的...所以要檢查是否存在。
node = doc.CreateNode(XmlNodeType.Element, "param", null);
attribute = doc.CreateAttribute("name");
attribute.Value = "apply-inbound-acl";
node.Attributes.Append(attribute);
attribute = doc.CreateAttribute("value");
attribute.Value = acl_list;
node.Attributes.Append(attribute);
xpath = "/profile/settings";
parent = doc.SelectSingleNode(xpath);
parent.AppendChild(node);
}
else
{
node.Attributes["value"].Value = acl_list;
}
XMLUtils.SaveXML(doc, file);
}
//清掉指定的Conference設定，重新填回預設值
public static void ResetConferenceConfig()
{
string file = Path.Combine(new string[] { ConfigPath, "autoload_configs", ConferenceFile });
if (System.IO.File.Exists(file) == false)
{
throw new FileNotFoundException($"config file not exist! => {file}");
}
XmlDocument doc = XMLUtils.LoadXML(file);
string xpath = string.Format("/configuration/profiles/profile[@name='{0}']", Conference_Ctx);
XmlNode node = doc.SelectSingleNode(xpath);
XmlNode parent = null;
XmlNode child = null;
Dictionary <string, string> attr_map = new Dictionary <string, string>();
if (node != null)
{
parent = node.ParentNode;
parent.RemoveChild(node);
}
attr_map["name"] = Conference_Ctx;
child = XMLUtils.CreateElementNode(doc, "profile", attr_map);
parent.AppendChild(child);
//切換到 <profile>
parent = child;
attr_map.Clear();
attr_map["name"] = "domain";
attr_map["value"] = "$${domain}";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map.Clear();
attr_map["name"] = "rate";
attr_map["value"] = "8000";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map.Clear();
attr_map["name"] = "interval";
attr_map["value"] = "20";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map.Clear();
attr_map["name"] = "energy-level";
attr_map["value"] = "100";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map.Clear();
attr_map["name"] = "caller-id-name";
attr_map["value"] = "$${outbound_caller_name}";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map.Clear();
attr_map["name"] = "caller-id-number";
attr_map["value"] = "$${outbound_caller_id}";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map.Clear();
attr_map["name"] = "comfort-noise";
attr_map["value"] = "true";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
attr_map["name"] = "auto-gain-level";
attr_map["value"] = "true";
child = XMLUtils.CreateElementNode(doc, "param", attr_map);
parent.AppendChild(child);
XMLUtils.SaveXML(doc, file);
}