This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-site.git
The following commit(s) were added to refs/heads/main by this push:
new 5769bad237 Fix IMAP configuration (#859)
5769bad237 is described below
commit 5769bad237ff078fbc71e61faee6177bdf27f4ef
Author: Jarek Potiuk <[email protected]>
AuthorDate: Fri Sep 1 17:59:38 2023 +0200
Fix IMAP configuration (#859)
---
.../apache-airflow-providers-imap/3.3.1/.buildinfo | 2 +-
.../airflow/providers/imap/hooks/imap.html | 6 ++--
.../3.3.1/configurations-ref.html | 39 ++++++++++++++++++++-
.../3.3.1/objects.inv | Bin 824 -> 843 bytes
.../3.3.1/searchindex.js | 2 +-
.../3.3.1/security/security-model.html | 1 -
6 files changed, 44 insertions(+), 6 deletions(-)
diff --git a/docs-archive/apache-airflow-providers-imap/3.3.1/.buildinfo
b/docs-archive/apache-airflow-providers-imap/3.3.1/.buildinfo
index 70d1cabae8..7e3290ca0a 100644
--- a/docs-archive/apache-airflow-providers-imap/3.3.1/.buildinfo
+++ b/docs-archive/apache-airflow-providers-imap/3.3.1/.buildinfo
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it
is not found, a full rebuild will be done.
-config: 8c4cd5541008bf4ef460dfd74dfac52f
+config: 1bf7918303510b2128406e1967189472
tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git
a/docs-archive/apache-airflow-providers-imap/3.3.1/_modules/airflow/providers/imap/hooks/imap.html
b/docs-archive/apache-airflow-providers-imap/3.3.1/_modules/airflow/providers/imap/hooks/imap.html
index bb7e31550c..5bd32b78c9 100644
---
a/docs-archive/apache-airflow-providers-imap/3.3.1/_modules/airflow/providers/imap/hooks/imap.html
+++
b/docs-archive/apache-airflow-providers-imap/3.3.1/_modules/airflow/providers/imap/hooks/imap.html
@@ -625,13 +625,15 @@
<span class="kn">import</span> <span class="nn">os</span>
<span class="kn">import</span> <span class="nn">re</span>
<span class="kn">import</span> <span class="nn">ssl</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span
class="kn">import</span> <span class="n">Any</span><span class="p">,</span>
<span class="n">Iterable</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span
class="kn">import</span> <span class="n">TYPE_CHECKING</span><span
class="p">,</span> <span class="n">Any</span><span class="p">,</span> <span
class="n">Iterable</span>
<span class="kn">from</span> <span class="nn">airflow.exceptions</span> <span
class="kn">import</span> <span class="n">AirflowException</span>
<span class="kn">from</span> <span class="nn">airflow.hooks.base</span> <span
class="kn">import</span> <span class="n">BaseHook</span>
-<span class="kn">from</span> <span class="nn">airflow.models.connection</span>
<span class="kn">import</span> <span class="n">Connection</span>
<span class="kn">from</span> <span
class="nn">airflow.utils.log.logging_mixin</span> <span
class="kn">import</span> <span class="n">LoggingMixin</span>
+<span class="k">if</span> <span class="n">TYPE_CHECKING</span><span
class="p">:</span>
+ <span class="kn">from</span> <span
class="nn">airflow.models.connection</span> <span class="kn">import</span>
<span class="n">Connection</span>
+
<div class="viewcode-block" id="ImapHook"><a class="viewcode-back"
href="../../../../../_api/airflow/providers/imap/hooks/imap/index.html#airflow.providers.imap.hooks.imap.ImapHook">[docs]</a><span
class="k">class</span> <span class="nc">ImapHook</span><span
class="p">(</span><span class="n">BaseHook</span><span class="p">):</span>
<span class="w"> </span><span class="sd">"""</span>
diff --git
a/docs-archive/apache-airflow-providers-imap/3.3.1/configurations-ref.html
b/docs-archive/apache-airflow-providers-imap/3.3.1/configurations-ref.html
index b44e2c0411..92660e3d03 100644
--- a/docs-archive/apache-airflow-providers-imap/3.3.1/configurations-ref.html
+++ b/docs-archive/apache-airflow-providers-imap/3.3.1/configurations-ref.html
@@ -623,6 +623,40 @@ that were available in Airflow core.</p>
<div class="section" id="imap">
<span id="config-imap"></span><h2><a class="toc-backref"
href="#id1">[imap]</a><a class="headerlink" href="#imap" title="Permalink to
this heading">¶</a></h2>
<p>Options for IMAP provider.</p>
+<div class="section" id="ssl-context">
+<span id="config-imap-ssl-context"></span><h3>ssl_context<a class="headerlink"
href="#ssl-context" title="Permalink to this heading">¶</a></h3>
+<blockquote>
+<div><div class="versionadded">
+<p><span class="versionmodified added">New in version 3.3.0.</span></p>
+</div>
+</div></blockquote>
+<p>ssl context to use when using SMTP and IMAP SSL connections. By default,
the context is “default”
+which sets it to <code class="docutils literal notranslate"><span
class="pre">ssl.create_default_context()</span></code> which provides the right
balance between
+compatibility and security, it however requires that certificates in your
operating system are
+updated and that SMTP/IMAP servers of yours have valid certificates that have
corresponding public
+keys installed on your machines. You can switch it to “none” if you want to
disable checking
+of the certificates, but it is not recommended as it allows MITM
(man-in-the-middle) attacks
+if your infrastructure is not sufficiently secured. It should only be set
temporarily while you
+are fixing your certificate configuration. This can be typically done by
upgrading to newer
+version of the operating system you run Airflow components on,by
upgrading/refreshing proper
+certificates in the OS or by updating certificates for your mail servers.
+If you do not set this option explicitly, it will use Airflow
“email.ssl_context” configuration,
+but if this configuration is not present, it will use “default” value.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type</dt>
+<dd class="field-odd"><p>string</p>
+</dd>
+<dt class="field-even">Default</dt>
+<dd class="field-even"><p><code class="docutils literal notranslate"><span
class="pre">None</span></code></p>
+</dd>
+<dt class="field-odd">Environment Variable</dt>
+<dd class="field-odd"><p><code class="docutils literal notranslate"><span
class="pre">AIRFLOW__IMAP__SSL_CONTEXT</span></code></p>
+</dd>
+<dt class="field-even">Example</dt>
+<dd class="field-even"><p><code class="docutils literal notranslate"><span
class="pre">default</span></code></p>
+</dd>
+</dl>
+</div>
</div>
</div>
@@ -702,7 +736,10 @@ that were available in Airflow core.</p>
<div class="wy-menu-vertical">
<ul>
<li><a class="reference internal" href="#">Configuration Reference</a><ul>
-<li><a class="reference internal" href="#imap">[imap]</a></li>
+<li><a class="reference internal" href="#imap">[imap]</a><ul>
+<li><a class="reference internal" href="#ssl-context">ssl_context</a></li>
+</ul>
+</li>
</ul>
</li>
</ul>
diff --git a/docs-archive/apache-airflow-providers-imap/3.3.1/objects.inv
b/docs-archive/apache-airflow-providers-imap/3.3.1/objects.inv
index 8e56bbc39d..6125fe204c 100644
Binary files a/docs-archive/apache-airflow-providers-imap/3.3.1/objects.inv and
b/docs-archive/apache-airflow-providers-imap/3.3.1/objects.inv differ
diff --git a/docs-archive/apache-airflow-providers-imap/3.3.1/searchindex.js
b/docs-archive/apache-airflow-providers-imap/3.3.1/searchindex.js
index 673aa4865b..9c2804b684 100644
--- a/docs-archive/apache-airflow-providers-imap/3.3.1/searchindex.js
+++ b/docs-archive/apache-airflow-providers-imap/3.3.1/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["_api/airflow/providers/imap/hooks/imap/index",
"_api/airflow/providers/imap/hooks/index", "_api/airflow/providers/imap/index",
"_api/airflow/providers/imap/sensors/imap_attachment/index",
"_api/airflow/providers/imap/sensors/index", "changelog", "commits",
"configurations-ref", "connections/imap", "index",
"installing-providers-from-sources", "security"], "filenames":
["_api/airflow/providers/imap/hooks/imap/index.rst",
"_api/airflow/providers/imap/hooks/in [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["_api/airflow/providers/imap/hooks/imap/index",
"_api/airflow/providers/imap/hooks/index", "_api/airflow/providers/imap/index",
"_api/airflow/providers/imap/sensors/imap_attachment/index",
"_api/airflow/providers/imap/sensors/index", "changelog", "commits",
"configurations-ref", "connections/imap", "index",
"installing-providers-from-sources", "security"], "filenames":
["_api/airflow/providers/imap/hooks/imap/index.rst",
"_api/airflow/providers/imap/hooks/in [...]
\ No newline at end of file
diff --git
a/docs-archive/apache-airflow-providers-imap/3.3.1/security/security-model.html
b/docs-archive/apache-airflow-providers-imap/3.3.1/security/security-model.html
deleted file mode 100644
index 9a36716bcb..0000000000
---
a/docs-archive/apache-airflow-providers-imap/3.3.1/security/security-model.html
+++ /dev/null
@@ -1 +0,0 @@
-<html><head><meta http-equiv="refresh" content="0;
url=../security.html"/></head></html>
\ No newline at end of file