Automates MDM tasks using the Jamf APIs
Project description
Jautomate
This tool automates MDM tasks on Jamf using the Jamf Pro and Jamf Classic API. For now there are only tasks focused on mobile devices. Computer versions of those tasks are in the works.
Installation
A pip installation will be set up once the build has been tested. For now you can install it from the testing PyPi server with this command:
python3 -m pip install --index-url https://test.pypi.org/simple --extra-index-url https://pypi.org/simple/ jautomate
Setup
Env Variables
You have to define the following environment variables in a .env
file to connect to your Jamf Pro server.
JPS_USERNAME=[Username]
JPS_PASSWORD=[Password]
JPS_URL=[Url]
Basic Usage
This tool runs from the command line and has basic help information built into it. To access the help functions use the command:
jautomate --help
Available Commands
Assign a device
Add student information to a device record in Jamf Pro
jautomate assign [DEVICE_TYPE] [ASSET_TAG] [SERIAL_NUMBER] [STUDENT_NAME] [HOMEROOM] [STUDENT_GRADE] [BUILDING]
Required arguments
DEVICE_TYPE | Type of device being updated. {mobile / computer} |
ASSET_TAG | Asset tag should be a 6 digit number |
SERIAL_NUMBER | Serial Number of device |
STUDENT_NAME | Student full name |
HOMEROOM | Homeroom teachers last name |
STUDENT_GRADE | Student grade as a number |
BUILDING | Building names as used in Jamf Pro |
Unassign a device
Remove student information from device record in Jamf Pro.
jautomate unassign [DEVICE_TYPE] [ASSET_TAG]
Required arguments
DEVICE_TYPE | Type of device being updated. {mobile / computer} |
ASSET_TAG | Asset tag should be a 6 digit number |
Sync multiple device records
Syncs data from a csv file of device records to Jamf Pro. Devices must all be of same type (mobile/computer.)
jautomate sync [DEVICE_TYPE] [FILE_PATH]
Required arguments
DEVICE_TYPE | Type of devices being updated. {mobile / computer} |
FILE_PATH | The path to the csv file to be imported |
Development
References for dev/testing
# Run this line from the same directory as setup.py
python -m build
# To test the build you can install/re-install with this line.
pip install dist/jautomate-0.0.7-py3-none-any.whl --force-reinstall
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file jautomate-0.0.23.tar.gz
.
File metadata
- Download URL: jautomate-0.0.23.tar.gz
- Upload date:
- Size: 15.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e0daefc18219d544aaa3456b51f40e09b438d6717361f814afeb57b6b8a156f2 |
|
MD5 | 053ade8e898a5bf0ece705fc800b972a |
|
BLAKE2b-256 | b5506434f28960080d1889dc0697a97be3a8b4e84d1814a28e54ea00b4c5b395 |
File details
Details for the file jautomate-0.0.23-py3-none-any.whl
.
File metadata
- Download URL: jautomate-0.0.23-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f8c76685357b2ac6ea622cb2272d70ca68afe2cc355f941ab22530790d24b784 |
|
MD5 | 245c374aa0caaa6e9fe540e8736c4c58 |
|
BLAKE2b-256 | 8e11d70ad8fd1f9cb68e66945db8aa019ded6ba1adf2c3660444ec150561076a |