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
Body
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
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

No content

Get FIU configuration

get
Authorizations
Path parameters
fiu_client_idstringRequired
Responses
200
Successful response
application/json
get
GET /v1/entities/{fiu_client_id} HTTP/1.1
Host: localhost:8080
Authorization: Basic username:password
Accept: */*
200

Successful response

No content

Update FIU configuration

put
Authorizations
Path parameters
fiu_client_idstringRequired
Body
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
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

No content

PreviousAppsNextAA Partner

Last updated