Router
Last updated
Last updated
Sahamati Router serves as an additional layer on top of the AA network, offering extra services and policies. By integrating with Sahamati Router, FIUs, FIPs, and AAs can seamlessly connect with all other entities within the Router. This eliminates the need for multiple integration points, significantly reducing the integration and operational efforts for members.
The members to register with Sahamati Router for accessing the APIs and send requests through the Sahamati Router below are the prerequisites.
Base URL of the API endpoint by member. This will be used by the Sahamati Router to forward requests received from other members to the intended target.
Certificate (RSA Public Key) should be in JSON Web Token (JWT) format. This will be used by other members to validate the request's signature and ensure it has not been tampered with. This adheres to the current process and is not an additional requirement.
Members can be onboarded to the sandbox environment by providing the following details over an email to sandbox@sahamati.org.in.
The Entity (member) information such as
The member details should be supplied in a JSON file following the format below.
The User of the entity information such as
The member (entity) will be onboarded along with a user with admin role for managing the profile, secret rotation of entity etc,.
Once the member entry is added to CR, they can whitelist Sahamati Router IP.
Upon the successful onboarding of the new member, a Client ID and Secret are issued. These credentials are used to generate an access token in the form of a JSON Web Token (JWT). This access token is then included in the Authorization header of all API requests made by the member to ensure authenticity and secure access to the Sahamati Network Router.
Each member of the Sahamati Network will be onboarding a user with admin role to manage member's profile and mananging the secret lifecycle.
The user will receive an email with the credentials to generate user access token for accessing the APIs from Sahamati Network services.
Property Name | Description |
---|---|
Property Name | Description |
---|---|
ID (Entity ID or Client ID)
Identifier of the entity to use with CR and other Sahamati Network Services.
Name
Name of the entity
Type
Entity Type - one of FIU, FIP, AA
Base URL
Base URL of the entity to access the APIs and send requests. (Only v2 API endpoint is supported by Sandbox environment)
Certificate
The RSA public key of the entity. It will be used by the members to validate the signature (x-jws-signature
) of the API request.
ips
The IP address(es) of the entity to whitelist to access of Sahamati Network services (Ex: Router).
inboundports
The port of the member that the Sahamati services can connect to.
outboundports
The port of the member that the Sahamati services can expect to receive requests from.
entityhandle
Relevant and required only for AAs.
Name
Name of the user from entity
Email address of the user
Mobile [Optional]
Mobile number of the user