Developer Guide
Service Accounts
Terms and definitions
- Interactive application is an application that involves user interaction. Such applications are getting authenticated into the DTCC DA platform when an actual human user provide their login credentials.
- Non-interactive application is an application that is involves server-to-server communication with the DTCC DA APIs. Such applications are normally used for automating API interactions between external applications without frontend and the DTCC DA platform, instead of having a real user at keyboard that performs those API requests manually. Non-interactive applications use service accounts to get authenticated into the DTCC DA platform.
- Service account is a machine user which is used by non-interactive applications for authenticating into the DTCC DA platform. In LedgerScan MVP service accounts use email and password login credentials, as a normal user.
Authentication with service accounts uses the Default Application client that is automatically created for each tenant. This aspect is not visible for end users and simplifies the UX of integrating external non-interactive applications.
Interactive Applications
To integrate your interactive application, first create an application client for a workspace you want to use for connecting to the LedgerScan APIs. This can be done on the Workspace Details page using button “New”. The following information is required for creating an application client for integrating an interactive application:
Name
- : Custom identifier for an application client. [200 character limit]
RedirectUris
- : URI location to which users are redirected after successfully completing the registration. [list of URIs, 400 character limit]
ReturnUris
- : URI location to which users are redirected after successfully completing the authentication. [ list of URIs, 2000 character limit]
PostLogoutRedirectUris