Inicio rápido: Adición de dominios de correo electrónico comprobados personalizados

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Consulte Crear una cuenta de forma gratuita.
• Un recurso de correo electrónico de Azure Communication Services creado y listo para agregar los dominios. Consulte Introducción a la creación de recursos de comunicación de correo electrónico.

Aprovisionamiento de un dominio personalizado

Para aprovisionar un dominio personalizado, deberá:

• Compruebe la propiedad del dominio personalizado agregando un registro TXT en el sistema de nombres de dominio (DNS).
• Configure la autenticación del remitente mediante la adición de registros de Marco de directivas de remitente (SPF) y DomainKeys Identified Mail (DKIM).

Implementación de un dominio personalizado

En esta sección, comprobará la propiedad del dominio personalizado agregando un registro TXT en el DNS.

1. Abra la página Información general del recurso de Email Communication Service que creó en Introducción a la creación de un recurso de comunicación de correo electrónico.

2. Cree un dominio personalizado con una de las siguientes opciones.

   • (Opción 1) Haga clic en el botón Configurar en Configurar un dominio personalizado. Continúe con el paso 3.

     

   • (Opción 2) Haga clic en Aprovisionar dominio en el panel de navegación izquierdo.

     

   • Haga clic en Agregar dominio en la barra de navegación superior.

   • Seleccione Dominio personalizado en la lista desplegable.

3. Haga clic en Agregar un dominio personalizado.

4. Escriba el nombre de dominio en el cuadro de texto.

5. Vuelva a escribir el nombre de dominio en el cuadro de texto siguiente.

6. Haga clic en Confirmar.

   

7. Asegúrese de que el nombre de dominio especificado es correcto y que ambos cuadros de texto son los mismos. Si es necesario, haga clic en Editar para corregir el nombre de dominio antes de confirmarlo.

8. Haga clic en Agregar.

   

9. Azure Communication Services crea una configuración de dominio personalizada para el dominio.

   

10. Para comprobar la propiedad del dominio, haga clic en Comprobar dominio.

    .

11. Para reanudar la comprobación más adelante, haga clic en Cerrar y reanudar. A continuación, para continuar la comprobación desde Dominios de aprovisionamiento, haga clic en Configurar.

    

12. Al seleccionar Comprobar dominio o Configurar, se abre el cuadro de diálogo Comprobar dominio a través del registro TXT.

    

13. Agregue el registro TXT anterior al registrador de su dominio o al proveedor de hospedaje DNS. Consulte la sección Registros TXT para obtener información sobre cómo agregar un registro TXT para su proveedor DNS.

    Una vez completado este paso, haga clic en Siguiente.

14. Compruebe que el registro TXT se creó correctamente en el DNS y, a continuación, haga clic en Listo.

15. Los cambios de DNS requieren entre 15 y 30 minutos para que surtan efecto. Haga clic en Cerrar.

    

16. Una vez comprobado el dominio, puede agregar los registros SPF y DKIM para autenticar los dominios.

    

Configuración de la autenticación del remitente para un dominio personalizado

Para configurar la autenticación del remitente para los dominios, debe agregar más registros del Sistema de nombres de dominio (DNS). En esta sección se describe cómo Azure Communication Services ofrece registros para agregarlos al DNS. Sin embargo, dependiendo de si el dominio que va a registrar es un dominio raíz o un subdominio, debe agregar los registros a la zona correspondiente o realizar cambios en los registros generados automáticamente.

En esta sección se muestra cómo agregar registros SPF y DKIM para el dominio personalizado sales.us.notification.azurecommtest.net. En los ejemplos siguientes se describen cuatro métodos diferentes para agregar estos registros al DNS, en función del nivel de la zona donde se agregan los registros.

1. Zona: sales.us.notification.azurecommtest.net

Los registros generados por el portal suponen que va a agregar estos registros al DNS en esta zona sales.us.notification.azurecommtest.net.

2. Zona: us.notification.azurecommtest.net

3. Zona: notification.azurecommtest.net

4. Zona: azurecommtest.net

Agregar registros SPF y DKIM

En esta sección, configurará la autenticación del remitente agregando registros del Marco de directivas de remitente (SPF) y DomainKeys Identified Mail (DKIM).

1. Abra Dominios de aprovisionamiento y confirme que el estado del dominio está en el estado Verified.

2. Para agregar información de SPF y DKIM, haga clic en Configurar.

3. Agregue el siguiente registro TXT y registros CNAME al registrador de su dominio o al proveedor de hospedaje DNS. Consulte la tabla de adición de registros DNS en registradores de dominio populares para obtener información sobre cómo agregar un registro CNAME y TXT para el proveedor DNS.

   

4. Cuando haya terminado de agregar información TXT y CNAME, haga clic en Siguiente para continuar.

5. Compruebe que los registros TXT y CNAME se crearon correctamente en el DNS. A continuación, haga clic en Hecho.

   

6. Los cambios de DNS tardarán en surtir efecto de 15 a 30 minutos. Haga clic en Cerrar y espere a que se complete la comprobación.

   

7. Compruebe el estado de comprobación en la página Dominios de aprovisionamiento.

   

