Adaptive Application Controls - Get

Lekéri az alkalmazásvezérlő virtuális gépet/kiszolgálócsoportot.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/applicationWhitelistings/{groupName}?api-version=2020-01-01

URI-paraméterek

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

string

Az a hely, ahol az ASC az előfizetés adatait tárolja. lekérhető a Helyek lekérése lehetőségről

groupName
path True

string

Alkalmazásvezérlő gépcsoport neve

subscriptionId
path True

string

Azure-előfizetés azonosítója

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

A művelet API-verziója

Válaszok

Name Típus Description
200 OK

AdaptiveApplicationControlGroup

OK

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Példák

Gets a configured application control VM/server group

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/locations/centralus/applicationWhitelistings/ERELGROUP1?api-version=2020-01-01

Sample Response

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/locations/centralus/applicationWhitelistings/ERELGROUP1",
  "name": "ERELGROUP1",
  "type": "Microsoft.Security/applicationWhitelistings",
  "location": "centralus",
  "properties": {
    "recommendationStatus": "Recommended",
    "enforcementMode": "Audit",
    "protectionMode": {
      "exe": "Audit",
      "msi": "Audit",
      "script": "None"
    },
    "vmRecommendations": [
      {
        "configurationStatus": "Configured",
        "resourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/erelh-stable/providers/microsoft.compute/virtualmachines/erelh-16090",
        "recommendationAction": "Recommended",
        "enforcementSupport": "Supported"
      },
      {
        "configurationStatus": "Configured",
        "resourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/matanvs/providers/microsoft.compute/virtualmachines/matanvs19",
        "recommendationAction": "Recommended",
        "enforcementSupport": "Supported"
      }
    ],
    "pathRecommendations": [
      {
        "path": "[Exe] O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US\\*\\*\\0.0.0.0",
        "type": "PublisherSignature",
        "publisherInfo": {
          "publisherName": "O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US",
          "productName": "*",
          "binaryName": "*",
          "version": "0.0.0.0"
        },
        "common": true,
        "action": "Recommended",
        "usernames": [
          {
            "username": "Everyone",
            "recommendationAction": "Recommended"
          }
        ],
        "userSids": [
          "S-1-1-0"
        ],
        "fileType": "Exe",
        "configurationStatus": "Configured"
      },
      {
        "path": "%OSDRIVE%\\WINDOWSAZURE\\SECAGENT\\WASECAGENTPROV.EXE",
        "type": "ProductSignature",
        "publisherInfo": {
          "publisherName": "CN=MICROSOFT AZURE DEPENDENCY CODE SIGN",
          "productName": "MICROSOFT® COREXT",
          "binaryName": "*",
          "version": "0.0.0.0"
        },
        "common": true,
        "action": "Recommended",
        "usernames": [
          {
            "username": "NT AUTHORITY\\SYSTEM",
            "recommendationAction": "Recommended"
          }
        ],
        "userSids": [
          "S-1-1-0"
        ],
        "fileType": "Exe",
        "configurationStatus": "Configured"
      },
      {
        "path": "%OSDRIVE%\\WINDOWSAZURE\\PACKAGES_201973_7415\\COLLECTGUESTLOGS.EXE",
        "type": "PublisherSignature",
        "publisherInfo": {
          "publisherName": "CN=MICROSOFT AZURE DEPENDENCY CODE SIGN",
          "productName": "*",
          "binaryName": "*",
          "version": "0.0.0.0"
        },
        "common": true,
        "action": "Recommended",
        "usernames": [
          {
            "username": "NT AUTHORITY\\SYSTEM",
            "recommendationAction": "Recommended"
          }
        ],
        "userSids": [
          "S-1-1-0"
        ],
        "fileType": "Exe",
        "configurationStatus": "Configured"
      },
      {
        "path": "C:\\directory\\file.exe",
        "type": "File",
        "common": true,
        "action": "Add",
        "usernames": [
          {
            "username": "Everyone",
            "recommendationAction": "Recommended"
          }
        ],
        "userSids": [
          "S-1-1-0"
        ],
        "fileType": "Exe",
        "configurationStatus": "Configured"
      }
    ],
    "configurationStatus": "Configured",
    "issues": [],
    "sourceSystem": "Azure_AppLocker"
  }
}

