Добавление настраиваемых проверенных доменов электронной почты

Предварительные условия

• Учетная запись Azure с активной подпиской. Дополнительные сведения см. в статье "Создание учетной записи".
• Созданный и готовый к добавлению доменов ресурс электронной почты Службы коммуникации Azure. См. статью "Создание ресурсов службы коммуникации электронной почты и управление ими".

Подготовка личного домена

Чтобы подготовить личный домен, необходимо выполнить следующие действия.

• Проверьте владение личным доменом, добавив запись TXT в систему доменных имен (DNS).
• Настройте проверку подлинности отправителя, добавив записи Sender Policy Framework (SPF) и DomainKeys Identified Mail (DKIM).

Проверка личного домена

В этом разделе описано, как проверить владение личным доменом, добавив запись TXT в DNS.

1. Откройте страницу "Обзор" ресурса службы коммуникации электронной почты, созданного в разделе "Создание ресурсов службы коммуникации электронной почты" и управление ими.

2. Создайте личный домен с помощью одного из следующих параметров.

   • (Вариант 1) Нажмите кнопку Настройка в разделе Настройка личного домена. Перейдите к шагу 3.

     

   • (Вариант 2) Щелкните Подготовка доменов на панели навигации слева.

     

   • Нажмите Добавить домен в верхней панели навигации.

   • Выберите Личный домен в раскрывающемся списке.

3. Нажмите кнопку "Добавить личный домен".

4. Введите доменное имя в текстовом поле.

5. Повторно введите доменное имя в следующем текстовом поле.

6. Нажмите кнопку Подтвердить.

   

7. Убедитесь, что введено правильное доменное имя, и оба текстовых поля одинаковы. При необходимости нажмите кнопку "Изменить ", чтобы исправить доменное имя перед подтверждением.

8. Нажмите кнопку Добавить.

   

9. Службы коммуникации Azure создают пользовательскую конфигурацию домена для вашего домена.

   

10. Чтобы проверить владение доменом, нажмите кнопку "Проверить домен".

    .

11. Чтобы возобновить проверку позже, нажмите кнопку "Закрыть " и возобновить работу. Затем, чтобы продолжить проверку с использованием доменов Provision, нажмите Настроить.

    

12. Если выбрать "Проверить домен" или "Настроить", откроется диалоговое окно "Проверить домен с помощью записи TXT".

    

13. Добавьте предыдущую запись TXT в регистратор домена или поставщик услуг размещения DNS. Обратитесь к разделу записей TXT, чтобы узнать, как добавить запись TXT для вашего поставщика DNS.

    После завершения этого шага нажмите кнопку "Далее".

14. Убедитесь, что запись TXT была успешно создана в DNS, а затем нажмите кнопку "Готово".

15. Для изменения DNS требуется 15–30 минут. Нажмите кнопку Закрыть.

    

16. После проверки домена вы можете добавить записи SPF и DKIM для проверки подлинности доменов.

    

Настройка проверки подлинности отправителя для личного домена

Чтобы настроить проверку подлинности отправителя для доменов, необходимо добавить дополнительные записи службы доменных имен (DNS). В этом разделе описывается, как службы Azure Communication Services предоставляют записи для добавления в ваш DNS. Однако в зависимости от того, является ли домен, который вы регистрируете, является корневым доменом или поддоменом, необходимо добавить записи в соответствующую зону или внести изменения в автоматически созданные записи.

В этом разделе показано, как добавить записи SPF и DKIM для sales.us.notification.azurecommtest.net личного домена. В следующих примерах описаны четыре различных метода добавления этих записей в DNS в зависимости от уровня зоны, в которой вы добавляете записи.

1. Зона: sales.us.notification.azurecommtest.net

Записи, созданные на портале, предполагают, что вы добавляете эти записи в DNS в этой зоне sales.us.notification.azurecommtest.net.

2. Зона: us.notification.azurecommtest.net

3. Зона: notification.azurecommtest.net

4. Зона: azurecommtest.net

Добавление записей SPF и DKIM

В этом разделе вы настраиваете аутентификацию отправителя, добавляя записи Sender Policy Framework (SPF) и DomainKeys Identified Mail (DKIM).

