Compartilhar via

Início Rápido: Como conectar um domínio de email verificado

  • Artigo

Este início rápido descreve como conectar um domínio verificado nos Serviços de Comunicação do Azure para enviar email.

Pré-requisitos

Conectar um domínio de email a um Recurso do Serviço de Comunicação

  1. Na página de visão geral do Recurso do Serviço de Comunicação do Azure, no painel de navegação esquerdo em Email, clique em Domínios.

    Captura de tela que mostra o painel de navegação esquerdo para vincular Domínios de Email.

  2. Selecione uma das opções a seguir:

    • Clique em Conectar domínio na barra de navegação superior.

    • Clique em Conectar domínio na tela inicial.

      Captura de tela que mostra como conectar um dos seus domínios de email verificados.

  3. Selecionar um dos domínios verificados por filtragem:

    • Assinatura
    • Grupo de Recursos
    • Serviço de Email
    • Domínio Verificado

    Captura de tela que mostra como filtrar e selecionar um dos domínios de email verificados para se conectar.

Observação

Você só pode conectar domínios na mesma geografia. Certifique-se de que o local de dados do Recurso de Comunicação e o Recurso de Comunicação por Email que você selecionou durante a criação do recurso estejam na mesma área geográfica.

  1. Clique em Conectar.

    Captura de tela mostrando que um dos domínios de email verificados agora está conectado.

Observação

Permitimos que os clientes vinculem até 100 domínios personalizados a um único recurso de serviço de comunicação. Todos os endereços Mail-From configurados nesses domínios personalizados são acessíveis para o recurso de serviço de comunicação. Você só pode vincular domínios personalizados verificados.

Desconectar um domínio de email de um Recurso do Serviço de Comunicação

  1. Na página de visão geral do Recurso dos Serviços de Comunicação do Azure, clique em Domínios no painel de navegação esquerdo em Email.

  2. Selecione os Domínios Conectados, clique em ... e selecione Desconectar.

    Captura de tela que mostra como desconectar o domínio conectado.

Pré-requisitos

Conectar um domínio de email a um Recurso do Serviço de Comunicação

Substitua {subscription-id}, {resource-group-name}, {communication-services-resource-name} e {linked-domain-resource-id} na solicitação de exemplo.

Formate a ID do recurso de domínio vinculado da seguinte maneira:

/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/emailServices/{email-service-name}/domains/{domain-name}

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name será "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de email que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, faça uma solicitação PATCH usando a URL e o corpo da solicitação a seguir.

https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/CommunicationServices/{communication-services-resource-name}?api-version=2023-03-31

{
    "properties": {
        "linkedDomains": ["{linked-domain-resource-id}"]
    }
}

Desconectar um domínio de email de um Recurso do Serviço de Comunicação

Substitua {subscription-id}, {resource-group-name} e {communication-services-resource-name} na solicitação de exemplo.

Depois que esses valores forem preenchidos, faça uma solicitação PATCH usando a URL e o corpo da solicitação a seguir.

https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/CommunicationServices/{communication-services-resource-name}?api-version=2023-03-31

{
    "properties": {
        "linkedDomains": []
    }
}

Pré-requisitos

Instalação dos pacotes necessários

dotnet add package Azure.ResourceManager.Communication

Inicializar o cliente de gerenciamento

Configure a variável de ambiente AZURE_SUBSCRIPTION_ID com a ID da assinatura em que o seu Domínio e seus recursos de Email estão incluídos. Execute a amostra de código para inicializar o cliente de gerenciamento.

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Compute;
using Azure.ResourceManager.Resources;

ArmClient client = new ArmClient(new DefaultAzureCredential());

Conectar um domínio de email a um Recurso do Serviço de Comunicação

Substitua <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name> e <linked-domain-resource-id> no código de exemplo.

Formate a ID do recurso de domínio vinculado da seguinte maneira:

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Se você estiver usando um Domínio Gerenciado do Azure, domain-name será "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de email que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.

ResourceIdentifier communicationServiceResourceId = CommunicationServiceResource.CreateResourceIdentifier("<subscription-id>", "<resource-group-name>", "<azure-communication-services-resource-name>");
CommunicationServiceResource communicationServiceResource = client.GetCommunicationServiceResource(communicationServiceResourceId);

CommunicationServiceResourcePatch patch = new CommunicationServiceResourcePatch()
{
    LinkedDomains =
    {
        "<linked-domain-resource-id>",
    },
};
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);

Desconectar um domínio de email de um Recurso do Serviço de Comunicação

Substitua <subscription-id>, <resource-group-name> e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.

ResourceIdentifier communicationServiceResourceId = CommunicationServiceResource.CreateResourceIdentifier("<subscription-id>", "<resource-group-name>", "<azure-communication-services-resource-name>");
CommunicationServiceResource communicationServiceResource = client.GetCommunicationServiceResource(communicationServiceResourceId);

CommunicationServiceResourcePatch patch = new CommunicationServiceResourcePatch();
patch.LinkedDomains.Clear();
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);

