Guida introduttiva: Come aggiungere domini di posta elettronica verificati personalizzati

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Vedere Creare gratuitamente un account.
• Una Servizi di comunicazione di Azure risorsa di posta elettronica creata e pronta per aggiungere i domini. Vedere Introduzione alla creazione di una risorsa di comunicazione tramite posta elettronica.

Effettuare il provisioning di un dominio personalizzato

Per effettuare il provisioning di un dominio personalizzato, è necessario:

• Verificare la proprietà del dominio personalizzato aggiungendo un record TXT nel dns (Domain Name System).
• Configurare l'autenticazione del mittente aggiungendo record SPF (Sender Policy Framework) e DomainKeys Identified Mail (DKIM).

Verificare un dominio personalizzato

In questa sezione si verifica la proprietà del dominio personalizzato aggiungendo un record TXT nel DNS.

1. Aprire la pagina Panoramica della risorsa servizio di comunicazione tramite posta elettronica creata in Introduzione alla creazione di una risorsa di comunicazione tramite posta elettronica.

2. Creare un dominio personalizzato usando una delle opzioni seguenti.

   • (Opzione 1) Fare clic sul pulsante Setup (Imposta ) in Setup a custom domain (Configura un dominio personalizzato). Continuare con il passaggio 3.

     

   • (Opzione 2) Fare clic su Provision Domains (Effettuare il provisioning di domini ) nel pannello di spostamento sinistro.

     

   • Fare clic su Aggiungi dominio nella barra di spostamento superiore.

   • Selezionare Dominio personalizzato nell'elenco a discesa.

3. Fare clic su Aggiungi un dominio personalizzato.

4. Immettere il nome di dominio nella casella di testo.

5. Immettere nuovamente il nome di dominio nella casella di testo successiva.

6. Fare clic su Conferma.

   

7. Assicurarsi che il nome di dominio immesso sia corretto e che entrambe le caselle di testo siano uguali. Se necessario, fare clic su Modifica per correggere il nome di dominio prima di confermare.

8. Fare clic su Aggiungi.

   

9. Servizi di comunicazione di Azure crea una configurazione di dominio personalizzata per il dominio.

   

10. Per verificare la proprietà del dominio, fare clic su Verifica dominio.

    .

11. Per riprendere la verifica in un secondo momento, fare clic su Chiudi e riprendere. Quindi, per continuare la verifica da Effettuare il provisioning dei domini, fare clic su Configura.

    

12. Quando si seleziona Verifica dominio o Configura, viene visualizzata la finestra di dialogo Verifica dominio tramite record TXT.

    

13. Aggiungere il record TXT precedente al registrar o al provider di hosting DNS del dominio. Per informazioni sull'aggiunta di un record TXT per il provider DNS, vedere la sezione record TXT.

    Dopo aver completato questo passaggio, fare clic su Avanti.

14. Verificare che il record TXT sia stato creato correttamente nel DNS, quindi fare clic su Fine.

15. Le modifiche DNS richiedono da 15 a 30 minuti per rendere effettive le modifiche al DNS. Fare clic su Close.

    

16. Dopo aver verificato il dominio, è possibile aggiungere i record SPF e DKIM per autenticare i domini.

    

Configurare l'autenticazione del mittente per il dominio personalizzato

Per configurare l'autenticazione del mittente per i domini, è necessario aggiungere altri record DNS (Domain Name Service). Questa sezione descrive come Servizi di comunicazione di Azure offrire record da aggiungere al DNS. Tuttavia, a seconda che il dominio registrato sia un dominio radice o un sottodominio, è necessario aggiungere i record alla rispettiva zona o apportare modifiche ai record generati automaticamente.

Questa sezione illustra come aggiungere record SPF e DKIM per il dominio personalizzato sales.us.notification.azurecommtest.net. Gli esempi seguenti descrivono quattro diversi metodi per l'aggiunta di questi record al DNS, a seconda del livello della zona in cui si aggiungono i record.

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

I record generati dal portale presuppongono che questi record vengano aggiunti al DNS in questa zona sales.us.notification.azurecommtest.net.

2. Zona: us.notification.azurecommtest.net

3. Zona: notification.azurecommtest.net

4. Zona: azurecommtest.net

Aggiungere record SPF e DKIM

In questa sezione viene configurata l'autenticazione del mittente aggiungendo record Sender Policy Framework (SPF) e DomainKeys Identified Mail (DKIM).

