Code Monkey home page Code Monkey logo

open-sstp-client's Introduction

Open SSTP Client for Android

This is an open-sourced Secure Socket Tunneling Protocol (MS-SSTP) client for Android, developed for accessing to VPN Azure Cloud (or SoftEther VPN Server). So no test with other servers is done. Its behavior may be still unstable.

Installation

You can download and install the latest version via Google Play. Some of previous versions are released as apk file on the releases page.

Usage

Enter Host, Username and Password preferences and turn the switch on. If a key icon gets to show on the right side of the status bar, establishing a VPN connection has been succeeded. To disconnect the connection, turn the switch off in the home tab or tap the notification.

Setting tab

Some settings to be noted are written below:

Add Trusted Certificates (SSL Layer)

If you choose a certain directory, the client uses ONLY certificates in the directory, but the default certificate store. I made this option for debugging.

PPP Network Protocol

You can choose what network protocol PPP layer tries enabling. Remember, IPv6 option just gives the device a link local address, never guarantees that you can communicate perfectly with IPv6 protocol.

Custom DNS Server Address

You can specify DNS server to use in this option. Packets associated with this address is routed to the VPN tunnel. If you specify a IPv4(v6) address and disable IPv4(v6) network, domain names possibly cannot be resolved.

Enable App-Based Rule

With Select Allowed Apps option, you can specify the apps which use the VPN tunnel. Even allowed apps cannot use the VPN tunnel if their routes are not on the routeing table. So when you use this option, enabling Add Default Route option is recommended.

Notice

  • Host preference can also contain IP address, but cannot include a port number. You can configure it in the setting tab.

  • Your device needs to install a self-signed certificate and disable Verify Hostname option to access to a server using it

  • A server must enable DHCP

  • Only PAP and MS-CHAPv2 authentication protocols can be enabled. No EAP.

Debugging

It is almost impossible that I can debug a problem caused in any environments but my own. In a networking app, there are many possible reasons to cause the problem and I cannot identify the real one unless the problem can be reproduced in my environment.

So it is strongly encouraged that you should debug by yourself. With Select Cipher Suites option, this client tries to use TLS_RSA_WITH_AES_128_CBC_SHA or TLS_RSA_WITH_AES_256_CBC_SHA as a cipher suite so that you can decrypt and investigate packets with software like WireShark. I think there can be a similar app for Android. Don't forget the great software, Android Studio and its emulator (v^ー°)

I don't have Windows Server OS. So I don't officially support accessing to it, but there is a successful case. See this issue.

License

Licensed under MIT. Be sure you use this software at your own risk.

open-sstp-client's People

Contributors

kittoku avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.