Partager via


Démarrage rapide : comment ajouter des domaines de courrier vérifiés personnalisés

Dans ce guide de démarrage rapide, vous découvrez comment approvisionner un domaine de courrier vérifié personnalisé dans Azure Communication Services.

Prérequis

Approvisionner un domaine personnalisé

Pour provisionner un domaine personnalisé, vous devez :

  • Vérifiez la propriété du domaine personnalisé en ajoutant un enregistrement TXT dans votre DNS (Domain Name System).
  • Configurez l’authentification de l’expéditeur en ajoutant des enregistrements SPF (Sender Policy Framework) et DomainKeys Identified Mail (DKIM).

Vérifier un domaine personnalisé

Dans cette section, vous allez vérifier la propriété du domaine personnalisé en ajoutant un enregistrement TXT dans votre DNS.

  1. Ouvrez la page de présentation de la ressource du service de communication par e-mail que vous avez créée dans Bien démarrer avec la création d’une ressource de communication par e-mail.

  2. Créez un domaine personnalisé à l’aide de l’une des options suivantes.

    • (Option 1) Cliquez sur le bouton Configurer sous Configurer un domaine personnalisé. Passez à l’étape 3.

      Capture d’écran montrant comment configurer un domaine personnalisé.

    • (Option 2) Cliquez sur Provisionner des domaines dans le volet de navigation gauche.

      Capture d’écran montrant le lien de navigation vers la page Provisionner des domaines.

    • Cliquez sur Ajouter un domaine dans le volet de navigation du haut.

    • Sélectionnez Domaine personnalisé dans la liste déroulante.

  3. Cliquez sur Ajouter un domaine personnalisé.

  4. Entrez votre nom de domaine dans la zone de texte.

  5. Entrez de nouveau votre nom de domaine dans la zone de texte suivante.

  6. Cliquez sur Confirmer.

    Capture d'écran montrant où entrer la valeur du domaine personnalisé.

  7. Vérifiez que le nom de domaine que vous avez entré est correct et que les deux zones de texte sont identiques. Si nécessaire, cliquez sur Modifier pour corriger le nom de domaine avant de confirmer.

  8. Cliquez sur Ajouter.

    Capture d’écran montrant comment ajouter le domaine personnalisé de votre choix.

  9. Azure Communication Services crée une configuration de domaine personnalisée pour votre domaine.

    Capture d’écran montrant la progression du déploiement d’un domaine personnalisé.

  10. Pour vérifier la propriété du domaine, cliquez sur Vérifier le domaine.

    Capture d’écran montrant la réussite de l’ajout du domaine personnalisé pour vérification. .

  11. Pour reprendre la vérification ultérieurement, cliquez sur Fermer et reprendre. Ensuite, pour continuer la vérification à partir de domaines d’approvisionnement, cliquez sur Configurer.

    Capture d’écran montrant le domaine ajouté prêt pour vérification dans la liste des domaines provisionnés.

  12. Lorsque vous sélectionnez Vérifier le domaine ou Configurer, cela ouvre la boîte de dialogue Vérifier le domaine via l’enregistrement TXT .

    Capture d’écran montrant le lien Configurer sur lequel cliquer pour vérifier la propriété du domaine.

  13. Ajoutez l’enregistrement TXT précédent au bureau d’enregistrement ou au fournisseur d’hébergement DNS de votre domaine. Reportez-vous à la section enregistrements TXT pour plus d’informations sur l’ajout d’un enregistrement TXT pour votre fournisseur DNS.

    Lorsque vous avez terminé cette étape, cliquez sur Suivant.

  14. Vérifiez que l’enregistrement TXT a été correctement créé dans votre DNS, puis cliquez sur Terminé.

  15. Les modifications de DNS peuvent prendre entre 15 et 30 minutes. Cliquez sur Fermer.

    Capture d’écran montrant que la vérification du domaine est en cours.

  16. Une fois votre domaine vérifié, vous pouvez ajouter vos enregistrements SPF et DKIM pour authentifier vos domaines.

    Capture d’écran montrant le domaine personnalisé vérifié.

Configurer l’authentification de l’expéditeur pour un domaine personnalisé

