Welcome!

Microservices Expo Authors: Elizabeth White, Pat Romanski, Liz McMillan, Yeshim Deniz, Carmen Gonzalez

Related Topics: Microservices Expo, Machine Learning

Microservices Expo: Article

Web Services Specifications and SOA Interoperability

Achieving interoperability is neither simple nor straightforward

Interoperability is an important factor in the success of solutions that are based on Web Services and Service Oriented Architecture (SOA), along with other key factors such as contracts, loose coupling, and reuse. Interoperability is generally accomplished by developing your Web Services using the well-established guidelines for implementing Web Services and by following industry standards such as XML, WSDL, SOAP, and UDDI. However, just following Web Services standards and guidelines during the development phase of a project isn't sufficient to achieve interoperability.

The different products used for development also have to comply with many requirements such as the need to have similar implementations (data types, formats, and schemas) of the standards that you want to use. As different products are provided by different vendors, developed by several sets of people, and employ various types of underlying technologies, achieving a common understanding often becomes very difficult, which makes the products likely to be non-interoperable with each other.

Over the last few years, the basic Web Services standards like XML, WSDL, and SOAP have matured a lot and WS-I has released a Basic Profile (described later) that contains implementation guidelines for basic Web Services standards. Today, most vendors provide products that comply with the Basic Profile and support the standards included in the profile. With the wide adoption of the Basic Profile, software vendors have been able to make their products interoperable to a great extent.

As the Web Services industry evolves, it embraces new specifications like WS-Security, WS-ReliableMessaging (WS-RM), and WS-AtomicTransactions (WS-AT) to provide advanced functionalities such as security, reliability, and transactions that are not provided by the basic specifications. These specifications are generally referred to as the WS-* (pronounced WS-Star) specifications. As they are relatively new and have not been so widely agreed on by the industry, achieving interoperability between Web Services that use WS-* specifications is much more difficult and the WS-* specifications may not even be supported in many products.

This article provides a set of guidelines and best practices that you can follow to accomplish interoperability when developing web services that make use of the WS-* specifications across products provided by different vendors. It also provides insight into the Web Services specifications situation that contains a large number of WS-* specifications that are being developed by different groups.

Author's Note:
1.  This article uses the term "product" as a common term to refer to platforms, technologies, or tools provided by software vendors for developing Web Services.
2.  It uses examples of interoperability between J2EE- and .NET- based Web Services. However, the given guidelines and best practices can be applied to other platforms too.
3.  This article assumes that the reader is aware of basic Web Services concepts and knows the different steps involved in develoing Web Services.

Basic Web Services Interoperability
Achieving interoperability for scenarios involving only basic standards is relatively easy if you follow the guidelines set by the Basic Profile (BP) 1.0 or 1.1 of the Web Services Interoperability Organization (WS-I). The Basic Profile consists of implementing guidelines recommending how a set of core Web Services specifications should be used together to develop interoperable Web Services. The guidelines address technologies that cover four core areas: Messaging, Description, Discovery, and Security. BP1.0 covers the following core Web Services specifications and provides constraints and clarifications to these base specifications, along with conventions about how to use them together:

  • SOAP 1.1
  • WSDL 1.1
  • UDDI 2.0
  • XML 1.0 (Second Edition)
  • XML Schema Part 1: Structures
  • XML Schema Part 2: Data types
  • RFC2246: The Transport Layer Security Protocol Version 1.0
  • RFC2459: Internet X.509 Public Key Infrastructure Certificate and CRL Profile
  • RFC2616: HyperText Transfer Protocol 1.1
  • RFC2818: HTTP over TLS Transport Layer Security
  • RFC2965: HTTP State Management Mechanism
  • The Secure Sockets Layer Protocol Version 3.0
You can see detailed information about the Basic Profile at its home page: www.ws-i.org/deliverables/workinggroup.aspx?wg=basicprofile.

