github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-24 01:38:56 -04:00
Code Issues Projects Releases Packages Wiki Activity

[8.9] [DOCS] Clarify Microsoft Exchange endpoints supported by email connector (#161815) (#161880)

Browse source 
# Backport

This will backport the following commits from `main` to `8.9`:
- [[DOCS] Clarify Microsoft Exchange endpoints supported by email
connector (#161815)](https://github.com/elastic/kibana/pull/161815)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"lcawley@elastic.co"},"sourceCommit":{"committedDate":"2023-07-13T14:52:03Z","message":"[DOCS]
Clarify Microsoft Exchange endpoints supported by email connector
(#161815)","sha":"81b250b509c3ae647ed11dd051d8cb6cbd42e765","branchLabelMapping":{"^v8.10.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","Team:ResponseOps","docs","Feature:Actions/ConnectorTypes","v8.9.0","v8.10.0"],"number":161815,"url":"https://github.com/elastic/kibana/pull/161815","mergeCommit":{"message":"[DOCS]
Clarify Microsoft Exchange endpoints supported by email connector
(#161815)","sha":"81b250b509c3ae647ed11dd051d8cb6cbd42e765"}},"sourceBranch":"main","suggestedTargetBranches":["8.9"],"targetPullRequestStates":[{"branch":"8.9","label":"v8.9.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.10.0","labelRegex":"^v8.10.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/161815","number":161815,"mergeCommit":{"message":"[DOCS]
Clarify Microsoft Exchange endpoints supported by email connector
(#161815)","sha":"81b250b509c3ae647ed11dd051d8cb6cbd42e765"}}]}]
BACKPORT-->

Co-authored-by: Lisa Cawley <lcawley@elastic.co>
This commit is contained in:
Kibana Machine 2023-07-13 11:18:24 -04:00 • committed by GitHub
parent 49a4eee8eb
commit e72edd29a1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/management/connectors/action-types/email.asciidoc
View file

@ -8,11 +8,8 @@
:frontmatter-tags-content-type: [how-to]
:frontmatter-tags-user-goals: [configure]
The email connector uses the SMTP protocol to send mail messages, using an
integration of https://nodemailer.com/[Nodemailer]. An exception is Microsoft
Exchange, which uses HTTP protocol for sending emails,
https://docs.microsoft.com/en-us/graph/api/user-sendmail[Send mail]. Email
message text is sent as both plain text and html text.
The email connector uses the SMTP protocol to send mail messages.
Email message text is sent as both plain text and html text.
[NOTE]
====
@ -214,11 +211,10 @@ settings. You can set configurations that apply to all your connectors or use
[[configuring-email]]
=== Configure email accounts for well-known services
The email connector can send email using many popular SMTP email services and
the Microsoft Exchange Graph API.
The email connector uses an integration of https://nodemailer.com/[Nodemailer] to send email from many popular SMTP email services.
For Microsoft Exchange email, it uses the Microsoft Graph API.
For more information about configuring the email connector to work with
different email systems, refer to:
To configure the email connector to work with common email systems, refer to:
* <<elasticcloud>>
* <<gmail>>
@ -337,7 +333,7 @@ at AWS.
[[exchange-basic-auth]]
==== Sending email from Microsoft Exchange with Basic Authentication
deprecated:[This Microsoft Exchange configuration is deprecated in 7.16.0, and will be removed later, because Microsoft is deprecating https://docs.microsoft.com/en-us/lifecycle/announcements/exchange-online-basic-auth-deprecated [Basic Authentication]:
deprecated:[7.16.0,"This Microsoft Exchange configuration is deprecated and will be removed later because Microsoft is deprecating basic authentication."]
[source,text]
--------------------------------------------------
@ -365,6 +361,8 @@ https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-client
[[exchange]]
==== Sending email from Microsoft Exchange with OAuth 2.0
NOTE: The email connector uses Microsoft Graph REST API v1.0, in particular the https://docs.microsoft.com/en-us/graph/api/user-sendmail[sendMail] endpoint. It supports only the https://learn.microsoft.com/en-us/graph/deployments#microsoft-graph-and-graph-explorer-service-root-endpoints[Microsoft Graph global service] root endpoint (`https://graph.microsoft.com`).
Before you create an email connector for Microsoft Exchange, you must create and
register the client integration application on the
https://go.microsoft.com/fwlink/?linkid=2083908[Azure portal]: