Merge pull request #258546 from ddouglas-msft/user/ddouglas-msft/smtp-quickstart-update

[ACS Email Quickstart and Concepts] Add traffic source and dot delimiter

Author: prmerger-automator[bot]

articles/communication-services/concepts/analytics/logs/email-logs.md

@@ -74,6 +74,7 @@ Communication Services offers the following types of logs that you can enable:
 | `BccRecipientsCount` | The total # of unique email addresses on the Bcc line. |
 | `UniqueRecipientsCount` | This is the deduplicated total recipient count for the To, Cc, and Bcc address fields. |
 | `AttachmentsCount` | The total # of attachments. |
+| `TrafficSource` | The name of the client where the email request originated from. |
 
 **Samples**
 
@@ -86,7 +87,8 @@ Communication Services offers the following types of logs that you can enable:
   "CcRecipientsCount":3, 
   "BccRecipientsCount":1, 
   "UniqueRecipientsCount":6, 
-  "AttachmentsCount":0
+  "AttachmentsCount":0,
+  "TrafficSource":"Email .NET SDK"
 }
 ```
 

articles/communication-services/quickstarts/email/send-email-smtp/smtp-authentication.md

@@ -67,20 +67,25 @@ When assigning the Entra application a role for the Azure Communication Services
 
 ### Creating the SMTP credentials from the Entra application information.
 #### SMTP Authentication Username
-Azure Communication Services allows the credentials for an Entra application to be used as the SMTP username and password. The username consists of three pipe-delimited parts.
+Azure Communication Services allows the credentials for an Entra application to be used as the SMTP username and password. The username consists of the following three parts and can be pipe or dot delimited.
 1. The Azure Communication Service Resource name.
     :::image type="content" source="../media/email-smtp-resource-name.png" alt-text="Screenshot that shows finding the resource name.":::
 1. The Entra Application ID.
     :::image type="content" source="../media/email-smtp-entra-details.png" alt-text="Screenshot that shows finding the Entra Application ID.":::
 1. The Entra Tenant ID.
     :::image type="content" source="../media/email-smtp-entra-tenant.png" alt-text="Screenshot that shows finding the Entra Tenant ID.":::
 
-**Format:**
+**Dot-delimited Format:**
+```
+username: <Azure Communication Services Resource name>.<Entra Application ID>.<Entra Tenant ID>
+```
+**Pipe-delimited Format:**
 ```
 username: <Azure Communication Services Resource name>.<Entra Application ID>.<Entra Tenant ID>
 OR
 username: <Azure Communication Services Resource name>|<Entra Application ID>|<Entra Tenant ID>
 ```
+
 #### SMTP Authentication Password
 The password is one of the Entra application's client secrets.
     :::image type="content" source="../media/email-smtp-entra-secret.png" alt-text="Screenshot that shows finding the Entra client secret.":::
@@ -90,7 +95,7 @@ The password is one of the Entra application's client secrets.
 - **Authentication**: Username and password authentication is supported using Entra application details as the credentials. The Azure Communication Services SMTP service will use the Entra application details to get an access token on behalf of the user and use that to submit the email. Because the Entra token isn't cached, access can be revoked immediately by either changing the Entra application client secret or by changing the access controls for the Azure Communication Services Resource.
 - **Azure Communication Service**: An Azure Communication Services Resource with a connected Azure Communication Email Resource and domain is required.
 - **Transport Layer Security (TLS)**: Your device must be able to use TLS version 1.2 and above.
-- **Port**: Port 587 (recommended) or port 25 is required and must be unblocked on your network. Some network firewalls or ISPs block ports, especially port 25, because that's the port that email servers use to send mail.
+- **Port**: Port 587 is required and must be unblocked on your network. Some network firewalls or ISPs block ports because that's the port that email servers use to send mail.
 - **DNS**: Use the DNS name smtp.azurecomm.net. Don't use an IP address for the Microsoft 365 or Office 365 server, as IP Addresses aren't supported.
 
 ### How to set up SMTP AUTH client submission
@@ -100,6 +105,6 @@ Enter the following settings directly on your device or in the application as th
 | Device or Application setting | Value |
 |--|--|
 |Server / smart host | smtp.azurecomm.net |
-|Port |Port 587 (recommended) or port 25|
+|Port |Port 587|
 |TLS / StartTLS | Enabled|
 |Username and password | Enter the Entra application credentials from an application with access to the Azure Communication Services Resource |