Kaspersky Anti Targeted Attack Platform

Distributed solution and multitenancy

You can configure settings of each Central Node component individually or manage several components in a centralized way in distributed solution mode.

The distributed solution is a two-tier hierarchy of servers with Central Node components installed. This structure sets apart a primary control server known as the Primary Central Node (PCN) and secondary servers known as Secondary Central Nodes (SCN). Interaction of servers requires connecting SCN to PCN.

If you have deployed the Central Node component as a cluster, the entire cluster takes on the role of a PCN or SCN.

PCN and SCN scan files and objects using the same technology as the individually managed Central Node component.

The distributed solution allows centralized management of the following functional areas of the application:

  • Users.
  • Alerts.
  • Threat Hunting.
  • Tasks.
  • Prevention.
  • Custom rules.
  • Storage.
  • Endpoint Agents, including network isolation of hosts.
  • Reports.

If you are supporting multiple organizations or branch offices of the same organization, you can use the application in multitenancy mode.

Multitenancy mode lets you use the application to simultaneously protect the infrastructure of multiple organizations or branch offices of the same organization (hereinafter also referred to as "

"). You can install Kaspersky Anti Targeted Attack Platform on one or more Central Node for each tenant. Each tenant can manage the application independently from other tenants. The service provider can manage the data of multiple tenants.

For each user account, the number of simultaneous application management sessions is limited to one IP address. If the same user name is used to log in to the application from a different IP address, the earlier session is terminated.

If you are using the distributed solution and multitenancy mode, the limit is enforced for each PCN and SCN server separately.

kata_distributed

Operation of the application in distributed solution mode

You can use the distributed solution and multitenancy mode in the following cases:

  • To protect more than 10,000 hosts of a tenant
  • For centralized management of the application in different business units of the tenant
  • For centralized management of the application on servers of multiple tenants
  • For processing network traffic at a maximum rate of 10 Gbps if your network includes more than one 10 Gbps segment and if you want to process traffic in these segments

When the application switches to the distributed solution and multitenancy mode, all previously added license keys are deleted from servers with the SCN role. Each connected SCN receives a key from the PCN. If full functionality of the application is used for the PCN (KATA and KEDR key), and partial functionality is used for the SCN (only KATA key or only KEDR key), the SCN server load limit may be exceeded because of the increased volume of data. If partial application functionality is used for the PCN (only KATA key or only KEDR key), and full functionality is used for the SCN (KATA and KEDR key), the application functionality is partially unavailable.

License keys can be managed only on the PCN.

You can use the following scenarios to deploy the application in distributed solution and multitenancy mode:

  • Install the Central Node component on new servers and assign PCN and SCN roles to those servers.
  • Assign PCN and SCN roles to servers that already have the Central Node component installed.

    In this case, you must upgrade the Central Node component to version 7.0.

    Before you switch servers with Central Node components installed to distributed solution mode, you should review the changes that will be applied to the system after the operating mode is changed. Assigning the PCN role to a server is irreversible.

In this Help section

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247445]

Distributed solution and multitenancy mode transition scenario

Switching the application to the distributed solution and multitenancy mode involves the following steps:

  1. Assigning a DNS name to the Central Node server that you want to use as the PCN

    If a DNS name has been assigned previously, make sure it is specified correctly.

  2. Assigning the PCN role to a server
  3. Creating an application administrator account on the PCN server

    You will use this account to connect SCN servers to the PCN. If Active Directory integration is configured for Kaspersky Anti Targeted Attack Platform, you must select the KATA user account authentication type when creating the account.

  4. Assigning the SCN role to the servers and sending connection requests to the PCN
  5. Processing a SCN to PCN connection request.

After switching to the distributed solution and multitenancy mode, the application may need some time to configure the components. In this case, the application menu is not displayed in the SCN web interface, and in the PCN web interface, the Dashboard section displays the Data has not been sent to the SCN for over 5 minutes error. The time needed to set up the components depends on the amount of accumulated data, but is 20 to 30 minutes on average.

Page top
[Topic 175543]

Modifications of application settings for the distributed solution and multitenancy mode

Modifications of application settings for the distributed solution and multitenancy mode are listed in the following table.

Modifications of application settings when switching to the distributed solution and multitenancy mode

Functional area

PCN

SCN

Users

