From c9bfa0fedcbcb1f6a266ba71a864ff790867ecd9 Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Tue, 11 Jun 2024 17:22:14 +0530 Subject: [PATCH 1/7] Initial Draft for Documentation --- docs/guides/quickstart-dfp.md | 250 ++++++++++++++++++++++++++++++++++ 1 file changed, 250 insertions(+) create mode 100644 docs/guides/quickstart-dfp.md diff --git a/docs/guides/quickstart-dfp.md b/docs/guides/quickstart-dfp.md new file mode 100644 index 00000000..1ebedfd1 --- /dev/null +++ b/docs/guides/quickstart-dfp.md @@ -0,0 +1,250 @@ +--- +page_title: "Managing DHCP service with the BloxOne Terraform Provider" +subcategory: "Guides" +description: |- + This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage IPAM and DHCP resources. +--- + +# Managing Policy Based DFP service using the BloxOne Terraform Provider + +This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage Security Policies and various Threat Defense objects associated with it. + +## Configuring the Provider + +The provider needs to be configured with an API key and the URL of the Infoblox Cloud Services Portal (CSP). You can get the API Key from the Infoblox Cloud Services Portal (CSP) by following the steps outlined in this guide - [Configuring User API Keys](https://docs.infoblox.com/space/BloxOneCloud/35430405/Configuring+User+API+Keys). + +Create a directory for the Terraform configuration and create a file named `main.tf` with the following content: + +````terraform +terraform { + required_providers { + bloxone = { + source = "infobloxopen/bloxone" + version = ">= 1.0.0" + } + } + required_version = ">= 1.5.0" +} + +provider "bloxone" { + csp_url = "https://csp.infoblox.com" + api_key = "" +} +```` + +!> Warning: Hard-coded credentials are not recommended in any configuration file. It is recommended to use environment variables. + +You can also use the following environment variables to configure the provider: +`BLOXONE_CSP_URL` and `BLOXONE_API_KEY`. + +Initialize the provider by running the following command. This will download the provider and initialize the working directory. + +```shell +terraform init +``` + +## Configuring Resources + +### BloxOne Host on AWS with DFP service + +As the first step, you will also configure a BloxOne Host on AWS with DFP service. +You will use the following module to create these +- [bloxone_infra_host_aws](https://github.com/infobloxopen/terraform-provider-bloxone/tree/master/modules/bloxone_infra_host_aws) + +The module requires the [AWS terraform provider](https://registry.terraform.io/providers/hashicorp/aws/latest) to be configured. +To configure the AWS provider, add the following code to your main.tf: + +````terraform +provider "aws" { + region = "us-west-2" + access_key = "my-access-key" + secret_key = "my-secret-key" +} +```` + +!> Warning: Hard-coded credentials are not recommended in any configuration file. It is recommended to use the AWS credentials file or environment variables. + +You can also use the following environment variables to configure the provider: +`AWS_REGION`, `AWS_ACCESS_KEY_ID`, and `AWS_SECRET_ACCESS_KEY`. + +To create an EC2 instance with DHCP service, you will need to have the following information: +- key_name: The name of the key pair to use for the instance +- subnet_id: The ID of the subnet to launch the instance into +- vpc_security_group_ids: A list of security group IDs to associate with the instance + +Add the following code to your main.tf to create an EC2 instance with DHCP service: + +````terraform + +// Create a BloxOne Host on AWS with DHCP service +module "bloxone_infra_host_aws" { + source = "github.com/infobloxopen/terraform-provider-bloxone//modules/bloxone_infra_host_aws" + + key_name = "my-key" + subnet_id = "subnet-id" + vpc_security_group_ids = ["vpc-security-group-id"] + + services = { + dfp = "start" + } +} +```` + +You will need the pool ID of the AWS host to create the Infra Service block for DFP. `explain how to get the pool ID` +To create the Infra service block , we use the following resource : +- [bloxone_infra_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/infra_service) + +`Add the following code to your main.tf: + +````terraform +resource "bloxone_infra_service" "example" { + name = "example_dfp_service" + pool_id = data.bloxone_infra_hosts.dfp_host.results.0.pool_id + service_type = "dfp" + desired_state = "start" + wait_for_state = false +} +```` + +`explain all 2 blocks below` +Further , we define the following: +- [bloxone_td_internal_domain_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_internal_domain_list) +- [bloxone_dfp_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/dfp_service) + + +````terraform +resource "bloxone_td_internal_domain_list" "example_list" { + name = "example_internal_domain_list" + internal_domains = ["example.domain.com"] +} + +# Create the DFP Service +resource "bloxone_dfp_service" "example" { + service_id = bloxone_infra_service.example.id + + # Other optional fields + internal_domain_lists = [bloxone_td_internal_domain_list.example_list.id] + resolvers_all = [ + { + address = "1.1.1.1" + is_fallback = true + is_local = false + protocols = ["DO53"] + } + ] +} +```` + +You can now run `terraform plan` to see what resources will be created. + +```shell +terraform plan +``` + +### IPAM and DHCP Resources +In this example, you will use the following resources to create a Named/Custom List, Access/Bypass Code, and a Network List/External Network. +`add alternate names for the resources below` +- [bloxone_td_named_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_named_list) +- [bloxone_td_access_code](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_access_code) +- [bloxone_td_network_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_network_list) + +Add the following to the `main.tf` file: + +````terraform +# Create the Named List +resource "bloxone_td_named_list" "example" { + name = "example_named_list" + items_described = [ + { + item = "tf-domain.com" + description = "Example Domain" + } + ] + type = "custom_list" +} + +# Create the Access Code using the Named List +resource "bloxone_td_access_code" "example" { + name = "example_access_code" + activation = timestamp() + expiration = timeadd(timestamp(), "24h") + rules = [ + { + data = bloxone_td_named_list.example.name, + type = bloxone_td_named_list.example.type + } + ] + # Other optional fields + description = "Example Access Code" +} + +# Create the Network List +resource "bloxone_td_network_list" "example" { + name = "example_network_list" + items = ["156.2.3.0/24"] + + # Other optional fields + description = "Example Network List" +} + + +```` + +You can now run `terraform plan` to see what resources will be created. + +```shell +terraform plan +``` + +Finally, you will create the Security Policy that uses Named List, Access Code, and Network List created earlier. + +- [bloxone_td_security_policy](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_security_policy) + +Add the following code to your main.tf: + +````terraform +# Create the Security Policy using the Named List, Network List, and Access Code +resource "bloxone_td_security_policy" "example" { + name = "example_security_policy" + + # Other optional fields + rules = [ + { + action = "action_allow", + data = bloxone_td_named_list.example.name, + type = bloxone_td_named_list.example.type + } + ] + description = "Example Security Policy" + dfps = [bloxone_dfp_service.example.id] + ecs = true + onprem_resolve = true + safe_search = false + tags = { + site = "Site A" + } + network_lists = [bloxone_td_network_list.example.id] + access_codes = [bloxone_td_access_code.example.id] +} +```` + +`explain everthing above` + +You can now run `terraform plan` to see what resources will be created. + +```shell +terraform plan +``` + + +## Applying the Configuration + +To create the resources, run the following command: + +```shell +terraform apply +``` + +## Next steps + +You can also use the BloxOne Terraform Provider to manage other resources such as DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). From a94cfc6b22e388ff25d36db3cd3c290ab0178419 Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Thu, 13 Jun 2024 15:58:40 +0530 Subject: [PATCH 2/7] First Draft for the DFP Workflow --- docs/guides/quickstart-dfp.md | 36 +++++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 14 deletions(-) diff --git a/docs/guides/quickstart-dfp.md b/docs/guides/quickstart-dfp.md index 1ebedfd1..8822196f 100644 --- a/docs/guides/quickstart-dfp.md +++ b/docs/guides/quickstart-dfp.md @@ -7,7 +7,7 @@ description: |- # Managing Policy Based DFP service using the BloxOne Terraform Provider -This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage Security Policies and various Threat Defense objects associated with it. +This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various Threat Defense objects associated with it. ## Configuring the Provider @@ -48,7 +48,8 @@ terraform init ### BloxOne Host on AWS with DFP service As the first step, you will also configure a BloxOne Host on AWS with DFP service. -You will use the following module to create these + +You will use the following module to create it: - [bloxone_infra_host_aws](https://github.com/infobloxopen/terraform-provider-bloxone/tree/master/modules/bloxone_infra_host_aws) The module requires the [AWS terraform provider](https://registry.terraform.io/providers/hashicorp/aws/latest) to be configured. @@ -90,11 +91,12 @@ module "bloxone_infra_host_aws" { } ```` -You will need the pool ID of the AWS host to create the Infra Service block for DFP. `explain how to get the pool ID` +You will need the pool ID of the AWS host to create the Infra Service block for DFP. + To create the Infra service block , we use the following resource : - [bloxone_infra_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/infra_service) -`Add the following code to your main.tf: +Add the following code to your main.tf: ````terraform resource "bloxone_infra_service" "example" { @@ -102,15 +104,17 @@ resource "bloxone_infra_service" "example" { pool_id = data.bloxone_infra_hosts.dfp_host.results.0.pool_id service_type = "dfp" desired_state = "start" - wait_for_state = false } ```` -`explain all 2 blocks below` -Further , we define the following: + +Further , we deploy the DFP Service and create an Internal Domain List using the following resources: - [bloxone_td_internal_domain_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_internal_domain_list) - [bloxone_dfp_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/dfp_service) +We use the service ID of the Infra Service block to create the DFP Service. + +Add the following code to your main.tf: ````terraform resource "bloxone_td_internal_domain_list" "example_list" { @@ -134,6 +138,7 @@ resource "bloxone_dfp_service" "example" { ] } ```` +The `resolvers_all` attribute is used to specify the DNS resolvers for the DFP service. You can now run `terraform plan` to see what resources will be created. @@ -141,12 +146,12 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -### IPAM and DHCP Resources -In this example, you will use the following resources to create a Named/Custom List, Access/Bypass Code, and a Network List/External Network. -`add alternate names for the resources below` -- [bloxone_td_named_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_named_list) -- [bloxone_td_access_code](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_access_code) -- [bloxone_td_network_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_network_list) +### Creating Security Policy and resources associated with it +In this example, you will use the following resources to create a Custom List, Bypass Code and an External Network. + +- [bloxone_td_named_list (Custom List)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_named_list) +- [bloxone_td_access_code (Bypass Code)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_access_code) +- [bloxone_td_network_list (External Network)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_network_list) Add the following to the `main.tf` file: @@ -189,6 +194,7 @@ resource "bloxone_td_network_list" "example" { ```` +The `rules` attribute in the Access code resource is used to specify the Named List. You can now run `terraform plan` to see what resources will be created. @@ -228,7 +234,9 @@ resource "bloxone_td_security_policy" "example" { } ```` -`explain everthing above` +Here the `dfps` attribute is used to associate the Security Policy with the DFP Service. + +The `onprem_resolve` attribute is used to enable the resolution of on-premises domains. You can now run `terraform plan` to see what resources will be created. From ceff937483b83ba5e9393dba8756e0e5e7c901c6 Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Thu, 13 Jun 2024 16:05:10 +0530 Subject: [PATCH 3/7] Resolved build issue --- docs/guides/quickstart-dhcp.md | 2 +- templates/guides/quickstart-dfp.md | 258 ++++++++++++++++++++++++++++ templates/guides/quickstart-dhcp.md | 2 +- 3 files changed, 260 insertions(+), 2 deletions(-) create mode 100644 templates/guides/quickstart-dfp.md diff --git a/docs/guides/quickstart-dhcp.md b/docs/guides/quickstart-dhcp.md index def339c0..3ea62f97 100644 --- a/docs/guides/quickstart-dhcp.md +++ b/docs/guides/quickstart-dhcp.md @@ -251,4 +251,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other resources such as DNS zones, DNS records. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other DNS and DHCP objects. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). diff --git a/templates/guides/quickstart-dfp.md b/templates/guides/quickstart-dfp.md new file mode 100644 index 00000000..8822196f --- /dev/null +++ b/templates/guides/quickstart-dfp.md @@ -0,0 +1,258 @@ +--- +page_title: "Managing DHCP service with the BloxOne Terraform Provider" +subcategory: "Guides" +description: |- + This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage IPAM and DHCP resources. +--- + +# Managing Policy Based DFP service using the BloxOne Terraform Provider + +This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various Threat Defense objects associated with it. + +## Configuring the Provider + +The provider needs to be configured with an API key and the URL of the Infoblox Cloud Services Portal (CSP). You can get the API Key from the Infoblox Cloud Services Portal (CSP) by following the steps outlined in this guide - [Configuring User API Keys](https://docs.infoblox.com/space/BloxOneCloud/35430405/Configuring+User+API+Keys). + +Create a directory for the Terraform configuration and create a file named `main.tf` with the following content: + +````terraform +terraform { + required_providers { + bloxone = { + source = "infobloxopen/bloxone" + version = ">= 1.0.0" + } + } + required_version = ">= 1.5.0" +} + +provider "bloxone" { + csp_url = "https://csp.infoblox.com" + api_key = "" +} +```` + +!> Warning: Hard-coded credentials are not recommended in any configuration file. It is recommended to use environment variables. + +You can also use the following environment variables to configure the provider: +`BLOXONE_CSP_URL` and `BLOXONE_API_KEY`. + +Initialize the provider by running the following command. This will download the provider and initialize the working directory. + +```shell +terraform init +``` + +## Configuring Resources + +### BloxOne Host on AWS with DFP service + +As the first step, you will also configure a BloxOne Host on AWS with DFP service. + +You will use the following module to create it: +- [bloxone_infra_host_aws](https://github.com/infobloxopen/terraform-provider-bloxone/tree/master/modules/bloxone_infra_host_aws) + +The module requires the [AWS terraform provider](https://registry.terraform.io/providers/hashicorp/aws/latest) to be configured. +To configure the AWS provider, add the following code to your main.tf: + +````terraform +provider "aws" { + region = "us-west-2" + access_key = "my-access-key" + secret_key = "my-secret-key" +} +```` + +!> Warning: Hard-coded credentials are not recommended in any configuration file. It is recommended to use the AWS credentials file or environment variables. + +You can also use the following environment variables to configure the provider: +`AWS_REGION`, `AWS_ACCESS_KEY_ID`, and `AWS_SECRET_ACCESS_KEY`. + +To create an EC2 instance with DHCP service, you will need to have the following information: +- key_name: The name of the key pair to use for the instance +- subnet_id: The ID of the subnet to launch the instance into +- vpc_security_group_ids: A list of security group IDs to associate with the instance + +Add the following code to your main.tf to create an EC2 instance with DHCP service: + +````terraform + +// Create a BloxOne Host on AWS with DHCP service +module "bloxone_infra_host_aws" { + source = "github.com/infobloxopen/terraform-provider-bloxone//modules/bloxone_infra_host_aws" + + key_name = "my-key" + subnet_id = "subnet-id" + vpc_security_group_ids = ["vpc-security-group-id"] + + services = { + dfp = "start" + } +} +```` + +You will need the pool ID of the AWS host to create the Infra Service block for DFP. + +To create the Infra service block , we use the following resource : +- [bloxone_infra_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/infra_service) + +Add the following code to your main.tf: + +````terraform +resource "bloxone_infra_service" "example" { + name = "example_dfp_service" + pool_id = data.bloxone_infra_hosts.dfp_host.results.0.pool_id + service_type = "dfp" + desired_state = "start" +} +```` + + +Further , we deploy the DFP Service and create an Internal Domain List using the following resources: +- [bloxone_td_internal_domain_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_internal_domain_list) +- [bloxone_dfp_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/dfp_service) + +We use the service ID of the Infra Service block to create the DFP Service. + +Add the following code to your main.tf: + +````terraform +resource "bloxone_td_internal_domain_list" "example_list" { + name = "example_internal_domain_list" + internal_domains = ["example.domain.com"] +} + +# Create the DFP Service +resource "bloxone_dfp_service" "example" { + service_id = bloxone_infra_service.example.id + + # Other optional fields + internal_domain_lists = [bloxone_td_internal_domain_list.example_list.id] + resolvers_all = [ + { + address = "1.1.1.1" + is_fallback = true + is_local = false + protocols = ["DO53"] + } + ] +} +```` +The `resolvers_all` attribute is used to specify the DNS resolvers for the DFP service. + +You can now run `terraform plan` to see what resources will be created. + +```shell +terraform plan +``` + +### Creating Security Policy and resources associated with it +In this example, you will use the following resources to create a Custom List, Bypass Code and an External Network. + +- [bloxone_td_named_list (Custom List)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_named_list) +- [bloxone_td_access_code (Bypass Code)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_access_code) +- [bloxone_td_network_list (External Network)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_network_list) + +Add the following to the `main.tf` file: + +````terraform +# Create the Named List +resource "bloxone_td_named_list" "example" { + name = "example_named_list" + items_described = [ + { + item = "tf-domain.com" + description = "Example Domain" + } + ] + type = "custom_list" +} + +# Create the Access Code using the Named List +resource "bloxone_td_access_code" "example" { + name = "example_access_code" + activation = timestamp() + expiration = timeadd(timestamp(), "24h") + rules = [ + { + data = bloxone_td_named_list.example.name, + type = bloxone_td_named_list.example.type + } + ] + # Other optional fields + description = "Example Access Code" +} + +# Create the Network List +resource "bloxone_td_network_list" "example" { + name = "example_network_list" + items = ["156.2.3.0/24"] + + # Other optional fields + description = "Example Network List" +} + + +```` +The `rules` attribute in the Access code resource is used to specify the Named List. + +You can now run `terraform plan` to see what resources will be created. + +```shell +terraform plan +``` + +Finally, you will create the Security Policy that uses Named List, Access Code, and Network List created earlier. + +- [bloxone_td_security_policy](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_security_policy) + +Add the following code to your main.tf: + +````terraform +# Create the Security Policy using the Named List, Network List, and Access Code +resource "bloxone_td_security_policy" "example" { + name = "example_security_policy" + + # Other optional fields + rules = [ + { + action = "action_allow", + data = bloxone_td_named_list.example.name, + type = bloxone_td_named_list.example.type + } + ] + description = "Example Security Policy" + dfps = [bloxone_dfp_service.example.id] + ecs = true + onprem_resolve = true + safe_search = false + tags = { + site = "Site A" + } + network_lists = [bloxone_td_network_list.example.id] + access_codes = [bloxone_td_access_code.example.id] +} +```` + +Here the `dfps` attribute is used to associate the Security Policy with the DFP Service. + +The `onprem_resolve` attribute is used to enable the resolution of on-premises domains. + +You can now run `terraform plan` to see what resources will be created. + +```shell +terraform plan +``` + + +## Applying the Configuration + +To create the resources, run the following command: + +```shell +terraform apply +``` + +## Next steps + +You can also use the BloxOne Terraform Provider to manage other resources such as DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). diff --git a/templates/guides/quickstart-dhcp.md b/templates/guides/quickstart-dhcp.md index def339c0..3ea62f97 100644 --- a/templates/guides/quickstart-dhcp.md +++ b/templates/guides/quickstart-dhcp.md @@ -251,4 +251,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other resources such as DNS zones, DNS records. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other DNS and DHCP objects. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). From cf5a2cab6bb6a1570d9a218a3d5b0f7709292a62 Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Thu, 13 Jun 2024 16:11:38 +0530 Subject: [PATCH 4/7] Rollback changes for DFP guide --- docs/guides/quickstart-dhcp.md | 2 +- templates/guides/quickstart-dhcp.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/quickstart-dhcp.md b/docs/guides/quickstart-dhcp.md index 3ea62f97..def339c0 100644 --- a/docs/guides/quickstart-dhcp.md +++ b/docs/guides/quickstart-dhcp.md @@ -251,4 +251,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other DNS and DHCP objects. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other resources such as DNS zones, DNS records. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). diff --git a/templates/guides/quickstart-dhcp.md b/templates/guides/quickstart-dhcp.md index 3ea62f97..def339c0 100644 --- a/templates/guides/quickstart-dhcp.md +++ b/templates/guides/quickstart-dhcp.md @@ -251,4 +251,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other DNS and DHCP objects. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other resources such as DNS zones, DNS records. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). From 231b7d2bf1949e8c5ba914346c0d67334bb528df Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Tue, 18 Jun 2024 12:40:31 +0530 Subject: [PATCH 5/7] Minor changes --- docs/guides/quickstart-dfp.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/guides/quickstart-dfp.md b/docs/guides/quickstart-dfp.md index 8822196f..fe0cfe77 100644 --- a/docs/guides/quickstart-dfp.md +++ b/docs/guides/quickstart-dfp.md @@ -1,13 +1,13 @@ --- -page_title: "Managing DHCP service with the BloxOne Terraform Provider" +page_title: "Managing Policy Based DFP service using the BloxOne Terraform Provider" subcategory: "Guides" description: |- - This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage IPAM and DHCP resources. + This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various resources associated to it. --- # Managing Policy Based DFP service using the BloxOne Terraform Provider -This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various Threat Defense objects associated with it. +This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various resources associated to it. ## Configuring the Provider @@ -47,7 +47,7 @@ terraform init ### BloxOne Host on AWS with DFP service -As the first step, you will also configure a BloxOne Host on AWS with DFP service. +As the first step, you will configure a BloxOne Host on AWS with DFP service. You will use the following module to create it: - [bloxone_infra_host_aws](https://github.com/infobloxopen/terraform-provider-bloxone/tree/master/modules/bloxone_infra_host_aws) @@ -108,7 +108,7 @@ resource "bloxone_infra_service" "example" { ```` -Further , we deploy the DFP Service and create an Internal Domain List using the following resources: +Next , we create the DFP Service block and an Internal Domain List using the following resources: - [bloxone_td_internal_domain_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_internal_domain_list) - [bloxone_dfp_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/dfp_service) @@ -146,7 +146,7 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -### Creating Security Policy and resources associated with it +### Creating the Security Policy and Resources associated with it In this example, you will use the following resources to create a Custom List, Bypass Code and an External Network. - [bloxone_td_named_list (Custom List)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_named_list) @@ -194,7 +194,7 @@ resource "bloxone_td_network_list" "example" { ```` -The `rules` attribute in the Access code resource is used to specify the Named List. +The `rules` attribute in the Access code resource is used to specify the Named List created earlier. You can now run `terraform plan` to see what resources will be created. @@ -202,7 +202,7 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -Finally, you will create the Security Policy that uses Named List, Access Code, and Network List created earlier. +Finally, you will create the Security Policy that uses the Custom List, Bypass Code and an External Network created earlier. - [bloxone_td_security_policy](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_security_policy) @@ -255,4 +255,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other resources such as DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). From 26b3b3837647d3f3f66a57427dadfccea049690a Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Tue, 18 Jun 2024 13:03:58 +0530 Subject: [PATCH 6/7] Generated docs --- docs/guides/quickstart-dfp.md | 2 +- templates/guides/quickstart-dfp.md | 18 +++++++++--------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/guides/quickstart-dfp.md b/docs/guides/quickstart-dfp.md index fe0cfe77..0774dd12 100644 --- a/docs/guides/quickstart-dfp.md +++ b/docs/guides/quickstart-dfp.md @@ -255,4 +255,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). diff --git a/templates/guides/quickstart-dfp.md b/templates/guides/quickstart-dfp.md index 8822196f..0774dd12 100644 --- a/templates/guides/quickstart-dfp.md +++ b/templates/guides/quickstart-dfp.md @@ -1,13 +1,13 @@ --- -page_title: "Managing DHCP service with the BloxOne Terraform Provider" +page_title: "Managing Policy Based DFP service using the BloxOne Terraform Provider" subcategory: "Guides" description: |- - This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage IPAM and DHCP resources. + This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various resources associated to it. --- # Managing Policy Based DFP service using the BloxOne Terraform Provider -This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various Threat Defense objects associated with it. +This guide provides step-by-step instructions for using the BloxOne Terraform Provider to manage the DFP Service , Security Policies and various resources associated to it. ## Configuring the Provider @@ -47,7 +47,7 @@ terraform init ### BloxOne Host on AWS with DFP service -As the first step, you will also configure a BloxOne Host on AWS with DFP service. +As the first step, you will configure a BloxOne Host on AWS with DFP service. You will use the following module to create it: - [bloxone_infra_host_aws](https://github.com/infobloxopen/terraform-provider-bloxone/tree/master/modules/bloxone_infra_host_aws) @@ -108,7 +108,7 @@ resource "bloxone_infra_service" "example" { ```` -Further , we deploy the DFP Service and create an Internal Domain List using the following resources: +Next , we create the DFP Service block and an Internal Domain List using the following resources: - [bloxone_td_internal_domain_list](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_internal_domain_list) - [bloxone_dfp_service](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/dfp_service) @@ -146,7 +146,7 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -### Creating Security Policy and resources associated with it +### Creating the Security Policy and Resources associated with it In this example, you will use the following resources to create a Custom List, Bypass Code and an External Network. - [bloxone_td_named_list (Custom List)](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_named_list) @@ -194,7 +194,7 @@ resource "bloxone_td_network_list" "example" { ```` -The `rules` attribute in the Access code resource is used to specify the Named List. +The `rules` attribute in the Access code resource is used to specify the Named List created earlier. You can now run `terraform plan` to see what resources will be created. @@ -202,7 +202,7 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -Finally, you will create the Security Policy that uses Named List, Access Code, and Network List created earlier. +Finally, you will create the Security Policy that uses the Custom List, Bypass Code and an External Network created earlier. - [bloxone_td_security_policy](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_security_policy) @@ -255,4 +255,4 @@ terraform apply ## Next steps -You can also use the BloxOne Terraform Provider to manage other resources such as DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). +You can also use the BloxOne Terraform Provider to manage other DNS and DHCP/IPAM resources. For more information, see the [BloxOne Terraform Provider documentation](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs). From e54db4ca96bc840c274918f8ad2cb6489c62dd89 Mon Sep 17 00:00:00 2001 From: Ujjwal Nasra Date: Fri, 26 Jul 2024 17:21:32 +0530 Subject: [PATCH 7/7] Addressed Review Comments --- docs/guides/quickstart-dfp.md | 6 +++--- templates/guides/quickstart-dfp.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/guides/quickstart-dfp.md b/docs/guides/quickstart-dfp.md index 0774dd12..de90a99c 100644 --- a/docs/guides/quickstart-dfp.md +++ b/docs/guides/quickstart-dfp.md @@ -68,7 +68,7 @@ provider "aws" { You can also use the following environment variables to configure the provider: `AWS_REGION`, `AWS_ACCESS_KEY_ID`, and `AWS_SECRET_ACCESS_KEY`. -To create an EC2 instance with DHCP service, you will need to have the following information: +To create an EC2 instance with DFP service, you will need to have the following information: - key_name: The name of the key pair to use for the instance - subnet_id: The ID of the subnet to launch the instance into - vpc_security_group_ids: A list of security group IDs to associate with the instance @@ -123,7 +123,7 @@ resource "bloxone_td_internal_domain_list" "example_list" { } # Create the DFP Service -resource "bloxone_dfp_service" "example" { +resource "bloxone_dfp_service" "example_dfp_service" { service_id = bloxone_infra_service.example.id # Other optional fields @@ -202,7 +202,7 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -Finally, you will create the Security Policy that uses the Custom List, Bypass Code and an External Network created earlier. +Finally, you will create a Security Policy that uses the DFP Service, Custom List, Bypass Code and an External Network created earlier. - [bloxone_td_security_policy](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_security_policy) diff --git a/templates/guides/quickstart-dfp.md b/templates/guides/quickstart-dfp.md index 0774dd12..de90a99c 100644 --- a/templates/guides/quickstart-dfp.md +++ b/templates/guides/quickstart-dfp.md @@ -68,7 +68,7 @@ provider "aws" { You can also use the following environment variables to configure the provider: `AWS_REGION`, `AWS_ACCESS_KEY_ID`, and `AWS_SECRET_ACCESS_KEY`. -To create an EC2 instance with DHCP service, you will need to have the following information: +To create an EC2 instance with DFP service, you will need to have the following information: - key_name: The name of the key pair to use for the instance - subnet_id: The ID of the subnet to launch the instance into - vpc_security_group_ids: A list of security group IDs to associate with the instance @@ -123,7 +123,7 @@ resource "bloxone_td_internal_domain_list" "example_list" { } # Create the DFP Service -resource "bloxone_dfp_service" "example" { +resource "bloxone_dfp_service" "example_dfp_service" { service_id = bloxone_infra_service.example.id # Other optional fields @@ -202,7 +202,7 @@ You can now run `terraform plan` to see what resources will be created. terraform plan ``` -Finally, you will create the Security Policy that uses the Custom List, Bypass Code and an External Network created earlier. +Finally, you will create a Security Policy that uses the DFP Service, Custom List, Bypass Code and an External Network created earlier. - [bloxone_td_security_policy](https://registry.terraform.io/providers/infobloxopen/bloxone/latest/docs/resources/td_security_policy)