Pour configurer l’authentification de l’expéditeur pour vos domaines, des enregistrements DNS supplémentaires doivent être ajoutés à votre domaine. Cette section décrit comment Azure Communication Services vous propose des enregistrements à ajouter à votre DNS. Cependant, selon si le domaine que vous inscrivez est un domaine racine ou un sous-domaine, vous devrez ajouter les enregistrements à la zone correspondante ou apporter des modifications aux enregistrements générés automatiquement.

Cette section montre comment ajouter des enregistrements SPF et DKIM pour le domaine personnalisé sales.us.notification.azurecommtest.net. Les exemples suivants décrivent quatre méthodes différentes pour ajouter ces enregistrements au DNS, en fonction du niveau de la zone où vous ajoutez les enregistrements.

  1. Zone : sales.us.notification.azurecommtest.net
Enregistrement Type Nom Valeur
SPF TXT sales.us.notification.azurecommtest.net v=spf1 include:spf.protection.outlook.com -all
DKIM CNAME selector1-azurecomm-prod-net._domainkey selector1-azurecomm-prod-net._domainkey.azurecomm.net
DKIM2 CNAME selector2-azurecomm-prod-net._domainkey selector2-azurecomm-prod-net._domainkey.azurecomm.net

Les enregistrements générés par le portail considèrent que vous ajoutez ces enregistrements au DNS dans cette zone sales.us.notification.azurecommtest.net.

  1. Zone : us.notification.azurecommtest.net
Enregistrement Type Nom Valeur
SPF TXT sales v=spf1 include:spf.protection.outlook.com -all
DKIM CNAME selector1-azurecomm-prod-net._domainkey.sales selector1-azurecomm-prod-net._domainkey.azurecomm.net
DKIM2 CNAME selector2-azurecomm-prod-net._domainkey.sales selector2-azurecomm-prod-net._domainkey.azurecomm.net
  1. Zone : notification.azurecommtest.net
Enregistrement Type Nom Valeur
SPF TXT sales.us v=spf1 include:spf.protection.outlook.com -all
DKIM CNAME selector1-azurecomm-prod-net._domainkey.sales.us selector1-azurecomm-prod-net._domainkey.azurecomm.net
DKIM2 CNAME selector2-azurecomm-prod-net._domainkey.sales.us selector2-azurecomm-prod-net._domainkey.azurecomm.net
  1. Zone : azurecommtest.net
Enregistrement Type Nom Valeur
SPF TXT sales.us.notification v=spf1 include:spf.protection.outlook.com -all
DKIM CNAME selector1-azurecomm-prod-net._domainkey.sales.us.notification selector1-azurecomm-prod-net._domainkey.azurecomm.net
DKIM2 CNAME selector2-azurecomm-prod-net._domainkey.sales.us.notification selector2-azurecomm-prod-net._domainkey.azurecomm.net

Ajout d’enregistrements SPF et DKIM

Dans cette section, vous allez configurer l’authentification de l’expéditeur en ajoutant des enregistrements SPF (Sender Policy Framework) et DomainKeys Identified Mail (DKIM).

  1. Accédez à Provisionner des domaines et vérifiez que l’État du domaine est sur Verified.

  2. Pour ajouter des informations SPF et DKIM, cliquez sur Configurer.

  3. Ajoutez l’enregistrement TXT et les enregistrements CNAME suivants au bureau d’enregistrement ou au fournisseur d’hébergement DNS de votre domaine. Pour obtenir des informations sur la procédure d’ajout d’un enregistrement TXT et CNAME pour votre fournisseur DNS, consultez l’ajout d’enregistrements DNS dans une table des bureaux d’enregistrement de domaines les plus utilisés.

    Capture d’écran montrant les enregistrements DNS que vous devez ajouter pour une validation SPF de vos domaines vérifiés.Capture d’écran montrant les enregistrements DNS que vous devez ajouter pour DKIM.Capture d’écran montrant les enregistrements DNS que vous devez ajouter pour des enregistrements DKIM supplémentaires.

  4. Lorsque vous avez terminé d’ajouter des informations TXT et CNAME, cliquez sur Suivant pour continuer.

  5. Vérifiez que les enregistrements TXT et CNAME ont été créés correctement dans votre DNS. Cliquez ensuite sur Terminé.

    Capture d’écran montrant les enregistrements DNS que vous devez ajouter pour S P F et D K I M.

  6. Les modifications du DNS prennent effet en 15 à 30 minutes. Cliquez sur Fermer puis attendez que la vérification se termine.

    Capture d’écran montrant que la vérification de l’authentification de l’expéditeur est en cours.

  7. Vous pouvez consulter l’état de la vérification dans la page Approvisionner des domaines.

    Capture d’écran montrant que la vérification de l’authentification de l’expéditeur est terminée.

  8. Une fois vos configurations d’authentification de l’expéditeur vérifiées, votre domaine de messagerie est prêt à envoyer des e-mails en utilisant le domaine personnalisé.

    Capture d’écran montrant que votre domaine personnalisé vérifié est prêt à envoyer des e-mails.

