Enforce the use of python3 when running this script

* commit 'e976f230da31301ab16531caf9997fa6216f7ff3':
  WebApp Admin: Add polling interval injection

LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (C) 2019 Kopano and its licensors
+
+This program is free software: you can redistribute it and/or modify it under the terms of the
+GNU Affero 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 Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along with this program.
+If not, see http://www.gnu.org/licenses/.

README.md

@@ -0,0 +1,27 @@
+# WebApp tools
+
+WebApp tools repository can be found [here](https://stash.kopano.io/projects/KSC/repos/webapp-tools/) and consist of various sub-projects:
+
+## WebApp_Admin
+
+A CLI tool that can be used to manage WebApp user settings, signatures, S/MIME certificates and more.
+More info [here](https://stash.kopano.io/projects/KSC/repos/webapp-tools/browse/webapp_admin/README.md).
+
+## Files_Admin
+
+A CLI tool to inject files accounts into a user settings. More info [here](https://stash.kopano.io/projects/KSC/repos/webapp-tools/browse/files_admin/README.md).
+
+## Manage_recipients
+
+A simple script to manage the recipient history list for a user. More info [here](https://stash.kopano.io/projects/KSC/repos/webapp-tools/browse/manage_recipients/readme.md).
+
+# How to contribute
+
+1) Clone the repository from `https://stash.kopano.io/` or `https://github.com/Kopano-mirror/webapp_tools`.
+2) Commit and sign your work (git commit -s).
+3) Upload commits to a git store of your choosing, or export the series as a patchset using git format-patch.
+4) Send the patch(es) or git link to `contributing @ kopano .io` and we will consider the submission.
+
+# License
+
+All software found in this repostory and sub-projects are licensed under GNU Affero General Public License v3 unless stated otherwise. A copy of this license can be found in the main directory of this project and in every sub-project.

files_admin/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (C) 2019 Kopano and its licensors
+
+This program is free software: you can redistribute it and/or modify it under the terms of the
+GNU Affero 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 Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along with this program.
+If not, see http://www.gnu.org/licenses/.

files_admin/README.md

@@ -19,4 +19,8 @@ Use the username and password provided in the config file
 # Dependencies
 
 - python-kopano
-- python-mapi
+- python-mapi
+
+# License
+
+licensed under GNU Affero General Public License v3.

files_admin/files_admin.py

@@ -54,11 +54,11 @@ def files(options):
     files = options.file.split(',')
     for file in files:
         configfile = ConfigObj(file)
-        if configfile['setting']['use_zarafa_credentials']:
-            username = configfile['setting']['default_user']
-        else:
+        if configfile['setting'].as_bool('use_zarafa_credentials'):
             username = options.user
