2017 © Pedro Peláez
 

module yii2-itam-module

ITAM - IT Asset Manager module for Yii 2.

image

marqu3s/yii2-itam-module

ITAM - IT Asset Manager module for Yii 2.

  • Monday, August 14, 2017
  • by marqu3s
  • Repository
  • 1 Watchers
  • 0 Stars
  • 69 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 1 Versions
  • 19 % Grown

The README.md

yii2-itam-module

ITAM - IT Asset Manager module for Yii2., (*1)

To use this module you must install it on an Yii2 application. If you don't have one, checkout this one., (*2)

Description

The purpose of this module is to allow IT administrators to manage IT assets. Both hardware and software assets are supported. There is also a monitoring module to help monitor important assets like servers and switches., (*3)

The following hardware assets are currently supported:, (*4)

  • Servers
  • Smartphones
  • Switches
  • Workstations

The following software assets and its licenses are currently supported:, (*5)

  • OS - Operational Systems
  • Office Suites
  • Other Softwares

Reports are available to help the IT manager control licenses usage., (*6)

Instalation

Web Application

The prefered method to install is using composer., (*7)

composer require "marqu3s/yii2-itam-module:dev-master"

You can simply add this to require section your composer.json file:, (*8)

"marqu3s/yii2-itam-module": "dev-master"

Then add this to your web application main.php config file:, (*9)

'modules' => [
    'itam' => [
        'class' => 'marqu3s\itam\Module',
        'rbacAuthorization' => true,
        'nmapPath' => '/usr/bin/'   // Set this to the path of the nmap executable on your system.
    ],
],

NOTE: It's a good idea to initialy set rbacAuthorization to false so you can acess the admin setup page and create the authorization stuff. Then enable the rbacAuthorization setting it to true., (*10)

Console Application (Monitoring)

To use the monitoring console commands, add this to your console application main.php config file:, (*11)

'controllerMap' => [
    'itam-monitoring' => [
        'class' => 'marqu3s\itam\console\controllers\MonitoringController',
        'nmapPath' => '/usr/bin/',
        'pushbulletAPIKey' => '',
        'pushbulletChannelTag' => '',
        'pushoverUserKey' => '',
        'pushoverAPIKey' => '',
    ],
],

Notifications about assets going down or up are currently sent thru Pushbullet or Pushover. Everybody are welcome to add other notification providers and enhance this module., (*12)

Future Enhancements

  • Dashboard should show only asset types counts that contains at least one asset.
  • Better setup wizard (mainly the creation of tables in DB and some setup instructions)
  • New types of assets
    • Wi-Fi APs
    • IP Cameras
    • Projectors
    • Printers
    • WAN Links

The Versions