Prérequis

Approvisionner un domaine personnalisé

Pour provisionner un domaine personnalisé, vous devez :

  • Vérifiez la propriété du domaine personnalisé en ajoutant un enregistrement TXT dans votre DNS (Domain Name System).
  • Configurez l’authentification de l’expéditeur en ajoutant des enregistrements SPF (Sender Policy Framework) et DomainKeys Identified Mail (DKIM).

Create une ressource de domaine

Pour créer une ressource de domaine, connectez-vous à Azure CLI. Vous pouvez vous connecter en exécutant la commande az login à partir du terminal et fournir vos informations d’identification. Pour créer la ressource, exécutez la commande suivante :

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

Si vous souhaitez sélectionner un abonnement particulier, vous pouvez également spécifier l’indicateur --subscription et fournir l’ID d’abonnement.

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

Vous pouvez configurer votre ressource de domaine avec les options suivantes :

  • Le groupe de ressources
  • Nom de la ressource Email Communication Services.
  • Zone géographique à laquelle associer la ressource.
  • Le nom du domaine de ressource.
  • Valeur de la propriété de gestion de domaine.
    • Pour les domaines personnalisés, la valeur doit être : CustomerManaged.

À l’étape suivante, vous pouvez affecter des balises ou mettre à jour le suivi de l’engagement utilisateur vers la ressource de domaine. Les étiquettes peuvent être utiles pour organiser vos domaines de ressources. Pour plus d’informations sur les étiquettes, consultez la documentation sur l’étiquetage des ressources.

Gérer les ressources de votre domaine

Pour ajouter des balises ou mettre à jour le suivi de l’engagement utilisateur à votre ressource de domaine, exécutez les commandes suivantes. Vous pouvez également cibler un abonnement spécifique.

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

Pour dresser la liste de toutes les ressources de votre domaine dans un service de communication par e-mail donné, utilisez la commande suivante :

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

Pour afficher toutes les informations d’un domaine de ressource spécifique, utilisez la commande suivante :

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

Opération de vérification pour votre ressource de domaine

Pour configurer l’authentification de l’expéditeur pour vos domaines, reportez-vous à la section Configurer l’authentification de l’expéditeur pour un domaine personnalisé à partir de l’onglet Portail Azure.

Lancer la vérification

Pour lancer la vérification du domaine, exécutez la commande ci-dessous :

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

Annuler la vérification

Pour annuler la vérification du domaine, exécutez la commande ci-dessous :

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

Nettoyer une ressource de domaine

Si vous souhaitez nettoyer et supprimer une ressource de domaine, vous pouvez supprimer en exécutant la commande suivante.

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

Remarque

La suppression d’une ressource est définitive, et aucune donnée, y compris les filtres d’événements, les numéros de téléphone ou autres informations liées à la ressource, ne peut être récupérée une fois la ressource supprimée.

Pour plus d’informations sur d’autres commandes, consultez la CLI de domaine.

Prérequis

Approvisionner un domaine personnalisé

Pour provisionner un domaine personnalisé, vous devez :

  • Vérifiez la propriété du domaine personnalisé en ajoutant un enregistrement TXT dans votre DNS (Domain Name System).
  • Configurez l’authentification de l’expéditeur en ajoutant des enregistrements SPF (Sender Policy Framework) et DomainKeys Identified Mail (DKIM).

Installation du SDK