Pré-requisitos

Instalação dos pacotes necessários

npm install @azure/arm-communication
npm install @azure/identity

Inicializar o cliente de gerenciamento

Substitua o campo na amostra de código pela ID da assinatura em que o seu Domínio e seus recursos de Email estão incluídos. Execute a amostra de código para inicializar o cliente de gerenciamento.

const { CommunicationServiceManagementClient } = require("@azure/arm-communication");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();
const subscriptionId = "<your-subscription-id>";

client = new CommunicationServiceManagementClient(credential, subscriptionId);

Conectar um domínio de email a um Recurso do Serviço de Comunicação

Substitua <resource-group-name>, <azure-communication-services-resource-name> e <linked-domain-resource-id> no código de exemplo.

Formate a ID do recurso de domínio vinculado da seguinte maneira:

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name será "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de email que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.

const parameters = {
    dataLocation: "United States",
    location: "Global",
    linkedDomains: [
        "<linked-domain-resource-id>"
    ]
};

const result = await client.communicationServices.beginCreateOrUpdateAndWait(
    "<resource-group-name>",
    "<azure-communication-services-resource-name>",
    parameters
);

Desconectar um domínio de email de um Recurso do Serviço de Comunicação

Substitua <resource-group-name> e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.

const parameters = {
    dataLocation: "United States",
    location: "Global"
};

const result = await client.communicationServices.beginCreateOrUpdateAndWait(
    "<resource-group-name>",
    "<azure-communication-services-resource-name>",
    parameters
);

Pré-requisitos

Instalação dos pacotes necessários

Adicione a seguinte dependência ao seu pom.xml.

<dependency>
    <groupId>com.azure.resourcemanager</groupId>
    <artifactId>azure-resourcemanager-communication</artifactId>
    <version>2.0.0</version>
</dependency>

Inicializar o cliente de gerenciamento

Configure a variável de ambiente AZURE_SUBSCRIPTION_ID com a ID da assinatura em que o seu Domínio e seus recursos de Email estão incluídos. Execute a amostra de código para inicializar o cliente de gerenciamento.

AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
TokenCredential credential = new DefaultAzureCredentialBuilder()
    .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
    .build();
CommunicationManager manager = CommunicationManager
    .authenticate(credential, profile);

Conectar um domínio de email a um Recurso do Serviço de Comunicação

Substitua <resource-group-name>, <azure-communication-services-resource-name> e <linked-domain-resource-id> no código de exemplo.

A ID do recurso de domínio vinculado deve estar no formato a seguir.

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Se você estiver usando um Domínio Gerenciado do Azure, domain-name será "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de email que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.

List<String> linkedDomains = new ArrayList<>();
linkedDomains.add("<linked-domain-resource-id>") 

manager
    .communicationServices()
    .define("<azure-communication-services-resource-name>")
    .withRegion("Global")
    .withExistingResourceGroup("<resource-group-name>")
    .withDataLocation("United States")
    .withLinkedDomains(linkedDomains)
    .create();

Desconectar um domínio de email de um Recurso do Serviço de Comunicação

Substitua <resource-group-name> e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.

manager
    .communicationServices()
    .define("<azure-communication-services-resource-name>")
    .withRegion("Global")
    .withExistingResourceGroup("<resource-group-name>")
    .withDataLocation("United States")
    .create();

Pré-requisitos

Instalação dos pacotes necessários

pip install azure-mgmt-communication
pip install azure-identity

Inicializar o cliente de gerenciamento

Substitua o campo na amostra de código pela ID da assinatura em que o seu Domínio e seus recursos de Email estão incluídos. Execute a amostra de código para inicializar o cliente de gerenciamento.

from azure.mgmt.communication import CommunicationServiceManagementClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>"

client = CommunicationServiceManagementClient(credential, subscription_id)

Conectar um domínio de email a um Recurso do Serviço de Comunicação

Substitua <resource-group-name>, <azure-communication-services-resource-name> e <linked-domain-resource-id> no código de exemplo.

A ID do recurso de domínio vinculado deve estar no formato a seguir.

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Se você estiver usando um Domínio Gerenciado do Azure, domain-name será "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de email que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.


response = client.communication_services.begin_create_or_update(
    resource_group_name="<resource-group-name>",
    communication_service_name="<azure-communication-services-resource-name>",
    parameters={
        "location": "Global",
        "properties": {
            "dataLocation": "United States",
            "linkedDomains": [
                "<linked-domain-resource-id>"
            ],
        }
    },
).result()

Desconectar um domínio de email de um Recurso do Serviço de Comunicação

Substitua <resource-group-name> e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.


response = client.communication_services.begin_create_or_update(
    resource_group_name="<resource-group-name>",
    communication_service_name="<azure-communication-services-resource-name>",
    parameters={
        "location": "Global",
        "properties": {
            "dataLocation": "United States"
        }
    },
).result()

Próximas etapas