Início Rápido: Como conectar um domínio de email verificado
Neste início rápido, você vai aprender a conectar um domínio verificado nos Serviços de Comunicação do Azure para enviar emails.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente..
- Um Recurso dos Serviços de Comunicação por Email do Azure pronto para provisionar domínios. Comece a criar o Recurso de Comunicação por Email.
- Um Domínio Gerenciado do Azure ou um Domínio Personalizado provisionado e pronto para enviar emails. Esse domínio deve ser totalmente verificado antes de tentar vinculá-lo ao recurso do Serviço de Comunicação.
- Um Recurso dos Serviços de Comunicação do Azure. Crie um recurso dos Serviços de Comunicação.
Conectar um domínio de email a um Recurso do Serviço de Comunicação
Na página de visão geral do Recurso do Serviço de Comunicação do Azure, clique em Domínios no painel de navegação esquerdo em Email.
Selecionar uma das opções abaixo
Selecionar um dos domínios verificados por filtragem
- Subscription
- Grupo de recursos
- Serviço de Email
- Domínio Verificado
Observação
Permitimos apenas conectar os domínios na mesma geografia. Verifique se o local dos dados do Recurso de Comunicação e do Recurso de Comunicação de Email que foi selecionado durante a criação do recurso é o mesmo.
Desconectar um domínio de email de um Recurso do Serviço de Comunicação
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente..
- Um Recurso dos Serviços de Comunicação por Email do Azure pronto para provisionar domínios. Comece a criar o Recurso de Comunicação por Email.
- Um Domínio Gerenciado do Azure ou um Domínio Personalizado provisionado e pronto para enviar emails. Esse domínio deve ser totalmente verificado antes de tentar vinculá-lo ao recurso do Serviço de Comunicação.
- Um Recurso dos Serviços de Comunicação do Azure. Crie um recurso dos Serviços de Comunicação.
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.
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, faça uma solicitação PATCH para o 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 para o 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
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente..
- Um Recurso dos Serviços de Comunicação por Email do Azure pronto para provisionar domínios. Comece a criar o Recurso de Comunicação por Email.
- Um Domínio Gerenciado do Azure ou um Domínio Personalizado provisionado e pronto para enviar emails. Esse domínio deve ser totalmente verificado antes de tentar vinculá-lo ao recurso do Serviço de Comunicação.
- Um Recurso dos Serviços de Comunicação do Azure. Crie um recurso dos Serviços de Comunicação.
- Estamos usando uma entidade de serviço para a autenticação. Defina os valores do ID do cliente, ID do locatário e segredo do cliente do aplicativo Microsoft Entra como as seguintes variáveis de ambiente:
AZURE_CLIENT_ID
,AZURE_TENANT_ID
eAZURE_CLIENT_SECRET
.
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.
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.
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();
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente..
- Um Recurso dos Serviços de Comunicação por Email do Azure pronto para provisionar domínios. Comece a criar o Recurso de Comunicação por Email.
- Um Domínio Gerenciado do Azure ou um Domínio Personalizado provisionado e pronto para enviar emails. Esse domínio deve ser totalmente verificado antes de tentar vinculá-lo ao recurso do Serviço de Comunicação.
- Um Recurso dos Serviços de Comunicação do Azure. Crie um recurso dos Serviços de Comunicação.
- Estamos usando uma entidade de serviço para a autenticação. Defina os valores do ID do cliente, ID do locatário e segredo do cliente do aplicativo Microsoft Entra como as seguintes variáveis de ambiente:
AZURE_CLIENT_ID
,AZURE_TENANT_ID
eAZURE_CLIENT_SECRET
.
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.
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.
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
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente..
- Um Recurso dos Serviços de Comunicação por Email do Azure pronto para provisionar domínios. Comece a criar o Recurso de Comunicação por Email.
- Um Domínio Gerenciado do Azure ou um Domínio Personalizado provisionado e pronto para enviar emails. Esse domínio deve ser totalmente verificado antes de tentar vinculá-lo ao recurso do Serviço de Comunicação.
- Um Recurso dos Serviços de Comunicação do Azure. Crie um recurso dos Serviços de Comunicação.
- Estamos usando uma entidade de serviço para a autenticação. Defina os valores do ID do cliente, ID do locatário e segredo do cliente do aplicativo Microsoft Entra como as seguintes variáveis de ambiente:
AZURE_CLIENT_ID
,AZURE_TENANT_ID
eAZURE_CLIENT_SECRET
.
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
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente..
- Um Recurso dos Serviços de Comunicação por Email do Azure pronto para provisionar domínios. Comece a criar o Recurso de Comunicação por Email.
- Um Domínio Gerenciado do Azure ou um Domínio Personalizado provisionado e pronto para enviar emails. Esse domínio deve ser totalmente verificado antes de tentar vinculá-lo ao recurso do Serviço de Comunicação.
- Um Recurso dos Serviços de Comunicação do Azure. Crie um recurso dos Serviços de Comunicação.
- Estamos usando uma entidade de serviço para a autenticação. Defina os valores do ID do cliente, ID do locatário e segredo do cliente do aplicativo Microsoft Entra como as seguintes variáveis de ambiente:
AZURE_CLIENT_ID
,AZURE_TENANT_ID
eAZURE_CLIENT_SECRET
.
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
Artigos relacionados
- Familiarize-se com a biblioteca de clientes de email