Microsoft Azure SDK for Python

This is the Microsoft Azure Security Center Management Client Library. This package has been tested with Python 3.8+. For a more complete view of Azure libraries, see the azure sdk python release.

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Getting started

Prerequisites

• Python 3.8+ is required to use this package.
• Azure subscription

Install the package

pip install azure-mgmt-security
pip install azure-identity

Authentication

By default, Azure Active Directory token authentication depends on correct configure of following environment variables.

• AZURE_CLIENT_ID for Azure client ID.
• AZURE_TENANT_ID for Azure tenant ID.
• AZURE_CLIENT_SECRET for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable AZURE_SUBSCRIPTION_ID.

With above configuration, client can be authenticated by following code:

from azure.identity import DefaultAzureCredential
from azure.mgmt.security import SecurityCenter
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = SecurityCenter(credential=DefaultAzureCredential(), subscription_id=sub_id)

Examples

Code samples for this package can be found at:

• Search Security Center Management on docs.microsoft.com
• Azure Python Mgmt SDK Samples Repo

Troubleshooting

Next steps

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

7.0.0 (2024-05-20)

Features Added

• Added operation HealthReportsOperations.get
• Added operation PricingsOperations.delete
• Added operation group AzureDevOpsOrgsOperations
• Added operation group AzureDevOpsProjectsOperations
• Added operation group AzureDevOpsReposOperations
• Added operation group DevOpsConfigurationsOperations
• Added operation group DevOpsOperationResultsOperations
• Added operation group GitHubOwnersOperations
• Added operation group GitHubReposOperations
• Added operation group GitLabGroupsOperations
• Added operation group GitLabProjectsOperations
• Added operation group GitLabSubgroupsOperations
• Added operation group SensitivitySettingsOperations
• Added operation group ServerVulnerabilityAssessmentsSettingsOperations
• Model AwsEnvironmentData has a new parameter scan_interval
• Model DefenderCspmAwsOffering has a new parameter ciem
• Model DefenderCspmAwsOffering has a new parameter mdc_containers_agentless_discovery_k8_s
• Model DefenderCspmAwsOffering has a new parameter mdc_containers_image_assessment
• Model DefenderCspmGcpOffering has a new parameter ciem_discovery
• Model DefenderCspmGcpOffering has a new parameter data_sensitivity_discovery
• Model DefenderCspmGcpOffering has a new parameter mdc_containers_agentless_discovery_k8_s
• Model DefenderCspmGcpOffering has a new parameter mdc_containers_image_assessment
• Model DefenderCspmGcpOffering has a new parameter vm_scanners
• Model DefenderForContainersAwsOffering has a new parameter mdc_containers_agentless_discovery_k8_s
• Model DefenderForContainersAwsOffering has a new parameter mdc_containers_image_assessment
• Model DefenderForContainersGcpOffering has a new parameter mdc_containers_agentless_discovery_k8_s
• Model DefenderForContainersGcpOffering has a new parameter mdc_containers_image_assessment
• Model GcpProjectEnvironmentData has a new parameter scan_interval
• Model HealthReport has a new parameter affected_defenders_sub_plans
• Model HealthReport has a new parameter report_additional_data
• Model Pricing has a new parameter enforce
• Model Pricing has a new parameter inherited
• Model Pricing has a new parameter inherited_from
• Model Pricing has a new parameter resources_coverage_status
• Model Status has a new parameter last_scanned_date
• Model Status has a new parameter reason
• Operation PricingsOperations.list has a new optional parameter filter

Breaking Changes

• Operation PricingsOperations.get has a new required parameter scope_id
• Operation PricingsOperations.list has a new required parameter scope_id
• Operation PricingsOperations.update has a new required parameter scope_id
• Removed operation group IngestionSettingsOperations

6.0.0 (2024-01-19)

Features Added

• Added operation group APICollectionsOperations
• Added operation group DefenderForStorageOperations
• Model SecurityContact has a new parameter emails
• Model SecurityContact has a new parameter notifications_by_role

Breaking Changes

• Model SecurityContact no longer has parameter alerts_to_admins
• Model SecurityContact no longer has parameter email
• Removed operation SecurityContactsOperations.update

5.0.0 (2023-04-20)

Features Added

