Event Notification Configurations

To enable the Event Notification feature in WSO2 Open Banking:

  1. To create Event Notification database tables:
    1. Go to the <IS_HOME>/dbscripts/open-banking/event-notifications directory.
    2. According to your database, execute the relevant script against the openbank_openbankingdb database.
  2. Open the <IS_HOME>/repository/conf/deployment.toml file.
  3. Find the resource.access_control configurations and add the following tags to secure the Event Notification endpoints: 
     [[resource.access_control]]
 context = "(.*)/api/openbanking/event-notifications/(.*)"
 secure="true"
 http_method="all"
 permissions=["/permission/admin"]
 allowed_auth_handlers = ["BasicAuthentication"]

  4. Add the following tags and configure them:

    Click here to see the definitions of the configuration tags...
    Configuration Description
    token_issuer The issuer of the notification JWT. For example, bank.
    number_of_sets_to_return The maximum number of events to be returned. This is the default value for maxEvents, if the request payload has not defined a value.
    event_creation_handler Configure the Event Creation Handler. If you have not implemented a custom handler, configure the default handler by following the sample below. This handler adheres to the IETF Security Event Token (SET) specification.
    event_polling_handler Configure the Event Polling Handler. If you have not implemented a custom handler, configure the default handler by following the sample below. This handler adheres to the IETF Security Event Token (SET) specification.
    event_subscription_handler Configure the Event Subscription Handler. If you have not implemented a custom handler, configure the default handler by following the sample below. This handler adheres to the IETF Security Event Token (SET) specification.
    event_notification_generator Configure the Event Notification Generator. If you have not implemented a custom generator, configure the default handler by following the sample below. This generator adheres to the IETF Security Event Token (SET) specification.
    set_sub_claim_included, set_txn_claim_included, set_toe_claim_included Configure the customized optional claims in event notification using these tags. They represent the subject, transaction, and time of event claims respectively. 
     [open_banking.event.notifications]
  token_issuer = "www.wso2.com"
  number_of_sets_to_return = 5
  event_creation_handler = "com.wso2.openbanking.accelerator.event.notifications.service.handler.DefaultEventCreationServiceHandler"
  event_polling_handler = "com.wso2.openbanking.accelerator.event.notifications.service.handler.DefaultEventPollingServiceHandler"
  event_subscription_handler = "com.wso2.openbanking.accelerator.event.notifications.service.handler.DefaultEventSubscriptionServiceHandler"
  event_notification_generator = "com.wso2.openbanking.accelerator.event.notifications.service.service.DefaultEventNotificationGenerator"
  set_sub_claim_included = true
  set_txn_claim_included = true
  set_toe_claim_included = true
Top