MDMTools

DEP Tool

This Django project provides a custom webapp interface to micromd service (https://github.com/micromdm/micromdm). It handles adding and removing records in .json record file, applying configuration and generally running a couple of defined commands.

This project is still under development and not everything works

!!!Sorry for all mistakes done in codes, this was mostly my training project !!! Please feel free to rewrite in any aspects.

Requirements

Linux host (preffered)
Python 3.0+ and its Django library
Micromdm json located in /home/youraccount/DEP-Config/DEP-Profile.json
Database file located in /var/db/deptool/database.sqllite3

Setting up

Important : check in all location for YOURDOMAIN text and replace with your, before you start :

rename all within a code "youraccount" or filw's name in project to your username view.py HTML in DEP/templates/.html Scripts/.sh

/home/youraccount/DEP_tool/upload/ = you can use your on path just make changes in code.

Clone the DEP_tool Git repository:
```
$ cd DEP_tool
```
Make sure you have .json record file in /home/youraccount/DEP-Config/DEP-Profile.json.
Create a Python virtual environment for DEP_tool.
```
$ python3 -m venv venv
```

Install Django library.

$ source venv/bin/activate
$ pip3 install django

Create database. Make sure path /var/db/deptool exists.

$ python3 manage.py makemigrations
$ python3 manage.py migrate

You should be able to run the tool.

$ python3 manage.py runserver 0.0.0.0:8080

If you need to deploy it on Apache server you can follow:
- https://www.digitalocean.com/community/tutorials/how-to-serve-django-applications-with-apache-and-mod_wsgi-on-ubuntu-16-04
- https://www.digitalocean.com/community/tutorials/how-to-create-a-self-signed-ssl-certificate-for-apache-in-ubuntu-16-04

Adding new "functionality" to main view

Currently it is implemented in way that api calls are directed to /modular url. There is an "method" POST paramd which defines method which will be run on the server. If you need to add new button running command similiar to systemctl or journactl you just need to following actions:

Add new form to DEP/templates/DEP/main.html
Add new script with path to DEP/settings.py
Add new MDM API function in DEP/views.py
Add JAVA script in DEP/static/DEP/js
Add images in DEP/static/DEP/Bootstra4/img

Permissions

There are two levels of users. If you are superuser (set in Django admin site), you can see and do everything. If you are just regular staff user (set in Django admin site), you have limited view and actions you can do.

Images:

please import your desired Images for icons and pictures , i removed all related internal stuff

Credits

Fonts: Font AweSome Montserrat Poppins

HTML Tools:

BootStrap 4 - SB Admin2 Jquery Pace Login

machinas-achim/MDMTools