Fortinet black logo

Administration Guide

Overview

Copy Link
Copy Doc ID 51ead988-9e80-11eb-b70b-00505692583a:249178
Download PDF

Overview

Use the administration guide to understand how to customize and administer FortiSOAR, including system, security and user management, and configuring templates.

Note

When you log on to FortiSOAR for the first time as a csadmin user, you will be mandated to change your password. This enhances the security of your csadmin account and prevents unauthorized parties from accessing the administration account for FortiSOAR. Ensure that you note down your csadmin password since if you forget your initial csadmin password, then you have to request FortiSOAR to reset this password. Also, when you are changing your csadmin password, you must ensure that you also update the email ID that is specified for csadmin, which by default is set to soc@fortinet.com (which is not a valid email ID). You can change the email ID by clicking the User Profile icon (User Profile icon) to open the User Profile page and change the email address in the Email field. Once you set a valid email ID in the user profile, then you would be able to reset your password, whenever required, by clicking the Forgot Password link on the login page.

Also, note that from version 7.0.0 onwards, if you want to move any file from and to a FortiSOAR system, then you must install SCP (yum install openssh-clients -y) or any SCP client. This is required since the openssh-clients package has been removed from FortiSOAR for security compliance.

Common Tasks

Some of the common task that an administrator can perform are:

  • License management
  • System configuration
  • Security management
  • User management
  • Appliance management
  • Password Vault management
  • Playbook configuration
  • Application management

You can perform administration tasks using the Settings (Settings icon) icon in the upper right-hand corner near the User Profile icon.

Tasks and Permissions

To manage different modules, appropriate rights must be assigned to users. In FortiSOAR, modules are applied to roles, for example, the Security module is applied to the Security Administrator role. Role permissions are based on the Create, Read, Update, and Delete model (CRUD). Each module within FortiSOAR has explicit CRUD permissions that you can modify and save within a single Role.

For example, to perform all tasks for system configuration, you must be assigned a role that has CRUD permissions on the Application module, or to be able to add and manage users, you must be assigned a role that at the minimum has Create and Update permissions on the People module.

By default, FortiSOAR has at least one role in place after installation, the Security Administrator.

Task Permissions required on the module
System configuration: Customizing FortiSOAR and configure several default options used throughout the system, including setting up authentication mechanisms and configuring dashboards and templates. Create, Read, Update, and Delete (CRUD) permissions on Application module. Default Role - Application Administrator.
Security management: Managing teams and roles. CRUD permissions on Security module. Default Role - Security Administrator. The security administrator role also has CRUD permissions on the Secure Message Exchange and Tenants modules, so that this role can configure multi-tenant systems.
User management: Adding and removing users and editing their permissions. CRUD permissions on People module.
Appliances management: Configuring data models, including picklist values and system navigation. CRUD permissions on Appliances module.
Password Vault management: Integrating with third-party external vaults to manage sensitive data CRUD permissions on Connectors module and Read permission on Application module.
Playbook management: Configuring playbook collections and playbooks CRUD permissions on Playbook module. Default Role - Playbook Administrator.

Overview

Use the administration guide to understand how to customize and administer FortiSOAR, including system, security and user management, and configuring templates.

Note

When you log on to FortiSOAR for the first time as a csadmin user, you will be mandated to change your password. This enhances the security of your csadmin account and prevents unauthorized parties from accessing the administration account for FortiSOAR. Ensure that you note down your csadmin password since if you forget your initial csadmin password, then you have to request FortiSOAR to reset this password. Also, when you are changing your csadmin password, you must ensure that you also update the email ID that is specified for csadmin, which by default is set to soc@fortinet.com (which is not a valid email ID). You can change the email ID by clicking the User Profile icon (User Profile icon) to open the User Profile page and change the email address in the Email field. Once you set a valid email ID in the user profile, then you would be able to reset your password, whenever required, by clicking the Forgot Password link on the login page.

Also, note that from version 7.0.0 onwards, if you want to move any file from and to a FortiSOAR system, then you must install SCP (yum install openssh-clients -y) or any SCP client. This is required since the openssh-clients package has been removed from FortiSOAR for security compliance.

Common Tasks

Some of the common task that an administrator can perform are:

  • License management
  • System configuration
  • Security management
  • User management
  • Appliance management
  • Password Vault management
  • Playbook configuration
  • Application management

You can perform administration tasks using the Settings (Settings icon) icon in the upper right-hand corner near the User Profile icon.

Tasks and Permissions

To manage different modules, appropriate rights must be assigned to users. In FortiSOAR, modules are applied to roles, for example, the Security module is applied to the Security Administrator role. Role permissions are based on the Create, Read, Update, and Delete model (CRUD). Each module within FortiSOAR has explicit CRUD permissions that you can modify and save within a single Role.

For example, to perform all tasks for system configuration, you must be assigned a role that has CRUD permissions on the Application module, or to be able to add and manage users, you must be assigned a role that at the minimum has Create and Update permissions on the People module.

By default, FortiSOAR has at least one role in place after installation, the Security Administrator.

Task Permissions required on the module
System configuration: Customizing FortiSOAR and configure several default options used throughout the system, including setting up authentication mechanisms and configuring dashboards and templates. Create, Read, Update, and Delete (CRUD) permissions on Application module. Default Role - Application Administrator.
Security management: Managing teams and roles. CRUD permissions on Security module. Default Role - Security Administrator. The security administrator role also has CRUD permissions on the Secure Message Exchange and Tenants modules, so that this role can configure multi-tenant systems.
User management: Adding and removing users and editing their permissions. CRUD permissions on People module.
Appliances management: Configuring data models, including picklist values and system navigation. CRUD permissions on Appliances module.
Password Vault management: Integrating with third-party external vaults to manage sensitive data CRUD permissions on Connectors module and Read permission on Application module.
Playbook management: Configuring playbook collections and playbooks CRUD permissions on Playbook module. Default Role - Playbook Administrator.