Vorderingenoverzicht Rijk

De App gebruikt het CreateSession protocol uit de Blauwe Knop Connect standaard voor authenticatie, resulterend in een sessionToken en een AES key voor later gebruik.

De App stelt een Document JWS samen (zie de sectie over Documenten hierboven), met "FINANCIAL_CLAIMS_INFORMATION_REQUEST" als type, en zonder version en body.

Voorbeeld:

{
  "typ": "jwt",
  "alg": "ES256"
}
.
{
  "sub": "document",
  "type": "FINANCIAL_CLAIMS_INFORMATION_REQUEST"
}

De App versleutelt het Document JWS met de AES key van de sessie in de vorm van een JWE (zie de Cryptografie sectie in de Blauwe Knop Connect standaard).

De App verstuurt het versleutelde Document JWS naar de CitizenFinancialClaimsProcess middels een HTTP POST met de volgende inhoud:

• HTTP headers:
  • Authorization: het sessionToken uit stap 1.
• POST body: het versleutelde Document JWS.

Voorbeeld:

POST /configure_claims_request HTTP/1.1
Host: organization.example.com
Authorization: 9YryEzKheqpx5iS2JsDNRHoydCBIsAKV

eyNaIioBb2_Jhb...x5Nz-g

De CitizenFinancialClaimProcess genereert met een CSPRNG een willekeurige alfanumerieke configuration token die minimaal 22 karakters MOET zijn (zodat hij minimaal 128 bit entropie heeft).

De CitizenFinancialClaimsProcess maakt een JSON object met daarin de volgende velden:

• sub: MOET de vaste waarde configuration_token hebben.
• iss: de URL van de CitizenFinancialClaimsProcess.
• configuration_token: het configuration_token uit stap 8.

Voorbeeld:

{
  "sub": "configuration_token",
  "iss": "https://citizen-financial-claims-process.example.com/",
  "configuration_token": "LarRGSbmUPYtRYO6BQ4yn8"
}

De CitizenFinancialClaimsProcess versleutelt dit JSON object met de AES key van de sessie in de vorm van een JWE (zie de Cryptografie sectie in de Blauwe Knop Connect standaard), en stuurt dat in de HTTP response behorende bij het HTTP request uit Stap 5 terug naar de app.

De App ontsleutelt de JWE met de session AES key, en valideert dat:

1. dit resulteert in een JSON object, en
2. dat dit JSON object de velden uit Stap 15 bevat, met iss en sub de waardes zoals daar gespecificeerd.

De App gebruikt het CreateSession protocol uit de Blauwe Knop Connect standaard voor authenticatie, resulterend in een sessionToken en een AES key voor later gebruik.

De App maakt een JSON object met daarin de volgende velden:

• sub: MOET de vaste waarde configuration_token hebben.
• iss: MOET de vaste waarde bk-connect://app/ hebben.
• configuration_token: het configuration_token uit het ConfigureRequest protocol.

Voorbeeld:

{
  "sub": "configuration_token",
  "iss": "bk-connect://app/",
  "configuration_token": "LarRGSbmUPYtRYO6BQ4yn8"
}

Vervolgens versleutelt de App dit object met de session AES key uit het CreateSession protocol in de vorm van een JWE (zie de Cryptografie sectie in de Blauwe Knop Connect standaard).

De App verstuurt een HTTP POST naar de CitizenFinancialClaimsProcess met de volgende inhoud:

• Query parameters:
  • configurationToken: De JWE uit stap 2.
• HTTP headers:
  • Authorization: het sessionToken uit stap 1.

Voorbeeld:

POST /request_financial_claims_information?configurationToken=eylNzToF_nyZU... HTTP/1.1
Host: organization.example.com
Authorization: 9YryEzKheqpx5iS2JsDNRHoydCBIsAKV

Het CitizenFinancialClaimsProcess ontsleutelt de JWE met de session AES key, en valideert dat:

1. dit resulteert in een JSON object, en
2. dat dit JSON object de velden uit Stap 2 bevat, met iss en sub de waardes zoals daar gespecificeerd.

Het CitizenFinancialClaimsProcess doet een HTTP POST request naar /financial_claims_information van het SourceSystem om financiële informatie op te vragen, met in de POST body een JSON object met daarin:

• bsn: Het BSN in de vorm van een string.

Voorbeeld:

POST /financial_claims_information HTTP/1.1
Host: sourcesystem.example.com

{
  "bsn": "999991772"
}

NB: toegang tot het /financial_claims_information endpoint MOET geauthenticeerd zijn zodat enkel geauthoriseerde diensten waaronder het CitizenFinancialClaimsProcess er toegang toe hebben. Deze authenticatie valt buiten de scope van deze standaard, maar te denken valt aan een Authorization HTTP header met daarin een voorgeconfigureerd token, of het bereikbaar maken van het endpoint enkel binnen een intern netwerk van de organisatie, of tweezijdig TLS, of een combinatie van deze maatregelen.

Het SourceSystem antwoordt met een JSON object met daarin de financiële informatie.

De CitizenFinancialClaimsProcess stelt op basis van de response van het SourceSystem die hij heeft geraadpleegd een Document JWS samen (zie de sectie over Documenten hierboven), met "FINANCIAL_CLAIMS_INFORMATION_RESPONSE" als type, en de financiële informatie in de body.

Voorbeeld:

{
  "typ": "jwt",
  "alg": "ES256",
  "kid": "1"
}
.
{
  "sub": "document",
  "type": "FINANCIAL_CLAIMS_INFORMATION_RESPONSE",
  "version": "2",
  "body": {
    // financial document as returned by the SourceSystem
  }
}

De CitizenFinancialClaimsProcess versleutelt bovenstaande Document JWS met de AES key van de sessie in de vorm van een JWE (zie de Cryptografie sectie in de Blauwe Knop Connect standaard), en stuurt dat in de HTTP response behorende bij het HTTP request uit Stap 3 terug naar de app.