azure-native.security.SecurityContact

Explore with Pulumi AI

Contact details and configurations for notifications coming from Microsoft Defender for Cloud. API Version: 2020-01-01-preview.

Example Usage

Create security contact data

using System.Collections.Generic;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var securityContact = new AzureNative.Security.SecurityContact("securityContact", new()
    {
        AlertNotifications = new AzureNative.Security.Inputs.SecurityContactPropertiesAlertNotificationsArgs
        {
            MinimalSeverity = "Low",
            State = "On",
        },
        Emails = "john@contoso.com;jane@contoso.com",
        NotificationsByRole = new AzureNative.Security.Inputs.SecurityContactPropertiesNotificationsByRoleArgs
        {
            Roles = new[]
            {
                "Owner",
            },
            State = "On",
        },
        Phone = "(214)275-4038",
        SecurityContactName = "default",
    });

});
package main

import (
	security "github.com/pulumi/pulumi-azure-native/sdk/go/azure/security"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := security.NewSecurityContact(ctx, "securityContact", &security.SecurityContactArgs{
			AlertNotifications: &security.SecurityContactPropertiesAlertNotificationsArgs{
				MinimalSeverity: pulumi.String("Low"),
				State:           pulumi.String("On"),
			},
			Emails: pulumi.String("john@contoso.com;jane@contoso.com"),
			NotificationsByRole: &security.SecurityContactPropertiesNotificationsByRoleArgs{
				Roles: pulumi.StringArray{
					pulumi.String("Owner"),
				},
				State: pulumi.String("On"),
			},
			Phone:               pulumi.String("(214)275-4038"),
			SecurityContactName: pulumi.String("default"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.security.SecurityContact;
import com.pulumi.azurenative.security.SecurityContactArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var securityContact = new SecurityContact("securityContact", SecurityContactArgs.builder()        
            .alertNotifications(Map.ofEntries(
                Map.entry("minimalSeverity", "Low"),
                Map.entry("state", "On")
            ))
            .emails("john@contoso.com;jane@contoso.com")
            .notificationsByRole(Map.ofEntries(
                Map.entry("roles", "Owner"),
                Map.entry("state", "On")
            ))
            .phone("(214)275-4038")
            .securityContactName("default")
            .build());

    }
}
import pulumi
import pulumi_azure_native as azure_native

security_contact = azure_native.security.SecurityContact("securityContact",
    alert_notifications=azure_native.security.SecurityContactPropertiesAlertNotificationsArgs(
        minimal_severity="Low",
        state="On",
    ),
    emails="john@contoso.com;jane@contoso.com",
    notifications_by_role=azure_native.security.SecurityContactPropertiesNotificationsByRoleArgs(
        roles=["Owner"],
        state="On",
    ),
    phone="(214)275-4038",
    security_contact_name="default")
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const securityContact = new azure_native.security.SecurityContact("securityContact", {
    alertNotifications: {
        minimalSeverity: "Low",
        state: "On",
    },
    emails: "john@contoso.com;jane@contoso.com",
    notificationsByRole: {
        roles: ["Owner"],
        state: "On",
    },
    phone: "(214)275-4038",
    securityContactName: "default",
});
resources:
  securityContact:
    type: azure-native:security:SecurityContact
    properties:
      alertNotifications:
        minimalSeverity: Low
        state: On
      emails: john@contoso.com;jane@contoso.com
      notificationsByRole:
        roles:
          - Owner
        state: On
      phone: (214)275-4038
      securityContactName: default

Create SecurityContact Resource

new SecurityContact(name: string, args?: SecurityContactArgs, opts?: CustomResourceOptions);
@overload
def SecurityContact(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    alert_notifications: Optional[SecurityContactPropertiesAlertNotificationsArgs] = None,
                    emails: Optional[str] = None,
                    notifications_by_role: Optional[SecurityContactPropertiesNotificationsByRoleArgs] = None,
                    phone: Optional[str] = None,
                    security_contact_name: Optional[str] = None)
@overload
def SecurityContact(resource_name: str,
                    args: Optional[SecurityContactArgs] = None,
                    opts: Optional[ResourceOptions] = None)
func NewSecurityContact(ctx *Context, name string, args *SecurityContactArgs, opts ...ResourceOption) (*SecurityContact, error)
public SecurityContact(string name, SecurityContactArgs? args = null, CustomResourceOptions? opts = null)
public SecurityContact(String name, SecurityContactArgs args)
public SecurityContact(String name, SecurityContactArgs args, CustomResourceOptions options)
type: azure-native:security:SecurityContact
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args SecurityContactArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args SecurityContactArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args SecurityContactArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args SecurityContactArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args SecurityContactArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

SecurityContact Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The SecurityContact resource accepts the following input properties:

AlertNotifications Pulumi.AzureNative.Security.Inputs.SecurityContactPropertiesAlertNotificationsArgs

Defines whether to send email notifications about new security alerts

Emails string

List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.

NotificationsByRole Pulumi.AzureNative.Security.Inputs.SecurityContactPropertiesNotificationsByRoleArgs

Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.

Phone string

The security contact's phone number

SecurityContactName string

Name of the security contact object

AlertNotifications SecurityContactPropertiesAlertNotificationsArgs

Defines whether to send email notifications about new security alerts

Emails string

List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.

NotificationsByRole SecurityContactPropertiesNotificationsByRoleArgs

Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.

Phone string

The security contact's phone number

SecurityContactName string

Name of the security contact object

alertNotifications SecurityContactPropertiesAlertNotificationsArgs

Defines whether to send email notifications about new security alerts

emails String

List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.

notificationsByRole SecurityContactPropertiesNotificationsByRoleArgs

Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.

phone String

The security contact's phone number

securityContactName String

Name of the security contact object

alertNotifications SecurityContactPropertiesAlertNotificationsArgs

Defines whether to send email notifications about new security alerts

emails string

List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.

notificationsByRole SecurityContactPropertiesNotificationsByRoleArgs

Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.

phone string

The security contact's phone number

securityContactName string

Name of the security contact object

alert_notifications SecurityContactPropertiesAlertNotificationsArgs

Defines whether to send email notifications about new security alerts

emails str

List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.

notifications_by_role SecurityContactPropertiesNotificationsByRoleArgs

Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.

phone str

The security contact's phone number

security_contact_name str

Name of the security contact object

alertNotifications Property Map

Defines whether to send email notifications about new security alerts

emails String

List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.

notificationsByRole Property Map

Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.

phone String

The security contact's phone number

securityContactName String

Name of the security contact object

Outputs

All input properties are implicitly available as output properties. Additionally, the SecurityContact resource produces the following output properties:

Id string

The provider-assigned unique ID for this managed resource.

Name string

Resource name

Type string

Resource type

Id string

The provider-assigned unique ID for this managed resource.

Name string

Resource name

Type string

Resource type

id String

The provider-assigned unique ID for this managed resource.

name String

Resource name

type String

Resource type

id string

The provider-assigned unique ID for this managed resource.

name string

Resource name

type string

Resource type

id str

The provider-assigned unique ID for this managed resource.

name str

Resource name

type str

Resource type

id String

The provider-assigned unique ID for this managed resource.

name String

Resource name

type String

Resource type

Supporting Types

MinimalSeverity

High
High

Get notifications on new alerts with High severity

Medium
Medium

Get notifications on new alerts with medium or high severity

Low
Low

Don't get notifications on new alerts with low, medium or high severity

MinimalSeverityHigh
High

Get notifications on new alerts with High severity

MinimalSeverityMedium
Medium

Get notifications on new alerts with medium or high severity

MinimalSeverityLow
Low

Don't get notifications on new alerts with low, medium or high severity

High
High

Get notifications on new alerts with High severity

Medium
Medium

Get notifications on new alerts with medium or high severity

Low
Low

Don't get notifications on new alerts with low, medium or high severity

High
High

Get notifications on new alerts with High severity

Medium
Medium

Get notifications on new alerts with medium or high severity

Low
Low

Don't get notifications on new alerts with low, medium or high severity

HIGH
High

Get notifications on new alerts with High severity

MEDIUM
Medium

Get notifications on new alerts with medium or high severity

LOW
Low

Don't get notifications on new alerts with low, medium or high severity

"High"
High

Get notifications on new alerts with High severity

"Medium"
Medium

Get notifications on new alerts with medium or high severity

"Low"
Low

Don't get notifications on new alerts with low, medium or high severity

Roles

AccountAdmin
AccountAdmin

If enabled, send notification on new alerts to the account admins

ServiceAdmin
ServiceAdmin

If enabled, send notification on new alerts to the service admins

Owner
Owner

If enabled, send notification on new alerts to the subscription owners

Contributor
Contributor

If enabled, send notification on new alerts to the subscription contributors

RolesAccountAdmin
AccountAdmin

If enabled, send notification on new alerts to the account admins

RolesServiceAdmin
ServiceAdmin

If enabled, send notification on new alerts to the service admins

RolesOwner
Owner

If enabled, send notification on new alerts to the subscription owners

RolesContributor
Contributor

If enabled, send notification on new alerts to the subscription contributors

AccountAdmin
AccountAdmin

If enabled, send notification on new alerts to the account admins

ServiceAdmin
ServiceAdmin

If enabled, send notification on new alerts to the service admins

Owner
Owner

If enabled, send notification on new alerts to the subscription owners

Contributor
Contributor

If enabled, send notification on new alerts to the subscription contributors

AccountAdmin
AccountAdmin

If enabled, send notification on new alerts to the account admins

ServiceAdmin
ServiceAdmin

If enabled, send notification on new alerts to the service admins

Owner
Owner

If enabled, send notification on new alerts to the subscription owners

Contributor
Contributor

If enabled, send notification on new alerts to the subscription contributors

ACCOUNT_ADMIN
AccountAdmin

If enabled, send notification on new alerts to the account admins

SERVICE_ADMIN
ServiceAdmin

If enabled, send notification on new alerts to the service admins

OWNER
Owner

If enabled, send notification on new alerts to the subscription owners

CONTRIBUTOR
Contributor

If enabled, send notification on new alerts to the subscription contributors

"AccountAdmin"
AccountAdmin

If enabled, send notification on new alerts to the account admins

"ServiceAdmin"
ServiceAdmin

If enabled, send notification on new alerts to the service admins

"Owner"
Owner

If enabled, send notification on new alerts to the subscription owners

"Contributor"
Contributor

If enabled, send notification on new alerts to the subscription contributors

SecurityContactPropertiesAlertNotifications

MinimalSeverity string | Pulumi.AzureNative.Security.MinimalSeverity

Defines the minimal alert severity which will be sent as email notifications

State string | Pulumi.AzureNative.Security.State

Defines if email notifications will be sent about new security alerts

MinimalSeverity string | MinimalSeverity

Defines the minimal alert severity which will be sent as email notifications

State string | State

Defines if email notifications will be sent about new security alerts

minimalSeverity String | MinimalSeverity

Defines the minimal alert severity which will be sent as email notifications

state String | State

Defines if email notifications will be sent about new security alerts

minimalSeverity string | MinimalSeverity

Defines the minimal alert severity which will be sent as email notifications

state string | State

Defines if email notifications will be sent about new security alerts

minimal_severity str | MinimalSeverity

Defines the minimal alert severity which will be sent as email notifications

state str | State

Defines if email notifications will be sent about new security alerts

minimalSeverity String | "High" | "Medium" | "Low"

Defines the minimal alert severity which will be sent as email notifications

state String | "On" | "Off"

Defines if email notifications will be sent about new security alerts

SecurityContactPropertiesNotificationsByRole

Roles List<Union<string, Pulumi.AzureNative.Security.Roles>>

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

State string | Pulumi.AzureNative.Security.State

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

Roles []string

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

State string | State

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<Either<String,Roles>>

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state String | State

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles (string | Roles)[]

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state string | State

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles Sequence[Union[str, Roles]]

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state str | State

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<String | "AccountAdmin" | "ServiceAdmin" | "Owner" | "Contributor">

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state String | "On" | "Off"

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

SecurityContactPropertiesResponseAlertNotifications

MinimalSeverity string

Defines the minimal alert severity which will be sent as email notifications

State string

Defines if email notifications will be sent about new security alerts

MinimalSeverity string

Defines the minimal alert severity which will be sent as email notifications

State string

Defines if email notifications will be sent about new security alerts

minimalSeverity String

Defines the minimal alert severity which will be sent as email notifications

state String

Defines if email notifications will be sent about new security alerts

minimalSeverity string

Defines the minimal alert severity which will be sent as email notifications

state string

Defines if email notifications will be sent about new security alerts

minimal_severity str

Defines the minimal alert severity which will be sent as email notifications

state str

Defines if email notifications will be sent about new security alerts

minimalSeverity String

Defines the minimal alert severity which will be sent as email notifications

state String

Defines if email notifications will be sent about new security alerts

SecurityContactPropertiesResponseNotificationsByRole

Roles List<string>

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

State string

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

Roles []string

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

State string

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<String>

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state String

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles string[]

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state string

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles Sequence[str]

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state str

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<String>

Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:

state String

Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

State

On
On

Send notification on new alerts to the subscription's admins

Off
Off

Don't send notification on new alerts to the subscription's admins

StateOn
On

Send notification on new alerts to the subscription's admins

StateOff
Off

Don't send notification on new alerts to the subscription's admins

On
On

Send notification on new alerts to the subscription's admins

Off
Off

Don't send notification on new alerts to the subscription's admins

On
On

Send notification on new alerts to the subscription's admins

Off
Off

Don't send notification on new alerts to the subscription's admins

ON
On

Send notification on new alerts to the subscription's admins

OFF
Off

Don't send notification on new alerts to the subscription's admins

"On"
On

Send notification on new alerts to the subscription's admins

"Off"
Off

Don't send notification on new alerts to the subscription's admins

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:security:SecurityContact default /subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default 

Package Details

Repository
Azure Native pulumi/pulumi-azure-native
License
Apache-2.0