Configurar un servidor SMTP

Aneu a Administració > SMTP.

Configuració bàsica

  • Adreça: adreça del servidor SMTP
  • Port: port que s’utilitza per comunicar-se amb el servidor SMTP
  • Xifratge: xifratge de la connexió al servidor SMTP (STARTTLS, TLS o Sense xifrar)
  • Domini: domini del servidor SMTP
  • Autenticació: mètode d’autenticació amb el servidor SMTP (PLAIN, LOGIN, CRAM-MD5 o OAuth 2.0 (Microsoft 365))
  • Nom d’usuari: nom d’usuari que s’utilitza per establir la connexió amb el servidor SMTP
  • Contrasenya: contrasenya del nom d’usuari indicat anteriorment
  • Credencial d’Azure: credencial desada que proporciona el testimoni d’accés, en lloc de la contrasenya, amb l’autenticació OAuth 2.0 (Microsoft 365)
  • Remitent: adreça electrònica que utilitzarà la instància de Cyberwatch

Configuració d’un servidor sense autenticació

Per configurar un servidor SMTP sense autenticació, n’hi ha prou de deixar buits els camps Nom d'usuari i Contrasenya.

Si hi ha algun problema, podeu suprimir la configuració actual amb el botó Suprimeix i, a continuació, tornar a crear la configuració que vulgueu.

Autenticació OAuth 2.0 amb Microsoft 365

Microsoft retira l’autenticació SMTP amb contrasenya a Exchange Online (calendari). Amb l’autenticació OAuth 2.0 (Microsoft 365), Cyberwatch obté un testimoni d’accés de Microsoft Entra ID per a una aplicació registrada al vostre inquilí i, a continuació, s’autentica amb aquest testimoni davant del servidor SMTP.

La configuració es fa en tres passos: l’aplicació a Microsoft Entra ID, el seu accés a la bústia a Exchange Online i, finalment, el formulari SMTP de Cyberwatch.

Crear l’aplicació a Microsoft Entra ID

  1. Des del centre d’administració de Microsoft Entra, al menú App registrations, creeu un registre d’aplicació nou, amb el tipus de compte Accounts in this organizational directory only
  2. Anoteu l’Application (client) ID i el Directory (tenant) ID, que es mostren a la pàgina Overview de l’aplicació
  3. A Certificates & secrets, creeu un secret de client (client secret). També us podeu autenticar amb un certificat generat per Cyberwatch, tal com es descriu a Configurar els accessos a l’API
  4. A API permissions, feu clic a Add a permission i, a continuació, a la pestanya APIs my organization uses, cerqueu Office 365 Exchange Online
  5. Feu clic a Application permissions, marqueu SMTP.SendAsApp i, a continuació, feu clic a Add permissions
  6. Concediu el consentiment de l’administrador per a aquest permís des de la mateixa pàgina

Autoritzar l’accés a la bústia a Exchange Online

A continuació, cal registrar l’entitat de servei de l’aplicació a Exchange Online i donar-li accés a la bústia d’enviament. Aquestes operacions es fan amb el mòdul de PowerShell ExchangeOnlineManagement:

Install-Module -Name ExchangeOnlineManagement
Connect-ExchangeOnline -Organization <TENANT_ID>
New-ServicePrincipal -AppId <APPLICATION_ID> -ObjectId <OBJECT_ID> -DisplayName "Cyberwatch SMTP"
Get-ServicePrincipal -Identity "Cyberwatch SMTP" | Format-List
Add-MailboxPermission -Identity "cyberwatch@contoso.com" -User <SERVICE_PRINCIPAL_ID> -AccessRights FullAccess

On:

  • <TENANT_ID>: l’identificador del directori o inquilí (Directory (tenant) ID)
  • <APPLICATION_ID>: l’identificador de l’aplicació o client (Application (client) ID)
  • <OBJECT_ID>: l’identificador d’objecte (Object ID) que es mostra al menú Enterprise applications, a la pàgina Overview de l’aplicació
  • <SERVICE_PRINCIPAL_ID>: el valor del camp Identity que retorna Get-ServicePrincipal
  • cyberwatch@contoso.com: l’adreça de la bústia d’enviament

L’identificador d’objecte que cal utilitzar és el de l’aplicació empresarial, i no el del registre de l’aplicació. Amb un identificador d’objecte incorrecte, l’autenticació falla.

Si l’adreça indicada al camp Remitent de Cyberwatch és diferent de la bústia d’enviament, autoritzeu també l’aplicació a enviar en nom d’aquest remitent:

Add-RecipientPermission -Identity <EXPEDITEUR> -Trustee <SERVICE_PRINCIPAL_ID> -AccessRights SendAs

Si l’autenticació SMTP (SMTP AUTH) està desactivada a nivell de l’inquilí, activeu-la per a la bústia d’enviament:

Set-CASMailbox -Identity "cyberwatch@contoso.com" -SmtpClientAuthenticationDisabled $false

Configurar Cyberwatch

  1. A Paràmetres > Credencials desades, creeu una credencial de tipus Microsoft Entra ID (Azure o Microsoft 365), amb l’identificador de l’inquilí, l’identificador de l’aplicació (client) i el secret de client, tal com es descriu a Configurar els accessos a l’API. En una instància desplegada a AKS, la credencial també es pot autenticar amb Azure Workload Identity

  2. Aneu a Administració > SMTP i ompliu els camps següents:

    CampValor
    Adreçasmtp.office365.com
    Port587
    XifratgeSTARTTLS
    AutenticacióOAuth 2.0 (Microsoft 365)
    Nom d’usuariL’adreça de la bústia d’enviament
    Credencial d’AzureLa credencial creada al pas anterior
  3. Feu clic a Desa
  4. Envieu un correu electrònic de prova des de la secció Envia un correu de prova

La sol·licitud del testimoni d’accés passa pel servidor intermediari configurat a Administració > Servidor intermediari, tret que la credencial tingui l’opció per evitar el servidor intermediari. En canvi, la connexió amb el servidor SMTP no passa pel servidor intermediari.

No es pot suprimir una credencial utilitzada per la configuració SMTP.

Errors freqüents

Si falla, el correu electrònic de prova mostra el missatge que retorna Microsoft:

  • HTTP 401: AADSTS7000215: Invalid client secret…: el secret de client de la credencial no és vàlid o ha caducat
  • 535 5.7.3 Authentication unsuccessful: l’entitat de servei no està registrada a Exchange Online, s’ha registrat amb un identificador d’objecte incorrecte o no té accés a la bústia d’enviament