Managing WSDLs

WSDL is one of many asset models supported by the WSO2 Governance Registry. For more information on a complete list of asset models supported by WSO2 Governance Registry, see Supported APIs & Standards.

You can upload WSDL files from the local file system as a Governance Archive, or import them from a given URL. For instructions, see Adding a SOAP Service.

During the importing, WSDL is validated and put into the Registry. If the given WSDL requires any other WSDL imports, these WSDLs also go through the same process, and are imported into the Registry. All the Schema/Policy imports are also downloaded into the Registry and put into the location where all the Schemas/Policies are stored.

The WSDL can have a number of Endpoints. The Governance Registry creates new resources for these Endpoints and puts them into a general location where all the Endpoints are saved.

A single WSDL can have a number of dependent resources at the end of import process, and the WSDL resource will have associations and dependencies for those resources according to the relationship.

Validating WSDLs Offline

Users can upload WSDL files to the WSO2 Governance Registry. During the uploading process, the Governance Registry validates each WSDL file during its first addition. However, in order to do that, there should be an active internet connection on the machine which is running the Governance Registry. This page explains the process to follow in order to add and validate WSDLs using Governance Registry on a machine without having an internet connection.

When validating the WSDL, the Governance Registry connects to ws-i.org site, in order to get few resources. See here for more information.

There can be problems and delays in validating WSDL, if the machine doesn't have an active internet connection at the moment. So, as a workaround for this issue, the following sections explain how to host those required resources locally and validate WSDLs using those locally hosted resources without using an internet connection:

Install and run Apache Web Server

If you havenot already installed the Apache Web server, see download page to download the latest version of the Apache Web server.

For information on installing and running, go to the relevant section on Apache Web Server official documentation. For Windows installations, go to the Apache Windows Installations documentation.

At the time when writing this article, the latest Apache Web server version is 2.4. Therefore, the instructions and references used in this article are related to the latest Apache server documentation version (2.4).

To verify the installations run the Apache server and locate the following link on your browser.

Your browser displays content related to Apache Web server. If not, you may have to check the error logs of the Apache Web server and resolve issues.

Publish files on Apache Server

For information on locating the "web site publish directory" of the Apache server, go to Apache documentation.

E.g., for Linux it is "/var/www" and for Windows it can be "C:\Program Files (x86)\Apache Group\Apache2\htdocs".

As mentioned earlier, WSO2 Governance Registry connects to ws-i.org to download resources (two XML files). Manually download these resources (XML files) and publish them on the Apache Web server.

Hence, download the following XML files from a computer, which is having an internet connection. When you are adding WSDL through Governance Registry, Governance Registry needs these XML files to complete the validation.

After downloading above files, save them inside your "web site publish directory" of the Apache web server. Please remember to save these files under the corresponding folder structure (that matches the url resource path of ws-i.org site) inside your "web site publish directory" of the Apache web server.

E.g., for a Linux environment it should be:

The above resource files (TAD - Test Assertion Documents) contain test assertions for WS-I profiles. These test assertions are used by the analyzer tool (inside the WSO2 Governance Registry when validating WSDL file), in order to determine the conformance of the Web Service.

To verify what we have done so far, please locate the following links on your browser.

The above links display the content of the TAD XML files in the browser.

Editing the hosts file

Hosts file is a text file that contains entries to map host names to IP addresses. By editing this file it is possible to redirect requests (by the WSO2 Governance Registry) requesting ws-i.org site resources to out locally hosted Apache web server resources. In Linux environment, the hosts file is located at:

In Windows it is under:

Please see here to get more information about hosts file paths on different environments. Open the hosts file on your machine and add the following entries to it.

Verifying the steps

To verify these steps, locate the following link on your browser (on the machine which is not having an internet connection),

If you are able to see the content of the above .xml file, that means WSO2 Governance Registry is ready to validate WSDL on a machine which does not have an internet connection.

To add WSDLs to the WSO2 Governance Registry:

1. Start up WSO2 Governance Registry and log into it with credentials.
2. For information on adding WSDLs, see Adding a SOAP Service.
3. If you have followed the above steps correctly, then you should be able to add and validate WSDL resources successfully with the WSO2 Governance Registry which runs on a machine that does not have an internet connection.