Adaptive Application Controls - Put
Memperbarui grup komputer kontrol aplikasi
PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/applicationWhitelistings/{groupName}?api-version=2020-01-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
asc
|
path | True |
string |
Lokasi tempat ASC menyimpan data langganan. dapat diambil dari Dapatkan lokasi |
group
|
path | True |
string |
Nama grup komputer kontrol aplikasi |
subscription
|
path | True |
string |
ID langganan Azure Regex pattern: |
api-version
|
query | True |
string |
Versi API untuk operasi |
Isi Permintaan
Nama | Jenis | Deskripsi |
---|---|---|
properties.enforcementMode |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
|
properties.pathRecommendations |
Mewakili jalur yang direkomendasikan untuk diizinkan dan propertinya |
|
properties.protectionMode |
Mode perlindungan jenis koleksi/file. Exe/Msi/Script digunakan untuk Windows, Executable digunakan untuk Linux. |
|
properties.vmRecommendations |
Mewakili komputer yang merupakan bagian dari grup mesin |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Respons kesalahan yang menjelaskan mengapa operasi gagal. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
Update an application control machine group by adding a new application
Sample Request
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/locations/centralus/applicationWhitelistings/ERELGROUP1?api-version=2020-01-01
{
"properties": {
"enforcementMode": "Audit",
"protectionMode": {
"exe": "Audit",
"msi": "None",
"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",
"action": "Add",
"type": "File",
"common": true
}
]
}
}
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": "None",
"script": "None"
},
"vmRecommendations": [
{
"resourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/erelh-stable/providers/microsoft.compute/virtualmachines/erelh-16090",
"recommendationAction": "Recommended"
},
{
"resourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/matanvs/providers/microsoft.compute/virtualmachines/matanvs19",
"recommendationAction": "Recommended"
}
],
"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": "NotConfigured"
}
],
"configurationStatus": "InProgress",
"issues": [],
"sourceSystem": "Azure_AppLocker"
}
}
Definisi
Nama | Deskripsi |
---|---|
Adaptive |
|
Adaptive |
Pemberitahuan yang dapat dimiliki komputer dalam grup |
Adaptive |
Mewakili ringkasan pemberitahuan grup komputer |
Cloud |
Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.). |
Cloud |
Detail kesalahan. |
Configuration |
Status konfigurasi grup komputer atau mesin atau aturan |
Enforcement |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
Enforcement |
Dukungan mesin fitur Terlaksanakan |
Error |
Info tambahan kesalahan manajemen sumber daya. |
File |
Jenis file (untuk file Linux - Executable digunakan) |
Path |
Mewakili jalur yang direkomendasikan untuk diizinkan dan propertinya |
Protection |
Mode perlindungan jenis koleksi/file. Exe/Msi/Script digunakan untuk Windows, Executable digunakan untuk Linux. |
Publisher |
Mewakili informasi penerbit dari proses/aturan |
Recommendation |
Tindakan rekomendasi komputer atau aturan |
Recommendation |
Status rekomendasi awal grup komputer atau mesin |
Recommendation |
Jenis aturan yang akan diizinkan |
Source |
Jenis sumber grup komputer |
User |
Mewakili pengguna yang disarankan untuk diizinkan untuk aturan tertentu |
Vm |
Mewakili komputer yang merupakan bagian dari grup mesin |
AdaptiveApplicationControlGroup
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID sumber daya |
location |
string |
Lokasi tempat sumber daya disimpan |
name |
string |
Nama sumber daya |
properties.configurationStatus |
Status konfigurasi grup komputer atau mesin atau aturan |
|
properties.enforcementMode |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
|
properties.issues |
Mewakili ringkasan pemberitahuan grup komputer |
|
properties.pathRecommendations |
Mewakili jalur yang direkomendasikan untuk diizinkan dan propertinya |
|
properties.protectionMode |
Mode perlindungan jenis koleksi/file. Exe/Msi/Script digunakan untuk Windows, Executable digunakan untuk Linux. |
|
properties.recommendationStatus |
Status rekomendasi awal grup komputer atau mesin |
|
properties.sourceSystem |
Jenis sumber grup komputer |
|
properties.vmRecommendations |
Mewakili komputer yang merupakan bagian dari grup mesin |
|
type |
string |
Jenis Sumber Daya |
AdaptiveApplicationControlIssue
Pemberitahuan yang dapat dimiliki komputer dalam grup
Nama | Jenis | Deskripsi |
---|---|---|
ExecutableViolationsAudited |
string |
|
MsiAndScriptViolationsAudited |
string |
|
MsiAndScriptViolationsBlocked |
string |
|
RulesViolatedManually |
string |
|
ViolationsAudited |
string |
|
ViolationsBlocked |
string |
AdaptiveApplicationControlIssueSummary
Mewakili ringkasan pemberitahuan grup komputer
Nama | Jenis | Deskripsi |
---|---|---|
issue |
Pemberitahuan yang dapat dimiliki komputer dalam grup |
|
numberOfVms |
number |
Jumlah komputer dalam grup yang memiliki pemberitahuan ini |
CloudError
Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
Nama | Jenis | Deskripsi |
---|---|---|
error.additionalInfo |
Info tambahan kesalahan. |
|
error.code |
string |
Kode kesalahan. |
error.details |
Detail kesalahan. |
|
error.message |
string |
Pesan kesalahan. |
error.target |
string |
Target kesalahan. |
CloudErrorBody
Detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
additionalInfo |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ConfigurationStatus
Status konfigurasi grup komputer atau mesin atau aturan
Nama | Jenis | Deskripsi |
---|---|---|
Configured |
string |
|
Failed |
string |
|
InProgress |
string |
|
NoStatus |
string |
|
NotConfigured |
string |
EnforcementMode
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer
Nama | Jenis | Deskripsi |
---|---|---|
Audit |
string |
|
Enforce |
string |
|
None |
string |
EnforcementSupport
Dukungan mesin fitur Terlaksanakan
Nama | Jenis | Deskripsi |
---|---|---|
NotSupported |
string |
|
Supported |
string |
|
Unknown |
string |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
info |
object |
Info tambahan. |
type |
string |
Jenis info tambahan. |
FileType
Jenis file (untuk file Linux - Executable digunakan)
Nama | Jenis | Deskripsi |
---|---|---|
Dll |
string |
|
Exe |
string |
|
Executable |
string |
|
Msi |
string |
|
Script |
string |
|
Unknown |
string |
PathRecommendation
Mewakili jalur yang direkomendasikan untuk diizinkan dan propertinya
Nama | Jenis | Deskripsi |
---|---|---|
action |
Tindakan rekomendasi komputer atau aturan |
|
common |
boolean |
Apakah aplikasi umumnya dijalankan pada komputer |
configurationStatus |
Status konfigurasi grup komputer atau mesin atau aturan |
|
fileType |
Jenis file (untuk file Linux - Executable digunakan) |
|
path |
string |
Jalur lengkap file, atau pengidentifikasi aplikasi |
publisherInfo |
Mewakili informasi penerbit dari proses/aturan |
|
type |
Jenis aturan yang akan diizinkan |
|
userSids |
string[] |
Pengidentifikasi keamanan |
usernames |
Mewakili pengguna yang disarankan untuk diizinkan untuk aturan tertentu |
ProtectionMode
Mode perlindungan jenis koleksi/file. Exe/Msi/Script digunakan untuk Windows, Executable digunakan untuk Linux.
Nama | Jenis | Deskripsi |
---|---|---|
exe |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
|
executable |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
|
msi |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
|
script |
Mode penegakan/perlindungan kebijakan kontrol aplikasi dari grup komputer |
PublisherInfo
Mewakili informasi penerbit dari proses/aturan
Nama | Jenis | Deskripsi |
---|---|---|
binaryName |
string |
Bidang "OriginalName" yang diambil dari sumber daya versi file |
productName |
string |
Nama produk yang diambil dari sumber daya versi file |
publisherName |
string |
Bidang Subjek sertifikat x.509 yang digunakan untuk menandatangani kode, menggunakan bidang berikut - O = Organisasi, L = Lokalitas, S = Negara Bagian atau Provinsi, dan C = Negara |
version |
string |
Versi file biner yang diambil dari sumber daya versi file |
RecommendationAction
Tindakan rekomendasi komputer atau aturan
Nama | Jenis | Deskripsi |
---|---|---|
Add |
string |
|
Recommended |
string |
|
Remove |
string |
RecommendationStatus
Status rekomendasi awal grup komputer atau mesin
Nama | Jenis | Deskripsi |
---|---|---|
NoStatus |
string |
|
NotAvailable |
string |
|
NotRecommended |
string |
|
Recommended |
string |
RecommendationType
Jenis aturan yang akan diizinkan
Nama | Jenis | Deskripsi |
---|---|---|
BinarySignature |
string |
|
File |
string |
|
FileHash |
string |
|
ProductSignature |
string |
|
PublisherSignature |
string |
|
VersionAndAboveSignature |
string |
SourceSystem
Jenis sumber grup komputer
Nama | Jenis | Deskripsi |
---|---|---|
Azure_AppLocker |
string |
|
Azure_AuditD |
string |
|
NonAzure_AppLocker |
string |
|
NonAzure_AuditD |
string |
|
None |
string |
UserRecommendation
Mewakili pengguna yang disarankan untuk diizinkan untuk aturan tertentu
Nama | Jenis | Deskripsi |
---|---|---|
recommendationAction |
Tindakan rekomendasi komputer atau aturan |
|
username |
string |
Mewakili pengguna yang disarankan untuk diizinkan untuk aturan tertentu |
VmRecommendation
Mewakili komputer yang merupakan bagian dari grup mesin
Nama | Jenis | Deskripsi |
---|---|---|
configurationStatus |
Status konfigurasi grup komputer atau mesin atau aturan |
|
enforcementSupport |
Dukungan mesin fitur Terlaksanakan |
|
recommendationAction |
Tindakan rekomendasi komputer atau aturan |
|
resourceId |
string |
Id sumber daya lengkap komputer |