Краткое руководство. Подключение проверенного домена электронной почты

Статья
10/18/2023

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

Необходимые компоненты

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно..
Ресурс служб коммуникации Azure, готовый к подготовке доменов. Приступая к созданию ресурса связи с электронной почтой.
Управляемый домен Azure или личный домен , подготовленный и готовый для отправки сообщений электронной почты. Этот домен должен быть полностью проверен перед попыткой связать его с ресурсом службы коммуникации.
Ресурс Службы коммуникации Azure. Создание ресурсов служб коммуникации.

Подключение домена электронной почты к ресурсу службы коммуникации

На странице обзора ресурсов Службы коммуникации Azure в области навигации слева в разделе "Электронная почта" щелкните "Домены".
Выберите один из следующих параметров.
- В верхней панели навигации щелкните "Подключить домен".
- На экране-заставки нажмите кнопку "Подключить домен".
Выберите один из проверенных доменов, отфильтровав:
- Подписка
- Группа ресурсов
- Служба электронной почты
- Проверенный домен

Примечание.

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

Щелкните Подключить.

Примечание.

Мы разрешаем клиентам связывать до 100 пользовательских доменов с одним ресурсом службы коммуникации. Все адреса электронной почты, настроенные в этих пользовательских доменах, доступны для ресурса службы коммуникации. Вы можете связать только проверенные пользовательские домены.

Подключение домена электронной почты к ресурсу службы коммуникации

На странице обзора ресурсов Службы коммуникации Azure в области навигации слева в разделе "Электронная почта" щелкните "Домены".
Выберите подключенные домены, а затем нажмите кнопку ..., а затем нажмите кнопку "Отключить".

Необходимые компоненты

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
Ресурс служб коммуникации Azure, готовый к подготовке доменов. Приступая к созданию ресурса связи с электронной почтой.
Управляемый домен Azure или личный домен , подготовленный и готовый для отправки сообщений электронной почты. Этот домен должен быть полностью проверен перед попыткой связать его с ресурсом службы коммуникации.
Ресурс Службы коммуникации Azure. Создание ресурсов служб коммуникации.

Подключение домена электронной почты к ресурсу службы коммуникации

Замените {subscription-id}, {resource-group-name}{communication-services-resource-name}и {linked-domain-resource-id} в примере запроса.

Отформатируйте идентификатор ресурса связанного домена следующим образом:

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

Если вы используете управляемый домен Azure, domain-name это "AzureManagedDomain". Это email-service-name должна быть та же служба электронной почты, которую вы использовали для подготовки домена.

После заполнения этих значений сделайте запрос PATCH с помощью следующего URL-адреса запроса и текста.

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

Подключение домена электронной почты к ресурсу службы коммуникации

Замените {subscription-id}и {resource-group-name}{communication-services-resource-name} в примере запроса.

После заполнения этих значений сделайте запрос PATCH с помощью следующего URL-адреса запроса и текста.

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": []
    }
}

Необходимые компоненты

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
Ресурс служб коммуникации Azure, готовый к подготовке доменов. Приступая к созданию ресурса связи с электронной почтой.
Управляемый домен Azure или личный домен , подготовленный и готовый для отправки сообщений электронной почты. Этот домен должен быть полностью проверен перед попыткой связать его с ресурсом службы коммуникации.
Ресурс Службы коммуникации Azure. Создание ресурсов служб коммуникации.
Мы используем субъект-службу для проверки подлинности. Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения Microsoft Entra следующими переменными среды: AZURE_CLIENT_ID, AZURE_TENANT_IDи AZURE_CLIENT_SECRET.

Установка необходимых пакетов

dotnet add package Azure.ResourceManager.Communication

Инициализация клиента управления

Задайте переменную AZURE_SUBSCRIPTION_ID среды с идентификатором подписки, в которой находятся ресурсы домена и электронной почты. Запустите пример кода, чтобы инициализировать клиент управления.

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());

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <subscription-id>, <resource-group-name><azure-communication-services-resource-name>и <linked-domain-resource-id> в примере кода.

Отформатируйте идентификатор ресурса связанного домена следующим образом:

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

