fix: Fix core command swagger

.gitignore

@@ -49,3 +49,5 @@ stage/*
 snap/.snapcraft/*
 squashfs-root/
 
+# result files
+fuzz_result/*

Dockerfile.fuzz

@@ -0,0 +1,15 @@
+FROM mcr.microsoft.com/dotnet/sdk:6.0-alpine as builder
+
+RUN apk add --no-cache python3 py3-pip bash
+
+RUN git clone https://github.com/microsoft/restler-fuzzer.git
+
+RUN cd restler-fuzzer; mkdir -p restler_bin
+WORKDIR /restler-fuzzer
+RUN python3 ./build-restler.py --dest_dir ./restler_bin/
+
+COPY fuzzing_docker.sh /restler-fuzzer/fuzzing.sh
+COPY /openapi/v3/core-data.yaml /restler-fuzzer/
+
+ENTRYPOINT ["/restler-fuzzer/fuzzing.sh"]
+CMD ["core-data", "/restler-fuzzer", "core-data.yaml"]

fuzzing_docker.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+EDGEX_PROJECT_NAME=${1}
+echo $EDGEX_PROJECT_NAME
+SWAGGER_FILE_PATH=${2}
+echo $SWAGGER_FILE_PATH
+SWAGGER_FILE_NAME=${3}
+echo $SWAGGER_FILE_NAME
+
+echo "--compile from swagger file"
+./restler_bin/restler/Restler compile --api_spec /$SWAGGER_FILE_PATH/$SWAGGER_FILE_NAME
+
+echo "--test the grammar"
+./restler_bin/restler/Restler test --grammar_file ./Compile/grammar.py --dictionary_file ./Compile/dict.json --settings ./Compile/engine_settings.json --no_ssl
+
+# assuming edgex service is already running on host
+echo "--run fuzz-lean"
+./restler_bin/restler/Restler fuzz-lean --grammar_file ./Compile/grammar.py --dictionary_file ./Compile/dict.json --settings ./Compile/engine_settings.json --no_ssl
+
+echo "--copy result logs into $EDGEX_PROJECT_NAME"
+mkdir -p /fuzz_result/$EDGEX_PROJECT_NAME
+cp -r ./Test/RestlerResults/ /fuzz_result/$EDGEX_PROJECT_NAME/

openapi/v3/core-command.yaml

@@ -461,14 +461,14 @@ paths:
           required: true
           schema:
             type: string
-          example: sensor01
+          example: Random-Boolean-Device
           description: "A name uniquely identifying a device."
         - in: path
           name: command
           required: true
           schema:
             type: string
-          example: command01
+          example: Bool
           description: "A name uniquely identifying a command."
         - in: query
           name: ds-pushevent
@@ -562,6 +562,22 @@ paths:
                   $ref: '#/components/examples/503Example'
     put:
       summary: "Issue the specified write command referenced by the command name to the device/sensor that is also referenced by name."
+      parameters:
+        - $ref: '#/components/parameters/correlatedRequestHeader'
+        - in: path
+          name: name
+          required: true
+          schema:
+            type: string
+          example: Random-Boolean-Device
+          description: "A name uniquely identifying a device."
+        - in: path
+          name: command
+          required: true
+          schema:
+            type: string
+          example: Bool
+          description: "A name uniquely identifying a command."
       requestBody:
         content:
           application/json:
@@ -647,6 +663,7 @@ paths:
         required: true
         schema:
           type: string
+        example: Random-Boolean-Device
         description: "A name uniquely identifying a device."
     get:
       summary: "Returns all commands associated with the specified device."