Andrew Prokop
Andrew Prokop has been heavily involved in the world of communications since the early 1980s. He holds five United States...
Read Full Bio >>

Andrew Prokop | April 27, 2015 |


Customizing Solutions with Web Services

Customizing Solutions with Web Services Web services like those offered by Avaya Aura System Manager allow solution customization while adding value to an enterprise's investment.

Web services like those offered by Avaya Aura System Manager allow solution customization while adding value to an enterprise's investment.

Ask ten IT professionals what excites them about today's communication technology and you might hear ten different answers. Some folks get all worked up about video and will bore you to tears with their thoughts on H.264 vs. VP8. Others are more interested in voice and get all warm and fuzzy about quality of service and wideband audio codecs (think Opus). The security-focused people pay attention to encryption, topology hiding, and certificates while the bleeding edge types are all about WebRTC and browser-based communications.

Personally, I am thrilled about all of the above and wear my communications propeller beanie with pride. However, there is one recent advancement that doesn't get nearly the attention that it deserves – Web services interfaces. Specifically, I am talking about Web services exposed by management systems. Granted, that doesn't sound as sexy as high definition video or SIP mobility, but these new interfaces open up traditionally closed systems in ways not previously possible.

A Quick and Dirty Introduction to Web Services

The term Web services should be self-explanatory. These are services that are available over the Internet (Web) or an enterprise's intranet.

You've used Google Maps before, right? Google offers a Web services interface for map access and data retrieval. Microsoft offers a similar interface for its Bing maps. The social media giant, Twitter, advertises a myriad of Web services to retrieve tweet data and statistics based upon a variety of parameters. Think of any major player on the Web and I bet you will find that they support their own Web services for data retrieval and manipulation.

Web services are built on the same protocols that your browser uses. Http is used for unencrypted access and https is used when you require a secure, encrypted connection from client to server. Using these widely accepted protocols allows Web services to pass through intermediaries such as data firewalls.

Web services are implemented in two distinct fashions – SOAP and REST. SOAP (Simple Object Access Protocol) came first and for many years was the predominant way to create Web services. REST (Representational State Transfer) came along after SOAP, but most developers are moving to REST because of its simplicity, statelessness, and ability to scale to support large, distributed computing environments.

A comparison of SOAP and REST is beyond the scope of what I want to accomplish in this article. There are plenty of those discussions on the Internet, and I invite you to explore them. For this article, I will focus on REST, since it appears to be winning the API (Application Programming Interface) war.

RESTful Web services follow four basic design principles:

  • Use HTTP methods explicitly
  • Be stateless
  • Expose directory structure-like URIs
  • Transfer XML, JSON (JavaScript Object Notation), or both

In terms of http, REST predominantly uses four methods – POST, GET, PUT, and DELETE. You will sometimes hear this referred to as CRUD -- Create, Read, Update, and Delete.

The mapping of http methods to REST functionality is as follows:

  • To create a resource on a server, use POST
  • To retrieve a resource from a server, use GET
  • To change the state of a resource or to update it, use PUT
  • To remove or delete a resource, use DELETE

A very simplistic REST call to add a user to a contact list might look as follows:

POST /contacts HTTP/1.1 Host: myserver Content-Type application/xml <?xml version="1.0"?> <user> <name>Andrew Prokop</name> </user> Avaya Aura System Manager Web Services

Now that I've gotten the basics out of the way, allow me to return to my original topic – Web services management interfaces. In particular, I want to introduce you to the Web services exposed by the Avaya Aura System Manager .

As most Avaya customers know, System Manager is Avaya's unified management tool. It provides a web-based interface to configure and perform administration functions on nearly every Avaya Aura component. This gives you access to everything from Communication Manager to Session Manager to Avaya Aura Conferencing . In fact, Avaya is starting to discontinue the product specific management tools (e.g. Avaya Site Administrator) and moving everything to System Manager.

For the first few years of its existence, System Manager functionality was delivered solely through a Web interface. An administrator would sit down at a Web browser and click keys on a keyboard. However, what if you didn't want to do that? What if you wanted to automate the process or execute those administrative tasks from some other application or interface?

That's where the System Manager Web Services come in. Through a series of RESTful interfaces, Avaya exposes the following services:

  • Create User
  • Update User
  • Delete User
  • Get User Profile

With these interfaces, it's now possible to perform standard "moves, adds and changes" operations from any Web services-capable language such as Java, C#, Perl, or Python. This not only enhances an enterprise's management capabilities, but it simplifies them as well. While System Manager is not a difficult interface to learn, certain functions can now be presented in ways that even the most telecom ignorant people can easily learn and use.

