46
QRadar on Cloud Getting Started Guide IBM

QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

  • Upload
    others

  • View
    32

  • Download
    0

Embed Size (px)

Citation preview

Page 1: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

QRadar on Cloud

Getting Started Guide

IBM

Page 2: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Note

Before using this information and the product that it supports, read the information in “Notices” onpage 35.

Product information

This document applies to IBM® QRadar® Security Intelligence Platform V7.2.6 and subsequent releases unlesssuperseded by an updated version of this document.© Copyright International Business Machines Corporation 2015, 2019.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Page 3: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Contents

Introduction to QRadar on Cloud Onboarding..........................................................v

Chapter 1. QRadar on Cloud overview.................................................................... 1

Chapter 3. Support for migration to QRadar on Cloud..............................................3

Chapter 4. QRadar on Cloud onboarding................................................................. 5Prerequisites for data gateways.................................................................................................................. 5System requirements for data gateways.................................................................................................... 5

Chapter 5. Data Gateways..................................................................................... 7Creating your virtual machine......................................................................................................................7Installing a QRadar data gateway................................................................................................................8Installing a QRadar data gateway in Microsoft Azure.................................................................................9Installing a QRadar data gateway in Microsoft Azure Government Cloud...............................................12Installing a QRadar data gateway on Microsoft Hyper-V......................................................................... 14Installing a QRadar data gateway in AWS.................................................................................................15Installing a QRadar data gateway in Amazon Web Services from the marketplace image.....................17Installing a QRadar data gateway in Google Cloud Platform................................................................... 19Configuring the data gateway status notification rule..............................................................................22

Chapter 6. Attaching a QRadar Network Insights appliance to QRadar on Cloud.... 23

Chapter 7. Sending TLS syslog data to the QRadar Console................................... 25

Chapter 8. Self Serve App.................................................................................... 27Proxy mapping configuration.....................................................................................................................27

Adding a proxy mapping.......................................................................................................................27Editing a proxy mapping.......................................................................................................................28Deleting a proxy mapping.................................................................................................................... 28

User management......................................................................................................................................28Viewing users....................................................................................................................................... 28Adding a user........................................................................................................................................28Modifying user settings........................................................................................................................ 29Disabling a user account...................................................................................................................... 29

Access management to the console......................................................................................................... 29Generating a new token for a data gateway........................................................................................ 29Whitelisting an IP address................................................................................................................... 30Editing or deleting a whitelisted IP address........................................................................................30

Authorized service tokens......................................................................................................................... 31Adding an authorized service token.................................................................................................... 31Deleting an authorized services token.................................................................................................31

Chapter 9. QRadar on Cloud work items that require a support ticket....................33

Notices................................................................................................................35Trademarks................................................................................................................................................ 36Terms and conditions for product documentation................................................................................... 36IBM Online Privacy Statement.................................................................................................................. 37

iii

Page 4: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

iv

Page 5: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Introduction to QRadar on Cloud Onboarding

Use IBM QRadar on Cloud to monitor your network with IBM QRadar in a subscription model.

Intended audience

Network administrators who are responsible for installing and configuring QRadar systems must befamiliar with network security concepts and the Linux® operating system.

Technical documentation

To find IBM Security QRadar product documentation on the web, including all translated documentation,access the IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter/SSKMKU/com.ibm.qradar.doc_cloud/c_hosted_inst.html).

For information about how to access more technical documentation in the QRadar products library, seeAccessing IBM Security QRadar documentation (www.ibm.com/support/docview.wss?rs=0&uid=swg21614644).

Contacting customer support