8. Una vez que compruebe las configuraciones de autenticación del remitente, el dominio de correo electrónico está listo para enviar correos electrónicos mediante el dominio personalizado.

   

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Instalación de la CLI de Azure
• Cree un Email Communication Service.

Aprovisionamiento de un dominio personalizado

Para aprovisionar un dominio personalizado, deberá:

• Compruebe la propiedad del dominio personalizado agregando un registro TXT en el sistema de nombres de dominio (DNS).
• Configure la autenticación del remitente mediante la adición de registros de Marco de directivas de remitente (SPF) y DomainKeys Identified Mail (DKIM).

Creación de un recurso de dominio

Para crear un recurso de dominio, Inicie sesión en la CLI de Azure. Para iniciar sesión, ejecute el comando az login desde el terminal y proporcione sus credenciales. Para crear el recurso, ejecute el siguiente comando:

az communication email domain create --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management CustomerManaged

Si quiere seleccionar una suscripción específica, también puede especificar la marca --subscription y proporcionar el identificador de la suscripción.

az communication email domain create --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management CustomerManaged --subscription "<subscriptionId>"

Puede configurar el recurso de dominio con las siguientes opciones:

• El grupo de recursos
• El nombre del recurso de Email Communication Services.
• La geografía a la que se asociará el recurso.
• El nombre del recurso de dominio.
• Valor de la propiedad Administración de dominios.
  • Para dominios personalizados, el valor debe ser : CustomerManaged.

En el paso siguiente, puede asignar etiquetas o actualizar el seguimiento de involucración del usuario al recurso de dominio. Las etiquetas se pueden usar para organizar los recursos de dominio. Para más información sobre las etiquetas, consulte la documentación sobre las etiquetas de recursos.

Administración del recurso de dominio

Para agregar etiquetas o actualizar el seguimiento de involucración del usuario al recurso de dominio, ejecute los siguientes comandos. También puede usar una suscripción específica como destino.

az communication email domain update --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --user-engmnt-tracking Enabled

az communication email domain update --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --user-engmnt-tracking Disabled --subscription "<subscriptionId>"

Para enumerar todos los recursos de dominio en Email Communication Service determinado, use el siguiente comando:

az communication email domain list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Para mostrar toda la información de un recurso de dominio determinado, use el siguiente comando:

az communication email domain show --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Operación de comprobación para el recurso de dominio

Para configurar la autenticación de remitente para los dominios, consulte la sección Configuración de la autenticación del remitente para un dominio personalizado en la pestaña Azure Portal.

Iniciar comprobación

Para iniciar la comprobación del dominio, ejecute el siguiente comando:

az communication email domain initiate-verification --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --verification-type Domain

Cancelación de la comprobación

Para cancelar la comprobación del dominio, ejecute el siguiente comando:

az communication email domain cancel-verification --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --verification-type Domain

Limpieza de un recurso de dominio

Si desea limpiar y quitar un recurso de dominio, puede hacerlo ejecutando el siguiente comando.

az communication email domain delete --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Para obtener información sobre otros comandos, consulte CLI de dominio.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• La versión más reciente del SDK de .NET Core para su sistema operativo.
• Obtenga la versión más reciente del SDK de .NET Identity.
• Obtenga la versión más reciente del SDK de administración de .NET.

Aprovisionamiento de un dominio personalizado

Para aprovisionar un dominio personalizado, deberá:

• Compruebe la propiedad del dominio personalizado agregando un registro TXT en el sistema de nombres de dominio (DNS).
• Configure la autenticación del remitente mediante la adición de registros de Marco de directivas de remitente (SPF) y DomainKeys Identified Mail (DKIM).

Instalar el SDK

En primer lugar, incluya el SDK de administración de Communication Services en el proyecto de C#:

using Azure.ResourceManager.Communication;

Id. de suscripción

Deberá saber el identificador de su suscripción a Azure. Se puede adquirir en el portal:

1. Inicie sesión en la cuenta de Azure.
2. Seleccione Suscripciones en la barra lateral izquierda
3. Seleccione la suscripción que necesite.
4. Haga clic en Información general.
5. Seleccione el identificador de la suscripción.

En este inicio rápido, se supone que ha almacenado el identificador de la suscripción en una variable de entorno denominada AZURE_SUBSCRIPTION_ID.

Autenticación

Para comunicarse con el recurso de dominio, primero debe autenticarse en Azure.

Autenticar el cliente

La opción predeterminada para crear un cliente autenticado es usar DefaultAzureCredential. Dado que todas las API de administración pasan por el mismo punto de conexión, con el fin de interactuar con los recursos, solo se debe crear un ArmClient de nivel superior.

Para autenticarse en Azure y crear un ArmClient, haga lo siguiente:

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Resources;
...
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://video2.skills-academy.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Interacción con los recursos de Azure

Ahora ya está autenticado.

Para cada uno de los ejemplos siguientes, asignaremos nuestros recursos de dominio a un servicio de comunicación de Email.

Si necesita crear un Email Communication Service, puede hacerlo mediante Azure Portal.

Crear un recurso de dominio