-        password = encode(configfile['setting']['default_password'])
+        else:
+            username = configfile['setting'].get('default_user', 'does not matter')
+        password = encode(configfile['setting'].get('default_password', 'does not matter'))
         backendoptions = {
             'ftp': {"backend_features": {
                 "Streaming": "true", }},
@@ -93,6 +93,7 @@ def files(options):
             address = configfile['setting']['server_address']
             ssl = configfile['setting']['server_ssl']
         id = str(uuid.uuid4())
+
         filesjson['accounts'][id] = {
             "status": "ok",
             "backend_config": {
@@ -101,7 +102,7 @@ def files(options):
                 "server_address": encode(address).decode('utf-8'),
                 "server_ssl": ssl,
                 "current_account_id": encode('d4cacda458a2a26c301f2b7d75ada530').decode('utf-8'),
-                "use_zarafa_credentials": configfile['setting']['use_zarafa_credentials'],
+                "use_zarafa_credentials": configfile['setting'].as_bool('use_zarafa_credentials'),
                 "user": encode(username).decode('utf-8'),
                 "password": password.decode('utf-8'),
                 "server_port": encode(port).decode('utf-8')

files_admin/ftp.cfg

@@ -0,0 +1,13 @@
+[setting]
+
+name = FTP server
+type = FTP
+workgroup =
+server_path = /srv/ftp
+server_address = 10.10.11.9
+server_ssl = false
+use_zarafa_credentials = false
+server_port = 21
+default_user = ftpuser
+default_password = ftpuser
+server_pasv = false

files_admin/smb.cfg

@@ -4,7 +4,7 @@ name = Samba share
 type = SMB
 workgroup = zarafa
 server_path = files
-server_address = 192.168.1.230
+server_address = 10.10.11.9
 server_ssl = false
 use_zarafa_credentials = true
 server_port = 80

manage_recipients/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (C) 2019 Kopano and its licensors
+
+This program is free software: you can redistribute it and/or modify it under the terms of the
+GNU Affero 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 Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along with this program.
+If not, see http://www.gnu.org/licenses/.

manage_recipients/README.md

@@ -11,24 +11,28 @@ Manage recipients in webapp
 python remove_recipients.py --user <user>  --list
 ```
 ###### Remove recipient
-Remove options is searching in display_name, smtp_address or email_address. 
+Remove options is searching in display_name, smtp_address or email_address.
 
 ```python
 python remove_recipients.py --user <user>  --remove <recipient name>
 ```
-    
-###### Clear history 
+
+###### Clear history
 
 ```python
 python remove_recipients.py --user <user>  --remove-all
 ```
-    
+
 #### Example
 
 Remove all recipients that have example.com in there display_name, smtp_address or email_address
 
 ```python
 python remove_recipients.py --user user  --remove example.com
-```  
+```
+
+# License
+
+licensed under GNU Affero General Public License v3.
 
 

webapp_admin/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (C) 2019 Kopano and its licensors
+
+This program is free software: you can redistribute it and/or modify it under the terms of the
+GNU Affero 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 Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along with this program.
+If not, see http://www.gnu.org/licenses/.

webapp_admin/README.md

@@ -1,6 +1,6 @@
 # WebApp Admin
 
->**This tool is under contruction. Use caution on a live server. Always make a backup of the user settings and test first before modifing**
+>**Always make a backup of the user settings and test the new settings afterwards**
 
 WebApp admin is a command-line interface to modify, inject and export WebApp settings.
 
@@ -22,3 +22,7 @@ If you want to make a change for all users pass the --all-users parameter. Examp
 - python-mapi
 - OpenSSL
 - dotty_dict
+
+# License
+
+licensed under GNU Affero General Public License v3.

webapp_admin/webapp_admin.py

@@ -1,23 +1,26 @@
 #!/usr/bin/env python3
 # encoding: utf-8
+from pkg_resources import parse_version
 import sys
+if sys.version_info[0] < 3:
+    print('This tool works with Python3. Not Python 2')
+    sys.exit(1)
 try:
     import kopano
 except ImportError:
-    print('python-kopano should be installed on your system')
+    print('python3-kopano should be installed on your system')
     sys.exit(1)
 try:
     from MAPI.Util import *
 except ImportError:
-    print('python-mapi should be installed on your system')
+    print('python3-mapi should be installed on your system')
     sys.exit(1)
 import json
 import base64
 try:
     import OpenSSL.crypto
 except ImportError:
-    print('pip3 install pyOpenSSL')
-    sys.exit(1)
+    pass
 from datetime import datetime
 from time import mktime
 import getpass
@@ -26,7 +29,7 @@ from optparse import OptionGroup
 try:
     from dotty_dict import dotty
 except ImportError:
-    print('dotty_dict not found on your system. Run pip3 install dotty_dict')
+    pass
 
 
 """
@@ -75,11 +78,14 @@ def opt_args(print_help=None):
 
     # WebApp setting option group
     group = OptionGroup(parser, "webapp-settings", "")
-    group.add_option("--language", dest="language", action="store", help="Set new language (e.g. en_GB or nl_NL)")
+    group.add_option("--language", dest="language", action="store", type="string", help="Set new language (e.g. en_GB or nl_NL)")
     group.add_option("--theme", dest="theme", action="store", help="Change theme (e.g. dark)")
     group.add_option("--free-busy", dest="freebusy", action="store", help="Change free/busy time span in months")
     group.add_option("--icons", dest="icons", action="store", help="Change icons (e.g. breeze)")
     group.add_option("--htmleditor", dest="htmleditor", action="store", help="Change the HTML editor (e.g. full_tinymce)")
+    group.add_option("--remove-state", dest="remove_state", action="store_true", help="Remove all the state settings")
+    group.add_option("--add-safesender", dest="addsender", action="store", help="Add domain to safe sender list")
+    group.add_option("--polling-interval", dest="pollinginterval", action="store", help="Change the polling interval (seconds)")
     parser.add_option_group(group)
 
     # Advanced option group
@@ -315,11 +321,11 @@ def import_categories(user, filename=None):
     if not user.store.get_prop(PR_EC_WEBAPP_PERSISTENT_SETTINGS_JSON_W):
         persistent_settings ={'settings': {'kopano': {'main': {'categories':data}}}}
     else:
-        persistent_settings = user.store.get_prop(PR_EC_WEBAPP_PERSISTENT_SETTINGS_JSON_W)
+        persistent_settings = json.loads(user.store.get_prop(PR_EC_WEBAPP_PERSISTENT_SETTINGS_JSON_W).value)
         persistent_settings['settings']['kopano']['main']['categories'] = data
 
     print('Restoring categories for user {}'.format(user.name))
-    user.store.create_prop(PR_EC_WEBAPP_PERSISTENT_SETTINGS_JSON_W, json.dumps(persistent_settings).decode('utf-8'))
+    user.store.create_prop(PR_EC_WEBAPP_PERSISTENT_SETTINGS_JSON_W, json.dumps(persistent_settings))
 
 
 """
@@ -330,6 +336,7 @@ Export S/MIME certificate from users store
 :param public: Export public certificate part
 """
 def export_smime(user, location=None, public=None):
+
     if location:
         backup_location = location
     else:
@@ -364,6 +371,9 @@ Import S/MIME certificate into users store
 :param public: Import public certificate part
 """
 def import_smime(user, cert_file, passwd, ask_password=None, public=None):
+    if not sys.modules.get('OpenSSL'):
+        print('PyOpenSSl not installed \npip3 install pyOpenSSL')
+        sys.exit(1)
     if ask_password:
         passwd = getpass.getpass()
     elif not passwd:
@@ -447,11 +457,21 @@ Inject webapp settings into the users store
 :param user: The user
 :param data: The webapp setting
 """
-def advanced_inject(user, data):
+def advanced_inject(user, data, value_type='string'):
+    if not sys.modules.get('dotty_dict'):
+        print('dotty_dict not found on your system. \nRun pip3 install dotty_dict')
+        sys.exit(1)
     settings = read_settings(user)
     split_data = data.split('=')
 
     value = split_data[1].lstrip().rstrip()
+    if value.lower() == 'true': 
+        value = True
+    elif value.lower() == 'false':
+        value = False
+    if value_type == 'list':
+        value = value.split(',')
+
     dot = dotty()
     dot[split_data[0].rstrip()] = value
 
@@ -469,14 +489,15 @@ def main():
         opt_args(True)
     options, args = opt_args()
 
-    # Always first!
     # If the script should execute for all users
     # The admin should pass the '--all-users' parameter
     if not options.users and not options.all_users:
         print('There are no users specified. Use "--all-users" to run for all users')
         sys.exit(1)
 
-    for user in kopano.Server(options).users(options.users):
+    server = kopano.Server(options)
+
+    for user in server.users(options.users):
         # Backup and restore
         if options.backup:
             backup(user, options.location)
@@ -489,7 +510,7 @@ def main():
 
         #Categories
         if options.export_categories:
-            export_categories(user, options.change_locale)
+            export_categories(user, options.file)
         if options.import_categories:
             import_categories(user, options.file)
         # S/MIME import/export
@@ -534,7 +555,7 @@ def main():
                 sys.exit(1)
             setting = 'settings.zarafa.v1.main.active_iconset = {}'.format(options.icons)
             advanced_inject(user, setting)
-            print('icon set changed to {}'.format(options.icons))
+            print('Icon set changed to {}'.format(options.icons))
 
         # Editor
         if options.htmleditor:
@@ -546,6 +567,32 @@ def main():
             advanced_inject(user, setting)
             print('Editor changed to {}'.format(options.htmleditor))
 
+        # State settings
+        if options.remove_state:
+           settings = read_settings(user)
+           settings['settings']['zarafa']['v1']['state'] = {}
+           write_settings(user, json.dumps(settings))
+           print('Removed state settings for {}'.format(user.name))
+
+	    # Add sender to safe sender list
+        if options.addsender:
+           settings = read_settings(user)
+           setting = 'settings.zarafa.v1.contexts.mail.safe_senders_list = {}'.format(options.addsender)
+           advanced_inject(user, setting, 'list')
+           print('{}'.format(options.addsender), 'Added to safe sender list')
+
+        # Polling interval
+        if options.pollinginterval:
+            try:
+                value = int(options.pollinginterval)
+            except ValueError:
+                print('Invalid number used. Please specify the value in seconds')
+                sys.exit(1)
+            settings = read_settings(user)
+            setting = 'settings.zarafa.v1.main.reminder.polling_interval = {}'.format(options.pollinginterval)
+            advanced_inject(user, setting)
+            print('Polling interval changed to', '{}'.format(options.pollinginterval))
+
         # Always at last!!!
         if options.reset:
             reset_settings(user)