For information about contacting customer support, see QRadar Support – Assistance 101 (https://ibm.biz/qradarsupport).

Statement of good security practices

IT system security involves protecting systems and information through prevention, detection andresponse to improper access from within and outside your enterprise. Improper access can result ininformation being altered, destroyed, misappropriated or misused or can result in damage to or misuse ofyour systems, including for use in attacks on others. No IT system or product should be consideredcompletely secure and no single product, service or security measure can be completely effective inpreventing improper use or access. IBM systems, products and services are designed to be part of alawful comprehensive security approach, which will necessarily involve additional operationalprocedures, and may require other systems, products or services to be most effective. IBM DOES NOTWARRANT THAT ANY SYSTEMS, PRODUCTS OR SERVICES ARE IMMUNE FROM, OR WILL MAKE YOURENTERPRISE IMMUNE FROM, THE MALICIOUS OR ILLEGAL CONDUCT OF ANY PARTY.

Please Note:

Use of this Program may implicate various laws or regulations. including those related to privacy, dataprotection, employment, and electronic communications and storage. IBM Security QRadar may be usedonly for lawful purposes and in a lawful manner. Customer agrees to use this Program pursuant to, andassumes all responsibility for complying with, applicable laws, regulations and policies. Licenseerepresents that it will obtain or has obtained any consents, permissions, or licenses required to enable itslawful use of IBM Security QRadar.

© Copyright IBM Corp. 2015, 2019 v

Page 6: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

vi QRadar on Cloud : Getting Started Guide

Page 7: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 1. QRadar on Cloud overviewIn an environment where security requirements are dynamic, IBM QRadar on Cloud provides both thesecurity monitoring that you need, and the flexibility to modify your monitoring activities as yourrequirements change.

With QRadar on Cloud, you can protect your network and meet compliance monitoring and reportingrequirements, with reduced total cost of ownership. Other than a data gateway appliance, which is usedto connect to QRadar, you do not need to install any extra hardware on your premises.

You get the benefit of all of the QRadar capabilities without investing in the hardware and software of anon-premises QRadar deployment. IBM security professionals manage the infrastructure, while yoursecurity analysts perform the threat detection and management tasks. You can have a maximum of sixusers, and you can give any of these users the security administrator access.

For more information about the capabilities of QRadar on Cloud, see "Capabilities in your securityintelligence product" in the IBM QRadar SIEM Administration Guide.

Gateway appliance

Download and install the enabling software on your gateway appliance to collect flow and event data fromall of the log sources that are supported in your on-premises or cloud deployment.

The enabling software forwards the collected events and flow data through a secure VPN tunnel toQRadar running in the IBM cloud, where the data is stored and managed.

Log on to the QRadar console from a web browser to manage all your security and threat managementtasks, just as you would with QRadar deployed on your premises.

The following image shows devices on your network that send information to your gateway appliance. Thegateway appliance then communicates with an instance of QRadar that is running in the IBM cloud.

Gateway-Appliance

QRadar

Figure 1. QRadar on Cloud deployment example

EPS and FPM limits

Your data gateway appliance can collect 20,000 events per second (EPS) if you are not collecting flowdata. If you are collecting flow data and events, the following table provides limits for EPS and flows perminute (FPM).

© Copyright IBM Corp. 2015, 2019 1

Page 8: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Table 1. EPS and FPM limits for the QRadar on Cloud data gateway appliance

Events per second Flows per minute

0 200,000

1,000 180,000

2,000 160,000

3,000 140,000

4,000 120,000

5,000 100,000

6,000 80,000

7,000 60,000

8,000 40,000

9,000 20,000

10,000 - 20,000 0

2 QRadar on Cloud : Getting Started Guide

Page 9: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 3. Support for migration to QRadar on Cloud

Migration from an on-premises QRadar deployment to QRadar on Cloud is outside the scope of IBMSupport; contact Security Expert Labs (www.ibm.com/security/security-expert-labs) or [email protected] assistance with any of the following actions:

• Configuration migration• Data migration• Onboarding log sources

© Copyright IBM Corp. 2015, 2019 3

Page 10: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

4 QRadar on Cloud : Getting Started Guide

Page 11: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 4. QRadar on Cloud onboardingAfter you purchase IBM QRadar on Cloud, IBM sends you the information that is required for you to useQRadar on Cloud.

Prerequisites for data gatewaysYou must meet certain prerequisites before you can use the QRadar on Cloud gateway appliance.

• You must have the public host name of the console that you connect to through the gateway appliance.You receive the public host name from IBM.

• Ensure that the public IP address of the data gateway appliance is whitelisted in QRadar on Cloud.Whitelist the data gateway appliance before you request the token.

• You must have your QRadar on Cloud token. You need a token for each gateway appliance that you wantto use to connect to QRadar on Cloud on the IBM cloud. Go to Admin > Hosted QRadar in QRadar toretrieve your token.

• You must have a download link to the IBM QRadar ISO for your gateway appliance. The download link isat Admin > Hosted QRadar in QRadar.

• You must have a static IP address to connect to QRadar on Cloud through your gateway appliance. Donot use any IP address in the 192.168.0.0/16 network range.

• Your gateway appliance must be behind a network address translation (NAT) firewall.• If your gateway traffic is routed through a proxy server, it must be a transparent or inline proxy server

that does not challenge for authentication.• You must have adequate bandwidth to send your security data to QRadar on Cloud. On average, 0.72

Mbps is required for 1000 events per second (EPS), 7.2 Mbps for 10,000 EPS. Use the following formulato determine your bandwidth requirements:

EPS * ((average event size + 200) bytes x 8) / (1000 x 1000 x 10) = Mbps value.

Example: 1000 * ((700 + 200) x 8) / (1000 x 1000 x 10) = 0.7 Mbps

A minimum of 5 Mbps is required, regardless of the event rate.• Your gateway appliance must meet the system requirements.

System requirements for data gatewaysThe gateway appliance that you install on your premises communicates with QRadar on Cloud must meetcertain specifications.

Tip: To ensure that your data gateway meets the requirements, see “Prerequisites for data gateways” onpage 5.

Table 2. Gateway system requirements for physical appliances

Specification Required value

CPU 2.6 GHz, 16 Core, 15 MB Cache

RAM 16 GB

HDD 500 GB minimum (2 TB recommended)

300 IOPS

300 MB/s data transfer rate

© Copyright IBM Corp. 2015, 2019 5

Page 12: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Table 3. Gateway system requirements for virtual appliances

Specification Required value

CPU 4 cores for 1000 events per second (EPS) or less

8 cores for up to 7,500 EPS

16 cores for 7,500 - 20,000 EPS

16 cores for deployments with QRadar Vulnerability Manager

16 cores for any Data Gateway that is also running flows.

RAM 16 GB

32 GB for deployments with QRadar Vulnerability Manager

HDD 500 GB minimum (2 TB recommended)

300 IOPS

300 MB/s data transfer rate

Port 443 outbound

You must ensure that port 443 is open on your firewall for both the HTTPS and VPN IP addresses that areprovided for your deployment. IBM provides you with two IP addresses for your QRadar on Clouddeployment. One is the HTTPS address for the console, and the second is for the VPN. These addressesare listed in the welcome email. Port 443 for both of these addresses must be open on your firewall.

Network time protocol

IBM QRadar on Cloud uses GPS, with a receiver in each data center, to sync systems for Network TimeProtocol. This time might differ slightly from customers that use the common NIST pool for NTP for theirown systems.

6 QRadar on Cloud : Getting Started Guide

Page 13: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 5. Data GatewaysYou connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway on aphysical appliance, or on a virtual machine either on your own server, in Microsoft Azure, or in AWS.

The data gateway version that you install must be the same version as the QRadar on Cloud console thatyou are using.

Third-party software on data gateways

IBM QRadar is a security appliance that is built on Linux, and is designed to resist attacks. QRadar is notintended as a multi-user, general-purpose server. It is designed and developed specifically to support itsintended functions. The operating system and the services are designed for secure operation. QRadar hasa built-in firewall, and allows administrative access only through a secure connection that requiresencrypted and authenticated access, and provides controlled upgrades and updates. QRadar datagateways do not require or support traditional anti-virus or malware agents, or support the installation ofthird-party packages or programs.

Prerequisites and system requirements

See Chapter 4, “QRadar on Cloud onboarding,” on page 5 for prerequisites and system requirements forinstalling a data gateway.

Creating your virtual machineCreate a virtual machine where you can install IBM Security QRadar if you do not want to install it on aphysical appliance.

Before you beginTo install a virtual appliance, you must use VMware vSphere Client 5.1 or later to create a virtual machine.

About this taskBuild your virtual machine to match the recommended specifications for IBM QRadar on Cloud. For moreinformation, see Chapter 4, “QRadar on Cloud onboarding,” on page 5.

Procedure

1. From the VMware vSphere Client, click File > New > Virtual Machine.2. Use the following steps to guide you through the choices:

a) In the Configuration pane of the Create New Virtual Machine window, select Custom.b) In the Virtual Machine Version pane, select a virtual machine hardware version 13.

For more information about VMWare ESXi and hardware versions, see ESXi/ESX hosts andcompatible virtual machine hardware versions list (https://kb.vmware.com/s/article/2007240).

c) For the Operating System (OS), select Linux, and select Red Hat Enterprise Linux 7.3 (64-bit).d) On the CPUs page, configure the number of virtual processors that you want for the virtual

machine:

• For less than 1000 events per second (EPS), select 4 cores.• For 1000 EPS or more, or for a deployment with QRadar Vulnerability Manager, select 8 cores.

e) In the Memory Size field, select 16 or greater.f) Use the following table to configure you network connections.

© Copyright IBM Corp. 2015, 2019 7

Page 14: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Table 4. Descriptions for network configuration parameters

Parameter Description

How many NICs do you want to connect You must add at least one Network InterfaceController (NIC)

Adapter VMXNET3

g) In the SCSI controller pane, select VMware Paravirtual.h) In the Disk pane, select Create a new virtual disk and use the following table to configure the

virtual disk parameters.

Table 5. Settings for the virtual disk size and provisioning policy parameters

Property Option

Capacity 500 GB minimum

2 TB or higher recommended

Disk Provisioning Thick provision

Advanced options Do not configure

3. On the Ready to Complete page, review the settings and click Finish.

Installing a QRadar data gatewayYou connect to IBM QRadar on Cloud through a data gateway. Install the data gateway on a physicalappliance, or on a virtual machine.

Before you beginSchedule a maintenance window for this task and ensure that users do not deploy changes while the datagateway is being added to your deployment.

Ensure that you have the following information:

• The token for QRadar on Cloud.• The full host name of the console that you connect to through your gateway appliance.

About this task

Notes:

• Data gateways must be installed one at a time. If you are installing more than one data gateway, waituntil you complete installation of one before you install the next one.

• You set a root password as part of the installation process. You cannot change this password until afterthe installation process is complete. The root password is also the gateway host password.

