WSO2 Governance Registry is a registry-repository for storing and managing metadata related to services and other artifacts. Services in the Governance Registry are implemented as configurable governance artifacts (RXT files). Usually, APIs are created using the API Publisher Web interface. Instead, you can integrate the API Manager with the Governance Registry to directly create APIs in the API Publisher using the services deployed in the Governance Registry.
The steps below explain how to configure the two products to expose services in the Governance Registry as APIs.
Follow the steps below to publish services on Governance Registry to the API Manager.
Download both WSO2 Governance Registry (G-Reg) and WSO2 API Manager.
Provide the API Manager credentials in
<GREG_HOME>/repository/resources/lifecycles/configurations.xmlfile. For example, the following code block defines an
productionstate. It provides the API Manager's endpoint, username and password as executor parameters.
Note: If you started the G-Reg server at least once before executing step 2, editing the
configurations.xmlfile and restarting the server does not apply the configurations. You need to add the configurations using the G-Reg management console as follows:
- Log in to the G-Reg Management console and select Extensions -> Configure -> Lifecycles menu.
- Click the Edit link associated with
- Add the configuration given in step 2 above and Save.
Run the G-Reg and the API Manager.
When running more than one WSO2 products on the same server, change the default port of one product to avoid port conflicts. You can do this by changing the
<offset>value of one product in
<PRODUCT_HOME>/repository/conf/carbon.xmlfile. In this example, we set the port offset value of Governance Registry to 1 as follows:
Note: If you offset the default API Manager port, you must also change the default API endpoints and the Thrift port accordingly. See Changing the Default Ports with Offset.
Access the API Manager server using the following URL: https://<HostName>:9443/carbon. As you changed the default port of G-Reg, you can access the server using the following URL: https://<HostName>:<9443+offset>/carbon.
Log in to the G-Reg management console and create a new service in it and attach the default service lifecycle to it. For instructions on how to add a new service and associate a new lifecycle, see http://docs.wso2.org/governance-registry/Managing+Services in the Governance Registry documentation.
Promote the service until it gets to the production state.
When it is in the production state, publish it using the Publish button. You should get a confirmation message once the API is successfully published.
You have now created an API using a service in the Governance Registry. Open the API Publisher to see that this service is successfully created as an API.
Use Secure Vault to secure the API Manager username and Password in a production deployment. See Adding API Manager username and password to secure vault.
Adding API Manager username and password to secure vault
- Run ciphertool.sh/.bat with -Dconfigure parameter.
- Add apim.username and apim.password as aliases to ciper-text.properties.
- Run cipertool.sh (on Linux) or cipertool.bat (on Windows) and encrypt username and password values.
Add the encrypted text to
ciper-text.propertiesfile after the other ailas and encrypted pairs and restart the server. For example,