[INJIMOB-2452]: [Develop] Well knwon discovery design document (#1812)

* [INJIMOB-2452]: Well known discovery design document

Signed-off-by: BalachandarG <balachandar.g@thoughtworks.com>

* [INJIMOB-2452]: Changes in wellknown discovery document

Signed-off-by: BalachandarG <balachandar.g@thoughtworks.com>

* [INJIMOB-2452]: Replace Well Known into well-known

Signed-off-by: BalachandarG <balachandar.g@thoughtworks.com>

---------

Signed-off-by: BalachandarG <balachandar.g@thoughtworks.com>
This commit is contained in:
balachandarg-tw
2025-02-26 22:59:21 +05:30
committed by GitHub
parent 6234726859
commit 57e3112572

View File

@@ -0,0 +1,25 @@
# Well-Known Discovery
Inji Wallet fetches well-known response directly by hitting the endpoint url constructed using Credential Issuer by appending `/.well-known/openid-credential-issuer`
## Well-Known discovery flow
- The implementation follows OpenID for Verifiable Credential Issuance. [Specification](https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html#name-credential-issuer-metadata-).
- Steps involved in the Well-Known discovery from Inji Wallet,
- Inji wallet sends request to Mimoto for fetching Issuers Configurations.
- Each Issuers has the parameter `credential_issuer_host`.
- Once Issuers Configurations are fetched, append `/.well-known/openid-credential-issuer` to `credential_issuer_host` and construct the Well-Known end point.
- Invoke the End point URL directly from Inji Wallet to get the Well-Known Response which will be in json format.
```mermaid
sequenceDiagram
participant Inji Wallet
participant Mimoto
participant Inji Certify
Inji Wallet->>Mimoto: Request for Credential Issuer Host
Mimoto-->>Inji Wallet: Returns Credential Issuer Host
Inji Wallet-->>Inji Wallet: Construct well-known End point by appending <br/> `/.well-known/openid-credential-issuer` to the host
Inji Wallet->>Inji Certify: Request for well-known with constructed <br/> well-known end point URL
Inji Certify-->>Inji Wallet: Returns well-known Json
```