Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jautomate-0.0.23.tar.gz (15.1 kB view details)

Uploaded Source

Built Distribution

jautomate-0.0.23-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

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

Hashes for jautomate-0.0.23.tar.gz
Algorithm Hash digest
SHA256 e0daefc18219d544aaa3456b51f40e09b438d6717361f814afeb57b6b8a156f2
MD5 053ade8e898a5bf0ece705fc800b972a
BLAKE2b-256 b5506434f28960080d1889dc0697a97be3a8b4e84d1814a28e54ea00b4c5b395

See more details on using hashes here.

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

Hashes for jautomate-0.0.23-py3-none-any.whl
Algorithm Hash digest
SHA256 f8c76685357b2ac6ea622cb2272d70ca68afe2cc355f941ab22530790d24b784
MD5 245c374aa0caaa6e9fe540e8736c4c58
BLAKE2b-256 8e11d70ad8fd1f9cb68e66945db8aa019ded6ba1adf2c3660444ec150561076a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page