• ×
    Information
    Windows update impacting certain printer icons and names. Microsoft is working on a solution.
    Click here to learn more
    Information
    Need Windows 11 help?
    Check documents on compatibility, FAQs, upgrade information and available fixes.
    Windows 11 Support Center.
  • post a message
  • ×
    Information
    Windows update impacting certain printer icons and names. Microsoft is working on a solution.
    Click here to learn more
    Information
    Need Windows 11 help?
    Check documents on compatibility, FAQs, upgrade information and available fixes.
    Windows 11 Support Center.
  • post a message
Guidelines
The HP Community is where owners of HP products, like you, volunteer to help each other find solutions.
HP Recommended

One of our customer request to reboot the Vvx 1500 remotely without using the administrative web page, they want to reboot more than one phone at one time.

 

Is there any key action combination XML API to do that? 

 

 

Thanks,

Wenya

2 REPLIES 2
HP Recommended

Hello wenya,

welcome to the Polycom Community.

Please contact myself internally as I do not feel comfortable to post such solution in the public as it could probably be used for something similar like a DDoS attack.

Please ensure to provide some feedback if this reply has helped you so other users can profit from your experience.

Best Regards

Steffen Baier

Polycom Global Services

------------------------------------------------
Notice: I am an HP Poly employee but all replies within the community are done as a volunteer outside of my day role. This community forum is not an official HP Poly support resource, thus responses from HP Poly employees, partners, and customers alike are best-effort in attempts to share learned knowledge.
If you need immediate and/or official assistance for former Poly\Plantronics\Polycom please open a service ticket through your support channels
For HP products please check HP Support.

Please also ensure you always check the General VoIP , Video Endpoint , UC Platform (Microsoft) , PSTN
HP Recommended

I'm wondering why it needs to be via the XML API?  Is that because you think that might be the only way to automate such a thing?

 

There is a publicly-documented way of accomplishing what you want through a configuration option combined with a specially-crafted SIP NOTIFY packet that includes "Event: check-sync" in the headers.  Normally a check-sync NOTIFY will merely cause the phone to check and see if its configuration file(s) on the provisioning server has changed.  If it hasn't changed, the phone does nothing.  If it has changed, the phone will apply the new configuration and then reboot if any of the parameters that changed require a reboot to be applied.  This use of a check-sync NOTIFY is actually pretty common with most hardware SIP endpoints.

 

However, if you include...

 

voIpProt.SIP.specialEvent.checkSync.alwaysReboot="1"

 

...in your configuration, the phone will reboot whenever it receives a check-sync NOTIFY, regardless of whether the configuration file has changed on the provisioning server or not.  As long as you include this option in your provisioning for all of your phones, you should be able to devise an automated/scriptable means of sending check-sync NOTIFYs en-masse to all of the endpoints of yours that you want to reboot simultaneously.

 

As Steffen suggested, implementing such a solution could be compromising security-wise and lead to denial-of-service exploitation of your Polycom endpoints if sufficient attempts at protecting yourself from this are not made.  By default, Polycom UC software does not try to validate check-sync NOTIFYs in any way, which means that any Polycom endpoints you have on public IP addresses not protected by a firewall can be rebooted by anybody.  You could address this problem by ensuring that all phones are behind a firewall or NAT, and then have your mass-reboot tool communicate with the phones over a VPN.  If that is not an option, another thing you can do is add the following parameters to your phone configuration:

 

voIpProt.SIP.requestValidation.1.request="NOTIFY"
voIpProt.SIP.requestValidation.1.request.1.event="check-sync"  
voIpProt.SIP.requestValidation.1.method="digest"

 

With this in place, the phones will challenge and validate each incoming check-sync NOTIFY request using digest authentication.  If you use this, though, your tool or script will not be able to just blindly send check-sync NOTIFYs to phones...the phones will challenge the initial request and your script must be ready to answer their challenge.  You will also need to know the credentials (SIP username and password) that each phone is using to register to your SIP registrar in order to be able to properly compute the response.

 

Another option would be to set the method to "source" instead of "digest", which will cause the phones to validate the request by source IP address.  If you use this method, though, you must run your script from the same server that the phones are registering to.

 

Hope this helps,

 

-- Nathan

† The opinions expressed above are the personal opinions of the authors, not of HP. By using this site, you accept the <a href="https://www8.hp.com/us/en/terms-of-use.html" class="udrlinesmall">Terms of Use</a> and <a href="/t5/custom/page/page-id/hp.rulespage" class="udrlinesmall"> Rules of Participation</a>.