From e0a12201264b17052b909450761a1e5e5564fa73 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:17:25 +0000 Subject: [PATCH 1/7] move self-signed cert guide to bottom --- docs/ipad.md | 90 ++++++++++++++++++++++++++-------------------------- 1 file changed, 45 insertions(+), 45 deletions(-) diff --git a/docs/ipad.md b/docs/ipad.md index d1447e33..a40d03e9 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -45,51 +45,6 @@ can add this to `keybindings.json`: 4. Test the command by using `cmd+w` to close an active file. -## Access code-server with a self-signed certificate on an iPad - -If you've installed code-server and are [running it with a self-signed -certificate](./guide.md#using-a-self-signed-certificate), you may see multiple -security warnings from Safari. To fix this, you'll need to install the -self-signed certificate generated by code-server as a profile on your device (you'll also need to do this to -enable WebSocket connections). - -### Certificate requirements - -- We're assuming that you're using the self-signed certificate code-server - generates for you (if not, make sure that your certificate [abides by the - guidelines issued by Apple](https://support.apple.com/en-us/HT210176)). -- We've noticed that the certificate has to include `basicConstraints=CA:true`. -- Your certificate must have a subject alt name that matches the hostname you'll - use to access code-server from the iPad. You can pass this name to code-server - so that it generates the certificate correctly using `--cert-host`. - -### Sharing a self-signed certificate with an iPad - -To share a self-signed certificate with an iPad: - -1. Get the location of the certificate code-server generated; code-server prints - the certificate's location in its logs: - - ```console - [2020-10-30T08:55:45.139Z] info - Using generated certificate and key for HTTPS: ~/.local/share/code-server/mymbp_local.crt - ``` - -2. Send the certificate to the iPad, either by emailing it to yourself or using - Apple's Airdrop feature. - -3. Open the `*.crt` file so that you're prompted to go into Settings to install. - -4. Go to **Settings** > **General** > **Profile**, and select the profile. Tap **Install**. - -5. Go to **Settings** > **About** > **Certificate Trust Settings** and [enable - full trust for your certificate](https://support.apple.com/en-us/HT204477). - -You should be able to access code-server without all of Safari's warnings now. - -**warning**: Your iPad must access code-server via a domain name. It could be local -DNS like `mymacbookpro.local`, but it must be a domain name. Otherwise, Safari will -not allow WebSockets connections. - ## Access code-server using Servediter If you are unable to get the self-signed certificate working, or you do not have a domain @@ -199,3 +154,48 @@ In the meantime, you can manually define a shortcut as a workaround: ``` _Source: [StackOverflow](https://stackoverflow.com/a/52735954/3015595)_ + +## Access code-server with a self-signed certificate on an iPad + +If you've installed code-server and are [running it with a self-signed +certificate](./guide.md#using-a-self-signed-certificate), you may see multiple +security warnings from Safari. To fix this, you'll need to install the +self-signed certificate generated by code-server as a profile on your device (you'll also need to do this to +enable WebSocket connections). + +### Certificate requirements + +- We're assuming that you're using the self-signed certificate code-server + generates for you (if not, make sure that your certificate [abides by the + guidelines issued by Apple](https://support.apple.com/en-us/HT210176)). +- We've noticed that the certificate has to include `basicConstraints=CA:true`. +- Your certificate must have a subject alt name that matches the hostname you'll + use to access code-server from the iPad. You can pass this name to code-server + so that it generates the certificate correctly using `--cert-host`. + +### Sharing a self-signed certificate with an iPad + +To share a self-signed certificate with an iPad: + +1. Get the location of the certificate code-server generated; code-server prints + the certificate's location in its logs: + + ```console + [2020-10-30T08:55:45.139Z] info - Using generated certificate and key for HTTPS: ~/.local/share/code-server/mymbp_local.crt + ``` + +2. Send the certificate to the iPad, either by emailing it to yourself or using + Apple's Airdrop feature. + +3. Open the `*.crt` file so that you're prompted to go into Settings to install. + +4. Go to **Settings** > **General** > **Profile**, and select the profile. Tap **Install**. + +5. Go to **Settings** > **About** > **Certificate Trust Settings** and [enable + full trust for your certificate](https://support.apple.com/en-us/HT204477). + +You should be able to access code-server without all of Safari's warnings now. + +**warning**: Your iPad must access code-server via a domain name. It could be local +DNS like `mymacbookpro.local`, but it must be a domain name. Otherwise, Safari will +not allow WebSockets connections. \ No newline at end of file From 4229e95a7d4dd497d0c00895667b9f20c88ba977 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:17:58 +0000 Subject: [PATCH 2/7] remove closed issue --- docs/ipad.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/ipad.md b/docs/ipad.md index a40d03e9..4fba369c 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -104,7 +104,6 @@ and tricks helpful: process](#access-code-server-with-a-self-signed-certificate-on-an-ipad) - Keyboard issues: - The keyboard disappear sometimes - [#1313](https://github.com/cdr/code-server/issues/1313), [#979](https://github.com/cdr/code-server/issues/979) - Some expectations regarding shortcuts may not be met: - `cmd + n` opens new browser window instead of new file, and it's difficult From 80f3884e0fff6e3e10b9ce7efeae6a16cd889a5f Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:19:51 +0000 Subject: [PATCH 3/7] update trackpad scripping --- docs/ipad.md | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/docs/ipad.md b/docs/ipad.md index 4fba369c..86be4685 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -111,15 +111,9 @@ and tricks helpful: - In general, expect to edit your keyboard shortcuts - There's no escape key by default on the Magic Keyboard, so most users set the globe key to be an escape key -- Trackpad scrolling does not work +- Trackpad scrolling does not work on iPadOS < 145 ([#1455](https://github.com/cdr/code-server/issues/1455)) - - Bug tracking of a WebKit fix - [here](https://bugs.webkit.org/show_bug.cgi?id=210071#c13) - - Tracking of [WebKit patch](https://trac.webkit.org/changeset/270712/webkit) - - Alternatives: - - Install line-jump extension and use keyboard to navigate by jumping large - amount of lines - - Use touch scrolling + - [WebKit fix](https://bugs.webkit.org/show_bug.cgi?id=210071#c13) - `ctrl+c` does not stop a long-running process in the browser - Tracking upstream issue here: [#114009](https://github.com/microsoft/vscode/issues/114009) From 8156fc040ad97b860e3997855b94e57a2812f3a9 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:21:37 +0000 Subject: [PATCH 4/7] mention terminal text --- docs/ipad.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/ipad.md b/docs/ipad.md index 86be4685..640db557 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -114,6 +114,7 @@ and tricks helpful: - Trackpad scrolling does not work on iPadOS < 145 ([#1455](https://github.com/cdr/code-server/issues/1455)) - [WebKit fix](https://bugs.webkit.org/show_bug.cgi?id=210071#c13) +- Terminal text does not appear by default [#3824](https://github.com/cdr/code-server/issues/3824) - `ctrl+c` does not stop a long-running process in the browser - Tracking upstream issue here: [#114009](https://github.com/microsoft/vscode/issues/114009) From b27e1d8dd49f25e4e0eb4f073075f542706e8fb6 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:31:12 +0000 Subject: [PATCH 5/7] doctoc/format --- docs/ipad.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/ipad.md b/docs/ipad.md index 640db557..8c74a96b 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -3,14 +3,14 @@ # iPad - [Using the code-server progressive web app (PWA)](#using-the-code-server-progressive-web-app-pwa) -- [Access code-server with a self-signed certificate on an iPad](#access-code-server-with-a-self-signed-certificate-on-an-ipad) - - [Certificate requirements](#certificate-requirements) - - [Sharing a self-signed certificate with an iPad](#sharing-a-self-signed-certificate-with-an-ipad) - [Access code-server using Servediter](#access-code-server-using-servediter) - [Raspberry Pi USB-C network](#raspberry-pi-usb-c-network) - [Recommendations](#recommendations) - [Known issues](#known-issues) - [Workaround for issue with `ctrl+c` not stopping a running process in the terminal](#workaround-for-issue-with-ctrlc-not-stopping-a-running-process-in-the-terminal) +- [Access code-server with a self-signed certificate on an iPad](#access-code-server-with-a-self-signed-certificate-on-an-ipad) + - [Certificate requirements](#certificate-requirements) + - [Sharing a self-signed certificate with an iPad](#sharing-a-self-signed-certificate-with-an-ipad) From e58b072f243405a4c7b05d7638aedbe40180eca4 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:42:30 +0000 Subject: [PATCH 6/7] add focus bug --- docs/ipad.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/ipad.md b/docs/ipad.md index 8c74a96b..67409cc6 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -114,6 +114,7 @@ and tricks helpful: - Trackpad scrolling does not work on iPadOS < 145 ([#1455](https://github.com/cdr/code-server/issues/1455)) - [WebKit fix](https://bugs.webkit.org/show_bug.cgi?id=210071#c13) +- Keyboard may lose focus in Safari / split view [#4182](https://github.com/cdr/code-server/issues/4182) - Terminal text does not appear by default [#3824](https://github.com/cdr/code-server/issues/3824) - `ctrl+c` does not stop a long-running process in the browser - Tracking upstream issue here: From ee04915d1268eb36d7c3f4ef847b7efd36986272 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Thu, 23 Sep 2021 14:45:09 +0000 Subject: [PATCH 7/7] add newline (whoops) --- docs/ipad.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ipad.md b/docs/ipad.md index 67409cc6..a66bf2e0 100644 --- a/docs/ipad.md +++ b/docs/ipad.md @@ -193,4 +193,4 @@ You should be able to access code-server without all of Safari's warnings now. **warning**: Your iPad must access code-server via a domain name. It could be local DNS like `mymacbookpro.local`, but it must be a domain name. Otherwise, Safari will -not allow WebSockets connections. \ No newline at end of file +not allow WebSockets connections.