Least permissions
11 minute read
Ansible Tower
For OneFuse Ansible Tower Modules.
- Create or determine the Service Account for the OneFuse Ansible Tower Module.
- Log in to Ansible Tower as an Administrator.
- Go to Access > Users.
- Add the Service Account via either Local Users or LDAP User Account (do not use Social, Azure AD, or Kerberos). If the desired Service Account already exists, edit the user.
-
Under the Details section for the user, verify the following:
Setting Selection User Type Normal User -
Select Save.
-
Under the Permissions tab for the Service Account, perform the following:
Resource Selection Role Organizations Select all Organizations OneFuse will integrate with Member For granular permissions instead of at an Organizational level, set below: Projects Select all Projects OneFuse will integrate with Use Job Templates Select all Job Templates OneFuse will integrate with Execute Inventories Select all Inventories OneFuse will integrate with Inventory Admin -
Save the user.
-
BlueCat
For OneFuse BlueCat IPAM and/or DNS Modules.
- Create or determine the Service Account for the OneFuse BlueCat Module IPAM and/or DNS.
- Log in to BlueCat as an Administrator.
- Go to Administration > Users and Groups.
- Add the Service Account via either Local Users or Groups. If the desired Service Account already exists, edit the user.
-
Under User Access for a Local User, verify the following:
Setting Selection Administrator Do not check the Administrator checkbox Security Privilege No Access History Privilege Hide Access Type API -
Under General for a Group, verify the following:
Setting Selection Administrator Privilege Do not check the Administrator checkbox -
Save the user or group.
-
- Grant rights to the BlueCat Configuration:
-
Go to Administration > Configurations.
-
Select the desired Configuration from the Configuration list.
-
Scroll down to Access Rights and select New Access Right….
-
Select the Service Account Local User or Group and select Add.
-
Select the following:
Setting Selection Access Right Default Access View Default Access Quick Deployment (checked) Overrides IPv4 Objects IPv4 Address Full Access Resource Records Alias Record Full Access Host Record Full Access -
Select Add to save the Configuration’s Access Rights.
-
Infoblox
For OneFuse Infoblox IPAM and/or DNS Modules.
-
Create or determine the Service Account for the OneFuse Infoblox Module IPAM and/or DNS.
-
Log in to Infoblox UI as an Administrator.
-
Go to Administration > Administration > Groups.
-
Add a new Infoblox Admin Group:
Setting Selection Step 1 of 8 - Allow access from Allow access from Any Step 5 of 8 - Roles Allowed Interfaces API (required); GUI (recommended for troubleshooting); Cloud API only (No PAPI) -
Save the new Infoblox Admin Group.
-
Select the Permissions tab.
-
Select + to Create a New Permission.
-
Select the Infoblox Group from Step 4 from the dropdown for Group Permission.
-
Select the following from the Permission Type dropdown and check the specified permissions:
IPAM permissions (Infoblox IPAM OneFuse Module):
Resource/Functions Read/Write Read-Only All Network Views Yes All Hosts Yes DHCP permissions (Infoblox IPAM OneFuse Module):
Resource/Functions Read/Write Read-Only All Network Views Yes All Hosts Yes All IPv4 DHCP Fixed Addresses/Reservations Yes DNS permissions (Infoblox DNS OneFuse Module):
Resource/Functions Read/Write Read-Only All DNS Views Yes All Hosts Yes All A Records Yes All PTR Records Yes Grid permissions (only for using Infoblox with Microsoft DHCP Ranges):
Resource/Functions Read/Write Read-Only All Microsoft Servers Yes -
Select Save & Close to save the Permissions.
-
-
Add or verify that the Service Account is in the Infoblox Admin Group.
Men&Mice Micetro
For OneFuse Men&Mice Micetro IPAM and/or DNS Modules.
- Create or determine the Service Account for the OneFuse Men&Mice Micetro Module IPAM and/or DNS.
- Log in to Men&Mice Micetro Management Console as an Administrator.
- Go to Tools > User Management > Roles.
- Select Add to add a new Role.
- Provide a Name (for example,
OneFuse_WebAccess) and optional Description. - Select OK.
- Provide a Name (for example,
- Select Tools > Global Access.
- Under Group, role or user names, select Add and add the Role created in Step 4.
- Under Permissions for <Role Name>, select the following:
- Access to the web interface (checked)
- Select OK to save.
- Add the Service Account to either Users or Groups. If the desired Service Account already exists, edit the user.
- Under Roles, select the following:
- The Role created in Step 4 (checked)
- DNS Administrators (built-in): for the Men&Mice Micetro DNS OneFuse Module
- IPAM Administrators (built-in): for the Men&Mice Micetro IPAM OneFuse Module
- Select OK to save.
- Under Roles, select the following:
Microsoft
For the following OneFuse Microsoft Module(s): Active Directory, DNS, and IPAM.
- Verify Windows NTP is set up correctly.
- Create or determine the Service Account for the OneFuse Microsoft Module(s) Active Directory, DNS, and/or IPAM.
Jump server
Perform the following if utilizing an OpenSSH Jump Server to the target AD/DNS and/or IPAM server.
- Install and configure OpenSSH on the Jump Server.
- Verify Firewall rules are open between the Jump Server and OneFuse Appliance(s).
Perform the following on all Windows Jump Server(s):
RSAT (Remote Server Administration Tools):
Resource: Remote Server Administration Tools
-
Log in to the Jump Server as an Administrator.
-
Open Server Manager and select Manage > Add Roles and Features.
-
Accept defaults and select Next until the Server Selection tab.
-
Select the desired server from the list in Server Selection and select Next.
-
Accept defaults and select Next for Server Roles.
-
In the Features tab, scroll down and select Remote Server Administration Tools:
Module Role(s) Active Directory Role Administration Tools: AD DS and AD LDS Tools DNS Role Administration Tools: DNS Server Tools IPAM Feature Administration Tools: IP Address Management (IPAM) Client -
Select Next.
-
Optionally have the server restarted, or leave the option unchecked and select Install.
-
Select Close.
-
Once installation completes, select Tools on the top-right menu of the Server Manager. Verify the following is listed:
- Active Directory: Active Directory Users and Computers
- DNS: DNS
Local temporary folder permissions:
- Create a folder for storing OneFuse PowerShell Scripts (for example,
C:\OneFuse). - Add the Service Account to the Group or user names for the Temporary Folder with the following Allow permissions:
- Modify
- Read & execute
- List folder contents
- Read
Permission to run remote PowerShell scripts:
-
Log in to the Jump Server as an Administrator.
-
Open PowerShell.
-
Run the following command and confirm when prompted.
This action could have a serious impact on your system and will enable other users/groups to run commands on the server.
Set-PSSessionConfiguration -Name Microsoft.PowerShell -showSecurityDescriptorUI -
Add the Service Account to Select Users, Computers, Service Accounts, or Groups with the following Allow permissions:
- Full Control (All Operations)
-
Select OK and then confirm Yes to apply the change.
Set WMI Control settings:
- Log in to the Jump Server as an Administrator.
- From the Computer Management console, expand Service and Applications.
- Right-click on WMI Control and select Properties.
- Select the Security tab.
- Expand the Root folder and select CIMV2, then select the [Security] button.
- Add the Service Account to the Groups or user names.
- Select the Service Account and select Advanced next to “For special permissions or advanced settings”.
- On the Permissions tab, select the desired user in Permissions entries and select Edit.
- Select the following permissions:
- TYPE: Allow
- APPLIES TO: This namespace and subnamespaces
- PERMISSIONS: Execute Methods, Enable Account, Remote Enable
- Select OK to apply the changes.
Add the IPAM server to the Jump Server’s server pool:
Perform if using this Jump Server for the Microsoft IPAM OneFuse Module.
- Log in to the Jump Server as an Administrator.
- Open Server Manager and right-click on All Servers, then select Add Servers.
- In the Add Servers wizard, enter the IPAM Server Name and select Find Now.
- Highlight the server name, select the arrow in the center to add it to the list, and select OK.
- The IPAM server will appear in the list of servers.
- Repeat for each IPAM server.
Active Directory
Perform the following on all Windows servers for Microsoft Active Directory to enable creating, moving (optional), and deleting Computer Objects; creating and deleting OUs; and adding Computer Objects to Security Groups.
Source: Delegating Administration by Using OU Objects
Service:
- Verify Active Directory Web Services (ADWS) is installed. For Windows Server 2012 and newer, ADWS is pre-installed.
- Recommended: Configure ADWS to start automatically on all servers.
Computer Object delegation rights:
The following need to be applied to each top-level OU as required; child OUs will have the permissions applied automatically.
Delegate the following permissions to the Service Account on the appropriate OU to create/delete (and move) Computer Objects.
- Create a Custom Task to delegate only on Computer Objects.
- Select the following permissions for Create selected objects in this folder and Delete selected objects in this folder:
- Read all properties
- Create all child objects
- Delete all child objects
- If planning on building computers into a Build OU, add the following permissions:
- Read
- Write
OU Object security rights:
The following need to be applied to each top-level OU as required; child OUs will have the permissions applied automatically.
Delegate the following permissions to the Service Account on the appropriate OU to create/delete OUs within the specified OU.
- In the Properties of the OU, go to Security > Advanced and select Add New Permissions.
- Select the desired Service Account and add the following:
- TYPE: Allow; APPLIES TO: This object and all descendant objects; PERMISSIONS: List Contents, Read all properties, Write all properties, Read permissions, Create Organization Unit objects, Delete Organization Unit objects
- TYPE: Allow; APPLIES TO: Descendant Organizational Unit objects; PERMISSIONS: List Contents, Read all properties, Write all properties, Read permissions, Delete, Create Organization Unit objects, Delete Organization Unit objects
AD Security Group permission set:
The following delegation depends on whether it is to an OU or a Group(s).
Delegate the following permissions to the Service Account on the appropriate OU to place Computer Accounts into Security Group(s):
- Modify the membership of a Group
DNS
Perform the following on all Forward and/or Reverse DNS Zones on Windows servers for Microsoft DNS.
Configure Read-Access permissions to the top DNS server layer:
- In the DNS Manager window, right-click and select Properties of the DNS server.
- Add the Service Account with the following permissions:
- Read
Configure Forward Lookup Zone(s):
Perform the following if registering/removing A records.
- In the DNS Manager window, right-click on the Forward Zone where records are being registered.
- In the Security tab, add the Service Account to the users list.
- Select Advanced to verify the following permissions:
- TYPE: Allow
- APPLIES TO: This object and all descendant objects
- PERMISSIONS: List Contents, Read all properties, Write all properties, Delete, Delete subtree, Read permissions, Modify permissions, Modify owner, All validated writes, Create all child objects, Delete all child objects
- All Properties should be selected/checked.
Configure Reverse Lookup Zone(s):
Perform the following if registering/removing PTR records.
- In the DNS Manager window, right-click on the Reverse Lookup Zone where records are being registered.
- In the Security tab, add the Service Account to the users list.
- Select Advanced to verify the following permissions:
- TYPE: Allow
- APPLIES TO: This object and all descendant objects
- PERMISSIONS: List Contents, Read all properties, Write all properties, Delete, Delete subtree, Read permissions, Modify permissions, Modify owner, All validated writes, Create all child objects, Delete all child objects
- All Properties should be selected/checked.
IPAM
Perform the following on all Windows servers for Microsoft IPAM.
Services:
- Verify IPAM client is installed:
- Server Manager > Manage > Add Roles and Features.
- Accept defaults and select Next until the Features option.
- Expand Remote Server Administration Tools > expand Feature Administration Tools.
- Select IP Address Management (IPAM) Client.
- Confirm and select Install.
- Enable non-local administrators to run IPAM cmdlets in PowerShell (see Microsoft’s IPAM documentation).
Run IPAM PowerShell cmdlets:
- Follow Microsoft’s instructions for enabling non-local administrators to run IPAM cmdlets in PowerShell.
Service Account in Remote Management Users:
- Verify the Service Account is part of the following built-in Windows Group to allow remote connectivity:
- Remote Management Users
Microsoft IPAM Roles:
-
Verify the Service Account has the following Built-in Roles in Microsoft IPAM:
- IP Address Record Administrator Role, or a custom role with: Create IP address, Edit IP address, Delete IP address
- DNS Record Administrator Role, or a custom role with: Create DNS resource records, Delete DNS resource records
Source: View Roles and Role Permissions
ServiceNow
For OneFuse ServiceNow CMDB Module and/or OneFuse ServiceNow Connector.
-
Create or determine the Service Account for the OneFuse ServiceNow CMDB Module and/or ServiceNow Connector.
-
Log in to ServiceNow as an Administrator.
-
Go to User Administration > Users.
-
Add the Service Account to Users and select Submit.
-
Once the desired Service Account exists, edit the user.
-
Select the Roles tab and add/verify the following Roles:
OneFuse Module OneFuse purpose Role(s) ServiceNow Connector Specific MID Server Account mid_serverServiceNow Connector OneFuse Service Account x_sovla_onefuse.admin;mid_serveronly if this account will also be used as the MID Server accountServiceNow CMDB OneFuse Service Account asset(to add and update records);itil(to utilize the ServiceNow IRE API);web_service_admin(to utilize the ServiceNow API) -
Select Update to save.
SolarWinds
For OneFuse SolarWinds IPAM Module.
-
Create or determine the Service Account for the OneFuse SolarWinds Module IPAM.
-
Log in to SolarWinds Orion as an Admin.
-
Go to Admin > Accounts > Manage Accounts.
-
Add the Service Account to either Individual Accounts, Windows Groups, or SAML Groups. If the desired Service Account already exists, edit the user.
-
Under Default Summary View, select to expand IP Address Manager Settings and verify the following:
Setting Selection IPAM Summary View IP Address Manager IPAM Address Details View IPAM IP Address Details - IP Address Details IPAM DHCP Server View DHCP Server Details IPAM Roles & Permissions Power User: read/write access and can initiate scans to all subnets. Full access to DHCP and DNS management. -
Select Submit to save.
SolarWinds 4.9 requires FULL admin rights (not only Admin for IP Address Manager Settings). SolarWinds is tracking this bug under reference IPAM-2651.
VMware Aria Automation
For OneFuse VMware Aria Automation Module.
- For VMware Aria Automation 8x/Cloud, refer to the VMware Aria Automation installation and setup section to create the OneFuse Service Account or API Token.
- For VMware vRealize Automation 7.6, refer to the VMware vRealize Automation 7.6 installation and setup section to create the OneFuse Service Account.