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

Add instructions for OpenConnect app on Android. #1440

Open
wants to merge 12 commits into
base: master
Choose a base branch
from

Conversation

jsha
Copy link

@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.

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
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
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
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

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