Bagikan melalui


Mulai cepat: Cara menyambungkan domain email terverifikasi

Mulai cepat ini menjelaskan cara menyambungkan domain terverifikasi di Azure Communication Services untuk mengirim email.

Prasyarat

Menghubungkan domain email ke Sumber Daya Communication Service

  1. Di halaman gambaran umum Sumber Daya Azure Communication Service, di panel navigasi kiri di bawah Email, klik Domain.

    Cuplikan layar yang memperlihatkan panel navigasi kiri untuk menautkan Domain Email.

  2. pilih salah satu dari opsi berikut ini:

    • Dari bilah navigasi atas, klik Sambungkan domain.

    • Dari layar percikan, klik Sambungkan domain.

      Cuplikan layar yang memperlihatkan cara menyambungkan salah satu domain email terverifikasi Anda.

  3. Pilih salah satu domain terverifikasi dengan memfilter:

    • Langganan
    • Grup Sumber Daya
    • Layanan Email
    • Domain Terverifikasi

    Cuplikan layar yang memperlihatkan cara memfilter dan memilih salah satu domain email terverifikasi untuk disambungkan.

Catatan

Anda hanya dapat menyambungkan domain dalam geografi yang sama. Pastikan lokasi Data untuk Sumber Daya Komunikasi dan Sumber Daya Komunikasi Email yang Anda pilih selama pembuatan sumber daya berada dalam geografi yang sama.

  1. Klik Sambungkan.

    Cuplikan layar yang memperlihatkan salah satu domain email terverifikasi sekarang tersambung.

Catatan

Kami memungkinkan pelanggan untuk menautkan hingga 100 domain kustom ke satu sumber daya layanan komunikasi. Semua alamat Mail-From yang dikonfigurasi di bawah domain kustom ini dapat diakses untuk sumber daya layanan komunikasi. Anda hanya dapat menautkan domain kustom terverifikasi.

Putuskan sambungan domain email dari Sumber Daya Communication Service

  1. Di halaman gambaran umum Sumber Daya Azure Communication Services, dari panel navigasi kiri di bawah Email, klik Domain.

  2. Pilih Domain Tersambung, lalu klik ... dan pilih Putuskan Sambungan.

    Cuplikan layar yang memperlihatkan cara memutuskan sambungan domain yang tersambung.

Prasyarat

  • Akun Azure dengan langganan aktif. Buat akun secara gratis.
  • Sumber Daya Azure Email Communication Services siap menyediakan domain. Mulai membuat Sumber Daya Komunikasi Email.
  • Domain Terkelola Azure atau Domain Kustom disediakan dan siap untuk mengirim email. Domain ini harus sepenuhnya diverifikasi sebelum mencoba menautkannya ke sumber daya Communication Service.
  • Sumber daya Azure Communication Services. Membuat Sumber Daya Communication Services.

Menghubungkan domain email ke Sumber Daya Communication Service

{subscription-id}Ganti , , {resource-group-name}{communication-services-resource-name}, dan {linked-domain-resource-id} dalam permintaan sampel.

Format ID sumber daya domain tertaut sebagai berikut:

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

Jika Anda menggunakan Azure Managed Domain, domain-name itu adalah "AzureManagedDomain". email-service-name harus berupa layanan email yang sama dengan yang Anda gunakan untuk memprovisikan domain.

Setelah nilai-nilai ini diisi, buat permintaan PATCH menggunakan URL permintaan dan isi berikut.

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

Putuskan sambungan domain email dari Sumber Daya Communication Service

{subscription-id}Ganti , {resource-group-name}, dan {communication-services-resource-name} dalam permintaan sampel.

Setelah nilai-nilai ini diisi, buat permintaan PATCH menggunakan URL permintaan dan isi berikut.

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

Prasyarat

  • Akun Azure dengan langganan aktif. Buat akun secara gratis.
  • Sumber Daya Azure Email Communication Services siap menyediakan domain. Mulai membuat Sumber Daya Komunikasi Email.
  • Domain Terkelola Azure atau Domain Kustom disediakan dan siap untuk mengirim email. Domain ini harus sepenuhnya diverifikasi sebelum mencoba menautkannya ke sumber daya Communication Service.
  • Sumber daya Azure Communication Services. Membuat Sumber Daya Communication Services.
  • Kami menggunakan perwakilan layanan untuk autentikasi. Atur nilai ID klien, ID penyewa, dan rahasia klien aplikasi Microsoft Entra sebagai variabel lingkungan berikut: AZURE_CLIENT_ID, , AZURE_TENANT_IDdan AZURE_CLIENT_SECRET.

Menginstal paket yang diperlukan

dotnet add package Azure.ResourceManager.Communication

Menginisialisasi klien manajemen

Atur variabel AZURE_SUBSCRIPTION_ID lingkungan dengan ID langganan langganan tempat domain dan sumber daya Email Anda berada. Jalankan sampel kode untuk menginisialisasi klien manajemen.

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

