FIU Config

SahamatiNet / AA Ecosystem

It is a prerequisite to have your entity (FIU/FIP/AA) onboarded in the Central Registry (CR) before interacting with the AA Ecosystem. Follow the instructions outlined here to onboard: https://developer.sahamati.org.in/sahamatinet/proxy#onboarding-process.

Once you have the Member Credentials, You can configure TruFIU with your ClientID, ClientSecret by making the following API call.

You may leverage the Onboarding utils to prepare your Entity Info JSON payload to share with Sahamati team.

Configure FIU credentials

post

Authorizations

basicAuth

AuthorizationstringRequired

Username: Your App ID. | Password: Your App Secret.

Body

application/json

client_idstringRequired

your fiu entity/client id

client_secretstringRequired

your entity/client secret

keypairobjectRequired

JSON Web Key payload. This material contains private key hence it is confidential. Entity should store this in a secure place and use to sign requests to the AA ecosystem. Refer to the Spec here: https://datatracker.ietf.org/doc/html/rfc7517

Example: {"alg":"RS256","d":"qzHajqJtZXAJw4NXZ5uz0sBZZHjPaJrVQ5nMwJozT9AsYde13xiTi9m2yGsoUVZ09YWEKPQc19uHGP2HWN4OduzCpLGSxlhK8GZ7JbMld6CbCB-eU6HNoye9Uce8ytWhCP9DRMVdwHBiOHVhElr9UgYVc4t9pBQlenEd8QIQWfEjBKdcbWQ3QnvuQuElOyxtSS8GHB0lZlv9NdjhvU9_vkdU78rApTL_s9a5sAnwp5g_3vWdV2lUA0BkuVOP7b2tDeqQvck8JMsVXlCOIcW9AH-RTAX5WSg5gZHIpLx-ZtW3MB3D3XfM9D_RVlzTPu9rbC4h2Tw5UBrxl2a-IS_6IQ","dp":"zr9L-UFPsZ7IYYS1it5ZWT1mcs6OswpPDSGJXkZFblb4HltmGEdetZO41V6GkZMgn_SWl4EWrnjf2cLyLaknMVe3ivJMZrkTWRw4WVQVl0nSAO4NC6kOtKRkdo17Pr4J8XWl69XSUmq6-kC4Rg6AATun5-qVlQ8onzePFRxnMpE","dq":"Y3jx0rQp9zW40KDEsvANosUGy_8Z6cR0edTukXLB_-o5u7Qt9nu_v_Nj9AckjlB8_BrsvKvyPDxte-9YeRdCG-0S4ZZTDESw6tuIKTHWg8FSH8n19932d49nMkM0FXaZnD07OySHfa3a_bW1_TffaAb8rLtggaJqnYai9Sz7Mqc","e":"AQAB","kid":"10c6c43b-7871-4666-ac0d-e4e568953a92","kty":"RSA","n":"q7laSF_PQZfvfpd_3livD-epCInoKLIxx4S3joXbAvjRjo0Eb0nTm5Jolj_o6l7KuSXYZV_eEVP547hsI00e4jrZxnEGNctN6N1BRG0Ew4OU-LHqJBZ26FHIsBdQ4RMj5c-8Xu8sT5ihf6TR8JHyRDr5x77F-QJMXItBuLoLbv1D4mN3YfjqBajgcULvpf3UI6-jQwEd4oFnqUY2Owofk9-adPsZ5hQKtQvXW8Zw1AeuKAhtMZgJeKiKvgvgShIZOiCFdU50wUD2kk2QSZqLnFtpqAnde8yTKzAy_EDlFmdLb9g92ILsWErcsjJ-slYSc09L5FP6gGwZPscPTcnoxw","p":"06SZ0uA-AeOoRR4gWQKm6V3N0To0-Rcd5VzzlVRd_NOe0jmfdl77FNbBUy6g4jReHAUIVGMUihznX-daEqe7fQvufxPiA5CSpgw728okL4SfJI1emIa_ztACF1HzyfV4Xtjk9G5GxQ0yftAsfhTr36ARaqSZmJ7yUm3_QkjA3FE","q":"z7b1ZsiD1z8LN-lFD5f9WPzOoq16L-6gydeo8BSl_uBO4BT1zSHPyoRqhcekO2PGpX_-oFnpRtjN8eVD9SIMRwW9pFgZJNu4YUPQww-Rorv2pSR7tD1K6n1ToOlmgvAceVSfQXTAvvokCHTFDwP2DEVe7yxLDOtwV7YzmSBcZZc","qi":"puqOtZJ3Ow6A98ZXpiXX11wlOKbmuP0MQgOCF-buGQvx3Hrmn2RDXBCC050wil3qTMvwXde5FOIjAnx-Q1ubVcUsPd1SE3eYtNw8f8PE1Z2A4L8cvv627qfYl1wP6D1Paj_HjWOfCMVCevypiuTQ73xJMOjlC8Q6b8GEvDTcWoo","use":"sig"}