1. Aprire Effettuare il provisioning dei domini e verificare che lo stato del dominio sia nello Verified stato.

2. Per aggiungere informazioni SPF e DKIM, fare clic su Configura.

3. Aggiungere i record TXT e CNAME seguenti al registrar o al provider di hosting DNS del dominio. Per informazioni sull'aggiunta di un record TXT e CNAME per il provider DNS, vedere la tabella aggiunta di record DNS nella tabella dei registrar di dominio più diffusi.

   

4. Al termine dell'aggiunta di informazioni TXT e CNAME, fare clic su Avanti per continuare.

5. Verificare che i record TXT e CNAME siano stati creati correttamente nel DNS. Fare quindi clic su Done (Chiudi).

   

6. Le modifiche DNS diventano effettive tra 15 e 30 minuti. Fare clic su Chiudi e attendere il completamento della verifica.

   

7. Controllare lo stato di verifica nella pagina Effettuare il provisioning dei domini .

   

8. Dopo aver verificato le configurazioni di autenticazione del mittente, il dominio di posta elettronica è pronto per inviare messaggi di posta elettronica usando il dominio personalizzato.

   

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Installare l' interfaccia della riga di comando di Azure
• Creare un servizio di comunicazione tramite posta elettronica.

Effettuare il provisioning di un dominio personalizzato

Per effettuare il provisioning di un dominio personalizzato, è necessario:

• Verificare la proprietà del dominio personalizzato aggiungendo un record TXT nel dns (Domain Name System).
• Configurare l'autenticazione del mittente aggiungendo record SPF (Sender Policy Framework) e DomainKeys Identified Mail (DKIM).

Creare una risorsa di dominio

Per creare una risorsa di dominio, accedere all'interfaccia della riga di comando di Azure. È possibile accedere eseguendo il az login comando dal terminale e specificando le credenziali. Per creare la risorsa, eseguire il comando seguente:

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

Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.

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

È possibile configurare la risorsa di dominio con le opzioni seguenti:

• Gruppo di risorse
• Nome della risorsa servizi di comunicazione di posta elettronica.
• Area geografica a cui verrà associata la risorsa.
• Nome della risorsa dominio.
• Valore della proprietà Gestione dominio.
  • Per Domini personalizzati, il valore deve essere - CustomerManaged.

Nel passaggio successivo è possibile assegnare tag o aggiornare il rilevamento dell'engagement degli utenti alla risorsa di dominio. I tag possono essere usati per organizzare le risorse di dominio. Per altre informazioni sui tag, vedere la documentazione relativa all'assegnazione di tag alle risorse.

Gestire la risorsa di dominio

Per aggiungere tag o aggiornare il rilevamento dell'engagement degli utenti alla risorsa di dominio, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.

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

Per elencare tutte le risorse di dominio in un determinato servizio di comunicazione tramite posta elettronica, usare il comando seguente:

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

Per visualizzare tutte le informazioni su una determinata risorsa di dominio, usare il comando seguente:

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

Operazione di verifica per la risorsa di dominio

Per configurare l'autenticazione del mittente per i domini, vedere configurare l'autenticazione del mittente per il dominio personalizzato nella scheda portale di Azure.

Avviare la verifica

Per avviare la verifica del dominio, eseguire il comando seguente:

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

Annulla verifica

Per annullare la verifica del dominio, eseguire il comando seguente:

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

Pulire una risorsa di dominio

Se si vuole pulire e rimuovere una risorsa di dominio, è possibile eliminare eseguendo il comando seguente.

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

Per informazioni su altri comandi, vedere Interfaccia della riga di comando del dominio.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Versione più recente di .NET Core SDK per il sistema operativo.
• Ottenere la versione più recente di .NET Identity SDK.
• Ottenere la versione più recente di .NET Management SDK.

Effettuare il provisioning di un dominio personalizzato

Per effettuare il provisioning di un dominio personalizzato, è necessario:

• Verificare la proprietà del dominio personalizzato aggiungendo un record TXT nel dns (Domain Name System).
• Configurare l'autenticazione del mittente aggiungendo record SPF (Sender Policy Framework) e DomainKeys Identified Mail (DKIM).

Installazione dell'SDK

In primo luogo, includere Communication Services Management SDK nel progetto C#:

using Azure.ResourceManager.Communication;

ID sottoscrizione

È necessario conoscere l'ID della sottoscrizione di Azure. Queste informazioni possono essere acquisite dal portale:

1. Accedere all'account Azure
2. Selezionare Sottoscrizioni nella barra laterale sinistra
3. Selezionare la sottoscrizione necessaria
4. Fare clic su Panoramica
5. Selezionare l'ID sottoscrizione

In questo argomento di avvio rapido si presuppone che l'ID sottoscrizione sia stato archiviato in una variabile di ambiente denominata AZURE_SUBSCRIPTION_ID.

Autenticazione

Per comunicare con la risorsa di dominio, è prima necessario eseguire l'autenticazione in Azure.

Autenticare il client

L'opzione predefinita per creare un client autenticato consiste nell'usare DefaultAzureCredential. Poiché tutte le API di gestione passano attraverso lo stesso endpoint, per interagire con le risorse, è necessario creare un solo armClient di primo livello.

Per eseguire l'autenticazione in Azure e creare armClient, eseguire il codice seguente:

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

Interazione con le risorse di Azure

Dopo aver eseguito l'autenticazione.

Per ognuno degli esempi seguenti, le risorse di dominio verranno assegnate a un servizio di comunicazione di posta elettronica esistente.

Se è necessario creare un servizio di comunicazione tramite posta elettronica, è possibile farlo usando il portale di Azure.

Creare una risorsa di dominio

Quando si crea una risorsa di dominio, si specificano il nome del gruppo di risorse, il nome del servizio di comunicazione di posta elettronica, il nome della risorsa e 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}");

Gestire le risorse del dominio

Aggiornare una risorsa di dominio

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

Elenco per servizio di posta elettronica

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

Ottenere la risorsa di dominio

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

Operazione di verifica per la risorsa di dominio

Per configurare l'autenticazione del mittente per i domini, vedere Configurare l'autenticazione del mittente per il dominio personalizzato nella scheda portale di Azure.

Avviare la verifica

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

Annulla verifica

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

Pulire una risorsa di dominio

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

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Installare il modulo Azure Az PowerShell
• Creare un servizio di comunicazione tramite posta elettronica.

Effettuare il provisioning di un dominio personalizzato

Per effettuare il provisioning di un dominio personalizzato, è necessario:

• Verificare la proprietà del dominio personalizzato aggiungendo un record TXT nel dns (Domain Name System).
• Configurare l'autenticazione del mittente aggiungendo record SPF (Sender Policy Framework) e DomainKeys Identified Mail (DKIM).

Creare una risorsa di dominio

Per creare una risorsa di dominio, accedere all'account Azure usando il Connect-AzAccount comando seguente e specificare le credenziali.

PS C:\> Connect-AzAccount

Prima di tutto, assicurarsi di installare il modulo Az.Communication Servizi di comunicazione di Azure usando il comando seguente.

PS C:\> Install-Module Az.Communication

Eseguire il comando seguente per creare la risorsa dominio gestito personalizzato:

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

È possibile configurare la risorsa di dominio con le opzioni seguenti:

• Gruppo di risorse
• Nome della risorsa servizi di comunicazione di posta elettronica.
• Nome della risorsa dominio.
• Valore della proprietà Gestione dominio.
  • Per Domini personalizzati, il valore deve essere "CustomerManaged".

Nel passaggio successivo è possibile assegnare tag o aggiornare il rilevamento dell'engagement degli utenti alla risorsa di dominio. I tag possono essere usati per organizzare le risorse di dominio. Per altre informazioni sui tag, vedere la documentazione relativa all'assegnazione di tag a una risorsa.

Gestire la risorsa di dominio

Per aggiungere tag o aggiornare il rilevamento dell'engagement degli utenti alla risorsa di dominio, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.

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

Per elencare tutte le risorse di dominio in un determinato servizio di comunicazione tramite posta elettronica, usare il comando seguente:

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

Per elencare tutte le informazioni su una determinata risorsa di dominio, usare il comando seguente:

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

Operazione di verifica per la risorsa di dominio

Per configurare l'autenticazione del mittente per i domini, vedere Configurare l'autenticazione del mittente per il dominio personalizzato nella scheda portale di Azure.

Avviare la verifica

Per richiamare la verifica del dominio, eseguire il comando seguente:

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

Annulla verifica

Per arrestare la verifica del dominio, eseguire il comando seguente:

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

Pulire una risorsa di dominio

Se si vuole pulire e rimuovere una risorsa di dominio, è possibile eliminare la risorsa di dominio eseguendo il comando seguente:

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