Skip to content
This repository was archived by the owner on Jun 4, 2021. It is now read-only.

Add instructions for OpenConnect app on Android.#1440

Open
jsha wants to merge 12 commits into
StreisandEffect:masterfrom
jsha:openconnect-instructions
Open

Add instructions for OpenConnect app on Android.#1440
jsha wants to merge 12 commits into
StreisandEffect:masterfrom
jsha:openconnect-instructions

Conversation

@jsha
Copy link
Copy Markdown

@jsha jsha commented Sep 4, 2018

The OpenConnect app has a few advantages over the Cisco AnyConnect:

For now, I kept the AnyConnect instructions, but I think if a number of
people are successful with these instructions, it would make sense to
provide instructions only for OpenConnect.

Fixes #1143.

jsha added 2 commits September 3, 2018 21:54
The OpenConnect app has a few advantages over the Cisco AnyConnect:
 - Doesn't require agreeing to a EULA.
 - GPL'ed.
 - Can install a CA certificate rather than clicking through a
   certificate mismatch prompt.
 - Forward secrecy.
 - It doesn't appear to tickle the bug in StreisandEffect#847 (prompting for a
   username).

For now, I kept the AnyConnect instructions, but I think if a number of
people are successful with these instructions, it would make sense to
provide instructions only for OpenConnect.

Fixes StreisandEffect#1143.
Certificates installed at the system level are trusted for both HTTPS
and VPN, so it's better not to install the CA certificate.
Copy link
Copy Markdown
Collaborator

@alimakki alimakki left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @jsha for the PR and taking the time to write out instructions for OpenConnect on Android.

The instructions you have written look good, however I think it would be clearer to separate OpenConnect and AnyConnect instructions under their own respective anchor elements for navigational purposes - this would keep consistency with the layout we are using when having multiple options for the same platform (see the macOS instructions for example):

* [Android](#android)
  * [Android OpenConnect](#android-openconnect)
  * [Android AnyConnect](#android-anyconnect)

@@ -117,6 +117,33 @@ Client certificates are a mechanism by which clients can authenticate themselves
<a name="android"></a>
### Android ###
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<a name="android-openconnect"></a>
### Android OpenConnect ###

1. You will be prompted *Please select your group.* The correct default has already been chosen. Tap *OK*.
1. You should be good to go! You can verify that your traffic is being routed properly by [looking up your IP address on DuckDuckGo]({{ streisand_my_ip_url }}). It should say *Your public IP address is {{ streisand_ipv4_address }}*.

Alternate instructions using Cisco AnyConnect, in case the above instructions fail:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<a href="android-anyconnect"></a>
### Android AnyConnect ###
Alternate instructions using ....

@baimafeima
Copy link
Copy Markdown

Thank you @jsha for the PR. I think it would still be good to keep both OpenConnect and AnyConnect so that the widest possible user group can meaningfully follow the instructions.

@cpu cpu added status/revisions-needed For items with outstanding requested changes status/needs-testing For items that need to be manually tested labels Oct 20, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area/openconnect client/android kind/docs status/needs-testing For items that need to be manually tested status/revisions-needed For items with outstanding requested changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Android instructions for OpenConnect in addition to AnyConnect

6 participants