Skip to content

Commit ba29eda

Browse files
committed
Edits per testing
1 parent 40504a1 commit ba29eda

File tree

1 file changed

+54
-64
lines changed

1 file changed

+54
-64
lines changed

articles/search/service-create-private-endpoint.md

Lines changed: 54 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,17 @@ ms.date: 09/12/2022
1414

1515
In this article, you'll learn how to secure an Azure Cognitive Search service so that it can't be accessed over the internet:
1616

17-
+ [Create an Azure virtual network](#create-the-virtual-network) or use an existing one
18-
+ [Create or update a search service to use a private endpoint](#create-a-search-service-with-a-private-endpoint)
19-
+ [Configure an Azure virtual machine in the same virtual network](#create-a-virtual-machine)
20-
+ [Connect to the search service using a browser session on the virtual machine](#connect-to-the-vm)
17+
+ [Create an Azure virtual network](#create-the-virtual-network) (or use an existing one)
18+
+ [Create a search service to use a private endpoint](#create-a-search-service-with-a-private-endpoint)
19+
+ [Create a Azure virtual machine in the same virtual network](#create-a-virtual-machine)
20+
+ [Connect to search using a browser session on the virtual machine](#connect-to-the-vm)
2121

2222
Private endpoints are provided by [Azure Private Link](../private-link/private-link-overview.md), as a separate billable service. For more information about costs, see the [pricing page](https://azure.microsoft.com/pricing/details/private-link/).
2323

2424
You can create a private endpoint in the Azure portal, as described in this article. Alternatively, you can use the [Management REST API version 2020-03-13](/rest/api/searchmanagement/), [Azure PowerShell](/powershell/module/az.search), or [Azure CLI](/cli/azure/search).
2525

2626
> [!NOTE]
27-
> Once a search service is configured for private link, portal access a search service must be initiated from a browser session on a virtual machine inside the virtual network. See [this step](#portal-access-private-search-service) for details.
27+
> Once a search service has a private endpoint, portal access to that service must be initiated from a browser session on a virtual machine inside the virtual network. See [this step](#portal-access-private-search-service) for details.
2828
2929
## Why use a Private Endpoint for secure access?
3030

@@ -42,61 +42,58 @@ In this section, you'll create a virtual network and subnet to host the VM that
4242

4343
1. From the Azure portal home tab, select **Create a resource** > **Networking** > **Virtual network**.
4444

45-
1. In **Create virtual network**, enter or select this information:
45+
1. In **Create virtual network**, enter or select the following values:
4646

4747
| Setting | Value |
4848
| ------- | ----- |
49-
| Subscription | Select your subscription|
50-
| Resource group | Select **Create new**, enter *myResourceGroup*, then select **OK** |
51-
| Name | Enter *MyVirtualNetwork* |
52-
| Region | Select your desired region |
53-
|||
49+
| Subscription | Select your subscription.|
50+
| Resource group | Select **Create new**, enter a name, such as "myResourceGroup", then select **OK**. |
51+
| Name | Enter a name, such as "MyVirtualNetwork". |
52+
| Region | Select a region. |
5453

55-
1. Leave the defaults for the rest of the settings. Select **Review + create** and then **Create**
54+
1. Accept the defaults for the rest of the settings. Select **Review + create** and then **Create**.
5655

5756
## Create a search service with a private endpoint
5857

5958
In this section, you'll create a new Azure Cognitive Search service with a Private Endpoint.
6059

6160
1. On the upper-left side of the screen in the Azure portal, select **Create a resource** > **Web** > **Azure Cognitive Search**.
6261

63-
1. In **New Search Service - Basics**, enter or select this information:
62+
1. In **New Search Service - Basics**, enter or select the following values:
6463

6564
| Setting | Value |
6665
| ------- | ----- |
6766
| **PROJECT DETAILS** | |
6867
| Subscription | Select your subscription. |
69-
| Resource group | Select **myResourceGroup**, which you created in the previous section.|
68+
| Resource group | Use the resource group that you created in the previous step.|
7069
| **INSTANCE DETAILS** | |
7170
| URL | Enter a unique name. |
72-
| Location | Select your desired region. |
73-
| Pricing tier | Select **Change Pricing Tier** and choose your desired service tier. (Not support on **Free** tier. Must be **Basic** or higher.) |
74-
|||
71+
| Location | Select your region. |
72+
| Pricing tier | Select **Change Pricing Tier** and choose your desired service tier. Private endpoints aren't supported on the **Free** tier. You must select **Basic** or higher. |
7573

7674
1. Select **Next: Scale**.
7775

78-
1. Leave the values as default and select **Next: Networking**.
76+
1. Accept the defaults and select **Next: Networking**.
7977

8078
1. In **New Search Service - Networking**, select **Private** for **Endpoint connectivity(data)**.
8179

82-
1. In **New Search Service - Networking**, select **+ Add** under **Private endpoint**.
80+
1. Select **+ Add** under **Private endpoint**.
8381

84-
1. In **Create Private Endpoint**, enter or select the following values:
82+
1. In **Create Private Endpoint**, enter or select values that associate your search service with the virtual network you created:
8583

8684
| Setting | Value |
8785
| ------- | ----- |
8886
| Subscription | Select your subscription. |
89-
| Resource group | Select **myResourceGroup**, which you created in the previous section.|
90-
| Location | Select **West US**.|
91-
| Name | Enter *myPrivateEndpoint*. |
92-
| Target subresource | Leave the default **searchService**. |
87+
| Resource group | Use the resource group that you created in the previous step. |
88+
| Location | Select a region. |
89+
| Name | Enter a name, such as "myPrivateEndpoint". |
90+
| Target subresource | Accept the default **searchService**. |
9391
| **NETWORKING** | |
94-
| Virtual network | Select *MyVirtualNetwork* from resource group *myResourceGroup*. |
95-
| Subnet | Select *mySubnet*. |
92+
| Virtual network | Select the virtual network you created in the previous step. |
93+
| Subnet | Select the default. |
9694
| **PRIVATE DNS INTEGRATION** | |
97-
| Integrate with private DNS zone | Leave the default **Yes**. |
98-
| Private DNS zone | Leave the default ** (New) privatelink.search.windows.net**. |
99-
|||
95+
| Integrate with private DNS zone | Accept the default "Yes". |
96+
| Private DNS zone | Accept the default **(New) privatelink.search.windows.net**. |
10097

10198
1. Select **OK**.
10299

@@ -122,58 +119,55 @@ In this section, you'll create a new Azure Cognitive Search service with a Priva
122119
| ------- | ----- |
123120
| **PROJECT DETAILS** | |
124121
| Subscription | Select your subscription. |
125-
| Resource group | Select **myResourceGroup**, which you created in the previous section. |
122+
| Resource group | Use the resource group that you created in the previous section.|
126123
| **INSTANCE DETAILS** | |
127-
| Virtual machine name | Enter *myVm*. |
128-
| Region | Select **West US** or whatever region you're using. |
129-
| Availability options | Leave the default **No infrastructure redundancy required**. |
130-
| Image | Select **Windows Server 2019 Datacenter**. |
131-
| Size | Leave the default **Standard DS1 v2**. |
124+
| Virtual machine name | Enter a name, such as "my-vm". |
125+
| Region | Select your region. |
126+
| Availability options | You can choose **No infrastructure redundancy required**, or select another option if you need the functionality. |
127+
| Image | Select **Windows Server 2022 Datacenter: Azure Edition - Gen2**. |
128+
| VM architecture | Accept the default **x64**. |
129+
| Size | Accept the default **Standard D2S v3**. |
132130
| **ADMINISTRATOR ACCOUNT** | |
133-
| Username | Enter a username of your choosing. |
134-
| Password | Enter a password of your choosing. The password must be at least 12 characters long and meet the [defined complexity requirements](../virtual-machines/windows/faq.yml?toc=%2fazure%2fvirtual-network%2ftoc.json#what-are-the-password-requirements-when-creating-a-vm-).|
131+
| Username | Enter the user name of the administrator.. |
132+
| Password | Enter the password. The password must be at least 12 characters long and meet the [defined complexity requirements](../virtual-machines/windows/faq.yml?toc=%2fazure%2fvirtual-network%2ftoc.json#what-are-the-password-requirements-when-creating-a-vm-).|
135133
| Confirm Password | Reenter password. |
136134
| **INBOUND PORT RULES** | |
137-
| Public inbound ports | Leave the default **Allow selected ports**. |
138-
| Select inbound ports | Leave the default **RDP (3389)**. |
139-
| **SAVE MONEY** | |
140-
| Already have a Windows license? | Leave the default **No**. |
141-
|||
135+
| Public inbound ports | Accept the default **Allow selected ports**. |
136+
| Select inbound ports | Accept the default **RDP (3389)**. |
142137

143138
1. Select **Next: Disks**.
144139

145-
1. In **Create a virtual machine - Disks**, leave the defaults and select **Next: Networking**.
140+
1. In **Create a virtual machine - Disks**, accept the defaults and select **Next: Networking**.
146141

147-
1. In **Create a virtual machine - Networking**, select this information:
142+
1. In **Create a virtual machine - Networking**, provide the following values:
148143

149144
| Setting | Value |
150145
| ------- | ----- |
151-
| Virtual network | Leave the default **MyVirtualNetwork**. |
152-
| Address space | Leave the default **10.1.0.0/24**.|
153-
| Subnet | Leave the default **mySubnet (10.1.0.0/24)**.|
154-
| Public IP | Leave the default **(new) myVm-ip**. |
155-
| Public inbound ports | Select **Allow selected ports**. |
156-
| Select inbound ports | Select **HTTP** and **RDP**.|
157-
||
146+
| Virtual network | Select the virtual network you created in a previous step. |
147+
| Subnet | Accept the default (10.1.0.0/24).|
148+
| NIC network security group | Accept the default "Basic" |
149+
| Public IP | Accept the default "(new) myVm-ip". |
150+
| Public inbound ports | Select the default "Allow selected ports". |
151+
| Select inbound ports | Select "HTTP 80", "HTTPS (443)" and "RDP (3389)".|
158152

159153
> [!NOTE]
160154
> IPv4 addresses can be expressed in [CIDR](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) format. Remember to avoid the IP range reserved for private networking, as described in [RFC 1918](https://tools.ietf.org/html/rfc1918):
161155
>
162-
> - `10.0.0.0 - 10.255.255.255 (10/8 prefix)`
163-
> - `172.16.0.0 - 172.31.255.255 (172.16/12 prefix)`
164-
> - `192.168.0.0 - 192.168.255.255 (192.168/16 prefix)`
156+
> + `10.0.0.0 - 10.255.255.255 (10/8 prefix)`
157+
> + `172.16.0.0 - 172.31.255.255 (172.16/12 prefix)`
158+
> + `192.168.0.0 - 192.168.255.255 (192.168/16 prefix)`
165159
166-
1. Select **Review + create**. You're taken to the **Review + create** page where Azure validates your configuration.
160+
1. Select **Review + create** for a validation check.
167161

168162
1. When you see the **Validation passed** message, select **Create**.
169163

170164
## Connect to the VM
171165

172-
Download and then connect to the VM *myVm* as follows:
166+
Download and then connect to the virtual machine as follows:
173167

174-
1. In the portal's search bar, enter *myVm*.
168+
1. In the portal's search bar, search for the virtual machine created in the previous step.
175169

176-
1. Select the **Connect** button. After selecting the **Connect** button, **Connect to virtual machine** opens.
170+
1. Select **Connect**. After selecting the **Connect** button, **Connect to virtual machine** opens.
177171

178172
1. Select **Download RDP File**. Azure creates a Remote Desktop Protocol (*.rdp*) file and downloads it to your computer.
179173

@@ -235,13 +229,9 @@ To work around this restriction, connect to Azure portal from a browser on a vir
235229
236230
## Clean up resources
237231
238-
When you're done using the Private Endpoint, search service, and the VM, delete the resource group and all of the resources it contains:
232+
When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money.
239233
240-
1. Enter *myResourceGroup* in the **Search** box at the top of the portal and select *myResourceGroup* from the search results.
241-
242-
1. Select **Delete resource group**.
243-
244-
1. Enter *myResourceGroup* for **TYPE THE RESOURCE GROUP NAME** and select **Delete**.
234+
You can delete individual resources or the resource group to delete everything you created in this exercise. Select the resource group on any resource's overview page, and then select **Delete**.
245235
246236
## Next steps
247237

0 commit comments

Comments
 (0)