Procedure

1. Choose your installation method.

• If you are installing your data gateway on a physical appliance, select the boot option for theQRadar ISO location: DVD or USB.

• If you are installing your data gateway on a virtual machine (VM), begin the installation by using thefollowing steps.

a. Point to the QRadar ISO from the DVD drive.

8 QRadar on Cloud : Getting Started Guide

Page 15: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

b. Configure your VM boot menu to start from the DVD drive when you power it on.• If you are installing your data gateway in Microsoft Azure, follow the instructions in “Installing a

QRadar data gateway in Microsoft Azure” on page 9.• If you are installing your data gateway in Amazon Web Services (AWS), follow the instructions in

“Installing a QRadar data gateway in AWS” on page 15.2. Power on the appliance.3. Accept the End User License Agreement (EULA) that is displayed.

Tip: Press the Space bar key to advance through the document.4. Follow the instructions in the installation wizard.

a) In the Appliance Install window, select Appliance Install.b) In the Non-Software Appliance Assignment window, select Event Collector Gateway 7000.c) In the Network Information Setup window, do not use an IP address in the 192.168.0.0/16

network range. You must use a static IP address. Do not change this IP address. Leave the PublicIP field blank. Give each gateway a unique host name. The gateway host name cannot be the sameas the console host name, and cannot be "qradar".

d) In the Deployment Configuration window, enter the fully qualified domain name for the console,and the token for QRadar on Cloud.

e) In the Internet Access window, select A direct connection.

After you configure the installation parameters, a series of installation messages are displayed. Theinstallation process can take several minutes.

Installing a QRadar data gateway in Microsoft AzureYou connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway inMicrosoft Azure.

Before you beginSchedule a maintenance window for this task and ensure that users do not deploy changes while the datagateway is being added to your deployment.

Ensure that you have the full host name of the Console that you connect to through your gatewayappliance.

About this task

For any issues with QRadar software, engage IBM Support. If you experience any problems with MicrosoftAzure infrastructure, refer to Microsoft Azure Support documentation. If IBM Support determines thatyour issue is caused by the Microsoft Azure infrastructure, you must contact Microsoft for support toresolve the underlying issue with the Microsoft Azure infrastructure.

You must use static private and public IP addresses.

Data gateways must be installed one at a time. If you are installing more than one data gateway, wait untilyou complete installation of one before you install the next one.

Do not make any configuration changes, such as adding extra DNS entries, until after installation iscomplete.

Procedure

1. Go to the Microsoft Azure Marketplace (https://azuremarketplace.microsoft.com/en-us/marketplace/apps/ibm.qradar733?tab=Overview).The Plans + Pricing tab can be used to estimate pricing for certain VM sizes, but you don't chooseyour VM size on this screen. Refer to the Core and RAM columns when you are estimating pricing.

Chapter 5. Data Gateways 9

Page 16: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Ignore the Disk Space column, as all QRadar marketplace images include a disk for the operatingsystem, and a 1 TB disk for storage.

2. Click Get It Now.3. Select QRadar SIEM MH 7.3.3 from the Software plan menu list and click Continue.4. Click Create to create an instance for the data gateway.5. Configure VM settings.

a) Select an existing Resource Group or create a new one.b) Enter a virtual machine name.

Note: The VM name must be ten characters or fewer.c) Select a Region.d) Click Change size and ensure that your VM meets the minimum system requirements.

For more information, see Chapter 4, “QRadar on Cloud onboarding,” on page 5.e) Enter a username for the administrator account.f) Choose an SSH public key or Password.

For more information about creating and using an SSH public-private key pair for Linux VMs inMicrosoft Azure, see Microsoft documentation.

g) Set Public inbound ports to Allow selected ports.h) Set Select inbound ports to SSH (22) and HTTPS (443).

6. Click Review + Create.7. Click Create to deploy the instance.8. When your VM is deployed in Azure, set the private and public IP addresses to static:

a) Click Go to resource.b) Click the public IP address.c) Set the Assignment to Static.d) Click Save.e) Click Overview.f) Click the Associated to link.g) Click IP configurations.h) In the list of IP configurations, click the configuration row where the Type is set to Primary.i) Set the Private IP address assignment to Static.j) Click Save.

9. Create or select a security group that allows ports 22 and 443 only from trusted IP addresses tocreate a whitelist of IP addresses that can access your QRadar deployment.a) Click Virtual Machines > <virtual_machine_name>.b) Click Networking.c) Click the SSH rule that is associated with port 22.d) In the edit pane, select IP Addresses from the Source list.e) In the Source IP addresses/CIDR ranges field, enter the address range of the IP addresses that

are allowed to access the VM.f) Click Save.g) Click the HTTPS rule that is associated with port 443.h) In the edit pane, select IP Addresses from the Source list.i) In the Source IP addresses/CIDR ranges field, enter the address range of the IP addresses that

are allowed to access the VM.j) Click Save.

10 QRadar on Cloud : Getting Started Guide

Page 17: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

10. To display the SSH connection information for the public IP address of the virtual appliance:a) Click Virtual Machines > <virtual_machine_name>.b) Click Connect.

11. Log in to your virtual machine.

• To log in using SSH and your key pair, type the following command:

ssh -i <key.pem> user@<public_IP_address>

• To log in using SSH and your password, type the following command:

ssh user@<public_IP_address>

12. To check the length of your FQDN, type the following command:

hostname -f | wc -c

If the command returns a value greater than 63 installation will fail. Restart this procedure with ashorter virtual machine name.

13. Log in to your data gateway and type the following command:

sudo /root/setup_mh 7000

14. The system prompts you to set a root password. The password must meet the following criteria:

• Contains at least 5 characters• Contains no spaces• Cannot include the following special characters: @, #, ^, and *.

You cannot change this password until after the installation process is complete. The root passwordis also the gateway host password.

15. Upgrade the data gateway to the same version of QRadar as your Console.a) Log in to the Console.

b) Click the navigation menu ( ), and then click About.c) Download the SFS file for the version of QRadar that the Console is at from Fix Central (https://

www.ibm.com/support/fixcentral).d) Copy the software update SFS file to your data gateway.e) Move the SFS file to the /storetmp directory by typing the following command:

sudo mv 733_QRadar_patchupdate-<version_number>.sfs /storetmp

f) Open the superuser shell by typing the following command:

sudo su -

g) Create the /media/updates directory by typing the following command:

mkdir /media/updates

h) Mount the SFS file by typing the following command:

mount -o loop -t squashfs /storetmp/733_QRadar_patchupdate-<version_number>.sfs /media/updates

i) Run the software update installer by typing the following command:

/media/updates/installer

16. Open a support ticket and provide the following information.

• The public IP address of your data gateway, which is added to your whitelist.

Chapter 5. Data Gateways 11

Page 18: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

• The private IP address of your data gateway, which is used to generate your token for QRadar onCloud.

17. After you receive your token:a) Because the appliance restarted after the previous step, open the superuser shell again by typing

the following command:

sudo su -

b) To finish the initial data gateway setup, type the following command:

/opt/qradar/bin/setup_qradar_host.py mh_setup interactive -p

What to do next

Exit the superuser shell by typing the following command:

exit

Related information

