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/frontdoor/endpoint.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,59 +6,59 @@ services: frontdoor
6
6
author: duongau
7
7
ms.service: azure-frontdoor
8
8
ms.topic: conceptual
9
-
ms.date: 08/09/2023
9
+
ms.date: 11/13/2024
10
10
ms.author: duau
11
11
---
12
12
13
13
# Endpoints in Azure Front Door
14
14
15
-
In Azure Front Door, an *endpoint* is a logical grouping of one or more routes that are associated with domain names. Each endpoint is [assigned a domain name](#endpoint-domain-names) by Front Door, and you can associate your own custom domains by using routes.
15
+
In Azure Front Door, an *endpoint* is a logical grouping of one or more routes associated with domain names. Each endpoint is [assigned a domain name](#endpoint-domain-names) by Front Door, and you can also associate your own custom domains using routes.
16
16
17
17
## How many endpoints should I create?
18
18
19
-
A Front Door profile can contain multiple endpoints. However, in many situations you might only need a single endpoint.
19
+
A Front Door profile can contain multiple endpoints, but in many cases, a single endpoint might suffice.
20
20
21
-
When you're planning the endpoints to create, consider the following factors:
21
+
Consider the following factors when planning your endpoints:
22
22
23
-
- If all of your domains use the same or similar route paths, it's probably best to combine them into a single endpoint.
24
-
- If you use different routes and route paths for each domain, consider using separate endpoints, such as by having an endpoint for each custom domain.
25
-
- If you need to enable or disable all of your domains together, consider using a single endpoint. An entire endpoint can be enabled or disabled together.
23
+
- If all your domains use the same or similar route paths, it's likely best to combine them into a single endpoint.
24
+
- If you use different routes and route paths for each domain, consider creating separate endpoints, such as one for each custom domain.
25
+
- If you need to enable or disable all your domains together, consider using a single endpoint, as an entire endpoint can be enabled or disabled at once.
26
26
27
27
## Endpoint domain names
28
28
29
29
Endpoint domain names are automatically generated when you create a new endpoint. Front Door generates a unique domain name based on several components, including:
30
30
31
31
- The endpoint's name.
32
-
- A pseudorandom hash value, which gets determined by Front Door. By using hash values as part of the domain name, Front Door helps to protect against [subdomain takeover](../security/fundamentals/subdomain-takeover.md) attacks.
33
-
- The base domain name for your Front Door environment. Generally is`z01.azurefd.net`.
32
+
- A pseudorandom hash valuedetermined by Front Door, which helps protect against [subdomain takeover](../security/fundamentals/subdomain-takeover.md) attacks.
33
+
- The base domain name for your Front Door environment, generally`z01.azurefd.net`.
34
34
35
-
For example, suppose you have created an endpoint named `myendpoint`. The endpoint domain name might be `myendpoint-mdjf2jfgjf82mnzx.z01.azurefd.net`.
35
+
For example, if you create an endpoint named `myendpoint`, the endpoint domain name might be `myendpoint-mdjf2jfgjf82mnzx.z01.azurefd.net`.
36
36
37
37
The endpoint domain is accessible when you associate it with a route.
38
38
39
39
### Reuse of an endpoint domain name
40
40
41
-
When you delete and redeploy an endpoint, you might expect to get the same pseudorandom hash value, and therefore the same endpoint domain name. Front Door enables you to control how the pseudorandom hash values are reused on an endpoint-by-endpoint basis.
41
+
When you delete and redeploy an endpoint, you might expect to get the same pseudorandom hash value and, therefore, the same endpoint domain name. Front Door allows you to control how these pseudorandom hash values are reused on an endpoint-by-endpoint basis.
42
42
43
43
An endpoint's domain can be reused within the same tenant, subscription, or resource group scope level. You can also choose to not allow the reuse of an endpoint domain. By default, Front Door allows reuse of the endpoint domain within the same Microsoft Entra tenant.
44
44
45
-
You can use Bicep, an Azure Resource Manager template (ARM template), the Azure CLI, or Azure PowerShell to configure the scope level of the endpoint's domain reuse behavior. You can also configure it for all Front Door endpoints in your whole organization by using Azure Policy. The Azure portal uses the scope level you define through the command line once it has been changed.
45
+
You can configure the scope level of the endpoint's domain reuse behavior using Bicep, an Azure Resource Manager (ARM) template, the Azure CLI, or Azure PowerShell. Additionally, you can configure it for all Front Door endpoints in your organization using Azure Policy. The Azure portal uses the scope level you define through the command line once it has been changed.
46
46
47
47
The following table lists the allowable values for the endpoint's domain reuse behavior:
48
48
49
49
| Value | Description |
50
50
|--|--|
51
51
|`TenantReuse`| This is the default value. Endpoints with the same name in the same Microsoft Entra tenant receive the same domain label. |
52
52
|`SubscriptionReuse`| Endpoints with the same name in the same Azure subscription receive the same domain label. |
53
-
|`ResourceGroupReuse`| Endpoints with the same name in the same resource group receives the same domain label. |
53
+
|`ResourceGroupReuse`| Endpoints with the same name in the same resource group receive the same domain label. |
54
54
|`NoReuse`| Endpoints always receive a new domain label. |
55
55
56
56
> [!NOTE]
57
-
> You can't modify the reuse behavior of an existing Front Door endpoint. The reuse behavior only applies to newly created endpoints.
57
+
> The reuse behavior cannot be modified for an existing Front Door endpoint. It only applies to newly created endpoints.
58
58
59
-
The following example shows how to create a new Front Door endpoint with a reuse scope of`SubscriptionReuse`:
59
+
The following examples demonstrate how to create a new Front Door endpoint with the reuse scope set to`SubscriptionReuse`:
0 commit comments