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 after [open_banking] tag 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