You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/search/service-create-private-endpoint.md
+54-64Lines changed: 54 additions & 64 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,17 +14,17 @@ ms.date: 09/12/2022
14
14
15
15
In this article, you'll learn how to secure an Azure Cognitive Search service so that it can't be accessed over the internet:
16
16
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)
21
21
22
22
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/).
23
23
24
24
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).
25
25
26
26
> [!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.
28
28
29
29
## Why use a Private Endpoint for secure access?
30
30
@@ -42,61 +42,58 @@ In this section, you'll create a virtual network and subnet to host the VM that
42
42
43
43
1. From the Azure portal home tab, select **Create a resource** > **Networking** > **Virtual network**.
44
44
45
-
1. In **Create virtual network**, enter or select this information:
45
+
1. In **Create virtual network**, enter or select the following values:
46
46
47
47
| Setting | Value |
48
48
| ------- | ----- |
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. |
54
53
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**.
56
55
57
56
## Create a search service with a private endpoint
58
57
59
58
In this section, you'll create a new Azure Cognitive Search service with a Private Endpoint.
60
59
61
60
1. On the upper-left side of the screen in the Azure portal, select **Create a resource** > **Web** > **Azure Cognitive Search**.
62
61
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:
64
63
65
64
| Setting | Value |
66
65
| ------- | ----- |
67
66
|**PROJECT DETAILS**||
68
67
| 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.|
70
69
|**INSTANCE DETAILS**||
71
70
| 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. |
75
73
76
74
1. Select **Next: Scale**.
77
75
78
-
1.Leave the values as default and select **Next: Networking**.
76
+
1.Accept the defaults and select **Next: Networking**.
79
77
80
78
1. In **New Search Service - Networking**, select **Private** for **Endpoint connectivity(data)**.
81
79
82
-
1.In **New Search Service - Networking**, select**+ Add** under **Private endpoint**.
80
+
1.Select**+ Add** under **Private endpoint**.
83
81
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:
85
83
86
84
| Setting | Value |
87
85
| ------- | ----- |
88
86
| 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**. |
93
91
|**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. |
96
94
|**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**. |
100
97
101
98
1. Select **OK**.
102
99
@@ -122,58 +119,55 @@ In this section, you'll create a new Azure Cognitive Search service with a Priva
122
119
| ------- | ----- |
123
120
|**PROJECT DETAILS**||
124
121
| 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.|
126
123
|**INSTANCE DETAILS**||
127
-
| Virtual machine name | Enter *myVm*. |
128
-
| Region | Select **West US** or whatever region you're using. |
| Size | Accept the default **Standard D2S v3**. |
132
130
|**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-).|
135
133
| Confirm Password | Reenter password. |
136
134
|**INBOUND PORT RULES**||
137
-
| Public inbound ports | Leave the default **Allow selected ports**. |
> 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):
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.
167
161
168
162
1. When you see the **Validation passed** message, select **Create**.
169
163
170
164
## Connect to the VM
171
165
172
-
Download and then connect to the VM *myVm* as follows:
166
+
Download and then connect to the virtual machine as follows:
173
167
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.
175
169
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.
177
171
178
172
1. Select **Download RDP File**. Azure creates a Remote Desktop Protocol (*.rdp*) file and downloads it to your computer.
179
173
@@ -235,13 +229,9 @@ To work around this restriction, connect to Azure portal from a browser on a vir
235
229
236
230
## Clean up resources
237
231
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.
239
233
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**.
0 commit comments