Hızlı Başlangıç: Doğrulanmış e-posta etki alanını bağlama

  • Makale

Bu hızlı başlangıçta, e-posta göndermek için Azure İletişim Hizmetleri'da doğrulanmış bir etki alanının nasıl bağlandığı açıklanmaktadır.

Önkoşullar

E-posta etki alanını İletişim Hizmeti Kaynağına bağlama

  1. Azure İletişim Hizmeti Kaynağına genel bakış sayfasında, sol gezinti panelinde, E-posta'nın altında Etki Alanları'na tıklayın.

    E-posta Etki Alanlarını bağlamak için sol gezinti panelini gösteren ekran görüntüsü.

  2. Aşağıdaki seçeneklerden birini belirleyin:

    • Üst gezinti çubuğunda Etki alanına bağlan'a tıklayın.

    • Giriş ekranında Etki alanına bağlan'a tıklayın.

      Doğrulanmış e-posta etki alanlarınızdan birinin nasıl bağlandığını gösteren ekran görüntüsü.

  3. Filtreleyerek doğrulanmış etki alanlarından birini seçin:

    • Abonelik
    • Kaynak Grubu
    • E-posta Hizmeti
    • Doğrulanmış Etki Alanı

    Bağlanacak doğrulanmış e-posta etki alanlarından birini filtrelemeyi ve seçmeyi gösteren ekran görüntüsü.

Not

Yalnızca aynı coğrafyadaki etki alanlarını bağlayabilirsiniz. Lütfen kaynak oluşturma sırasında seçtiğiniz İletişim Kaynağı ve E-posta İletişim Kaynağı için Veri konumunun aynı coğrafyada olduğundan emin olun.

  1. Bağlan'a tıklayın.

    Doğrulanmış e-posta etki alanlarından birinin artık bağlı olduğunu gösteren ekran görüntüsü.

Not

Müşterilerin tek bir iletişim hizmeti kaynağına en fazla 100 özel etki alanı bağlamasını sağlıyoruz. Bu özel etki alanları altında yapılandırılan tüm Posta Kaynağı adreslerine iletişim hizmeti kaynağı için erişilebilir. Yalnızca doğrulanmış özel etki alanlarını bağlayabilirsiniz.

İletişim Hizmeti Kaynağı ile e-posta etki alanının bağlantısını kesme

  1. Azure İletişim Hizmetleri Kaynağa genel bakış sayfasında, E-posta'nın altındaki sol gezinti panelinde Etki Alanları'na tıklayın.

  2. Bağlı Etki Alanları'nı seçin, ardından ... öğesine tıklayın ve Bağlantıyı Kes'i seçin.

    Bağlı etki alanının bağlantısının nasıl kesildiğini gösteren ekran görüntüsü.

Önkoşullar

E-posta etki alanını İletişim Hizmeti Kaynağına bağlama

Örnek istekteki {subscription-id}, {resource-group-name}, {communication-services-resource-name}ve {linked-domain-resource-id} değerini değiştirin.

Bağlı etki alanı kaynak kimliğini aşağıdaki gibi biçimlendirin:

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

Azure Yönetilen Etki Alanı kullanıyorsanız , domain-name "AzureManagedDomain" olur. , email-service-name etki alanını sağlamak için kullandığınız e-posta hizmetiyle aynı olmalıdır.

Bu değerler dolduruldıktan sonra, aşağıdaki İstek URL'sini ve gövdesini kullanarak bir PATCH isteği oluşturun.

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

İletişim Hizmeti Kaynağı ile e-posta etki alanının bağlantısını kesme

Örnek istekteki {subscription-id}, {resource-group-name}ve {communication-services-resource-name} değerini değiştirin.

Bu değerler dolduruldıktan sonra, aşağıdaki İstek URL'sini ve gövdesini kullanarak bir PATCH isteği oluşturun.

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

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
  • Etki alanlarını sağlamaya hazır bir Azure E-posta İletişim Hizmetleri Kaynağı. E-posta İletişim Kaynağı oluşturmaya başlayın.
  • Sağlanan ve e-posta göndermeye hazır bir Azure Yönetilen Etki Alanı veya Özel Etki Alanı . Bu etki alanı, İletişim Hizmeti kaynağına bağlanmaya çalışmadan önce tam olarak doğrulanmalıdır.
  • bir Azure İletişim Hizmetleri Kaynağı. İletişim Hizmetleri Kaynakları oluşturma.
  • Kimlik doğrulaması için hizmet sorumlusu kullanıyoruz. Microsoft Entra uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini şu ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID, AZURE_TENANT_IDve AZURE_CLIENT_SECRET.

Gerekli paketleri yükleme

dotnet add package Azure.ResourceManager.Communication

Yönetim istemcisini başlatma

Ortam değişkenini AZURE_SUBSCRIPTION_ID , Etki Alanı ve E-posta kaynaklarınızın içinde yer alan aboneliğin abonelik kimliğiyle ayarlayın. Yönetim istemcisini başlatmak için kod örneğini çalıştırın.

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