Menghubungkan domain email ke Sumber Daya Communication Service

<subscription-id>Ganti , , <resource-group-name><azure-communication-services-resource-name>, dan <linked-domain-resource-id> dalam kode sampel.

Format ID sumber daya domain tertaut sebagai berikut:

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

Jika Anda menggunakan Azure Managed Domain, domain-name adalah "AzureManagedDomain." email-service-name harus berupa layanan email yang sama dengan yang Anda gunakan untuk memprovisikan domain.

Setelah nilai-nilai ini diisi, jalankan kode sampel.

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

Putuskan sambungan domain email dari Sumber Daya Communication Service

<subscription-id>Ganti , <resource-group-name>, dan <azure-communication-services-resource-name> dalam kode sampel.

Setelah nilai-nilai ini diisi, jalankan kode sampel.

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

Prasyarat

  • Akun Azure dengan langganan aktif. Buat akun secara gratis.
  • Sumber Daya Azure Email Communication Services siap menyediakan domain. Mulai membuat Sumber Daya Komunikasi Email.
  • Domain Terkelola Azure atau Domain Kustom disediakan dan siap untuk mengirim email. Domain ini harus sepenuhnya diverifikasi sebelum mencoba menautkannya ke sumber daya Communication Service.
  • Sumber daya Azure Communication Services. Membuat Sumber Daya Communication Services.
  • Kami menggunakan perwakilan layanan untuk autentikasi. Atur nilai ID klien, ID penyewa, dan rahasia klien aplikasi Microsoft Entra sebagai variabel lingkungan berikut: AZURE_CLIENT_ID, , AZURE_TENANT_IDdan AZURE_CLIENT_SECRET.

Menginstal paket yang diperlukan

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

Menginisialisasi klien manajemen

Ganti bidang dalam kode sampel dengan ID langganan langganan tempat domain dan sumber daya Email Anda berada. Jalankan sampel kode untuk menginisialisasi klien manajemen.

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

Menghubungkan domain email ke Sumber Daya Communication Service

<resource-group-name>Ganti , <azure-communication-services-resource-name>, dan <linked-domain-resource-id> dalam kode sampel.

Format ID sumber daya domain tertaut sebagai berikut:

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

Jika Anda menggunakan Azure Managed Domain, domain-name itu adalah "AzureManagedDomain". email-service-name harus berupa layanan email yang sama dengan yang Anda gunakan untuk memprovisikan domain.

Setelah nilai-nilai ini diisi, jalankan kode sampel.

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

Putuskan sambungan domain email dari Sumber Daya Communication Service

<resource-group-name>Ganti , dan <azure-communication-services-resource-name> dalam kode sampel.

Setelah nilai-nilai ini diisi, jalankan kode sampel.

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

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

Prasyarat

Menginstal paket yang diperlukan

Tambahkan dependensi berikut ke .pom.xml

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

Menginisialisasi klien manajemen

Atur variabel AZURE_SUBSCRIPTION_ID lingkungan dengan ID langganan langganan tempat domain dan sumber daya Email Anda berada. Jalankan sampel kode untuk menginisialisasi klien manajemen.

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

Menghubungkan domain email ke Sumber Daya Communication Service

<resource-group-name>Ganti , <azure-communication-services-resource-name>, dan <linked-domain-resource-id> dalam kode sampel.

ID sumber daya domain tertaut harus dalam format berikut.

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

Jika Anda menggunakan Azure Managed Domain, domain-name adalah "AzureManagedDomain". email-service-name harus berupa layanan email yang sama dengan yang Anda gunakan untuk memprovisikan domain.

Setelah nilai-nilai ini diisi, jalankan kode sampel.

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

Putuskan sambungan domain email dari Sumber Daya Communication Service

<resource-group-name>Ganti , dan <azure-communication-services-resource-name> dalam kode sampel.

Setelah nilai-nilai ini diisi, jalankan kode sampel.

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

Prasyarat

Menginstal paket yang diperlukan

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

Menginisialisasi klien manajemen

Ganti bidang dalam kode sampel dengan ID langganan langganan tempat domain dan sumber daya Email Anda berada. Jalankan sampel kode untuk menginisialisasi klien manajemen.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Menghubungkan domain email ke Sumber Daya Communication Service

<resource-group-name>Ganti , <azure-communication-services-resource-name>, dan <linked-domain-resource-id> dalam kode sampel.

ID sumber daya domain tertaut harus dalam format berikut.

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

Jika Anda menggunakan Azure Managed Domain, domain-name adalah "AzureManagedDomain". email-service-name harus berupa layanan email yang sama dengan yang Anda gunakan untuk memprovisikan domain.

Setelah nilai-nilai ini diisi, jalankan kode sampel.


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

Putuskan sambungan domain email dari Sumber Daya Communication Service

<resource-group-name> Ganti dan <azure-communication-services-resource-name> dalam kode sampel.

Setelah nilai-nilai ini diisi, jalankan kode sampel.


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

Langkah berikutnya