Installing a QRadar data gateway in Microsoft Azure Government CloudYou connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway inMicrosoft Azure Government Cloud.

Before you beginSchedule a maintenance window for this task and ensure that users do not deploy changes while the datagateway is being added to your deployment.

Ensure that you have the full host name of the Console that you connect to through your gatewayappliance.

About this task

For any issues with QRadar software, engage IBM Support. If you experience any problems with MicrosoftAzure infrastructure, refer to Microsoft Azure Support documentation. If IBM Support determines thatyour issue is caused by the Microsoft Azure infrastructure, you must contact Microsoft for support toresolve the underlying issue with the Microsoft Azure infrastructure.

You must use static private and public IP addresses.

Data gateways must be installed one at a time. If you are installing more than one data gateway, wait untilyou complete installation of one before you install the next one.

Do not make any configuration changes, such as adding extra DNS entries, until after installation iscomplete.

Procedure

1. Go to the Microsoft Azure Government Cloud Marketplace (https://portal.azure.us/#blade/Microsoft_Azure_Marketplace/MarketplaceOffersBlade/selectedMenuItemId/) and search for"QRadar".

2. Select QRadar SIEM (BYOL).3. Click Create to create an instance for the data gateway.4. Configure VM settings.

a) Enter a name.

Note: The VM name must be eight characters or fewer.

12 QRadar on Cloud : Getting Started Guide

Page 19: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

b) Click Change size and ensure that your VM meets the minimum system requirements.For more information, see Chapter 4, “QRadar on Cloud onboarding,” on page 5.

c) Enter an ssh user name.d) Choose a SSH public key or Password.

For more information on how to create and use an SSH public-private key pair for Linux VMs in Azure,see Microsoft documentation.

5. Configure the Azure networking firewall rules to allow access only from your internal infrastructureCIDR ranges.a) Click Settings > Choose network security group > Create network security group.b) Click Advanced.c) Select the network security group that you created in the previous step.d) Click the default-allow-ssh rule.e) In the edit pane, select IP addresses from the Source list.f) In the Source IP addresses/CIDR ranges field, enter the address range of the IP addresses that

are allowed to access the VM.g) Enter ports 22 and 443 in the Destination port ranges field.h) Click Save.i) Click OK.j) On the Settings tab, click OK.

6. Click Review + Create.7. Click Create to deploy the instance.8. When your VM is deployed in Azure, set the private and public IP addresses to static:

a) Click Go to resource.b) Click the public IP address.c) Set the Assignment to Static.d) Click Save.e) Click Overview.f) Click the Associated to link.g) Click IP configurations.h) In the list of IP configurations, click the configuration row where the Type is set to Primary.i) Set the Private IP address assignment to Static.j) Click Save.

9. To display the SSH connection information for the public IP address of the virtual appliance:a) Click Virtual Machines > <virtual_machine_name>.b) Click Connect.

10. Log in to your data gateway and type the following command:

sudo /root/run_first 7000

11. Upgrade the data gateway to the same version of QRadar as your Console.a) Log in to the Console.

b) Click the navigation menu ( ), and then click About.c) Download the SFS file for the version of QRadar that the Console is at from Fix Central (https://

www.ibm.com/support/fixcentral).d) Copy the software update SFS file to your data gateway.e) Move the SFS file to the /storetmp directory by typing the following command:

Chapter 5. Data Gateways 13

Page 20: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

sudo mv 732_QRadar_patchupdate-<version_number>.sfs /storetmp

f) Open the superuser shell by typing the following command:

sudo su -

g) Create the /media/updates directory by typing the following command:

mkdir /media/updates

h) Mount the SFS file by typing the following command:

mount -o loop -t squashfs /storetmp/732_QRadar_patchupdate-<version_number>.sfs /media/updates

i) Run the software update installer by typing the following command:

/media/updates/installer

12. After you receive your token:a) Because the appliance restarted after the previous step, open the superuser shell again by typing

the following command:

sudo su -

b) To finish the initial data gateway setup, type the following command:

/opt/qradar/bin/setup_qradar_host.py mh_setup interactive -p

What to do next

Exit the superuser shell by typing the following command:

exit

Related information

Installing a QRadar data gateway on Microsoft Hyper-VYou connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway onMicrosoft Hyper-V.

You must use a software installation rather than an appliance installation to use a data gateway onMicrosoft Hyper-V. During the installation, on the installation type screen, press CTRL+K to enter theactivation key for the data gateway. (You can follow the same process as in step “8” on page 16 of“Installing a QRadar data gateway in AWS” on page 15.)

For more information about software installations, see the virtual appliance installations section of theIBM QRadar installation guide (https://www.ibm.com/support/knowledgecenter/SS42VS_7.3.2/com.ibm.qradar.doc/c_siem_vrt_ap_inst.html).

For more information about the memory and processor requirements, see “System requirements for datagateways” on page 5.

14 QRadar on Cloud : Getting Started Guide

Page 21: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Installing a QRadar data gateway in AWSYou connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway in AmazonWeb Services (AWS).

Before you beginSchedule a maintenance window for this task and ensure that users do not deploy changes while the datagateway is being added to your deployment.

1. Find your data gateway activation key on the Hosted QRadar window in the Admin settings of yourConsole.

2. Download the ISO image from the Hosted QRadar window in the Admin settings of your Console.3. Configure a key pair on AWS.4. Create an Amazon EC2 instance that meets the following requirements:

Table 6. AWS Instance Requirements

Requirement Value

Image RHEL-7.5_HVM_GA-20180322-x86_64-1-Hourly2-GP2, found in Community AMIs

Instance type Choose an instance that meets the systemrequirements in “Creating your virtual machine”on page 7.

Storage Two disks:

1 x 100 GB volume

One volume for storage. Minimum 500 GB. Usethe spreadsheet in the Calculating Event StorageRequirements section of Event FAQ (https://developer.ibm.com/qradar/2017/08/22/1775/)to determine your storage needs.

Security Group Your IP addresses from the list, with ports 22 and443 open. The AWS firewall ports and protocolsmust be open to your HTTPS IP address and yourVPN IP address.

5. Download the AWS QRadar Install Helper script from Fix Central (www.ibm.com/support/fixcentral/).

a. Go to the Select product tab.b. Set Product Group to IBM Security.c. Set Select from IBM Security to IBM Security QRadar SIEM.d. Set Installed Version to 7.3.0 and click Continue.e. Select Browse for fixes and click Continue.f. Click SCRIPT.g. Select the AWS QRadar Install Helper script.

The AWS instance key is required to log in to the instance with SSH.

About this task

The command values that appear in this procedure are examples only. Command values can vary amongdeployments.

Notes:

Chapter 5. Data Gateways 15

Page 22: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

• Data gateways must be installed one at a time. If you are installing more than one data gateway, waituntil you complete installation of one before you install the next one.

• You set a root password as part of the installation process. You cannot change this password until afterthe installation process is complete. The root password is also the gateway host password.

• The data gateway version that you install must be the same version as the QRadar on Cloud consolethat you are using.

Procedure

1. To copy the script that prepares the AWS partitions and configuration options to the AWS instance,type the following command:

scp -i <key.pem> aws_qradar_prep.sh ec2-user@<public_IP_address>:

2. To log in to the AWS instance by using the key pair that you created when you configured the instance,type the following command:

ssh -i <key.pem> ec2-user@<public_IP_address>

3. To update dracut, type the following command:

sudo yum update -y dracut

4. To run the script to prepare the AWS partitions and configuration options, type the followingcommand:

sudo bash +x ./aws_qradar_prep.sh --install

The AWS instance restarts after the script runs.5. To copy the ISO image to the device, type the following command:

scp -i <key.pem> <qradar.iso> ec2-user@<public_IP_address>:

6. To mount the ISO image, type the following command:

sudo mount -o loop /home/ec2-user/<qradar.iso> /media/cdrom

7. Accept the End User License Agreement (EULA) that is displayed.

Tip: Press the Space bar key to advance through the document.8. Follow the instructions in the installation wizard.

a) Do one of the following steps:

• If the Appliance Install window appears, select Appliance Install.• If the Software Installed System window appears, press CTRL+K, and enter the activation key.

Note: To enter the activation key, you must delete the sample entry and then enter youractivation key. You can find your activation key in the Hosted QRadar > Gateway Installationsection in the console. The key is named Gateway Activation Key. If you enter an incorrectactivation key, a console is deployed instead of a data gateway.

b) In the Network Information Setup window, do not use any IP address in the 192.168.0.0/16network range. You must use a static IP address. Do not change this IP address. Leave the PublicIP field blank. Give each gateway a unique host name. The gateway host name cannot be the sameas the console host name, and cannot be "qradar".