If you can ensure that all the products being used in your solution are compliant with the Basic Profile, you are very close to achieving the interoperability between those products. Additionally, if you build your Web Services by following the Basic Profile guidelines and by using the specifications listed above, you can achieve complete interoperability. However, the guidelines for using basic Web Services specifications aren't within the scope of this article. To find out more on the topic, you can either look at resources listed in the section "Web Services Interoperability Resources" or search for the keyword "Web Services interoperability" on any major search engine. You'll find numerous articles, guidelines, and samples.

Land in the WS-* Space
The basic Web Services specifications such as XML, SOAP, and UDDI have been around for a long time now and have been ratified by one standards body or another (described later in this section) as standards. These specifications have also found wide adoption in the industry and in leading Web Services products. However, the case is not the same for advanced Web Services specifications or WS-* specifications. Figure 1 below graphically represents how different categories of specifications fit in the context of a Web Services framework.

Note that Figure 1 provides high-level categorization of Web Services specifications; it shouldn't be considered a underlying architecture for Web Services implementations. The basic specification provides the core functionalities for Web Services such as messaging, discovery, and description, whereas WS-* specifications provide advanced functionalities such as security, reliability, and transactions. A specification is generally given the status of a standard when it's approved by a standards body. There are two main standard bodies dealing with Web Services standards:

  1. W3C: The World Wide Web Consortium (www.w3.org/)
  2. OASIS: The Organization for the Advancement of Structured Information Standards (www.oasis-open.org)
W3C was founded mainly to focus on Web-based protocols and standards such as HTML, HTTP, and others. It also plays a core role in standardizing the basic specifications for Web Services including SOAP, XML, and WSDL. It's expanded beyond that and has been involved in overseeing higher-level ones such as WS-Choreography Description Language.

On the other hand, OASIS focuses on developing and adopting e-business and higher-level Web Services specifications such as ebXML, UDDI, and many of WS-* specifications including WS-Security, WS-Reliability, Web Services Business Process Execution Language (WS-BPEL), etc.

Besides to these two major standard bodies, there are two other groups involved in Web Services-related standardizations:

1.  The Web Services Interoperability (WS-I) organization (www.ws-i.org/) was founded by Microsoft, IBM, and other vendors primarily to promote interoperability across platforms. It focuses on developing profiles of Web Services standards that enable interoperability. It also provides usage scenarios, sample applications, and testing tools to help you develop applications conforming to the profiles. Its profile, BP1.0, mentioned in the section "Basic Web Services Interoperability" above, has gained wide acceptance in the industry.

2.  The Liberty Alliance (www.projectliberty.org/) was co-founded by Sun with the mission to develop Web Services specifications for identity management using the Security Assertion Markup Language (SAML). It focuses exclusively on identity management and security issues.

Stages of a Specification Before Becoming a Standard
This section describes the process followed by W3C and OASIS to adopt a specification as a standard. The exact process followed by the two standards bodies might be different, but on a high level, they follow the process described here.

Generally, some vendors (such as Microsoft and IBM) get together and create a draft version of a specification that they want widely adopted. They publish that draft specification to get feedback and support from the industry. The authoring vendors make changes to the specification per the feedback and, if they choose to, submit an agreed version to one of the standards bodies. The standards body then enters its process for deciding whether to form a working group (WG) in the case of W3C or a technical committee (TC) in the case of OASIS. If it does form the WG or TC, it calls for participation from industry members to work on the specification. The WG or TC works on enhancing the original submission. At this stage, the specification is called a "working draft." When they are done with enhancements, the WG or TC members publish the specification for public review and take inputs. If the specification gets approved in the public review, the TC recommends to the standard body that it ratify the specification as a standard. In the case of the W3C, the process for promoting a specification to the status of standard is more rigorous.

This process and the availability of numerous Web Services specifications complicate the building of Web Services using WS-* specifications. The complications are described in the next two sections.

