{ "swagger": "2.0", "info": { "version": "2024-01-10", "title": "IoT Firmware Defense", "description": "Firmware & IoT Security REST API" }, "host": "management.azure.com", "schemes": [ "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "security": [ { "azure_auth": [ "user_impersonation" ] } ], "securityDefinitions": { "azure_auth": { "type": "oauth2", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "flow": "implicit", "description": "Azure Active Directory OAuth2 Flow", "scopes": { "user_impersonation": "impersonate your user account" } } }, "paths": { "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces/{workspaceName}/firmwares/{firmwareId}/binaryHardeningResults": { "get": { "tags": [ "BinaryHardening" ], "operationId": "BinaryHardening_ListByFirmware", "description": "Lists binary hardening analysis results of a firmware.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter" }, { "$ref": "./common.json#/parameters/WorkspaceNameParameter" }, { "$ref": "./common.json#/parameters/FirmwareIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BinaryHardeningListResult" } }, "default": { "description": "Common error response for all Azure Resource Manager APIs to return error details for failed operations.", "schema": { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" }, "x-ms-examples": { "BinaryHardening_ListByFirmware_MaximumSet_Gen": { "$ref": "./examples/BinaryHardening_ListByFirmware_MaximumSet_Gen.json" }, "BinaryHardening_ListByFirmware_MinimumSet_Gen": { "$ref": "./examples/BinaryHardening_ListByFirmware_MinimumSet_Gen.json" } } } } }, "definitions": { "BinaryHardeningFeatures": { "type": "object", "properties": { "nx": { "description": "NX (no-execute) flag.", "type": "boolean" }, "pie": { "description": "PIE (position independent executable) flag.", "type": "boolean" }, "relro": { "description": "RELRO (relocation read-only) flag.", "type": "boolean" }, "canary": { "description": "Canary (stack canaries) flag.", "type": "boolean" }, "stripped": { "description": "Stripped flag.", "type": "boolean" } }, "description": "Binary hardening features." }, "BinaryHardeningResult": { "type": "object", "properties": { "binaryHardeningId": { "description": "ID for the binary hardening result.", "type": "string", "x-nullable": true }, "features": { "title": "BinaryHardeningFeatures", "description": "Binary hardening features.", "x-ms-client-flatten": true, "$ref": "#/definitions/BinaryHardeningFeatures" }, "architecture": { "description": "The architecture of the uploaded firmware.", "type": "string", "x-nullable": true }, "filePath": { "description": "The executable path.", "type": "string", "x-nullable": true }, "class": { "description": "The executable class to indicate 32 or 64 bit.", "type": "string", "x-nullable": true }, "runpath": { "description": "The runpath of the uploaded firmware.", "type": "string", "x-nullable": true }, "rpath": { "description": "The rpath of the uploaded firmware.", "type": "string", "x-nullable": true } }, "description": "Binary hardening of a firmware." }, "BinaryHardeningResource": { "type": "object", "description": "binary hardening analysis result resource", "properties": { "properties": { "title": "binary hardening result properties", "description": "The properties of a binary hardening result found within a firmware image", "x-ms-client-flatten": true, "$ref": "#/definitions/BinaryHardeningResult" } }, "allOf": [ { "$ref": "../../../../../../common-types/resource-management/v5/types.json#/definitions/Resource" } ] }, "BinaryHardeningListResult": { "type": "object", "description": "List of binary hardening results.", "properties": { "value": { "type": "array", "readOnly": true, "items": { "$ref": "#/definitions/BinaryHardeningResource" }, "description": "The list of binary hardening results." }, "nextLink": { "type": "string", "description": "The uri to fetch the next page of resources." } } } }, "parameters": {} }