빠른 시작: 확인된 메일 도메인을 연결하는 방법

아티클
10/17/2024

이 빠른 시작에서는 Azure Communication Services에서 확인된 도메인을 연결하여 이메일을 보내는 방법을 설명합니다.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
도메인을 프로비전할 준비가 된 Azure Email Communication Services 리소스. 이메일 통신 리소스 만들기 시작
프로비전되고 이메일을 보낼 준비가 된 Azure Managed Domain 또는 사용자 지정 도메인. 이 도메인은 Communication Service 리소스에 연결하기 전에 완전히 확인해야 합니다.
Azure Communication Services 리소스. Communication Services 리소스를 만듭니다.

이메일 도메인을 통신 서비스 리소스에 연결

Azure Communication Service 리소스 개요 페이지의 이메일 아래 왼쪽 탐색 패널에서 도메인을 클릭합니다.
다음 옵션 중 하나를 선택합니다.
- 위쪽 탐색 모음에서 연결 도메인을 클릭합니다.
- 시작 화면에서 연결 도메인을 클릭합니다.
필터링하여 확인된 도메인 중 하나를 선택합니다.
- 구독
- 리소스 그룹
- 전자 메일 서비스
- 확인된 도메인

참고 항목

동일한 지역에 있는 도메인만 연결할 수 있습니다. 리소스를 만드는 동안 선택한 통신 리소스 및 전자 메일 통신 리소스의 데이터 위치가 동일한 지역에 있는지 확인하세요.

연결을 클릭합니다.

참고 항목

고객은 최대 100개의 사용자 지정 도메인을 단일 통신 서비스 리소스에 연결할 수 있습니다. 이러한 사용자 지정 도메인에 구성된 모든 메일 원본 주소는 통신 서비스 리소스에 액세스할 수 있습니다. 확인된 사용자 지정 도메인만 연결할 수 있습니다.

Communication Service Resource에서 이메일 도메인 연결 끊기

Azure Communication Services 리소스 개요 페이지의 왼쪽 탐색 패널에서 전자 메일 아래의 도메인을 클릭합니다.
연결된 도메인을 선택한 다음 ... 를 클릭하고 연결 끊기를 선택합니다.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
도메인을 프로비전할 준비가 된 Azure Email Communication Services 리소스. 이메일 통신 리소스 만들기 시작
프로비전되고 이메일을 보낼 준비가 된 Azure Managed Domain 또는 사용자 지정 도메인. 이 도메인은 Communication Service 리소스에 연결하기 전에 완전히 확인해야 합니다.
Azure Communication Services 리소스. Communication Services 리소스를 만듭니다.

이메일 도메인을 통신 서비스 리소스에 연결

샘플 요청에서 {subscription-id}, {resource-group-name}, {communication-services-resource-name} 및 {linked-domain-resource-id}을 바꿉니다.

다음과 같이 연결된 도메인 리소스 ID의 서식을 지정합니다.

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

Azure Managed Domain domain-name 을 사용하는 경우 "AzureManagedDomain"입니다. email-service-name은 도메인을 프로비전하는 데 사용한 것과 동일한 이메일 서비스여야 합니다.

이러한 값이 채워지면 다음 요청 URL 및 본문을 사용하여 PATCH 요청을 수행합니다.

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

Communication Service Resource에서 이메일 도메인 연결 끊기

샘플 요청에서 {subscription-id}, {resource-group-name} 및 {communication-services-resource-name}을 바꿉니다.

이러한 값이 채워지면 다음 요청 URL 및 본문을 사용하여 PATCH 요청을 수행합니다.

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 Email Communication Services 리소스. 이메일 통신 리소스 만들기 시작
프로비전되고 이메일을 보낼 준비가 된 Azure Managed Domain 또는 사용자 지정 도메인. 이 도메인은 Communication Service 리소스에 연결하기 전에 완전히 확인해야 합니다.
Azure Communication Services 리소스. Communication Services 리소스를 만듭니다.
우리는 인증을 위해 서비스 주체를 사용하고 있습니다. Microsoft Entra 애플리케이션의 클라이언트 ID, 테넌트 ID 및 클라이언트 비밀 값을 다음 환경 변수AZURE_CLIENT_IDAZURE_TENANT_IDAZURE_CLIENT_SECRET로 설정합니다.

필요한 패키지 설치

dotnet add package Azure.ResourceManager.Communication

관리 클라이언트 초기화