После заполнения этих значений запустите пример кода.

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);

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <subscription-id>и <resource-group-name><azure-communication-services-resource-name> в примере кода.

После заполнения этих значений запустите пример кода.

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);

Необходимые компоненты

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
Ресурс служб коммуникации Azure, готовый к подготовке доменов. Приступая к созданию ресурса связи с электронной почтой.
Управляемый домен Azure или личный домен , подготовленный и готовый для отправки сообщений электронной почты. Этот домен должен быть полностью проверен перед попыткой связать его с ресурсом службы коммуникации.
Ресурс Службы коммуникации Azure. Создание ресурсов служб коммуникации.
Мы используем субъект-службу для проверки подлинности. Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения Microsoft Entra следующими переменными среды: AZURE_CLIENT_ID, AZURE_TENANT_IDи AZURE_CLIENT_SECRET.

Установка необходимых пакетов

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

Инициализация клиента управления

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

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);

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <resource-group-name>и <azure-communication-services-resource-name><linked-domain-resource-id> в примере кода.

Отформатируйте идентификатор ресурса связанного домена следующим образом:

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

После заполнения этих значений запустите пример кода.

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
);

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <resource-group-name>код и <azure-communication-services-resource-name> в примере кода.

После заполнения этих значений запустите пример кода.

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

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

Необходимые компоненты

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно..
Ресурс служб коммуникации Azure, готовый к подготовке доменов. Приступая к созданию ресурса связи с электронной почтой.
Управляемый домен Azure или личный домен , подготовленный и готовый для отправки сообщений электронной почты. Этот домен должен быть полностью проверен перед попыткой связать его с ресурсом службы коммуникации.
Ресурс Службы коммуникации Azure. Создание ресурсов служб коммуникации.
Мы используем субъект-службу для проверки подлинности. Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения Microsoft Entra следующими переменными среды: AZURE_CLIENT_ID, AZURE_TENANT_IDи AZURE_CLIENT_SECRET.

Установка необходимых пакетов

Добавьте следующую зависимость в вашу pom.xml.

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

Инициализация клиента управления

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

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <resource-group-name>и <azure-communication-services-resource-name><linked-domain-resource-id> в примере кода.

Идентификатор ресурса связанного домена должен иметь следующий формат.

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

После заполнения этих значений запустите пример кода.

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();

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <resource-group-name>код и <azure-communication-services-resource-name> в примере кода.

После заполнения этих значений запустите пример кода.

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

Необходимые компоненты

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно..
Ресурс служб коммуникации Azure, готовый к подготовке доменов. Приступая к созданию ресурса связи с электронной почтой.
Управляемый домен Azure или личный домен , подготовленный и готовый для отправки сообщений электронной почты. Этот домен должен быть полностью проверен перед попыткой связать его с ресурсом службы коммуникации.
Ресурс Службы коммуникации Azure. Создание ресурсов служб коммуникации.
Мы используем субъект-службу для проверки подлинности. Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения Microsoft Entra следующими переменными среды: AZURE_CLIENT_ID, AZURE_TENANT_IDи AZURE_CLIENT_SECRET.

Установка необходимых пакетов

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

Инициализация клиента управления

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <resource-group-name>и <azure-communication-services-resource-name><linked-domain-resource-id> в примере кода.

Идентификатор ресурса связанного домена должен иметь следующий формат.

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

После заполнения этих значений запустите пример кода.


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()

Подключение домена электронной почты к ресурсу службы коммуникации

Замените <resource-group-name> <azure-communication-services-resource-name> и в примере кода.

После заполнения этих значений запустите пример кода.


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()

Следующие шаги

Сведения о клиентской библиотеке для электронной почты

Поделиться через

Краткое руководство. Подключение проверенного домена электронной почты

Необходимые компоненты

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Следующие шаги

Обратная связь

Дополнительные ресурсы

Поделиться через

Краткое руководство. Подключение проверенного домена электронной почты

Необходимые компоненты

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Необходимые компоненты

Установка необходимых пакетов

Инициализация клиента управления

Подключение домена электронной почты к ресурсу службы коммуникации

Подключение домена электронной почты к ресурсу службы коммуникации

Следующие шаги

Связанные статьи

Обратная связь

Дополнительные ресурсы