Al crear un recurso de dominio, especificará el nombre del grupo de recursos, el nombre de Email Communication Service, el nombre del recurso y DomainManagement.

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation
string domainName = "contoso.com";
CommunicationDomainResourceData data = new CommunicationDomainResourceData(new AzureLocation("Global"))
{
    DomainManagement = DomainManagement.CustomerManaged,
};
ArmOperation<CommunicationDomainResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, domainName, data);            
CommunicationDomainResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
CommunicationDomainResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Administrar los recursos de dominio

Actualización de un recurso de dominio

...
// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
CommunicationDomainResourcePatch patch = new CommunicationDomainResourcePatch()
{
    UserEngagementTracking = UserEngagementTracking.Enabled,
};
ArmOperation<CommunicationDomainResource> lro = await communicationDomainResource.UpdateAsync(WaitUntil.Completed, patch);
CommunicationDomainResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
CommunicationDomainResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Enumerar por servicio de Email

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation and iterate over the result
await foreach (CommunicationDomainResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    CommunicationDomainResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Obtener recurso de dominio

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation
string domainName = "contoso.com";
bool result = await collection.ExistsAsync(domainName);

Console.WriteLine($"Succeeded: {result}");

Operación de comprobación para el recurso de dominio

Para configurar la autenticación de remitente para los dominios, consulte la sección Configuración de la autenticación del remitente para un dominio personalizado desde la pestaña Azure Portal.

Iniciar comprobación

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
DomainsRecordVerificationContent content = new DomainsRecordVerificationContent(DomainRecordVerificationType.Spf);
await communicationDomainResource.InitiateVerificationAsync(WaitUntil.Completed, content);

Console.WriteLine($"Succeeded");

Cancelación de la comprobación

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
DomainsRecordVerificationContent content = new DomainsRecordVerificationContent(DomainRecordVerificationType.Spf);
await communicationDomainResource.CancelVerificationAsync(WaitUntil.Completed, content);

Console.WriteLine($"Succeeded");

Limpieza de un recurso de dominio

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
await communicationDomainResource.DeleteAsync(WaitUntil.Completed);

Console.WriteLine($"Succeeded");

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Instale el módulo Azure Az PowerShell.
• Cree un Email Communication Service.

Aprovisionamiento de un dominio personalizado

Para aprovisionar un dominio personalizado, deberá:

• Compruebe la propiedad del dominio personalizado agregando un registro TXT en el sistema de nombres de dominio (DNS).
• Configure la autenticación del remitente mediante la adición de registros de Marco de directivas de remitente (SPF) y DomainKeys Identified Mail (DKIM).

Crear un recurso de dominio

Para crear un recurso de dominio, inicie sesión en su cuenta Azure mediante el comando Connect-AzAccount siguiente y proporcione sus credenciales.

PS C:\> Connect-AzAccount

En primer lugar, asegúrese de instalar el módulo Azure Communication Services Az.Communication con el siguiente comando.

PS C:\> Install-Module Az.Communication

Ejecute el siguiente comando para crear el recurso dominio administrado personalizado:

PS C:\> New-AzEmailServiceDomain -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -Name contoso.com -DomainManagement CustomerManaged

Puede configurar el recurso de dominio con las siguientes opciones:

• El grupo de recursos
• El nombre del recurso de Email Communication Services.
• El nombre del recurso de dominio.
• Valor de la propiedad Administración de dominios.
  • Para dominios personalizados, el valor debe ser "CustomerManaged".

En el paso siguiente, puede asignar etiquetas o actualizar el seguimiento de involucración del usuario al recurso de dominio. Las etiquetas se pueden usar para organizar los recursos de dominio. Para obtener más información sobre las etiquetas, consulte la documentación sobre las etiquetas de recursos.

Administración del recurso de dominio

Para agregar etiquetas o actualizar el seguimiento de involucración del usuario al recurso de dominio, ejecute los siguientes comandos. También puede usar una suscripción específica como destino.

PS C:\> Update-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -UserEngagementTracking 1

PS C:\> Update-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -UserEngagementTracking 0 -SubscriptionId SubscriptionID

Para enumerar todos los recursos de dominio en Email Communication Service determinado, use el siguiente comando:

PS C:\> Get-AzEmailServiceDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Para enumerar toda la información de un recurso de dominio determinado, use el siguiente comando:

PS C:\> Get-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Operación de comprobación para el recurso de dominio

Para configurar la autenticación de remitente para los dominios, consulte la sección Configuración de la autenticación del remitente para un dominio personalizado desde la pestaña Azure Portal.

Iniciar comprobación

Para invocar la comprobación del dominio, ejecute el siguiente comando:

PS C:\> Invoke-AzEmailServiceInitiateDomainVerification -DomainName contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -VerificationType Domain

Cancelación de la comprobación

Para detener la comprobación del dominio, ejecute el siguiente comando:

PS C:\> Stop-AzEmailServiceDomainVerification -DomainName contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -VerificationType Domain

Limpieza de un recurso de dominio

Si desea limpiar y quitar un recurso de dominio, puede eliminar su recurso de Dominio ejecutando el siguiente comando:

PS C:\> Remove-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1