proposal: Update excample and description of Authorization property i…

…n ScanRequest

Signed-off-by: Daniel Pacak <pacak.daniel@gmail.com>

proposals/assets/pluggable-image-vulnerability-scanning/scanner-adapter-openapi-v1.0.yaml

@@ -262,25 +262,31 @@ components:
       properties:
         url:
           type: string
-          description: A base URL or the Docker Registry v2 API exposed by Harbor.
+          description: A base URL or the Docker Registry v2 API.
           format: url
-          example: https://harbor-harbor-registry:5000
+          example: https://core.harbor.domain
         authorization:
           type: string
           description: |
             An optional value of the HTTP Authorization header sent with each request to the Docker Registry v2 API.
-          example: "Bearer JWTTOKENGOESHERE"
+            It's used to exchange Base64 encoded robot account credentials to a short lived JWT access token which
+            allows the underlying scanner to pull the artifact from the Docker Registry.
+          example: "Basic BASE64_ENCODED_CREDENTIALS"
     Artifact:
       type: object
       properties:
         repository:
           type: string
-          description: A name of the Harbor repository containing the artifact.
-          example: library/oracle/nosql
+          description: The name of the Docker Registry repository containing the artifact.
+          example: library/mongo
         digest:
           type: string
           description: The artifact's digest, consisting of an algorithm and hex portion.
           example: "sha256:6c3c624b58dbbcd3c0dd82b4c53f04194d1247c6eebdaab7c610cf7d66709b3b"
+        mime_type:
+          type: string
+          description: The MIME type of the artifact.
+          example: "application/vnd.docker.distribution.manifest.v2+json"
     HarborVulnerabilityReport:
       type: object
       properties:
@@ -307,7 +313,7 @@ components:
         package:
           type: string
           description: |
-            An operating system or software dependency package containing the vulnerability.
+            An operating system package containing the vulnerability.
           example: dpkg
         version:
           type: string
@@ -336,7 +342,7 @@ components:
             type: string
             format: uri
           description: |
-            The list of link to the upstream database with the full description of the vulnerability.
+            The list of links to the upstream databases with the full description of the vulnerability.
           format: uri
           example:
             - https://security-tracker.debian.org/tracker/CVE-2017-8283