Snabbstart: Lägga till anpassade verifierade e-postdomäner

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Se Skapa ett konto kostnadsfritt.
• En e-postresurs för Azure Communication Services har skapats och är redo att lägga till domänerna. Se Kom igång med att skapa en e-postkommunikationsresurs.

Etablera en anpassad domän

Om du vill etablera en anpassad domän måste du:

• Verifiera det anpassade domänägarskapet genom att lägga till en TXT-post i ditt DNS (Domain Name System).
• Konfigurera avsändarautentiseringen genom att lägga till SPF-poster (Sender Policy Framework) och DomainKeys Identified Mail (DKIM).

Verifiera anpassad domän

I det här avsnittet kontrollerar du ägarskapet för den anpassade domänen genom att lägga till en TXT-post i DNS.

1. Öppna sidan Översikt för resursen e-postkommunikationstjänst som du skapade i Kom igång med att skapa en e-postkommunikationsresurs.

2. Skapa en anpassad domän med något av följande alternativ.

   • (Alternativ 1) Klicka på knappen Installation under Konfigurera en anpassad domän. Fortsätt till steg 3.

     

   • (Alternativ 2) Klicka på Etablera domäner på den vänstra navigeringspanelen.

     

   • Klicka på Lägg till domän i det övre navigeringsfältet.

   • Välj Anpassad domän i listrutan.

3. Klicka på Lägg till en anpassad domän.

4. Ange ditt domännamn i textrutan.

5. Ange domännamnet igen i nästa textruta.

6. Klicka på Bekräfta.

   

7. Kontrollera att domännamnet du angav är korrekt och att båda textrutorna är desamma. Om det behövs klickar du på Redigera för att korrigera domännamnet innan du bekräftar det.

8. Klicka på Lägg till.

   

9. Azure Communication Services skapar en anpassad domänkonfiguration för din domän.

   

10. Om du vill verifiera domänägarskapet klickar du på Verifiera domän.

    .

11. Om du vill återuppta verifieringen senare klickar du på Stäng och återupptar. Klicka sedan på Konfigurera för att fortsätta verifieringen från Etableringsdomäner.

    

12. När du väljer Verifiera domän eller Konfigurera öppnas dialogrutan Verifiera domän via TXT-post .

    

13. Lägg till föregående TXT-post till domänens registrator eller DNS-värd. Mer information om hur du lägger till en TXT-post för DNS-providern finns i avsnittet TXT-poster .

    När du har slutfört det här steget klickar du på Nästa.

14. Kontrollera att TXT-posten har skapats i DNS och klicka sedan på Klar.

15. DNS-ändringar kräver 15 till 30 minuter för att börja gälla. Klicka på Stäng.

    

16. När du har verifierat domänen kan du lägga till dina SPF- och DKIM-poster för att autentisera dina domäner.

    

Konfigurera avsändarautentisering för anpassad domän

För att konfigurera avsändarautentisering för dina domäner måste du lägga till fler DNS-poster (Domain Name Service). Det här avsnittet beskriver hur Azure Communication Services erbjuder poster som du kan lägga till i din DNS. Beroende på om domänen du registrerar är en rotdomän eller en underdomän måste du dock lägga till posterna i respektive zon eller göra ändringar i de automatiskt genererade posterna.

Det här avsnittet visar hur du lägger till SPF- och DKIM-poster för den anpassade domänen sales.us.notification.azurecommtest.net. I följande exempel beskrivs fyra olika metoder för att lägga till dessa poster i DNS, beroende på nivån för zonen där du lägger till posterna.

1. Zon: sales.us.notification.azurecommtest.net

De poster som genereras av portalen förutsätter att du lägger till dessa poster i DNS i den här zonen sales.us.notification.azurecommtest.net.

2. Zon: us.notification.azurecommtest.net

3. Zon: notification.azurecommtest.net

4. Zon: azurecommtest.net

Lägga till SPF- och DKIM-poster

I det här avsnittet konfigurerar du avsändarautentiseringen genom att lägga till SPF-poster (Sender Policy Framework) och DomainKeys Identified Mail (DKIM).

1. Öppna Etableringsdomäner och bekräfta att domänstatusen är i tillståndet Verified .

2. Om du vill lägga till SPF- och DKIM-information klickar du på Konfigurera.

3. Lägg till följande TXT-post och CNAME-poster till domänens registrator eller DNS-värd. Mer information om hur du lägger till en TXT- och CNAME-post för DNS-providern finns i tabellen lägga till DNS-poster i tabellen med populära domänregistratorer.

   

4. När du är klar med att lägga till TXT- och CNAME-information klickar du på Nästa för att fortsätta.

5. Kontrollera att TXT- och CNAME-poster har skapats i din DNS. Klicka sedan på Done (Klar).

   

6. DNS-ändringar börjar gälla om 15 till 30 minuter. Klicka på Stäng och vänta tills verifieringen har slutförts.

   

