Upload Test Root Certificate API Sandbox

(3 reviews)

home

Introduction

This specification describes the API which a TPP needs to invoke before onboarding its application using the Dynamic Client Registration API.

Note: TPP needs to execute this API only before accessing the Sandbox Dynamic Client Registration(DCR) API. It is not applicable for production environment.

Description

Bank of Ireland supports mutually authenticated transport-layer security using certificates chaining hence when a TPP comes to onboard its application, it has to first upload its Root Certificate using the Upload Test Root Certificate API. TPP should have a valid eIDAS certificate when calling the API.

When a TPP accesses BOI's APIs using its network/transport certificate (containing both the leaf and intermediate), BOI uses this root certificate for mutually authenticating the TPP request using certificate chaining.

Examples

POST request: /uploadcertificate sample

This API uploads the test root certificate of the TPP application onto BOI.

curl -X POST \

  https://auth-sandbox.bankofireland.com/1/api/open-banking/v1.0/uploadcertificate \

  -H 'Content-Type: application/json' \

  -H 'Postman-Token: c7fccb8f-0f56-4c08-9dbe-3ede1562b81b' \

  -H 'cache-control: no-cache' \

  -d '{

    "X509Certificate" : "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"

} '

POST response: /uploadcertificate sample

{
     "message": "Certificate uploaded successfully"
}

Reviews