#############
Support Users
#############


.. raw:: html

	<p>This page explains how to create support users that will be responsible for providing the technical support for a single installation of 4PointX. Applies to both 4PointX Cloud and 4PointX Self-Managed deployments.</p>

.. raw:: html

	<p>There are two type of support roles. These roles come created by default. We just need to create users.</p>

.. list-table::
	:header-rows: 1

	* - Support Role
	  - Access
	* - support-admin
	  - read-write access to all sites, plants etc. including index patterns (create/delete), gateways, users etc.
	* - support-analyst
	  - read-only access. Cannot edit/change/create anything


**********************************
Steps to create support users (UI)
**********************************

.. raw:: html

	<p>Note: Unlike regular users that are created using the User Management module, support users are created as Internal Users using the Security module.</p>

#. Go to the Security section, then click on Internal Users. Afterward, select Create Internal User.
#. Enter Username and Password.
#. Assign the Backend role either support-admin or support-analyst.
#. Include an attribute labeled as user_type. Set the Variable name as user_type and assign its value as eithersupport-admin or support-analyst.



.. raw:: html

	<img src='/docs/_static/media/image-20231129-110804.png'>

#. This step is required for support-admin role only. Map the security_rest_api_access role so that when they create Plant they will be able to create Tenant also (automatically in background):
	#. Navigate to the 'Security' section and select 'Roles.'
	#. Search for security_rest_api_access within the Roles.
	#. Go to 'Mapped Users' for this role, and then proceed to 'Manage Mapping.'
	#. Add the respective user to the 'Users' list.
		.. raw:: html
		
			<img src='/docs/_static/media/image-20231213-032713.png'>
		
	
	
	



************************************
Create support users using Dev Tools
************************************

.. code-block:: json

	PUT _plugins/_security/api/internalusers/support@example.com
	{
	  "password": "support@123",
	  "backend_roles": ["support-analyst"],
	  "attributes": {
	    "user_type": "support-analyst"
	  }
	}



Repeat Step No. 5 for support-admin user.
-----------------------------------------

.. toctree::