• Added operation group APICollectionOffboardingOperations
• Added operation group APICollectionOnboardingOperations
• Added operation group APICollectionOperations
• Added operation group SecurityOperatorsOperations
• Model AwsEnvironmentData has a new parameter account_name
• Model AwsEnvironmentData has a new parameter regions
• Model DefenderCspmAwsOffering has a new parameter data_sensitivity_discovery
• Model DefenderCspmAwsOffering has a new parameter databases_dspm
• Model DefenderFoDatabasesAwsOffering has a new parameter databases_dspm
• Model DefenderFoDatabasesAwsOfferingArcAutoProvisioning has a new parameter configuration
• Model DefenderForDatabasesGcpOfferingArcAutoProvisioning has a new parameter configuration
• Model DefenderForDatabasesGcpOfferingArcAutoProvisioningConfiguration has a new parameter private_link_scope
• Model DefenderForDatabasesGcpOfferingArcAutoProvisioningConfiguration has a new parameter proxy
• Model DefenderForServersAwsOfferingArcAutoProvisioning has a new parameter configuration
• Model DefenderForServersGcpOffering has a new parameter vm_scanners
• Model DefenderForServersGcpOfferingArcAutoProvisioning has a new parameter configuration
• Model DefenderForServersGcpOfferingArcAutoProvisioningConfiguration has a new parameter private_link_scope
• Model DefenderForServersGcpOfferingArcAutoProvisioningConfiguration has a new parameter proxy
• Model GcpOrganizationalDataOrganization has a new parameter organization_name
• Model GcpProjectDetails has a new parameter project_name
• Model Pricing has a new parameter enablement_time
• Model Pricing has a new parameter extensions

Breaking Changes

• Model DefenderForDatabasesGcpOfferingArcAutoProvisioningConfiguration no longer has parameter agent_onboarding_service_account_numeric_id
• Model DefenderForDatabasesGcpOfferingArcAutoProvisioningConfiguration no longer has parameter client_id
• Model DefenderForServersGcpOfferingArcAutoProvisioningConfiguration no longer has parameter agent_onboarding_service_account_numeric_id
• Model DefenderForServersGcpOfferingArcAutoProvisioningConfiguration no longer has parameter client_id

4.0.0 (2023-03-20)

Features Added

• Added operation GovernanceRulesOperations.begin_execute
• Added operation GovernanceRulesOperations.list
• Added operation GovernanceRulesOperations.operation_results
• Added operation group HealthReportOperations
• Added operation group HealthReportsOperations
• Model GovernanceRule has a new parameter excluded_scopes
• Model GovernanceRule has a new parameter include_member_scopes
• Model GovernanceRule has a new parameter metadata
• Model GovernanceRule has a new parameter tenant_id
• Model ResourceDetails has a new parameter connector_id
• Model ResourceDetails has a new parameter id
• Model ScanProperties has a new parameter last_scan_time

Breaking Changes

• Operation GovernanceRulesOperations.create_or_update has a new required parameter scope
• Operation GovernanceRulesOperations.get has a new required parameter scope
• Removed operation GovernanceRulesOperations.begin_rule_id_execute_single_security_connector
• Removed operation GovernanceRulesOperations.begin_rule_id_execute_single_subscription
• Removed operation group GovernanceRuleOperations
• Removed operation group SecurityConnectorGovernanceRuleOperations
• Removed operation group SecurityConnectorGovernanceRulesExecuteStatusOperations
• Removed operation group SecurityConnectorGovernanceRulesOperations
• Removed operation group SubscriptionGovernanceRulesExecuteStatusOperations
• Renamed operation GovernanceRulesOperations.delete to GovernanceRulesOperations.begin_delete

4.0.0b2 (2023-03-06)

Features Added

• Added operation GovernanceRulesOperations.begin_execute
• Added operation GovernanceRulesOperations.list
• Added operation GovernanceRulesOperations.operation_results
• Model GovernanceRule has a new parameter excluded_scopes
• Model GovernanceRule has a new parameter include_member_scopes
• Model GovernanceRule has a new parameter metadata
• Model GovernanceRule has a new parameter tenant_id

Breaking Changes

• Operation GovernanceRulesOperations.create_or_update has a new required parameter scope
• Operation GovernanceRulesOperations.get has a new required parameter scope
• Removed operation GovernanceRulesOperations.begin_rule_id_execute_single_security_connector
• Removed operation GovernanceRulesOperations.begin_rule_id_execute_single_subscription
• Removed operation group GovernanceRuleOperations
• Removed ope