diff --git a/pages/assets/screens/control_panel/product-selection/web-cloud/zimbra/domain/diagnostics/access.png b/pages/assets/screens/control_panel/product-selection/web-cloud/zimbra/domain/diagnostics/access.png
new file mode 100644
index 00000000000..bd0f49dfb59
Binary files /dev/null and b/pages/assets/screens/control_panel/product-selection/web-cloud/zimbra/domain/diagnostics/access.png differ
diff --git a/pages/assets/screens/control_panel/product-selection/web-cloud/zimbra/domain/diagnostics/dkim-cname-conf.png b/pages/assets/screens/control_panel/product-selection/web-cloud/zimbra/domain/diagnostics/dkim-cname-conf.png
new file mode 100644
index 00000000000..7888e2c61ea
Binary files /dev/null and b/pages/assets/screens/control_panel/product-selection/web-cloud/zimbra/domain/diagnostics/dkim-cname-conf.png differ
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.de-de.md b/pages/web_cloud/domains/dns_zone_dkim/guide.de-de.md
index 3aea742bf85..33562a7f660 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.de-de.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.de-de.md
@@ -1,7 +1,7 @@
---
title: E-Mail-Sicherheit durch DKIM-Eintrag verbessern
excerpt: Erfahren Sie hier, wie Sie einen DKIM-Eintrag für Domainnamen und E-Mail-Dienste bei OVHcloud einrichten
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
## Ziel
@@ -46,10 +57,11 @@ Der DKIM-Eintrag (**D**omain**K**eys **I**dentified **M**ail) ermöglicht die Si
- Sie haben über das [OVHcloud Kundencenter](/links/manager) Zugriff auf die Konfiguration des betreffenden Domainnamens oder entsprechenden Verwaltungszugriff bei Ihrem DNS-Anbieter, wenn der Domainname nicht über OVHcloud registriert ist.
- Sie haben Zugriff auf Ihr [OVHcloud Kundencenter](/links/manager).
-- Sie verfügen über einen der folgenden E-Mail-Dienste:
+- Eine der folgenden E-Mail-Angebote abonniert haben:
- OVHcloud MX Plan E-Mail, verfügbar mit den Angeboten [Webhosting](/links/web/hosting), [Kostenloses Hosting 100M](/links/web/domains-free-hosting) oder als separater Dienst
- [Hosted Exchange](/links/web/emails-hosted-exchange) oder [Private Exchange](/links/web/emails-hosted-exchange)
- [E-Mail Pro](/links/web/email-pro)
+ - [Zimbra](/links/web/zimbra).
- Ein E-Mail-Angebot außerhalb von OVHcloud, das über DKIM verfügt
> [!warning]
@@ -70,15 +82,15 @@ Der DKIM-Eintrag (**D**omain**K**eys **I**dentified **M**ail) ermöglicht die Si
- [Warum müssen die DNS-Server konfiguriert werden?](#dns-and-dkim)
- [Beispiel einer unter Verwendung von DKIM gesendeten E-Mail](#example)
- [Was ist ein DKIM-Selektor?](#selector)
-- [DKIM automatisch für OVHcloud Exchange oder E-Mail Pro konfigurieren](#auto-dkim)
+- [DKIM automatisch für ein E-Mail-Angebot von OVHcloud konfigurierenn](#auto-dkim)
- [DKIM manuell für OVHcloud Exchange oder E-Mail Pro konfigurieren](#internal-dkim)
- - [Vollständige Konfiguration von DKIM](#firststep)
- - [Für E-Mails (MX Plan)](#confemail)
+ - [API - Vollständige Konfiguration von DKIM](#firststep)
+ - [Für MX Plan und Zimbra](#confemail)
- [Für Exchange](#confex)
- [Für E-Mail Pro](#confemp)
- - [Die verschiedenen DKIM-Zustände](#dkim-status)
- - [DKIM-Selektor aktivieren oder ändern](#enable-switch)
- - [DKIM deaktivieren und löschen](#disable-delete)
+ - [API - Die verschiedenen DKIM-Zustände](#dkim-status)
+ - [API - DKIM-Selektor aktivieren oder ändern](#enable-switch)
+ - [API - DKIM deaktivieren und löschen](#disable-delete)
- [DKIM für einen E-Mail-Dienst außerhalb Ihres OVHcloud Kunden-Accounts konfigurieren](#external-dkim)
- [DKIM-Eintrag](#dkim-record)
- [TXT-Eintrag](#txt-record)
@@ -93,7 +105,7 @@ Der DKIM-Eintrag (**D**omain**K**eys **I**dentified **M**ail) ermöglicht die Si
Um zu verstehen, wie DKIM Ihre E-Mail-Transaktionen absichern kann, muss erklärt werden, wie DKIM grundsätzlich funktioniert. DKIM verwendet **Hashing** und **Asymmetrische Verschlüsselung**, um eine sichere Signatur zu erstellen. Der **E-Mail-Dienst** und die **DNS-Zone** Ihrer Domain helfen, die DKIM-Informationen an Ihre Empfänger weiterzuleiten.
-#### Hashing
+/// details | Hashing
Das Prinzip einer **Hash-Funktion** ist, eine **Signatur** (auch *Fingerprint* genannt) aus Eingabedaten zu generieren. Das Ziel ist, eine feste Zeichenfolge als Ausgabe zu erhalten, unabhängig von der Menge der eingegebenen Daten.
@@ -103,7 +115,9 @@ Im folgenden Diagramm können Sie sehen, dass der Output unter Verwendung eines
Die Hash-Funktion ist nützlich zum Überprüfen der Integrität einer Nachricht. Unterschiede in Eingabedaten, die oberflächlich nicht auffallen, produzieren einen völlig unterschiedlichen Hashwert mit gleicher Zeichenlänge in der Ausgabe, unabhängig von der Eingabegröße.
-#### Asymmetrische Verschlüsselung
+///
+
+/// details |Asymmetrische Verschlüsselung
**Verschlüsselung** sorgt für die Chiffrierung der Eingabedaten. Sie ist **asymmetrisch**, da zum Ver- und Entschlüsseln der Nachricht nicht derselbe Schlüssel verwendet wird, im Gegensatz zu einer symmetrischen Verschlüsselung mit identischem Schlüssel.
@@ -119,17 +133,23 @@ Es gibt zwei Verwendungszwecke für asymmetrische Verschlüsselung:
{.thumbnail .w-400 .h-600}
-#### Wie werden asymmetrisches Hashing und Verschlüsselung für DKIM verwendet?
+///
+
+/// details | Wie werden asymmetrisches Hashing und Verschlüsselung für DKIM verwendet?
Für E-Mail-Dienste nutzt DKIM das Hashing-Verfahren, um eine Signatur aus einigen Elementen des [E-Mail-Headers](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) sowie des Inhalts der E-Mail (*Body*) zu erstellen.
Die Signatur wird dann mit dem privaten Schlüssel asymmetrisch verschlüsselt.
-#### Warum müssen die DNS Server konfiguriert werden?
+///
+
+/// details | Warum müssen die DNS Server konfiguriert werden?
Damit der Empfänger die DKIM-Signatur des Absenders überprüfen kann, benötigt er die DKIM-Parameter, insbesondere den öffentlichen Schlüssel, um die Signatur zu entschlüsseln. Die [DNS-Zone](/pages/web_cloud/domains/dns_zone_general_information) eines Domainnamens ist öffentlich verfügbar, deshalb wird, um den öffentlichen Schlüssel und die DKIM-Parameter an den Empfänger weiterzuleiten, ein DNS-Eintrag verwendet.
-#### Was ist ein DKIM-Selektor?
+///
+
+/// details | Was ist ein DKIM-Selektor?
Wenn Sie DKIM aktivieren, funktioniert es mit einem Schlüsselpaar. Es ist möglich, Ihrem Domainnamen mehrere Schlüsselpaare zuzuweisen, zum Beispiel mittels einer Rotation. Wenn Sie das Schlüsselpaar wechseln, muss das alte Paar so lange aktiv bleiben, bis alle mit dem alten Schlüssel versendete E-Mails den DKIM-Check beim Empfangsserver nicht mehr bestehen.
@@ -142,7 +162,9 @@ Damit dieses Prinzip der Rotation funktioniert, werden **DKIM-Selektoren** einge
Der Wert des Selektors ist hier `s=ovhex123456-selector`.
-#### Beispiel einer gesendeten E-Mail mit DKIM
+///
+
+/// details | Beispiel einer gesendeten E-Mail mit DKIM
Wenn Sie eine E-Mail über **contact@mydomain.ovh** versenden, wird dem Header der E-Mail eine mit privatem Schlüsssel verschlüsselte Signatur hinzugefügt.
@@ -152,13 +174,22 @@ Der Empfänger **recipient@otherdomain.ovh** kann diese Signatur mit dem in der
{.thumbnail .w-400 .h-600}
-### DKIM automatisch für OVHcloud Exchange oder E-Mail Pro konfigurieren
+///
-Die automatische DKIM-Konfiguration ist verfügbar für MX Plan E-Mail-Angebote (inklusive bei [Webhosting](/links/web/hosting), [Kostenloses Hosting 100M](/links/web/domains-free-hosting) oder separat bestellten), [Exchange](/links/web/emails) und [E-Mail Pro](/links/web/email-pro).
+### DKIM automatisch für ein E-Mail-Angebot von OVHcloud konfigurieren
-Standardmäßig ist DKIM nicht aktiviert, wenn Sie Ihrem Dienst einen Domainnamen hinzufügen. Starten Sie die automatische Konfiguration über das Kundencenter.
+Die automatische DKIM-Konfiguration ist für alle unsere E-Mail-Angebote verfügbar:
-Wählen Sie Ihr E-Mail-Angebot in den folgenden Tabs aus:
+- MX Plan inklusive [Cloud-Web-Hosting](/links/web/hosting), ein [kostenloses Hosting 100M](/links/web/domains-free-hosting) oder separat bestellt.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
+
+Wenn Sie Ihren Domainnamen auf einer E-Mail-Lösung von OVHcloud konfigurieren, wird die automatische DKIM-Konfiguration standardmäßig angeboten und durchgeführt, sofern Sie sie nicht deaktivieren.
+
+Wenn DKIM nicht aktiviert wurde, als Sie einen Domainnamen zu Ihrer E-Mail-Plattform hinzugefügt haben, müssen Sie den automatischen Konfigurationsprozess über das Kundencenter starten.
+
+Klicken Sie auf das unten stehende Registerblatt, das zu Ihrem Angebot passt.
> [!tabs]
> **E-Mails (MX Plan)**
@@ -169,10 +200,20 @@ Wählen Sie Ihr E-Mail-Angebot in den folgenden Tabs aus:
>> 1. Wählen Sie die betreffende Domain aus.
>> 1. Gehen Sie dann auf den Tab `Allgemeine Informationen`{.action}.
>>
->> Im Rahmen **Allgemeine Informationen** können Sie sehen, dass wird `DKIM` in rot unter **Diagnose** angezeigt wird.
+>> Im Bereich **Allgemeine Informationen** können Sie beobachten, dass die Schaltfläche `DKIM` rot unter der Bezeichnung **Diagnose** ist.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Um DKIM zu aktivieren, klicken Sie einfach auf die rote Schaltfläche `DKIM` und dann auf `Bestätigen`{.action} im Aktivierungsdialog, der angezeigt wird.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Falls Ihr Domainname nicht im gleichen OVHcloud Kundencenter wie Ihre E-Mail-Plattform verwaltet wird oder außerhalb von OVHcloud registriert ist, erhalten Sie das folgende Fenster:
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Dieses Fenster fordert Sie dazu auf, zwei CNAME-Werte in der DNS-Zone des Domainnamens einzugeben, wodurch dieser Domainname mit den DKIM-Selektoren Ihres E-Mail-Dienstes verknüpft wird. Sie müssen diese Werte eingeben und sicherstellen, dass sie verbreitet wurden, bevor Sie auf `Aktivieren`{.action} klicken.
+>>
> **Exchange**
>>
>> 1. Loggen Sie sich in Ihr [OVHcloud Kundencenter](/links/manager) ein.
@@ -181,9 +222,13 @@ Wählen Sie Ihr E-Mail-Angebot in den folgenden Tabs aus:
>> 1. Wählen Sie den gewünschten Dienst aus.
>> 1. Gehen Sie dann auf den Tab `Assoziierte Domains`{.action}.
>>
->> Rechts neben dem betreffenden Domainnamen wird `DKIM` in rot angezeigt.
+>> Rechts neben dem betreffenden Domainnamen können Sie beobachten, dass die Schaltfläche `DKIM` rot ist.
>>
->>{.thumbnail .w-400 .h-600}
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Um DKIM zu aktivieren, klicken Sie einfach auf die rote Schaltfläche `DKIM` und dann auf `Bestätigen`{.action} im Aktivierungsdialog, der angezeigt wird.
+>>
+>> {.thumbnail .w-400 .h-600}
>>
> **E-Mail Pro**
>>
@@ -193,32 +238,45 @@ Wählen Sie Ihr E-Mail-Angebot in den folgenden Tabs aus:
>> 1. Wählen Sie den gewünschten Dienst aus.
>> 1. Gehen Sie dann auf den Tab `Assoziierte Domains`{.action}.
>>
->> Rechts neben dem betreffenden Domainnamen wird `DKIM` in rot angezeigt.
+>> Rechts neben dem betreffenden Domainnamen können Sie beobachten, dass die Schaltfläche `DKIM` rot ist.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Um DKIM zu aktivieren, klicken Sie einfach auf die rote Schaltfläche `DKIM` und dann auf `Bestätigen`{.action} im Aktivierungsdialog, der angezeigt wird.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Melden Sie sich bei Ihrem [OVHcloud Kundencenter](/links/manager) an.
+>> 1. Gehen Sie in den Bereich `Web Cloud`{.action}.
+>> 1. Klicken Sie auf `Zimbra Mail`{.action}.
+>> 1. Gehen Sie schließlich zum Registerblatt `Domain`{.action}.
+>> 1. Klicken Sie rechts neben der betreffenden Domain auf `⁝`{.action}, und dann auf `Diagnostics`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
>>
->>{.thumbnail .w-400 .h-600}
+>> Rechts neben der Bezeichnung `DKIM` auf dem entsprechenden Registerblatt sollten Sie eine Warnung sehen, die anzeigt, dass DKIM fehlschlägt. Klicken Sie auf das Registerblatt `DKIM`{.action}, um den Status der DKIM-Konfiguration anzuzeigen. Um den Fehler zu beheben, müssen Sie zwei DNS-Einträge vom Typ CNAME in der DNS-Zone des zugeordneten Domainnamens hinzufügen oder ändern, basierend auf den Informationen, die in diesem Registerblatt sichtbar sind.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Tipp zur Erstellung eines CNAME-Eintrags**
+>> >
+>> > Melden Sie sich im [OVHcloud Kundencenter](/links/manager) an, in dem der Domainname Ihres E-Mail-Dienstes gehostet wird. Gehen Sie in den Bereich `Web Cloud`{.action}, klicken Sie auf `Domainnamen`{.action} in der linken Spalte und wählen Sie den betreffenden Domainnamen aus.
+>> > Wählen Sie das Registerblatt `DNS-Zone`{.action} und klicken Sie auf `Eintrag hinzufügen`{.action} im angezeigten Fenster. Wählen Sie `CNAME` und füllen Sie die Werte entsprechend den von Ihnen notierten Werten aus.
-Um den DKIM zu aktivieren, klicken Sie auf den roten Eintrag `DKIM` und dann im neuen Fenster auf `Bestätigen`{.action}.
+Um DKIM zu aktivieren, klicken Sie einfach auf die rote Schaltfläche `DKIM` und dann auf `Bestätigen`{.action} im Aktivierungsdialog, der angezeigt wird.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **E-Mails (MX Plan)**
->
-> Wenn Ihr Domainname nicht von derselben OVHcloud Kunden-Kennung wie Ihre E-Mail-Plattform verwaltet wird oder außerhalb von OVHcloud registriert ist, sehen Sie das folgende Fenster:
->
-> {.thumbnail .w-400 .h-600}
->
-> Sie werden dann aufgefordert, zwei CNAME-Werte in die DNS-Zone der Domain einzugeben, um die Domain mit den DKIM-Selektoren Ihres E-Mail-Dienstes zu verknüpfen. Sie müssen diese Werte eingeben und sicherstellen, dass sie weitergegeben werden, bevor Sie auf `Aktivieren`{.action} klicken.
->
-
-Die automatische Aktivierung des DKIM dauert zwischen 30 Minuten und 24 Stunden. Um zu überprüfen, dass Ihr DKIM funktioniert, gehen Sie in den Tab `Allgemeine Informationen`{.action} oder `Assoziierte Domains`{.action} Ihres E-Mail-Dienstes und stellen Sie sicher, dass die Anzeige von `DKIM` grün geworden ist.
+Die automatische DKIM-Aktivierung dauert zwischen 30 Minuten und maximal 24 Stunden. Um zu prüfen, ob Ihr DKIM funktioniert, kehren Sie einfach in den Bereich zur Domainverwaltung zurück, der in den oben genannten Registerblättern erwähnt wird, und stellen Sie sicher, dass die Schaltfläche `DKIM` grün ist oder, bei einer Zimbra-Angebot, dass das Registerblatt `DKIM` keine Warnung mehr anzeigt.
{.thumbnail .w-400 .h-600}
-Wenn nach 24 Stunden Ihr `DKIM` noch rot erscheint, lesen Sie den Abschnitt [Warum funktioniert der DKIM nicht und wird im Kundencenter rot angezeigt?](#reddkim) dieser Anleitung.
+Falls nach 24 Stunden die Schaltfläche `DKIM` immer noch rot ist, konsultieren Sie den Abschnitt [„Warum ist DKIM nicht funktional und erscheint rot im Kundencenter?“](#reddkim) in diesem Leitfaden.
-### DKIM manuell für ein E-Mail-Angebot von OVHcloud konfigurieren
+### DKIM per API für eine E-Mail von OVHcloud konfigurieren
Um Ihr DKIM zu konfigurieren müssen Sie zuerst die Dienst-Referenz (Dienstname) Ihres E-Mail-Dienstes abrufen.
@@ -253,18 +311,25 @@ Vergewissern Sie sich, dass der Domainname, den Sie für Ihre E-Mails verwenden
{.thumbnail .w-400 .h-600}
-#### Vollständige Konfiguration von DKIM
+#### API - Vollständige Konfiguration von DKIM
-Um DKIM zu konfigurieren, gehen Sie zur Seite und klicken Sie oben rechts auf `Login`{.action}. Geben Sie die Zugangsdaten Ihres OVHcloud Kunden-Accounts ein, um sich einzuloggen.
+Um DKIM zu konfigurieren, besuchen Sie die [OVHcloud API-Seite](/links/console) und melden Sie sich an:
-> Lesen Sie unsere Anleitung zur [Verwendung der API](/pages/manage_and_operate/api/first-steps), wenn Sie damit noch nicht vertraut sind.
+1. Klicken Sie auf `Authentication`{.action} oben links.
+1. Klicken Sie anschließend auf `Login with OVHcloud SSO`{.action}.
+1. Geben Sie Ihre OVHcloud-Anmeldeinformationen ein.
+1. Klicken Sie auf den Button `Authorize`{.action}, um die API-Aufrufe von dieser Website zu autorisieren.
-Öffnen Sie im API-Interface den Bereich `/email/domain/` (MX Plan) `/email/exchange` (Exchange) oder `/email/pro` (E-Mail Pro) und geben Sie "dkim" in das Feld `Filter` ein, um nur die Endpunkte anzuzeigen, die sich auf DKIM beziehen.
+> [!primary]
+>
+> Nutzen Sie unseren Leitfaden „[Erste Schritte mit den OVHcloud APIs](/pages/manage_and_operate/api/first-steps)“, falls Sie die APIs noch nie verwendet haben.
+
+Gehen Sie zu dem Abschnitt `/email/domain/` (Angebote MX Plan und Zimbra), `/email/exchange` (Angebot Exchange) oder `/email/pro` (Angebot E-mail Pro) der APIs und geben Sie „dkim“ in das Feld `Filter` ein, um nur die API-Funktionen anzuzeigen, die sich auf DKIM beziehen.
Klicken Sie auf den Tab für Ihren Dienst:
> [!tabs]
-> **E-Mails (MX Plan)**.
+> **MX Plan und Zimbra**
>>
>> {.thumbnail .w-400 .h-600}
>>
@@ -277,7 +342,7 @@ Klicken Sie auf den Tab für Ihren Dienst:
>> {.thumbnail .w-400 .h-600}
>>
-##### **Für MX Plan E-Mail**
+##### **Für MX Plan und Zimbra**
Folgen Sie den **5 Schritten**, indem Sie nacheinander auf die Tabs klicken:
@@ -591,7 +656,7 @@ Folgen Sie den **5 Schritten**, indem Sie auf jeden Tab klicken.
> **5. DKIM aktivieren**
>> > [!warning]
>> >
->> > Überprüfen Sie mithilfe des Abschnitts [**Die verschiedenen DKIM-Zustände**](#dkim-status) in dieser Anleitung, dass `status:` den Wert `ready` hat, bevor Sie DKIM aktivieren.
+>> > Überprüfen Sie mithilfe des Abschnitts [API - Die verschiedenen Zustände von DKIM](#dkim-status) in dieser Anleitung, dass `status:` den Wert `ready` hat, bevor Sie DKIM aktivieren.
>>
>> Um DKIM zu aktivieren, verwenden Sie folgenden API-Aufruf:
>>
@@ -617,7 +682,7 @@ Folgen Sie den **5 Schritten**, indem Sie auf jeden Tab klicken.
>>
>> > [!success]
>> >
->> > Sie haben damit alle notwendigen Schritte unternommen, um DKIM zu aktivieren. Um sicherzustellen, dass DKIM aktiviert ist, püfen Sie mithilfe des Abschnitts [**Die verschiedenen DKIM-Zustände**](#dkim-status) dieser Anleitung, ob `status:` den Wert `inProduction` hat. Ist das der Fall, ist Ihr DKIM aktiv.
**Wenn Sie zwei Selektoren erstellt haben**, sollte der zweite Selektor `status:` den Wert `ready` haben.
+>> > Sie haben damit alle notwendigen Schritte unternommen, um DKIM zu aktivieren. Um sicherzustellen, dass DKIM aktiviert ist, püfen Sie mithilfe des Abschnitts [API - Die verschiedenen Zustände von DKIM](#dkim-status) dieser Anleitung, ob `status:` den Wert `inProduction` hat. Ist das der Fall, ist Ihr DKIM aktiv.
**Wenn Sie zwei Selektoren erstellt haben**, sollte der zweite Selektor `status:` den Wert `ready` haben.
>>
##### **Für E-Mail Pro**
@@ -755,7 +820,7 @@ Folgen Sie den **5 Schritten**, indem Sie auf jeden Tab klicken.
> **5. DKIM aktivieren**
>> > [!warning]
>> >
->> > Überprüfen Sie mithilfe des Abschnitts [**Die verschiedenen DKIM-Zustände**](#dkim-status) in dieser Anleitung, dass `status:` den Wert `ready` hat, bevor Sie DKIM aktivieren.
+>> > Überprüfen Sie mithilfe des Abschnitts [API - Die verschiedenen Zustände von DKIM](#dkim-status) in dieser Anleitung, dass `status:` den Wert `ready` hat, bevor Sie DKIM aktivieren.
>>
>> Um DKIM zu aktivieren, verwenden Sie folgenden API-Aufruf:
>>
@@ -780,15 +845,15 @@ Folgen Sie den **5 Schritten**, indem Sie auf jeden Tab klicken.
>>
>> > [!success]
>> >
->> > Sie haben damit alle notwendigen Schritte unternommen, um DKIM zu aktivieren. Um sicherzustellen, dass DKIM aktiviert ist, prüfen Sie mithilfe des Abschnitts [**Die verschiedenen DKIM-Zustände**](#dkim-status) dieser Anleitung, ob `status:` den Wert `inProduction` hat. Ist das der Fall, ist Ihr DKIM aktiv.
+>> > Sie haben damit alle notwendigen Schritte unternommen, um DKIM zu aktivieren. Um sicherzustellen, dass DKIM aktiviert ist, prüfen Sie mithilfe des Abschnitts [API - Die verschiedenen Zustände von DKIM](#dkim-status) dieser Anleitung, ob `status:` den Wert `inProduction` hat. Ist das der Fall, ist Ihr DKIM aktiv.
>>
-#### Die verschiedenen DKIM-Zustände
+#### API - Die verschiedenen Zustände des DKIM
Klicken Sie auf den Tab für Ihren Dienst:
> [!tabs]
-> **E-Mail (MX Plan)**
+> **MX Plan und Zimbra**
>> Überprüfen Sie bei DKIM-Operationen den aktuellen DKIM-Status mithilfe des folgenden API-Aufrufs.
>>
>> > [!api]
@@ -801,15 +866,15 @@ Klicken Sie auf den Tab für Ihren Dienst:
>>
>> - `disabled`: DKIM ist deaktiviert, wurde noch nicht konfiguriert oder wurde über API deaktiviert.
>> - `modifying`: Die DKIM-Konfiguration wird ausgeführt. Es muss gewartet werden, bis der Vorgang abgeschlossen ist.
->> - `toConfigure`: Die DKIM-Konfiguration wartet auf die DNS-Einstellungen der Domain. Die DNS-Einträge müssen manuell in der DNS-Zone eingegeben werden. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan](#confemail).
+>> - `toConfigure`: Die DKIM-Konfiguration wartet auf die DNS-Einstellungen der Domain. Die DNS-Einträge müssen manuell in der DNS-Zone eingegeben werden. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan und Zimbra](#confemail).
>> - `enabled`: DKIM ist konfiguriert und funktionsfähig.
>> - `error`: Fehler beim Installationsvorgang. Erstellen Sie ein [Ticket für den Support](https://help.ovhcloud.com/csm?id=csm_get_help) und geben Sie die betreffende Domain an.
>>
>> Auf der Ebene der Selektoren haben Sie auch drei mögliche Zustände:
>>
>> - `set`: Der Selektor ist korrekt konfiguriert und aktiv.
->> - `toSet`: Der Selektor ist nicht in der DNS-Zone der Domain konfiguriert. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan](#confemail).
->> - `toFix`: Der Selektor wurde erfolgreich in der DNS-Zone der Domain konfiguriert, aber die Werte sind falsch. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan](#confemail).
+>> - `toSet`: Der Selektor ist nicht in der DNS-Zone der Domain konfiguriert. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan und Zimbra](#confemail).
+>> - `toFix`: Der Selektor wurde erfolgreich in der DNS-Zone der Domain konfiguriert, aber die Werte sind falsch. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan und Zimbra](#confemail).
>>
> **Exchange**
>> Wenn Sie DKIM mit Exchange verwenden, nutzen Sie den folgenden API-Aufruf, um den aktuellen Status von DKIM zu überprüfen.
@@ -868,15 +933,38 @@ Klicken Sie auf den Tab für Ihren Dienst:
>> { "message": "The requested object (selectorName = ovhemp123456-selector1) does not exist" }
>> ```
-#### DKIM-Selektor aktivieren oder ändern
+#### API - DKIM deaktivieren und löschen
> [!warning]
>
-> Der DKIM-Selektor muss den Status `ready` haben, bevor er aktiviert werden kann.
+> **Für die Angebote Exchange und E-Mail Pro**
+>
+> Der DKIM-Selektor muss den Status `inProduction` oder `ready` haben, bevor er deaktiviert werden kann.
-Klicken Sie auf den Tab für Ihren Dienst:
+Wählen Sie das E-Mail-Angebot aus, das in den folgenden Registerkarten behandelt wird:
> [!tabs]
+> **MX Plan und Zimbra**
+>> Um DKIM zu aktivieren, verwenden Sie folgenden API-Aufruf:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain` : Geben Sie den Domainnamen ein, der mit Ihrem E-Mail-Dienst verknüpft ist, auf dem DKIM aktiviert sein soll.
+>>
+>> *Beispiel für das Ergebnis:*
+>>
+>> ```console
+>> {
+>> "domain": "guidesteam.ovh",
+>> "id": 123456789,
+>> "function": "domain/enableDKIM",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> Um DKIM auf einem Selektor zu aktivieren, verwenden Sie folgenden API-Aufruf:
>>
@@ -907,7 +995,7 @@ Klicken Sie auf den Tab für Ihren Dienst:
>
> Während der Rotation des DKIM-Selektors können Sie den zweiten Selektor, den Sie erstellt haben, aktivieren und dazu wechseln. Dabei bleibt der erste Selektor aktiv, bis alle mit ihm gesendeten E-Mails vom Empfänger geprüft wurden.
-#### DKIM deaktivieren und löschen
+#### DKIM deaktivieren und löschen
> [!warning]
>
@@ -918,7 +1006,7 @@ Klicken Sie auf den Tab für Ihren Dienst:
Klicken Sie auf den Tab für Ihren Dienst:
> [!tabs]
-> **MX Plan E-Mail**
+> **MX Plan und Zimbra**
>> Wenn Sie DKIM deaktivieren möchten, ohne die Selektoren und deren Schlüsselpaare zu löschen, verwenden Sie folgenden API-Aufruf:
>>
>> > [!api]
@@ -1098,7 +1186,7 @@ Um den Header einer E-Mail einzusehen, lesen Sie unsere Anleitung "[E-Mail-Heade
Wenn Sie DKIM zum ersten Mal für Ihren E-Mail-Dienst aktivieren, können Sie zwei Selektoren erstellen, die jeweils ein Schlüsselpaar enthalten. Die zweite Auswahl dient als Nachfolger der aktuellen Auswahl.
-Um Versuchen entgegenzuwirken, die DKIM-Verschlüsselung zu entschlüsseln, sollten Sie das Schlüsselpaar regelmäßig wechseln. Vergewissern Sie sich, dass Sie Ihre beiden Selektoren korrekt konfiguriert haben, indem Sie sicherstellen, dass der erste den Status `inProduction` und der zweite den Status `ready` hat. Sie können diesen Status mit ["Die verschiedenen DKIM-Zustände"](#dkim-status) überprüfen.
+Um Versuchen entgegenzuwirken, die DKIM-Verschlüsselung zu entschlüsseln, sollten Sie das Schlüsselpaar regelmäßig wechseln. Vergewissern Sie sich, dass Sie Ihre beiden Selektoren korrekt konfiguriert haben, indem Sie sicherstellen, dass der erste den Status `inProduction` und der zweite den Status `ready` hat. Sie können diesen Status mit ["API - Die verschiedenen Zustände des DKIM"](#dkim-status) überprüfen.
Klicken Sie auf den Tab für Ihren Dienst:
@@ -1208,18 +1296,18 @@ Hier sind die 4 Zustände, die zu dem roten DKIM-Symbol in Ihrem Kundencenter f
#### Wie kann ich über die OVHcloud API den Zustand eines nicht funktionierenden DKIM verstehen?
-Wenn Sie DKIM mithilfe der OVHcloud API konfigurieren und es nicht funktioniert, finden Sie im Abschnitt "[Die verschiedenen DKIM-Zustände](#dkim-status)" dieser Anleitung Informationen zum Status Ihrer Selektoren.
+Wenn Sie DKIM mithilfe der OVHcloud API konfigurieren und es nicht funktioniert, finden Sie im Abschnitt "[API - Die verschiedenen Zustände des DKIM](#dkim-status)" dieser Anleitung Informationen zum Status Ihrer Selektoren.
Im Folgenden finden Sie die Zustände, die den Betrieb Ihres DKIM blockieren können, und die passende Lösung für jede Situation.
> [!tabs]
> **Exchange und E-Mail Pro**
->> - `WaitingRecord`: DNS-Einträge in der DNS-Zone warten auf Konfiguration oder werden überprüft. Es wird automatisch und regelmäßig überprüft, ob der DNS-Eintrag vorhanden und korrekt ausgefüllt ist. Folgen Sie **Schritt 5** im Bereich "[Vollständige DKIM-Konfiguration](#firststep)", um die DNS-Zone korrekt zu konfigurieren.
->> - `ready`: DNS-Einträge sind in der Zone vorhanden. DKIM kann jetzt aktiviert werden, indem Sie dem Abschnitt "[DKIM aktivieren oder ändern](#enable-switch)" folgen.
->> - `deleting`: DKIM wird gelöscht. Nach dem Löschen folgen Sie dem Abschnitt "[Vollständige DKIM-Konfiguration](#firststep)".
->> - `disabling`: DKIM wird deaktiviert. Danach können Sie ihn reaktivieren, indem Sie den Abschnitt "[DKIM aktivieren oder ändern](#enable-switch)" verwenden.
+>> - `WaitingRecord`: DNS-Einträge in der DNS-Zone warten auf Konfiguration oder werden überprüft. Es wird automatisch und regelmäßig überprüft, ob der DNS-Eintrag vorhanden und korrekt ausgefüllt ist. Folgen Sie **Schritt 5** im Bereich "[API - Vollständige DKIM-Konfiguration](#firststep)", um die DNS-Zone korrekt zu konfigurieren.
+>> - `ready`: DNS-Einträge sind in der Zone vorhanden. DKIM kann jetzt aktiviert werden, indem Sie dem Abschnitt "[API - DKIM aktivieren oder ändern](#enable-switch)" folgen.
+>> - `deleting`: DKIM wird gelöscht. Nach dem Löschen folgen Sie dem Abschnitt "[API - ollständige DKIM-Konfiguration](#firststep)".
+>> - `disabling`: DKIM wird deaktiviert. Danach können Sie ihn reaktivieren, indem Sie den Abschnitt "[API - DKIM aktivieren oder ändern](#enable-switch)" verwenden.
>> - `todo`: Der Task wurde initialisiert und muss gestartet werden. Wenn er sich nach 24 Stunden noch in diesem Status befindet, können Sie ein [Support-Ticket](https://help.ovhcloud.com/csm?id=csm_get_help) unter Angabe der Selektor-ID erstellen.
-> **E-Mails (MX Plan)**
+> **E-Mails und Zimbra**
>> - `disabled`: DKIM ist deaktiviert, wurde noch nicht konfiguriert oder wurde über API deaktiviert.
>> - `modifying`: Die DKIM-Konfiguration wird ausgeführt. Es muss gewartet werden, bis der Vorgang abgeschlossen ist.
>> - `toConfigure`: Die DKIM-Konfiguration wartet auf die DNS-Einstellungen der Domain. Die DNS-Einträge müssen manuell in der Zone eingegeben werden. Verwenden Sie hierzu den Abschnitt "[Vollständige DKIM-Konfiguration](#confemail)" in dieser Anleitung.
@@ -1227,9 +1315,9 @@ Im Folgenden finden Sie die Zustände, die den Betrieb Ihres DKIM blockieren kö
>>
>> Auf der Ebene der Selektoren haben Sie auch 2 Fehlerstatus:
>>
->> - `toSet`: Der Selektor ist nicht in der DNS-Zone der Domain konfiguriert. TGehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan](#confemail).
->> - `toFix`: Der Selektor wurde erfolgreich in der DNS-Zone der Domain konfiguriert, aber die Werte sind falsch. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan](#confemail).
+>> - `toSet`: Der Selektor ist nicht in der DNS-Zone der Domain konfiguriert. TGehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan und Zimbra](#confemail).
+>> - `toFix`: Der Selektor wurde erfolgreich in der DNS-Zone der Domain konfiguriert, aber die Werte sind falsch. Gehen Sie zu [Schritt 4. "Vollständige Konfiguration von DKIM" für MX Plan und Zimbra](#confemail).
## Weiterführende Informationen
-Treten Sie unserer [User Community](/links/community) bei.
+Treten Sie unserer [User Community](/links/community) bei.
\ No newline at end of file
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.en-gb.md b/pages/web_cloud/domains/dns_zone_dkim/guide.en-gb.md
index 934b3535c55..954bf40fd2a 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.en-gb.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.en-gb.md
@@ -1,7 +1,7 @@
---
title: How to improve email security with a DKIM record
excerpt: Find out how to configure a DKIM record on your OVHcloud domain name and email service
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
+details>summary {
+ color:rgb(33, 153, 232) !important;
+ cursor: pointer;
+}
+details>summary::before {
+ content:'\25B6';
+ padding-right:1ch;
+}
+details[open]>summary::before {
+ content:'\25BC';
+}
+.w-500 {
+ max-width:500px !important;
+}
+e>
## Objective
@@ -50,6 +61,7 @@ The DKIM (**D**omain**K**eys **I**dentified **M**ail) record allows you to sign
- OVHcloud MX Plan Email, available with a [web hosting plan](/links/web/hosting), a [100M free hosting plan](/links/web/domains-free-hosting), or a separate MX Plan solution
- [Exchange](/links/web/emails-hosted-exchange) or [Private Exchange](/links/web/emails-hosted-exchange)
- [Email Pro](/links/web/email-pro)
+ - [Zimbra](/links/web/zimbra).
- An email solution outside of OVHcloud with DKIM support
> [!warning]
@@ -70,15 +82,15 @@ The DKIM (**D**omain**K**eys **I**dentified **M**ail) record allows you to sign
- [Why do we need to configure DNS servers?](#dns-and-dkim)
- [Example of an email sent using DKIM](#example)
- [What is a DKIM selector?](#selector)
-- [Configuring DKIM automatically for an OVHcloud Exchange or Email Pro solution](#auto-dkim)
-- [Configuring DKIM manually for an OVHcloud Exchange or OVHcloud Email Pro solution](#internal-dkim)
- - [Full DKIM configuration](#firststep)
- - [For Emails (MX Plan)](#confemail)
+- [Automatically configure DKIM for an OVHcloud email offer](#auto-dkim)
+- [Configure DKIM via API for an OVHcloud email offer](#internal-dkim)
+ - [API - Full DKIM configuration](#firststep)
+ - [For MX Plan ans Zimbra)](#confemail)
- [For Exchange](#confex)
- [For Email Pro](#confemp)
- - [The different states of DKIM](#dkim-status)
- - [Enable or change DKIM selector](#enable-switch)
- - [Disable and delete DKIM](#disable-delete)
+ - [API - The different states of DKIM](#dkim-status)
+ - [API - Enable or change DKIM selector](#enable-switch)
+ - [API - Disable and delete DKIM](#disable-delete)
- [Configuring DKIM for an email solution outside of your OVHcloud account](#external-dkim)
- [DKIM record](#dkim-record)
- [TXT record](#txt-record)
@@ -91,9 +103,9 @@ The DKIM (**D**omain**K**eys **I**dentified **M**ail) record allows you to sign
### How does DKIM work?
-To fully understand why DKIM can secure your email exchanges, you need to understand how it works. DKIM uses **hashing** and **asymmetric encryption** to create a secure signature. Your domain name’s **email platform** and **DNS zone** will help deliver DKIM information to your recipients.
+To understand why DKIM helps secure your email exchanges, it is necessary to understand how it works. DKIM uses "**hashing**" and "**asymmetric encryption**" to create a secure signature. The **email platform** and the **DNS zone** of your domain name will help transmit the DKIM information to your recipients.
-#### Hashing
+/// details | Hashing
The principle of a **hash function** is to generate a **signature** (also called a fingerprint) from input data. Its purpose is to create a fixed sequence of characters at the output, regardless of the amount of input data.
@@ -103,7 +115,9 @@ On the following diagram, you can see that the output will always be 32 characte
The hash function is useful when you want to check the integrity of a message. Different but similar looking input data will produce a completely different hash value with an equal length of characters in output, regardless of the input length.
-#### Asymmetric encryption
+///
+
+/// details | Asymmetric encryption
The purpose of **encryption**, as its name suggests, is to encrypt the data it is given. It is **asymmetric** because the encryption key is not the same as the decryption, unlike symmetric encryption, which uses the same key to encrypt and decrypt.
@@ -119,17 +133,23 @@ There are two uses for asymmetric encryption:
{.thumbnail .w-400 .h-600}
-#### How are hashing and asymmetric encryption used for DKIM?
+///
+
+/// details | How are hashing and asymmetric encryption used for DKIM?
From the email platform, DKIM will use hashing to create a signature from certain elements of [the email header](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) and email body (email content).
The signature is then encrypted with the private key using asymmetric encryption.
-#### Why do we need to configure DNS servers?
+///
+
+/// details | Why do we need to configure DNS servers?
In order for a recipient to verify the sender's DKIM signature, they will need the DKIM parameters and especially the public key to decrypt it. A domain name’s [DNS zone](/pages/web_cloud/domains/dns_zone_general_information) is public, which is why a DNS record is added to transmit the public key and DKIM settings to the recipient.
-#### What is a DKIM selector?
+///
+
+/// details | What is a DKIM selector?
When you enable DKIM, it works with a public/private key pair. You can assign several pairs of keys to your domain name, for example, as part of a rotation. Indeed, when you change the key pair, the old pair must remain active until all emails you sent with the old key fail to pass the DKIM check on the incoming server.
@@ -142,7 +162,9 @@ For this rotation principle to work, we're going to use something called **DKIM
The value of this selector is `s=ovhex123456-selector1`.
-#### Example of an email sent using DKIM
+///
+
+/// details | Example of an email sent using DKIM
When you send an email from **contact@mydomain.ovh**, a signature encrypted with a private key is added to the email header.
@@ -152,16 +174,25 @@ The recipient **recipient@otherdomain.ovh** can decrypt this signature with the
{.thumbnail .w-400 .h-600}
-### Configuring DKIM automatically for an OVHcloud Exchange or Email Pro solution
+///
-The automatic configuration of DKIM is accessible for an email solution MX Plan (included with a [Web Cloud hosting plan](/links/web/hosting), a [100M free hosting plan](/links/web/domains-free-hosting), or ordered separately), the email solutions [Exchange](/links/web/emails) and [Email Pro](/links/web/email-pro).
+### Automatically configure DKIM for an OVHcloud email offer
-By default, the DKIM is not activated when you add a domain name to your platform. You will need to launch the automatic configuration process via the OVHcloud Control Panel.
+Automatic DKIM configuration is available for all our email offers:
-Click on the tab below corresponding to your solution.
+- MX Plan included with a [Cloud Web Hosting](/links/web/hosting), a [free 100M hosting](/links/web/domains-free-hosting) or ordered separately.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
+
+When you configure your domain name on an OVHcloud email solution, automatic DKIM configuration is proposed and performed by default if you do not disable it.
+
+If DKIM was not enabled when you added a domain name to your email platform, you will need to launch the automatic configuration process via the Control Panel.
+
+Click on the tab below corresponding to your offer.
> [!tabs]
-> **Emails (MX Plan)**
+> **MX Plan**
>>
>> 1. Log in to your [OVHcloud Control Panel](/links/manager).
>> 1. Open the `Web Cloud`{.action} section.
@@ -173,6 +204,16 @@ Click on the tab below corresponding to your solution.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> To enable DKIM, simply click on the red `DKIM` badge and then click on `Validate`{.action} from the activation window that appears.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> If your domain name is not managed in the same OVHcloud Control Panel as your email platform or is registered outside OVHcloud, you will see the window below:
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> This window asks you to enter two CNAME values in the DNS zone of the domain name, which links this domain name to the DKIM selectors of your email service. You need to enter these values and ensure they are propagated before clicking on `Enable`{.action}.
+>>
> **Exchange**
>>
>> 1. Log in to your [OVHcloud Control Panel](/links/manager).
@@ -185,6 +226,10 @@ Click on the tab below corresponding to your solution.
>>
>>{.thumbnail .w-400 .h-600}
>>
+>> To enable DKIM, simply click on the red `DKIM` badge and then click on `Validate`{.action} from the activation window that appears.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
> **Email Pro**
>>
>> 1. Log in to your [OVHcloud Control Panel](/links/manager).
@@ -193,32 +238,45 @@ Click on the tab below corresponding to your solution.
>> 1. Select the service concerned.
>> 1. Finally, go to the `Associated domains`{.action} tab.
>>
->> To the right of the domain name concerned, `DKIM` is displayed in red.
+>> To the right of the relevant domain name, you can see that the `DKIM` badge is red.
>>
->>{.thumbnail .w-400 .h-600}
+>> {.thumbnail .w-400 .h-600}
+>>
+>> To enable DKIM, simply click on the red `DKIM` badge and then click on `Validate`{.action} from the activation window that appears.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Log in to your [OVHcloud Control Panel](/links/manager).
+>> 1. Go to the `Web Cloud`{.action} section.
+>> 1. Click on `Zimbra Mail`{.action}.
+>> 1. Finally, go to the `Domain`{.action} tab.
+>> 1. To the right of the relevant domain, click on `⁝`{.action}, then on `Diagnostics`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> To the right of the `DKIM` label on the corresponding tab, you should see a warning indicating that DKIM is not working. Click on the `DKIM`{.action} tab to access the DKIM configuration status. To fix the error, you need to add or modify two DNS entries of type CNAME in the DNS zone of the associated domain name, according to the information visible from this tab.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Tip for creating a CNAME record**
+>> >
+>> > From the [OVHcloud Control Panel](/links/manager) where the domain name of your email service is hosted, in the `Web Cloud`{.action} section, click on `Domain names`{.action} in the left column and select the relevant domain name.
+>> > Select the `DNS zone`{.action} tab and then click on `Add an entry`{.action} in the window that appears. Choose `CNAME` and complete the fields according to the values you have noted.
To activate DKIM, simply click on the red `DKIM` box, then `Confirm`{.action} in the activation window that pops up.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **Emails (MX Plan)**
->
-> If your domain name is not managed in the same OVHcloud Control Panel as your email platform, or registered outside of OVHcloud, you will see the window below:
->
-> {.thumbnail .w-400 .h-600}
->
-> This prompts you to enter two CNAME values in the domain name’s DNS zone, which enables you to link this domain name to the DKIM selectors of your email service. You will need to enter these values and ensure that they are propagated before clicking `Enable`{.action}.
->
-
-The automatic activation of the DKIM takes between 30 minutes and 24 hours. To check that your DKIM is functional, simply go back to the `General information`{.action} or the `Associated domains`{.action} tab of your email platform and make sure that the `DKIM` box has turned green.
+Automatic DKIM activation takes between 30 minutes and a maximum of 24 hours. To check that your DKIM is working, simply return to the domain management section mentioned in the tabs above and check that the `DKIM` badge is green, or for a Zimbra offer, that the `DKIM` tab no longer displays the warning icon.
{.thumbnail .w-400 .h-600}
-After 24 hours, if your `DKIM` box is red, please refer to the section [“Why does DKIM not work and appear in red in the OVHcloud Control Panel?”](#reddkim) of this guide.
+If after 24 hours your `DKIM` badge is still red, refer to the section [« Why is DKIM not working and appears red in the Control Panel? »](#reddkim) of this guide.
-### Configuring DKIM manually for an OVHcloud Email solution
+### Configure DKIM via API for an OVHcloud email offer
To configure Exchange or Email Pro DKIM, you will first need to retrieve the internal reference of your Exchange or Email Pro service.
@@ -253,18 +311,25 @@ Also, make sure that the domain name you want to use for your emails is active i
{.thumbnail .w-400 .h-600}
-#### Full DKIM configuration
+#### API - Full DKIM configuration
+
+To configure DKIM, go to the [OVHcloud API page](/links/console) and log in:
-To configure DKIM, go to the website , log in using the `Login`{.action} button in the top right-hand corner, and enter your OVHcloud credentials.
+1. Click on `Authentication`{.action} in the top left.
+1. Then click on `Login with OVHcloud SSO`{.action}.
+1. Enter your OVHcloud credentials.
+1. Click on the `Authorize`{.action} button to authorise API calls from this site.
-> Visit our guide ["First Steps with the OVHcloud APIs"](/pages/manage_and_operate/api/first-steps) if you have never used APIs.
+> [!primary]
+>
+> Refer to our guide « [Getting started with OVHcloud APIs](/pages/manage_and_operate/api/first-steps) » if you have never used APIs before.
-To configure DKIM on Exchange or Email Pro, you must first retrieve the service name (reference). Go to the API section `/email/domain/`(MX Plan Email), `/email/exchange` (Exchange offers) or `/email/pro` (Email Pro offer), depending on your service. Type "dkim" in the `Filter` box to display only the endpoints related to the DKIM.
+Go to the `/email/domain/` (MX Plan and Zimbra offers), `/email/exchange` (Exchange offer) or `/email/pro` (E-mail Pro offer) section of the APIs and enter « dkim » in the `Filter` field to display only the API functions related to DKIM.
-Click on the tab corresponding to your solution:
+Click on the tab corresponding to your offer:
> [!tabs]
-> **Emails (MX Plan)**
+> **MX Plan and Zimbra**
>>
>> {.thumbnail .w-400 .h-600}
>>
@@ -277,7 +342,7 @@ Click on the tab corresponding to your solution:
>> {.thumbnail .w-400 .h-600}
>>
-##### **For Emails (MX Plan)**
+##### **For MX Plan and Zimbra**
Follow the **5 steps** by clicking on each of the 5 tabs below:
@@ -594,7 +659,7 @@ Follow the **5 steps** below by clicking on each tab.
> **5. Activating DKIM**
>> > [!warning]
>> >
->> > In the section "[**The different states of DKIM**](#dkim-status)" of this guide, check that the value `status:` is `ready` before you activate DKIM.
+>> > In the section "[API - The different states of DKIM](#dkim-status)" of this guide, check that the value `status:` is `ready` before you activate DKIM.
>>
>> To enable DKIM, use the following API call:
>>
@@ -620,7 +685,7 @@ Follow the **5 steps** below by clicking on each tab.
>>
>> > [!success]
>> >
->> > You have now made all the changes to enable DKIM. To ensure that DKIM is enabled, please refer to the section [**The different states of DKIM**](#dkim-status) of this guide to check that the `status:` value is `inProduction`. If this is the case, your DKIM is now active.
**If you have created two selectors**, the second selector should have the `status:` value `ready`.
+>> > You have now made all the changes to enable DKIM. To ensure that DKIM is enabled, please refer to the section [API - The different states of DKIM](#dkim-status) of this guide to check that the `status:` value is `inProduction`. If this is the case, your DKIM is now active.
**If you have created two selectors**, the second selector should have the `status:` value `ready`.
>>
##### **For Email Pro**
@@ -757,7 +822,7 @@ Follow the **5 steps** below by clicking on each tab.
> **5. Activating DKIM**
>> > [!warning]
>> >
->> > In the section "[**The different states of DKIM**](#dkim-status)" of this guide, check that the value `status:` is `ready` before you activate DKIM.
+>> > In the section "[API - The different states of DKIM](#dkim-status)" of this guide, check that the value `status:` is `ready` before you activate DKIM.
>>
>> To enable DKIM, use the following API call:
>>
@@ -782,15 +847,15 @@ Follow the **5 steps** below by clicking on each tab.
>>
>> > [!success]
>> >
->> > You have now made all the changes to enable DKIM. To ensure that DKIM is enabled, please refer to the [**The different states of DKIM**](#dkim-status) section of this guide to check that the value `status:` is `inProduction`. If this is the case, your DKIM is now active.
+>> > You have now made all the changes to enable DKIM. To ensure that DKIM is enabled, please refer to the [API - The different states of DKIM](#dkim-status) section of this guide to check that the value `status:` is `inProduction`. If this is the case, your DKIM is now active.
>>
-#### The different states of DKIM
+#### API - The different states of DKIM
Select the email solution concerned in the following tabs:
> [!tabs]
-> **Email (MX Plan)**
+> **MX Plan and Zimbra**
>> When performing operations on your E-mail platform's DKIM, use the API call below to check the current DKIM status.
>>
>> > [!api]
@@ -803,14 +868,14 @@ Select the email solution concerned in the following tabs:
>>
>> - `disabled`: DKIM is disabled, has not yet been configured or has been disabled by API.
>> - `modifying`: DKIM configuration is in progress, it is necessary to wait for the process to complete.
->> - `toConfigure`: DKIM configuration is pending domain name DNS settings. You must manually enter the DNS records in the domain name zone. To do this, go to [Step 4 of the “Complete DKIM Configuration” for Emails (MX Plan)](#confemail).
+>> - `toConfigure`: DKIM configuration is pending domain name DNS settings. You must manually enter the DNS records in the domain name zone. To do this, go to [Step 4 of the “Complete DKIM Configuration” for MX Plan and Zimbra](#confemail).
>> - `enabled` - The DKIM is configured and functional.
>> - `error`: The installation process encountered an error. Please open a [support ticket](https://help.ovhcloud.com/csm?id=csm_get_help) with the domain name concerned.
>>
>> At the level of the selectors you also have 3 possible states:
>>
>> - `set`: The selector is correctly configured and active.
->> - `toSet`: The selector is not configured in the DNS zone of the domain name. See [Step 4 in "Configuring the DKIM in full" for Emails (MX Plan)](#confemail).
+>> - `toSet`: The selector is not configured in the DNS zone of the domain name. See [Step 4 in "Configuring the DKIM in full" for MX Plan and Zimbra](#confemail).
>> - `toFix`: The selector has been configured in the domain name’s DNS zone, but the values are incorrect. See [Step 4 in "Configuring the DKIM in full" for Emails (MX Plan)](#confemail).
>>
> **Exchange**
@@ -871,7 +936,7 @@ Select the email solution concerned in the following tabs:
>> ```
>>
-#### Enable or change the DKIM selector
+#### API - Enable or change the DKIM selector
> [!warning]
>
@@ -880,6 +945,27 @@ Select the email solution concerned in the following tabs:
Select the email solution concerned in the following tabs:
> [!tabs]
+> **MX Plan and Zimbra**
+>> Pour activer le DKIM, utilisez l'appel API suivant :
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain` : saisissez le nom de domaine attaché à votre service E-mail sur lequel le DKIM doit être présent.
+>>
+>> *Exemple de résultat :*
+>>
+>> ```console
+>> {
+>> "function": "domain/enableDKIM",
+>> "id": 123456789,
+>> "domain": "guidesteam.ovh",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> To enable DKIM on a selector, use the following API call:
>>
@@ -910,7 +996,7 @@ Select the email solution concerned in the following tabs:
>
> During a DKIM selector rotation, you can directly activate the second selector you have created to switch over to it, while keeping the first selector active until all emails delivered with it are properly scanned by their recipient.
-#### Disable and delete DKIM
+#### API - Disable and delete DKIM
> [!warning]
>
@@ -921,7 +1007,7 @@ Select the email solution concerned in the following tabs:
Select the email solution concerned in the following tabs:
> [!tabs]
-> **Email (MX Plan)**
+> **MX Plan and zimbra**
>> If you want to disable the DKIM without removing the selectors and their key pair, use the following API call:
>>
>> > [!api]
@@ -1101,7 +1187,7 @@ To retrieve the header of an email, please read our guide on [Retrieving email h
When you enable DKIM for the first time on your email service, you can create 2 selectors, each containing a pair of keys. The second selector acts as a successor to the one that is currently in use.
-To avoid attempts to decrypt the DKIM key, it is recommended that you change the key pair periodically. To do this, make sure that you have configured your 2 selectors by checking that the first one is in `inProduction` status and the second one is in `ready` status. You can check this status by referring to the section [“The different states of DKIM”](#dkim-status).
+To avoid attempts to decrypt the DKIM key, it is recommended that you change the key pair periodically. To do this, make sure that you have configured your 2 selectors by checking that the first one is in `inProduction` status and the second one is in `ready` status. You can check this status by referring to the section [API - The different states of DKIM](#dkim-status).
Click on the tab below corresponding to your solution.
@@ -1176,8 +1262,8 @@ Here are the 4 states that result in a red DKIM icon in your Control Panel. Clic
>> Only a DKIM selector is present in your configuration. To allow us to switch to a new key when necessary, we are asked to configure the 2 selectors provided by the service.
>> To fix this error:
>>
->> - Check the status of the DKIM selectors to determine which one needs to be configured. Use the section “[The different states of DKIM](#dkim-status)” of this guide.
->> - Once you have identified the selector you want to configure, follow the steps in the section “[Full DKIM configuration](#firststep)” of this guide, depending on your solution (Exchange or Email Pro), and apply it only to the selector concerned.
+>> - Check the status of the DKIM selectors to determine which one needs to be configured. Use the section “[API - The different states of DKIM](#dkim-status)” of this guide.
+>> - Once you have identified the selector you want to configure, follow the steps in the section “[API - Full DKIM configuration](#firststep)” of this guide, depending on your solution (Exchange or Email Pro), and apply it only to the selector concerned.
>> Wait a maximum of 24 hours after configuring the selector.
>>
> **502**
@@ -1210,28 +1296,28 @@ Here are the 4 states that result in a red DKIM icon in your Control Panel. Clic
#### From the OVHcloud API interface, how do I understand the status when DKIM is not working?
-If you are using the OVHcloud API to configure your DKIM and it is not functional, please use the section “[The different states of DKIM](#dkim-status)” of this guide to identify the status of your selectors.
+If you are using the OVHcloud API to configure your DKIM and it is not functional, please use the section “[API - The different states of DKIM](#dkim-status)” of this guide to identify the status of your selectors.
Below, you will find the states that may block your DKIM from working, and the appropriate solution for each situation.
> [!tabs]
> **Exchange and Email Pro**
->> - `WaitingRecord`: The DNS records are pending configuration or being validated in the DNS zone. A regular automatic check is carried out to see if the DNS record is present and correctly entered. Depending on your solution, follow **step 5** in the section “[Full DKIM configuration](#firststep)” to configure the DNS zone correctly for the domain name concerned.
->> - `ready`: DNS records are present in the zone. DKIM can now be enabled. Simply activate the selector by going to the section [Enable or change a DKIM selector](#enable-switch).
->> - `deleting`: DKIM configuration is being deleted. Once you have deleted it, you will need to follow the section “[Full DKIM configuration](#firststep)”.
->> - `disabling`: DKIM is being disabled. Once you have done this, you can activate the selector by going to [Activate or change a DKIM selector](#enable-switch).
+>> - `WaitingRecord`: The DNS records are pending configuration or being validated in the DNS zone. A regular automatic check is carried out to see if the DNS record is present and correctly entered. Depending on your solution, follow **step 5** in the section “[API - Full DKIM configuration](#firststep)” to configure the DNS zone correctly for the domain name concerned.
+>> - `ready`: DNS records are present in the zone. DKIM can now be enabled. Simply activate the selector by going to the section [API - Enable or change a DKIM selector](#enable-switch).
+>> - `deleting`: DKIM configuration is being deleted. Once you have deleted it, you will need to follow the section “[API - Full DKIM configuration](#firststep)”.
+>> - `disabling`: DKIM is being disabled. Once you have done this, you can activate the selector by going to [API - Activate or change a DKIM selector](#enable-switch).
>> - `todo`: The task has been initialised, it must be launched. After 24 hours, if your selector is still in this state, please open a [support ticket](https://help.ovhcloud.com/csm?id=csm_get_help), specifying the number of the selector concerned.
-> **Emails (MX Plan)**
+> **MX Plan and Zimbra**
>> - `disabled`: DKIM is disabled, has not yet been configured, or has been disabled by API.
>> - `modifying`: The DKIM configuration is in progress, you will need to wait for the process to complete.
->> - `toConfigure`: DKIM configuration is pending domain name DNS settings. You must manually enter the DNS records in the domain name zone. To do this, see the step “[Full DKIM configuration](#confemail)” in this guide.
+>> - `toConfigure`: DKIM configuration is pending domain name DNS settings. You must manually enter the DNS records in the domain name zone. To do this, see the step “[API - Full DKIM configuration](#confemail)” in this guide.
>> - `error`: The installation process encountered an error. Please open a [support ticket](https://help.ovhcloud.com/csm?id=csm_get_help), specifying the domain name concerned.
>>
>> At the level of the selectors you also have 2 states relating to an error:
>>
->> - `toSet`: The selector is not configured in the DNS zone of the domain name. See [Step 4 in "Configuring the DKIM in full" for Emails (MX Plan)](#confemail).
->> - `toFix`: The selector has been configured in the domain name’s DNS zone, but the values are incorrect. See [Step 4 in "Configuring the DKIM in full" for Emails (MX Plan)](#confemail).
+>> - `toSet`: The selector is not configured in the DNS zone of the domain name. See [Step 4 in "Configuring the DKIM in full" for MX Plan and Zimbra](#confemail).
+>> - `toFix`: The selector has been configured in the domain name’s DNS zone, but the values are incorrect. See [Step 4 in "Configuring the DKIM in full" for MX Plan and Zimbra](#confemail).
## Go further
-Join our [community of users](/links/community).
+Join our [community of users](/links/community).
\ No newline at end of file
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.es-es.md b/pages/web_cloud/domains/dns_zone_dkim/guide.es-es.md
index 791cfb1d87e..148e5da8797 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.es-es.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.es-es.md
@@ -1,7 +1,7 @@
---
title: Mejorar la seguridad del correo electrónico mediante un registro DKIM
excerpt: Cómo configurar un registro DKIM en un dominio y una plataforma de correo electrónico de OVHcloud
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
## Objetivo
@@ -50,6 +61,7 @@ El registro DKIM (**D**omain**K**eys **I**dentified **M**ail) permite firmar los
- Correo electrónico (MX Plan) OVHcloud. Esta puede adquirirse a través de un [plan de hosting Web Cloud](/links/web/hosting), un [alojamiento gratuito 100M](/links/web/domains-free-hosting) o un MX Plan contratado por separado.
- [Exchange](/links/web/emails-hosted-exchange) o [Private Exchange](/links/web/emails-hosted-exchange).
- [Email Pro](/links/web/email-pro).
+ - [Zimbra](/links/web/zimbra).
- Una solución de correo fuera de OVHcloud con DKIM.
> [!warning]
@@ -70,15 +82,15 @@ El registro DKIM (**D**omain**K**eys **I**dentified **M**ail) permite firmar los
- [¿Por qué es necesario configurar los servidores DNS?](#dns-and-dkim)
- [Ejemplo de un email enviado utilizando DKIM](#example)
- [¿Qué es un selector DKIM?](#selector)
-- [Configurar el DKIM automáticamente para una solución de correo Exchange o Email Pro de OVHcloud](#auto-dkim)
-- [Configurar el DKIM manualmente para una solución de correo Exchange o Email Pro de OVHcloud](#internal-dkim)
- - [Configuración completa de DKIM](#firststep)
- - [Para E-mails (MX Plan)](#confemail)
+- [Configurar el DKIM automáticamente para una oferta de correo electrónico de OVHcloud](#auto-dkim)
+- [Configurar el DKIM mediante API para una oferta de correo electrónico de OVHcloud](#internal-dkim)
+ - [API - Configuración completa de DKIM](#firststep)
+ - [Para MX Plan y Zimbra](#confemail)
- [Para Exchange](#confex)
- [Para Email Pro](#confemp)
- - [Los diferentes estados del DKIM](#status)
- - [Activar o cambiar un selector DKIM](#enable-switch)
- - [Desactivar y eliminar el DKIM](#disable-delete)
+ - [API - Los diferentes estados del DKIM](#status)
+ - [API - Activar o cambiar un selector DKIM](#enable-switch)
+ - [API - Desactivar y eliminar el DKIM](#disable-delete)
- [Configurar DKIM para una solución de correo electrónico fuera de su cuenta de OVHcloud](#external-dkim)
- [Registro DKIM](#dkim-record)
- [Registro TXT](#txt-record)
@@ -93,7 +105,7 @@ El registro DKIM (**D**omain**K**eys **I**dentified **M**ail) permite firmar los
Para entender por qué DKIM permite proteger los intercambios de correo, es necesario entender cómo funciona. DKIM utiliza el "**hachage**" y el "**cifrado asimétrico**" para crear una firma segura. La **plataforma de correo** y la **zona DNS** de su dominio ayudarán a transmitir la información del DKIM a sus destinatarios.
-#### El hackeo
+/// details | El hackeo
El principio de una **función de trama** es generar una **firma** (también llamada huella) a partir de un dato de entrada. Su interés es crear una secuencia de caracteres fija en salida, independientemente de la cantidad de datos de entrada.
@@ -103,7 +115,9 @@ En el siguiente diagrama, puede ver que la salida (Output) siempre estará compu
La función hash es útil cuando desea comprobar la integridad de un mensaje. De hecho, dos datos que pueden ser de apariencia muy parecida presentan un valor de hackeo completamente diferente con una longitud de caracteres igual a la salida, cualquiera que sea la longitud de entrada.
-#### El cifrado asimétrico
+///
+
+/// details | El cifrado asimétrico
El **cifrado**, como su nombre indica, tiene como objetivo cifrar los datos que se le proporcionan. Es "**asimétrico**" porque la clave de cifrado no es la misma que la clave de descifrado, a diferencia de un cifrado simétrico, que usará la misma clave para cifrar y descifrar.
@@ -119,17 +133,23 @@ Existen dos usos del cifrado asimétrico:
{.thumbnail .w-400 .h-600}
-#### ¿Cómo se utilizan el encriptado y el cifrado asimétrico para el DKIM?
+///
+
+/// details | ¿Cómo se utilizan el encriptado y el cifrado asimétrico para el DKIM?
Desde la plataforma de correo, DKIM utilizará el hackeo para crear una firma a partir de algunos elementos de [la cabecera del email](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) y del cuerpo del email (contenido del email).
La firma se cifrará con la clave privada utilizando cifrado asimétrico.
-#### ¿Por qué es necesario configurar los servidores DNS?
+///
+
+/// details | ¿Por qué es necesario configurar los servidores DNS?
Para que el destinatario pueda verificar la firma DKIM del remitente, necesitará los parámetros DKIM y, sobre todo, la clave pública para descifrarla. La [zona DNS](/pages/web_cloud/domains/dns_zone_general_information) de un dominio es pública, por lo que se añade un registro DNS para transmitir la clave pública y los parámetros DKIM al destinatario.
-#### ¿Qué es un selector DKIM?
+///
+
+/// details | ¿Qué es un selector DKIM?
Al activar el DKIM, este funciona con un par de claves públicas/clave privada. Es posible asignar varios pares de claves a su dominio, por ejemplo, mediante la rotación. De hecho, al cambiar de par de claves, el antiguo par debe permanecer activo hasta que todos los mensajes que haya enviado con la antigua clave no fallen en la verificación del DKIM en el servidor de recepción.
@@ -142,7 +162,9 @@ Para que funcione este principio de rotación, usaremos lo que se llama **select
Aquí el valor del selector es `s=ovhex123456-selector1`.
-#### Ejemplo de un email enviado utilizando DKIM
+///
+
+/// details | Ejemplo de un email enviado utilizando DKIM
Al enviar un correo electrónico desde **contact@mydomain.ovh**, se añade una firma cifrada con clave privada (private key) a la cabecera del email.
@@ -152,13 +174,22 @@ El destinatario **recipient@otherdomain.ovh** podrá descifrar esta firma con la
{.thumbnail .w-400 .h-600}
-### Configurar el DKIM automáticamente para una solución de correo Exchange o Email Pro de OVHcloud
+///
-La configuración automática del DKIM está disponible para los servicios Correo electrónico (MX Plan) OVHcloud (esta puede adquirirse a través de un [plan de hosting Web Cloud](/links/web/hosting), un [alojamiento gratuito 100M](/links/web/domains-free-hosting) o un MX Plan contratado por separado), [Exchange](/links/web/emails) y [E-mail Pro](/links/web/email-pro).
+### Configurar el DKIM automáticamente para una oferta de correo electrónico de OVHcloud
-Por defecto, el DKIM no está activado cuando se añade un dominio a la plataforma. Por lo tanto, deberá iniciar el proceso de configuración automática desde el área de cliente.
+La configuración automática del DKIM está disponible para todas nuestras ofertas de correo electrónico:
-Haga clic en la pestaña que corresponde a su producto.
+- MX Plan incluida con un [alojamiento Web Cloud](/links/web/hosting), un [alojamiento gratuito 100M](/links/web/domains-free-hosting) o adquirida por separado.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
+
+Cuando configure su nombre de dominio en una solución de correo electrónico de OVHcloud, la configuración automática del DKIM se propone y se realiza por defecto si no la desactiva.
+
+Si el DKIM no se ha activado cuando ha añadido un nombre de dominio a su plataforma de correo electrónico, deberá iniciar el proceso de configuración automática a través del área de cliente.
+
+Haga clic en la pestaña inferior correspondiente a su oferta.
> [!tabs]
> **Correo electrónico (MX Plan)**
@@ -173,6 +204,16 @@ Haga clic en la pestaña que corresponde a su producto.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Para activar el DKIM, simplemente haga clic en el indicador `DKIM` rojo y luego en `Validar`{.action} desde la ventana de activación que aparece.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> En el caso de que su nombre de dominio no esté gestionado en el mismo área de cliente de OVHcloud que su plataforma de correo electrónico o esté registrado fuera de OVHcloud, obtendrá la ventana siguiente:
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Esta le invita a introducir dos valores CNAME en la zona DNS del nombre de dominio, lo que permite vincular este nombre de dominio a los selectores DKIM de su servicio de correo electrónico. Es necesario introducir estos valores y asegurarse de que se hayan propagado antes de hacer clic en `Activar`{.action}.
+>>
> **Exchange**
>>
>> 1. Conéctese al [área de cliente de OVHcloud](/links/manager).
@@ -185,6 +226,10 @@ Haga clic en la pestaña que corresponde a su producto.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Para activar el DKIM, simplemente haga clic en el indicador `DKIM` rojo y luego en `Validar`{.action} desde la ventana de activación que aparece.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
> **Email Pro**
>>
>> 1. Conéctese a su [área de cliente de OVHcloud](/links/manager).
@@ -193,32 +238,45 @@ Haga clic en la pestaña que corresponde a su producto.
>> 1. Seleccione la plataforma correspondiente.
>> 1. Por último, abra la pestaña `Dominios asociados`{.action}.
>>
->> A la derecha del dominio en cuestión, puede observar que la etiqueta `DKIM` es rojo.
+>> A la derecha del nombre de dominio correspondiente, puede observar que el indicador `DKIM` es rojo.
>>
>> {.thumbnail .w-400 .h-600}
+>>
+>> Para activar el DKIM, simplemente haga clic en el indicador `DKIM` rojo y luego en `Validar`{.action} desde la ventana de activación que aparece.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Inicie sesión en su [área de cliente de OVHcloud](/links/manager).
+>> 1. Vaya a la sección `Web Cloud`{.action}.
+>> 1. Haga clic en `Zimbra Mail`{.action}.
+>> 1. Finalmente, vaya a la pestaña `Dominio`{.action}.
+>> 1. A la derecha del dominio correspondiente, haga clic en `⁝`{.action}, y luego en `Diagnóstico`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> A la derecha de la mención `DKIM` en la pestaña correspondiente, debería observar una advertencia indicando que el DKIM no está configurado correctamente. Haga clic en la pestaña `DKIM`{.action} para acceder al estado de la configuración DKIM. Para corregir el error, debe añadir o modificar dos entradas DNS de tipo CNAME en la zona DNS del nombre de dominio asociado, según las informaciones visibles desde esta pestaña.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Consejo para crear un registro CNAME**
+>> >
+>> > Desde el [área de cliente de OVHcloud](/links/manager) donde se aloja el nombre de dominio de su servicio de correo electrónico, en la sección `Web Cloud`{.action}, haga clic en `Nombres de dominio`{.action} en la columna de la izquierda y seleccione el nombre de dominio correspondiente.
+>> > Seleccione la pestaña `Zona DNS`{.action} y haga clic en `Añadir una entrada`{.action} en la ventana que aparece. Elija `CNAME` y complete según los valores que haya anotado.
Para activar el DKIM, haga clic en la etiqueta rojo `DKIM` y seleccione `Validar`{.action} desde la ventana de activación que aparece.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **Correo electrónico (MX Plan)**
->
-> En caso de que su dominio no esté gestionado en el mismo área de cliente de OVHcloud que su plataforma de correo o esté registrado fuera de OVHcloud, obtendrá la siguiente ventana:
->
-> {.thumbnail .w-400 .h-600}
->
-> Esta opción le solicita que introduzca dos valores CNAME en la zona DNS del dominio, lo que permite asociar el dominio a los selectores DKIM del servicio de correo. Es necesario introducir estos valores y asegurarse de que se propagan antes de hacer clic en `Activar`{.action}.
->
-
-La activación automática del DKIM tarda entre 30 minutos y 24 horas como máximo. Para comprobar que su DKIM está operativo, solo tiene que volver a la pestaña `Información general`{.action} o `Dominios asociados`{.action} de su plataforma de correo y asegurarse de que la etiqueta `DKIM` se haya vuelto verde.
+La activación automática del DKIM dura entre 30 minutos y 24 horas como máximo. Para verificar que su DKIM funciona correctamente, simplemente vaya a la sección de gestión del dominio mencionada en las pestañas anteriores y verifique que el indicador `DKIM` es verde o, para una oferta Zimbra, que la pestaña `DKIM` no muestra más el icono de advertencia.
{.thumbnail .w-400 .h-600}
Si la etiqueta `DKIM` es de color rojo, después de las 24 horas, consulte la sección ["¿Por qué el DKIM no funciona y aparece en rojo en el área de cliente?"](#reddkim) de esta guía.
-### Configurar el DKIM manualmente para una solución de correo de OVHcloud
+### Configurar el DKIM mediante API para un correo electrónico de OVHcloud
Para una plataforma Exchange o Email Pro, primero debe obtener la referencia de su plataforma para configurar su DKIM.
@@ -231,7 +289,6 @@ Haga clic en la pestaña de abajo correspondiente a su producto.
>> 1. Acceda al apartado `Web Cloud`{.action}.
>> 1. En la sección `MICROSOFT`, haga clic en `Exchange`{.action}.
>> 1. Seleccione la plataforma correspondiente.
->> 1. Por último, abra la pestaña `Dominios asociados`{.action}.
>>
>> Por defecto, el nombre de su plataforma corresponde a su referencia, o ésta será visible con el nombre que le haya asignado (ver la imagen inferior).
>>
@@ -243,7 +300,6 @@ Haga clic en la pestaña de abajo correspondiente a su producto.
>> 1. Acceda al apartado `Web Cloud`{.action}.
>> 1. Haga clic en `Email Pro`{.action}.
>> 1. Seleccione la plataforma correspondiente.
->> 1. Por último, abra la pestaña `Dominios asociados`{.action}.
>>
>> Por defecto, el nombre de su plataforma corresponde a su referencia, o ésta será visible con el nombre que le haya asignado (ver la imagen inferior).
>>
@@ -253,18 +309,25 @@ Asimismo, asegúrese de que el dominio que quiera utilizar para el correo electr
{.thumbnail .w-400 .h-600}
-#### Configuración completa de DKIM
+#### API - Configuración completa del DKIM
-Para configurar el DKIM, acceda al sitio web , conéctese con el botón `Login`{.action} en la parte superior derecha e introduzca sus claves OVHcloud.
+Para configurar el DKIM, vaya a la [página de las API de OVHcloud](/links/console) y inicie sesión:
-> Si nunca ha utilizado la API, puede consultar nuestra guía "[Cómo utilizar las API de OVHcloud](/pages/manage_and_operate/api/first-steps)".
+1. Haga clic en `Authentication`{.action} en la esquina superior izquierda.
+1. Haga clic a continuación en `Login with OVHcloud SSO`{.action}.
+1. Introduzca sus identificadores de OVHcloud.
+1. Haga clic en el botón `Authorize`{.action} para autorizar las llamadas a las API desde este sitio.
-Acceda a la sección `/email/domain/` (productos de correo (MXplan)), `/email/exchange` (productos Exchange) o `/email/pro` (producto Email Pro) de las API e introduzca " dkim " en la casilla `Filter` para que solo aparezcan las API relativas al DKIM.
+> [!primary]
+>
+> Consulte nuestro guía « [Primeros pasos con las API de OVHcloud](/pages/manage_and_operate/api/first-steps) » si nunca ha utilizado las API.
-Haga clic en la pestaña que corresponde a su producto.
+Vaya a la sección `/email/domain/` (ofertas MX Plan y Zimbra), `/email/exchange` (oferta Exchange) o `/email/pro` (oferta E-mail Pro) de las API y escriba « dkim » en el campo `Filter` para mostrar únicamente las funciones API relacionadas con el DKIM.
+
+Haga clic en la pestaña correspondiente a su oferta:
> [!tabs]
-> **E-mails (MX Plan)**
+> **MX Plan y Zimbra**
>>
>> {.thumbnail .w-400 .h-600}
>>
@@ -277,7 +340,7 @@ Haga clic en la pestaña que corresponde a su producto.
>> {.thumbnail .w-400 .h-600}
>>
-##### **Para Correo (MX Plan)**
+##### **Para MX Plan y Zimbra**
Siga los **5 pasos** haciendo clic en cada una de las 5 pestañas siguientes:
@@ -594,7 +657,7 @@ Siga los **5 pasos** que se indican a continuación haciendo clic en cada una de
> **5. Activación del DKIM**
>> > [!warning]
>> >
->> > En la sección [**Estado del DKIM**](#dkim-status) de esta guía, compruebe que el valor `status:` está bien en `ready` antes de poder activar el DKIM.
+>> > En la sección « [API - Los distintos estados del DKIM](#dkim-status) » de esta guía, compruebe que el valor `status:` está bien en `ready` antes de poder activar el DKIM.
>>
>> Para activar el DKIM, utilice la siguiente llamada a la API:
>>
@@ -620,7 +683,7 @@ Siga los **5 pasos** que se indican a continuación haciendo clic en cada una de
>>
>> > [!success]
>> >
->> > Ahora ha realizado todas las operaciones necesarias para activar el DKIM. Para asegurarse de que esté activado, consulte la sección [**"Estado de DKIM"**](#dkim-status) de esta guía para comprobar que el valor `status:` está bien en `inProduction`. En ese caso, su DKIM estará activo.
**Si ha creado dos selectores**, el segundo selector debe estar en `status: "ready"`.
+>> > Ahora ha realizado todas las operaciones necesarias para activar el DKIM. Para asegurarse de que esté activado, consulte la sección « [API - Los distintos estados del DKIM](#dkim-status) » de esta guía para comprobar que el valor `status:` está bien en `inProduction`. En ese caso, su DKIM estará activo.
**Si ha creado dos selectores**, el segundo selector debe estar en `status: "ready"`.
>>
##### **Para Email Pro**
@@ -757,7 +820,7 @@ Siga los **5 pasos** que se indican a continuación haciendo clic en cada una de
> **5.Activación del DKIM**
>> > [!warning]
>> >
->> > En la sección [**Estado del DKIM**](#dkim-status) de esta guía, compruebe que el valor `status:` está bien en `ready` antes de poder activar el DKIM.
+>> > En la sección « [API - Los distintos estados del DKIM](#dkim-status) » de esta guía, compruebe que el valor `status:` está bien en `ready` antes de poder activar el DKIM.
>>
>> Para activar el DKIM, utilice la siguiente llamada a la API:
>>
@@ -782,15 +845,15 @@ Siga los **5 pasos** que se indican a continuación haciendo clic en cada una de
>>
>> > [!success]
>> >
->> > Ahora ha realizado todas las operaciones necesarias para activar el DKIM. Para asegurarse de que esté activado, consulte la sección [**"Estado de DKIM"**](#dkim-status) de esta guía para comprobar que el valor `status:` está bien en `inProduction`. En ese caso, su DKIM estará activo.
**Si ha creado dos selectores**, el segundo selector debe estar en `status: "ready"`.
+>> > Ahora ha realizado todas las operaciones necesarias para activar el DKIM. Para asegurarse de que esté activado, consulte la sección « [API - Los distintos estados del DKIM](#dkim-status) » de esta guía para comprobar que el valor `status:` está bien en `inProduction`. En ese caso, su DKIM estará activo.
**Si ha creado dos selectores**, el segundo selector debe estar en `status: "ready"`.
>>
-#### Los diferentes estados del DKIM
+#### API - Los distintos estados del DKIM
Seleccione el servicio de correo en las siguientes pestañas:
> [!tabs]
-> **Correo electrónico (MX Plan)**
+> **MX Plan y Zimbra**
>> Durante sus operaciones en el DKIM de su plataforma E-mail, utilice la llamada API que aparece a continuación para comprobar el estado actual del DKIM.
>>
>> > [!api]
@@ -803,15 +866,15 @@ Seleccione el servicio de correo en las siguientes pestañas:
>>
>> - `disabled`: el DKIM está desactivado, todavía no se ha configurado o ha sido desactivado por API.
>> - `modifying`: la configuración del DKIM está en curso, es necesario esperar hasta que el proceso haya finalizado.
->> - `toConfigure`: la configuración del DKIM está pendiente de los parámetros DNS del dominio. Debe introducir manualmente los registros DNS en la zona del nombre de dominio. Para ello, vaya al [paso 4 de la "configuración completa del DKIM" para Correo electrónico (MX Plan)](#confemail).
+>> - `toConfigure`: la configuración del DKIM está pendiente de los parámetros DNS del dominio. Debe introducir manualmente los registros DNS en la zona del nombre de dominio. Para ello, vaya al [paso 4 de la "configuración completa del DKIM" para MX Plan y Zimbra](#confemail).
>> - `enabled`: el DKIM está configurado y funciona.
>> - `error`: el proceso de instalación encontró un error. Le invitamos a abrir un [tíquet con el soporte](https://help.ovhcloud.com/csm?id=csm_get_help) indicando el dominio correspondiente.
>>
>> En el nivel de los selectores también tiene 3 estados posibles:
>>
>> - `set`: el selector está bien configurado y activo.
->> - `toSet`: el selector no está configurado en la zona DNS del dominio. Haga clic en [Paso 4 de "Configuración completa de DKIM" para Correo electrónico (MX Plan)](#confemail).
->> - `toFix`: el selector se ha configurado correctamente en la zona DNS del dominio, pero los valores son incorrectos. Haga clic en [Paso 4 de "Configuración completa de DKIM" para Correo electrónico (MX Plan)](#confemail).
+>> - `toSet`: el selector no está configurado en la zona DNS del dominio. Haga clic en [Paso 4 de "Configuración completa de DKIM" para MX Plan y Zimbra](#confemail).
+>> - `toFix`: el selector se ha configurado correctamente en la zona DNS del dominio, pero los valores son incorrectos. Haga clic en [Paso 4 de "Configuración completa de DKIM" para MX Plan y Zimbra](#confemail).
>>
> **Exchange**
>> Al realizar operaciones en el DKIM de su plataforma Exchange, utilice la siguiente llamada a la API para comprobar el estado actual del DKIM.
@@ -871,7 +934,7 @@ Seleccione el servicio de correo en las siguientes pestañas:
>> ```
>>
-#### Activar o cambiar un selector DKIM
+#### API - Activar o cambiar un selector DKIM
> [!warning]
>
@@ -880,6 +943,27 @@ Seleccione el servicio de correo en las siguientes pestañas:
Seleccione el servicio de correo en las siguientes pestañas:
> [!tabs]
+> **MX Plan y Zimbra**
+>> Para activar el DKIM, utilice la siguiente llamada a la API:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain` : Introduzca el dominio asociado a su servicio de correo en el que debe estar presente el DKIM.
+>>
+>> *Ejemplo de resultado:*
+>>
+>> ```console
+>> {
+>> "domain": "guidesteam.ovh",
+>> "id": 174219594,
+>> "function": "domain/enableDKIM",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> Para activar el DKIM en un selector, utilice la siguiente llamada a la API:
>>
@@ -910,7 +994,7 @@ Seleccione el servicio de correo en las siguientes pestañas:
>
> Al rotar el selector DKIM, puede activar directamente el segundo selector que haya creado para cambiarlo, pero conservando el primer selector que permanecerá activo hasta que el destinatario analice correctamente todos los mensajes de correo que se emitan con él.
-#### Desactivar y eliminar el DKIM
+#### API - Desactivar y eliminar el DKIM
> [!warning]
>
@@ -921,7 +1005,7 @@ Seleccione el servicio de correo en las siguientes pestañas:
Seleccione el servicio de correo en las siguientes pestañas:
> [!tabs]
-> **Correo electrónico (MX Plan)**
+> **MX Plan y Zimbra**
>> Si desea desactivar el DKIM sin eliminar los selectores y su par de claves, utilice la siguiente llamada a la API:
>>
>> > [!api]
@@ -1101,7 +1185,7 @@ Para consultar la cabecera de un mensaje de correo electrónico, consulte nuestr
Al activar por primera vez el DKIM en su servicio de correo, es posible crear dos selectores, cada uno de los cuales contiene un par de claves. El segundo selector sirve como sucesor del que está en uso.
-Para evitar los intentos de descifrar la clave DKIM, se recomienda cambiar periódicamente el par de claves. Para ello, asegúrese de haber configurado bien sus 2 selectores verificando que el primero esté en status `inProduction` y el segundo en status `ready`. Puede consultar este estado en la sección ["Los diferentes estados del DKIM"](#dkim-status).
+Para evitar los intentos de descifrar la clave DKIM, se recomienda cambiar periódicamente el par de claves. Para ello, asegúrese de haber configurado bien sus 2 selectores verificando que el primero esté en status `inProduction` y el segundo en status `ready`. Puede consultar este estado en la sección ["API - Los diferentes estados del DKIM"](#dkim-status).
Haga clic en la pestaña que corresponde a su producto.
@@ -1150,6 +1234,7 @@ Haga clic en la pestaña que corresponde a su producto para comprobar el estado
>> 1. Acceda al apartado `Web Cloud`{.action}.
>> 1. En la sección `MICROSOFT`, haga clic en `Exchange`{.action}.
>> 1. Seleccione la plataforma correspondiente.
+>> 1. Por último, abra la pestaña `Dominios asociados`{.action}.
>>
>> En la sección `Dominios asociados`{.action}, compruebe el color del icono `DKIM` a la derecha del dominio correspondiente (ver la imagen a continuación).
>>
@@ -1161,6 +1246,7 @@ Haga clic en la pestaña que corresponde a su producto para comprobar el estado
>> 1. Acceda al apartado `Web Cloud`{.action}.
>> 1. Haga clic en `Email Pro`{.action}.
>> 1. Seleccione la plataforma correspondiente.
+>> 1. Por último, abra la pestaña `Dominios asociados`{.action}.
>>
>> En la sección `Dominios asociados`{.action}, compruebe el color del icono `DKIM` a la derecha del dominio en cuestión (ver la imagen siguiente).
>>
@@ -1176,8 +1262,8 @@ Estos son los cuatro estados cuyo resultado es el icono DKIM en rojo en el área
>> Sólo hay un selector DKIM en la configuración. Para permitirnos cambiar a una nueva clave cuando sea necesario, se le solicita que configure los 2 selectores proporcionados por el servicio.
>> Para corregir este error :
>>
->> - compruebe el estado de los selectores de DKIM para determinar cuál debe configurarse. Para ello, consulte la sección "[Los diferentes estados del DKIM](#dkim-status)" de esta guía.
->> - Una vez que haya identificado el selector que desea configurar, siga los pasos que se indican en el apartado "[Configuración completa del DKIM](#firststep)" de esta guía, en función del plan que tenga contratado (Exchange o Email Pro), aplicándolo únicamente al selector correspondiente.
+>> - compruebe el estado de los selectores de DKIM para determinar cuál debe configurarse. Para ello, consulte la sección "[API - Los diferentes estados del DKIM](#dkim-status)" de esta guía.
+>> - Una vez que haya identificado el selector que desea configurar, siga los pasos que se indican en el apartado "[API - Configuración completa del DKIM](#firststep)" de esta guía, en función del plan que tenga contratado (Exchange o Email Pro), aplicándolo únicamente al selector correspondiente.
>> Espere un máximo de 24 horas después de configurar el selector.
>>
> **502**
@@ -1210,18 +1296,18 @@ Estos son los cuatro estados cuyo resultado es el icono DKIM en rojo en el área
#### Desde la API de OVHcloud, ¿cómo entender el estado del DKIM que no funciona?
-Si utiliza las API de OVHcloud para configurar su DKIM y este no está operativo, consulte la sección "[Los diferentes estados del DKIM](#dkim-status)" de esta guía para identificar el estado de sus selectores.
+Si utiliza las API de OVHcloud para configurar su DKIM y este no está operativo, consulte la sección "[API - Los diferentes estados del DKIM](#dkim-status)" de esta guía para identificar el estado de sus selectores.
A continuación, encontrará los estados que pueden bloquear el funcionamiento de su DKIM y la solución adecuada para cada situación.
> [!tabs]
> **Exchange et E-mail Pro**
->> - `WaitingRecord`: los registros DNS están pendientes de configuración o se están validando en la zona DNS del dominio. Se realiza una comprobación automática periódica para comprobar si el registro DNS está presente y se ha completado correctamente. En función de su plan, siga el **paso 5** del apartado "[Configuración completa del DKIM](#firststep)" para configurar correctamente la zona DNS del dominio.
->> - `ready`: los registros DNS están presentes en la zona. El DKIM ya puede activarse. Para activar el selector, pulse en la sección "[Activar o cambiar un selector DKIM](#enable-switch)".
->> - `deleting`: se está eliminando el DKIM. Una vez eliminado, siga la sección "[Configuración completa del DKIM](#firststep)".
->> - `disabling`: se está desactivando el DKIM. Una vez hecho esto, puede activar el selector en la sección "[Activar o cambiar un selector DKIM](#enable-switch)".
+>> - `WaitingRecord`: los registros DNS están pendientes de configuración o se están validando en la zona DNS del dominio. Se realiza una comprobación automática periódica para comprobar si el registro DNS está presente y se ha completado correctamente. En función de su plan, siga el **paso 5** del apartado "[API - Configuración completa del DKIM](#firststep)" para configurar correctamente la zona DNS del dominio.
+>> - `ready`: los registros DNS están presentes en la zona. El DKIM ya puede activarse. Para activar el selector, pulse en la sección "[API - Activar o cambiar un selector DKIM](#enable-switch)".
+>> - `deleting`: se está eliminando el DKIM. Una vez eliminado, siga la sección "[API - Configuración completa del DKIM](#firststep)".
+>> - `disabling`: se está desactivando el DKIM. Una vez hecho esto, puede activar el selector en la sección "[API - Activar o cambiar un selector DKIM](#enable-switch)".
>> - `todo`: la tarea se ha inicializado y debe iniciarse. Una vez transcurridas 24 horas, si el selector sigue en este estado, le invitamos a abrir un [tíquet con el soporte](https://help.ovhcloud.com/csm?id=csm_get_help) indicando el número del selector correspondiente.
-> **Correo electrónico (MX Plan)**
+> **MX Plan y Zimbra**
>> - `disabled`: El DKIM está desactivado, todavía no se ha configurado o ha sido desactivado por API.
>> - `modifying`: La configuración del DKIM está en curso, es necesario esperar hasta que el proceso haya finalizado.
>> - `toConfigure`: La configuración del DKIM está pendiente de los parámetros DNS del dominio. Debe introducir manualmente los registros DNS en la zona del nombre de dominio. Para ello, consulte el paso "[Configuración completa del DKIM](#confemail)" de esta guía.
@@ -1229,8 +1315,8 @@ A continuación, encontrará los estados que pueden bloquear el funcionamiento d
>>
>> En el nivel de los selectores también tiene 2 estados de error:
>>
->> - `toSet`: el selector no está configurado en la zona DNS del dominio. Haga clic en [Paso 4 de "Configuración completa de DKIM" para Correo electrónico (MX Plan)](#confemail).
->> - `toFix`: el selector se ha configurado correctamente en la zona DNS del dominio, pero los valores son incorrectos. Haga clic en [Paso 4 de "Configuración completa de DKIM" para Correo electrónico (MX Plan)](#confemail).
+>> - `toSet`: el selector no está configurado en la zona DNS del dominio. Haga clic en [Paso 4 de "Configuración completa de DKIM" para MX Plan y Zimbra](#confemail).
+>> - `toFix`: el selector se ha configurado correctamente en la zona DNS del dominio, pero los valores son incorrectos. Haga clic en [Paso 4 de "Configuración completa de DKIM" para MX Plan y Zimbra](#confemail).
## Más información
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.fr-fr.md b/pages/web_cloud/domains/dns_zone_dkim/guide.fr-fr.md
index c144a9f013d..937fcdce203 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.fr-fr.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.fr-fr.md
@@ -1,7 +1,7 @@
---
title: Améliorer la sécurité des e-mails via un enregistrement DKIM
excerpt: Découvrez comment configurer un enregistrement DKIM sur votre nom de domaine et votre plateforme e-mail OVHcloud
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
## Objectif
@@ -46,10 +57,11 @@ L'enregistrement DKIM (**D**omain**K**eys **I**dentified **M**ail) permet de sig
- Disposer d'un accès à la gestion du nom de domaine concerné depuis l'[espace client OVHcloud](/links/manager) ou auprès de votre prestataire de domaine s'il est enregistré en dehors d'OVHcloud.
- Être connecté à votre [espace client OVHcloud](/links/manager).
-- Avoir souscrit à une des offres e-mail :
- - E-mails (MX Plan) OVHcloud (disponible via une [offre d’hébergement Web Cloud](/links/web/hosting)), un [hébergement gratuit 100M](/links/web/domains-free-hosting) ou une offre MX Plan commandée séparément.
+- Avoir souscrit à l'une des offres e-mail ci-dessous :
+ - MX Plan OVHcloud (disponible via une [offre d’hébergement Web Cloud](/links/web/hosting)), un [hébergement gratuit 100M](/links/web/domains-free-hosting) ou une offre MX Plan commandée séparément.
- [Exchange](/links/web/emails-hosted-exchange) ou [Private Exchange](/links/web/emails-hosted-exchange).
- [E-mail Pro](/links/web/email-pro).
+ - [Zimbra](/links/web/zimbra).
- Une offre e-mail hors OVHcloud disposant du DKIM.
> [!warning]
@@ -70,15 +82,15 @@ L'enregistrement DKIM (**D**omain**K**eys **I**dentified **M**ail) permet de sig
- [Pourquoi a-t-on besoin de configurer les serveurs DNS ?](#dns-and-dkim)
- [Exemple d'un e-mail envoyé en utilisant le DKIM](#example)
- [Qu'est-ce qu'un sélecteur DKIM ?](#selector)
-- [Configurer le DKIM automatiquement pour une offre e-mail Exchange ou E-mail Pro OVHcloud](#auto-dkim)
-- [Configurer le DKIM manuellement pour une offre e-mail Exchange ou E-mail Pro OVHcloud](#internal-dkim)
- - [Configuration complète du DKIM](#firststep)
- - [Pour E-mails (MX Plan)](#confemail)
+- [Configurer le DKIM automatiquement pour une offre e-mail OVHcloud](#auto-dkim)
+- [Configurer le DKIM par API pour une offre e-mail OVHcloud](#internal-dkim)
+ - [API - Configuration complète du DKIM](#firststep)
+ - [Pour MX Plan et Zimbra](#confemail)
- [Pour Exchange](#confex)
- [Pour E-mail Pro](#confemp)
- - [Les différents états du DKIM](#dkim-status)
- - [Activer ou changer un sélecteur DKIM](#enable-switch)
- - [Désactiver et supprimer le DKIM](#disable-delete)
+ - [API - Les différents états du DKIM](#dkim-status)
+ - [API - Activer ou changer un sélecteur DKIM](#enable-switch)
+ - [API - Désactiver et supprimer le DKIM](#disable-delete)
- [Configurer DKIM pour une offre e-mail hors de votre compte OVHcloud](#external-dkim)
- [Enregistrement DKIM](#dkim-record)
- [Enregistrement TXT](#txt-record)
@@ -91,9 +103,9 @@ L'enregistrement DKIM (**D**omain**K**eys **I**dentified **M**ail) permet de sig
### Comment le DKIM fonctionne-t-il ?
-Pour bien comprendre pourquoi le DKIM permet de sécuriser vos échanges d'e-mails, il est nécessaire de comprendre comment il fonctionne. Le DKIM fait appel au «**hachage**» et au «**chiffrement asymétrique**» pour créer une signature sécurisée. La **plateforme e-mail** et la **Zone DNS** de votre nom de domaine vont aider à transmettre les informations du DKIM à vos destinataires.
+Pour bien comprendre pourquoi le DKIM permet de sécuriser vos échanges d'e-mails, il est nécessaire de comprendre comment il fonctionne. Le DKIM fait appel au «**hachage**» et au «**chiffrement asymétrique**» pour créer une signature sécurisée. La **plateforme e-mail** et la **zone DNS** de votre nom de domaine vont aider à transmettre les informations du DKIM à vos destinataires.
-#### Le hachage
+/// details | Le hachage
Le principe d'une **fonction de hachage** est de générer une **signature** (aussi appelée empreinte) à partir d'une donnée d'entrée. Son intérêt est de créer en sortie une suite de caractères fixe, quelle que soit la quantité de données en entrée.
@@ -103,7 +115,9 @@ Sur le diagramme suivant, vous pouvez constater que la sortie (Output) sera touj
La fonction de hachage est utile lorsque vous souhaitez vérifier l'intégrité d'un message. En effet, deux données qui peuvent sembler très similaires présentent en réalité une valeur de hachage complètement différente, avec une longueur de caractères égale en sortie, quelle que soit la longueur d'entrée.
-#### Le chiffrement asymétrique
+///
+
+/// details | Le chiffrement asymétrique
Le **chiffrement**, comme son nom l'indique, a pour but de chiffrer les données qu'on lui donne. Il est « **asymétrique** » car la clé de chiffrement n'est pas la même que la clé de déchiffrement, contrairement à un chiffrement symétrique qui utilisera la même clé pour chiffrer et déchiffrer.
@@ -119,17 +133,23 @@ Il existe deux utilisations du chiffrement asymétrique :
{.thumbnail .w-400 .h-600}
-#### Comment le hachage et le chiffrement asymétrique sont-ils utilisés pour le DKIM ?
+///
+
+/// details | Comment le hachage et le chiffrement asymétrique sont-ils utilisés pour le DKIM ?
Depuis la plateforme e-mail, le DKIM va utiliser le hachage pour créer une signature à partir de certains éléments de [l'en-tête de l'e-mail](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) et du corps de l'e-mail (contenu de l'e-mail).
La signature est ensuite chiffrée avec la clé privée en utilisant le chiffrement asymétrique.
-#### Pourquoi a-t-on besoin de configurer les serveurs DNS ?
+///
+
+/// details | Pourquoi a-t-on besoin de configurer les serveurs DNS ?
Pour que le destinataire puisse vérifier la signature DKIM de l'expéditeur, il aura besoin des paramètres DKIM et surtout de la clé publique pour la déchiffrer. La [zone DNS](/pages/web_cloud/domains/dns_zone_general_information) d'un nom de domaine est publique, c'est pourquoi un enregistrement DNS est ajouté pour transmettre la clé publique et les paramètres DKIM au destinataire.
-#### Qu'est-ce qu'un sélecteur DKIM
+///
+
+/// details | Qu'est-ce qu'un sélecteur DKIM ?
Lorsque vous activez le DKIM, celui-ci fonctionne avec une paire de clé publique / clé privée. Il est possible d'attribuer plusieurs paires de clés à votre nom de domaine, dans le cadre d'une rotation par exemple. En effet, lorsque vous changez de paire de clés, l'ancienne paire doit rester active le temps que l'ensemble des e-mails que vous avez envoyé avec l'ancienne clé ne rencontre pas d'échec dans la vérification du DKIM sur le serveur de réception.
@@ -142,7 +162,9 @@ Pour que ce principe de rotation fonctionne, on va utiliser ce qu'on appelle les
La valeur du sélecteur est ici `s=ovhex123456-selector1`.
-#### Exemple d'un e-mail envoyé en utilisant le DKIM
+///
+
+/// details | Exemple d'un e-mail envoyé en utilisant le DKIM
Lorsque vous envoyez un e-mail depuis **contact@mydomain.ovh**, une signature chiffrée à l'aide d'une clé privée (private key) est ajoutée dans l'en-tête de l'e-mail.
@@ -152,16 +174,25 @@ Le destinataire **recipient@otherdomain.ovh** pourra déchiffrer cette signature
{.thumbnail .w-400 .h-600}
-### Configurer le DKIM automatiquement pour une offre e-mail Exchange ou E-mail Pro OVHcloud
+///
+
+### Configurer le DKIM automatiquement pour une offre e-mail OVHcloud
-La configuration automatique du DKIM est accessible pour les offres e-mail MX Plan (incluse avec un [hébergement Web Cloud](/links/web/hosting), un [hébergement gratuit 100M](/links/web/domains-free-hosting) ou commandée séparément), [Exchange](/links/web/emails) et [E-mail Pro](/links/web/email-pro).
+La configuration automatique du DKIM est accessible pour toutes nos offres e-mail :
-Par défaut le DKIM n'est pas activé lorsque vous ajoutez un nom de domaine à votre plateforme. Vous devez donc lancer le processus de configuration automatique via l'espace client.
+- MX Plan incluse avec un [hébergement Web Cloud](/links/web/hosting), un [hébergement gratuit 100M](/links/web/domains-free-hosting) ou commandée séparément.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
+
+Lorsque vous configurez votre nom de domaine sur une solution e-mail OVHcloud, la configuration automatique du DKIM est proposée et réalisée par défaut si vous ne la désactivez pas.
+
+Si le DKIM n'a pas été activé lorsque vous avez ajouté un nom de domaine à votre plateforme e-mail, vous devrez lancer le processus de configuration automatique via l'espace client.
Cliquez sur l'onglet ci-dessous correspondant à votre offre.
> [!tabs]
-> **E-mails (MX Plan)**
+> **MX Plan**
>>
>> 1. Connectez-vous à votre [espace client OVHcloud](/links/manager).
>> 1. Rendez-vous dans la partie `Web Cloud`{.action}.
@@ -173,6 +204,16 @@ Cliquez sur l'onglet ci-dessous correspondant à votre offre.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur `Valider`{.action} depuis la fenêtre d'activation qui apparaît.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Dans le cas où votre nom de domaine n'est pas géré dans le même espace client OVHcloud que votre plateforme e-mail ou enregistré hors OVHcloud, vous obtenez la fenêtre ci-dessous :
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Celle-ci vous invite à saisir deux valeurs CNAME dans la zone DNS du nom de domaine, ce qui permet de lier ce nom de domaine aux sélecteurs DKIM de votre service e-mail. Il est nécessaire de saisir ces valeurs et de vous assurer qu'elles soient propagées avant de cliquer sur `Activer`{.action}.
+>>
> **Exchange**
>>
>> 1. Connectez-vous à votre [espace client OVHcloud](/links/manager).
@@ -185,6 +226,10 @@ Cliquez sur l'onglet ci-dessous correspondant à votre offre.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur `Valider`{.action} depuis la fenêtre d'activation qui apparaît.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
> **E-mail Pro**
>>
>> 1. Connectez-vous à votre [espace client OVHcloud](/links/manager).
@@ -196,29 +241,42 @@ Cliquez sur l'onglet ci-dessous correspondant à votre offre.
>> À droite du nom de domaine concerné, vous pouvez observer que la pastille `DKIM` est rouge.
>>
>> {.thumbnail .w-400 .h-600}
+>>
+>> Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur `Valider`{.action} depuis la fenêtre d'activation qui apparaît.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Connectez-vous à votre [espace client OVHcloud](/links/manager).
+>> 1. Rendez-vous dans la partie `Web Cloud`{.action}.
+>> 1. Cliquez sur `Zimbra Mail`{.action}.
+>> 1. Enfin, allez dans l'onglet `Domaine`{.action}.
+>> 1. À droite du domaine concerné, cliquez sur `⁝`{.action}, puis sur `Diagnostics`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> À droite de la mention `DKIM` sur l'onglet correspondant, vous devriez observer un avertissement indiquant que le DKIM est en défaut. Cliquez sur l'onglet `DKIM`{.action} pour accéder au statut de la configuration DKIM. Pour corriger l'erreur, vous devez ajouter ou modifier deux entrées DNS de type CNAME dans la zone DNS du nom de domaine associé, selon les informations visible depuis cet onglet.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Astuce pour créer un enregistrement CNAME**
+>> >
+>> > Depuis [l'espace client OVHcloud](/links/manager) où est hébergé le nom de domaine de votre service e-mail, dans la partie `Web Cloud`{.action}, cliquez sur `Noms de domaine`{.action} dans la colonne de gauche et sélectionnez le nom de domaine concerné.
+>> > Sélectionnez l'onglet `Zone DNS`{.action} puis cliquez sur `Ajouter une entrée`{.action} dans la fenêtre qui s'affiche. Choisissez `CNAME` puis complétez selon les valeurs que vous avez relevées.
Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur `Valider`{.action} depuis la fenêtre d'activation qui apparaît.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **E-mails (MX Plan)**
->
-> Dans le cas où votre nom de domaine n'est pas géré dans le même espace client OVHcloud que votre plateforme e-mail ou enregistré hors OVHcloud, vous obtenez la fenêtre ci-dessous :
->
-> {.thumbnail .w-400 .h-600}
->
-> Celle-ci vous invite à saisir deux valeurs CNAME dans la zone DNS du nom de domaine, ce qui permet de lier ce nom de domaine aux sélecteurs DKIM de votre service e-mail. Il est nécessaire de saisir ces valeurs et de vous assurer qu'elles soit propagées avant de cliquer sur `Activer`{.action}.
->
-
-L'activation automatique du DKIM dure entre 30 minutes et 24 heures maximum. Pour vérifier que votre DKIM est fonctionnel, il vous suffit de retourner dans l'onglet `Informations générales`{.action} ou `Domaines associés`{.action} de votre plateforme e-mail et de vous assurer que la pastille `DKIM` est devenue verte.
+L'activation automatique du DKIM dure entre 30 minutes et 24 heures maximum. Pour vérifier que votre DKIM est fonctionnel, il vous suffit de retourner dans la rubrique de gestion du domaine mentionnée dans les onglet ci-dessus et de vérifier que la pastille `DKIM` est verte ou, pour une offre Zimbra, que l'onglet `DKIM` ne présente plus l'icône d'avertissement.
{.thumbnail .w-400 .h-600}
Au-delà des 24 heures, si votre pastille `DKIM` est rouge, consultez la rubrique [« Pourquoi le DKIM n'est pas fonctionnel et apparait en rouge dans l'espace client ? »](#reddkim) de ce guide.
-### Configurer le DKIM manuellement pour une offre e-mail OVHcloud
+### Configurer le DKIM par API pour une e-mail OVHcloud
Pour une plateforme Exchange ou E-mail Pro, vous devez d'abord récupérer la référence de votre plateforme pour configurer votre DKIM.
@@ -251,18 +309,25 @@ Assurez-vous également que le nom de domaine que vous souhaitez utiliser pour v
{.thumbnail .w-400 .h-600}
-#### Configuration complète du DKIM
+#### API - Configuration complète du DKIM
-Pour configurer le DKIM, rendez-vous sur le site , connectez-vous à l'aide du bouton `Login`{.action} en haut à droite et renseignez vos identifiants OVHcloud.
+Pour configurer le DKIM, rendez-vous sur la [page des API OVHcloud](/links/console) et connectez-vous :
-> Appuyez-vous sur notre guide [« Découvrez comment utiliser les API OVHcloud »](/pages/manage_and_operate/api/first-steps) si vous n'avez jamais utilisé les API.
+1. Cliquez sur `Authentication`{.action} en haut à gauche.
+1. Cliquez ensuite sur `Login with OVHcloud SSO`{.action}.
+1. Saisissez vos identifiants OVHcloud.
+1. Cliquez sur le bouton `Authorize`{.action} pour autoriser les appels aux API depuis ce site.
-Dirigez-vous vers la section `/email/domain/`(offres E-mails (MXplan)) `/email/exchange` (offres Exchanges) ou `/email/pro` (offre E-mail Pro) des API et tapez « dkim » dans la case `Filter` pour faire apparaître uniquement les API relatifs au DKIM.
+> [!primary]
+>
+> Appuyez-vous sur notre guide « [Premiers pas avec les API OVHcloud](/pages/manage_and_operate/api/first-steps) » si vous n'avez jamais utilisé les API.
+
+Dirigez-vous vers la section `/email/domain/` (offres MX Plan et Zimbra), `/email/exchange` (offre Exchange) ou `/email/pro` (offre E-mail Pro) des API et renseignez « dkim » dans le champ `Filter` pour faire apparaître uniquement les fonctions API relatives au DKIM.
Cliquez sur l'onglet correspondant à votre offre :
> [!tabs]
-> **E-mails (MX Plan)**
+> **MX Plan et Zimbra**
>>
>> {.thumbnail .w-400 .h-600}
>>
@@ -275,7 +340,7 @@ Cliquez sur l'onglet correspondant à votre offre :
>> {.thumbnail .w-400 .h-600}
>>
-##### **Pour E-mails (MX Plan)**
+##### **Pour MX Plan et Zimbra**
Suivez les **5 étapes** en cliquant successivement sur chacun des 5 onglets ci-dessous :
@@ -589,10 +654,10 @@ Suivez les **5 étapes** ci-dessous en cliquant sur chacun des onglets.
>> >
>> > N'oubliez pas qu'une modification dans une zone DNS est soumise à un délai de propagation. Il est généralement court mais peut s'étendre jusqu'à 24 heures.
>>
-> **5.Activation du DKIM**
+> **5. Activation du DKIM**
>> > [!warning]
>> >
->> > Depuis la section [**Les différents états du DKIM**](#dkim-status) de ce guide, vérifiez que la valeur `status:` est bien en `ready` avant de pouvoir activer le DKIM.
+>> > Depuis la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide, vérifiez que la valeur `status:` est bien en `ready` avant de pouvoir activer le DKIM.
>>
>> Pour activer le DKIM, utilisez l'appel API suivant :
>>
@@ -618,7 +683,7 @@ Suivez les **5 étapes** ci-dessous en cliquant sur chacun des onglets.
>>
>> > [!success]
>> >
->> > Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s'assurer que celui-ci est bien activé, consultez la section [**« Les différents états du DKIM »**](#dkim-status) de ce guide pour vérifier que la valeur `status:` est bien en `inProduction`. Si c'est bien le cas, votre DKIM est désormais actif.
**Si vous avez créé deux sélecteurs**, le deuxième sélecteur devrait être en `status: "ready"`.
+>> > Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s'assurer que celui-ci est bien activé, consultez la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide pour vérifier que la valeur `status:` est bien en `inProduction`. Si c'est bien le cas, votre DKIM est désormais actif.
**Si vous avez créé deux sélecteurs**, le deuxième sélecteur devrait être en `status: "ready"`.
>>
##### **Pour E-mail Pro**
@@ -752,10 +817,10 @@ Suivez les **5 étapes** ci-dessous en cliquant sur chacun des onglets.
>> >
>> > N'oubliez pas qu'une modification dans une zone DNS est soumise à un délai de propagation. Il est généralement court mais peut s'étendre jusqu'à 24 heures.
>>
-> **5.Activation du DKIM**
+> **5. Activation du DKIM**
>> > [!warning]
>> >
->> > Depuis la section [**Les différents états du DKIM**](#dkim-status) de ce guide, vérifiez que la valeur `status:` est bien en `ready` avant de pouvoir activer le DKIM.
+>> > Depuis la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide, vérifiez que la valeur `status:` est bien en `ready` avant de pouvoir activer le DKIM.
>>
>> Pour activer le DKIM, utilisez l'appel API suivant :
>>
@@ -780,15 +845,15 @@ Suivez les **5 étapes** ci-dessous en cliquant sur chacun des onglets.
>>
>> > [!success]
>> >
->> > Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s'assurer que celui-ci est bien activé, consultez la section [**« Les différents états du DKIM »**](#dkim-status) de ce guide pour vérifier que la valeur `status:` est bien en `inProduction`. Si c'est bien le cas, votre DKIM est désormais actif.
**Si vous avez créé deux sélecteurs**, le deuxième sélecteur devrait être en `status: "ready"`.
+>> > Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s'assurer que celui-ci est bien activé, consultez la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide pour vérifier que la valeur `status:` est bien en `inProduction`. Si c'est bien le cas, votre DKIM est désormais actif.
**Si vous avez créé deux sélecteurs**, le deuxième sélecteur devrait être en `status: "ready"`.
>>
-#### Les différents états du DKIM
+#### API - Les différents états du DKIM
-Sélectionnez l'offre e-mail concernée dans les onglets suivant:
+Sélectionnez l'offre e-mail concernée dans les onglets suivants :
> [!tabs]
-> **E-mail (MX Plan)**
+> **MX Plan et Zimbra**
>> Lors de vos opérations sur le DKIM de votre plateforme E-mail, utilisez l'appel API ci-dessous pour vérifier le statut actuel du DKIM.
>>
>> > [!api]
@@ -801,15 +866,15 @@ Sélectionnez l'offre e-mail concernée dans les onglets suivant:
>>
>> - `disabled` : le DKIM est désactivé, il n'a pas encore été configuré ou il a été désactivé par API.
>> - `modifying` : la configuration du DKIM est en cours, il est nécessaire de patienter jusqu'à la fin du processus.
->> - `toConfigure` : la configuration du DKIM est en attente des paramètres DNS du nom de domaine. Vous devez renseigner manuellement les enregistrements DNS dans la zone du nom de domaine. Pour cela, appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour E-mails (MX Plan)](#confemail).
+>> - `toConfigure` : la configuration du DKIM est en attente des paramètres DNS du nom de domaine. Vous devez renseigner manuellement les enregistrements DNS dans la zone du nom de domaine. Pour cela, appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
>> - `enabled` : le DKIM est configuré et fonctionnel.
>> - `error` : Le processus d'installation a rencontré une erreur. Nous vous invitons à ouvrir un [ticket auprès du support](https://help.ovhcloud.com/csm?id=csm_get_help) en précisant le nom de domaine concerné.
>>
>> Au niveau des sélecteurs vous avez également 3 états possibles:
>>
>> - `set` : le sélecteur est bien configuré et actif.
->> - `toSet` : le sélecteur n'est pas configuré dans la zone DNS du nom de domaine. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour E-mails (MX Plan)](#confemail).
->> - `toFix` : le sélecteur a bien été configuré dans la zone DNS du nom de domaine mais les valeurs sont incorrectes. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour E-mails (MX Plan)](#confemail).
+>> - `toSet` : le sélecteur n'est pas configuré dans la zone DNS du nom de domaine. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
+>> - `toFix` : le sélecteur a bien été configuré dans la zone DNS du nom de domaine mais les valeurs sont incorrectes. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
>>
> **Exchange**
>> Lors de vos opérations sur le DKIM de votre plateforme Exchange, utilisez l'appel API ci-dessous pour vérifier le statut actuel du DKIM.
@@ -869,7 +934,7 @@ Sélectionnez l'offre e-mail concernée dans les onglets suivant:
>> ```
>>
-#### Activer ou changer un sélecteur DKIM
+#### API - Activer ou changer un sélecteur DKIM
> [!warning]
>
@@ -878,6 +943,27 @@ Sélectionnez l'offre e-mail concernée dans les onglets suivant:
Sélectionnez l'offre e-mail concernée parmi les onglets suivants :
> [!tabs]
+> **MX Plan et Zimbra**
+>> Pour activer le DKIM, utilisez l'appel API suivant :
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain` : saisissez le nom de domaine attaché à votre service E-mail sur lequel le DKIM doit être présent.
+>>
+>> *Exemple de résultat :*
+>>
+>> ```console
+>> {
+>> "function": "domain/enableDKIM",
+>> "id": 123456789,
+>> "domain": "guidesteam.ovh",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> Pour activer le DKIM sur un sélecteur, utilisez l'appel API suivant :
>>
@@ -908,7 +994,7 @@ Sélectionnez l'offre e-mail concernée parmi les onglets suivants :
>
> Lors d'une rotation de sélecteur DKIM, vous pouvez directement activer le deuxième sélecteur que vous avez créé afin de basculer dessus, tout en conservant le premier sélecteur qui restera actif le temps que tous les e-mails délivrés avec celui-ci soient bien analysés par leur destinataire.
-#### Désactiver et supprimer le DKIM
+#### API - Désactiver et supprimer le DKIM
> [!warning]
>
@@ -919,7 +1005,7 @@ Sélectionnez l'offre e-mail concernée parmi les onglets suivants :
Sélectionnez l'offre e-mail concernée parmi les onglets suivants :
> [!tabs]
-> **E-mail (MX Plan)**
+> **MX Plan et Zimbra**
>> Si vous souhaitez désactiver le DKIM sans supprimer les sélecteurs et leur paire de clés, utilisez l'appel API suivant :
>>
>> > [!api]
@@ -1099,7 +1185,7 @@ Pour récupérer l'en-tête d'un e-mail, consulter notre guide « [Récupérer l
Lorsque vous activez pour la première fois le DKIM sur votre service e-mail, il est possible de créer 2 sélecteurs qui contiennent chacun une paire de clés. Le deuxième sélecteur sert de successeur à celui qui est en cours d'utilisation.
-Pour éviter les tentatives de déchiffrement de la clé DKIM, il est conseillé de changer régulièrement de paire de clés. Pour cela, assurez-vous d'avoir bien configuré vos 2 sélecteurs en vérifiant que le premier est en status `inProduction`et le second en status `ready`. Vous pouvez vérifier cet état en vous référant à la section [« Les différents états du DKIM »](#dkim-status).
+Pour éviter les tentatives de déchiffrement de la clé DKIM, il est conseillé de changer régulièrement de paire de clés. Pour cela, assurez-vous d'avoir bien configuré vos 2 sélecteurs en vérifiant que le premier est en status `inProduction`et le second en status `ready`. Vous pouvez vérifier cet état en vous référant à la section « [API - Les différents états du DKIM](#dkim-status) ».
Cliquez sur l'onglet ci-dessous correspondant à votre offre.
@@ -1148,6 +1234,7 @@ Cliquez sur l'onglet ci-dessous correspondant à votre offre, pour constater l'
>> 1. Rendez-vous dans la partie `Web Cloud`{.action}.
>> 1. Dans la rubrique `MICROSOFT`, cliquez sur `Exchange`{.action}.
>> 1. Sélectionnez la plateforme concernée.
+>> 1. Enfin, allez dans l'onglet `Domaines associés`{.action}.
>>
>> Dans la rubrique `Domaines associés`{.action}, vérifiez la couleur de l'icône `DKIM` à droite du nom de domaine concerné (voir l'image ci-dessous).
>>
@@ -1175,8 +1262,8 @@ Voici les 4 états ayant pour résultat l'icône DKIM en rouge dans votre espace
>> Seul un sélecteur DKIM est présent dans votre configuration. Pour nous permettre la bascule vers une nouvelle clé lorsque cela est nécessaire, il est demandé de configurer les 2 sélecteurs fournis par le service.
>> Pour corriger cette erreur :
>>
->> - Vérifiez l'état des sélecteurs DKIM pour identifier celui qui doit être configuré. Pour cela, aidez-vous de la partie « [Les différents états du DKIM](#dkim-status) » de ce guide.
->> - Une fois que vous avez identifié le sélecteur à configurer, suivez les étapes de la partie « [Configuration complète du DKIM](#firststep) » sur ce guide, selon votre offre (Exchange ou E-mail Pro), en l'appliquant uniquement au sélecteur concerné.
+>> - Vérifiez l'état des sélecteurs DKIM pour identifier celui qui doit être configuré. Pour cela, aidez-vous de la partie « [API - Les différents états du DKIM](#dkim-status) » de ce guide.
+>> - Une fois que vous avez identifié le sélecteur à configurer, suivez les étapes de la partie « [API - Configuration complète du DKIM](#firststep) » sur ce guide, selon votre offre (Exchange ou E-mail Pro), en l'appliquant uniquement au sélecteur concerné.
>> Patientez maximum 24 heures après configuration du sélecteur.
>>
> **502**
@@ -1209,18 +1296,18 @@ Voici les 4 états ayant pour résultat l'icône DKIM en rouge dans votre espace
#### Depuis l'interface API OVHcloud, comment comprendre l'état du DKIM qui ne fonctionne pas ?
-Si vous utilisez les API OVHcloud pour configurer votre DKIM et que celui-ci n'est pas fonctionnel aidez-vous de la rubrique « [Les différents états du DKIM](#dkim-status) » de ce guide pour identifier l'état de vos sélecteurs.
+Si vous utilisez les API OVHcloud pour configurer votre DKIM et que celui-ci n'est pas fonctionnel aidez-vous de la rubrique « [API - Les différents états du DKIM](#dkim-status) » de ce guide pour identifier l'état de vos sélecteurs.
Retrouvez ci-dessous les états qui peuvent bloquer le fonctionnement de votre DKIM et la solution appropriée à chaque situation.
> [!tabs]
> **Exchange et E-mail Pro**
->> - `WaitingRecord` : Les enregistrements DNS sont en attente de configuration ou en cours de validation dans la zone DNS du nom de domaine. Une vérification automatique régulière est faite pour constater si l'enregistrement DNS est présent et correctement renseigné. Selon vote offre, suivez **l'étape 5** dans la section « [Configuration complète du DKIM](#firststep) » pour configurer correctement la zone DNS du nom de domaine concerné.
->> - `ready` : Les enregistrements DNS sont présents dans la zone. Le DKIM peut maintenant être activé. Il vous suffira d'activer le sélecteur en vous appuyant sur la section « [Activer ou changer un sélecteur DKIM](#enable-switch) ».
->> - `deleting` : Le DKIM est en cours de suppression. Après suppression, il vous faudra suivre la section « [Configuration complète du DKIM](#firststep) ».
->> - `disabling` : Le DKIM est en cours de désactivation. Après cette opération, vous pourrez activer le sélecteur en vous appuyant sur la section « [Activer ou changer un sélecteur DKIM](#enable-switch) ».
+>> - `WaitingRecord` : Les enregistrements DNS sont en attente de configuration ou en cours de validation dans la zone DNS du nom de domaine. Une vérification automatique régulière est faite pour constater si l'enregistrement DNS est présent et correctement renseigné. Selon vote offre, suivez **l'étape 5** dans la section « [API - Configuration complète du DKIM](#firststep) » pour configurer correctement la zone DNS du nom de domaine concerné.
+>> - `ready` : Les enregistrements DNS sont présents dans la zone. Le DKIM peut maintenant être activé. Il vous suffira d'activer le sélecteur en vous appuyant sur la section « [API - Activer ou changer un sélecteur DKIM](#enable-switch) ».
+>> - `deleting` : Le DKIM est en cours de suppression. Après suppression, il vous faudra suivre la section « [API - Configuration complète du DKIM](#firststep) ».
+>> - `disabling` : Le DKIM est en cours de désactivation. Après cette opération, vous pourrez activer le sélecteur en vous appuyant sur la section « [API - Activer ou changer un sélecteur DKIM](#enable-switch) ».
>> - `todo` : La tâche a été initialisée, elle doit se lancer. Au-delà de 24 heures, si votre sélecteur est toujours dans cet état, nous vous invitons à ouvrir un [ticket auprès du support](https://help.ovhcloud.com/csm?id=csm_get_help) en précisant le numéro du sélecteur concerné.
-> **E-mails (MX Plan)**
+> **MX Plan et Zimbra**
>> - `disabled` : Le DKIM est désactivé, il n'a pas encore été configuré ou il a été désactivé par API.
>> - `modifying` : La configuration du DKIM est en cours, il est nécessaire de patienter jusqu'à la fin du processus.
>> - `toConfigure` : La configuration du DKIM est en attente des paramètres DNS du nom de domaine. Vous devez renseigner manuellement les enregistrements DNS dans la zone du nom de domaine. Pour cela; appuyez-vous sur l'étape « [Configuration complète du DKIM](#confemail) » de ce guide.
@@ -1228,11 +1315,9 @@ Retrouvez ci-dessous les états qui peuvent bloquer le fonctionnement de votre D
>>
>> Au niveau des sélecteurs vous avez également 2 états relatifs à une erreur:
>>
->> - `toSet` : le sélecteur n'est pas configuré dans la zone DNS du nom de domaine. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour E-mails (MX Plan)](#confemail).
->> - `toFix` : le sélecteur a bien été configuré dans la zone DNS du nom de domaine mais les valeurs sont incorrectes. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour E-mails (MX Plan)](#confemail).
+>> - `toSet` : Le sélecteur n'est pas configuré dans la zone DNS du nom de domaine. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
+>> - `toFix` : Le sélecteur a bien été configuré dans la zone DNS du nom de domaine mais les valeurs sont incorrectes. Appuyez-vous sur [l'étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
## Aller plus loin
-Échangez avec notre [communauté d'utilisateurs](/links/community).
-
-Dans le cadre de la mise en place d'un enregistrement DNS dynamique (DynHost), l'utilisation d'un wildcard (caractère `*`) dans la case `sous-domaine`{.action} du formulaire d'un enregistrement DNS est indisponible.
\ No newline at end of file
+Échangez avec notre [communauté d'utilisateurs](/links/community).
\ No newline at end of file
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.it-it.md b/pages/web_cloud/domains/dns_zone_dkim/guide.it-it.md
index 32973f34c60..d6947a4452b 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.it-it.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.it-it.md
@@ -1,7 +1,7 @@
---
title: Migliora la sicurezza delle email con un record DKIM
excerpt: Come configurare un record DKIM sul tuo dominio e sulla tua piattaforma email OVHcloud
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
## Obiettivo
@@ -50,6 +61,7 @@ Il record DKIM (**D**omain**K**eys **I**dentified **M**ail) permette di firmare
- "Email" (MX Plan) OVHcloud. È disponibile tramite una [offerta di hosting Web Cloud](/links/web/hosting), un [hosting gratuito 100M](/links/web/domains-free-hosting) o una soluzione MX Plan ordinata separatamente.
- [Exchange](/links/web/emails-hosted-exchange) o [Private Exchange](/links/web/emails-hosted-exchange).
- [Email Pro](/links/web/email-pro).
+ - [Zimbra](/links/web/zimbra).
- Offerta di posta elettronica esterna a OVHcloud con DKIM.
> [!warning]
@@ -70,15 +82,15 @@ Il record DKIM (**D**omain**K**eys **I**dentified **M**ail) permette di firmare
- [Perché è necessario configurare i server DNS?](#dns-and-dkim)
- [Esempio di un'email inviata utilizzando il DKIM](#example)
- [Cos'è un selettore DKIM?](#selector)
-- [Configurare DKIM automaticamente per un servizio di posta Exchange o Email Pro di OVHcloud](#auto-dkim)
-- [Configurare il DKIM manualmente per un servizio di posta Exchange o Email Pro OVHcloud](#internal-dkim)
- - [Configurazione completa del DKIM](#firststep)
+- [Configurare automaticamente il DKIM per un'offerta e-mail OVHcloud](#auto-dkim)
+- [Configurare il DKIM tramite API per un'offerta e-mail OVHcloud](#internal-dkim)
+ - [API - Configurazione completa del DKIM](#firststep)
- [Per Email (MX Plan)](#confemail)
- [Per Exchange](#confex)
- [Per Email Pro](#confemp)
- - [I diversi stati del DKIM](#status)
- - [Attiva o modifica un selettore DKIM](#enable-switch)
- - [Disattiva ed elimina il DKIM](#disable-delete)
+ - [API - I diversi stati del DKIM](#status)
+ - [API - Attiva o modifica un selettore DKIM](#enable-switch)
+ - [API - Disattiva ed elimina il DKIM](#disable-delete)
- [Configurare DKIM per un'offerta email al di fuori del tuo account OVHcloud](#external-dkim)
- [Record DKIM](#dkim-record)
- [Record TXT](#txt-record)
@@ -93,7 +105,7 @@ Il record DKIM (**D**omain**K**eys **I**dentified **M**ail) permette di firmare
Per capire bene perché il DKIM permette di rendere sicuri gli scambi di email, è necessario capire come funziona. Per creare una firma sicura, il DKIM ricorre alla **macinatura** e alla **crittografia asimmetrica**. La **piattaforma email** e la **Zona DNS** del tuo dominio aiuteranno a trasmettere le informazioni del DKIM ai tuoi destinatari.
-#### La macinazione
+/// details | La macinazione
Il principio della **funzione trituratrice** è quello di generare una **firma** (detta anche impronta) a partire da un dato d'ingresso. Il suo interesse è quello di creare all'uscita una serie di caratteri fissi, qualunque sia la quantità di dati in entrata.
@@ -103,7 +115,9 @@ Nel seguente diagramma, potete constatare che l'uscita (Output) sarà sempre com
La funzione di scatto è utile per verificare l'integrità di un messaggio. Infatti, due dati apparentemente molto simili presentano un valore di macinazione completamente diverso con una lunghezza di caratteri uguale in uscita, qualunque sia la lunghezza d'ingresso.
-#### Crittografia asimmetrica
+///
+
+/// details | Crittografia asimmetrica
La **cifratura**, come indica il nome, ha lo scopo di cifrare i dati che gli vengono dati. È "**asimmetrico**" perché la chiave di crittografia non è la stessa della chiave di decifrare, a differenza di una crittografia simmetrica che utilizzerà la stessa chiave per cifrare e decifrare.
@@ -119,17 +133,23 @@ Esistono due utilizzi della cifratura asimmetrica:
{.thumbnail .w-400 .h-600}
-#### Come vengono utilizzati la classificazione e la crittografia asimmetrica per il DKIM?
+///
+
+/// details | Come vengono utilizzati la classificazione e la crittografia asimmetrica per il DKIM?
Dalla piattaforma email, il DKIM utilizzerà l'hash per creare una firma a partire da alcuni elementi [dell'intestazione dell'email](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) e del corpo dell'email (contenuto dell'email).
La firma viene poi cifrata con la chiave privata utilizzando la crittografia asimmetrica.
-#### Perché è necessario configurare i server DNS?
+///
+
+/// details | Perché è necessario configurare i server DNS?
Affinché il destinatario possa verificare la firma DKIM del mittente, avrà bisogno dei parametri DKIM e soprattutto della chiave pubblica per decifrarla. La [zona DNS](/pages/web_cloud/domains/dns_zone_general_information) di un dominio è pubblica, motivo per cui è stato aggiunto un record DNS per trasmettere la chiave pubblica e i parametri DKIM al destinatario.
-#### Cos'è un selettore DKIM
+///
+
+/// details | Cos'è un selettore DKIM
Quando attivate il DKIM, questo funziona con una coppia di chiavi pubbliche / chiave privata. È possibile attribuire più coppie di chiavi al tuo dominio, ad esempio tramite rotazione. Quando cambi coppie di chiavi, la vecchia coppia deve rimanere attiva per il tempo che tutte le email che hai inviato con la vecchia chiave non incontrano errori nella verifica del DKIM sul server di ricezione.
@@ -142,7 +162,9 @@ Perché questo principio di rotazione funzioni, utilizzeremo quello che chiamiam
Il valore del selettore è `s=ovhex123456-selector1`.
-#### Esempio di un'email inviata utilizzando il DKIM
+///
+
+/// details | Esempio di un'email inviata utilizzando il DKIM
Quando invii un'email da **contact@mydomain.ovh**, una firma cifrata con una chiave privata (private key) viene aggiunta nell'intestazione dell'email.
@@ -152,11 +174,20 @@ Il destinatario **recipient@otherdomain.ovh** potrà decifrare questa firma con
{.thumbnail .w-400 .h-600}
+///
+
### Configurare il DKIM automaticamente per un servizio di posta Exchange o Email Pro OVHcloud
-La configurazione automatica di DKIM è accessibile per le offerte di posta elettronica "Email" (MX Plan) OVHcloud (disponibile tramite una [offerta di hosting Web Cloud](/links/web/hosting), un [hosting gratuito 100M](/links/web/domains-free-hosting)), [Exchange](/links/web/emails) e [Email Pro](/links/web/email-pro).
+La configurazione automatica del DKIM è disponibile per tutte le nostre offerte e-mail :
+
+- MX Plan inclusa con un [hosting Web Cloud](/links/web/hosting), un [hosting gratuito 100M](/links/web/domains-free-hosting) o ordinata separatamente.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
-Di default, il DKIM non è attivo quando aggiungi un dominio alla tua piattaforma. È quindi necessario avviare il processo di configurazione automatica dallo Spazio Cliente.
+Quando configurate il vostro nome a dominio su una soluzione e-mail OVHcloud, la configurazione automatica del DKIM è proposta e realizzata per default se non la disattivate.
+
+Se il DKIM non è stato attivato quando avete aggiunto un nome a dominio alla vostra piattaforma e-mail, dovrete avviare il processo di configurazione automatica tramite lo spazio client.
Clicca sulla scheda qui sotto corrispondente alla tua offerta.
@@ -173,6 +204,16 @@ Clicca sulla scheda qui sotto corrispondente alla tua offerta.
>>
>>{.thumbnail .w-400 .h-600}
>>
+>> Per attivare il DKIM, basta cliccare sul tasto `DKIM` rosso e poi su `Conferma`{.action} dalla finestra di attivazione che appare.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Nel caso in cui il vostro nome a dominio non sia gestito nello stesso spazio client OVHcloud della vostra piattaforma e-mail o registrato fuori da OVHcloud, otterrete la finestra qui sotto :
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Questa vi invita a inserire due valori CNAME nella zona DNS del nome a dominio, il che permette di collegare questo nome a dominio ai selettori DKIM del vostro servizio e-mail. È necessario inserire questi valori e assicurarvi che siano propagati prima di cliccare su `Attiva`{.action}.
+>>
> **Exchange**
>>
>> 1. Accedi allo [Spazio Cliente OVHcloud](/links/manager).
@@ -185,6 +226,10 @@ Clicca sulla scheda qui sotto corrispondente alla tua offerta.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Per attivare il DKIM, basta cliccare sul tasto `DKIM` rosso e poi su `Conferma`{.action} dalla finestra di attivazione che appare.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
> **Email Pro**
>>
>> 1. Accedi allo [Spazio Cliente OVHcloud](/links/manager).
@@ -196,29 +241,42 @@ Clicca sulla scheda qui sotto corrispondente alla tua offerta.
>> A destra del dominio in questione, la casellina `DKIM` è rosso.
>>
>> {.thumbnail .w-400 .h-600}
+>>
+>> Per attivare il DKIM, basta cliccare sul tasto `DKIM` rosso e poi su `Conferma`{.action} dalla finestra di attivazione che appare.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Accedete al vostro [Spazio Cliente OVHcloud](/links/manager).
+>> 1. Recatevi nella sezione `Web Cloud`{.action}.
+>> 1. Cliccate su `Zimbra Mail`{.action}.
+>> 1. Infine, andate sull'onghetto `Dominio`{.action}.
+>> 1. A destra del dominio interessato, cliccate su `⁝`{.action}, quindi su `Diagnostica`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> A destra della dicitura `DKIM` sull'onghetto corrispondente, dovreste osservare un avviso che indica che il DKIM non è conforme. Cliccate sull'onghetto `DKIM`{.action} per accedere allo stato della configurazione DKIM. Per correggere l'errore, dovrete aggiungere o modificare due voci DNS di tipo CNAME nella zona DNS del nome a dominio associato, in base alle informazioni visibili da questo onggetto.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Suggerimento per creare un record CNAME**
+>> >
+>> > Dal [Spazio Cliente OVHcloud](/links/manager) dove è ospitato il nome a dominio del vostro servizio e-mail, nella sezione `Web Cloud`{.action}, cliccate su `Nomi di dominio`{.action} nella colonna di sinistra e selezionate il nome a dominio interessato.
+>> > Selezionate l'onghetto `Zona DNS`{.action} e cliccate su `Aggiungi un'entrata`{.action} nella finestra che appare. Scegliete `CNAME` e completate in base ai valori che avete notati.
Per attivare il DKIM, clicca sulla casellina `DKIM` rosso e poi su `Conferma`{.action} dalla finestra di attivazione che appare.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **Email (MX Plan)**
->
-> Se il dominio non è associato allo Spazio Cliente OVHcloud o registrato al di fuori di OVHcloud, visualizzi questa finestra:
->
-> {.thumbnail .w-400 .h-600}
->
-> Questa operazione richiede l’inserimento di due valori CNAME nella zona DNS del dominio. In questo modo, è possibile associare il dominio ai selettori DKIM del servizio di posta. Prima di cliccare su `Attiva`{.action} è necessario inserire questi valori e assicurarti che vengano propagati.
->
-
-L'attivazione automatica del DKIM dura tra 30 minuti e 24 ore al massimo. Per verificare che la tua DKIM sia funzionante, è sufficiente tornare alla scheda `Informazioni generali`{.action} o `Domini associati`{.action} della tua piattaforma e assicurarti che la casellina `DKIM` sia diventata verde.
+La activación automática del DKIM dura entre 30 minutos y 24 horas como máximo. Para verificar que su DKIM funciona correctamente, simplemente vaya a la sección de gestión del dominio mencionada en las pestañas anteriores y verifique que el indicador `DKIM` es verde o, para una oferta Zimbra, que la pestaña `DKIM` no muestra más el icono de advertencia.
{.thumbnail .w-400 .h-600}
Dopo le 24 ore, se la tua casellina `DKIM` è rossa, consulta la sezione ["Perché il DKIM non funziona e appare in rosso nello Spazio Cliente?"](#reddkim) di questa guida.
-### Configurare il DKIM manualmente per un servizio di posta Exchange o Email Pro OVHcloud
+### Configurare il DKIM tramite API per un'e-mail OVHcloud
Per una piattaforma Exchange o Email Pro, è necessario prima recuperare il riferimento della piattaforma per configurare il DKIM.
@@ -251,13 +309,20 @@ Assicurati anche che il dominio da utilizzare per le tue email sia attivo nella
{.thumbnail .w-400 .h-600}
-#### Configurazione completa del DKIM
+#### API - Configurazione completa del DKIM
-Per configurare il DKIM, accedi al sito utilizzando il pulsante `Login`{.action} in alto a destra e inserisci le credenziali OVHcloud.
+Per configurare il DKIM, recatevi sulla [pagina delle API OVHcloud](/links/console) e accedete :
-> Clicca sulla nostra guida "[Scopri come utilizzare le API OVHcloud](/pages/manage_and_operate/api/first-steps)" se non hai mai utilizzato le API.
+1. Cliccate su `Authentication`{.action} in alto a sinistra.
+1. Cliccate quindi su `Login with OVHcloud SSO`{.action}.
+1. Inserite i vostri identificativi OVHcloud.
+1. Cliccate sul pulsante `Authorize`{.action} per autorizzare le chiamate alle API da questo sito.
-Clicca sulla sezione `/email/domain/` (offerte email (MXplan)), `/email/exchange` (offerte Exchanges) o `/email/pro` (offerta Email Pro) delle API e digita "dkim" nella casella `Filter` per visualizzare solo le API relative al DKIM.
+> [!primary]
+>
+> Riferitevi alla nostra guida « [Primi passi con le API OVHcloud](/pages/manage_and_operate/api/first-steps) » se non avete mai utilizzato le API.
+
+Recatevi nella sezione `/email/domain/` (offerte MX Plan e Zimbra), `/email/exchange` (offerta Exchange) o `/email/pro` (offerta E-mail Pro) delle API e digitate « dkim » nel campo `Filter` per far apparire solo le funzioni API relative al DKIM.
Clicca sulla scheda corrispondente alla tua offerta:
@@ -275,7 +340,7 @@ Clicca sulla scheda corrispondente alla tua offerta:
>> {.thumbnail .w-400 .h-600}
>>
-##### **Per Email (MX Plan)**
+##### **Per MX Plan e Zimbra**
Segui i **5 step** cliccando su ognuna delle 5 schede qui sotto:
@@ -592,7 +657,7 @@ Clicca sui **5 step** seguenti, cliccando su ciascuna scheda.
> **5. Attivazione del DKIM**
>> > [!warning]
>> >
->> > Dalla sezione [**Gli stati del DKIM**](#dkim-status) di questa guida, verifica che il valore `status:` è in `ready` prima di attivare il DKIM.
+>> > Dalla sezione "[API - Gli stati del DKIM](#dkim-status)" di questa guida, verifica che il valore `status:` è in `ready` prima di attivare il DKIM.
>>
>> Per attivare il DKIM, utilizza questa chiamata API:
>>
@@ -618,7 +683,7 @@ Clicca sui **5 step** seguenti, cliccando su ciascuna scheda.
>>
>> > [!success]
>> >
->> > Ora hai eseguito tutte le manipolazioni per attivare il DKIM. Per assicurarti che sia abilitato, consulta la sezione [**"I diversi stati DKIM"**](#dkim-status) di questa guida per verificare che il valore `status:` sia in `inProduction`. In tal caso, il tuo DKIM è ora attivo.
**Se sono stati creati due selettori**, il secondo selettore dovrebbe essere in `status: "ready"`.
+>> > Ora hai eseguito tutte le manipolazioni per attivare il DKIM. Per assicurarti che sia abilitato, consulta la sezione "[API - Gli stati del DKIM](#dkim-status)" di questa guida per verificare che il valore `status:` sia in `inProduction`. In tal caso, il tuo DKIM è ora attivo.
**Se sono stati creati due selettori**, il secondo selettore dovrebbe essere in `status: "ready"`.
>>
##### **Per Email Pro**
@@ -755,7 +820,7 @@ Clicca sui **5 step** seguenti, cliccando su ciascuna scheda.
> **5. Attivazione del DKIM**
>> > [!warning]
>> >
->> > Dalla sezione [**Gli stati del DKIM**](#dkim-status) di questa guida, verifica che il valore `status:` è in `ready` prima di attivare il DKIM.
+>> > Dalla sezione "[API - Gli stati del DKIM](#dkim-status)" di questa guida, verifica che il valore `status:` è in `ready` prima di attivare il DKIM.
>>
>> Per attivare il DKIM, utilizza questa chiamata API:
>>
@@ -780,7 +845,7 @@ Clicca sui **5 step** seguenti, cliccando su ciascuna scheda.
>>
>> > [!success]
>> >
->> > Hai effettuato tutte le operazioni necessarie per attivare il DKIM. Per assicurarti che sia attivo, consulta la sezione [**"I diversi stati del DKIM"**](#dkim-status) di questa guida per verificare che il valore `status:` è in `produzione`. In caso affermativo, il tuo DKIM è attivo.
+>> > Hai effettuato tutte le operazioni necessarie per attivare il DKIM. Per assicurarti che sia attivo, consulta la sezione "[API - Gli stati del DKIM](#dkim-status)" di questa guida per verificare che il valore `status:` è in `produzione`. In caso affermativo, il tuo DKIM è attivo.
>>
#### I diversi stati del DKIM
@@ -788,7 +853,7 @@ Clicca sui **5 step** seguenti, cliccando su ciascuna scheda.
Seleziona il servizio di posta in questione nelle seguenti schede:
> [!tabs]
-> **Email (MX Plan)**
+> **MX Plan e Zimbra**
>> Durante le operazioni sulla DKIM del tuo servizio Email, utilizza la chiamata API qui sotto per verificare lo stato attuale della DKIM.
>>
>> > [!api]
@@ -801,15 +866,15 @@ Seleziona il servizio di posta in questione nelle seguenti schede:
>>
>> - `disabled`: il DKIM è disattivato, non è stato ancora configurato o è stato disattivato tramite API.
>> - `modifying`: la configurazione del DKIM è in corso, è necessario attendere il completamento del processo.
->> - `toConfigure`: la configurazione del DKIM è in attesa delle impostazioni DNS del nome di dominio. È necessario inserire manualmente i record DNS nella zona del nome di dominio. Per farlo, clicca su [Step 4 della "Configurazione completa di DKIM" per le email (MX Plan)](#confemail).
+>> - `toConfigure`: la configurazione del DKIM è in attesa delle impostazioni DNS del nome di dominio. È necessario inserire manualmente i record DNS nella zona del nome di dominio. Per farlo, clicca su [Step 4 della "Configurazione completa di DKIM" per MX Plan e Zimbra](#confemail).
>> - `enabled`: il DKIM è configurato e funzionante.
>> - `error`: il processo di installazione ha riscontrato un errore. Ti invitiamo ad aprire un [ticket al supporto](https://help.ovhcloud.com/csm?id=csm_get_help) e a specificare il dominio in questione.
>>
>> A livello di selettori avete anche 3 stati possibili:
>>
>> - `set`: il selettore è ben configurato e attivo.
->> - `toSet`: il selettore non è configurato nella zona DNS del nome di dominio. Clicca su [Step 4 della "Configurazione completa di DKIM" per le email (MX Plan)](#confemail).
->> - `toFix`: il selettore è stato configurato correttamente nella zona DNS del nome di dominio ma i valori sono errati. Clicca su [Step 4 della "Configurazione completa di DKIM" per le email (MX Plan)](#confemail).
+>> - `toSet`: il selettore non è configurato nella zona DNS del nome di dominio. Clicca su [Step 4 della "Configurazione completa di DKIM" per MX Plan e Zimbra](#confemail).
+>> - `toFix`: il selettore è stato configurato correttamente nella zona DNS del nome di dominio ma i valori sono errati. Clicca su [Step 4 della "Configurazione completa di DKIM" per MX Plan e Zimbra](#confemail).
>>
> **Exchange**
>> Durante le operazioni sul DKIM della piattaforma Exchange, utilizza la chiamata API qui sotto per verificare lo stato attuale del DKIM.
@@ -869,7 +934,7 @@ Seleziona il servizio di posta in questione nelle seguenti schede:
>> ```
>>
-#### Attiva o modifica un selettore DKIM
+#### API - Attivare o cambiare un selettore DKIM
> [!warning]
>
@@ -878,6 +943,27 @@ Seleziona il servizio di posta in questione nelle seguenti schede:
Seleziona il servizio di posta in questione nelle seguenti schede:
> [!tabs]
+> **MX Plan e Zimbra**
+>> Per attivare il DKIM, utilizza questa chiamata API:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain`: inserisci il dominio associato al tuo servizio di posta elettronica su cui deve essere presente il DKIM.
+>>
+>> *Esempio di risultato:*
+>>
+>> ```console
+>> {
+>> "domain": "guidesteam.ovh",
+>> "id": 174219594,
+>> "function": "domain/enableDKIM",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> Per attivare il DKIM su un selettore, utilizza questa chiamata API:
>>
@@ -903,11 +989,12 @@ Seleziona il servizio di posta in questione nelle seguenti schede:
>> - `selectorName` : inserisci il nome del selettore che hai creato.
>> - `servizio` : inserisci il nome della tua piattaforma Email Pro nella forma "emailpro-zz111111-1".
>>
+
> [!primary]
>
> Durante la rotazione del selettore DKIM, potrai attivare direttamente il secondo selezionatore che hai creato per ribaltarlo, conservando il primo selettore che resterà attivo per tutto il tempo che tutte le email rilasciate con questo saranno analizzate correttamente dal destinatario.
-#### Disattiva ed elimina il DKIM
+#### API - Disattivare e eliminare il DKIM
> [!warning]
>
@@ -918,7 +1005,7 @@ Seleziona il servizio di posta in questione nelle seguenti schede:
Seleziona il servizio di posta in questione nelle seguenti schede:
> [!tabs]
-> **Email (MX Plan)**
+> **MX Plan e Zimbra**
>> Per disattivare il DKIM senza eliminare i selettori e le relative coppie di chiavi, utilizza questa chiamata API:
>>
>> > [!api]
@@ -1098,7 +1185,7 @@ Per recuperare l'intestazione di un'email, consulta la guida [Recuperare l'intes
Quando attivi per la prima volta il DKIM sul tuo servizio di posta, è possibile creare 2 selettori che contengono ciascuno una coppia di chiavi. Il secondo selettore funge da successore di quello attualmente in uso.
-Per evitare tentativi di decrittografia della chiave DKIM, è consigliabile modificare regolarmente le coppie di chiavi. Per farlo, assicurati di aver configurato correttamente i tuoi 2 selettori verificando che il primo sia in stato `inProduction`e il secondo in stato `ready`. Per verificare questo stato, consulta la sezione ["I diversi stati del DKIM"](#dkim-status).
+Per evitare tentativi di decrittografia della chiave DKIM, è consigliabile modificare regolarmente le coppie di chiavi. Per farlo, assicurati di aver configurato correttamente i tuoi 2 selettori verificando che il primo sia in stato `inProduction`e il secondo in stato `ready`. Per verificare questo stato, consulta la sezione [API - Gli stati del DKIM](#dkim-status).
Clicca sulla scheda qui sotto corrispondente alla tua offerta.
@@ -1109,7 +1196,6 @@ Clicca sulla scheda qui sotto corrispondente alla tua offerta.
>> > [!api]
>> >
>> > @api {v1} /email/exchange POST /email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}/enable
->> >
>>
>> - `domainName` : inserisci il dominio associato alla piattaforma Exchange.
>> - `exchangeService` : inserisci il nome della piattaforma Exchange che si presenta sotto forma di "hosted-zz111111-1" o "private-zz111111-1".
@@ -1148,6 +1234,7 @@ Clicca sulla scheda qui sotto corrispondente alla tua offerta per verificare lo
>> 1. Accedi alla sezione `Web Cloud`{.action}.
>> 1. Nella sezione `MICROSOFT`, clicca su `Exchange`{.action}.
>> 1. Seleziona la piattaforma interessata.
+>> 1. Infine, clicca sulla scheda `Domini associati`{.action}.
>>
>> Nella sezione `Domini associati`{.action}, verifica il colore dell’icona `DKIM` a destra del dominio interessato (vedi l’immagine qui sotto).
>>
@@ -1159,6 +1246,7 @@ Clicca sulla scheda qui sotto corrispondente alla tua offerta per verificare lo
>> 1. Accedi alla sezione `Web Cloud`{.action}.
>> 1. Clicca su `Email Pro`{.action}.
>> 1. Seleziona la piattaforma interessata.
+>> 1. Infine, clicca sulla scheda `Domini associati`{.action}.
>>
>> Nella sezione `Domini associati`{.action}, verifica il colore dell’icona `DKIM` a destra del nome di dominio interessato (vedi l’immagine qui sotto).
>>
@@ -1174,8 +1262,8 @@ Ecco i 4 stati che hanno come risultato l’icona DKIM in rosso nel tuo Spazio C
>> Nella configurazione è presente solo un selettore DKIM. Per consentirci di passare a una nuova chiave quando necessario, è necessario configurare i 2 selettori forniti dal servizio.
>> Per correggere questo errore :
>>
->> - Controllare lo stato dei selettori DKIM per individuare quello che si desidera configurare. Per farlo, consulta la sezione "[I diversi stati del DKIM](#dkim-status)" di questa guida.
->> - Una volta individuato il selettore da configurare, segui gli step indicati nella sezione "[Configurazione completa del DKIM](#firststep)" di questa guida, in base alla tua offerta (Exchange o Email Pro), applicandola esclusivamente al selettore in questione.
+>> - Controllare lo stato dei selettori DKIM per individuare quello che si desidera configurare. Per farlo, consulta la sezione "[API - Gli stati del DKIM](#dkim-status)" di questa guida.
+>> - Una volta individuato il selettore da configurare, segui gli step indicati nella sezione "[API - Configurazione completa del DKIM](#firststep)" di questa guida, in base alla tua offerta (Exchange o Email Pro), applicandola esclusivamente al selettore in questione.
>> Attendi fino a 24 ore dopo aver configurato il selettore.
>>
> **502**
@@ -1208,18 +1296,18 @@ Ecco i 4 stati che hanno come risultato l’icona DKIM in rosso nel tuo Spazio C
#### Dall'interfaccia API OVHcloud, come capire lo stato del DKIM che non funziona?
-Se utilizzi le API OVHcloud per configurare il tuo DKIM e questo non funziona, consulta la sezione "[I diversi stati del DKIM](#dkim-status)" di questa guida per identificare lo stato dei tuoi selettori.
+Se utilizzi le API OVHcloud per configurare il tuo DKIM e questo non funziona, consulta la sezione "[API - Gli stati del DKIM](#dkim-status)" di questa guida per identificare lo stato dei tuoi selettori.
Di seguito sono riportati gli stati che possono bloccare il funzionamento della tua DKIM e la soluzione adatta a ogni situazione.
> [!tabs]
> **Exchange e Email Pro**
->> - `WaitingRecord`: i record DNS sono in attesa di configurazione o in corso di convalida nella zona DNS del nome di dominio. Verifica automaticamente e regolarmente se il record DNS è presente e inserito correttamente. In base all’offerta, segui lo **step 5** nella sezione "[Configurazione completa del DKIM](#firststep)" per configurare correttamente la zona DNS del dominio in questione.
->> - `ready` : i record DNS sono presenti nella zona. A questo punto DKIM può essere attivato. Sarà sufficiente attivare il selettore cliccando sulla sezione "[Attiva o modifica un selettore DKIM](#enable-switch)".
->> - `deleting`: eliminazione DKIM in corso. Dopo l’eliminazione, segui la sezione "[Configurazione completa del DKIM](#firststep)".
->> - `disabling`: disattivazione del DKIM in corso. Dopo questa operazione, è possibile attivare il selettore dalla sezione "[Attiva o modifica un selettore DKIM](#enable-switch)".
+>> - `WaitingRecord`: i record DNS sono in attesa di configurazione o in corso di convalida nella zona DNS del nome di dominio. Verifica automaticamente e regolarmente se il record DNS è presente e inserito correttamente. In base all’offerta, segui lo **step 5** nella sezione "[API - Configurazione completa del DKIM](#firststep)" per configurare correttamente la zona DNS del dominio in questione.
+>> - `ready` : i record DNS sono presenti nella zona. A questo punto DKIM può essere attivato. Sarà sufficiente attivare il selettore cliccando sulla sezione "[API - Attiva o modifica un selettore DKIM](#enable-switch)".
+>> - `deleting`: eliminazione DKIM in corso. Dopo l’eliminazione, segui la sezione "[API - Configurazione completa del DKIM](#firststep)".
+>> - `disabling`: disattivazione del DKIM in corso. Dopo questa operazione, è possibile attivare il selettore dalla sezione "[API - Attiva o modifica un selettore DKIM](#enable-switch)".
>> - `todo`: l’operazione è stata inizializzata, deve essere avviata. Oltre le 24 ore, se il selettore è ancora in questo stato, ti invitiamo ad aprire un [ticket presso il supporto](https://help.ovhcloud.com/csm?id=csm_get_help) precisando il numero del selettore in questione.
-> **Email (MX Plan)**
+> **MX Plan e Zimbra**
>> - `disabled`: il DKIM è disattivato, non è stato ancora configurato o è stato disattivato tramite API.
>> - `modifying`: La configurazione del DKIM è in corso, è necessario attendere il completamento del processo.
>> - `toConfigure`: la configurazione del DKIM è in attesa delle impostazioni DNS del nome di dominio. È necessario inserire manualmente i record DNS nella zona del nome di dominio. Per farlo, clicca sul passaggio "[Configurazione completa del DKIM](#confemail)" di questa guida.
@@ -1227,8 +1315,8 @@ Di seguito sono riportati gli stati che possono bloccare il funzionamento della
>>
>> A livello di selettore si hanno anche 2 stati relativi a un errore:
>>
->> - `toSet`: il selettore non è configurato nella zona DNS del nome di dominio. Clicca su [Step 4 della "Configurazione completa di DKIM" per le email (MX Plan)](#confemail).
->> - `toFix`: il selettore è stato configurato correttamente nella zona DNS del nome di dominio ma i valori sono errati. Clicca su [Step 4 della "Configurazione completa di DKIM" per le email (MX Plan)](#confemail).
+>> - `toSet`: il selettore non è configurato nella zona DNS del nome di dominio. Clicca su [Step 4 della "Configurazione completa di DKIM" per MX Plan e Zimbra](#confemail).
+>> - `toFix`: il selettore è stato configurato correttamente nella zona DNS del nome di dominio ma i valori sono errati. Clicca su [Step 4 della "Configurazione completa di DKIM" per MX Plan e Zimbra](#confemail).
## Per saperne di più
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.pl-pl.md b/pages/web_cloud/domains/dns_zone_dkim/guide.pl-pl.md
index c652f9f3d23..341c89a8aee 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.pl-pl.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.pl-pl.md
@@ -1,7 +1,7 @@
---
title: "Poprawa bezpieczeństwa e-maili dzięki rejestracji DKIM"
excerpt: "Dowiedz się, jak skonfigurować rekord DKIM w Twojej domenie i platformie e-mail OVHcloud"
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
## Wprowadzenie
@@ -46,10 +57,11 @@ Wpis DKIM (**D**omain**K**eys **I**dentified **M**ail) pozwala na podpisanie e-m
- Posiadanie dostępu do interfejsu zarządzania domeną w [Panelu klienta OVHcloud](/links/manager) lub u operatora domeny, jeśli jest zarejestrowany poza OVHcloud.
- Dostęp do [Panelu klienta OVHcloud](/links/manager).
-- Wykupienie jednej z ofert e-mail:
+- Zamówienie jednej z poniższych ofert e-mail:
- "E-maile" (MX Plan) OVHcloud. Jest ona dostępna w ramach [oferty hostingu Cloud](/links/web/hosting), [bezpłatny hosting 100M](/links/web/domains-free-hosting) lub w ramach oferty MX Plan zamówionej oddzielnie.
- [Exchange](/links/web/emails-hosted-exchange) lub [Private Exchange](/links/web/emails-hosted-exchange).
- [E-mail Pro](/links/web/email-pro).
+ - [Zimbra](/links/web/zimbra).
- Oferta e-mail poza OVHcloud z DKIM.
> [!warning]
@@ -70,15 +82,15 @@ Wpis DKIM (**D**omain**K**eys **I**dentified **M**ail) pozwala na podpisanie e-m
- [Dlaczego trzeba skonfigurować serwery DNS?](#dns-and-dkim)
- [Przykład e-maila wysłanego z wykorzystaniem DKIM](#example)
- [Co to jest selekcja DKIM?](#selector)
-- [Automatyczna konfiguracja DKIM dla oferty e-mail Exchange lub E-mail Pro OVHcloud](#auto-dkim)
-- [Ręczna konfiguracja DKIM dla oferty e-mail Exchange lub E-mail Pro OVHcloud](#internal-dkim)
- - [Kompletna konfiguracja DKIM](#firststep)
- - [Dla E-maili (MX Plan)](#confemail)
+- [Automatyczna konfiguracja DKIM dla oferty e-mail OVHcloud](#auto-dkim)
+- [Konfiguracja DKIM przez API dla oferty e-mail OVHcloud](#internal-dkim)
+ - [API - Kompletna konfiguracja DKIM](#firststep)
+ - [Dla MX Plan i Zimbra](#confemail)
- [Dla usługi Exchange](#confex)
- [Dla E-mail Pro](#confemp)
- - [Poszczególne państwa DKIM](#status)
- - [Włącz lub zmień selekcję DKIM](#enable-switch)
- - [Wyłącz i usuń DKIM](#disable-delete)
+ - [API - Poszczególne państwa DKIM](#status)
+ - [API - Włącz lub zmień selekcję DKIM](#enable-switch)
+ - [API - Wyłącz i usuń DKIM](#disable-delete)
- [Konfiguracja DKIM w przypadku oferty e-mail poza Twoim kontem OVHcloud](#external-dkim)
- [Rejestracja DKIM](#dkim-record)
- [Rejestracja TXT](#txt-record)
@@ -91,9 +103,9 @@ Wpis DKIM (**D**omain**K**eys **I**dentified **M**ail) pozwala na podpisanie e-m
### Jak działa DKIM?
-Aby w pełni zrozumieć, dlaczego DKIM pozwala na zabezpieczenie wymiany wiadomości e-mail, należy zrozumieć, jak działa. DKIM używa "**hakowania**" i "**szyfrowania asymetrycznego**" do utworzenia bezpiecznego podpisu. **Platforma e-mail** oraz **Strefa DNS** Twojej domeny pomogą w przekazywaniu informacji z DKIM do Twoich odbiorców.
+Aby dobrze zrozumieć, dlaczego DKIM pozwala na zabezpieczenie Twoich wiadomości e-mail, należy zrozumieć, jak działa. DKIM korzysta z „**skrótu**” i „**szyfrowania asymetrycznego**”, aby stworzyć bezpieczną sygnaturę. **Platforma e-mail** i **strefa DNS** Twojej domeny pomogą przekazać informacje DKIM odbiorcom.
-#### Mieszanie
+/// details | Mieszanie
Zasadą **funkcji mielenia** jest wygenerowanie **podpisu** (zwanego również odciskiem palca) na podstawie danych wejściowych. W tym celu twórz na samym początku zestaw znaków stałych, niezależnie od ilości danych wejściowych.
@@ -103,7 +115,9 @@ Na poniższym schemacie można zobaczyć, że wyjście (Output) będzie zawsze s
Funkcja siekania jest przydatna, gdy chcesz sprawdzić integralność wiadomości. Dwie dane, które mogą być bardzo podobne, mają zupełnie inną wartość hakowania przy równej długości wychodzącej znaków, niezależnie od długości wejścia.
-#### Szyfrowanie asymetryczne
+///
+
+/// details | Szyfrowanie asymetryczne
Szyfrowanie **danych**, jak sama nazwa wskazuje, ma na celu zaszyfrowanie ich danych. Jest "**asymetryczny**", ponieważ klucz szyfrujący nie jest taki sam jak klucz w przeciwieństwie do symetrycznego szyfrowania, które będzie używać tego samego klucza do szyfrowania i rozszyfrowania.
@@ -119,17 +133,23 @@ Istnieją dwa sposoby szyfrowania asymetrycznego:
{.thumbnail .w-400 .h-600}
-#### W jaki sposób stosowane są szyfrowanie i szyfrowanie asymetryczne?
+///
+
+/// details | W jaki sposób stosowane są szyfrowanie i szyfrowanie asymetryczne?
W ramach platformy e-mail DKIM będzie używać hakowania do tworzenia podpisu [z określonych elementów nagłówka e-maila](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) i treści e-maila (zawartość e-maila).
Podpis jest następnie szyfrowany kluczem prywatnym, używając asymetrycznego szyfrowania.
-#### Dlaczego trzeba skonfigurować serwery DNS?
+///
+
+/// details | Dlaczego trzeba skonfigurować serwery DNS?
Aby odbiorca mógł zweryfikować podpis DKIM nadawcy, będzie potrzebował parametrów DKIM, a przede wszystkim klucza publicznego, aby go odszyfrować. [Strefa DNS](/pages/web_cloud/domains/dns_zone_general_information) domeny jest dostępna do wiadomości publicznej. W związku z tym dodano wpis DNS w celu przekazania odbiorcy klucza publicznego oraz parametrów DKIM.
-#### Co to jest selekcja DKIM
+///
+
+/// details | Co to jest selekcja DKIM
Po włączeniu DKIM działa on z parą klucza publicznego / klucza prywatnego. Możesz przypisać kilka par kluczy do Twojej domeny, na przykład w trakcie rotacji. W przypadku zmiany pary kluczy stara para powinna pozostać aktywna tak długo, jak wszystkie e-maile wysłane przez Ciebie z dawnym kluczem nie poniosą porażki w weryfikacji DKIM na serwerze poczty przychodzącej.
@@ -142,7 +162,9 @@ Aby zasada rotacji działała, użyjemy tzw. **selektorów DKIM**. Wybieracz DKI
Wartość selektora jest tutaj `s=ovhex123456-selector1`.
-#### Przykład e-maila wysłanego z wykorzystaniem DKIM
+///
+
+/// details | Przykład e-maila wysłanego z wykorzystaniem DKIM
Gdy wysyłasz e-mail z **contact@mydomain.ovh**, szyfrowany podpis z kluczem prywatnym (private key) zostanie dodany do nagłówka wiadomości.
@@ -152,16 +174,25 @@ Odbiorca **recipient@otherdomain.ovh** będzie mógł odszyfrować ten podpis kl
{.thumbnail .w-400 .h-600}
-### Automatyczna konfiguracja DKIM dla usługi e-mail Exchange lub E-mail Pro OVHcloud
+///
-Automatyczna konfiguracja DKIM jest dostępna dla ofert e-mail MX Plan (zawartych w ofercie [hosting Web Cloud](/links/web/hosting), [darmowy hosting 100M](/links/web/domains-free-hosting) lub zamówionych oddzielnie), [Exchange](/links/web/emails) i [E-mail Pro](/links/web/email-pro).
+### Automatyczna konfiguracja DKIM dla oferty e-mail OVHcloud
-Domyślnie DKIM nie jest aktywowany podczas dodawania domeny do platformy. Dlatego rozpocznij proces automatycznej konfiguracji w Panelu klienta.
+Automatyczna konfiguracja DKIM jest dostępna dla wszystkich naszych ofert e-mail:
-Kliknij na zakładkę odnoszącą się do Twojej oferty.
+- MX Plan wchodzący w skład [hostingu Web Cloud](/links/web/hosting), [darmowego 100M hostingu](/links/web/domains-free-hosting) lub zamówiony osobno.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
+
+Podczas konfiguracji swojej domeny na rozwiązaniu e-mail OVHcloud, automatyczna konfiguracja DKIM jest proponowana i realizowana domyślnie, jeśli nie zostanie ona wyłączona.
+
+Jeśli DKIM nie został włączony podczas dodawania domeny do Twojej platformy e-mail, należy uruchomić proces konfiguracji automatycznej za pomocą panelu klienta.
+
+Kliknij na zakładkę poniżej odpowiadającą Twojej ofercie.
> [!tabs]
-> **E-maile (MX Plan)**
+> **MX Plan**
>>
>> 1. Zaloguj się do [Panelu klienta OVHcloud](/links/manager).
>> 1. Przejdź do sekcji `Web Cloud`{.action}.
@@ -173,6 +204,16 @@ Kliknij na zakładkę odnoszącą się do Twojej oferty.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Aby włączyć DKIM, wystarczy kliknąć guzik `DKIM` czerwony, a następnie kliknąć `Zatwierdź`{.action} z pojawiającej się okienka aktywacji.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> W przypadku, gdy Twoja domena nie jest zarządzana w tym samym panelu klienta OVHcloud, co Twoja platforma e-mail, lub jest zarejestrowana poza OVHcloud, otrzymasz poniższe okno:
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> W tym oknie zostaniesz poproszony o wprowadzenie dwóch wartości CNAME w strefie DNS Twojej domeny, co pozwoli powiązać tę domenę z selektorami DKIM Twojej usługi e-mail. Należy wprowadzić te wartości i upewnić się, że zostały rozpropagowane, zanim klikniesz `Włącz`{.action}.
+>>
> **Exchange**
>>
>> 1. Zaloguj się do [Panelu klienta OVHcloud](/links/manager).
@@ -185,6 +226,10 @@ Kliknij na zakładkę odnoszącą się do Twojej oferty.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Aby włączyć DKIM, wystarczy kliknąć guzik `DKIM` czerwony, a następnie kliknąć `Zatwierdź`{.action} z pojawiającej się okienka aktywacji.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
> **E-mail Pro**
>>
>> 1. Zaloguj się do [Panelu klienta OVHcloud](/links/manager).
@@ -196,29 +241,42 @@ Kliknij na zakładkę odnoszącą się do Twojej oferty.
>> Po prawej stronie wybranej domeny, możesz zauważyć, że przycisk `DKIM` jest czerwony.
>>
>> {.thumbnail .w-400 .h-600}
+>>
+>> Aby włączyć DKIM, wystarczy kliknąć guzik `DKIM` czerwony, a następnie kliknąć `Zatwierdź`{.action} z pojawiającej się okienka aktywacji.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Zaloguj się do swojego [panelu klienta OVHcloud](/links/manager).
+>> 1. Przejdź do sekcji `Web Cloud`{.action}.
+>> 1. Kliknij `Zimbra Mail`{.action}.
+>> 1. Na koniec przejdź do zakładki `Domena`{.action}.
+>> 1. Po prawej stronie od domeny kliknij `⁝`{.action}, a następnie `Diagnostyka`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Po prawej stronie od opisu `DKIM` na odpowiedniej zakładce powinieneś zauważyć ostrzeżenie wskazujące, że DKIM jest niepoprawny. Kliknij zakładkę `DKIM`{.action}, aby uzyskać dostęp do statusu konfiguracji DKIM. Aby poprawić błąd, musisz dodać lub zmodyfikować dwie wpisy DNS typu CNAME w strefie DNS Twojej domeny, zgodnie z informacjami widocznymi z tej zakładki.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Szybki sposób na utworzenie wpisu CNAME**
+>> >
+>> > Z [panelu klienta OVHcloud](/links/manager), w którym znajduje się Twoja domena e-mail, w sekcji `Web Cloud`{.action}, kliknij `Domeny`{.action} w lewej kolumnie i wybierz odpowiednią domenę.
+>> > Wybierz zakładkę `Strefa DNS`{.action}, a następnie kliknij `Dodaj wpis`{.action} w oknie, które się pojawi. Wybierz `CNAME`, a następnie uzupełnij zgodnie z wartościami, które zanotowałeś.
Aby aktywować DKIM, wystarczy kliknąć czerwony przycisk `DKIM`, a następnie `Zatwierdź`{.action} w oknie aktywacyjnym, które się pojawi.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **E-maile (MX Plan)**
->
-> Jeśli Twoja nazwa domeny nie jest zarządzana w tym samym Panelu klienta OVHcloud co Twoja platforma e-mail lub zarejestrowana poza OVHcloud, wyświetli się poniższe okno:
->
-> {.thumbnail .w-400 .h-600}
->
-> W polu wpisz dwie wartości CNAME w strefie DNS domeny, co pozwoli na powiązanie domeny z selektorami DKIM w Twojej usłudze e-mail. Należy wprowadzić te wartości i upewnić się, że są propagowane przed kliknięciem przycisku `Aktywuj`{.action}.
->
-
-Automatyczna aktywacja DKIM trwa od 30 minut do maksymalnie 24 godzin. Aby sprawdzić, czy DKIM działa, wróć do zakładki `Informacje ogólne`{.action} lub `Powiązane domeny`{.action} Twojej platformy e-mail i upewnij się, że przycisk `DKIM` zmienił kolor na zielony.
+Automatyczna aktywacja DKIM trwa od 30 minut do maksymalnie 24 godzin. Aby sprawdzić, czy Twój DKIM działa poprawnie, wróć do sekcji zarządzania domeną, jak w powyższych zakładkach, i sprawdź, czy guzik `DKIM` jest zielony, lub, w przypadku oferty Zimbra, czy zakładka `DKIM` nie zawiera już ikony ostrzeżenia.
{.thumbnail .w-400 .h-600}
Po upływie 24 godzin, jeśli Twój przycisk `DKIM` jest czerwony, zapoznaj się z rubryką ["Dlaczego DKIM nie działa i wyświetla się w Panelu klienta na czerwono?"](#reddkim) niniejszego przewodnika.
-### Ręczna konfiguracja DKIM dla oferty e-mail Exchange lub E-mail Pro OVHcloud
+### Konfiguracja DKIM przez API dla oferty e-mail OVHcloud
W przypadku platformy Exchange lub E-mail Pro należy najpierw pobrać numer referencyjny platformy, aby skonfigurować DKIM.
@@ -251,18 +309,25 @@ Upewnij się również, czy domena, której chcesz używać do obsługi e-maili
{.thumbnail .w-400 .h-600}
-#### Kompletna konfiguracja DKIM
+#### API - Kompletna konfiguracja DKIM
-Aby skonfigurować DKIM, wejdź na stronę WWW, zaloguj się przyciskiem `Login`{.action} w prawym górnym rogu i wprowadź dane identyfikacyjne OVHcloud.
+Aby skonfigurować DKIM, przejdź na [stronę API OVHcloud](/links/console) i zaloguj się:
-> Skorzystaj z naszego przewodnika "[Dowiedz się, jak korzystać z API OVHcloud](/pages/manage_and_operate/api/first-steps)", jeśli nigdy wcześniej nie korzystałeś z API.
+1. Kliknij `Authentication`{.action} w lewym górnym rogu.
+1. Kliknij następnie `Login with OVHcloud SSO`{.action}.
+1. Wprowadź swoje dane logowania OVHcloud.
+1. Kliknij przycisk `Authorize`{.action}, aby zezwolić na wywołania API z tej strony.
-Przejdź do sekcji`/email/domain/` (oferty E-mail (MXplan)), `/email/exchange` (oferty Exchange) lub`/email/pro` (oferta E-mail Pro) interfejsów API i wpisz "dkim" w polu `Filter`, aby wyświetlić tylko API związane z DKIM.
+> [!primary]
+>
+> Skorzystaj z naszego przewodnika „[Pierwsze kroki z API OVHcloud](/pages/manage_and_operate/api/first-steps)”, jeśli nigdy wcześniej nie korzystałeś z API.
+
+Przejdź do sekcji `/email/domain/` (oferty MX Plan i Zimbra), `/email/exchange` (oferta Exchange) lub `/email/pro` (oferta E-mail Pro) API i wpisz „dkim” w polu `Filter`, aby wyświetlić tylko funkcje API związane z DKIM.
Kliknij zakładkę odnoszącą się do Twojej oferty:
> [!tabs]
-> **E-maile (MX Plan)**
+> **MX Plan i Zimbra**
>>
>> {.thumbnail .w-400 .h-600}
>>
@@ -275,7 +340,7 @@ Kliknij zakładkę odnoszącą się do Twojej oferty:
>> {.thumbnail .w-400 .h-600}
>>
-#### **Dla E-maili (MX Plan)**
+##### **Dla MX Plan i Zimbra**
Postępuj zgodnie z instrukcjami **5 kroków**, klikając kolejno na 5 poniższych zakładek:
@@ -592,7 +657,7 @@ Postępuj zgodnie z **5 krokami** poniżej, klikając na każdą z zakładek.
> **5. Aktywacja DKIM**
>> > [!warning]
>> >
->> > W sekcji [**Poszczególne stany DKIM**](#dkim-status) w tym przewodniku sprawdź, czy wartość `status:` jest w `ready`, zanim uruchomi DKIM.
+>> > W sekcji [API - Różne stany DKIM](#dkim-status) w tym przewodniku sprawdź, czy wartość `status:` jest w `ready`, zanim uruchomi DKIM.
>>
>> Aby włączyć DKIM, użyj następującego wywołania API:
>>
@@ -618,7 +683,7 @@ Postępuj zgodnie z **5 krokami** poniżej, klikając na każdą z zakładek.
>>
>> > [!success]
>> >
->> > Wykonałeś teraz wszystkie operacje, aby aktywować DKIM. Aby upewnić się, że konfiguracja jest aktywna, zapoznaj się z sekcją [**"Różne stany DKIM"**](#dkim-status) w tym przewodniku, aby sprawdzić, czy wartość `status:` jest w `inProduction`. Jeśli tak jest, Twój DKIM jest teraz aktywny.
**Jeśli utworzyłeś dwa selektory**, drugi selektor powinien być w `status: "ready"`.
+>> > Wykonałeś teraz wszystkie operacje, aby aktywować DKIM. Aby upewnić się, że konfiguracja jest aktywna, zapoznaj się z sekcją [API - Różne stany DKIM](#dkim-status) w tym przewodniku, aby sprawdzić, czy wartość `status:` jest w `inProduction`. Jeśli tak jest, Twój DKIM jest teraz aktywny.
**Jeśli utworzyłeś dwa selektory**, drugi selektor powinien być w `status: "ready"`.
>>
##### **Dla E-mail Pro**
@@ -755,7 +820,7 @@ Postępuj zgodnie z **5 krokami** poniżej, klikając na każdą z zakładek.
> **5. Aktywacja DKIM**
>> > [!warning]
>> >
->> > W sekcji [**Poszczególne stany DKIM**](#dkim-status) w tym przewodniku sprawdź, czy wartość `status:` jest w `ready`, zanim uruchomi DKIM.
+>> > W sekcji [API - Różne stany DKIM](#dkim-status) w tym przewodniku sprawdź, czy wartość `status:` jest w `ready`, zanim uruchomi DKIM.
>>
>> Aby włączyć DKIM, użyj następującego wywołania API:
>>
@@ -780,15 +845,15 @@ Postępuj zgodnie z **5 krokami** poniżej, klikając na każdą z zakładek.
>>
>> > [!success]
>> >
->> > Wykonałeś teraz wszystkie operacje, aby aktywować DKIM. Aby upewnić się, że konfiguracja jest aktywna, zapoznaj się z sekcją [**"Różne stany DKIM"**](#dkim-status) w tym przewodniku, aby sprawdzić, czy wartość `status:` jest w `inProduction`. Jeśli tak jest, Twój DKIM jest teraz aktywny.
+>> > Wykonałeś teraz wszystkie operacje, aby aktywować DKIM. Aby upewnić się, że konfiguracja jest aktywna, zapoznaj się z sekcją [API - Różne stany DKIM](#dkim-status) w tym przewodniku, aby sprawdzić, czy wartość `status:` jest w `inProduction`. Jeśli tak jest, Twój DKIM jest teraz aktywny.
>>
-#### Poszczególne państwa DKIM
+#### API - Poszczególne państwa DKIM
Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
> [!tabs]
-> **E-mail (MX Plan)**
+> **MX Plan i Zimbra**
>> Podczas operacji na DKIM Twojej platformy Email użyj poniższego wywołania API, aby sprawdzić aktualny status DKIM.
>>
>> > [!api]
@@ -801,15 +866,15 @@ Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
>>
>> - `disabled`: DKIM jest wyłączony, nie został jeszcze skonfigurowany lub został wyłączony przez API.
>> - `modifying`: trwa konfigurowanie DKIM. Należy poczekać na zakończenie procesu.
->> - `toConfigure`: konfiguracja DKIM oczekuje na ustawienia DNS domeny. Wprowadź ręcznie rekordy DNS w strefie nazwy domeny. W tym celu przejdź do [etapu 4 "pełnej konfiguracji DKIM" dla kont e-mail (MX Plan)](#confemail).
+>> - `toConfigure`: konfiguracja DKIM oczekuje na ustawienia DNS domeny. Wprowadź ręcznie rekordy DNS w strefie nazwy domeny. W tym celu przejdź do [etapu 4 "pełnej konfiguracji DKIM" dla MX Plan i Zimbra](#confemail).
>> - `enabled`: DKIM jest skonfigurowany i działa.
>> - `error`: Podczas procesu instalacji wystąpił błąd. Otwórz [zgłoszenie w dziale obsługi klienta](https://help.ovhcloud.com/csm?id=csm_get_help) i podaj nazwę wybranej domeny.
>>
>> Na selektorach masz również 3 możliwe stany:
>>
>> - `set` : przełącznik wyboru jest poprawnie skonfigurowany i aktywny.
->> - `toSet` : selektor nie jest skonfigurowany w strefie DNS domeny. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla kont e-mail (MX Plan)](#confemail).
->> - `toFix` : selektor został skonfigurowany w strefie DNS domeny, ale wartości są nieprawidłowe. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla kont e-mail (MX Plan)](#confemail).
+>> - `toSet` : selektor nie jest skonfigurowany w strefie DNS domeny. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla MX Plan i Zimbra](#confemail).
+>> - `toFix` : selektor został skonfigurowany w strefie DNS domeny, ale wartości są nieprawidłowe. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla MX Plan i Zimbra](#confemail).
>>
> **Exchange**
>> Podczas wykonywania operacji na DKIM w Twojej platformie Exchange, skorzystaj z poniższego wywołania API, aby sprawdzić aktualny status DKIM.
@@ -869,7 +934,7 @@ Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
>> ```
>>
-#### Włącz lub zmień selekcję DKIM
+#### API - Włącz lub zmień selekcję DKIM
> [!warning]
>
@@ -878,6 +943,27 @@ Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
> [!tabs]
+> **MX Plan i Zimbra**
+>> Aby wyłączyć DKIM bez usuwania selektorów i ich par kluczy, należy użyć następującego wywołania API:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain` : wprowadź nazwę domeny przypisanej do Twojej usługi E-mail, na której DKIM ma być obecny.
+>>
+>> *Przykład wyniku:*
+>>
+>> ```console
+>> {
+>> "domain": "guidesteam.ovh",
+>> "id": 174219594,
+>> "function": "domain/enableDKIM",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> Aby aktywować DKIM na selektorze, użyj następującego wywołania API:
>>
@@ -908,7 +994,7 @@ Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
>
> Podczas rotacji selektywnika DKIM możesz bezpośrednio włączyć drugi wyłącznik, który utworzyłeś, aby go przełączyć, zachowując przy tym pierwszy wyłącznik, który pozostanie aktywny, dopóki wszystkie e-maile dostarczone wraz z tym wyborem są dokładnie analizowane przez ich adresata.
-#### Wyłącz i usuń DKIM
+#### API - Wyłącz i usuń DKIM
> [!warning]
>
@@ -919,7 +1005,7 @@ Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
Wybierz odpowiednią ofertę e-mail w następujących zakładkach:
> [!tabs]
-> **E-mail (MX Plan)**
+> **MX Plan i Zimbra**
>> Aby wyłączyć DKIM bez usuwania selektorów i ich par kluczy, należy użyć następującego wywołania API:
>>
>> > [!api]
@@ -1099,7 +1185,7 @@ Aby pobrać nagłówek wiadomości e-mail, zapoznaj się z naszym przewodnikiem
Po pierwszym włączeniu DKIM w Twojej usłudze e-mail możesz utworzyć 2 selektory, z których każdy zawiera parę kluczy. Drugi selektor jest następcą bieżącego selektora.
-Aby uniknąć prób odszyfrowania klucza DKIM, zaleca się regularne zmiany pary kluczy. Upewnij się, że skonfigurowałeś 2 selektory, sprawdzając, czy pierwszy jest w statusie `inProduction`a drugi w statusie `ready`. Możesz sprawdzić ten stan, odwołując się do sekcji ["Różne stany DKIM"](#dkim-status).
+Aby uniknąć prób odszyfrowania klucza DKIM, zaleca się regularne zmiany pary kluczy. Upewnij się, że skonfigurowałeś 2 selektory, sprawdzając, czy pierwszy jest w statusie `inProduction`a drugi w statusie `ready`. Możesz sprawdzić ten stan, odwołując się do sekcji [API - Różne stany DKIM](#dkim-status).
Kliknij na zakładkę odnoszącą się do Twojej oferty.
@@ -1148,6 +1234,7 @@ Kliknij na poniższą zakładkę odnoszącą się do Twojej oferty, aby sprawdzi
>> 1. Przejdź do sekcji `Web Cloud`{.action}.
>> 1. W sekcji `MICROSOFT` kliknij `Exchange`{.action}.
>> 1. Wybierz odpowiednią platformę.
+>> 1. Na koniec przejdź do zakładki `Przypisane domeny`{.action}.
>>
>> W rubryce `Przypisane domeny`{.action}, sprawdź kolor ikony `DKIM` po prawej stronie odpowiedniej domeny (patrz obrazek poniżej).
>>
@@ -1159,6 +1246,7 @@ Kliknij na poniższą zakładkę odnoszącą się do Twojej oferty, aby sprawdzi
>> 1. Przejdź do sekcji `Web Cloud`{.action}.
>> 1. Kliknij `Email Pro`{.action}.
>> 1. Wybierz odpowiednią platformę.
+>> 1. Na koniec przejdź do zakładki `Przypisane domeny`{.action}.
>>
>> W rubryce `Przypisane domeny`{.action} sprawdź kolor ikony `DKIM` po prawej stronie odpowiedniej domeny (patrz obrazek poniżej).
>>
@@ -1174,8 +1262,8 @@ Oto cztery statusy, po których w Panelu klienta wyświetli się czerwona ikona
>> Tylko selektor DKIM jest obecny w konfiguracji. Aby umożliwić przełączenie na nowy klucz, jeśli jest to konieczne, należy skonfigurować 2 selektory dostarczane przez usługę.
>> Aby naprawić ten błąd :
>>
->> - Sprawdź stan selektorów DKIM, aby określić, który powinien zostać skonfigurowany. W tym celu przejdź do sekcji "[Różne stany DKIM](#dkim-status)" niniejszego przewodnika.
->> - Po wybraniu selektora do konfiguracji postępuj zgodnie z instrukcjami zawartymi w tej sekcji "[Pełna konfiguracja DKIM](#firststep)" w zależności od wybranej oferty (Exchange lub E-mail Pro) i zastosuj ją tylko do wybranego selektora.
+>> - Sprawdź stan selektorów DKIM, aby określić, który powinien zostać skonfigurowany. W tym celu przejdź do sekcji "[API - Różne stany DKIM](#dkim-status)" niniejszego przewodnika.
+>> - Po wybraniu selektora do konfiguracji postępuj zgodnie z instrukcjami zawartymi w tej sekcji "[API - Pełna konfiguracja DKIM](#firststep)" w zależności od wybranej oferty (Exchange lub E-mail Pro) i zastosuj ją tylko do wybranego selektora.
>> Odczekaj maksymalnie 24 godziny od skonfigurowania selektora.
>>
> **502**
@@ -1227,8 +1315,8 @@ Poniżej znajdziesz statusy, które mogą blokować działanie DKIM i odpowiedni
>>
>> Na selektorach masz również 2 stany związane z błędem:
>>
->> - `toSet` : selektor nie jest skonfigurowany w strefie DNS domeny. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla kont e-mail (MX Plan)](#confemail).
->> - `toFix` : selektor został skonfigurowany w strefie DNS domeny, ale wartości są nieprawidłowe. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla kont e-mail (MX Plan)](#confemail).
+>> - `toSet` : selektor nie jest skonfigurowany w strefie DNS domeny. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla MX Plan i Zimbra](#confemail).
+>> - `toFix` : selektor został skonfigurowany w strefie DNS domeny, ale wartości są nieprawidłowe. Skorzystaj z [etapu 4 "pełnej konfiguracji DKIM" dla MX Plan i Zimbra](#confemail).
## Sprawdź również
diff --git a/pages/web_cloud/domains/dns_zone_dkim/guide.pt-pt.md b/pages/web_cloud/domains/dns_zone_dkim/guide.pt-pt.md
index 563d8fbbcce..6b61344c8c9 100644
--- a/pages/web_cloud/domains/dns_zone_dkim/guide.pt-pt.md
+++ b/pages/web_cloud/domains/dns_zone_dkim/guide.pt-pt.md
@@ -1,7 +1,7 @@
---
title: "Melhorar a segurança dos e-mails através do registo DKIM"
excerpt: "Saiba como configurar um registo DKIM no seu domínio e na sua plataforma de e-mail OVHcloud"
-updated: 2025-04-28
+updated: 2025-11-19
---
-
-
## Objetivo
@@ -46,10 +57,11 @@ O registo DKIM (**D**omain**K**eys **I**dentified **M**ail) permite assinar os e
- Ter acesso à secção de gestão do domínio na [Área de Cliente OVHcloud](/links/manager) ou na Área de Cliente, caso esteja registado fora da OVHcloud.
- Ter acesso à [Área de Cliente OVHcloud](/links/manager).
-- Ter subscrito uma das ofertas de e-mail:
+- Ter adquirido uma das ofertas de correio eletrónico abaixo:
- "E-mails" (MX Plan) OVHcloud. Esta última está disponível através de uma [oferta de alojamento Web Cloud](/links/web/hosting), um [alojamento gratuito 100M](/links/web/domains-free-hosting) ou uma oferta MX Plan encomendada separadamente.
- [Exchange](/links/web/emails-hosted-exchange) ou [Private Exchange](/links/web/emails-hosted-exchange).
- [E-mail Pro](/links/web/email-pro).
+ - [Zimbra](/links/web/zimbra).
- Uma oferta de e-mail fora da OVHcloud que dispõe do DKIM.
> [!warning]
@@ -70,15 +82,15 @@ O registo DKIM (**D**omain**K**eys **I**dentified **M**ail) permite assinar os e
- [Porque é que precisamos de configurar os servidores DNS?](#dns-and-dkim)
- [Exemplo de um e-mail enviado utilizando o DKIM](#example)
- [O que é um seletor DKIM?](#selector)
-- [Configurar o DKIM automaticamente para um serviço de e-mail Exchange ou E-mail Pro da OVHcloud](#auto-dkim)
-- [Configurar o DKIM manualmente para um serviço de e-mail Exchange ou E-mail Pro da OVHcloud](#internal-dkim)
- - [Configuração completa do DKIM](#firststep)
- - [Para E-mails (MX Plan)](#confemail)
+- [Configurar o DKIM automaticamente para uma oferta de correio eletrónico OVHcloud](#auto-dkim)
+- [Configurar o DKIM através da API para uma oferta de correio eletrónico OVHcloud](#internal-dkim)
+ - [API - Configuração completa do DKIM](#firststep)
+ - [Para MX Plan e Zimbra](#confemail)
- [Para Exchange](#confex)
- [Para o E-mail Pro](#confemp)
- - [Os diferentes estados do DKIM](#status)
- - [Ativar ou alterar um seletor DKIM](#enable-switch)
- - [Desativar e eliminar o DKIM](#disable-delete)
+ - [API - Os diferentes estados do DKIM](#status)
+ - [API - Ativar ou alterar um seletor DKIM](#enable-switch)
+ - [API - Desativar e eliminar o DKIM](#disable-delete)
- [Configurar DKIM para uma oferta de e-mail fora da sua conta OVHcloud](#external-dkim)
- [Registo DKIM](#dkim-record)
- [Registo TXT](#txt-record)
@@ -91,9 +103,9 @@ O registo DKIM (**D**omain**K**eys **I**dentified **M**ail) permite assinar os e
### Como funciona o DKIM?
-Para compreender bem porque é que o DKIM permite proteger as suas trocas de e-mails, é necessário compreender como funciona. O DKIM recorre à "**picadura**" e à "**encriptação assimétrica**" para criar uma assinatura segura. A **plataforma de e-mail** e a **Zona DNS** do seu domínio irão ajudar a transmitir as informações do DKIM aos seus destinatários.
+Para compreender bem por que o DKIM permite proteger os seus trocas de correio eletrónico, é necessário compreender como funciona. O DKIM utiliza o «**hashing**» e a «**criptografia assimétrica**» para criar uma assinatura segura. A **plataforma de correio eletrónico** e a **zona DNS** do seu nome de domínio ajudarão a transmitir as informações do DKIM aos seus destinatários.
-#### A picadura
+/// details | A picadura
O princípio de uma **função de picadura** é gerar uma **assinatura** (também designada "pegada") a partir de um dado de entrada. O seu interesse é criar à saída uma sequência de caracteres fixa, independentemente da quantidade de dados à entrada.
@@ -103,7 +115,9 @@ No diagrama seguinte, pode constatar que a saída (Output) será sempre composta
A função de triagem é útil quando deseja verificar a integridade de uma mensagem. Com efeito, dois dados que podem ser de aparência muito próximas apresentam um valor de picadura completamente diferente com um comprimento de caracteres igual à saída, qualquer que seja o comprimento de entrada.
-#### A encriptação assimétrica
+///
+
+/// details | A encriptação assimétrica
A **encriptação**, como o seu nome indica, tem como objetivo encriptar os dados que lhe são dados. É "**assimétrica**" porque a chave de encriptação não é a mesma que a chave de decifrar, ao contrário de uma encriptação simétrica que vai usar a mesma chave para encriptar e decifrar.
@@ -119,17 +133,23 @@ Existem duas utilizações da encriptação assimétrica:
{.thumbnail .w-400 .h-600}
-#### Como é que a picadura e a encriptação assimétrica são utilizadas para o DKIM?
+///
+
+/// details | Como é que a picadura e a encriptação assimétrica são utilizadas para o DKIM?
A partir da plataforma de e-mail, o DKIM vai utilizar a trituração para criar uma assinatura a partir de certos elementos [do cabeçalho do e-mail](/pages/web_cloud/email_and_collaborative_solutions/troubleshooting/diagnostic_headers) e do corpo do e-mail (conteúdo do e-mail).
A assinatura é depois encriptada com a chave privada utilizando a encriptação assimétrica.
-#### Porque é que precisamos de configurar os servidores DNS?
+///
+
+/// details | Porque é que precisamos de configurar os servidores DNS?
Para que o destinatário possa verificar a assinatura DKIM do remetente, precisará dos parâmetros DKIM e, sobretudo, da chave pública para a decifrar. A [zona DNS](/pages/web_cloud/domains/dns_zone_general_information) de um nome de domínio é pública, pelo que é acrescentado um registo DNS para transmitir a chave pública e os parâmetros DKIM ao destinatário.
-#### O que é um seletor DKIM
+///
+
+/// details | O que é um seletor DKIM
Quando ativa o DKIM, este funciona com um par de chave pública / chave privada. É possível atribuir vários pares de chaves ao seu domínio, no quadro de uma rotação, por exemplo. Com efeito, quando muda de par de chaves, o antigo par deve permanecer ativo enquanto o conjunto dos e-mails que enviou com a antiga chave não encontrar falha na verificação do DKIM no servidor de receção.
@@ -142,7 +162,9 @@ Para que este princípio de rotação funcione, vamos utilizar o que chamamos os
O valor do seletor é aqui `s=ovhex123456-seletor1`.
-#### Exemplo de um e-mail enviado utilizando o DKIM
+///
+
+/// details | Exemplo de um e-mail enviado utilizando o DKIM
Quando envia um e-mail a partir de **contact@mydomain.ovh**, é adicionada uma assinatura encriptada com a ajuda de uma chave privada (private key) no cabeçalho do e-mail.
@@ -152,16 +174,26 @@ O destinatário **recipient@otherdomain.ovh** poderá decifrar esta assinatura c
{.thumbnail .w-400 .h-600}
-### Configurar o DKIM automaticamente para um serviço de e-mail Exchange ou E-mail Pro da OVHcloud
+///
+
+### Configurar o DKIM automaticamente para uma oferta de correio eletrónico OVHcloud
-A configuração automática do DKIM está acessível às ofertas e-mail MX Plan (incluída com um [alojamento Web Cloud](/links/web/hosting), um [alojamento gratuito 100M](/links/web/domains-free-hosting) ou encomendado separadamente), [Exchange](/links/web/emails) e [E-mail Pro](/links/web/email-pro).
+A configuração automática do DKIM está disponível para todas as nossas ofertas de correio eletrónico:
+
+- MX Plan incluída com um [alojamento Web Cloud](/links/web/hosting), um [alojamento gratuito 100M](/links/web/domains-free-hosting) ou adquirida separadamente.
+- [Exchange](/links/web/emails).
+- [E-mail Pro](/links/web/email-pro).
+- [Zimbra](/links/web/zimbra).
+
+Quando configura o seu nome de domínio numa solução de correio eletrónico OVHcloud, a configuração automática do DKIM é proposta e realizada por defeito se não a desativar.
+
+Se o DKIM não foi ativado quando adicionou um nome de domínio à sua plataforma de correio eletrónico, terá de iniciar o processo de configuração automática através do espaço cliente.
-Por predefinição, o DKIM não é ativado quando adiciona um domínio à sua plataforma. Deve então lançar o processo de configuração automática através da Área de Cliente.
Clique no separador seguinte da sua oferta.
> [!tabs]
-> **E-mails (MX Plan)**
+> **MX Plan**
>>
>> 1. Aceda à [Área de Cliente OVHcloud](/links/manager).
>> 1. Aceda à secção `Web Cloud`{.action}.
@@ -173,6 +205,15 @@ Clique no separador seguinte da sua oferta.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Para ativar o DKIM, basta clicar no botão `DKIM` vermelho e depois em `Validar`{.action} a partir da janela de ativação que aparece.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> No caso em que o seu nome de domínio não seja gerido no mesmo espaço cliente OVHcloud que a sua plataforma de correio eletrónico ou esteja registado fora da OVHcloud, obtém a janela abaixo:
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> Esta janela convida-o a introduzir dois valores CNAME na zona DNS do nome de domínio, o que permite ligar este nome de domínio aos seletores DKIM do seu serviço de correio eletrónico. É necessário introduzir estes valores e assegurar-se de que estão propagados antes de clicar em `Ativar`{.action}.
> **Exchange**
>>
>> 1. Aceda à [Área de Cliente OVHcloud](/links/manager).
@@ -185,6 +226,10 @@ Clique no separador seguinte da sua oferta.
>>
>> {.thumbnail .w-400 .h-600}
>>
+>> Para ativar o DKIM, basta clicar no botão `DKIM` vermelho e depois em `Validar`{.action} a partir da janela de ativação que aparece.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
> **E-mail Pro**
>>
>> 1. Aceda à [Área de Cliente OVHcloud](/links/manager).
@@ -196,29 +241,42 @@ Clique no separador seguinte da sua oferta.
>> À direita do domínio em causa, pode verificar que a etiqueta `DKIM` é vermelho.
>>
>> {.thumbnail .w-400 .h-600}
+>>
+>> Para ativar o DKIM, basta clicar no botão `DKIM` vermelho e depois em `Validar`{.action} a partir da janela de ativação que aparece.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+> **Zimbra**
+>>
+>> 1. Inicie sessão no seu [espaço cliente OVHcloud](/links/manager).
+>> 1. Dirija-se à secção `Web Cloud`{.action}.
+>> 1. Clique em `Zimbra Mail`{.action}.
+>> 1. Finalmente, vá ao separador `Domínio`{.action}.
+>> 1. À direita do domínio em questão, clique em `⁝`{.action}, depois em `Diagnóstico`{.action}.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> À direita da menção `DKIM` no separador correspondente, deverá observar um aviso indicando que o DKIM está com defeito. Clique no separador `DKIM`{.action} para aceder ao estado da configuração DKIM. Para corrigir o erro, terá de adicionar ou modificar duas entradas DNS do tipo CNAME na zona DNS do nome de domínio associado, de acordo com as informações visíveis a partir deste separador.
+>>
+>> {.thumbnail .w-400 .h-600}
+>>
+>> > [!primary]
+>> > **Dica para criar um registo CNAME**
+>> >
+>> > A partir do [espaço cliente OVHcloud](/links/manager) onde está alojado o nome de domínio do seu serviço de correio eletrónico, na secção `Web Cloud`{.action}, clique em `Nomes de domínio`{.action} na coluna à esquerda e selecione o nome de domínio em questão.
+>> > Selecione o separador `Zona DNS`{.action} e clique em `Adicionar uma entrada`{.action} na janela que aparece. Escolha `CNAME` e preencha de acordo com os valores que registou.
Para ativar o DKIM, basta clicar na etiqueta `DKIM` vermelho e, a seguir, em `Validar`{.action} a partir da janela de ativação apresentada.
{.thumbnail .w-400 .h-600}
-> [!primary]
->
-> **E-mails (MX Plan)**
->
-> Se o domínio não for gerido na mesma Área de Cliente OVHcloud que a plataforma de correio eletrónico ou se encontrar registado fora da OVHcloud, aceda à seguinte janela:
->
-> {.thumbnail .w-400 .h-600}
->
-> Aqui, será solicitado que introduza dois valores CNAME na zona DNS do domínio, o que permite associar este domínio aos seletores DKIM do seu serviço de e-mail. Deve introduzir estes valores e certificar-se de que estes são propagados antes de clicar em `Ativar`{.action}.
->
-
-A ativação automática do DKIM dura entre 30 minutos e 24 horas, no máximo. Para verificar se o seu DKIM está funcional, basta voltar ao separador `Informações gerais`{.action} ou `Domínios associados`{.action} da sua plataforma de e-mail e certificar-se de que a etiqueta `DKIM` ficou verde.
+A ativação automática do DKIM dura entre 30 minutos e 24 horas no máximo. Para verificar que o seu DKIM está funcional, basta voltar à rubrica de gestão do domínio mencionada nos separadores acima e verificar que o botão `DKIM` está verde ou, para uma oferta Zimbra, que o separador `DKIM` não apresenta mais o ícone de aviso.
{.thumbnail .w-400 .h-600}
Se a etiqueta `DKIM` for vermelha após 24 horas, consulte a secção "[Porque é que o DKIM não está funcional e aparece a vermelho na Área de Cliente?](#reddkim)" deste guia.
-### Configurar o DKIM manualmente para um serviço de e-mail Exchange ou E-mail Pro da OVHcloud
+### Configurar o DKIM através da API para uma oferta de correio eletrónico OVHcloud
Para uma plataforma Exchange ou E-mail Pro, deve primeiro recuperar a referência da sua plataforma para configurar o seu DKIM.
@@ -251,18 +309,25 @@ Certifique-se também de que o domínio que pretende utilizar para os seus e-mai
{.thumbnail .w-400 .h-600}
-#### Configuração completa do DKIM
+#### API -Configuração completa do DKIM
-Para configurar o DKIM, aceda ao website através do botão `Login`{.action} no canto superior direito e introduza as suas credenciais OVHcloud.
+Para configurar o DKIM, dirija-se à [página das API OVHcloud](/links/console) e inicie sessão:
-> Apoie-se no nosso guia "[Descubra como utilizar as API OVHcloud](/pages/manage_and_operate/api/first-steps)" se nunca utilizou as API.
+1. Clique em `Authentication`{.action} no canto superior esquerdo.
+1. Clique depois em `Login with OVHcloud SSO`{.action}.
+1. Introduza os seus identificadores OVHcloud.
+1. Clique no botão `Authorize`{.action} para autorizar as chamadas às API a partir deste site.
-Aceda à secção `/email/domain/` (ofertas E-mails (MXplan)), `/email/exchange` (ofertas Exchange) ou `/email/pro` (oferta E-mail Pro) das API e introduza "dkim" na caixa `Filter` para apresentar apenas as API relativas ao DKIM.
+> [!primary]
+>
+> Consulte o nosso guia « [Primeiros passos com as API OVHcloud](/pages/manage_and_operate/api/first-steps) » se nunca utilizou as API.
+
+Dirija-se à secção `/email/domain/` (ofertas MX Plan e Zimbra), `/email/exchange` (oferta Exchange) ou `/email/pro` (oferta E-mail Pro) das API e preencha « dkim » no campo `Filter` para mostrar apenas as funções API relativas ao DKIM.
Clique no separador da sua oferta:
> [!tabs]
-> **E-mails (MX Plan)**
+> **MX Plan e Zimbra**
>>
>> {.thumbnail .w-400 .h-600}
>>
@@ -275,7 +340,7 @@ Clique no separador da sua oferta:
>> {.thumbnail .w-400 .h-600}
>>
-##### **Para E-mails (MX Plan)**
+##### **Para MX Plan e Zimbra**
Siga os **5 passos** clicando sucessivamente em cada um dos 5 separadores seguintes:
@@ -592,7 +657,7 @@ Siga os **5 passos** abaixo ao clicar em cada separador.
> **5. Ativação do DKIM**
>> > [!warning]
>> >
->> > Na secção [**Os diferentes estados do DKIM**](#dkim-status) deste manual, verifique se o valor `status:` está bem em `ready` antes de poder ativar o DKIM.
+>> > Na secção [API - Os diferentes estados do DKIM](#dkim-status) deste manual, verifique se o valor `status:` está bem em `ready` antes de poder ativar o DKIM.
>>
>> Para ativar o DKIM, utilize a seguinte chamada API:
>>
@@ -618,7 +683,7 @@ Siga os **5 passos** abaixo ao clicar em cada separador.
>>
>> > [!success]
>> >
->> > Já realizou todas as operações para ativar o DKIM. Para assegurar que o servidor está ativo, consulte a secção [**"Os diferentes estados do DKIM"**](#dkim-status) deste guia para verificar que o valor `status:` está bem em `inProduction`. Se for o caso, o seu DKIM está ativo.
**Se tiver criado dois seletores**, o segundo seletor deverá estar em `status: "ready"`.
+>> > Já realizou todas as operações para ativar o DKIM. Para assegurar que o servidor está ativo, consulte a secção [API - Os diferentes estados do DKIM](#dkim-status) deste guia para verificar que o valor `status:` está bem em `inProduction`. Se for o caso, o seu DKIM está ativo.
**Se tiver criado dois seletores**, o segundo seletor deverá estar em `status: "ready"`.
>>
##### **Para o E-mail Pro**
@@ -755,7 +820,7 @@ Siga os **5 passos** abaixo ao clicar em cada separador.
> **5. Ativação do DKIM**
>> > [!warning]
>> >
->> > Na secção [**Os diferentes estados do DKIM**](#dkim-status) deste manual, verifique se o valor `status:` está bem em `ready` antes de poder ativar o DKIM.
+>> > Na secção [API - Os diferentes estados do DKIM](#dkim-status) deste manual, verifique se o valor `status:` está bem em `ready` antes de poder ativar o DKIM.
>>
>> Para ativar o DKIM, utilize a seguinte chamada API:
>>
@@ -780,15 +845,15 @@ Siga os **5 passos** abaixo ao clicar em cada separador.
>>
>> > [!success]
>> >
->> > Já realizou todas as operações para ativar o DKIM. Para assegurar que o servidor está ativo, consulte a secção [**"Os diferentes estados do DKIM"**](#dkim-status) deste guia para verificar que o valor `status:` está bem em `inProduction`. Se for o caso, o seu DKIM está ativo.
+>> > Já realizou todas as operações necessárias para ativar o DKIM. Para se assegurar que está bem ativado, consulte a secção « [API - Os diferentes estados do DKIM](#dkim-status) » deste guia para verificar que o valor `status:` está bem em `inProduction`. Se for o caso, o seu DKIM está agora ativo.
**Se criou dois seletores**, o segundo seletor deverá estar em `status: "ready"`.
>>
-#### Os diferentes estados do DKIM
+#### API - Os diferentes estados do DKIM
Selecione a oferta de e-mail em questão nos separadores seguintes:
> [!tabs]
-> **E-mail (MX Plan)**
+> **MX Plan e Zimbra**
>> Quando efetuar as operações no DKIM da sua plataforma Email, utilize a chamada API abaixo para verificar o estado atual do DKIM.
>>
>> > [!api]
@@ -801,15 +866,15 @@ Selecione a oferta de e-mail em questão nos separadores seguintes:
>>
>> - `disabled`: o DKIM está desativado, ainda não foi configurado ou foi desativado pela API.
>> - `modifying` : a configuração do DKIM está em curso, é necessário aguardar até ao fim do processo.
->> - `toConfigure`: a configuração do DKIM está aguardando os parâmetros DNS do domínio. Os registos DNS devem ser preenchidos manualmente na zona do domínio. Para isso, clique em [etapa 4 de "a configuração completa do DKIM" for E-mails (MX Plan)](#confemail).
+>> - `toConfigure`: a configuração do DKIM está aguardando os parâmetros DNS do domínio. Os registos DNS devem ser preenchidos manualmente na zona do domínio. Para isso, clique em [etapa 4 de "a configuração completa do DKIM" para MX Plan e Zimbra](#confemail).
>> - `enabled`: o DKIM está configurado e funcional.
>> - `error`: O processo de instalação encontrou um erro. Sugerimos que abra um [ticket junto do suporte](https://help.ovhcloud.com/csm?id=csm_get_help) especificando o domínio em causa.
>>
>> Ao nível dos seletores também tem 3 estados possíveis:
>>
>> - `set`: o seletor está bem configurado e ativo.
->> - `toSet`: o seletor não está configurado na zona DNS do domínio. Pressione [etapa 4 "configuração completa do DKIM" for E-mails (MX Plan)](#confemail).
->> - `toFix`: o seletor foi corretamente configurado na zona DNS do domínio, mas os valores estão incorretos. Pressione [etapa 4 "configuração completa do DKIM" for E-mails (MX Plan)](#confemail).
+>> - `toSet`: o seletor não está configurado na zona DNS do domínio. Pressione [etapa 4 "configuração completa do DKIM" para MX Plan e Zimbra](#confemail).
+>> - `toFix`: o seletor foi corretamente configurado na zona DNS do domínio, mas os valores estão incorretos. Pressione [etapa 4 "configuração completa do DKIM" para MX Plan e Zimbra](#confemail).
>>
> **Exchange**
>> Aquando das suas operações no DKIM da sua plataforma Exchange, utilize a chamada API abaixo para verificar o estado atual do DKIM.
@@ -869,7 +934,7 @@ Selecione a oferta de e-mail em questão nos separadores seguintes:
>> ```
>>
-#### Ativar ou alterar um seletor DKIM
+#### API - Ativar ou alterar um seletor DKIM
> [!warning]
>
@@ -878,6 +943,27 @@ Selecione a oferta de e-mail em questão nos separadores seguintes:
Selecione a oferta de e-mail em questão nos separadores seguintes:
> [!tabs]
+> **MX Plan et Zimbra**
+>> Para ativar o DKIM, utilize a seguinte chamada API:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /email/domain/ PUT /email/domain/{domain}/dkim/enable
+>>
+>>
+>> - `domain` : introduza o nome de domínio associado ao seu serviço E-mail no qual o DKIM deve estar presente.
+>>
+>> *Exemplo de resultado:*
+>>
+>> ```console
+>> {
+>> "domain": "guidesteam.ovh",
+>> "id": 174219594,
+>> "function": "domain/enableDKIM",
+>> "status": "todo"
+>> }
+>> ```
+>>
> **Exchange**
>> Para ativar o DKIM num seletor, utilize a seguinte chamada API:
>>
@@ -908,7 +994,7 @@ Selecione a oferta de e-mail em questão nos separadores seguintes:
>
> Aquando de uma rotação de seletor DKIM, pode diretamente ativar o segundo seletor que criou para o migrar, conservando o primeiro seletor que ficará ativo enquanto todos os e-mails emitidos com este último forem bem analisados pelo destinatário.
-#### Desativar e eliminar o DKIM
+#### API - Desativar e eliminar o DKIM
> [!warning]
>
@@ -919,7 +1005,7 @@ Selecione a oferta de e-mail em questão nos separadores seguintes:
Selecione a oferta de e-mail em questão nos separadores seguintes:
> [!tabs]
-> **E-mail (MX Plan)**
+> **MX Plan e Zimbra**
>> Se deseja desativar o DKIM sem eliminar os seletores e o seu par de chaves, utilize a seguinte chamada API:
>>
>> > [!api]
@@ -1099,7 +1185,7 @@ Para obter o cabeçalho de um e-mail, consulte o nosso manual "[Obter o cabeçal
Quando ativar pela primeira vez o DKIM no seu serviço de e-mail, é possível criar 2 seletores, cada um contendo um par de chaves. O segundo seletor serve de sucessor ao que está em curso de utilização.
-Para evitar tentativas de desencriptação da chave DKIM, é aconselhável alterar regularmente o par de chaves. Para isso, certifique-se de que configurou corretamente os seus 2 seletores, verificando que o primeiro está em status `inProduction`e o segundo em status `ready`. Você pode verificar este status consultando a secção "[Os vários estados do DKIM](#dkim-status)".
+Para evitar tentativas de desencriptação da chave DKIM, é aconselhável alterar regularmente o par de chaves. Para isso, certifique-se de que configurou corretamente os seus 2 seletores, verificando que o primeiro está em status `inProduction`e o segundo em status `ready`. Você pode verificar este status consultando a secção "[API - Os diferentes estados do DKIM](#dkim-status)".
Clique no separador seguinte da sua oferta.
@@ -1148,6 +1234,7 @@ Clique no separador abaixo correspondente à sua oferta para verificar o estado
>> 1. Aceda à secção `Web Cloud`{.action}.
>> 1. Na rubrica `MICROSOFT`, clique em `Exchange`{.action}.
>> 1. Selecione a plataforma em causa.
+>> 1. Por fim, aceda ao separador `Domínios associados`{.action}.
>>
>> Na rubrica `Domínios associados`{.action}, verifique a cor do ícone `DKIM` à direita do domínio em questão (ver a imagem abaixo).
>>
@@ -1159,6 +1246,7 @@ Clique no separador abaixo correspondente à sua oferta para verificar o estado
>> 1. Aceda à secção `Web Cloud`{.action}.
>> 1. Clique em `Email Pro`{.action}.
>> 1. Selecione a plataforma em causa.
+>> 1. Por fim, aceda ao separador `Domínios associados`{.action}.
>>
>> Na rubrica `Domínios associados`{.action}, verifique a cor do ícone `DKIM` à direita do domínio em causa (ver imagem abaixo).
>>
@@ -1174,8 +1262,8 @@ Eis os 4 estados que têm por resultado o ícone DKIM a vermelho na sua Área de
>> Apenas um seletor DKIM está presente na sua configuração. Para nos permitir mudar para uma nova chave, quando necessário, é necessário configurar os 2 seletores fornecidos pelo serviço.
>> Para corrigir este erro :
>>
->> - Verifique o estado dos seletores DKIM para identificar o que deve ser configurado. Para isso, consulte a secção "[Os diferentes estados do DKIM](#dkim-status)" deste guia.
->> - Depois de identificar o seletor a configurar, siga as etapas da secção "[Configuração completa do DKIM](#firststep)" neste guia, de acordo com a sua oferta (Exchange ou E-mail Pro), aplicando-a apenas ao seletor em questão.
+>> - Verifique o estado dos seletores DKIM para identificar o que deve ser configurado. Para isso, consulte a secção "[API - Os diferentes estados do DKIM](#dkim-status)" deste guia.
+>> - Depois de identificar o seletor a configurar, siga as etapas da secção "[API - Configuração completa do DKIM](#firststep)" neste guia, de acordo com a sua oferta (Exchange ou E-mail Pro), aplicando-a apenas ao seletor em questão.
>> Aguarde até 24 horas após a configuração do seletor.
>>
> **502**
@@ -1208,27 +1296,27 @@ Eis os 4 estados que têm por resultado o ícone DKIM a vermelho na sua Área de
#### A partir da interface API OVHcloud, como compreender o estado do DKIM que não funciona?
-Se utilizar as API da OVHcloud para configurar o seu DKIM e este não estiver funcional, consulte a secção "[Os diferentes estados do DKIM](#dkim-status)" deste guia para identificar o estado dos seus seletores.
+Se utilizar as API da OVHcloud para configurar o seu DKIM e este não estiver funcional, consulte a secção "[API - Os diferentes estados do DKIM](#dkim-status)" deste guia para identificar o estado dos seus seletores.
Abaixo irá encontrar os estados que podem bloquear o funcionamento do seu DKIM e a solução adequada a cada situação.
> [!tabs]
> **Exchange e E-mail Pro**
>> - `WaitingRecord`: os registos DNS estão a aguardar uma configuração ou em curso de validação na zona DNS do domínio. É efetuada uma verificação automática regular para verificar se o registo DNS está presente e corretamente indicado. Consoante a sua oferta, siga a **etapa 5** na secção "[Configuração completa do DKIM](#firststep)" para configurar corretamente a zona DNS do domínio em questão.
->> - `ready`: os registos DNS estão presentes na zona. O DKIM pode agora ser ativado. Basta que ative o seletor recorrendo à secção "[Ativar ou alterar um seletor DKIM](#enable-switch)".
->> - `deleting`: o DKIM está em curso de eliminação. Após a eliminação, deverá seguir a secção "[Configuração completa do DKIM](#firststep)".
->> - `disabling`: o DKIM está em curso de desativação. Após esta operação, poderá ativar o seletor recorrendo à secção "[Ativar ou alterar um seletor DKIM](#enable-switch)".
+>> - `ready`: os registos DNS estão presentes na zona. O DKIM pode agora ser ativado. Basta que ative o seletor recorrendo à secção "[API - Ativar ou alterar um seletor DKIM](#enable-switch)".
+>> - `deleting`: o DKIM está em curso de eliminação. Após a eliminação, deverá seguir a secção "[API - Configuração completa do DKIM](#firststep)".
+>> - `disabling`: o DKIM está em curso de desativação. Após esta operação, poderá ativar o seletor recorrendo à secção "[API - Ativar ou alterar um seletor DKIM](#enable-switch)".
>> - `todo`: a tarefa foi inicializada e deverá iniciar-se. Acima das 24 horas, se o seletor ainda estiver nesse estado, convidamo-lo a abrir um [ticket junto do suporte](https://help.ovhcloud.com/csm?id=csm_get_help) especificando o número do seletor em causa.
> **E-mails (MX Plan)**
>> - `disabled`: O DKIM está desativado, ainda não foi configurado ou foi desativado pela API.
>> - `modifying`: A configuração do DKIM está em curso, é necessário aguardar até ao fim do processo.
->> - `toConfigure`: A configuração do DKIM está aguardando os parâmetros DNS do domínio. Os registos DNS devem ser preenchidos manualmente na zona do domínio. Para isso, clique na etapa "[Configuração completa do DKIM](#confemail)" deste guia.
+>> - `toConfigure`: A configuração do DKIM está aguardando os parâmetros DNS do domínio. Os registos DNS devem ser preenchidos manualmente na zona do domínio. Para isso, clique na etapa "[API - Configuração completa do DKIM](#confemail)" deste guia.
>> - `error`: O processo de instalação encontrou um erro. Sugerimos que abra um [ticket junto do suporte](https://help.ovhcloud.com/csm?id=csm_get_help) especificando o domínio em causa.
>>
>> Ao nível dos seletores também possui 2 estados relativos a um erro:
>>
->> - `toSet`: o seletor não está configurado na zona DNS do domínio. Pressione [etapa 4 "configuração completa do DKIM" for E-mails (MX Plan)](#confemail).
->> - `toFix`: o seletor foi corretamente configurado na zona DNS do domínio, mas os valores estão incorretos. Pressione [etapa 4 "configuração completa do DKIM" for E-mails (MX Plan)](#confemail).
+>> - `toSet`: o seletor não está configurado na zona DNS do domínio. Pressione [etapa 4 "configuração completa do DKIM" para MX Plan e Zimbra](#confemail).
+>> - `toFix`: o seletor foi corretamente configurado na zona DNS do domínio, mas os valores estão incorretos. Pressione [etapa 4 "configuração completa do DKIM" para MX Plan e Zimbra](#confemail).
## Saiba mais