Tout d’abord, incluez le SDK Communication Services Management dans votre projet C# :

using Azure.ResourceManager.Communication;

Identifiant d’abonnement

Vous devez connaître l’ID de votre abonnement Azure. Vous pouvez l’obtenir à partir du portail :

  1. Connectez-vous à votre compte Azure
  2. Sélectionnez Abonnements dans la barre latérale gauche
  3. Sélectionnez l’abonnement à utiliser
  4. Cliquez sur Vue d’ensemble
  5. Sélectionnez votre ID d’abonnement

Dans ce guide de démarrage rapide, nous supposons que vous avez stocké l’ID d’abonnement dans une variable d’environnement appelée AZURE_SUBSCRIPTION_ID.

Authentification

Pour communiquer avec une ressource de domaine, vous devez d’abord vous authentifier auprès d’Azure.

Authentifier le client

L’option par défaut permettant de créer un client authentifié consiste à utiliser DefaultAzureCredential. Du fait que toutes les API de gestion passent par le même point de terminaison, vous ne devez créer qu’un seul ArmClient de niveau supérieur pour interagir avec des ressources.

Pour vous authentifier à Azure et créer un ArmClient, effectuez le code suivant :

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

Interaction avec des ressources Azure

Vous êtes maintenant authentifié(e).

Pour chacun des exemples suivants, nous affecterons nos ressources de domaine à un service de communication par e-mail existant.

Si vous devez créer un service de communication par e-mail, vous pouvez le faire à l’aide du portail Azure.

Create une ressource de domaine

Lors de la création d’une ressource Domaine, vous devez spécifier le nom du groupe de ressources, le nom du service de communication par courriel, le nom de la ressource et DomainManagement.

Remarque

La propriété Location a toujours la valeur 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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}");

Gérer les ressources de votre domaine

Mettre à jour une ressource de domaine

...
// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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}");

Répertorier par service d- e-mail

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Obtenir des ressources de domaine

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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}");

Opération de vérification pour votre ressource de domaine

Pour configurer l’authentification de l’expéditeur pour vos domaines, reportez-vous à la section Configurer l’authentification de l’expéditeur pour un domaine personnalisé à partir de l’onglet Portail Azure.

Lancer la vérification

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Annuler la vérification

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Nettoyer une ressource de domaine

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Remarque

La suppression d’une ressource est définitive, et aucune donnée, y compris les filtres d’événements, les numéros de téléphone ou autres informations liées à la ressource, ne peut être récupérée une fois la ressource supprimée.

Prérequis

Approvisionner un domaine personnalisé

Pour provisionner un domaine personnalisé, vous devez :

  • Vérifiez la propriété du domaine personnalisé en ajoutant un enregistrement TXT dans votre DNS (Domain Name System).
  • Configurez l’authentification de l’expéditeur en ajoutant des enregistrements SPF (Sender Policy Framework) et DomainKeys Identified Mail (DKIM).

Create une ressource de domaine

Pour créer une ressource de domaine, connectez-vous à votre compte Azure en utilisant la Connect-AzAccount à l’aide de la commande suivante et fournissez vos informations d’identification.

PS C:\> Connect-AzAccount

Tout d’abord, assurez-vous d’installer le module Azure Communication Services Az.Communication à l’aide de la commande suivante.

PS C:\> Install-Module Az.Communication

Exécutez la commande suivante pour créer la ressource de domaine géré personnalisée :

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

Vous pouvez configurer votre ressource de domaine avec les options suivantes :

  • Le groupe de ressources
  • Nom de la ressource Email Communication Services.
  • Le nom du domaine de ressource.
  • Valeur de la propriété de gestion de domaine.
    • Pour les domaines personnalisés, la valeur doit être : « CustomerManaged ».

À l’étape suivante, vous pouvez affecter des balises ou mettre à jour le suivi de l’engagement utilisateur vers la ressource de domaine. Les étiquettes peuvent être utiles pour organiser vos domaines de ressources. Pour plus d’informations sur les étiquettes, consultez la documentation sur l’étiquetage des ressources.

Gérer les ressources de votre domaine

Pour ajouter des balises ou mettre à jour le suivi de l’engagement utilisateur à votre ressource de domaine, exécutez les commandes suivantes. Vous pouvez également cibler un abonnement spécifique.

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

