From 36bc1a591a888380b171db42f5cc69ffcca97902 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Tue, 14 May 2024 16:36:54 +0200
Subject: [PATCH 01/14] Helper documentation

---
 doc/.DS_Store                                 |  Bin 0 -> 6148 bytes
 .../PELAYOTOAL22-Helper-1.0.0-resolved.yaml   | 1468 +++++++++++++++++
 2 files changed, 1468 insertions(+)
 create mode 100644 doc/.DS_Store
 create mode 100644 doc/swagger/PELAYOTOAL22-Helper-1.0.0-resolved.yaml

diff --git a/doc/.DS_Store b/doc/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..1de8cf1d3cf077ce6ed011fcc38b84d570da4a85
GIT binary patch
literal 6148
zcmZQzU|@7AO)+F(5MW?n;9!8zEL;p&0Z1N%F(jFwBHSSJz-AOM6f>kU=rUw6Btqpz
zsnHM^4S~TM0-(Gr%aF>D%#g#7$$*@H%NP<FbQ#ha@)`0O(iw8V`MQ{)grO45)?=t(
z$Ysd!%*jtq%E?cH79oxd3=Dez!2s-KHU>8aM}|NKJ%(I{6g0K#(bV!Wq%)*4lrWSq
zWHRJ2q%(l*N@OTvC}BuN*UKo2rk9N&lOdNO5o|&+sy&R|_|ztq7Z*U?zcZ;IC$qT3
zz~CAq6Eh1d8#@O(2RBD-a7KQ4a7kiGX|YpcQ8b7blAoWG1Y;*Ag=MCe#|wx!=jW9q
zX6B_9fs_Pirlck%7R7{T=B4D9JLQ+=r4)npLM1pjIXL45B&(~9j0|-Y42{i9YIPK<
zEsYFx6ikfGYHK+;M3wcegW|Jua`W;*9srfFjNl+;VBm$)Fsg@vfdM4|%7TmXa`N-i
zL7KqjJ19U?7*ZK3utfypPqYBy1_wPPnu{4S7*fH}f)=byAk&efnjIWbphyGRmW~<;
z44{ND51cOkgPo108gDdk&@dV}sT&Pw-a?BAu+Ik(0ZmXGpfX?(IcwA@qaiRF0)rp~
zK;?r1v=VWE(hU$AB*nnUzyR(7FfuT(z?{nn?gub{<Um?MG)OCm25Dtr1hK$ofVDC(
zLbWo2yCEQbpe_lB25V<vWB_YtU}OMmXJ7=|%)r11(ayjKwV4sxLt%tyXJCYAXJCYA
zhdFPQ9u0xf5P*gNGlUiZ)&H&x47mFL5LKh(Xb6mkz_1JfMi!S~7bkF~jNN~rx)xNQ
zCP1Y@bug$pW(3vK5PcveU|A-}fT9GL1Cax11y%dts+f@hQj?E11YjXFN{@yB{X+l%
DF7WRG

literal 0
HcmV?d00001

diff --git a/doc/swagger/PELAYOTOAL22-Helper-1.0.0-resolved.yaml b/doc/swagger/PELAYOTOAL22-Helper-1.0.0-resolved.yaml
new file mode 100644
index 00000000..90387a39
--- /dev/null
+++ b/doc/swagger/PELAYOTOAL22-Helper-1.0.0-resolved.yaml
@@ -0,0 +1,1468 @@
+---
+openapi: 3.0.0
+info:
+  title: Helper Service
+  description: "New microservice inside CCF, it will simplify integration with third parties like external management portals"
+  contact:
+    email: you@your-company.com
+  license:
+    name: Apache 2.0
+    url: http://www.apache.org/licenses/LICENSE-2.0.html
+  version: 1.0.0
+servers:
+- url: https://virtserver.swaggerhub.com/PELAYOTOAL22/Helper/1.0.0
+  description: SwaggerHub API Auto Mocking
+tags:
+- name: Helper
+paths:
+  /deleteEntities/{uuid}:
+    delete:
+      tags:
+      - Helper
+      summary: Delete all entities created by a user
+      operationId: DeleteEntitiesList
+      parameters:
+      - name: uuid
+        in: path
+        description: The user uuid
+        required: true
+        style: simple
+        explode: false
+        schema:
+          minimum: 1
+          type: string
+          format: uuid
+      responses:
+        "200":
+          description: User entities removed successfully.
+        "204":
+          description: No entities found for that uuid.
+  /getInvokers:
+    get:
+      tags:
+      - Helper
+      summary: Get the list of invokers
+      operationId: GetInvokersList
+      parameters:
+      - name: uuid
+        in: query
+        description: uuid of the User you want the invokers for.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+          format: uuid
+      - name: api_invoker_id
+        in: query
+        description: Id of the invoker from which the information is wanted.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: page_size
+        in: query
+        description: Size of the list (page) of invokers that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: page
+        in: query
+        description: list number (page) that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: sort_order
+        in: query
+        description: Sorting by onboarding date of the invokers (ascending or descending).
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+          enum:
+          - asc
+          - dsc
+        example: asc
+      responses:
+        "200":
+          description: Response with the requested invokers list.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InvokersResponse'
+        "400":
+          description: Invalid page or page_size supplied.
+  /getProviders:
+    get:
+      tags:
+      - Helper
+      summary: Get the list of providers
+      operationId: GetProvidersList
+      parameters:
+      - name: uuid
+        in: query
+        description: uuid of the User you want the providerss for.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+          format: uuid
+      - name: api_prov_dom_id
+        in: query
+        description: Id of the provider from which the information is wanted.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: page_size
+        in: query
+        description: Size of the list (page) of providers that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: page
+        in: query
+        description: list number (page) that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: sort_order
+        in: query
+        description: Sorting by onboarding date of the providers (ascending or descending).
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+          enum:
+          - asc
+          - dsc
+        example: asc
+      responses:
+        "200":
+          description: Response with the requested providers list.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProvidersResponse'
+        "400":
+          description: Invalid page or page_size supplied.
+  /getServices:
+    get:
+      tags:
+      - Helper
+      summary: Get the list of services
+      operationId: GetServicesList
+      parameters:
+      - name: service_id
+        in: query
+        description: Id of the service from which the information is wanted.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: api_name
+        in: query
+        description: Name of the service from which the information is wanted.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: apf_id
+        in: query
+        description: Id of the APF that published the services.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: page_size
+        in: query
+        description: Size of the list (page) of services that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: page
+        in: query
+        description: list number (page) that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: sort_order
+        in: query
+        description: Sorting by onboarding date of the Services (ascending or descending).
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+          enum:
+          - asc
+          - dsc
+        example: asc
+      responses:
+        "200":
+          description: Response with the requested services list.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ServiceResponse'
+        "400":
+          description: Invalid page or page_size supplied.
+  /getSecurity:
+    get:
+      tags:
+      - Helper
+      summary: Get the list of security context
+      operationId: GetSecurityContextList
+      parameters:
+      - name: invoker_id
+        in: query
+        description: Id of the invoker for which the security context is wanted.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: page_size
+        in: query
+        description: Size of the list (page) of security contexts that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: page
+        in: query
+        description: list number (page) that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      responses:
+        "200":
+          description: Response with the requested security context list.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SecurityResponse'
+        "400":
+          description: Invalid page or page_size supplied.
+  /getEvents:
+    get:
+      tags:
+      - Helper
+      summary: Get the list of events
+      operationId: GetEventsList
+      parameters:
+      - name: subscriber_id
+        in: query
+        description: ID of the invoker or APF that subscribed to events.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: subscription_id
+        in: query
+        description: Event subscription id.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: string
+      - name: page_size
+        in: query
+        description: Size of the list (page) of events that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      - name: page
+        in: query
+        description: list number (page) that is returned.
+        required: false
+        style: form
+        explode: true
+        schema:
+          type: integer
+      responses:
+        "200":
+          description: Response with the requested events list.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EventsResponse'
+        "400":
+          description: Invalid page or page_size supplied.
+components:
+  schemas:
+    InvokersResponse:
+      type: object
+      properties:
+        invokers:
+          type: array
+          description: CAPIF invokers list.
+          items:
+            $ref: '#/components/schemas/APIInvokerEnrolmentDetails'
+        long:
+          type: integer
+          description: Total number of invokers that match the given parameters.
+          format: int64
+          example: 3
+        sortOrder:
+          type: string
+          description: Sorting by onboarding date of the invokers (ascending or descending).
+          example: asc
+          enum:
+          - desc
+          - asc
+        total:
+          type: integer
+          description: Total number of invokers in CAPIF.
+          format: int64
+          example: 3
+        totalPages:
+          type: integer
+          description: Total number of pages given page size.
+          format: int64
+          example: 3
+    ProvidersResponse:
+      type: object
+      properties:
+        providers:
+          type: array
+          description: CAPIF providers list.
+          items:
+            $ref: '#/components/schemas/APIProviderEnrolmentDetails'
+        long:
+          type: integer
+          description: Total number of providers that match the given parameters.
+          format: int64
+          example: 3
+        sortOrder:
+          type: string
+          description: Sorting by onboarding date of the providers (ascending or descending).
+          example: asc
+          enum:
+          - desc
+          - asc
+        total:
+          type: integer
+          description: Total number of providers in CAPIF.
+          format: int64
+          example: 3
+        totalPages:
+          type: integer
+          description: Total number of pages given page size.
+          format: int64
+          example: 3
+    ServiceResponse:
+      type: object
+      properties:
+        services:
+          type: array
+          description: CAPIF services list.
+          items:
+            $ref: '#/components/schemas/ServiceAPIDescription'
+        long:
+          type: integer
+          description: Total number of services that match the given parameters.
+          format: int64
+          example: 3
+        sortOrder:
+          type: string
+          description: Sorting by onboarding date of the services (ascending or descending).
+          example: asc
+          enum:
+          - desc
+          - asc
+        total:
+          type: integer
+          description: Total number of services in CAPIF.
+          format: int64
+          example: 3
+        totalPages:
+          type: integer
+          description: Total number of pages given page size.
+          format: int64
+          example: 3
+    SecurityResponse:
+      type: object
+      properties:
+        security:
+          type: array
+          description: CAPIF security context list.
+          items:
+            $ref: '#/components/schemas/ServiceSecurity'
+        long:
+          type: integer
+          description: Total number of security contexts that match the given parameters.
+          format: int64
+          example: 3
+        total:
+          type: integer
+          description: Total number of security contexts in CAPIF.
+          format: int64
+          example: 3
+        totalPages:
+          type: integer
+          description: Total number of pages given page size.
+          format: int64
+          example: 3
+    EventsResponse:
+      type: object
+      properties:
+        events:
+          type: array
+          description: CAPIF events list.
+          items:
+            $ref: '#/components/schemas/EventSubscription'
+        long:
+          type: integer
+          description: Total number of events that match the given parameters.
+          format: int64
+          example: 3
+        total:
+          type: integer
+          description: Total number of events in CAPIF.
+          format: int64
+          example: 3
+        totalPages:
+          type: integer
+          description: Total number of pages given page size.
+          format: int64
+          example: 3
+    APIInvokerEnrolmentDetails:
+      required:
+      - notificationDestination
+      - onboardingInformation
+      type: object
+      properties:
+        onboarding_date:
+          type: string
+          description: Invoker onboarding date
+          format: date-time
+        username:
+          type: string
+          description: User who registered the invoker
+        uuid:
+          type: string
+          description: uuid of the user who registered the invoker
+          format: uuid
+        apiInvokerId:
+          type: string
+          description: |
+            API invoker ID assigned by the CAPIF core function to the API invoker while on-boarding the API invoker. Shall not be present in the HTTP POST request from the API invoker to the CAPIF core function, to on-board itself. Shall be present in all other HTTP requests and responses.
+          readOnly: true
+        onboardingInformation:
+          $ref: '#/components/schemas/OnboardingInformation'
+        notificationDestination:
+          $ref: '#/components/schemas/Uri'
+        requestTestNotification:
+          type: boolean
+          description: |
+            Set to true by Subscriber to request the CAPIF core function to send a test notification as defined in in clause 7.6. Set to false or omitted otherwise.
+        websockNotifConfig:
+          $ref: '#/components/schemas/WebsockNotifConfig'
+        apiList:
+          $ref: '#/components/schemas/APIList'
+        apiInvokerInformation:
+          type: string
+          description: |
+            Generic information related to the API invoker such as details of the device or the application.
+        supportedFeatures:
+          $ref: '#/components/schemas/SupportedFeatures'
+      description: Information about the API Invoker that requested to onboard
+    APIProviderEnrolmentDetails:
+      required:
+      - regSec
+      type: object
+      properties:
+        onboarding_date:
+          type: string
+          description: Provider onboarding date
+          format: date-time
+        username:
+          type: string
+          description: User who registered the provider
+        uuid:
+          type: string
+          description: uuid of the user who registered the provider
+          format: uuid
+        apiProvDomId:
+          type: string
+          description: |
+            API provider domain ID assigned by the CAPIF core function to the API management function while registering the API provider domain. Shall not be present in the HTTP POST request from the API Management function to the CAPIF core function, to on-board itself. Shall be present in all other HTTP requests and responses.
+          readOnly: true
+        regSec:
+          type: string
+          description: |
+            Security information necessary for the CAPIF core function to validate the registration of the API provider domain. Shall be present in HTTP POST request from API management function to CAPIF core function for API provider domain registration.
+        apiProvFuncs:
+          minItems: 1
+          type: array
+          description: |
+            A list of individual API provider domain functions details. When included by the API management function in the HTTP request message, it lists the API provider domain functions that the API management function intends to register/update in registration or update registration procedure. When included by the CAPIF core function in the HTTP response message, it lists the API domain functions details that are registered or updated successfully.
+          items:
+            $ref: '#/components/schemas/APIProviderFunctionDetails'
+        apiProvDomInfo:
+          type: string
+          description: |
+            Generic information related to the API provider domain such as details of the API provider applications.
+        suppFeat:
+          $ref: '#/components/schemas/SupportedFeatures'
+        failReason:
+          type: string
+          description: |
+            Registration or update specific failure information of failed API provider domain function registrations.Shall be present in the HTTP response body if atleast one of the API provider domain function registration or update registration fails.
+      description: Represents an API provider domain's enrolment details.
+    ServiceSecurity:
+      required:
+      - notificationDestination
+      - securityInfo
+      type: object
+      properties:
+        api_invoker_id:
+          type: string
+          description: Id of the invoker of this security context.
+        securityInfo:
+          minimum: 1
+          type: array
+          items:
+            $ref: '#/components/schemas/SecurityInformation'
+        notificationDestination:
+          $ref: '#/components/schemas/Uri'
+        requestTestNotification:
+          type: boolean
+          description: |
+            Set to true by API invoker to request the CAPIF core function to send a test notification as defined in in clause 7.6. Set to false or omitted otherwise.
+        websockNotifConfig:
+          $ref: '#/components/schemas/WebsockNotifConfig'
+        supportedFeatures:
+          $ref: '#/components/schemas/SupportedFeatures'
+      description: |
+        Represents the details of the security method for each service API interface. When included by the API invoker, it indicates the preferred method of security. When included by the CAPIF core function, it indicates the security method to be used for the service API interface.
+    SecurityInformation:
+      required:
+      - prefSecurityMethods
+      type: object
+      properties:
+        interfaceDetails:
+          $ref: '#/components/schemas/InterfaceDescription'
+        aefId:
+          type: string
+          description: Identifier of the API exposing function
+        apiId:
+          type: string
+          description: API identifier
+        prefSecurityMethods:
+          minItems: 1
+          type: array
+          description: Security methods preferred by the API invoker for the API interface.
+          items:
+            $ref: '#/components/schemas/SecurityMethod'
+        selSecurityMethod:
+          $ref: '#/components/schemas/SecurityMethod'
+        authenticationInfo:
+          type: string
+          description: Authentication related information
+        authorizationInfo:
+          type: string
+          description: Authorization related information
+      description: Represents the interface details and the security method.
+      oneOf:
+      - required:
+        - interfaceDetails
+      - required:
+        - aefId
+    EventSubscription:
+      required:
+      - events
+      - notificationDestination
+      type: object
+      properties:
+        events:
+          minItems: 1
+          type: array
+          description: Subscribed events
+          items:
+            $ref: '#/components/schemas/CAPIFEvent'
+        eventFilters:
+          minItems: 1
+          type: array
+          description: Subscribed event filters
+          items:
+            $ref: '#/components/schemas/CAPIFEventFilter'
+        eventReq:
+          $ref: '#/components/schemas/ReportingInformation'
+        notificationDestination:
+          $ref: '#/components/schemas/Uri'
+        requestTestNotification:
+          type: boolean
+          description: |
+            Set to true by Subscriber to request the CAPIF core function to send a test notification as defined in in clause 7.6. Set to false or omitted otherwise.
+        websockNotifConfig:
+          $ref: '#/components/schemas/WebsockNotifConfig'
+        supportedFeatures:
+          $ref: '#/components/schemas/SupportedFeatures'
+      description: Represents an individual CAPIF Event Subscription resource.
+    OnboardingInformation:
+      required:
+      - apiInvokerPublicKey
+      type: object
+      properties:
+        apiInvokerPublicKey:
+          type: string
+          description: The API Invoker's public key
+        apiInvokerCertificate:
+          type: string
+          description: |
+            The API Invoker's generic client certificate, provided by the CAPIF core function.
+        onboardingSecret:
+          type: string
+          description: |
+            The API Invoker's onboarding secret, provided by the CAPIF core function.
+      description: Represents on-boarding information of the API invoker.
+    APIProviderFunctionDetails:
+      required:
+      - apiProvFuncRole
+      - regInfo
+      type: object
+      properties:
+        apiProvFuncId:
+          type: string
+          description: |
+            API provider domain functionID assigned by the CAPIF core function to the API provider domain function while registering/updating the API provider domain. Shall not be present in the HTTP POST request from the API management function to the CAPIF core function, to register itself. Shall be present in all other HTTP requests and responses.
+        regInfo:
+          $ref: '#/components/schemas/RegistrationInformation'
+        apiProvFuncRole:
+          $ref: '#/components/schemas/ApiProviderFuncRole'
+        apiProvFuncInfo:
+          type: string
+          description: |
+            Generic information related to the API provider domain function such as details of the API provider applications.
+      description: Represents API provider domain function's details.
+    ApiProviderFuncRole:
+      description: |
+        Possible values are:
+        - AEF: API provider function is API Exposing Function.
+        - APF: API provider function is API Publishing Function.
+        - AMF: API Provider function is API Management Function.
+      anyOf:
+      - type: string
+        enum:
+        - AEF
+        - APF
+        - AMF
+      - type: string
+        description: |
+          This string provides forward-compatiblity with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    RegistrationInformation:
+      required:
+      - apiProvPubKey
+      type: object
+      properties:
+        apiProvPubKey:
+          type: string
+          description: Public Key of API Provider domain function.
+        apiProvCert:
+          type: string
+          description: API provider domain function's client certificate
+      description: |
+        Represents registration information of an individual API provider domain function.
+    APIList:
+      type: object
+      properties:
+        serviceAPIDescriptions:
+          minItems: 1
+          type: array
+          description: The list of service APIs that the API Invoker is allowed to invoke.
+          items:
+            $ref: '#/components/schemas/ServiceAPIDescription'
+      description: Represents a list of APIs.
+    Uri:
+      type: string
+      description: string providing an URI formatted according to IETF RFC 3986.
+    WebsockNotifConfig:
+      type: object
+      properties:
+        websocketUri:
+          $ref: '#/components/schemas/Link'
+        requestWebsocketUri:
+          type: boolean
+          description: Set by the SCS/AS to indicate that the Websocket delivery is requested.
+      description: Represents the configuration information for the delivery of notifications over Websockets.
+    Link:
+      type: string
+      description: string formatted according to IETF RFC 3986 identifying a referenced resource.
+    SupportedFeatures:
+      pattern: "^[A-Fa-f0-9]*$"
+      type: string
+      description: |
+        A string used to indicate the features supported by an API that is used as defined in clause  6.6 in 3GPP TS 29.500. The string shall contain a bitmask indicating supported features in  hexadecimal representation Each character in the string shall take a value of "0" to "9",  "a" to "f" or "A" to "F" and shall represent the support of 4 features as described in  table 5.2.2-3. The most significant character representing the highest-numbered features shall  appear first in the string, and the character representing features 1 to 4 shall appear last  in the string. The list of features and their numbering (starting with 1) are defined  separately for each API. If the string contains a lower number of characters than there are  defined features for an API, all features that would be represented by characters that are not  present in the string are not supported.
+    ServiceAPIDescription:
+      required:
+      - apiName
+      type: object
+      properties:
+        apiName:
+          type: string
+          description: "API name, it is set as {apiName} part of the URI structure as defined in clause 5.2.4 of 3GPP TS 29.122."
+        apiId:
+          type: string
+          description: |
+            API identifier assigned by the CAPIF core function to the published service API. Shall not be present in the HTTP POST request from the API publishing function to the CAPIF core function. Shall be present in the HTTP POST response from the CAPIF core function to the API publishing function and in the HTTP GET response from the CAPIF core function to the API invoker (discovery API).
+        aefProfiles:
+          minItems: 1
+          type: array
+          description: |
+            AEF profile information, which includes the exposed API details (e.g. protocol).
+          items:
+            $ref: '#/components/schemas/AefProfile'
+        description:
+          type: string
+          description: Text description of the API
+        supportedFeatures:
+          $ref: '#/components/schemas/SupportedFeatures'
+        shareableInfo:
+          $ref: '#/components/schemas/ShareableInformation'
+        serviceAPICategory:
+          type: string
+        apiSuppFeats:
+          $ref: '#/components/schemas/SupportedFeatures'
+        pubApiPath:
+          $ref: '#/components/schemas/PublishedApiPath'
+        ccfId:
+          type: string
+          description: CAPIF core function identifier.
+      description: Represents the description of a service API as published by the APF.
+    AefProfile:
+      required:
+      - aefId
+      - versions
+      type: object
+      properties:
+        aefId:
+          type: string
+          description: Identifier of the API exposing function
+        versions:
+          minItems: 1
+          type: array
+          description: API version
+          items:
+            $ref: '#/components/schemas/Version'
+        protocol:
+          $ref: '#/components/schemas/Protocol'
+        dataFormat:
+          $ref: '#/components/schemas/DataFormat'
+        securityMethods:
+          minItems: 1
+          type: array
+          description: Security methods supported by the AEF
+          items:
+            $ref: '#/components/schemas/SecurityMethod'
+        domainName:
+          type: string
+          description: Domain to which API belongs to
+        interfaceDescriptions:
+          minItems: 1
+          type: array
+          description: Interface details
+          items:
+            $ref: '#/components/schemas/InterfaceDescription'
+        aefLocation:
+          $ref: '#/components/schemas/AefLocation'
+      description: Represents the AEF profile data.
+      oneOf:
+      - required:
+        - domainName
+      - required:
+        - interfaceDescriptions
+    ShareableInformation:
+      required:
+      - isShareable
+      type: object
+      properties:
+        isShareable:
+          type: boolean
+          description: |
+            Set to "true" indicates that the service API and/or the service API category can be shared to the list of CAPIF provider domain information. Otherwise set to "false".
+        capifProvDoms:
+          minItems: 1
+          type: array
+          description: |
+            List of CAPIF provider domains to which the service API information to be shared.
+          items:
+            type: string
+      description: |
+        Indicates whether the service API and/or the service API category can be shared to the list of CAPIF provider domains.
+    PublishedApiPath:
+      type: object
+      properties:
+        ccfIds:
+          minItems: 1
+          type: array
+          description: A list of CCF identifiers where the service API is already published.
+          items:
+            type: string
+      description: Represents the published API path within the same CAPIF provider domain.
+    Version:
+      required:
+      - apiVersion
+      type: object
+      properties:
+        apiVersion:
+          type: string
+          description: API major version in URI (e.g. v1)
+        expiry:
+          $ref: '#/components/schemas/DateTime'
+        resources:
+          minItems: 1
+          type: array
+          description: Resources supported by the API.
+          items:
+            $ref: '#/components/schemas/Resource'
+        custOperations:
+          minItems: 1
+          type: array
+          description: Custom operations without resource association.
+          items:
+            $ref: '#/components/schemas/CustomOperation'
+      description: Represents the API version information.
+    Protocol:
+      description: |
+        Possible values are:
+        - HTTP_1_1: HTTP version 1.1
+        - HTTP_2: HTTP version 2
+      anyOf:
+      - type: string
+        enum:
+        - HTTP_1_1
+        - HTTP_2
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    DataFormat:
+      description: |
+        Possible values are:
+        - JSON: JavaScript Object Notation
+      anyOf:
+      - type: string
+        enum:
+        - JSON
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    SecurityMethod:
+      description: |
+        Possible values are:
+        - PSK: Security method 1 (Using TLS-PSK) as described in 3GPP TS 33.122
+        - PKI: Security method 2 (Using PKI) as described in 3GPP TS 33.122
+        - OAUTH: Security method 3 (TLS with OAuth token) as described in 3GPP TS 33.122
+      anyOf:
+      - type: string
+        enum:
+        - PSK
+        - PKI
+        - OAUTH
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    Resource:
+      required:
+      - commType
+      - resourceName
+      - uri
+      type: object
+      properties:
+        resourceName:
+          type: string
+          description: Resource name
+        commType:
+          $ref: '#/components/schemas/CommunicationType'
+        uri:
+          type: string
+          description: |
+            Relative URI of the API resource, it is set as {apiSpecificSuffixes} part of the URI structure as defined in clause 5.2.4 of 3GPP TS 29.122.
+        custOpName:
+          type: string
+          description: |
+            it is set as {custOpName} part of the URI structure for a custom operation associated with a resource as defined in clause 5.2.4 of 3GPP TS 29.122.
+        operations:
+          minItems: 1
+          type: array
+          description: |
+            Supported HTTP methods for the API resource. Only applicable when the protocol in AefProfile indicates HTTP.
+          items:
+            $ref: '#/components/schemas/Operation'
+        description:
+          type: string
+          description: Text description of the API resource
+      description: Represents the API resource data.
+    CustomOperation:
+      required:
+      - commType
+      - custOpName
+      type: object
+      properties:
+        commType:
+          $ref: '#/components/schemas/CommunicationType'
+        custOpName:
+          type: string
+          description: |
+            it is set as {custOpName} part of the URI structure for a custom operation without resource association as defined in clause 5.2.4 of 3GPP TS 29.122.
+        operations:
+          minItems: 1
+          type: array
+          description: |
+            Supported HTTP methods for the API resource. Only applicable when the protocol in AefProfile indicates HTTP.
+          items:
+            $ref: '#/components/schemas/Operation'
+        description:
+          type: string
+          description: Text description of the custom operation
+      description: Represents the description of a custom operation.
+    CommunicationType:
+      description: |
+        Possible values are:
+        - REQUEST_RESPONSE: The communication is of the type request-response
+        - SUBSCRIBE_NOTIFY: The communication is of the type subscribe-notify
+      anyOf:
+      - type: string
+        enum:
+        - REQUEST_RESPONSE
+        - SUBSCRIBE_NOTIFY
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    Operation:
+      description: |
+        Possible values are:
+        - GET: HTTP GET method
+        - POST: HTTP POST method
+        - PUT: HTTP PUT method
+        - PATCH: HTTP PATCH method
+        - DELETE: HTTP DELETE method
+      anyOf:
+      - type: string
+        enum:
+        - GET
+        - POST
+        - PUT
+        - PATCH
+        - DELETE
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    InterfaceDescription:
+      type: object
+      properties:
+        ipv4Addr:
+          $ref: '#/components/schemas/Ipv4Addr'
+        ipv6Addr:
+          $ref: '#/components/schemas/Ipv6Addr'
+        port:
+          $ref: '#/components/schemas/Port'
+        securityMethods:
+          minItems: 1
+          type: array
+          description: |
+            Security methods supported by the interface, it take precedence over the security methods provided in AefProfile, for this specific interface.
+          items:
+            $ref: '#/components/schemas/SecurityMethod'
+      description: Represents the description of an API's interface.
+      oneOf:
+      - required:
+        - ipv4Addr
+      - required:
+        - ipv6Addr
+    Ipv4Addr:
+      type: string
+      description: string identifying a Ipv4 address formatted in the "dotted decimal" notation as defined in IETF RFC 1166.
+    Ipv6Addr:
+      type: string
+      description: string identifying a Ipv6 address formatted according to clause 4 in IETF RFC 5952. The mixed Ipv4 Ipv6 notation according to clause 5 of IETF RFC 5952 shall not be used.
+    Port:
+      maximum: 65535
+      minimum: 0
+      type: integer
+      description: Unsigned integer with valid values between 0 and 65535.
+    AefLocation:
+      type: object
+      properties:
+        civicAddr:
+          $ref: '#/components/schemas/CivicAddress'
+        geoArea:
+          $ref: '#/components/schemas/GeographicArea'
+        dcId:
+          type: string
+          description: |
+            Identifies the data center where the AEF providing the service API is located.
+      description: |
+        The location information (e.g. civic address, GPS coordinates, data center ID) where the AEF providing the service API is located.
+    DateTime:
+      type: string
+      description: string with format "date-time" as defined in OpenAPI.
+      format: date-time
+    CivicAddress:
+      type: object
+      properties:
+        country:
+          type: string
+        A1:
+          type: string
+        A2:
+          type: string
+        A3:
+          type: string
+        A4:
+          type: string
+        A5:
+          type: string
+        A6:
+          type: string
+        PRD:
+          type: string
+        POD:
+          type: string
+        STS:
+          type: string
+        HNO:
+          type: string
+        HNS:
+          type: string
+        LMK:
+          type: string
+        LOC:
+          type: string
+        NAM:
+          type: string
+        PC:
+          type: string
+        BLD:
+          type: string
+        UNIT:
+          type: string
+        FLR:
+          type: string
+        ROOM:
+          type: string
+        PLC:
+          type: string
+        PCN:
+          type: string
+        POBOX:
+          type: string
+        ADDCODE:
+          type: string
+        SEAT:
+          type: string
+        RD:
+          type: string
+        RDSEC:
+          type: string
+        RDBR:
+          type: string
+        RDSUBBR:
+          type: string
+        PRM:
+          type: string
+        POM:
+          type: string
+        usageRules:
+          type: string
+        method:
+          type: string
+        providedBy:
+          type: string
+      description: Indicates a Civic address.
+    GeographicArea:
+      description: Geographic area specified by different shape.
+      anyOf:
+      - $ref: '#/components/schemas/Point'
+      - $ref: '#/components/schemas/PointUncertaintyCircle'
+      - $ref: '#/components/schemas/PointUncertaintyEllipse'
+      - $ref: '#/components/schemas/Polygon'
+      - $ref: '#/components/schemas/PointAltitude'
+      - $ref: '#/components/schemas/PointAltitudeUncertainty'
+      - $ref: '#/components/schemas/EllipsoidArc'
+    Point:
+      description: Ellipsoid Point.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - point
+        type: object
+        properties:
+          point:
+            $ref: '#/components/schemas/GeographicalCoordinates'
+    GADShape:
+      required:
+      - shape
+      type: object
+      properties:
+        shape:
+          $ref: '#/components/schemas/SupportedGADShapes'
+      description: Common base type for GAD shapes.
+      discriminator:
+        propertyName: shape
+        mapping:
+          POINT: '#/components/schemas/Point'
+          POINT_UNCERTAINTY_CIRCLE: '#/components/schemas/PointUncertaintyCircle'
+          POINT_UNCERTAINTY_ELLIPSE: '#/components/schemas/PointUncertaintyEllipse'
+          POLYGON: '#/components/schemas/Polygon'
+          POINT_ALTITUDE: '#/components/schemas/PointAltitude'
+          POINT_ALTITUDE_UNCERTAINTY: '#/components/schemas/PointAltitudeUncertainty'
+          ELLIPSOID_ARC: '#/components/schemas/EllipsoidArc'
+          LOCAL_2D_POINT_UNCERTAINTY_ELLIPSE: '#/components/schemas/Local2dPointUncertaintyEllipse'
+          LOCAL_3D_POINT_UNCERTAINTY_ELLIPSOID: '#/components/schemas/Local3dPointUncertaintyEllipsoid'
+    GeographicalCoordinates:
+      required:
+      - lat
+      - lon
+      type: object
+      properties:
+        lon:
+          maximum: 180
+          minimum: -180
+          type: number
+          format: double
+        lat:
+          maximum: 90
+          minimum: -90
+          type: number
+          format: double
+      description: Geographical coordinates.
+    SupportedGADShapes:
+      description: Indicates supported GAD shapes.
+      anyOf:
+      - type: string
+        enum:
+        - POINT
+        - POINT_UNCERTAINTY_CIRCLE
+        - POINT_UNCERTAINTY_ELLIPSE
+        - POLYGON
+        - POINT_ALTITUDE
+        - POINT_ALTITUDE_UNCERTAINTY
+        - ELLIPSOID_ARC
+        - LOCAL_2D_POINT_UNCERTAINTY_ELLIPSE
+        - LOCAL_3D_POINT_UNCERTAINTY_ELLIPSOID
+      - type: string
+    PointUncertaintyCircle:
+      description: Ellipsoid point with uncertainty circle.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - point
+        - uncertainty
+        type: object
+        properties:
+          point:
+            $ref: '#/components/schemas/GeographicalCoordinates'
+          uncertainty:
+            $ref: '#/components/schemas/Uncertainty'
+    Uncertainty:
+      minimum: 0
+      type: number
+      description: Indicates value of uncertainty.
+      format: float
+    PointUncertaintyEllipse:
+      description: Ellipsoid point with uncertainty ellipse.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - confidence
+        - point
+        - uncertaintyEllipse
+        type: object
+        properties:
+          point:
+            $ref: '#/components/schemas/GeographicalCoordinates'
+          uncertaintyEllipse:
+            $ref: '#/components/schemas/UncertaintyEllipse'
+          confidence:
+            $ref: '#/components/schemas/Confidence'
+    UncertaintyEllipse:
+      required:
+      - orientationMajor
+      - semiMajor
+      - semiMinor
+      type: object
+      properties:
+        semiMajor:
+          $ref: '#/components/schemas/Uncertainty'
+        semiMinor:
+          $ref: '#/components/schemas/Uncertainty'
+        orientationMajor:
+          $ref: '#/components/schemas/Orientation'
+      description: Ellipse with uncertainty.
+    Confidence:
+      maximum: 100
+      minimum: 0
+      type: integer
+      description: Indicates value of confidence.
+    Orientation:
+      maximum: 180
+      minimum: 0
+      type: integer
+      description: Indicates value of orientation angle.
+    Polygon:
+      description: Polygon.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - pointList
+        type: object
+        properties:
+          pointList:
+            $ref: '#/components/schemas/PointList'
+    PointList:
+      maxItems: 15
+      minItems: 3
+      type: array
+      description: List of points.
+      items:
+        $ref: '#/components/schemas/GeographicalCoordinates'
+    PointAltitude:
+      description: Ellipsoid point with altitude.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - altitude
+        - point
+        type: object
+        properties:
+          point:
+            $ref: '#/components/schemas/GeographicalCoordinates'
+          altitude:
+            $ref: '#/components/schemas/Altitude'
+    Altitude:
+      maximum: 32767
+      minimum: -32767
+      type: number
+      description: Indicates value of altitude.
+      format: double
+    PointAltitudeUncertainty:
+      description: Ellipsoid point with altitude and uncertainty ellipsoid.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - altitude
+        - confidence
+        - point
+        - uncertaintyAltitude
+        - uncertaintyEllipse
+        type: object
+        properties:
+          point:
+            $ref: '#/components/schemas/GeographicalCoordinates'
+          altitude:
+            $ref: '#/components/schemas/Altitude'
+          uncertaintyEllipse:
+            $ref: '#/components/schemas/UncertaintyEllipse'
+          uncertaintyAltitude:
+            $ref: '#/components/schemas/Uncertainty'
+          confidence:
+            $ref: '#/components/schemas/Confidence'
+    EllipsoidArc:
+      description: Ellipsoid Arc.
+      allOf:
+      - $ref: '#/components/schemas/GADShape'
+      - required:
+        - confidence
+        - includedAngle
+        - innerRadius
+        - offsetAngle
+        - point
+        - uncertaintyRadius
+        type: object
+        properties:
+          point:
+            $ref: '#/components/schemas/GeographicalCoordinates'
+          innerRadius:
+            $ref: '#/components/schemas/InnerRadius'
+          uncertaintyRadius:
+            $ref: '#/components/schemas/Uncertainty'
+          offsetAngle:
+            $ref: '#/components/schemas/Angle'
+          includedAngle:
+            $ref: '#/components/schemas/Angle'
+          confidence:
+            $ref: '#/components/schemas/Confidence'
+    InnerRadius:
+      maximum: 327675
+      minimum: 0
+      type: integer
+      description: Indicates value of the inner radius.
+      format: int32
+    Angle:
+      maximum: 360
+      minimum: 0
+      type: integer
+      description: Indicates value of angle.
+    CAPIFEvent:
+      description: |
+        Possible values are:
+        - SERVICE_API_AVAILABLE: Events related to the availability of service APIs after the service APIs are published.
+        - SERVICE_API_UNAVAILABLE: Events related to the unavailability of service APIs after the service APIs are unpublished.
+        - SERVICE_API_UPDATE: Events related to change in service API information.
+        - API_INVOKER_ONBOARDED: Events related to API invoker onboarded to CAPIF.
+        - API_INVOKER_OFFBOARDED: Events related to API invoker offboarded from CAPIF.
+        - SERVICE_API_INVOCATION_SUCCESS: Events related to the successful invocation of service APIs.
+        - SERVICE_API_INVOCATION_FAILURE: Events related to the failed invocation of service APIs.
+        - ACCESS_CONTROL_POLICY_UPDATE: Events related to the update for the access control policy related to the service APIs.
+        - ACCESS_CONTROL_POLICY_UNAVAILABLE: Events related to the unavailability of the access control policy related to the service APIs.
+        - API_INVOKER_AUTHORIZATION_REVOKED: Events related to the revocation of the authorization of API invokers to access the service APIs.
+        - API_INVOKER_UPDATED: Events related to API invoker profile updated to CAPIF.
+        - API_TOPOLOGY_HIDING_CREATED: Events related to the creation or update of the API topology hiding information of the service APIs after the service APIs are published.
+        - API_TOPOLOGY_HIDING_REVOKED: Events related to the revocation of the API topology hiding information of the service APIs after the service APIs are unpublished.
+      anyOf:
+      - type: string
+        enum:
+        - SERVICE_API_AVAILABLE
+        - SERVICE_API_UNAVAILABLE
+        - SERVICE_API_UPDATE
+        - API_INVOKER_ONBOARDED
+        - API_INVOKER_OFFBOARDED
+        - SERVICE_API_INVOCATION_SUCCESS
+        - SERVICE_API_INVOCATION_FAILURE
+        - ACCESS_CONTROL_POLICY_UPDATE
+        - ACCESS_CONTROL_POLICY_UNAVAILABLE
+        - API_INVOKER_AUTHORIZATION_REVOKED
+        - API_INVOKER_UPDATED
+        - API_TOPOLOGY_HIDING_CREATED
+        - API_TOPOLOGY_HIDING_REVOKED
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    CAPIFEventFilter:
+      type: object
+      properties:
+        apiIds:
+          minItems: 1
+          type: array
+          description: Identifier of the service API
+          items:
+            type: string
+        apiInvokerIds:
+          minItems: 1
+          type: array
+          description: Identity of the API invoker
+          items:
+            type: string
+        aefIds:
+          minItems: 1
+          type: array
+          description: Identifier of the API exposing function
+          items:
+            type: string
+      description: Represents a CAPIF event filter.
+    ReportingInformation:
+      type: object
+      properties:
+        immRep:
+          type: boolean
+        notifMethod:
+          $ref: '#/components/schemas/NotificationMethod'
+        maxReportNbr:
+          $ref: '#/components/schemas/Uinteger'
+        monDur:
+          $ref: '#/components/schemas/DateTime'
+        repPeriod:
+          $ref: '#/components/schemas/DurationSec'
+        sampRatio:
+          $ref: '#/components/schemas/SamplingRatio'
+        partitionCriteria:
+          minItems: 1
+          type: array
+          description: Criteria for partitioning the UEs before applying the sampling ratio.
+          items:
+            $ref: '#/components/schemas/PartitioningCriteria'
+        grpRepTime:
+          $ref: '#/components/schemas/DurationSec'
+        notifFlag:
+          $ref: '#/components/schemas/NotificationFlag'
+      description: Represents the type of reporting that the subscription requires.
+    NotificationMethod:
+      description: |
+        Possible values are:
+        - PERIODIC
+        - ONE_TIME
+        - ON_EVENT_DETECTION
+      anyOf:
+      - type: string
+        enum:
+        - PERIODIC
+        - ONE_TIME
+        - ON_EVENT_DETECTION
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    Uinteger:
+      minimum: 0
+      type: integer
+      description: "Unsigned Integer, i.e. only value 0 and integers above 0 are permissible."
+    DurationSec:
+      type: integer
+      description: indicating a time in seconds.
+    SamplingRatio:
+      maximum: 100
+      minimum: 1
+      type: integer
+      description: "Unsigned integer indicating Sampling Ratio (see clauses 4.15.1 of 3GPP TS 23.502), expressed in percent. \n"
+    PartitioningCriteria:
+      description: |
+        Possible values are:
+        - "TAC": Type Allocation Code
+        - "SUBPLMN": Subscriber PLMN ID
+        - "GEOAREA": Geographical area, i.e. list(s) of TAI(s)
+        - "SNSSAI": S-NSSAI
+        - "DNN": DNN
+      anyOf:
+      - type: string
+        enum:
+        - TAC
+        - SUBPLMN
+        - GEOAREA
+        - SNSSAI
+        - DNN
+      - type: string
+        description: |
+          This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
+    NotificationFlag:
+      description: |-
+        Possible values are:
+        - ACTIVATE: The event notification is activated.
+        - DEACTIVATE: The event notification is deactivated and shall be muted. The available
+           event(s) shall be stored.
+        - RETRIEVAL: The event notification shall be sent to the NF service consumer(s),
+          after that, is muted again.
+      anyOf:
+      - type: string
+        enum:
+        - ACTIVATE
+        - DEACTIVATE
+        - RETRIEVAL
+      - type: string
+        description: "This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API. \n"
-- 
GitLab


From a6dacc3efb10b3319f0ea36f5f72a3b903ce6d67 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Tue, 14 May 2024 16:48:16 +0200
Subject: [PATCH 02/14] Helper swagger

---
 ...ELAYOTOAL22-Helper-1.0.0-resolved.yaml => helper_swagger.yaml} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename doc/swagger/{PELAYOTOAL22-Helper-1.0.0-resolved.yaml => helper_swagger.yaml} (100%)

diff --git a/doc/swagger/PELAYOTOAL22-Helper-1.0.0-resolved.yaml b/doc/swagger/helper_swagger.yaml
similarity index 100%
rename from doc/swagger/PELAYOTOAL22-Helper-1.0.0-resolved.yaml
rename to doc/swagger/helper_swagger.yaml
-- 
GitLab


From 4edec00d94e41f7c10dc06522a2e8e1e7f4839c3 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Wed, 15 May 2024 09:08:05 +0200
Subject: [PATCH 03/14] Helper swagger

---
 doc/swagger/helper_swagger.yaml | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/doc/swagger/helper_swagger.yaml b/doc/swagger/helper_swagger.yaml
index 90387a39..333664b0 100644
--- a/doc/swagger/helper_swagger.yaml
+++ b/doc/swagger/helper_swagger.yaml
@@ -1,17 +1,14 @@
 ---
 openapi: 3.0.0
 info:
+  description: New microservice inside CCF, it will simplify integration with third parties like external management portals
+  version: "1.0.0"
   title: Helper Service
-  description: "New microservice inside CCF, it will simplify integration with third parties like external management portals"
   contact:
-    email: you@your-company.com
+    email: SDGsupport@etsi.org
   license:
-    name: Apache 2.0
-    url: http://www.apache.org/licenses/LICENSE-2.0.html
-  version: 1.0.0
-servers:
-- url: https://virtserver.swaggerhub.com/PELAYOTOAL22/Helper/1.0.0
-  description: SwaggerHub API Auto Mocking
+    name: Apache
+    url: 'file://./.LICENSE'
 tags:
 - name: Helper
 paths:
-- 
GitLab


From 4506f6a4264616928c695ced36cef012a2606a18 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Wed, 15 May 2024 09:11:02 +0200
Subject: [PATCH 04/14] Helper swagger

---
 doc/swagger/helper_swagger.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/swagger/helper_swagger.yaml b/doc/swagger/helper_swagger.yaml
index 333664b0..fa7f0168 100644
--- a/doc/swagger/helper_swagger.yaml
+++ b/doc/swagger/helper_swagger.yaml
@@ -7,8 +7,8 @@ info:
   contact:
     email: SDGsupport@etsi.org
   license:
-    name: Apache
-    url: 'file://./.LICENSE'
+    name: License
+    url: '..LICENSE'
 tags:
 - name: Helper
 paths:
-- 
GitLab


From b2208c450e489574631ed8f73f77ae63448919ab Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Wed, 15 May 2024 09:14:18 +0200
Subject: [PATCH 05/14] Helper swagger

---
 doc/swagger/helper_swagger.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/swagger/helper_swagger.yaml b/doc/swagger/helper_swagger.yaml
index fa7f0168..50878057 100644
--- a/doc/swagger/helper_swagger.yaml
+++ b/doc/swagger/helper_swagger.yaml
@@ -6,9 +6,9 @@ info:
   title: Helper Service
   contact:
     email: SDGsupport@etsi.org
-  license:
-    name: License
-    url: '..LICENSE'
+  externalDocs:
+    description: License
+    url: 'labs.etsi.org/rep/ocf/documentation/-/blob/OCF-Doc8-documentation-of-the-helper-service/'
 tags:
 - name: Helper
 paths:
-- 
GitLab


From 1ce5545bcdeac1653f35db0e856d47d36d03d872 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Wed, 15 May 2024 09:15:55 +0200
Subject: [PATCH 06/14] Helper swagger

---
 doc/swagger/helper_swagger.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/swagger/helper_swagger.yaml b/doc/swagger/helper_swagger.yaml
index 50878057..54b369ae 100644
--- a/doc/swagger/helper_swagger.yaml
+++ b/doc/swagger/helper_swagger.yaml
@@ -6,9 +6,9 @@ info:
   title: Helper Service
   contact:
     email: SDGsupport@etsi.org
-  externalDocs:
-    description: License
-    url: 'labs.etsi.org/rep/ocf/documentation/-/blob/OCF-Doc8-documentation-of-the-helper-service/'
+  license:
+    name: License
+    url: 'https://creativecommons.org/licenses/by/4.0/'
 tags:
 - name: Helper
 paths:
-- 
GitLab


From a7a6465b79023d30ea8a14f72f6cb600ac1f82e5 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Thu, 16 May 2024 15:00:54 +0200
Subject: [PATCH 07/14] Helper documentation

---
 doc/testing/postman/.gitignore                |  3 +++
 .../postman/CAPIF.postman_collection.json     | 21 +++++++------------
 2 files changed, 11 insertions(+), 13 deletions(-)
 create mode 100644 doc/testing/postman/.gitignore

diff --git a/doc/testing/postman/.gitignore b/doc/testing/postman/.gitignore
new file mode 100644
index 00000000..8fbe30b8
--- /dev/null
+++ b/doc/testing/postman/.gitignore
@@ -0,0 +1,3 @@
+/Responses
+/node_modules
+package-lock.json
\ No newline at end of file
diff --git a/doc/testing/postman/CAPIF.postman_collection.json b/doc/testing/postman/CAPIF.postman_collection.json
index 4f4ba37f..423ec302 100644
--- a/doc/testing/postman/CAPIF.postman_collection.json
+++ b/doc/testing/postman/CAPIF.postman_collection.json
@@ -1,10 +1,10 @@
 {
 	"info": {
-		"_postman_id": "b512e528-4b13-4be2-aed2-a61a8381360e",
+		"_postman_id": "03e5f144-6a4f-4899-a917-14787d59fbef",
 		"name": "CAPIF",
 		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
 		"_exporter_id": "31608242",
-		"_collection_link": "https://red-comet-993867.postman.co/workspace/Team-Workspace~bfc7c442-a60c-4bb1-8730-fdabc2df89b9/collection/31608242-b512e528-4b13-4be2-aed2-a61a8381360e?action=share&source=collection_link&creator=31608242"
+		"_collection_link": "https://red-comet-993867.postman.co/workspace/Team-Workspace~bfc7c442-a60c-4bb1-8730-fdabc2df89b9/collection/31608242-03e5f144-6a4f-4899-a917-14787d59fbef?action=share&source=collection_link&creator=31608242"
 	},
 	"item": [
 		{
@@ -264,7 +264,6 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
@@ -340,7 +339,6 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
@@ -439,7 +437,6 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
@@ -527,7 +524,6 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
@@ -603,7 +599,6 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
@@ -686,7 +681,6 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
@@ -741,7 +735,8 @@
 						"exec": [
 							""
 						],
-						"type": "text/javascript"
+						"type": "text/javascript",
+						"packages": {}
 					}
 				},
 				{
@@ -750,7 +745,8 @@
 						"exec": [
 							""
 						],
-						"type": "text/javascript"
+						"type": "text/javascript",
+						"packages": {}
 					}
 				}
 			],
@@ -773,13 +769,12 @@
 					{
 						"key": "",
 						"value": "",
-						"type": "text",
 						"disabled": true
 					}
 				],
 				"body": {
 					"mode": "raw",
-					"raw": "{\n\"name\": {{USERNAME_INVOKER}}\n}",
+					"raw": "{\n\"name\": \"{{USER_NAME}}\"\n}",
 					"options": {
 						"raw": {
 							"language": "json"
@@ -961,7 +956,7 @@
 						}
 					]
 				},
-				"method": "GET",
+				"method": "POST",
 				"header": [],
 				"url": {
 					"raw": "https://{{REGISTER_HOSTNAME}}:{{REGISTER_PORT}}/refresh",
-- 
GitLab


From c4324659858581d4e8b9f4804593557c1a50aa73 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Thu, 16 May 2024 15:02:52 +0200
Subject: [PATCH 08/14] Helper documentation

---
 doc/gettingstarted/howtorun.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/gettingstarted/howtorun.md b/doc/gettingstarted/howtorun.md
index 8858bfd9..7b5d06df 100644
--- a/doc/gettingstarted/howtorun.md
+++ b/doc/gettingstarted/howtorun.md
@@ -158,4 +158,8 @@ Run using python
 cd <Service>
 pip3 install -r requirements.txt
 python3 -m <service>
-```
\ No newline at end of file
+```
+
+#### 4. Start Your Testing with OpenCAPIF
+
+You can now test OpenCAPIF. Visit the Testing page to see how it works.
\ No newline at end of file
-- 
GitLab


From f0a5bf9bdd81419f96288c5a357bf338aa1c3a52 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Thu, 16 May 2024 15:06:51 +0200
Subject: [PATCH 09/14] Helper documentation

---
 doc/gettingstarted/howtorun.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/gettingstarted/howtorun.md b/doc/gettingstarted/howtorun.md
index 7b5d06df..0c3d4fe5 100644
--- a/doc/gettingstarted/howtorun.md
+++ b/doc/gettingstarted/howtorun.md
@@ -6,6 +6,7 @@
 - [Run All CAPIF Services locally with Docker images and deploy monitoring stack](#run-all-capif-services-locally-with-docker-images-and-deploy-monitoring-stack)
 - [Run each service using Docker](#run-each-service-using-docker)
 - [Run each service using Python](#run-each-service-using-python)
+- [Start Your Testing with OpenCAPIF](#start-your-testing-with-opencapif)
 
 Capif services are developed under [services folder](https://labs.etsi.org/rep/ocf/capif/-/tree/main/services).
 
@@ -160,6 +161,6 @@ pip3 install -r requirements.txt
 python3 -m <service>
 ```
 
-#### 4. Start Your Testing with OpenCAPIF
+#### Start Your Testing with OpenCAPIF
 
 You can now test OpenCAPIF. Visit the Testing page to see how it works.
\ No newline at end of file
-- 
GitLab


From c679afe59431aeaa27a29f00fb4e34ccc0f8bc52 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Thu, 16 May 2024 15:34:32 +0200
Subject: [PATCH 10/14] Helper documentation

---
 doc/gettingstarted/howtorun.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/gettingstarted/howtorun.md b/doc/gettingstarted/howtorun.md
index 0c3d4fe5..69150179 100644
--- a/doc/gettingstarted/howtorun.md
+++ b/doc/gettingstarted/howtorun.md
@@ -163,4 +163,11 @@ python3 -m <service>
 
 #### Start Your Testing with OpenCAPIF
 
-You can now test OpenCAPIF. Visit the Testing page to see how it works.
\ No newline at end of file
+You can now test OpenCAPIF.
+
+To test it, in the "Testing" tab you have three options:
+
+- [Test Plan](./testing/testplan/README.md): To see how to test the services and use them.
+- [Robot Framework](./testing/robotframework/README.md): To test the operation of all services or one in particular.
+- [Postman](./testing/postman/README.md): In order to carry out the complete OpenCAPIF flow, being invoker and provider
+
-- 
GitLab


From 83544040afe962848422ffd65267314c96806244 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Thu, 16 May 2024 15:49:43 +0200
Subject: [PATCH 11/14] Helper documentation

---
 doc/gettingstarted/howtorun.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/gettingstarted/howtorun.md b/doc/gettingstarted/howtorun.md
index 69150179..902e1c1a 100644
--- a/doc/gettingstarted/howtorun.md
+++ b/doc/gettingstarted/howtorun.md
@@ -167,7 +167,11 @@ You can now test OpenCAPIF.
 
 To test it, in the "Testing" tab you have three options:
 
-- [Test Plan](./testing/testplan/README.md): To see how to test the services and use them.
-- [Robot Framework](./testing/robotframework/README.md): To test the operation of all services or one in particular.
-- [Postman](./testing/postman/README.md): In order to carry out the complete OpenCAPIF flow, being invoker and provider
+- [Test Plan Directory]: To see how to test the services and use them.
+- [Testing with Robot Framework]: To test the operation of all services or one in particular.
+- [Testing with Postman]: In order to carry out the complete OpenCAPIF flow, being invoker and provider
 
+
+[Test Plan Directory]: .././testing/testplan/README.md  "Test Plan"
+[Testing with Robot Framework]: .././testing/robotframework/README.md  "Robot Framework"
+[Testing with Postman]: .././testing/postman/README.md  "Postman"
-- 
GitLab


From a1f5ae79e5ac6865848193165b7bf70c1d8f729e Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Wed, 22 May 2024 11:16:11 +0200
Subject: [PATCH 12/14] Testing in how to run

---
 .gitignore                     |  3 +++
 doc/gettingstarted/howtorun.md | 10 ++++------
 doc/testing/postman/.gitignore |  3 ---
 3 files changed, 7 insertions(+), 9 deletions(-)
 delete mode 100644 doc/testing/postman/.gitignore

diff --git a/.gitignore b/.gitignore
index 1320f90e..e44d0eb3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,4 @@
 site
+doc/testing/postman/Responses
+doc/testing/postman/node_modules
+doc/testing/postman/package-lock.json
\ No newline at end of file
diff --git a/doc/gettingstarted/howtorun.md b/doc/gettingstarted/howtorun.md
index 902e1c1a..d300ccab 100644
--- a/doc/gettingstarted/howtorun.md
+++ b/doc/gettingstarted/howtorun.md
@@ -163,13 +163,11 @@ python3 -m <service>
 
 #### Start Your Testing with OpenCAPIF
 
-You can now test OpenCAPIF.
+Related with OpenCAPIF Testing, the following sections help you to understand testing implemented and how to run it by yourself:
 
-To test it, in the "Testing" tab you have three options:
-
-- [Test Plan Directory]: To see how to test the services and use them.
-- [Testing with Robot Framework]: To test the operation of all services or one in particular.
-- [Testing with Postman]: In order to carry out the complete OpenCAPIF flow, being invoker and provider
+- [Test Plan Directory]: Here you can find the complete test plan definition that are accomplish by all versions released of OpenCAPIF.
+- [Testing with Robot Framework]: At this section you can find all information about how to run the test suite implemented using Robot Framework.
+- [Testing with Postman]: Easy way to understand the complete basic OpenCAPIF flow, acting as invoker and provider.
 
 
 [Test Plan Directory]: .././testing/testplan/README.md  "Test Plan"
diff --git a/doc/testing/postman/.gitignore b/doc/testing/postman/.gitignore
deleted file mode 100644
index 8fbe30b8..00000000
--- a/doc/testing/postman/.gitignore
+++ /dev/null
@@ -1,3 +0,0 @@
-/Responses
-/node_modules
-package-lock.json
\ No newline at end of file
-- 
GitLab


From 5a06a583e77647b805fb38b614a7474b10dfa2f6 Mon Sep 17 00:00:00 2001
From: Pelayo Torres <pelayo.torresalonso@telefonica.com>
Date: Wed, 22 May 2024 11:50:44 +0200
Subject: [PATCH 13/14] Ds_Store

---
 .gitignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index e44d0eb3..b3daeb9e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 site
 doc/testing/postman/Responses
 doc/testing/postman/node_modules
-doc/testing/postman/package-lock.json
\ No newline at end of file
+doc/testing/postman/package-lock.json
+.DS_Store
\ No newline at end of file
-- 
GitLab


From 61fa52d573fd829aa63d925a309b51d4ea16fdf0 Mon Sep 17 00:00:00 2001
From: torrespel <pelayo.torresalonso@telefonica.com>
Date: Wed, 22 May 2024 09:53:52 +0000
Subject: [PATCH 14/14] Delete .DS_Store

---
 doc/.DS_Store | Bin 6148 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 doc/.DS_Store

diff --git a/doc/.DS_Store b/doc/.DS_Store
deleted file mode 100644
index 1de8cf1d3cf077ce6ed011fcc38b84d570da4a85..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmZQzU|@7AO)+F(5MW?n;9!8zEL;p&0Z1N%F(jFwBHSSJz-AOM6f>kU=rUw6Btqpz
zsnHM^4S~TM0-(Gr%aF>D%#g#7$$*@H%NP<FbQ#ha@)`0O(iw8V`MQ{)grO45)?=t(
z$Ysd!%*jtq%E?cH79oxd3=Dez!2s-KHU>8aM}|NKJ%(I{6g0K#(bV!Wq%)*4lrWSq
zWHRJ2q%(l*N@OTvC}BuN*UKo2rk9N&lOdNO5o|&+sy&R|_|ztq7Z*U?zcZ;IC$qT3
zz~CAq6Eh1d8#@O(2RBD-a7KQ4a7kiGX|YpcQ8b7blAoWG1Y;*Ag=MCe#|wx!=jW9q
zX6B_9fs_Pirlck%7R7{T=B4D9JLQ+=r4)npLM1pjIXL45B&(~9j0|-Y42{i9YIPK<
zEsYFx6ikfGYHK+;M3wcegW|Jua`W;*9srfFjNl+;VBm$)Fsg@vfdM4|%7TmXa`N-i
zL7KqjJ19U?7*ZK3utfypPqYBy1_wPPnu{4S7*fH}f)=byAk&efnjIWbphyGRmW~<;
z44{ND51cOkgPo108gDdk&@dV}sT&Pw-a?BAu+Ik(0ZmXGpfX?(IcwA@qaiRF0)rp~
zK;?r1v=VWE(hU$AB*nnUzyR(7FfuT(z?{nn?gub{<Um?MG)OCm25Dtr1hK$ofVDC(
zLbWo2yCEQbpe_lB25V<vWB_YtU}OMmXJ7=|%)r11(ayjKwV4sxLt%tyXJCYAXJCYA
zhdFPQ9u0xf5P*gNGlUiZ)&H&x47mFL5LKh(Xb6mkz_1JfMi!S~7bkF~jNN~rx)xNQ
zCP1Y@bug$pW(3vK5PcveU|A-}fT9GL1Cax11y%dts+f@hQj?E11YjXFN{@yB{X+l%
DF7WRG

-- 
GitLab