Microsoft. SQL servery/vulnerabilityAssessments 2023-08-01

Definice zdroje Bicep

Typ prostředku servers/vulnerabilityAssessments je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Příklady použití

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Module Description
Azure SQL Server - Hodnocení zranitelnosti AVM Child Module for Azure SQL Server - Vulnerability Assessment

Formát prostředku

Vytvořit Microsoft. Zdroj SQL/servery/vulnerabilityAssessments, přidejte následující Bicep do své šablony.

resource symbolicname 'Microsoft.Sql/servers/vulnerabilityAssessments@2023-08-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    recurringScans: {
      emails: [
        'string'
      ]
      emailSubscriptionAdmins: bool
      isEnabled: bool
    }
    storageAccountAccessKey: 'string'
    storageContainerPath: 'string'
    storageContainerSasKey: 'string'
  }
}

Hodnoty vlastností

Microsoft. Sql/servery/hodnocení zranitelností

Name Description Value
name Název prostředku Výchozí (povinné)
nadřazený objekt V Bicep můžete specifikovat rodičovský zdroj pro poddaný zdroj. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.
Symbolický název prostředku typu: servery
properties Vlastnosti prostředku. ServerVulnerabilityAssessmentProperties

ServerVulnerabilityAssessmentProperties

Name Description Value
recurringScans Nastavení opakovaných kontrol VulnerabilityAssessmentRecurringScansProperties
storageAccountAccessKey Určuje klíč identifikátoru účtu úložiště pro výsledky kontroly posouzení ohrožení zabezpečení. Pokud není zadaný parametr StorageContainerSasKey, vyžaduje se klíč storageAccountAccessKey. Platí pouze v případě, že účet úložiště není za virtuální sítí nebo bránou firewall. řetězec
storageContainerPath Cesta ke kontejneru úložiště objektů blob pro uložení výsledků kontroly (např. https://myStorage.blob.core.windows.net/VaScans/). string (povinné)
storageContainerSasKey Sdílený přístupový podpis (klíč SAS), který má přístup k zápisu do kontejneru objektů blob zadaný v parametru storageContainerPath. Pokud není zadaný parametr storageAccountAccessKey, vyžaduje se StorageContainerSasKey. Platí pouze v případě, že účet úložiště není za virtuální sítí nebo bránou firewall. řetězec

VulnerabilityAssessmentRecurringScansProperties

Name Description Value
emails Určuje pole e-mailových adres, na které se odesílá oznámení kontroly. string[]
emailSubscriptionAdmins Určuje, že bude oznámení o kontrole plánu odesláno správcům předplatného. bool
isEnabled Stav opakovaných kontrol bool

Definice prostředku šablony ARM

Typ prostředku servers/vulnerabilityAssessments je možné nasadit s operacemi, které cílí:

Příklady použití

Formát prostředku

Vytvořit Microsoft. Zdroj SQL/server/vulnerabilityAssessments, přidejte do šablony následující JSON.

{
  "type": "Microsoft.Sql/servers/vulnerabilityAssessments",
  "apiVersion": "2023-08-01",
  "name": "string",
  "properties": {
    "recurringScans": {
      "emails": [ "string" ],
      "emailSubscriptionAdmins": "bool",
      "isEnabled": "bool"
    },
    "storageAccountAccessKey": "string",
    "storageContainerPath": "string",
    "storageContainerSasKey": "string"
  }
}

Hodnoty vlastností

Microsoft. Sql/servery/hodnocení zranitelností

Name Description Value
apiVersion Verze rozhraní API '2023-08-01'
name Název prostředku Výchozí (povinné)
properties Vlastnosti prostředku. ServerVulnerabilityAssessmentProperties
typ Typ prostředku 'Microsoft. Sql/servery/vulnerabilityAssessments'

ServerVulnerabilityAssessmentProperties

Name Description Value
recurringScans Nastavení opakovaných kontrol VulnerabilityAssessmentRecurringScansProperties
storageAccountAccessKey Určuje klíč identifikátoru účtu úložiště pro výsledky kontroly posouzení ohrožení zabezpečení. Pokud není zadaný parametr StorageContainerSasKey, vyžaduje se klíč storageAccountAccessKey. Platí pouze v případě, že účet úložiště není za virtuální sítí nebo bránou firewall. řetězec
storageContainerPath Cesta ke kontejneru úložiště objektů blob pro uložení výsledků kontroly (např. https://myStorage.blob.core.windows.net/VaScans/). string (povinné)
storageContainerSasKey Sdílený přístupový podpis (klíč SAS), který má přístup k zápisu do kontejneru objektů blob zadaný v parametru storageContainerPath. Pokud není zadaný parametr storageAccountAccessKey, vyžaduje se StorageContainerSasKey. Platí pouze v případě, že účet úložiště není za virtuální sítí nebo bránou firewall. řetězec

VulnerabilityAssessmentRecurringScansProperties

Name Description Value
emails Určuje pole e-mailových adres, na které se odesílá oznámení kontroly. string[]
emailSubscriptionAdmins Určuje, že bude oznámení o kontrole plánu odesláno správcům předplatného. bool
isEnabled Stav opakovaných kontrol bool

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku servers/vulnerabilityAssessments je možné nasadit s operacemi, které cílí:

  • Skupiny zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

Ukázky Terraformu

Základní příklad nasazení Vulnerability Assessment pro MS SQL Server.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "centralus"
}

variable "administrator_login_password" {
  type        = string
  sensitive   = true
  description = "The administrator login password for the SQL server"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2023-08-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2023-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}sa"
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
      accessTier                   = "Hot"
      allowBlobPublicAccess        = true
      allowCrossTenantReplication  = false
      allowSharedKeyAccess         = true
      defaultToOAuthAuthentication = false
      dnsEndpointType              = "Standard"
      encryption = {
        keySource = "Microsoft.Storage"
        services = {
          queue = {
            keyType = "Service"
          }
          table = {
            keyType = "Service"
          }
        }
      }
      isHnsEnabled       = false
      isLocalUserEnabled = true
      isNfsV3Enabled     = false
      isSftpEnabled      = false
      minimumTlsVersion  = "TLS1_2"
      networkAcls = {
        bypass              = "AzureServices"
        defaultAction       = "Allow"
        ipRules             = []
        resourceAccessRules = []
        virtualNetworkRules = []
      }
      publicNetworkAccess      = "Enabled"
      supportsHttpsTrafficOnly = true
    }
    sku = {
      name = "Standard_GRS"
    }
  }
}