Definíciók

Name Description
AdaptiveApplicationControlGroup
AdaptiveApplicationControlIssue

Riasztás arról, hogy a csoporton belüli gépek rendelkezhetnek

AdaptiveApplicationControlIssueSummary

A gépcsoport riasztásainak összegzését jelöli

CloudError

Az összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

CloudErrorBody

A hiba részletei.

ConfigurationStatus

A gépcsoport vagy -gép vagy -szabály konfigurációs állapota

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

EnforcementSupport

A kényszerítés funkció gépi támogatása

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

FileType

A fájl típusa (Linux-fájlok esetén – Végrehajtható)

PathRecommendation

Az engedélyezett elérési utat és tulajdonságait jelöli

ProtectionMode

A gyűjtemény/fájltípusok védelmi módja. Az Exe/Msi/Script a Windowshoz, a Futtatható a Linuxhoz használható.

PublisherInfo

Egy folyamat/szabály közzétevői adatait jelöli

RecommendationAction

A gép vagy szabály javaslati művelete

RecommendationStatus

A gépcsoport vagy gép kezdeti javaslati állapota

RecommendationType

Az engedélyezendő szabály típusa

SourceSystem

A gépcsoport forrástípusa

UserRecommendation

Egy olyan felhasználót jelöl, amelyet ajánlott engedélyezni egy adott szabályhoz

VmRecommendation

Egy gépcsoport részét képező gépet jelöl

AdaptiveApplicationControlGroup

Name Típus Description
id

string

Erőforrás-azonosító

location

string

Az erőforrás tárolási helye

name

string

Erőforrás neve

properties.configurationStatus

ConfigurationStatus

A gépcsoport vagy -gép vagy -szabály konfigurációs állapota

properties.enforcementMode

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

properties.issues

AdaptiveApplicationControlIssueSummary[]

A gépcsoport riasztásainak összegzését jelöli

properties.pathRecommendations

PathRecommendation[]

Az engedélyezett elérési utat és tulajdonságait jelöli

properties.protectionMode

ProtectionMode

A gyűjtemény/fájltípusok védelmi módja. Az Exe/Msi/Script a Windowshoz, a Futtatható a Linuxhoz használható.

properties.recommendationStatus

RecommendationStatus

A gépcsoport vagy gép kezdeti javaslati állapota

properties.sourceSystem

SourceSystem

A gépcsoport forrástípusa

properties.vmRecommendations

VmRecommendation[]

Egy gépcsoport részét képező gépet jelöl

type

string

Erőforrás típusa

AdaptiveApplicationControlIssue

Riasztás arról, hogy a csoporton belüli gépek rendelkezhetnek

Name Típus Description
ExecutableViolationsAudited

string

MsiAndScriptViolationsAudited

string

MsiAndScriptViolationsBlocked

string

RulesViolatedManually

string

ViolationsAudited

string

ViolationsBlocked

string

AdaptiveApplicationControlIssueSummary

A gépcsoport riasztásainak összegzését jelöli

Name Típus Description
issue

AdaptiveApplicationControlIssue

Riasztás arról, hogy a csoporton belüli gépek rendelkezhetnek

numberOfVms

number

A csoport azon gépeinek száma, amelyeknél ez a riasztás szerepel

CloudError

Az összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Name Típus Description
error.additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

error.code

string

A hibakód.

error.details

CloudErrorBody[]

A hiba részletei.

error.message

string

A hibaüzenet.

error.target

string

A hibacél.

CloudErrorBody

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

