This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Getting Started with WSO2 Governance as a Service

Owned by Former user (Deleted)
Last updated: Dec 20, 2012Version comment
4 min read

WSO2 Governance Registry helps you store and manage your organization's SOA metadata. Governance as a Service (GaaS) is an online instance of WSO2 with a multi-tenant (multi-organization) support. Users do not need to download and deploy the package; rather, they can use the online instance to govern their SOA platform.

Register a New Organization

1. In order to use the WSO2 Governance as a Service instance, you must first create an account for your organization. Click the "Register" button in the WSO2 Governance as a Service home page to access the "Register Organization" form.

2. Fill out the Register A New Organization form:

Fill in the following fields:

  • Domain - A domain registered with your organization. (Currently, we are not validating the domain ownership, but we will suspend the use of invalid domains in the near future).
  • Admin Username - The username of the admin account.
  • Admin Password - The password of the admin account.
  • Admin Password-Repeat - Re-enter the password typed above.
  • Email - Your email address. This email is used to contact you for any updates.
  • Word Verification - Enter the letters shown in the CAPTCHA image in this text box.

3. When you submit the form to add a new organization, you will receive an email, along with the instructions you need to follow to activate your account.

4. After you have successfully created the account for your organization, you will be redirected to the login page. The page URL will have the following structure:
 http://governance.cloud.wso2.com/t/yourdomain
For example, for example.com the URL is: *http://governance.cloud.wso2.com/t/example.com*
Bookmark this URL, as this is the page that all the users of your organization should use to sign in to the WSO2 Governance as a Service instance.

Login to the WSO2 Governance as a Service account

1. Once you have created an account, go to this URL:
http://governance.cloud.wso2.com/t/yourdomainHere, yourdomain should be replaced with the domain you registered with.

For example, for example.com the URL is:
 *http://governance.cloud.wso2.com/t/example.com*
2. Enter the username and password values that you have registered to sign in to the admin account for your organization.

Add a Service

1. When you log in to your account for the first time, you will see the direct links to add your first service, WSDL, schema, or policy. Click the "Add new service" button. See Managing Services.

2. The "Add Service" page will appear.

Note

You can reach the same page by clicking the Metadata Add Service on the menu bar on the left-hand side of the screen. See Managing Services.

3. Fill in the name and a namespace for the service. (Both are required fields.)

Note

The fields of this form are highly configurable. (You can configure the fields by editing the Service UI configuration XML that can be reached from Configure Service.)

4. If there is a WSDL describing the interface of your service, you can list the URL in the "WSDL URL" field.

Once you submit the form, Governance Registry will import the dependencies of your service including WSDLs, XMLs, and schemas to the registry.

5. Visit the Metadata List Service, Metadata List WSDL, Metadata List Schema to view the created service and the dependent WSDLs and schemas.

The WSO2 Registry allows the following actions:

  • Manage Service Lifecycle (for more information, see Lifecycles).
  • Retrieving WSDL/Schema/Policies

One of the key aspects of SOA governance is the ability to share service interfaces with various parties in a consistent and orderly manner. After you have successfully stored the resources (WSDLs, schemas and policies, etc.) in the Governance Registry, you can provide the locations of the service interfaces and the service meta data in order to refer them from different applications or to share them with third parties. For example, WSDLs inside the WSO2 Governance Registry can be used to publish web services with web services engines like WSO2 and WSAS, or to create proxy services with WSO2 ESB.

Each resource is associated with a unique path in the context of the registry. You can always visit the path from the registry browser to update, delete, move, or copy the resources.
Every resource in the registry will have a unique RESTful URL. The URL will have the following structure:

  • HTTPs URL - https://governance.cloud.wso2.com/t/yourdomain/registry/resource/wsdlpath1
  • HTTP URL - http://governance.cloud.wso2.com/t/yourdomain/registry/resource/wsdlpath1

For example, for the domain example.com and wsdl /example/path/example.wsdl

  • HTTPs - https://governance.cloud.wso2.com/t/example.com/registry/resource/example/path/example.wsdl
  • HTTP - http://governance.cloud.wso2.com/t/example.com/registry/resource/example/path/example.wsdl