Users and roles assigned to them are preserved. Additionally, PCN users are granted access rights to work with PCN and all connected SCNs.

All users are deleted except the user that was created while Central Node was deployed.

After that, the SCN requests a list of users from the PCN and uses that list to create local users with the same parameters:

Name

Password

Role

Status

 

Users that do not have rights to access the SCN, are not displayed in the list of users.

Alerts

Information about all alerts from all connected SCNs is added to the PCN database.

The user name is no longer displayed in existing alert information. User data are deleted from alert operation history.

Network traffic events

No changes.

No changes.

Dashboard

On the Alerts tab, you can now select the SCNs whose information must be displayed in the widget.

On the System health tab, the status of connection of the PCN with connected SCNs is now displayed.

On the System health tab, the status of connection with the PCN is now displayed.

Tasks

Tasks created on the Central Node server before it was assigned the PCN role, as well as tasks created on the PCN after switching to distributed solution mode, apply to all connected SCNs.

Tasks created on SCNs are also displayed in the task list. Settings of these tasks cannot be changed on the PCN.

Tasks created on the PCN are displayed, as well as tasks created on this SCN.

Settings of tasks created on the PCN cannot be changed.

Reports

Templates and reports created before the switch to distributed solution mode are preserved.

The Servers column is added to the report table, containing information about the SCN to which the alert belongs.

After switching to distributed solution mode, only reports created on a PCN are displayed.

Templates and reports created before the switch to distributed solution mode are preserved.

Information about the user who created the report is preserved if the PCN has a user with the same ID (guid). In other cases user information is deleted.

After switching to distributed solution mode, only reports created on an SCN are displayed.

Prevention

Policies created on the Central Node server before it was assigned the PCN role, as well as policies created on the PCN after switching to distributed solution mode, apply to all connected SCNs.

Policies created on SCNs are also displayed in the policy list. Settings of these policies cannot be changed on the PCN.

Policies created on the PCN are displayed, as well as policies created on this SCN.

Settings of policies created on the PCN cannot be changed.

Storage

All files and metadata that were stored on PCNs before the switch to distributed solution mode are preserved. The name of the PCN is displayed for them in the Central Node column.

The PCN also keeps the contents of the Storage of all connected SCNs.

All files and metadata that were stored on SCNs before the switch to distributed solution mode are preserved.

TAA exclusions

No changes.

No changes.

VIP status

No changes.

No changes.

Notification rules

No changes.

No changes.

Integration with mail sensors

No changes.

No changes.

Threat Hunting

During threat hunting in the database, the PCN sends a request to all connected SCNs. After the search query is processed, a list of PCN and SCN events of the selected tenant is displayed.

No changes.

Custom rules ‑ TAA

TAA (IOA) rules that were added on the Central Node server before it was assigned the PCN role are applied only to this PCN server. Rules added after the server got the PCN role are also applied to the SCN.

TAA (IOA) rules added on the PCN, as well as TAA (IOA) rules added on this SCN before and after switching to distributed solution mode are displayed.

Custom rules ‑ Intrusion detection

No changes.

No changes.

Custom rules ‑ IOC

The search for indicators of compromise by IOC files that were added on the Central Node server before it got the PCN role is performed only on this PCN server. The search for indicators of compromise by IOC files that were added on the Central Node server after it got the PCN role is performed also on the SCN.

IOC files added on the PCN, as well as IOC files added on this SCN before and after switching to distributed solution mode are displayed.

Custom rules ‑ YARA

YARA rules that were added on the Central Node server before it was assigned the PCN role are applied only to this PCN server. Rules added after the server got the PCN role are also applied to the SCN.

YARA rules added on the PCN, as well as YARA rules added on this SCN before and after switching to distributed solution mode are displayed.

Assets

No changes.

No changes.

Network map

No changes.

No changes.

Risks and anomalies

No changes.

No changes.

Backup of the application

Backup of the application is only available on a PCN that does not have SCNs connected.

To back up the application on a PCN, disconnect all SCNs from the PCN.

Backup of the application on an SCN is not available.

To back up the application on an SCN, disconnect that server from the PCN by switching it to standalone server mode.

See also

Distributed solution and multitenancy mode transition scenario

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247813]

Assigning the PCN role to a server