sahamatinet_enabledbooleanOptionalDefault: false

Responses

201

Successful response

application/json

post

/v1/entities/

HTTPcURLJavaScriptPython

POST /v1/entities/ HTTP/1.1
Host: localhost:8080
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 1768

{
  "client_id": "text",
  "client_secret": "text",
  "keypair": {
    "alg": "RS256",
    "d": "qzHajqJtZXAJw4NXZ5uz0sBZZHjPaJrVQ5nMwJozT9AsYde13xiTi9m2yGsoUVZ09YWEKPQc19uHGP2HWN4OduzCpLGSxlhK8GZ7JbMld6CbCB-eU6HNoye9Uce8ytWhCP9DRMVdwHBiOHVhElr9UgYVc4t9pBQlenEd8QIQWfEjBKdcbWQ3QnvuQuElOyxtSS8GHB0lZlv9NdjhvU9_vkdU78rApTL_s9a5sAnwp5g_3vWdV2lUA0BkuVOP7b2tDeqQvck8JMsVXlCOIcW9AH-RTAX5WSg5gZHIpLx-ZtW3MB3D3XfM9D_RVlzTPu9rbC4h2Tw5UBrxl2a-IS_6IQ",
    "dp": "zr9L-UFPsZ7IYYS1it5ZWT1mcs6OswpPDSGJXkZFblb4HltmGEdetZO41V6GkZMgn_SWl4EWrnjf2cLyLaknMVe3ivJMZrkTWRw4WVQVl0nSAO4NC6kOtKRkdo17Pr4J8XWl69XSUmq6-kC4Rg6AATun5-qVlQ8onzePFRxnMpE",
    "dq": "Y3jx0rQp9zW40KDEsvANosUGy_8Z6cR0edTukXLB_-o5u7Qt9nu_v_Nj9AckjlB8_BrsvKvyPDxte-9YeRdCG-0S4ZZTDESw6tuIKTHWg8FSH8n19932d49nMkM0FXaZnD07OySHfa3a_bW1_TffaAb8rLtggaJqnYai9Sz7Mqc",
    "e": "AQAB",
    "kid": "10c6c43b-7871-4666-ac0d-e4e568953a92",
    "kty": "RSA",
    "n": "q7laSF_PQZfvfpd_3livD-epCInoKLIxx4S3joXbAvjRjo0Eb0nTm5Jolj_o6l7KuSXYZV_eEVP547hsI00e4jrZxnEGNctN6N1BRG0Ew4OU-LHqJBZ26FHIsBdQ4RMj5c-8Xu8sT5ihf6TR8JHyRDr5x77F-QJMXItBuLoLbv1D4mN3YfjqBajgcULvpf3UI6-jQwEd4oFnqUY2Owofk9-adPsZ5hQKtQvXW8Zw1AeuKAhtMZgJeKiKvgvgShIZOiCFdU50wUD2kk2QSZqLnFtpqAnde8yTKzAy_EDlFmdLb9g92ILsWErcsjJ-slYSc09L5FP6gGwZPscPTcnoxw",
    "p": "06SZ0uA-AeOoRR4gWQKm6V3N0To0-Rcd5VzzlVRd_NOe0jmfdl77FNbBUy6g4jReHAUIVGMUihznX-daEqe7fQvufxPiA5CSpgw728okL4SfJI1emIa_ztACF1HzyfV4Xtjk9G5GxQ0yftAsfhTr36ARaqSZmJ7yUm3_QkjA3FE",
    "q": "z7b1ZsiD1z8LN-lFD5f9WPzOoq16L-6gydeo8BSl_uBO4BT1zSHPyoRqhcekO2PGpX_-oFnpRtjN8eVD9SIMRwW9pFgZJNu4YUPQww-Rorv2pSR7tD1K6n1ToOlmgvAceVSfQXTAvvokCHTFDwP2DEVe7yxLDOtwV7YzmSBcZZc",
    "qi": "puqOtZJ3Ow6A98ZXpiXX11wlOKbmuP0MQgOCF-buGQvx3Hrmn2RDXBCC050wil3qTMvwXde5FOIjAnx-Q1ubVcUsPd1SE3eYtNw8f8PE1Z2A4L8cvv627qfYl1wP6D1Paj_HjWOfCMVCevypiuTQ73xJMOjlC8Q6b8GEvDTcWoo",
    "use": "sig"
  },
  "sahamatinet_enabled": false
}

