You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# When is enabled we show all messages in a chain. For instance:
248
248
# {
249
-
# "error": "OBP-30001: Bank not found. Please specify a valid value for BANK_ID. <- Full(Kafka_TimeoutExceptionjava.util.concurrent.TimeoutException: The stream has not been completed in 1550 milliseconds.)"
249
+
# "error": "OBP-30001: Bank not found. Please specify a valid value for BANK_ID. <- Full(TimeoutExceptionjava.util.concurrent.TimeoutException: The stream has not been completed in 1550 milliseconds.)"
valKafkaMessageClassCastException="OBP-50002: Kafka Response Message Class Cast Exception."
685
684
valAdapterOrCoreBankingSystemException="OBP-50003: Adapter Or Core Banking System Exception. Failed to get a valid response from the south side Adapter or Core Banking System."
686
685
// This error may not be shown to user, just for debugging.
687
686
valCurrentUserNotFoundException="OBP-50004: Method (AuthUser.getCurrentUser) can not find the current user in the current context!"
688
687
valAnUnspecifiedOrInternalErrorOccurred="OBP-50005: An unspecified or internal error occurred."
|## Use Kafka as an interface between OBP and your Core Banking System (CBS).
299
-
|
300
-
|
301
-
|For an introduction to Kafka see [here](https://kafka.apache.org/)
302
-
|
303
-
|### Installation Prerequisites
304
-
|
305
-
|
306
-
|* You have OBP-API running and it is connected to a Kafka installation.
307
-
| You can check OBP -> Kafka connectivity using the <a href="/#OBPv3_1_0-getObpConnectorLoopback">"loopback" endpoint</a>.
308
-
|
309
-
|* Ideally you have API Explorer running (the application serving this page) but its not necessary - you could use any other REST client.
310
-
|* You might want to also run API Manager as it makes it easier to grant yourself roles, but its not necessary - you could use the API Explorer / any REST client instead.
311
-
|
312
-
|### Create a Customer User and an Admin User
313
-
|
314
-
|* Register a User who will use the API as a Customer.
315
-
|* Register another User that will use the API as an Admin. The Admin user will need some Roles. See [here](/index#OBPv2_0_0-addEntitlement). You can bootstrap an Admin user by editing the Props file. See the README for that.
316
-
|
317
-
|### Add some authentication context to the Customer User
318
-
|
319
-
|* As the Admin User, use the [Create Auth Context](/index#OBPv3_1_0-createUserAuthContext) endpoint to add one or more attributes to the Customer User.
320
-
|For instance you could add the name/value pair CUSTOMER_NUMBER/889763 and this will be sent to the Adapter / CBS inside the AuthInfo object.
321
-
|
322
-
|
323
-
|Now you should be able to use the [Get Auth Contexts](/index#OBPv3_1_0-getUserAuthContexts) endpoint to see the data you added.
324
-
|
325
-
|### Write or Build an Adapter to respond to the following messages.
326
-
|
327
-
| When getting started, we suggest that you implement the messages in the following order:
328
-
|
329
-
|1) Core (Prerequisites) - Get Adapter, Get Banks, Get Bank
330
-
|
331
-
|* ${messageDocLink("obp.getAdapterInfo")}
332
-
|
333
-
|Now you should be able to use the [Adapter Info](/index#OBPv3_1_0-getAdapterInfo) endpoint
334
-
|
335
-
|* ${messageDocLink("obp.getBanks")}
336
-
|
337
-
|Now you should be able to use the [Get Banks](/index#OBPv3_0_0-getBanks) endpoint
338
-
|
339
-
|* ${messageDocLink("obp.getBank")}
340
-
|
341
-
|Now you should be able to use the [Get Bank](/index#OBPv3_0_0-bankById) endpoint
342
-
|
343
-
|
344
-
|2) Core (Authentications) -The step1 Apis are all anonymous access. If you need to link bank customer data to the obp user,
345
-
| Then you need link OBP user with Bank user/customer using the [Create User Auth Context]((/index#OBPv3_1_0-createUserAuthContext)). Also
346
-
| check the description for this endpoint. Once you create the user-auth-context for one user, then these user-auth-context key value pair
347
-
| can be propagated over connector message. Than the Adapter can use it to map OBP user and Bank user/customer.
|The OBP Connector is a core part of the OBP-API and is written in Scala / Java and potentially other JVM languages.
3174
3019
|
3175
-
|The OBP Connector implements multiple functions / methods in a style that satisfies a particular transport / protocol such as HTTP REST, Akka or Kafka.
3020
+
|The OBP Connector implements multiple functions / methods in a style that satisfies a particular transport / protocol such as HTTP REST, Akka or RabbitMq.
3176
3021
|
3177
3022
|An OBP Adapter is a separate software component written in any programming language that responds to requests from the OBP Connector.
|This contains the named fields and their values which are specific to each Function / Message Doc.
3234
3079
|
3235
3080
|
3236
-
|The Outbound / Inbound Topics are used for routing in multi OBP instance / Kafka installations. (so OBP nodes only listen only to the correct Topics).
3081
+
|The Outbound / Inbound Topics are used for routing in multi OBP instance / RabbitMq installations. (so OBP nodes only listen only to the correct Topics).
3237
3082
|
3238
3083
|The dependent endpoints are listed to facilitate navigation in the API Explorer so integrators can test endpoints during integration.
Copy file name to clipboardexpand all lines: obp-api/src/main/scala/code/api/v2_2_0/APIMethods220.scala
+3-3
Original file line number
Diff line number
Diff line change
@@ -438,12 +438,12 @@ trait APIMethods220 {
438
438
"GET",
439
439
"/message-docs/CONNECTOR",
440
440
"Get Message Docs",
441
-
"""These message docs provide example messages sent by OBP to the (Kafka) message queue for processing by the Core Banking / Payment system Adapter - together with an example expected response and possible error codes.
441
+
"""These message docs provide example messages sent by OBP to the (RabbitMq) message queue for processing by the Core Banking / Payment system Adapter - together with an example expected response and possible error codes.
442
442
| Integrators can use these messages to build Adapters that provide core banking services to OBP.
443
443
|
444
444
| Note: API Explorer provides a Message Docs page where these messages are displayed.
// obpApiLoopback <- connectorVersion.contains(connectorVersion.contains("star")) match {
1884
-
// case false => throw new IllegalStateException(s"${NotImplemented}for connector ${connectorVersion}")
1885
-
// case _ => throw new IllegalStateException(s"${KafkaServerUnavailable} Timeout error, because kafka do not return message to OBP-API. ${e.getMessage}")
1886
-
// }
1887
-
//TODO, before we only support kafka, now we need to decide what kind of connector should we use.
1883
+
//TODO we need to decide what kind of connector should we use.
0 commit comments