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">&quot;&quot;&quot;</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

Reply via email to