c) In the Deployment Configuration window, enter the fully qualified domain name for the console,and the token for QRadar on Cloud.

d) In the Internet Access window, select A direct connection.

After you configure the installation parameters, a series of installation messages are displayed. Theinstallation process can take several minutes.

16 QRadar on Cloud : Getting Started Guide

Page 23: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Installing a QRadar data gateway in Amazon Web Services from themarketplace image

You connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway on anAmazon Web Services (AWS) instance by using the provided Amazon Machine Image (AMI).

Before you beginSchedule a maintenance window for this task and ensure that users do not deploy changes while the datagateway is being added to your deployment.

Ensure that you have the full host name of the Console that you connect to through your gatewayappliance.

About this task

For any issues with QRadar software, engage IBM Support. If you experience any problems with AWSinfrastructure, refer to AWS documentation. If IBM Support determines that your issue is caused by theAWS infrastructure, you must contact Amazon for support to resolve the underlying issue with the AWSinfrastructure.

You must use static private and public IP addresses.

Data gateways must be installed one at a time. If you are installing more than one data gateway, wait untilyou complete installation of one before you install the next one.

Do not make any configuration changes, such as adding extra DNS entries, until after installation iscomplete.

Procedure

1. Go to the AWS Marketplace (https://aws.amazon.com/marketplace/pp/B07TC8WXBG).2. Click Continue to Subscribe.3. Click Accept Terms.4. When the subscription is ready, click Continue to Configuration.5. Select a region and click Continue to Launch.6. From the Choose Action list, select Launch from Website.7. Select an m4.2xlarge or larger EC2 Instance Type that meets the minimum system requirements.

For more information, see Chapter 4, “QRadar on Cloud onboarding,” on page 5.8. Create or select a virtual private cloud (VPC).9. Create or select a subnet for your VPC.

10. Create or select a security group that allows ports 22 and 443 only from trusted IP addresses tocreate a whitelist of IP addresses that can access your QRadar deployment.

11. Configure a key pair. You will use this key pair every time you connect to the appliance by using SSH.12. Click Launch.13. Log in to the AWS instance by using the key pair that you created when you configured the instance,

type the following command:

ssh -i <key.pem> ec2-user@<public_IP_address>

14. To check the length of your FQDN, type the following command:

hostname -f | wc -c

If the command returns a value greater than 63 installation will fail. Restart this procedure with ashorter virtual machine name.

15. Log in to your data gateway and type the following command:

Chapter 5. Data Gateways 17

Page 24: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

sudo /root/setup_mh 7000

16. The system prompts you to set a root password. The password must meet the following criteria:

• Contains at least 5 characters• Contains no spaces• Cannot include the following special characters: @, #, ^, and *.

You cannot change this password until after the installation process is complete. The root passwordis also the gateway host password.

17. Upgrade the data gateway to the same version of QRadar as your Console.a) Log in to the Console.

b) Click the navigation menu ( ), and then click About.c) Download the SFS file for the version of QRadar that the Console is at from Fix Central (https://

www.ibm.com/support/fixcentral).d) Copy the software update SFS file to your data gateway.e) Move the SFS file to the /storetmp directory by typing the following command:

sudo mv 733_QRadar_patchupdate-<version_number>.sfs /storetmp

f) Open the superuser shell by typing the following command:

sudo su -

g) Create the /media/updates directory by typing the following command:

mkdir /media/updates

h) Mount the SFS file by typing the following command:

mount -o loop -t squashfs /storetmp/733_QRadar_patchupdate-<version_number>.sfs /media/updates

i) Run the software update installer by typing the following command:

/media/updates/installer

18. Open a support ticket and provide the following information.

• The public IP address of your data gateway, which is added to your whitelist.• The private IP address of your data gateway, which is used to generate your token for QRadar on

Cloud.19. After you receive your token:

a) Because the appliance restarted after the previous step, open the superuser shell again by typingthe following command:

sudo su -

b) To finish the initial data gateway setup, type the following command:

/opt/qradar/bin/setup_qradar_host.py mh_setup interactive -p

What to do next

Exit the superuser shell by typing the following command:

exit

18 QRadar on Cloud : Getting Started Guide

Page 25: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Related information

Installing a QRadar data gateway in Google Cloud PlatformYou connect to IBM QRadar on Cloud through a data gateway. You can install the data gateway on aGoogle Cloud Platform (GCP) instance by using the provided image.

Before you beginSchedule a maintenance window for this task and ensure that users do not deploy changes while the datagateway is being added to your deployment.

Ensure that you have the full host name of the Console that you connect to through your gatewayappliance.

About this task

For any issues with QRadar software, engage IBM Support. If you experience any problems with GCPinfrastructure, refer to GCP documentation. If IBM Support determines that your issue is caused by theGCP infrastructure, you must contact GCP for support to resolve the underlying issue with the GCPinfrastructure.

You must use static private and public IP addresses.

Data gateways must be installed one at a time. If you are installing more than one data gateway, wait untilyou complete installation of one before you install the next one.

Do not make any configuration changes, such as adding extra DNS entries, until after installation iscomplete.

Procedure

1. Create a project name in GCP that allows for a fully qualified domain name (FQDN) to be no morethan 63 characters long. The FQDN consists of the deployment name followed by "-vm", the zone, theregion, the project name, and ".internal".

For example, if your project name is abc-stq-xyz, the appliance deployment name is qr-con, thezone is us-east4-c, and the region is c, the FQDN is qr-con-vm.us-east4-c.c.abc-stq-xyz.internal. The zone can be between 10 and 25 characters long. Depending on the zone, thisleaves somewhere between 25 and 40 characters to be split between your project name and yourdeployment name.

2. In the project that you created in step 1, configure your network interface.a) Click Google Cloud Platform > VPC network > VPC networks.

©2019 Google LLC, used with permission. Google and the Google logo are registered trademarks of Google LLC.