1. Откройте домены предоставления и убедитесь, что статус домена находится в состоянии Verified.

2. Чтобы добавить сведения о SPF и DKIM, нажмите кнопку "Настроить".

3. Добавьте следующую запись TXT и записи CNAME к регистратору домена или поставщику размещения DNS. Чтобы получить дополнительную информацию о добавлении записей TXT и CNAME для вашего провайдера DNS, подробности смотрите в таблице о добавлении записей DNS у популярных регистраторов доменов.

   

4. После добавления сведений TXT и CNAME нажмите кнопку "Далее ", чтобы продолжить.

5. Убедитесь, что записи TXT и CNAME успешно созданы в DNS. Затем нажмите кнопку Готово.

   

6. Изменения DNS вступают в силу в течение 15–30 минут. Нажмите кнопку "Закрыть" и дождитесь завершения проверки.

   

7. Проверьте статус проверки на странице предоставления доменов.

   

8. После проверки конфигураций проверки подлинности отправителя домен электронной почты готов к отправке сообщений электронной почты с помощью личного домена.

   

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Установите Azure CLI.
• Создайте службу обмена сообщениями электронной почты.

Подготовка личного домена

Чтобы подготовить личный домен, необходимо выполнить следующие действия.

• Проверьте владение личным доменом, добавив запись TXT в систему доменных имен (DNS).
• Настройте проверку подлинности отправителя, добавив записи Фреймворк политики отправителя (SPF) и DomainKeys Identified Mail (DKIM).

Создание ресурса домена

Чтобы создать ресурс домена, войдите в Azure CLI. Войдите, выполнив az login команду из терминала и предоставив учетные данные. Чтобы создать ресурс, выполните следующую команду:

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

Если вы хотите выбрать определенную подписку, можно также указать параметр --subscription и идентификатор подписки.

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

Вы можете настроить ресурс домена с помощью следующих параметров:

• Группа ресурсов
• Имя ресурса служб коммуникации электронной почты.
• География, связанная с ресурсом.
• Имя ресурса домена.
• Значение свойства управления доменами.
  • Для пользовательских доменов значение должно быть CustomerManaged.

На следующем шаге можно назначить теги или обновить отслеживание взаимодействия пользователей для ресурса домена. Теги можно использовать для упорядочивания ресурсов домена. Для получения дополнительной информации о тегах см. документацию по присвоению тегов ресурсам.

Управление ресурсом домена

Чтобы добавить теги или обновить отслеживание взаимодействия пользователей в ресурс домена, выполните следующие команды. Вы также можете нацеливаться на конкретную подписку.

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>"

Чтобы получить список всех ресурсов домена в данной службе коммуникации электронной почты, используйте следующую команду:

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

Чтобы отобразить все сведения о заданном ресурсе домена, выполните следующую команду:

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

Операция проверки ресурса домена

Сведения о настройке проверки подлинности отправителя для доменов см. в разделе "Настройка проверки подлинности отправителя для личного домена " на вкладке портала Azure.

Инициирование проверки

Чтобы инициировать проверку домена, выполните следующую команду:

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

Отмена проверки

Чтобы отменить проверку домена, выполните следующую команду:

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

Очистка ресурса домена

Если вы хотите очистить и удалить ресурс домена, можно удалить, выполнив следующую команду.

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

Дополнительные сведения о других командах см. в статье "Интерфейс командной строки домена".

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Последняя версия пакета SDK для .NET Core для вашей операционной системы.
• Получите последнюю версию пакета SDK для .NET Identity.
• Получите последнюю версию пакета SDK управления .NET.

Подготовка личного домена

Чтобы подготовить личный домен, необходимо выполнить следующие действия.

• Проверьте владение личным доменом, добавив запись TXT в систему доменных имен (DNS).
• Настройте проверку подлинности отправителя, добавив записи Sender Policy Framework (SPF) и DomainKeys Identified Mail (DKIM).

Установка пакета SDK

Во-первых, добавьте пакет SDK для управления Служб коммуникации в проект C#:

using Azure.ResourceManager.Communication;

