Skip to content

Commit

Permalink
Add html helper for Android (trailofbits#554)
Browse files Browse the repository at this point in the history
* add html helper trailofbits#280

move to the new local schema

fix a typo

* Update client-android.md
  • Loading branch information
gunph1ld authored and dguido committed May 22, 2017
1 parent e9e6c6e commit 40e0363
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 1 deletion.
9 changes: 9 additions & 0 deletions docs/client-android.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Android client setup

## Installation via profiles

1. [Install the strongSwan VPN Client](https://play.google.com/store/apps/details?id=org.strongswan.android).
2. Copy `android_{username}.sswan` and `android_{username}_helper.html` to your phone's internal storage.
3. Open the helper file in a browser (e.g., Google Chrome).
4. Click on the link. It opens the StrongSwan app and configures the VPN with your profile.

## Manual installation

**NOTE:** If you are a Project Fi user, you must disable WiFi Assistant before continuing. See the [strongSwan documentation](https://wiki.strongswan.org/projects/strongswan/wiki/AndroidVPNClient) for details.

| Instruction | Screenshot(s) |
Expand Down
12 changes: 11 additions & 1 deletion roles/vpn/tasks/client_configs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,14 +27,24 @@
- name: Build the strongswan app android config
template:
src: sswan.j2
dest: configs/{{ IP_subject_alt_name }}/{{ item.0 }}.sswan
dest: configs/{{ IP_subject_alt_name }}/android_{{ item.0 }}.sswan
mode: 0600
become: no
with_together:
- "{{ users }}"
- "{{ PayloadContent.results }}"
no_log: True

- name: Build the android helper html
template:
src: android_html_helper.j2
dest: configs/{{ IP_subject_alt_name }}/android_{{ item.0 }}_helper.html
mode: 0600
become: no
with_together:
- "{{ users }}"
no_log: True

- name: Build the client ipsec config file
template:
src: client_ipsec.conf.j2
Expand Down
1 change: 1 addition & 0 deletions roles/vpn/templates/android_html_helper.j2
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<a href="android_{{ item.0 }}.sswan" type="application/vnd.strongswan.profile">{{ item.0 }}</a>

0 comments on commit 40e0363

Please sign in to comment.