b) Click CREATE VPC NETWORK.c) Give your network a name, and configure the settings as needed. Set DNS server policy to No

server policy.

Chapter 5. Data Gateways 19

Page 26: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

d) Click Create.3. Add an SSH key to the project if you haven't already done so. The key must be created for a user

called cloud-user.a) Click Google Cloud Platform > Compute Engine > Metadata.

©2019 Google LLC, used with permission. Google and the Google logo are registered trademarks of Google LLC.

b) Click SSH Keys.c) Click Edit.d) Click Add item.e) Enter an SSH key, followed by cloud-user.f) Click Save.

4. Go to QRadar Security Intelligence Platform Managed Host v7.3.2 P1 (https://console.cloud.google.com/marketplace/details/ibm-security-public/qradar-mh?q=IBM%20qradar&id=19dda1c2-9483-4ddc-a7bf-43e5e0d2fc01).

5. Click LAUNCH ON COMPUTE ENGINE.6. Set a deployment name for the appliance that allows for a fully qualified domain name (FQDN) to be

no more than 63 characters long. The FQDN consists of the deployment name, the zone, the projectname, and ".internal".

For example, if your project name is abc-stq-xyz, the appliance deployment name is qr-con, thezone is us-east4-c, and the region is c, the FQDN is qr-con-vm.us-east4-c.c.abc-stq-xyz.internal. The zone can be between 10 and 25 characters long. Depending on the zone, thisleaves somewhere between 25 and 40 characters to be split between your project name and yourdeployment name.

7. Select the zone that your project is in.8. Select a Machine Type and Boot Disk parameters that meet the minimum system requirements.

For more information, see Chapter 4, “QRadar on Cloud onboarding,” on page 5.9. Select the network interface that you created.

10. Set the firewall rules for your appliance that allow ports 22 and 443 only from trusted IP addressesto create a whitelist of IP addresses that can access your QRadar deployment.In a QRadar deployment with multiple appliances, other ports might also be allowed betweenmanaged hosts. For more information about what ports might need to be allowed in yourdeployment, see Common ports and servers used by QRadar.

11. Check I accept the GCP Marketplace Terms of Service.12. Click Deploy.

20 QRadar on Cloud : Getting Started Guide

Page 27: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

13. Set a static IP address for your appliance.a) Click Google Cloud Platform > Compute Engine > VM instances.b) Select your appliance from the list.c) Click Edit.d) Edit the network interface.

• Set the Internal IP type parameter to Static and reserve a new IP address.• Select or create a static External IP address.

e) Click Done.14. When the instance is ready, log in using SSH and your key pair by typing the following command:

ssh -i <key.pem> cloud-user@<public_IP_address>

15. To check the length of your FQDN, type the following command:

hostname -f | wc -c

If the command returns a value greater than 63 installation will fail. Restart this procedure with ashorter virtual machine name.

16. Log in to your data gateway and type the following command:

sudo /root/setup_mh 7000

17. The system prompts you to set a root password. The password must meet the following criteria:

• Contains at least 5 characters• Contains no spaces• Cannot include the following special characters: @, #, ^, and *.

You cannot change this password until after the installation process is complete. The root passwordis also the gateway host password.

18. Upgrade the data gateway to the same version of QRadar as your Console.a) Log in to the Console.

b) Click the navigation menu ( ), and then click About.c) Download the SFS file for the version of QRadar that the Console is at from Fix Central (https://

www.ibm.com/support/fixcentral).d) Copy the software update SFS file to your data gateway.e) Move the SFS file to the /storetmp directory by typing the following command:

sudo mv 733_QRadar_patchupdate-<version_number>.sfs /storetmp

f) Open the superuser shell by typing the following command:

sudo su -

g) Create the /media/updates directory by typing the following command:

mkdir /media/updates

h) Mount the SFS file by typing the following command:

mount -o loop -t squashfs /storetmp/733_QRadar_patchupdate-<version_number>.sfs /media/updates

i) Run the software update installer by typing the following command:

/media/updates/installer

Chapter 5. Data Gateways 21

Page 28: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

19. Open a support ticket and provide the following information.

• The public IP address of your data gateway, which is added to your whitelist.• The private IP address of your data gateway, which is used to generate your token for QRadar on

Cloud.20. After you receive your token:

a) Because the appliance restarted after the previous step, open the superuser shell again by typingthe following command:

sudo su -

b) To finish the initial data gateway setup, type the following command:

/opt/qradar/bin/setup_qradar_host.py mh_setup interactive -p

What to do next

Exit the superuser shell by typing the following command:

exit

Configuring the data gateway status notification ruleQRadar on Cloud provides a rule to send notifications if any data gateways have an unknown status. Therule is configured to run every 5 minutes. If a data gateway is in an unknown state, a system notification isgenerated. You can customize the rule response options to suit your needs.

Procedure

1. From the Offenses, Log Activity, or Network Activity tabs, click Rules.2. Type QRoC in Search Rules, and press Enter.3. Double-click QRoC Data Gateway Status check.4. Use the Rule Wizard to modify the rule response options.

22 QRadar on Cloud : Getting Started Guide

Page 29: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 6. Attaching a QRadar Network Insightsappliance to QRadar on Cloud

To use an IBM QRadar Network Insights appliance with IBM QRadar on Cloud, you must use a token andrun a command to attach the appliance to the console by using a virtual private network (VPN).

Before you begin

The appliance must be at the same version as the QRadar on Cloud console. If they are not the sameversion, the appliance cannot be attached to the console.

You must request a token before you can run the command to attach the appliance.

Procedure

1. In your QRadar on Cloud console, go to Admin > Hosted QRadar to request a token from IBM Support.

You must request a token for the QRadar Network Insights appliance.2. After you receive your token, from the appliance, type the following command to attach the appliance

to QRadar on Cloud:

/opt/qradar/bin/setup_qradar_host.py mh_setup interactive -p

3. Open another ticket with IBM Support to connect the appliance to a data gateway.

You must specify which data gateway that you want the QRadar Network Insights appliance to beconnected to.

© Copyright IBM Corp. 2015, 2019 23

Page 30: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

24 QRadar on Cloud : Getting Started Guide

Page 31: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 7. Sending TLS syslog data to the QRadarConsole

You can send syslog log source information directly to IBM QRadar on Cloud by using the TLS syslog logsource protocol. You do not need to use a data gateway.

Procedure

1. Click the Admin tab.2. Click the Log Sources icon.3. Click Add.4. Configure the common parameters for your log source.5. Configure the protocol-specific parameters for your log source.

• You must use port 6514 for the listening port.• If you need a copy of the server-generated TLS certificate, you must request it through a support

ticket.• If you want to provide your own certificate and key pair, you must upload it through a support ticket.

For more information about configuring the protocol, see TLS syslog protocol configuration options6. Click Save.7. On the Admin tab, click Deploy Changes.8. Configure the network device to send traffic to the same IP or fully qualified domain name (FQDN)

address that you use to access your QRadar on Cloud instance.

For example, you are configuring a firewall to send TLS syslog information to QRadar on Cloud. If yourconsole address is console-######.qradar.ibmcloud.com, enter console-######.qradar.ibmcloud.com as the destination in the firewall's syslog configuration.