Of course, you don't want just anyone manipulating your configuration data. That's why the System Manager Web Services authenticate exactly the same as if the operations were performed from the Web interface. Additionally, with System Manager's role-based administration, control over who can do what to whom is built into these new interfaces.

Putting it to the Test

An API without an application is like a motor without a car: It makes a lot of noise, but in the end, it won't take you where you need to be. You must harness that power to make it work for you. Allow me to take a look at an application that does just that.

As I travel around the country speaking with communications professionals, I nearly always ask these two questions:

"How many of you set the password of your IP telephones to be the same as their extensions?" and "How many allow '1234' as the password?"

Sadly, I get raised hands and guilty smiles far more often than I would like. It's hard to blame them, though. Changing the password on an Avaya telephone is not a trivial task. In fact, it's not possible for a user to do it. He or she must ask an administrator to do it on his or her behalf. Also, that request will usually come in the form of an email containing the new password. Clearly, this is far from ideal and filled with more security violations than I care to count.

To solve this problem, my company Arrow Systems Integration created an application using the System Manager Web Services interfaces that gives users control over their telephone's password management. PasswordPro is a SaaS application that adds a much needed layer of security on top of an Avaya system.

Its features include:

  • A user-friendly, intuitive Web portal
  • User authentication
  • Password aging
  • Email notification of impending password expiration
  • Prohibiting password reuse
  • Prohibiting unsecure passwords (extension, 1234, etc.)

In other words, PasswordPro allows a best-practices approach to Avaya passwords that hasn't been previously possible. In today's world where security concerns have risen to the top of mind of most IP directors and CIOs, it's hard to imagine any enterprise that is willing to keep the status quo of easily guessed passwords and highly vulnerable communications systems. Remember, all it takes is one weak link to break an otherwise strong chain.

Bringing it all Back Home

The days of closed communications architectures are over and I couldn't be happier. Web services are paving the way to highly flexible systems that allow system integrators and software developers the ability to customize solutions while adding significant value to an enterprise's costly investment. Avaya's new System Manager APIs are only the beginning, but they are a good start. Over time, I expect their scope to expand, and the number of applications that use them will only grow.

Andrew Prokop writes about all things unified communications on his popular blog, SIP Adventures.

Follow Andrew Prokop on Twitter and LinkedIn!
Andrew Prokop on LinkedIn


March 7, 2018

Video collaboration is experiencing significant change and innovation-how can your enterprise take advantage? In this webinar, leading industry analyst Ira Weinstein will present detailed analysis

February 21, 2018

Business agility has become the strongest driver for enterprises to begin migrating their communications to the cloud-and its a benefit that enterprises are already realizing. To gain this benefit

February 7, 2018

Enterprises are starting to grasp the critical importance of security and compliance in their team collaboration deployments. And once the risks are mitigated, your enterprise can integrate these n

