From d3e19b7e52debe0db759f56e25eb2706ad2434b6 Mon Sep 17 00:00:00 2001
From: Miguel Grinberg <miguel.grinberg@gmail.com>
Date: Sun, 19 May 2019 17:11:12 +0100
Subject: [PATCH] note on cors support for sanic (fixes #205)

---
 docs/server.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/server.rst b/docs/server.rst
index c13fc75..8d36147 100644
--- a/docs/server.rst
+++ b/docs/server.rst
@@ -534,6 +534,18 @@ The Sanic application is then executed in the usual manner::
     if __name__ == '__main__':
         app.run()
 
+It has been reported that the CORS support provided by the Sanic extension
+`sanic-cors <https://github.com/ashleysommer/sanic-cors>`_ is incomaptible with
+this package's own support for this protocol. To disable CORS support in this
+package and let Sanic take full control, initialize the server as follows::
+
+    sio = socketio.AsyncServer(async_mode='sanic', cors_allowed_origins=[])
+
+On the Sanic side you will need to enable the `CORS_SUPPORTS_CREDENTIALS`
+setting in addition to any other configuration that you use::
+
+    app.config['CORS_SUPPORTS_CREDENTIALS'] = True
+
 Uvicorn, Daphne, and other ASGI servers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~