E-posta etki alanını İletişim Hizmeti Kaynağına bağlama

Örnek koddaki <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name>ve <linked-domain-resource-id> değerini değiştirin.

Bağlı etki alanı kaynak kimliğini aşağıdaki gibi biçimlendirin:

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

Azure Yönetilen Etki Alanı kullanıyorsanız , domain-name "AzureManagedDomain" olur. , email-service-name etki alanını sağlamak için kullandığınız e-posta hizmetiyle aynı olmalıdır.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.

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

İletişim Hizmeti Kaynağı ile e-posta etki alanının bağlantısını kesme

Örnek koddaki <subscription-id>, <resource-group-name>ve <azure-communication-services-resource-name> değerini değiştirin.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.

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

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
  • Etki alanlarını sağlamaya hazır bir Azure E-posta İletişim Hizmetleri Kaynağı. E-posta İletişim Kaynağı oluşturmaya başlayın.
  • Sağlanan ve e-posta göndermeye hazır bir Azure Yönetilen Etki Alanı veya Özel Etki Alanı . Bu etki alanı, İletişim Hizmeti kaynağına bağlanmaya çalışmadan önce tam olarak doğrulanmalıdır.
  • bir Azure İletişim Hizmetleri Kaynağı. İletişim Hizmetleri Kaynakları oluşturma.
  • Kimlik doğrulaması için hizmet sorumlusu kullanıyoruz. Microsoft Entra uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini şu ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID, AZURE_TENANT_IDve AZURE_CLIENT_SECRET.

Gerekli paketleri yükleme

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

Yönetim istemcisini başlatma

Örnek koddaki alanı, Etki Alanı ve E-posta kaynaklarınızın içinde yer alan aboneliğin abonelik kimliğiyle değiştirin. Yönetim istemcisini başlatmak için kod örneğini çalıştırın.

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

E-posta etki alanını İletişim Hizmeti Kaynağına bağlama

Örnek koddaki <resource-group-name>, <azure-communication-services-resource-name>ve <linked-domain-resource-id> değerini değiştirin.

Bağlı etki alanı kaynak kimliğini aşağıdaki gibi biçimlendirin:

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

Azure Yönetilen Etki Alanı kullanıyorsanız , domain-name "AzureManagedDomain" olur. , email-service-name etki alanını sağlamak için kullandığınız e-posta hizmetiyle aynı olmalıdır.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.

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

İletişim Hizmeti Kaynağı ile e-posta etki alanının bağlantısını kesme

örnek kodda <resource-group-name>ve <azure-communication-services-resource-name> değerini değiştirin.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.

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

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

Önkoşullar

Gerekli paketleri yükleme

Aşağıdaki bağımlılığı kendi öğesine pom.xmlekleyin.

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

Yönetim istemcisini başlatma

Ortam değişkenini AZURE_SUBSCRIPTION_ID , Etki Alanı ve E-posta kaynaklarınızın içinde yer alan aboneliğin abonelik kimliğiyle ayarlayın. Yönetim istemcisini başlatmak için kod örneğini çalıştırın.

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

E-posta etki alanını İletişim Hizmeti Kaynağına bağlama

Örnek koddaki <resource-group-name>, <azure-communication-services-resource-name>ve <linked-domain-resource-id> değerini değiştirin.

Bağlı etki alanı kaynak kimliği aşağıdaki biçimde olmalıdır.

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

Azure Yönetilen Etki Alanı kullanıyorsanız , domain-name "AzureManagedDomain" olur. , email-service-name etki alanını sağlamak için kullandığınız e-posta hizmetiyle aynı olmalıdır.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.

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

İletişim Hizmeti Kaynağı ile e-posta etki alanının bağlantısını kesme

örnek kodda <resource-group-name>ve <azure-communication-services-resource-name> değerini değiştirin.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.

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

Önkoşullar

Gerekli paketleri yükleme

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

Yönetim istemcisini başlatma

Örnek koddaki alanı, Etki Alanı ve E-posta kaynaklarınızın içinde yer alan aboneliğin abonelik kimliğiyle değiştirin. Yönetim istemcisini başlatmak için kod örneğini çalıştırın.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

E-posta etki alanını İletişim Hizmeti Kaynağına bağlama

Örnek koddaki <resource-group-name>, <azure-communication-services-resource-name>ve <linked-domain-resource-id> değerini değiştirin.

Bağlı etki alanı kaynak kimliği aşağıdaki biçimde olmalıdır.

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

Azure Yönetilen Etki Alanı kullanıyorsanız , domain-name "AzureManagedDomain" olur. , email-service-name etki alanını sağlamak için kullandığınız e-posta hizmetiyle aynı olmalıdır.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.


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

İletişim Hizmeti Kaynağı ile e-posta etki alanının bağlantısını kesme

<resource-group-name> örnek koddaki ve <azure-communication-services-resource-name> değerini değiştirin.

Bu değerler dolduruldıktan sonra örnek kodu çalıştırın.


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

Sonraki adımlar