7. Kontrollera verifieringsstatusen på sidan Etablera domäner .

   

8. När du har verifierat konfigurationer för avsändarautentisering är din e-postdomän redo att skicka e-postmeddelanden med den anpassade domänen.

   

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Installera Azure CLI
• Skapa en e-postkommunikationstjänst.

Etablera en anpassad domän

Om du vill etablera en anpassad domän måste du:

• Verifiera det anpassade domänägarskapet genom att lägga till en TXT-post i ditt DNS (Domain Name System).
• Konfigurera avsändarautentiseringen genom att lägga till SPF-poster (Sender Policy Framework) och DomainKeys Identified Mail (DKIM).

Skapa domänresurs

Om du vill skapa en domänresurs loggar du in på Azure CLI. Du kan logga in med az login kommandot från terminalen och ange dina autentiseringsuppgifter. Kör följande kommando för att skapa resursen:

az communication email domain create --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management CustomerManaged

Om du vill välja en specifik prenumeration kan du också ange --subscription flaggan och ange prenumerations-ID:t.

az communication email domain create --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management CustomerManaged --subscription "<subscriptionId>"

Du kan konfigurera domänresursen med följande alternativ:

• Resursgruppen
• Namnet på resursen För e-postkommunikationstjänster.
• Det geografiska område som resursen ska associeras med.
• Namnet på domänresursen.
• Värdet för egenskapen Domänhantering.
  • För anpassade domäner ska värdet vara – CustomerManaged.

I nästa steg kan du tilldela taggar eller uppdatera spårning av användarengagemang till domänresursen. Taggar kan användas för att organisera dina domänresurser. Mer information om taggar finns i dokumentationen om resurstaggning.

Hantera domänresursen

Om du vill lägga till taggar eller uppdatera spårning av användarengagemang i domänresursen kör du följande kommandon. Du kan även rikta in dig på en specifik prenumeration.

az communication email domain update --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --user-engmnt-tracking Enabled

az communication email domain update --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --user-engmnt-tracking Disabled --subscription "<subscriptionId>"

Om du vill visa en lista över alla dina domänresurser i en viss e-postkommunikationstjänst använder du följande kommando:

az communication email domain list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Om du vill visa all information om en viss domänresurs använder du följande kommando:

az communication email domain show --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Verifieringsåtgärd för domänresursen

Information om hur du konfigurerar avsändarautentisering för dina domäner finns i Avsnittet Konfigurera avsändarautentisering för anpassad domän på fliken Azure-portalen.

Initiera verifiering

Starta domänverifiering genom att köra kommandot nedan:

az communication email domain initiate-verification --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --verification-type Domain

Avbryt verifiering

Om du vill avbryta domänverifieringen kör du kommandot nedan:

az communication email domain cancel-verification --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --verification-type Domain

Rensa en domänresurs

Om du vill rensa och ta bort en domänresurs kan du ta bort genom att köra följande kommando.

az communication email domain delete --domain-name "contoso.com" --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Information om andra kommandon finns i Domän CLI.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Den senaste versionen av .NET Core SDK för ditt operativsystem.
• Hämta den senaste versionen av .NET Identity SDK.
• Hämta den senaste versionen av .NET Management SDK.

Etablera en anpassad domän

Om du vill etablera en anpassad domän måste du:

• Verifiera det anpassade domänägarskapet genom att lägga till en TXT-post i ditt DNS (Domain Name System).
• Konfigurera avsändarautentiseringen genom att lägga till SPF-poster (Sender Policy Framework) och DomainKeys Identified Mail (DKIM).

Installera SDK

Ta först med Communication Services Management SDK i ditt C#-projekt:

using Azure.ResourceManager.Communication;

Prenumerations-ID:t

Du måste känna till ID:t för din Azure-prenumeration. Detta kan hämtas från portalen:

1. Logga in på ditt Azure-konto
2. Välj Prenumerationer i det vänstra sidofältet
3. Välj vilken prenumeration som behövs
4. Klicka på Översikt
5. Välj ditt prenumerations-ID

I den här snabbstarten förutsätter vi att du har lagrat prenumerations-ID:t i en miljövariabel med namnet AZURE_SUBSCRIPTION_ID.

Autentisering

Om du vill kommunicera med domänresursen måste du först autentisera dig själv till Azure.

Autentisera klienten

Standardalternativet för att skapa en autentiserad klient är att använda DefaultAzureCredential. Eftersom alla hanterings-API:er går igenom samma slutpunkt måste endast en armclient på den översta nivån skapas för att kunna interagera med resurser.

Om du vill autentisera till Azure och skapa en ArmClient gör du följande kod:

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://video2.skills-academy.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Interagera med Azure-resurser

Nu när du är autentiserad.

För vart och ett av följande exempel tilldelar vi våra domänresurser till en befintlig e-postkommunikationstjänst.

