/LoanShark

Easy to use loan management tool with authentication using Jamf Pro's APIs and passphrase authentication for use without Jamf Pro

Primary LanguageSwiftGNU General Public License v3.0GPL-3.0

Swift 5.0 macOS 10.12 macOS 10.13 macOS 10.14 macOS 10.15 macOS Dark Mode

License: GPL v3 Current LoanShark Version

LoanSharkLoanShark

LoanShark's goal is to provide a simple, yet effective management to your loaner fleet.
This utility allows you to:

  • Lockout users after loaning period expires
  • Provide custom loaning durations
  • Enable users to remotely request loaning extensions

This currently supports Jamf Pro's interface for the Authentication piece.

In Action

Notifications

LoanShark has built in support to send notifications to the end user, is displays a notification like the ones below.

Notification - Not Configured Notification - Active Notification - Warning Notification - Critical

Jamf Pro Authentication

LoanShark uses Jamf Pro's API to provide a layer of security to authenticate users who are allowed to manage loaner devices.

Authentication - Jamf Pro Authentication - Jamf Pro - Filled

Shared Secret Authentication

LoanShark also allows the ability to use a passphrase, also known as a shared secret, to authenticate users who are allowed to manage loaner devices. Authentication - SharedSecret Authentication - SharedSecret - Filled

Life Cycle

LoanShark has a complete loaning lifecycle which includes custom duration, tech information, loanee information, extension requests, extensions, and expirations.

Configuration

After authenticating using Jamf Pro, or a Shared Secret; the loaner is then able to be configured. Configuration Screen Configuration Screen - Filled

Extension Request

When a loaner is about to expire, the user is provided a notification that asks if they want to extend the loaner. This will open the below window. Once submitted, it will open an email going to the person who deployed the loaner. Extension - Request Extension - Request - Filled

Extension - Authorized User

When an extension to a loaning period is recieved and approved to be performed; the user who is performing the extension can n avigate from the menu bar --> Admin --> Extend. The user will then be prompted to authenticate using Jamf Pro, or entering a Shared Secret. They will then see the below window. Extension Extension - Filled

Lockout & Logoff

When the loaning period expires, the user will then be locked out from being able to use the computer, and be forced to log off. Lockout

Automatic Email Extension Requests

LoanShark includes built in support to automatically open default mail client and send email to the tech who assigned the loaner

Loaner Extension Request - Auto Email

Agent Menu

LoanShark also has an agent menu that provides valuable information and actions in a quick manner. Agent Menu - Configured Agent Menu - Not Configured

Quick Start

The best way to start is the Kickstart Guide.

Release History

The release history is available here.

LoanShark was made possible thanks to the work for the following individuals.

Getting Help

The best place to discuss LoanShark is to join the #loanshark channel on the MacAdmins Slack.

Contributing

I cybertunnel have been working on this project for over a year for the company I currently work for. I have spent these past few months making it more stable and esuring the availability for general use.

Please feel free to fork and contribute.