Mulai Cepat: Cara menambahkan Domain Terkelola Azure ke Communication Service Email
Dalam mulai cepat ini, Anda mempelajari cara memprovisikan Azure Managed Domain ke Email Communication Service di Azure Communication Services.
Prasyarat
- Akun Azure dengan langganan aktif. Buat akun secara gratis.
- Sumber Daya Email Azure Communication Services dibuat dan siap untuk menambahkan domain. Lihat Mulai membuat Sumber Daya Komunikasi Email.
Memprovisikan Domain Terkelola Azure
Buka halaman Gambaran Umum sumber daya Layanan Komunikasi Email yang Anda buat di Mulai Membuat Sumber Daya Komunikasi Email.
Buat Domain Terkelola Azure menggunakan salah satu opsi berikut.
- (Opsi 1) Klik tombol 1-klik tambahkan di bawah Tambahkan subdomain Azure gratis. Lanjutkan ke langkah 3.
- (Opsi 2) Klik Provisikan Domain di panel navigasi kiri.
- Klik Tambahkan domain di bilah navigasi atas.
- Pilih Domain Azure dari dropdown.
Tunggu hingga penerapan selesai.
Setelah domain dibuat, Anda akan melihat tampilan daftar dengan domain baru.
Klik nama domain yang disediakan untuk membuka halaman gambaran umum untuk jenis sumber daya domain.
Prasyarat
- Akun Azure dengan langganan aktif. Buat akun secara gratis.
- Memasang Azure CLI
- Membuat Layanan Komunikasi Email.
Membuat sumber daya Domain
Untuk membuat sumber daya Domain, masuk ke Azure CLI. Anda dapat masuk menjalankan az login perintah dari terminal dan memberikan kredensial Anda. Untuk membuat sumber daya, jalankan perintah berikut:
az communication email domain create --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management AzureManaged
Jika Anda ingin memilih langganan tertentu, Anda juga dapat menentukan --subscription bendera dan memberikan ID langganan.
az communication email domain create --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management AzureManaged --subscription "<subscriptionId>"
Anda dapat mengonfigurasi sumber daya Domain Anda dengan opsi berikut:
- Grup sumber daya
- Nama sumber daya Layanan Komunikasi Email
- Geografi yang akan dikaitkan dengan sumber daya
- Nama sumber daya Domain:
- Untuk domain Azure, nama harus AzureManagedDomain.
- Nilai properti Manajemen domain.
- Untuk domain Azure, nilainya harus AzureManaged.
Pada langkah berikutnya, Anda dapat menetapkan tag ke sumber daya domain. Tag dapat digunakan untuk mengatur sumber daya Domain Anda. Untuk informasi selengkapnya tentang tag, lihat dokumentasi pemberian tag sumber daya.
Mengelola sumber daya Domain Anda
Untuk menambahkan tag ke sumber daya Domain Anda, jalankan perintah berikut. Anda juga dapat menargetkan langganan tertentu.
az communication email domain update --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1"
az communication email domain update --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --subscription "<subscriptionId>"
Untuk mencantumkan semua Sumber Daya Domain Anda di Layanan Komunikasi Email tertentu, gunakan perintah berikut:
az communication email domain list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"
Untuk memperlihatkan semua informasi tentang sumber daya domain tertentu, gunakan perintah berikut:
az communication email domain show --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"
Membersihkan sumber daya Domain
Jika Anda ingin membersihkan dan menghapus sumber daya Domain, Anda bisa menghapus dengan menjalankan perintah berikut.
az communication email domain delete --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"
Catatan
Penghapusan sumber daya bersifat permanen dan tidak ada data, termasuk filter kisi peristiwa, nomor telepon, atau data lain yang terkait dengan sumber daya Anda, dapat dipulihkan jika Anda menghapus sumber daya.
Untuk informasi tentang perintah lain, lihat Domain CLI.
Prasyarat
- Akun Azure dengan langganan aktif. Buat akun secara gratis.
- Versi terbaru .NET Core SDK untuk sistem operasi Anda.
- Dapatkan versi terbaru dari .NET Identity SDK.
- Dapatkan versi terbaru dari .NET Management SDK.
Menginstal SDK
Pertama, sertakan SDK Manajemen Communication Services dalam proyek C# Anda:
using Azure.ResourceManager.Communication;
ID Langganan
Anda perlu mengetahui ID langganan Azure Anda. Ini dapat diperoleh dari portal:
- Masuk ke akun Azure Anda
- Pilih Langganan di bilah sisi kiri
- Pilih langganan mana yang diperlukan
- Klik Gambaran Umum
- Pilih ID Langganan Anda
Dalam mulai cepat ini, kami akan menganggap bahwa Anda telah menyimpan ID langganan dalam variabel lingkungan yang disebut AZURE_SUBSCRIPTION_ID.
Autentikasi
Untuk berkomunikasi dengan sumber daya Domain, Anda harus terlebih dahulu mengautentikasi diri Anda ke Azure.
Mengautentikasi Klien
Opsi default untuk membuat klien terautentikasi adalah menggunakan DefaultAzureCredential. Karena semua API manajemen melalui titik akhir yang sama, untuk berinteraksi dengan sumber daya, hanya satu ArmClient tingkat atas yang harus dibuat.
Untuk mengautentikasi ke Azure dan membuat ArmClient, lakukan kode berikut:
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);
Berinteraksi dengan sumber daya Azure
Sekarang setelah Anda diautentikasi.
Untuk setiap contoh berikut, kami akan menetapkan sumber daya Domain kami ke layanan komunikasi Email yang ada.
Jika Anda perlu membuat Layanan Komunikasi Email, Anda dapat melakukannya dengan menggunakan portal Azure.
Membuat sumber daya Domain
Saat membuat sumber daya Domain, Anda harus menentukan nama grup sumber daya, nama Layanan Komunikasi Email, nama sumber daya, dan DomainManagement.
Catatan
Properti Location selalu global.
// 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 = "AzureManagedDomain";
CommunicationDomainResourceData data = new CommunicationDomainResourceData(new AzureLocation("Global"))
{
DomainManagement = DomainManagement.AzureManaged,
};
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}");
Mengelola Sumber Daya Domain Anda
Memperbarui sumber daya Domain
...
// 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 = "AzureManagedDomain";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);
// invoke the operation
CommunicationDomainResourcePatch patch = new CommunicationDomainResourcePatch()
{
Tags =
{
["newTag"] = "newVal",
},
};
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}");
Daftar menurut Layanan 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");
Mendapatkan sumber daya Domain
// 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 = "AzureManagedDomain";
bool result = await collection.ExistsAsync(domainName);
Console.WriteLine($"Succeeded: {result}");
Membersihkan sumber daya Domain
// 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 = "AzureManagedDomain";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);
// invoke the operation
await communicationDomainResource.DeleteAsync(WaitUntil.Completed);
Console.WriteLine($"Succeeded");
Catatan
Penghapusan sumber daya bersifat permanen dan tidak ada data, termasuk filter kisi peristiwa, nomor telepon, atau data lain yang terkait dengan sumber daya Anda, dapat dipulihkan jika Anda menghapus sumber daya.
Prasyarat
- Akun Azure dengan langganan aktif. Buat akun secara gratis.
- Menginstal Modul Azure Az PowerShell
- Membuat Layanan Komunikasi Email.
Membuat sumber daya Domain
Untuk membuat sumber daya Domain, Masuk ke akun Azure Anda dengan menggunakan Connect-AzAccount perintah berikut dan berikan kredensial Anda.
PS C:\> Connect-AzAccount
Pertama, pastikan untuk memasang modul Azure Communication Services Az.Communication menggunakan perintah berikut.
PS C:\> Install-Module Az.Communication
Jalankan perintah berikut untuk membuat sumber daya domain terkelola Azure:
PS C:\> New-AzEmailServiceDomain -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -Name AzureManagedDomain -DomainManagement AzureManaged
Anda dapat mengonfigurasi sumber daya Domain Anda dengan opsi berikut:
- Grup sumber daya
- Nama sumber daya Layanan Komunikasi Email.
- Nama sumber daya Domain:
- Untuk domain Azure, namanya harus - AzureManagedDomain.
- Nilai properti Manajemen domain.
- Untuk domain Azure, nilainya harus AzureManaged.
Pada langkah berikutnya, Anda dapat menetapkan tag ke sumber daya domain. Tag dapat digunakan untuk mengatur sumber daya Domain Anda. Untuk informasi selengkapnya tentang tag, lihat dokumentasi pemberian tag sumber daya.
Mengelola sumber daya Domain Anda
Untuk menambahkan tag ke sumber daya Domain Anda, jalankan perintah berikut. Anda juga dapat menargetkan langganan tertentu.
PS C:\> Update-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}
PS C:\> Update-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID
Untuk mencantumkan semua Sumber Daya Domain Anda di Layanan Komunikasi Email tertentu, gunakan perintah berikut:
PS C:\> Get-AzEmailServiceDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1
Untuk mencantumkan semua informasi pada sumber daya domain tertentu, gunakan perintah berikut:
PS C:\> Get-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1
Membersihkan sumber daya Domain
Jika Anda ingin membersihkan dan menghapus sumber daya Domain, Anda bisa menghapus sumber daya Domain Anda dengan menjalankan perintah berikut:
PS C:\> Remove-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1
Catatan
Penghapusan sumber daya bersifat permanen dan tidak ada data, termasuk filter kisi peristiwa, nomor telepon, atau data lain yang terkait dengan sumber daya Anda, dapat dipulihkan jika Anda menghapus sumber daya.
Domain Terkelola Azure dibandingkan dengan Domain Kustom
Sebelum menyediakan Azure Managed Domain, tinjau tabel berikut untuk memutuskan jenis domain mana yang paling sesuai dengan kebutuhan Anda.
| Domain Terkelola Azure | Domain Kustom | |
|---|---|---|
| Pro: | - Penyiapan cepat & mudah - Tidak diperlukan verifikasi domain |
- Email dikirim dari domain Anda sendiri |
| Kontra: | - Domain pengirim tidak dipersonalisasi dan tidak dapat diubah - Nama pengguna pengirim tidak dapat dipersonalisasi - Volume pengiriman yang sangat terbatas - Pelacakan Keterlibatan Pengguna tidak dapat diaktifkan |
- Memerlukan verifikasi catatan domain - Penyiapan yang lebih panjang untuk verifikasi |
Autentikasi pengirim untuk Domain Terkelola Azure
Azure Communication Services secara otomatis mengonfigurasi protokol autentikasi email yang diperlukan untuk email seperti yang dijelaskan dalam praktik terbaik Autentikasi Email.
Domain email Anda sekarang siap untuk mengirim email.
Langkah berikutnya
Artikel terkait
- Biasakan diri Anda dengan Pustaka klien email
- Pelajari cara mengirim email dengan domain terverifikasi kustom di Mulai Cepat: Cara menambahkan domain email terverifikasi kustom