Om du behöver skapa en e-postkommunikationstjänst kan du göra det med hjälp av Azure-portalen.

Skapa en domänresurs

När du skapar en domänresurs anger du resursgruppens namn, namnet på e-postkommunikationstjänsten, resursnamnet och DomainManagement.

// 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 = "contoso.com";
CommunicationDomainResourceData data = new CommunicationDomainResourceData(new AzureLocation("Global"))
{
    DomainManagement = DomainManagement.CustomerManaged,
};
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}");

Hantera dina domänresurser

Uppdatera en domänresurs

...
// 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 = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
CommunicationDomainResourcePatch patch = new CommunicationDomainResourcePatch()
{
    UserEngagementTracking = UserEngagementTracking.Enabled,
};
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}");

Lista efter e-posttjänst

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

Hämta domänresurs

// 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 = "contoso.com";
bool result = await collection.ExistsAsync(domainName);

Console.WriteLine($"Succeeded: {result}");

Verifieringsåtgärd för domänresursen

Information om hur du konfigurerar avsändarautentisering för dina domäner finns i Avsnittet Konfigurera avsändarautentisering för anpassad domän på fliken Azure-portalen.

Initiera verifiering

// 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 = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
DomainsRecordVerificationContent content = new DomainsRecordVerificationContent(DomainRecordVerificationType.Spf);
await communicationDomainResource.InitiateVerificationAsync(WaitUntil.Completed, content);

Console.WriteLine($"Succeeded");

Avbryt verifiering

// 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 = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
DomainsRecordVerificationContent content = new DomainsRecordVerificationContent(DomainRecordVerificationType.Spf);
await communicationDomainResource.CancelVerificationAsync(WaitUntil.Completed, content);

Console.WriteLine($"Succeeded");

Rensa en domänresurs

// 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 = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
await communicationDomainResource.DeleteAsync(WaitUntil.Completed);

Console.WriteLine($"Succeeded");

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Installera Azure Az PowerShell-modulen
• Skapa en e-postkommunikationstjänst.

Etablera en anpassad domän

Om du vill etablera en anpassad domän måste du:

• Verifiera det anpassade domänägarskapet genom att lägga till en TXT-post i ditt DNS (Domain Name System).
• Konfigurera avsändarautentiseringen genom att lägga till SPF-poster (Sender Policy Framework) och DomainKeys Identified Mail (DKIM).

Skapa en domänresurs

Om du vill skapa en domänresurs loggar du in på ditt Azure-konto med hjälp Connect-AzAccount av följande kommando och anger dina autentiseringsuppgifter.

PS C:\> Connect-AzAccount

Börja med att installera Azure Communication Services-modulen Az.Communication med hjälp av följande kommando.

PS C:\> Install-Module Az.Communication

Kör följande kommando för att skapa resursen anpassad hanterad domän:

PS C:\> New-AzEmailServiceDomain -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -Name contoso.com -DomainManagement CustomerManaged

Du kan konfigurera domänresursen med följande alternativ:

• Resursgruppen
• Namnet på resursen För e-postkommunikationstjänster.
• Namnet på domänresursen.
• Värdet för egenskapen Domänhantering.
  • För anpassade domäner ska värdet vara "CustomerManaged".

I nästa steg kan du tilldela taggar eller uppdatera spårning av användarengagemang till domänresursen. Taggar kan användas för att organisera dina domänresurser. Mer information om taggar finns i dokumentationen för resurstaggning.

Hantera domänresursen

Om du vill lägga till taggar eller uppdatera spårning av användarengagemang i domänresursen kör du följande kommandon. Du kan även rikta in dig på en specifik prenumeration.

PS C:\> Update-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -UserEngagementTracking 1

PS C:\> Update-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -UserEngagementTracking 0 -SubscriptionId SubscriptionID

Om du vill visa en lista över alla dina domänresurser i en viss e-postkommunikationstjänst använder du följande kommando:

PS C:\> Get-AzEmailServiceDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Om du vill visa all information om en viss domänresurs använder du följande kommando:

PS C:\> Get-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Verifieringsåtgärd för domänresursen

Information om hur du konfigurerar avsändarautentisering för dina domäner finns i Avsnittet Konfigurera avsändarautentisering för anpassad domän på fliken Azure-portalen.

Initiera verifiering

Om du vill anropa domänverifiering kör du kommandot nedan:

PS C:\> Invoke-AzEmailServiceInitiateDomainVerification -DomainName contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -VerificationType Domain

Avbryt verifiering

Om du vill stoppa domänverifieringen kör du kommandot nedan:

PS C:\> Stop-AzEmailServiceDomainVerification -DomainName contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -VerificationType Domain

Rensa en domänresurs

Om du vill rensa och ta bort en domänresurs kan du ta bort domänresursen genom att köra följande kommando:

PS C:\> Remove-AzEmailServiceDomain -Name contoso.com -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1