README.md

Admin group manager

Manage routines associates to admin groups

Available features:

• Create admin group setting the default group quota and enabled apps

Setup

• Clone this repo at your app folder

• Run the follow commands:

   composer install --no-dev
   npm ci
   npm run build
   occ app:enable admin_group_manager
   occ app:enable groupquota

• Allowed IP

  By security, this API only receive requests from a specific IP.

  • Run a tail with grep to watch by the word "Unauthorized access".

     tail -f data/nextcloud.log|grep "Unauthorized access"

  • Do a request to API endpoint and go back to terminal to check the logs and get the IP.
  • With the IP, run the follow command:

     occ config:system:set admin_group_manager_allowed_ip --value <theIdentifiedIp>

Performance improving

Systemd service

• Create a systemd service file in /etc/systemd/system/admin-group-manager.service with the following content:

   [Unit]
   Description=Admin Group Manager worker
   After=network.target
  
   [Service]
   ExecStart=/opt/admin-group-manager/taskprocessing.sh
   Restart=always
  
   [Install]
   WantedBy=multi-user.target

• Create a shell script in /opt/admin-group-manager/taskprocessing.sh with the following content and make sure to make it executable:

   #!/bin/sh
   echo "Starting Admin Group Manager worker $1"
   cd /path/to/nextcloud
   sudo -u www-data php occ background-job:worker 'OCA\AdminGroupManager\BackgroundJob\EnableAppsForGroup'

• Enable and start the service:

  systemctl enable --now admin-group-manager.service

• Check if is working fine:

   systemctl list-units --type=service | grep admin-group-manager

• Check execution log:

   journalctl -xeu nextcloud-ai-worker.service -f

How to use

Check the available endpoints installing the app ocs_api_viewer and going to Nextcloud web interface at ocs_api_viewer app to verify the endpoints of this app.