도메인 및 이메일 리소스가 있는 구독의 구독 ID로 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>을 바꿉니다.

다음과 같이 연결된 도메인 리소스 ID의 서식을 지정합니다.

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

Azure Managed Domain domain-name 을 사용하는 경우 "AzureManagedDomain"입니다. 도메인 email-service-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);

Communication Service Resource에서 이메일 도메인 연결 끊기

샘플 코드에서 <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 Email Communication Services 리소스. 이메일 통신 리소스 만들기 시작
프로비전되고 이메일을 보낼 준비가 된 Azure Managed Domain 또는 사용자 지정 도메인. 이 도메인은 Communication Service 리소스에 연결하기 전에 완전히 확인해야 합니다.
Azure Communication Services 리소스. Communication Services 리소스를 만듭니다.
우리는 인증을 위해 서비스 주체를 사용하고 있습니다. Microsoft Entra 애플리케이션의 클라이언트 ID, 테넌트 ID 및 클라이언트 비밀 값을 다음 환경 변수AZURE_CLIENT_IDAZURE_TENANT_IDAZURE_CLIENT_SECRET로 설정합니다.

필요한 패키지 설치

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

관리 클라이언트 초기화

샘플 코드의 필드를 도메인 및 이메일 리소스가 있는 구독의 구독 ID로 바꿉니다. 코드 샘플을 실행하여 관리 클라이언트를 초기화합니다.

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>을 바꿉니다.

다음과 같이 연결된 도메인 리소스 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
);

Communication Service Resource에서 이메일 도메인 연결 끊기

샘플 코드에서 <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 Email Communication Services 리소스. 이메일 통신 리소스 만들기 시작
프로비전되고 이메일을 보낼 준비가 된 Azure Managed Domain 또는 사용자 지정 도메인. 이 도메인은 Communication Service 리소스에 연결하기 전에 완전히 확인해야 합니다.
Azure Communication Services 리소스. Communication Services 리소스를 만듭니다.
우리는 인증을 위해 서비스 주체를 사용하고 있습니다. Microsoft Entra 애플리케이션의 클라이언트 ID, 테넌트 ID 및 클라이언트 암호 값을 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>

관리 클라이언트 초기화

도메인 및 이메일 리소스가 있는 구독의 구독 ID로 AZURE_SUBSCRIPTION_ID 환경 변수를 설정합니다. 코드 샘플을 실행하여 관리 클라이언트를 초기화합니다.

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>을 바꿉니다.

연결된 도메인 리소스 ID는 다음 형식이어야 합니다.

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

Azure Managed Domain을 사용하는 경우 domain-name은 "AzureManagedDomain"입니다. email-service-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();

Communication Service Resource에서 이메일 도메인 연결 끊기

샘플 코드에서 <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 Email Communication Services 리소스. 이메일 통신 리소스 만들기 시작
프로비전되고 이메일을 보낼 준비가 된 Azure Managed Domain 또는 사용자 지정 도메인. 이 도메인은 Communication Service 리소스에 연결하기 전에 완전히 확인해야 합니다.
Azure Communication Services 리소스. Communication Services 리소스를 만듭니다.
우리는 인증을 위해 서비스 주체를 사용하고 있습니다. Microsoft Entra 애플리케이션의 클라이언트 ID, 테넌트 ID 및 클라이언트 암호 값을 AZURE_CLIENT_ID, AZURE_TENANT_ID 및 AZURE_CLIENT_SECRET 환경 변수로 설정합니다.

필요한 패키지 설치

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

관리 클라이언트 초기화

샘플 코드의 필드를 도메인 및 이메일 리소스가 있는 구독의 구독 ID로 바꿉니다. 코드 샘플을 실행하여 관리 클라이언트를 초기화합니다.

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>을 바꿉니다.

연결된 도메인 리소스 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()

Communication Service Resource에서 이메일 도메인 연결 끊기

샘플 코드에서 <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()

다음 단계

이메일 클라이언트 라이브러리 숙지

다음을 통해 공유

빠른 시작: 확인된 메일 도메인을 연결하는 방법

필수 조건

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

다음 단계

피드백

추가 리소스

다음을 통해 공유

빠른 시작: 확인된 메일 도메인을 연결하는 방법

필수 조건

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

필수 조건

필요한 패키지 설치

관리 클라이언트 초기화

이메일 도메인을 통신 서비스 리소스에 연결

Communication Service Resource에서 이메일 도메인 연결 끊기

다음 단계

관련된 문서

피드백

추가 리소스