March 12, 2018
An effective E-911 implementation doesn't just happen; it takes a solid strategy. Tune in for tips from IT expert Irwin Lazar, of Nemertes Research.
March 9, 2018
IT consultant Steve Leaden lays out the whys and how-tos of getting the green light for your convergence strategy.
March 7, 2018
In advance of his speech tech tutorial at EC18, communications analyst Jon Arnold explores what voice means in a post-PBX world.
February 28, 2018
Voice engagement isn't about a simple phone call any longer, but rather a conversational experience that crosses from one channel to the next, as Daniel Hong, a VP and research director with Forrester....
February 16, 2018
What trends and technologies should you be up on for your contact center? Sheila McGee-Smith, Contact Center & Customer Experience track chair for Enterprise Connect 2018, gives us the lowdown.
February 9, 2018
Melanie Turek, VP of connected work research at Frost & Sullivan, walks us through key components -- and sticking points -- of customer-oriented digital transformation projects.
February 2, 2018
UC consultant Marty Parker has crunched lots of numbers evaluating UC options; tune in for what he's learned and tips for your own analysis.
January 26, 2018
Don't miss out on the fun! Organizer Alan Quayle shares details of his pre-Enterprise Connect hackathon, TADHack-mini '18, showcasing programmable communications.
December 20, 2017
Kevin Kieller, partner with enableUC, provides advice on how to move forward with your Skype for Business and Teams deployments.
December 20, 2017
Zeus Kerravala, principal analyst with ZK Research, shares his perspective on artificial intelligence and the future of team collaboration.
December 20, 2017
Delanda Coleman, Microsoft senior marketing manager, explains the Teams vision and shares use case examples.
November 30, 2017
With a ruling on the FCC's proposed order to dismantle the Open Internet Order expected this month, communications technology attorney Martha Buyer walks us through what's at stake.
October 23, 2017
Wondering which Office 365 collaboration tool to use when? Get quick pointers from CBT Nuggets instructor Simona Millham.
September 22, 2017
In this podcast, we explore the future of work with Robert Brown, AVP of the Cognizant Center for the Future of Work, who helps us answer the question, "What do we do when machines do everything?"
September 8, 2017
Greg Collins, a technology analyst and strategist with Exact Ventures, delivers a status report on 5G implementation plans and tells enterprises why they shouldn't wait to move ahead on potential use ....
August 25, 2017
Find out what business considerations are driving the SIP trunking market today, and learn a bit about how satisfied enterprises are with their providers. We talk with John Malone, president of The Ea....
August 16, 2017
World Vision U.S. is finding lots of goodness in RingCentral's cloud communications service, but as Randy Boyd, infrastructure architect at the global humanitarian nonprofit, tells us, he and his team....
August 11, 2017
Alicia Gee, director of unified communications at Sutter Physician Services, oversees the technical team supporting a 1,000-agent contact center running on Genesys PureConnect. She catches us up on th....
August 4, 2017
Andrew Prokop, communications evangelist with Arrow Systems Integration, has lately been working on integrating enterprise communications into Internet of Things ecosystems. He shares examples and off....
July 27, 2017
Industry watcher Elka Popova, a Frost & Sullivan program director, shares her perspective on this acquisition, discussing Mitel's market positioning, why the move makes sense, and more.
July 14, 2017
Lantre Barr, founder and CEO of Blacc Spot Media, urges any enterprise that's been on the fence about integrating real-time communications into business workflows to jump off and get started. Tune and....
June 28, 2017
Communications expert Tsahi Levent-Levi, author of the popular blog, keeps a running tally and comprehensive overview of communications platform-as-a-service offerings in his "Choosing a W....
June 9, 2017
If you think telecom expense management applies to nothing more than business phone lines, think again. Hyoun Park, founder and principal investigator with technology advisory Amalgam Insights, tells ....
June 2, 2017
Enterprises strategizing on mobility today, including for internal collaboration, don't have the luxury of learning as they go. Tony Rizzo, enterprise mobility specialist with Blue Hill Research, expl....
May 24, 2017
Mark Winther, head of IDC's global telecom consulting practice, gives us his take on how CPaaS providers evolve beyond the basic building blocks and address maturing enterprise needs.
May 18, 2017
Diane Myers, senior research director at IHS Markit, walks us through her 2017 UC-as-a-service report... and shares what might be to come in 2018.
April 28, 2017
Change isn't easy, but it is necessary. Tune in for advice and perspective from Zeus Kerravala, co-author of a "Digital Transformation for Dummies" special edition.
April 20, 2017
Robin Gareiss, president of Nemertes Research, shares insight gleaned from the firm's 12th annual UCC Total Cost of Operations study.
March 23, 2017
Tim Banting, of Current Analysis, gives us a peek into what the next three years will bring in advance of his Enterprise Connect session exploring the question: Will there be a new model for enterpris....
March 15, 2017
Andrew Prokop, communications evangelist with Arrow Systems Integration, discusses the evolving role of the all-important session border controller.
March 9, 2017
Organizer Alan Quayle gives us the lowdown on programmable communications and all you need to know about participating in this pre-Enterprise Connect hackathon.
March 3, 2017
From protecting against new vulnerabilities to keeping security assessments up to date, security consultant Mark Collier shares tips on how best to protect your UC systems.
February 24, 2017
UC analyst Blair Pleasant sorts through the myriad cloud architectural models underlying UCaaS and CCaaS offerings, and explains why knowing the differences matter.
February 17, 2017
From the most basics of basics to the hidden gotchas, UC consultant Melissa Swartz helps demystify the complex world of SIP trunking.
February 7, 2017
UC&C consultant Kevin Kieller, a partner at enableUC, shares pointers for making the right architectural choices for your Skype for Business deployment.
February 1, 2017
Elka Popova, a Frost & Sullivan program director, shares a status report on the UCaaS market today and offers her perspective on what large enterprises need before committing to UC in the cloud.
January 26, 2017
Andrew Davis, co-founder of Wainhouse Research and chair of the Video track at Enterprise Connect 2017, sorts through the myriad cloud video service options and shares how to tell if your choice is en....
January 23, 2017
Sheila McGee-Smith, Contact Center/Customer Experience track chair for Enterprise Connect 2017, tells us what we need to know about the role cloud software is playing in contact centers today.