Assigning the PCN role to a server is irreversible. After changing the server role to PCN, you will not be able to change the role of that server to SCN or standalone server. To change the role of that server you will have to reinstall the application.

To assign the PCN role to the server:

  1. Log in to the application web interface with the administrator account.

    You need to log in to the web interface of the server to which you want to assign the PCN role.

  2. Select the Operating mode section.
  3. Click Distributed solution.
  4. In the Server role drop-down list, select Primary Central Node.
  5. In the Tenant name field, enter the name of the tenant to which this Central Node server belongs.
  6. Click Assign the PCN role.

    This opens the action confirmation window.

    After confirming the action, log in to the application web interface again.

  7. Click Yes.

The server is assigned the PCN role and the name of the tenant.

After logging in to the application web interface with administrator credentials, the Operating mode section of the application web interface displays the following information:

  • Current mode Distributed solution.
  • Server role Primary Central Node.
  • Certificate fingerprint the fingerprint of the server's certificate required for authentication when establishing connection with an SCN.
  • Tenants information about tenants to which this server and connected SCN servers belong:
    • IP Primary Central Node for this server and IP addresses of SCN servers (after they connect).
    • Server name of this server and names of SCN servers (after they connect).

      This name is not related to name of the host where the application is installed. You can change it.

    • Certificate fingerprint blank value for this server and certificate fingerprints of SCN servers (after they connect).
    • Status connection state of SCN servers (after they connect) and the number of servers connected to tenants.
  • The Servers pending authorization table contains information about connected SCN.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247894]

Assigning the SCN role to a server

To assign the SCN role to the server:

  1. Log in to the application web interface with the administrator account.

    You need to log in to the web interface of the server to which you want to assign the SCN role.

  2. Select the Operating mode section in the window of the application web interface.
  3. Click Distributed solution.
  4. In the Server role drop-down list, select Secondary Central Node.
  5. In the PCN IP field, enter the IP address of the server that has the PCN role, to which you want to connect the SCN.
  6. Click Get certificate fingerprint.

    A fingerprint of the certificate of the server that has the PCN role is displayed in the workspace.

  7. Contact the administrator of the PCN and compare the certificate fingerprint you received with the fingerprint displayed on the PCN in the Certificate fingerprint field of the Operating mode section.
  8. If certificate fingerprints on the SCN and the PCN match, in the User name and Password fields, enter the user name and password of the administrator account created on the PCN for connecting SCNs.
  9. Click Send connection request.

    This opens a confirmation window.

  10. Click Yes.

The SCN role is assigned to the server.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247895]

Viewing information about tenants, PCN and SCN servers

In the web interface of the PCN server, you can view information about this server and about all SCN servers that are connected to it.

To view information about PCN and SCN servers in multitenancy mode:

  1. Log in to the application web interface with the administrator account.

    You need to log in to the web interface of the PCN server.

  2. Select the Operating mode section in the window of the application web interface.

The workspace displays the following information about servers:

  • Current mode Distributed solution.
  • Server role Primary Central Node.
  • Certificate fingerprint certificate fingerprint of the PCN server.
  • Tenants information about tenants to which the server belongs, as well as all SCN servers connected to the PCN.
    • IP Primary Central Node for the PCN server and IP addresses of SCN servers connected to the PCN.
    • Server name of the server and names of SCN servers that connect to the PCN.

      This name is not related to name of the host where the application is installed. You can change it.

    • Certificate fingerprint blank value for the PCN server and certificate fingerprints of SCN servers waiting to connect to the PCN.
    • Status connection status of SCN servers and the number of servers connected to the tenant.
  • The Servers pending authorization table contains the following information:
    • IP IP address or domain name of the SCN server.
    • Server is the name of the SCN server that is displayed in the application web interface.

      This name is not related to name of the host where the application is installed. You can change it.

    • Certificate fingerprint certificate fingerprint of the SCN server that is sent to the PCN with the connection request.
    • Status status of the SCN to PCN connection.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247897]

Adding a tenant to the PCN server

To add a tenant in the PCN server web interface:

  1. Log in to the application web interface with the administrator account.

    You must log in to the web interface of the PCN server for which you want to add a tenant.

  2. Select the Operating mode section in the window of the application web interface.
  3. In the right part of the Tenants workspace, click Add.
  4. In the Name field, enter the name of the tenant that you want to add.
  5. Click Add.

