Link Search Menu Expand Document

Running as an app (Android)

The SCION Android app allows you to host a SCION AS on your smartphone. This allows you to request and serve contents from and to the SCIONLab network. All SCION services are configured automatically based on your SCIONLab configuration. For detailed usage instructions, see below.

Prerequisites

Instructions

To connect to the SCIONLab network with your Android phone, perform the following steps:

  1. Register for a free user account on scionlab.org.
  2. In “My ASes”, create a new SCIONLab AS with the following settings:

    • Label: any value (is ignored by the app)
    • Installation type: Choose SCION installation from sources
    • Attachment point: Choose any attachment point you like, preferably the nearest to your location
    • Use VPN: You must check this box
    • Public Port: You must not change this from its default value 50000

    Alternatively, you can also use an existing SCIONLab AS if you adjust its settings as described above. In that case, also make sure that the Active box is checked.

  3. Once you have created the AS, you can download its configuration from “My ASes” as a .tar.gz archive. Store this archive somewhere on your smartphone (e.g., on the SD card).
  4. In the app, press the blue SCION button. The app will ask you to install OpenVPN for Android, which is required to connect to SCIONLab. You do not need to start OpenVPN for Android manually, everything is set up by the SCION app.
  5. Once OpenVPN for Android is installed, press the SCION button again. You may have to grant permissions regarding VPN and media storage. Then choose the .tar.gz SCIONLab configuration you have downloaded previously.
  6. The app will now connect to SCIONLab and ping the given SCION address. To disconnect, press the SCION button again.

Troubleshooting

In the app, you can view all log data from SCION. For more detailed information, have a look at the /Android/data/org.scionlab.scion/files/ directory in the internal (or, on some devices, external) storage of your phone.


Copyright © 2020, Network Security Group, ETH Zurich