Add open api specifications

rest-api/resources/src/main/resources/openapi/openapi.yaml

@@ -418,6 +418,9 @@ paths:
     $ref: './user/user-scopeId-userId-mfa.yaml#/paths/~1{scopeId}~1users~1{userId}~1mfa'
   /{scopeId}/users/{userId}/mfa/disableTrust:
     $ref: './user/user-scopeId-userId-mfa-disableTrust.yaml#/paths/~1{scopeId}~1users~1{userId}~1mfa~1disableTrust'
+  ### User Credentials ###
+  /{scopeId}/user/credentials/password:
+    $ref: './userCredentials/user-credentials-scopeId.yaml#/paths/~1{scopeId}~1user~1credentials~1password'
 
 components:
   parameters:
@@ -923,6 +926,9 @@ components:
       $ref: './user/user.yaml#/components/schemas/mfaOption'
     mfaOptionCreator:
       $ref: './user/user.yaml#/components/schemas/mfaOptionCreator'
+    ### User Credentials Entities ###
+    passwordChangeRequest:
+      $ref: './userCredentials/userCredentials.yaml#/components/schemas/passwordChangeRequest'
   requestBodies:
     kapuaQuery:
       description: An object to specify Query options

rest-api/resources/src/main/resources/openapi/userCredentials/user-credentials-scopeId.yaml

@@ -0,0 +1,38 @@
+openapi: 3.0.2
+
+info:
+  title: Everyware Cloud REST API - User Credentials
+  version: '1.0'
+  contact:
+    name: Eurotech
+    url: https://www.eurotech.com
+
+paths:
+
+  /{scopeId}/user/credentials/password:
+    post:
+      tags:
+        - User Credentials
+      summary: Change the user password
+      operationId: provisionRequestExecutionCount
+      parameters:
+        - $ref: '../openapi.yaml#/components/parameters/scopeId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '../openapi.yaml#/components/schemas/passwordChangeRequest'
+      responses:
+        200:
+          description: The details of the updated Credential
+          content:
+            application/json:
+              schema:
+                $ref: '../credential/credential.yaml#/components/schemas/credential'
+        401:
+          $ref: '../openapi.yaml#/components/responses/unauthenticated'
+        403:
+          $ref: '../openapi.yaml#/components/responses/subjectUnauthorized'
+        500:
+          $ref: '../openapi.yaml#/components/responses/kapuaError'
+      description: Change logged user password

rest-api/resources/src/main/resources/openapi/userCredentials/userCredentials.yaml

@@ -0,0 +1,25 @@
+openapi: 3.0.2
+
+info:
+  title: Everyware Cloud REST API - User Credentials
+  version: '1.0'
+  contact:
+    name: Eurotech
+    url: https://www.eurotech.com
+
+paths: {}
+
+components:
+  schemas:
+    passwordChangeRequest:
+      allOf:
+        - description: Represent a request for changing the user password
+          type: object
+          properties:
+            oldPassword:
+              type: string
+            newPassword:
+              type: string
+          example:
+            oldPassword: "Welcome1234!"
+            newPassword: "NewWelcome1234!"