app: add configuration FTP server

This is a ridiculous workaround to make the configuration (and other files) accessible to the user
necessary after the new storage access restriction enforced in Android 11 which prevent other
applications from accessing the supposedly public application's directory.

The app's internal private storage directory is now exposed to the user through an embedded FTP
server that the user can turn on and off from the configuration activity. The user can then play
with the configuration and retrieve logs through a remote or local FTP client application of their
choice.

GitHub: closes #103

13 files changed, 327 insertions, 13 deletions

diff --git a/app/build.gradle b/app/build.gradle
index 99e9226..41c75ef 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -70,6 +70,14 @@ android {
   buildFeatures {
     dataBinding = true
   }
+
+  packagingOptions {
+    // clashing in dependencies (Apache Mina FtpServer)
+    exclude 'META-INF/DEPENDENCIES'
+    exclude 'META-INF/spring.schemas'
+    exclude 'META-INF/spring.handlers'
+    exclude 'META-INF/license.txt'
+  }
 }
 
 dependencies {
@@ -88,6 +96,7 @@ dependencies {
   implementation('org.apache.commons:commons-configuration2:2.3') { exclude group: 'commons-logging', module: 'commons-logging' }
   implementation('commons-beanutils:commons-beanutils:1.9.3') { exclude group: 'commons-logging', module: 'commons-logging' }
   implementation('commons-io:commons-io:2.6') { exclude group: 'commons-logging', module: 'commons-logging' }
+  implementation('org.apache.ftpserver:ftpserver:1.1.1') { exclude group: 'org.slf4j', module: 'slf4j-log4j12' }
 }
 
 repositories {
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
index 5100915..ffbb3e3 100644
--- a/app/proguard-rules.pro
+++ b/app/proguard-rules.pro
@@ -1,5 +1,5 @@
 # Tinc App, an Android binding and user interface for the tinc mesh VPN daemon
-# Copyright (C) 2017-2019 Pacien TRAN-GIRARD
+# Copyright (C) 2017-2020 Pacien TRAN-GIRARD
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -15,6 +15,8 @@
 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 -keep class org.apache.commons.** { *; }
+-keep class org.apache.mina.** { *; }
+-keep class org.apache.ftpserver.** { *; }
 -keep class org.bouncycastle.**
 -keep class ch.qos.** { *; }
 -keep class org.slf4j.** { *; }
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index c86ec8f..020d62d 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -81,6 +81,10 @@
             </intent-filter>
         </service>
 
+        <service
+            android:name="org.pacien.tincapp.service.ConfigurationFtpService">
+        </service>
+
     </application>
 
 </manifest>
diff --git a/app/src/main/java/org/pacien/tincapp/activities/configure/ConfigurationFtpServerFragment.kt b/app/src/main/java/org/pacien/tincapp/activities/configure/ConfigurationFtpServerFragment.kt
new file mode 100644
index 0000000..b97a15e
--- /dev/null
+++ b/app/src/main/java/org/pacien/tincapp/activities/configure/ConfigurationFtpServerFragment.kt
@@ -0,0 +1,72 @@
+/*
+ * Tinc App, an Android binding and user interface for the tinc mesh VPN daemon
+ * Copyright (C) 2017-2020 Pacien TRAN-GIRARD
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package org.pacien.tincapp.activities.configure
+
+import android.content.Intent
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.databinding.Observable
+import androidx.databinding.ObservableBoolean
+import org.pacien.tincapp.activities.BaseFragment
+import org.pacien.tincapp.databinding.ConfigureToolsConfigurationFtpServerFragmentBinding
+import org.pacien.tincapp.service.ConfigurationFtpService
+
+/**
+ * @author pacien
+ */
+class ConfigurationFtpServerFragment : BaseFragment() {
+  private val ftpServerStartListener = object : Observable.OnPropertyChangedCallback() {
+    override fun onPropertyChanged(sender: Observable, propertyId: Int) {
+      binding.ftpEnabled = (sender as ObservableBoolean).get()
+    }
+  }
+
+  private lateinit var binding: ConfigureToolsConfigurationFtpServerFragmentBinding
+
+  override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View {
+    binding = ConfigureToolsConfigurationFtpServerFragmentBinding.inflate(inflater, container, false)
+    binding.ftpUsername = ConfigurationFtpService.FTP_USERNAME
+    binding.ftpPassword = ConfigurationFtpService.FTP_PASSWORD
+    binding.ftpPort = ConfigurationFtpService.FTP_PORT
+    binding.toggleFtpState = { toggleServer() }
+    return binding.root
+  }
+
+  override fun onResume() {
+    super.onResume()
+    ConfigurationFtpService.runningState.addOnPropertyChangedCallback(ftpServerStartListener)
+    binding.ftpEnabled = ConfigurationFtpService.runningState.get()
+  }
+
+  override fun onPause() {
+    ConfigurationFtpService.runningState.removeOnPropertyChangedCallback(ftpServerStartListener)
+    super.onPause()
+  }
+
+  private fun toggleServer() {
+    val targetServiceIntent = Intent(requireContext(), ConfigurationFtpService::class.java)
+
+    if (binding.ftpEnabled)
+      requireContext().stopService(targetServiceIntent)
+    else
+      requireContext().startService(targetServiceIntent)
+  }
+}
diff --git a/app/src/main/java/org/pacien/tincapp/service/ConfigurationFtpService.kt b/app/src/main/java/org/pacien/tincapp/service/ConfigurationFtpService.kt
new file mode 100644
index 0000000..c562768
--- /dev/null
+++ b/app/src/main/java/org/pacien/tincapp/service/ConfigurationFtpService.kt
@@ -0,0 +1,128 @@
+/*
+ * Tinc App, an Android binding and user interface for the tinc mesh VPN daemon
+ * Copyright (C) 2017-2020 Pacien TRAN-GIRARD
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package org.pacien.tincapp.service
+
+import android.app.Service
+import android.content.Intent
+import android.os.IBinder
+import androidx.databinding.ObservableBoolean
+import org.apache.ftpserver.FtpServer
+import org.apache.ftpserver.FtpServerFactory
+import org.apache.ftpserver.ftplet.*
+import org.apache.ftpserver.listener.ListenerFactory
+import org.apache.ftpserver.usermanager.UsernamePasswordAuthentication
+import org.apache.ftpserver.usermanager.impl.WritePermission
+import org.pacien.tincapp.R
+import org.pacien.tincapp.context.App
+import org.pacien.tincapp.extensions.Java.defaultMessage
+import org.slf4j.LoggerFactory
+import java.io.IOException
+
+/**
+ * FTP server service allowing a remote and local user to access and modify configuration files in
+ * the application's context.
+ *
+ * @author pacien
+ */
+class ConfigurationFtpService : Service() {
+  companion object {
+    const val FTP_PORT = 65521 // tinc port `concat` FTP port