resource "azapi_resource_action" "storageAccountKeys" {
  type                   = "Microsoft.Storage/storageAccounts@2023-05-01"
  resource_id            = azapi_resource.storageAccount.id
  action                 = "listKeys"
  response_export_values = ["keys"]
}

resource "azapi_resource" "storageContainer" {
  type      = "Microsoft.Storage/storageAccounts/blobServices/containers@2023-05-01"
  parent_id = "${azapi_resource.storageAccount.id}/blobServices/default"
  name      = "vulnerability-assessment"
  body = {
    properties = {}
  }
}

resource "azapi_resource" "securityAlertPolicy" {
  type      = "Microsoft.Sql/servers/securityAlertPolicies@2023-08-01-preview"
  parent_id = azapi_resource.server.id
  name      = "default"
  body = {
    properties = {
      state = "Enabled"
    }
  }
}

resource "azapi_resource" "vulnerabilityAssessment" {
  type      = "Microsoft.Sql/servers/vulnerabilityAssessments@2023-08-01-preview"
  parent_id = azapi_resource.server.id
  name      = "default"
  body = {
    properties = {
      recurringScans = {
        emailSubscriptionAdmins = false
        emails                  = []
        isEnabled               = false
      }
      storageAccountAccessKey = azapi_resource_action.storageAccountKeys.output.keys[0].value
      storageContainerPath    = "${azapi_resource.storageAccount.output.properties.primaryEndpoints.blob}${azapi_resource.storageContainer.name}/"
    }
  }
  depends_on = [azapi_resource.securityAlertPolicy]
}

Formát prostředku

Vytvořit Microsoft. Zdroj SQL/servery/vulnerabilityAssessments, přidejte následující Terraform do své šablony.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/vulnerabilityAssessments@2023-08-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      recurringScans = {
        emails = [
          "string"
        ]
        emailSubscriptionAdmins = bool
        isEnabled = bool
      }
      storageAccountAccessKey = "string"
      storageContainerPath = "string"
      storageContainerSasKey = "string"
    }
  }
}

Hodnoty vlastností

Microsoft. Sql/servery/hodnocení zranitelností

Name Description Value
name Název prostředku Výchozí (povinné)
parent_id ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: servery
properties Vlastnosti prostředku. ServerVulnerabilityAssessmentProperties
typ Typ prostředku "Microsoft. Sql/servers/vulnerabilityAssessments@2023-08-01"

ServerVulnerabilityAssessmentProperties

Name Description Value
recurringScans Nastavení opakovaných kontrol VulnerabilityAssessmentRecurringScansProperties
storageAccountAccessKey Určuje klíč identifikátoru účtu úložiště pro výsledky kontroly posouzení ohrožení zabezpečení. Pokud není zadaný parametr StorageContainerSasKey, vyžaduje se klíč storageAccountAccessKey. Platí pouze v případě, že účet úložiště není za virtuální sítí nebo bránou firewall. řetězec
storageContainerPath Cesta ke kontejneru úložiště objektů blob pro uložení výsledků kontroly (např. https://myStorage.blob.core.windows.net/VaScans/). string (povinné)
storageContainerSasKey Sdílený přístupový podpis (klíč SAS), který má přístup k zápisu do kontejneru objektů blob zadaný v parametru storageContainerPath. Pokud není zadaný parametr storageAccountAccessKey, vyžaduje se StorageContainerSasKey. Platí pouze v případě, že účet úložiště není za virtuální sítí nebo bránou firewall. řetězec

VulnerabilityAssessmentRecurringScansProperties

Name Description Value
emails Určuje pole e-mailových adres, na které se odesílá oznámení kontroly. string[]
emailSubscriptionAdmins Určuje, že bude oznámení o kontrole plánu odesláno správcům předplatného. bool
isEnabled Stav opakovaných kontrol bool