CloudErrorBody[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ConfigurationStatus

A gépcsoport vagy -gép vagy -szabály konfigurációs állapota

Name Típus Description
Configured

string

Failed

string

InProgress

string

NoStatus

string

NotConfigured

string

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

Name Típus Description
Audit

string

Enforce

string

None

string

EnforcementSupport

A kényszerítés funkció gépi támogatása

Name Típus Description
NotSupported

string

Supported

string

Unknown

string

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

FileType

A fájl típusa (Linux-fájlok esetén – Végrehajtható)

Name Típus Description
Dll

string

Exe

string

Executable

string

Msi

string

Script

string

Unknown

string

PathRecommendation

Az engedélyezett elérési utat és tulajdonságait jelöli

Name Típus Description
action

RecommendationAction

A gép vagy szabály javaslati művelete

common

boolean

Azt jelzi, hogy az alkalmazás gyakran fut-e a gépen

configurationStatus

ConfigurationStatus

A gépcsoport vagy -gép vagy -szabály konfigurációs állapota

fileType

FileType

A fájl típusa (Linux-fájlok esetén – Végrehajtható)

path

string

A fájl teljes elérési útja vagy az alkalmazás azonosítója

publisherInfo

PublisherInfo

Egy folyamat/szabály közzétevői adatait jelöli

type

RecommendationType

Az engedélyezendő szabály típusa

userSids

string[]

Biztonsági azonosító

usernames

UserRecommendation[]

Egy olyan felhasználót jelöl, amelyet ajánlott engedélyezni egy adott szabályhoz

ProtectionMode

A gyűjtemény/fájltípusok védelmi módja. Az Exe/Msi/Script a Windowshoz, a Futtatható a Linuxhoz használható.

Name Típus Description
exe

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

executable

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

msi

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

script

EnforcementMode

A gépcsoport alkalmazásvezérlési szabályzat-kényszerítési/védelmi módja

PublisherInfo

Egy folyamat/szabály közzétevői adatait jelöli

Name Típus Description
binaryName

string

A fájl verzióerőforrásából vett "OriginalName" mező

productName

string

A fájl verzióerőforrásából vett terméknév

publisherName

string

A kód aláírásához használt x.509-tanúsítvány Tulajdonos mezője a következő mezők használatával: O = Szervezet, L = Helység, S = Állam vagy Tartomány és C = Ország

version

string

A fájl verzióerőforrásából vett bináris fájlverzió

RecommendationAction

A gép vagy szabály javaslati művelete

Name Típus Description
Add

string

Recommended

string

Remove

string

RecommendationStatus

A gépcsoport vagy gép kezdeti javaslati állapota

Name Típus Description
NoStatus

string

NotAvailable

string

NotRecommended

string

Recommended

string

RecommendationType

Az engedélyezendő szabály típusa

Name Típus Description
BinarySignature

string

File

string

FileHash

string

ProductSignature

string

PublisherSignature

string

VersionAndAboveSignature

string

SourceSystem

A gépcsoport forrástípusa

Name Típus Description
Azure_AppLocker

string

Azure_AuditD

string

NonAzure_AppLocker

string

NonAzure_AuditD

string

None

string

UserRecommendation

Egy olyan felhasználót jelöl, amelyet ajánlott engedélyezni egy adott szabályhoz

Name Típus Description
recommendationAction

RecommendationAction

A gép vagy szabály javaslati művelete

username

string

Egy olyan felhasználót jelöl, amelyet ajánlott engedélyezni egy adott szabályhoz

VmRecommendation

Egy gépcsoport részét képező gépet jelöl

Name Típus Description
configurationStatus

ConfigurationStatus

A gépcsoport vagy -gép vagy -szabály konfigurációs állapota

enforcementSupport

EnforcementSupport

A kényszerítés funkció gépi támogatása

recommendationAction

RecommendationAction

A gép vagy szabály javaslati művelete

resourceId

string

A gép teljes erőforrás-azonosítója