How to filter the number of users by using integration scripts

Issue

"WARNING: License is invalid for this server"

Environment

• Imunify360 - Stand-alone

Solution

In Imunify360 Stand-alone, it's possible to use the integration scripts to filter the users Imunify360 may consider and count for licensing. Imunify360 accepts JSON inputs with a list of users, admins, and domains through the integration_scripts routines. Find attached the script that might be used for this scenario.

SHA256/CHECKSUM:

181c48fbd7ec23a259eea1a7731e367d07c1b7dd8ae3ecd80eea7c2f928e4173  integration-script.tar.gz - [ Download ]

1. Unpack the scripts into /etc/sysconfig/imunify360:

# tar -xvzf integration-script.tar.gz -C /etc/sysconfig/imunify360

2. Set permission:

# chmod +x /etc/sysconfig/imunify360/get-*-script.sh

3. Append into the /etc/sysconfig/imunify360/integration.conf the following entries:

[integration_scripts]
admins = /etc/sysconfig/imunify360/get-admins-script.sh
users = /etc/sysconfig/imunify360/get-users-script.sh
domains = /etc/sysconfig/imunify360/get-domains-script.sh

How does it work

• get-admins-script.sh
  Generates the list of admin users. It looks in the /etc/sysconfig/imunify360/admins.txt and parses it out into JSON. It uses ":" as a delimiter and must be in the following format:
  username:email
• get-users-script.sh
  Generates the list of normal users. It looks in the /etc/sysconfig/imunify360/users.txt and parses it out into JSON. It uses ":" as a delimiter and must be in the following format:
  username:uid:domain:email
• get-domains-script.sh
  Generates the list of domains. It looks in the /etc/sysconfig/imunify360/domains.txt and parser it out into JSON. It uses ":" as a delimiter and must be in the following format:
  username:domain:documentroot

Cause

Imunify360 by default picks up the users from the Linux auth-system with UID/GID limited by uid_min and uid_max from the /etc/login.defs.

Useful Links

Documentation

• https://docs.imunify360.com/control_panel_integration/#_4-1-define-list-of-administrators-for-imunify360
• https://docs.imunify360.com/control_panel_integration/#use-a-specific-list-of-users-in-imunify360

Video instructions

• Standalone Mode on CentOS with Apache
• Standalone Mode on CentOS with Nginx