Идентификатор подписки

Необходимо знать идентификатор подписки Azure. Идентификатор можно получить на портале:

1. Войдите в учетную запись Azure.
2. Выберите подписки на левой боковой панели.
3. Выберите нужную подписку.
4. Нажмите кнопку "Обзор".
5. Выберите идентификатор подписки.

В этом примере предполагается, что идентификатор подписки хранится в переменной окружения, называемой AZURE_SUBSCRIPTION_ID.

Проверка подлинности

Чтобы взаимодействовать с ресурсом домена, необходимо сначала пройти проверку подлинности в Azure.

Проверка подлинности клиента

По умолчанию для создания аутентифицированного клиента используется DefaultAzureCredential. Так как все API управления проходят через одну конечную точку, чтобы взаимодействовать с ресурсами, необходимо создать только один верхний уровень ArmClient.

Чтобы выполнить проверку подлинности в Azure и создать ArmClient, выполните следующий код:

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://learn.microsoft.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Взаимодействие с ресурсами Azure

Для каждого из следующих примеров мы назначаем ресурсы домена существующей службе обмена сообщениями электронной почты.

Если вам нужно создать службу коммуникации по электронной почте, используйте портал Azure.

Создание ресурса домена

При создании ресурса домена укажите имя группы ресурсов, имя службы обмена сообщениями электронной почты, имя ресурса и ДоменМанажмент.

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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}");

Управление ресурсами домена

Обновление ресурса домена

...
// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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}");

Список по почтовому сервису

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Получение ресурса домена

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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}");

Операция проверки ресурса вашего домена

Сведения о настройке проверки подлинности отправителя для доменов см. в разделе "Настройка проверки подлинности отправителя для личного домена " на вкладке портала Azure.

Инициирование проверки

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Отмена проверки

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Очистка ресурса домена

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Установите модуль Azure Az PowerShell.
• Создайте службу обмена сообщениями электронной почты.

Подготовка личного домена

Чтобы подготовить личный домен, необходимо выполнить следующие действия.

• Проверьте владение личным доменом, добавив запись TXT в систему доменных имен (DNS).
• Настройте проверку подлинности отправителя, добавив записи SPF (Sender Policy Framework) и DKIM (DomainKeys Identified Mail).

Создание ресурса домена

Чтобы создать ресурс домена, войдите в учетную запись Azure с помощью Connect-AzAccount следующей команды и укажите свои учетные данные.

PS C:\> Connect-AzAccount

Сначала установите модуль Az.Communication Службы коммуникации Azure с помощью следующей команды.

PS C:\> Install-Module Az.Communication

Выполните следующую команду, чтобы создать ресурс личного управляемого домена:

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

Вы можете настроить ресурс домена с помощью следующих параметров:

• Группа ресурсов
• Имя ресурса служб коммуникации электронной почты.
• Имя ресурса домена.
• Значение свойства управления доменами.
  • Для пользовательских доменов значение должно быть CustomerManaged.

На следующем шаге назначьте теги или обновите отслеживание взаимодействия пользователей для ресурса домена. Теги можно использовать для упорядочивания ресурсов домена. Дополнительные сведения о тегах см. в документации по тегам ресурсов.

Управление ресурсом домена

Чтобы добавить теги или обновить отслеживание взаимодействия пользователей в ресурс домена, выполните следующие команды. Вы также можете нацеливаться на конкретную подписку.

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

Чтобы получить список всех ресурсов домена в данной службе коммуникации электронной почты, используйте следующую команду:

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

Чтобы получить список всех сведений о заданном ресурсе домена, используйте следующую команду:

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

Операция проверки для ресурса вашего домена

Чтобы настроить проверку подлинности отправителя для доменов, перейдите к разделу "Настройка проверки подлинности отправителя для личного домена" на вкладке портал Azure.

Инициирование проверки

Чтобы вызвать проверку домена, выполните следующую команду:

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

Отмена проверки

Чтобы остановить проверку домена, выполните следующую команду:

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

Очистка ресурса домена

Если вы хотите очистить и удалить ресурс домена, можно удалить ресурс домена, выполнив следующую команду:

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