This documentation is for WSO2 Open Banking version 1.3.0. View documentation for the latest release.
Skip to end of metadata
Go to start of metadata

This feature is available as a product update from July 2, 2019 (07-02-2019) onwards.

This document explains how to publish the Dynamic Client Registration API v3.2 in WSO2 Open Banking.

Prerequisite

  • Open the <WSO2_OB_APIM_HOME>/repository/resources/api_templates/velocity_template.xml file and add the following handlers after the UK specific handlers as follows:
    ## end of UK-specific handlers
    #end
    
    #if($apiObj.additionalProperties.get("ob-api-type") == "dcr" || $!apiName == "DynamicClientRegistrationAPI")
    <handler class="com.wso2.finance.open.banking.mtls.validator.handler.MTLSValidationHandler"/>
    <handler class="com.wso2.finance.open.banking.mtls.validator.handler.GatewayClientAuthenticationHandler"/>
    <handler class="org.wso2.carbon.apimgt.gateway.handlers.ext.APIManagerCacheExtensionHandler"/>
    #end
  1. Sign in to the API Publisher ( https://<WSO2_OB_APIM_HOST>:9443/publisher) with creator/publisher privileges.
  2. Click ADD NEW API .

  3. Select I Have an Existing API option.
  4. Select the Swagger File option and browse for the Swagger definition by clicking the Browse button.
    Use the <WSO2_OB_AM_HOME>/repository/resources/finance/apis/openbanking.org.uk/DynamicClientRegistration/3.2/dynamic-client-registration-swagger.yaml file to configure the properties according to the open-banking specification. 
  5. You are directed to the Design API stage. Design General Details are loaded for you in the Design tab.
  6. Click Next: Implement to navigate to the next level.
  7. Expand Managed API and set Endpoint Type by selecting Dynamic Endpoint from the drop-down list.
  8. Under Message Mediation Policies, check Select a message mediation policy to be executed in the message flow.
  9. Uploading the In flow:

    Make the following changes:

    1. Open the <WSO2_OB_APIM_HOME>/repository/resources/finance/apis/openbanking.org.uk/DynamicClientRegistration/3.2/dcr-dynamic-endpoint-insequence-3.2.xml In sequence file using a text editor.
    2. Replace the placeholder <WSO2_OB_APIM_HOSTNAME> with the hostname of your WSO2 Open Banking API Manager server and save the changes.

      <sequence xmlns="http://ws.apache.org/ns/synapse" name="dcr-dynamic-endpoint-insequence-3.2">
          <!-- Set UUID if header is not present-->
          <property expression="get-property('To')" name="ENDPOINT_ADDRESS" />
          <header name="x-wso2-client-id" expression="get-property('api.ut.consumerKey')" scope="transport"/>
          <header name="To" value="https://<WSO2_OB_APIM_HOSTNAME>:9443/ob-dynamic-client-registration" />
      </sequence>

    Click Upload In Flow and upload the modified dcr-dynamic-endpoint-insequence-3.2.xml In sequence file.

  10. Click Next: Manage to navigate to the next level.
  11. Under Subscription Tiers, check the option Unlimited : Allows unlimited requests unless you want to limit the requests. 
  12. Expand API Properties and add the following as Additional properties and click the + button to proceed.

    Property Nameob-api-type
    Property Valuedcr

  13. Click Save & Publish.

  14. The published DCR v3.2 API is available in the API Store.

You can find the REST API documentation for Dynamic Client Registration v3.2 here.

  • No labels