Multiple Statuses
The specifications listed in Figure 1 are at different "statuses" or "maturity levels" of the standards process. For example, WS-Security (SOAP Message Security v1.1) is an OASIS standard and WS-Addressing v1.0 is a W3C Candidate Recommendation (almost equivalent to a standard). WS-Policy is only a formal submission to W3C and WS-AtomicTransaction (WS-AT) isn't even submitted to a standard body; it's a joint publication by BEA, IBM, Microsoft, and few other vendors.

Author's Note: The status of the various specifications mentioned in this document is their status at the time of writing. But, their status keeps changing and may be different when you read this.

Competing Specifications
There are some areas where there's more than one specification to address the same functionality; the multiple specifications are supported by different consortia of vendors.

For example, the WS-Choreography Description Language v1.0 is a candidate recommendation (close to becoming a final recommendation or a standard) at W3C for Web Services choreography and was submitted initially by Novell, Oracle, and others. On the other hand, Web Services Business Process Execution Language (WS-BPEL) v2.0 is a committee draft at OASIS for very similar requirements (i.e., Web Services orchestration); it's supported by a mostly different set of vendors like BEA, HP, IBM, and Microsoft.

Similarly, WS-Reliability v1.1 is an OASIS standard, initially submitted by Sun, Oracle, and others. But another group of vendors made up of BEA, IBM, Microsoft, and TIBCO has published a similar but different specification called WS-ReliableMessaging. In some instances, you'll also find a vendor supporting competing specifications.

Because of these complications, achoeving interoperability using WS-* specifications becomes much more difficult compared to using basic Web Services specifications. The following section describes some guidelines that should help you increase the interoperability success rate of your implementations and reduce the time spent in debugging and investigations.

Guidelines for Interoperating Using WS-*
You need to look from a number of perspectives to ensure the interoperability between Web Services (using WS-* specifications) that are built on different products. This section offers insight into these perspectives and provides examples wherever applicable.

Support for the Same Specifications
As mentioned above, there could be more than one specification for the same functionality such as reliability or orchestration. Before you start, ensure that the products on which the Web Services are developed support the same specification.

For example, if you want reliable delivery of messages between Web Services developed on two different products, both products should support the same specification, that is, both support WS-Reliability (WS-R) or both support WS-Reliable Messaging (WS-RM). Otherwise, you may not be able to interoperate between the two products.

Another example is about identity federation, for which there are two different specifications available: Liberty Alliance's Identity Framework ID-FF and WS-Federation. In both specifications, federation is implemented through a Security Token Service (STS) that provides security tokens to the requesting clients. But the two specifications use different kinds of security tokens; Liberty Alliance uses extended SAML assertions, whereas WS-Federation uses WS-Security's profiles of X509 and Kerberos. When two parties (or organizations or security zones) plan to implement identity federation between them, they must ensure that the common security token is supported by the two STSes; otherwise, they won't be able to implement the federation.

Versions of the Specifications Web Services specifications are evolving and new versions keep moving through both the draft and final stage. But the products that implement these specifications don't change at the same pace. Because of that, you find products from different vendors implementing different versions of the specifications and the different versions of the same specification may not interoperate with each other. In such cases, check if the product that supports the newer version of the specification supports the older version too. Generally, products support the older version to maintain backward compatibility. You should configure a product to use an older version of the specification, if necessary, so that both products use the same version.

For example, BEA WebLogic Server (WLS) 9.0 only supports SOAP 1.1 whereas Microsoft Windows Communication Foundation (WCF) February 2006 Community Technology Preview (CTP) supports both SOAP 1.2 and SOAP 1.1. WCF provides out-of-the-box configuration settings for different kinds of bindings. All of the bindings except basicHTTPBinding are configured to use SOAP 1.2 by default. If your WCF Web Services use any of these bindings, they won't be able to communicate with WLS 9.0 clients and vice versa. To enable communication, you need to configure the WCF Web Services with a binding that uses SOAP 1.1. You can do that by creating a custom binding in WCF.

You also have to ensure that versions of the other specifications that are being used by the specification you're implementing are the same. For example, WS-RM makes use of WS-Addressing. By default, the WCF Feb 2006 CTP uses the version of WS-Addressing given below:

