Megosztás a következőn keresztül:

Firewall Policy Drafts - Create Or Update

  • Referencia
Szolgáltatás:
Virtual Networks
API-verzió:
2024-05-01

Tűzfalszabályzat-tervezet létrehozása vagy frissítése.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/firewallPolicies/{firewallPolicyName}/firewallPolicyDrafts/default?api-version=2024-05-01

URI-paraméterek

Name In Kötelező Típus Description
firewallPolicyName
 path True

string

pattern: ^[^_\W][\w-._]{0,79}(?

A tűzfalszabályzat neve.
resourceGroupName
 path True

string

Az erőforráscsoport neve.
subscriptionId
 path True

string

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version
 query True

string

Ügyfél API-verziója.

Kérelem törzse

Name Típus Description
id

string

Erőforrás-azonosító.
location

string

Erőforrás helye.
properties.basePolicy

SubResource

A szülő tűzfalszabályzat, amelytől a szabályok öröklődnek.
properties.dnsSettings

DnsSettings

DNS-proxybeállítások definíciója.
properties.explicitProxy

ExplicitProxy

Explicit proxybeállítások definíciója.
properties.insights

FirewallPolicyInsights

Elemzések a tűzfalszabályzatról.
properties.intrusionDetection

FirewallPolicyIntrusionDetection

A behatolásészlelés konfigurációja.
properties.snat

FirewallPolicySNAT

Azok a privát IP-címek/IP-tartományok, amelyek felé a forgalom nem lesz SNAT.
properties.sql

FirewallPolicySQL

SQL-beállítások definíciója.
properties.threatIntelMode

AzureFirewallThreatIntelMode

A fenyegetésintelligencia műveleti módja.
properties.threatIntelWhitelist

FirewallPolicyThreatIntelWhitelist

A ThreatIntel engedélyezési listája tűzfalszabályzathoz.
tags

object

Erőforráscímkék.

Válaszok

Name Típus Description
200 OK

FirewallPolicyDraft

OKÉ
201 Created

FirewallPolicyDraft

Létrehozott
Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

create or update firewall policy draft

Mintakérelem

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/firewallPolicyDrafts/default?api-version=2024-05-01

{
  "properties": {
    "threatIntelMode": "Alert",
    "threatIntelWhitelist": {
      "ipAddresses": [
        "20.3.4.5"
      ],
      "fqdns": [
        "*.microsoft.com"
      ]
    },
    "insights": {
      "isEnabled": true,
      "retentionDays": 100,
      "logAnalyticsResources": {
        "workspaces": [
          {
            "region": "westus",
            "workspaceId": {
              "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/workspace1"
            }
          },
          {
            "region": "eastus",
            "workspaceId": {
              "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/workspace2"
            }
          }
        ],
        "defaultWorkspaceId": {
          "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/defaultWorkspace"
        }
      }
    },
    "snat": {
      "privateRanges": [
        "IANAPrivateRanges"
      ]
    },
    "sql": {
      "allowSqlRedirect": true
    },
    "dnsSettings": {
      "servers": [
        "30.3.4.5"
      ],
      "enableProxy": true,
      "requireProxyForNetworkRules": false
    },
    "explicitProxy": {
      "enableExplicitProxy": true,
      "httpPort": 8087,
      "httpsPort": 8087,
      "enablePacFile": true,
      "pacFilePort": 8087,
      "pacFile": "https://tinawstorage.file.core.windows.net/?sv=2020-02-10&ss=bfqt&srt=sco&sp=rwdlacuptfx&se=2021-06-04T07:01:12Z&st=2021-06-03T23:01:12Z&sip=68.65.171.11&spr=https&sig=Plsa0RRVpGbY0IETZZOT6znOHcSro71LLTTbzquYPgs%3D"
    },
    "intrusionDetection": {
      "mode": "Alert",
      "profile": "Balanced",
      "configuration": {
        "signatureOverrides": [
          {
            "id": "2525004",
            "mode": "Deny"
          }
        ],
        "bypassTrafficSettings": [
          {
            "name": "bypassRule1",
            "description": "Rule 1",
            "protocol": "TCP",
            "sourceAddresses": [
              "1.2.3.4"
            ],
            "destinationAddresses": [
              "5.6.7.8"
            ],
            "destinationPorts": [
              "*"
            ]
          }
        ]
      }
    }
  }
}

Mintaválasz

Állapotkód:
200 
{
  "name": "firewallPolicy",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy",
  "type": "Microsoft.Network/firewallPolicies",
  "properties": {
    "threatIntelMode": "Alert",
    "threatIntelWhitelist": {
      "ipAddresses": [
        "20.3.4.5"
      ],
      "fqdns": [
        "*.microsoft.com"
      ]
    },
    "insights": {
      "isEnabled": true,
      "retentionDays": 100,
      "logAnalyticsResources": {
        "workspaces": [
          {
            "region": "westus",
            "workspaceId": {
              "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/workspace1"
            }
          },
          {
            "region": "eastus",
            "workspaceId": {
              "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/workspace2"
            }
          }
        ],
        "defaultWorkspaceId": {
          "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/defaultWorkspace"
        }
      }
    },
    "snat": {
      "privateRanges": [
        "IANAPrivateRanges"
      ]
    },
    "sql": {
      "allowSqlRedirect": true
    },
    "dnsSettings": {
      "servers": [
        "30.3.4.5"
      ],
      "enableProxy": true,
      "requireProxyForNetworkRules": false
    },
    "explicitProxy": {
      "enableExplicitProxy": true,
      "httpPort": 8087,
      "httpsPort": 8087,
      "enablePacFile": true,
      "pacFilePort": 8087,
      "pacFile": "https://tinawstorage.file.core.windows.net/?sv=2020-02-10&ss=bfqt&srt=sco&sp=rwdlacuptfx&se=2021-06-04T07:01:12Z&st=2021-06-03T23:01:12Z&sip=68.65.171.11&spr=https&sig=Plsa0RRVpGbY0IETZZOT6znOHcSro71LLTTbzquYPgs%3D"
    },
    "intrusionDetection": {
      "mode": "Alert",
      "profile": "Balanced",
      "configuration": {
        "signatureOverrides": [
          {
            "id": "2525004",
            "mode": "Deny"
          }
        ],
        "bypassTrafficSettings": [
          {
            "name": "bypassRule1",
            "description": "Rule 1",
            "protocol": "TCP",
            "sourceAddresses": [
              "1.2.3.4"
            ],
            "destinationAddresses": [
              "5.6.7.8"
            ],
            "destinationPorts": [
              "*"
            ]
          }
        ]
      }
    }
  }
}
Állapotkód:
201 
{
  "name": "firewallPolicy",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy",
  "type": "Microsoft.Network/firewallPolicies",
  "properties": {
    "threatIntelMode": "Alert",
    "threatIntelWhitelist": {
      "ipAddresses": [
        "20.3.4.5"
      ],
      "fqdns": [
        "*.microsoft.com"
      ]
    },
    "insights": {
      "isEnabled": true,
      "retentionDays": 100,
      "logAnalyticsResources": {
        "workspaces": [
          {
            "region": "westus",
            "workspaceId": {
              "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/workspace1"
            }
          },
          {
            "region": "eastus",
            "workspaceId": {
              "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/workspace2"
            }
          }
        ],
        "defaultWorkspaceId": {
          "id": "/subscriptions/subid/resourcegroups/rg1/providers/microsoft.operationalinsights/workspaces/defaultWorkspace"
        }
      }
    },
    "snat": {
      "privateRanges": [
        "IANAPrivateRanges"
      ]
    },
    "sql": {
      "allowSqlRedirect": true
    },
    "dnsSettings": {
      "servers": [
        "30.3.4.5"
      ],
      "enableProxy": true,
      "requireProxyForNetworkRules": false
    },
    "explicitProxy": {
      "enableExplicitProxy": true,
      "httpPort": 8087,
      "httpsPort": 8087,
      "enablePacFile": true,
      "pacFilePort": 8087,
      "pacFile": "https://tinawstorage.file.core.windows.net/?sv=2020-02-10&ss=bfqt&srt=sco&sp=rwdlacuptfx&se=2021-06-04T07:01:12Z&st=2021-06-03T23:01:12Z&sip=68.65.171.11&spr=https&sig=Plsa0RRVpGbY0IETZZOT6znOHcSro71LLTTbzquYPgs%3D"
    },
    "intrusionDetection": {
      "mode": "Alert",
      "profile": "Balanced",
      "configuration": {
        "signatureOverrides": [
          {
            "id": "2525004",
            "mode": "Deny"
          }
        ],
        "bypassTrafficSettings": [
          {
            "name": "bypassRule1",
            "description": "Rule 1",
            "protocol": "TCP",
            "sourceAddresses": [
              "1.2.3.4"
            ],
            "destinationAddresses": [
              "5.6.7.8"
            ],
            "destinationPorts": [
              "*"
            ]
          }
        ]
      }
    }
  }
}

Definíciók

Name Description
AutoLearnPrivateRangesMode

A privát tartományok automatikus tanulásának műveleti módja, hogy ne legyen SNAT
AzureFirewallThreatIntelMode

A Threat Intel műveleti módja.
CloudError

Hibaválasz a szolgáltatástól.
CloudErrorBody

Hibaválasz a szolgáltatástól.
DnsSettings

DNS-proxybeállítások a tűzfalszabályzatban.
ExplicitProxy

Explicit proxybeállítások a tűzfalszabályzatban.
FirewallPolicyDraft

FirewallPolicy-erőforrás.
FirewallPolicyInsights

Tűzfalszabályzat-elemzések.
FirewallPolicyIntrusionDetection

A behatolásészlelési mód és szabályok konfigurálása.
FirewallPolicyIntrusionDetectionBypassTrafficSpecifications

A behatolásészlelés megkerüli a forgalom specifikációját.
FirewallPolicyIntrusionDetectionConfiguration

A behatolásészlelés konfigurálásának művelete.
FirewallPolicyIntrusionDetectionProfileType

IDPS-profil neve. Szülőházirendhez csatolva a tűzfal érvényes profilja a szülőházirend profilneve.
FirewallPolicyIntrusionDetectionProtocol

A szabály megkerülő protokollja.
FirewallPolicyIntrusionDetectionSignatureSpecification

A behatolásészlelési aláírások specifikációinak állapota.
FirewallPolicyIntrusionDetectionStateType

Behatolásészlelés általános állapota. Szülőházirendhez csatolva a tűzfal tényleges IDPS-módja a kettő szigorúbb módja.
FirewallPolicyLogAnalyticsResources

Log Analytics-erőforrások tűzfalszabályzat-elemzésekhez.
FirewallPolicyLogAnalyticsWorkspace

Log Analytics-munkaterület tűzfalszabályzat-elemzésekhez.
FirewallPolicySNAT

Azok a privát IP-címek/IP-tartományok, amelyek felé a forgalom nem lesz SNAT.
FirewallPolicySQL

SQL-beállítások a tűzfalszabályzatban.
FirewallPolicyThreatIntelWhitelist

A ThreatIntel engedélyezési listája tűzfalszabályzathoz.
SubResource

Hivatkozás egy másik alforrásra.

AutoLearnPrivateRangesMode

Enumerálás

A privát tartományok automatikus tanulásának műveleti módja, hogy ne legyen SNAT

Érték Description
Disabled
Enabled

AzureFirewallThreatIntelMode

Enumerálás

A Threat Intel műveleti módja.

Érték Description
Alert
Deny
Off

CloudError

Objektum

Hibaválasz a szolgáltatástól.

Name Típus Description
error

CloudErrorBody

Felhőbeli hibatörzs.

CloudErrorBody

Objektum

Hibaválasz a szolgáltatástól.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details

CloudErrorBody[]

A hiba további részleteinek listája.
message

string

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target

string

Az adott hiba célja. Például a tulajdonság neve hibás.

DnsSettings

Objektum

DNS-proxybeállítások a tűzfalszabályzatban.

Name Típus Description
enableProxy

boolean

Engedélyezze a DNS-proxyt a tűzfalszabályzathoz csatolt tűzfalakon.
requireProxyForNetworkRules

boolean

A hálózati szabályok teljes tartománynevei támogatottak, ha igaz értékre vannak állítva.
servers

string[]

Egyéni DNS-kiszolgálók listája.

ExplicitProxy

Objektum

Explicit proxybeállítások a tűzfalszabályzatban.

Name Típus Description
enableExplicitProxy

boolean

Ha igaz értékre van állítva, a explicit proxy mód engedélyezve van.
enablePacFile

boolean

Ha igaz értékre van állítva, meg kell adni a pac fájlportot és az URL-címet.
httpPort

integer (int32)

minimum: 0
maximum: 64000
exclusiveMinimum: False
exclusiveMaximum: False

Az explicit proxy http protokolljának portszáma nem lehet nagyobb 64000-nél.
httpsPort

integer (int32)

minimum: 0
maximum: 64000
exclusiveMinimum: False
exclusiveMaximum: False

Az explicit proxy https protokoll portszáma nem lehet nagyobb 64000-nél.
pacFile

string

A PAC-fájl SAS URL-címe.
pacFilePort

integer (int32)

minimum: 0
maximum: 64000
exclusiveMinimum: False
exclusiveMaximum: False

A PAC-fájl kiszolgálására szolgáló tűzfal portszáma.

FirewallPolicyDraft

Objektum

FirewallPolicy-erőforrás.

Name Típus Description
id

string

Erőforrás-azonosító.
location

string

Erőforrás helye.
name

string

Erőforrás neve.
properties.basePolicy

SubResource

A szülő tűzfalszabályzat, amelytől a szabályok öröklődnek.
properties.dnsSettings

DnsSettings

DNS-proxybeállítások definíciója.
properties.explicitProxy

ExplicitProxy

Explicit proxybeállítások definíciója.
properties.insights

FirewallPolicyInsights

Elemzések a tűzfalszabályzatról.
properties.intrusionDetection

FirewallPolicyIntrusionDetection

A behatolásészlelés konfigurációja.
properties.snat

FirewallPolicySNAT

Azok a privát IP-címek/IP-tartományok, amelyek felé a forgalom nem lesz SNAT.
properties.sql

FirewallPolicySQL

SQL-beállítások definíciója.
properties.threatIntelMode

AzureFirewallThreatIntelMode

A fenyegetésintelligencia műveleti módja.
properties.threatIntelWhitelist

FirewallPolicyThreatIntelWhitelist

A ThreatIntel engedélyezési listája tűzfalszabályzathoz.
tags

object

Erőforráscímkék.
type

string

Erőforrás típusa.

FirewallPolicyInsights

Objektum

Tűzfalszabályzat-elemzések.

Name Típus Description
isEnabled

boolean

Egy jelző, amely jelzi, hogy az elemzések engedélyezve vannak-e a szabályzatban.
logAnalyticsResources

FirewallPolicyLogAnalyticsResources

A tűzfalszabályzat-elemzések konfigurálásához szükséges munkaterületek.
retentionDays

integer (int32)

Azon napok száma, amikor az elemzéseket engedélyezni kell a szabályzatban.

FirewallPolicyIntrusionDetection

Objektum

A behatolásészlelési mód és szabályok konfigurálása.

Name Típus Description
configuration

FirewallPolicyIntrusionDetectionConfiguration

Behatolásészlelés konfigurációs tulajdonságai.
mode

FirewallPolicyIntrusionDetectionStateType

Behatolásészlelés általános állapota. Szülőházirendhez csatolva a tűzfal tényleges IDPS-módja a kettő szigorúbb módja.
profile

FirewallPolicyIntrusionDetectionProfileType

IDPS-profil neve. Szülőházirendhez csatolva a tűzfal érvényes profilja a szülőházirend profilneve.

FirewallPolicyIntrusionDetectionBypassTrafficSpecifications

Objektum

A behatolásészlelés megkerüli a forgalom specifikációját.

Name Típus Description
description

string

Az elkerülő forgalmi szabály leírása.
destinationAddresses

string[]

A szabály cél IP-címeinek vagy tartományainak listája.
destinationIpGroups

string[]

A szabály cél ipgroupjainak listája.
destinationPorts

string[]

Célportok vagy tartományok listája.
name

string

Az elkerülő forgalmi szabály neve.
protocol

FirewallPolicyIntrusionDetectionProtocol

A szabály megkerülő protokollja.
sourceAddresses

string[]

A szabály forrás IP-címeinek vagy tartományainak listája.
sourceIpGroups

string[]

A szabályhoz tartozó forrás IpGroupok listája.

FirewallPolicyIntrusionDetectionConfiguration

Objektum

A behatolásészlelés konfigurálásának művelete.

Name Típus Description
bypassTrafficSettings

FirewallPolicyIntrusionDetectionBypassTrafficSpecifications[]

Megkerülendő forgalom szabályainak listája.
privateRanges

string[]

Az IDPS Privát IP-címtartományok a forgalom irányának azonosítására szolgálnak (például bejövő, kimenő stb.). Alapértelmezés szerint csak az IANA RFC 1918 által meghatározott tartományok minősülnek magánhálózati IP-címeknek. Az alapértelmezett tartományok módosításához adja meg a magánhálózati IP-címtartományokat ezzel a tulajdonsággal
signatureOverrides

FirewallPolicyIntrusionDetectionSignatureSpecification[]

Adott aláírási állapotok listája.

FirewallPolicyIntrusionDetectionProfileType

Enumerálás

IDPS-profil neve. Szülőházirendhez csatolva a tűzfal érvényes profilja a szülőházirend profilneve.

Érték Description
Advanced
Basic
Extended
Standard

FirewallPolicyIntrusionDetectionProtocol

Enumerálás

A szabály megkerülő protokollja.

Érték Description
ANY
ICMP
TCP
UDP

FirewallPolicyIntrusionDetectionSignatureSpecification

Objektum

A behatolásészlelési aláírások specifikációinak állapota.

Name Típus Description
id

string

Aláírás azonosítója.
mode

FirewallPolicyIntrusionDetectionStateType

Az aláírás állapota.

FirewallPolicyIntrusionDetectionStateType

Enumerálás

Behatolásészlelés általános állapota. Szülőházirendhez csatolva a tűzfal tényleges IDPS-módja a kettő szigorúbb módja.

Érték Description
Alert
Deny
Off

FirewallPolicyLogAnalyticsResources

Objektum

Log Analytics-erőforrások tűzfalszabályzat-elemzésekhez.

Name Típus Description
defaultWorkspaceId

SubResource

A Firewall Policy Insights alapértelmezett munkaterület-azonosítója.
workspaces

FirewallPolicyLogAnalyticsWorkspace[]

A Firewall Policy Insights munkaterületeinek listája.

FirewallPolicyLogAnalyticsWorkspace

Objektum

Log Analytics-munkaterület tűzfalszabályzat-elemzésekhez.

Name Típus Description
region

string

Régió a munkaterület konfigurálásához.
workspaceId

SubResource

A Firewall Policy Insights munkaterület-azonosítója.

FirewallPolicySNAT

Objektum

Azok a privát IP-címek/IP-tartományok, amelyek felé a forgalom nem lesz SNAT.

Name Típus Description
autoLearnPrivateRanges

AutoLearnPrivateRangesMode

A privát tartományok automatikus tanulásának műveleti módja, hogy ne legyen SNAT
privateRanges

string[]

Azon magánhálózati IP-címek/IP-címtartományok listája, hogy ne legyen SNAT.

FirewallPolicySQL

Objektum

SQL-beállítások a tűzfalszabályzatban.

Name Típus Description
allowSqlRedirect

boolean

Egy jelző, amely jelzi, hogy engedélyezve van-e az SQL Redirect forgalomszűrése. A jelölő bekapcsolásához nincs szükség az 11000-11999-s portot használó szabályra.

FirewallPolicyThreatIntelWhitelist

Objektum

A ThreatIntel engedélyezési listája tűzfalszabályzathoz.

Name Típus Description
fqdns

string[]

A ThreatIntel engedélyezési listájához tartozó teljes tartománynevek listája.
ipAddresses

string[]

A ThreatIntel engedélyezési listájának IP-címeinek listája.

SubResource

Objektum

Hivatkozás egy másik alforrásra.

Name Típus Description
id

string

Erőforrás-azonosító.