Pour dresser la liste de toutes les ressources de votre domaine dans un service de communication par e-mail donné, utilisez la commande suivante :

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

Pour afficher toutes les informations d’un domaine de ressource spécifique, utilisez la commande suivante :

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

Opération de vérification pour votre ressource de domaine

Pour configurer l’authentification de l’expéditeur pour vos domaines, reportez-vous à la section Configurer l’authentification de l’expéditeur pour un domaine personnalisé à partir de l’onglet Portail Azure.

Lancer la vérification

Pour invoquer la vérification du domaine, exécutez la commande ci-dessous :

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

Annuler la vérification

Pour arrêter la vérification du domaine, exécutez la commande ci-dessous :

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

Nettoyer une ressource de domaine

Si vous souhaitez nettoyer et supprimer une ressource de domaine, vous pouvez supprimer votre ressource de domaine en exécutant la commande suivante :

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

Remarque

La suppression d’une ressource est définitive, et aucune donnée, y compris les filtres d’événements, les numéros de téléphone ou autres informations liées à la ressource, ne peut être récupérée une fois la ressource supprimée.

Domaines managés Azure comparés aux domaines personnalisés

Avant d’approvisionner un domaine de courrier personnalisé, examinez le tableau suivant pour déterminer le type de domaine le mieux adapté à vos besoins.

Domaines managés Azure Domaines personnalisés
Avantages : – L’installation est rapide et facile
– Aucune vérification de domaine requise
– Les e-mails sont envoyés à partir de votre propre domaine
Inconvénients : – Le domaine de l’expéditeur n’est pas personnalisé et ne peut pas être modifié
– Les noms d’utilisateur des expéditeurs ne peuvent pas être personnalisés
– Volume d’envoi limité
– Le suivi d’engagement utilisateur ne peut pas être activé
– Nécessite une vérification des enregistrements de domaine
– Configuration plus longue pour la vérification

Limites du service

Les domaines managés Azure et les domaines personnalisés sont soumis à des limites de service. Les limites de service incluent les limites d’échec, de taux et de taille. Pour plus d’informations, consultez Limites de service pour Azure Communication Services > Email.

Modifiez « Courrier reçu de » et le nom d’affichage DE pour les domaines personnalisés

Vous pouvez éventuellement configurer votre adresse MailFrom pour qu’elle ne corresponde pas à l’adresse DoNotReply par défaut, et également ajouter plusieurs noms d’utilisateur d’expéditeur à votre domaine. Pour mieux comprendre comment configurer votre adresse d’expéditeur, consultez Démarrage rapide : comment ajouter plusieurs adresses d’expéditeur.

Votre domaine de messagerie est maintenant prêt à envoyer des e-mails.

Enregistrements TXT

Les liens suivants fournissent des instructions sur la façon d’ajouter un enregistrement TXT avec les bureaux d’enregistrement de domaines courants.

Nom du bureau d’enregistrement Lien vers la documentation
IONOS par 1 & 1 Étapes 1-7
123-reg.co.uk Étapes 1-6
Amazon Web Services (AWS) Étapes 1-8
Cloudflare Étapes 1-6
GoDaddy Étapes 1-6
Namecheap Étapes 1-9
Network Solutions Étapes 1-9
OVH Étapes 1-9
web.com Étapes 1-8
Wix Étapes 1-5
Autre (Général) Étapes 1-4

Enregistrements CNAME

Les liens suivants fournissent des informations complémentaires sur la façon d’ajouter un enregistrement CNAME avec les bureaux d’enregistrement de domaines courants. Veillez à utiliser vos valeurs de la fenêtre de configuration plutôt que les exemples du le lien de documentation.

Nom du bureau d’enregistrement Lien vers la documentation
IONOS par 1 & 1 Étapes 1-10
123-reg.co.uk Étapes 1-6
Amazon Web Services (AWS) Étapes 1-8
Cloudflare Étapes 1-6
GoDaddy Étapes 1-6
Namecheap Étapes 1-8
Network Solutions Étapes 1-9
OVH Étapes 1-8
web.com Étapes 1-8
Wix Étapes 1-5
Autre (Général) Guide

Étapes suivantes