wsa10=http://www.w3.org/2005/08/addressing

Whereas the WLS 9.0 supports only the older version of WS-Addressing as given below:

wsa=http://schemas.xmlsoap.org/ws/2004/08/addressing

In this case also, you have to configure the WCF Web Service with a custom binding that uses an older version of WS-Addressing. If you don't want to create a custom binding, you can manually change the generated WSDL of the WCF service and use the changed WSDL for generating a proxy that the WLS client uses to call the WCF service. This will work only when the two versions are compatible with each other.

Sometimes, vendors provide service packs or refresh packs to overcome discrepancies in the released version of the product. These packs might bring in changes in the supported specifications. These changes might break the existing interoperability or enable interoperability where it was absent earlier. For example, IBM WebSphere Application Server (WAS) 6.0 supports the element <CoordinationContextType> for WS-AT, but when the refresh pack 6.0.2.9 is applied over it, the supported element changes to <CoordinationContext>. You should analyze all such changes in the refresh packs before deciding to apply these packs.

Schemas, Namespaces, and WSDLs
In some instances, the two products might use the same version number of a specification, but the namespaces for the specification might refer to different schemas. For example, both WCF Feb 2006 CTP and WLS 9.0 use the February 2005 version of the WS-RM Policy specifications but refer to different namespaces. The WCF Feb 2006 CTP generatesw WSDLs that refer to the following namespace for WS-RM Policy Assertions:

xmlns:wsrm=http://schemas.xmlsoap.org/ws/2005/02/rm/policy

Whereas the WLS 9.0 generates WSDLs that refer to this namespace:

xmlns:wsrm=http://schemas.xmlsoap.org/ws/2005/02/rm

The namespace above is actually for WS-ReliableMessaging specification and not for WS-RM Policy specification (which is different from WS-ReliableMessaging). But for some reason, WLS 9.0 uses this namespace to refer to RM Policy assertions.

In such cases, you can change the WSDL of a service manually to refer to a namespace that is understandable by the client. Subsequently, when you generate the client proxy from that changed WSDL, the client proxy would refer to the changed namespace. Hence the clients can communicate with the service successfully.

There's also not much standardization on the location of WS-Policy references in WSDLs. For example, WLS 9.0 adds the policy expression reference in the <operation> element, whereas WCF adds the policy file reference in the <binding> element. In such cases, you have to change the WSDL of a Web Service according to the client requirements.

Author's Note: In WebLogic Server 9.2, the namespace has been corrected and the WSDLs generated refer to the WS-RM Policy namespace for policy assertions.

Specifications & Actual Implementations
Although products may claim to support a particular specification, they may not support all the features in the specification that aren't mandatory. For example, WS-RM specifies four kinds of delivery assurances: AtMostOnce, AtLeastOnce, ExactlyOnce, and InOrder. However, WCF Feb 2006 CTP supports only two options: ExactlyOnce and InOrder. Hence, you need to make sure that both the products that you're trying to interoperate support the option you're choosing for implementation.


More Stories By Sanjay Narang

Sanjay Narang is a Senior Technology Consultant at Global Delivery India Center (GDIC) of Hewlett-Packard. He is based in Bangalore, India and has around 8 years of IT experience. Sanjay has done Post Graduate Diploma in IT (PGDIT) and holds MCSD for .Net Framework and SCJP certifications. He has been involved in designing and developing solutions based on Microsoft technologies for a long time. Apart from software process automation and VSTS, he is working on SOA related projects around Microsoft technologies and their interoperability with other technologies. He has published papers around IPv6, VSTS, SOA, and Web Services and writes extensively about VSTS in his blog: http://sanjaynarang.wordpress.com/ He can be contacted at [email protected]

Comments (1) View Comments

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


Most Recent Comments
SOA Web Services Journal News 12/17/06 11:56:05 AM EST

