Skip to content
Windows agent for Snipe-IT asset management system
C#
Branch: master
Clone or download

Latest commit

danielhogg Merge pull request #31 from mrcencig/patch-1
Fixed the MAC Address creation issue
Latest commit 9bd36b8 Feb 20, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Properties initial version Jul 2, 2018
.gitattributes initial version Jul 2, 2018
.gitignore added DefaultStatusLabel field to config, finalized v1.0.1 Nov 27, 2018
App.config reset default values Jul 12, 2019
Broker.cs partially fixed Assignment API issue Jul 7, 2019
LICENSE Update LICENSE Nov 13, 2019
Marksman.cs Fixed the MAC Address creation issue Feb 14, 2020
README.md Added 'Developer Guide' section to README Dec 7, 2019
marksman.csproj starting to implement update process Jun 28, 2019
marksman.sln

README.md

Marksman - A Windows agent for Snipe-IT

Installation

  1. Download and install the latest .msi installer from the releases tab.
  2. By default, the program will be installed in Program Files (x86)/Scope-IT/Marksman. Edit the Marksman.exe.config file to include your API key and BaseURI from the default values to the ones given by your Snipe-IT instance.
  3. Set the Company and Location parameters in Marksman.exe.config, then run the .exe.

Features

  • The agent creates an asset and fills out the fields:
    • Asset name (currently machine hostname, unless agent is run in interactive mode)
    • Asset id (Asset tag prefix + serial number)
    • Location (from a config file or the Organizational Unit)
    • Warranty (from config file)
    • Status label (from config file)
    • Mac address
    • Make, model of the machine (as reported to Windows)
  • Ensures that the assets created is unique
  • New locations, makes, models are created as needed

Getting started

You will need a working Snipe-IT database with API access and an API key. We recommend creating a separate user for the agent with minimal (read + add) permissions.

You can run it via a GPO or Scheduled task (recommended way is to run the agent once on boot with a delay of 1+ minute)

Developer Guide

If you want to not only use Marksman.exe, but edit the sources and build the project, here are some steps for getting started. Marksman has a dependency on our specific fork of SnipeSharp, so you will need to build it as well.

  1. Create a development folder. Inside this folder, clone the following repos:
  2. Open the SnipeSharp project .sln, and build the solution.
  3. Open the marksman project. Check the 'references' under the marksman project, and see if SnipeSharp has been added automatically. Make sure that the path of the SnipeSharp reference points to the repository you just built. If a reference does not exist, you may need to add it manually.
  4. Build the marksman project. It should build correctly - if there are any errors at this stage please file a bug report.
  5. You can now proceed to edit the config file so that your API key and BaseURI correspond to your Snipe-IT instance. Once the config file is set, the program can be run.

Bug Reports & Feature Requests

We welcome community participation in this project. Please submit an issue or pull request to participate in the development.

License

This project is licensed under the Apache 2.0 License

Planned features

  • Component lookup (automatic tracking of connected hard drives, CPU, GPU, etc.)
  • Automatic update feature (tracking of computer name and other property changes)
  • Additional query types for location
  • Warranty lookup APIs
  • Cross-platform (Windows/MacOS/Linux) agent using Mono

Acknowledgments

You can’t perform that action at this time.