© Copyright IBM Corp. 2015, 2019 25

Page 32: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

26 QRadar on Cloud : Getting Started Guide

Page 33: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 8. Self Serve AppUse the QRadar on Cloud Self Serve app to perform administrative tasks that are related to theprovisioning and configuration of your QRadar on Cloud instance.

The Self Serve app is installed on all QRadar on Cloud Consoles by default.

Proxy mapping configurationUse the QRadar on Cloud Self-Serve app to configure proxy mapping for your QRadar on Cloud instance.

Many apps require network access to devices, servers, or services on the customer network. Theseresources are not normally accessible from the internet. You use data gateway proxy mapping to create asecure tunnel between the QRadar on Cloud apps and your on-premises network resources. Only QRadaron Cloud apps use the VPN tunnel to your resources.

QRadar on Cloud

Customer firewall

Customer firewall

VPN tunnel

QRadarData Gateway

Customerapplication

Figure 2. QRadar on Cloud VPN tunnel

For example, you use the LDAP Reference Set Importer to import LDAP records for user analytics. You cancreate a proxy mapping that specifies the classless inter-domain routing (CIDR) range where your LDAPservers are located and which data gateway the QRadar on Cloud apps use for the tunnel. You can alsospecify single IP addresses with a CIDR ending in /32.

Important: Proxy mappings must use the IP addresses of the destination resource. Also, you cannot limitwhich QRadar on Cloud apps have access to which proxy mappings.

Adding a proxy mappingAdd a proxy mapping to allow QRadar apps to access API endpoints and other integrations on your localnetwork.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click Data Gateway Proxy Mapping.3. Click Add.4. Enter a name for the proxy mapping.5. Enter the CIDR range for the proxy mapping.6. Select the gateway that the proxy mapping applies to.7. Optional: Click Test to test your proxy mapping.8. Click Save.

© Copyright IBM Corp. 2015, 2019 27

Page 34: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Editing a proxy mappingYou can edit an existing proxy mapping to change the name, CIDR, or gateway.

Procedure

1. Click a proxy mapping.2. Click Edit.3. Make any necessary changes to the Name, CIDR, or Gateway fields.4. Optional: Click Test to test your proxy mapping.5. Click Save.

Deleting a proxy mappingIf a proxy mapping is no longer needed, you can delete the proxy mapping.

Procedure

1. Click a proxy mapping.2. Click Delete.

User managementUse the QRadar on Cloud Self Serve app to manage your QRadar on Cloud instance users.

Viewing usersThe User Management page shows your QRadar on Cloud users. You can filter the user list by role or bysecurity profile. And you can search for user names.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click User Management.

The list shows all of your QRadar on Cloud users. Not all QRadar roles are displayed in the list. Forexample, high-level roles are not displayed.

3. Select a filter for the users that you want to see. Or, enter the user name in the Search user box.

Adding a userYou can add users to your QRadar on Cloud instance. Users must have an IBM ID.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click User Management.3. Click Add.4. Enter the user's IBM ID in User Name.

If the user name is already in use, a message says that the user name is reserved.5. Select the User Role and Security Profile for the user.

• The user roles are defined by a QRadar on Cloud administrator. Not all QRadar roles are displayedin the list. For example, high-level roles are not displayed.

• The security profiles are standard QRadar profiles.6. Click Save.

28 QRadar on Cloud : Getting Started Guide

Page 35: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

The user is added the list, and the Status shows as PENDING until it is added. An ACTIVE status is foractive users.

If the IBM ID is not recognized, the Status shows as FAILED. Click the user name value, and then clickthe provided link to create an IBM ID for the user or click Delete to remove the user.

7. On the Admin tab, click Deploy Changes.

Modifying user settingsYou can change a QRadar on Cloud user's role or profile.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click User Management.3. Select the user, and click Edit.4. Modify the role or profile as required, and click Save.5. On the Admin tab, click Deploy Changes.

Disabling a user accountYou can disable a user from accessing QRadar on Cloud.

You cannot delete an existing user. If you want to remove a user from QRadar on Cloud, you must disabletheir accounts.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click User Management.3. Select the user, and click Edit.4. Click Disable.5. On the Admin tab, click Deploy Changes.

The account's Status remains as ACTIVE. But, the User Role shows as Disabled.

Access management to the consoleYou must add the IP addresses for any service that you want to access the IBM QRadar on Cloud console.

IP addresses are whitelisted by adding the classless inter-domain routing (CIDR) values in the /24 - /32range to the Self Serve app Whitelist Management screen.

Generating a new token for a data gatewayYou must have a valid token to install a data gateway for your IBM QRadar on Cloud instance. Yougenerate the token by using the Data Gateway Token Management tool in the Self Serve app.

Before you begin

The Data Gateway Token Management tool shows tokens that are currently in use and expired tokens. Italso shows tokens that are available to use with a data gateway. If there are no available tokens or theexpiry date is too near, you can generate a new token for your data gateway.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click Data Gateway Token Management.3. Enter the IP address for the data gateway in Data Gateway Private IP.

Chapter 8. Self Serve App 29

Page 36: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

4. Enter the number of days that you want the token to be valid for in Expires in (days).

14 is the minimum number of days that you can enter in Expires in (days).5. Click Generate Token.

The token generation can take some time to complete.

You can click the copy icon to copy the token or the hostname URL.

What to do nextYou must ensure that you whitelist the data gateway's IP address. Click Manage whitelists in the DataGateway Token Management screen to add the gateway's CIDR value. For more information, see“Whitelisting an IP address” on page 30.

Whitelisting an IP addressYou whitelist an IP address by adding the classless inter-domain routing (CIDR) value to the WhitelistManagement page.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click Whitelist Management.

The list shows all of your QRadar on Cloud whitelisted CIDRs.3. Click Add.4. Enter the CIDR.

The CIDR value must be in the range /24 - /32.

Private CIDR ranges are restricted, and you cannot add duplicate values.5. Click Save.6. Click Submit, and then click Confirm.

When you click Submit, all of the changes that you made in the table are updated on the server. Duringthe submit, the whitelisted IP address ranges are deleted, and the list is rebuilt. This process can takesome time. If you have several changes to make, make them all before you click Submit.

The table options are unavailable during the submission.

If the connection to the server is lost during the submission, an internal server error is displayed, andyou must reenter the changes.

It can take some time before the whitelisted IP address can access the console. If the IP address stillcannot access the console after a couple of hours, contact IBM Support.

Editing or deleting a whitelisted IP addressYou can update the entry on the Whitelist Management page if the IP address for a device changed. Youcan also delete whitelisted IP addresses if you no longer want them to have access to the console.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click Whitelist Management.3. Click Edit for the value that you want to change.4. Do one of the following steps.

• Edit the CIDR value, and click Save.• Click Delete.

30 QRadar on Cloud : Getting Started Guide

Page 37: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

You must have at least one CIDR value in the table. And you must ensure that the CIDR range thatholds your IP address remains in the table.

5. Click Submit.

Authorized service tokensYou can add and manage authorized service tokens for your IBM QRadar on Cloud instance.

The QRadar RESTful API uses authorized services to authenticate API calls to the console. For moreinformation about the RESTful API, see the QRadar API Guide.