The tenant is added and is displayed in the list.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247898]

Deleting a tenant from the PCN server

To delete a tenant in the PCN server web interface:

  1. Log in to the application web interface with the administrator account.

    You must log in to the web interface of the PCN server for which you want to delete a tenant.

  2. Select the Operating mode section in the window of the application web interface.
  3. In the Tenants workspace, select the tenant that you want to delete.
  4. Click Delete.

    This opens the action confirmation window.

    The action is irreversible. All global objects as well as reports and report templates of this tenant are lost.

  5. Click Yes.

The tenant is deleted.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247899]

Renaming a tenant on the PCN server

To rename a tenant in the web interface of the PCN server:

  1. Log in to the application web interface with the administrator account.

    You must log in to the web interface of the PCN server for which you want to rename a tenant.

  2. Select the Operating mode section in the window of the application web interface.
  3. In the Tenants list, click Apt_icon_change_company_name next to the tenant that you want to rename.

    This opens a window in which you can rename the tenant.

  4. In the Name field, enter the new name of the tenant.
  5. Click Save.

The tenant is renamed.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Disconnecting an SCN from PCN

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247900]

Disconnecting an SCN from PCN

Starting with version 7.0, an SCN server cannot be reconnected to any PCN server.

The administrator of Kaspersky Anti Targeted Attack Platform is responsible for the confidentiality of data on PCN, SCN, and Central Node servers. If you plan to move an SCN server from one tenant to another, you must delete all data remaining on the server after using Kaspersky Anti Targeted Attack Platform and reinstall Kaspersky Anti Targeted Attack Platform before handing over the server to the different tenant.

To disconnect an SCN from a PCN:

  1. Log in to the web interface of the PCN server from which you want to disconnect the SCN using the administrator account.
  2. Select the Operating mode section in the window of the application web interface.
  3. In the server list, select the SCN that you want to disconnect.
  4. Click Disconnect.

    This opens the action confirmation window.

  5. Click Yes.

The SCN is disconnected from the PCN and continues working as a standalone Central Node server.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Modifications of application settings for disconnecting an SCN from PCN

Page top
[Topic 247901]

Modifications of application settings for disconnecting an SCN from PCN

Modifications of application settings after an SCN is disconnected from the PCN are listed in the following table.

Modifications of application settings after disconnecting an SCN from PCN

Functional area

PCN

SCN

Users

The disconnected SCN is not removed from the list of servers to which user rights apply.

Information about changes of the user account that has rights on the disconnected SCN is not sent to the SCN.

User accounts received from the PCN are not deleted.

You can create new user accounts again, as well as disable and change passwords for existing user accounts.

Alerts

Alert information on the disconnected SCN is deleted.

Operation history and all alert information is preserved.

Tasks

Tasks created on the disconnected SCN are deleted.

Tasks created on the PCN are deleted.

Information about users who created tasks on the SCN is preserved.

Reports

All reports created earlier concerning the disconnected SCN are preserved, as well as the ability to filter the report list by this server.

Templates and reports are not modified.

Prevention

Policies created on the disconnected SCN are deleted.

Policies created on the PCN are deleted.

Information about users who created policies on the SCN is preserved.

Storage

All objects related to the disconnected SCN are deleted from Storage.

All objects in the Storage are preserved.

The link to the task stops working in information about objects received as part of tasks created on the PCN.

TAA exclusions

No changes.

No changes.

VIP status

No changes.

No changes.

Notification rules

No changes.

No changes.

Integration with mail sensors

No changes.

No changes.

Threat Hunting

After the search query is processed, events related to the disconnected SCN are not displayed.

No changes.

Custom rules ‑ TAA and IOC

IOC and TAA (IOA) rules of a disconnected SCN are deleted.

IOC and TAA (IOA) rules created on the PCN are deleted.

Backup of the application

Backup of the application remains unavailable.

Backup of the application becomes available.

See also

Distributed solution and multitenancy mode transition scenario

Modifications of application settings for the distributed solution and multitenancy mode

Assigning the PCN role to a server

Assigning the SCN role to a server

Viewing information about tenants, PCN and SCN servers

Adding a tenant to the PCN server

Deleting a tenant from the PCN server

Renaming a tenant on the PCN server

Disconnecting an SCN from PCN

Page top
[Topic 247902]