Interoperability is an important factor in the success of solutions that are based on Web Services and Service Oriented Architecture (SOA), along with other key factors such as contracts, loose coupling, and reuse. Interoperability is generally accomplished by developing your Web Services using the well-established guidelines for implementing Web Services and by following industry standards such as XML, WSDL, SOAP, and UDDI. However, just following Web Services standards and guidelines during the development phase of a project isn't sufficient to achieve interoperability.

@MicroservicesExpo Stories
The Software Defined Data Center (SDDC), which enables organizations to seamlessly run in a hybrid cloud model (public + private cloud), is here to stay. IDC estimates that the software-defined networking market will be valued at $3.7 billion by 2016. Security is a key component and benefit of the SDDC, and offers an opportunity to build security 'from the ground up' and weave it into the environment from day one. In his session at 16th Cloud Expo, Reuven Harrison, CTO and Co-Founder of Tufin, ...
By now, every company in the world is on the lookout for the digital disruption that will threaten their existence. In study after study, executives believe that technology has either already disrupted their industry, is in the process of disrupting it or will disrupt it in the near future. As a result, every organization is taking steps to prepare for or mitigate unforeseen disruptions. Yet in almost every industry, the disruption trend continues unabated.
SYS-CON Events announced today that HTBase will exhibit at SYS-CON's 20th International Cloud Expo®, which will take place on June 6-8, 2017, at the Javits Center in New York City, NY. HTBase (Gartner 2016 Cool Vendor) delivers a Composable IT infrastructure solution architected for agility and increased efficiency. It turns compute, storage, and fabric into fluid pools of resources that are easily composed and re-composed to meet each application’s needs. With HTBase, companies can quickly prov...
Building custom add-ons does not need to be limited to the ideas you see on a marketplace. In his session at 20th Cloud Expo, Sukhbir Dhillon, CEO and founder of Addteq, will go over some adventures they faced in developing integrations using Atlassian SDK and other technologies/platforms and how it has enabled development teams to experiment with newer paradigms like Serverless and newer features of Atlassian SDKs. In this presentation, you will be taken on a journey of Add-On and Integration ...
Culture is the most important ingredient of DevOps. The challenge for most organizations is defining and communicating a vision of beneficial DevOps culture for their organizations, and then facilitating the changes needed to achieve that. Often this comes down to an ability to provide true leadership. As a CIO, are your direct reports IT managers or are they IT leaders? The hard truth is that many IT managers have risen through the ranks based on their technical skills, not their leadership abi...
The essence of cloud computing is that all consumable IT resources are delivered as services. In his session at 15th Cloud Expo, Yung Chou, Technology Evangelist at Microsoft, demonstrated the concepts and implementations of two important cloud computing deliveries: Infrastructure as a Service (IaaS) and Platform as a Service (PaaS). He discussed from business and technical viewpoints what exactly they are, why we care, how they are different and in what ways, and the strategies for IT to transi...
Without a clear strategy for cost control and an architecture designed with cloud services in mind, costs and operational performance can quickly get out of control. To avoid multiple architectural redesigns requires extensive thought and planning. Boundary (now part of BMC) launched a new public-facing multi-tenant high resolution monitoring service on Amazon AWS two years ago, facing challenges and learning best practices in the early days of the new service.
All organizations that did not originate this moment have a pre-existing culture as well as legacy technology and processes that can be more or less amenable to DevOps implementation. That organizational culture is influenced by the personalities and management styles of Executive Management, the wider culture in which the organization is situated, and the personalities of key team members at all levels of the organization. This culture and entrenched interests usually throw a wrench in the work...
DevOps is often described as a combination of technology and culture. Without both, DevOps isn't complete. However, applying the culture to outdated technology is a recipe for disaster; as response times grow and connections between teams are delayed by technology, the culture will die. A Nutanix Enterprise Cloud has many benefits that provide the needed base for a true DevOps paradigm.
As software becomes more and more complex, we, as software developers, have been splitting up our code into smaller and smaller components. This is also true for the environment in which we run our code: going from bare metal, to VMs to the modern-day Cloud Native world of containers, schedulers and micro services. While we have figured out how to run containerized applications in the cloud using schedulers, we've yet to come up with a good solution to bridge the gap between getting your contain...
As organizations realize the scope of the Internet of Things, gaining key insights from Big Data, through the use of advanced analytics, becomes crucial. However, IoT also creates the need for petabyte scale storage of data from millions of devices. A new type of Storage is required which seamlessly integrates robust data analytics with massive scale. These storage systems will act as “smart systems” provide in-place analytics that speed discovery and enable businesses to quickly derive meaningf...
DevOps is often described as a combination of technology and culture. Without both, DevOps isn't complete. However, applying the culture to outdated technology is a recipe for disaster; as response times grow and connections between teams are delayed by technology, the culture will die. A Nutanix Enterprise Cloud has many benefits that provide the needed base for a true DevOps paradigm. In his Day 3 Keynote at 20th Cloud Expo, Chris Brown, a Solutions Marketing Manager at Nutanix, will explore t...
DevOps has often been described in terms of CAMS: Culture, Automation, Measuring, Sharing. While we’ve seen a lot of focus on the “A” and even on the “M”, there are very few examples of why the “C" is equally important in the DevOps equation. In her session at @DevOps Summit, Lori MacVittie, of F5 Networks, explored HTTP/1 and HTTP/2 along with Microservices to illustrate why a collaborative culture between Dev, Ops, and the Network is critical to ensuring success.
With major technology companies and startups seriously embracing Cloud strategies, now is the perfect time to attend @CloudExpo | @ThingsExpo, June 6-8, 2017, at the Javits Center in New York City, NY and October 31 - November 2, 2017, Santa Clara Convention Center, CA. Learn what is going on, contribute to the discussions, and ensure that your enterprise is on the right path to Digital Transformation.
Everyone wants to use containers, but monitoring containers is hard. New ephemeral architecture introduces new challenges in how monitoring tools need to monitor and visualize containers, so your team can make sense of everything. In his session at @DevOpsSummit, David Gildeh, co-founder and CEO of Outlyer, will go through the challenges and show there is light at the end of the tunnel if you use the right tools and understand what you need to be monitoring to successfully use containers in your...
What if you could build a web application that could support true web-scale traffic without having to ever provision or manage a single server? Sounds magical, and it is! In his session at 20th Cloud Expo, Chris Munns, Senior Developer Advocate for Serverless Applications at Amazon Web Services, will show how to build a serverless website that scales automatically using services like AWS Lambda, Amazon API Gateway, and Amazon S3. We will review several frameworks that can help you build serverle...
The IT industry is undergoing a significant evolution to keep up with cloud application demand. We see this happening as a mindset shift, from traditional IT teams to more well-rounded, cloud-focused job roles. The IT industry has become so cloud-minded that Gartner predicts that by 2020, this cloud shift will impact more than $1 trillion of global IT spending. This shift, however, has left some IT professionals feeling a little anxious about what lies ahead. The good news is that cloud computin...
An overall theme of Cloud computing and the specific practices within it is fundamentally one of automation. The core value of technology is to continually automate low level procedures to free up people to work on more value add activities, ultimately leading to the utopian goal of full Autonomic Computing. For example a great way to define your plan for DevOps tool chain adoption is through this lens. In this TechTarget article they outline a simple maturity model for planning this.
While DevOps most critically and famously fosters collaboration, communication, and integration through cultural change, culture is more of an output than an input. In order to actively drive cultural evolution, organizations must make substantial organizational and process changes, and adopt new technologies, to encourage a DevOps culture. Moderated by Andi Mann, panelists discussed how to balance these three pillars of DevOps, where to focus attention (and resources), where organizations might...
The rise of containers and microservices has skyrocketed the rate at which new applications are moved into production environments today. While developers have been deploying containers to speed up the development processes for some time, there still remain challenges with running microservices efficiently. Most existing IT monitoring tools don’t actually maintain visibility into the containers that make up microservices. As those container applications move into production, some IT operations t...