Skip to content

Commit acf6666

Browse files
author
Paul Sokolovsky
committed
README: Add warning about problems access WebREPL client over HTTPS.
1 parent 8ea1afd commit acf6666

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,17 @@ http://micropython.org/webrepl (note: while it's hosted online,
1313
all interaction with your boards still happen locally in your
1414
own network).
1515

16+
At this time, WebREPL client cannot be accessed over HTTPS connection.
17+
This is due to not widely published policy that HTTPS pages may
18+
access only WSS (WebSocket Secure) protocol. This is somewhat
19+
similar to warnings issues when e.g. an HTTPS paeg loads an image
20+
over plain HTTP. However, in case of WebSockets, some browsers
21+
don't even issue a user-visible warning, and other may word it
22+
confusingly, so it's hard to understand that it applies to WebSocket
23+
connection. As WebREPL is intended to be used only within user's
24+
local network, HTTPS isn't strictly required, and not accessing
25+
webrepl.html over HTTPS is a suggested workaround.
26+
1627
WebREPL file transfer
1728
---------------------
1829

0 commit comments

Comments
 (0)