Applying security group rules to source and destination IP addresses

Creating security group rules in the UI

You can create inbound and outbound rules during or after the provisioning of a security group.

1. From your browser, open the IBM Cloud console.

2. Select the Navigation Menu icon , then click VPC Infrastructure.

3. Click Security groups.

4. From the Security groups for VPC table, choose one of the following:

   • To create rules when provisioning a new security group, click Create, then follow instructions in Setting up a security group for your resource.
   • To create rules for an existing security group, click the name of the security group to view its Details page, then continue to step 4.

5. To create and manage rules, select the Rules tab.

6. Choose one of the following:

   • To create an inbound rule, select Create on the Inbound rules table, and complete the following fields. Then, click Create.

     • Protocol - Specify the protocol to enforce (TCP, UDP, ICMP, or ALL).
     • Port- Specify the ports to which the rule applies. Select Any or specify a Port range (min and max port values). Port values for TCP and UDP must be numbers between 1 and 65535. Valid port values for ICMP are from 0 to 254.
     • Source type - Select the set of network interfaces from which this rule allows traffic. You can select Any, IP address, or CIDR block for inbound, permitted traffic. Alternatively, you can specify a security group in the same VPC to allow traffic to or from all instances that are attached to the selected security group.
     • Destination type - Select Any, IP address, or CIDR block.

   • To create an outbound rule, select Create on the Outbound rules table, and complete the following fields. Then, click Create.

     • Protocol - Specify the protocol to enforce (TCP, UDP, ICMP, or ALL).
     • Port - Specify the ports to which the rule applies. Select Any or specify a Port range (min and max port values). Port values for TCP and UDP must be numbers between 1 and 65535. Valid port values for ICMP are from 0 to 254.
     • Destination type - Select Any, IP address, CIDR block, or Security group.
     • Source type - Select Any, IP address, or CIDR block.

Creating security group rules from the CLI

To create security group rules (inbound and outbound) by using the CLI, enter the following command.

ibmcloud is security-group-rule-add GROUP DIRECTION PROTOCOL [--vpc VPC] [--local LOCAL_ADDRESS | CIDR_BLOCK] [--remote REMOTE_ADDRESS | CIDR_BLOCK | SECURITY_GROUP] [--icmp-type ICMP_TYPE [--icmp-code ICMP_CODE]] [--port-min PORT_MIN] [--port-max PORT_MAX] [--output JSON] [-q, --quiet]

Where:

GROUP

ID or name of the security group.

DIRECTION

Direction of traffic to enforce. One of: inbound, outbound.

PROTOCOL

Protocol to which the rule applies. One of: tcp, udp, icmp, or all.

--vpc

ID or name of the VPC. This option is required only to specify the unique resource by name inside this VPC.

--local

Local IP address or range of local IP addresses to which this rule allows inbound traffic (or from which, for outbound traffic). Can be specified as an IP address or a CIDR block. One of: LOCAL_ADDRESS, CIDR_BLOCK. A CIDR block of 0.0.0.0/0 allows traffic to all local IP addresses (or from all local IP addresses, for outbound rules).

--remote

The set of network interfaces from which this rule allows traffic. It can be specified as either a REMOTE_ADDRESS, CIDR_BLOCK, or SECURITY_GROUP. If unspecified, then traffic is allowed from any source (or to any source, for outbound rules).

--icmp-type

ICMP traffic type to allow. Valid values from 0 to 254. This option is specified only when protocol is set to icmp. If unspecified, all types are allowed.

--icmp-code

ICMP traffic code to allow. Valid values from 0 to 255. This option is specified only when protocol is set to icmp. If unspecified, all codes are allowed.

-port-min

Minimum port number. Valid values are from 1 to 65535. This option is specified only when protocol is set to tcp or udp. If unspecified, all ports are allowed (default: 1).

--port-max

Maximum port number. Valid values are from 1 to 65535. This option is specified only when protocol is set to tcp or udp. If unspecified, all ports are allowed (default: 65535).

--output

Output format. One of JSON.

--q, --quiet

Suppress verbose output.

Creating security group rules with the API

The security group rule POST request accepts an optional property named local, which has two attributes:

address

The IP address to which this rule allows inbound traffic (or from which, for outbound rules).

cidr_block

The IP address range to which this rule allows inbound traffic (or from which, for outbound rules).

If the local property is not specified, the default value is cidr_block: 0.0.0.0/0.

You can create security group rules by using the API:

1. Set up your API environment with the correct variables.

2. Store the security group identifier in a variable to be used in the API commands:

   export security_group_id=<security_group_id>
   

3. To create a security group rule that allows inbound TCP traffic from remote address range 10.1.2.0/24 to local IP address 192.168.1.100, run the following command:

      curl -sX POST "$vpc_api_endpoint/v1/security_groups/$security_group_id/rules?version=$version&generation=2" \
        -H "Authorization: Bearer ${iam_token}" \
        -d '{
              "direction": "inbound",
              "local": {
                "address": "192.168.1.100"
              }
              "protocol": "tcp",
              "remote": {
                "cidr_block": "10.1.2.0/24"
              }
            }'
   

   Sample output:

   {
     "direction": "inbound",
     "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/r006-568b4cc2-b6d1-4ee4-898a-841be283a4cd/rules/r006-8d123cf9-9a4e-48d9-ad5e-dabf1e5b5773",
     "id": "r006-8d123cf9-9a4e-48d9-ad5e-dabf1e5b5773",
     "ip_version": "ipv4",
     "local": {
       "address": "192.168.1.100"
     }
     "protocol": "tcp",
     "remote": {
       "cidr_block": "10.1.2.0/24"
     }
   }
   

Creating security group rules with Terraform

To use Terraform, download the Terraform CLI and configure the IBM Cloud Provider plug-in. For more information, see Getting started with Terraform.

The following Terraform example shows how to create inbound security group rules. The local parameter in the resource accepts an IP address or CIDR block and is also in the response state and response of data sources ibm_is_security_group_rules and ibm_is_security_group_rule.

resource "ibm_is_security_group_rule" "example2" {
  group     = ibm_is_security_group.example.id
  direction = "inbound"
  remote    = "127.0.0.1"
  local = "192.168.3.0/24"
  udp {
    port_min = 805
    port_max = 807
  }
}