diff --git a/channels/microsoft365-graph/common-errors.rst b/channels/microsoft365-graph/common-errors.rst index c3550566..e684e599 100644 --- a/channels/microsoft365-graph/common-errors.rst +++ b/channels/microsoft365-graph/common-errors.rst @@ -15,10 +15,10 @@ your error is not covered here. Problem with User Mailbox ------------------------- -``MailboxNotEnabledForRESTAPI`` - *The mailbox is either inactive, soft-deleted, or is hosted on-premise.* +**Error message:** ``MailboxNotEnabledForRESTAPI. The mailbox is either inactive, +soft-deleted, or is hosted on-premise.`` -Possible reasons: +**Possible reasons:** - The user has no access to the mailbox. - The account has no mailbox at all (user mailboxes). @@ -29,8 +29,8 @@ a mailbox for this user. Problem with User Permissions ----------------------------- -``ErrorItemNotFound`` - *The specified object was not found in the store., Default folder Root not found.* +**Error message:** ``ErrorItemNotFound. The specified object was not found in the +store. Default folder Root not found.`` Indicates that the user has no delegation permissions for the mailbox. Make sure that the permissions are set correctly or consider using another @@ -39,8 +39,7 @@ account. Problem with Shared Mailbox --------------------------- -``ErrorInvalidUser`` - *The requested user '\*' is invalid.* +**Error message:** ``ErrorInvalidUser. The requested user '\*' is invalid.`` Possible reason could be that the shared mailbox you provided is wrong. Check if the provided shared mailbox email address is correct. diff --git a/channels/microsoft365/common-errors.rst b/channels/microsoft365/common-errors.rst index 3c60a460..00403f71 100644 --- a/channels/microsoft365/common-errors.rst +++ b/channels/microsoft365/common-errors.rst @@ -21,11 +21,8 @@ request to the wrong tenant. In this case, please compare whether the client ID created in Zammad matches that in Azure for the Azure App. - The Client ID can be found in the Zammad settings under *Channels > Microsoft 365 IMAP Email > App Configuration*. -See :doc:`account setup ` how to find -the client ID in Azure and where to copy it to Zammad. Wrong or Expired Client Secret ------------------------------ @@ -38,12 +35,6 @@ Wrong or Expired Client Secret :align: center This error occurs when the client uses an incorrect or expired client secret. - -.. warning:: **Important notice:** - We never ask the client for the client secret as this can potentially be a - security risk. We ask the customer to create a new client secret and copy the - value and not the ID to Zammad. - See :doc:`account setup ` for more information. @@ -59,10 +50,9 @@ neither a valid DNS name, nor a valid external domain. :align: center If a wrong tenant is used in Zammad or the email account is not a member of -the tenant created in Zammad, this error message occurs. - -In this case, please check if the tenant is entered correctly in -Zammad, or remove the tenant completely. +the tenant created in Zammad, this error message occurs. In such a case, please +check if the tenant is entered correctly in Zammad, or remove the tenant +completely. .. warning:: **Important notice:** Once the tenant is completely removed, all email accounts can be created in @@ -89,8 +79,8 @@ can be found on how to request admin consent from Zammad. The request for the admin consent can be bypassed by assigning the admin consent in Azure to the App. - Home > App Registration > Manage > API Permission > Grant admin consent for - "MSFT". + *Home > App Registration > Manage > API Permission > Grant admin consent for + "MSFT"*. Missing Permissions for the Azure User -------------------------------------- @@ -174,7 +164,6 @@ To avoid this, you should change the from "Dynamic Delivery" to something else fitting your needs (e.g. "Block") for your Office 365 instance. - Authentication Unsuccessful --------------------------- diff --git a/locale/admin-docs.pot b/locale/admin-docs.pot index c2f5137a..af9c86ba 100644 --- a/locale/admin-docs.pot +++ b/locale/admin-docs.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Zammad Admin Documentation pre-release\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-09 17:00+0200\n" +"POT-Creation-Date: 2026-04-10 07:29+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -4423,7 +4423,7 @@ msgid "In case you are using an user mailbox, the new user has to match the exis msgstr "" #: ../channels/microsoft365-graph/accounts.rst:207 -#: ../channels/microsoft365/common-errors.rst:72 +#: ../channels/microsoft365/common-errors.rst:62 msgid "Request Admin Consent" msgstr "" @@ -4448,16 +4448,12 @@ msgstr "" msgid "Problem with User Mailbox" msgstr "" -#: ../channels/microsoft365-graph/common-errors.rst:19 -msgid "``MailboxNotEnabledForRESTAPI``" -msgstr "" - -#: ../channels/microsoft365-graph/common-errors.rst:19 -msgid "*The mailbox is either inactive, soft-deleted, or is hosted on-premise.*" +#: ../channels/microsoft365-graph/common-errors.rst:18 +msgid "**Error message:** ``MailboxNotEnabledForRESTAPI. The mailbox is either inactive, soft-deleted, or is hosted on-premise.``" msgstr "" #: ../channels/microsoft365-graph/common-errors.rst:21 -msgid "Possible reasons:" +msgid "**Possible reasons:**" msgstr "" #: ../channels/microsoft365-graph/common-errors.rst:23 @@ -4476,12 +4472,8 @@ msgstr "" msgid "Problem with User Permissions" msgstr "" -#: ../channels/microsoft365-graph/common-errors.rst:33 -msgid "``ErrorItemNotFound``" -msgstr "" - -#: ../channels/microsoft365-graph/common-errors.rst:33 -msgid "*The specified object was not found in the store., Default folder Root not found.*" +#: ../channels/microsoft365-graph/common-errors.rst:32 +msgid "**Error message:** ``ErrorItemNotFound. The specified object was not found in the store. Default folder Root not found.``" msgstr "" #: ../channels/microsoft365-graph/common-errors.rst:35 @@ -4492,15 +4484,11 @@ msgstr "" msgid "Problem with Shared Mailbox" msgstr "" -#: ../channels/microsoft365-graph/common-errors.rst:43 -msgid "``ErrorInvalidUser``" -msgstr "" - -#: ../channels/microsoft365-graph/common-errors.rst:43 -msgid "*The requested user '\\*' is invalid.*" +#: ../channels/microsoft365-graph/common-errors.rst:42 +msgid "**Error message:** ``ErrorInvalidUser. The requested user '\\*' is invalid.``" msgstr "" -#: ../channels/microsoft365-graph/common-errors.rst:45 +#: ../channels/microsoft365-graph/common-errors.rst:44 msgid "Possible reason could be that the shared mailbox you provided is wrong. Check if the provided shared mailbox email address is correct." msgstr "" @@ -5013,173 +5001,157 @@ msgstr "" #: ../channels/microsoft365/common-errors.rst:None #: ../channels/microsoft365/common-errors.rst:None #: ../channels/microsoft365/common-errors.rst:None -#: ../channels/microsoft365/common-errors.rst:105 -#: ../channels/microsoft365/common-errors.rst:114 +#: ../channels/microsoft365/common-errors.rst:95 +#: ../channels/microsoft365/common-errors.rst:104 #: ../channels/microsoft365/common-errors.rst:None msgid "Error message" msgstr "" #: ../channels/microsoft365/common-errors.rst:22 -msgid "In this case, please compare whether the client ID created in Zammad matches that in Azure for the Azure App." +msgid "In this case, please compare whether the client ID created in Zammad matches that in Azure for the Azure App. The Client ID can be found in the Zammad settings under *Channels > Microsoft 365 IMAP Email > App Configuration*." msgstr "" -#: ../channels/microsoft365/common-errors.rst:25 -msgid "The Client ID can be found in the Zammad settings under *Channels > Microsoft 365 IMAP Email > App Configuration*. See :doc:`account setup ` how to find the client ID in Azure and where to copy it to Zammad." -msgstr "" - -#: ../channels/microsoft365/common-errors.rst:31 +#: ../channels/microsoft365/common-errors.rst:28 msgid "Wrong or Expired Client Secret" msgstr "" -#: ../channels/microsoft365/common-errors.rst:33 +#: ../channels/microsoft365/common-errors.rst:30 msgid "**Error message:** 500: We're sorry, but something went wrong." msgstr "" -#: ../channels/microsoft365/common-errors.rst:40 -msgid "This error occurs when the client uses an incorrect or expired client secret." +#: ../channels/microsoft365/common-errors.rst:37 +msgid "This error occurs when the client uses an incorrect or expired client secret. See :doc:`account setup ` for more information." msgstr "" #: ../channels/microsoft365/common-errors.rst:42 -msgid "**Important notice:** We never ask the client for the client secret as this can potentially be a security risk. We ask the customer to create a new client secret and copy the value and not the ID to Zammad." -msgstr "" - -#: ../channels/microsoft365/common-errors.rst:47 -msgid "See :doc:`account setup ` for more information." -msgstr "" - -#: ../channels/microsoft365/common-errors.rst:51 msgid "Wrong Tenant" msgstr "" -#: ../channels/microsoft365/common-errors.rst:53 +#: ../channels/microsoft365/common-errors.rst:44 msgid "**Error message:** AADSTS0023: Specified tenant identifier 'xxxxxxxx' is neither a valid DNS name, nor a valid external domain." msgstr "" -#: ../channels/microsoft365/common-errors.rst:61 -msgid "If a wrong tenant is used in Zammad or the email account is not a member of the tenant created in Zammad, this error message occurs." +#: ../channels/microsoft365/common-errors.rst:52 +msgid "If a wrong tenant is used in Zammad or the email account is not a member of the tenant created in Zammad, this error message occurs. In such a case, please check if the tenant is entered correctly in Zammad, or remove the tenant completely." msgstr "" -#: ../channels/microsoft365/common-errors.rst:64 -msgid "In this case, please check if the tenant is entered correctly in Zammad, or remove the tenant completely." -msgstr "" - -#: ../channels/microsoft365/common-errors.rst:67 +#: ../channels/microsoft365/common-errors.rst:57 msgid "**Important notice:** Once the tenant is completely removed, all email accounts can be created in Zammad regardless of which tenant the email account is a member of." msgstr "" -#: ../channels/microsoft365/common-errors.rst:74 +#: ../channels/microsoft365/common-errors.rst:64 msgid "**Prompt:** approval required" msgstr "" -#: ../channels/microsoft365/common-errors.rst:81 +#: ../channels/microsoft365/common-errors.rst:71 msgid "This message occurs when the admin tries to create an email account in Zammad that has not yet received approval from the Azure global admin." msgstr "" -#: ../channels/microsoft365/common-errors.rst:84 +#: ../channels/microsoft365/common-errors.rst:74 msgid "In our documentation, :doc:`step-by-step instructions ` can be found on how to request admin consent from Zammad." msgstr "" -#: ../channels/microsoft365/common-errors.rst:89 +#: ../channels/microsoft365/common-errors.rst:79 msgid "The request for the admin consent can be bypassed by assigning the admin consent in Azure to the App." msgstr "" -#: ../channels/microsoft365/common-errors.rst:92 -msgid "Home > App Registration > Manage > API Permission > Grant admin consent for \"MSFT\"." +#: ../channels/microsoft365/common-errors.rst:82 +msgid "*Home > App Registration > Manage > API Permission > Grant admin consent for \"MSFT\"*." msgstr "" -#: ../channels/microsoft365/common-errors.rst:96 +#: ../channels/microsoft365/common-errors.rst:86 msgid "Missing Permissions for the Azure User" msgstr "" -#: ../channels/microsoft365/common-errors.rst:98 +#: ../channels/microsoft365/common-errors.rst:88 msgid "**Error message:** Can't use Channel:Driver::SMTPAuthentificationError:Net::SMTPAuthentificationError" msgstr "" -#: ../channels/microsoft365/common-errors.rst:105 +#: ../channels/microsoft365/common-errors.rst:95 msgid "Error message in the M365 channel settings" msgstr "" -#: ../channels/microsoft365/common-errors.rst:107 +#: ../channels/microsoft365/common-errors.rst:97 msgid "or" msgstr "" -#: ../channels/microsoft365/common-errors.rst:114 +#: ../channels/microsoft365/common-errors.rst:104 msgid "Error message in the ticket" msgstr "" -#: ../channels/microsoft365/common-errors.rst:116 +#: ../channels/microsoft365/common-errors.rst:106 msgid "This error occurs when the admin wants to create an email account in Zammad whose user does not have permission for SMTP authentication to the mail server. Please check the following two most common problems in this case." msgstr "" -#: ../channels/microsoft365/common-errors.rst:121 +#: ../channels/microsoft365/common-errors.rst:111 msgid "Private Email Account" msgstr "" -#: ../channels/microsoft365/common-errors.rst:123 +#: ../channels/microsoft365/common-errors.rst:113 msgid "If it is a private email account, the admin must grant the SMTP authentication permission to the user of the inbox. The permission is provided at https://admin.microsoft.com." msgstr "" -#: ../channels/microsoft365/common-errors.rst:127 +#: ../channels/microsoft365/common-errors.rst:117 msgid "Add the SMTP authentication permission under *Users > Active Users* and click on *User > Email > Manage Email Apps*." msgstr "" -#: ../channels/microsoft365/common-errors.rst:136 +#: ../channels/microsoft365/common-errors.rst:126 msgid "Shared Inbox" msgstr "" -#: ../channels/microsoft365/common-errors.rst:138 +#: ../channels/microsoft365/common-errors.rst:128 msgid "If it is a shared inbox, you can try to enable the SMTP Authentication (``SmtpClientAuthenticationDisabled``) in the Azure shell. This isn't a Zammad problem, so we can only help to a limited extent here." msgstr "" -#: ../channels/microsoft365/common-errors.rst:142 +#: ../channels/microsoft365/common-errors.rst:132 msgid "To enable the SMTP Authentication, use the following commands:" msgstr "" -#: ../channels/microsoft365/common-errors.rst:144 +#: ../channels/microsoft365/common-errors.rst:134 msgid "If not installed:" msgstr "" -#: ../channels/microsoft365/common-errors.rst:150 +#: ../channels/microsoft365/common-errors.rst:140 msgid "Log in to Exchange using Powershell:" msgstr "" -#: ../channels/microsoft365/common-errors.rst:156 +#: ../channels/microsoft365/common-errors.rst:146 msgid "Switching on the SMTP authentication for a mailbox - also possible with a shared mailbox:" msgstr "" -#: ../channels/microsoft365/common-errors.rst:164 +#: ../channels/microsoft365/common-errors.rst:154 msgid "Retrieval of Email Failed" msgstr "" -#: ../channels/microsoft365/common-errors.rst:166 +#: ../channels/microsoft365/common-errors.rst:156 msgid "**Error message:** Retrieval using the IMAP4 protocol failed for the following message: [...]" msgstr "" -#: ../channels/microsoft365/common-errors.rst:169 +#: ../channels/microsoft365/common-errors.rst:159 msgid "This can be caused by Microsoft Defender for Office 365 when Zammad fetches an email while its attachment is still being checked." msgstr "" -#: ../channels/microsoft365/common-errors.rst:172 +#: ../channels/microsoft365/common-errors.rst:162 msgid "To avoid this, you should change the `Safe Attachments unknown malware response `_ from \"Dynamic Delivery\" to something else fitting your needs (e.g. \"Block\") for your Office 365 instance." msgstr "" -#: ../channels/microsoft365/common-errors.rst:179 +#: ../channels/microsoft365/common-errors.rst:168 msgid "Authentication Unsuccessful" msgstr "" -#: ../channels/microsoft365/common-errors.rst:181 +#: ../channels/microsoft365/common-errors.rst:170 msgid "**Error message:** 535 5.7.3 Authentication unsuccessful" msgstr "" -#: ../channels/microsoft365/common-errors.rst:183 +#: ../channels/microsoft365/common-errors.rst:172 msgid "This error message can have different reasons. See description below for one of them." msgstr "" -#: ../channels/microsoft365/common-errors.rst:186 +#: ../channels/microsoft365/common-errors.rst:175 msgid "Microsoft allows sign-in and authentication using the primary email address. While this works for fetching emails, SMTP authentication may not work in this case." msgstr "" -#: ../channels/microsoft365/common-errors.rst:190 +#: ../channels/microsoft365/common-errors.rst:179 msgid "Try to delete the MS account and recreate it using your username. In Zammad, manually change the email address to the username. Then you should be able to send and receive emails again." msgstr ""