changed name to securityTokens

This commit is contained in:
Mirjam Herald 2026-06-24 14:07:21 +02:00
parent 95bc19d7ff
commit 699c633a4e

View File

@ -9,21 +9,21 @@ servers:
security: security:
- oAuthSample: [profile] - oAuthSample: [profile]
tags: tags:
- name: tokens - name: securitytokens
paths: paths:
/tokens: /securitytokens:
post: post:
tags: tags:
- tokens - securitytokens
summary: Create a new token entry in the vault summary: Create a new security token entry in the vault
description: Create a new token entry in the vault, if the customerProfileId has been supplied create in the customerToken DB otherwise in the AnonymousToken DB description: Create a new security token entry in the vault, if the customerProfileId has been supplied create in the customerToken DB otherwise in the AnonymousToken DB
requestBody: requestBody:
content: content:
application/json: application/json:
schema: schema:
$ref: "#/components/schemas/CreateTokenBody" $ref: "#/components/schemas/CreateSecurityTokenBody"
examples: examples:
token: token details:
value: value:
{ {
"xTat": "cf694905-7f76-4799-b0bc-490716921323", "xTat": "cf694905-7f76-4799-b0bc-490716921323",
@ -84,7 +84,7 @@ paths:
value: value:
status: 409 status: 409
title: Conflict title: Conflict
detail: TAT Account Token already exists detail: Security Token already exists
"500": "500":
description: Internal server error description: Internal server error
content: content:
@ -97,7 +97,7 @@ paths:
status: 500 status: 500
title: Internal Server Error title: Internal Server Error
detail: An unknown error has occurred detail: An unknown error has occurred
/tokens/{xTat}/status: /securitytokens/{xTat}/status:
parameters: parameters:
- name: xTat - name: xTat
in: path in: path
@ -105,7 +105,7 @@ paths:
type: string type: string
example: 85dbeacc-b9aa-4d5b-bdec-9319010c597f example: 85dbeacc-b9aa-4d5b-bdec-9319010c597f
required: true required: true
description: The xTat for the token for which the status needs to be checked description: The xTat of the OVpastoken for which the status needs to be checked
- name: customerProfileId - name: customerProfileId
in: query in: query
schema: schema:
@ -115,7 +115,7 @@ paths:
description: The id of the customer Profile for which the request is being done, if customer has identified themselves description: The id of the customer Profile for which the request is being done, if customer has identified themselves
get: get:
tags: tags:
- tokens - securitytokens
summary: Request the security and authorization status of an OV pas token summary: Request the security and authorization status of an OV pas token
description: Request the security and authorization status of an OV pas token, if the customerProfileId has been supplied look in the customerToken DB otherwise check the AnonymousToken DB. description: Request the security and authorization status of an OV pas token, if the customerProfileId has been supplied look in the customerToken DB otherwise check the AnonymousToken DB.
responses: responses:
@ -124,7 +124,7 @@ paths:
content: content:
application/json: application/json:
schema: schema:
$ref: "#/components/schemas/TokenStatusResponse" $ref: "#/components/schemas/SecurityTokenStatusResponse"
examples: examples:
Not secured and not authorized : Not secured and not authorized :
summary: Not secured, not authorized summary: Not secured, not authorized
@ -200,7 +200,7 @@ paths:
status: 500 status: 500
title: Internal Server Error title: Internal Server Error
detail: An unknown error has occurred detail: An unknown error has occurred
/tokens/{xTat}: /securitytokens/{xTat}:
parameters: parameters:
- name: xTat - name: xTat
in: path in: path
@ -208,7 +208,7 @@ paths:
type: string type: string
example: uuid example: uuid
required: true required: true
description: The xTat for the token for which the status needs to be checked description: The xTat of the ovPastoken for which the status needs to be checked
- name: customerProfileId - name: customerProfileId
in: query in: query
schema: schema:
@ -218,14 +218,14 @@ paths:
description: The id of the customer Profile for which the request is being done, if customer has identified themselves description: The id of the customer Profile for which the request is being done, if customer has identified themselves
patch: patch:
tags: tags:
- tokens - securitytokens
summary: Validate the supplied OTP and secure and/or authorize the token summary: Validate the supplied OTP and secure and/or authorize the token
description: Validate the supplied OTP and secure and/or authorize the token if the customerProfileId has been supplied look in the customerToken DB otherwise check the AnonymousToken DB. description: Validate the supplied OTP and secure and/or authorize the token if the customerProfileId has been supplied look in the customerToken DB otherwise check the AnonymousToken DB.
requestBody: requestBody:
content: content:
application/json: application/json:
schema: schema:
$ref: "#/components/schemas/ValidateTokenBody" $ref: "#/components/schemas/SecurityValidateTokenBody"
examples: examples:
token: token:
value: value:
@ -238,7 +238,7 @@ paths:
content: content:
application/json: application/json:
schema: schema:
$ref: "#/components/schemas/TokenStatusResponse" $ref: "#/components/schemas/SecurityTokenStatusResponse"
examples: examples:
Not secured and not authorized : Not secured and not authorized :
summary: Not secured, not authorized summary: Not secured, not authorized
@ -353,8 +353,8 @@ components:
detail: detail:
type: string type: string
description: A detail IS A string that provides more details about the error. description: A detail IS A string that provides more details about the error.
CreateTokenBody: CreateSecurityTokenBody:
description: Body for when the a new token entry is created description: Body for when the a new security token entry is created
type: object type: object
required: required:
- xTat - xTat
@ -370,7 +370,7 @@ components:
description: >- description: >-
Key used to validate the OTP at GBO Key used to validate the OTP at GBO
example: 123456789123456789123456789abcde example: 123456789123456789123456789abcde
TokenStatusResponse: SecurityTokenStatusResponse:
description: Response for when the status of a token is requested description: Response for when the status of a token is requested
type: object type: object
properties: properties:
@ -384,7 +384,7 @@ components:
description: >- description: >-
Does HTM have the authorization to access the secured the data of the OVpas Does HTM have the authorization to access the secured the data of the OVpas
example: false example: false
ValidateTokenBody: SecurityValidateTokenBody:
description: Body for when the a token entry is validated description: Body for when the a token entry is validated
type: object type: object
required: required:
@ -394,6 +394,4 @@ components:
type : string type : string
description: >- description: >-
OTP to be used to secure the token and retrieve the JWT at GBO OTP to be used to secure the token and retrieve the JWT at GBO
minLength: 6
maxLength: 6
example: 123456 example: 123456