201

Successful response

Get FIU configuration

get

Authorizations

basicAuth

AuthorizationstringRequired

Username: Your App ID. | Password: Your App Secret.

Path parameters

fiu_client_idstringRequired

Responses

200

Successful response

application/json

get

/v1/entities/{fiu_client_id}

HTTPcURLJavaScriptPython

GET /v1/entities/{fiu_client_id} HTTP/1.1
Host: localhost:8080
Authorization: Basic username:password
Accept: */*

200

Successful response

Update FIU configuration

put

Authorizations

basicAuth

AuthorizationstringRequired

Username: Your App ID. | Password: Your App Secret.

Path parameters

fiu_client_idstringRequired

Body

application/json

client_secretstringOptional

your entity/client secret

keypairobjectOptional

JSON Web Key payload. This material contains private key hence it is confidential. Entity should store this in a secure place and use to sign requests to the AA ecosystem. Refer to the Spec here: https://datatracker.ietf.org/doc/html/rfc7517

Example: {"alg":"RS256","d":"qzHajqJtZXAJw4NXZ5uz0sBZZHjPaJrVQ5nMwJozT9AsYde13xiTi9m2yGsoUVZ09YWEKPQc19uHGP2HWN4OduzCpLGSxlhK8GZ7JbMld6CbCB-eU6HNoye9Uce8ytWhCP9DRMVdwHBiOHVhElr9UgYVc4t9pBQlenEd8QIQWfEjBKdcbWQ3QnvuQuElOyxtSS8GHB0lZlv9NdjhvU9_vkdU78rApTL_s9a5sAnwp5g_3vWdV2lUA0BkuVOP7b2tDeqQvck8JMsVXlCOIcW9AH-RTAX5WSg5gZHIpLx-ZtW3MB3D3XfM9D_RVlzTPu9rbC4h2Tw5UBrxl2a-IS_6IQ","dp":"zr9L-UFPsZ7IYYS1it5ZWT1mcs6OswpPDSGJXkZFblb4HltmGEdetZO41V6GkZMgn_SWl4EWrnjf2cLyLaknMVe3ivJMZrkTWRw4WVQVl0nSAO4NC6kOtKRkdo17Pr4J8XWl69XSUmq6-kC4Rg6AATun5-qVlQ8onzePFRxnMpE","dq":"Y3jx0rQp9zW40KDEsvANosUGy_8Z6cR0edTukXLB_-o5u7Qt9nu_v_Nj9AckjlB8_BrsvKvyPDxte-9YeRdCG-0S4ZZTDESw6tuIKTHWg8FSH8n19932d49nMkM0FXaZnD07OySHfa3a_bW1_TffaAb8rLtggaJqnYai9Sz7Mqc","e":"AQAB","kid":"10c6c43b-7871-4666-ac0d-e4e568953a92","kty":"RSA","n":"q7laSF_PQZfvfpd_3livD-epCInoKLIxx4S3joXbAvjRjo0Eb0nTm5Jolj_o6l7KuSXYZV_eEVP547hsI00e4jrZxnEGNctN6N1BRG0Ew4OU-LHqJBZ26FHIsBdQ4RMj5c-8Xu8sT5ihf6TR8JHyRDr5x77F-QJMXItBuLoLbv1D4mN3YfjqBajgcULvpf3UI6-jQwEd4oFnqUY2Owofk9-adPsZ5hQKtQvXW8Zw1AeuKAhtMZgJeKiKvgvgShIZOiCFdU50wUD2kk2QSZqLnFtpqAnde8yTKzAy_EDlFmdLb9g92ILsWErcsjJ-slYSc09L5FP6gGwZPscPTcnoxw","p":"06SZ0uA-AeOoRR4gWQKm6V3N0To0-Rcd5VzzlVRd_NOe0jmfdl77FNbBUy6g4jReHAUIVGMUihznX-daEqe7fQvufxPiA5CSpgw728okL4SfJI1emIa_ztACF1HzyfV4Xtjk9G5GxQ0yftAsfhTr36ARaqSZmJ7yUm3_QkjA3FE","q":"z7b1ZsiD1z8LN-lFD5f9WPzOoq16L-6gydeo8BSl_uBO4BT1zSHPyoRqhcekO2PGpX_-oFnpRtjN8eVD9SIMRwW9pFgZJNu4YUPQww-Rorv2pSR7tD1K6n1ToOlmgvAceVSfQXTAvvokCHTFDwP2DEVe7yxLDOtwV7YzmSBcZZc","qi":"puqOtZJ3Ow6A98ZXpiXX11wlOKbmuP0MQgOCF-buGQvx3Hrmn2RDXBCC050wil3qTMvwXde5FOIjAnx-Q1ubVcUsPd1SE3eYtNw8f8PE1Z2A4L8cvv627qfYl1wP6D1Paj_HjWOfCMVCevypiuTQ73xJMOjlC8Q6b8GEvDTcWoo","use":"sig"}

sahamatinet_enabledbooleanOptionalDefault: false

Responses

200

Successful response

application/json

put

/v1/entities/{fiu_client_id}

HTTPcURLJavaScriptPython

PUT /v1/entities/{fiu_client_id} HTTP/1.1
Host: localhost:8080
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 1749

{
  "client_secret": "text",
  "keypair": {
    "alg": "RS256",
    "d": "qzHajqJtZXAJw4NXZ5uz0sBZZHjPaJrVQ5nMwJozT9AsYde13xiTi9m2yGsoUVZ09YWEKPQc19uHGP2HWN4OduzCpLGSxlhK8GZ7JbMld6CbCB-eU6HNoye9Uce8ytWhCP9DRMVdwHBiOHVhElr9UgYVc4t9pBQlenEd8QIQWfEjBKdcbWQ3QnvuQuElOyxtSS8GHB0lZlv9NdjhvU9_vkdU78rApTL_s9a5sAnwp5g_3vWdV2lUA0BkuVOP7b2tDeqQvck8JMsVXlCOIcW9AH-RTAX5WSg5gZHIpLx-ZtW3MB3D3XfM9D_RVlzTPu9rbC4h2Tw5UBrxl2a-IS_6IQ",
    "dp": "zr9L-UFPsZ7IYYS1it5ZWT1mcs6OswpPDSGJXkZFblb4HltmGEdetZO41V6GkZMgn_SWl4EWrnjf2cLyLaknMVe3ivJMZrkTWRw4WVQVl0nSAO4NC6kOtKRkdo17Pr4J8XWl69XSUmq6-kC4Rg6AATun5-qVlQ8onzePFRxnMpE",
    "dq": "Y3jx0rQp9zW40KDEsvANosUGy_8Z6cR0edTukXLB_-o5u7Qt9nu_v_Nj9AckjlB8_BrsvKvyPDxte-9YeRdCG-0S4ZZTDESw6tuIKTHWg8FSH8n19932d49nMkM0FXaZnD07OySHfa3a_bW1_TffaAb8rLtggaJqnYai9Sz7Mqc",
    "e": "AQAB",
    "kid": "10c6c43b-7871-4666-ac0d-e4e568953a92",
    "kty": "RSA",
    "n": "q7laSF_PQZfvfpd_3livD-epCInoKLIxx4S3joXbAvjRjo0Eb0nTm5Jolj_o6l7KuSXYZV_eEVP547hsI00e4jrZxnEGNctN6N1BRG0Ew4OU-LHqJBZ26FHIsBdQ4RMj5c-8Xu8sT5ihf6TR8JHyRDr5x77F-QJMXItBuLoLbv1D4mN3YfjqBajgcULvpf3UI6-jQwEd4oFnqUY2Owofk9-adPsZ5hQKtQvXW8Zw1AeuKAhtMZgJeKiKvgvgShIZOiCFdU50wUD2kk2QSZqLnFtpqAnde8yTKzAy_EDlFmdLb9g92ILsWErcsjJ-slYSc09L5FP6gGwZPscPTcnoxw",
    "p": "06SZ0uA-AeOoRR4gWQKm6V3N0To0-Rcd5VzzlVRd_NOe0jmfdl77FNbBUy6g4jReHAUIVGMUihznX-daEqe7fQvufxPiA5CSpgw728okL4SfJI1emIa_ztACF1HzyfV4Xtjk9G5GxQ0yftAsfhTr36ARaqSZmJ7yUm3_QkjA3FE",
    "q": "z7b1ZsiD1z8LN-lFD5f9WPzOoq16L-6gydeo8BSl_uBO4BT1zSHPyoRqhcekO2PGpX_-oFnpRtjN8eVD9SIMRwW9pFgZJNu4YUPQww-Rorv2pSR7tD1K6n1ToOlmgvAceVSfQXTAvvokCHTFDwP2DEVe7yxLDOtwV7YzmSBcZZc",
    "qi": "puqOtZJ3Ow6A98ZXpiXX11wlOKbmuP0MQgOCF-buGQvx3Hrmn2RDXBCC050wil3qTMvwXde5FOIjAnx-Q1ubVcUsPd1SE3eYtNw8f8PE1Z2A4L8cvv627qfYl1wP6D1Paj_HjWOfCMVCevypiuTQ73xJMOjlC8Q6b8GEvDTcWoo",
    "use": "sig"
  },
  "sahamatinet_enabled": false
}

200

Successful response