Adding an authorized service tokenWhen you add an authorized service token, you must select a user role and security profile. You can alsoenter the expiry date of the token.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click Authorized Services Management.3. Click Add.4. In Service Name, type a name for this authorized service.5. In User Role, select the user role that you want to assign to this authorized service.

The user roles that are assigned to an authorized service determine the functions that this service canaccess in IBM QRadar on Cloud.

6. In Security Profile, select the security profile that you want to assign to this authorized service.

The security profile determines the networks and log sources that this service can access in IBMQRadar on Cloud.

7. In Expiry Date, type or select a date that you want this service to expire. If an expiry date is notrequired, select No Expiry.

8. Click Save.9. On the Admin tab, click Deploy Changes.

Deleting an authorized services tokenIf you no longer need a token, you can delete it.

Procedure

1. Open the Admin settings, and click QRoC Self Serve.2. Click Authorized Services Management.3. Click the service name.

Select the Service Name, User Role, or Security Profile check boxes to filter the authorized servicetokens.

4. Click Delete.5. On the Admin tab, click Deploy Changes.

Chapter 8. Self Serve App 31

Page 38: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

32 QRadar on Cloud : Getting Started Guide

Page 39: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Chapter 9. QRadar on Cloud work items that require asupport ticket

IBM Security professionals manage your QRadar on Cloud infrastructure. Providing as much informationas possible can help IBM to better help you.

The following table describes the work items that require a support ticket.

Table 7. QRadar on Cloud work items

Work item Description Information that you need toprovide

Authentication Contact support for anyauthentication issues.

Whitelist changes An asset whitelist is a collectionof asset data that overrides theasset reconciliation engine logicabout which data is added to anasset blacklist. When the systemidentifies a blacklist match, itchecks the whitelist to seewhether the value exists. If theasset update matches the datathat is on the whitelist, thechange is reconciled and theasset is updated. Whitelistedasset data is applied globally forall domains.

Provide the network range inClassless Inter-Domain Routing(CIDR) format to add to, orremove from, the whitelist.

Backup Configuration backup occursnightly.

The specific time to take thebackup if it is scheduled outsideof the normal backup time.

Restore Restore a daily backup. The date of the backup torestore, from the last week.

System settings System settings are used toconfigure settings for databases,authentication, Consoles, andmore.

Which setting and value you wantto change. For more informationabout system settings, see theIBM QRadar SIEM AdministrationGuide.

Forwarding destinations androuting rules

You can configure QRadarsystems to forward data to one ormore vendor systems, such asticketing or alerting systems. Youcan also forward normalized datato other QRadar systems. Thetarget system that receives thedata from QRadar is known as aforwarding destination. After youadd one or more forwardingdestinations, you can createfilter-based routing rules toforward large quantities of data.

Details about what to forwardand where to forward it.

For more information aboutforwarding destinations androuting rules, see the IBMQRadar SIEM AdministrationGuide.

© Copyright IBM Corp. 2015, 2019 33

Page 40: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

34 QRadar on Cloud : Getting Started Guide

Page 41: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries.Consult your local IBM representative for information on the products and services currently available inyour area. Any reference to an IBM product, program, or service is not intended to state or imply that onlythat IBM product, program, or service may be used. Any functionally equivalent product, program, orservice that does not infringe any IBM intellectual property right may be used instead. However, it is theuser's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in thisdocument. The furnishing of this document does not grant you any license to these patents. You can sendlicense inquiries, in writing, to:

IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM IntellectualProperty Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR APARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties incertain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodicallymade to the information herein; these changes will be incorporated in new editions of the publication.IBM may make improvements and/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM websites are provided for convenience only and do not inany manner serve as an endorsement of those websites. The materials at those websites are not part ofthe materials for this IBM product and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide in any way it believes appropriate withoutincurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) theexchange of information between independently created programs and other programs (including thisone) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

Such information may be available, subject to appropriate terms and conditions, including in some cases,payment of a fee.

© Copyright IBM Corp. 2015, 2019 35

Page 42: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

The licensed program described in this document and all licensed material available for it are provided byIBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or anyequivalent agreement between us.

The performance data and client examples cited are presented for illustrative purposes only. Actualperformance results may vary depending on specific configurations and operating conditions..

Information concerning non-IBM products was obtained from the suppliers of those products, theirpublished announcements or other publicly available sources. IBM has not tested those products andcannot confirm the accuracy of performance, compatibility or any other claims related to non-IBMproducts. Questions on the capabilities of non-IBM products should be addressed to the suppliers ofthose products.

Statements regarding IBM's future direction or intent are subject to change or withdrawal without notice,and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change withoutnotice. Dealer prices may vary.

This information contains examples of data and reports used in daily business operations. To illustratethem as completely as possible, the examples include the names of individuals, companies, brands, andproducts. All of these names are fictitious and any similarity to actual people or business enterprises isentirely coincidental.

TrademarksIBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International BusinessMachines Corp., registered in many jurisdictions worldwide. Other product and service names might betrademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at"Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Terms and conditions for product documentationPermissions for the use of these publications are granted subject to the following terms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBM website.

Personal use

You may reproduce these publications for your personal, noncommercial use provided that all proprietarynotices are preserved. You may not distribute, display or make derivative work of these publications, orany portion thereof, without the express consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within your enterprise provided thatall proprietary notices are preserved. You may not make derivative works of these publications, orreproduce, distribute or display these publications or any portion thereof outside your enterprise, withoutthe express consent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses or rights are granted, eitherexpress or implied, to the publications or any information, data, software or other intellectual propertycontained therein.

36 QRadar on Cloud : Getting Started Guide

Page 43: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use ofthe publications is detrimental to its interest or, as determined by IBM, the above instructions are notbeing properly followed.

You may not download, export or re-export this information except in full compliance with all applicablelaws and regulations, including all United States export laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS AREPROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

IBM Online Privacy StatementIBM Software products, including software as a service solutions, (“Software Offerings”) may use cookiesor other technologies to collect product usage information, to help improve the end user experience, totailor interactions with the end user or for other purposes. In many cases no personally identifiableinformation is collected by the Software Offerings. Some of our Software Offerings can help enable you tocollect personally identifiable information. If this Software Offering uses cookies to collect personallyidentifiable information, specific information about this offering’s use of cookies is set forth below.

Depending upon the configurations deployed, this Software Offering may use session cookies that collecteach user’s session id for purposes of session management and authentication. These cookies can bedisabled, but disabling them will also eliminate the functionality they enable.

If the configurations deployed for this Software Offering provide you as customer the ability to collectpersonally identifiable information from end users via cookies and other technologies, you should seekyour own legal advice about any laws applicable to such data collection, including any requirements fornotice and consent.

For more information about the use of various technologies, including cookies, for these purposes, SeeIBM’s Privacy Policy at http://www.ibm.com/privacy and IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details the section entitled “Cookies, Web Beacons and Other Technologies” andthe “IBM Software Products and Software-as-a-Service Privacy Statement” at http://www.ibm.com/software/info/product-privacy.

Notices 37

Page 44: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

38 QRadar on Cloud : Getting Started Guide

Page 45: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring
Page 46: QRadar on Cloud - IBM · Chapter 1. QRadar on Cloud overview. In an environment where security requirements are dynamic, IBM QRadar on Cloud provides both the security monitoring

IBM®