CotJS SDK and LinkageForm

By David Lee
2 min

In PDA environment, CotJS SDK is a library which provides authentication functions using ForgeRock JavaScript SDK. It also includes linkage functions which communicates with the middleware to check linkage status and load LinkageForm. The Linkage Form is used to link user’s accounts of the services the City offer to the PDA account. This Linkage Form will be a Micro-Frontend implemented with the new React based framework.

image-20250313-171248.png

Authorization and Authentication

The authorization begins when a user clicks a login button in the landing page.

  1. auth.login redirect the user to the ForgeRock login page.

  2. Once the user enters user name and password and authenticated, ForgeRock will redirect the user back to the client with root based callback url. The URL includes authorization code and state which will be used to exchange for access and id tokens via auth.authorize.

Linkage

Once the user successfully authenticated, the client needs to check if the user has linked the PDA account to the client service using linkage APIs

  1. Making a API call to the middleware to check linkage status: it should pass access token in the request

If already linked

  1. The middleware will return “yes”

  2. It will navigate to main page. The next route will be passed to the linkage library

If not linked yet

  1. The middleware will return “no” along with form definition in JSON

  2. Navigate to linkage route and the linkage lib will load the LinkageForm MFE and inject to the client’s view

  3. After a user fills in the form, it will submit to the middleware

  4. Middleware sends the data to AUX

  5. LinkageForm shows confirmation message

  6. The user clicks OK button to finish the linkage

  7. It will navigate to next page. The next route will be passed to linkage lib