Udostępnij za pośrednictwem

Szybki start: jak połączyć zweryfikowaną domenę poczty e-mail

  • Artykuł

W tym przewodniku Szybki start opisano sposób łączenia zweryfikowanej domeny w usługach Azure Communication Services w celu wysyłania wiadomości e-mail.

Wymagania wstępne

Łączenie domeny poczty e-mail z zasobem usługi komunikacyjnej

  1. Na stronie Przegląd zasobu usługi Azure Communication Service w lewym panelu nawigacyjnym w obszarze Poczta e-mail kliknij pozycję Domeny.

    Zrzut ekranu przedstawiający lewy panel nawigacyjny umożliwiający łączenie domen poczty e-mail.

  2. Wybierz jedną z następujących opcji:

    • Na górnym pasku nawigacyjnym kliknij pozycję Połącz domenę.

    • Na ekranie powitalnym kliknij pozycję Połącz domenę.

      Zrzut ekranu przedstawiający sposób łączenia jednej ze zweryfikowanych domen poczty e-mail.

  3. Wybierz jedną ze zweryfikowanych domen, filtrując:

    • Subskrypcja
    • Grupa zasobów
    • Usługa poczty e-mail
    • Zweryfikowana domena

    Zrzut ekranu przedstawiający sposób filtrowania i wybierania jednej ze zweryfikowanych domen poczty e-mail do nawiązania połączenia.

Uwaga

Domeny można łączyć tylko w tej samej lokalizacji geograficznej. Upewnij się, że lokalizacja danych dla zasobu komunikacji i zasobu komunikacji poczty e-mail wybranego podczas tworzenia zasobu znajduje się w tej samej lokalizacji geograficznej.

  1. Kliknij Połącz.

    Zrzut ekranu przedstawiający jedną z zweryfikowanych domen poczty e-mail jest teraz połączony.

Uwaga

Umożliwiamy klientom łączenie maksymalnie 100 domen niestandardowych z pojedynczym zasobem usługi komunikacyjnej. Wszystkie adresy mail-from skonfigurowane w tych domenach niestandardowych są dostępne dla zasobu usługi komunikacji. Można łączyć tylko zweryfikowane domeny niestandardowe.

Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej

  1. Na stronie Przegląd zasobów usług Azure Communication Services w lewym panelu nawigacyjnym w obszarze Poczta e-mail kliknij pozycję Domeny.

  2. Wybierz domeny połączone, a następnie kliknij pozycję ... i wybierz pozycję Rozłącz.

    Zrzut ekranu przedstawiający sposób odłączenia połączonej domeny.

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
  • Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
  • Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.

Łączenie domeny poczty e-mail z zasobem usługi komunikacyjnej

Zastąp element {subscription-id}, {resource-group-name}, {communication-services-resource-name}i {linked-domain-resource-id} w przykładowym żądaniu.

Sformatuj identyfikator zasobu połączonej domeny w następujący sposób:

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

Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.

Po wypełnieniu tych wartości utwórz żądanie PATCH przy użyciu następującego adresu URL żądania i treści.

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

Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej

Zastąp element {subscription-id}, {resource-group-name}i {communication-services-resource-name} w przykładowym żądaniu.

Po wypełnieniu tych wartości utwórz żądanie PATCH przy użyciu następującego adresu URL żądania i treści.

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

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
  • Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
  • Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

dotnet add package Azure.ResourceManager.Communication

Inicjowanie klienta zarządzania

Ustaw zmienną środowiskową AZURE_SUBSCRIPTION_ID przy użyciu identyfikatora subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.

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

Łączenie domeny poczty e-mail z zasobem usługi komunikacyjnej

Zastąp element <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.

Sformatuj identyfikator zasobu połączonej domeny w następujący sposób:

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

Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.

Po wypełnieniu tych wartości uruchom przykładowy kod.

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

Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej

Zastąp element <subscription-id>, <resource-group-name>i <azure-communication-services-resource-name> w przykładowym kodzie.

Po wypełnieniu tych wartości uruchom przykładowy kod.

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

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
  • Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
  • Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

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

Inicjowanie klienta zarządzania

Zastąp pole w przykładowym kodzie identyfikatorem subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.

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

Łączenie domeny poczty e-mail z zasobem usługi komunikacyjnej

Zastąp element <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.

Sformatuj identyfikator zasobu połączonej domeny w następujący sposób:

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

Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.

Po wypełnieniu tych wartości uruchom przykładowy kod.

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

Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej

Zastąp element <resource-group-name>i <azure-communication-services-resource-name> w przykładowym kodzie.

Po wypełnieniu tych wartości uruchom przykładowy kod.

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

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

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
  • Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
  • Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
  • Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

Dodaj następującą zależność do elementu pom.xml.

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

Inicjowanie klienta zarządzania

Ustaw zmienną środowiskową AZURE_SUBSCRIPTION_ID przy użyciu identyfikatora subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.

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

Łączenie domeny poczty e-mail z zasobem usługi komunikacyjnej

Zastąp element <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.

Identyfikator zasobu połączonej domeny powinien mieć następujący format.

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

Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.

Po wypełnieniu tych wartości uruchom przykładowy kod.

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

Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej

Zastąp element <resource-group-name>i <azure-communication-services-resource-name> w przykładowym kodzie.

Po wypełnieniu tych wartości uruchom przykładowy kod.

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

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
  • Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
  • Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
  • Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

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

Inicjowanie klienta zarządzania

Zastąp pole w przykładowym kodzie identyfikatorem subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Łączenie domeny poczty e-mail z zasobem usługi komunikacyjnej

Zastąp element <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.

Identyfikator zasobu połączonej domeny powinien mieć następujący format.

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

Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.

Po wypełnieniu tych wartości uruchom przykładowy kod.


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

Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej

Zastąp element <resource-group-name> i <azure-communication-services-resource-name> w przykładowym kodzie.

Po wypełnieniu tych wartości uruchom przykładowy kod.


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

Następne kroki