diff --git a/apps/docs/redirects/en/01.json b/apps/docs/redirects/en/01.json index 0891833877..1c97f1a4a6 100644 --- a/apps/docs/redirects/en/01.json +++ b/apps/docs/redirects/en/01.json @@ -961,7 +961,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/build/applications/error-responses/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/error-responses/" + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/error-responses/" }, { "from": "https://www.azion.com/en/documentation/products/build/applications/first-steps/", @@ -1117,7 +1117,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/build/edge-application/error-responses/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/error-responses/" + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/error-responses/" }, { "from": "https://www.azion.com/en/documentation/products/build/edge-application/first-steps/", @@ -1717,7 +1717,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/edge-application/error-responses/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/error-responses/" + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/error-responses/" }, { "from": "https://www.azion.com/en/documentation/products/edge-application/first-steps/", @@ -3793,7 +3793,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/secure/custom-pages/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/settings/" + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/settings/" }, { "from": "https://www.azion.com/en/documentation/products/secure/edge-connector/", @@ -3837,7 +3837,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/secure/edge-firewall/digital-certificates/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/certificates/" + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/certificates/" }, { "from": "https://www.azion.com/en/documentation/products/secure/edge-firewall/edge-functions-instances/", @@ -3893,7 +3893,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/secure/firewall/certificate-manager/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/certificates/" + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/certificates/" }, { "from": "https://www.azion.com/en/documentation/products/secure/firewall/ddos-protection/", @@ -3937,7 +3937,7 @@ }, { "from": "https://www.azion.com/en/documentation/products/secure/firewall/wildcard-lets-encrypt-certificates/", - "moved": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/" + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/issuance-and-renewal/" }, { "from": "https://www.azion.com/en/documentation/products/secure/intelligent-dns/", @@ -4562,5 +4562,45 @@ { "from": "https://www.azion.com/en/documentation/secure/bot-manager/examples/", "moved": "https://www.azion.com/en/documentation/platform/firewall/guides/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/", + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/quickstart/", + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/quickstart/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/reference/", + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/reference/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/", + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/issuance-and-renewal/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/certificate-manager/certificates/", + "moved": "https://www.azion.com/en/documentation/platform/certificate-manager/certificates/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/", + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/quickstart/", + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/quickstart/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/reference/", + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/reference/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/settings/", + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/settings/" + }, + { + "from": "https://www.azion.com/en/documentation/platform/workloads/custom-pages/error-responses/", + "moved": "https://www.azion.com/en/documentation/platform/custom-pages/error-responses/" } ] diff --git a/apps/docs/redirects/pt-br/01.json b/apps/docs/redirects/pt-br/01.json index 15e6c7ff9e..d3f4993078 100644 --- a/apps/docs/redirects/pt-br/01.json +++ b/apps/docs/redirects/pt-br/01.json @@ -877,7 +877,7 @@ }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/build/applications/error-responses/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/error-responses/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/build/applications/functions-instances/", @@ -997,7 +997,7 @@ }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/build/edge-application/error-responses/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/error-responses/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/build/edge-application/image-processor/", @@ -1661,7 +1661,7 @@ }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/edge-application/error-responses/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/error-responses/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/edge-application/functions-instances/", @@ -3845,7 +3845,7 @@ }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/custom-pages/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/configuracoes/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/edge-connector/", @@ -3889,7 +3889,7 @@ }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/edge-firewall/digital-certificates/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/certificados/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/edge-firewall/edge-functions-instances/", @@ -3941,11 +3941,11 @@ }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/firewall/certificados-wildcard-lets-encrypt/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/firewall/certificate-manager/", - "moved": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/" + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/certificados/" }, { "from": "https://www.azion.com/pt-br/documentacao/produtos/secure/firewall/ddos-protection/", @@ -4542,5 +4542,45 @@ { "from": "https://www.azion.com/pt-br/documentacao/secure/bot-manager/exemplos/", "moved": "https://www.azion.com/pt-br/documentacao/plataforma/firewall/guias/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/referencia/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/referencia/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/certificate-manager/certificados/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/primeiros-passos/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/primeiros-passos/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/referencia/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/referencia/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/configuracoes/" + }, + { + "from": "https://www.azion.com/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/", + "moved": "https://www.azion.com/pt-br/documentacao/plataforma/custom-pages/error-responses/" } ] diff --git a/apps/docs/src/content/docs/en/pages/agreements/tos/12-may-2026/terms-of-service-12-may-2026.mdx b/apps/docs/src/content/docs/en/pages/agreements/tos/12-may-2026/terms-of-service-12-may-2026.mdx index 36caff641c..419a3e405d 100644 --- a/apps/docs/src/content/docs/en/pages/agreements/tos/12-may-2026/terms-of-service-12-may-2026.mdx +++ b/apps/docs/src/content/docs/en/pages/agreements/tos/12-may-2026/terms-of-service-12-may-2026.mdx @@ -41,7 +41,7 @@ Azion is constantly working to improve its solutions. Consequently, this documen **Data Stream:** designed to collect, format, and send data generated by Azion Products and Services to the Customer's infrastructure or third-party systems through supported protocols and integrations. The Customer will choose which data will be collected and, by doing so, automatically declares that it is authorized to collect all selected data. AZION IS NOT RESPONSIBLE FOR: (A) THE USE OF THE DATA BY THE CUSTOMER; OR (B) THE CUSTOMER'S RIGHT TO COLLECT ITS USERS' DATA. The collected data is sent to the Customer's infrastructure using the protocol chosen by the Customer in the Azion Console interface or API, formatted in NDJSON (Newline Delimited JSON) in a configurable template. The data is dispatched in blocks of 2,000 records separated by “\n” (Newline), or 60 seconds, whichever happens first. Azion will use all commercially reasonable efforts to send all data to the Customer's infrastructure, or its suppliers, in real time or with a delay of less than 3 minutes. However, in the case of access peaks, attacks, or external causes, the delay may be longer. THE CUSTOMER IS RESPONSIBLE FOR THE AVAILABILITY OF THE INFRASTRUCTURE TO RECEIVE THE DATA AND, IN CASE OF UNAVAILABILITY, AZION CAN DISCARD THE DATA. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, Data Stream will be billed based on: (a) Requests and (b) Data Transfer, according to the volumes consumed. -**DDoS Protection:** a resource enabled by default in Azion and provided exclusively under the terms available at [https://www.azion.com/en/documentation/platform/workloads/#ddos-protection](https://www.azion.com/en/documentation/platform/workloads/#ddos-protection) ("Guidelines"). By using Azion, the Customer: (i) authorizes Azion to impose the technical measures available on the Azion Platform to control or mitigate DDoS attacks, even though such measures may result in performance degradation; and (ii) acknowledges that the Service Level Agreement ("SLA") does not apply while a DDoS attack is underway. DDoS Protection provides: (a) unmetered protection for network and transport layer attacks (OSI layers 3 and 4), including but not limited to UDP Flood, TCP SYN Flood, ICMP Flood, and other volumetric attacks as specified in the Guidelines; and (b) protection for certain application layer attacks (OSI layer 7), which may include connection-based restrictions and other technical measures for attacks such as Slowloris, HTTP/2 Fast Reset Attack, and other attack patterns described in the Guidelines. The Customer acknowledges that while DDoS Protection provides unmetered protection for layers 3 and 4 attacks, any application layer 7 attack mitigation by DDoS Protection, including connection-based restrictions, may generate chargeable traffic. For comprehensive protection against hybrid attacks combining multiple OSI layers, the Customer may need to activate multiple products as specified in the Guidelines. The Customer assumes all responsibility for service unavailability caused by misconfiguration of Azion Firewall rules or other security controls on the platform. AZION IS CONSTANTLY SEEKING TO UPGRADE ITS SECURITY MECHANISMS TO MAKE ITS PROTECTION SYSTEMS MORE EFFECTIVE AND REDUCE THE RISK OF IMPACTS TO CUSTOMER APPLICATIONS. HOWEVER, THERE ARE NO GUARANTEES THAT DDOS PROTECTION WILL BE ABLE TO PREVENT ALL POSSIBLE ATTACKS OR THREATS, PARTICULARLY ATTACKS THAT MAY REQUIRE ADDITIONAL CONFIGURATIONS, PRODUCTS, OR SERVICES. CUSTOMERS SHOULD KEEP SECURITY CONTROLS AT THEIR ORIGINS AS WELL AND CONSIDER ACTIVATING APPROPRIATE ADD-ON SERVICES, SUCH AS WAF OR BOT MANAGER, BASED ON THEIR SPECIFIC THREAT LANDSCAPE. CUSTOMERS ASSUME ALL RISKS OF SERVICE UNAVAILABILITY OWING TO RULES POORLY CONFIGURED IN THE SERVICE OR INADEQUATE PRODUCT SELECTION FOR THEIR SPECIFIC ATTACK VECTORS. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, DDoS Protection is included with Firewall and is not billed as a separate Product or Service. +**DDoS Protection:** a resource enabled by default in Azion and provided exclusively under the terms available at [https://www.azion.com/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/](https://www.azion.com/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) ("Guidelines"). By using Azion, the Customer: (i) authorizes Azion to impose the technical measures available on the Azion Platform to control or mitigate DDoS attacks, even though such measures may result in performance degradation; and (ii) acknowledges that the Service Level Agreement ("SLA") does not apply while a DDoS attack is underway. DDoS Protection provides: (a) unmetered protection for network and transport layer attacks (OSI layers 3 and 4), including but not limited to UDP Flood, TCP SYN Flood, ICMP Flood, and other volumetric attacks as specified in the Guidelines; and (b) protection for certain application layer attacks (OSI layer 7), which may include connection-based restrictions and other technical measures for attacks such as Slowloris, HTTP/2 Fast Reset Attack, and other attack patterns described in the Guidelines. The Customer acknowledges that while DDoS Protection provides unmetered protection for layers 3 and 4 attacks, any application layer 7 attack mitigation by DDoS Protection, including connection-based restrictions, may generate chargeable traffic. For comprehensive protection against hybrid attacks combining multiple OSI layers, the Customer may need to activate multiple products as specified in the Guidelines. The Customer assumes all responsibility for service unavailability caused by misconfiguration of Azion Firewall rules or other security controls on the platform. AZION IS CONSTANTLY SEEKING TO UPGRADE ITS SECURITY MECHANISMS TO MAKE ITS PROTECTION SYSTEMS MORE EFFECTIVE AND REDUCE THE RISK OF IMPACTS TO CUSTOMER APPLICATIONS. HOWEVER, THERE ARE NO GUARANTEES THAT DDOS PROTECTION WILL BE ABLE TO PREVENT ALL POSSIBLE ATTACKS OR THREATS, PARTICULARLY ATTACKS THAT MAY REQUIRE ADDITIONAL CONFIGURATIONS, PRODUCTS, OR SERVICES. CUSTOMERS SHOULD KEEP SECURITY CONTROLS AT THEIR ORIGINS AS WELL AND CONSIDER ACTIVATING APPROPRIATE ADD-ON SERVICES, SUCH AS WAF OR BOT MANAGER, BASED ON THEIR SPECIFIC THREAT LANDSCAPE. CUSTOMERS ASSUME ALL RISKS OF SERVICE UNAVAILABILITY OWING TO RULES POORLY CONFIGURED IN THE SERVICE OR INADEQUATE PRODUCT SELECTION FOR THEIR SPECIFIC ATTACK VECTORS. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, DDoS Protection is included with Firewall and is not billed as a separate Product or Service. **Edge DNS:** designed to provide an authoritative DNS service with support for standard DNS record types, including QTYPEs such as A, AAAA, ANAME, CAA, CNAME, MX, NS, PTR, SRV, and TXT. To adopt Edge DNS, the Customer must change the authoritative DNS servers with the domain registrar where the domain is managed so that the domain starts using Azion name servers. The Customer is responsible for renewing its domain names and ensuring the correct configuration of zones, records, and responses that it wishes to provide through the DNS service. Therefore, Azion is not responsible for any failure, limitation, propagation delay, resolution error, domain unavailability, or service impact caused by incorrect, incomplete, unauthorized, outdated, or external DNS configurations. Azion is authorized to remove zones that are not being used. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, Edge DNS will be billed based on: (a) Zones and (b) Queries, according to the volumes consumed. diff --git a/apps/docs/src/content/docs/en/pages/agreements/tos/terms-of-service.mdx b/apps/docs/src/content/docs/en/pages/agreements/tos/terms-of-service.mdx index f1fc07acc7..9123e61ddf 100644 --- a/apps/docs/src/content/docs/en/pages/agreements/tos/terms-of-service.mdx +++ b/apps/docs/src/content/docs/en/pages/agreements/tos/terms-of-service.mdx @@ -41,7 +41,7 @@ Azion is constantly working to improve its solutions. Consequently, this documen **Data Stream:** designed to collect, format, and send data generated by Azion Products and Services to the Customer's infrastructure or third-party systems through supported protocols and integrations. The Customer will choose which data will be collected and, by doing so, automatically declares that it is authorized to collect all selected data. AZION IS NOT RESPONSIBLE FOR: (A) THE USE OF THE DATA BY THE CUSTOMER; OR (B) THE CUSTOMER'S RIGHT TO COLLECT ITS USERS' DATA. The collected data is sent to the Customer's infrastructure using the protocol chosen by the Customer in the Azion Console interface or API, formatted in NDJSON (Newline Delimited JSON) in a configurable template. The data is dispatched in blocks of 2,000 records separated by “\n” (Newline), or 60 seconds, whichever happens first. Azion will use all commercially reasonable efforts to send all data to the Customer's infrastructure, or its suppliers, in real time or with a delay of less than 3 minutes. However, in the case of access peaks, attacks, or external causes, the delay may be longer. THE CUSTOMER IS RESPONSIBLE FOR THE AVAILABILITY OF THE INFRASTRUCTURE TO RECEIVE THE DATA AND, IN CASE OF UNAVAILABILITY, AZION CAN DISCARD THE DATA. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, Data Stream will be billed based on: (a) Requests and (b) Data Transfer, according to the volumes consumed. -**DDoS Protection:** a resource enabled by default in Azion and provided exclusively under the terms available at [https://www.azion.com/en/documentation/platform/workloads/#ddos-protection](https://www.azion.com/en/documentation/platform/workloads/#ddos-protection) ("Guidelines"). By using Azion, the Customer: (i) authorizes Azion to impose the technical measures available on the Azion Platform to control or mitigate DDoS attacks, even though such measures may result in performance degradation; and (ii) acknowledges that the Service Level Agreement ("SLA") does not apply while a DDoS attack is underway. DDoS Protection provides: (a) unmetered protection for network and transport layer attacks (OSI layers 3 and 4), including but not limited to UDP Flood, TCP SYN Flood, ICMP Flood, and other volumetric attacks as specified in the Guidelines; and (b) protection for certain application layer attacks (OSI layer 7), which may include connection-based restrictions and other technical measures for attacks such as Slowloris, HTTP/2 Fast Reset Attack, and other attack patterns described in the Guidelines. The Customer acknowledges that while DDoS Protection provides unmetered protection for layers 3 and 4 attacks, any application layer 7 attack mitigation by DDoS Protection, including connection-based restrictions, may generate chargeable traffic. For comprehensive protection against hybrid attacks combining multiple OSI layers, the Customer may need to activate multiple products as specified in the Guidelines. The Customer assumes all responsibility for service unavailability caused by misconfiguration of Azion Firewall rules or other security controls on the platform. AZION IS CONSTANTLY SEEKING TO UPGRADE ITS SECURITY MECHANISMS TO MAKE ITS PROTECTION SYSTEMS MORE EFFECTIVE AND REDUCE THE RISK OF IMPACTS TO CUSTOMER APPLICATIONS. HOWEVER, THERE ARE NO GUARANTEES THAT DDOS PROTECTION WILL BE ABLE TO PREVENT ALL POSSIBLE ATTACKS OR THREATS, PARTICULARLY ATTACKS THAT MAY REQUIRE ADDITIONAL CONFIGURATIONS, PRODUCTS, OR SERVICES. CUSTOMERS SHOULD KEEP SECURITY CONTROLS AT THEIR ORIGINS AS WELL AND CONSIDER ACTIVATING APPROPRIATE ADD-ON SERVICES, SUCH AS WAF OR BOT MANAGER, BASED ON THEIR SPECIFIC THREAT LANDSCAPE. CUSTOMERS ASSUME ALL RISKS OF SERVICE UNAVAILABILITY OWING TO RULES POORLY CONFIGURED IN THE SERVICE OR INADEQUATE PRODUCT SELECTION FOR THEIR SPECIFIC ATTACK VECTORS. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, DDoS Protection is included with Firewall and is not billed as a separate Product or Service. +**DDoS Protection:** a resource enabled by default in Azion and provided exclusively under the terms available at [https://www.azion.com/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/](https://www.azion.com/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) ("Guidelines"). By using Azion, the Customer: (i) authorizes Azion to impose the technical measures available on the Azion Platform to control or mitigate DDoS attacks, even though such measures may result in performance degradation; and (ii) acknowledges that the Service Level Agreement ("SLA") does not apply while a DDoS attack is underway. DDoS Protection provides: (a) unmetered protection for network and transport layer attacks (OSI layers 3 and 4), including but not limited to UDP Flood, TCP SYN Flood, ICMP Flood, and other volumetric attacks as specified in the Guidelines; and (b) protection for certain application layer attacks (OSI layer 7), which may include connection-based restrictions and other technical measures for attacks such as Slowloris, HTTP/2 Fast Reset Attack, and other attack patterns described in the Guidelines. The Customer acknowledges that while DDoS Protection provides unmetered protection for layers 3 and 4 attacks, any application layer 7 attack mitigation by DDoS Protection, including connection-based restrictions, may generate chargeable traffic. For comprehensive protection against hybrid attacks combining multiple OSI layers, the Customer may need to activate multiple products as specified in the Guidelines. The Customer assumes all responsibility for service unavailability caused by misconfiguration of Azion Firewall rules or other security controls on the platform. AZION IS CONSTANTLY SEEKING TO UPGRADE ITS SECURITY MECHANISMS TO MAKE ITS PROTECTION SYSTEMS MORE EFFECTIVE AND REDUCE THE RISK OF IMPACTS TO CUSTOMER APPLICATIONS. HOWEVER, THERE ARE NO GUARANTEES THAT DDOS PROTECTION WILL BE ABLE TO PREVENT ALL POSSIBLE ATTACKS OR THREATS, PARTICULARLY ATTACKS THAT MAY REQUIRE ADDITIONAL CONFIGURATIONS, PRODUCTS, OR SERVICES. CUSTOMERS SHOULD KEEP SECURITY CONTROLS AT THEIR ORIGINS AS WELL AND CONSIDER ACTIVATING APPROPRIATE ADD-ON SERVICES, SUCH AS WAF OR BOT MANAGER, BASED ON THEIR SPECIFIC THREAT LANDSCAPE. CUSTOMERS ASSUME ALL RISKS OF SERVICE UNAVAILABILITY OWING TO RULES POORLY CONFIGURED IN THE SERVICE OR INADEQUATE PRODUCT SELECTION FOR THEIR SPECIFIC ATTACK VECTORS. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, DDoS Protection is included with Firewall and is not billed as a separate Product or Service. **Edge DNS:** designed to provide an authoritative DNS service with support for standard DNS record types, including QTYPEs such as A, AAAA, ANAME, CAA, CNAME, MX, NS, PTR, SRV, and TXT. To adopt Edge DNS, the Customer must change the authoritative DNS servers with the domain registrar where the domain is managed so that the domain starts using Azion name servers. The Customer is responsible for renewing its domain names and ensuring the correct configuration of zones, records, and responses that it wishes to provide through the DNS service. Therefore, Azion is not responsible for any failure, limitation, propagation delay, resolution error, domain unavailability, or service impact caused by incorrect, incomplete, unauthorized, outdated, or external DNS configurations. Azion is authorized to remove zones that are not being used. Except as otherwise provided in the Customer Agreement or any other documents attached thereto, Edge DNS will be billed based on: (a) Zones and (b) Queries, according to the volumes consumed. diff --git a/apps/docs/src/content/docs/en/pages/architectures/compliance/compliance-architecture.mdx b/apps/docs/src/content/docs/en/pages/architectures/compliance/compliance-architecture.mdx index 7d9bc62907..7fe5cd5395 100644 --- a/apps/docs/src/content/docs/en/pages/architectures/compliance/compliance-architecture.mdx +++ b/apps/docs/src/content/docs/en/pages/architectures/compliance/compliance-architecture.mdx @@ -11,7 +11,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -This design serves security and compliance teams that must show auditors the controls in front of a regulated application. That application handles card or personal data under a standard such as PCI DSS, SOC 2, LGPD, or GDPR. [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) holds the TLS certificates, and the [application](/en/documentation/platform/applications/) redirects all traffic to HTTPS. A [firewall](/en/documentation/platform/firewall/) applies [WAF](/en/documentation/platform/firewall/waf/) rules, [Network Shield](/en/documentation/platform/firewall/network-shield/) lists, and geographic restrictions before requests reach the origin through a [connector](/en/documentation/platform/connectors/). [Data Stream](/en/documentation/platform/data-stream/) exports every request record, with its WAF decision, to a SIEM or storage the team keeps for the period its standard requires. Under the [Shared Responsibility Model](/en/documentation/fundamentals/shared-responsibility/), Azion secures the platform, and the team configures and evidences these controls. The design implements the use case [Prepare regulated web applications for security audits](/en/documentation/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits/). +This design serves security and compliance teams that must show auditors the controls in front of a regulated application. That application handles card or personal data under a standard such as PCI DSS, SOC 2, LGPD, or GDPR. [Certificate Manager](/en/documentation/platform/certificate-manager/) holds the TLS certificates, and the [application](/en/documentation/platform/applications/) redirects all traffic to HTTPS. A [firewall](/en/documentation/platform/firewall/) applies [WAF](/en/documentation/platform/firewall/waf/) rules, [Network Shield](/en/documentation/platform/firewall/network-shield/) lists, and geographic restrictions before requests reach the origin through a [connector](/en/documentation/platform/connectors/). [Data Stream](/en/documentation/platform/data-stream/) exports every request record, with its WAF decision, to a SIEM or storage the team keeps for the period its standard requires. Under the [Shared Responsibility Model](/en/documentation/fundamentals/shared-responsibility/), Azion secures the platform, and the team configures and evidences these controls. The design implements the use case [Prepare regulated web applications for security audits](/en/documentation/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits/). ## Architecture diagram @@ -42,7 +42,7 @@ flowchart TD ### Dataflow -1. A client connects over HTTPS, and the workload presents the certificate that Certificate Manager holds for the domain. [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) assesses the traffic before any firewall rule runs. +1. A client connects over HTTPS, and the workload presents the certificate that Certificate Manager holds for the domain. [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) assesses the traffic before any firewall rule runs. 2. Firewall rules read Network Shield lists and answer `403` in two cases. One is a client from a country outside the served list, and the other a request for `/admin` from outside the team's network. 3. WAF scores every request and, in _Blocking_, answers `400` to a request whose score reaches the threshold of a threat family. 4. A request that passes reaches the application, which redirects plain HTTP to HTTPS and forwards the request to the origin through the connector. @@ -68,7 +68,7 @@ A refusal starts at the firewall and goes straight to the client, because the ap - [Prepare regulated web applications for security audits](/en/documentation/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits/) - builds this design end to end, with the HTTPS redirect, the country and address rules, the stream of security events, and the checks for each. - [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/) - has Azion request and renew a certificate for the domains of the workload. -- [Certificate Manager quickstart](/en/documentation/platform/workloads/certificate-manager/quickstart/) - uploads a certificate of your own and binds it to a workload. +- [Certificate Manager quickstart](/en/documentation/platform/certificate-manager/quickstart/) - uploads a certificate of your own and binds it to a workload. - [Redirect HTTP to HTTPS](/en/documentation/guides/application-security/tls-and-certificates/redirect-http-to-https/) - creates the application rule that redirects every plain HTTP request to HTTPS. - [Bind a firewall to a workload](/en/documentation/guides/application-security/firewall-and-waf/firewall-protect-your-domain/) - names the firewall in the deployment of the workload, so it inspects the requests to every domain. - [Apply a rule set to every request](/en/documentation/guides/application-security/firewall-and-waf/apply-rule-set/) - applies the WAF rule set, the application-layer control an audit asks for. diff --git a/apps/docs/src/content/docs/en/pages/architectures/security-modernization/security-modernization-v3.mdx b/apps/docs/src/content/docs/en/pages/architectures/security-modernization/security-modernization-v3.mdx index f517870255..dc712ddb98 100644 --- a/apps/docs/src/content/docs/en/pages/architectures/security-modernization/security-modernization-v3.mdx +++ b/apps/docs/src/content/docs/en/pages/architectures/security-modernization/security-modernization-v3.mdx @@ -44,7 +44,7 @@ This use case is ideal for organizations looking to build a strong online presen - [Applications](/en/documentation/platform/applications/): your application running on top of the Azion Web Platform. - [Firewall](/en/documentation/platform/firewall/): executes its modules and security rules. - - [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection): always active, detects and mitigates DDoS and DoS attacks. + - [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/): always active, detects and mitigates DDoS and DoS attacks. - [Web Application Firewall](/en/documentation/platform/firewall/waf/): allows you to configure protection against attacks and vulnerabilities. - [Network Shield](/en/documentation/platform/firewall/network-shield/): allows you to create lists with IP addresses or countries with suspicious behavior and restrict their access. - [Functions](/en/documentation/platform/firewall/functions/): serverless functions that run on Azion Runtime with low latency, bringing the operational power and security processing closer to the end user. diff --git a/apps/docs/src/content/docs/en/pages/build/applications/troubleshooting.mdx b/apps/docs/src/content/docs/en/pages/build/applications/troubleshooting.mdx index 24558dfe1d..99def27c44 100644 --- a/apps/docs/src/content/docs/en/pages/build/applications/troubleshooting.mdx +++ b/apps/docs/src/content/docs/en/pages/build/applications/troubleshooting.mdx @@ -34,7 +34,7 @@ Your origin answers a request with a `4xx` or `5xx` status, and the client recei The Connector that a _Set Connector_ rule sets receives the origin's error. The error page is set on the Workload, not on the Application: the Workload's deployment sets the page beside the Application and the Firewall. -- **Serve your own error page**: create it as [Custom Pages quickstart](/en/documentation/platform/workloads/custom-pages/quickstart/) shows. Then, in Azion Console, select it in the **Custom Page** field of the Workload's **Deployment Settings**. +- **Serve your own error page**: create it as [Custom Pages quickstart](/en/documentation/platform/custom-pages/quickstart/) shows. Then, in Azion Console, select it in the **Custom Page** field of the Workload's **Deployment Settings**. - **Serve the last stored copy instead of a `5xx`**: turn on [stale cache](/en/documentation/platform/applications/cache/expiration-and-freshness/#stale-cache) in the cache setting that a _Set Cache Policy_ rule applies to the path, with `modules.cache.stale_cache.enabled` set to `true` in the API. A client then receives your page for an origin error, or the expired copy of a cached object within the stale window. diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/config/azion-config-js.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/config/azion-config-js.mdx index 39db6adc93..a90259221f 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/config/azion-config-js.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/config/azion-config-js.mdx @@ -528,7 +528,7 @@ With `azion deploy`, a deployment serves the Application that the deploy creates ### Custom Pages -Each entry of `customPages` declares one set of [custom pages](/en/documentation/platform/workloads/custom-pages/settings/), the pages Azion returns in place of an error response. +Each entry of `customPages` declares one set of [custom pages](/en/documentation/platform/custom-pages/settings/), the pages Azion returns in place of an error response. | Property | Type | Required | Description | | --- | --- | --- | --- | diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/crl.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/crl.mdx index 852d35d0b1..a53a88e9dd 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/crl.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/crl.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -The Azion CLI `crl` commands create, list, describe, update, and delete certificate revocation lists (CRLs) in [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/#certificate-revocation-lists). A CRL is a list of revoked certificates that a Certificate Authority (CA) issues, and the CLI uploads it from a file in PEM format. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). +The Azion CLI `crl` commands create, list, describe, update, and delete certificate revocation lists (CRLs) in [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/#certificate-revocation-lists). A CRL is a list of revoked certificates that a Certificate Authority (CA) issues, and the CLI uploads it from a file in PEM format. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). --- @@ -253,7 +253,7 @@ Updated Certificate Revocation List with ID 1237 The options every command accepts, such as `--format`, `--out`, and `-y`. - The fields of a CRL, its size limit, and how a workload with mTLS uses it. + The fields of a CRL, its size limit, and how a workload with mTLS uses it. The commands that upload and manage the certificates Certificate Manager stores. The commands that create and manage certificate signing requests in Certificate Manager. diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx index 66c9cfe575..4aba89aa39 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -The Azion CLI `csr` commands create, describe, and delete certificate signing requests (CSRs) in [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/). A CSR is the request you submit to a certificate authority (CA) to obtain a certificate, and the CLI prints it when it creates one. Azion stores a CSR as a digital certificate with status `pending`, so the CSR and your certificates share one set of IDs. The CLI has no command that lists or updates a CSR: `azion list digital-certificate` lists it with your certificates, and the [digital-certificate commands](/en/documentation/devtools/cli/resources/digital-certificate/) manage the entry. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). +The Azion CLI `csr` commands create, describe, and delete certificate signing requests (CSRs) in [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/). A CSR is the request you submit to a certificate authority (CA) to obtain a certificate, and the CLI prints it when it creates one. Azion stores a CSR as a digital certificate with status `pending`, so the CSR and your certificates share one set of IDs. The CLI has no command that lists or updates a CSR: `azion list digital-certificate` lists it with your certificates, and the [digital-certificate commands](/en/documentation/devtools/cli/resources/digital-certificate/) manage the entry. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). --- @@ -54,7 +54,7 @@ Created Certificate Signing Request with ID 123481 | `--organization-unity` | — | string | — | Organizational unit of the certificate subject. | | `--state` | — | string | — | State or province of the certificate subject. | -A `--key-algorithm` value outside the three listed is refused with `"rsa_1024" is not a valid choice.` A `--name` that a certificate of your account already uses is refused with `This field must be unique.` Every name in `--common-name` and `--alternative-names` must belong to a domain your account has permission for. The bounds of each field are in [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). +A `--key-algorithm` value outside the three listed is refused with `"rsa_1024" is not a valid choice.` A `--name` that a certificate of your account already uses is refused with `This field must be unique.` Every name in `--common-name` and `--alternative-names` must belong to a domain your account has permission for. The bounds of each field are in [Certificates](/en/documentation/platform/certificate-manager/certificates/). --- @@ -181,7 +181,7 @@ Created Certificate Signing Request with ID 123482 The options every command accepts, such as `--format`, `--out`, and `-y`. - The fields of a CSR, its bounds, and how to add the certificate the CA signs. + The fields of a CSR, its bounds, and how to add the certificate the CA signs. The commands that list your CSRs with your certificates and manage each entry. Every resource the CLI manages, and the verbs each one supports. diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/custom-pages.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/custom-pages.mdx index 72c757f4ca..862bb7eafb 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/custom-pages.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/custom-pages.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -The Azion CLI `custom-pages` commands create, list, describe, update, and delete custom page sets, the [Custom Pages](/en/documentation/platform/workloads/custom-pages/settings/) resource that replaces the error responses of a workload with pages served from a connector. These commands manage the set and do not assign it to a workload: set **Custom Page** in the workload's deployment settings in Azion Console, pass `--custom-page` to [`azion create workload-deployment`](/en/documentation/devtools/cli/resources/workload-deployment/#create) when you create the deployment, or name the set in the [`deployments`](/en/documentation/devtools/cli/azion-config-js/#workload-deployments) entry of `azion.config.js`. The CLI has no command that updates a deployment, so on a workload that already has one, assign the set in Azion Console. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). +The Azion CLI `custom-pages` commands create, list, describe, update, and delete custom page sets, the [Custom Pages](/en/documentation/platform/custom-pages/settings/) resource that replaces the error responses of a workload with pages served from a connector. These commands manage the set and do not assign it to a workload: set **Custom Page** in the workload's deployment settings in Azion Console, pass `--custom-page` to [`azion create workload-deployment`](/en/documentation/devtools/cli/resources/workload-deployment/#create) when you create the deployment, or name the set in the [`deployments`](/en/documentation/devtools/cli/azion-config-js/#workload-deployments) entry of `azion.config.js`. The CLI has no command that updates a deployment, so on a workload that already has one, assign the set in Azion Console. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). --- @@ -222,7 +222,7 @@ The file carries the fields of the set: - `pages` holds one entry per status code. Each entry carries the status code in `code`, as a string such as `"404"`, and a `page` object. - `page.type` is `page_connector`, and `page.attributes` carries `connector`, the ID of the connector that serves the page, `ttl`, and `uri`, the path of the page on that connector. -For what each field does and the values it takes, refer to [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/). +For what each field does and the values it takes, refer to [Custom page settings](/en/documentation/platform/custom-pages/settings/). A page of type `page_default` that carries only `ttl` is refused before the set is created, although the file is valid JSON: @@ -239,7 +239,7 @@ On update, the file carries only the fields to change, and the fields it leaves The options every command accepts, such as `--format`, `--out`, and `-y`. - The fields of a custom page set, the status codes it can replace, and how a page takes its content from a connector. + The fields of a custom page set, the status codes it can replace, and how a page takes its content from a connector. The commands that create and manage the connector that serves the pages of a set. The commands that name a custom page set when they create the deployment of a workload. The `deployments` entry that assigns a custom page set to a workload. diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/digital-certificate.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/digital-certificate.mdx index 15694c24b5..da2fe5b9f7 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/digital-certificate.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/digital-certificate.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -The Azion CLI `digital-certificate` commands create, list, describe, update, and delete the [certificates](/en/documentation/platform/workloads/certificate-manager/certificates/) that Certificate Manager stores for TLS. A certificate is a server certificate you upload with its private key or request from Let's Encrypt, or a Trusted CA certificate that verifies client certificates. These commands store the certificate and do not bind it to a workload. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). +The Azion CLI `digital-certificate` commands create, list, describe, update, and delete the [certificates](/en/documentation/platform/certificate-manager/certificates/) that Certificate Manager stores for TLS. A certificate is a server certificate you upload with its private key or request from Let's Encrypt, or a Trusted CA certificate that verifies client certificates. These commands store the certificate and do not bind it to a workload. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). --- @@ -46,7 +46,7 @@ The command prints `Requested` instead of `Created`: Requested Digital Certificate with ID 123479 ``` -For what each challenge needs before Let's Encrypt issues the certificate, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +For what each challenge needs before Let's Encrypt issues the certificate, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). ### Flags @@ -135,7 +135,7 @@ Last Modified: "2026-01-01T12:00:14.812268Z" Renewed At: null ``` -With `--format json`, the command prints the full object: `active`, `authority`, `certificate`, `challenge`, `created_at`, `csr`, `id`, `issuer`, `key_algorithm`, `last_editor`, `last_modified`, `managed`, `name`, `product_version`, `renewed_at`, `status`, `status_detail`, `subject_name`, `type`, and `validity`. The `certificate` field holds the PEM text of the certificate, and the object carries no private key. A requested certificate has `managed` set to `true`. For what each status means, refer to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#statuses). +With `--format json`, the command prints the full object: `active`, `authority`, `certificate`, `challenge`, `created_at`, `csr`, `id`, `issuer`, `key_algorithm`, `last_editor`, `last_modified`, `managed`, `name`, `product_version`, `renewed_at`, `status`, `status_detail`, `subject_name`, `type`, and `validity`. The `certificate` field holds the PEM text of the certificate, and the object carries no private key. A requested certificate has `managed` set to `true`. For what each status means, refer to [Certificates](/en/documentation/platform/certificate-manager/certificates/#statuses). ### Flags @@ -291,7 +291,7 @@ Updated Digital Certificate with ID 123478 The options every command accepts, such as `--format`, `--out`, and `-y`. - Every field, status, and key algorithm of a stored certificate. + Every field, status, and key algorithm of a stored certificate. The commands that create a certificate signing request, which shares the ID space of certificates. The commands that manage the workload that serves a certificate over TLS. diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/workload-deployment.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/workload-deployment.mdx index d8e78303a6..c48c0a7bfc 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/workload-deployment.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/workload-deployment.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -The Azion CLI `workload-deployment` commands create, list, and describe the deployment of a [workload](/en/documentation/platform/workloads/). The deployment names the application that answers the workload's domains and, optionally, the [firewall](/en/documentation/platform/firewall/) that inspects requests first and the [custom page set](/en/documentation/platform/workloads/custom-pages/settings/) that replaces error responses. A workload holds one deployment, so `azion create workload-deployment` works only on a workload that has none. The CLI has no command that updates or deletes a deployment. To change the deployment of a workload, set its fields in the workload's deployment settings in Azion Console. A project that declares its workload in `azion.config.js` gets its deployment from the [`deployments`](/en/documentation/devtools/cli/azion-config-js/#workload-deployments) entry when you run `azion deploy`. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). This page matches Azion CLI 4.24.0. +The Azion CLI `workload-deployment` commands create, list, and describe the deployment of a [workload](/en/documentation/platform/workloads/). The deployment names the application that answers the workload's domains and, optionally, the [firewall](/en/documentation/platform/firewall/) that inspects requests first and the [custom page set](/en/documentation/platform/custom-pages/settings/) that replaces error responses. A workload holds one deployment, so `azion create workload-deployment` works only on a workload that has none. The CLI has no command that updates or deletes a deployment. To change the deployment of a workload, set its fields in the workload's deployment settings in Azion Console. A project that declares its workload in `azion.config.js` gets its deployment from the [`deployments`](/en/documentation/devtools/cli/azion-config-js/#workload-deployments) entry when you run `azion deploy`. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/). This page matches Azion CLI 4.24.0. --- diff --git a/apps/docs/src/content/docs/en/pages/devtools/terraform/resources/certificates.mdx b/apps/docs/src/content/docs/en/pages/devtools/terraform/resources/certificates.mdx index e2d24d945c..e1b8dab4ea 100644 --- a/apps/docs/src/content/docs/en/pages/devtools/terraform/resources/certificates.mdx +++ b/apps/docs/src/content/docs/en/pages/devtools/terraform/resources/certificates.mdx @@ -15,7 +15,7 @@ import DocItem from '@aziontech/webkit/doc-item' -A digital certificate is the SSL/TLS certificate and private key pair that lets an application answer over HTTPS. The Azion Terraform Provider manages the certificates of [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/) with four resources and reads them with four data sources. Besides uploading a certificate that you already have, the provider can request a Let's Encrypt certificate, create a certificate signing request (CSR), and upload a certificate revocation list (CRL) for mTLS. +A digital certificate is the SSL/TLS certificate and private key pair that lets an application answer over HTTPS. The Azion Terraform Provider manages the certificates of [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/) with four resources and reads them with four data sources. Besides uploading a certificate that you already have, the provider can request a Let's Encrypt certificate, create a certificate signing request (CSR), and upload a certificate revocation list (CRL) for mTLS. --- diff --git a/apps/docs/src/content/docs/en/pages/guides/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/en/pages/guides/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx index 7a02334d40..072e5c350c 100644 --- a/apps/docs/src/content/docs/en/pages/guides/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx @@ -138,7 +138,7 @@ Every Akamai product in the inventory has a destination on Azion. Find the produ | API Gateway | API registration, routing, delivery, and protection | Applications, [Rules Engine](/en/documentation/platform/applications/rules-engine/), Functions, and Firewall | | API Prioritization Cloudlet | API traffic prioritization | Rules Engine and Application Accelerator | | API Security | API discovery, monitoring, and protection workflows | Firewall, [Web Application Firewall](/en/documentation/platform/firewall/waf/quickstart/), and Applications | -| App & API Protector | Protection of applications and APIs against vulnerabilities, abuse, and distributed threats | Firewall, Web Application Firewall, [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection), and [Bot Manager](/en/documentation/platform/firewall/bot-manager/quickstart/) | +| App & API Protector | Protection of applications and APIs against vulnerabilities, abuse, and distributed threats | Firewall, Web Application Firewall, [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/), and [Bot Manager](/en/documentation/platform/firewall/bot-manager/quickstart/) | | App Platform | Managed containerized application deployment | [Orchestrator](/en/documentation/platform/orchestrator/), which provisions and manages services on nodes you operate | | Application Load Balancer Cloudlet | Application load balancing for performance and availability | [Load Balancer](/en/documentation/platform/connectors/load-balancer/quickstart/), turned on in a connector | | Audience Segmentation Cloudlet | Cookie-based segmentation, A/B testing, and session affinity patterns | Rules Engine criteria on cookies and device groups | @@ -1049,7 +1049,7 @@ The response carries `"state": "pending"` and the rule. A matching request recei ## Rely on DDoS Protection -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) takes over the role of Prolexic for the traffic Azion serves. It is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks on layers 3, 4, 6, and 7. Examples are UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) takes over the role of Prolexic for the traffic Azion serves. It is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks on layers 3, 4, 6, and 7. Examples are UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris. | Aspect | Akamai Prolexic and DDoS products | Azion DDoS Protection | | --- | --- | --- | @@ -1321,7 +1321,7 @@ A single-page application is measured once per full page load. Rebuild the mPuls ## Prepare the certificate -[Certificate Manager](/en/documentation/platform/workloads/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the hostname points to Azion, so users reach the property over HTTPS from the first request. +[Certificate Manager](/en/documentation/platform/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the hostname points to Azion, so users reach the property over HTTPS from the first request. | Certificate option | Use it for | | --- | --- | @@ -1365,7 +1365,7 @@ For a move from Akamai, use DNS-01. -If the certificate does not become active, read its `status` and `status_detail`. For DNS-01, check the `_acme-challenge` CNAME. Confirm that the hostname is in the **Domains** of the right workload before the DNS change. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +If the certificate does not become active, read its `status` and `status_detail`. For DNS-01, check the `_acme-challenge` CNAME. Confirm that the hostname is in the **Domains** of the right workload before the DNS change. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). --- diff --git a/apps/docs/src/content/docs/en/pages/guides/availability/show-your-own-page-when-no-origin-answers.mdx b/apps/docs/src/content/docs/en/pages/guides/availability/show-your-own-page-when-no-origin-answers.mdx index 7e238a55ac..f9108470a8 100644 --- a/apps/docs/src/content/docs/en/pages/guides/availability/show-your-own-page-when-no-origin-answers.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/availability/show-your-own-page-when-no-origin-answers.mdx @@ -70,7 +70,7 @@ The examples serve the page at `/errors/503.html` on a connector named `error-pa ## Create a set with a page for each code -The set binds `502`, `503`, and `504` to the same page. In the [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/#status-codes), `502` is a gateway that received an invalid response, `503` a server that is not ready, and `504` a gateway that received no response in time. Each page answers with `503`, which marks a temporary condition. +The set binds `502`, `503`, and `504` to the same page. In the [Custom page settings](/en/documentation/platform/custom-pages/settings/#status-codes), `502` is a gateway that received an invalid response, `503` a server that is not ready, and `504` a gateway that received no response in time. Each page answers with `503`, which marks a temporary condition. The page comes from a connector that reaches none of your origins, because a page fetched from a failing origin fails with it. **Response TTL** sets how many seconds the page stays in cache, from 0 to 31,536,000. An error page is static and rarely changes, so a high value, such as `86400`, one day, keeps requests away from the page's connector. @@ -236,7 +236,7 @@ To confirm the page: -The response carries status `503`, from the page's **Response Custom Status Code**, and the body of `/errors/503.html`, not the page titled `Azion - Default error page`. It carries no `Location` header, so the client is not redirected. If the default page still arrives after the deployment change has spread, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#custom-pages). +The response carries status `503`, from the page's **Response Custom Status Code**, and the body of `/errors/503.html`, not the page titled `Azion - Default error page`. It carries no `Location` header, so the client is not redirected. If the default page still arrives after the deployment change has spread, refer to [Troubleshoot Custom Pages](/en/documentation/platform/custom-pages/troubleshooting/). In the [Keep an application online when an origin fails](/en/documentation/use-cases/improve-performance-and-reliability/keep-an-application-online-when-an-origin-fails/) use case, expect: @@ -247,7 +247,7 @@ In the [Keep an application online when an origin fails](/en/documentation/use-c ## Next steps - + diff --git a/apps/docs/src/content/docs/en/pages/guides/aws-to-azion/aws-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/en/pages/guides/aws-to-azion/aws-to-azion-comprehensive-guide.mdx index e3cb1fde5f..3732301438 100644 --- a/apps/docs/src/content/docs/en/pages/guides/aws-to-azion/aws-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/aws-to-azion/aws-to-azion-comprehensive-guide.mdx @@ -161,7 +161,7 @@ Every AWS product in the inventory has a destination on Azion. Find the product | AWS WAF Bot Control | Managed bot detection and mitigation | [Bot Manager](/en/documentation/platform/firewall/bot-manager/quickstart/) and [Bot Manager Lite](/en/documentation/guides/application-development/integrations/bot-manager-lite/) | | AWS WAF rate-based rules | Rate limits keyed on IP, headers, URI, or method | Firewall and Functions | | AWS WAF IP sets | Reusable IP and CIDR lists for allow or block rules | [Network lists](/en/documentation/platform/firewall/network-shield/network-lists/) | -| AWS Shield Standard | Standard DDoS protection | [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) | +| AWS Shield Standard | Standard DDoS protection | [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) | | AWS Shield Advanced | DDoS protection with more visibility and mitigation options | DDoS Protection | | Shield Advanced automatic mitigation | WAF protections created during application-layer attacks | DDoS Protection and Web Application Firewall | | AWS Network Firewall | Managed network firewall for a VPC | Firewall and [Network Shield](/en/documentation/platform/firewall/network-shield/quickstart/) | @@ -173,7 +173,7 @@ Every AWS product in the inventory has a destination on Azion. Find the product | CloudFront signed URLs and cookies | Access to private content | Rules Engine for Applications, Functions, and the [Secure Token](/en/documentation/guides/application-development/integrations/secure-token/) integration on a firewall | | CloudFront geographic restrictions | Access allowed or blocked by country | Rules Engine for Applications and Network Shield | | Amazon Route 53 | Authoritative DNS, registration, routing policies, and health checks | Edge DNS | -| AWS Certificate Manager | TLS certificates: provisioning, import, deployment, and renewal | [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/) | +| AWS Certificate Manager | TLS certificates: provisioning, import, deployment, and renewal | [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/) | | AWS Private CA | Private certificate authorities | Certificate Manager, which holds Trusted CA certificates | | AWS Private CA for client authentication | Certificate-based client authentication | [mTLS](/en/documentation/platform/workloads/mtls/) | | AWS IoT Greengrass | Managed components and local processing on edge devices | Orchestrator | @@ -1914,7 +1914,7 @@ The list ID is a JSON integer. An ID sent as a string is refused with `25042`, a ## Rely on DDoS Protection -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks, such as UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris, on layers 3, 4, 6, and 7. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks, such as UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris, on layers 3, 4, 6, and 7. | Aspect | AWS Shield | Azion DDoS Protection | | --- | --- | --- | @@ -2326,7 +2326,7 @@ Each visitor runs one test every 30 minutes. Azion Console has no page that char ## Prepare the certificate -[Certificate Manager](/en/documentation/platform/workloads/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the domain points to Azion, so users reach the project over HTTPS from the first request. +[Certificate Manager](/en/documentation/platform/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the domain points to Azion, so users reach the project over HTTPS from the first request. | Area | AWS Certificate Manager | Azion Certificate Manager | | --- | --- | --- | @@ -2381,7 +2381,7 @@ To request the certificate in Azion Console: The first attempt runs up to 5 minutes after you save, and retries follow at 5, 10, 15, 20, and 30 minutes, then on a slower schedule. The status moves from `pending` to `challenge_verification`, then to `active` or `failed`. -To upload a certificate exported from ACM, go to **Certificate Manager** and create a digital certificate with the **Server Certificate** preset. Paste the PEM certificate and the private key. Intermediate certificates go in the same field as the certificate. Then select it in the **Digital Certificate** field of the workload. For the steps, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/), and for every certificate field, to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). +To upload a certificate exported from ACM, go to **Certificate Manager** and create a digital certificate with the **Server Certificate** preset. Paste the PEM certificate and the private key. Intermediate certificates go in the same field as the certificate. Then select it in the **Digital Certificate** field of the workload. For the steps, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/), and for every certificate field, to [Certificates](/en/documentation/platform/certificate-manager/certificates/). @@ -2403,7 +2403,7 @@ To upload a certificate exported from ACM, go to **Certificate Manager** and cre -If the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Retries continue on schedule, so a fixed record issues the certificate later. On a TLS handshake failure, check that the certificate covers the hostname and that the intermediates are in the certificate field. Then check the `minimum_version` of the workload. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +If the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Retries continue on schedule, so a fixed record issues the certificate later. On a TLS handshake failure, check that the certificate covers the hostname and that the intermediates are in the certificate field. Then check the `minimum_version` of the workload. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). mTLS needs a Trusted CA certificate, and an Azion-generated certificate cannot be the Trusted CA. An AWS Private CA certificate can be exported and uploaded with the **Trusted CA Certificate** preset. Then set `mtls.enabled`, `mtls.config.certificate`, and `verification`, `enforce` or `permissive`, on the workload through the API or `azion update workload --file`. mTLS works over HTTPS only. For the steps, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/) and [mTLS](/en/documentation/platform/workloads/mtls/). diff --git a/apps/docs/src/content/docs/en/pages/guides/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/en/pages/guides/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx index 38ba89fc8c..bf838d71bf 100644 --- a/apps/docs/src/content/docs/en/pages/guides/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx @@ -136,14 +136,14 @@ Every Cloudflare product in the inventory has a destination on Azion. Find the p | AI Gateway | Observing, caching, rate limiting, and controlling AI traffic | Functions, Cache, Real-Time Events, and Data Stream | | AI Search | Managed retrieval and search pipelines | SQL Database, with vector search, and AI Inference | | Analytics | Analytics across Cloudflare services | Real-Time Metrics, Real-Time Events, Data Stream, and [Edge Pulse](/en/documentation/platform/edge-pulse/) | -| API Shield | API discovery, schema validation, mTLS, and controls | Firewall, [Web Application Firewall](/en/documentation/platform/firewall/waf/quickstart/), Network Shield, and [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/quickstart/) | +| API Shield | API discovery, schema validation, mTLS, and controls | Firewall, [Web Application Firewall](/en/documentation/platform/firewall/waf/quickstart/), Network Shield, and [Certificate Manager](/en/documentation/platform/certificate-manager/quickstart/) | | Bots | Detection and mitigation of automated traffic | [Bot Manager](/en/documentation/platform/firewall/bot-manager/quickstart/) and [Bot Manager Lite](/en/documentation/guides/application-development/integrations/bot-manager-lite/) | | Cache | CDN cache behavior | Cache, including Tiered Cache | | Cloudflare for Platforms | Platforms built on Cloudflare services | Azion API and [Marketplace](/en/documentation/platform/marketplace/) | | Cloudflare Images | Storing, resizing, optimizing, and delivering images | [Image Processor](/en/documentation/platform/applications/image-processor/quickstart/), with the images stored in Object Storage | | Cloudflare Network Firewall | Firewall as a service for network traffic | Firewall and Network Shield | | D1 | Serverless SQL database built on SQLite | SQL Database | -| DDoS Protection | Protection against DDoS attacks | [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) | +| DDoS Protection | Protection against DDoS attacks | [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) | | Digital Experience Monitoring | User, device, network, and application experience | Edge Pulse and Real-Time Metrics | | DNS | Authoritative DNS and DNS security | Edge DNS | | Dynamic Workers | Isolated Workers created on demand | Functions | @@ -887,7 +887,7 @@ The `${network}` criterion requires Network Shield on the firewall. For the vari ## Rely on DDoS Protection -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks, such as UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris, on layers 3, 4, 6, and 7. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks, such as UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris, on layers 3, 4, 6, and 7. | Aspect | Cloudflare DDoS Protection | Azion DDoS Protection | | --- | --- | --- | @@ -1119,7 +1119,7 @@ For an Object Storage destination, the credential needs `listAllBucketNames`, `l ## Prepare the certificate -[Certificate Manager](/en/documentation/platform/workloads/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the domain points to Azion, so users reach the project over HTTPS from the first request. +[Certificate Manager](/en/documentation/platform/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the domain points to Azion, so users reach the project over HTTPS from the first request. | Area | Cloudflare SSL/TLS | Azion Certificate Manager | | --- | --- | --- | @@ -1169,7 +1169,7 @@ For a move from Cloudflare, use DNS-01. -If the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Retries continue on schedule, so a fixed record issues the certificate later. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +If the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Retries continue on schedule, so a fixed record issues the certificate later. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). mTLS needs a Trusted CA certificate, and an Azion-generated certificate cannot be the Trusted CA. Upload it, then set `mtls.enabled`, `mtls.config.certificate`, and `verification`, `enforce` or `permissive`, on the workload through the API or `azion update workload --file`. mTLS works over HTTPS only. For the steps, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/) and [mTLS](/en/documentation/platform/workloads/mtls/). diff --git a/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-customize-error-responses.mdx b/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-customize-error-responses.mdx index 2c8293c311..1e30259041 100644 --- a/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-customize-error-responses.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-customize-error-responses.mdx @@ -13,11 +13,11 @@ import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' -You can replace the error responses of a [workload](/en/documentation/platform/workloads/) with pages of your own, for several status codes at once, from Azion Console, the [Azion CLI](/en/documentation/devtools/cli/), or the API. To create your first set with one page and see it replace a `404`, refer to [Custom Pages quickstart](/en/documentation/platform/workloads/custom-pages/quickstart/). +You can replace the error responses of a [workload](/en/documentation/platform/workloads/) with pages of your own, for several status codes at once, from Azion Console, the [Azion CLI](/en/documentation/devtools/cli/), or the API. To create your first set with one page and see it replace a `404`, refer to [Custom Pages quickstart](/en/documentation/platform/custom-pages/quickstart/). -With [Custom Pages](/en/documentation/platform/workloads/#custom-pages), the pages live in a custom page set. Each page answers one status code that the application's [connector](/en/documentation/platform/connectors/) returns, and the set serves pages only after the workload's deployment names it. +With [Custom Pages](/en/documentation/platform/custom-pages/), the pages live in a custom page set. Each page answers one status code that the application's [connector](/en/documentation/platform/connectors/) returns, and the set serves pages only after the workload's deployment names it. -An application that runs on API v3 sets its error pages in Error Responses instead. For more information, refer to [Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/). +An application that runs on API v3 sets its error pages in Error Responses instead. For more information, refer to [Error Responses](/en/documentation/platform/custom-pages/error-responses/). --- @@ -69,7 +69,7 @@ An application that runs on API v3 sets its error pages in Error Responses inste ## Create a set with a page for each code -Each page in the set takes its own status code, connector path, cache time, and response status code. A page can also answer with a code other than the one the connector returned, such as a `404` in place of a `403`. Azion serves the page in place, with no redirect. After you change a page's document, Azion keeps serving the cached copy until its cache time runs out. For the codes a page accepts and the range of each field, refer to [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/#page-fields). +Each page in the set takes its own status code, connector path, cache time, and response status code. A page can also answer with a code other than the one the connector returned, such as a `404` in place of a `403`. Azion serves the page in place, with no redirect. After you change a page's document, Azion keeps serving the cached copy until its cache time runs out. For the codes a page accepts and the range of each field, refer to [Custom page settings](/en/documentation/platform/custom-pages/settings/#page-fields). @@ -281,15 +281,15 @@ For a page whose response status code is `404`, the response starts with this st HTTP/2 404 ``` -The response carries no `Location` header, so the client stays on the requested URL and is not redirected. If the connector's own error response still arrives after the deployment change has spread, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#custom-pages). +The response carries no `Location` header, so the client stays on the requested URL and is not redirected. If the connector's own error response still arrives after the deployment change has spread, refer to [Troubleshoot Custom Pages](/en/documentation/platform/custom-pages/troubleshooting/). --- ## Next steps - - + + - + diff --git a/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx b/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx index 5edf719415..d31931abfb 100644 --- a/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx @@ -10,7 +10,7 @@ permalink: /documentation/guides/application-security/tls-and-certificates/how-t import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' -You can request a TLS certificate signed by Let's Encrypt™ through the [Azion API](/en/documentation/devtools/api/#authentication), validated by the DNS-01 or the HTTP-01 challenge, including a wildcard certificate. To obtain one while you create a [workload](/en/documentation/platform/workloads/) in Azion Console instead, refer to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#lets-encrypt-certificate). +You can request a TLS certificate signed by Let's Encrypt™ through the [Azion API](/en/documentation/devtools/api/#authentication), validated by the DNS-01 or the HTTP-01 challenge, including a wildcard certificate. To obtain one while you create a [workload](/en/documentation/platform/workloads/) in Azion Console instead, refer to [Certificates](/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate). A web application served over HTTPS needs a TLS certificate. Let's Encrypt issues one free of charge, and Azion automates its issuance, its renewal, and its deactivation. Azion renews the certificate before it expires, as long as its validation settings stay valid and up to date. The renewal needs no maintenance window, and the certificate keeps its quotas, billing, and permissions. @@ -28,7 +28,7 @@ The two challenges prove control of the hostname in different ways: - A personal token, sent in the `Authorization` header as `Token [TOKEN VALUE]`. To create one, refer to [Manage a personal token](/en/documentation/guides/platform/account-and-billing/personal-tokens/). - `curl`, or another HTTP client. - The hostname the certificate covers, such as `www.example.com`. -- For DNS-01 with a zone that another DNS provider hosts, the `_acme-challenge` CNAME record of the hostname, set at that provider. A zone in [Edge DNS](/en/documentation/platform/edge-dns/) needs no record. For the record's name and value, refer to [Domain validation](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#domain-validation). +- For DNS-01 with a zone that another DNS provider hosts, the `_acme-challenge` CNAME record of the hostname, set at that provider. A zone in [Edge DNS](/en/documentation/platform/edge-dns/) needs no record. For the record's name and value, refer to [Domain validation](/en/documentation/platform/certificate-manager/issuance-and-renewal/#domain-validation). - For HTTP-01, the DNS of the hostname, and of every alternative name, pointed to Azion. - For a wildcard certificate, the domain's zone configured and active in [Edge DNS](/en/documentation/platform/edge-dns/). @@ -121,7 +121,7 @@ After a certificate request, Azion validates the hostname and issues the certifi Send the request again until the status shows that the issuance finished. When the issuance fails, the `status_detail` field carries the reason, such as `An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com`. -For what each status means, refer to [Statuses](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#statuses). For the retries Azion makes after a failed attempt, refer to [Issuance time and retries](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#issuance-time-and-retries). +For what each status means, refer to [Statuses](/en/documentation/platform/certificate-manager/issuance-and-renewal/#statuses). For the retries Azion makes after a failed attempt, refer to [Issuance time and retries](/en/documentation/platform/certificate-manager/issuance-and-renewal/#issuance-time-and-retries). The `status` and `status_detail` fields now tell you whether Azion issued the certificate, or why it could not. @@ -142,9 +142,9 @@ To bind the certificate from Azion Console, the Azion CLI, or the API, refer to ## Next steps - + - + diff --git a/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates.mdx b/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates.mdx index d582563929..ba21e7db6d 100644 --- a/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/edge-application/ea-request-lets-encrypt-certificates.mdx @@ -16,7 +16,7 @@ import VersionDualSteps from '~/includes/snippets/versionDualSteps/en/snippet.md You can request a Let's Encrypt™ certificate for the domains of a [workload](/en/documentation/platform/workloads/) from Azion Console, the [Azion CLI](/en/documentation/devtools/cli/), or the API. To use a certificate you obtained from another certificate authority instead, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/). -HTTPS on your own hostname needs a server certificate that covers it, because the default Azion SAN certificate covers only the workload domain and the Azion Custom Domain. With a Let's Encrypt certificate, [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) does the certificate work for you. Azion requests the certificate from Let's Encrypt, completes the challenge that proves you control each hostname, and renews the certificate before it expires. Some older clients cannot validate the chain of a Let's Encrypt certificate. For which clients, refer to [Certificate chain](/en/documentation/platform/workloads/certificate-manager/certificates/#certificate-chain). +HTTPS on your own hostname needs a server certificate that covers it, because the default Azion SAN certificate covers only the workload domain and the Azion Custom Domain. With a Let's Encrypt certificate, [Certificate Manager](/en/documentation/platform/certificate-manager/) does the certificate work for you. Azion requests the certificate from Let's Encrypt, completes the challenge that proves you control each hostname, and renews the certificate before it expires. Some older clients cannot validate the chain of a Let's Encrypt certificate. For which clients, refer to [Certificate chain](/en/documentation/platform/certificate-manager/certificates/#certificate-chain). An account that runs on API v3 with Domains selects the certificate on each domain instead. For more information, refer to [Domains](/en/documentation/platform/workloads/domains/). @@ -80,7 +80,7 @@ Let's Encrypt issues the certificate only after it validates every hostname on t | HTTP-01 | `http` | Every hostname already points to the workload domain | Every hostname already points to the workload domain | | DNS-01 | `dns` | No record. Azion writes the `_acme-challenge` record into the zone | One `_acme-challenge` `CNAME` record per hostname | -With DNS-01 and a zone at another DNS provider, create the `_acme-challenge` record of each hostname at that provider before you send the request. The table below carries its name and its value. With the zone in Edge DNS, Azion writes the record into the zone and the challenge completes with no action from you. Choose DNS-01 when a hostname does not point to Azion yet, such as during a move from another provider. For how each challenge validates a hostname, refer to [Domain validation](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#domain-validation). +With DNS-01 and a zone at another DNS provider, create the `_acme-challenge` record of each hostname at that provider before you send the request. The table below carries its name and its value. With the zone in Edge DNS, Azion writes the record into the zone and the challenge completes with no action from you. Choose DNS-01 when a hostname does not point to Azion yet, such as during a move from another provider. For how each challenge validates a hostname, refer to [Domain validation](/en/documentation/platform/certificate-manager/issuance-and-renewal/#domain-validation). At your DNS provider, create the records your challenge needs, one row per hostname: @@ -199,7 +199,7 @@ A name on the request that your account has no permission for is refused. The Az Error: Failed to request the Digital Certificate: ["This account cannot use certain common or alternative names because it does not have permission for their domain names."]. Check your settings and try again. If the error persists, contact Azion support ``` -For the causes and fixes, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#certificate-manager). A workload cannot list a wildcard hostname, so the Console cannot request a wildcard certificate. To request one with the DNS-01 challenge, refer to [Request a Let's Encrypt certificate with the API](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate-via-api/). +For the causes and fixes, refer to [Troubleshoot Certificate Manager](/en/documentation/platform/certificate-manager/troubleshooting/). A workload cannot list a wildcard hostname, so the Console cannot request a wildcard certificate. To request one with the DNS-01 challenge, refer to [Request a Let's Encrypt certificate with the API](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate-via-api/). --- @@ -360,7 +360,7 @@ The response carries the certificate with its `status` and `status_detail`. To l The certificate moves from `pending` to `challenge_verification` while the challenge awaits validation. Once Let's Encrypt issues it, it reads `active` while a workload names it, and `inactive` otherwise. When validation fails, it reads `failed`, and `status_detail` names the hostname to check, such as `An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com`. -A failed attempt is retried on a schedule, so a record you correct later can still end in an automatic issuance. For the retry schedule, refer to [Issuance time and retries](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#issuance-time-and-retries). For a certificate that stays `pending` or turns `failed`, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#certificate-manager). +A failed attempt is retried on a schedule, so a record you correct later can still end in an automatic issuance. For the retry schedule, refer to [Issuance time and retries](/en/documentation/platform/certificate-manager/issuance-and-renewal/#issuance-time-and-retries). For a certificate that stays `pending` or turns `failed`, refer to [Troubleshoot Certificate Manager](/en/documentation/platform/certificate-manager/troubleshooting/). --- @@ -417,8 +417,8 @@ The certificate is issued through the **DNS-01** challenge. A hostname whose zon ## Next steps - + - + diff --git a/apps/docs/src/content/docs/en/pages/guides/edge-dns/caa-record.mdx b/apps/docs/src/content/docs/en/pages/guides/edge-dns/caa-record.mdx index f2c69048af..1f8ab2f590 100644 --- a/apps/docs/src/content/docs/en/pages/guides/edge-dns/caa-record.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/edge-dns/caa-record.mdx @@ -63,7 +63,7 @@ You can restrict which certificate authorities (CAs) may issue certificates for The record goes on `@`, the apex, so it covers `example.com`. Replace `example.com` with your domain and `letsencrypt.org` with the CA you allow. -Certificate Manager requests a workload's certificates from Let's Encrypt. While it issues certificates for your domain, keep `letsencrypt.org` in the record. For how it issues and renews them, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +Certificate Manager requests a workload's certificates from Let's Encrypt. While it issues certificates for your domain, keep `letsencrypt.org` in the record. For how it issues and renews them, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). @@ -198,7 +198,7 @@ The answer lists the values of the CAA record. If it lists nothing, refer to [Tr ## Next steps - + diff --git a/apps/docs/src/content/docs/en/pages/guides/edge-dns/txt-verification.mdx b/apps/docs/src/content/docs/en/pages/guides/edge-dns/txt-verification.mdx index bf2edbf313..bdce1fb0a4 100644 --- a/apps/docs/src/content/docs/en/pages/guides/edge-dns/txt-verification.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/edge-dns/txt-verification.mdx @@ -11,7 +11,7 @@ import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' -You can verify a domain with a TXT record in [Edge DNS](/en/documentation/platform/edge-dns/) from Azion Console, the Azion CLI, or the Azion API. A service that asks you to prove control of a domain gives you a value, then reads it back from the domain's DNS. To validate a certificate that Azion requests for a workload, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#domain-validation) instead. +You can verify a domain with a TXT record in [Edge DNS](/en/documentation/platform/edge-dns/) from Azion Console, the Azion CLI, or the Azion API. A service that asks you to prove control of a domain gives you a value, then reads it back from the domain's DNS. To validate a certificate that Azion requests for a workload, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/#domain-validation) instead. --- diff --git a/apps/docs/src/content/docs/en/pages/guides/edge-firewall/update-edge-firewall.mdx b/apps/docs/src/content/docs/en/pages/guides/edge-firewall/update-edge-firewall.mdx index 597c0e2203..db85f6ad10 100644 --- a/apps/docs/src/content/docs/en/pages/guides/edge-firewall/update-edge-firewall.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/edge-firewall/update-edge-firewall.mdx @@ -14,7 +14,7 @@ import DocStep from '@aziontech/webkit/doc-step' You can move each setting of a deprecated Firewall rule set to a [firewall](/en/documentation/platform/firewall/) from Azion Console. A rule in [Rules Engine for Firewall](/en/documentation/platform/firewall/rules-engine/) replaces each setting. To add a rule that no deprecated rule set carried, refer to [Create a firewall rule](/en/documentation/guides/application-security/firewall-and-waf/work-with-rules-engine/). -A deprecated rule set was turned on in the main settings of an application. A behavior in that application's Rules Engine applied it. Azion Console marks a deprecated rule set with a banner that asks you to upgrade it. A firewall carries [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection), [Network Shield](/en/documentation/platform/firewall/network-shield/), [Web Application Firewall (WAF)](/en/documentation/platform/firewall/waf/), and [Functions](/en/documentation/platform/firewall/functions/) itself. One firewall can protect several workloads. +A deprecated rule set was turned on in the main settings of an application. A behavior in that application's Rules Engine applied it. Azion Console marks a deprecated rule set with a banner that asks you to upgrade it. A firewall carries [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/), [Network Shield](/en/documentation/platform/firewall/network-shield/), [Web Application Firewall (WAF)](/en/documentation/platform/firewall/waf/), and [Functions](/en/documentation/platform/firewall/functions/) itself. One firewall can protect several workloads. Each section of this page rebuilds one setting as a firewall rule. Geo-blocking and IP blocking also need a [network list](/en/documentation/platform/firewall/network-shield/network-lists/), and a secure token needs a function instance. Once the firewall applies its rules, you remove the deprecated rule sets from your applications. diff --git a/apps/docs/src/content/docs/en/pages/guides/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/en/pages/guides/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx index 3ade62477d..13edfdcf21 100644 --- a/apps/docs/src/content/docs/en/pages/guides/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx @@ -129,11 +129,11 @@ Every Fastly product in the inventory has a destination on Azion. Find the produ | Bot Management | Detection of, and response to, automated traffic | [Bot Manager](/en/documentation/platform/firewall/bot-manager/quickstart/) and [Bot Manager Lite](/en/documentation/platform/firewall/bot-manager/bot-manager-lite/) | | Cache APIs | Programmatic cache interaction for Compute applications | Functions, Cache, and [Real-Time Purge](/en/documentation/platform/applications/cache/real-time-purge/) | | Cache Reservation | Reserved cache capacity for content | [Cache](/en/documentation/platform/applications/cache/), including [Tiered Cache](/en/documentation/platform/applications/cache/tiered-cache/) | -| Certainly | Fastly certificate authority for TLS certificates | [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/) | +| Certainly | Fastly certificate authority for TLS certificates | [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/) | | Compute | Serverless compute that runs custom code on Fastly's network | Functions | | Compute packages | Packaged application code deployed to Compute | Functions and the [Azion CLI](/en/documentation/devtools/cli/) | | Conditions | Request, cache, and response conditions | [Rules Engine for Applications](/en/documentation/platform/applications/rules-engine/) | -| DDoS Protection | DDoS visibility and mitigation | [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) | +| DDoS Protection | DDoS visibility and mitigation | [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) | | Domain Inspector | Domain-level traffic visibility and reporting | Real-Time Metrics | | Domains | Hostnames associated with services | Workloads | | Edge Data Storage | Key-value data used by Compute services | KV Store | @@ -1129,7 +1129,7 @@ The `${network}` criterion requires Network Shield on the firewall. For the vari ## Rely on DDoS Protection -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks on layers 3, 4, 6, and 7. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) is on for every workload, with nothing to create and nothing to configure. It mitigates volumetric, protocol, and application-layer attacks on layers 3, 4, 6, and 7. | Aspect | Fastly DDoS Protection | Azion DDoS Protection | | --- | --- | --- | @@ -1364,7 +1364,7 @@ When logs do not reach the destination, check the stream status, the destination ## Prepare the certificate -[Certificate Manager](/en/documentation/platform/workloads/certificate-manager/quickstart/) holds the certificates that workloads serve. Fastly Platform TLS, TLS Service Options, and Certainly map to it. Prepare the certificate before the domain points to Azion, so users reach the service over HTTPS from the first request. +[Certificate Manager](/en/documentation/platform/certificate-manager/quickstart/) holds the certificates that workloads serve. Fastly Platform TLS, TLS Service Options, and Certainly map to it. Prepare the certificate before the domain points to Azion, so users reach the service over HTTPS from the first request. | Area | Fastly TLS | Azion Certificate Manager | | --- | --- | --- | @@ -1410,7 +1410,7 @@ For a move from Fastly, use DNS-01. -If the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Confirm that the hostname is in the **Domains** of the workload. Retries continue on schedule, so a fixed record issues the certificate later. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/), and for every certificate field, to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). +If the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Confirm that the hostname is in the **Domains** of the workload. Retries continue on schedule, so a fixed record issues the certificate later. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/), and for every certificate field, to [Certificates](/en/documentation/platform/certificate-manager/certificates/). mTLS needs a Trusted CA certificate, and an Azion-generated certificate cannot be the Trusted CA. Upload it, then set `mtls.enabled`, `mtls.config.certificate`, and `verification`, `enforce` or `permissive`, on the workload through the API or `azion update workload --file`. mTLS works over HTTPS only. For the steps, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/) and [mTLS](/en/documentation/platform/workloads/mtls/). diff --git a/apps/docs/src/content/docs/en/pages/guides/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/en/pages/guides/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx index f46a92cc2b..b0d39b7c36 100644 --- a/apps/docs/src/content/docs/en/pages/guides/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx @@ -126,7 +126,7 @@ Find each item of the inventory in the first column. The last column names the A | BotID | Bot verification for sensitive actions, invisible to the user | Bot Manager | | CI/CD and Preview Deployments | Builds from Git, with a preview environment for each change | Applications and the Azion CLI | | Content Delivery Network | Caching, routing, compression, TLS, redirects, and rewrites | Applications, [Cache](/en/documentation/platform/applications/cache/), and [Rules Engine for Applications](/en/documentation/platform/applications/rules-engine/) | -| Domains and DNS | Custom domains, DNS records, nameservers, and certificate automation | Workloads, Edge DNS, and [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) | +| Domains and DNS | Custom domains, DNS records, nameservers, and certificate automation | Workloads, Edge DNS, and [Certificate Manager](/en/documentation/platform/certificate-manager/) | | Edge Config | A replicated store for feature flags, experiments, redirects, and configuration | KV Store | | Environment Variables | Values for the production, preview, and development environments | [Environment variables](/en/documentation/platform/functions/environment-variables/), stored on the account | | Fluid Compute | A server-side compute model for concurrent dynamic workloads | Functions | @@ -135,7 +135,7 @@ Find each item of the inventory in the first column. The last column names the A | Microfrontends | Frontend projects deployed on their own, behind one routing layer | Applications and Rules Engine for Applications | | Observability | Monitoring of traffic, builds, functions, external API calls, performance, errors, and usage | Real-Time Metrics, Real-Time Events, and Data Stream | | Observability Plus | Longer retention, metrics, request data, queries, notebooks, monitoring, and alerts | Real-Time Metrics, Real-Time Events, and Data Stream | -| Platform Security | DDoS mitigation, TLS, platform firewalling, access controls, and security monitoring | Firewall, [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection), and [Network Shield](/en/documentation/platform/firewall/network-shield/) | +| Platform Security | DDoS mitigation, TLS, platform firewalling, access controls, and security monitoring | Firewall, [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/), and [Network Shield](/en/documentation/platform/firewall/network-shield/) | | Production Deployments | Builds promoted to the domains customers use | Applications and the Azion CLI | | Projects | The build, deployment, environment, domain, and runtime settings of one project | Applications, served by a workload | | Redirects and rewrites | Path and host routing from project settings, framework configuration, or `vercel.json` | Rules Engine for Applications | @@ -1469,7 +1469,7 @@ A second rule with `${request_uri}` _starts with_ `/preview/` protects preview p ## Rely on DDoS Protection -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) covers every workload, with nothing to create or configure. It takes over the DDoS mitigation of Vercel Platform Security. It mitigates volumetric, protocol, and application-layer attacks on layers 3, 4, 6, and 7: UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris, among others. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) covers every workload, with nothing to create or configure. It takes over the DDoS mitigation of Vercel Platform Security. It mitigates volumetric, protocol, and application-layer attacks on layers 3, 4, 6, and 7: UDP and ICMP floods, SYN floods, packet fragmentation, HTTP floods, and slowloris, among others. | Aspect | Azion DDoS Protection | | --- | --- | @@ -1731,7 +1731,7 @@ To move the real-user monitoring: ## Prepare the certificate -[Certificate Manager](/en/documentation/platform/workloads/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the domain points to Azion, so users reach the project over HTTPS from the first request. +[Certificate Manager](/en/documentation/platform/certificate-manager/quickstart/) holds the certificates that workloads serve. Prepare the certificate before the domain points to Azion, so users reach the project over HTTPS from the first request. | Area | Azion Certificate Manager | | --- | --- | @@ -1778,7 +1778,7 @@ For a move from Vercel, use DNS-01, so the certificate is active before the doma -When the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Retries continue on schedule, so a fixed record issues the certificate later. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +When the certificate does not become active, read its `status` and `status_detail`. For HTTP-01, check that the hostname points to Azion. For DNS-01, check the `_acme-challenge` CNAME. Retries continue on schedule, so a fixed record issues the certificate later. For the issuance rules, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). mTLS needs a Trusted CA certificate, and an Azion-generated certificate cannot be the Trusted CA. Upload it, then set `mtls.enabled`, `mtls.config.certificate`, and `verification`, `enforce` or `permissive`, on the workload through the API or `azion update workload --file`. mTLS works over HTTPS only. For the steps, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/) and [mTLS](/en/documentation/platform/workloads/mtls/). diff --git a/apps/docs/src/content/docs/en/pages/hubs/guides/certificate-manager.mdx b/apps/docs/src/content/docs/en/pages/hubs/guides/certificate-manager.mdx new file mode 100644 index 0000000000..3a62feee34 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/hubs/guides/certificate-manager.mdx @@ -0,0 +1,10 @@ +--- +title: Certificate Manager guides and tutorials +description: Every guide and tutorial for Certificate Manager, each covering one task. +meta_tags: 'certificate manager, guides, tutorials' +namespace: documentation_products_certificate_manager_guides +permalink: /documentation/platform/certificate-manager/guides/ +guides_hub: certificate-manager +--- + +Every guide and tutorial for Certificate Manager, each covering one task. Open one and it takes you to the Guides section, where every guide lives. diff --git a/apps/docs/src/content/docs/en/pages/hubs/guides/custom-pages.mdx b/apps/docs/src/content/docs/en/pages/hubs/guides/custom-pages.mdx new file mode 100644 index 0000000000..a93269b033 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/hubs/guides/custom-pages.mdx @@ -0,0 +1,10 @@ +--- +title: Custom Pages guides and tutorials +description: Every guide and tutorial for Custom Pages, each covering one task. +meta_tags: 'custom pages, guides, tutorials' +namespace: documentation_products_custom_pages_guides +permalink: /documentation/platform/custom-pages/guides/ +guides_hub: custom-pages +--- + +Every guide and tutorial for Custom Pages, each covering one task. Open one and it takes you to the Guides section, where every guide lives. diff --git a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/certificate-manager-reference.mdx b/apps/docs/src/content/docs/en/pages/hubs/nav/certificate-manager/reference.mdx similarity index 65% rename from apps/docs/src/content/docs/en/pages/hubs/nav/workloads/certificate-manager-reference.mdx rename to apps/docs/src/content/docs/en/pages/hubs/nav/certificate-manager/reference.mdx index d6b1f88b21..34495f3787 100644 --- a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/certificate-manager-reference.mdx +++ b/apps/docs/src/content/docs/en/pages/hubs/nav/certificate-manager/reference.mdx @@ -1,9 +1,9 @@ --- title: Certificate Manager reference description: Find the reference pages of Certificate Manager in one list, each with a summary of what it covers. -meta_tags: 'certificate manager, reference, workloads' +meta_tags: 'certificate manager, reference, certificates, issuance and renewal, tls' namespace: documentation_hub_workloads_certificate_manager_reference -permalink: /documentation/platform/workloads/certificate-manager/reference/ +permalink: /documentation/platform/certificate-manager/reference/ --- This section holds the reference pages of Certificate Manager. diff --git a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/custom-pages-reference.mdx b/apps/docs/src/content/docs/en/pages/hubs/nav/custom-pages/reference.mdx similarity index 66% rename from apps/docs/src/content/docs/en/pages/hubs/nav/workloads/custom-pages-reference.mdx rename to apps/docs/src/content/docs/en/pages/hubs/nav/custom-pages/reference.mdx index 2178ae7c1f..75cad74312 100644 --- a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/custom-pages-reference.mdx +++ b/apps/docs/src/content/docs/en/pages/hubs/nav/custom-pages/reference.mdx @@ -1,9 +1,9 @@ --- title: Custom Pages reference description: Find the reference pages of Custom Pages in one list, each with a summary of what it covers. -meta_tags: 'custom pages, reference, workloads' +meta_tags: 'custom pages, reference, custom page settings, error responses' namespace: documentation_hub_workloads_custom_pages_reference -permalink: /documentation/platform/workloads/custom-pages/reference/ +permalink: /documentation/platform/custom-pages/reference/ --- This section holds the reference pages of Custom Pages. diff --git a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/certificate-manager.mdx b/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/certificate-manager.mdx deleted file mode 100644 index 9dd19eacb8..0000000000 --- a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/certificate-manager.mdx +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Certificate Manager -description: Find the pages of Certificate Manager, from its quickstart to its reference, in one list, each with a summary of what it covers. -meta_tags: 'certificate manager, workloads' -namespace: documentation_hub_workloads_certificate_manager -permalink: /documentation/platform/workloads/certificate-manager/ ---- - -This section holds the pages of Certificate Manager, a Platform Resource nested in Workloads. diff --git a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/custom-pages.mdx b/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/custom-pages.mdx deleted file mode 100644 index 518b2f8731..0000000000 --- a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/custom-pages.mdx +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Custom Pages -description: Find the pages of Custom Pages, from its quickstart to its reference, in one list, each with a summary of what it covers. -meta_tags: 'custom pages, workloads' -namespace: documentation_hub_workloads_custom_pages -permalink: /documentation/platform/workloads/custom-pages/ ---- - -This section holds the pages of Custom Pages, a Platform Resource nested in Workloads. diff --git a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/ddos-protection.mdx b/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/ddos-protection.mdx index fee160d103..421d4c04c8 100644 --- a/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/ddos-protection.mdx +++ b/apps/docs/src/content/docs/en/pages/hubs/nav/workloads/ddos-protection.mdx @@ -6,4 +6,4 @@ namespace: documentation_hub_workloads_ddos_protection permalink: /documentation/platform/workloads/ddos-protection/ --- -This section holds the pages of DDoS Protection, a Platform Resource nested in Workloads. +This section holds the pages of DDoS Protection, a Feature of the Azion Platform that mitigates denial-of-service attacks on every Workload. diff --git a/apps/docs/src/content/docs/en/pages/main-menu/additional-resources/migrate-to-azion/migrate-to-azion.mdx b/apps/docs/src/content/docs/en/pages/main-menu/additional-resources/migrate-to-azion/migrate-to-azion.mdx index 2ee388db6a..899de2b1a7 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/additional-resources/migrate-to-azion/migrate-to-azion.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/additional-resources/migrate-to-azion/migrate-to-azion.mdx @@ -214,7 +214,7 @@ A domain apex cannot hold a CNAME record at every provider. To point the apex, [ - + diff --git a/apps/docs/src/content/docs/en/pages/main-menu/get-started/azion-platform-overview.mdx b/apps/docs/src/content/docs/en/pages/main-menu/get-started/azion-platform-overview.mdx index 3ee872ad32..58cd2fdd69 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/get-started/azion-platform-overview.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/get-started/azion-platform-overview.mdx @@ -71,7 +71,7 @@ Everything you enable or create lives on the resources of the request path. Some | Resource | What you enable or create on it | Reference | | --- | --- | --- | -| Workload | The TLS certificate bound to the workload, the custom page set its deployment names, and DDoS mitigation, which applies to every workload with nothing to enable. | [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager), [Custom Pages](/en/documentation/platform/workloads/#custom-pages), [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) | +| Workload | The TLS certificate bound to the workload, the custom page set its deployment names, and DDoS mitigation, which applies to every workload with nothing to enable. | [Certificate Manager](/en/documentation/platform/certificate-manager/), [Custom Pages](/en/documentation/platform/custom-pages/), [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) | | Firewall | A WAF rule set applied to the firewall, a Bot Manager instance running on it, and the network lists its rules reference. | [WAF](/en/documentation/platform/firewall/waf/), [Bot Manager](/en/documentation/platform/firewall/bot-manager/), [Network Shield](/en/documentation/platform/firewall/network-shield/) | | Application | Cache settings, the Application Accelerator and Image Processor switches, and the functions instantiated on the application. | [Cache](/en/documentation/platform/applications/cache/), [Application Accelerator](/en/documentation/platform/applications/application-accelerator/), [Image Processor](/en/documentation/platform/applications/image-processor/) | | Connector | Load balancing across several addresses, and Origin Shield, which lets only Azion's IP ranges reach the origin. | [Load Balancer](/en/documentation/platform/connectors/load-balancer/), [Origin Shield](/en/documentation/platform/connectors/origin-shield/) | diff --git a/apps/docs/src/content/docs/en/pages/main-menu/get-started/fundamentals.mdx b/apps/docs/src/content/docs/en/pages/main-menu/get-started/fundamentals.mdx index 0fc77abea3..fac700d944 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/get-started/fundamentals.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/get-started/fundamentals.mdx @@ -24,10 +24,10 @@ Everything that serves traffic on Azion is a set of Platform Resources bound to -1. A [workload](/en/documentation/platform/workloads/) receives the traffic for its domains. It holds the [domains](/en/documentation/platform/workloads/domains/) and the certificate from [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager), and it binds, side by side, a firewall, an application, and a custom page set. -2. A [firewall](/en/documentation/platform/firewall/) inspects each request before the application. You apply a [WAF](/en/documentation/platform/firewall/waf/) rule set, [Bot Manager](/en/documentation/platform/firewall/bot-manager/), [Network Shield](/en/documentation/platform/firewall/network-shield/) lists, and functions to it. [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is always on, with or without a firewall. +1. A [workload](/en/documentation/platform/workloads/) receives the traffic for its domains. It holds the [domains](/en/documentation/platform/workloads/domains/) and the certificate from [Certificate Manager](/en/documentation/platform/certificate-manager/), and it binds, side by side, a firewall, an application, and a custom page set. +2. A [firewall](/en/documentation/platform/firewall/) inspects each request before the application. You apply a [WAF](/en/documentation/platform/firewall/waf/) rule set, [Bot Manager](/en/documentation/platform/firewall/bot-manager/), [Network Shield](/en/documentation/platform/firewall/network-shield/) lists, and functions to it. [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) is always on, with or without a firewall. 3. An [application](/en/documentation/platform/applications/) serves the content. [Rules Engine](/en/documentation/platform/applications/rules-engine/) decides what to do with each request, such as redirecting it or changing its headers. [Cache](/en/documentation/platform/applications/cache/) keeps a copy of a response and answers repeat requests from it, without going to the origin. [Image Processor](/en/documentation/platform/applications/image-processor/) resizes and optimizes images before they are delivered. [Functions](/en/documentation/platform/functions/) runs your own code in the request path. -4. A [custom page set](/en/documentation/platform/workloads/#custom-pages) replaces the default error responses with pages you control. +4. A [custom page set](/en/documentation/platform/custom-pages/) replaces the default error responses with pages you control. 5. When the cache cannot answer, the application fetches the content through a [connector](/en/documentation/platform/connectors/): an HTTP connector reaches your origin server, and a [storage connector](/en/documentation/platform/connectors/settings/#storage) reads an Object Storage bucket. [Load Balancer](/en/documentation/platform/connectors/load-balancer/) and [Origin Shield](/en/documentation/platform/connectors/origin-shield/) are enabled on the connector. 6. Your functions can read and write data in [SQL Database](/en/documentation/platform/sql-database/), [KV Store](/en/documentation/platform/kv-store/), and [Object Storage](/en/documentation/platform/object-storage/), and call AI models through [AI Inference](/en/documentation/platform/ai-inference/). diff --git a/apps/docs/src/content/docs/en/pages/main-menu/performance/maintenance-mode.mdx b/apps/docs/src/content/docs/en/pages/main-menu/performance/maintenance-mode.mdx index e44eaf1d37..968084fd6e 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/performance/maintenance-mode.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/performance/maintenance-mode.mdx @@ -13,7 +13,7 @@ import DocStep from '@aziontech/webkit/doc-step' import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' -You put an application in maintenance mode with a request-phase rule on its [rules engine](/en/documentation/platform/applications/rules-engine/). The rule answers every visitor with a maintenance page and ends the request before it reaches the origin. Removing the rule returns the application to normal, with no deploy. To change what visitors see when the origin itself returns an error, refer to [Custom Pages](/en/documentation/platform/workloads/#custom-pages). +You put an application in maintenance mode with a request-phase rule on its [rules engine](/en/documentation/platform/applications/rules-engine/). The rule answers every visitor with a maintenance page and ends the request before it reaches the origin. Removing the rule returns the application to normal, with no deploy. To change what visitors see when the origin itself returns an error, refer to [Custom Pages](/en/documentation/platform/custom-pages/). --- @@ -127,7 +127,7 @@ To return the application to normal, delete the maintenance rule. The remaining - + diff --git a/apps/docs/src/content/docs/en/pages/main-menu/performance/minimize-downtime.mdx b/apps/docs/src/content/docs/en/pages/main-menu/performance/minimize-downtime.mdx index 1debcb07a7..48391fa05b 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/performance/minimize-downtime.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/performance/minimize-downtime.mdx @@ -159,6 +159,6 @@ A 503 from the origin now returns your page. The status code stays 503 unless yo - + diff --git a/apps/docs/src/content/docs/en/pages/main-menu/pricing/pricing.mdx b/apps/docs/src/content/docs/en/pages/main-menu/pricing/pricing.mdx index 7c0ba7deea..144c18a948 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/pricing/pricing.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/pricing/pricing.mdx @@ -535,7 +535,7 @@ Included with Firewall, no additional charge. DDoS Protection is on by default on every Workload. Mitigation of network and transport layer attacks, Open Systems Interconnection (OSI) layers 3 and 4, is unmetered. Mitigation of application layer attacks, OSI layer 7, including connection-based restrictions, may generate chargeable traffic, as the [Terms of Service](/en/documentation/agreements/tos/) state. - + ### Edge DNS diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/sso-integration.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/sso-integration.mdx index c5f3e1a6ad..317a450b9b 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/sso-integration.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/accounts/sso-integration.mdx @@ -31,7 +31,7 @@ Azion SSO supports X.509 certificate-based authentication as an additional authe The authentication flow works identically for all types of X.509 certificates. Users do not need to perform any special configuration or different actions to use X.509 certificate authentication: the process integrates with your existing SSO setup. -To configure an X.509 certificate on Azion, refer to [How to configure an X.509 certificate](/en/documentation/platform/workloads/certificate-manager/certificates/#server-certificate) in the Certificate Manager documentation. +To configure an X.509 certificate on Azion, refer to [How to configure an X.509 certificate](/en/documentation/platform/certificate-manager/certificates/#server-certificate) in the Certificate Manager documentation. --- diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/domains.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/domains.mdx index 5d94efb304..ab30fb8e20 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/domains.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/domains.mdx @@ -25,7 +25,7 @@ You may also bind a **Digital Certificate** to domains that use the HTTPS protoc | Scope | Resource | | --- | --- | | Adding a custom domain | [Getting started](/en/documentation/guides/platform/migration/configure-a-domain/) | -| About Certificate Manager | [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/) | +| About Certificate Manager | [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/) | | About mTLS | [mTLS](/en/documentation/platform/workloads/mtls/) | --- diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/mtls.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/mtls.mdx index 404aa1976c..06eb2ae16e 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/mtls.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/domains/mtls.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Mutual TLS (mTLS), also called mutual authentication, is a Transport Layer Security (TLS) handshake in which the client also presents a certificate. On a [Workload](/en/documentation/platform/workloads/), Azion validates that client certificate against a Trusted CA certificate, the certificate of a certificate authority (CA) that you trust. A Trusted CA certificate is one of the types listed in [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). mTLS is optional on a Workload, and the Open Banking model requires it, so Workloads that serve financial services and payments often need it. For the `mtls` row among every other Workload field, refer to [Workload settings](/en/documentation/platform/workloads/settings/#mtls). +Mutual TLS (mTLS), also called mutual authentication, is a Transport Layer Security (TLS) handshake in which the client also presents a certificate. On a [Workload](/en/documentation/platform/workloads/), Azion validates that client certificate against a Trusted CA certificate, the certificate of a certificate authority (CA) that you trust. A Trusted CA certificate is one of the types listed in [Certificates](/en/documentation/platform/certificate-manager/certificates/). mTLS is optional on a Workload, and the Open Banking model requires it, so Workloads that serve financial services and payments often need it. For the `mtls` row among every other Workload field, refer to [Workload settings](/en/documentation/platform/workloads/settings/#mtls). --- @@ -144,7 +144,7 @@ The Workload requests a certificate, the client sends none, and the connection e - The Trusted CA certificates a Workload uses in mTLS, the CRLs it lists, and how to upload each one. + The Trusted CA certificates a Workload uses in mTLS, the CRLs it lists, and how to upload each one. The steps that upload a Trusted CA, turn on mTLS on a Workload, and add a permissive rule. Every other field of a Workload, from domains and ports to the server certificate in TLS. The bound on the size of a Trusted CA certificate. diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx index 5e5ebc5ffc..006b0574c2 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx @@ -145,7 +145,7 @@ The [Image Processor overview](/en/documentation/platform/applications/image-pro - **Cache and images in code**: code that reads or writes cached entries runs in a Function and uses the [Cache API](/en/documentation/devtools/runtime/api-reference/cache/), because Cache itself cannot run code. A Function that processes images on its own uses the WASM Image Processor library, which is separate from the Image Processor Platform Resource. [Where Image Processor stops](/en/documentation/platform/applications/image-processor/image-delivery/#where-image-processor-stops) explains the difference. - **Devices**: a [device group](/en/documentation/platform/applications/device-groups/) is a name and a regular expression that the Application compares with the `User-Agent` header of each request. Both uses of a group need Application Accelerator on: a rule tests the group through `${device_group}`, and a cache setting can keep one copy per group. [Applications best practices](/en/documentation/platform/applications/best-practices/#match-a-device-group-on-the-words-that-only-that-device-sends) shows how to write an expression that matches only the devices you mean. - **WebSocket**: [WebSocket Proxy](/en/documentation/platform/applications/websocket/) is a Feature of Applications that carries a WebSocket connection between your users and the origin. The connection opens with the `Upgrade: websocket` and `Connection: upgrade` headers. Azion turns the Feature on for an account only on request, and [Support guidelines](/en/documentation/support/) explains how to ask. Because Azion recycles keepalive connections about every 15 minutes, the client must reopen a WebSocket connection when it closes. -- **Workloads**: a Workload holds the domains, protocols, and certificates that serve the Application, so you configure delivery on the Workload, not on the Application. [Test an application through the hosts file](/en/documentation/guides/application-development/getting-started/stage-applications-through-hosts-file/) shows how to request an Application on your own domain from one device before you change its DNS records. _Redirect HTTP to HTTPS_ works only when the Workload has HTTPS. When the Connector receives a 4xx or 5xx response from your origin, [Custom Pages](/en/documentation/platform/workloads/#custom-pages) on the Workload sets the error page that the client sees. +- **Workloads**: a Workload holds the domains, protocols, and certificates that serve the Application, so you configure delivery on the Workload, not on the Application. [Test an application through the hosts file](/en/documentation/guides/application-development/getting-started/stage-applications-through-hosts-file/) shows how to request an Application on your own domain from one device before you change its DNS records. _Redirect HTTP to HTTPS_ works only when the Workload has HTTPS. When the Connector receives a 4xx or 5xx response from your origin, [Custom Pages](/en/documentation/platform/custom-pages/) on the Workload sets the error page that the client sees. - **Interfaces**: in [Azion Console](https://console.azion.com/), you create and manage your Applications on the **Applications** page, where each Application has five tabs: **Main Settings**, **Device Groups**, **Cache Settings**, **Functions Instances**, and **Rules Engine**. In the Console, the **Clone** row action of the **Applications** list creates a separate Application with the settings of the original, as [Clone an application](/en/documentation/guides/application-development/getting-started/clone-applications/) shows. The [Azion API](https://api.azion.com/) serves your Applications at `/v4/workspace/applications`, and [Azion CLI](/en/documentation/devtools/cli/) manages them with commands such as `azion create application`, `azion update application`, and `azion create rules-engine`. You can also create and configure your Applications with [`azion.config.js`](/en/documentation/devtools/cli/azion-config-js/), [Azion Lib](/en/documentation/devtools/azion-lib/application/), or the [Azion Terraform Provider](/en/documentation/devtools/terraform/). If your account has not migrated to API v4, use [Applications | v3](/en/documentation/platform/applications/v3/). - **Observability**: with Debug Rules on, [Real-Time Events](/en/documentation/platform/real-time-events/) and [Data Stream](/en/documentation/platform/data-stream/) show the rules that each request ran, in the `$traceback` field. Debug Rules starts off in a new Application. It is the `debug` field of the Application in the API, and [Main Settings](/en/documentation/platform/applications/main-settings/#debug-rules) shows where to turn it on in Azion Console. To check one response, send the request with `Pragma: azion-debug-cache`: the response reports its cache status, such as `HIT` or `MISS`, in the `x-cache` header. Across all requests, [Real-Time Metrics](/en/documentation/platform/real-time-metrics/) shows the traffic of Cache and [Tiered Cache](/en/documentation/platform/applications/cache/tiered-cache/). [Troubleshoot Applications](/en/documentation/platform/applications/troubleshooting/) lists the tools and queries. For traffic that differs from what you see, refer to [A problem shows in traffic but not in the responses you request](/en/documentation/platform/applications/troubleshooting/#a-problem-shows-in-traffic-but-not-in-the-responses-you-request). - **Limits**: an Application accepts at most 200 rules, counting both phases. Each rule has 1 to 5 groups of 1 to 10 criteria, plus 1 to 10 behaviors. Without Application Accelerator, a cache setting needs a Max Age, its `modules.cache.max_age` field, of at least 60 seconds. One cached object can be as large as 10 GB. [Applications limits](/en/documentation/platform/applications/limits/) lists every bound, what happens past it, and the bounds of each Platform Resource nested in Applications. diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/error-responses.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/error-responses.mdx deleted file mode 100644 index 956c5f9578..0000000000 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/error-responses.mdx +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Error Responses -description: >- - Error Responses is an Applications capability that allows you to customize - error pages for users based on the status code received from the origin. -meta_tags: 'errors, application, http, error pages' -namespace: documentation_edge_application_error_responses -permalink: /documentation/platform/workloads/custom-pages/error-responses/ ---- -import DocButton from '~/components/webkit/DocButton.vue'; -import VersionDeprecated from '~/includes/snippets/versionDeprecated/en/snippet.mdx' - -[Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/) - -**Error Responses** is an Azion **Applications** feature that allows you to customize error pages for users based on the status code received from the origin. - -When a user requests content from an application, Azion sends the request to the origin servers. As a response, the origin sends back an HTTP status code, which indicates whether or not the request has been completed. - -HTTP status codes are three-digit numbers, grouped into five categories: - -* Informational responses (1xx): the connection status or progress before completing the request. -* Successful responses (2xx): the request was successfully received, understood, accepted, and processed by the origin. -* Redirection messages (3xx): in order to fulfill the request, there must be a redirect. -* Client error responses (4xx): the request couldn't be completed due to an apparent error on the client's side. -* Server error responses (5xx): the server is unable to process the request. - -:::note -See the [specifications on HTTP status codes](https://httpwg.org/specs/rfc9110.html#overview.of.status.codes) for more information on HTTP statuses. -::: - -With **Error Responses**, you can customize how your application will handle *Client (4xx)* and *Server (5xx)* error types. This way, when a request is made to a URL that can't be found at the origin or when the server is unable to respond, the user will be redirected to a custom error page, whose contents can be cached. - -## Implementation - -| Scope | Resource | -| --- | --- | -| Applications first steps | [Applications quickstart](/en/documentation/platform/applications/quickstart/) | -| Customizing error page | [Customize an error page](/en/documentation/guides/application-development/getting-started/customizing-error-response-page/) | - ---- - -## Status Code - -The code Azion receives when connecting to the origin. - ---- - -## Error Caching TTL - -Defines the time in seconds that the error page will remain in cache before it's refreshed. - -:::tip -Since an error page is often static and doesn't change frequently, Azion recommends high value cache times. That way, you can optimize your application's performance and reduce the cost of processing at the origin. -::: - - - ---- - -## URI - -Path to the file (usually in HTML) with the content of the error page that will be delivered. This path is appended to your application's domain. For example: `/404.html`. - ---- - -## Custom Status Code - -Status code that will be delivered to the user instead of the original one. For example, you may define that the `404` code be delivered in response to a `403` error. - ---- - -## Set Origin - -The origin in which the URI file is located. Can only be altered if a URI is provided. Must be configured using **Origins**. - - - ---- - -## Available error status codes - -| Status Code | Description | -| --- | --- | -| 400: Bad Request | Request error caused by invalid parameters, missing required parameters, or others. | -| 401: Unauthorized | Error resulting from a lack of the `Authentication` HTTP header. | -| 403: Forbidden | Lack of user permissions to execute the operation. | -| 404: Not Found | The resource requested doesn't exist. | -| 405: Method Not Allowed | The requested method can't be applied to the URL. | -| 406: Not Acceptable | `Accept` header wasn't found in the HTTP request or header contains content whose formatting or version isn't supported by the API. | -| 408: Request Timeout | The server informs that the request is coming in slower than the server is prepared to wait. This means the server would like to terminate the connection.

This response is often used since some browsers, like Chrome, Firefox 27+, or IE9, use HTTP pre-connection to speed up navigation. Also, some servers take down the connection without sending this message. | -| 409: Conflict | Conflict in the execution of the request, such as creating an existing registry. | -| 410: Gone | This response is sent when the requested content was permanently deleted from the server, without a preset redirect address. If this error happens, any caches or links to this resource should be removed.

The HTTP specification describes that this code should be used for "limited promotional services". APIs shouldn't be made to indicate which resources were removed with this status code. | -| 411: Length Required | The server has rejected the request because the header `Content-Length` is undefined but required by the server. | -| 414: URI Too Long | The requested URI is larger than the server's limits. | -| 415: Unsupported Media Type | The media format of the requested data is unsupported by the server, so the server rejects it. | -| 416: Request Range Not Satisfiable | The value specified by the `Range` header couldn't be filled; it's likely that it's out of range of the target URI data. | -| 426: Upgrade Required | The server refuses to execute the requisition using the current protocol, but it'll be ready to do so after the client updates to a different protocol. The server sends an `Upgrade` header response to indicate the required protocols. | -| 429: Too Many Requests | The request was temporarily rejected for exceeding operation limits. The client must wait until the moment defined in the `X-Ratelimit-Reset` and try again. | -| 431: Request Header Fields Too Large | The request's headers are too long or too many cookies were sent in the request. | -| 500: Internal Server Error | Unintentional error, fault unidentified in the processing of the request. | -| 501: Not Implemented | The request method is unsupported by the server and can't be modified. The only methods required for servers to support (and thus shouldn't return this code) are GET and HEAD. | -| 502: Bad Gateway | This error response means that the server, working as a gateway in order to obtain a necessary response to manipulate the request, obtained an invalid response. | -| 503: Service Unavailable | The server isn't ready to handle the request. Common causes are an overloaded server or a server under maintenance. Next to this response, a friendly page explaining the problem should be sent.

These responses should be used for temporary conditions and the `Retry-After` header should contain the estimated time to recover the service. The webmaster should also be careful with the caching related headers that are sent with this response, since these temporary condition responses shouldn't normally be cached. | -| 504: Gateway Timeout | This error response is sent when the server is acting as a gateway and doesn't obtain a response in time. | -| 505: HTTP Version Not Supported | The HTTP version used in the request isn't supported by the server. | - - - - diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/edge-application-v3.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/edge-application-v3.mdx index 655cd05943..a163a635a0 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/edge-application-v3.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/edge-application-v3.mdx @@ -46,7 +46,7 @@ You can create and manage applications using: | Application Cache Settings | [Cache Settings](/en/documentation/platform/applications/cache/cache-settings/) | | Get to know Functions | [Functions Instances](/en/documentation/platform/applications/functions-instances/) | | Get to know Device Groups | [Device Groups](/en/documentation/platform/applications/device-groups/) | -| Get to know Error Responses | [Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/) | +| Get to know Error Responses | [Error Responses](/en/documentation/platform/custom-pages/error-responses/) | | Get to know Origins | [Origins](/en/documentation/platform/connectors/origins/) | | Get to know Real-Time Purge | [Real-Time Purge](/en/documentation/platform/applications/cache/real-time-purge/) | | Rules Engine for Application | [Rules Engine](/en/documentation/platform/applications/rules-engine/) | @@ -82,7 +82,7 @@ See the documentation for each available setting: | [Main Settings](/en/documentation/platform/applications/main-settings-v3/) | Customize your application delivery with Azion's range of protocol options including HTTP, HTTPS, and HTTP/3 support for a better user experience and secure your connection with TLS ciphers. | | [Origins](/en/documentation/platform/connectors/origins/) | Modify your origin address, `Host` header, path, protocol policies, and HMAC authentication credentials. | | [Device Groups](/en/documentation/platform/applications/device-groups/) | Create groups to change your application's cache and delivery behavior according to end-user devices. | -| [Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/) | Customize error response pages, their cache expiration time, and their origin. | +| [Error Responses](/en/documentation/platform/custom-pages/error-responses/) | Customize error response pages, their cache expiration time, and their origin. | | [Cache Settings](/en/documentation/platform/applications/cache/cache-settings/) | Configure your application's browser and cache expiration time, large file optimization, and advanced cache behavior based on cookies or query strings. | | [Functions](/en/documentation/platform/applications/functions-instances/) | Instantiate functions created with **Functions**. | | [Rules Engine](/en/documentation/platform/applications/rules-engine/) | Automate the execution of behaviors based on specific parameters for your application. | @@ -101,7 +101,7 @@ Azion **Workloads** provides you with the flexibility to use automatically gener With **Certificate Manager**, you can enhance the security of your HTTPS applications by binding a custom TLS certificate to your application. - + --- diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/main-settings-v3.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/main-settings-v3.mdx index 0d2c649e9b..076ea1f6a9 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/main-settings-v3.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/v3/main-settings-v3.mdx @@ -25,7 +25,7 @@ With [Application](/en/documentation/platform/applications/), you can choose you - **HTTP & HTTPS**: delivers your application using both the HTTP and HTTPS protocols. :::note -If you choose to deliver your application through HTTP & HTTPS, you must associate a [digital certificate](/en/documentation/platform/workloads/certificate-manager/certificates/) to your domain. +If you choose to deliver your application through HTTP & HTTPS, you must associate a [digital certificate](/en/documentation/platform/certificate-manager/certificates/) to your domain. ::: ### HTTP/3 support diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/api-v4-migration.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/api-v4-migration.mdx index 3639d8595d..d8638b55d5 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/api-v4-migration.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/api-v4-migration.mdx @@ -1076,7 +1076,7 @@ Existing Error Responses will be automatically converted to **Custom Pages** in - Enable or disable any **Custom Page** using a status toggle. - View and manage a paginated list of all configured status codes through the user interface. - + --- diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx index 05d506679b..7be5b8e6c5 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx @@ -18,7 +18,7 @@ import DocItem from '@aziontech/webkit/doc-item' **Server Name Indication (SNI)** is a TLS extension that allows a client to specify the hostname it intends to reach during the TLS handshake, before the server sends its certificate. This enables a single server to host multiple TLS-enabled workloads on the same IP address, each with its own certificate. -On the Azion Web Platform, each workload is associated with a [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/) entry. When a client establishes a TLS connection, the platform uses the SNI value to select the appropriate certificate. If the HTTP `Host` header used in the subsequent request does not match the certificate's covered names (Common Name or Subject Alternative Names), the request is considered misdirected. +On the Azion Web Platform, each workload is associated with a [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/) entry. When a client establishes a TLS connection, the platform uses the SNI value to select the appropriate certificate. If the HTTP `Host` header used in the subsequent request does not match the certificate's covered names (Common Name or Subject Alternative Names), the request is considered misdirected. --- @@ -74,7 +74,7 @@ SNI Check enforcement is not configurable through the Azion Console or the API. - The certificates whose Common Name and Subject Alternative Names decide which hostnames pass the check. + The certificates whose Common Name and Subject Alternative Names decide which hostnames pass the check. How to find the requests that receive a 421 response and fix the certificate or the hostname. The logs that show the host and the TLS server name of each request. What a connector does once a request passes the check and reaches your application. diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx index 6ab9f7dcde..8a3d47f037 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx @@ -11,7 +11,7 @@ import DocItem from '@aziontech/webkit/doc-item' A denial-of-service (DoS) attack floods a service with traffic until legitimate requests cannot get through. A distributed denial-of-service (DDoS) attack sends that traffic from many machines at once. Attack traffic rarely looks different from real traffic one packet at a time. What gives it away is the pattern: a flow that grows far past its normal shape, packets that break a protocol, or connections opened and never finished. A defense therefore watches every flow continuously, recognizes those patterns, and discards the matching traffic before the service has to handle it. -On Azion, that defense is [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection). DDoS Protection is a Feature of the Azion Platform that mitigates denial-of-service attacks on every Workload. It is always on, and it needs no activation or configuration. For where it acts on a request, ahead of the Firewall that a Workload's deployment can set, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/#ddos-protection). The sections below cover detection, mitigation, the attack types and techniques involved, the Security Response Team, and where attack records appear. +On Azion, that defense is **DDoS Protection**, a Feature of the Azion Platform that mitigates denial-of-service attacks on every [Workload](/en/documentation/platform/workloads/). It is always on, and it needs no activation or configuration. For where it acts on a request, ahead of the Firewall that a Workload's deployment can set, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/#ddos-protection). The sections below cover detection, mitigation, the attack types and techniques involved, the Security Response Team, and where attack records appear. --- diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-firewall.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-firewall.mdx index 23e92db072..2073115933 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-firewall.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-firewall.mdx @@ -105,7 +105,7 @@ For how Bot Manager scores a request, how an instance reaches it, and where to s - **Responses**: _Deny (403 Forbidden)_ answers `403` with Azion's default error page, and _Drop (Close Without Response)_ sends no HTTP response. _Set Rate Limit_ releases requests at its configured rate and answers `429` only to simultaneous requests beyond its burst, and a WAF block answers `400`. - **Functions**: a firewall runs JavaScript, your own protection logic included, through a [function instance](/en/documentation/platform/firewall/functions-instances/) that a _Run Function_ behavior invokes. The function declares the `firewall` execution environment, and it can deny, drop, or answer the request, or add request and response headers. You write it in [Functions](/en/documentation/platform/functions/) or install it from Azion Marketplace. **Functions** is on in a firewall created through the API, the CLI, or the **Create Firewall** page. For the event and its methods, refer to [Functions for Firewall](/en/documentation/platform/firewall/functions/), and for working code, refer to [Functions on a firewall](/en/documentation/platform/functions/general-firewall-example/). - **Marketplace**: [Radware Bot Manager](/en/documentation/guides/application-development/integrations/radware-bot-manager/) and [DataDome Bot Protection](/en/documentation/guides/application-development/integrations/datadome-bot-protection/) install from Azion Marketplace as firewall functions, under their own subscriptions. -- **DDoS protection**: [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) mitigates denial-of-service (DoS) and distributed denial-of-service (DDoS) attacks in every account, with no configuration. The firewall's **DDoS Protection Unmetered** switch carries the tag **Automatically enabled in all accounts** and cannot be turned off. +- **DDoS protection**: [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) mitigates denial-of-service (DoS) and distributed denial-of-service (DDoS) attacks in every account, with no configuration. The firewall's **DDoS Protection Unmetered** switch carries the tag **Automatically enabled in all accounts** and cannot be turned off. - **Workloads**: a workload's deployment names one firewall, and one firewall can serve several workloads. A rule belongs to the firewall it was created on. **Clone**, a row action of the **Firewalls** list in Azion Console, starts a firewall as a copy of another, its function instances and rules included. For when to share one firewall, refer to [Firewall best practices](/en/documentation/platform/firewall/best-practices/#share-one-firewall-among-workloads-with-the-same-security-policy). - **Interfaces**: you create and manage firewalls on the **Firewalls** page of [Azion Console](https://console.azion.com/), and through the [Azion API](https://api.azion.com/) at `/v4/workspace/firewalls`. [Azion CLI](/en/documentation/devtools/cli/) manages them with commands such as `azion create firewall` and `azion create firewall-rule`. `azion.config.js` declares a firewall and its rules for the Azion CLI to create, as [Bind a rule set in azion.config.js](/en/documentation/guides/application-security/firewall-and-waf/config-file-binding/) shows. Installing a function from Azion Marketplace runs in Azion Console. - **Observability**: no response header names the firewall or the rule that decided. Every response carries an `x-azion-request-id` header, which Azion's default error page repeats. With the firewall's **Debug Rules** setting on, [Real-Time Events](/en/documentation/platform/real-time-events/) and [Data Stream](/en/documentation/platform/data-stream/) show the rules a request ran, in the `$traceback` field. The setting is off by default. diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/workloads/workloads.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/workloads/workloads.mdx index 65e01fb33e..788f0150ed 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/workloads/workloads.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/workloads/workloads.mdx @@ -1,7 +1,7 @@ --- title: Workloads description: Connect your domains to an Application with a Workload, which receives each request, serves HTTPS, and forwards the request to the Application. -meta_tags: 'workloads, workload domain, custom domain, tls, mtls, deployment, certificate manager, custom pages, ddos protection' +meta_tags: 'workloads, workload domain, custom domain, tls, mtls, deployment, ddos protection, entry point' namespace: documentation_products_secure_workloads permalink: /documentation/platform/workloads/ --- @@ -13,20 +13,21 @@ import VersionRollingOut from '~/includes/snippets/versionRollingOut/en/snippet. [Domains](/en/documentation/platform/workloads/domains/) -**Workloads** is a Platform Resource that receives the requests sent to your domains, as their entry point, on Azion's distributed infrastructure. The entry point of a website is the configuration that answers its hostnames, such as `www.example.com`. A Domain Name System (DNS) lookup sends the client to the entry point, which terminates the Transport Layer Security (TLS) connection: it decrypts the traffic of that connection. In that encrypted connection, the entry point proves with a certificate that it holds the hostname and, when the entry point requires mutual TLS (mTLS), the client also proves its identity. +**Workloads** is a Platform Resource that receives the requests sent to your domains, as their entry point, on Azion's distributed infrastructure. An entry point is the configuration that answers a site's hostnames, holds a certificate for each, and terminates their HTTPS connections. Use Workloads to put an [Application](/en/documentation/platform/applications/) on your own domain, serve that domain over HTTPS, or try a configuration on staging before production. -A Workload holds the hostnames it answers: a workload domain that Azion generates and the domains you add. It also holds the settings for connections to those hostnames: TLS, mTLS, the ports, and the HTTP versions it accepts. When you create a Workload, you pick the network it runs on: production or staging. +Each Workload has these features: -A deployment is the part of a Workload that sets the [Application](/en/documentation/platform/applications/) that answers its requests and, optionally, a [Firewall](/en/documentation/platform/firewall/) that inspects requests first and a custom page set that replaces error responses. After it receives a request, the Workload forwards the request to the Application that this Workload's deployment sets. That Application runs its rules on the request. Use Workloads to put an Application on your own domain, serve it over HTTPS with your certificate or one that Azion requests for you, require client certificates, or try a configuration on staging before production. +- [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) mitigates floods of attack traffic before they reach your Workloads and the Applications behind them. For a defense aimed at one specific attack, you add custom rules to a Firewall. +- [Mutual TLS (mTLS)](/en/documentation/platform/workloads/mtls/) lets a Workload refuse, in `enforce` mode, every client without a certificate from a certificate authority you trust. It suits an API that partner systems call, such as one that must meet Open Banking requirements. - + --- ## Request path -Creating a Workload serves no request: that Workload first needs a deployment that sets an Application. Until the deployment propagates, the workload domain answers `404` with Azion's HTML error page. +Creating a Workload serves no request: a request reaches an Application only once that Workload's deployment sets that Application. A deployment is the part of a Workload that sets the Application and, optionally, a [Firewall](/en/documentation/platform/firewall/) and a custom page set. Until the deployment propagates, the workload domain, the hostname Azion generates for the Workload, answers `404` with Azion's HTML error page. Solid arrows carry the request, and dotted arrows carry what goes back to the client. Each label starts with the number of the step it belongs to. @@ -35,6 +36,8 @@ Solid arrows carry the request, and dotted arrows carry what goes back to the cl flowchart TD Client(["Client"]) DNS[["DNS"]] + DDoS["DDoS Protection"] + Blocked["blocked traffic"] WL["Workload"] FW["Firewall"] App["Application"] @@ -43,7 +46,9 @@ flowchart TD CP["custom page set"] Client -->|"1. hostname lookup"| DNS DNS -.->|"1. Azion address"| Client - Client -->|"2, 3. request and TLS handshake"| WL + Client -->|"2. traffic"| DDoS + DDoS -->|"2. identified as an attack"| Blocked + DDoS -->|"2, 3. request and TLS handshake"| WL WL -.->|"3. handshake refused"| Client WL -->|"4. deployment sets a Firewall"| FW WL -->|"4. no Firewall"| App @@ -59,117 +64,13 @@ flowchart TD ``` 1. The client looks up the hostname, and DNS returns an address of Azion's distributed infrastructure. A custom domain, a domain of your own listed on the Workload, reaches that address through a CNAME record that points at the workload domain. -2. The Workload that lists the hostname receives the request. -3. On an HTTPS connection, the Workload completes the TLS handshake with its certificate, its minimum TLS version, and its cipher suite. With mTLS on, it also checks the client certificate. In `enforce` mode, a client with no certificate, or with one that an authority you do not trust signed, cannot complete the handshake. +2. In the data center the client reaches, DDoS Protection inspects the traffic before the Workload sees it, and Azion mitigates the traffic it identifies as an attack. The Workload that lists the hostname receives the rest. +3. On an HTTPS connection, the Workload completes the Transport Layer Security (TLS) handshake with its certificate, its minimum TLS version, and its cipher suite. The certificate is Azion's own or one you bind from [Certificate Manager](/en/documentation/platform/certificate-manager/). With mTLS on, the Workload also checks the client certificate in this handshake and can refuse it. 4. When the deployment sets a Firewall, the Firewall's rules evaluate the request before the Application and can block that request. With no Firewall, the request goes straight to the Application. 5. The Application that the deployment sets runs its rules on the request. When a rule sets a [Connector](/en/documentation/platform/connectors/), that Connector routes the request to your origin. The response returns through the Application to the client. -6. When the Connector answers with an error status code that the deployment's custom page set covers, the client receives the custom page in place of that response. +6. When the Connector answers with an error status code that the deployment's custom page set covers, the client receives the custom page from [Custom Pages](/en/documentation/platform/custom-pages/) in place of that response. -A Workload holds at most one deployment, so every hostname of the Workload reaches the same Application. When the deployment sets a Firewall or a custom page set, the same holds for it. For each step of the path and its tradeoff, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/). For a domain that answers `404` or a handshake that fails, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/). - ---- - -## Workload structure - -The API and [Azion CLI](/en/documentation/devtools/cli/) represent a Workload as a JSON object. `azion describe workload --workload-id --format json` shows a new Workload, created with a name and every default, as the API stores it: - -```json -{ - "active": true, - "created_at": "2026-01-01T12:00:00.000000Z", - "domains": [], - "id": , - "infrastructure": 1, - "last_editor": "", - "last_modified": "2026-01-01T12:00:00.000000Z", - "mtls": { - "config": { - "certificate": null, - "verification": null - }, - "enabled": false - }, - "name": "my-workload", - "product_version": "1.0", - "protocols": { - "http": { - "http_ports": [ - 80 - ], - "https_ports": [ - 443 - ], - "quic_ports": [ - 443 - ], - "versions": [ - "http1", - "http2", - "http3" - ] - } - }, - "tls": { - "certificate": null, - "ciphers": 7, - "minimum_version": "tls_1_3" - }, - "workload_domain": ".map.azionedge.net", - "workload_domain_allow_access": true -} -``` - -- `workload_domain` is the read-only hostname Azion generates at creation. `domains` holds the hostnames you add: your own domains and an optional `azion.app` hostname. `workload_domain_allow_access` decides whether clients still reach the workload domain. -- `infrastructure` is `1` for production and `2` for staging, and it sets the suffix of the workload domain. -- `protocols.http` lists the HTTP versions and the ports the Workload accepts. `tls` sets the certificate, along with the cipher suite and the minimum TLS version. With `tls.certificate` set to `null`, the Workload presents the Azion SAN certificate: Azion's own certificate, with its hostnames listed as Subject Alternative Names (SAN). -- `mtls` is off in a new Workload. Turned on, it sets a Trusted CA certificate and a verification mode. A Trusted CA certificate is the certificate of a certificate authority (CA) that you trust to sign client certificates. The Workload checks each client certificate against it. - -This object holds no Application. The Workload's deployment is not part of this object: it sets the Application and can also set a Firewall and a custom page set. Because of that split, the hostnames and certificates change without any change to your application's code. - ---- - -## Resources - -Certificate Manager acts on a Workload once you bind a certificate to that Workload. Custom Pages acts on a Workload once that Workload's deployment sets a custom page set. DDoS Protection acts on every Workload from the moment it exists. - -### Certificate Manager - -Certificate Manager is a Platform Resource that stores the certificates a Workload uses for TLS. It stores server certificates, uploaded with their private key, and Trusted CA certificates, which verify client certificates for mTLS. It also requests Let's Encrypt certificates for the Workload's domains and renews them for you, stores certificate revocation lists (CRLs), and creates certificate signing requests (CSRs). Turn to it when a domain of your own must serve HTTPS, because the Azion SAN certificate covers only the workload domain and the `azion.app` hostname. - -For the certificate types, their fields, and their statuses, refer to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). For how Azion requests and renews a Let's Encrypt certificate, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). To bind your first certificate to a Workload, refer to the [Certificate Manager quickstart](/en/documentation/platform/workloads/certificate-manager/quickstart/). - -### Custom Pages - -Custom Pages is a Platform Resource that replaces the error response returned by a Connector with a page of your own, one page per error status code. For example, when a Connector returns `404` for a missing path, the client receives your own page at the URL it requested, with no redirect. A custom page set is a named list of those pages. Azion fetches the content of each page from a Connector, and each page sets a cache time for that content. A page can also answer with a status code you set. Use Custom Pages when visitors must see your own page instead of the origin's error page. - -For the fields of a set and its pages, and the status codes a page can replace, refer to [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/). To replace your first `404`, refer to the [Custom Pages quickstart](/en/documentation/platform/workloads/custom-pages/quickstart/). For an account that still runs API v3, refer to [Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/). - -### DDoS Protection - -DDoS Protection is a Feature of the Azion Platform that mitigates denial-of-service attacks on every Workload. It is always on, and it needs no activation or configuration. - -A denial-of-service (DoS) attack floods a service with traffic until legitimate requests cannot get through. A distributed denial-of-service (DDoS) attack sends that traffic from many machines at once. DDoS Protection mitigates these attacks at the network, transport, presentation, and application layers. For detection and mitigation targeted at a specific attack, you write custom rules on the Firewall that the deployment sets. - -For the attack types and the mitigation techniques, refer to [Attack mitigation](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/). For how DDoS Protection mitigation is billed, refer to [Pricing](/en/documentation/fundamentals/pricing/#ddos-protection). - ---- - -## Scope and limits - -- **Domains**: a Workload answers on its workload domain, `.map.azionedge.net` on production and `.preview.azionedge.net` on staging, as soon as its deployment propagates, before you own any domain. You add domains of your own, each a full hostname with no wildcard, and point each one at the workload domain with a CNAME record. A production Workload can also answer on one `azion.app` hostname, which [Azion Console](https://console.azion.com/) calls **Azion Custom Domain**, at no additional cost. With `workload_domain_allow_access` set to `false`, the workload domain answers `404`, and the Workload answers only on the hostnames in `domains`. That value fits a Workload whose own domains already serve traffic, and the API accepts it only while `domains` holds at least one hostname. For every rule a hostname follows, refer to [Workload settings](/en/documentation/platform/workloads/settings/#domains), and for the DNS records, refer to [Point a domain to a workload](/en/documentation/guides/platform/migration/point-domain-to-azion/). -- **DNS**: a Workload holds no DNS records. A domain's zone stays at your DNS provider, or in [Edge DNS](/en/documentation/platform/edge-dns/), and the Workload answers the hostnames it lists wherever their zone is hosted. -- **Infrastructure**: a Workload runs on one of two networks: the production network, for global availability, or the staging network, for testing with limited propagation. You pick it when you create the Workload, in the `infrastructure` field of the API: `1` for production or `2` for staging. The choice cannot change after creation, and a staging Workload takes no custom domain. For example, a configuration tested on a staging Workload reaches production as a second Workload, created on the production infrastructure. For the same choice in Azion Console, refer to [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure). For how to try a change on staging first, refer to [Workloads best practices](/en/documentation/platform/workloads/best-practices/). -- **Protocols**: a Workload accepts HTTP/1.1, HTTP/2, and HTTP/3 over QUIC, which needs both earlier versions listed and HTTPS on. HTTP runs on up to four ports, from `80`, `8008`, `8080`, and `8880`, with `80` by default. HTTPS runs on up to 12 listed ports, with `443` by default. For the ports, refer to [Workload settings](/en/documentation/platform/workloads/settings/#protocols-and-ports). -- **TLS**: the minimum TLS version ranges from TLS 1.0 to TLS 1.3, the default, and TLS 1.0 and 1.1 are deprecated. Eight cipher suites are available, with suite `7` by default. The Azion SAN certificate covers the workload domain and the `azion.app` hostname, and a domain of your own needs a server certificate from [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager). Azion blocks TLS renegotiation by default. These settings secure the connection from the client to Azion, while the connection to your origin is set on the Connector. For the fields and the ciphers of each suite, refer to [Workload settings](/en/documentation/platform/workloads/settings/#tls). -- **mTLS**: with mTLS on, a Workload checks client certificates against a Trusted CA certificate, in `enforce` or `permissive` mode, on HTTPS connections only. It also lists up to 100 CRLs. For both modes and every requirement, refer to [mTLS](/en/documentation/platform/workloads/mtls/). -- **Deployment**: a Workload holds at most one deployment, and a Workload created through the API or Azion CLI starts with none. The deployment sets the Application that answers and can also set a Firewall and a custom page set. The published API v4 reference has no endpoint for the deployment: Azion Console, Azion CLI, and [Terraform](/en/documentation/devtools/terraform/workloads/) write it. For its fields, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). -- **Propagation**: a saved change to a Workload or its deployment takes several minutes to reach all of Azion's distributed infrastructure, with no guaranteed duration. Meanwhile, requests can receive the old or the new configuration. For example, right after you turn on mTLS in `enforce` mode, some data centers still answer a client with no certificate. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). -- **Interfaces**: you create and manage Workloads on the **Workloads** page of [Azion Console](https://console.azion.com/), through the [Azion API](https://api.azion.com/) at `/v4/workspace/workloads`, with [Azion CLI](/en/documentation/devtools/cli/) commands such as `azion create workload`, and with the `azion_workload` and `azion_workload_deployment` resources of [Terraform](/en/documentation/devtools/terraform/workloads/). -- **API v4**: on API v3, one Domains object carried the role of a Workload, and an Application's Main Settings held the protocol and TLS settings. On API v4, the Workload and its deployment replace the Domains object, and the Workload holds the protocol and TLS settings. For the mapping between the two models, refer to [API v4 Migration](/en/documentation/fundamentals/api-v4-migration/), and for an account that still runs API v3, refer to [Domains](/en/documentation/platform/workloads/domains/). -- **Observability**: Azion's error page carries an `x-azion-request-id` header that identifies the request. [Data Stream](/en/documentation/platform/data-stream/) collects the events of the Workloads you associate with a stream, as [Associate workloads with a stream](/en/documentation/guides/platform/observability/data-stream-associate-workloads/) shows. -- **Limits**: a Workload `name` takes up to 100 characters, and a Workload lists up to 50 domains by default. For every bound and the answer past it, refer to [Workloads limits](/en/documentation/platform/workloads/limits/). -- **Billing**: each plan includes an amount of usage before a rate applies, and [Azion pricing](https://www.azion.com/en/pricing/) lists it per plan. For the rates, refer to [Pricing](/en/documentation/fundamentals/pricing/#workloads). -- **Terms**: the [Workloads glossary](/en/documentation/platform/workloads/glossary/) defines the words the Workloads pages give a specific meaning, such as workload domain, deployment, Azion custom domain, and Trusted CA certificate. +Every hostname of a Workload reaches the Application, Firewall, and custom page set that its deployment sets. For each step of the path and its tradeoff, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/). --- @@ -180,4 +81,8 @@ For the attack types and the mitigation techniques, refer to [Attack mitigation] + + + + diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/services/support/http-error-status-codes.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/services/support/http-error-status-codes.mdx index afbce41a5e..46e75ce3c2 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/services/support/http-error-status-codes.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/services/support/http-error-status-codes.mdx @@ -257,6 +257,6 @@ To solve it: Investigate why your application returned an error to your users. Set the protocol a connector uses to reach your origin. Find the Redirect HTTP to HTTPS behavior and the other behaviors of a rule. - Replace the error pages of a workload with pages of your own. + Replace the error pages of a workload with pages of your own. diff --git a/apps/docs/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx b/apps/docs/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx index 846b8f1323..e81baf6b5e 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx +++ b/apps/docs/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx @@ -927,7 +927,7 @@ Sync command fix aligned with API page size maximum (100 items). Fixed an issue that blocked Let's Encrypt certificate issuance during domain creation. -Read more about [Azion CLI](/en/documentation/devtools/cli/) and [Let's Encrypt certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#lets-encrypt-certificate). +Read more about [Azion CLI](/en/documentation/devtools/cli/) and [Let's Encrypt certificates](/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate). @@ -1209,11 +1209,11 @@ Visit the [handlers](/en/documentation/devtools/runtime/api-reference/handlers/) ### Let’s Encrypt HTTP-01 Challenge through API -Azion now offers API-based issuance and renewal of [Let’s Encrypt certificates](https://www.azion.com/en/documentation/platform/workloads/certificate-manager/certificates/#lets-encrypt-certificate) using the HTTP-01 challenge, providing a streamlined process with no need for DNS TXT records. This offers a straightforward and convenient integration solution, particularly beneficial for customers managing numerous domains and hostnames. +Azion now offers API-based issuance and renewal of [Let’s Encrypt certificates](https://www.azion.com/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate) using the HTTP-01 challenge, providing a streamlined process with no need for DNS TXT records. This offers a straightforward and convenient integration solution, particularly beneficial for customers managing numerous domains and hostnames. Certificates auto-renew before expiring, removing maintenance windows, and maintaining existing quotas, billing, and permissions. Perfect for ecommerce platforms and hosting providers, this enhancement enables faster onboarding and secures customer sites in minutes without DNS changes. -For more information on these updates, [visit the Digital Certificates documentation](https://www.azion.com/en/documentation/platform/workloads/certificate-manager/certificates/#lets-encrypt-certificate). +For more information on these updates, [visit the Digital Certificates documentation](https://www.azion.com/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate). @@ -1675,7 +1675,7 @@ No changes have been made to the functionality of the products. **Digital Certificates** now supports the management of **Certificate Revocation Lists (CRL)** through Azion API. CRL is a list of digital certificates revoked before their expiration date. -Use the [Azion API](https://api.azion.com/#b2df23ee-7a28-4900-9ad5-ffd135b4c6cf) to manage CRLs and see the [Digital Certificates reference](/en/documentation/platform/workloads/certificate-manager/certificates/#certificate-revocation-lists) for more information. +Use the [Azion API](https://api.azion.com/#b2df23ee-7a28-4900-9ad5-ffd135b4c6cf) to manage CRLs and see the [Digital Certificates reference](/en/documentation/platform/certificate-manager/certificates/#certificate-revocation-lists) for more information. @@ -1966,7 +1966,7 @@ Go to the Websocket [documentation](/en/documentation/platform/applications/webs **DDoS Protection** is now automatically enabled in all accounts. It offers protection against DoS and DDoS attacks with unmetered bandwidth for all Azion customers. -Get to know more about [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection). +Get to know more about [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/). @@ -2026,7 +2026,7 @@ For more details, check the documentation on [How to integrate Azion with Grafan - [Rules Engine](/en/documentation/platform/applications/rules-engine/) now provides a **description** field for you to describe your rule. - You can customize the description via [Real-Time Manager](https://console.azion.com) or [Azion API](https://api.azion.com/). -- For Azion [Domains](/en/documentation/platform/workloads/domains/), you can request the issuance of a [Let's Encrypt certificate](/en/documentation/platform/workloads/certificate-manager/certificates/#lets-encrypt-certificate) through Azion. +- For Azion [Domains](/en/documentation/platform/workloads/domains/), you can request the issuance of a [Let's Encrypt certificate](/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate) through Azion. - This TLS certificate will be automatically managed and renewed by Azion before the expiration date of 90 days. - See the guide on [How to generate a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/) for more information. - Available in [Real-Time Manager](https://console.azion.com) or [Azion API](https://api.azion.com/). diff --git a/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/edit-main-settings.mdx b/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/edit-main-settings.mdx index fa260587bb..c4d8250817 100644 --- a/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/edit-main-settings.mdx +++ b/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/edit-main-settings.mdx @@ -72,7 +72,7 @@ Each Product adds criteria or behaviors to the firewall's [Rules Engine](/en/doc | [Web Application Firewall (WAF)](/en/documentation/platform/firewall/waf/) | The _Set WAF_ behavior, which applies a WAF rule set to the request. It also adds the seven _Header_ criteria, such as _Header User Agent_, and the _Request Args_ and _Request Method_ criteria. | Off | | [Network Shield](/en/documentation/platform/firewall/network-shield/) | The _Network_ criterion, which matches a request against a [network list](/en/documentation/platform/firewall/network-shield/network-lists/) of IP addresses or CIDR ranges, ASNs, or countries. | On | | [Functions](/en/documentation/platform/firewall/functions/) | The _Run Function_ behavior, and the **Functions Instances** tab, where you add a function instance to the firewall. | On | -| [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) | Mitigation of distributed denial-of-service (DDoS) attacks. Its switch, **DDoS Protection Unmetered**, cannot be turned off. | Always on | +| [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) | Mitigation of distributed denial-of-service (DDoS) attacks. Its switch, **DDoS Protection Unmetered**, cannot be turned off. | Always on | A WAF rule set scores each request for attacks such as SQL injection, remote file inclusion (RFI), and cross-site scripting (XSS). For every threat family it scores, refer to [Rule sets](/en/documentation/platform/firewall/waf/rules-set/#threat-families). diff --git a/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/protect-your-domain.mdx b/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/protect-your-domain.mdx index 03bc2001f3..aebc1a8015 100644 --- a/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/protect-your-domain.mdx +++ b/apps/docs/src/content/docs/en/pages/secure-journey/edit-edge-firewall/protect-your-domain.mdx @@ -57,7 +57,7 @@ An account that runs on API v3 with Domains binds a firewall in the settings of ## Bind the firewall to the workload -A deployment carries exactly three settings: its application, its firewall, and its [custom page set](/en/documentation/platform/workloads/custom-pages/settings/). The application and the custom page set stay the ones the workload uses today, so the firewall is the only setting that changes. Until a deployment names the firewall, the firewall's rules see no request to the workload. +A deployment carries exactly three settings: its application, its firewall, and its [custom page set](/en/documentation/platform/custom-pages/settings/). The application and the custom page set stay the ones the workload uses today, so the firewall is the only setting that changes. Until a deployment names the firewall, the firewall's rules see no request to the workload. A workload holds one deployment, so you change the deployment it has. A second deployment is refused with `The maximum number of deployments allowed per workload is 1.` For every field of the deployment, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). diff --git a/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/digital-certificates.mdx b/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/digital-certificates.mdx index 15a4864a36..af4e47ed55 100644 --- a/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/digital-certificates.mdx +++ b/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/digital-certificates.mdx @@ -14,7 +14,7 @@ import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' import VersionDualSteps from '~/includes/snippets/versionDualSteps/en/snippet.mdx' -You can add a certificate that a certificate authority (CA) issued for your domain to [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) and bind it to a [workload](/en/documentation/platform/workloads/), from Azion Console, the [Azion CLI](/en/documentation/devtools/cli/), or the API. For a certificate that Azion requests from Let's Encrypt and renews, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). For the Trusted CA certificate that checks client certificates, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/). +You can add a certificate that a certificate authority (CA) issued for your domain to [Certificate Manager](/en/documentation/platform/certificate-manager/) and bind it to a [workload](/en/documentation/platform/workloads/), from Azion Console, the [Azion CLI](/en/documentation/devtools/cli/), or the API. For a certificate that Azion requests from Let's Encrypt and renews, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). For the Trusted CA certificate that checks client certificates, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/). A server certificate covers the hostnames a workload serves over HTTPS. You get one in either of two ways: you upload a certificate with its private key, or Certificate Manager creates a certificate signing request (CSR) and keeps the private key while your CA signs the certificate. Either way, a workload uses the certificate only once its `tls.certificate` field names it, and the certificate reads `inactive` until then. @@ -277,7 +277,7 @@ The API answers `201` with the new certificate entry and its `id`. The `csr` fie -A request that names a hostname in a domain your account has no permission for is refused with `This account cannot use certain common or alternative names because it does not have permission for their domain names.` For the meaning of each CSR field, refer to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#certificate-signing-requests). +A request that names a hostname in a domain your account has no permission for is refused with `This account cannot use certain common or alternative names because it does not have permission for their domain names.` For the meaning of each CSR field, refer to [Certificates](/en/documentation/platform/certificate-manager/certificates/#certificate-signing-requests). Submit the request to the CA of your choice, such as DigiCert, GlobalSign, or IdenTrust. The CA validates the details in the request and, once it approves them, issues the signed certificate. @@ -464,7 +464,7 @@ The API accepts the update, and the workload then names the certificate in `tls. A Trusted CA certificate in `tls.certificate` is refused with `Invalid certificate type, MUST be an Edge Certificate.` To go back to Azion's own certificate, select _Azion (SAN)_ in **Digital Certificate**, or send `null` in `tls.certificate`. -Binding a certificate is a workload change, which takes several minutes to reach all of Azion's distributed infrastructure. Requests can receive the old or the new configuration meanwhile. For certificate errors and their fixes, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#certificate-manager). +Binding a certificate is a workload change, which takes several minutes to reach all of Azion's distributed infrastructure. Requests can receive the old or the new configuration meanwhile. For certificate errors and their fixes, refer to [Troubleshoot Certificate Manager](/en/documentation/platform/certificate-manager/troubleshooting/). --- @@ -557,7 +557,7 @@ To go back to Azion's own certificate, select _Azion (SAN)_ in **Digital Certifi A certificate you upload does not renew itself, and once its `validity` date passes, it no longer protects traffic. To replace it, upload the new certificate as Upload a server certificate describes, then bind it as Bind the certificate to the workload describes. The old entry reads `inactive` once no workload names it. Delete it after the new certificate is `active` and the change has propagated. -For why to switch while the old certificate is still valid, refer to [Workloads best practices](/en/documentation/platform/workloads/best-practices/#certificate-manager). +For why to switch while the old certificate is still valid, refer to [Certificate Manager best practices](/en/documentation/platform/certificate-manager/best-practices/). --- @@ -566,6 +566,6 @@ For why to switch while the old certificate is still valid, refer to [Workloads - + diff --git a/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/mtls.mdx b/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/mtls.mdx index 4c7f251072..122cf7077a 100644 --- a/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/mtls.mdx +++ b/apps/docs/src/content/docs/en/pages/secure-journey/transport-layer-security/mtls.mdx @@ -73,7 +73,7 @@ An account that runs on API v3 has Domains in place of workloads, and sets mTLS ## Upload the Trusted CA certificate -[Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) stores the Trusted CA certificate with the type `trusted_ca_certificate` and no private key. The file must be in PEM format, with its `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----` lines, and Certificate Manager refuses any other format. When your chain has intermediate certificates, include them in the same file. +[Certificate Manager](/en/documentation/platform/certificate-manager/) stores the Trusted CA certificate with the type `trusted_ca_certificate` and no private key. The file must be in PEM format, with its `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----` lines, and Certificate Manager refuses any other format. When your chain has intermediate certificates, include them in the same file. diff --git a/apps/docs/src/content/docs/en/pages/secure-journey/zone-advanced-configurations/add-lets-encrypt-txt-record.mdx b/apps/docs/src/content/docs/en/pages/secure-journey/zone-advanced-configurations/add-lets-encrypt-txt-record.mdx index c36b10bb41..5ef70a1458 100644 --- a/apps/docs/src/content/docs/en/pages/secure-journey/zone-advanced-configurations/add-lets-encrypt-txt-record.mdx +++ b/apps/docs/src/content/docs/en/pages/secure-journey/zone-advanced-configurations/add-lets-encrypt-txt-record.mdx @@ -14,9 +14,9 @@ import DocStep from '@aziontech/webkit/doc-step' You can add the TXT record of a Let's Encrypt DNS-01 challenge to a zone in [Edge DNS](/en/documentation/platform/edge-dns/) from Azion Console. Add it when an ACME client outside Azion, such as Certbot, requests the certificate for a hostname of that zone. -A certificate that Azion requests for a workload needs no TXT record from you. When the zone is in Edge DNS, Azion writes the challenge record itself. At another DNS provider, you create a CNAME record instead. To create that record, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#domain-validation). To have Azion request the certificate, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). +A certificate that Azion requests for a workload needs no TXT record from you. When the zone is in Edge DNS, Azion writes the challenge record itself. At another DNS provider, you create a CNAME record instead. To create that record, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/#domain-validation). To have Azion request the certificate, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). -Devices that depend on the expired Let's Encrypt chain cross-signed by IdenTrust reject certificates that use it. For more information, refer to [Certificate chain](/en/documentation/platform/workloads/certificate-manager/certificates/#certificate-chain). +Devices that depend on the expired Let's Encrypt chain cross-signed by IdenTrust reject certificates that use it. For more information, refer to [Certificate chain](/en/documentation/platform/certificate-manager/certificates/#certificate-chain). --- @@ -84,7 +84,7 @@ A name that nobody queried before it existed answers within seconds. A name quer - + diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/best-practices.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/best-practices.mdx new file mode 100644 index 0000000000..3b63b725d9 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/best-practices.mdx @@ -0,0 +1,97 @@ +--- +title: Certificate Manager best practices +description: Replace certificates before they expire, keep renewal records in place, and limit how far a private key or a DNS credential reaches. +meta_tags: 'certificate manager, best practices, certificate replacement, lets encrypt, renewal, acme challenge, dns-01, validation levels, wildcard certificate' +namespace: documentation_products_certificate_manager_best_practices +permalink: /documentation/platform/certificate-manager/best-practices/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' +import Code from '~/components/webkit/CodeBlock.vue' + +A certificate stops protecting traffic on the day it expires, and an automatic renewal fails once the record that proves control of the domain is gone. A private key or a DNS credential that reaches too far turns one leak into exposure of every name it covers. + +These practices apply to the certificates that [Certificate Manager](/en/documentation/platform/certificate-manager/), a Platform Resource, stores for a [Workload](/en/documentation/platform/workloads/). In order, they are: replace a server certificate before it expires, keep the challenge record of a domain hosted outside Edge DNS, choose a domain-validated certificate unless you need more, limit DNS-01 credentials to the challenge records, and keep wildcard certificates off critical production systems. + +Binding a certificate changes the Workload, and that change takes several minutes to reach all of Azion's distributed infrastructure, with no guaranteed duration. Until then, requests can meet the old or the new configuration, so a check on this page holds only once repeated requests agree. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). + +--- + +## Replace a server certificate before it expires + +An uploaded server certificate never renews itself, and once its `validity` date passes, it no longer protects traffic. Switching while the old certificate is still valid leaves time to confirm the new one and to switch back if it fails. The cost is the old entry, which stays in Certificate Manager until you delete it. + +Azion renews the Let's Encrypt certificates it manages, as [Renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/#renewal) describes, so this practice covers the certificates you upload. After you upload the new certificate, point `tls.certificate` at its ID with this body for `azion update workload --file`: + +, + "tls": { "certificate": , "ciphers": 7, "minimum_version": "tls_1_3" } +}`} /> + +Replace `7` and `tls_1_3` with the `ciphers` and `minimum_version` values the Workload already holds, so that the certificate is the only value that changes. The CLI answers `Updated Workload with ID `. + +To check, run `azion list digital-certificate --details`: the new certificate reads `active`, and the old one reads `inactive` once no Workload uses it. Delete the old entry after the new one reads `active` and the change has propagated. For the upload itself, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/). + +--- + +## Keep the challenge record of a domain hosted outside Edge DNS + +Azion renews a managed Let's Encrypt certificate before it expires by running its challenge again. For a DNS-01 certificate whose zone is in [Edge DNS](/en/documentation/platform/edge-dns/), Azion writes the `_acme-challenge` record itself. At another DNS provider, the challenge depends on a record you added, and deleting that record makes the next renewal fail, so the certificate expires. + +The record is a canonical name (CNAME) record named `_acme-challenge.` that points to `.letsencrypt.azion.com`. Keep it at your provider for as long as a Workload uses the certificate. + +Renewal starts 30 days before the 90-day validity ends. To check, confirm before then that the CNAME still exists and that the certificate's status in Certificate Manager is not `failed`. For the record to create, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). + +--- + +## Choose a domain-validated certificate unless you need more + +The certificate authority (CA) that issues a certificate you upload validates the request at one of three levels: + +- Domain Validation (DV) confirms your right to use the domain. +- Organization Validation (OV) adds checks on the requesting organization. +- Extended Validation (EV) asks for documents that prove the organization's physical, legal, and operational existence. + +Use DV in most cases. OV and EV take more work to obtain, and their extra checks vouch for your organization rather than for the domain. Order OV or EV only when a requirement you can name asks for those checks. For the three levels, refer to [Validation levels](/en/documentation/platform/certificate-manager/certificates/#validation-levels). + +--- + +## Limit DNS-01 credentials to the challenge records + +This practice applies when your own Automatic Certificate Management Environment (ACME) client, such as Certbot, obtains a certificate for a zone outside Edge DNS. A Let's Encrypt certificate that Azion manages needs none of it, because the single CNAME of [Keep the challenge record of a domain hosted outside Edge DNS](/en/documentation/platform/certificate-manager/best-practices/#keep-the-challenge-record-of-a-domain-hosted-outside-edge-dns) is enough. + +Your ACME client writes the `_acme-challenge` record at the DNS provider, so it holds the provider's API credentials. Credentials that reach every record give whoever obtains them control of the domain and of all its records. + +Restrict those credentials to `_acme-challenge` records, so that a leak exposes only the challenge. The cost is a separate credential that you create and keep for that client alone. To check, confirm at your provider that the credential's permissions name only `_acme-challenge` records. + +--- + +## Keep wildcard certificates off critical production systems + +A wildcard certificate, such as one for `*.example.com`, covers subdomains such as `blog.example.com` with a single private key. When that key leaks, or the certificate is revoked, every subdomain it covers is affected at once. A wildcard certificate fits when: + +- Centralized management is a priority. +- The same team manages the subdomains. +- A well-defined reverse proxy architecture exists. +- Your security policies allow controlled key sharing. + +Under stricter requirements, give each critical production system a certificate of its own, keep separate certificates for development environments, and leave the wildcard to lower-criticality services. The cost is one replacement per certificate instead of one replacement for all. For how Azion issues a wildcard name, refer to [Wildcard certificates](/en/documentation/platform/certificate-manager/issuance-and-renewal/#wildcard-certificates). + +Keep a wildcard's private key in Certificate Manager, bound to Workloads, instead of copying it across servers. Once saved, the key cannot be read back from Azion Console or the API. + +To check, list the Workloads that use each wildcard certificate with `GET /v4/workspace/workloads?digital_certificate_id=`, and give any critical production Workload a certificate of its own. + +--- + +## Related resources + + + + The certificate types, statuses, and validation levels behind these practices. + How Let's Encrypt validates and issues a certificate that Azion requests, how Azion renews it, and when Azion stops renewing it. + How a Workload binds each certificate, and why the certificate and the Workload are checked apart. + Symptoms of a certificate that stays pending, fails to issue, or is refused, for when a practice was skipped. + + diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/digital-certificates.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/certificates.mdx similarity index 88% rename from apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/digital-certificates.mdx rename to apps/docs/src/content/docs/en/pages/secure/certificate-manager/certificates.mdx index c43ce4e52f..d249065cd6 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/digital-certificates.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/certificates.mdx @@ -3,16 +3,16 @@ title: Certificates description: Look up the certificate types Certificate Manager stores, their fields, key algorithms, and statuses, and the CSR and CRL objects. meta_tags: 'certificate manager, digital certificate, edge certificate, trusted ca certificate, csr, crl, lets encrypt, tls, workloads' namespace: documentation_digital_certificates -permalink: /documentation/platform/workloads/certificate-manager/certificates/ +permalink: /documentation/platform/certificate-manager/certificates/ --- import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -[Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) is a Platform Resource that stores the certificates a [Workload](/en/documentation/platform/workloads/) uses for Transport Layer Security (TLS). Each of them is an X.509 certificate. A server certificate is a TLS certificate for your own domains: you upload it, or Azion requests it from Let's Encrypt. A Trusted CA certificate is the certificate of a certificate authority (CA) that you trust to sign client certificates for mutual TLS (mTLS). Certificate Manager also creates certificate signing requests (CSRs) and stores certificate revocation lists (CRLs). +[Certificate Manager](/en/documentation/platform/certificate-manager/) is a Platform Resource that stores the certificates a [Workload](/en/documentation/platform/workloads/) uses for Transport Layer Security (TLS). Each of them is an X.509 certificate of one of two types: a server certificate for your own domains, or a Trusted CA certificate for mutual TLS (mTLS). Certificate Manager also creates certificate signing requests (CSRs) and stores certificate revocation lists (CRLs). -This page lists every field of these objects by its API name. For how Azion requests and renews a Let's Encrypt certificate, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +This page lists every field of these objects by its API name. For how Azion requests and renews a Let's Encrypt certificate, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). --- @@ -24,7 +24,7 @@ Four interfaces manage certificates, CSRs, and CRLs. The tables on this page nam | --- | --- | --- | | [Azion Console](https://console.azion.com/) | The **Create Digital Certificate** page, with four presets | The **Edit Digital Certificate** and **Edit CRL** pages | | Azion API v4 | `POST /v4/workspace/tls/certificates` uploads a certificate; `POST /v4/workspace/tls/certificates/request` requests a Let's Encrypt certificate; `POST /v4/workspace/tls/csr` creates a CSR; `POST /v4/workspace/tls/crls` stores a CRL | `GET`, `PUT`, `PATCH`, and `DELETE` on `/v4/workspace/tls/certificates/{certificate_id}` and on `/v4/workspace/tls/crls/{crl_id}`. `GET /v4/workspace/tls/certificates` and `GET /v4/workspace/tls/crls` list them | -| Azion CLI | [`azion create digital-certificate`](/en/documentation/devtools/cli/resources/), `azion create csr`, and `azion create crl` | `azion list digital-certificate`, `azion describe digital-certificate`, `azion list crl`, and `azion describe crl` | +| Azion CLI | [`azion create digital-certificate`](/en/documentation/devtools/cli/resources/digital-certificate/), `azion create csr`, and `azion create crl` | `azion list digital-certificate`, `azion describe digital-certificate`, `azion list crl`, and `azion describe crl` | | [Terraform](/en/documentation/devtools/terraform/certificates/) | The certificate resources that page lists | The same resources | In Azion Console, the **Create Digital Certificate** page opens from the **Certificate Manager** menu, at `/digital-certificates/create`. Its presets are **Server Certificate**, **Trusted CA Certificate**, _New Let's Encrypt Certificate (HTTP-01)_, and _New Let's Encrypt Certificate (DNS-01)_. The **Edit Digital Certificate** page edits a certificate, and the **Edit CRL** page edits a CRL. @@ -45,19 +45,23 @@ A Workload can use three kinds of certificate. Certificate Manager stores two of ### Azion SAN certificate -The Azion SAN certificate is Azion's own TLS certificate. A Workload presents it for its workload domain and its `azion.app` hostname, and for every hostname when `tls.certificate` is `null`. In Azion Console, _Azion (SAN)_ in the Workload form sets that value. The certificate lists the hostnames Azion assigns as Subject Alternative Names (SANs): the workload domain in the `azionedge.net` zone, and the `azion.app` hostname that Azion Console calls **Azion Custom Domain**. It costs nothing extra and needs no upload. +The Azion SAN certificate is Azion's own TLS certificate. A Workload presents it for its workload domain and its `azion.app` hostname, and for every hostname when `tls.certificate` is `null`. In Azion Console, _Azion (SAN)_ in the Workload form sets that value. + +The certificate lists the hostnames Azion assigns as Subject Alternative Names (SANs): the workload domain in the `azionedge.net` zone, and the `azion.app` hostname that Azion Console calls **Azion Custom Domain**. It costs nothing extra and needs no upload. For example, a test Workload reached only on `.map.azionedge.net` serves HTTPS with the Azion SAN certificate and nothing to manage. The `azionedge.net` zone is shared with other Azion customers, and the Azion SAN certificate covers no domain of yours. So a hostname in a domain of your own needs a server certificate. ### Server certificate -A server certificate is a TLS certificate for your own domains, which a Workload presents to prove it holds a hostname. Certificate Manager stores it with `type` set to `edge_certificate`. You upload one that a CA issued to you, with its private key, at no additional cost. Or you ask Azion to request one from Let's Encrypt, described in Let's Encrypt certificate. +A server certificate is a TLS certificate for your own domains, which a Workload presents to prove it holds a hostname. Certificate Manager stores it with `type` set to `edge_certificate`. You upload one that a certificate authority (CA) issued to you, with its private key, at no additional cost. Or you ask Azion to request one from Let's Encrypt, as [Let's Encrypt certificate](/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate) describes. + +A certificate for a single domain and a certificate for several hostnames listed as SANs are both accepted. The API does not compare those names with the Workload's domains: it accepts a certificate whose names do not match them. The Workload then presents that certificate for its custom domains anyway, and the client's check of the names fails. -A certificate for a single domain and a certificate for several hostnames listed as SANs are both accepted. The API does not compare those names with the Workload's domains: it accepts a certificate whose names do not match them. The Workload then presents that certificate for its custom domains anyway, and the client's check of the names fails. A domain served with a bound server certificate relies on the Server Name Indication (SNI) extension of TLS. A client without SNI receives the Azion SAN certificate. +A domain served with a bound server certificate relies on the Server Name Indication (SNI) extension of TLS. A client without SNI receives the Azion SAN certificate. Once saved, the private key cannot be read back from Azion Console or the API. The edit page reads "Paste the PEM-encoded TLS X.509 certificate and private key in the respective fields to update the certificate. The current certificate and private key are hidden to protect sensitive information." -To replace a server certificate without downtime, refer to [Workloads best practices](/en/documentation/platform/workloads/best-practices/#certificate-manager). +To replace a server certificate without downtime, refer to [Certificate Manager best practices](/en/documentation/platform/certificate-manager/best-practices/). ### Validation levels @@ -75,7 +79,7 @@ A Let's Encrypt certificate is a server certificate that Azion requests from the You request one from the _New Let's Encrypt Certificate (DNS-01)_ or _New Let's Encrypt Certificate (HTTP-01)_ preset, or with `POST /v4/workspace/tls/certificates/request`. In Azion Console, the presets appear in Certificate Manager and in the Workload's **Digital Certificate** field. From the Workload form, the Console names the certificate `Lets Encrypt - - `. It sets `key_algorithm` to `rsa_2048` and takes `common_name` and `alternative_names` from the Workload's **Domains**. -In Azion Console, the edit page of a managed certificate reads "This is a Let's Encrypt™ certificate automatically created and managed by Azion." A wildcard certificate, such as one for `*.example.com`, is issued through the DNS-01 challenge. Every name on the request must belong to a domain the account has permission for, or the request is refused, as Errors lists. For the challenges, the renewal schedule, and wildcard names, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +In Azion Console, the edit page of a managed certificate reads "This is a Let's Encrypt™ certificate automatically created and managed by Azion." A wildcard certificate, such as one for `*.example.com`, is issued through the DNS-01 challenge. Every name on the request must belong to a domain the account has permission for, or the request is refused, as [Errors](/en/documentation/platform/certificate-manager/certificates/#errors) lists. For the challenges, the renewal schedule, and wildcard names, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). ### Trusted CA certificate @@ -107,7 +111,7 @@ Azion fills the fields below, and no request can set them: | API field | Type | What it holds | | --- | --- | --- | | `id` | integer | The certificate ID, assigned by Azion | -| `status` | enum | The state of the certificate, as Statuses describes | +| `status` | enum | The state of the certificate, as [Statuses](/en/documentation/platform/certificate-manager/certificates/#statuses) describes | | `status_detail` | string, 0 to 500 characters | Why issuance failed; empty (`""`) otherwise | | `managed` | boolean | `true` for a Let's Encrypt certificate that Azion manages, `false` otherwise | | `key_algorithm` | string | On an uploaded certificate, the algorithm of its key, such as `rsa_2048` | @@ -191,7 +195,7 @@ The read-only `status` field reports the state of a certificate. The API returns The certificate list in Azion Console shows a warning icon for a `pending` certificate and an error icon for a `failed` one, with `status_detail` as the explanation. A certificate whose `validity` date has passed carries the tag **Expired**. The Workload's **Digital Certificate** field warns "This certificate is pending validation and HTTPS may not work until it’s validated" for a pending certificate. For a failed one, it warns "This digital certificate failed and HTTPS cannot be used until the issue is resolved". -An uploaded certificate reads `inactive` until you bind it to a Workload, and `active` from then on. Binding a certificate is a change to the Workload, and it takes several minutes to reach all of Azion's distributed infrastructure. Meanwhile, requests can meet the old or the new configuration. For how a Let's Encrypt certificate moves through `pending`, `challenge_verification`, and `active`, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). +An uploaded certificate reads `inactive` until you bind it to a Workload, and `active` from then on. Binding a certificate is a change to the Workload, and it takes several minutes to reach all of Azion's distributed infrastructure. Meanwhile, requests can meet the old or the new configuration. For how a Let's Encrypt certificate moves through `pending`, `challenge_verification`, and `active`, refer to [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). `azion list digital-certificate --details` shows the status of each certificate. Here a Trusted CA certificate and a server certificate are bound to a Workload, and a second server certificate is not: @@ -291,7 +295,9 @@ Azion fills the fields below from the CRL itself and from the request: | `last_modified` | string, date-time | When the CRL content last changed | | `product_version` | string | `1.0` | -Azion validates a CRL before it stores it. Each request stores one CRL, so to add several, send one `POST /v4/workspace/tls/crls` per CRL. A CRL that a Workload lists in `mtls.config.crl` cannot be deleted: remove it from the Workload first. In Azion Console, the **Edit CRL** page reads "Paste the PEM-encoded CRL in the respective field to update the certificate. The current certificate is hidden to protect sensitive information." +Azion validates a CRL before it stores it. Each request stores one CRL, so to add several, send one `POST /v4/workspace/tls/crls` per CRL. A CRL that a Workload lists in `mtls.config.crl` cannot be deleted: remove it from the Workload first. + +In Azion Console, the **Edit CRL** page reads "Paste the PEM-encoded CRL in the respective field to update the certificate. The current certificate is hidden to protect sensitive information." Store a CRL with the CLI: @@ -327,7 +333,7 @@ Created Certificate Revocation List with ID ## Errors -The API refuses each request below with the message in the first column. The CLI prints the message inside `Error: Failed to create the Digital Certificate: [...]`, `Error: Failed to request the Digital Certificate: [...]`, `Error: Failed to create the Certificate Signing Request: [...]`, or `Error: Failed to update the Workload: [...]`. The message is followed by `Check your settings and try again. If the error persists, contact Azion support`. For symptoms that return no message, refer to [Workloads troubleshooting](/en/documentation/platform/workloads/troubleshooting/#certificate-manager). +The API refuses each request below with the message in the first column. The CLI prints the message inside `Error: Failed to create the Digital Certificate: [...]`, `Error: Failed to request the Digital Certificate: [...]`, `Error: Failed to create the Certificate Signing Request: [...]`, or `Error: Failed to update the Workload: [...]`. The message is followed by `Check your settings and try again. If the error persists, contact Azion support`. For symptoms that return no message, refer to [Troubleshoot Certificate Manager](/en/documentation/platform/certificate-manager/troubleshooting/). | Message | Cause | What to do | | --- | --- | --- | @@ -336,7 +342,7 @@ The API refuses each request below with the message in the first column. The CLI | `Invalid certificate type, MUST be an Edge Certificate.` | A Workload's `tls.certificate` holds the ID of a Trusted CA certificate. | Send the ID of a certificate of type `edge_certificate`, or `null` for the Azion SAN certificate. | | `Invalid certificate type, MUST be a Trusted CA.` | A Workload's `mtls.config.certificate` holds the ID of a server certificate. | Send the ID of a certificate of type `trusted_ca_certificate`. | -An `azion.app` hostname in a Let's Encrypt request or a CSR gets the permission refusal too, even one that a Workload of the account holds. For the private key forms the API accepts, refer to [Key algorithms and formats](/en/documentation/platform/workloads/certificate-manager/certificates/#key-algorithms-and-formats). +An `azion.app` hostname in a Let's Encrypt request or a CSR gets the permission refusal too, even one that a Workload of the account holds. For the private key forms the API accepts, refer to [Key algorithms and formats](/en/documentation/platform/certificate-manager/certificates/#key-algorithms-and-formats). --- @@ -344,9 +350,9 @@ An `azion.app` hostname in a Let's Encrypt request or a CSR gets the permission - How Azion requests and renews a Let's Encrypt certificate, with what each challenge needs. + How Azion requests and renews a Let's Encrypt certificate, with what each challenge needs. How a Workload checks client certificates against a Trusted CA certificate, in enforce and permissive mode, and lists its CRLs. The steps to upload a server certificate and bind it to a Workload. - The size of a certificate, a private key, and a CRL, beside the other bounds on Workloads. + The size of a certificate, a private key, and a CRL, and the number of CRLs a Workload lists. diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/glossary.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/glossary.mdx new file mode 100644 index 0000000000..d95eed6bc5 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/glossary.mdx @@ -0,0 +1,19 @@ +--- +title: Glossary +description: Look up what Certificate Manager, CRL, CSR, Trusted CA certificate, and the other terms of the Certificate Manager pages mean. +meta_tags: 'certificate manager, glossary, terms, digital certificate, trusted ca certificate, crl, csr, lets encrypt, azion san certificate' +namespace: documentation_products_certificate_manager_glossary +permalink: /documentation/platform/certificate-manager/glossary/ +--- + +Definitions for the terms the **Certificate Manager** documentation uses. + +| Term | Definition | +| --- | --- | +| Azion SAN certificate | Azion's own Transport Layer Security (TLS) certificate, which lists the hostnames it covers as Subject Alternative Names (SAN). A [Workload](/en/documentation/platform/workloads/) presents it on the [workload domain](/en/documentation/platform/workloads/how-it-works/#workload-domain-and-custom-domains), and on every hostname while `tls.certificate` is `null`, and it covers the workload domain and the [Azion custom domain](/en/documentation/platform/workloads/glossary/) at no additional cost. To present a certificate for your own domain instead, refer to [Certificates](/en/documentation/platform/certificate-manager/certificates/). | +| Certificate Manager | A Platform Resource that stores the certificates a [Workload](/en/documentation/platform/workloads/) uses for TLS, served in the API under `/v4/workspace/tls/`. It holds server certificates you upload, Let's Encrypt certificates Azion requests and renews, Trusted CA certificates, certificate revocation lists, and CSRs. [Certificate Manager](/en/documentation/platform/certificate-manager/) describes what it does for a Workload, and the [Certificate Manager quickstart](/en/documentation/platform/certificate-manager/quickstart/) binds a first certificate. | +| certificate revocation list (CRL) | The list of certificates that a certificate authority revoked before their expiration date, signed by that certificate authority. You upload it to Certificate Manager and attach it to a Workload in `mtls.config.crl`, at most 100 per Workload, beside the Trusted CA certificate. [Certificates](/en/documentation/platform/certificate-manager/certificates/) documents its fields. | +| certificate signing request (CSR) | A request for a certificate that you create in Certificate Manager and submit to a certificate authority (CA). The **Common Name** (`common_name`) sets the domain the certificate covers, and the CSR creates a certificate entry with no certificate yet. Once the CA signs the certificate, you add the PEM-encoded certificate to that entry, and [Certificates](/en/documentation/platform/certificate-manager/certificates/) lists every field. | +| digital certificate | A certificate that Certificate Manager stores, of any kind, under the name Azion Console and Azion CLI use for it, from the **Digital Certificate** field (`tls.certificate`) of a Workload to the `azion create digital-certificate` command. Its `type` is `edge_certificate` for a server certificate or `trusted_ca_certificate` for a Trusted CA certificate, and a Let's Encrypt certificate is one Azion requests and renews. [Certificates](/en/documentation/platform/certificate-manager/certificates/) compares the kinds. | +| Let's Encrypt certificate | A free TLS certificate signed by the Let's Encrypt certificate authority, which Azion requests and renews for you. Let's Encrypt validates the domain through an HTTP-01 or DNS-01 challenge that Azion completes, and renewal starts 30 days before the 90-day validity ends. [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/) covers the challenges and the retry policy. | +| Trusted CA certificate | The certificate of a certificate authority that you upload so a Workload can verify client certificates in [mTLS](/en/documentation/platform/workloads/mtls/), `trusted_ca_certificate` in the API and **Trusted CA Certificate** in Azion Console. The upload accepts intermediate certificates, and a Workload sets it in `mtls.config.certificate`, where a server certificate returns `Invalid certificate type, MUST be a Trusted CA.` To upload one, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/). | diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/how-it-works.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/how-it-works.mdx new file mode 100644 index 0000000000..c002471dc4 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/how-it-works.mdx @@ -0,0 +1,72 @@ +--- +title: How Certificate Manager works +description: Understand what Certificate Manager stores, how a Workload binds a server or Trusted CA certificate, and what keeping certificates apart costs. +meta_tags: 'certificate manager, how it works, server certificate, trusted ca certificate, crl, csr, certificate binding, tls, mtls, workloads' +namespace: documentation_products_certificate_manager_how_it_works +permalink: /documentation/platform/certificate-manager/how-it-works/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +An HTTPS connection starts with a handshake in which the server presents a certificate whose names cover the hostname the client asked for. A server that also checks its clients needs the certificate of the authority that signs their certificates. + +[Certificate Manager](/en/documentation/platform/certificate-manager/) is a Platform Resource that stores the certificates a [Workload](/en/documentation/platform/workloads/) uses for Transport Layer Security (TLS). The handshake, step by step, is under [Request path](/en/documentation/platform/certificate-manager/#request-path), and how Azion obtains a Let's Encrypt certificate is on [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/). The sections cover what Certificate Manager stores, how a Workload binds a certificate, and the cost of storing certificates apart from the Workload. + +--- + +## What Certificate Manager stores + +Certificate Manager stores two kinds of certificate, server and Trusted CA, plus certificate revocation lists, and it creates certificate signing requests. + +A server certificate is a TLS certificate for your own domains. The Workload presents it in the handshake to prove it holds a hostname. You upload it with its private key, or Azion requests it from Let's Encrypt and renews it for you. + +A domain of your own needs a server certificate, because the Azion SAN certificate, Azion's own, covers only the workload domain and the `azion.app` hostname. For example, a Workload reached only on its workload domain serves HTTPS with nothing stored in Certificate Manager. Once `www.example.com` joins that Workload's domains, it needs a server certificate that covers it. + +A Trusted CA certificate is the certificate of a certificate authority (CA) that you trust to sign client certificates. A Workload with mutual TLS (mTLS) on checks each client certificate against it, and [mTLS](/en/documentation/platform/workloads/mtls/#verification-modes) describes how the `enforce` and `permissive` modes treat each client. + +A certificate revocation list (CRL) is the list of certificates that a CA revoked before their expiration date, signed by that CA. + +A certificate signing request (CSR) is the request you submit to a CA to obtain a certificate of your own. Certificate Manager creates the CSR and generates its private key, which Azion keeps and the API never returns. For the fields of each object, refer to [Certificates](/en/documentation/platform/certificate-manager/certificates/). + +--- + +## Certificate binding + +A certificate in Certificate Manager reaches no traffic until you bind it to a Workload. Once bound, it acts during the TLS handshake, before a Firewall or an Application sees the request. + +Each kind of entry goes in the Workload field meant for it: + +- A server certificate goes in [`tls.certificate`](/en/documentation/platform/workloads/settings/#tls). +- A Trusted CA certificate goes in [`mtls.config.certificate`](/en/documentation/platform/workloads/settings/#mtls). +- CRLs go in `mtls.config.crl`. + +The API refuses a certificate sent in the field meant for the other kind. For the refusal and its fix, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#a-certificate-is-refused-in-a-workload-setting). + +With `tls.certificate` set to `null`, the Workload presents the Azion SAN certificate instead. + +The status of an uploaded certificate shows whether any Workload uses it. It reads `inactive` until you bind it to a Workload, and `active` from then on. For every status value, refer to [Statuses](/en/documentation/platform/certificate-manager/certificates/#statuses). + +--- + +## Certificates stored apart from the Workload + +Certificate Manager keeps each certificate apart from the Workload, so replacing one leaves the Workload's other settings untouched. For example, swapping an uploaded certificate before it expires changes one value, `tls.certificate`, and the old entry stays in Certificate Manager until you delete it. + +The price of that split is two separate checks, one per entity. The API does not compare a certificate's names with the Workload's domains, so it accepts a certificate that does not cover them. That mismatch surfaces only when a client checks the names, as a failed handshake. + +Binding a certificate is also a Workload change, and it takes several minutes to reach all of Azion's distributed infrastructure. Until then, some data centers serve the old configuration and others the new one, as [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation) describes. + +--- + +## Related resources + + + + Every field of a certificate, a CSR, and a CRL, with the statuses, key formats, and errors behind this page. + Upload a server certificate, bind it to a Workload, and confirm it reads active. + The size of a certificate, a private key, and a CRL, and the number of CRLs a Workload lists. + Replace a certificate before it expires and keep each renewal path working. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/issuance-and-renewal.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/issuance-and-renewal.mdx index 74d74d0499..e5b886c469 100644 --- a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/issuance-and-renewal.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/issuance-and-renewal.mdx @@ -3,7 +3,7 @@ title: Issuance and renewal description: Understand how Azion requests and renews a Let's Encrypt certificate for a Workload's domains, which challenge proves control, and what happens when it fails. meta_tags: 'certificate manager, lets encrypt, acme, http-01, dns-01, wildcard certificate, renewal, certificate status, workloads' namespace: documentation_products_certificate_manager_issuance_and_renewal -permalink: /documentation/platform/workloads/certificate-manager/issuance-and-renewal/ +permalink: /documentation/platform/certificate-manager/issuance-and-renewal/ --- import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' @@ -11,7 +11,7 @@ import DocItem from '@aziontech/webkit/doc-item' A certificate authority (CA) is an organization that signs certificates. It signs one only after the requester proves control of every name on it. The proof is a challenge: a value the CA checks in the domain's Domain Name System (DNS) records, or a file served on the hostname. Let's Encrypt is a CA that issues certificates valid for 90 days, so a certificate stays useful only while someone renews it. -For a Workload's server certificate, Azion takes that work on: it requests the certificate from Let's Encrypt, completes the challenge, and renews the certificate before it expires. [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) is a Platform Resource that stores the certificates a Workload uses for Transport Layer Security (TLS). For where Certificate Manager acts on a request, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/#certificate-manager). A certificate you upload, or obtain from a CA through a certificate signing request (CSR), is described on [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). +For a Workload's server certificate, Azion takes that work on: it requests the certificate from Let's Encrypt, completes the challenge, and renews the certificate before it expires. [Certificate Manager](/en/documentation/platform/certificate-manager/) is a Platform Resource that stores the certificates a Workload uses for Transport Layer Security (TLS). For where Certificate Manager acts on a request, refer to [Request path](/en/documentation/platform/certificate-manager/#request-path). A certificate you upload, or obtain from a CA through a certificate signing request (CSR), is described on [Certificates](/en/documentation/platform/certificate-manager/certificates/). The sections cover certificate requests, domain validation, wildcard certificates, statuses, issuance time and retries, and renewal. @@ -19,13 +19,13 @@ The sections cover certificate requests, domain validation, wildcard certificate ## Certificate requests -A Let's Encrypt request asks Azion to obtain a certificate for a set of hostnames. In the body of an API request, the main hostname goes in `common_name`. Optionally, other hostnames go in `alternative_names`, and the certificate lists them as Subject Alternative Names (SANs). The body also names the authority, `lets_encrypt`, and the challenge that proves control of the names: `http` for HTTP-01 or `dns` for DNS-01. In Azion Console, the Workload form fills these fields for you. The names come from the Workload's **Domains**, and the challenge comes from the preset you pick. +A Let's Encrypt request asks Azion to obtain a certificate for a set of hostnames. In the body of an API request, the main hostname goes in `common_name`, and optional other hostnames go in `alternative_names`, which the certificate lists as Subject Alternative Names (SANs). The body also names the authority, `lets_encrypt`, and the challenge that proves control of the names: `http` for HTTP-01 or `dns` for DNS-01. A request from the Workload form in Azion Console takes the names from the Workload's domains and the challenge from the preset you pick. -Azion generates the certificate's key. On an API request, `key_algorithm` defaults to `ecc_384`. For the other algorithms and defaults, refer to [Certificate fields](/en/documentation/platform/workloads/certificate-manager/certificates/#certificate-fields). +Azion generates the certificate's key. `key_algorithm` defaults to `ecc_384` on an API request and to `rsa_2048` on a request from the Workload form. For the other algorithms, refer to [Certificate fields](/en/documentation/platform/certificate-manager/certificates/#certificate-fields). -You request a certificate in Azion Console or through the API. [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/) and [Request a Let's Encrypt certificate with the API](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate-via-api/) show the steps. The Console presets _New Let's Encrypt Certificate (HTTP-01)_ and _New Let's Encrypt Certificate (DNS-01)_ appear in Certificate Manager and in the Workload's **Digital Certificate** field. Through the API, the request is `POST /v4/workspace/tls/certificates/request`. From the Workload form, the Console names the certificate `Lets Encrypt - - ` and sets `key_algorithm` to `rsa_2048`. +You request a certificate in Azion Console or with `POST /v4/workspace/tls/certificates/request`. [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/) and [Request a Let's Encrypt certificate with the API](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate-via-api/) show the steps. For the Console presets that start a request and the name the Console gives the certificate, refer to [Let's Encrypt certificate](/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate). -The API answers a request with the certificate's `id`, and Azion schedules the issuance. Until Let's Encrypt issues the certificate, the entry holds a temporary certificate that Azion generates. The certificate is listed in Certificate Manager from then on, and the `id` identifies it when you check its status. +Until Let's Encrypt issues the certificate, its entry in Certificate Manager holds a temporary certificate that Azion generates. The certificate is listed in Certificate Manager from the request on, and the `id` the API returns identifies it when you check its status. This diagram follows a request from you to the Workload that presents the certificate. Solid arrows carry requests and checks, and dotted arrows carry answers. Each label starts with the number of the step it belongs to. @@ -63,7 +63,9 @@ Azion requests Let's Encrypt certificates for domains and subdomains registered Let's Encrypt validates every name on a request before it issues the certificate, and the request's challenge decides how. Azion supports both challenges, HTTP-01 and DNS-01, for a domain whose DNS is hosted in [Edge DNS](/en/documentation/platform/edge-dns/) or at another DNS provider. -With HTTP-01, Let's Encrypt validates the hostname through a file served for it, and Azion runs the service that answers the challenge. The domain's DNS needs no TXT record, so the challenge asks for no change in the domain's zone. The hostname must already point to Azion when you send the request. When the request carries alternative names, every one of them must point to Azion, or the issuance fails. Azion schedules the issuance even when no Workload with the hostname is published and active. Because no DNS change is needed per name, HTTP-01 suits an account that manages many domains and hostnames. +With HTTP-01, Let's Encrypt validates the hostname through a file served for it, and Azion runs the service that answers the challenge. No name needs a TXT record or any other change in the domain's zone, so HTTP-01 suits an account that manages many domains and hostnames. + +The hostname must already point to Azion when you send an HTTP-01 request. Every alternative name on the request must point to Azion too, or the issuance fails. Azion schedules the issuance even when no Workload with the hostname is published and active. With DNS-01, Let's Encrypt validates the hostname through a TXT record in the domain's DNS, under the hostname's `_acme-challenge` name. Who prepares the DNS depends on where the zone is hosted: @@ -79,7 +81,7 @@ Each challenge fits a different situation: | HTTP-01 | `http` | You do not control the domain's DNS records, and the domain already points to Azion | | DNS-01 | `dns` | You control the DNS records, need a wildcard name, or cannot access the web server | -The two challenges trade a dependency on traffic for a dependency on DNS. HTTP-01 needs no record, but it cannot validate a hostname that does not point to Azion yet. For example, during a move to Azion, a DNS-01 request can obtain the certificate for `www.example.com` while the hostname still points to the previous provider. An HTTP-01 request can obtain it only after the hostname points to Azion. +The two challenges trade a dependency on traffic for a dependency on DNS. For example, during a move to Azion, a DNS-01 request can obtain the certificate for `www.example.com` while the hostname still points to the previous provider. An HTTP-01 request can obtain it only after the hostname points to Azion. --- @@ -87,13 +89,13 @@ The two challenges trade a dependency on traffic for a dependency on DNS. HTTP-0 A wildcard name, such as `*.example.com`, lets one certificate cover subdomains that you do not list one by one. A wildcard certificate goes through the DNS-01 challenge, and Azion requests and renews it automatically. -Automatic issuance needs the domain's zone configured and active in Edge DNS, which gives Azion control over the records the validation needs. During issuance, Azion generates the `_acme-challenge` TXT record and inserts it into the zone, with no action from you. When the zone is not active in Edge DNS, Azion cannot automate the validation, and you complete it manually. +Automatic issuance needs the domain's zone configured and active in Edge DNS, which gives Azion control over the `_acme-challenge` TXT record the validation needs. When the zone is not active in Edge DNS, Azion cannot automate the validation, and you complete it manually. A certificate can carry a wildcard name alone or next to specific names. A subdomain that the wildcard already covers needs no entry of its own: with `*.example.com` on the certificate, `blog.example.com` need not be listed. A Workload, by contrast, lists each hostname in full. Its domains refuse a wildcard entry with `The domain does not conform to the format defined in RFC 1035.` The Workload form requests a certificate for the Workload's domains, so it cannot request a wildcard name. To request one with the DNS-01 challenge, refer to [Request a Let's Encrypt certificate with the API](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate-via-api/). -One wildcard certificate in place of one certificate per subdomain means fewer distinct certificates to issue. That lowers the chance of reaching the issuance limits of the Let's Encrypt service, which [Workloads limits](/en/documentation/platform/workloads/limits/#certificate-manager) links. The cost is a dependency on DNS: automatic issuance needs the zone in Edge DNS, and a zone elsewhere means validating by hand. For when one certificate shared by many subdomains is a risk, refer to [Workloads best practices](/en/documentation/platform/workloads/best-practices/#certificate-manager). +One wildcard certificate in place of one certificate per subdomain means fewer distinct certificates to issue. That lowers the chance of reaching the issuance limits of the Let's Encrypt service, which [Certificate Manager limits](/en/documentation/platform/certificate-manager/limits/) links. The cost is the dependency on Edge DNS that automatic issuance brings. For when one certificate shared by many subdomains is a risk, refer to [Certificate Manager best practices](/en/documentation/platform/certificate-manager/best-practices/). --- @@ -127,9 +129,9 @@ flowchart TD 4. When validation fails, the certificate reads `failed`, and it keeps that status between the retries of the issuance. The `status_detail` field carries the reason, such as `An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com`. 5. Once its `validity` date passes, the certificate reads `expired` and no longer protects traffic. -Azion Console shows the same states. The certificate list marks a `pending` certificate with a warning icon and a `failed` one with an error icon, with `status_detail` as the explanation. A certificate whose `validity` date has passed carries the tag **Expired**. +You can bind a certificate to a Workload before Let's Encrypt issues it, but HTTPS on the Workload's domains may not work until the certificate validates. In Azion Console, the Workload's **Digital Certificate** field then warns "This certificate is pending validation and HTTPS may not work until it’s validated". For a failed certificate, it warns "This digital certificate failed and HTTPS cannot be used until the issue is resolved". -You can bind a certificate to a Workload before Let's Encrypt issues it. In Azion Console, the Workload's **Digital Certificate** field then warns "This certificate is pending validation and HTTPS may not work until it’s validated". For a failed certificate, it warns "This digital certificate failed and HTTPS cannot be used until the issue is resolved". Until the certificate validates, HTTPS on the Workload's domains may not work. For the full status table, uploaded certificates included, refer to [Statuses](/en/documentation/platform/workloads/certificate-manager/certificates/#statuses). +For the full status table, with uploaded certificates and the icons of the Azion Console list, refer to [Statuses](/en/documentation/platform/certificate-manager/certificates/#statuses). --- @@ -139,13 +141,13 @@ Azion makes the first attempt to obtain a Let's Encrypt certificate up to 5 minu The first 5 retries come at increasing intervals of about 5 to 30 minutes, and they resolve most failures that DNS propagation or a temporarily unavailable service causes. -Azion records why an attempt failed in `status_detail`, which the API returns with the certificate and Azion Console shows with the status icon. For example, a mistyped `_acme-challenge` CNAME at your DNS provider fails the first attempts, and `status_detail` names the hostname whose CNAME to check. Once you correct the record, a later attempt in the schedule can obtain the certificate. For symptoms and their fixes, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#certificate-manager). +Azion records why an attempt failed in `status_detail`, which the API returns with the certificate and Azion Console shows beside the certificate's error icon. For example, a mistyped `_acme-challenge` CNAME at your DNS provider fails the first attempts, and `status_detail` names the hostname whose CNAME to check. Once you correct the record, a later attempt in the schedule can obtain the certificate. For symptoms and their fixes, refer to [Troubleshoot Certificate Manager](/en/documentation/platform/certificate-manager/troubleshooting/). --- ## Renewal -A Let's Encrypt certificate expires 90 days after it is issued, and Azion renews it automatically before that date. Renewal starts 30 days before expiration, when the certificate becomes eligible for renewal. Azion monitors the certificates it requested, completes the challenge again as renewal approaches, and updates the certificate. The `renewed_at` field records when Azion last renewed it. +Azion renews a Let's Encrypt certificate automatically before its 90-day validity ends. Renewal starts 30 days before expiration, when the certificate becomes eligible for renewal. Azion monitors the certificates it requested, completes the challenge again as renewal approaches, and updates the certificate. The `renewed_at` field records when Azion last renewed it. The renewal needs no maintenance window, and the certificate keeps its quotas, billing, and permissions. Wildcard certificates renew the same way. @@ -157,9 +159,11 @@ Azion stops renewing a certificate in these cases: - You change the domains the certificate was requested for. Azion creates another certificate from the changed set, and the old one is not renewed. - You delete the certificate, or the domain it was requested for is removed from Azion. Each of these two events also deactivates a managed certificate. -A certificate unbound from its Workload stays in Certificate Manager, and you can bind it again while it remains valid. Automatic renewal removes the expiration date as a task, at the cost of a dependency. The validation path that obtained the certificate has to keep working for as long as a Workload uses it. +A certificate unbound from its Workload stays in Certificate Manager, and you can bind it again while it remains valid. + +Automatic renewal removes the expiration date as a task, at the cost of a dependency. The validation path that obtained the certificate has to keep working for as long as a Workload uses it. -Azion does not renew a certificate you upload. To replace one before it expires, refer to [Workloads best practices](/en/documentation/platform/workloads/best-practices/#certificate-manager). +Azion does not renew a certificate you upload. To replace one before it expires, refer to [Certificate Manager best practices](/en/documentation/platform/certificate-manager/best-practices/). --- @@ -167,9 +171,9 @@ Azion does not renew a certificate you upload. To replace one before it expires, - Every field of a Let's Encrypt request, the full status table, and the key algorithms Azion generates. + Every field of a Let's Encrypt request, the full status table, and the key algorithms Azion generates. The steps to request a Let's Encrypt certificate and prepare the DNS records its challenge needs. The steps to add the TXT record that a DNS-01 challenge checks. - Symptoms of a certificate that fails to issue or renew, with their causes and fixes. + Symptoms of a certificate that fails to issue or renew, with their causes and fixes. diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/limits.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/limits.mdx new file mode 100644 index 0000000000..4cecec833c --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/limits.mdx @@ -0,0 +1,49 @@ +--- +title: Certificate Manager limits +description: Check the size bounds of a certificate, a private key, and a CRL, the CRLs a Workload lists, and where Let's Encrypt support stops. +meta_tags: 'certificate manager, limits, certificate size, private key, crl, lets encrypt, rate limits, workloads, tls, mtls' +namespace: documentation_products_certificate_manager_limits +permalink: /documentation/platform/certificate-manager/limits/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +[Certificate Manager](/en/documentation/platform/certificate-manager/) is a Platform Resource that stores the certificates a [Workload](/en/documentation/platform/workloads/) uses for Transport Layer Security (TLS): server certificates, Trusted CA certificates for mutual TLS (mTLS), and the certificate revocation lists (CRLs) a Workload lists. It also requests the Let's Encrypt certificates that Azion manages for you. Certificate Manager has no included amount per plan. + +--- + +## Scope + +- **Azion SAN certificate**: a Workload needs nothing from Certificate Manager for its workload domain and its `azion.app` hostname, because the Azion SAN certificate covers both. A domain of your own needs a server certificate from Certificate Manager. For the certificate types, refer to [Certificates](/en/documentation/platform/certificate-manager/certificates/#certificate-types). +- **Names on a Let's Encrypt certificate**: a certificate requested from the Workload form covers the Workload's domains, because the form fills `common_name` and `alternative_names` from them. An API request names its hostnames in those two fields itself. A Workload refuses a wildcard domain, so the Workload form cannot request a wildcard name. For a wildcard name, refer to [Wildcard certificates](/en/documentation/platform/certificate-manager/issuance-and-renewal/#wildcard-certificates). +- **Let's Encrypt service**: Azion's support for Let's Encrypt certificates depends on the availability and the limits of the Let's Encrypt service. One wildcard certificate in place of one certificate per subdomain lowers the chance of reaching those limits. For the limits, refer to the [Let's Encrypt rate limits](https://letsencrypt.org/docs/rate-limits/). + +--- + +## Default limits + +The Azion API checks each bound in this table on every call, and a call past a bound fails. + +| Scope | Limit | +| --- | --- | +| Certificate, server or Trusted CA, in `certificate` | Up to 1,000,000 characters | +| Private key, in `private_key` | Up to 64,000 characters | +| CRL, in `crl` | Up to 30,720,000 characters | +| CRLs per Workload, in `mtls.config.crl` | Up to 100 | + +One further bound applies: a Let's Encrypt certificate covers up to 50 of the Workload's domains. For the number of domains a Workload lists, refer to [Workloads limits](/en/documentation/platform/workloads/limits/). + +--- + +## Related resources + + + + Every field of a certificate, a CSR, and a CRL, including the fields the bounds on this page apply to. + How Azion requests a Let's Encrypt certificate for a Workload's domains and renews it. + The Workload fields that hold a Trusted CA certificate and the CRLs a Workload lists. + What Certificate Manager stores and how a Workload binds each certificate. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/overview.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/overview.mdx new file mode 100644 index 0000000000..e333d4aa97 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/overview.mdx @@ -0,0 +1,65 @@ +--- +title: Certificate Manager +description: Store the certificates your Workloads use for TLS, from certificates you upload to Let's Encrypt certificates that Azion requests and renews. +meta_tags: 'certificate manager, digital certificate, tls, server certificate, trusted ca certificate, lets encrypt, csr, crl, mtls, workloads' +namespace: documentation_products_certificate_manager +permalink: /documentation/platform/certificate-manager/ +--- + +import DocButton from '~/components/webkit/DocButton.vue' +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' + +**Certificate Manager** is a Platform Resource that stores the certificates a [Workload](/en/documentation/platform/workloads/) uses for Transport Layer Security (TLS) connections on Azion's distributed infrastructure. A certificate is a signed document that proves a server holds a hostname, or lets that server verify client certificates for [mutual TLS (mTLS)](/en/documentation/platform/workloads/mtls/). Use Certificate Manager to serve HTTPS on your own domains or accept client certificates from your certificate authority (CA). + +Certificate Manager holds certificates you obtain yourself and certificates Azion obtains for you: + +- [Certificates](/en/documentation/platform/certificate-manager/certificates/) let you bring a certificate a CA issued to you, with its private key, or request one through a certificate signing request (CSR). Certificate Manager also stores certificate revocation lists (CRLs), so a Workload can refuse the client certificates a CA revoked. +- [Issuance and renewal](/en/documentation/platform/certificate-manager/issuance-and-renewal/) lets Azion request a server certificate for a Workload's domains from Let's Encrypt and renew it before it expires. Every name on the certificate must belong to a domain your account has permission for. + + + + +## Request path + +Storing a certificate in Certificate Manager secures no hostname: a Workload uses a certificate only once that certificate is bound to that Workload. Certificate Manager then acts during the TLS handshake. + +This diagram follows a handshake from the client's hello to the request that continues, with the certificates Certificate Manager supplies. Solid arrows carry the handshake and the request, and dotted arrows carry what goes back to the client. The thick arrow carries the certificates you bound before the request. Each label starts with the number of the step it belongs to. + +```mermaid +%%{init: {"layout": "elk", "elk": {"cycleBreakingStrategy": "MODEL_ORDER"}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% +flowchart TD + Client(["Client"]) + WL["Workload"] + CM["Certificate Manager"] + FW["Firewall"] + App["Application"] + Client -->|"1, 4. TLS hello, then the client certificate"| WL + CM ==>|"2, 4. bound server certificate, Trusted CA"| WL + WL -.->|"2. server certificate"| Client + WL -.->|"5. enforce, missing or untrusted: handshake ends"| Client + WL -->|"3, 5. Firewall set"| FW + WL -->|"3, 5. no Firewall"| App + FW -->|"3, 5. allowed"| App + FW -.->|"5. refused by a rule"| Client +``` + +1. The client opens a TLS connection to one of the Workload's hostnames and names that hostname through Server Name Indication (SNI). +2. The Workload presents its server certificate. For the [workload domain](/en/documentation/platform/workloads/how-it-works/#workload-domain-and-custom-domains), or with `tls.certificate` set to `null`, that is Azion's SAN certificate. For a custom domain with a server certificate bound, it is that certificate. +3. With mTLS off, the handshake completes, and the request continues to the [Application](/en/documentation/platform/applications/), through the [Firewall](/en/documentation/platform/firewall/) when the deployment sets one. +4. With mTLS on, the Workload requests a client certificate and checks it against the Trusted CA certificate in `mtls.config.certificate`. +5. In `enforce` mode, a client with no certificate, or with one another authority signed, cannot complete the handshake. In `permissive` mode, the handshake completes. When the deployment sets a Firewall, a rule that tests the Client Certificate Validation variable can refuse the request. + +--- + +## Next steps + + + + + + + + + + diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/quickstart.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/quickstart.mdx index 89be1bab8b..941df03103 100644 --- a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/quickstart.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/quickstart.mdx @@ -3,7 +3,7 @@ title: Certificate Manager quickstart description: Upload your first certificate to Certificate Manager, bind it to a Workload, and confirm the platform marks it active. meta_tags: 'certificate manager, quickstart, digital certificate, edge certificate, tls, https, workloads, azion cli' namespace: documentation_products_certificate_manager_quickstart -permalink: /documentation/platform/workloads/certificate-manager/quickstart/ +permalink: /documentation/platform/certificate-manager/quickstart/ --- import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' @@ -12,7 +12,7 @@ import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' import Code from '~/components/webkit/CodeBlock.vue' -This guide instructs you through binding your first certificate of your own to a [Workload](/en/documentation/platform/workloads/) with [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager). +This guide instructs you through binding your first certificate of your own to a [Workload](/en/documentation/platform/workloads/) with [Certificate Manager](/en/documentation/platform/certificate-manager/). - Upload a server certificate and its private key to Certificate Manager. - Bind the certificate to your Workload. @@ -26,7 +26,7 @@ Three elements take part, and each one links to the next: An uploaded certificate protects no traffic until you bind it to a Workload. The Azion SAN certificate covers only the workload domain and the `azion.app` hostname. A Workload keeps presenting it for those two hostnames after you bind your own certificate. This guide changes only the `tls` settings of the Workload and keeps its domains, ports, and deployment as they are. -To have Azion request a certificate from Let's Encrypt and renew it for you instead, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). In Azion Console, the Workload's **Digital Certificate** field also offers the Let's Encrypt presets, described in [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#lets-encrypt-certificate). +To have Azion request a certificate from Let's Encrypt and renew it for you instead, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). In Azion Console, the Workload's **Digital Certificate** field also offers the Let's Encrypt presets, described in [Certificates](/en/documentation/platform/certificate-manager/certificates/#lets-encrypt-certificate). --- @@ -360,7 +360,7 @@ Binding a certificate is a change to the Workload. The change takes several minu - + - + diff --git a/apps/docs/src/content/docs/en/pages/secure/certificate-manager/troubleshooting.mdx b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/troubleshooting.mdx new file mode 100644 index 0000000000..cab975e4c0 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/certificate-manager/troubleshooting.mdx @@ -0,0 +1,95 @@ +--- +title: Troubleshoot Certificate Manager +description: Fix a Let's Encrypt certificate that stays pending or fails to issue, a refused certificate request, and a refused private key. +meta_tags: 'certificate manager, troubleshooting, lets encrypt, pending certificate, failed certificate, status_detail, acme challenge, private key, csr, permission' +namespace: documentation_products_certificate_manager_troubleshooting +permalink: /documentation/platform/certificate-manager/troubleshooting/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +These symptoms affect [Certificate Manager](/en/documentation/platform/certificate-manager/), the Platform Resource that stores the certificates a Workload uses for Transport Layer Security (TLS) and reports each one's state in its `status` field. They cover a Let's Encrypt certificate that does not issue, and a request or an upload that the API refuses. A certificate refused in a Workload setting is a Workload symptom, under [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#a-certificate-is-refused-in-a-workload-setting). For where Certificate Manager acts on a request, refer to [Request path](/en/documentation/platform/certificate-manager/#request-path). + +--- + +## A certificate stays pending + +A Let's Encrypt certificate does not leave the `pending` or `challenge_verification` status. In Azion Console, the Workload's **Digital Certificate** field warns "This certificate is pending validation and HTTPS may not work until it’s validated". + +One of the names fails its challenge: in HTTP-01, Let's Encrypt fetches a file from each hostname, so every name must point to Azion. In DNS-01, it reads an `_acme-challenge` record in the domain's DNS, as [Domain validation](/en/documentation/platform/certificate-manager/issuance-and-renewal/#domain-validation) explains. + +- **Check the names**: a certificate requested from the Workload form in Azion Console covers the Workload's **Domains**, so confirm that each one is correct. +- **Point every name at Azion for HTTP-01**, alternative names included. +- **Add the CNAME for DNS-01 at another DNS provider**: name it `_acme-challenge.`, with the value `.letsencrypt.azion.com`. In Edge DNS, Azion writes the record itself. +- **Check the CNAME records again if the certificate keeps failing**: Azion retries a failed issuance at increasing intervals, as [Issuance time and retries](/en/documentation/platform/certificate-manager/issuance-and-renewal/#issuance-time-and-retries) lists. + +After a later attempt validates, the certificate reads `active` while a Workload uses it, or `inactive` until then. For the records step by step, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). + +--- + +## A certificate request is refused with This account cannot use certain common or alternative names + +A Let's Encrypt request, a certificate signing request (CSR), or saving a new domain in Azion Console fails with `This account cannot use certain common or alternative names because it does not have permission for their domain names.` + +The request carries a name in a domain that the account has no permission for. An `azion.app` hostname is refused too, even one that a Workload of the account holds, as [Errors](/en/documentation/platform/certificate-manager/certificates/#errors) lists. + +- **Name only hostnames in domains your account has permission for**, in `common_name` and `alternative_names`. +- **Request no certificate for an `azion.app` hostname**: with `tls.certificate` set to `null`, the Workload presents the Azion SAN certificate, which covers the `azion.app` hostname and the workload domain. +- **Remove the refused domain from Domains in Azion Console**: adding a domain switches **Digital Certificate** from _Azion (SAN)_ to _New Let's Encrypt Certificate (DNS-01)_. **Save** then requests that certificate before it saves the Workload, and saves nothing when the request is refused. + +An accepted request returns the certificate's `id` with the `pending` status, and Azion Console shows "Your workload has been updated". + +--- + +## A certificate fails to issue + +A Let's Encrypt certificate reads `failed`. In Azion Console, the Workload's **Digital Certificate** field warns "This digital certificate failed and HTTPS cannot be used until the issue is resolved". + +Validation failed, and Azion stores the reason in the certificate's `status_detail` field. One value names the hostname whose record to check: + +```text +An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com +``` + +Another value names no hostname, so check every name on the certificate, as [A certificate stays pending](/en/documentation/platform/certificate-manager/troubleshooting/#a-certificate-stays-pending) lists: + +```text +domain ownership validation failed - verify DNS records or HTTP challenge accessibility +``` + +Read `status_detail` from any interface, then correct the record or the name it points to: + +- **Azion Console**: in **Certificate Manager**, the error icon of the certificate carries it. +- **Azion CLI**: `azion describe digital-certificate --digital-certificate-id --format json` prints it beside `status`. +- **API**: `GET /v4/workspace/tls/certificates/` returns it with the certificate. + +A later attempt in the [retry schedule](/en/documentation/platform/certificate-manager/issuance-and-renewal/#issuance-time-and-retries) can then issue the certificate, and an issued certificate in use reads `active`, with `status_detail` at `""`. + +--- + +## An uploaded private key is refused + +Uploading a server certificate fails with `The provided private key is invalid. Please check the key and try again.` + +The `private_key` that arrived with the certificate is not one the API can read, as [Errors](/en/documentation/platform/certificate-manager/certificates/#errors) lists. + +- **Send the key that matches the certificate**. +- **Send the key in PEM**, with its `-----BEGIN` and `-----END` lines and no passphrase, as [Key algorithms and formats](/en/documentation/platform/certificate-manager/certificates/#key-algorithms-and-formats) lists. +- **Write the key as one JSON string in an API body**, with each line break written as `\n`. + +Azion CLI then prints `Created Digital Certificate with ID `, and the certificate reads `inactive` until a Workload uses it. + +--- + +## Related resources + + + + The certificate types, statuses, and key formats, with every error an upload or a request returns. + How each challenge validates a name, and the schedule Azion follows when an attempt fails. + The steps to upload a server certificate with its private key and bind it to a Workload. + Keep the challenge record in place and replace an uploaded certificate before it expires. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/connectors/troubleshooting.mdx b/apps/docs/src/content/docs/en/pages/secure/connectors/troubleshooting.mdx index c058b04f95..54f7c90711 100644 --- a/apps/docs/src/content/docs/en/pages/secure/connectors/troubleshooting.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/connectors/troubleshooting.mdx @@ -77,7 +77,7 @@ A client receives `421 Misdirected Request` for an HTTPS request to a workload. The request arrived on a TLS connection set up for a hostname other than its `Host` header, and the workload's certificate does not cover that host. Clients cause it when they reuse one connection for several hostnames, through connection pooling or HTTP/2 multiplexing, or send a `Host` header outside the certificate. - **Find the hostname**: in [Real-Time Events](/en/documentation/platform/real-time-events/), filter the requests by status code `421`, and compare the `host` and `ssl_server_name` fields of each event. -- **Cover every hostname in the certificate**: list it in the Common Name (CN) or the Subject Alternative Names (SAN) of the certificate in [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/), with a wildcard such as `*.example.com` or a multi-SAN certificate. +- **Cover every hostname in the certificate**: list it in the Common Name (CN) or the Subject Alternative Names (SAN) of the certificate in [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/), with a wildcard such as `*.example.com` or a multi-SAN certificate. - **Open one connection per hostname**: change the client's connection logic when the hostname must stay outside the certificate. Requests for the hostname then receive their normal response. For the checks that decide a `421` on the client's connection to the workload, refer to [SNI Check](/en/documentation/platform/connectors/sni-check/). diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/error-responses.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/error-responses.mdx new file mode 100644 index 0000000000..32afde3f45 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/error-responses.mdx @@ -0,0 +1,119 @@ +--- +title: Error Responses +description: >- + Customize the error page an Application on API v3 serves for each client or + server error status code it receives from the origin. +meta_tags: 'errors, application, http, error pages' +namespace: documentation_edge_application_error_responses +permalink: /documentation/platform/custom-pages/error-responses/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' +import VersionDeprecated from '~/includes/snippets/versionDeprecated/en/snippet.mdx' + +[Custom page settings](/en/documentation/platform/custom-pages/settings/) + +**Error Responses** is a Feature of Applications on API v3: the error page settings that customize the page a user receives for a status code from the origin. On API v4, [Custom Pages](/en/documentation/platform/custom-pages/) takes its place. + +When a user requests content from an Application, Azion sends the request to the origin servers. The origin answers with an HTTP status code, which says whether the request was completed. + +HTTP status codes are three-digit numbers, grouped into five categories: + +- Informational responses (1xx): the connection status or the progress before the request completes. +- Successful responses (2xx): the origin received, understood, accepted, and processed the request. +- Redirection messages (3xx): the request needs a redirect to be fulfilled. +- Client error responses (4xx): the request could not be completed because of an apparent error on the client side. +- Server error responses (5xx): the server cannot process the request. + +For more information on HTTP statuses, refer to the [specifications on HTTP status codes](https://httpwg.org/specs/rfc9110.html#overview.of.status.codes). + +Error Responses customizes how an Application handles client error (4xx) and server error (5xx) responses. When a request reaches a URL that the origin cannot find, or the server cannot respond, the user is redirected to a custom error page, and its content can be cached. + +--- + +## Status Code + +The code that Azion receives when it connects to the origin. + +--- + +## Error Caching TTL + +The time, in seconds, that the error page stays in cache before Azion refreshes it. For more information on expiration settings, refer to [Cache settings](/en/documentation/platform/applications/cache/cache-settings/#browser-cache). + +:::tip +An error page is often static and rarely changes, so Azion recommends a high cache time. A high value improves the performance of the Application and reduces the processing cost at the origin. +::: + +--- + +## URI + +The path to the file, usually HTML, that holds the content of the error page. Azion appends this path to the domain of the Application, for example, `/404.html`. + +--- + +## Custom Status Code + +The status code the user receives instead of the original one. For example, a page can deliver the `404` code in response to a `403` error. + +--- + +## Set Origin + +The origin that holds the URI file. You can change it only after you enter a URI, and you configure the origin in **Origins**. For more information, refer to [Origins](/en/documentation/platform/connectors/origins/). + +--- + +## Available error status codes + +Error Responses accepts these client error and server error status codes: + +| Status Code | Description | +| --- | --- | +| 400: Bad Request | A request error, such as invalid parameters or missing required parameters. | +| 401: Unauthorized | The request lacks the `Authentication` HTTP header. | +| 403: Forbidden | The user lacks permission to run the operation. | +| 404: Not Found | The requested resource does not exist. | +| 405: Method Not Allowed | The requested method cannot be applied to the URL. | +| 406: Not Acceptable | The `Accept` header is missing, or asks for a format or version the API does not support. | +| 408: Request Timeout | The request arrives slower than the server is prepared to wait, so the server wants to end the connection. | +| 409: Conflict | The request conflicts during execution, such as creating a record that already exists. | +| 410: Gone | The requested content was permanently deleted from the server, with no preset redirect address. | +| 411: Length Required | The server rejected the request because the required `Content-Length` header is undefined. | +| 414: URI Too Long | The requested URI is longer than the server's limits. | +| 415: Unsupported Media Type | The server does not support the media format of the requested data, so it rejects it. | +| 416: Request Range Not Satisfiable | The server cannot fill the `Range` header value, likely out of range of the target URI data. | +| 426: Upgrade Required | The server refuses the request on the current protocol and accepts it after the client changes protocol. | +| 429: Too Many Requests | The request was rejected for a time because it exceeded operation limits. | +| 431: Request Header Fields Too Large | The request headers are too long, or the request sends too many cookies. | +| 500: Internal Server Error | An unintentional, unidentified fault occurred while the request was processed. | +| 501: Not Implemented | The server does not support the request method, and the method cannot be modified. | +| 502: Bad Gateway | The server, working as a gateway to get a response the request needs, received an invalid response. | +| 503: Service Unavailable | The server is not ready to handle the request, often because it is overloaded or under maintenance. | +| 504: Gateway Timeout | The server, acting as a gateway, does not receive a response in time. | +| 505: HTTP Version Not Supported | The server does not support the HTTP version used in the request. | + +Six of the codes carry more detail: + +- **408**: this response is common because some browsers, such as Chrome, Firefox 27+, and IE9, use HTTP pre-connection to speed up navigation. Some servers also end the connection without sending this message. +- **410**: when this error happens, caches and links to the resource should be removed. The HTTP specification describes this code for "limited promotional services", and an API should not use it to say which resources were removed. +- **426**: the server sends an `Upgrade` header in the response to name the protocols it requires. +- **429**: the client must wait until the time in the `X-Ratelimit-Reset` header before it tries again. +- **501**: the only methods a server must support are `GET` and `HEAD`, so a server does not return this code for them. +- **503**: send a page that explains the problem with this response. The code is for temporary conditions, and the `Retry-After` header should carry the estimated time to recover the service. Take care with the cache headers sent with this response, because a temporary condition should not normally be cached. + +--- + +## Related resources + + + + The API v4 model that replaces Error Responses, and the path a response takes through a custom page set. + Every Custom Pages field, and the Error Responses field that each one replaces. + Replace the error responses of several status codes at once, each page with its own cache time. + Create your first Application, the first step before you customize its error pages. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/glossary.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/glossary.mdx new file mode 100644 index 0000000000..4237b45d95 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/glossary.mdx @@ -0,0 +1,15 @@ +--- +title: Glossary +description: Look up what Custom Pages, custom page set, and custom page mean in the pages that document Custom Pages. +meta_tags: 'custom pages, glossary, terms, custom page, custom page set, error pages, status codes' +namespace: documentation_products_custom_pages_glossary +permalink: /documentation/platform/custom-pages/glossary/ +--- + +Definitions for the terms the **Custom Pages** documentation uses. + +| Term | Definition | +| --- | --- | +| custom page | One entry of a custom page set: the page Azion serves in place of a response with a 4xx or 5xx status code from a [Connector](/en/documentation/platform/connectors/), selected by the status code of the page. With a `page_connector` page, Azion fetches the document at `uri` from the page's Connector, caches it for `ttl`, and answers with `custom_status_code` when one is set, so the client is served in place and not redirected. [Custom page settings](/en/documentation/platform/custom-pages/settings/) documents every field. | +| custom page set | The named list that groups custom pages, at least one per set, served in the API at `/v4/workspace/custom_pages`. Azion Console calls it a custom page, on the **Create Custom Page** page. A [Workload](/en/documentation/platform/workloads/) uses a custom page set only once that Workload's [deployment](/en/documentation/platform/workloads/settings/#deployment) sets that custom page set, as the [Custom Pages quickstart](/en/documentation/platform/custom-pages/quickstart/) shows. | +| Custom Pages | A Platform Resource that replaces the error response returned by a Connector with a page of your own, one page per error status code, through the custom page set that a Workload's deployment sets. It replaces the [Error Responses](/en/documentation/platform/custom-pages/error-responses/) of an [Application](/en/documentation/platform/applications/) on API v3. [Custom Pages](/en/documentation/platform/custom-pages/) describes it. | diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/how-it-works.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/how-it-works.mdx new file mode 100644 index 0000000000..3d407e1e29 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/how-it-works.mdx @@ -0,0 +1,78 @@ +--- +title: How Custom Pages works +description: Follow how a custom page set replaces the error response of a Connector with your own page, and which status codes get Azion's default page. +meta_tags: 'custom pages, how it works, error page, error response, status codes, page connector, connector, ttl, custom status code, deployment, workloads' +namespace: documentation_products_custom_pages_how_it_works +permalink: /documentation/platform/custom-pages/how-it-works/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +When an origin cannot find a resource, or does not respond in time, the client receives an error response, such as `404` or `504`. A custom page replaces that response with content you choose. + +[Custom Pages](/en/documentation/platform/custom-pages/) is a Platform Resource that replaces the error response returned by a [Connector](/en/documentation/platform/connectors/) with a page of your own, one page per error status code. On API v4, Custom Pages takes the place of Error Responses, the error page settings of an Application on API v3. For an Application that still runs on API v3, refer to [Error Responses](/en/documentation/platform/custom-pages/error-responses/). + +This page covers the mechanisms rather than the fields: every field is on [Custom page settings](/en/documentation/platform/custom-pages/settings/), and every bound is on [Custom Pages limits](/en/documentation/platform/custom-pages/limits/). For the path of a request through Custom Pages, with a diagram, refer to [Request path](/en/documentation/platform/custom-pages/#request-path). The sections cover, in order, error responses, custom pages and custom page sets, page content from a Connector, the status codes a page can replace, Azion's default error page, and the deployment. + +--- + +## Error responses + +An error response carries a status code that says the request failed: a client error (4xx) or a server error (5xx). On Azion, the Application sends a request to the origin through a Connector, and the Connector answers with a status code. A custom page acts after the Application receives that response, and the status code decides whether a page applies. + +--- + +## Custom pages and custom page sets + +A custom page replaces the error response for one status code, and a custom page set is the named list that groups those pages. When the Connector answers with a status code, Azion looks for a page with that code in the custom page set that the [Workload](/en/documentation/platform/workloads/)'s deployment sets. Each page acts only on the status code it lists, such as `"404"`, so a set holds one page for each code it replaces. + +When a page matches, the client receives the page's content in place of the response. The response carries no redirect and no `Location` header, so the browser stays on the URL it requested. A set holds at least one page, as [Custom Pages limits](/en/documentation/platform/custom-pages/limits/) states. + +--- + +## Page content from a Connector + +A page of the `page_connector` type sets a Connector and the path of the page's content on that Connector. Azion fetches the content from the page's Connector at the page's `uri`. The page's `ttl` sets the cache time of that content. A page can also set `custom_status_code`, the status code the client receives instead of the original one. + +For example, your origin answers a deleted product page with `404`. A page for the code `404` then serves the document at its `uri`, such as `/myerrors/404.html`, still with status `404`, and the browser shows your page. + +For the type and the default of each field, refer to [Page fields](/en/documentation/platform/custom-pages/settings/#page-fields). + +--- + +## Status codes a page can replace + +A page can replace only a status code from a fixed list of 22 codes: 16 client errors (4xx) and six server errors (5xx). For each code in the list and what it means when the Connector returns it, refer to [Status codes](/en/documentation/platform/custom-pages/settings/#status-codes). + +--- + +## Azion's default error page + +When the custom page set has no page for a status code, the client receives the Connector's response unchanged. Eight codes are the exception: `400`, `401`, `403`, `406`, `500`, `502`, `503`, and `504` receive Azion's default error page instead. A page for one of those eight codes replaces Azion's default error page with yours. + +For example, a set that holds only a `404` page answers a `502` from the Connector with Azion's default error page, not with the origin's response. A Workload whose deployment sets no custom page set passes every response unchanged. + +--- + +## The deployment + +A [Workload](/en/documentation/platform/workloads/) uses a custom page set only once that Workload's deployment sets that custom page set. A Workload holds at most one deployment, so one custom page set covers every hostname of the Workload. For the deployment fields, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). + +Assigning a set is a change to the Workload's deployment, and that change propagates. It spreads across Azion's distributed infrastructure, data center by data center, over several minutes. Meanwhile, requests can receive the previous or the updated configuration, depending on the data center that answers. For that reason, Azion does not guarantee when an assigned set starts to serve, as [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation) explains. + +To set the custom page set in the deployment, refer to [Customize an error page](/en/documentation/guides/application-development/getting-started/customizing-error-response-page/#assign-the-set-in-the-workloads-deployment). + +--- + +## Related resources + + + + Every field of a custom page set and its pages, the 22 status codes a page can replace, and a request body to copy. + Create a custom page set, assign it in a Workload's deployment, and see a page replace your origin's 404. + Replace the error responses of several status codes at once, each page with its own cache time. + Find the cause when a custom page set is refused or an error page does not reach the client. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/limits.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/limits.mdx new file mode 100644 index 0000000000..c5de5bab5b --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/limits.mdx @@ -0,0 +1,49 @@ +--- +title: Custom Pages limits +description: Check the scope of Custom Pages and the bounds of a custom page set and its pages, from the minimum page count to the range of each field. +meta_tags: 'custom pages, limits, scope, custom page set, pages, name, ttl, uri, custom status code, error page' +namespace: documentation_products_custom_pages_limits +permalink: /documentation/platform/custom-pages/limits/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +[Custom Pages](/en/documentation/platform/custom-pages/) is a Platform Resource that replaces the error response returned by a [Connector](/en/documentation/platform/connectors/) with a page of your own, one page per error status code. A custom page set is the named list that groups those pages. This page states where Custom Pages acts and the bounds Azion applies to a set and to each page in it. + +--- + +## Scope + +- **Status codes**: a page can replace only a status code from the 22 in [Status codes](/en/documentation/platform/custom-pages/settings/#status-codes), 16 client errors (4xx) and six server errors (5xx). +- **Workloads**: a [Workload](/en/documentation/platform/workloads/) uses a custom page set only once that Workload's deployment sets that custom page set. A Workload holds at most one deployment, so one set covers every hostname of the Workload. For the deployment fields, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). +- **Timing**: an assigned set serves only after the change to the deployment propagates, over several minutes, and Azion does not guarantee when. Repeat the request until the page answers, as [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation) explains. +- **API v3**: Custom Pages is the API v4 model for error pages. An Application that still runs on API v3 sets its error pages in [Error Responses](/en/documentation/platform/custom-pages/error-responses/), whose fields map to Custom Pages fields in [Interfaces](/en/documentation/platform/custom-pages/settings/#interfaces). + +--- + +## Default limits + +This table states the page count of a custom page set and what happens to a set below it. + +| Scope | Limit | Past the limit | +| --- | --- | --- | +| Pages per custom page set | At least 1 | The set is refused. | + +The API refuses an empty set with `Ensure this field has at least 1 elements.` Azion CLI prints that message inside `Error: Failed to create Custom Page: [...]`, and Azion Console shows `You must have at least one custom page code`. + +Four further bounds apply: a set `name` takes 1 to 255 characters, a page `ttl` takes 0 to 31,536,000 seconds, a page `uri` takes 1 to 250 characters, and a page `custom_status_code` takes 100 to 599. For the fields these bounds apply to, refer to [Custom page settings](/en/documentation/platform/custom-pages/settings/). + +--- + +## Related resources + + + + The fields of a custom page set and its pages, with the type, the default, and the values each bound on this page applies to. + How a page replaces an error response, and which status codes receive Azion's default error page. + The fix for a custom page set refused with no page, and for an error page that does not appear. + The deployment fields that set the Application, the Firewall, and the custom page set of a Workload. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/overview.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/overview.mdx new file mode 100644 index 0000000000..e6c1bba88e --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/overview.mdx @@ -0,0 +1,66 @@ +--- +title: Custom Pages +description: Replace the error responses your origin returns with pages of your own, one page per status code, served through a Workload's deployment. +meta_tags: 'custom pages, custom page set, error pages, status codes, 404, connector, deployment, workloads' +namespace: documentation_products_custom_pages +permalink: /documentation/platform/custom-pages/ +--- + +import DocButton from '~/components/webkit/DocButton.vue' +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' +import VersionRollingOut from '~/includes/snippets/versionRollingOut/en/snippet.mdx' + +[Error Responses](/en/documentation/platform/custom-pages/error-responses/) + +**Custom Pages** is a Platform Resource that replaces the error response a [Connector](/en/documentation/platform/connectors/) returns with a page of your own, on Azion's distributed infrastructure. A custom error page is a document a site serves in place of a server's default error response for one status code, such as `404`. Use Custom Pages to show your own page for a missing resource or a timed-out origin, set its cache time, or change its status code. Also use [Custom page settings](/en/documentation/platform/custom-pages/settings/) to look up the fields of a set, its pages, and the status codes a page replaces. + + + + +## Request path + +Creating a custom page set changes no response: a [Workload](/en/documentation/platform/workloads/) uses a custom page set only once that Workload's deployment sets that custom page set. + +This diagram follows a response from the Connector's status code to what the client receives. Solid arrows carry requests, and dotted arrows carry responses. Each label starts with the number of the step it belongs to. + +```mermaid +%%{init: {"layout": "elk", "elk": {"preset": "modelOrder", "keepEntryNodeOnTop": true}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% +flowchart TD + Client(["Client"]) + WL["Workload"] + App["Application"] + Conn["Connector"] + Origin[["origin"]] + Set["custom page set"] + PConn["page's Connector"] + Client -->|"1. request"| WL + WL -->|"1. request"| App + App -->|"1. request"| Conn + Conn -->|"1. request"| Origin + Origin -.->|"1. status code"| Conn + Conn -.->|"2. look up the code"| Set + Set -.->|"2. no page: response unchanged"| Client + Set -.->|"2. no page, listed code: default page"| Client + Set -->|"3. page found: fetch uri"| PConn + PConn -.->|"3. content"| Set + Set -.->|"4. page in place, no redirect"| Client +``` + +1. The Workload forwards the request to the [Application](/en/documentation/platform/applications/) that its deployment sets. The Application sends the request to the origin through a Connector, and the Connector answers with a status code. +2. Azion looks for a page with that code in the custom page set that the deployment sets. When the set has no page for the code, the client receives the Connector's response unchanged, except for the status codes `400`, `401`, `403`, `406`, `500`, `502`, `503`, and `504`, which receive Azion's default error page. +3. When a page matches, Azion fetches its content from the page's Connector at the page's `uri`. The page's `ttl` sets its cache time. +4. The client receives that content in place, with no redirect and no `Location` header. The status is the page's `custom_status_code`, when one is set. + +--- + +## Next steps + + + + + + + + + diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/quickstart.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/quickstart.mdx index e960fc73b3..dcc91830c7 100644 --- a/apps/docs/src/content/docs/en/pages/secure/custom-pages/quickstart.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/quickstart.mdx @@ -3,7 +3,7 @@ title: Custom Pages quickstart description: Create a custom page set that replaces your origin's 404 with a page of your own, assign it in the Workload's deployment, and see it served. meta_tags: 'custom pages, quickstart, error page, 404, connector, deployment, workloads' namespace: documentation_products_custom_pages_quickstart -permalink: /documentation/platform/workloads/custom-pages/quickstart/ +permalink: /documentation/platform/custom-pages/quickstart/ --- import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' @@ -12,7 +12,7 @@ import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' import Code from '~/components/webkit/CodeBlock.vue' -This guide instructs you through replacing the `404` your origin returns with your first page from [Custom Pages](/en/documentation/platform/workloads/#custom-pages). +This guide instructs you through replacing the `404` your origin returns with your first page from [Custom Pages](/en/documentation/platform/custom-pages/). - Create a custom page set with one page for status code `404`. - Assign the set in the deployment of your [Workload](/en/documentation/platform/workloads/). @@ -25,7 +25,9 @@ Four elements take part, and each one leads to the next: 3. The **deployment** of the Workload sets the custom page set, next to the Application it already sets. 4. The **request** reaches a path that the Connector your Application uses answers with `404`, and the custom page set replaces that response. -A Workload uses a custom page set only once that Workload's deployment sets that custom page set. Then, when the Connector your Application uses answers `404`, the visitor receives the content of your page in place of that response. The response carries no redirect, and its status code is the one the page sets. This guide covers Azion Console and the API, and you assign the set in Azion Console. The Azion CLI has no command that updates a deployment, and the published API v4 reference has no endpoint for one. +A Workload uses a custom page set only once that Workload's deployment sets that custom page set. Then, when the Connector your Application uses answers `404`, the client receives the content of your page in place of that response. The response carries no redirect, and its status code is the one the page sets. + +This guide covers Azion Console and the API, and you assign the set in Azion Console. The Azion CLI has no command that updates a deployment, and the published API v4 reference has no endpoint for one. --- @@ -207,7 +209,7 @@ The published Azion API v4 reference has no endpoint for the deployment of a Wor The check is the same whichever interface assigned the set. In the command, replace `` with the workload domain of your Workload, of the form `.map.azionedge.net`. Replace `` with the path that the Connector your Application uses answers with `404`. -An assigned set does not serve at once. The change to the deployment spreads across Azion's distributed infrastructure, and that takes several minutes, with no guaranteed duration. While it spreads, a request can receive either your origin's `404` or your page. Repeat the request until your page answers. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). +An assigned set does not serve at once. The change to the deployment spreads across Azion's distributed infrastructure, and that takes several minutes, with no guaranteed duration. While it spreads, a request can receive either your origin's `404` or your page. Repeat the request until your page answers, as [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation) explains. Send a request to the missing path and print the response headers with the body: @@ -234,8 +236,8 @@ The response carries no `Location` header, so the client is not redirected. Your ## Next steps - + - + diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/custom-pages/custom-pages.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/settings.mdx similarity index 75% rename from apps/docs/src/content/docs/en/pages/main-menu/reference/secure/custom-pages/custom-pages.mdx rename to apps/docs/src/content/docs/en/pages/secure/custom-pages/settings.mdx index e7c18a2efd..6ae01013b8 100644 --- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/custom-pages/custom-pages.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/settings.mdx @@ -3,7 +3,7 @@ title: Custom page settings description: Look up the fields of a custom page set, the status codes it can replace, and how each page sets its Connector, status, and cache time. meta_tags: 'custom pages, error pages, status codes, connector, ttl, workloads, deployment' namespace: documentation_secure_custom_pages -permalink: /documentation/platform/workloads/custom-pages/settings/ +permalink: /documentation/platform/custom-pages/settings/ --- import FrameBox from '@aziontech/webkit/frame-box' @@ -11,9 +11,9 @@ import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' import VersionRollingOut from '~/includes/snippets/versionRollingOut/en/snippet.mdx' -[Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/) +[Error Responses](/en/documentation/platform/custom-pages/error-responses/) -[Custom Pages](/en/documentation/platform/workloads/#custom-pages) is a Platform Resource that replaces the error response returned by a [Connector](/en/documentation/platform/connectors/) with a page of your own, one page per error status code. A custom page set is the named list that groups those pages. Azion fetches the content of each page from a Connector, and each page sets its cache time. A page can also answer with a different status code. A [Workload](/en/documentation/platform/workloads/) uses a custom page set only once that Workload's deployment sets that custom page set. For the deployment fields, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). +[Custom Pages](/en/documentation/platform/custom-pages/) is a Platform Resource that replaces the error response returned by a [Connector](/en/documentation/platform/connectors/) with a page of your own, one page per error status code. A custom page set is the named list that groups those pages. A [Workload](/en/documentation/platform/workloads/) uses a custom page set only once that Workload's deployment sets that custom page set. For the deployment fields, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). --- @@ -29,7 +29,7 @@ Three interfaces write a custom page set, and a Workload's deployment sets it. T The CLI reads every field of the set from the JSON file of `--file`. In Azion Console, you assign a set in the **Custom Page** field of the Workload's **Deployment Settings** section. -Assigning a set is a change to the Workload's deployment, and that change propagates. It spreads across Azion's distributed infrastructure, data center by data center, over several minutes. Meanwhile, requests can receive the previous or the updated configuration, depending on the data center that answers. For that reason, Azion does not guarantee when an assigned set starts to serve. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). +Assigning a set is a change to the Workload's deployment, and that change reaches the data centers over several minutes, with no guaranteed time. For more information, refer to [How Custom Pages works](/en/documentation/platform/custom-pages/how-it-works/#the-deployment) and [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). On API v4, **Custom Pages** takes the place of Error Responses, the error page settings of an Application on API v3. Each v3 field has a v4 counterpart: @@ -40,7 +40,7 @@ On API v4, **Custom Pages** takes the place of Error Responses, the error page s | URI | **Page Path (URI)**, `uri` | | Custom Status Code | **Response Custom Status Code**, `custom_status_code` | -The two models locate the page file differently. A v3 URI is appended to the Application's domain and fetched from the origin that the **Set Origin** field sets. A v4 `uri` is fetched from the Connector of the page. For an Application that still runs on API v3, refer to [Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/). +The two models locate the page file differently. A v3 URI is appended to the Application's domain and fetched from the origin that the **Set Origin** field sets. A v4 `uri` is fetched from the Connector of the page. For an Application that still runs on API v3, refer to [Error Responses](/en/documentation/platform/custom-pages/error-responses/). --- @@ -80,13 +80,13 @@ Each entry of `pages` assigns one page to one status code. A page of the `page_c | **Page Path (URI)** | `page.attributes.uri` | string, or `null` | 1 to 250 characters | none | | **Response Custom Status Code** | `page.attributes.custom_status_code` | integer, or `null` | 100 to 599 | none | -A page acts on the status code that a Connector returns to Azion. When that code has a page in the set, the visitor receives the page's content in place of the response, with no redirect. Azion Console offers two page types, _Page Connector_ and _Page Default_. With _Page Default_, the Console shows the **Content Type** and **Response** fields instead of the Connector fields, and the API has no documented shape for that type. +A page acts on the status code that a Connector returns to Azion. When that code has a page in the set, the client receives the page's content in place of the response, with no redirect. Azion Console offers two page types, _Page Connector_ and _Page Default_. With _Page Default_, the Console shows the **Content Type** and **Response** fields instead of the Connector fields, and the API has no documented shape for that type. `page.attributes.uri` is the path from which the page's Connector delivers the content. For example, with the path `/myerrors/505.html` and a Connector whose address is `myconnector.azion.com`, Azion fetches and delivers the content from `myconnector.azion.com/myerrors/505.html`. `page.attributes.ttl` sets the time to live (TTL) of the error page: its cache time, in seconds. For the expiration settings of an Application's own cache, refer to [Cache settings](/en/documentation/platform/applications/cache/cache-settings/#browser-cache). -`page.attributes.custom_status_code` is the status code the visitor receives instead of the original one. For example, a page with `code` set to `"403"` and `custom_status_code` set to `404` answers a `403` from the Connector with a `404`. +`page.attributes.custom_status_code` is the status code the client receives instead of the original one. For example, a page with `code` set to `"403"` and `custom_status_code` set to `404` answers a `403` from the Connector with a `404`. --- @@ -132,12 +132,27 @@ Six of the codes carry more detail: ## Request body -The JSON body below creates a set with one page. It replaces a `404` from the Connector with the document at the path `/html` on the page's Connector, and answers with status `404`. The same body works for `POST /v4/workspace/custom_pages` and for the file of `azion create custom-pages --file`: +A request body with one page creates a set that replaces a `404` from the Connector. The page serves the document at the path `/html` on its Connector, with status `404`. The same body works for `POST /v4/workspace/custom_pages` and for the file of `azion create custom-pages --file`: ```json -{"name": "my-custom-pages", "active": true, "pages": [ - {"code": "404", "page": {"type": "page_connector", "attributes": {"connector": , "ttl": 0, "uri": "/html", "custom_status_code": 404}}} -]} +{ + "name": "my-custom-pages", + "active": true, + "pages": [ + { + "code": "404", + "page": { + "type": "page_connector", + "attributes": { + "connector": , + "ttl": 0, + "uri": "/html", + "custom_status_code": 404 + } + } + } + ] +} ``` Send it with the CLI, with the body saved as `cp.json`: @@ -163,31 +178,31 @@ ID NAME ACTIVE LAST EDITOR LAST MODIFIED ```json { - "active": true, - "created_at": "2026-01-01T12:00:00.00000Z", - "id": , - "is_versioned": false, - "last_editor": "", - "last_modified": "2026-01-01T12:00:00.000000Z", - "name": "my-custom-pages", - "pages": [ - { - "code": "404", - "page": { - "attributes": { - "connector": , - "custom_status_code": 404, - "ttl": 0, - "uri": "/html" - }, - "type": "page_connector" - } - } - ], - "product_version": "1.0", - "version": null, - "version_id": null, - "version_state": null + "active": true, + "created_at": "2026-01-01T12:00:00.00000Z", + "id": , + "is_versioned": false, + "last_editor": "", + "last_modified": "2026-01-01T12:00:00.000000Z", + "name": "my-custom-pages", + "pages": [ + { + "code": "404", + "page": { + "attributes": { + "connector": , + "custom_status_code": 404, + "ttl": 0, + "uri": "/html" + }, + "type": "page_connector" + } + } + ], + "product_version": "1.0", + "version": null, + "version_id": null, + "version_state": null } ``` @@ -230,9 +245,9 @@ The API refuses a set with an empty `pages` list, and the Console refuses to sav - Create a custom page set, assign it in a Workload's deployment, and see a page replace an error. - Every field of a Workload and of its deployment, which sets the Application, the Firewall, and the custom page set. - The error page settings of an Application on API v3, for accounts that still run on API v3. - The path a request follows from a domain through the Workload to the Application and the Connector. + How a page replaces an error response, which codes receive Azion's default error page, and how an assigned set propagates. + Replace the error responses of several status codes at once, each page with its own cache time. + The scope of Custom Pages, the minimum page count of a set, and the range of each field on this page. + The fix for a set refused with no page, and for an error page that does not reach the client. diff --git a/apps/docs/src/content/docs/en/pages/secure/custom-pages/troubleshooting.mdx b/apps/docs/src/content/docs/en/pages/secure/custom-pages/troubleshooting.mdx new file mode 100644 index 0000000000..e450ea34b7 --- /dev/null +++ b/apps/docs/src/content/docs/en/pages/secure/custom-pages/troubleshooting.mdx @@ -0,0 +1,53 @@ +--- +title: Troubleshoot Custom Pages +description: Fix a custom page set that is refused for having no page, and an error page that does not replace the error response of a Connector. +meta_tags: 'custom pages, troubleshooting, error page, custom page set, ensure this field has at least 1 elements, deployment, connector, propagation, errors' +namespace: documentation_products_custom_pages_troubleshooting +permalink: /documentation/platform/custom-pages/troubleshooting/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +This page covers two symptoms of [Custom Pages](/en/documentation/platform/custom-pages/): a custom page set that is refused, and an error page that does not reach the client. Custom Pages is a Platform Resource that replaces the error response returned by a Connector with a page of your own, and the pages sit in a custom page set. For where Custom Pages acts on a request, refer to [Request path](/en/documentation/platform/custom-pages/#request-path). A quoted refusal is the API's message, unless the entry names another source. + +--- + +## A custom page set is refused with Ensure this field has at least 1 elements + +Creating a custom page set fails with `Ensure this field has at least 1 elements.`, or Azion Console refuses to save it with `You must have at least one custom page code`. Azion CLI prints the API message inside `Error: Failed to create Custom Page: [...]`. + +A custom page set holds at least one page, and the request sent `"pages": []`, as the errors on [Custom page settings](/en/documentation/platform/custom-pages/settings/#errors) show. In Azion Console, the **Page Codes** table had no row. + +- **Add a page to `pages`**: one page replaces one error status code with content from a Connector, as the body in [Request body](/en/documentation/platform/custom-pages/settings/#request-body) shows. +- **Add a page code in Azion Console**: the **Page Codes** table needs one row before you save the set. + +Azion CLI then prints `Created Custom Page with ID `. + +--- + +## An error page does not appear + +The Connector's error response reaches the client unchanged, even though a custom page set holds a page for its status code. + +A Workload uses a custom page set only once that Workload's deployment sets that custom page set. A page also acts only on the status code it lists, and a change to the deployment takes several minutes to propagate. + +- **Set the custom page set in the deployment**: in Azion Console, select it in the **Custom Page** field of **Deployment Settings**, or pass `--custom-page` to `azion create workload-deployment` when you create the deployment. The Azion CLI has no command that updates a deployment. For the steps, refer to [Customize an error page](/en/documentation/guides/application-development/getting-started/customizing-error-response-page/#assign-the-set-in-the-workloads-deployment). +- **Check the status code the Connector returns**: compare it with the `code` of each page in the set, such as `"404"`. +- **Wait for the change to propagate**: Azion does not guarantee a duration, so repeat the request until the page answers. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). + +The client then receives the page's content in place, with the page's `custom_status_code` when one is set, and no `Location` header. + +--- + +## Related resources + + + + Every field of a custom page set and its pages, with the refusals the API and Azion Console return and what to do about each. + How a page replaces an error response once the deployment sets the set, which most fixes here lean on. + Create a set with a page for each code and assign it in the Workload's deployment, from Azion Console, the CLI, or the API. + The minimum page count of a set and the range of each field of a page. + + diff --git a/apps/docs/src/content/docs/en/pages/secure/firewall/glossary.mdx b/apps/docs/src/content/docs/en/pages/secure/firewall/glossary.mdx index fb3b1e90fc..677841c856 100644 --- a/apps/docs/src/content/docs/en/pages/secure/firewall/glossary.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/firewall/glossary.mdx @@ -32,7 +32,7 @@ permalink: /documentation/platform/firewall/glossary/ | countries list | A network list of type `countries`, _Countries_ in Azion Console, that matches a request by the country Azion resolves from its client IP address. The API takes two-letter uppercase ISO 3166-1 alpha-2 codes such as `DE`, and the Console form selects countries by name. A blocklist of this type blocks requests by country, the task known as geoblocking; [Network Lists](/en/documentation/platform/firewall/network-shield/network-lists/#list-types) compares the three types. | | criterion | One condition a rule tests: a variable such as `${request_uri}`, a comparison operator, and an argument when the operator takes one. Some variables need a Product: `${network}` needs Network Shield, and the seven header variables, `${request_args}`, and `${request_method}` need WAF. [Rules Engine for Firewall](/en/documentation/platform/firewall/rules-engine/#criteria) lists every variable and how criteria combine with `and` and `or`. | | Custom Allowed Rules | A retired name for WAF exceptions that appears in no Azion interface. The Azion Console tab reads **Allowed Rules**, and the API and the CLI call the object an exception. | -| DDoS Protection | The mitigation of distributed denial-of-service (DDoS) attacks that every firewall runs, shown in the **Modules** section as **DDoS Protection Unmetered** and tagged **Automatically enabled in all accounts**. Its switch cannot be turned off, and the API reports `modules.ddos_protection.enabled` as `true`. [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) documents it. | +| DDoS Protection | The mitigation of distributed denial-of-service (DDoS) attacks that every firewall runs, shown in the **Modules** section as **DDoS Protection Unmetered** and tagged **Automatically enabled in all accounts**. Its switch cannot be turned off, and the API reports `modules.ddos_protection.enabled` as `true`. [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) documents it. | | Debug Rules | The **Main Settings** section that logs the Rules Engine rules each request ran, `debug` in the API and off when you create a firewall. With its **Active** switch on, executed rules appear in the `$traceback` field in [Data Stream](/en/documentation/platform/data-stream/) and [Real-Time Events](/en/documentation/platform/real-time-events/), and in the `stacktrace` field of the [Real-Time Events GraphQL API](/en/documentation/devtools/graphql/gql-real-time-events-fields/). [Debug rules created with Rules Engine](/en/documentation/guides/application-development/getting-started/debug-rules/) shows how to read them. | | does not match | The Azion Console label of the comparison operator that is true when a value does not match a regular expression, or, on the Network criterion, when the client IP address has no match in the network list, where it sends `is_not_in_list`. With the `deny` behavior on the Network criterion, it turns the list into an allowlist. [Rules Engine for Firewall](/en/documentation/platform/firewall/rules-engine/#operators) lists the operators each variable takes. | | due date | The expiration date an item in an `ip_cidr` list can carry: `--LT` and a UTC date and time in `YYYY-MM-DDTHH:MM:SSZ` form, as in `192.0.2.2 --LT2030-01-01T00:00:00Z`. Azion checks it only when you write the list's items, so a past-dated item is dropped then, and an item whose date passes later keeps matching until you write the items again. The Console help calls it an expiration date, and [Network Lists](/en/documentation/platform/firewall/network-shield/network-lists/#item-annotations) documents its syntax. | diff --git a/apps/docs/src/content/docs/en/pages/secure/firewall/how-it-works.mdx b/apps/docs/src/content/docs/en/pages/secure/firewall/how-it-works.mdx index abc4fce7fc..c22b8a9cb1 100644 --- a/apps/docs/src/content/docs/en/pages/secure/firewall/how-it-works.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/firewall/how-it-works.mdx @@ -60,7 +60,7 @@ A firewall runs its rules in sequence until one of them blocks or restricts the Order therefore changes outcomes that the rules alone do not show. For example, a rule that rate-limits a login path never counts the requests an earlier rule denies, because those requests never reach it. -Rule order also sets the order in which the firewall's protections act on a request. [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) acts first: it assesses each request for a DoS or DDoS attack, and blocks or allows it, before any rule runs. WAF, Network Shield, Bot Manager, and functions have no fixed order of their own, because each acts only through a rule. Network Shield acts through a rule's _Network_ criterion, WAF through _Set WAF_, and Bot Manager and other functions through _Run Function_. They therefore act in the order of the rules that call them, and none of them acts on a request an earlier rule stopped. Inside one rule, _Set WAF_ and _Run Function_ run in the order the rule arranges them. +Rule order also sets the order in which the firewall's protections act on a request. [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) acts first: it assesses each request for a DoS or DDoS attack, and blocks or allows it, before any rule runs. WAF, Network Shield, Bot Manager, and functions have no fixed order of their own, because each acts only through a rule. Network Shield acts through a rule's _Network_ criterion, WAF through _Set WAF_, and Bot Manager and other functions through _Run Function_. They therefore act in the order of the rules that call them, and none of them acts on a request an earlier rule stopped. Inside one rule, _Set WAF_ and _Run Function_ run in the order the rule arranges them. A rule belongs to the firewall it was created on, and the API keeps it under that firewall's `/v4/workspace/firewalls//request_rules`. A rule therefore cannot be shared with another firewall. To start a firewall from the rules of another, clone it: the **Firewalls** list in Azion Console offers **Clone** on each row. The API describes a clone as a deep copy of the firewall, its function instances and its Rules Engine rules included. @@ -127,7 +127,7 @@ A new firewall starts with three of them on. A firewall created through the API The **Create Firewall** page in Azion Console starts with the same switches on. A firewall created from a Console drawer instead of that page starts with **Functions** off, so check that switch before you rely on _Run Function_. -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is always on. Its switch carries the tag **Automatically enabled in all accounts** and cannot be turned off, and the API treats `ddos_protection` as read-only. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) is always on. Its switch carries the tag **Automatically enabled in all accounts** and cannot be turned off, and the API treats `ddos_protection` as read-only. Each of the other three gates what a rule can use. A gated option stays visible in the Rules Engine form while its Product is off, disabled and relabeled with the Product it needs: diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/best-practices.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/best-practices.mdx index 2041aafd1d..8aaef07892 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/best-practices.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/best-practices.mdx @@ -1,7 +1,7 @@ --- title: Workloads best practices -description: Test changes on a staging Workload, close the default address Azion generates once your domain serves traffic, and replace certificates without downtime. -meta_tags: 'workloads, best practices, staging, workload domain, mtls, sni, certificate manager, certificate replacement, lets encrypt' +description: Test changes on a staging Workload, close the default address Azion generates once your domain serves traffic, and keep mTLS strict in production. +meta_tags: 'workloads, best practices, staging, workload domain, mtls, permissive, enforce, sni' namespace: documentation_products_workloads_best_practices permalink: /documentation/platform/workloads/best-practices/ --- @@ -10,19 +10,21 @@ import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' import Code from '~/components/webkit/CodeBlock.vue' -The entry point of a site decides who can reach it and whether a connection is trusted. Mistakes there rarely surface as an error in your code. A change tried on live traffic reaches every visitor at once. An address you forgot stays open to anyone who finds it. A certificate that expires stops protecting traffic on the day it lapses. +The entry point of a site decides who can reach it and whether a connection is trusted. Mistakes there rarely surface as an error in your code: a change tried on live traffic reaches every visitor at once, and an address you forgot stays open to anyone who finds it. -These practices apply to a [Workload](/en/documentation/platform/workloads/), the hostnames and Transport Layer Security (TLS) settings it holds, and the certificates it uses. The mechanisms behind them are on [How Workloads works](/en/documentation/platform/workloads/how-it-works/), and every field is on [Workload settings](/en/documentation/platform/workloads/settings/). +These practices apply to a [Workload](/en/documentation/platform/workloads/) and the hostnames and Transport Layer Security (TLS) settings it holds. The practices for the certificates a Workload uses are on [Certificate Manager best practices](/en/documentation/platform/certificate-manager/best-practices/). The mechanisms behind these practices are on [How Workloads works](/en/documentation/platform/workloads/how-it-works/), and every field is on [Workload settings](/en/documentation/platform/workloads/settings/). A change to a Workload takes several minutes to reach all of Azion's distributed infrastructure, with no guaranteed duration. Meanwhile, requests can receive the old or the new configuration, as [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation) describes. Every check on this page holds only once repeated requests agree. -The first four practices apply to every Workload: test a change on a staging Workload before production, close the workload domain once your own domain serves traffic, use permissive mutual TLS (mTLS) only to test, and make sure every client application sends Server Name Indication (SNI). The practices for the certificates a Workload uses follow, under Certificate Manager. +The practices, in order: test a change on a staging Workload before production, close the workload domain once your own domain serves traffic, use permissive mutual TLS (mTLS) only to test, and make sure every client application sends Server Name Indication (SNI). --- ## Test a change on a staging Workload before production -A staging Workload is a Workload created on the staging infrastructure, with `infrastructure` set to `2` in the API. It runs on the staging network, apart from the production network, so a mistake there reaches no visitor of your site. It answers only on its workload domain, `.preview.azionedge.net`, because a staging Workload takes no custom domain. The cost is a second Workload with its own deployment, which you keep in step with production yourself. The infrastructure is fixed at creation, so a tested configuration reaches production as a new Workload, not as an edit of the staging one. For the same choice in Azion Console, refer to [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure). +A staging Workload is a Workload created on the staging infrastructure, with `infrastructure` set to `2` in the API. It runs on the staging network, apart from the production network, so a mistake there reaches no visitor of your site. It answers only on its workload domain, `.preview.azionedge.net`, because a staging Workload takes no custom domain. + +The cost is a second Workload with its own deployment, which you keep in step with production yourself. The infrastructure is fixed at creation, so a tested configuration reaches production as a new Workload, not as an edit of the staging one. For the same choice in Azion Console, refer to [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure). This file, sent with `azion create workload --file`, creates a staging Workload through `"infrastructure": 2`. Its other values are the defaults of a production Workload. Copy the values of your own production Workload instead, so that staging tests the same configuration. @@ -61,7 +63,9 @@ The CLI answers `Updated Workload with ID `. Once the change propag ## Use permissive mTLS only to test -Mutual TLS ([mTLS](/en/documentation/platform/workloads/mtls/)) is a TLS handshake in which the client also presents a certificate. The Workload then checks that a certificate authority (CA) you trust signed that certificate. In `enforce` mode, a client without such a certificate fails the handshake. In `permissive` mode, the handshake completes, so a Firewall rule that tests the Client Certificate Validation variable must refuse the client. Without that rule, a permissive Workload admits the clients that mTLS was meant to refuse. +Mutual TLS ([mTLS](/en/documentation/platform/workloads/mtls/)) is a TLS handshake in which the client also presents a certificate. The Workload then checks that a certificate authority (CA) you trust signed that certificate. + +In `enforce` mode, a client without such a certificate fails the handshake. In `permissive` mode, the handshake completes, so a Firewall rule that tests the Client Certificate Validation variable must refuse the client. Without that rule, a permissive Workload admits the clients that mTLS was meant to refuse. Use `permissive` to test access under specific conditions, and serve production with `enforce`, as in this body for `azion update workload --file`: @@ -83,57 +87,11 @@ For the Firewall rule a permissive Workload needs, refer to [Verification modes] ## Make sure every client application sends SNI -Server Name Indication (SNI) is the TLS extension in which a client names the host it wants during the handshake. Every domain served with a certificate bound to the Workload, uploaded or from Let's Encrypt, relies on it. A connection without SNI reaches Azion's default configuration, which presents the Azion SAN certificate instead of yours. That is Azion's own certificate, with Azion hostnames listed as Subject Alternative Names (SAN), such as `*.map.azionedge.net` and `*.azion.app`. On a Workload with mTLS in `enforce` mode, Azion closes such a connection before it reaches your application, and the client receives no response. - -The setting lives in each client, such as a partner's API client or a service that calls your Workload, so Azion cannot add it for them. Confirm with the owner of every client application that its TLS library sends the hostname it calls as the server name. If a client with a valid certificate never reaches your application, check first whether it sends SNI. For the rest of the mTLS requirements, refer to [mTLS](/en/documentation/platform/workloads/mtls/#requirements). - ---- - -## Certificate Manager - -[Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) is a Platform Resource that stores the certificates a Workload uses for TLS. It stores the server certificates that Workloads present to clients and the Trusted CA certificates that verify client certificates in mTLS. It also requests and renews Let's Encrypt certificates. The practices in this section are to replace a server certificate before it expires, keep the challenge record of a domain hosted outside [Edge DNS](/en/documentation/platform/edge-dns/), choose a domain-validated certificate unless you need more, limit DNS-01 credentials to the challenge records, and keep wildcard certificates off critical production systems. - -### Replace a server certificate before it expires - -A server certificate you upload does not renew itself, and once its `validity` date passes, it no longer protects traffic. Switching while the old certificate is still valid leaves time to confirm that the new one works, and to switch back if it does not. The old entry stays in Certificate Manager after the switch, so the cost is one more certificate to delete. Azion renews the Let's Encrypt certificates it manages, as [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/) describes. - -Upload the new certificate, then point `tls.certificate` at its ID with `azion update workload --file`. Keep `ciphers` and `minimum_version` at the values the Workload already holds, so the certificate is the only value that changes: - -, - "tls": { "certificate": , "ciphers": 7, "minimum_version": "tls_1_3" } -}`} /> - -The CLI answers `Updated Workload with ID `. `azion list digital-certificate --details` then shows the new certificate as `active`, and the old one as `inactive` once no Workload uses it. When the new certificate is `active` and the change has propagated, delete the old entry. For the upload itself, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/). - -### Keep the challenge record of a domain hosted outside Edge DNS - -Azion renews a managed Let's Encrypt certificate before it expires by running its challenge again. When the zone of a DNS-01 certificate's domain is in [Edge DNS](/en/documentation/platform/edge-dns/), Azion writes the `_acme-challenge` record itself. When the zone is hosted at another DNS provider, you add a canonical name (CNAME) record, `_acme-challenge.`, that points to `.letsencrypt.azion.com`. Deleting that CNAME later makes the next renewal fail, and the certificate then expires. - -Keep the CNAME at your provider for as long as a Workload uses the certificate. Renewal starts 30 days before the 90-day validity ends. To check, confirm before then that the CNAME still exists, and that the certificate's status in Certificate Manager is not `failed`. For the record to create, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). - -### Choose a domain-validated certificate unless you need more - -The certificate authority that issues a certificate you upload validates the request at one of three levels. Domain Validation (DV) confirms your right to use the domain. Organization Validation (OV) adds checks on the requesting organization, and Extended Validation (EV) asks for documents that prove its physical, legal, and operational existence. +Server Name Indication (SNI) is the TLS extension in which a client names the host it wants during the handshake. Every domain served with a certificate bound to the Workload, uploaded or from Let's Encrypt, relies on it. A connection without SNI reaches Azion's default configuration, which presents the [Azion SAN certificate](/en/documentation/platform/certificate-manager/glossary/) instead of yours. That is Azion's own certificate, with Azion hostnames listed as Subject Alternative Names (SAN), such as `*.map.azionedge.net` and `*.azion.app`. -Use DV in most cases. OV and EV are more complex to obtain, and the extra checks buy assurance about your organization, not about the domain. Order OV or EV only when a requirement you can name asks for those checks. For the three levels, refer to [Validation levels](/en/documentation/platform/workloads/certificate-manager/certificates/#validation-levels). +On a Workload with mTLS in `enforce` mode, Azion closes such a connection before it reaches your application, and the client receives no response. -### Limit DNS-01 credentials to the challenge records - -This practice applies when you obtain a certificate yourself, with an Automatic Certificate Management Environment (ACME) client such as Certbot, for a zone hosted outside Edge DNS. A Let's Encrypt certificate that Azion manages needs none of it: the one CNAME of [Keep the challenge record of a domain hosted outside Edge DNS](#keep-the-challenge-record-of-a-domain-hosted-outside-edge-dns) is enough. Your client writes the `_acme-challenge` record at the DNS provider, so it holds the provider's API credentials. Credentials that reach every record give whoever obtains them control of the domain and all of its records. - -Restrict those credentials to `_acme-challenge` records, so that a leak exposes only the challenge. The cost is a separate credential to create and keep for that client alone. To check, confirm at your provider that the credential's permissions name only `_acme-challenge` records. - -### Keep wildcard certificates off critical production systems - -A wildcard certificate, such as one for `*.example.com`, covers the subdomains of `example.com`, such as `blog.example.com`, with one private key. If that key leaks, or the certificate is revoked, every subdomain it covers is affected at once. A wildcard certificate fits when: - -- Centralized management is a priority. -- The same team manages the subdomains. -- A well-defined reverse proxy architecture exists. -- Your security policies allow controlled key sharing. - -Under stricter requirements, give each critical production system its own certificate, keep separate certificates for development environments, and leave the wildcard to lower-criticality services. The cost is one replacement per certificate instead of one for all. Keep a wildcard's private key in Certificate Manager, bound to Workloads, rather than spread across servers: once saved, the key cannot be read back from Azion Console or the API. To check, list the Workloads that use each wildcard certificate with `GET /v4/workspace/workloads?digital_certificate_id=`, and give any critical production Workload a certificate of its own. +The setting lives in each client, such as a partner's API client or a service that calls your Workload, so Azion cannot add it for them. Confirm with the owner of every client application that its TLS library sends the hostname it calls as the server name. If a client with a valid certificate never reaches your application, check first whether it sends SNI. For the rest of the mTLS requirements, refer to [mTLS](/en/documentation/platform/workloads/mtls/#requirements). --- @@ -142,7 +100,7 @@ Under stricter requirements, give each critical production system its own certif Every field these practices change, from the infrastructure and domains to TLS and mTLS, with its type and default. - The certificate types, statuses, and validation levels behind the Certificate Manager practices. + Replace a server certificate before it expires, keep each renewal path working, and choose the right kind of certificate. What enforce and permissive mode do with each client, and the requirements a Workload must meet. Symptoms along the request path, with their causes and fixes, for when a practice was skipped. diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/glossary.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/glossary.mdx index e57a56d9ea..cdc88c319b 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/glossary.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/glossary.mdx @@ -1,39 +1,28 @@ --- title: Glossary -description: What Workload, workload domain, deployment, Azion custom domain, Trusted CA, CRL, custom page, and the other Workloads terms mean. -meta_tags: 'workloads, glossary, terms, workload domain, deployment, certificate manager, custom pages, ddos protection' +description: Look up what Workload, workload domain, deployment, Azion custom domain, enforce, permissive, and the other Workloads terms mean. +meta_tags: 'workloads, glossary, terms, workload domain, deployment, azion custom domain, mtls, ddos protection' namespace: documentation_products_workloads_glossary permalink: /documentation/platform/workloads/glossary/ --- -The terms in this glossary carry a meaning of their own in [Workloads](/en/documentation/platform/workloads/) and in what works on a Workload: [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager), [Custom Pages](/en/documentation/platform/workloads/#custom-pages), and [DDoS Protection](/en/documentation/platform/workloads/#ddos-protection). +Definitions for the terms the **Workloads** documentation uses. | Term | Definition | | --- | --- | -| Azion custom domain | The free `azion.app` hostname a Workload can answer on, set in Azion Console with the **Custom Domain** switch and the **Azion Custom Domain** field. The field takes a name such as `my-custom-name`, appends `.azion.app`, and stores the full hostname in `domains`, where a Workload holds at most one, a name another Workload holds is refused, and a staging Workload takes none. It is not the workload domain, and [Workload settings](/en/documentation/platform/workloads/settings/#domains) lists every rule it follows. | -| Azion SAN certificate | Azion's own TLS certificate, which lists the hostnames it covers as Subject Alternative Names (SAN). A Workload presents it on the workload domain, and on every hostname while `tls.certificate` is `null`, and it covers the workload domain and the Azion custom domain at no additional cost. To present a certificate for your own domain instead, refer to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). | -| Certificate Manager | A Platform Resource that stores the certificates a Workload uses for TLS, served in the API under `/v4/workspace/tls/` and listed in Azion Console on the **Certificate Manager** page. It holds server certificates you upload, Let's Encrypt certificates Azion requests and renews, Trusted CA certificates, certificate revocation lists, and CSRs. [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) describes what it does for a Workload, and the [Certificate Manager quickstart](/en/documentation/platform/workloads/certificate-manager/quickstart/) binds a first certificate. | -| certificate revocation list (CRL) | A list of client certificates revoked before their expiration date, signed by the certificate authority that issued them. You upload it to Certificate Manager and attach it to a Workload in `mtls.config.crl`, at most 100 per Workload, beside the Trusted CA certificate. [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/) documents its fields. | -| certificate signing request (CSR) | A request for a certificate that you create in Certificate Manager and submit to a certificate authority (CA). The **Common Name** (`common_name`) sets the domain the certificate covers, and the CSR creates a certificate entry with no certificate yet. Once the CA signs the certificate, you add the PEM-encoded certificate to that entry, and [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/) lists every field. | +| Azion custom domain | The free `azion.app` hostname a Workload can answer on, which Azion Console labels **Azion Custom Domain**. You pick a name such as `my-custom-name`, Azion appends `.azion.app`, and the full hostname is stored in `domains`, where a Workload holds at most one, a name another Workload holds is refused, and a staging Workload takes none. It is not the workload domain, and [Workload settings](/en/documentation/platform/workloads/settings/#domains) lists every rule it follows. | | cipher suite | One of eight named sets of [ciphers](https://www.azion.com/en/learning/) a Workload offers for TLS, chosen by number in `tls.ciphers`, from `1` (`TLSv1.2_2018`) to `8` (`Legacy_v2017Q1`). The default is `7` (`Modern_v2025Q1`), and the client and the Workload negotiate one cipher from the suite for each session. [Workload settings](/en/documentation/platform/workloads/settings/#cipher-suites) lists the ciphers of each suite. | -| custom domain | A domain you own, such as `www.example.com`, that a production Workload answers on in addition to its workload domain. You list it in `domains` and point it at the workload domain with a CNAME record at your DNS provider, as [Add a custom domain to a workload](/en/documentation/guides/platform/migration/configure-a-domain/) shows. In Azion Console, **Add Domain** in the **Domains** section adds it, while the **Custom Domain** switch turns on the Azion custom domain instead. | -| custom page | One entry of a custom page set: the response Azion serves in place of a 4xx or 5xx status code it receives from a [Connector](/en/documentation/platform/connectors/), selected by the status code of the page. A `page_connector` page fetches the document at `uri` from a Connector, sets its cache time in `ttl`, and answers with `custom_status_code` when one is set, so the client is served in place and not redirected. [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/) documents every field. | -| custom page set | The named list that groups custom pages, at least one per set, served in the API at `/v4/workspace/custom_pages`. Azion Console calls it a custom page, on the **Create Custom Page** page. A Workload uses a custom page set only once that Workload's deployment sets that custom page set, in the **Custom Page** field in Azion Console, as the [Custom Pages quickstart](/en/documentation/platform/workloads/custom-pages/quickstart/) shows. | -| Custom Pages | A Platform Resource that replaces the error response returned by a Connector with a page of your own, one page per error status code, through the custom page set that a Workload's deployment sets. It replaces the [Error Responses](/en/documentation/platform/workloads/custom-pages/error-responses/) of a v3 application. [Custom Pages](/en/documentation/platform/workloads/#custom-pages) describes it. | +| custom domain | A domain you own, such as `www.example.com`, that a production Workload answers on in addition to its workload domain. You list it in `domains` and point it at the workload domain with a CNAME record at your DNS provider, as [Add a custom domain to a workload](/en/documentation/guides/platform/migration/configure-a-domain/) shows. | | DDoS Protection | A Feature of the Azion Platform that mitigates [distributed denial-of-service (DDoS)](https://www.azion.com/en/learning/) attacks on every Workload. It is always on, and it needs no activation or configuration. [Attack mitigation](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) describes how the Platform mitigates an attack. | -| deployment | The part of a Workload that sets the [Application](/en/documentation/platform/applications/) that answers its requests and, optionally, a [Firewall](/en/documentation/platform/firewall/) and a custom page set. A Workload holds at most one deployment, and in Azion Console you edit it in the **Deployment Settings** section of the Workload. A second deployment is refused with `The maximum number of deployments allowed per workload is 1.`, as [Workload settings](/en/documentation/platform/workloads/settings/#deployment) documents. | -| digital certificate | The Azion Console and Azion CLI name for any certificate in Certificate Manager, from the **Digital Certificate** field of a Workload to the `azion create digital-certificate` command. Its `type` is `edge_certificate` for a server certificate or `trusted_ca_certificate` for a Trusted CA certificate, and a Let's Encrypt certificate is one Azion requests and renews. [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/) compares the kinds. | +| deployment | The part of a Workload that sets the [Application](/en/documentation/platform/applications/) that answers its requests and, optionally, a [Firewall](/en/documentation/platform/firewall/) and a [custom page set](/en/documentation/platform/custom-pages/glossary/). A Workload holds at most one deployment, and a second one is refused with `The maximum number of deployments allowed per workload is 1.`, as [Workload settings](/en/documentation/platform/workloads/settings/#deployment) documents. | | Domains | The v3 object that held an application's domains, its Azion domain, and its certificate, replaced on API v4 by the Workload and its deployment. [Domains](/en/documentation/platform/workloads/domains/) documents it for accounts that run API v3, and [API v4 Migration](/en/documentation/fundamentals/api-v4-migration/) maps one model onto the other. | -| enforce | The `mtls.config.verification` mode in which a Workload refuses the TLS handshake of a client that presents no certificate, or one that its Trusted CA certificate did not sign. A client whose certificate the Trusted CA signed is served. [mTLS](/en/documentation/platform/workloads/mtls/) compares it with permissive. | +| enforce | The `mtls.config.verification` mode in which a Workload refuses the TLS handshake of a client that presents no certificate, or one that its [Trusted CA certificate](/en/documentation/platform/certificate-manager/glossary/) did not sign. A client whose certificate the Trusted CA signed is served. [mTLS](/en/documentation/platform/workloads/mtls/) compares it with permissive. | | hostname | A fully qualified domain name a client requests, such as `www.example.com`. A Workload answers on its workload domain and on the hostnames in `domains`, where every entry must conform to RFC 1035, so a wildcard such as `*.azion.app` is refused with `The domain does not conform to the format defined in RFC 1035.` [Workload settings](/en/documentation/platform/workloads/settings/#domains) lists the other rules. | | infrastructure | The field of a Workload that picks the network serving it: `1`, the default, for the production network, for global availability, or `2` for the staging network, for testing with limited propagation. It sets the suffix of the workload domain, `.map.azionedge.net` on production and `.preview.azionedge.net` on staging, and a staging Workload takes no custom domain. The field is fixed at creation: an update that changes it returns `The infrastructure cannot be changed after Workload creation.` [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure) compares the two values. | -| Let's Encrypt certificate | A free TLS certificate signed by the Let's Encrypt certificate authority, which Azion requests and renews for you. Azion validates the domain with an HTTP-01 or DNS-01 challenge, and renewal starts 30 days before the 90-day validity ends. [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/) covers the challenges and the retry policy. | | minimum TLS version | The lowest TLS version a Workload accepts, set in `tls.minimum_version` to `tls_1_0`, `tls_1_1`, `tls_1_2`, or `tls_1_3`, the default. It is a floor, so a Workload set to `tls_1_2` can still serve a session over TLS 1.3. [Workload settings](/en/documentation/platform/workloads/settings/#tls) documents the TLS fields. | -| mTLS | Mutual TLS, in which the client also presents a certificate and the Workload checks it against a Trusted CA certificate. A Workload turns it on in its `mtls` object, with a verification mode of enforce or permissive and optional certificate revocation lists. [mTLS](/en/documentation/platform/workloads/mtls/) documents both modes, and the [Learning Center](https://www.azion.com/en/learning/) covers the generic protocol. | +| mTLS | Mutual TLS, in which the client also presents a certificate and the Workload checks it against a [Trusted CA certificate](/en/documentation/platform/certificate-manager/glossary/). A Workload turns it on in its `mtls` object, with a verification mode of enforce or permissive and optional certificate revocation lists. [mTLS](/en/documentation/platform/workloads/mtls/) documents both modes, and the [Learning Center](https://www.azion.com/en/learning/) covers the generic protocol. | | origin | The server a request's content comes from. A Workload sets no origin: its deployment sets an Application, and when a rule of that Application sets a [Connector](/en/documentation/platform/connectors/), that Connector routes the request to your origin. | -| permissive | The `mtls.config.verification` mode in which a Workload completes the TLS handshake with every client, with or without a certificate its Trusted CA certificate signed. The request continues to the Application, through the Firewall when the deployment sets one, and a rule of that Firewall on Client Certificate Validation can refuse it. [mTLS](/en/documentation/platform/workloads/mtls/) compares it with enforce. | -| Trusted CA certificate | The certificate of a certificate authority that you upload so a Workload can verify client certificates in mTLS, `trusted_ca_certificate` in the API and **Trusted CA Certificate** in Azion Console; the upload accepts intermediate certificates. A Workload sets it in `mtls.config.certificate`, and a server certificate there returns `Invalid certificate type, MUST be a Trusted CA.` To upload one, refer to [Configure mTLS on a workload](/en/documentation/guides/application-security/tls-and-certificates/associate-an-mtls-certificate/). | +| permissive | The `mtls.config.verification` mode in which a Workload completes the TLS handshake with every client, with or without a certificate its [Trusted CA certificate](/en/documentation/platform/certificate-manager/glossary/) signed. The request continues to the Application, through the Firewall when the deployment sets one, and a rule of that Firewall on Client Certificate Validation can refuse it. [mTLS](/en/documentation/platform/workloads/mtls/) compares it with enforce. | | Workload | The entity you create in Workloads: the entry point that receives the requests sent to your domains on Azion's distributed infrastructure. A Workload holds a workload domain that Azion generates, the domains you add, the TLS and mTLS settings, the ports and the HTTP versions it accepts, and the infrastructure it runs on. After it receives a request, the Workload forwards the request to the Application that this Workload's deployment sets. [Workloads](/en/documentation/platform/workloads/) describes the Platform Resource, and the [Workloads quickstart](/en/documentation/platform/workloads/quickstart/) creates one. | -| workload domain | The read-only hostname Azion assigns a Workload at creation, `workload_domain`: `.map.azionedge.net` on production and `.preview.azionedge.net` on staging. Clients reach the Workload on it while `workload_domain_allow_access` is `true`, and your custom domains point at it with a CNAME record, as [Point a domain to a workload](/en/documentation/guides/platform/migration/point-domain-to-azion/) shows. It is not the Azion custom domain, which is an `azion.app` hostname you choose. | -| Workload Domain Allow Access | The setting of a Workload, `workload_domain_allow_access` in the API and a switch in Azion Console, that lets clients reach the Workload on its workload domain, on by default. With it off, the workload domain answers `404`, and `domains` must hold at least one hostname or the API returns `When the workload hostname access is blocked, the workload requires alternate domains or domains.` [Workload settings](/en/documentation/platform/workloads/settings/#domains) documents the field. | +| workload domain | The read-only hostname Azion assigns a Workload at creation, `workload_domain`: `.map.azionedge.net` on production and `.preview.azionedge.net` on staging. Clients reach the Workload on it while `workload_domain_allow_access` is `true`, the default, and your custom domains point at it with a CNAME record, as [Point a domain to a workload](/en/documentation/guides/platform/migration/point-domain-to-azion/) shows. It is not the Azion custom domain, which is an `azion.app` hostname you choose. | | zone | The DNS records of one domain, together with the nameservers that answer for them. On Azion a zone lives in [Edge DNS](/en/documentation/platform/edge-dns/), not in a Workload: a Workload holds no DNS records and answers the hostnames in `domains` wherever their zone is hosted. | diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/how-it-works.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/how-it-works.mdx index 692807b3f6..ce779a5e5f 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/how-it-works.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/how-it-works.mdx @@ -1,7 +1,7 @@ --- title: How Workloads works description: Follow a request from DNS to a Workload, through TLS and mTLS, to the Application, Firewall, and custom page set that the Workload's deployment sets. -meta_tags: 'workloads, how it works, workload domain, custom domain, tls, mtls, deployment, infrastructure, staging, certificate manager, custom pages, ddos protection' +meta_tags: 'workloads, how it works, workload domain, custom domain, tls, mtls, deployment, infrastructure, staging, propagation, ddos protection' namespace: documentation_products_workloads_how_it_works permalink: /documentation/platform/workloads/how-it-works/ --- @@ -17,15 +17,19 @@ Before a website answers a request, three things happen: Only then does any application code run. -On Azion, that entry point is a Workload. [Workloads](/en/documentation/platform/workloads/) is a Platform Resource that receives the requests sent to your domains on Azion's distributed infrastructure. A Workload holds the hostnames a request can arrive on, the TLS settings of the connection, and the ports and HTTP versions it accepts. The Workload's deployment sets the [Application](/en/documentation/platform/applications/) that answers, and optionally the [Firewall](/en/documentation/platform/firewall/) that inspects requests first and the custom page set that replaces error responses. On API v3, a Domains object carried the hostnames and the certificate, and an Application's Main Settings held the protocol and TLS settings. On API v4, the Workload and its deployment replace them, and [API v4 Migration](/en/documentation/fundamentals/api-v4-migration/) maps the two models. +On Azion, that entry point is a Workload. [Workloads](/en/documentation/platform/workloads/) is a Platform Resource that receives the requests sent to your domains on Azion's distributed infrastructure. A Workload holds the hostnames a request can arrive on, the TLS settings of the connection, and the ports and HTTP versions it accepts. The Workload's deployment sets the [Application](/en/documentation/platform/applications/) that answers, and optionally the [Firewall](/en/documentation/platform/firewall/) that inspects requests first and the custom page set from [Custom Pages](/en/documentation/platform/custom-pages/) that replaces error responses. -This page covers the mechanisms rather than the fields: every field is on [Workload settings](/en/documentation/platform/workloads/settings/), and every bound is on [Workloads limits](/en/documentation/platform/workloads/limits/). The sections cover, in order, the path a request travels, the workload domain and custom domains, the infrastructure, TLS and HTTP versions, the deployment, and propagation. Certificate Manager, Custom Pages, and DDoS Protection close the page, in that order. +On API v3, a Domains object carried the hostnames and the certificate, and an Application's Main Settings held the protocol and TLS settings. On API v4, the Workload and its deployment replace them, and [API v4 Migration](/en/documentation/fundamentals/api-v4-migration/) maps the two models. + +This page covers the mechanisms rather than the fields: every field is on [Workload settings](/en/documentation/platform/workloads/settings/), and every bound is on [Workloads limits](/en/documentation/platform/workloads/limits/). The sections cover, in order, the path a request travels, the workload domain and custom domains, the infrastructure, TLS and HTTP versions, the deployment, and propagation. [DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) closes the page. --- ## The path a request travels -A request reaches a Workload through the hostname the client asks for. That hostname is the workload domain that Azion generates or a hostname in the Workload's domains. Before the Application receives the request, the Workload completes the TLS handshake and, with [mutual TLS (mTLS)](/en/documentation/platform/workloads/mtls/) on, checks the client certificate. When the Workload's deployment sets a Firewall, the rules of that Firewall run next. The Application receives only the requests that passed each of these checks. +A request reaches a Workload through the hostname the client asks for. That hostname is the workload domain that Azion generates or a hostname in the Workload's domains. + +Before the Application receives the request, the Workload completes the TLS handshake and, with [mutual TLS (mTLS)](/en/documentation/platform/workloads/mtls/) on, checks the client certificate. When the Workload's deployment sets a Firewall, the rules of that Firewall run next. The Application receives only the requests that passed each of these checks. This diagram follows one request from the DNS lookup to the response. Solid arrows carry the request, and dotted arrows carry what goes back to the client. Each label starts with the number of the step it belongs to. @@ -81,27 +85,35 @@ Two more kinds of hostname go in the Workload's domains: an `azion.app` hostname ### The azion.app hostname -The free hostname under `azion.app`, such as `my-site.azion.app`, is the one that Azion Console calls **Azion Custom Domain**. A Workload holds one at most, and a name that another Workload holds is not available. Azion serves it over HTTPS with the Azion SAN certificate. That certificate is Azion's own, and it lists the hostnames it covers as Subject Alternative Names (SANs). So the `azion.app` hostname needs no certificate of yours. +The free hostname under `azion.app`, such as `my-site.azion.app`, is the one that Azion Console calls **Azion Custom Domain**. A Workload holds one at most, and a name that another Workload holds is not available. + +Azion serves it over HTTPS with the [Azion SAN certificate](/en/documentation/platform/certificate-manager/glossary/), Azion's own, so the `azion.app` hostname needs no certificate of yours. ### Custom domains -A custom domain is a hostname of a domain you already own, such as `www.example.com`. You list each one on the Workload, then point it at the workload domain with a CNAME record at your DNS provider. When [Edge DNS](/en/documentation/platform/edge-dns/) hosts the domain's zone, Edge DNS can link the domain to Azion. In Azion Console, you can then select the domain from that zone in the **Domain** field of the Workload. The account must have permission for every domain the Workload lists, and the API refuses a domain without it. For that refusal, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#a-domain-is-refused-with-this-account-is-not-allowed-to-use-the-following-cnames). +A custom domain is a hostname of a domain you already own, such as `www.example.com`. You list each one on the Workload, then point it at the workload domain with a CNAME record at your DNS provider. When [Edge DNS](/en/documentation/platform/edge-dns/) hosts the domain's zone, Edge DNS can link the domain to Azion, and the Workload can then take the domain from that zone, as [Workload settings](/en/documentation/platform/workloads/settings/#domains) shows. + +The account must have permission for every domain the Workload lists, and the API refuses a domain without it. For that refusal, refer to [Troubleshoot Workloads](/en/documentation/platform/workloads/troubleshooting/#a-domain-is-refused-with-this-account-is-not-allowed-to-use-the-following-cnames). :::caution -A custom domain serves HTTPS only with a server certificate that covers it. Azion's SAN certificate covers the workload domain, which sits in a zone that Azion shares with other customers, and the `azion.app` hostname. It covers no domain of yours. For the certificate, refer to [The certificate](/en/documentation/platform/workloads/how-it-works/#the-certificate). +A custom domain serves HTTPS only with a server certificate that covers it, because Azion's SAN certificate covers only Azion's names, such as the workload domain in a zone that Azion shares with other customers. For the certificate, refer to [The certificate](/en/documentation/platform/workloads/how-it-works/#the-certificate). ::: For example, a site that runs at `www.example.com` with another provider moves to Azion in three changes. You add `www.example.com` to the Workload's domains, bind a server certificate that covers it, and replace its DNS record with a CNAME to the workload domain. Visitors reach the Workload once their resolvers pick up the new record. For the DNS records step by step, refer to [Point a domain to a workload](/en/documentation/guides/platform/migration/point-domain-to-azion/). ### Access to the workload domain -The workload domain stays reachable alongside your own hostnames while `workload_domain_allow_access` is `true`, which is the default. Azion Console names this setting **Workload Domain Allow Access**. Set it to `false` when the Workload must answer only on your own hostnames: the workload domain then answers `404`, while your domains keep serving. A Workload cannot close its workload domain without another hostname to answer on, so the API refuses that change on a Workload whose domains list is empty. For the rules the API applies to each hostname, refer to [Workload settings](/en/documentation/platform/workloads/settings/#domains). +The workload domain stays reachable alongside your own hostnames while `workload_domain_allow_access` is `true`, which is the default. Azion Console names this setting **Workload Domain Allow Access**. + +Set it to `false` when the Workload must answer only on your own hostnames: the workload domain then answers `404`, while your domains keep serving. A Workload cannot close its workload domain without another hostname to answer on, so the API refuses that change on a Workload whose domains list is empty. For the rules the API applies to each hostname, refer to [Workload settings](/en/documentation/platform/workloads/settings/#domains). --- ## Infrastructure -A Workload's infrastructure is the network that serves it. The production network gives global availability across Azion's distributed infrastructure, and the staging network is for testing, with limited propagation. You choose the infrastructure when you create the Workload, in the `infrastructure` field of the API. The choice also sets the workload domain's suffix: `.map.azionedge.net` on production and `.preview.azionedge.net` on staging. For the same choice in Azion Console, refer to [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure). +A Workload's infrastructure is the network that serves it. The production network gives global availability across Azion's distributed infrastructure, and the staging network is for testing, with limited propagation. + +You choose the infrastructure when you create the Workload, in the `infrastructure` field of the API. The choice also sets the workload domain's suffix: `.map.azionedge.net` on production and `.preview.azionedge.net` on staging. For the same choice in Azion Console, refer to [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure). A staging Workload accepts no `azion.app` hostname and no custom domain, so you reach it only through its workload domain. Changes you make to it do not affect a production Workload. @@ -113,11 +125,15 @@ The infrastructure is fixed at creation, and the API refuses an update that chan ## TLS and HTTP versions -Transport Layer Security (TLS) is the protocol that encrypts the connection between the client and the Workload. In its handshake, the Workload presents a certificate for the hostname, and the client and the Workload agree on a TLS version and a cipher. The Workload's `tls` settings hold that certificate, the lowest TLS version the Workload accepts, and the cipher suite it offers. These settings secure the leg from the client to Azion. The connection from Azion to your origin is set on the [Connector](/en/documentation/platform/connectors/) the Application uses. +Transport Layer Security (TLS) is the protocol that encrypts the connection between the client and the Workload. In its handshake, the Workload presents a certificate for the hostname, and the client and the Workload agree on a TLS version and a cipher. The Workload's `tls` settings hold that certificate, the lowest TLS version the Workload accepts, and the cipher suite it offers. + +These settings secure the leg from the client to Azion. The connection from Azion to your origin is set on the [Connector](/en/documentation/platform/connectors/) the Application uses. ### The certificate -The certificate that the Workload presents comes from one of two places. With [`tls.certificate`](/en/documentation/platform/workloads/#workload-structure) set to `null`, the Workload presents Azion's SAN certificate, which covers the workload domain and the `azion.app` hostname. For a domain of your own, you bind a server certificate from [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager), and the Workload presents that certificate for that domain. The API does not compare the certificate's names with the Workload's domains, so it accepts a certificate that does not cover them. Check the names before you bind one. +The certificate that the Workload presents comes from one of two places. With [`tls.certificate`](/en/documentation/platform/workloads/settings/#tls) set to `null`, the Workload presents Azion's SAN certificate, which covers the workload domain and the `azion.app` hostname. For a domain of your own, you bind a server certificate stored in [Certificate Manager](/en/documentation/platform/certificate-manager/), and the Workload presents that certificate for that domain. + +The API does not compare the certificate's names with the Workload's domains, so it accepts a certificate that does not cover them. Check the names before you bind one. This diagram follows the certificate from the Workload to the client's check. Solid arrows carry the client's handshake and the choice of certificate, and dotted arrows carry the certificate back. Each label starts with the number of the step it belongs to. @@ -142,9 +158,13 @@ flowchart TD 3. For a custom domain, with a server certificate bound in `tls.certificate`, the Workload presents that certificate. 4. The client checks that the certificate's names cover the hostname it asked for. A mismatch shows up only at this step, as a failed handshake. +For how a Workload binds each kind of certificate, and what an unbound certificate reads, refer to [How Certificate Manager works](/en/documentation/platform/certificate-manager/how-it-works/). + ### Minimum TLS version and cipher suite -The minimum TLS version and the cipher suite decide which clients can complete the handshake. The minimum version is the lowest one the Workload accepts, so a session can still use a newer version. The cipher suite is a named set of ciphers, and the client and the Workload negotiate one cipher from it for each session. A higher minimum version refuses clients that support only older versions, and a lower one admits them, down to TLS 1.0. TLS 1.0 and TLS 1.1 are deprecated. For the ciphers each suite holds, refer to [Cipher suites](/en/documentation/platform/workloads/settings/#cipher-suites). +The minimum TLS version and the cipher suite decide which clients can complete the handshake. The minimum version is the lowest one the Workload accepts, so a session can still use a newer version. The cipher suite is a named set of ciphers, and the client and the Workload negotiate one cipher from it for each session. + +A higher minimum version refuses clients that support only older versions, and a lower one admits them, down to TLS 1.0. TLS 1.0 and TLS 1.1 are deprecated. For the ciphers each suite holds, refer to [Cipher suites](/en/documentation/platform/workloads/settings/#cipher-suites). ### Clients without SNI @@ -152,15 +172,17 @@ Server Name Indication (SNI) is the TLS extension in which a client names the ho ### HTTP/3 -HTTP/3 runs over QUIC, and a client reaches it through an upgrade. On the first request, the handshake and the response use TCP with HTTP/1.1 or HTTP/2. The response carries an `Alt-Svc` header that announces HTTP/3. A browser that supports HTTP/3 then sends later requests over QUIC, until the cached `Alt-Svc` answer is missing or expires. The API accepts `http3` in a Workload's HTTP versions only alongside `http1` and `http2`. In Azion Console, **HTTP/3 support** also requires **HTTPS support** to be on. +HTTP/3 runs over QUIC, and a client reaches it through an upgrade. On the first request, the handshake and the response use TCP with HTTP/1.1 or HTTP/2. The response carries an `Alt-Svc` header that announces HTTP/3. A browser that supports HTTP/3 then sends later requests over QUIC, until the cached `Alt-Svc` answer is missing or expires. + +The API accepts `http3` in a Workload's HTTP versions only alongside `http1` and `http2`, and HTTP/3 also needs HTTPS on, as [Protocols and ports](/en/documentation/platform/workloads/settings/#protocols-and-ports) describes. --- ## The deployment -A Workload holds hostnames and TLS settings, but no Application. A deployment is the part of a Workload that sets the Application, which is required, and optionally a Firewall and a custom page set. In Azion Console, these are the **Application**, **Firewall**, and **Custom Page** fields of **Deployment Settings**. +A Workload holds hostnames and TLS settings, but no Application. A deployment is the part of a Workload that sets the Application, which is required, and optionally a Firewall and a custom page set from [Custom Pages](/en/documentation/platform/custom-pages/). -A Workload gets its Firewall only through the deployment: the Firewall has no domain of its own, and the Workload's own fields set no Firewall. Until a Workload's deployment sets a Firewall, the rules of that Firewall see no request to that Workload. The same holds for a custom page set: a Workload uses a custom page set only once that Workload's deployment sets that custom page set. +A Workload gets its Firewall only through the deployment: the Firewall has no domain of its own, and the Workload's own fields set no Firewall. Until a Workload's deployment sets a Firewall, the rules of that Firewall see no request to that Workload. The same holds for a custom page set: a Workload uses a custom page set only once that Workload's deployment sets that custom page set. For the responses a custom page set replaces, refer to [How Custom Pages works](/en/documentation/platform/custom-pages/how-it-works/). A Workload holds at most one deployment, and the API refuses a second one. So every hostname of the Workload reaches the same Application and, when the deployment sets them, the same Firewall and custom page set. Changing any of them means editing that one deployment, and the edit applies to every hostname of the Workload. A change to the deployment propagates like any other Workload change, as [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation) describes. @@ -191,93 +213,9 @@ A saved change to a Workload or its deployment reaches traffic only after it pro While a change spreads, requests can receive the old configuration or the new one, depending on the data center that answers. Each data center serves one configuration or the other, and the share of data centers on the new one grows until all of them agree. For example, right after mTLS is turned on in `enforce` mode, a client with no certificate can still receive `200` from a data center that lacks the change. Meanwhile, a data center that has it refuses the same client's handshake. -So a single request right after a change proves little. Check a change by repeating the request until it answers as expected and the answers agree. The cost of best-effort propagation is that no change is atomic: design each change so that the old and the new configuration can serve side by side. For example, keep the workload domain open until your own hostnames answer everywhere, then set `workload_domain_allow_access` to `false`. - ---- - -## Certificate Manager - -[Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) is a Platform Resource that stores the certificates a Workload uses for TLS. A server certificate is a TLS certificate for your own domains, which the Workload presents to prove it holds a hostname. You upload it with its private key, or Azion requests it from Let's Encrypt and renews it for you. A Trusted CA certificate is the certificate of a certificate authority (CA) that you trust to sign client certificates. Certificate Manager also stores certificate revocation lists (CRLs) and creates certificate signing requests (CSRs). - -A Workload uses a certificate only once you bind it. A server certificate goes in [`tls.certificate`](/en/documentation/platform/workloads/#workload-structure), a Trusted CA certificate goes in `mtls.config.certificate`, and CRLs go in `mtls.config.crl`. The API refuses a certificate sent in the field meant for the other kind. An uploaded certificate reads `inactive` until you bind it to a Workload, and `active` from then on, so the status shows whether any Workload uses it. - -### Where Certificate Manager acts on a request - -Certificate Manager acts during the TLS handshake, before a Firewall or an Application sees the request. - -This diagram follows a handshake from the client's hello to the request that continues, with the certificates Certificate Manager supplies. Solid arrows carry the handshake and the request, and dotted arrows carry what goes back to the client. The thick arrow carries the certificates you bound before the request. Each label starts with the number of the step it belongs to. - -```mermaid -%%{init: {"layout": "elk", "elk": {"cycleBreakingStrategy": "MODEL_ORDER"}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% -flowchart TD - Client(["Client"]) - WL["Workload"] - CM["Certificate Manager"] - FW["Firewall"] - App["Application"] - Client -->|"1, 4. TLS hello, then the client certificate"| WL - CM ==>|"2, 4. server certificate, Trusted CA"| WL - WL -.->|"2. server certificate"| Client - WL -.->|"5. enforce, missing or untrusted: handshake ends"| Client - WL -->|"3, 5. Firewall set"| FW - WL -->|"3, 5. no Firewall"| App - FW -->|"3, 5. allowed"| App - FW -.->|"5. refused by a rule"| Client -``` - -1. The client opens a TLS connection to one of the Workload's hostnames and names that hostname through SNI. -2. The Workload presents its server certificate. For the workload domain, or with `tls.certificate` set to `null`, that is Azion's SAN certificate. For a custom domain with a server certificate bound, it is that certificate. -3. With mTLS off, the handshake completes, and the request continues to the Application, through the Firewall when the deployment sets one. -4. With mTLS on, the Workload requests a client certificate and checks it against the Trusted CA certificate in `mtls.config.certificate`. -5. In `enforce` mode, a client with no certificate, or with one another authority signed, cannot complete the handshake. In `permissive` mode, the handshake completes. When the deployment sets a Firewall, a rule that tests the Client Certificate Validation variable can refuse the request. - -Storing certificates apart from the Workload lets you replace one without editing the Workload's other settings. The cost is that the certificate and the Workload are checked separately. The API accepts a certificate whose names do not cover the Workload's domains, and binding one is a Workload change that propagates over several minutes. For how `enforce` and `permissive` treat each client, refer to [mTLS](/en/documentation/platform/workloads/mtls/#verification-modes). - -For how Azion requests a Let's Encrypt certificate, completes its challenge, and renews it, refer to [Issuance and renewal](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/). - ---- - -## Custom Pages - -When an origin cannot find a resource, or does not respond in time, the client receives an error response, such as `404` or `504`. A custom page replaces that response with content you choose, for one status code at a time. - -[Custom Pages](/en/documentation/platform/workloads/#custom-pages) is a Platform Resource that replaces the error response returned by a Connector with a page of your own, one page per error status code. A custom page set is the named list that groups those pages. A page of the `page_connector` type sets a Connector and the path of the page's content on that Connector. It also sets a cache time and an optional status code for the response. A page can replace only a status code from a fixed list of client error (4xx) and server error (5xx) codes. A Workload uses a custom page set only once that Workload's deployment sets that custom page set. - -### Where Custom Pages acts on a request - -A custom page acts after the Application receives a response from the origin. The status code of that response says whether the request succeeded, and it decides whether a page applies. - -This diagram follows a response from the Connector's status code to what the client receives. Solid arrows carry requests, and dotted arrows carry responses. Each label starts with the number of the step it belongs to. - -```mermaid -%%{init: {"layout": "elk", "elk": {"preset": "modelOrder", "keepEntryNodeOnTop": true}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% -flowchart TD - Client(["Client"]) - App["Application"] - Conn["Connector"] - Origin[["origin"]] - Set["custom page set"] - PConn["page's Connector"] - Client -->|"1. request"| App - App -->|"1. request"| Conn - Conn -->|"1. request"| Origin - Origin -.->|"1. status code"| Conn - Conn -.->|"2. look up the code"| Set - Set -.->|"2. no page: response unchanged"| Client - Set -.->|"2. no page, listed code: default page"| Client - Set -->|"3. page found: fetch uri"| PConn - PConn -.->|"3. content"| Set - Set -.->|"4. page in place, no redirect"| Client -``` - -1. The Application sends the request to the origin through a Connector, and the Connector answers with a status code. -2. Azion looks for a page with that code in the custom page set that the deployment sets. When the set has no page for the code, the client receives the Connector's response unchanged, except for the status codes `400`, `401`, `403`, `406`, `500`, `502`, `503`, and `504`, which receive Azion's default error page. A Workload whose deployment sets no custom page set passes every response unchanged. -3. When a page matches, Azion fetches its content from the page's Connector at the page's `uri`. The page's `ttl` sets its cache time. -4. The client receives that content in place, with no redirect and no `Location` header. The status is the page's `custom_status_code`, when one is set. - -For example, your origin answers a deleted product page with `404`. A page for the code `404` then serves the document at its `uri`, such as `/myerrors/404.html`, still with status `404`. The browser stays on the URL it asked for and shows your page. +So a single request right after a change proves little. Check a change by repeating the request until it answers as expected and the answers agree. -For the fields of a set and its pages, and the status codes a page can replace, refer to [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/). +The cost of best-effort propagation is that no change is atomic: design each change so that the old and the new configuration can serve side by side. For example, keep the workload domain open until your own hostnames answer everywhere, then set `workload_domain_allow_access` to `false`. --- @@ -285,7 +223,7 @@ For the fields of a set and its pages, and the status codes a page can replace, A denial-of-service (DoS) attack floods a service with traffic until legitimate requests cannot get through. It can come from a single IP address. A distributed denial-of-service (DDoS) attack sends that traffic from a botnet of many machines at once. Mitigating an attack means telling attack traffic apart from real traffic before either reaches the service, and dropping the first. -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is a Feature of the Azion Platform that mitigates these attacks on every Workload. It is always on, and it needs no activation or configuration. It applies whether your origin runs on premises or in a cloud, and whether your network is IPv4, IPv6, or both. +[DDoS Protection](/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/) is a Feature of the Azion Platform that mitigates these attacks on every Workload. It is always on, and it needs no activation or configuration. It applies whether your origin runs on premises or in a cloud, and whether your network is IPv4, IPv6, or both. ### Where DDoS Protection acts on a request diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/limits.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/limits.mdx index 19fa5c8bdc..9c36f986f7 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/limits.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/limits.mdx @@ -1,7 +1,7 @@ --- title: Workloads limits -description: Check the bounds of a Workload, its domains, ports, and deployment, and of Certificate Manager, Custom Pages, and DDoS Protection. -meta_tags: 'workloads, limits, quotas, domains, certificates, custom pages, ddos protection, plans' +description: Check the scope of a Workload and the bounds of its name, domains, ports, HTTP versions, infrastructure, and deployment. +meta_tags: 'workloads, limits, scope, quotas, domains, ports, infrastructure, deployment, plans' namespace: documentation_products_workloads_limits permalink: /documentation/platform/workloads/limits/ --- @@ -10,15 +10,32 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -[Workloads](/en/documentation/platform/workloads/) is a Platform Resource that receives the requests sent to your domains, as their entry point, on Azion's distributed infrastructure. After it receives a request, a Workload forwards the request to the [Application](/en/documentation/platform/applications/) that this Workload's deployment sets. The deployment can also set the [Firewall](/en/documentation/platform/firewall/) that inspects requests first and the custom page set that replaces error responses. This page states the bounds Azion applies to a Workload, to the certificates and custom pages it uses, and to DDoS Protection. +[Workloads](/en/documentation/platform/workloads/) is a Platform Resource that receives the requests sent to your domains, as their entry point, on Azion's distributed infrastructure. After it receives a request, a Workload forwards the request to the [Application](/en/documentation/platform/applications/) that this Workload's deployment sets. The deployment can also set the [Firewall](/en/documentation/platform/firewall/) that inspects requests first and the custom page set that replaces error responses. This page states where a Workload stops and the bounds Azion applies to it. -Each limit on this page is checked on every call, and the call fails past it. A service plan also includes an amount of usage before a rate applies. That amount is a billing quantity: passing it changes what the account is charged rather than what the call returns. [Azion pricing](https://www.azion.com/en/pricing/) lists the plans and the usage each one includes. For the rates, refer to [Pricing](/en/documentation/fundamentals/pricing/#workloads). +Each limit on this page is checked on every call, and the call fails past it. + +A service plan also includes an amount of usage before a rate applies. That amount is a billing quantity: passing it changes what the account is charged rather than what the call returns. [Azion pricing](https://www.azion.com/en/pricing/) lists the plans and the usage each one includes. For the rates, refer to [Pricing](/en/documentation/fundamentals/pricing/#workloads). + +--- + +## Scope + +- **Domains**: a Workload answers on its workload domain, `.map.azionedge.net` on production and `.preview.azionedge.net` on staging, as soon as its deployment propagates, before you own any domain. Each domain you add points at the workload domain with a CNAME record. A production Workload can also answer on an `azion.app` hostname, which Azion Console labels **Azion Custom Domain**. For every rule a hostname follows, refer to [Workload settings](/en/documentation/platform/workloads/settings/#domains), and for the DNS records, refer to [Point a domain to a workload](/en/documentation/guides/platform/migration/point-domain-to-azion/). +- **Access to the workload domain**: with `workload_domain_allow_access` set to `false`, the workload domain answers `404`, and the Workload answers only on the hostnames in `domains`. That value fits a Workload whose own domains already serve traffic, and the API accepts it only while `domains` holds at least one hostname. For the order of that change, refer to [Workloads best practices](/en/documentation/platform/workloads/best-practices/#close-the-workload-domain-once-your-own-domain-serves-traffic). +- **DNS**: a Workload holds no DNS records. A domain's zone stays at your DNS provider, or in [Edge DNS](/en/documentation/platform/edge-dns/), and the Workload answers the hostnames it lists wherever their zone is hosted. +- **Infrastructure**: a Workload runs on the production network, for global availability, or on the staging network, for testing with limited propagation. The choice is fixed at creation, and a staging Workload takes no custom domain. For example, a configuration tested on a staging Workload reaches production as a second Workload, created on the production infrastructure. For the choice in each interface, refer to [Workload settings](/en/documentation/platform/workloads/settings/#infrastructure). +- **TLS**: the Transport Layer Security (TLS) settings of a Workload secure the connection from the client to Azion, while the connection to your origin is set on the [Connector](/en/documentation/platform/connectors/). The [Azion SAN certificate](/en/documentation/platform/certificate-manager/glossary/) covers the workload domain and the `azion.app` hostname, so a domain of your own needs a server certificate. Azion blocks TLS renegotiation by default. For the TLS versions and the cipher suites, refer to [Workload settings](/en/documentation/platform/workloads/settings/#tls). +- **mTLS**: with mutual TLS (mTLS) on, a Workload checks client certificates only on HTTPS connections, against a [Trusted CA certificate](/en/documentation/platform/certificate-manager/glossary/), in `enforce` or `permissive` mode. For both modes and every requirement, refer to [mTLS](/en/documentation/platform/workloads/mtls/). +- **Certificates and custom pages**: a Workload presents the certificates you bind from [Certificate Manager](/en/documentation/platform/certificate-manager/), and its deployment can set a custom page set from [Custom Pages](/en/documentation/platform/custom-pages/). The bounds on a certificate, a private key, a certificate revocation list (CRL), a custom page set, and its pages are on [Certificate Manager limits](/en/documentation/platform/certificate-manager/limits/) and [Custom Pages limits](/en/documentation/platform/custom-pages/limits/). +- **Deployment**: a Workload created through the API or Azion CLI starts with no deployment. The published API v4 reference has no endpoint for the deployment, so Azion Console, Azion CLI, and [Terraform](/en/documentation/devtools/terraform/workloads/) write it. For its fields, refer to [Workload settings](/en/documentation/platform/workloads/settings/#deployment). +- **Propagation**: a saved change to a Workload or its deployment takes several minutes to reach all of Azion's distributed infrastructure, with no guaranteed duration. Meanwhile, requests can receive the old or the new configuration, so repeat a request until the answers agree. For example, right after you turn on mTLS in `enforce` mode, some data centers still answer a client with no certificate. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). +- **Observability**: Azion's error page carries an `x-azion-request-id` header that identifies the request. [Data Stream](/en/documentation/platform/data-stream/) collects the events of the Workloads you associate with a stream, as [Associate workloads with a stream](/en/documentation/guides/platform/observability/data-stream-associate-workloads/) shows. --- ## Workloads -A Workload holds a workload domain that Azion generates, the domains you add, the Transport Layer Security (TLS) and mutual TLS (mTLS) settings, the ports and the HTTP versions it accepts, and the infrastructure it runs on. It also holds at most one deployment. The bounds in this section apply to every Workload, on every service plan, unless a table names a plan. +The bounds in this section apply to every Workload, on every service plan, unless a table names a plan. They cover what a Workload holds: its workload domain and the domains you add, its Transport Layer Security (TLS) and mutual TLS (mTLS) settings, its ports and HTTP versions, its infrastructure, and at most one deployment. ### Default limits @@ -39,7 +56,7 @@ The API refuses a call past each bound in this table with the message in the Pas An `azion.app` domain belongs to one Workload in one account and cannot be shared between accounts or configurations. For example, to move an `azion.app` domain to a new Workload, remove it from the Workload that holds it first. -Four further bounds apply: a Workload lists up to 50 domains by default, `http_ports` holds 1 to 4 entries, `https_ports` holds 1 to 12 entries, and `quic_ports` holds up to 12 entries. For the 12 HTTPS ports a Workload accepts, refer to [Workload settings](/en/documentation/platform/workloads/settings/#protocols-and-ports). +Five further bounds apply: a Workload lists up to 50 domains by default, `http_ports` holds 1 to 4 entries, `https_ports` holds 1 to 12 entries, `quic_ports` holds up to 12 entries, and `mtls.config.crl` lists up to 100 CRLs. For the 12 HTTPS ports a Workload accepts, refer to [Workload settings](/en/documentation/platform/workloads/settings/#protocols-and-ports). The port bounds apply to the ports a Workload listens on. The port Azion connects to on your origin is set on a [Connector](/en/documentation/platform/connectors/), and it can be any port that exists on the origin. For the delivery and origin port combinations, refer to [Configure HTTP and HTTPS ports](/en/documentation/guides/application-development/getting-started/configure-ports/). @@ -47,57 +64,13 @@ Azion raises the limit of 50 domains per Workload on request, based on your plan --- -## Certificate Manager - -[Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) is a Platform Resource that stores the certificates a Workload uses for TLS. It stores the server certificates a Workload presents and the Trusted CA certificates that verify client certificates for mTLS. It also stores the certificate revocation lists (CRLs) a Workload lists, and it requests the Let's Encrypt certificates that Azion manages for you. Certificate Manager has no included amount per plan. - -### Default limits - -The Azion API applies these bounds to a certificate, a private key, and a CRL: - -- A certificate, server or Trusted CA, takes up to 1,000,000 characters. -- A private key takes up to 64,000 characters. -- A CRL takes up to 30,720,000 characters. -- A Workload attaches up to 100 CRLs, in `mtls.config.crl`. -- A Let's Encrypt certificate covers up to 50 of the Workload's domains. - -The names a Let's Encrypt certificate covers come from the Workload's domains. - -Azion support for Let's Encrypt certificates depends on the availability and the limits of the Let's Encrypt service. For those limits, refer to the [Let's Encrypt rate limits](https://letsencrypt.org/docs/rate-limits/). - ---- - -## Custom Pages - -[Custom Pages](/en/documentation/platform/workloads/#custom-pages) is a Platform Resource that replaces the error response returned by a Connector with a page of your own, one page per error status code. A custom page set is the named list that groups those pages. A Workload uses a custom page set only once that Workload's deployment sets that custom page set. The bounds in this section apply to the set and to each page in it. - -### Default limits - -A custom page set holds at least one page. The API and Azion Console refuse an empty set with the message in the Past the limit column. - -| Scope | Limit | Past the limit | -| --- | --- | --- | -| Pages per custom page set | At least 1 | The API returns `Ensure this field has at least 1 elements.` Azion Console shows `You must have at least one custom page code`. | - -Four further bounds apply: a set `name` takes 1 to 255 characters, a page `ttl` takes 0 to 31,536,000 seconds, a page `uri` takes 1 to 250 characters, and a page `custom_status_code` takes 100 to 599. For the fields these bounds apply to, refer to [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/). - ---- - -## DDoS Protection - -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is a Feature of the Azion Platform that mitigates denial-of-service attacks on every Workload. It is always on, and it needs no activation or configuration. For how DDoS Protection mitigation is billed, including what is unmetered, refer to [Pricing](/en/documentation/fundamentals/pricing/#ddos-protection). - -You can contact the [Security Response Team (SRT)](/en/documentation/services/security-response-team/) during or after an attack, or before one to build custom rules. The SRT is a separate contract: a monthly package of hours. - ---- - ## Related resources Every field of a Workload and its deployment, with the type, the default, and the allowed values the bounds on this page apply to. - The server and Trusted CA certificates a Workload uses, the CRLs it lists, and how to upload or request a certificate. - The fields of a custom page set and its pages, and the status codes a page can replace. + The size of a certificate, a private key, and a CRL, and the names a Let's Encrypt certificate covers. + The bounds of a custom page set and of each page in it. The rate that applies to Workloads, data transfer, and requests past each included amount. diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/quickstart.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/quickstart.mdx index b5bd377c80..c19b56f4c2 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/quickstart.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/quickstart.mdx @@ -27,9 +27,7 @@ After it receives a request, the Workload forwards the request to the Applicatio This guide keeps the defaults of a new Workload: the production infrastructure, the default Transport Layer Security (TLS) settings, ports `80` and `443`, and no domain of your own. -The Workload this guide leaves you with is the starting point for two more quickstarts. With [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager), you bind a certificate to the Workload. With [Custom Pages](/en/documentation/platform/workloads/#custom-pages), you set a custom page set in the Workload's deployment to replace error responses. - -[DDoS Protection](/en/documentation/platform/workloads/#ddos-protection) is a Feature of the Azion Platform that mitigates denial-of-service attacks on every Workload. It is always on, and it needs no activation or configuration. +The Workload this guide leaves you with is the starting point for two more quickstarts. With [Certificate Manager](/en/documentation/platform/certificate-manager/), you bind a certificate to the Workload. With [Custom Pages](/en/documentation/platform/custom-pages/), you set a custom page set in the Workload's deployment to replace error responses. --- @@ -125,7 +123,9 @@ To create the Workload in Azion Console: -Azion Console shows the message "Your Workload has been created. After propagation the domain will be available in the Workload URL. You also can add a custom domain." To copy the workload domain that you send the request to, select **Copy Workload URL**. The message closes after a few seconds, and the **Workload Domain** column of the Workloads list also shows the workload domain. The Workload exists, and its deployment sets your Application. +Azion Console shows the message "Your Workload has been created. After propagation the domain will be available in the Workload URL. You also can add a custom domain." To copy the workload domain that you send the request to, select **Copy Workload URL**. + +The message closes after a few seconds, and the **Workload Domain** column of the Workloads list also shows the workload domain. The Workload exists, and its deployment sets your Application. @@ -361,7 +361,9 @@ The deployment of the Workload sets your Application. The check is the same whichever interface created the Workload. In the commands, replace `` with the workload domain of the Workload you created, of the form `.map.azionedge.net`. -A new Workload answers with your Application only once its deployment propagates across Azion's distributed infrastructure. That takes several minutes, with no guaranteed duration. Until then, the workload domain answers `404` with Azion's HTML error page. While the deployment propagates, answers to the same request can alternate between that `404` and your Application's response. Repeat the request until your Application answers. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). +A new Workload answers with your Application only once its deployment propagates across Azion's distributed infrastructure. That takes several minutes, with no guaranteed duration. Until then, the workload domain answers `404` with Azion's HTML error page. + +While the deployment propagates, answers to the same request can alternate between that `404` and your Application's response. Repeat the request until your Application answers. For more information, refer to [Propagation](/en/documentation/platform/workloads/how-it-works/#propagation). Before the deployment propagates, a `HEAD` request receives `404` and the headers of Azion's error page: @@ -387,8 +389,8 @@ The response is the one your Application returns for `/`: its status, its header ## Next steps - - + + diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/settings.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/settings.mdx index 4145a6e025..ec667b7a98 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/settings.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/settings.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -A [Workload](/en/documentation/platform/workloads/) is the entity that receives the requests sent to your domains, as their entry point, on Azion's distributed infrastructure. A Workload holds a workload domain that Azion generates, the domains you add, the Transport Layer Security (TLS) and mutual TLS (mTLS) settings, the ports and the HTTP versions it accepts, and the infrastructure it runs on. After it receives a request, the Workload forwards the request to the [Application](/en/documentation/platform/applications/) that this Workload's deployment sets. The deployment can also set the [Firewall](/en/documentation/platform/firewall/) that inspects requests first and the [custom page set](/en/documentation/platform/workloads/custom-pages/settings/) that replaces error responses. +A [Workload](/en/documentation/platform/workloads/) is the entity that receives the requests sent to your domains, as their entry point, on Azion's distributed infrastructure. A Workload holds a workload domain that Azion generates, the domains you add, the Transport Layer Security (TLS) and mutual TLS (mTLS) settings, the ports and the HTTP versions it accepts, and the infrastructure it runs on. After it receives a request, the Workload forwards the request to the [Application](/en/documentation/platform/applications/) that this Workload's deployment sets. The deployment can also set the [Firewall](/en/documentation/platform/firewall/) that inspects requests first and the [custom page set](/en/documentation/platform/custom-pages/settings/) that replaces error responses. This page lists every field of the Workload by its API name, with its Azion Console control in the tables that map one. It lists every field of the deployment by its Azion Console control. For the numeric bounds in one place, refer to [Workloads limits](/en/documentation/platform/workloads/limits/). For the path a request follows from the Workload to the Application, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/). @@ -129,9 +129,9 @@ Transport Layer Security (TLS) is the protocol that encrypts the connection betw | **Minimum TLS version** | `tls.minimum_version` | enum | `tls_1_0` (TLS 1.0, deprecated), `tls_1_1` (TLS 1.1, deprecated), `tls_1_2` (TLS 1.2), `tls_1_3` (TLS 1.3) | `tls_1_3` | `--file` only | | **Cipher suite** | `tls.ciphers` | integer | `1` to `8`, one per suite in Cipher suites | `7` | `--file` only | -HTTPS needs an X.509 certificate. You can upload your own certificate to [Certificate Manager](/en/documentation/platform/workloads/certificate-manager/certificates/) or request a Let's Encrypt certificate that Azion manages, both at no additional cost. In Azion Console, typing a domain switches **Digital Certificate** from _Azion (SAN)_ to _New Let's Encrypt Certificate (DNS-01)_. **Save** then requests that certificate before it saves the Workload. +HTTPS needs an X.509 certificate. You can upload your own certificate to [Certificate Manager](/en/documentation/platform/certificate-manager/certificates/) or request a Let's Encrypt certificate that Azion manages, both at no additional cost. In Azion Console, typing a domain switches **Digital Certificate** from _Azion (SAN)_ to _New Let's Encrypt Certificate (DNS-01)_. **Save** then requests that certificate before it saves the Workload. -With `tls.certificate` set to `null`, the Workload presents the Azion SAN certificate, which covers the Azion Custom Domain and the workload domain. That certificate is Azion's own, with its hostnames listed as Subject Alternative Names (SAN). A certificate of another type is refused. For example, a Trusted CA certificate, the certificate of a certificate authority (CA) that you trust to sign client certificates, returns `Invalid certificate type, MUST be an Edge Certificate.` in `tls.certificate`. +With `tls.certificate` set to `null`, the Workload presents the [Azion SAN certificate](/en/documentation/platform/certificate-manager/glossary/), which covers the Azion Custom Domain and the workload domain. That certificate is Azion's own, with its hostnames listed as Subject Alternative Names (SAN). A certificate of another type is refused. For example, a [Trusted CA certificate](/en/documentation/platform/certificate-manager/glossary/), the certificate of a certificate authority (CA) that you trust to sign client certificates, returns `Invalid certificate type, MUST be an Edge Certificate.` in `tls.certificate`. `tls.minimum_version` sets a floor, not the exact version a session uses. A Workload with `tls_1_2` can still serve a session over TLS 1.3, depending on the cipher the client and the Workload negotiate from the suite. Azion blocks TLS renegotiation by default. To change that, contact the Sales team. @@ -342,7 +342,9 @@ A deployment is the part of a Workload that sets the Application, which is requi | **Firewall** | integer | the ID of a Firewall | | **Custom Page** | integer | the ID of a custom page set | -A deployment sets nothing beyond those three fields. With the Azion CLI, `azion create workload-deployment` creates the deployment and sets its Application with `--application-id`, as in `azion create workload-deployment --workload-id --name my-deployment --application-id `. A deployment without a Firewall shows _Select a Firewall_ in the **Firewall** field of Azion Console. A Workload uses a custom page set only once that Workload's deployment sets that custom page set. A Workload that still uses a Firewall keeps that Firewall from being deleted, and deleting the deployment does not release it: delete the Workload first. +A deployment sets nothing beyond those three fields. With the Azion CLI, `azion create workload-deployment` creates the deployment and sets its Application with `--application-id`, as in `azion create workload-deployment --workload-id --name my-deployment --application-id `. A deployment without a Firewall shows _Select a Firewall_ in the **Firewall** field of Azion Console. + +A Workload uses a custom page set only once that Workload's deployment sets that custom page set. A Workload that still uses a Firewall keeps that Firewall from being deleted, and deleting the deployment does not release it: delete the Workload first. --- @@ -423,7 +425,43 @@ Created Workload with ID Through the API, `POST /v4/workspace/workloads` answers with HTTP `202` and `state` set to `pending`. A production Workload created with `name`, `active`, `infrastructure`, and `workload_domain_allow_access` alone returns every default: ```json -{"state":"pending","data":{"id":,"name":"my-workload","active":true,"last_editor":"","last_modified":"2026-01-01T12:00:00.000000Z","created_at":"2026-01-01T12:00:00.000000Z","infrastructure":1,"tls":{"certificate":null,"ciphers":7,"minimum_version":"tls_1_3"},"protocols":{"http":{"versions":["http1","http2","http3"],"http_ports":[80],"https_ports":[443],"quic_ports":[443]}},"mtls":{"enabled":false,"config":{"certificate":null,"crl":null,"verification":null}},"domains":[],"workload_domain_allow_access":true,"workload_domain":".map.azionedge.net","product_version":"1.0"}} +{ + "state": "pending", + "data": { + "id": , + "name": "my-workload", + "active": true, + "last_editor": "", + "last_modified": "2026-01-01T12:00:00.000000Z", + "created_at": "2026-01-01T12:00:00.000000Z", + "infrastructure": 1, + "tls": { + "certificate": null, + "ciphers": 7, + "minimum_version": "tls_1_3" + }, + "protocols": { + "http": { + "versions": ["http1", "http2", "http3"], + "http_ports": [80], + "https_ports": [443], + "quic_ports": [443] + } + }, + "mtls": { + "enabled": false, + "config": { + "certificate": null, + "crl": null, + "verification": null + } + }, + "domains": [], + "workload_domain_allow_access": true, + "workload_domain": ".map.azionedge.net", + "product_version": "1.0" + } +} ``` --- @@ -462,6 +500,6 @@ The API refuses each request below with the message in the first column. For a W How a Workload verifies client certificates in enforce and permissive mode, with the Trusted CA it uses and the CRLs it lists. Every bound on a Workload, its domains, and its deployment, with what happens past each one. The path a request follows from a domain through the Workload to its Application and Firewall. - The server and Trusted CA certificates a Workload accepts, and how to upload or request one. + The server and Trusted CA certificates a Workload accepts, and how to upload or request one.
diff --git a/apps/docs/src/content/docs/en/pages/secure/workloads/troubleshooting.mdx b/apps/docs/src/content/docs/en/pages/secure/workloads/troubleshooting.mdx index 088d848cbd..b9d8a4d646 100644 --- a/apps/docs/src/content/docs/en/pages/secure/workloads/troubleshooting.mdx +++ b/apps/docs/src/content/docs/en/pages/secure/workloads/troubleshooting.mdx @@ -1,7 +1,7 @@ --- title: Troubleshoot Workloads -description: Find the cause of a 404, a refused domain or setting, a client that fails mutual TLS (mTLS), and a certificate that is not issued. -meta_tags: 'workloads, troubleshooting, 404, domains, mtls, handshake, certificate manager, lets encrypt, pending, custom pages, errors' +description: Find the cause of a 404, a refused domain or setting, a client that fails mutual TLS (mTLS), and a certificate refused in a Workload setting. +meta_tags: 'workloads, troubleshooting, 404, domains, mtls, handshake, propagation, certificate, deployment, errors' namespace: documentation_products_workloads_troubleshooting permalink: /documentation/platform/workloads/troubleshooting/ --- @@ -11,7 +11,7 @@ import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' import Code from '~/components/webkit/CodeBlock.vue' -This page covers the symptoms a [Workload](/en/documentation/platform/workloads/) shows on live traffic or in a refused request, including its [Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) certificates and [Custom Pages](/en/documentation/platform/workloads/#custom-pages). A quoted refusal is the API's message, unless the entry names another source. Azion CLI prints the same message inside `Error: Failed to ... [...]`. +This page covers the symptoms a [Workload](/en/documentation/platform/workloads/) shows on live traffic or in a refused request. For a certificate from [Certificate Manager](/en/documentation/platform/certificate-manager/) or a custom page set from [Custom Pages](/en/documentation/platform/custom-pages/), refer to [Troubleshoot Certificate Manager](/en/documentation/platform/certificate-manager/troubleshooting/) and [Troubleshoot Custom Pages](/en/documentation/platform/custom-pages/troubleshooting/). A quoted refusal is the API's message, unless the entry names another source. Azion CLI prints the same message inside `Error: Failed to ... [...]`. --- @@ -78,7 +78,7 @@ The client then accepts the certificate, and the custom domain serves HTTPS. Saving the Workload's domains fails with `This account is not allowed to use the following CNAMEs: example.com.`, where the message names each refused domain. -The account has no permission for a domain in `domains`, and the API refuses the whole request, as the [Workload settings](/en/documentation/platform/workloads/settings/#errors) errors show. In Azion Console, a _New Let's Encrypt Certificate_ option requests a certificate first, which fails as [A certificate request is refused](#a-certificate-request-is-refused-with-this-account-cannot-use-certain-common-or-alternative-names) describes. +The account has no permission for a domain in `domains`, and the API refuses the whole request, as the [Workload settings](/en/documentation/platform/workloads/settings/#errors) errors show. In Azion Console, a _New Let's Encrypt Certificate_ option requests a certificate first, which fails as [A certificate request is refused](/en/documentation/platform/certificate-manager/troubleshooting/#a-certificate-request-is-refused-with-this-account-cannot-use-certain-common-or-alternative-names) describes. - **Remove the domain the message names**, and save the rest of the list. - **List only domains your account has permission for**. @@ -177,7 +177,7 @@ A client gets no response: curl exits with code `56` after the server's certific The Workload has mutual TLS (mTLS) in `enforce` mode, and the client presented no certificate, or one that a certificate authority (CA) you do not trust signed. A connection without Server Name Indication (SNI) is also closed before it reaches your application. -- **Present a certificate that your trusted CA signed**: the Trusted CA certificate is the certificate of the CA that signs your clients' certificates. The Workload reads it from `mtls.config.certificate`, and curl sends a client certificate with `--cert` and `--key`. +- **Present a certificate that your trusted CA signed**: the [Trusted CA certificate](/en/documentation/platform/certificate-manager/glossary/) is the certificate of the CA that signs your clients' certificates. The Workload reads it from `mtls.config.certificate`, and curl sends a client certificate with `--cert` and `--key`. - **Send SNI from every client**: on an `enforce` Workload, a connection without it never reaches your application, as [mTLS](/en/documentation/platform/workloads/mtls/#requirements) lists. - **Admit clients while you test**: `permissive` completes the handshake and leaves the decision to a Firewall rule, as [Verification modes](/en/documentation/platform/workloads/mtls/#verification-modes) describes. - **Wait for a mode change to propagate**: until it does, some data centers answer with the previous mode. @@ -223,109 +223,13 @@ Azion CLI then prints `Updated Workload with ID `, and the bound ce --- -## Certificate Manager - -[Certificate Manager](/en/documentation/platform/workloads/#certificate-manager) is a Platform Resource that stores the certificates a Workload uses for TLS. It requests Let's Encrypt certificates for a Workload's domains, stores the ones you upload, and reports each one's state in its `status` field. For where it acts on a request, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/#certificate-manager). - -### A certificate stays pending - -A Let's Encrypt certificate keeps the `pending` or `challenge_verification` status, and in Azion Console, the Workload's **Digital Certificate** field warns "This certificate is pending validation and HTTPS may not work until it’s validated". - -The challenge cannot validate one of the names: in HTTP-01, Let's Encrypt fetches a file from the hostname, so every name must point to Azion. In DNS-01, it reads an `_acme-challenge` record in the domain's DNS, as [Domain validation](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#domain-validation) explains. - -- **Check the names**: a certificate requested from the Workload form in Azion Console covers the Workload's **Domains**, so confirm each one is correct. -- **For HTTP-01, point every name at Azion**, alternative names included. -- **For DNS-01 at another DNS provider, add the CNAME**: `_acme-challenge.` with the value `.letsencrypt.azion.com`. In Edge DNS, Azion writes the record itself. -- **If the certificate keeps failing, check the CNAME records again**: Azion retries a failed issuance at increasing intervals, as [Issuance time and retries](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#issuance-time-and-retries) lists. - -After a later attempt validates, the certificate reads `active` while a Workload uses it, or `inactive` until then. For the records step by step, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/). - -### A certificate request is refused with This account cannot use certain common or alternative names - -A Let's Encrypt request, a certificate signing request (CSR), or saving a new domain in Azion Console fails with `This account cannot use certain common or alternative names because it does not have permission for their domain names.` - -A name on the request belongs to a domain the account has no permission for. An `azion.app` hostname is refused too, even one a Workload of the account holds, as the [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#errors) errors show. - -- **Name only hostnames in domains your account has permission for**, in `common_name` and `alternative_names`. -- **Request no certificate for an `azion.app` hostname**: with `tls.certificate` set to `null`, the Workload presents the Azion SAN certificate, which covers the `azion.app` hostname and the workload domain. -- **In Azion Console, remove the refused domain from Domains**: adding a domain switches **Digital Certificate** from _Azion (SAN)_ to _New Let's Encrypt Certificate (DNS-01)_. **Save** then requests that certificate before it saves the Workload, and saves nothing when the request is refused. - -An accepted request returns the certificate's `id` with the `pending` status, and Azion Console shows "Your workload has been updated". - -### A certificate fails to issue - -A Let's Encrypt certificate reads `failed`, and in Azion Console, the Workload's **Digital Certificate** field warns "This digital certificate failed and HTTPS cannot be used until the issue is resolved". - -Validation failed, and Azion records why in the certificate's `status_detail` field. One value names the hostname whose record to check: - -```text -An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com -``` - -Another names no hostname, so check every name on the certificate, as [A certificate stays pending](#a-certificate-stays-pending) lists: - -```text -domain ownership validation failed - verify DNS records or HTTP challenge accessibility -``` - -Read `status_detail` from any interface, then correct the record or the name it points to: - -- **Azion Console**: in **Certificate Manager**, the error icon of the certificate carries it. -- **Azion CLI**: `azion describe digital-certificate --digital-certificate-id --format json` prints it beside `status`. -- **API**: `GET /v4/workspace/tls/certificates/` returns it with the certificate. - -A later attempt in the [retry schedule](/en/documentation/platform/workloads/certificate-manager/issuance-and-renewal/#issuance-time-and-retries) can then issue the certificate, and an issued certificate in use reads `active` with `status_detail` at `""`. - -### An uploaded private key is refused - -Uploading a server certificate fails with `The provided private key is invalid. Please check the key and try again.` - -The API cannot read the `private_key` sent with the certificate, as the [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/#errors) errors show. - -- **Send the key that matches the certificate**. -- **Send it in PEM**, with its `-----BEGIN` and `-----END` lines and no passphrase, as [Key algorithms and formats](/en/documentation/platform/workloads/certificate-manager/certificates/#key-algorithms-and-formats) lists. -- **Keep the key one JSON string in an API body**, with each line break written as `\n`. - -Azion CLI then prints `Created Digital Certificate with ID `, and the certificate reads `inactive` until a Workload uses it. - ---- - -## Custom Pages - -[Custom Pages](/en/documentation/platform/workloads/#custom-pages) is a Platform Resource that replaces the error response returned by a Connector with a page of your own, one page per error status code. The pages sit in a custom page set. For where it acts on a request, refer to [How Workloads works](/en/documentation/platform/workloads/how-it-works/#custom-pages). - -### A custom page set is refused with Ensure this field has at least 1 elements - -Creating a custom page set fails with `Ensure this field has at least 1 elements.`, or Azion Console refuses to save it with `You must have at least one custom page code`. - -A set holds at least one page, and the request sent `"pages": []`, as the [Custom page settings](/en/documentation/platform/workloads/custom-pages/settings/#errors) errors show. - -- **Add a page to `pages`**: one page replaces one error status code with content from a Connector, as the body in [Request body](/en/documentation/platform/workloads/custom-pages/settings/#request-body) shows. -- **Add a page code in Azion Console**: the **Page Codes** table needs one row before you save the set. - -Azion CLI then prints `Created Custom Page with ID `. - -### An error page does not appear - -The Connector's error response reaches the client unchanged, even though a custom page set holds a page for its status code. - -A Workload uses a custom page set only once that Workload's deployment sets that custom page set. - -- **Set the custom page set in the deployment**: in Azion Console, select it in the **Custom Page** field of **Deployment Settings**, or pass `--custom-page` to `azion create workload-deployment` when you create the deployment. The Azion CLI has no command that updates a deployment. For the steps, refer to [Customize an error page](/en/documentation/guides/application-development/getting-started/customizing-error-response-page/#assign-the-set-in-the-workloads-deployment). -- **Check the status code the Connector returns**: a page acts only on the code it lists, such as `"404"`. -- **Wait for the change to propagate**. - -The client then receives the page's content in place, with the page's `custom_status_code` when one is set, and no `Location` header. - ---- - ## Related resources Every field of a Workload and its deployment, with the full table of refusals and what to do about each. The path a request follows through the Workload, the deployment, and propagation, which most fixes here lean on. - The certificate types, statuses, and key formats a Workload accepts, with the errors an upload or a request returns. + A certificate that stays pending, fails to issue, or is refused at request or upload. How enforce and permissive mode treat a client certificate, and what a refused handshake looks like. diff --git a/apps/docs/src/content/docs/en/pages/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits.mdx b/apps/docs/src/content/docs/en/pages/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits.mdx index 7ed17d1695..4331b6b940 100644 --- a/apps/docs/src/content/docs/en/pages/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits.mdx +++ b/apps/docs/src/content/docs/en/pages/use-cases/secure-applications-and-networks/prepare-regulated-web-applications-for-security-audits.mdx @@ -18,7 +18,7 @@ This use case does not cover Azion's own certifications as a vendor, for which r - An Azion account. If you do not have one, [create an account](https://console.azion.com/signup). - An application that serves the web application through a connector and a workload. To create them, refer to [Applications quickstart](/en/documentation/platform/applications/quickstart/). -- HTTPS turned on in the workload's protocol settings, with a certificate that covers its domains. To have Azion request and renew one, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/), and to upload one of your own, refer to the [Certificate Manager quickstart](/en/documentation/platform/workloads/certificate-manager/quickstart/). +- HTTPS turned on in the workload's protocol settings, with a certificate that covers its domains. To have Azion request and renew one, refer to [Request a Let's Encrypt certificate](/en/documentation/guides/application-security/tls-and-certificates/how-to-generate-a-lets-encrypt-certificate/), and to upload one of your own, refer to the [Certificate Manager quickstart](/en/documentation/platform/certificate-manager/quickstart/). - A firewall bound to the workload's deployment, with WAF applied to every request. To build it, refer to [Bind a firewall to a workload](/en/documentation/guides/application-security/firewall-and-waf/firewall-protect-your-domain/) and [Apply a rule set to every request](/en/documentation/guides/application-security/firewall-and-waf/apply-rule-set/). - An endpoint that keeps the events for the period your standard requires, such as a SIEM or a storage bucket. For the endpoints a stream sends to, refer to [Endpoints](/en/documentation/platform/data-stream/endpoints/). @@ -28,7 +28,7 @@ This use case does not cover Azion's own certifications as a vendor, for which r | The audit asks for | Which means | Product | Documented in | | --- | --- | --- | --- | -| Traffic encrypted in transit | A certificate on the workload, and a _Redirect HTTP to HTTPS_ rule on the application | Certificate Manager | [Certificate Manager quickstart](/en/documentation/platform/workloads/certificate-manager/quickstart/) and [Redirect HTTP to HTTPS](/en/documentation/guides/application-security/tls-and-certificates/redirect-http-to-https/) | +| Traffic encrypted in transit | A certificate on the workload, and a _Redirect HTTP to HTTPS_ rule on the application | Certificate Manager | [Certificate Manager quickstart](/en/documentation/platform/certificate-manager/quickstart/) and [Redirect HTTP to HTTPS](/en/documentation/guides/application-security/tls-and-certificates/redirect-http-to-https/) | | Application-layer attacks filtered | A WAF rule set that a _Set WAF_ rule applies to every request | WAF | [Apply a rule set to every request](/en/documentation/guides/application-security/firewall-and-waf/apply-rule-set/) | | Access restricted by country and by network | Network lists that deny rules read through the _Network_ criterion | Network Shield | [Network Lists](/en/documentation/platform/firewall/network-shield/network-lists/) | | Security events kept outside the platform | A stream of the _Applications_ data source, with the WAF variables, to the team's endpoint | Data Stream | [Stream request and WAF records to a SIEM](/en/documentation/guides/platform/observability/stream-request-and-waf-records-to-siem/) | diff --git a/apps/docs/src/content/docs/pt-br/pages/arquiteturas/compliance/compliance-architecture.mdx b/apps/docs/src/content/docs/pt-br/pages/arquiteturas/compliance/compliance-architecture.mdx index ace902d49f..8c835791ae 100644 --- a/apps/docs/src/content/docs/pt-br/pages/arquiteturas/compliance/compliance-architecture.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/arquiteturas/compliance/compliance-architecture.mdx @@ -11,7 +11,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Este design atende equipes de segurança e de compliance que precisam mostrar aos auditores os controles na frente de uma aplicação regulada. Essa aplicação trata dados de cartão ou dados pessoais sob um padrão como PCI DSS, SOC 2, LGPD ou GDPR. [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) guarda os certificados TLS, e a [application](/pt-br/documentacao/plataforma/applications/) redireciona todo o tráfego para HTTPS. Um [firewall](/pt-br/documentacao/plataforma/firewall/) aplica regras do [WAF](/pt-br/documentacao/plataforma/firewall/waf/), listas do [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) e restrições geográficas antes que as requisições cheguem à origem por um [connector](/pt-br/documentacao/plataforma/connectors/). [Data Stream](/pt-br/documentacao/plataforma/data-stream/) exporta o registro de cada requisição, com a sua decisão do WAF, a um SIEM ou armazenamento que a equipe mantém pelo período que o seu padrão exige. Pelo [Modelo de Responsabilidade Compartilhada](/pt-br/documentacao/fundamentos/responsabilidade-compartilhada/), a Azion protege a plataforma, e a equipe configura e evidencia esses controles. O design implementa o caso de uso [Preparar aplicações web reguladas para auditorias de segurança](/pt-br/documentacao/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca/). +Este design atende equipes de segurança e de compliance que precisam mostrar aos auditores os controles na frente de uma aplicação regulada. Essa aplicação trata dados de cartão ou dados pessoais sob um padrão como PCI DSS, SOC 2, LGPD ou GDPR. [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) guarda os certificados TLS, e a [application](/pt-br/documentacao/plataforma/applications/) redireciona todo o tráfego para HTTPS. Um [firewall](/pt-br/documentacao/plataforma/firewall/) aplica regras do [WAF](/pt-br/documentacao/plataforma/firewall/waf/), listas do [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) e restrições geográficas antes que as requisições cheguem à origem por um [connector](/pt-br/documentacao/plataforma/connectors/). [Data Stream](/pt-br/documentacao/plataforma/data-stream/) exporta o registro de cada requisição, com a sua decisão do WAF, a um SIEM ou armazenamento que a equipe mantém pelo período que o seu padrão exige. Pelo [Modelo de Responsabilidade Compartilhada](/pt-br/documentacao/fundamentos/responsabilidade-compartilhada/), a Azion protege a plataforma, e a equipe configura e evidencia esses controles. O design implementa o caso de uso [Preparar aplicações web reguladas para auditorias de segurança](/pt-br/documentacao/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca/). ## Diagrama de arquitetura @@ -42,7 +42,7 @@ flowchart TD ### Fluxo de dados -1. Um cliente se conecta por HTTPS, e o workload apresenta o certificado que Certificate Manager guarda para o domínio. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) avalia o tráfego antes que qualquer regra de firewall rode. +1. Um cliente se conecta por HTTPS, e o workload apresenta o certificado que Certificate Manager guarda para o domínio. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) avalia o tráfego antes que qualquer regra de firewall rode. 2. Regras de firewall leem listas do Network Shield e respondem `403` em dois casos. Um é um cliente de um país fora da lista atendida, e o outro uma requisição a `/admin` de fora da rede da equipe. 3. WAF pontua toda requisição e, em _Blocking_, responde `400` a uma requisição cujo score atinge o threshold de uma família de ameaças. 4. Uma requisição que passa chega à application, que redireciona HTTP simples para HTTPS e encaminha a requisição à origem pelo connector. @@ -68,7 +68,7 @@ Uma recusa começa no firewall e vai direto ao cliente, porque a application nun - [Preparar aplicações web reguladas para auditorias de segurança](/pt-br/documentacao/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca/) - constrói este design de ponta a ponta, com o redirecionamento para HTTPS, as regras de país e de endereço, o stream de eventos de segurança e as verificações de cada um. - [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/) - faz a Azion solicitar e renovar um certificado para os domínios do workload. -- [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) - envia um certificado próprio e o vincula a um workload. +- [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) - envia um certificado próprio e o vincula a um workload. - [Redirecione HTTP para HTTPS](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/redirecionar-http-para-https/) - cria a regra da application que redireciona cada requisição HTTP simples para HTTPS. - [Vincule um firewall a um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/proteja-seu-dominio/) - nomeia o firewall no deployment do workload, para que ele inspecione as requisições a todo domínio. - [Aplique um rule set a toda requisição](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/aplicar-rule-set/) - aplica o WAF rule set, o controle da camada de aplicação que uma auditoria pede. diff --git a/apps/docs/src/content/docs/pt-br/pages/arquiteturas/security-modernization/security-modernization-v3.mdx b/apps/docs/src/content/docs/pt-br/pages/arquiteturas/security-modernization/security-modernization-v3.mdx index 6661dbcbb8..b2b0e4648f 100644 --- a/apps/docs/src/content/docs/pt-br/pages/arquiteturas/security-modernization/security-modernization-v3.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/arquiteturas/security-modernization/security-modernization-v3.mdx @@ -44,7 +44,7 @@ Este caso de uso é ideal para organizações que buscam construir uma forte pre - [Applications](/pt-br/documentacao/plataforma/applications/): sua aplicação em execução na Azion Web Platform. - [Firewall](/pt-br/documentacao/plataforma/firewall/): executa seus módulos e regras de segurança. - - [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection): sempre ativo, detecta e mitiga ataques DDoS e DoS. + - [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/): sempre ativo, detecta e mitiga ataques DDoS e DoS. - [Web Application Firewall](/pt-br/documentacao/plataforma/firewall/waf/): permite que você configure a proteção contra ataques e vulnerabilidades. - [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/): permite que você crie listas com endereços IP ou países com comportamento suspeito e restrinja seu acesso. - [Functions](/pt-br/documentacao/plataforma/firewall/functions/): funções sem servidor que são executadas no Azion Runtime com baixa latência, trazendo o poder operacional e o processamento de segurança mais próximos do usuário final. diff --git a/apps/docs/src/content/docs/pt-br/pages/build/applications/solucao-de-problemas.mdx b/apps/docs/src/content/docs/pt-br/pages/build/applications/solucao-de-problemas.mdx index 08849c31a9..cea04bc329 100644 --- a/apps/docs/src/content/docs/pt-br/pages/build/applications/solucao-de-problemas.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/build/applications/solucao-de-problemas.mdx @@ -34,7 +34,7 @@ A sua origem responde a uma requisição com um status `4xx` ou `5xx`, e o clien O Connector que uma regra com _Set Connector_ define recebe o erro da origem. A página de erro é definida no Workload, não na Application: o deployment do Workload define a página ao lado da Application e do Firewall. -- **Sirva a sua própria página de erro**: crie-a como mostra [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/workloads/custom-pages/primeiros-passos/). Depois, no Azion Console, selecione-a no campo **Custom Page** da seção **Deployment Settings** do Workload. +- **Sirva a sua própria página de erro**: crie-a como mostra [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/custom-pages/primeiros-passos/). Depois, no Azion Console, selecione-a no campo **Custom Page** da seção **Deployment Settings** do Workload. - **Sirva a última cópia armazenada no lugar de um `5xx`**: ative o [stale cache](/pt-br/documentacao/plataforma/applications/cache/expiracao-e-atualizacao/#stale-cache) no cache setting que uma regra com _Set Cache Policy_ aplica ao path, com `modules.cache.stale_cache.enabled` definido como `true` na API. O cliente então recebe a sua página para um erro da origem, ou a cópia expirada de um objeto em cache dentro da janela de stale. diff --git a/apps/docs/src/content/docs/pt-br/pages/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca.mdx b/apps/docs/src/content/docs/pt-br/pages/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca.mdx index 664f43160b..450ab0bd19 100644 --- a/apps/docs/src/content/docs/pt-br/pages/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/casos-de-uso/proteger-aplicacoes-e-redes/preparar-aplicacoes-web-reguladas-para-auditorias-de-seguranca.mdx @@ -18,7 +18,7 @@ Este caso de uso não cobre as certificações da própria Azion como fornecedor - Uma conta Azion. Se você ainda não tem uma, [crie uma conta](https://console.azion.com/signup). - Uma application que serve a aplicação web por meio de um connector e de um workload. Para criá-los, consulte [Primeiros passos com Applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/). -- HTTPS ativado nas configurações de protocolo do workload, com um certificado que cobre os seus domínios. Para que a Azion solicite e renove um, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/), e para enviar um certificado próprio, consulte [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/). +- HTTPS ativado nas configurações de protocolo do workload, com um certificado que cobre os seus domínios. Para que a Azion solicite e renove um, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/), e para enviar um certificado próprio, consulte [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/). - Um firewall vinculado ao deployment do workload, com WAF aplicado a toda requisição. Para construí-lo, consulte [Vincule um firewall a um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/proteja-seu-dominio/) e [Aplique um rule set a toda requisição](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/aplicar-rule-set/). - Um endpoint que guarda os eventos pelo período que o seu padrão exige, como um SIEM ou um bucket de armazenamento. Para os endpoints aos quais um stream envia, consulte [Endpoints](/pt-br/documentacao/plataforma/data-stream/endpoints/). @@ -28,7 +28,7 @@ Este caso de uso não cobre as certificações da própria Azion como fornecedor | A auditoria pede | O que significa | Produto | Documentado em | | --- | --- | --- | --- | -| Tráfego criptografado em trânsito | Um certificado no workload e uma regra _Redirect HTTP to HTTPS_ na application | Certificate Manager | [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) e [Redirecione HTTP para HTTPS](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/redirecionar-http-para-https/) | +| Tráfego criptografado em trânsito | Um certificado no workload e uma regra _Redirect HTTP to HTTPS_ na application | Certificate Manager | [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) e [Redirecione HTTP para HTTPS](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/redirecionar-http-para-https/) | | Ataques na camada de aplicação filtrados | Um WAF rule set que uma regra _Set WAF_ aplica a toda requisição | WAF | [Aplique um rule set a toda requisição](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/aplicar-rule-set/) | | Acesso restrito por país e por rede | Network lists que regras de negação leem pelo critério _Network_ | Network Shield | [Network Lists](/pt-br/documentacao/plataforma/firewall/network-shield/network-lists/) | | Eventos de segurança guardados fora da plataforma | Um stream da fonte de dados _Applications_, com as variáveis do WAF, para o endpoint da equipe | Data Stream | [Envie registros de requisições e do WAF a um SIEM](/pt-br/documentacao/guias/plataforma/observabilidade/enviar-registros-de-requisicoes-e-waf-a-um-siem/) | diff --git a/apps/docs/src/content/docs/pt-br/pages/contratos/tos/12-may-2026/terms-of-service-12-may-2026.mdx b/apps/docs/src/content/docs/pt-br/pages/contratos/tos/12-may-2026/terms-of-service-12-may-2026.mdx index b95c52cfd8..755e16f52a 100644 --- a/apps/docs/src/content/docs/pt-br/pages/contratos/tos/12-may-2026/terms-of-service-12-may-2026.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/contratos/tos/12-may-2026/terms-of-service-12-may-2026.mdx @@ -44,7 +44,7 @@ A Azion trabalha constantemente para melhorar suas soluções. Consequentemente, **Data Stream:** projetado para coletar, formatar e enviar dados gerados por Produtos e Serviços Azion para a infraestrutura do Cliente ou sistemas de terceiros por meio de protocolos e integrações suportados. O Cliente escolherá quais dados serão coletados e, ao fazê-lo, automaticamente declara que está autorizado a coletar todos os dados selecionados. A AZION NÃO SE RESPONSABILIZA: (A) PELO USO DOS DADOS PELO CLIENTE; OU (B) PELO DIREITO DO CLIENTE DE COLETAR DADOS DE SEUS USUÁRIOS. Os dados coletados são enviados para a infraestrutura do Cliente utilizando o protocolo escolhido pelo Cliente na interface do Azion Console ou API, formatados em NDJSON (Newline Delimited JSON) em um template configurável. Os dados são enviados em blocos de 2.000 registros separados por “\n” (Newline), ou 60 segundos, o que ocorrer antes. A Azion adotará medidas razoáveis, compatíveis com a natureza do serviço, para enviar os dados à infraestrutura do Cliente, ou de seus fornecedores, em tempo real ou com atraso inferior a 3 minutos. No entanto, em casos de picos de acesso, ataques ou causas externas, o atraso poderá ser maior. O CLIENTE É RESPONSÁVEL PELA DISPONIBILIDADE DA INFRAESTRUTURA PARA RECEBER OS DADOS E, EM CASO DE INDISPONIBILIDADE, A AZION PODERÁ DESCARTAR OS DADOS. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, a cobrança do Data Stream se dará por: (a) Requests e (b) Data Transfer, de acordo com os volumes consumidos. -**DDoS Protection:** recurso habilitado por padrão na Azion e fornecido exclusivamente de acordo com os termos disponíveis em [https://www.azion.com/pt-br/documentacao/plataforma/workloads/#ddos-protection](https://www.azion.com/pt-br/documentacao/plataforma/workloads/#ddos-protection) (“Diretrizes”). Ao utilizar a Azion, o Cliente: (i) autoriza a Azion a impor as medidas técnicas disponíveis na Azion Platform para controlar ou mitigar ataques DDoS, ainda que tais medidas possam resultar em degradação de performance; e (ii) reconhece que o Acordo de Nível de Serviço ("SLA") não se aplica enquanto um ataque DDoS estiver em andamento. DDoS Protection fornece: (a) proteção unmetered para ataques nas camadas de rede e transporte (camadas 3 e 4 do modelo OSI), incluindo, sem limitação, UDP Flood, TCP SYN Flood, ICMP Flood e outros ataques volumétricos conforme especificado nas Diretrizes; e (b) proteção para determinados ataques na camada de aplicação (camada 7 do modelo OSI), que pode incluir restrições baseadas em conexão e outras medidas técnicas para ataques como Slowloris, HTTP/2 Fast Reset Attack e outros padrões de ataque descritos nas Diretrizes. O Cliente reconhece que, embora DDoS Protection forneça proteção unmetered para ataques nas camadas 3 e 4, qualquer mitigação de ataque na camada 7 pelo DDoS Protection, incluindo restrições baseadas em conexão, poderá gerar tráfego cobrável. Para proteção abrangente contra ataques híbridos que combinem múltiplas camadas OSI, o Cliente poderá precisar ativar múltiplos produtos conforme especificado nas Diretrizes. O Cliente assume integral responsabilidade por indisponibilidade do serviço causada por configuração incorreta de regras do Azion Firewall ou de outros controles de segurança na plataforma. A AZION BUSCA CONSTANTEMENTE ATUALIZAR SEUS MECANISMOS DE SEGURANÇA PARA TORNAR SEUS SISTEMAS DE PROTEÇÃO MAIS EFETIVOS E REDUZIR O RISCO DE IMPACTOS ÀS APLICAÇÕES DO CLIENTE. NO ENTANTO, NÃO HÁ GARANTIA DE QUE O DDOS PROTECTION SERÁ CAPAZ DE PREVENIR TODOS OS POSSÍVEIS ATAQUES OU AMEAÇAS, PARTICULARMENTE ATAQUES QUE POSSAM EXIGIR CONFIGURAÇÕES, PRODUTOS OU SERVIÇOS ADICIONAIS. OS CLIENTES DEVEM MANTER CONTROLES DE SEGURANÇA TAMBÉM EM SUAS ORIGENS E CONSIDERAR A ATIVAÇÃO DE ADD-ONS APROPRIADOS, COMO WAF OU BOT MANAGER, DE ACORDO COM SEU CENÁRIO ESPECÍFICO DE AMEAÇAS. OS CLIENTES ASSUMEM TODOS OS RISCOS DE INDISPONIBILIDADE DE SERVIÇO DECORRENTES DE REGRAS MAL CONFIGURADAS NO SERVIÇO OU DA SELEÇÃO INADEQUADA DE PRODUTOS PARA SEUS VETORES ESPECÍFICOS DE ATAQUE. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, DDoS Protection está incluído no Firewall e não é cobrado como Produto ou Serviço separado. +**DDoS Protection:** recurso habilitado por padrão na Azion e fornecido exclusivamente de acordo com os termos disponíveis em [https://www.azion.com/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/](https://www.azion.com/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) (“Diretrizes”). Ao utilizar a Azion, o Cliente: (i) autoriza a Azion a impor as medidas técnicas disponíveis na Azion Platform para controlar ou mitigar ataques DDoS, ainda que tais medidas possam resultar em degradação de performance; e (ii) reconhece que o Acordo de Nível de Serviço ("SLA") não se aplica enquanto um ataque DDoS estiver em andamento. DDoS Protection fornece: (a) proteção unmetered para ataques nas camadas de rede e transporte (camadas 3 e 4 do modelo OSI), incluindo, sem limitação, UDP Flood, TCP SYN Flood, ICMP Flood e outros ataques volumétricos conforme especificado nas Diretrizes; e (b) proteção para determinados ataques na camada de aplicação (camada 7 do modelo OSI), que pode incluir restrições baseadas em conexão e outras medidas técnicas para ataques como Slowloris, HTTP/2 Fast Reset Attack e outros padrões de ataque descritos nas Diretrizes. O Cliente reconhece que, embora DDoS Protection forneça proteção unmetered para ataques nas camadas 3 e 4, qualquer mitigação de ataque na camada 7 pelo DDoS Protection, incluindo restrições baseadas em conexão, poderá gerar tráfego cobrável. Para proteção abrangente contra ataques híbridos que combinem múltiplas camadas OSI, o Cliente poderá precisar ativar múltiplos produtos conforme especificado nas Diretrizes. O Cliente assume integral responsabilidade por indisponibilidade do serviço causada por configuração incorreta de regras do Azion Firewall ou de outros controles de segurança na plataforma. A AZION BUSCA CONSTANTEMENTE ATUALIZAR SEUS MECANISMOS DE SEGURANÇA PARA TORNAR SEUS SISTEMAS DE PROTEÇÃO MAIS EFETIVOS E REDUZIR O RISCO DE IMPACTOS ÀS APLICAÇÕES DO CLIENTE. NO ENTANTO, NÃO HÁ GARANTIA DE QUE O DDOS PROTECTION SERÁ CAPAZ DE PREVENIR TODOS OS POSSÍVEIS ATAQUES OU AMEAÇAS, PARTICULARMENTE ATAQUES QUE POSSAM EXIGIR CONFIGURAÇÕES, PRODUTOS OU SERVIÇOS ADICIONAIS. OS CLIENTES DEVEM MANTER CONTROLES DE SEGURANÇA TAMBÉM EM SUAS ORIGENS E CONSIDERAR A ATIVAÇÃO DE ADD-ONS APROPRIADOS, COMO WAF OU BOT MANAGER, DE ACORDO COM SEU CENÁRIO ESPECÍFICO DE AMEAÇAS. OS CLIENTES ASSUMEM TODOS OS RISCOS DE INDISPONIBILIDADE DE SERVIÇO DECORRENTES DE REGRAS MAL CONFIGURADAS NO SERVIÇO OU DA SELEÇÃO INADEQUADA DE PRODUTOS PARA SEUS VETORES ESPECÍFICOS DE ATAQUE. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, DDoS Protection está incluído no Firewall e não é cobrado como Produto ou Serviço separado. **Edge DNS:** projetado para fornecer um serviço de DNS autoritativo com suporte a tipos padrão de registros DNS, incluindo QTYPEs como A, AAAA, ANAME, CAA, CNAME, MX, NS, PTR, SRV e TXT. Para adotar o Edge DNS, o Cliente deve alterar os servidores DNS autoritativos junto ao órgão de registro no qual o domínio é gerenciado, para que o domínio passe a utilizar os name servers da Azion. O Cliente é responsável por renovar seus nomes de domínio e garantir a configuração correta das zonas, registros e respostas que deseja fornecer por meio do serviço de DNS. Portanto, a Azion não se responsabiliza por qualquer falha, limitação, atraso de propagação, erro de resolução, indisponibilidade de domínio ou impacto no serviço causado por configurações de DNS incorretas, incompletas, não autorizadas, desatualizadas ou externas. A Azion está autorizada a remover zonas que não estejam em uso. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, a cobrança do Edge DNS se dará por: (a) Zones e (b) Queries, de acordo com os volumes consumidos. diff --git a/apps/docs/src/content/docs/pt-br/pages/contratos/tos/index.mdx b/apps/docs/src/content/docs/pt-br/pages/contratos/tos/index.mdx index a1df263fd1..a60b7075ee 100644 --- a/apps/docs/src/content/docs/pt-br/pages/contratos/tos/index.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/contratos/tos/index.mdx @@ -44,7 +44,7 @@ A Azion trabalha constantemente para melhorar suas soluções. Consequentemente, **Data Stream:** projetado para coletar, formatar e enviar dados gerados por Produtos e Serviços Azion para a infraestrutura do Cliente ou sistemas de terceiros por meio de protocolos e integrações suportados. O Cliente escolherá quais dados serão coletados e, ao fazê-lo, automaticamente declara que está autorizado a coletar todos os dados selecionados. A AZION NÃO SE RESPONSABILIZA: (A) PELO USO DOS DADOS PELO CLIENTE; OU (B) PELO DIREITO DO CLIENTE DE COLETAR DADOS DE SEUS USUÁRIOS. Os dados coletados são enviados para a infraestrutura do Cliente utilizando o protocolo escolhido pelo Cliente na interface do Azion Console ou API, formatados em NDJSON (Newline Delimited JSON) em um template configurável. Os dados são enviados em blocos de 2.000 registros separados por “\n” (Newline), ou 60 segundos, o que ocorrer antes. A Azion adotará medidas razoáveis, compatíveis com a natureza do serviço, para enviar os dados à infraestrutura do Cliente, ou de seus fornecedores, em tempo real ou com atraso inferior a 3 minutos. No entanto, em casos de picos de acesso, ataques ou causas externas, o atraso poderá ser maior. O CLIENTE É RESPONSÁVEL PELA DISPONIBILIDADE DA INFRAESTRUTURA PARA RECEBER OS DADOS E, EM CASO DE INDISPONIBILIDADE, A AZION PODERÁ DESCARTAR OS DADOS. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, a cobrança do Data Stream se dará por: (a) Requests e (b) Data Transfer, de acordo com os volumes consumidos. -**DDoS Protection:** recurso habilitado por padrão na Azion e fornecido exclusivamente de acordo com os termos disponíveis em [https://www.azion.com/pt-br/documentacao/plataforma/workloads/#ddos-protection](https://www.azion.com/pt-br/documentacao/plataforma/workloads/#ddos-protection) (“Diretrizes”). Ao utilizar a Azion, o Cliente: (i) autoriza a Azion a impor as medidas técnicas disponíveis na Azion Platform para controlar ou mitigar ataques DDoS, ainda que tais medidas possam resultar em degradação de performance; e (ii) reconhece que o Acordo de Nível de Serviço ("SLA") não se aplica enquanto um ataque DDoS estiver em andamento. DDoS Protection fornece: (a) proteção unmetered para ataques nas camadas de rede e transporte (camadas 3 e 4 do modelo OSI), incluindo, sem limitação, UDP Flood, TCP SYN Flood, ICMP Flood e outros ataques volumétricos conforme especificado nas Diretrizes; e (b) proteção para determinados ataques na camada de aplicação (camada 7 do modelo OSI), que pode incluir restrições baseadas em conexão e outras medidas técnicas para ataques como Slowloris, HTTP/2 Fast Reset Attack e outros padrões de ataque descritos nas Diretrizes. O Cliente reconhece que, embora DDoS Protection forneça proteção unmetered para ataques nas camadas 3 e 4, qualquer mitigação de ataque na camada 7 pelo DDoS Protection, incluindo restrições baseadas em conexão, poderá gerar tráfego cobrável. Para proteção abrangente contra ataques híbridos que combinem múltiplas camadas OSI, o Cliente poderá precisar ativar múltiplos produtos conforme especificado nas Diretrizes. O Cliente assume integral responsabilidade por indisponibilidade do serviço causada por configuração incorreta de regras do Azion Firewall ou de outros controles de segurança na plataforma. A AZION BUSCA CONSTANTEMENTE ATUALIZAR SEUS MECANISMOS DE SEGURANÇA PARA TORNAR SEUS SISTEMAS DE PROTEÇÃO MAIS EFETIVOS E REDUZIR O RISCO DE IMPACTOS ÀS APLICAÇÕES DO CLIENTE. NO ENTANTO, NÃO HÁ GARANTIA DE QUE O DDOS PROTECTION SERÁ CAPAZ DE PREVENIR TODOS OS POSSÍVEIS ATAQUES OU AMEAÇAS, PARTICULARMENTE ATAQUES QUE POSSAM EXIGIR CONFIGURAÇÕES, PRODUTOS OU SERVIÇOS ADICIONAIS. OS CLIENTES DEVEM MANTER CONTROLES DE SEGURANÇA TAMBÉM EM SUAS ORIGENS E CONSIDERAR A ATIVAÇÃO DE ADD-ONS APROPRIADOS, COMO WAF OU BOT MANAGER, DE ACORDO COM SEU CENÁRIO ESPECÍFICO DE AMEAÇAS. OS CLIENTES ASSUMEM TODOS OS RISCOS DE INDISPONIBILIDADE DE SERVIÇO DECORRENTES DE REGRAS MAL CONFIGURADAS NO SERVIÇO OU DA SELEÇÃO INADEQUADA DE PRODUTOS PARA SEUS VETORES ESPECÍFICOS DE ATAQUE. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, DDoS Protection está incluído no Firewall e não é cobrado como Produto ou Serviço separado. +**DDoS Protection:** recurso habilitado por padrão na Azion e fornecido exclusivamente de acordo com os termos disponíveis em [https://www.azion.com/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/](https://www.azion.com/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) (“Diretrizes”). Ao utilizar a Azion, o Cliente: (i) autoriza a Azion a impor as medidas técnicas disponíveis na Azion Platform para controlar ou mitigar ataques DDoS, ainda que tais medidas possam resultar em degradação de performance; e (ii) reconhece que o Acordo de Nível de Serviço ("SLA") não se aplica enquanto um ataque DDoS estiver em andamento. DDoS Protection fornece: (a) proteção unmetered para ataques nas camadas de rede e transporte (camadas 3 e 4 do modelo OSI), incluindo, sem limitação, UDP Flood, TCP SYN Flood, ICMP Flood e outros ataques volumétricos conforme especificado nas Diretrizes; e (b) proteção para determinados ataques na camada de aplicação (camada 7 do modelo OSI), que pode incluir restrições baseadas em conexão e outras medidas técnicas para ataques como Slowloris, HTTP/2 Fast Reset Attack e outros padrões de ataque descritos nas Diretrizes. O Cliente reconhece que, embora DDoS Protection forneça proteção unmetered para ataques nas camadas 3 e 4, qualquer mitigação de ataque na camada 7 pelo DDoS Protection, incluindo restrições baseadas em conexão, poderá gerar tráfego cobrável. Para proteção abrangente contra ataques híbridos que combinem múltiplas camadas OSI, o Cliente poderá precisar ativar múltiplos produtos conforme especificado nas Diretrizes. O Cliente assume integral responsabilidade por indisponibilidade do serviço causada por configuração incorreta de regras do Azion Firewall ou de outros controles de segurança na plataforma. A AZION BUSCA CONSTANTEMENTE ATUALIZAR SEUS MECANISMOS DE SEGURANÇA PARA TORNAR SEUS SISTEMAS DE PROTEÇÃO MAIS EFETIVOS E REDUZIR O RISCO DE IMPACTOS ÀS APLICAÇÕES DO CLIENTE. NO ENTANTO, NÃO HÁ GARANTIA DE QUE O DDOS PROTECTION SERÁ CAPAZ DE PREVENIR TODOS OS POSSÍVEIS ATAQUES OU AMEAÇAS, PARTICULARMENTE ATAQUES QUE POSSAM EXIGIR CONFIGURAÇÕES, PRODUTOS OU SERVIÇOS ADICIONAIS. OS CLIENTES DEVEM MANTER CONTROLES DE SEGURANÇA TAMBÉM EM SUAS ORIGENS E CONSIDERAR A ATIVAÇÃO DE ADD-ONS APROPRIADOS, COMO WAF OU BOT MANAGER, DE ACORDO COM SEU CENÁRIO ESPECÍFICO DE AMEAÇAS. OS CLIENTES ASSUMEM TODOS OS RISCOS DE INDISPONIBILIDADE DE SERVIÇO DECORRENTES DE REGRAS MAL CONFIGURADAS NO SERVIÇO OU DA SELEÇÃO INADEQUADA DE PRODUTOS PARA SEUS VETORES ESPECÍFICOS DE ATAQUE. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, DDoS Protection está incluído no Firewall e não é cobrado como Produto ou Serviço separado. **Edge DNS:** projetado para fornecer um serviço de DNS autoritativo com suporte a tipos padrão de registros DNS, incluindo QTYPEs como A, AAAA, ANAME, CAA, CNAME, MX, NS, PTR, SRV e TXT. Para adotar o Edge DNS, o Cliente deve alterar os servidores DNS autoritativos junto ao órgão de registro no qual o domínio é gerenciado, para que o domínio passe a utilizar os name servers da Azion. O Cliente é responsável por renovar seus nomes de domínio e garantir a configuração correta das zonas, registros e respostas que deseja fornecer por meio do serviço de DNS. Portanto, a Azion não se responsabiliza por qualquer falha, limitação, atraso de propagação, erro de resolução, indisponibilidade de domínio ou impacto no serviço causado por configurações de DNS incorretas, incompletas, não autorizadas, desatualizadas ou externas. A Azion está autorizada a remover zonas que não estejam em uso. Salvo disposição em contrário no Contrato de Cliente ou quaisquer documentos anexos a ele, a cobrança do Edge DNS se dará por: (a) Zones e (b) Queries, de acordo com os volumes consumidos. diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/configs/azion-config-js.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/configs/azion-config-js.mdx index b85393c430..5595b0fef4 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/configs/azion-config-js.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/configs/azion-config-js.mdx @@ -528,7 +528,7 @@ Com `azion deploy`, um deployment serve a Application que o deploy cria para o p ### Custom Pages -Cada entrada de `customPages` declara um conjunto de [custom pages](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/), as páginas que a Azion retorna no lugar de uma resposta de erro. +Cada entrada de `customPages` declara um conjunto de [custom pages](/pt-br/documentacao/plataforma/custom-pages/configuracoes/), as páginas que a Azion retorna no lugar de uma resposta de erro. | Propriedade | Tipo | Obrigatório | Descrição | | --- | --- | --- | --- | diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/crl.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/crl.mdx index f48db6d250..cfad9a9b03 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/crl.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/crl.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Os comandos `crl` da Azion CLI criam, listam, descrevem, atualizam e excluem listas de revogação de certificados (CRLs) em [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#listas-de-revogacao-de-certificados). Uma CRL é uma lista de certificados revogados que uma autoridade certificadora (CA) emite, e a CLI a envia a partir de um arquivo em formato PEM. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). +Os comandos `crl` da Azion CLI criam, listam, descrevem, atualizam e excluem listas de revogação de certificados (CRLs) em [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/#listas-de-revogacao-de-certificados). Uma CRL é uma lista de certificados revogados que uma autoridade certificadora (CA) emite, e a CLI a envia a partir de um arquivo em formato PEM. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). --- @@ -253,7 +253,7 @@ Updated Certificate Revocation List with ID 1237 As opções que todo comando aceita, como `--format`, `--out` e `-y`. - Os campos de uma CRL, o limite de tamanho dela e como um workload com mTLS a usa. + Os campos de uma CRL, o limite de tamanho dela e como um workload com mTLS a usa. Os comandos que enviam e gerenciam os certificados que Certificate Manager armazena. Os comandos que criam e gerenciam solicitações de assinatura de certificado em Certificate Manager. diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx index f7a943a2ce..1fe73b6dea 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Os comandos `csr` da Azion CLI criam, descrevem e excluem solicitações de assinatura de certificado (CSRs) em [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). Uma CSR é a solicitação que você envia a uma autoridade certificadora (CA) para obter um certificado, e a CLI a imprime quando cria uma. A Azion armazena uma CSR como um certificado digital com status `pending`, por isso a CSR e os seus certificados compartilham um mesmo conjunto de IDs. A CLI não tem comando que liste ou atualize uma CSR: `azion list digital-certificate` a lista com os seus certificados, e os [comandos digital-certificate](/pt-br/documentacao/devtools/cli/recursos/digital-certificate/) gerenciam a entrada. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). +Os comandos `csr` da Azion CLI criam, descrevem e excluem solicitações de assinatura de certificado (CSRs) em [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/). Uma CSR é a solicitação que você envia a uma autoridade certificadora (CA) para obter um certificado, e a CLI a imprime quando cria uma. A Azion armazena uma CSR como um certificado digital com status `pending`, por isso a CSR e os seus certificados compartilham um mesmo conjunto de IDs. A CLI não tem comando que liste ou atualize uma CSR: `azion list digital-certificate` a lista com os seus certificados, e os [comandos digital-certificate](/pt-br/documentacao/devtools/cli/recursos/digital-certificate/) gerenciam a entrada. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). --- @@ -54,7 +54,7 @@ Created Certificate Signing Request with ID 123481 | `--organization-unity` | — | string | — | Unidade organizacional do subject do certificado. | | `--state` | — | string | — | Estado ou província do subject do certificado. | -Um valor de `--key-algorithm` fora dos três listados é recusado com `"rsa_1024" is not a valid choice.` Um `--name` que um certificado da sua conta já usa é recusado com `This field must be unique.` Cada nome em `--common-name` e `--alternative-names` precisa pertencer a um domínio para o qual a sua conta tem permissão. Os limites de cada campo estão em [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). +Um valor de `--key-algorithm` fora dos três listados é recusado com `"rsa_1024" is not a valid choice.` Um `--name` que um certificado da sua conta já usa é recusado com `This field must be unique.` Cada nome em `--common-name` e `--alternative-names` precisa pertencer a um domínio para o qual a sua conta tem permissão. Os limites de cada campo estão em [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). --- @@ -181,7 +181,7 @@ Created Certificate Signing Request with ID 123482 As opções que todo comando aceita, como `--format`, `--out` e `-y`. - Os campos de uma CSR, os limites deles e como adicionar o certificado que a CA assina. + Os campos de uma CSR, os limites deles e como adicionar o certificado que a CA assina. Os comandos que listam as suas CSRs com os seus certificados e gerenciam cada entrada. Cada recurso que a CLI gerencia e os verbos que cada um aceita. diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/custom-pages.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/custom-pages.mdx index d7150e5a52..a47a9548ce 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/custom-pages.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/custom-pages.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Os comandos `custom-pages` da Azion CLI criam, listam, descrevem, atualizam e excluem conjuntos de custom pages, o recurso [Custom Pages](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/) que substitui as respostas de erro de um workload por páginas servidas a partir de um connector. Esses comandos gerenciam o conjunto e não o atribuem a um workload: defina **Custom Page** nas configurações de deployment do workload no Azion Console, passe `--custom-page` para o [`azion create workload-deployment`](/pt-br/documentacao/devtools/cli/recursos/workload-deployment/#criar) ao criar o deployment ou indique o conjunto na entrada [`deployments`](/pt-br/documentacao/devtools/cli/azion-config-js/#deployments-do-workload) do `azion.config.js`. A CLI não tem comando que atualiza um deployment, então, em um workload que já tem um, atribua o conjunto no Azion Console. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais da Azion CLI](/pt-br/documentacao/devtools/cli/globals/). +Os comandos `custom-pages` da Azion CLI criam, listam, descrevem, atualizam e excluem conjuntos de custom pages, o recurso [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) que substitui as respostas de erro de um workload por páginas servidas a partir de um connector. Esses comandos gerenciam o conjunto e não o atribuem a um workload: defina **Custom Page** nas configurações de deployment do workload no Azion Console, passe `--custom-page` para o [`azion create workload-deployment`](/pt-br/documentacao/devtools/cli/recursos/workload-deployment/#criar) ao criar o deployment ou indique o conjunto na entrada [`deployments`](/pt-br/documentacao/devtools/cli/azion-config-js/#deployments-do-workload) do `azion.config.js`. A CLI não tem comando que atualiza um deployment, então, em um workload que já tem um, atribua o conjunto no Azion Console. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais da Azion CLI](/pt-br/documentacao/devtools/cli/globals/). --- @@ -222,7 +222,7 @@ O arquivo traz os campos do conjunto: - `pages` contém uma entrada por código de status. Cada entrada traz o código de status em `code`, como uma string, por exemplo `"404"`, e um objeto `page`. - `page.type` é `page_connector`, e `page.attributes` traz `connector`, o ID do connector que serve a página, `ttl` e `uri`, o caminho da página nesse connector. -Para saber o que cada campo faz e os valores que ele aceita, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/). +Para saber o que cada campo faz e os valores que ele aceita, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/). Uma página do tipo `page_default` que traz somente `ttl` é recusada antes de o conjunto ser criado, embora o arquivo seja um JSON válido: @@ -239,7 +239,7 @@ Na atualização, o arquivo traz somente os campos a alterar, e os campos que el As opções que todo comando aceita, como `--format`, `--out` e `-y`. - Os campos de um conjunto de custom pages, os códigos de status que ele pode substituir e como uma página obtém seu conteúdo de um connector. + Os campos de um conjunto de custom pages, os códigos de status que ele pode substituir e como uma página obtém seu conteúdo de um connector. Os comandos que criam e gerenciam o connector que serve as páginas de um conjunto. Os comandos que indicam um conjunto de custom pages ao criar o deployment de um workload. A entrada `deployments` que atribui um conjunto de custom pages a um workload. diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/digital-certificate.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/digital-certificate.mdx index c4b0199dac..177916d26a 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/digital-certificate.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/digital-certificate.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Os comandos `digital-certificate` da Azion CLI criam, listam, descrevem, atualizam e excluem os [certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) que Certificate Manager armazena para TLS. Um certificado é um certificado de servidor que você envia com a chave privada dele ou solicita à Let's Encrypt, ou um certificado de CA confiável que verifica certificados de cliente. Esses comandos armazenam o certificado e não o vinculam a um workload. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). +Os comandos `digital-certificate` da Azion CLI criam, listam, descrevem, atualizam e excluem os [certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/) que Certificate Manager armazena para TLS. Um certificado é um certificado de servidor que você envia com a chave privada dele ou solicita à Let's Encrypt, ou um certificado de CA confiável que verifica certificados de cliente. Esses comandos armazenam o certificado e não o vinculam a um workload. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). --- @@ -46,7 +46,7 @@ O comando imprime `Requested` em vez de `Created`: Requested Digital Certificate with ID 123479 ``` -Para saber o que cada desafio exige antes que a Let's Encrypt emita o certificado, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Para saber o que cada desafio exige antes que a Let's Encrypt emita o certificado, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). ### Flags @@ -135,7 +135,7 @@ Last Modified: "2026-01-01T12:00:14.812268Z" Renewed At: null ``` -Com `--format json`, o comando imprime o objeto completo: `active`, `authority`, `certificate`, `challenge`, `created_at`, `csr`, `id`, `issuer`, `key_algorithm`, `last_editor`, `last_modified`, `managed`, `name`, `product_version`, `renewed_at`, `status`, `status_detail`, `subject_name`, `type` e `validity`. O campo `certificate` contém o texto PEM do certificado, e o objeto não traz nenhuma chave privada. Um certificado solicitado tem `managed` definido como `true`. Para saber o que cada status significa, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#status). +Com `--format json`, o comando imprime o objeto completo: `active`, `authority`, `certificate`, `challenge`, `created_at`, `csr`, `id`, `issuer`, `key_algorithm`, `last_editor`, `last_modified`, `managed`, `name`, `product_version`, `renewed_at`, `status`, `status_detail`, `subject_name`, `type` e `validity`. O campo `certificate` contém o texto PEM do certificado, e o objeto não traz nenhuma chave privada. Um certificado solicitado tem `managed` definido como `true`. Para saber o que cada status significa, consulte [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#status). ### Flags @@ -291,7 +291,7 @@ Updated Digital Certificate with ID 123478 As opções que todo comando aceita, como `--format`, `--out` e `-y`. - Cada campo, status e algoritmo de chave de um certificado armazenado. + Cada campo, status e algoritmo de chave de um certificado armazenado. Os comandos que criam uma solicitação de assinatura de certificado, que compartilha o espaço de IDs dos certificados. Os comandos que gerenciam o workload que serve um certificado por TLS. diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/workload-deployment.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/workload-deployment.mdx index 76a794d0d9..fc9f13e416 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/workload-deployment.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/workload-deployment.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Os comandos `workload-deployment` da Azion CLI criam, listam e descrevem o deployment de um [workload](/pt-br/documentacao/plataforma/workloads/). O deployment nomeia a aplicação que responde aos domínios do workload e, opcionalmente, o [firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições antes e o [conjunto de custom pages](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/) que substitui as respostas de erro. Um workload tem um deployment, então o `azion create workload-deployment` só funciona em um workload que ainda não tem um. A CLI não tem comando que atualiza ou exclui um deployment. Para alterar o deployment de um workload, defina os campos dele nas configurações de deployment do workload no Azion Console. Um projeto que declara o workload no `azion.config.js` recebe o deployment da entrada [`deployments`](/pt-br/documentacao/devtools/cli/azion-config-js/#deployments-do-workload) quando você roda `azion deploy`. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). Esta página corresponde à Azion CLI 4.24.0. +Os comandos `workload-deployment` da Azion CLI criam, listam e descrevem o deployment de um [workload](/pt-br/documentacao/plataforma/workloads/). O deployment nomeia a aplicação que responde aos domínios do workload e, opcionalmente, o [firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições antes e o [conjunto de custom pages](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) que substitui as respostas de erro. Um workload tem um deployment, então o `azion create workload-deployment` só funciona em um workload que ainda não tem um. A CLI não tem comando que atualiza ou exclui um deployment. Para alterar o deployment de um workload, defina os campos dele nas configurações de deployment do workload no Azion Console. Um projeto que declara o workload no `azion.config.js` recebe o deployment da entrada [`deployments`](/pt-br/documentacao/devtools/cli/azion-config-js/#deployments-do-workload) quando você roda `azion deploy`. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/). Esta página corresponde à Azion CLI 4.24.0. --- diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/terraform/resources/certificates.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/terraform/resources/certificates.mdx index 1a8fa16eb6..a7bf7c28a5 100644 --- a/apps/docs/src/content/docs/pt-br/pages/devtools/terraform/resources/certificates.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/devtools/terraform/resources/certificates.mdx @@ -15,7 +15,7 @@ import DocItem from '@aziontech/webkit/doc-item' -Um certificado digital é o par de certificado SSL/TLS e chave privada que permite a uma aplicação responder por HTTPS. O Azion Terraform Provider gerencia os certificados do [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) com quatro recursos e os lê com quatro data sources. Além de enviar um certificado que você já tem, o provider pode solicitar um certificado Let's Encrypt, criar uma solicitação de assinatura de certificado (CSR) e enviar uma lista de revogação de certificados (CRL) para mTLS. +Um certificado digital é o par de certificado SSL/TLS e chave privada que permite a uma aplicação responder por HTTPS. O Azion Terraform Provider gerencia os certificados do [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/) com quatro recursos e os lê com quatro data sources. Além de enviar um certificado que você já tem, o provider pode solicitar um certificado Let's Encrypt, criar uma solicitação de assinatura de certificado (CSR) e enviar uma lista de revogação de certificados (CRL) para mTLS. --- diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx index d21db25584..668d6c3b50 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/akamai-to-azion/akamai-to-azion-comprehensive-guide.mdx @@ -138,7 +138,7 @@ Todo produto da Akamai do inventário tem um destino na Azion. Encontre o produt | API Gateway | Registro, roteamento, entrega e proteção de APIs | Applications, [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/), Functions e Firewall | | API Prioritization Cloudlet | Priorização do tráfego de APIs | Rules Engine e Application Accelerator | | API Security | Fluxos de descoberta, monitoramento e proteção de APIs | Firewall, [Web Application Firewall](/pt-br/documentacao/plataforma/firewall/waf/primeiros-passos/) e Applications | -| App & API Protector | Proteção de aplicações e APIs contra vulnerabilidades, abuso e ameaças distribuídas | Firewall, Web Application Firewall, [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) e [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/primeiros-passos/) | +| App & API Protector | Proteção de aplicações e APIs contra vulnerabilidades, abuso e ameaças distribuídas | Firewall, Web Application Firewall, [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) e [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/primeiros-passos/) | | App Platform | Deployment gerenciado de aplicações em contêineres | [Orchestrator](/pt-br/documentacao/plataforma/orchestrator/), que provisiona e gerencia serviços em nós que você opera | | Application Load Balancer Cloudlet | Balanceamento de carga de aplicações para performance e disponibilidade | [Load Balancer](/pt-br/documentacao/plataforma/connectors/load-balancer/primeiros-passos/), ativado em um connector | | Audience Segmentation Cloudlet | Segmentação por cookie, testes A/B e padrões de afinidade de sessão | Critérios do Rules Engine sobre cookies e grupos de dispositivos | @@ -1049,7 +1049,7 @@ A resposta traz `"state": "pending"` e a regra. Uma requisição correspondente ## Conte com DDoS Protection -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) assume o papel do Prolexic para o tráfego que a Azion atende. Ele está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação nas camadas 3, 4, 6 e 7. Exemplos são floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) assume o papel do Prolexic para o tráfego que a Azion atende. Ele está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação nas camadas 3, 4, 6 e 7. Exemplos são floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris. | Aspecto | Akamai Prolexic e produtos de DDoS | Azion DDoS Protection | | --- | --- | --- | @@ -1321,7 +1321,7 @@ Uma aplicação de página única é medida uma vez por carregamento completo da ## Prepare o certificado -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o hostname apontar para a Azion, para que os usuários acessem a property por HTTPS desde a primeira requisição. +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o hostname apontar para a Azion, para que os usuários acessem a property por HTTPS desde a primeira requisição. | Opção de certificado | Use para | | --- | --- | @@ -1365,7 +1365,7 @@ Para uma migração a partir da Akamai, use DNS-01. -Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para DNS-01, verifique o CNAME `_acme-challenge`. Confirme que o hostname está nos **Domains** do workload certo antes da mudança de DNS. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para DNS-01, verifique o CNAME `_acme-challenge`. Confirme que o hostname está nos **Domains** do workload certo antes da mudança de DNS. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). --- diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/aws-to-azion/aws-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/aws-to-azion/aws-to-azion-comprehensive-guide.mdx index ee589a1777..a0958bd9b5 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/aws-to-azion/aws-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/aws-to-azion/aws-to-azion-comprehensive-guide.mdx @@ -161,7 +161,7 @@ Todo produto da AWS do inventário tem um destino na Azion. Encontre o produto n | AWS WAF Bot Control | Detecção e mitigação gerenciadas de bots | [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/primeiros-passos/) e [Bot Manager Lite](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/bot-manager-lite/) | | Regras baseadas em taxa do AWS WAF | Rate limits por IP, headers, URI ou método | Firewall e Functions | | IP sets do AWS WAF | Listas reutilizáveis de IPs e CIDRs para regras de permissão ou bloqueio | [Network lists](/pt-br/documentacao/plataforma/firewall/network-shield/network-lists/) | -| AWS Shield Standard | Proteção DDoS padrão | [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) | +| AWS Shield Standard | Proteção DDoS padrão | [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) | | AWS Shield Advanced | Proteção DDoS com mais visibilidade e opções de mitigação | DDoS Protection | | Mitigação automática do Shield Advanced | Proteções de WAF criadas durante ataques à camada de aplicação | DDoS Protection e Web Application Firewall | | AWS Network Firewall | Firewall de rede gerenciado para uma VPC | Firewall e [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/primeiros-passos/) | @@ -173,7 +173,7 @@ Todo produto da AWS do inventário tem um destino na Azion. Encontre o produto n | Signed URLs e cookies do CloudFront | Acesso a conteúdo privado | Rules Engine para Applications, Functions e a integração [Secure Token](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/secure-token/) em um firewall | | Restrições geográficas do CloudFront | Acesso permitido ou bloqueado por país | Rules Engine para Applications e Network Shield | | Amazon Route 53 | DNS autoritativo, registro, políticas de roteamento e health checks | Edge DNS | -| AWS Certificate Manager | Certificados TLS: provisionamento, importação, implantação e renovação | [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) | +| AWS Certificate Manager | Certificados TLS: provisionamento, importação, implantação e renovação | [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/) | | AWS Private CA | Autoridades certificadoras privadas | Certificate Manager, que guarda certificados Trusted CA | | AWS Private CA para autenticação de clientes | Autenticação de clientes baseada em certificados | [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) | | AWS IoT Greengrass | Componentes gerenciados e processamento local nos dispositivos | Orchestrator | @@ -1914,7 +1914,7 @@ O ID da lista é um inteiro JSON. Um ID enviado como string é recusado com `250 ## Conte com DDoS Protection -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação, como floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris, nas camadas 3, 4, 6 e 7. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação, como floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris, nas camadas 3, 4, 6 e 7. | Aspecto | AWS Shield | Azion DDoS Protection | | --- | --- | --- | @@ -2326,7 +2326,7 @@ Cada visitante executa um teste a cada 30 minutos. Azion Console não tem uma p ## Prepare o certificado -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o projeto por HTTPS desde a primeira requisição. +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o projeto por HTTPS desde a primeira requisição. | Área | AWS Certificate Manager | Azion Certificate Manager | | --- | --- | --- | @@ -2381,7 +2381,7 @@ Para solicitar o certificado no Azion Console: A primeira tentativa acontece em até 5 minutos depois de salvar, e as novas tentativas seguem aos 5, 10, 15, 20 e 30 minutos, depois em um ritmo mais lento. O status passa de `pending` para `challenge_verification` e depois para `active` ou `failed`. -Para enviar um certificado exportado do ACM, vá para **Certificate Manager** e crie um certificado digital com o preset **Server Certificate**. Cole o certificado PEM e a chave privada. Os certificados intermediários vão no mesmo campo do certificado. Depois selecione-o no campo **Digital Certificate** do workload. Para os passos, consulte [Faça upload de um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/), e para cada campo de certificado, [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). +Para enviar um certificado exportado do ACM, vá para **Certificate Manager** e crie um certificado digital com o preset **Server Certificate**. Cole o certificado PEM e a chave privada. Os certificados intermediários vão no mesmo campo do certificado. Depois selecione-o no campo **Digital Certificate** do workload. Para os passos, consulte [Faça upload de um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/), e para cada campo de certificado, [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). @@ -2403,7 +2403,7 @@ Para enviar um certificado exportado do ACM, vá para **Certificate Manager** e -Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Em uma falha de handshake TLS, verifique se o certificado cobre o hostname e se os intermediários estão no campo do certificado. Depois verifique o `minimum_version` do workload. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Em uma falha de handshake TLS, verifique se o certificado cobre o hostname e se os intermediários estão no campo do certificado. Depois verifique o `minimum_version` do workload. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). O mTLS precisa de um certificado Trusted CA, e um certificado gerado pela Azion não pode ser o Trusted CA. Um certificado do AWS Private CA pode ser exportado e enviado com o preset **Trusted CA Certificate**. Depois defina `mtls.enabled`, `mtls.config.certificate` e `verification`, `enforce` ou `permissive`, no workload pela API ou com `azion update workload --file`. O mTLS funciona apenas por HTTPS. Para os passos, consulte [Configure o mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/) e [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/). diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx index 70e2edb566..070020b9f0 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/cloudflare-to-azion/cf-to-azion-comprehensive-guide.mdx @@ -136,14 +136,14 @@ Todo produto da Cloudflare do inventário tem um destino na Azion. Encontre o pr | AI Gateway | Observação, cache, rate limiting e controle de tráfego de IA | Functions, Cache, Real-Time Events e Data Stream | | AI Search | Pipelines gerenciados de recuperação e busca | SQL Database, com vector search, e AI Inference | | Analytics | Analytics dos serviços da Cloudflare | Real-Time Metrics, Real-Time Events, Data Stream e [Edge Pulse](/pt-br/documentacao/plataforma/edge-pulse/) | -| API Shield | Descoberta de APIs, validação de schema, mTLS e controles | Firewall, [Web Application Firewall](/pt-br/documentacao/plataforma/firewall/waf/primeiros-passos/), Network Shield e [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) | +| API Shield | Descoberta de APIs, validação de schema, mTLS e controles | Firewall, [Web Application Firewall](/pt-br/documentacao/plataforma/firewall/waf/primeiros-passos/), Network Shield e [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) | | Bots | Detecção e mitigação de tráfego automatizado | [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/primeiros-passos/) e [Bot Manager Lite](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/bot-manager-lite/) | | Cache | Comportamento do cache da CDN | Cache, incluindo Tiered Cache | | Cloudflare for Platforms | Plataformas construídas sobre serviços da Cloudflare | Azion API e [Marketplace](/pt-br/documentacao/plataforma/marketplace/) | | Cloudflare Images | Armazenamento, redimensionamento, otimização e entrega de imagens | [Image Processor](/pt-br/documentacao/plataforma/applications/image-processor/primeiros-passos/), com as imagens armazenadas no Object Storage | | Cloudflare Network Firewall | Firewall como serviço para tráfego de rede | Firewall e Network Shield | | D1 | Banco de dados SQL serverless construído sobre SQLite | SQL Database | -| DDoS Protection | Proteção contra ataques DDoS | [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) | +| DDoS Protection | Proteção contra ataques DDoS | [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) | | Digital Experience Monitoring | Experiência de usuário, dispositivo, rede e aplicação | Edge Pulse e Real-Time Metrics | | DNS | DNS autoritativo e segurança de DNS | Edge DNS | | Dynamic Workers | Workers isolados criados sob demanda | Functions | @@ -887,7 +887,7 @@ O critério `${network}` requer Network Shield no firewall. Para as variáveis e ## Conte com DDoS Protection -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação, como floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris, nas camadas 3, 4, 6 e 7. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação, como floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris, nas camadas 3, 4, 6 e 7. | Aspecto | Cloudflare DDoS Protection | Azion DDoS Protection | | --- | --- | --- | @@ -1119,7 +1119,7 @@ Para um destino Object Storage, a credencial precisa de `listAllBucketNames`, `l ## Prepare o certificado -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o projeto por HTTPS desde a primeira requisição. +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o projeto por HTTPS desde a primeira requisição. | Área | Cloudflare SSL/TLS | Azion Certificate Manager | | --- | --- | --- | @@ -1169,7 +1169,7 @@ Para uma migração a partir da Cloudflare, use DNS-01. -Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). O mTLS precisa de um certificado Trusted CA, e um certificado gerado pela Azion não pode ser o Trusted CA. Envie-o e depois defina `mtls.enabled`, `mtls.config.certificate` e `verification`, `enforce` ou `permissive`, no workload pela API ou com `azion update workload --file`. O mTLS funciona apenas por HTTPS. Para os passos, consulte [Configure o mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/) e [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/). diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/disponibilidade/mostrar-a-sua-propria-pagina-quando-nenhuma-origem-responde.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/disponibilidade/mostrar-a-sua-propria-pagina-quando-nenhuma-origem-responde.mdx index c4f2305a59..9000a1eac2 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/disponibilidade/mostrar-a-sua-propria-pagina-quando-nenhuma-origem-responde.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/disponibilidade/mostrar-a-sua-propria-pagina-quando-nenhuma-origem-responde.mdx @@ -70,7 +70,7 @@ Os exemplos servem a página em `/errors/503.html` em um connector chamado `erro ## Crie um set com uma página para cada código -O set vincula `502`, `503` e `504` à mesma página. Nas [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/#status-codes), `502` é um gateway que recebeu uma resposta inválida, `503` um servidor que não está pronto e `504` um gateway que não recebeu resposta a tempo. Cada página responde com `503`, que marca uma condição temporária. +O set vincula `502`, `503` e `504` à mesma página. Nas [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#status-codes), `502` é um gateway que recebeu uma resposta inválida, `503` um servidor que não está pronto e `504` um gateway que não recebeu resposta a tempo. Cada página responde com `503`, que marca uma condição temporária. A página vem de um connector que não alcança nenhuma das suas origens, porque uma página buscada em uma origem que falha falha junto com ela. **Response TTL** define por quantos segundos a página fica em cache, de 0 a 31.536.000. Uma página de erro é estática e raramente muda, então um valor alto, como `86400`, um dia, afasta as requisições do connector da página. @@ -236,7 +236,7 @@ Para confirmar a página: -A resposta traz o status `503`, do **Response Custom Status Code** da página, e o corpo de `/errors/503.html`, não a página intitulada `Azion - Default error page`. Ela não traz header `Location`, então o cliente não é redirecionado. Se a página padrão ainda chegar depois que a alteração do deployment se propagou, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#custom-pages). +A resposta traz o status `503`, do **Response Custom Status Code** da página, e o corpo de `/errors/503.html`, não a página intitulada `Azion - Default error page`. Ela não traz header `Location`, então o cliente não é redirecionado. Se a página padrão ainda chegar depois que a alteração do deployment se propagou, consulte [Solucione problemas do Custom Pages](/pt-br/documentacao/plataforma/custom-pages/solucao-de-problemas/). No caso de uso [Manter uma aplicação no ar quando uma origem falha](/pt-br/documentacao/casos-de-uso/melhorar-performance-e-confiabilidade/manter-uma-aplicacao-no-ar-quando-uma-origem-falha/), espere: @@ -247,7 +247,7 @@ No caso de uso [Manter uma aplicação no ar quando uma origem falha](/pt-br/doc ## Próximos passos - + diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-customize-error-responses.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-customize-error-responses.mdx index 579d0186f5..fd0c410c67 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-customize-error-responses.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-customize-error-responses.mdx @@ -13,11 +13,11 @@ import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' -Você pode substituir as respostas de erro de um [workload](/pt-br/documentacao/plataforma/workloads/) por páginas suas, para vários códigos de status de uma vez, pelo Azion Console, pela [Azion CLI](/pt-br/documentacao/devtools/cli/) ou pela API. Para criar o seu primeiro conjunto com uma página e vê-la substituir um `404`, consulte [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/workloads/custom-pages/primeiros-passos/). +Você pode substituir as respostas de erro de um [workload](/pt-br/documentacao/plataforma/workloads/) por páginas suas, para vários códigos de status de uma vez, pelo Azion Console, pela [Azion CLI](/pt-br/documentacao/devtools/cli/) ou pela API. Para criar o seu primeiro conjunto com uma página e vê-la substituir um `404`, consulte [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/custom-pages/primeiros-passos/). -Com [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages), as páginas ficam em um conjunto de custom pages. Cada página responde a um código de status que o [connector](/pt-br/documentacao/plataforma/connectors/) da aplicação retorna, e o conjunto serve páginas apenas depois que o deployment do workload o nomeia. +Com [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/), as páginas ficam em um conjunto de custom pages. Cada página responde a um código de status que o [connector](/pt-br/documentacao/plataforma/connectors/) da aplicação retorna, e o conjunto serve páginas apenas depois que o deployment do workload o nomeia. -Uma aplicação que roda na API v3 define as suas páginas de erro em Error Responses. Para mais informações, consulte [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/). +Uma aplicação que roda na API v3 define as suas páginas de erro em Error Responses. Para mais informações, consulte [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/). --- @@ -69,7 +69,7 @@ Uma aplicação que roda na API v3 define as suas páginas de erro em Error Resp ## Crie um conjunto com uma página para cada código -Cada página do conjunto recebe o próprio código de status, caminho no connector, tempo de cache e código de status de resposta. Uma página também pode responder com um código diferente daquele que o connector retornou, como um `404` no lugar de um `403`. A Azion serve a página no próprio lugar, sem redirecionamento. Depois que você altera o documento de uma página, a Azion continua servindo a cópia em cache até que o tempo de cache dela termine. Para os códigos que uma página aceita e o intervalo de cada campo, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/#campos-da-pagina). +Cada página do conjunto recebe o próprio código de status, caminho no connector, tempo de cache e código de status de resposta. Uma página também pode responder com um código diferente daquele que o connector retornou, como um `404` no lugar de um `403`. A Azion serve a página no próprio lugar, sem redirecionamento. Depois que você altera o documento de uma página, a Azion continua servindo a cópia em cache até que o tempo de cache dela termine. Para os códigos que uma página aceita e o intervalo de cada campo, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#campos-da-pagina). @@ -281,15 +281,15 @@ Para uma página cujo código de status de resposta é `404`, a resposta começa HTTP/2 404 ``` -A resposta não traz header `Location`, então o cliente permanece na URL solicitada e não é redirecionado. Se a resposta de erro do próprio connector ainda chega depois que a mudança no deployment se propagou, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#custom-pages). +A resposta não traz header `Location`, então o cliente permanece na URL solicitada e não é redirecionado. Se a resposta de erro do próprio connector ainda chega depois que a mudança no deployment se propagou, consulte [Solucione problemas do Custom Pages](/pt-br/documentacao/plataforma/custom-pages/solucao-de-problemas/). --- ## Próximos passos - - + + - + diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx index a5d1039950..670a6d01ba 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-request-lets-encrypt-certificates-via-api.mdx @@ -10,7 +10,7 @@ permalink: /documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-g import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' -Você pode solicitar um certificado TLS assinado pela Let's Encrypt™ pela [Azion API](/pt-br/documentacao/devtools/api/#autenticacao), validado pelo desafio DNS-01 ou pelo desafio HTTP-01, inclusive um certificado wildcard. Para obter um certificado ao criar um [workload](/pt-br/documentacao/plataforma/workloads/) no Azion Console, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-lets-encrypt). +Você pode solicitar um certificado TLS assinado pela Let's Encrypt™ pela [Azion API](/pt-br/documentacao/devtools/api/#autenticacao), validado pelo desafio DNS-01 ou pelo desafio HTTP-01, inclusive um certificado wildcard. Para obter um certificado ao criar um [workload](/pt-br/documentacao/plataforma/workloads/) no Azion Console, consulte [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-lets-encrypt). Uma aplicação web servida por HTTPS precisa de um certificado TLS. A Let's Encrypt emite um certificado gratuitamente, e a Azion automatiza a emissão, a renovação e a desativação dele. A Azion renova o certificado antes que ele expire, desde que as configurações de validação dele continuem válidas e atualizadas. A renovação não precisa de janela de manutenção, e o certificado mantém as cotas, o faturamento e as permissões dele. @@ -28,7 +28,7 @@ Os dois desafios comprovam o controle do hostname de formas diferentes: - Um personal token, enviado no header `Authorization` como `Token [TOKEN VALUE]`. Para criar um, consulte [Gerencie um personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/). - O `curl` ou outro cliente HTTP. - O hostname que o certificado cobre, como `www.example.com`. -- Para DNS-01 com uma zona hospedada por outro provedor de DNS, o registro CNAME `_acme-challenge` do hostname, configurado nesse provedor. Uma zona no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) não precisa de registro. Para o nome e o valor do registro, consulte [Validação de domínio](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). +- Para DNS-01 com uma zona hospedada por outro provedor de DNS, o registro CNAME `_acme-challenge` do hostname, configurado nesse provedor. Uma zona no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) não precisa de registro. Para o nome e o valor do registro, consulte [Validação de domínio](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). - Para HTTP-01, o DNS do hostname, e de cada nome alternativo, apontado para a Azion. - Para um certificado wildcard, a zona do domínio configurada e ativa no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/). @@ -121,7 +121,7 @@ Depois de uma solicitação de certificado, a Azion valida o hostname e emite o Envie a requisição de novo até que o status mostre que a emissão terminou. Quando a emissão falha, o campo `status_detail` carrega o motivo, como `An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com`. -Para o significado de cada status, consulte [Status](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#status). Para as novas tentativas que a Azion faz depois de uma tentativa que falhou, consulte [Tempo de emissão e novas tentativas](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas). +Para o significado de cada status, consulte [Status](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#status). Para as novas tentativas que a Azion faz depois de uma tentativa que falhou, consulte [Tempo de emissão e novas tentativas](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas). Os campos `status` e `status_detail` agora informam se a Azion emitiu o certificado ou por que ela não conseguiu emiti-lo. @@ -142,9 +142,9 @@ Para vincular o certificado pelo Azion Console, pela Azion CLI ou pela API, cons ## Próximos passos - + - + diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-requet-lets-encrypt-certificates.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-requet-lets-encrypt-certificates.mdx index a951cc1a69..3ad147c127 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-requet-lets-encrypt-certificates.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/edge-application/ea-requet-lets-encrypt-certificates.mdx @@ -16,7 +16,7 @@ import VersionDualSteps from '~/includes/snippets/versionDualSteps/pt/snippet.md Você pode solicitar um certificado Let's Encrypt™ para os domínios de um [workload](/pt-br/documentacao/plataforma/workloads/) pelo Azion Console, pela [Azion CLI](/pt-br/documentacao/devtools/cli/) ou pela API. Para usar um certificado obtido de outra autoridade certificadora, consulte [Envie um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/). -HTTPS no seu próprio hostname precisa de um certificado de servidor que o cubra, porque o certificado SAN padrão da Azion cobre apenas o workload domain e o Azion Custom Domain. Com um certificado Let's Encrypt, [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) cuida do certificado por você. A Azion solicita o certificado ao Let's Encrypt, conclui o desafio que prova que você controla cada hostname e renova o certificado antes que ele expire. Alguns clientes mais antigos não conseguem validar a cadeia de um certificado Let's Encrypt. Para saber quais clientes, consulte [Cadeia de certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#cadeia-de-certificados). +HTTPS no seu próprio hostname precisa de um certificado de servidor que o cubra, porque o certificado SAN padrão da Azion cobre apenas o workload domain e o Azion Custom Domain. Com um certificado Let's Encrypt, [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) cuida do certificado por você. A Azion solicita o certificado ao Let's Encrypt, conclui o desafio que prova que você controla cada hostname e renova o certificado antes que ele expire. Alguns clientes mais antigos não conseguem validar a cadeia de um certificado Let's Encrypt. Para saber quais clientes, consulte [Cadeia de certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#cadeia-de-certificados). Uma conta que opera na API v3 com Domains seleciona o certificado em cada domínio, em vez disso. Para mais informações, consulte [Domains](/pt-br/documentacao/plataforma/workloads/domains/). @@ -80,7 +80,7 @@ O Let's Encrypt emite o certificado apenas depois de validar todos os hostnames | HTTP-01 | `http` | Todo hostname já aponta para o workload domain | Todo hostname já aponta para o workload domain | | DNS-01 | `dns` | Nenhum registro. A Azion grava o registro `_acme-challenge` na zona | Um registro `_acme-challenge` do tipo `CNAME` por hostname | -Com DNS-01 e uma zona em outro provedor de DNS, crie o registro `_acme-challenge` de cada hostname nesse provedor antes de enviar a solicitação. A tabela abaixo traz o nome e o valor dele. Com a zona no Edge DNS, a Azion grava o registro na zona e o desafio é concluído sem nenhuma ação sua. Escolha DNS-01 quando um hostname ainda não aponta para a Azion, como durante uma migração de outro provedor. Para saber como cada desafio valida um hostname, consulte [Validação de domínio](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). +Com DNS-01 e uma zona em outro provedor de DNS, crie o registro `_acme-challenge` de cada hostname nesse provedor antes de enviar a solicitação. A tabela abaixo traz o nome e o valor dele. Com a zona no Edge DNS, a Azion grava o registro na zona e o desafio é concluído sem nenhuma ação sua. Escolha DNS-01 quando um hostname ainda não aponta para a Azion, como durante uma migração de outro provedor. Para saber como cada desafio valida um hostname, consulte [Validação de domínio](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). No seu provedor de DNS, crie os registros que o seu desafio precisa, uma linha por hostname: @@ -199,7 +199,7 @@ Um nome da solicitação para o qual a sua conta não tem permissão é recusado Error: Failed to request the Digital Certificate: ["This account cannot use certain common or alternative names because it does not have permission for their domain names."]. Check your settings and try again. If the error persists, contact Azion support ``` -Para as causas e as correções, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#certificate-manager). Um workload não pode listar um hostname wildcard, então o Console não pode solicitar um certificado wildcard. Para solicitar um com o desafio DNS-01, consulte [Solicite um certificado Let's Encrypt com a API](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt-via-api/). +Para as causas e as correções, consulte [Solucione problemas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/). Um workload não pode listar um hostname wildcard, então o Console não pode solicitar um certificado wildcard. Para solicitar um com o desafio DNS-01, consulte [Solicite um certificado Let's Encrypt com a API](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt-via-api/). --- @@ -360,7 +360,7 @@ A resposta traz o certificado com o seu `status` e o seu `status_detail`. Para l O certificado passa de `pending` para `challenge_verification` enquanto o desafio aguarda a validação. Depois que o Let's Encrypt o emite, ele mostra `active` enquanto um workload o nomeia, e `inactive` caso contrário. Quando a validação falha, ele mostra `failed`, e `status_detail` nomeia o hostname a verificar, como `An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com`. -Uma tentativa que falha é repetida em um cronograma, então um registro que você corrige depois ainda pode terminar em uma emissão automática. Para o cronograma de novas tentativas, consulte [Tempo de emissão e novas tentativas](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas). Para um certificado que fica `pending` ou passa a `failed`, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#certificate-manager). +Uma tentativa que falha é repetida em um cronograma, então um registro que você corrige depois ainda pode terminar em uma emissão automática. Para o cronograma de novas tentativas, consulte [Tempo de emissão e novas tentativas](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas). Para um certificado que fica `pending` ou passa a `failed`, consulte [Solucione problemas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/). --- @@ -417,8 +417,8 @@ O certificado é emitido pelo desafio **DNS-01**. Um hostname cuja zona está no ## Próximos passos - + - + diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/edge-firewall/atualizar-edge-firewall.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/edge-firewall/atualizar-edge-firewall.mdx index 8eaf8855d5..2feed99ccc 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/edge-firewall/atualizar-edge-firewall.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/edge-firewall/atualizar-edge-firewall.mdx @@ -14,7 +14,7 @@ import DocStep from '@aziontech/webkit/doc-step' Você pode migrar cada configuração de um rule set obsoleto do Firewall para um [firewall](/pt-br/documentacao/plataforma/firewall/) pelo Azion Console. Uma regra no [Rules Engine para Firewall](/pt-br/documentacao/plataforma/firewall/rules-engine/) substitui cada configuração. Para adicionar uma regra que nenhum rule set obsoleto tinha, consulte [Crie uma regra de firewall](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/trabalhar-com-rules-engine/). -Um rule set obsoleto era ativado nas configurações principais de uma aplicação, e um behavior no Rules Engine dessa aplicação o aplicava. Azion Console marca um rule set obsoleto com um banner que pede que você o atualize. O próprio firewall traz [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection), [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/), [Web Application Firewall (WAF)](/pt-br/documentacao/plataforma/firewall/waf/) e [Functions](/pt-br/documentacao/plataforma/firewall/functions/). Um firewall pode proteger vários workloads. +Um rule set obsoleto era ativado nas configurações principais de uma aplicação, e um behavior no Rules Engine dessa aplicação o aplicava. Azion Console marca um rule set obsoleto com um banner que pede que você o atualize. O próprio firewall traz [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/), [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/), [Web Application Firewall (WAF)](/pt-br/documentacao/plataforma/firewall/waf/) e [Functions](/pt-br/documentacao/plataforma/firewall/functions/). Um firewall pode proteger vários workloads. Cada seção desta página recria uma configuração como uma regra de firewall. O bloqueio geográfico e o bloqueio de IP também precisam de uma [network list](/pt-br/documentacao/plataforma/firewall/network-shield/network-lists/), e um secure token precisa de uma instância de função. Depois que o firewall aplicar as regras, você remove os rule sets obsoletos das suas aplicações. diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx index 4ce60a5892..2940375a12 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/fastly-to-azion/fastly-to-azion-comprehensive-guide.mdx @@ -129,11 +129,11 @@ Todo produto da Fastly do inventário tem um destino na Azion. Encontre o produt | Bot Management | Detecção de tráfego automatizado e resposta a ele | [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/primeiros-passos/) e [Bot Manager Lite](/pt-br/documentacao/plataforma/firewall/bot-manager/bot-manager-lite/) | | Cache APIs | Interação programática com o cache para aplicações Compute | Functions, Cache e [Real-Time Purge](/pt-br/documentacao/plataforma/applications/cache/real-time-purge/) | | Cache Reservation | Capacidade de cache reservada para conteúdo | [Cache](/pt-br/documentacao/plataforma/applications/cache/), incluindo [Tiered Cache](/pt-br/documentacao/plataforma/applications/cache/tiered-cache/) | -| Certainly | Autoridade certificadora da Fastly para certificados TLS | [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) | +| Certainly | Autoridade certificadora da Fastly para certificados TLS | [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/) | | Compute | Computação serverless que executa código personalizado na rede da Fastly | Functions | | Compute packages | Código de aplicação empacotado para deploy no Compute | Functions e [Azion CLI](/pt-br/documentacao/devtools/cli/) | | Conditions | Condições de requisição, de cache e de resposta | [Rules Engine para Applications](/pt-br/documentacao/plataforma/applications/rules-engine/) | -| DDoS Protection | Visibilidade e mitigação de DDoS | [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) | +| DDoS Protection | Visibilidade e mitigação de DDoS | [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) | | Domain Inspector | Visibilidade e relatórios de tráfego por domínio | Real-Time Metrics | | Domains | Hostnames associados aos serviços | Workloads | | Edge Data Storage | Dados chave-valor usados pelos serviços Compute | KV Store | @@ -1129,7 +1129,7 @@ O critério `${network}` requer Network Shield no firewall. Para as variáveis e ## Conte com DDoS Protection -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação nas camadas 3, 4, 6 e 7. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) está ativado em todo workload, sem nada para criar e nada para configurar. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação nas camadas 3, 4, 6 e 7. | Aspecto | Fastly DDoS Protection | Azion DDoS Protection | | --- | --- | --- | @@ -1364,7 +1364,7 @@ Quando os logs não chegam ao destino, verifique o status do stream, as credenci ## Prepare o certificado -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Fastly Platform TLS, TLS Service Options e Certainly correspondem a ele. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o serviço por HTTPS desde a primeira requisição. +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Fastly Platform TLS, TLS Service Options e Certainly correspondem a ele. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o serviço por HTTPS desde a primeira requisição. | Área | Fastly TLS | Azion Certificate Manager | | --- | --- | --- | @@ -1410,7 +1410,7 @@ Para uma migração a partir da Fastly, use DNS-01. -Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. Confirme que o hostname está nos **Domains** do workload. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/), e para cada campo de certificado, [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). +Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. Confirme que o hostname está nos **Domains** do workload. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/), e para cada campo de certificado, [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). O mTLS precisa de um certificado Trusted CA, e um certificado gerado pela Azion não pode ser o Trusted CA. Envie-o e depois defina `mtls.enabled`, `mtls.config.certificate` e `verification`, `enforce` ou `permissive`, no workload pela API ou com `azion update workload --file`. O mTLS funciona apenas por HTTPS. Para os passos, consulte [Configure o mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/) e [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/). diff --git a/apps/docs/src/content/docs/pt-br/pages/guias/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx b/apps/docs/src/content/docs/pt-br/pages/guias/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx index 28086be312..5f2495066d 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guias/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guias/vercel-to-azion/vercel-to-azion-comprehensive-guide.mdx @@ -126,7 +126,7 @@ Encontre cada item do inventário na primeira coluna. A última coluna indica o | BotID | Verificação de bots para ações sensíveis, invisível para o usuário | Bot Manager | | CI/CD and Preview Deployments | Builds a partir do Git, com um ambiente de preview para cada mudança | Applications e Azion CLI | | Content Delivery Network | Cache, roteamento, compressão, TLS, redirecionamentos e reescritas | Applications, [Cache](/pt-br/documentacao/plataforma/applications/cache/) e [Rules Engine para Applications](/pt-br/documentacao/plataforma/applications/rules-engine/) | -| Domains and DNS | Domínios personalizados, registros DNS, nameservers e automação de certificados | Workloads, Edge DNS e [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) | +| Domains and DNS | Domínios personalizados, registros DNS, nameservers e automação de certificados | Workloads, Edge DNS e [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) | | Edge Config | Um store replicado para feature flags, experimentos, redirecionamentos e configuração | KV Store | | Environment Variables | Valores para os ambientes de produção, preview e desenvolvimento | [Variáveis de ambiente](/pt-br/documentacao/plataforma/functions/environment-variables/), armazenadas na conta | | Fluid Compute | Um modelo de computação do lado do servidor para workloads dinâmicos concorrentes | Functions | @@ -135,7 +135,7 @@ Encontre cada item do inventário na primeira coluna. A última coluna indica o | Microfrontends | Projetos de frontend com deploy independente, atrás de uma camada de roteamento | Applications e Rules Engine para Applications | | Observability | Monitoramento de tráfego, builds, funções, chamadas a APIs externas, performance, erros e uso | Real-Time Metrics, Real-Time Events e Data Stream | | Observability Plus | Retenção maior, métricas, dados de requisições, consultas, notebooks, monitoramento e alertas | Real-Time Metrics, Real-Time Events e Data Stream | -| Platform Security | Mitigação de DDoS, TLS, firewall da plataforma, controles de acesso e monitoramento de segurança | Firewall, [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) e [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) | +| Platform Security | Mitigação de DDoS, TLS, firewall da plataforma, controles de acesso e monitoramento de segurança | Firewall, [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) e [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) | | Production Deployments | Builds promovidos aos domínios que os clientes usam | Applications e Azion CLI | | Projects | As configurações de build, deployment, ambiente, domínio e runtime de um projeto | Applications, atendido por um workload | | Redirects and rewrites | Roteamento por caminho e por host a partir das configurações do projeto, da configuração do framework ou do `vercel.json` | Rules Engine para Applications | @@ -1469,7 +1469,7 @@ Uma segunda regra com `${request_uri}` _starts with_ `/preview/` protege os cami ## Conte com DDoS Protection -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) cobre todo workload, sem nada para criar e nada para configurar. Ele assume a mitigação de DDoS do Vercel Platform Security. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação nas camadas 3, 4, 6 e 7, como floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) cobre todo workload, sem nada para criar e nada para configurar. Ele assume a mitigação de DDoS do Vercel Platform Security. Ele mitiga ataques volumétricos, de protocolo e de camada de aplicação nas camadas 3, 4, 6 e 7, como floods UDP e ICMP, SYN floods, fragmentação de pacotes, floods HTTP e slowloris. | Aspecto | Azion DDoS Protection | | --- | --- | @@ -1731,7 +1731,7 @@ Para mover o monitoramento de usuários reais: ## Prepare o certificado -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o projeto por HTTPS desde a primeira requisição. +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) guarda os certificados que os workloads servem. Prepare o certificado antes de o domínio apontar para a Azion, para que os usuários acessem o projeto por HTTPS desde a primeira requisição. | Área | Azion Certificate Manager | | --- | --- | @@ -1778,7 +1778,7 @@ Para uma migração a partir da Vercel, use DNS-01, para que o certificado estej -Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Se o certificado não ficar ativo, leia seus campos `status` e `status_detail`. Para HTTP-01, verifique se o hostname aponta para a Azion. Para DNS-01, verifique o CNAME `_acme-challenge`. As novas tentativas continuam conforme o cronograma, então um registro corrigido emite o certificado mais tarde. Para as regras de emissão, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). O mTLS precisa de um certificado Trusted CA, e um certificado gerado pela Azion não pode ser o Trusted CA. Envie-o e depois defina `mtls.enabled`, `mtls.config.certificate` e `verification`, `enforce` ou `permissive`, no workload pela API ou com `azion update workload --file`. O mTLS funciona apenas por HTTPS. Para os passos, consulte [Configure o mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/) e [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/). diff --git a/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/caa-record.mdx b/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/caa-record.mdx index 70d137b6c7..0adb445b94 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/caa-record.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/caa-record.mdx @@ -63,7 +63,7 @@ Você pode restringir quais autoridades certificadoras (CAs) podem emitir certif O registro fica em `@`, o apex, e por isso cobre `example.com`. Substitua `example.com` pelo seu domínio e `letsencrypt.org` pela CA que você autoriza. -O Certificate Manager solicita os certificados de um workload ao Let's Encrypt. Enquanto ele emitir certificados para seu domínio, mantenha `letsencrypt.org` no registro. Para saber como ele os emite e renova, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +O Certificate Manager solicita os certificados de um workload ao Let's Encrypt. Enquanto ele emitir certificados para seu domínio, mantenha `letsencrypt.org` no registro. Para saber como ele os emite e renova, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). @@ -198,7 +198,7 @@ A resposta lista os valores do registro CAA. Se ela não listar nada, consulte [ ## Próximos passos - + diff --git a/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/txt-verification.mdx b/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/txt-verification.mdx index 640b7b638c..5511cc2784 100644 --- a/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/txt-verification.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/guides/edge-dns/txt-verification.mdx @@ -11,7 +11,7 @@ import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' -Você pode verificar um domínio com um registro TXT no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) pelo Azion Console, pela Azion CLI ou pela Azion API. Um serviço que pede que você comprove o controle de um domínio fornece um valor e depois o lê de volta no DNS do domínio. Para validar um certificado que a Azion solicita para um workload, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#validacao-de-dominio) em vez deste guia. +Você pode verificar um domínio com um registro TXT no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) pelo Azion Console, pela Azion CLI ou pela Azion API. Um serviço que pede que você comprove o controle de um domínio fornece um valor e depois o lê de volta no DNS do domínio. Para validar um certificado que a Azion solicita para um workload, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#validacao-de-dominio) em vez deste guia. --- diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/guias/certificate-manager.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/guias/certificate-manager.mdx new file mode 100644 index 0000000000..d480223e11 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/hubs/guias/certificate-manager.mdx @@ -0,0 +1,10 @@ +--- +title: Guias e tutoriais do Certificate Manager +description: Todos os guias e tutoriais do Certificate Manager, cada um cobrindo uma tarefa. +meta_tags: 'certificate manager, guias, tutoriais' +namespace: documentation_products_certificate_manager_guides +permalink: /documentacao/plataforma/certificate-manager/guias/ +guides_hub: certificate-manager +--- + +Todos os guias e tutoriais do Certificate Manager, cada um cobrindo uma tarefa. Abra um deles e você vai para a seção Guias, onde todos os guias ficam. diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/guias/custom-pages.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/guias/custom-pages.mdx new file mode 100644 index 0000000000..41776d1a19 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/hubs/guias/custom-pages.mdx @@ -0,0 +1,10 @@ +--- +title: Guias e tutoriais do Custom Pages +description: Todos os guias e tutoriais do Custom Pages, cada um cobrindo uma tarefa. +meta_tags: 'custom pages, guias, tutoriais' +namespace: documentation_products_custom_pages_guides +permalink: /documentacao/plataforma/custom-pages/guias/ +guides_hub: custom-pages +--- + +Todos os guias e tutoriais do Custom Pages, cada um cobrindo uma tarefa. Abra um deles e você vai para a seção Guias, onde todos os guias ficam. diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/certificate-manager-reference.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/certificate-manager/referencia.mdx similarity index 67% rename from apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/certificate-manager-reference.mdx rename to apps/docs/src/content/docs/pt-br/pages/hubs/nav/certificate-manager/referencia.mdx index 101a93dea0..f5af948760 100644 --- a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/certificate-manager-reference.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/certificate-manager/referencia.mdx @@ -1,9 +1,9 @@ --- title: Referência do Certificate Manager description: Encontre as páginas de referência do Certificate Manager em uma lista, cada uma com um resumo do que cobre. -meta_tags: 'certificate manager, reference, workloads' +meta_tags: 'certificate manager, reference, certificates, issuance and renewal, tls' namespace: documentation_hub_workloads_certificate_manager_reference -permalink: /documentacao/plataforma/workloads/certificate-manager/referencia/ +permalink: /documentacao/plataforma/certificate-manager/referencia/ --- Esta seção reúne as páginas de referência do Certificate Manager. diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/custom-pages-reference.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/custom-pages/referencia.mdx similarity index 67% rename from apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/custom-pages-reference.mdx rename to apps/docs/src/content/docs/pt-br/pages/hubs/nav/custom-pages/referencia.mdx index 1a9cbbba7d..b7d46a395d 100644 --- a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/custom-pages-reference.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/custom-pages/referencia.mdx @@ -1,9 +1,9 @@ --- title: Referência do Custom Pages description: Encontre as páginas de referência do Custom Pages em uma lista, cada uma com um resumo do que cobre. -meta_tags: 'custom pages, reference, workloads' +meta_tags: 'custom pages, reference, custom page settings, error responses' namespace: documentation_hub_workloads_custom_pages_reference -permalink: /documentacao/plataforma/workloads/custom-pages/referencia/ +permalink: /documentacao/plataforma/custom-pages/referencia/ --- Esta seção reúne as páginas de referência do Custom Pages. diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/certificate-manager.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/certificate-manager.mdx deleted file mode 100644 index a338801f4d..0000000000 --- a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/certificate-manager.mdx +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Certificate Manager -description: Encontre as páginas do Certificate Manager, dos primeiros passos à referência, em uma lista, cada uma com um resumo do que cobre. -meta_tags: 'certificate manager, workloads' -namespace: documentation_hub_workloads_certificate_manager -permalink: /documentacao/plataforma/workloads/certificate-manager/ ---- - -Esta seção reúne as páginas do Certificate Manager, um recurso da plataforma aninhado em Workloads. diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/custom-pages.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/custom-pages.mdx deleted file mode 100644 index 7116a11cc0..0000000000 --- a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/custom-pages.mdx +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Custom Pages -description: Encontre as páginas do Custom Pages, dos primeiros passos à referência, em uma lista, cada uma com um resumo do que cobre. -meta_tags: 'custom pages, workloads' -namespace: documentation_hub_workloads_custom_pages -permalink: /documentacao/plataforma/workloads/custom-pages/ ---- - -Esta seção reúne as páginas do Custom Pages, um recurso da plataforma aninhado em Workloads. diff --git a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/ddos-protection.mdx b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/ddos-protection.mdx index f0edb06ed7..5c3c5597d4 100644 --- a/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/ddos-protection.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/hubs/nav/workloads/ddos-protection.mdx @@ -6,4 +6,4 @@ namespace: documentation_hub_workloads_ddos_protection permalink: /documentacao/plataforma/workloads/ddos-protection/ --- -Esta seção reúne as páginas do DDoS Protection, um recurso da plataforma aninhado em Workloads. +Esta seção reúne as páginas do DDoS Protection, uma feature da Azion Platform que mitiga ataques de negação de serviço em todo Workload. diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/minimizar-o-downtime.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/minimizar-o-downtime.mdx index 57dd3a6749..42a85a1eed 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/minimizar-o-downtime.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/minimizar-o-downtime.mdx @@ -159,6 +159,6 @@ Um 503 da origem agora retorna a sua página. O código de status continua 503, - + diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/modo-de-manutencao.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/modo-de-manutencao.mdx index a2734212f5..3afd6dafe6 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/modo-de-manutencao.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/performance/modo-de-manutencao.mdx @@ -13,7 +13,7 @@ import DocStep from '@aziontech/webkit/doc-step' import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' -Você coloca uma aplicação em modo de manutenção com uma regra de fase de requisição no [rules engine](/pt-br/documentacao/plataforma/applications/rules-engine/) dela. A regra responde a todo visitante com uma página de manutenção e encerra a requisição antes que ela chegue à origem. Remover a regra devolve a aplicação ao normal, sem deploy. Para mudar o que os visitantes veem quando a própria origem retorna um erro, consulte [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages). +Você coloca uma aplicação em modo de manutenção com uma regra de fase de requisição no [rules engine](/pt-br/documentacao/plataforma/applications/rules-engine/) dela. A regra responde a todo visitante com uma página de manutenção e encerra a requisição antes que ela chegue à origem. Remover a regra devolve a aplicação ao normal, sem deploy. Para mudar o que os visitantes veem quando a própria origem retorna um erro, consulte [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/). --- @@ -127,7 +127,7 @@ Para devolver a aplicação ao normal, exclua a regra de manutenção. As demais - + diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/fundamentos.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/fundamentos.mdx index e162bae4c6..c89a836d63 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/fundamentos.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/fundamentos.mdx @@ -24,10 +24,10 @@ Tudo o que serve tráfego na Azion é um conjunto de recursos de plataforma liga -1. Um [workload](/pt-br/documentacao/plataforma/workloads/) recebe o tráfego dos seus domínios. Ele guarda os [domínios](/pt-br/documentacao/plataforma/workloads/domains/) e o certificado do [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager), e vincula, lado a lado, um firewall, uma aplicação e um conjunto de custom pages. -2. Um [firewall](/pt-br/documentacao/plataforma/firewall/) inspeciona cada requisição antes da aplicação. Você aplica a ele um rule set de [WAF](/pt-br/documentacao/plataforma/firewall/waf/), [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/), listas do [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) e funções. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) está sempre ativa, com ou sem firewall. +1. Um [workload](/pt-br/documentacao/plataforma/workloads/) recebe o tráfego dos seus domínios. Ele guarda os [domínios](/pt-br/documentacao/plataforma/workloads/domains/) e o certificado do [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), e vincula, lado a lado, um firewall, uma aplicação e um conjunto de custom pages. +2. Um [firewall](/pt-br/documentacao/plataforma/firewall/) inspeciona cada requisição antes da aplicação. Você aplica a ele um rule set de [WAF](/pt-br/documentacao/plataforma/firewall/waf/), [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/), listas do [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) e funções. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) está sempre ativa, com ou sem firewall. 3. Uma [aplicação](/pt-br/documentacao/plataforma/applications/) serve o conteúdo. [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) decide o que fazer com cada requisição, como redirecioná-la ou alterar os cabeçalhos dela. [Cache](/pt-br/documentacao/plataforma/applications/cache/) guarda uma cópia de uma resposta e responde às requisições repetidas a partir dela, sem ir à origem. [Image Processor](/pt-br/documentacao/plataforma/applications/image-processor/) redimensiona e otimiza imagens antes de elas serem entregues. [Functions](/pt-br/documentacao/plataforma/functions/) executa o seu próprio código no caminho da requisição. -4. Um conjunto de [custom pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) substitui as respostas de erro padrão por páginas que você controla. +4. Um conjunto de [custom pages](/pt-br/documentacao/plataforma/custom-pages/) substitui as respostas de erro padrão por páginas que você controla. 5. Quando o cache não consegue responder, a aplicação busca o conteúdo por um [connector](/pt-br/documentacao/plataforma/connectors/): um connector HTTP alcança o seu servidor de origem, e um [connector de storage](/pt-br/documentacao/plataforma/connectors/configuracoes/#storage) lê um bucket do Object Storage. [Load Balancer](/pt-br/documentacao/plataforma/connectors/load-balancer/) e [Origin Shield](/pt-br/documentacao/plataforma/connectors/origin-shield/) são habilitados no connector. 6. Suas funções podem ler e gravar dados no [SQL Database](/pt-br/documentacao/plataforma/sql-database/), no [KV Store](/pt-br/documentacao/plataforma/kv-store/) e no [Object Storage](/pt-br/documentacao/plataforma/object-storage/), e chamar modelos de AI pelo [AI Inference](/pt-br/documentacao/plataforma/ai-inference/). diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/visao-geral-da-azion.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/visao-geral-da-azion.mdx index 9b6979beed..8c7c9c649d 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/visao-geral-da-azion.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/ponto-de-partida/visao-geral-da-azion.mdx @@ -71,7 +71,7 @@ Tudo o que você habilita ou cria vive nos recursos do caminho da requisição. | Recurso | O que você habilita ou cria nele | Referência | | --- | --- | --- | -| Workload | O certificado TLS vinculado ao workload, o conjunto de custom pages que o seu deployment nomeia e a mitigação de DDoS, que se aplica a todo workload sem nada a habilitar. | [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager), [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages), [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) | +| Workload | O certificado TLS vinculado ao workload, o conjunto de custom pages que o seu deployment nomeia e a mitigação de DDoS, que se aplica a todo workload sem nada a habilitar. | [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/), [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) | | Firewall | Um rule set de WAF aplicado ao firewall, uma instância do Bot Manager executada nele e as network lists que suas regras referenciam. | [WAF](/pt-br/documentacao/plataforma/firewall/waf/), [Bot Manager](/pt-br/documentacao/plataforma/firewall/bot-manager/), [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) | | Aplicação | As configurações de cache, os interruptores de Application Accelerator e Image Processor e as funções instanciadas na aplicação. | [Cache](/pt-br/documentacao/plataforma/applications/cache/), [Application Accelerator](/pt-br/documentacao/plataforma/applications/application-accelerator/), [Image Processor](/pt-br/documentacao/plataforma/applications/image-processor/) | | Connector | O balanceamento entre vários endereços e o Origin Shield, que permite que só os ranges de IP da Azion alcancem a origem. | [Load Balancer](/pt-br/documentacao/plataforma/connectors/load-balancer/), [Origin Shield](/pt-br/documentacao/plataforma/connectors/origin-shield/) | diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/pricing/pricing.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/pricing/pricing.mdx index 948b5c7b79..e97da1a120 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/pricing/pricing.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/pricing/pricing.mdx @@ -538,7 +538,7 @@ Incluído no Firewall, sem cobrança adicional. DDoS Protection está ativa por padrão em todo Workload. A mitigação de ataques nas camadas de rede e de transporte, camadas Open Systems Interconnection (OSI) 3 e 4, não é medida. A mitigação de ataques na camada de aplicação, camada OSI 7, incluindo restrições baseadas em conexão, pode gerar tráfego cobrável, como os [Termos de Serviço](/pt-br/documentacao/contratos/tds/) estabelecem. - + ### Edge DNS @@ -1350,7 +1350,7 @@ Incluído no Firewall, sem cobrança adicional. DDoS Protection está ativa por padrão em todo Workload. A mitigação de ataques nas camadas de rede e de transporte, camadas Open Systems Interconnection (OSI) 3 e 4, não é medida. A mitigação de ataques na camada de aplicação, camada OSI 7, incluindo restrições baseadas em conexão, pode gerar tráfego cobrável, como os [Termos de Serviço](/pt-br/documentacao/contratos/tds/) estabelecem. - + ### Edge DNS diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/migrar-para-a-azion/migrar-para-a-azion.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/migrar-para-a-azion/migrar-para-a-azion.mdx index c0ee8656c8..88e145d6de 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/migrar-para-a-azion/migrar-para-a-azion.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/migrar-para-a-azion/migrar-para-a-azion.mdx @@ -214,7 +214,7 @@ Nem todo provedor aceita um registro CNAME no ápice do domínio. Para apontar o - + diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/domains.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/domains.mdx index 9ad32e1687..5ca2ce7296 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/domains.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/domains.mdx @@ -24,7 +24,7 @@ Você também pode vincular um certificado digital a domínios que usam o protoc | Escopo | Recurso | | --- | --- | | Adicionar um domínio personalizado | [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/) | -| Sobre Certificate Manager | [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) | +| Sobre Certificate Manager | [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/) | | Sobre mTLS | [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) | --- diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/mtls.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/mtls.mdx index aa3943597d..30d4474954 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/mtls.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/domains/mtls.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Mutual TLS (mTLS), também chamado de autenticação mútua, é um handshake de Transport Layer Security (TLS) no qual o cliente também apresenta um certificado. Em um [Workload](/pt-br/documentacao/plataforma/workloads/), a Azion valida esse certificado de cliente em relação a um certificado de CA confiável, o certificado de uma autoridade certificadora (CA) em que você confia. Um certificado de CA confiável é um dos tipos listados em [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). O mTLS é opcional em um Workload, e o modelo Open Banking o exige, por isso Workloads que atendem serviços financeiros e pagamentos costumam precisar dele. Para a linha `mtls` entre todos os outros campos de um Workload, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#mtls). +Mutual TLS (mTLS), também chamado de autenticação mútua, é um handshake de Transport Layer Security (TLS) no qual o cliente também apresenta um certificado. Em um [Workload](/pt-br/documentacao/plataforma/workloads/), a Azion valida esse certificado de cliente em relação a um certificado de CA confiável, o certificado de uma autoridade certificadora (CA) em que você confia. Um certificado de CA confiável é um dos tipos listados em [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). O mTLS é opcional em um Workload, e o modelo Open Banking o exige, por isso Workloads que atendem serviços financeiros e pagamentos costumam precisar dele. Para a linha `mtls` entre todos os outros campos de um Workload, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#mtls). --- @@ -144,7 +144,7 @@ O Workload solicita um certificado, o cliente não envia nenhum e a conexão ter - Os certificados de CA confiável que um Workload usa no mTLS, as CRLs que ele lista e como enviar cada um. + Os certificados de CA confiável que um Workload usa no mTLS, as CRLs que ele lista e como enviar cada um. Os passos que enviam uma CA confiável, ativam o mTLS em um Workload e adicionam uma regra permissive. Todos os outros campos de um Workload, de domínios e portas ao certificado de servidor em TLS. O limite do tamanho de um certificado de CA confiável. diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx index 83ad45ac10..c68847d545 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx @@ -145,7 +145,7 @@ A [visão geral do Image Processor](/pt-br/documentacao/plataforma/applications/ - **Cache e imagens em código**: o código que lê ou grava entradas em cache é executado em uma Function e usa a [Cache API](/pt-br/documentacao/devtools/runtime/api-reference/cache/), porque o próprio Cache não pode executar código. Uma Function que processa imagens por conta própria usa a biblioteca WASM Image Processor, que é separada do recurso da plataforma Image Processor. [Onde Image Processor para](/pt-br/documentacao/plataforma/applications/image-processor/entrega-de-imagens/#onde-image-processor-para) explica a diferença. - **Dispositivos**: um [device group](/pt-br/documentacao/plataforma/applications/device-groups/) é um nome e uma expressão regular que a Application compara com o header `User-Agent` de cada requisição. Os dois usos de um grupo precisam de Application Accelerator ativo: uma regra testa o grupo por meio de `${device_group}`, e um cache setting pode manter uma cópia por grupo. [Boas práticas de Applications](/pt-br/documentacao/plataforma/applications/boas-praticas/#defina-um-device-group-pelas-palavras-que-so-esse-dispositivo-envia) mostra como escrever uma expressão que corresponda somente aos dispositivos que você pretende alcançar. - **WebSocket**: [WebSocket Proxy](/pt-br/documentacao/plataforma/applications/websocket/) é uma feature de Applications que transporta uma conexão WebSocket entre os seus usuários e a origem. A conexão abre com os headers `Upgrade: websocket` e `Connection: upgrade`. A Azion ativa a feature em uma conta somente mediante solicitação, e [Diretrizes de suporte](/pt-br/documentacao/suporte/) explica como pedir. Como a Azion recicla as conexões keepalive aproximadamente a cada 15 minutos, o cliente precisa reabrir uma conexão WebSocket quando ela se fecha. -- **Workloads**: um Workload guarda os domínios, os protocolos e os certificados que servem a Application, então você configura a entrega no Workload, não na Application. [Teste uma aplicação pelo arquivo hosts](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/testar-edge-application-atraves-do-arquivo-hosts/) mostra como requisitar uma Application no seu próprio domínio a partir de um dispositivo antes de alterar os registros DNS dele. _Redirect HTTP to HTTPS_ só funciona quando o Workload tem HTTPS. Quando o Connector recebe uma resposta 4xx ou 5xx da sua origem, [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) no Workload define a página de erro que o cliente vê. +- **Workloads**: um Workload guarda os domínios, os protocolos e os certificados que servem a Application, então você configura a entrega no Workload, não na Application. [Teste uma aplicação pelo arquivo hosts](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/testar-edge-application-atraves-do-arquivo-hosts/) mostra como requisitar uma Application no seu próprio domínio a partir de um dispositivo antes de alterar os registros DNS dele. _Redirect HTTP to HTTPS_ só funciona quando o Workload tem HTTPS. Quando o Connector recebe uma resposta 4xx ou 5xx da sua origem, [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) no Workload define a página de erro que o cliente vê. - **Interfaces**: no [Azion Console](https://console.azion.com/), você cria e gerencia as suas Applications na página **Applications**, onde cada Application tem cinco abas: **Main Settings**, **Device Groups**, **Cache Settings**, **Functions Instances** e **Rules Engine**. No Console, a ação de linha **Clone** da lista **Applications** cria uma Application separada com as configurações da original, como mostra [Clone uma aplicação](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/clonar-applications/). [Azion API](https://api.azion.com/) serve as suas Applications em `/v4/workspace/applications`, e [Azion CLI](/pt-br/documentacao/devtools/cli/) as gerencia com comandos como `azion create application`, `azion update application` e `azion create rules-engine`. Você também pode criar e configurar as suas Applications com [`azion.config.js`](/pt-br/documentacao/devtools/cli/azion-config-js/), [Azion Lib](/pt-br/documentacao/devtools/azion-lib/application/) ou [Azion Terraform Provider](/pt-br/documentacao/devtools/terraform/). Se a sua conta não migrou para a API v4, use [Applications | v3](/pt-br/documentacao/plataforma/applications/v3/). - **Observabilidade**: com Debug Rules ativo, [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/) e [Data Stream](/pt-br/documentacao/plataforma/data-stream/) mostram as regras que cada requisição executou, no campo `$traceback`. Debug Rules começa desativado em uma Application nova. Ele é o campo `debug` da Application na API, e [Main Settings](/pt-br/documentacao/plataforma/applications/main-settings/#debug-rules) mostra onde ativá-lo no Azion Console. Para verificar uma resposta, envie a requisição com `Pragma: azion-debug-cache`: a resposta informa o seu status de cache, como `HIT` ou `MISS`, no header `x-cache`. Em todas as requisições, [Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/) mostra o tráfego de Cache e de [Tiered Cache](/pt-br/documentacao/plataforma/applications/cache/tiered-cache/). [Solucione problemas de Applications](/pt-br/documentacao/plataforma/applications/solucao-de-problemas/) lista as ferramentas e as consultas. Para um tráfego que difere do que você vê, consulte [Um problema aparece no tráfego, mas não nas respostas que você solicita](/pt-br/documentacao/plataforma/applications/solucao-de-problemas/#um-problema-aparece-no-trafego-mas-nao-nas-respostas-que-voce-solicita). - **Limites**: uma Application aceita no máximo 200 regras, somando as duas fases. Cada regra tem de 1 a 5 grupos de 1 a 10 critérios, além de 1 a 10 behaviors. Sem Application Accelerator, um cache setting precisa de um Max Age, o seu campo `modules.cache.max_age`, de no mínimo 60 segundos. Um único objeto em cache pode chegar a 10 GB. [Limites de Applications](/pt-br/documentacao/plataforma/applications/limites/) lista cada limite, o que acontece quando ele é ultrapassado e os limites de cada recurso da plataforma aninhado em Applications. diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/error-responses.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/error-responses.mdx deleted file mode 100644 index 2636eee64d..0000000000 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/error-responses.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: Error Responses -description: >- - Error Responses é uma capacidade da Azion Applications que permite - personalizar páginas de erro para os usuários com base no código de status - recebido da origem. -meta_tags: 'erros, application, http, páginas de erro' -namespace: documentation_edge_application_error_responses -permalink: /documentacao/plataforma/workloads/custom-pages/error-responses/ ---- -import DocButton from '~/components/webkit/DocButton.vue'; -import VersionDeprecated from '~/includes/snippets/versionDeprecated/pt/snippet.mdx' - -[Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/) - -**Error Responses** é uma capacidade do Azion **Applications** que permite personalizar páginas de erro para os usuários com base no código de status recebido da origem. - -Quando um usuário solicita conteúdo de uma application, a Azion envia a requisição para os servidores de origem. Como resposta, a origem envia de volta um código de status HTTP, o qual indica se a requisição foi ou não concluída. - -Os códigos de status HTTP são números de três dígitos, agrupados em cinco categorias: - -- Respostas de informação (1xx): o status da conexão ou o progresso antes da requisição ser completada. -- Respostas de sucesso (2xx): a requisição foi recebida, compreendida, aceita e processada com sucesso pela origem. -- Mensagens de redirecionamento (3xx): para atender à requisição, deve haver um redirecionamento. -- Respostas de erro do cliente (4xx): a requisição não pôde ser completada devido a um possível erro do cliente. -- Respostas de erro do servidor (5xx): o servidor não foi capaz de processar a requisição. - -:::note[nota] -Para mais informações sobre status HTTP, consulte as [especificações de códigos de status HTTP](https://httpwg.org/specs/rfc9110.html#overview.of.status.codes). -::: - - - -Com a funcionalidade **Error Responses**, você pode personalizar como sua aplicação irá lidar com erros de *Cliente (4xx)* e *Servidor (5xx)*. Desta forma, quando uma requisição é feita para uma URL que não está na origem ou quando não se obteve resposta do servidor, o usuário pode ser redirecionado para uma página de erro personalizada, cujo conteúdo pode ser armazenado em cache. - -## Implementação - -| Escopo | Recurso | -| --- | --- | -| Primeiros passos de Applications | [Primeiros passos](/pt-br/documentacao/plataforma/applications/primeiros-passos/) | -| Personalizar página de erro | [Personalize uma página de erro](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/personalizar-pagina-resposta-erro/) | - ---- - -## Status Code - -Código que a Azion recebe quando se conecta à origem. - ---- - -## Error Caching TTL - -Define o tempo, em segundos, que a página de erro ficará em cache antes de ser atualizada. - -:::tip[dica] -Como geralmente páginas de erro são estáticas e não mudam com frequência, a Azion recomenda valores altos de cache. Dessa maneira, você pode otimizar a performance da sua aplicação, bem como o custo de processamento na origem. -::: - ---- - -## URI - -Caminho para o arquivo (geralmente em HTML) com o conteúdo da página de erro que será entregue. Esse caminho é adicionado ao domínio da sua aplicação. Por exemplo: `/404.html`. - ---- - -## Custom Status Code - -Código de status que será entregue ao usuário em vez do código original. Por exemplo, você pode definir que o código `404` seja fornecido em resposta a um erro `403`. - ---- - -## Set Origin - -A origem em que o arquivo da URI está localizado. Só pode ser alterada se uma URI for adicionada. Deve ser configurada usando **Origins**. - - - ---- - -## Códigos de erro disponíveis - -| Código de status | Descrição | -| --- | --- | -| 400: Bad Request | Erro na requisição, tais como parâmetros inválidos, ausência de parâmetros obrigatórios ou outros. | -| 401: Unauthorized | Erro resultante da ausência do cabeçalho HTTP `Authentication`. | -| 403: Forbidden | Falta de permissão do usuário para executar a operação solicitada. | -| 404: Not Found | O recurso solicitado não existe. | -| 405: Method Not Allowed | O método solicitado não é aplicável à URL. | -| 406: Not Acceptable | Ausência do cabeçalho `Accept` na requisição HTTP ou cabeçalho contendo formato ou versão não suportados pela API. | -| 408: Request Timeout | Esta resposta é enviada por alguns servidores em uma conexão ociosa, mesmo sem qualquer requisição prévia pelo cliente. Ela significa que o servidor gostaria de derrubar esta conexão em desuso.

Esta resposta é muito usada já que alguns navegadores, como Chrome, Firefox 27+, ou IE9 usam mecanismos HTTP de pré-conexão para acelerar a navegação. Note também que alguns servidores derrubam a conexão sem enviar esta mensagem. | -| 409: Conflict | Conflito na execução da requisição, como a solicitação de criação de um registro já existente. | -| 410: Gone | Esta resposta será enviada quando o conteúdo requisitado foi permanentemente deletado do servidor, sem nenhum endereço de redirecionamento. É esperado que clientes removam seus caches e links para o recurso.

A especificação HTTP espera que este código de status seja usado para "serviços promocionais de tempo limitado". APIs não devem se sentir obrigadas a indicar que recursos foram removidos com este código de status. | -| 411: Length Required | O servidor rejeitou a requisição porque o campo `Content-Length` do cabeçalho não está definido e o servidor o requer. | -| 414: URI Too Long | A URI requisitada pelo cliente é maior do que o servidor aceita para interpretar. | -| 415: Unsupported Media Type | O formato de mídia dos dados requisitados não é suportado pelo servidor, então o servidor rejeita a requisição. | -| 416: Request Range Not Satisfiable | O trecho especificado pelo campo `Range` do cabeçalho na requisição não pode ser preenchido; é possível que o trecho esteja fora do tamanho dos dados da URI alvo. | -| 426: Upgrade Required | O servidor se recusa a executar a requisição usando o protocolo corrente mas estará pronto a fazê-lo após o cliente atualizar para um protocolo diferente. O servidor envia um cabeçalho Upgrade numa resposta 426 para indicar o(s) protocolo(s) requeridos. | -| 429: Too Many Requests | A requisição foi rejeitada temporariamente por exceder o limite de operações. Aguarde até o momento definido no cabeçalho `X-Ratelimit-Reset` e tente novamente. | -| 431: Request Header Fields Too Large | O cabeçalho da requisição é muito longo ou muitos cookies foram enviados na requisição. | -| 500: Internal Server Error | Erro não intencional, por falha não identificada no processamento da requisição. | -| 501: Not Implemented | O método da requisição não é suportado pelo servidor e não pode ser manipulado. Os únicos métodos exigidos que servidores suportem (e portanto não devem retornar este código) são GET e HEAD. | -| 502: Bad Gateway | Esta resposta de erro significa que o servidor, ao trabalhar como um gateway a fim de obter uma resposta necessária para manipular a requisição, obteve uma resposta inválida. | -| 503: Service Unavailable | O servidor não está pronto para manipular a requisição. Causas comuns são um servidor em manutenção ou sobrecarregado. É uma boa prática enviar, junto dessa resposta, uma página explicativa sobre o problema.

Estas respostas devem ser usadas para condições temporárias e o cabeçalho `Retry-After` deverá, se possível, conter o tempo estimado para recuperação do serviço. O webmaster deve também tomar cuidado com os cabeçalhos relacionados com o cache que são enviados com esta resposta, já que estas respostas de condições temporárias normalmente não deveriam ser postas em cache. | -| 504: Gateway Timeout | Esta resposta de erro é dada quando o servidor está atuando como um gateway e não obtém uma resposta a tempo. | -| 505: HTTP Version Not Supported | A versão HTTP usada na requisição não é suportada pelo servidor. | - - - ---- - diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/edge-application-v3.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/edge-application-v3.mdx index b7c770aab0..c03c51b166 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/edge-application-v3.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/edge-application-v3.mdx @@ -47,7 +47,7 @@ Você pode criar e gerenciar suas applications usando: | Applications Cache Settings | [Cache Settings](/pt-br/documentacao/plataforma/applications/cache/cache-settings/) | | Saiba mais sobre Functions | [Functions Instances](/pt-br/documentacao/plataforma/applications/functions-instances/) | | Saiba mais sobre Device Groups | [Device Groups](/pt-br/documentacao/plataforma/applications/device-groups/) | -| Saiba mais sobre Error Responses | [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/) | +| Saiba mais sobre Error Responses | [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/) | | Saiba mais sobre Origins | [Origins](/pt-br/documentacao/plataforma/connectors/origins/) | | Saiba mais sobre Real-Time Purge | [Real-Time Purge](/pt-br/documentacao/plataforma/applications/cache/real-time-purge/) | | Saiba mais sobre Rules Engine para Applications | [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) | @@ -83,7 +83,7 @@ Consulte a documentação para cada configuração disponível: | [Delivery Settings](/pt-br/documentacao/plataforma/applications/main-settings-v3/) | Personalize a entrega de sua aplicação com a variedade de opções de protocolo da Azion, incluindo suporte para HTTP, HTTPS e HTTP/3 para uma melhor experiência do usuário e proteja a conexão com cifras TLS. | | [Origins](/pt-br/documentacao/plataforma/connectors/origins/) | Modifique seu endereço de origem, cabeçalho `Host`, path, políticas de protocolo e credenciais de autenticação HMAC. | | [Device Groups](/pt-br/documentacao/plataforma/applications/device-groups/) | Crie grupos para alterar o cache e o comportamento de entrega de sua aplicação de acordo com os dispositivos de seus usuários. | -| [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/) | Personalize as páginas de resposta de erro, seu tempo de expiração em cache e sua origem. | +| [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/) | Personalize as páginas de resposta de erro, seu tempo de expiração em cache e sua origem. | | [Cache Settings](/pt-br/documentacao/plataforma/applications/cache/cache-settings/) | Configure o tempo de expiração do cache no navegador e no edge, Large File Optimization, e comportamentos avançados de cache com base em cookies ou *query strings*. | | [Functions](/pt-br/documentacao/plataforma/applications/functions-instances/) | Instancie funções criadas com **Functions**. | | [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) | Automatize a execução de comportamentos com base em parâmetros específicos para sua application. | @@ -102,7 +102,7 @@ Azion **Domains** oferece a flexibilidade de usar domínios gerados automaticame Com **Certificate Manager**, você pode aprimorar a segurança de suas aplicações HTTPS vinculando um certificado TLS personalizado à sua application. - + --- diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/main-settings-v3.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/main-settings-v3.mdx index 7756d0d81f..b09a8be00c 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/main-settings-v3.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/v3/main-settings-v3.mdx @@ -27,7 +27,7 @@ Você pode personalizar a entrega de sua aplicação através das seguintes opç - **HTTP & HTTPS**: entrega sua aplicação usando os protocolos HTTP e HTTPS. :::note[nota] -Se você escolher entregar sua aplicação usando HTTP & HTTPS, você deve associar um [digital certificate](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) a seu domínio. +Se você escolher entregar sua aplicação usando HTTP & HTTPS, você deve associar um [digital certificate](/pt-br/documentacao/plataforma/certificate-manager/certificados/) a seu domínio. ::: ### Suporte a HTTP/3 diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/sso.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/sso.mdx index bb8e514039..b37d95cf3d 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/sso.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/contas/sso.mdx @@ -31,7 +31,7 @@ O SSO da Azion suporta autenticação baseada em certificados X.509 como um mét O fluxo de autenticação funciona de forma idêntica para todos os tipos de certificados X.509. Os usuários não precisam realizar nenhuma configuração especial ou ação diferente para usar a autenticação com certificado X.509: o processo se integra à sua configuração de SSO existente. -Para configurar um certificado X.509 na Azion, consulte [Como configurar um certificado X.509](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-de-servidor) na documentação do Certificate Manager. +Para configurar um certificado X.509 na Azion, consulte [Como configurar um certificado X.509](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-de-servidor) na documentação do Certificate Manager. --- diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/api-v4-migration.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/api-v4-migration.mdx index 0cc29c75c3..89d4947ba5 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/api-v4-migration.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/api-v4-migration.mdx @@ -1074,7 +1074,7 @@ Os Error Responses existentes serão automaticamente convertidos em **Custom Pag - Ative ou desative qualquer **Custom Page** usando um controle de status. - Visualize e gerencie uma lista paginada de todos os códigos de status configurados pela interface do usuário. - + --- diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx index 4f967fae9c..e519a94c7f 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx @@ -18,7 +18,7 @@ O **SNI Check** é um mecanismo de segurança integrado à Azion Web Platform qu O **Server Name Indication (SNI)** é uma extensão do TLS que permite ao cliente especificar o hostname que deseja acessar durante o handshake TLS, antes que o servidor envie seu certificado. Isso permite que um único servidor hospede múltiplos workloads com TLS habilitado no mesmo endereço IP, cada um com seu próprio certificado. -Na Azion Web Platform, cada workload está associado a uma entrada no [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). Quando um cliente estabelece uma conexão TLS, a plataforma usa o valor do SNI para selecionar o certificado apropriado. Se o cabeçalho HTTP `Host` utilizado na requisição subsequente não corresponder aos nomes cobertos pelo certificado (Common Name ou Subject Alternative Names), a requisição é considerada misdirected. +Na Azion Web Platform, cada workload está associado a uma entrada no [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/). Quando um cliente estabelece uma conexão TLS, a plataforma usa o valor do SNI para selecionar o certificado apropriado. Se o cabeçalho HTTP `Host` utilizado na requisição subsequente não corresponder aos nomes cobertos pelo certificado (Common Name ou Subject Alternative Names), a requisição é considerada misdirected. --- @@ -75,7 +75,7 @@ A aplicação do SNI Check não é configurável pelo Azion Console ou pela API. - Os certificados cujos Common Name e Subject Alternative Names definem quais hostnames passam na verificação. + Os certificados cujos Common Name e Subject Alternative Names definem quais hostnames passam na verificação. Como encontrar as requisições que recebem uma resposta 421 e corrigir o certificado ou o hostname. Os logs que mostram o host e o nome do servidor TLS de cada requisição. O que um connector faz quando uma requisição passa na verificação e chega à sua aplicação. diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx index 5660d61c98..fa4abd85aa 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/ddos-protection/ddos-mitigation.mdx @@ -11,7 +11,7 @@ import DocItem from '@aziontech/webkit/doc-item' Um ataque de negação de serviço (DoS) inunda um serviço com tráfego até que as requisições legítimas não consigam passar. Um ataque distribuído de negação de serviço (DDoS) envia esse tráfego de muitas máquinas ao mesmo tempo. O tráfego de ataque raramente parece diferente do tráfego real quando visto um pacote por vez. O que o denuncia é o padrão: um fluxo que cresce muito além da sua forma normal, pacotes que violam um protocolo ou conexões abertas e nunca concluídas. Por isso, uma defesa observa cada fluxo continuamente, reconhece esses padrões e descarta o tráfego correspondente antes que o serviço precise tratá-lo. -Na Azion, essa defesa é [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection). DDoS Protection é uma feature da Azion Platform que mitiga ataques de negação de serviço em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. Para saber onde ela age sobre uma requisição, antes do Firewall que o deployment de um Workload pode definir, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/#ddos-protection). As seções abaixo cobrem a detecção, a mitigação, os tipos de ataque e as técnicas envolvidas, o Security Response Team e onde os registros de ataques aparecem. +Na Azion, essa defesa é **DDoS Protection**, uma feature da Azion Platform que mitiga ataques de negação de serviço em todo [Workload](/pt-br/documentacao/plataforma/workloads/). Ela está sempre ativa e não precisa de ativação nem de configuração. Para saber onde ela age sobre uma requisição, antes do Firewall que o deployment de um Workload pode definir, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/#ddos-protection). As seções abaixo cobrem a detecção, a mitigação, os tipos de ataque e as técnicas envolvidas, o Security Response Team e onde os registros de ataques aparecem. --- diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-firewall.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-firewall.mdx index 3415a69fb1..5e4d257285 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-firewall.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-firewall.mdx @@ -105,7 +105,7 @@ Para saber como Bot Manager pontua uma requisição, como uma instância chega a - **Respostas**: _Deny (403 Forbidden)_ responde `403` com a página de erro padrão da Azion, e _Drop (Close Without Response)_ não envia nenhuma resposta HTTP. _Set Rate Limit_ libera as requisições na taxa configurada e responde `429` somente a requisições simultâneas além do burst dele, e um bloqueio do WAF responde `400`. - **Functions**: um firewall executa JavaScript, incluindo a sua própria lógica de proteção, por meio de uma [instância de função](/pt-br/documentacao/plataforma/firewall/functions-instances/) que um comportamento _Run Function_ invoca. A função declara o ambiente de execução `firewall`, e ela pode negar, descartar ou responder à requisição, ou adicionar headers de requisição e de resposta. Você a escreve em [Functions](/pt-br/documentacao/plataforma/functions/) ou a instala pelo Azion Marketplace. **Functions** vem ativado em um firewall criado pela API, pela CLI ou pela página **Create Firewall**. Para o evento e os métodos dele, consulte [Functions no Firewall](/pt-br/documentacao/plataforma/firewall/functions/), e para código funcional, consulte [Functions em um firewall](/pt-br/documentacao/plataforma/functions/general-firewall-example/). - **Marketplace**: [Radware Bot Manager](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/radware-bot-manager/) e [DataDome Bot Protection](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/datadome-bot-protection/) são instalados pelo Azion Marketplace como funções de firewall, com assinaturas próprias. -- **Proteção contra DDoS**: [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) mitiga ataques de negação de serviço (DoS) e de negação de serviço distribuída (DDoS) em todas as contas, sem configuração. O interruptor **DDoS Protection Unmetered** do firewall carrega a tag **Automatically enabled in all accounts** e não pode ser desativado. +- **Proteção contra DDoS**: [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) mitiga ataques de negação de serviço (DoS) e de negação de serviço distribuída (DDoS) em todas as contas, sem configuração. O interruptor **DDoS Protection Unmetered** do firewall carrega a tag **Automatically enabled in all accounts** e não pode ser desativado. - **Workloads**: o deployment de um workload nomeia um firewall, e um firewall pode atender a vários workloads. Uma regra pertence ao firewall em que foi criada. **Clone**, uma ação de linha da lista **Firewalls** no Azion Console, inicia um firewall como cópia de outro, incluindo as instâncias de função e as regras dele. Para saber quando compartilhar um firewall, consulte [Boas práticas de Firewall](/pt-br/documentacao/plataforma/firewall/boas-praticas/). - **Interfaces**: você cria e gerencia firewalls na página **Firewalls** do [Azion Console](https://console.azion.com/) e pela [Azion API](https://api.azion.com/), em `/v4/workspace/firewalls`. [Azion CLI](/pt-br/documentacao/devtools/cli/) gerencia os firewalls com comandos como `azion create firewall` e `azion create firewall-rule`. `azion.config.js` declara um firewall e as regras dele para que Azion CLI os crie, como mostra [Vincule um rule set no azion.config.js](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/binding-no-arquivo-de-config/). A instalação de uma função pelo Azion Marketplace é feita no Azion Console. - **Observabilidade**: nenhum header de resposta nomeia o firewall ou a regra que decidiu. Toda resposta carrega um header `x-azion-request-id`, que a página de erro padrão da Azion repete. Com a configuração **Debug Rules** do firewall ativada, [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/) e [Data Stream](/pt-br/documentacao/plataforma/data-stream/) mostram as regras que uma requisição executou, no campo `$traceback`. A configuração vem desativada por padrão. diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/workloads/workloads.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/workloads/workloads.mdx index ca6a188d98..42b9d89e17 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/workloads/workloads.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/workloads/workloads.mdx @@ -1,7 +1,7 @@ --- title: Workloads description: Conecte os seus domínios a uma Application com um Workload, que recebe cada requisição, serve HTTPS e encaminha a requisição à Application. -meta_tags: 'workloads, workload domain, custom domain, tls, mtls, deployment, certificate manager, custom pages, ddos protection' +meta_tags: 'workloads, workload domain, custom domain, tls, mtls, deployment, ddos protection, entry point' namespace: documentation_products_secure_workloads permalink: /documentacao/plataforma/workloads/ --- @@ -13,20 +13,21 @@ import VersionRollingOut from '~/includes/snippets/versionRollingOut/pt/snippet. [Domains](/pt-br/documentacao/plataforma/workloads/domains/) -**Workloads** é um recurso da plataforma que recebe, como ponto de entrada, as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. O ponto de entrada de um site é a configuração que responde aos hostnames dele, como `www.example.com`. Uma consulta de Domain Name System (DNS) envia o cliente até o ponto de entrada, que faz a terminação da conexão Transport Layer Security (TLS): ele decifra o tráfego dessa conexão. Nessa conexão criptografada, o ponto de entrada prova com um certificado que detém o hostname e, quando o ponto de entrada exige TLS mútuo (mTLS), o cliente também prova a identidade dele. +**Workloads** é um recurso da plataforma que recebe, como ponto de entrada, as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Um ponto de entrada é a configuração que responde aos hostnames de um site, guarda o certificado de cada um e termina as conexões HTTPS. Use Workloads para colocar uma [Application](/pt-br/documentacao/plataforma/applications/) no seu próprio domínio, servir esse domínio por HTTPS ou testar uma configuração em staging antes da produção. -Um Workload guarda os hostnames aos quais ele responde: um workload domain que a Azion gera e os domínios que você adiciona. Ele também guarda as configurações das conexões a esses hostnames: TLS, mTLS, as portas e as versões HTTP que ele aceita. Ao criar um Workload, você escolhe a rede em que ele roda: produção ou staging. +Cada Workload tem estas features: -Um deployment é a parte de um Workload que define a [Application](/pt-br/documentacao/plataforma/applications/) que responde às requisições dele e, opcionalmente, um [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e um conjunto de custom pages que substitui as respostas de erro. Depois de receber uma requisição, o Workload a encaminha para a Application que o deployment desse Workload define. Essa Application executa as suas regras nessa requisição. Use Workloads para colocar uma Application no seu próprio domínio, servi-la por HTTPS com o seu certificado ou com um que a Azion solicita para você, exigir certificados de cliente ou testar uma configuração em staging antes da produção. +- [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) mitiga inundações de tráfego de ataque antes que elas cheguem aos seus Workloads e às Applications por trás deles. Para uma defesa voltada a um ataque específico, você adiciona regras personalizadas a um Firewall. +- [TLS mútuo (mTLS)](/pt-br/documentacao/plataforma/workloads/mtls/) permite que um Workload recuse, no modo `enforce`, todo cliente sem um certificado de uma autoridade certificadora em que você confia. É indicado para uma API chamada por sistemas de parceiros, como uma que precisa atender aos requisitos do Open Banking. - + --- ## Caminho da requisição -Criar um Workload não serve nenhuma requisição: antes, esse Workload precisa de um deployment que defina uma Application. Até o deployment se propagar, o workload domain responde `404` com a página de erro HTML da Azion. +Criar um Workload não serve nenhuma requisição: uma requisição chega a uma Application somente depois que o deployment desse Workload define essa Application. Um deployment é a parte de um Workload que define a Application e, opcionalmente, um [Firewall](/pt-br/documentacao/plataforma/firewall/) e um conjunto de custom pages. Até o deployment se propagar, o workload domain, o hostname que a Azion gera para o Workload, responde `404` com a página de erro HTML da Azion. As setas contínuas levam a requisição, e as setas pontilhadas levam o que volta ao cliente. Cada rótulo começa com o número do passo a que pertence. @@ -35,6 +36,8 @@ As setas contínuas levam a requisição, e as setas pontilhadas levam o que vol flowchart TD Client(["Cliente"]) DNS[["DNS"]] + DDoS["DDoS Protection"] + Blocked["tráfego bloqueado"] WL["Workload"] FW["Firewall"] App["Application"] @@ -43,7 +46,9 @@ flowchart TD CP["conjunto de custom pages"] Client -->|"1. consulta do hostname"| DNS DNS -.->|"1. endereço da Azion"| Client - Client -->|"2, 3. requisição e handshake TLS"| WL + Client -->|"2. tráfego"| DDoS + DDoS -->|"2. identificado como ataque"| Blocked + DDoS -->|"2, 3. requisição e handshake TLS"| WL WL -.->|"3. handshake recusado"| Client WL -->|"4. o deployment define um Firewall"| FW WL -->|"4. sem Firewall"| App @@ -59,117 +64,13 @@ flowchart TD ``` 1. O cliente consulta o hostname, e o DNS retorna um endereço da infraestrutura distribuída da Azion. Um domínio personalizado, um domínio seu listado no Workload, chega a esse endereço por um registro CNAME que aponta para o workload domain. -2. O Workload que lista o hostname recebe a requisição. -3. Em uma conexão HTTPS, o Workload conclui o handshake TLS com o certificado, a versão mínima de TLS e o conjunto de cifras dele. Com mTLS ativado, ele também verifica o certificado de cliente. No modo `enforce`, um cliente sem certificado, ou com um certificado assinado por uma autoridade em que você não confia, não conclui o handshake. +2. No data center que o cliente alcança, DDoS Protection inspeciona o tráfego antes que o Workload o veja, e a Azion mitiga o tráfego que identifica como ataque. O Workload que lista o hostname recebe o restante. +3. Em uma conexão HTTPS, o Workload conclui o handshake Transport Layer Security (TLS) com o certificado, a versão mínima de TLS e o conjunto de cifras dele. O certificado é o da própria Azion ou um que você vincula do [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/). Com mTLS ativado, o Workload também verifica o certificado de cliente nesse handshake e pode recusá-lo. 4. Quando o deployment define um Firewall, as regras desse Firewall avaliam a requisição antes da Application e podem bloquear essa requisição. Sem Firewall, a requisição segue direto para a Application. 5. A Application que o deployment define executa as regras dela sobre a requisição. Quando uma regra define um [Connector](/pt-br/documentacao/plataforma/connectors/), esse Connector encaminha a requisição à sua origem. A resposta volta pela Application até o cliente. -6. Quando o Connector responde com um status code de erro que o conjunto de custom pages do deployment cobre, o cliente recebe a custom page no lugar dessa resposta. +6. Quando o Connector responde com um status code de erro que o conjunto de custom pages do deployment cobre, o cliente recebe a custom page de [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) no lugar dessa resposta. -Um Workload guarda no máximo um deployment, então todo hostname do Workload chega à mesma Application. Quando o deployment define um Firewall ou um conjunto de custom pages, o mesmo vale para ele. Para cada passo do caminho e a contrapartida dele, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/). Para um domínio que responde `404` ou um handshake que falha, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/). - ---- - -## Estrutura do Workload - -A API e [Azion CLI](/pt-br/documentacao/devtools/cli/) representam um Workload como um objeto JSON. `azion describe workload --workload-id --format json` mostra um Workload novo, criado com nome e todos os padrões, como a API o armazena: - -```json -{ - "active": true, - "created_at": "2026-01-01T12:00:00.000000Z", - "domains": [], - "id": , - "infrastructure": 1, - "last_editor": "", - "last_modified": "2026-01-01T12:00:00.000000Z", - "mtls": { - "config": { - "certificate": null, - "verification": null - }, - "enabled": false - }, - "name": "my-workload", - "product_version": "1.0", - "protocols": { - "http": { - "http_ports": [ - 80 - ], - "https_ports": [ - 443 - ], - "quic_ports": [ - 443 - ], - "versions": [ - "http1", - "http2", - "http3" - ] - } - }, - "tls": { - "certificate": null, - "ciphers": 7, - "minimum_version": "tls_1_3" - }, - "workload_domain": ".map.azionedge.net", - "workload_domain_allow_access": true -} -``` - -- `workload_domain` é o hostname somente leitura que a Azion gera na criação. `domains` guarda os hostnames que você adiciona: os seus próprios domínios e um hostname `azion.app` opcional. `workload_domain_allow_access` decide se os clientes ainda alcançam o workload domain. -- `infrastructure` é `1` para produção e `2` para staging, e define o sufixo do workload domain. -- `protocols.http` lista as versões HTTP e as portas que o Workload aceita. `tls` define o certificado, junto com o conjunto de cifras e a versão mínima de TLS. Com `tls.certificate` em `null`, o Workload apresenta o certificado SAN da Azion: o certificado da própria Azion, com os hostnames dele listados como Subject Alternative Names (SAN). -- `mtls` vem desativado em um Workload novo. Ativado, ele define um certificado de CA confiável e um modo de verificação. Um certificado de CA confiável é o certificado de uma autoridade certificadora (CA) em que você confia para assinar certificados de cliente. O Workload verifica cada certificado de cliente com ele. - -Esse objeto não guarda nenhuma Application. O deployment do Workload não faz parte desse objeto: ele define a Application e também pode definir um Firewall e um conjunto de custom pages. Por causa dessa divisão, os hostnames e os certificados mudam sem nenhuma mudança no código da sua aplicação. - ---- - -## Recursos - -Certificate Manager age sobre um Workload depois que você vincula um certificado a esse Workload. Custom Pages age sobre um Workload depois que o deployment desse Workload define um conjunto de custom pages. DDoS Protection age sobre todo Workload a partir do momento em que ele existe. - -### Certificate Manager - -Certificate Manager é um recurso da plataforma que armazena os certificados que um Workload usa para TLS. Ele armazena certificados de servidor, enviados com a chave privada deles, e certificados de CA confiável, que verificam certificados de cliente para mTLS. Ele também solicita certificados Let's Encrypt para os domínios do Workload e os renova para você, armazena listas de revogação de certificados (CRLs) e cria solicitações de assinatura de certificado (CSRs). Recorra a ele quando um domínio seu precisa servir HTTPS, porque o certificado SAN da Azion cobre somente o workload domain e o hostname `azion.app`. - -Para os tipos de certificado, os campos e os status deles, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). Para saber como a Azion solicita e renova um certificado Let's Encrypt, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). Para vincular o seu primeiro certificado a um Workload, consulte [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/). - -### Custom Pages - -Custom Pages é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, uma página por status code de erro. Por exemplo, quando um Connector retorna `404` para um path que não existe, o cliente recebe a sua própria página na URL que pediu, sem redirecionamento. Um conjunto de custom pages é uma lista nomeada dessas páginas. A Azion busca o conteúdo de cada página em um Connector, e cada página define um tempo de cache para esse conteúdo. Uma página também pode responder com um status code que você define. Use Custom Pages quando os visitantes precisam ver a sua própria página em vez da página de erro da origem. - -Para os campos de um conjunto e das páginas dele, e os status codes que uma página pode substituir, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/). Para substituir o seu primeiro `404`, consulte [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/workloads/custom-pages/primeiros-passos/). Para uma conta que ainda roda a API v3, consulte [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/). - -### DDoS Protection - -DDoS Protection é uma feature da Azion Platform que mitiga ataques de negação de serviço em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. - -Um ataque de negação de serviço (DoS) inunda um serviço com tráfego até que as requisições legítimas não consigam passar. Um ataque distribuído de negação de serviço (DDoS) envia esse tráfego de muitas máquinas ao mesmo tempo. DDoS Protection mitiga esses ataques nas camadas de rede, de transporte, de apresentação e de aplicação. Para detecção e mitigação voltadas a um ataque específico, você escreve regras personalizadas no Firewall que o deployment define. - -Para os tipos de ataque e as técnicas de mitigação, consulte [Mitigação de ataques](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/). Para saber como a mitigação de DDoS Protection é cobrada, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#ddos-protection). - ---- - -## Escopo e limites - -- **Domínios**: um Workload responde no workload domain dele, `.map.azionedge.net` em produção e `.preview.azionedge.net` em staging, assim que o deployment dele se propaga, antes de você ter qualquer domínio. Você adiciona domínios seus, cada um como um hostname completo, sem wildcard, e aponta cada um para o workload domain com um registro CNAME. Um Workload de produção também pode responder em um hostname `azion.app`, que [Azion Console](https://console.azion.com/) chama de **Azion Custom Domain**, sem custo adicional. Com `workload_domain_allow_access` definido como `false`, o workload domain responde `404`, e o Workload responde somente nos hostnames de `domains`. Esse valor serve a um Workload cujos próprios domínios já atendem o tráfego, e a API o aceita somente enquanto `domains` tem pelo menos um hostname. Para cada regra que um hostname segue, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios), e para os registros DNS, consulte [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion/). -- **DNS**: um Workload não guarda registros DNS. A zona de um domínio fica no seu provedor de DNS ou no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), e o Workload responde aos hostnames que lista, onde quer que a zona deles esteja hospedada. -- **Infraestrutura**: um Workload roda em uma de duas redes: a rede de produção, para disponibilidade global, ou a rede de staging, para testes com propagação limitada. Você a escolhe ao criar o Workload, no campo `infrastructure` da API: `1` para produção ou `2` para staging. A escolha não muda depois da criação, e um Workload de staging não aceita domínio personalizado. Por exemplo, uma configuração testada em um Workload de staging chega à produção como um segundo Workload, criado na infraestrutura de produção. Para a mesma escolha no Azion Console, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura). Para saber como testar uma mudança em staging primeiro, consulte [Boas práticas de Workloads](/pt-br/documentacao/plataforma/workloads/boas-praticas/). -- **Protocolos**: um Workload aceita HTTP/1.1, HTTP/2 e HTTP/3 sobre QUIC, que exige as duas versões anteriores listadas e o HTTPS ativado. HTTP roda em até quatro portas, entre `80`, `8008`, `8080` e `8880`, com `80` por padrão. HTTPS roda em até 12 portas listadas, com `443` por padrão. Para as portas, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#protocolos-e-portas). -- **TLS**: a versão mínima de TLS vai de TLS 1.0 a TLS 1.3, o padrão, e TLS 1.0 e 1.1 estão descontinuados. Oito conjuntos de cifras estão disponíveis, com o conjunto `7` por padrão. O certificado SAN da Azion cobre o workload domain e o hostname `azion.app`, e um domínio seu precisa de um certificado de servidor de [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager). A Azion bloqueia a renegociação TLS por padrão. Essas configurações protegem a conexão do cliente até a Azion, enquanto a conexão com a sua origem é configurada no Connector. Para os campos e as cifras de cada conjunto, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#tls). -- **mTLS**: com mTLS ativado, um Workload verifica certificados de cliente com um certificado de CA confiável, no modo `enforce` ou `permissive`, somente em conexões HTTPS. Ele também lista até 100 CRLs. Para os dois modos e todos os requisitos, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/). -- **Deployment**: um Workload guarda no máximo um deployment, e um Workload criado pela API ou por Azion CLI começa sem nenhum. O deployment define a Application que responde e também pode definir um Firewall e um conjunto de custom pages. A referência publicada da API v4 não tem endpoint para o deployment: Azion Console, Azion CLI e [Terraform](/pt-br/documentacao/devtools/terraform/workloads/) o escrevem. Para os campos dele, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). -- **Propagação**: uma mudança salva em um Workload ou no deployment dele leva vários minutos para alcançar toda a infraestrutura distribuída da Azion, sem duração garantida. Enquanto isso, as requisições podem receber a configuração antiga ou a nova. Por exemplo, logo depois que você ativa o mTLS no modo `enforce`, alguns data centers ainda respondem a um cliente sem certificado. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). -- **Interfaces**: você cria e gerencia Workloads na página **Workloads** do [Azion Console](https://console.azion.com/), pela [Azion API](https://api.azion.com/) em `/v4/workspace/workloads`, com comandos do [Azion CLI](/pt-br/documentacao/devtools/cli/) como `azion create workload` e com os recursos `azion_workload` e `azion_workload_deployment` do [Terraform](/pt-br/documentacao/devtools/terraform/workloads/). -- **API v4**: na API v3, um único objeto Domains cumpria o papel de um Workload, e as Main Settings de uma Application guardavam as configurações de protocolo e de TLS. Na API v4, o Workload e o deployment dele substituem o objeto Domains, e o Workload guarda as configurações de protocolo e de TLS. Para o mapeamento entre os dois modelos, consulte [Migração para API v4](/pt-br/documentacao/fundamentos/api-v4-migration/), e para uma conta que ainda roda a API v3, consulte [Domains](/pt-br/documentacao/plataforma/workloads/domains/). -- **Observabilidade**: a página de erro da Azion carrega um header `x-azion-request-id` que identifica a requisição. [Data Stream](/pt-br/documentacao/plataforma/data-stream/) coleta os eventos dos Workloads que você associa a um stream, como mostra [Associe workloads a um stream](/pt-br/documentacao/guias/plataforma/observabilidade/data-stream-associar-workloads/). -- **Limites**: o `name` de um Workload aceita até 100 caracteres, e um Workload lista até 50 domínios por padrão. Para cada limite e a resposta quando ele é ultrapassado, consulte [Limites de Workloads](/pt-br/documentacao/plataforma/workloads/limites/). -- **Cobrança**: cada plano inclui uma quantidade de uso antes que uma tarifa se aplique, e a página [Preços da Azion](https://www.azion.com/pt-br/precos/) a lista por plano. Para as tarifas, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#workloads). -- **Termos**: o [glossário de Workloads](/pt-br/documentacao/plataforma/workloads/glossario/) define as palavras às quais as páginas de Workloads dão um significado específico, como workload domain, deployment, Azion custom domain e certificado de CA confiável. +Todo hostname de um Workload chega à Application, ao Firewall e ao conjunto de custom pages que o deployment desse Workload define. Para cada passo do caminho e a contrapartida dele, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/). --- @@ -180,4 +81,8 @@ Para os tipos de ataque e as técnicas de mitigação, consulte [Mitigação de + + + +
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/servicos/http-error-status-codes.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/servicos/http-error-status-codes.mdx index afb89e4371..2b73f22385 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/servicos/http-error-status-codes.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/servicos/http-error-status-codes.mdx @@ -257,6 +257,6 @@ Para resolver o erro: Investigue por que a sua aplicação retornou um erro aos seus usuários. Defina o protocolo que um connector usa para alcançar a sua origem. Encontre o behavior Redirect HTTP to HTTPS e os outros behaviors de uma regra. - Substitua as páginas de erro de um workload por páginas suas. + Substitua as páginas de erro de um workload por páginas suas.
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx index fc7d68e692..8ed532b647 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx @@ -928,7 +928,7 @@ Correção do comando sync alinhada com o tamanho máximo de página da API (100 Corrigido um problema que bloqueava a emissão de certificados Let's Encrypt durante a criação de domínio. -Leia mais sobre a [Azion CLI](/pt-br/documentacao/devtools/cli/) e [certificados Let's Encrypt](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-lets-encrypt). +Leia mais sobre a [Azion CLI](/pt-br/documentacao/devtools/cli/) e [certificados Let's Encrypt](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-lets-encrypt). @@ -1210,11 +1210,11 @@ Visite a documentação de [handlers](/pt-br/documentacao/devtools/runtime/api-r ### Desafio HTTP-01 do Let’s Encrypt via API -A Azion agora oferece emissão e renovação de [certificados Let’s Encrypt](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) via API usando o desafio HTTP-01, oferecendo um processo simplificado sem a necessidade de registros TXT no DNS. Isso oferece uma solução de integração fácil e conveniente, especialmente benéfica para clientes que gerenciam diversos domínios e nomes de host. +A Azion agora oferece emissão e renovação de [certificados Let’s Encrypt](/pt-br/documentacao/plataforma/certificate-manager/certificados/) via API usando o desafio HTTP-01, oferecendo um processo simplificado sem a necessidade de registros TXT no DNS. Isso oferece uma solução de integração fácil e conveniente, especialmente benéfica para clientes que gerenciam diversos domínios e nomes de host. Os certificados são renovados automaticamente antes de expirar, eliminando janelas de manutenção e mantendo as cotas, faturamento e permissões existentes. Perfeito para plataformas de e-commerce e provedores de hospedagem, esse aprimoramento permite um onboarding mais rápido e garante segurança aos sites dos clientes em minutos, sem alterações no DNS. -Para mais informações sobre essas atualizações, visite a documentação de [Digital Certificates](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). +Para mais informações sobre essas atualizações, visite a documentação de [Digital Certificates](/pt-br/documentacao/plataforma/certificate-manager/certificados/). @@ -1678,7 +1678,7 @@ Nenhuma mudança ocorreu na funcionalidade dos produtos. Agora, **Digital Certificates** suporta o gerenciamento de **Certificate Revocation Lists (CRL)** através da API da Azion. CRL é uma lista de certificados digitais que foram revogados antes de sua data de expiração. -Utilize a [API da Azion](https://api.azion.com/#b2df23ee-7a28-4900-9ad5-ffd135b4c6cf) para gerenciar as CRLs e consulte a [referência de Digital Certificates](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#listas-de-revogacao-de-certificados) para mais informações. +Utilize a [API da Azion](https://api.azion.com/#b2df23ee-7a28-4900-9ad5-ffd135b4c6cf) para gerenciar as CRLs e consulte a [referência de Digital Certificates](/pt-br/documentacao/plataforma/certificate-manager/certificados/#listas-de-revogacao-de-certificados) para mais informações. @@ -1968,7 +1968,7 @@ Consulte a [documentação do Websocket](/pt-br/documentacao/plataforma/applicat O **DDoS Protection** agora está automaticamente habilitado em todas as contas. Ele oferece proteção contra ataques DoS e DDoS com largura de banda ilimitada para todos os clientes Azion. -Saiba mais sobre o [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection). +Saiba mais sobre o [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/). @@ -2028,7 +2028,7 @@ Para mais detalhes, consulte a documentação sobre [Como integrar a Azion com o - O [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/#campos-da-regra) agora fornece o campo **description** para que você descreva sua regra. - Você pode personalizar a descrição via [Real-Time Manager](https://console.azion.com) ou [Azion API](https://api.azion.com/). -- Para Azion [Domains](/pt-br/documentacao/plataforma/workloads/domains/), você pode solicitar a emissão de um [certificado Let's Encrypt](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-lets-encrypt) por meio da Azion. +- Para Azion [Domains](/pt-br/documentacao/plataforma/workloads/domains/), você pode solicitar a emissão de um [certificado Let's Encrypt](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-lets-encrypt) por meio da Azion. - Esse certificado TLS será gerenciado e renovado automaticamente pela Azion antes da data de expiração de 90 dias. - Consulte o guia [Como gerar um certificado Let's Encrypt para seu domínio](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/) para obter mais informações. - Disponível no [Real-Time Manager](https://console.azion.com) ou na [Azion API](https://api.azion.com/). diff --git a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/editar-main-settings.mdx b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/editar-main-settings.mdx index 8c71b576ec..a356f5f291 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/editar-main-settings.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/editar-main-settings.mdx @@ -72,7 +72,7 @@ Cada produto adiciona critérios ou comportamentos ao [Rules Engine](/pt-br/docu | [Web Application Firewall (WAF)](/pt-br/documentacao/plataforma/firewall/waf/) | O behavior _Set WAF_, que aplica um WAF rule set à requisição. Também adiciona os sete critérios _Header_, como _Header User Agent_, e os critérios _Request Args_ e _Request Method_. | Desativado | | [Network Shield](/pt-br/documentacao/plataforma/firewall/network-shield/) | O critério _Network_, que compara uma requisição com uma [network list](/pt-br/documentacao/plataforma/firewall/network-shield/network-lists/) de endereços IP ou intervalos CIDR, ASNs ou países. | Ativado | | [Functions](/pt-br/documentacao/plataforma/firewall/functions/) | O behavior _Run Function_ e a aba **Functions Instances**, onde você adiciona uma instância de função ao firewall. | Ativado | -| [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) | Mitigação de ataques de negação de serviço distribuída (DDoS). O switch dele, **DDoS Protection Unmetered**, não pode ser desativado. | Sempre ativado | +| [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) | Mitigação de ataques de negação de serviço distribuída (DDoS). O switch dele, **DDoS Protection Unmetered**, não pode ser desativado. | Sempre ativado | Um WAF rule set pontua cada requisição em busca de ataques como SQL injection, remote file inclusion (RFI) e cross-site scripting (XSS). Para cada família de ameaças que ele pontua, consulte [Rule sets](/pt-br/documentacao/plataforma/firewall/waf/rule-sets/#familias-de-ameacas). diff --git a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/proteja-seu-dominio.mdx b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/proteja-seu-dominio.mdx index e8c63347ce..32fd5bc908 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/proteja-seu-dominio.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/editar-edge-firewall/proteja-seu-dominio.mdx @@ -57,7 +57,7 @@ Uma conta que usa a API v3 com Domains vincula um firewall nas configurações d ## Vincule o firewall ao workload -Um deployment tem exatamente três configurações: a aplicação, o firewall e o [conjunto de custom pages](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/) dele. A aplicação e o conjunto de custom pages continuam as que o workload usa hoje, então o firewall é a única configuração que muda. Até que um deployment nomeie o firewall, as regras do firewall não veem nenhuma requisição ao workload. +Um deployment tem exatamente três configurações: a aplicação, o firewall e o [conjunto de custom pages](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) dele. A aplicação e o conjunto de custom pages continuam as que o workload usa hoje, então o firewall é a única configuração que muda. Até que um deployment nomeie o firewall, as regras do firewall não veem nenhuma requisição ao workload. Um workload tem um único deployment, então você altera o deployment que ele já tem. Um segundo deployment é recusado com `The maximum number of deployments allowed per workload is 1.` Para todos os campos do deployment, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). diff --git a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/digital-certificates.mdx b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/digital-certificates.mdx index d3fafc3567..eed0e60518 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/digital-certificates.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/digital-certificates.mdx @@ -14,7 +14,7 @@ import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' import VersionDualSteps from '~/includes/snippets/versionDualSteps/pt/snippet.mdx' -Você pode adicionar um certificado que uma autoridade certificadora (CA) emitiu para o seu domínio ao [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) e vinculá-lo a um [workload](/pt-br/documentacao/plataforma/workloads/), pelo Azion Console, pela [Azion CLI](/pt-br/documentacao/devtools/cli/) ou pela API. Para um certificado que a Azion solicita ao Let's Encrypt e renova, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). Para o certificado de CA confiável que verifica certificados de cliente, consulte [Configure mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/). +Você pode adicionar um certificado que uma autoridade certificadora (CA) emitiu para o seu domínio ao [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) e vinculá-lo a um [workload](/pt-br/documentacao/plataforma/workloads/), pelo Azion Console, pela [Azion CLI](/pt-br/documentacao/devtools/cli/) ou pela API. Para um certificado que a Azion solicita ao Let's Encrypt e renova, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). Para o certificado de CA confiável que verifica certificados de cliente, consulte [Configure mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/). Um certificado de servidor cobre os hostnames que um workload atende por HTTPS. Você obtém um de duas formas: você envia um certificado com a sua chave privada, ou Certificate Manager cria uma solicitação de assinatura de certificado (CSR) e guarda a chave privada enquanto a sua CA assina o certificado. Em ambos os casos, um workload usa o certificado apenas depois que o seu campo `tls.certificate` o nomeia, e o certificado fica como `inactive` até lá. @@ -277,7 +277,7 @@ A API responde `201` com a nova entrada de certificado e o seu `id`. O campo `cs -Uma solicitação que nomeia um hostname em um domínio para o qual a sua conta não tem permissão é recusada com `This account cannot use certain common or alternative names because it does not have permission for their domain names.` Para o significado de cada campo da CSR, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#solicitacoes-de-assinatura-de-certificado). +Uma solicitação que nomeia um hostname em um domínio para o qual a sua conta não tem permissão é recusada com `This account cannot use certain common or alternative names because it does not have permission for their domain names.` Para o significado de cada campo da CSR, consulte [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#solicitacoes-de-assinatura-de-certificado). Envie a solicitação à CA da sua escolha, como DigiCert, GlobalSign ou IdenTrust. A CA valida os dados da solicitação e, depois de aprová-los, emite o certificado assinado. @@ -464,7 +464,7 @@ A API aceita a atualização, e o workload passa a nomear o certificado em `tls. Um certificado de CA confiável em `tls.certificate` é recusado com `Invalid certificate type, MUST be an Edge Certificate.` Para voltar ao certificado da própria Azion, selecione _Azion (SAN)_ em **Digital Certificate**, ou envie `null` em `tls.certificate`. -Vincular um certificado é uma mudança no workload, que leva vários minutos para chegar a toda a infraestrutura distribuída da Azion. Enquanto isso, as requisições podem receber a configuração antiga ou a nova. Para erros de certificado e as suas correções, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#certificate-manager). +Vincular um certificado é uma mudança no workload, que leva vários minutos para chegar a toda a infraestrutura distribuída da Azion. Enquanto isso, as requisições podem receber a configuração antiga ou a nova. Para erros de certificado e as suas correções, consulte [Solucione problemas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/). --- @@ -557,7 +557,7 @@ Para voltar ao certificado da própria Azion, selecione _Azion (SAN)_ em **Digit Um certificado que você envia não se renova sozinho e, depois que a sua data de `validity` passa, ele deixa de proteger o tráfego. Para substituí-lo, envie o novo certificado como descreve Envie um certificado de servidor e depois vincule-o como descreve Vincule o certificado ao workload. A entrada antiga fica como `inactive` quando nenhum workload a nomeia. Exclua-a depois que o novo certificado estiver `active` e a mudança tiver se propagado. -Para saber por que trocar enquanto o certificado antigo ainda é válido, consulte [Boas práticas de Workloads](/pt-br/documentacao/plataforma/workloads/boas-praticas/#certificate-manager). +Para saber por que trocar enquanto o certificado antigo ainda é válido, consulte [Boas práticas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/boas-praticas/). --- @@ -566,6 +566,6 @@ Para saber por que trocar enquanto o certificado antigo ainda é válido, consul - + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/mtls.mdx b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/mtls.mdx index 395fee5885..600bbb5b1c 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/mtls.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/transport-layer-security/mtls.mdx @@ -73,7 +73,7 @@ Uma conta que opera na API v3 tem Domains no lugar de workloads, e define o mTLS ## Envie o certificado de CA confiável -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) armazena o certificado de CA confiável com o tipo `trusted_ca_certificate` e sem chave privada. O arquivo deve estar em formato PEM, com as linhas `-----BEGIN CERTIFICATE-----` e `-----END CERTIFICATE-----`, e Certificate Manager recusa qualquer outro formato. Quando a sua cadeia tiver certificados intermediários, inclua-os no mesmo arquivo. +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) armazena o certificado de CA confiável com o tipo `trusted_ca_certificate` e sem chave privada. O arquivo deve estar em formato PEM, com as linhas `-----BEGIN CERTIFICATE-----` e `-----END CERTIFICATE-----`, e Certificate Manager recusa qualquer outro formato. Quando a sua cadeia tiver certificados intermediários, inclua-os no mesmo arquivo. diff --git a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/zona-configuracoes-avancadas/adicionar-registro-txt-lets-encrypt.mdx b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/zona-configuracoes-avancadas/adicionar-registro-txt-lets-encrypt.mdx index 34303bf4af..4db4b7d2c9 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure-jornada/zona-configuracoes-avancadas/adicionar-registro-txt-lets-encrypt.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure-jornada/zona-configuracoes-avancadas/adicionar-registro-txt-lets-encrypt.mdx @@ -14,9 +14,9 @@ import DocStep from '@aziontech/webkit/doc-step' Você pode adicionar o registro TXT de um desafio DNS-01 do Let's Encrypt a uma zona no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) pelo Azion Console. Adicione o registro quando um cliente ACME fora da Azion, como o Certbot, solicita o certificado para um hostname dessa zona. -Um certificado que a Azion solicita para um workload não precisa de nenhum registro TXT seu. Quando a zona está no Edge DNS, a própria Azion grava o registro do desafio. Em outro provedor de DNS, você cria um registro CNAME em vez disso. Para criar esse registro, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). Para que a Azion solicite o certificado, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). +Um certificado que a Azion solicita para um workload não precisa de nenhum registro TXT seu. Quando a zona está no Edge DNS, a própria Azion grava o registro do desafio. Em outro provedor de DNS, você cria um registro CNAME em vez disso. Para criar esse registro, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). Para que a Azion solicite o certificado, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). -Dispositivos que dependem da cadeia expirada do Let's Encrypt com assinatura cruzada da IdenTrust rejeitam certificados que usam essa cadeia. Para mais informações, consulte [Cadeia de certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#cadeia-de-certificados). +Dispositivos que dependem da cadeia expirada do Let's Encrypt com assinatura cruzada da IdenTrust rejeitam certificados que usam essa cadeia. Para mais informações, consulte [Cadeia de certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#cadeia-de-certificados). --- @@ -84,7 +84,7 @@ Um nome que ninguém consultou antes de existir responde em segundos. Um nome co - + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/boas-praticas.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/boas-praticas.mdx new file mode 100644 index 0000000000..f0adced01b --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/boas-praticas.mdx @@ -0,0 +1,97 @@ +--- +title: Boas práticas do Certificate Manager +description: Substitua certificados antes que expirem, mantenha os registros de renovação no lugar e limite o alcance de uma chave privada ou de uma credencial de DNS. +meta_tags: 'certificate manager, best practices, certificate replacement, lets encrypt, renewal, acme challenge, dns-01, validation levels, wildcard certificate' +namespace: documentation_products_certificate_manager_best_practices +permalink: /documentacao/plataforma/certificate-manager/boas-praticas/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' +import Code from '~/components/webkit/CodeBlock.vue' + +Um certificado deixa de proteger o tráfego no dia em que expira, e uma renovação automática falha quando o registro que prova o controle do domínio desaparece. Uma chave privada ou uma credencial de DNS com alcance demais transforma um único vazamento na exposição de todos os nomes que ela cobre. + +Estas práticas se aplicam aos certificados que [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), um recurso da plataforma, armazena para um [Workload](/pt-br/documentacao/plataforma/workloads/). Em ordem, elas são: substituir um certificado de servidor antes que ele expire, manter o registro de desafio de um domínio hospedado fora do Edge DNS, escolher um certificado validado por domínio a menos que precise de mais, limitar as credenciais de DNS-01 aos registros de desafio e manter certificados wildcard fora de sistemas críticos de produção. + +Vincular um certificado altera o Workload, e essa mudança leva vários minutos para alcançar toda a infraestrutura distribuída da Azion, sem duração garantida. Até lá, as requisições podem encontrar a configuração antiga ou a nova, então uma verificação desta página só vale quando requisições repetidas concordam. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). + +--- + +## Substitua um certificado de servidor antes que ele expire + +Um certificado de servidor enviado nunca se renova sozinho e, depois que a data em `validity` passa, ele deixa de proteger o tráfego. Trocar enquanto o certificado antigo ainda é válido deixa tempo para confirmar o novo e para voltar atrás se ele falhar. O custo é a entrada antiga, que permanece em Certificate Manager até que você a exclua. + +A Azion renova os certificados Let's Encrypt que gerencia, como descreve [Renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#renovacao), então esta prática trata dos certificados que você envia. Depois de enviar o novo certificado, aponte `tls.certificate` para o ID dele com este corpo para `azion update workload --file`: + +, + "tls": { "certificate": , "ciphers": 7, "minimum_version": "tls_1_3" } +}`} /> + +Substitua `7` e `tls_1_3` pelos valores de `ciphers` e `minimum_version` que o Workload já tem, para que o certificado seja o único valor que muda. A CLI responde `Updated Workload with ID `. + +Para verificar, execute `azion list digital-certificate --details`: o novo certificado aparece como `active`, e o antigo aparece como `inactive` quando nenhum Workload o usa mais. Exclua a entrada antiga depois que o novo certificado estiver `active` e a mudança tiver se propagado. Para o envio em si, consulte [Envie um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/). + +--- + +## Mantenha o registro de desafio de um domínio hospedado fora do Edge DNS + +A Azion renova um certificado Let's Encrypt gerenciado antes que ele expire, executando o desafio dele de novo. Para um certificado DNS-01 cuja zona está no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), a própria Azion escreve o registro `_acme-challenge`. Em outro provedor de DNS, o desafio depende de um registro que você adicionou, e excluir esse registro faz a próxima renovação falhar, então o certificado expira. + +O registro é um registro canonical name (CNAME) chamado `_acme-challenge.`, que aponta para `.letsencrypt.azion.com`. Mantenha-o no seu provedor enquanto um Workload usar o certificado. + +A renovação começa 30 dias antes do fim da validade de 90 dias. Para verificar, confirme antes disso que o CNAME ainda existe e que o status do certificado em Certificate Manager não é `failed`. Para o registro a criar, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). + +--- + +## Escolha um certificado validado por domínio, a menos que precise de mais + +A autoridade certificadora (CA) que emite um certificado que você envia valida a solicitação em um de três níveis: + +- Domain Validation (DV) confirma o seu direito de usar o domínio. +- Organization Validation (OV) acrescenta verificações sobre a organização solicitante. +- Extended Validation (EV) pede documentos que comprovem a existência física, jurídica e operacional da organização. + +Use DV na maioria dos casos. OV e EV dão mais trabalho para obter, e as verificações extras atestam a sua organização, não o domínio. Peça OV ou EV somente quando um requisito que você consiga nomear exigir essas verificações. Para os três níveis, consulte [Níveis de validação](/pt-br/documentacao/plataforma/certificate-manager/certificados/#niveis-de-validacao). + +--- + +## Limite as credenciais de DNS-01 aos registros de desafio + +Esta prática vale quando o seu cliente Automatic Certificate Management Environment (ACME), como o Certbot, obtém um certificado para uma zona fora do Edge DNS. Um certificado Let's Encrypt que a Azion gerencia não precisa dela, porque basta o único CNAME de [Mantenha o registro de desafio de um domínio hospedado fora do Edge DNS](/pt-br/documentacao/plataforma/certificate-manager/boas-praticas/#mantenha-o-registro-de-desafio-de-um-dominio-hospedado-fora-do-edge-dns). + +O seu cliente ACME escreve o registro `_acme-challenge` no provedor de DNS, então guarda as credenciais de API do provedor. Credenciais que alcançam todos os registros dão a quem as obtiver o controle do domínio e de todos os registros dele. + +Restrinja essas credenciais a registros `_acme-challenge`, para que um vazamento exponha apenas o desafio. O custo é uma credencial separada, que você cria e mantém só para esse cliente. Para verificar, confirme no seu provedor que as permissões da credencial nomeiam apenas registros `_acme-challenge`. + +--- + +## Mantenha certificados wildcard fora de sistemas críticos de produção + +Um certificado wildcard, como um para `*.example.com`, cobre subdomínios como `blog.example.com` com uma única chave privada. Quando essa chave vaza, ou o certificado é revogado, todos os subdomínios que ele cobre são afetados de uma vez. Um certificado wildcard é adequado quando: + +- A gestão centralizada é uma prioridade. +- A mesma equipe gerencia os subdomínios. +- Existe uma arquitetura de proxy reverso bem definida. +- As suas políticas de segurança permitem o compartilhamento controlado de chaves. + +Sob requisitos mais rígidos, dê a cada sistema crítico de produção um certificado próprio, mantenha certificados separados para ambientes de desenvolvimento e deixe o wildcard para serviços de menor criticidade. O custo é uma substituição por certificado em vez de uma substituição para todos. Para saber como a Azion emite um nome wildcard, consulte [Certificados wildcard](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#certificados-wildcard). + +Mantenha a chave privada de um wildcard em Certificate Manager, vinculada a Workloads, em vez de copiá-la para vários servidores. Depois de salva, a chave não pode ser lida de volta pelo Azion Console nem pela API. + +Para verificar, liste os Workloads que usam cada certificado wildcard com `GET /v4/workspace/workloads?digital_certificate_id=` e dê a qualquer Workload crítico de produção um certificado próprio. + +--- + +## Recursos relacionados + + + + Os tipos, os status e os níveis de validação de certificado por trás destas práticas. + Como o Let's Encrypt valida e emite um certificado que a Azion solicita, como a Azion o renova e quando a Azion deixa de renová-lo. + Como um Workload vincula cada certificado e por que o certificado e o Workload são verificados separadamente. + Sintomas de um certificado que fica pendente, falha na emissão ou é recusado, para quando uma prática foi ignorada. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/digital-certificates.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/certificados.mdx similarity index 88% rename from apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/digital-certificates.mdx rename to apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/certificados.mdx index f34ca22009..2032eaef2c 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/digital-certificates.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/certificados.mdx @@ -3,16 +3,16 @@ title: Certificados description: Consulte os tipos de certificado que Certificate Manager armazena, com campos, algoritmos de chave e status, além dos objetos CSR e CRL. meta_tags: 'certificate manager, digital certificate, edge certificate, trusted ca certificate, csr, crl, lets encrypt, tls, workloads' namespace: documentation_digital_certificates -permalink: /documentacao/plataforma/workloads/certificate-manager/certificados/ +permalink: /documentacao/plataforma/certificate-manager/certificados/ --- import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) é um recurso da plataforma que armazena os certificados que um [Workload](/pt-br/documentacao/plataforma/workloads/) usa para Transport Layer Security (TLS). Cada um deles é um certificado X.509. Um certificado de servidor é um certificado TLS para os seus próprios domínios: você o envia por upload, ou a Azion o solicita ao Let's Encrypt. Um certificado de CA confiável é o certificado de uma autoridade certificadora (CA) em que você confia para assinar certificados de cliente para TLS mútuo (mTLS). Certificate Manager também cria solicitações de assinatura de certificado (CSRs) e armazena listas de revogação de certificados (CRLs). +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) é um recurso da plataforma que armazena os certificados que um [Workload](/pt-br/documentacao/plataforma/workloads/) usa para Transport Layer Security (TLS). Cada um deles é um certificado X.509 de um de dois tipos: um certificado de servidor para os seus próprios domínios ou um certificado de CA confiável para TLS mútuo (mTLS). Certificate Manager também cria solicitações de assinatura de certificado (CSRs) e armazena listas de revogação de certificados (CRLs). -Esta página lista cada campo desses objetos pelo nome na API. Para saber como a Azion solicita e renova um certificado Let's Encrypt, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Esta página lista cada campo desses objetos pelo nome na API. Para saber como a Azion solicita e renova um certificado Let's Encrypt, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). --- @@ -24,7 +24,7 @@ Quatro interfaces gerenciam certificados, CSRs e CRLs. As tabelas desta página | --- | --- | --- | | [Azion Console](https://console.azion.com/) | A página **Create Digital Certificate**, com quatro presets | As páginas **Edit Digital Certificate** e **Edit CRL** | | Azion API v4 | `POST /v4/workspace/tls/certificates` faz upload de um certificado; `POST /v4/workspace/tls/certificates/request` solicita um certificado Let's Encrypt; `POST /v4/workspace/tls/csr` cria uma CSR; `POST /v4/workspace/tls/crls` armazena uma CRL | `GET`, `PUT`, `PATCH` e `DELETE` em `/v4/workspace/tls/certificates/{certificate_id}` e em `/v4/workspace/tls/crls/{crl_id}`. `GET /v4/workspace/tls/certificates` e `GET /v4/workspace/tls/crls` listam esses objetos | -| Azion CLI | [`azion create digital-certificate`](/pt-br/documentacao/devtools/cli/recursos/), `azion create csr` e `azion create crl` | `azion list digital-certificate`, `azion describe digital-certificate`, `azion list crl` e `azion describe crl` | +| Azion CLI | [`azion create digital-certificate`](/pt-br/documentacao/devtools/cli/recursos/digital-certificate/), `azion create csr` e `azion create crl` | `azion list digital-certificate`, `azion describe digital-certificate`, `azion list crl` e `azion describe crl` | | [Terraform](/pt-br/documentacao/devtools/terraform/certificates/) | Os recursos de certificado que essa página lista | Os mesmos recursos | No Azion Console, a página **Create Digital Certificate** abre a partir do menu **Certificate Manager**, em `/digital-certificates/create`. Os presets dela são **Server Certificate**, **Trusted CA Certificate**, _New Let's Encrypt Certificate (HTTP-01)_ e _New Let's Encrypt Certificate (DNS-01)_. A página **Edit Digital Certificate** edita um certificado, e a página **Edit CRL** edita uma CRL. @@ -45,19 +45,23 @@ Um Workload pode usar três tipos de certificado. Certificate Manager armazena d ### Certificado SAN da Azion -O certificado SAN da Azion é o certificado TLS da própria Azion. Um Workload o apresenta para o workload domain e o hostname `azion.app` dele, e para todo hostname quando `tls.certificate` é `null`. No Azion Console, _Azion (SAN)_ no formulário do Workload define esse valor. O certificado lista os hostnames que a Azion atribui como Subject Alternative Names (SANs): o workload domain na zona `azionedge.net` e o hostname `azion.app` que Azion Console chama de **Azion Custom Domain**. Ele não tem custo adicional e não exige upload. +O certificado SAN da Azion é o certificado TLS da própria Azion. Um Workload o apresenta para o workload domain e o hostname `azion.app` dele, e para todo hostname quando `tls.certificate` é `null`. No Azion Console, _Azion (SAN)_ no formulário do Workload define esse valor. + +O certificado lista os hostnames que a Azion atribui como Subject Alternative Names (SANs): o workload domain na zona `azionedge.net` e o hostname `azion.app` que Azion Console chama de **Azion Custom Domain**. Ele não tem custo adicional e não exige upload. Por exemplo, um Workload de teste acessado somente em `.map.azionedge.net` serve HTTPS com o certificado SAN da Azion, sem nada a gerenciar. A zona `azionedge.net` é compartilhada com outros clientes da Azion, e o certificado SAN da Azion não cobre nenhum domínio seu. Então um hostname em um domínio próprio precisa de um certificado de servidor. ### Certificado de servidor -Um certificado de servidor é um certificado TLS para os seus próprios domínios, que um Workload apresenta para provar que detém um hostname. Certificate Manager o armazena com `type` definido como `edge_certificate`. Você faz upload de um certificado que uma CA emitiu para você, com a chave privada, sem custo adicional. Ou pede à Azion que solicite um certificado ao Let's Encrypt, como descreve Certificado Let's Encrypt. +Um certificado de servidor é um certificado TLS para os seus próprios domínios, que um Workload apresenta para provar que detém um hostname. Certificate Manager o armazena com `type` definido como `edge_certificate`. Você faz upload de um certificado que uma autoridade certificadora (CA) emitiu para você, com a chave privada, sem custo adicional. Ou pede à Azion que solicite um certificado ao Let's Encrypt, como descreve [Certificado Let's Encrypt](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-lets-encrypt). + +São aceitos tanto um certificado para um único domínio quanto um certificado para vários hostnames listados como SANs. A API não compara esses nomes com os domínios do Workload: ela aceita um certificado cujos nomes não correspondem a eles. O Workload então apresenta esse certificado para os domínios personalizados dele mesmo assim, e a verificação dos nomes feita pelo cliente falha. -São aceitos tanto um certificado para um único domínio quanto um certificado para vários hostnames listados como SANs. A API não compara esses nomes com os domínios do Workload: ela aceita um certificado cujos nomes não correspondem a eles. O Workload então apresenta esse certificado para os domínios próprios dele mesmo assim, e a verificação dos nomes feita pelo cliente falha. Um domínio servido com um certificado de servidor vinculado depende da extensão Server Name Indication (SNI) do TLS. Um cliente sem SNI recebe o certificado SAN da Azion. +Um domínio servido com um certificado de servidor vinculado depende da extensão Server Name Indication (SNI) do TLS. Um cliente sem SNI recebe o certificado SAN da Azion. Depois de salva, a chave privada não pode ser lida de volta pelo Azion Console nem pela API. A página de edição exibe "Paste the PEM-encoded TLS X.509 certificate and private key in the respective fields to update the certificate. The current certificate and private key are hidden to protect sensitive information." -Para substituir um certificado de servidor sem indisponibilidade, consulte [Boas práticas de Workloads](/pt-br/documentacao/plataforma/workloads/boas-praticas/#certificate-manager). +Para substituir um certificado de servidor sem indisponibilidade, consulte [Boas práticas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/boas-praticas/). ### Níveis de validação @@ -75,7 +79,7 @@ Um certificado Let's Encrypt é um certificado de servidor que a Azion solicita Você solicita um certificado pelo preset _New Let's Encrypt Certificate (DNS-01)_ ou _New Let's Encrypt Certificate (HTTP-01)_, ou com `POST /v4/workspace/tls/certificates/request`. No Azion Console, os presets aparecem em Certificate Manager e no campo **Digital Certificate** do Workload. Pelo formulário do Workload, Azion Console nomeia o certificado `Lets Encrypt - - `. Ele define `key_algorithm` como `rsa_2048` e obtém `common_name` e `alternative_names` dos **Domains** do Workload. -No Azion Console, a página de edição de um certificado gerenciado exibe "This is a Let's Encrypt™ certificate automatically created and managed by Azion." Um certificado wildcard, como um para `*.example.com`, é emitido pelo desafio DNS-01. Cada nome da solicitação deve pertencer a um domínio para o qual a conta tem permissão; caso contrário, a solicitação é recusada, como Erros lista. Para os desafios, o cronograma de renovação e os nomes wildcard, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +No Azion Console, a página de edição de um certificado gerenciado exibe "This is a Let's Encrypt™ certificate automatically created and managed by Azion." Um certificado wildcard, como um para `*.example.com`, é emitido pelo desafio DNS-01. Cada nome da solicitação deve pertencer a um domínio para o qual a conta tem permissão; caso contrário, a solicitação é recusada, como lista [Erros](/pt-br/documentacao/plataforma/certificate-manager/certificados/#erros). Para os desafios, o cronograma de renovação e os nomes wildcard, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). ### Certificado de CA confiável @@ -107,7 +111,7 @@ A Azion preenche os campos abaixo, e nenhuma requisição pode defini-los: | Campo da API | Tipo | O que contém | | --- | --- | --- | | `id` | integer | O ID do certificado, atribuído pela Azion | -| `status` | enum | O estado do certificado, como Status descreve | +| `status` | enum | O estado do certificado, como descreve [Status](/pt-br/documentacao/plataforma/certificate-manager/certificados/#status) | | `status_detail` | string, de 0 a 500 caracteres | O motivo da falha na emissão; vazio (`""`) nos outros casos | | `managed` | boolean | `true` para um certificado Let's Encrypt que a Azion gerencia, `false` nos outros casos | | `key_algorithm` | string | Em um certificado enviado por upload, o algoritmo da chave, como `rsa_2048` | @@ -191,7 +195,7 @@ O campo somente leitura `status` informa o estado de um certificado. A API retor A lista de certificados do Azion Console mostra um ícone de aviso para um certificado `pending` e um ícone de erro para um certificado `failed`, com `status_detail` como explicação. Um certificado cuja data de `validity` passou recebe a tag **Expired**. O campo **Digital Certificate** do Workload avisa "This certificate is pending validation and HTTPS may not work until it’s validated" para um certificado pendente. Para um certificado com falha, ele avisa "This digital certificate failed and HTTPS cannot be used until the issue is resolved". -Um certificado enviado por upload fica `inactive` até que você o vincule a um Workload, e fica `active` a partir de então. Vincular um certificado é uma alteração no Workload, e ela leva vários minutos para chegar a toda a infraestrutura distribuída da Azion. Nesse intervalo, as requisições podem encontrar a configuração antiga ou a nova. Para saber como um certificado Let's Encrypt passa por `pending`, `challenge_verification` e `active`, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). +Um certificado enviado por upload fica `inactive` até que você o vincule a um Workload, e fica `active` a partir de então. Vincular um certificado é uma alteração no Workload, e ela leva vários minutos para chegar a toda a infraestrutura distribuída da Azion. Nesse intervalo, as requisições podem encontrar a configuração antiga ou a nova. Para saber como um certificado Let's Encrypt passa por `pending`, `challenge_verification` e `active`, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). `azion list digital-certificate --details` mostra o status de cada certificado. Aqui, um certificado de CA confiável e um certificado de servidor estão vinculados a um Workload, e um segundo certificado de servidor não está: @@ -270,7 +274,7 @@ Error: Failed to create the Certificate Signing Request: ["This account cannot u ## Listas de revogação de certificados -Uma lista de revogação de certificados (CRL) é a lista de certificados que uma CA revogou antes da data de expiração deles, assinada por essa CA. Certificate Manager armazena CRLs, e um Workload com mTLS ativado lista até 100 delas em `mtls.config.crl`. Para os campos de `mtls` que as listam, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#campos). +Uma lista de revogação de certificados (CRL) é a lista de certificados que uma CA revogou antes de expirarem, assinada por essa CA. Certificate Manager armazena CRLs, e um Workload com mTLS ativado lista até 100 delas em `mtls.config.crl`. Para os campos de `mtls` que as listam, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#campos). | Controle no Console | Campo da API | Tipo | Valores | Padrão | Flag da CLI | | --- | --- | --- | --- | --- | --- | @@ -291,7 +295,9 @@ A Azion preenche os campos abaixo a partir da própria CRL e da requisição: | `last_modified` | string, date-time | Quando o conteúdo da CRL mudou pela última vez | | `product_version` | string | `1.0` | -A Azion valida uma CRL antes de armazená-la. Cada requisição armazena uma CRL, então, para adicionar várias, envie um `POST /v4/workspace/tls/crls` por CRL. Uma CRL que um Workload lista em `mtls.config.crl` não pode ser excluída: remova a CRL do Workload primeiro. No Azion Console, a página **Edit CRL** exibe "Paste the PEM-encoded CRL in the respective field to update the certificate. The current certificate is hidden to protect sensitive information." +A Azion valida uma CRL antes de armazená-la. Cada requisição armazena uma CRL, então, para adicionar várias, envie um `POST /v4/workspace/tls/crls` por CRL. Uma CRL que um Workload lista em `mtls.config.crl` não pode ser excluída: remova a CRL do Workload primeiro. + +No Azion Console, a página **Edit CRL** exibe "Paste the PEM-encoded CRL in the respective field to update the certificate. The current certificate is hidden to protect sensitive information." Armazene uma CRL com a CLI: @@ -327,7 +333,7 @@ Created Certificate Revocation List with ID ## Erros -A API recusa cada requisição abaixo com a mensagem da primeira coluna. A CLI imprime a mensagem dentro de `Error: Failed to create the Digital Certificate: [...]`, `Error: Failed to request the Digital Certificate: [...]`, `Error: Failed to create the Certificate Signing Request: [...]` ou `Error: Failed to update the Workload: [...]`. A mensagem é seguida por `Check your settings and try again. If the error persists, contact Azion support`. Para sintomas que não retornam mensagem, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#certificate-manager). +A API recusa cada requisição abaixo com a mensagem da primeira coluna. A CLI imprime a mensagem dentro de `Error: Failed to create the Digital Certificate: [...]`, `Error: Failed to request the Digital Certificate: [...]`, `Error: Failed to create the Certificate Signing Request: [...]` ou `Error: Failed to update the Workload: [...]`. A mensagem é seguida por `Check your settings and try again. If the error persists, contact Azion support`. Para sintomas que não retornam mensagem, consulte [Solucione problemas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/). | Mensagem | Causa | O que fazer | | --- | --- | --- | @@ -336,7 +342,7 @@ A API recusa cada requisição abaixo com a mensagem da primeira coluna. A CLI i | `Invalid certificate type, MUST be an Edge Certificate.` | O `tls.certificate` de um Workload contém o ID de um certificado de CA confiável. | Envie o ID de um certificado do tipo `edge_certificate`, ou `null` para o certificado SAN da Azion. | | `Invalid certificate type, MUST be a Trusted CA.` | O `mtls.config.certificate` de um Workload contém o ID de um certificado de servidor. | Envie o ID de um certificado do tipo `trusted_ca_certificate`. | -Um hostname `azion.app` em uma solicitação Let's Encrypt ou em uma CSR também recebe a recusa por permissão, mesmo um que um Workload da conta mantém. Para as formas de chave privada que a API aceita, consulte [Algoritmos de chave e formatos](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#algoritmos-de-chave-e-formatos). +Um hostname `azion.app` em uma solicitação Let's Encrypt ou em uma CSR também recebe a recusa por permissão, mesmo um que um Workload da conta mantém. Para as formas de chave privada que a API aceita, consulte [Algoritmos de chave e formatos](/pt-br/documentacao/plataforma/certificate-manager/certificados/#algoritmos-de-chave-e-formatos). --- @@ -344,9 +350,9 @@ Um hostname `azion.app` em uma solicitação Let's Encrypt ou em uma CSR também - Como a Azion solicita e renova um certificado Let's Encrypt, com o que cada desafio exige. + Como a Azion solicita e renova um certificado Let's Encrypt, com o que cada desafio exige. Como um Workload verifica certificados de cliente com um certificado de CA confiável, nos modos enforce e permissive, e lista as CRLs dele. As etapas para fazer upload de um certificado de servidor e vinculá-lo a um Workload. - O tamanho de um certificado, de uma chave privada e de uma CRL, ao lado dos outros limites dos Workloads. + O tamanho de um certificado, de uma chave privada e de uma CRL, e o número de CRLs que um Workload lista. diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/como-funciona.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/como-funciona.mdx new file mode 100644 index 0000000000..a94f5448fb --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/como-funciona.mdx @@ -0,0 +1,72 @@ +--- +title: Como Certificate Manager funciona +description: Entenda o que Certificate Manager armazena, como um Workload vincula um certificado de servidor ou de CA confiável e o que custa manter os certificados à parte. +meta_tags: 'certificate manager, how it works, server certificate, trusted ca certificate, crl, csr, certificate binding, tls, mtls, workloads' +namespace: documentation_products_certificate_manager_how_it_works +permalink: /documentacao/plataforma/certificate-manager/como-funciona/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +Uma conexão HTTPS começa com um handshake em que o servidor apresenta um certificado cujos nomes cobrem o hostname que o cliente pediu. Um servidor que também verifica os seus clientes precisa do certificado da autoridade que assina os certificados deles. + +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) é um recurso da plataforma que armazena os certificados que um [Workload](/pt-br/documentacao/plataforma/workloads/) usa para Transport Layer Security (TLS). O handshake, passo a passo, está em [Caminho da requisição](/pt-br/documentacao/plataforma/certificate-manager/#caminho-da-requisicao), e a forma como a Azion obtém um certificado Let's Encrypt está em [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/). As seções tratam do que Certificate Manager armazena, de como um Workload vincula um certificado e do custo de armazenar os certificados à parte do Workload. + +--- + +## O que Certificate Manager armazena + +Certificate Manager armazena dois tipos de certificado, de servidor e de CA confiável, além de listas de revogação, e cria solicitações de assinatura de certificado. + +Um certificado de servidor é um certificado TLS para os seus próprios domínios. O Workload o apresenta no handshake para provar que detém um hostname. Você o envia com a chave privada dele, ou a Azion o solicita ao Let's Encrypt e o renova para você. + +Um domínio seu precisa de um certificado de servidor, porque o certificado SAN da Azion, o certificado da própria Azion, cobre apenas o workload domain e o hostname `azion.app`. Por exemplo, um Workload acessado apenas pelo seu workload domain serve HTTPS sem nada armazenado em Certificate Manager. Quando `www.example.com` entra nos domínios desse Workload, ele precisa de um certificado de servidor que o cubra. + +Um certificado de CA confiável é o certificado de uma autoridade certificadora (CA) em que você confia para assinar certificados de cliente. Um Workload com o TLS mútuo (mTLS) ativado verifica cada certificado de cliente contra ele, e [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#modos-de-verificacao) descreve como os modos `enforce` e `permissive` tratam cada cliente. + +Uma lista de revogação de certificados (CRL) é a lista dos certificados que uma CA revogou antes da data de expiração deles, assinada por essa CA. + +Uma solicitação de assinatura de certificado (CSR) é a solicitação que você envia a uma CA para obter um certificado próprio. Certificate Manager cria a CSR e gera a chave privada dela, que a Azion guarda e a API nunca retorna. Para os campos de cada objeto, consulte [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). + +--- + +## Vínculo de certificados + +Um certificado em Certificate Manager não alcança nenhum tráfego até que você o vincule a um Workload. Depois de vinculado, ele age durante o handshake TLS, antes que um Firewall ou uma Application veja a requisição. + +Cada tipo de entrada vai no campo do Workload destinado a ele: + +- Um certificado de servidor vai em [`tls.certificate`](/pt-br/documentacao/plataforma/workloads/configuracoes/#tls). +- Um certificado de CA confiável vai em [`mtls.config.certificate`](/pt-br/documentacao/plataforma/workloads/configuracoes/#mtls). +- As CRLs vão em `mtls.config.crl`. + +A API recusa um certificado enviado no campo destinado ao outro tipo. Para a recusa e a correção dela, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#um-certificado-e-recusado-em-uma-configuracao-do-workload). + +Com `tls.certificate` definido como `null`, o Workload apresenta o certificado SAN da Azion. + +O status de um certificado enviado mostra se algum Workload o usa. Ele fica `inactive` até que você o vincule a um Workload, e `active` a partir de então. Para todos os valores de status, consulte [Status](/pt-br/documentacao/plataforma/certificate-manager/certificados/#status). + +--- + +## Certificados armazenados à parte do Workload + +Certificate Manager guarda cada certificado à parte do Workload, então substituir um deles não altera as outras configurações do Workload. Por exemplo, trocar um certificado enviado antes que ele expire muda um único valor, `tls.certificate`, e a entrada antiga permanece em Certificate Manager até que você a exclua. + +O preço dessa separação são duas verificações independentes, uma por entidade. A API não compara os nomes de um certificado com os domínios do Workload, então aceita um certificado que não os cobre. Essa divergência só aparece quando um cliente verifica os nomes, como um handshake que falha. + +Vincular um certificado também é uma mudança do Workload, e ela leva vários minutos para alcançar toda a infraestrutura distribuída da Azion. Até lá, alguns data centers servem a configuração antiga e outros a nova, como descreve [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). + +--- + +## Recursos relacionados + + + + Cada campo de um certificado, de uma CSR e de uma CRL, com os status, os formatos de chave e os erros por trás desta página. + Envie um certificado de servidor, vincule-o a um Workload e confirme que ele fica active. + O tamanho de um certificado, de uma chave privada e de uma CRL, e o número de CRLs que um Workload lista. + Substitua um certificado antes que ele expire e mantenha cada caminho de renovação funcionando. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/emissao-e-renovacao.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/emissao-e-renovacao.mdx index 4c46c7fa7d..8fb82eca3d 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/emissao-e-renovacao.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/emissao-e-renovacao.mdx @@ -3,7 +3,7 @@ title: Emissão e renovação description: Entenda como a Azion solicita e renova um certificado Let's Encrypt para os domínios de um Workload, qual desafio prova o controle e o que ocorre na falha. meta_tags: 'certificate manager, lets encrypt, acme, http-01, dns-01, wildcard certificate, renewal, certificate status, workloads' namespace: documentation_products_certificate_manager_issuance_and_renewal -permalink: /documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/ +permalink: /documentacao/plataforma/certificate-manager/emissao-e-renovacao/ --- import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' @@ -11,7 +11,7 @@ import DocItem from '@aziontech/webkit/doc-item' Uma autoridade certificadora (CA) é uma organização que assina certificados. Ela assina um certificado somente depois que o solicitante prova o controle de todos os nomes que ele contém. A prova é um desafio: um valor que a CA verifica nos registros de Domain Name System (DNS) do domínio, ou um arquivo servido no hostname. Let's Encrypt é uma CA que emite certificados válidos por 90 dias, então um certificado só continua útil enquanto alguém o renova. -Para o certificado de servidor de um Workload, a Azion assume esse trabalho: ela solicita o certificado ao Let's Encrypt, conclui o desafio e renova o certificado antes que ele expire. [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) é um recurso da plataforma que armazena os certificados que um Workload usa para Transport Layer Security (TLS). Para saber onde Certificate Manager age sobre uma requisição, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/#certificate-manager). Um certificado que você envia, ou que obtém de uma CA por meio de uma solicitação de assinatura de certificado (CSR), é descrito em [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). +Para o certificado de servidor de um Workload, a Azion assume esse trabalho: ela solicita o certificado ao Let's Encrypt, conclui o desafio e renova o certificado antes que ele expire. [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) é um recurso da plataforma que armazena os certificados que um Workload usa para Transport Layer Security (TLS). Para saber onde Certificate Manager age sobre uma requisição, consulte [Caminho da requisição](/pt-br/documentacao/plataforma/certificate-manager/#caminho-da-requisicao). Um certificado que você envia, ou que obtém de uma CA por meio de uma solicitação de assinatura de certificado (CSR), é descrito em [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). As seções cobrem as solicitações de certificado, a validação de domínio, os certificados wildcard, os status, o tempo de emissão e as novas tentativas, e a renovação. @@ -19,13 +19,13 @@ As seções cobrem as solicitações de certificado, a validação de domínio, ## Solicitações de certificado -Uma solicitação Let's Encrypt pede à Azion que obtenha um certificado para um conjunto de hostnames. No corpo de uma solicitação pela API, o hostname principal vai em `common_name`. Opcionalmente, outros hostnames vão em `alternative_names`, e o certificado os lista como Subject Alternative Names (SANs). O corpo também nomeia a autoridade, `lets_encrypt`, e o desafio que prova o controle dos nomes: `http` para HTTP-01 ou `dns` para DNS-01. No Azion Console, o formulário do Workload preenche esses campos para você. Os nomes vêm dos **Domains** do Workload, e o desafio vem da predefinição que você escolhe. +Uma solicitação Let's Encrypt pede à Azion que obtenha um certificado para um conjunto de hostnames. No corpo de uma solicitação pela API, o hostname principal vai em `common_name`, e outros hostnames opcionais vão em `alternative_names`, que o certificado lista como Subject Alternative Names (SANs). O corpo também nomeia a autoridade, `lets_encrypt`, e o desafio que prova o controle dos nomes: `http` para HTTP-01 ou `dns` para DNS-01. Uma solicitação pelo formulário do Workload no Azion Console obtém os nomes dos domínios do Workload e o desafio da predefinição que você escolhe. -A Azion gera a chave do certificado. Em uma solicitação pela API, `key_algorithm` tem o padrão `ecc_384`. Para os outros algoritmos e padrões, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#campos-do-certificado). +A Azion gera a chave do certificado. `key_algorithm` tem o padrão `ecc_384` em uma solicitação pela API e `rsa_2048` em uma solicitação pelo formulário do Workload. Para os outros algoritmos, consulte [Campos do certificado](/pt-br/documentacao/plataforma/certificate-manager/certificados/#campos-do-certificado). -Você solicita um certificado no Azion Console ou pela API. [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/) e [Solicite um certificado Let's Encrypt com a API](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt-via-api/) mostram os passos. As predefinições do Console _New Let's Encrypt Certificate (HTTP-01)_ e _New Let's Encrypt Certificate (DNS-01)_ aparecem em Certificate Manager e no campo **Digital Certificate** do Workload. Pela API, a solicitação é `POST /v4/workspace/tls/certificates/request`. A partir do formulário do Workload, o Console nomeia o certificado como `Lets Encrypt - - ` e define `key_algorithm` como `rsa_2048`. +Você solicita um certificado no Azion Console ou com `POST /v4/workspace/tls/certificates/request`. [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/) e [Solicite um certificado Let's Encrypt com a API](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt-via-api/) mostram os passos. Para as predefinições do Console que iniciam uma solicitação e o nome que o Console dá ao certificado, consulte [Certificado Let's Encrypt](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-lets-encrypt). -A API responde a uma solicitação com o `id` do certificado, e a Azion agenda a emissão. Até que o Let's Encrypt emita o certificado, a entrada guarda um certificado temporário que a Azion gera. O certificado aparece em Certificate Manager a partir de então, e o `id` o identifica quando você verifica o seu status. +Até que o Let's Encrypt emita o certificado, a entrada dele em Certificate Manager guarda um certificado temporário que a Azion gera. O certificado aparece em Certificate Manager desde a solicitação, e o `id` que a API retorna o identifica quando você verifica o seu status. Este diagrama acompanha uma solicitação, de você até o Workload que apresenta o certificado. As setas contínuas levam solicitações e verificações, e as setas pontilhadas levam respostas. Cada rótulo começa com o número do passo a que pertence. @@ -53,7 +53,7 @@ flowchart TD 3. A Azion solicita o certificado ao Let's Encrypt para todos os nomes da solicitação. 4. O Let's Encrypt valida cada nome por meio do desafio. Com o HTTP-01, ele busca um arquivo no hostname, que a Azion serve. Com o DNS-01, ele lê o registro TXT `_acme-challenge` que a Azion escreve, em uma zona do Edge DNS ou por meio do registro Canonical Name (CNAME) que você adiciona em outro provedor de DNS. 5. O Let's Encrypt emite o certificado, e Certificate Manager o armazena. -6. Um Workload com o certificado vinculado em `tls.certificate` o apresenta no handshake TLS para os domínios próprios do Workload. +6. Um Workload com o certificado vinculado em `tls.certificate` o apresenta no handshake TLS para os domínios personalizados do Workload. A Azion solicita certificados Let's Encrypt para domínios e subdomínios registrados no DNS. Todo nome da solicitação também precisa pertencer a um domínio para o qual a conta tem permissão. Caso contrário, a solicitação é recusada com `This account cannot use certain common or alternative names because it does not have permission for their domain names.` Um hostname `azion.app` também é recusado, mesmo um que um Workload da conta tenha. @@ -63,7 +63,9 @@ A Azion solicita certificados Let's Encrypt para domínios e subdomínios regist O Let's Encrypt valida todos os nomes de uma solicitação antes de emitir o certificado, e o desafio da solicitação decide como. A Azion oferece suporte aos dois desafios, HTTP-01 e DNS-01, para um domínio cujo DNS está hospedado no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) ou em outro provedor de DNS. -Com o HTTP-01, o Let's Encrypt valida o hostname por meio de um arquivo servido para ele, e a Azion executa o serviço que responde ao desafio. O DNS do domínio não precisa de registro TXT, então o desafio não pede nenhuma mudança na zona do domínio. O hostname já precisa apontar para a Azion quando você envia a solicitação. Quando a solicitação leva nomes alternativos, todos eles precisam apontar para a Azion, ou a emissão falha. A Azion agenda a emissão mesmo quando nenhum Workload com o hostname está publicado e ativo. Como nenhuma mudança de DNS é necessária por nome, o HTTP-01 atende bem a uma conta que gerencia muitos domínios e hostnames. +Com o HTTP-01, o Let's Encrypt valida o hostname por meio de um arquivo servido para ele, e a Azion executa o serviço que responde ao desafio. Nenhum nome precisa de registro TXT nem de outra mudança na zona do domínio, então o HTTP-01 atende bem a uma conta que gerencia muitos domínios e hostnames. + +O hostname já precisa apontar para a Azion quando você envia uma solicitação HTTP-01. Todo nome alternativo da solicitação também precisa apontar para a Azion, ou a emissão falha. A Azion agenda a emissão mesmo quando nenhum Workload com o hostname está publicado e ativo. Com o DNS-01, o Let's Encrypt valida o hostname por meio de um registro TXT no DNS do domínio, sob o nome `_acme-challenge` do hostname. Quem prepara o DNS depende de onde a zona está hospedada: @@ -79,7 +81,7 @@ Cada desafio atende a uma situação diferente: | HTTP-01 | `http` | Você não controla os registros DNS do domínio, e o domínio já aponta para a Azion | | DNS-01 | `dns` | Você controla os registros DNS, precisa de um nome wildcard ou não acessa o servidor web | -Os dois desafios trocam uma dependência do tráfego por uma dependência do DNS. O HTTP-01 não precisa de registro, mas não consegue validar um hostname que ainda não aponta para a Azion. Por exemplo, durante uma migração para a Azion, uma solicitação DNS-01 pode obter o certificado para `www.example.com` enquanto o hostname ainda aponta para o provedor anterior. Uma solicitação HTTP-01 só consegue obtê-lo depois que o hostname aponta para a Azion. +Os dois desafios trocam uma dependência do tráfego por uma dependência do DNS. Por exemplo, durante uma migração para a Azion, uma solicitação DNS-01 pode obter o certificado para `www.example.com` enquanto o hostname ainda aponta para o provedor anterior. Uma solicitação HTTP-01 só consegue obtê-lo depois que o hostname aponta para a Azion. --- @@ -87,13 +89,13 @@ Os dois desafios trocam uma dependência do tráfego por uma dependência do DNS Um nome wildcard, como `*.example.com`, permite que um único certificado cubra subdomínios que você não lista um a um. Um certificado wildcard passa pelo desafio DNS-01, e a Azion o solicita e o renova automaticamente. -A emissão automática precisa que a zona do domínio esteja configurada e ativa no Edge DNS, o que dá à Azion controle sobre os registros de que a validação precisa. Durante a emissão, a Azion gera o registro TXT `_acme-challenge` e o insere na zona, sem nenhuma ação sua. Quando a zona não está ativa no Edge DNS, a Azion não consegue automatizar a validação, e você a conclui manualmente. +A emissão automática precisa que a zona do domínio esteja configurada e ativa no Edge DNS, o que dá à Azion controle sobre o registro TXT `_acme-challenge` de que a validação precisa. Quando a zona não está ativa no Edge DNS, a Azion não consegue automatizar a validação, e você a conclui manualmente. Um certificado pode levar um nome wildcard sozinho ou ao lado de nomes específicos. Um subdomínio que o wildcard já cobre não precisa de uma entrada própria: com `*.example.com` no certificado, `blog.example.com` não precisa ser listado. Um Workload, por outro lado, lista cada hostname por completo. Os domínios dele recusam uma entrada wildcard com `The domain does not conform to the format defined in RFC 1035.` O formulário do Workload solicita um certificado para os domínios do Workload, então não consegue solicitar um nome wildcard. Para solicitar um com o desafio DNS-01, consulte [Solicite um certificado Let's Encrypt com a API](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt-via-api/). -Um certificado wildcard no lugar de um certificado por subdomínio significa menos certificados distintos para emitir. Isso reduz a chance de atingir os limites de emissão do serviço Let's Encrypt, que [Limites de Workloads](/pt-br/documentacao/plataforma/workloads/limites/#certificate-manager) indica. O custo é uma dependência do DNS: a emissão automática precisa da zona no Edge DNS, e uma zona em outro lugar significa validar manualmente. Para saber quando um certificado compartilhado por muitos subdomínios é um risco, consulte [Boas práticas de Workloads](/pt-br/documentacao/plataforma/workloads/boas-praticas/#certificate-manager). +Um certificado wildcard no lugar de um certificado por subdomínio significa menos certificados distintos para emitir. Isso reduz a chance de atingir os limites de emissão do serviço Let's Encrypt, que [Limites do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/limites/) indica. O custo é a dependência do Edge DNS que a emissão automática traz. Para saber quando um certificado compartilhado por muitos subdomínios é um risco, consulte [Boas práticas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/boas-praticas/). --- @@ -127,9 +129,9 @@ flowchart TD 4. Quando a validação falha, o certificado aparece como `failed` e mantém esse status entre as novas tentativas da emissão. O campo `status_detail` traz o motivo, como `An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com`. 5. Depois que a data de `validity` passa, o certificado aparece como `expired` e não protege mais o tráfego. -Azion Console mostra os mesmos estados. A lista de certificados marca um certificado `pending` com um ícone de aviso e um `failed` com um ícone de erro, com `status_detail` como explicação. Um certificado cuja data de `validity` já passou leva a tag **Expired**. +Você pode vincular um certificado a um Workload antes que o Let's Encrypt o emita, mas o HTTPS nos domínios do Workload pode não funcionar até que o certificado seja validado. No Azion Console, o campo **Digital Certificate** do Workload então avisa "This certificate is pending validation and HTTPS may not work until it’s validated". Para um certificado com falha, ele avisa "This digital certificate failed and HTTPS cannot be used until the issue is resolved". -Você pode vincular um certificado a um Workload antes que o Let's Encrypt o emita. No Azion Console, o campo **Digital Certificate** do Workload então avisa "This certificate is pending validation and HTTPS may not work until it’s validated". Para um certificado com falha, ele avisa "This digital certificate failed and HTTPS cannot be used until the issue is resolved". Até que o certificado seja validado, o HTTPS nos domínios do Workload pode não funcionar. Para a tabela completa de status, incluindo os certificados enviados, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#status). +Para a tabela completa de status, com os certificados enviados e os ícones da lista do Azion Console, consulte [Status](/pt-br/documentacao/plataforma/certificate-manager/certificados/#status). --- @@ -139,13 +141,13 @@ A Azion faz a primeira tentativa de obter um certificado Let's Encrypt em até 5 As 5 primeiras novas tentativas ocorrem em intervalos crescentes de cerca de 5 a 30 minutos e resolvem a maioria das falhas causadas pela propagação de DNS ou por um serviço temporariamente indisponível. -A Azion registra por que uma tentativa falhou em `status_detail`, que a API retorna com o certificado e Azion Console mostra com o ícone de status. Por exemplo, um CNAME `_acme-challenge` digitado errado no seu provedor de DNS faz as primeiras tentativas falharem, e `status_detail` nomeia o hostname cujo CNAME você deve verificar. Depois que você corrige o registro, uma tentativa posterior do cronograma pode obter o certificado. Para sintomas e as suas correções, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#certificate-manager). +A Azion registra por que uma tentativa falhou em `status_detail`, que a API retorna com o certificado e Azion Console mostra ao lado do ícone de erro do certificado. Por exemplo, um CNAME `_acme-challenge` digitado errado no seu provedor de DNS faz as primeiras tentativas falharem, e `status_detail` nomeia o hostname cujo CNAME você deve verificar. Depois que você corrige o registro, uma tentativa posterior do cronograma pode obter o certificado. Para sintomas e as suas correções, consulte [Solucione problemas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/). --- ## Renovação -Um certificado Let's Encrypt expira 90 dias depois de emitido, e a Azion o renova automaticamente antes dessa data. A renovação começa 30 dias antes da expiração, quando o certificado se torna elegível para renovação. A Azion monitora os certificados que solicitou, conclui o desafio de novo conforme a renovação se aproxima e atualiza o certificado. O campo `renewed_at` registra quando a Azion o renovou pela última vez. +A Azion renova automaticamente um certificado Let's Encrypt antes que termine a sua validade de 90 dias. A renovação começa 30 dias antes da expiração, quando o certificado se torna elegível para renovação. A Azion monitora os certificados que solicitou, conclui o desafio de novo conforme a renovação se aproxima e atualiza o certificado. O campo `renewed_at` registra quando a Azion o renovou pela última vez. A renovação não precisa de janela de manutenção, e o certificado mantém as suas cotas, o seu faturamento e as suas permissões. Certificados wildcard são renovados da mesma forma. @@ -157,9 +159,11 @@ A Azion para de renovar um certificado nestes casos: - Você altera os domínios para os quais o certificado foi solicitado. A Azion cria outro certificado a partir do conjunto alterado, e o antigo não é renovado. - Você exclui o certificado, ou o domínio para o qual ele foi solicitado é removido da Azion. Cada um desses dois eventos também desativa um certificado gerenciado. -Um certificado desvinculado do seu Workload continua em Certificate Manager, e você pode vinculá-lo de novo enquanto ele permanece válido. A renovação automática elimina a data de expiração como tarefa, ao custo de uma dependência. O caminho de validação que obteve o certificado precisa continuar funcionando enquanto um Workload o usar. +Um certificado desvinculado do seu Workload continua em Certificate Manager, e você pode vinculá-lo de novo enquanto ele permanece válido. + +A renovação automática elimina a data de expiração como tarefa, ao custo de uma dependência. O caminho de validação que obteve o certificado precisa continuar funcionando enquanto um Workload o usar. -A Azion não renova um certificado que você envia. Para substituir um antes que expire, consulte [Boas práticas de Workloads](/pt-br/documentacao/plataforma/workloads/boas-praticas/#certificate-manager). +A Azion não renova um certificado que você envia. Para substituir um antes que expire, consulte [Boas práticas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/boas-praticas/). --- @@ -167,9 +171,9 @@ A Azion não renova um certificado que você envia. Para substituir um antes que - Todos os campos de uma solicitação Let's Encrypt, a tabela completa de status e os algoritmos de chave que a Azion gera. + Todos os campos de uma solicitação Let's Encrypt, a tabela completa de status e os algoritmos de chave que a Azion gera. Os passos para solicitar um certificado Let's Encrypt e preparar os registros DNS de que o seu desafio precisa. Os passos para adicionar o registro TXT que um desafio DNS-01 verifica. - Sintomas de um certificado que não é emitido ou renovado, com as suas causas e correções. + Sintomas de um certificado que não é emitido ou renovado, com as suas causas e correções. diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/glossario.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/glossario.mdx new file mode 100644 index 0000000000..edaf199331 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/glossario.mdx @@ -0,0 +1,19 @@ +--- +title: Glossário +description: Consulte o que Certificate Manager, CRL, CSR, certificado de CA confiável e os demais termos das páginas do Certificate Manager significam. +meta_tags: 'certificate manager, glossary, terms, digital certificate, trusted ca certificate, crl, csr, lets encrypt, azion san certificate' +namespace: documentation_products_certificate_manager_glossary +permalink: /documentacao/plataforma/certificate-manager/glossario/ +--- + +Definições dos termos que a documentação de **Certificate Manager** usa. + +| Termo | Definição | +| --- | --- | +| certificado de CA confiável | O certificado de uma autoridade certificadora que você envia para que um Workload possa verificar certificados de cliente em [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/), `trusted_ca_certificate` na API e **Trusted CA Certificate** no Azion Console. O envio aceita certificados intermediários, e um Workload o define em `mtls.config.certificate`, onde um certificado de servidor retorna `Invalid certificate type, MUST be a Trusted CA.` Para enviar um, consulte [Configure mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/). | +| certificado digital | Um certificado que Certificate Manager armazena, de qualquer tipo, com o nome que Azion Console e Azion CLI usam para ele, do campo **Digital Certificate** (`tls.certificate`) de um Workload ao comando `azion create digital-certificate`. O `type` dele é `edge_certificate` para um certificado de servidor ou `trusted_ca_certificate` para um certificado de CA confiável, e um certificado Let's Encrypt é um certificado que a Azion solicita e renova. [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/) compara os tipos. | +| certificado Let's Encrypt | Um certificado Transport Layer Security (TLS) gratuito assinado pela autoridade certificadora Let's Encrypt, que a Azion solicita e renova para você. O Let's Encrypt valida o domínio por meio de um desafio HTTP-01 ou DNS-01 que a Azion conclui, e a renovação começa 30 dias antes do fim da validade de 90 dias. [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/) cobre os desafios e a política de novas tentativas. | +| certificado SAN da Azion | O certificado TLS da própria Azion, que lista os hostnames que cobre como Subject Alternative Names (SAN). Um [Workload](/pt-br/documentacao/plataforma/workloads/) o apresenta no [workload domain](/pt-br/documentacao/plataforma/workloads/como-funciona/#workload-domain-e-dominios-personalizados), e em todo hostname enquanto `tls.certificate` é `null`, e ele cobre o workload domain e o [Azion custom domain](/pt-br/documentacao/plataforma/workloads/glossario/) sem custo adicional. Para apresentar um certificado para o seu próprio domínio, consulte [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). | +| Certificate Manager | Um recurso da plataforma que armazena os certificados que um [Workload](/pt-br/documentacao/plataforma/workloads/) usa para TLS, servido na API em `/v4/workspace/tls/`. Ele guarda certificados de servidor que você envia, certificados Let's Encrypt que a Azion solicita e renova, certificados de CA confiável, listas de revogação de certificados e CSRs. [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) descreve o que ele faz por um Workload, e [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/) vincula um primeiro certificado. | +| lista de revogação de certificados (CRL) | A lista dos certificados que uma autoridade certificadora revogou antes da data de expiração deles, assinada por essa autoridade certificadora. Você a envia ao Certificate Manager e a anexa a um Workload em `mtls.config.crl`, no máximo 100 por Workload, ao lado do certificado de CA confiável. [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/) documenta os campos dela. | +| solicitação de assinatura de certificado (CSR) | Uma solicitação de certificado que você cria no Certificate Manager e envia a uma autoridade certificadora (CA). O **Common Name** (`common_name`) define o domínio que o certificado cobre, e a CSR cria uma entrada de certificado ainda sem certificado. Depois que a CA assina o certificado, você adiciona o certificado codificado em PEM a essa entrada, e [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/) lista todos os campos. | diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/limites.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/limites.mdx new file mode 100644 index 0000000000..89ece878e0 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/limites.mdx @@ -0,0 +1,49 @@ +--- +title: Limites do Certificate Manager +description: Verifique o tamanho máximo de um certificado, de uma chave privada e de uma CRL, as CRLs que um Workload lista e onde o suporte a Let's Encrypt termina. +meta_tags: 'certificate manager, limits, certificate size, private key, crl, lets encrypt, rate limits, workloads, tls, mtls' +namespace: documentation_products_certificate_manager_limits +permalink: /documentacao/plataforma/certificate-manager/limites/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +[Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) é um recurso da plataforma que armazena os certificados que um [Workload](/pt-br/documentacao/plataforma/workloads/) usa para Transport Layer Security (TLS): certificados de servidor, certificados de CA confiável para o TLS mútuo (mTLS) e as listas de revogação de certificados (CRLs) que um Workload lista. Ele também solicita os certificados Let's Encrypt que a Azion gerencia para você. Certificate Manager não tem quantidade incluída por plano. + +--- + +## Escopo + +- **Certificado SAN da Azion**: um Workload não precisa de nada de Certificate Manager para o seu workload domain e o seu hostname `azion.app`, porque o certificado SAN da Azion cobre os dois. Um domínio seu precisa de um certificado de servidor de Certificate Manager. Para os tipos de certificado, consulte [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#tipos-de-certificado). +- **Nomes em um certificado Let's Encrypt**: um certificado solicitado pelo formulário do Workload cobre os domínios do Workload, porque o formulário preenche `common_name` e `alternative_names` a partir deles. Uma solicitação pela API nomeia os seus hostnames nesses dois campos. Um Workload recusa um domínio wildcard, então o formulário do Workload não consegue solicitar um nome wildcard. Para um nome wildcard, consulte [Certificados wildcard](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#certificados-wildcard). +- **Serviço Let's Encrypt**: o suporte da Azion a certificados Let's Encrypt depende da disponibilidade e dos limites do serviço Let's Encrypt. Um certificado wildcard no lugar de um certificado por subdomínio reduz a chance de atingir esses limites. Para os limites, consulte os [rate limits do Let's Encrypt](https://letsencrypt.org/docs/rate-limits/). + +--- + +## Limites padrão + +Azion API verifica cada limite desta tabela em toda chamada, e uma chamada que passa de um limite falha. + +| Escopo | Limite | +| --- | --- | +| Certificado, de servidor ou de CA confiável, em `certificate` | Até 1.000.000 caracteres | +| Chave privada, em `private_key` | Até 64.000 caracteres | +| CRL, em `crl` | Até 30.720.000 caracteres | +| CRLs por Workload, em `mtls.config.crl` | Até 100 | + +Um limite a mais se aplica: um certificado Let's Encrypt cobre até 50 dos domínios do Workload. Para o número de domínios que um Workload lista, consulte [Limites de Workloads](/pt-br/documentacao/plataforma/workloads/limites/). + +--- + +## Recursos relacionados + + + + Cada campo de um certificado, de uma CSR e de uma CRL, incluindo os campos aos quais os limites desta página se aplicam. + Como a Azion solicita um certificado Let's Encrypt para os domínios de um Workload e o renova. + Os campos do Workload que guardam um certificado de CA confiável e as CRLs que um Workload lista. + O que Certificate Manager armazena e como um Workload vincula cada certificado. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/primeiros-passos.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/primeiros-passos.mdx index 577be7a7b5..a19b8f5bc7 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/primeiros-passos.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/primeiros-passos.mdx @@ -3,7 +3,7 @@ title: Primeiros passos com Certificate Manager description: Envie o seu primeiro certificado ao Certificate Manager, vincule-o a um Workload e confirme que a plataforma o marca como ativo. meta_tags: 'certificate manager, quickstart, digital certificate, edge certificate, tls, https, workloads, azion cli' namespace: documentation_products_certificate_manager_quickstart -permalink: /documentacao/plataforma/workloads/certificate-manager/primeiros-passos/ +permalink: /documentacao/plataforma/certificate-manager/primeiros-passos/ --- import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' @@ -12,7 +12,7 @@ import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' import Code from '~/components/webkit/CodeBlock.vue' -Este guia orienta você a vincular o seu primeiro certificado próprio a um [Workload](/pt-br/documentacao/plataforma/workloads/) com [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager). +Este guia orienta você a vincular o seu primeiro certificado próprio a um [Workload](/pt-br/documentacao/plataforma/workloads/) com [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/). - Envie um certificado de servidor e a chave privada dele ao Certificate Manager. - Vincule o certificado ao seu Workload. @@ -26,7 +26,7 @@ Três elementos participam, e cada um se liga ao seguinte: Um certificado enviado não protege nenhum tráfego até que você o vincule a um Workload. O certificado SAN da Azion cobre somente o workload domain e o hostname `azion.app`. Um Workload continua a apresentá-lo para esses dois hostnames depois que você vincula o seu próprio certificado. Este guia altera somente as configurações de `tls` do Workload e mantém os domínios, as portas e o deployment dele como estão. -Para que a Azion solicite um certificado ao Let's Encrypt e o renove por você, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). No Azion Console, o campo **Digital Certificate** do Workload também oferece os presets do Let's Encrypt, descritos em [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-lets-encrypt). +Para que a Azion solicite um certificado ao Let's Encrypt e o renove por você, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). No Azion Console, o campo **Digital Certificate** do Workload também oferece os presets do Let's Encrypt, descritos em [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-lets-encrypt). --- @@ -360,7 +360,7 @@ Vincular um certificado é uma alteração no Workload. A alteração leva vári - + - + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/solucao-de-problemas.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/solucao-de-problemas.mdx new file mode 100644 index 0000000000..cf49ca6725 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/solucao-de-problemas.mdx @@ -0,0 +1,95 @@ +--- +title: Solucione problemas do Certificate Manager +description: Corrija um certificado Let's Encrypt que fica pendente ou falha na emissão, uma solicitação de certificado recusada e uma chave privada recusada. +meta_tags: 'certificate manager, troubleshooting, lets encrypt, pending certificate, failed certificate, status_detail, acme challenge, private key, csr, permission' +namespace: documentation_products_certificate_manager_troubleshooting +permalink: /documentacao/plataforma/certificate-manager/solucao-de-problemas/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +Estes sintomas afetam [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), o recurso da plataforma que armazena os certificados que um Workload usa para Transport Layer Security (TLS) e informa o estado de cada um no campo `status`. Eles cobrem um certificado Let's Encrypt que não é emitido e uma solicitação ou um envio que a API recusa. Um certificado recusado em uma configuração do Workload é um sintoma de Workloads, em [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#um-certificado-e-recusado-em-uma-configuracao-do-workload). Para saber onde Certificate Manager age sobre uma requisição, consulte [Caminho da requisição](/pt-br/documentacao/plataforma/certificate-manager/#caminho-da-requisicao). + +--- + +## Um certificado fica pendente + +Um certificado Let's Encrypt não sai do status `pending` ou `challenge_verification`. No Azion Console, o campo **Digital Certificate** do Workload avisa "This certificate is pending validation and HTTPS may not work until it’s validated". + +Um dos nomes falha no desafio: no HTTP-01, o Let's Encrypt busca um arquivo em cada hostname, então todo nome precisa apontar para a Azion. No DNS-01, ele lê um registro `_acme-challenge` no DNS do domínio, como explica [Validação de domínio](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#validacao-de-dominio). + +- **Verifique os nomes**: um certificado solicitado pelo formulário do Workload no Azion Console cobre os **Domains** do Workload, então confirme que cada um está correto. +- **Aponte todo nome para a Azion no HTTP-01**, incluindo os nomes alternativos. +- **Adicione o CNAME do DNS-01 em outro provedor de DNS**: dê a ele o nome `_acme-challenge.`, com o valor `.letsencrypt.azion.com`. No Edge DNS, a própria Azion escreve o registro. +- **Verifique os registros CNAME de novo se o certificado continuar falhando**: a Azion tenta de novo uma emissão que falhou em intervalos crescentes, como lista [Tempo de emissão e novas tentativas](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas). + +Depois que uma tentativa posterior valida, o certificado aparece como `active` enquanto um Workload o usa, ou `inactive` até lá. Para os registros passo a passo, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). + +--- + +## Uma solicitação de certificado é recusada com This account cannot use certain common or alternative names + +Uma solicitação Let's Encrypt, uma solicitação de assinatura de certificado (CSR) ou o salvamento de um domínio novo no Azion Console falha com `This account cannot use certain common or alternative names because it does not have permission for their domain names.` + +A solicitação traz um nome em um domínio para o qual a conta não tem permissão. Um hostname `azion.app` também é recusado, mesmo um que um Workload da conta tenha, como lista [Erros](/pt-br/documentacao/plataforma/certificate-manager/certificados/#erros). + +- **Nomeie apenas hostnames em domínios para os quais a sua conta tem permissão**, em `common_name` e `alternative_names`. +- **Não solicite certificado para um hostname `azion.app`**: com `tls.certificate` definido como `null`, o Workload apresenta o certificado SAN da Azion, que cobre o hostname `azion.app` e o workload domain. +- **Remova o domínio recusado de Domains no Azion Console**: adicionar um domínio troca **Digital Certificate** de _Azion (SAN)_ para _New Let's Encrypt Certificate (DNS-01)_. **Save** então solicita esse certificado antes de salvar o Workload e não salva nada quando a solicitação é recusada. + +Uma solicitação aceita retorna o `id` do certificado com o status `pending`, e Azion Console mostra "Your workload has been updated". + +--- + +## A emissão de um certificado falha + +Um certificado Let's Encrypt aparece como `failed`. No Azion Console, o campo **Digital Certificate** do Workload avisa "This digital certificate failed and HTTPS cannot be used until the issue is resolved". + +A validação falhou, e a Azion guarda o motivo no campo `status_detail` do certificado. Um valor nomeia o hostname cujo registro deve ser verificado: + +```text +An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com +``` + +Outro valor não nomeia hostname, então verifique todos os nomes do certificado, como lista [Um certificado fica pendente](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/#um-certificado-fica-pendente): + +```text +domain ownership validation failed - verify DNS records or HTTP challenge accessibility +``` + +Leia `status_detail` em qualquer interface e corrija o registro ou o nome para o qual ele aponta: + +- **Azion Console**: em **Certificate Manager**, o ícone de erro do certificado o mostra. +- **Azion CLI**: `azion describe digital-certificate --digital-certificate-id --format json` o imprime ao lado de `status`. +- **API**: `GET /v4/workspace/tls/certificates/` o retorna com o certificado. + +Uma tentativa posterior no [cronograma de novas tentativas](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas) pode então emitir o certificado, e um certificado emitido em uso aparece como `active`, com `status_detail` em `""`. + +--- + +## Uma chave privada enviada é recusada + +O envio de um certificado de servidor falha com `The provided private key is invalid. Please check the key and try again.` + +A API não consegue ler a `private_key` que chegou com o certificado, como lista [Erros](/pt-br/documentacao/plataforma/certificate-manager/certificados/#erros). + +- **Envie a chave que corresponde ao certificado**. +- **Envie a chave em PEM**, com as linhas `-----BEGIN` e `-----END` e sem passphrase, como lista [Algoritmos de chave e formatos](/pt-br/documentacao/plataforma/certificate-manager/certificados/#algoritmos-de-chave-e-formatos). +- **Escreva a chave como uma única string JSON em um corpo de API**, com cada quebra de linha escrita como `\n`. + +Azion CLI então imprime `Created Digital Certificate with ID `, e o certificado aparece como `inactive` até que um Workload o use. + +--- + +## Recursos relacionados + + + + Os tipos, os status e os formatos de chave de certificado, com cada erro que um envio ou uma solicitação retorna. + Como cada desafio valida um nome e o cronograma que a Azion segue quando uma tentativa falha. + Os passos para enviar um certificado de servidor com a chave privada dele e vinculá-lo a um Workload. + Mantenha o registro de desafio no lugar e substitua um certificado enviado antes que ele expire. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/visao-geral.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/visao-geral.mdx new file mode 100644 index 0000000000..7e3682f421 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/certificate-manager/visao-geral.mdx @@ -0,0 +1,65 @@ +--- +title: Certificate Manager +description: Armazene os certificados que os seus Workloads usam para TLS, dos que você envia aos certificados Let's Encrypt que a Azion solicita e renova. +meta_tags: 'certificate manager, digital certificate, tls, server certificate, trusted ca certificate, lets encrypt, csr, crl, mtls, workloads' +namespace: documentation_products_certificate_manager +permalink: /documentacao/plataforma/certificate-manager/ +--- + +import DocButton from '~/components/webkit/DocButton.vue' +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' + +**Certificate Manager** é um recurso da plataforma que armazena os certificados de Transport Layer Security (TLS) que um [Workload](/pt-br/documentacao/plataforma/workloads/) usa na infraestrutura distribuída da Azion. Um certificado é um documento assinado que prova que um servidor detém um hostname ou lhe permite verificar certificados de cliente no [TLS mútuo (mTLS)](/pt-br/documentacao/plataforma/workloads/mtls/). Use Certificate Manager para servir HTTPS nos seus domínios ou aceitar certificados de cliente da sua autoridade certificadora (CA). + +Certificate Manager guarda certificados que você obtém e certificados que a Azion obtém para você: + +- [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/) permitem trazer um certificado emitido por uma CA, com a chave privada, ou pedir um via solicitação de assinatura de certificado (CSR). Certificate Manager também guarda listas de revogação de certificados (CRLs), para que um Workload recuse certificados de cliente revogados por uma CA. +- [Emissão e renovação](/pt-br/documentacao/plataforma/certificate-manager/emissao-e-renovacao/) permite que a Azion solicite ao Let's Encrypt um certificado de servidor para os domínios de um Workload e o renove antes do vencimento. Todo nome no certificado precisa pertencer a um domínio que a sua conta tem permissão para usar. + + + + +## Caminho da requisição + +Armazenar um certificado no Certificate Manager não protege nenhum hostname: um Workload usa um certificado somente depois que esse certificado é vinculado a esse Workload. Certificate Manager então age durante o handshake TLS. + +Este diagrama acompanha um handshake, do hello do cliente até a requisição que continua, com os certificados que Certificate Manager fornece. As setas contínuas levam o handshake e a requisição, e as setas pontilhadas levam o que volta ao cliente. A seta grossa leva os certificados que você vinculou antes da requisição. Cada rótulo começa com o número do passo a que pertence. + +```mermaid +%%{init: {"layout": "elk", "elk": {"cycleBreakingStrategy": "MODEL_ORDER"}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% +flowchart TD + Client(["Cliente"]) + WL["Workload"] + CM["Certificate Manager"] + FW["Firewall"] + App["Application"] + Client -->|"1, 4. TLS hello, depois o certificado de cliente"| WL + CM ==>|"2, 4. certificado de servidor vinculado, CA confiável"| WL + WL -.->|"2. certificado de servidor"| Client + WL -.->|"5. enforce, ausente ou não confiável: o handshake termina"| Client + WL -->|"3, 5. com Firewall"| FW + WL -->|"3, 5. sem Firewall"| App + FW -->|"3, 5. permitida"| App + FW -.->|"5. recusada por uma regra"| Client +``` + +1. O cliente abre uma conexão TLS com um dos hostnames do Workload e nomeia esse hostname por Server Name Indication (SNI). +2. O Workload apresenta o certificado de servidor dele. Para o [workload domain](/pt-br/documentacao/plataforma/workloads/como-funciona/#workload-domain-e-dominios-personalizados), ou com `tls.certificate` definido como `null`, esse é o certificado SAN da Azion. Para um domínio personalizado com um certificado de servidor vinculado, é esse certificado. +3. Com o mTLS desativado, o handshake se completa, e a requisição continua até a [Application](/pt-br/documentacao/plataforma/applications/), pelo [Firewall](/pt-br/documentacao/plataforma/firewall/) quando o deployment define um Firewall. +4. Com o mTLS ativado, o Workload solicita um certificado de cliente e o verifica contra o certificado de CA confiável em `mtls.config.certificate`. +5. No modo `enforce`, um cliente sem certificado, ou com um certificado que outra autoridade assinou, não consegue completar o handshake. No modo `permissive`, o handshake se completa. Quando o deployment define um Firewall, uma regra que testa a variável Client Certificate Validation pode recusar a requisição. + +--- + +## Próximos passos + + + + + + + + + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/connectors/solucao-de-problemas.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/connectors/solucao-de-problemas.mdx index 20fab1d311..7e15052c7b 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/connectors/solucao-de-problemas.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/connectors/solucao-de-problemas.mdx @@ -77,7 +77,7 @@ Um cliente recebe `421 Misdirected Request` para uma requisição HTTPS a um wor A requisição chegou em uma conexão TLS estabelecida para um hostname diferente do seu header `Host`, e o certificado do workload não cobre esse host. Os clientes causam isso quando reutilizam uma conexão para vários hostnames, por meio de connection pooling ou de multiplexação HTTP/2, ou quando enviam um header `Host` fora do certificado. - **Encontre o hostname**: em [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/), filtre as requisições pelo status code `421` e compare os campos `host` e `ssl_server_name` de cada evento. -- **Cubra cada hostname no certificado**: liste-o no Common Name (CN) ou nos Subject Alternative Names (SAN) do certificado em [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/), com um wildcard como `*.example.com` ou um certificado multi-SAN. +- **Cubra cada hostname no certificado**: liste-o no Common Name (CN) ou nos Subject Alternative Names (SAN) do certificado em [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/), com um wildcard como `*.example.com` ou um certificado multi-SAN. - **Abra uma conexão por hostname**: altere a lógica de conexão do cliente quando o hostname precisar ficar fora do certificado. As requisições para o hostname então recebem a sua resposta normal. Para as verificações que decidem um `421` na conexão do cliente com o workload, consulte [SNI Check](/pt-br/documentacao/plataforma/connectors/sni-check/). diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/como-funciona.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/como-funciona.mdx new file mode 100644 index 0000000000..275563b679 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/como-funciona.mdx @@ -0,0 +1,78 @@ +--- +title: Como Custom Pages funciona +description: Acompanhe como um conjunto de custom pages substitui a resposta de erro de um Connector pela sua página e quais status codes recebem a página padrão da Azion. +meta_tags: 'custom pages, how it works, error page, error response, status codes, page connector, connector, ttl, custom status code, deployment, workloads' +namespace: documentation_products_custom_pages_how_it_works +permalink: /documentacao/plataforma/custom-pages/como-funciona/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +Quando uma origem não encontra um recurso, ou não responde a tempo, o cliente recebe uma resposta de erro, como `404` ou `504`. Uma custom page substitui essa resposta por um conteúdo que você escolhe. + +[Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um [Connector](/pt-br/documentacao/plataforma/connectors/), uma página por status code de erro. Na API v4, Custom Pages substitui Error Responses, as configurações de página de erro de uma Application na API v3. Para uma Application que ainda roda na API v3, consulte [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/). + +Esta página cobre os mecanismos, e não os campos: todos os campos estão em [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/), e todos os limites estão em [Limites do Custom Pages](/pt-br/documentacao/plataforma/custom-pages/limites/). Para o caminho de uma requisição por Custom Pages, com um diagrama, consulte [Caminho da requisição](/pt-br/documentacao/plataforma/custom-pages/#caminho-da-requisicao). As seções cobrem, nesta ordem, as respostas de erro, as custom pages e os conjuntos de custom pages, o conteúdo da página em um Connector, os status codes que uma página pode substituir, a página de erro padrão da Azion e o deployment. + +--- + +## Respostas de erro + +Uma resposta de erro traz um status code que diz que a requisição falhou: um erro de cliente (4xx) ou um erro de servidor (5xx). Na Azion, a Application envia uma requisição à origem por um Connector, e o Connector responde com um status code. Uma custom page age depois que a Application recebe essa resposta, e o status code decide se uma página se aplica. + +--- + +## Custom pages e conjuntos de custom pages + +Uma custom page substitui a resposta de erro de um status code. Um conjunto de custom pages é a lista nomeada que agrupa essas páginas. Quando o Connector responde com um status code, a Azion procura uma página com esse código no conjunto de custom pages que o deployment do [Workload](/pt-br/documentacao/plataforma/workloads/) define. Cada página age apenas sobre o status code que lista, como `"404"`, então um conjunto contém uma página para cada código que substitui. + +Quando uma página corresponde, o cliente recebe o conteúdo da página no lugar da resposta. A resposta não traz redirecionamento nem header `Location`, então o navegador permanece na URL que pediu. Um conjunto contém pelo menos uma página, como informa [Limites do Custom Pages](/pt-br/documentacao/plataforma/custom-pages/limites/). + +--- + +## Conteúdo da página em um Connector + +Uma página do tipo `page_connector` define um Connector e o caminho do conteúdo da página nesse Connector. A Azion busca o conteúdo no Connector da página, no `uri` da página. O `ttl` da página define o tempo de cache desse conteúdo. Uma página também pode definir `custom_status_code`, o status code que o cliente recebe no lugar do original. + +Por exemplo, a sua origem responde `404` para a página de um produto removido. Uma página para o código `404` serve, então, o documento do `uri` dela, como `/myerrors/404.html`, ainda com o status `404`, e o navegador mostra a sua página. + +Para o tipo e o padrão de cada campo, consulte [Campos da página](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#campos-da-pagina). + +--- + +## Status codes que uma página pode substituir + +Uma página só substitui um dos 22 status codes de uma lista fixa: 16 erros de cliente (4xx) e seis erros de servidor (5xx). Para cada código da lista e o que ele significa quando o Connector o retorna, consulte [Status codes](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#status-codes). + +--- + +## Página de erro padrão da Azion + +Quando o conjunto de custom pages não tem página para um status code, o cliente recebe a resposta do Connector sem alteração. Oito códigos são a exceção: `400`, `401`, `403`, `406`, `500`, `502`, `503` e `504` recebem a página de erro padrão da Azion. Uma página para um desses oito códigos substitui a página de erro padrão da Azion pela sua. + +Por exemplo, um conjunto que contém apenas uma página `404` responde a um `502` do Connector com a página de erro padrão da Azion, e não com a resposta da origem. Um Workload cujo deployment não define um conjunto de custom pages entrega toda resposta sem alteração. + +--- + +## O deployment + +Um [Workload](/pt-br/documentacao/plataforma/workloads/) usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Um Workload guarda no máximo um deployment, então um conjunto de custom pages cobre todos os hostnames do Workload. Para os campos do deployment, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). + +Atribuir um conjunto é uma mudança no deployment do Workload, e essa mudança se propaga. Ela se espalha pela infraestrutura distribuída da Azion, data center por data center, ao longo de vários minutos. Enquanto isso, as requisições podem receber a configuração anterior ou a atualizada, dependendo do data center que responde. Por isso, a Azion não garante quando um conjunto atribuído começa a ser servido, como explica [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). + +Para definir o conjunto de custom pages no deployment, consulte [Personalize uma página de erro](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/personalizar-pagina-resposta-erro/#atribua-o-conjunto-no-deployment-do-workload). + +--- + +## Recursos relacionados + + + + Todos os campos de um conjunto de custom pages e das páginas dele, os 22 status codes que uma página pode substituir e um corpo de requisição para copiar. + Crie um conjunto de custom pages, atribua-o no deployment de um Workload e veja uma página substituir o 404 da sua origem. + Substitua as respostas de erro de vários status codes de uma vez, cada página com o próprio tempo de cache. + Encontre a causa quando um conjunto de custom pages é recusado ou uma página de erro não chega ao cliente. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/custom-pages/custom-pages.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/configuracoes.mdx similarity index 75% rename from apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/custom-pages/custom-pages.mdx rename to apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/configuracoes.mdx index 654f6ea48f..822e454a3d 100644 --- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/custom-pages/custom-pages.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/configuracoes.mdx @@ -3,7 +3,7 @@ title: Configurações de custom page description: Consulte os campos de um conjunto de custom pages, os status codes que ele substitui e como cada página define o Connector, o status e o tempo de cache. meta_tags: 'custom pages, error pages, status codes, connector, ttl, workloads, deployment' namespace: documentation_secure_custom_pages -permalink: /documentacao/plataforma/workloads/custom-pages/configuracoes/ +permalink: /documentacao/plataforma/custom-pages/configuracoes/ --- import FrameBox from '@aziontech/webkit/frame-box' @@ -11,9 +11,9 @@ import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' import VersionRollingOut from '~/includes/snippets/versionRollingOut/pt/snippet.mdx' -[Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/) +[Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/) -[Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um [Connector](/pt-br/documentacao/plataforma/connectors/), uma página por status code de erro. Um conjunto de custom pages é a lista nomeada que agrupa essas páginas. A Azion busca o conteúdo de cada página em um Connector, e cada página define o tempo de cache dela. Uma página também pode responder com outro status code. Um [Workload](/pt-br/documentacao/plataforma/workloads/) usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Para os campos do deployment, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). +[Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um [Connector](/pt-br/documentacao/plataforma/connectors/), uma página por status code de erro. Um conjunto de custom pages é a lista nomeada que agrupa essas páginas. Um [Workload](/pt-br/documentacao/plataforma/workloads/) usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Para os campos do deployment, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). --- @@ -29,7 +29,7 @@ Três interfaces escrevem um conjunto de custom pages, e o deployment de um Work A CLI lê todos os campos do conjunto do arquivo JSON de `--file`. No Azion Console, você atribui um conjunto no campo **Custom Page** da seção **Deployment Settings** do Workload. -Atribuir um conjunto é uma mudança no deployment do Workload, e essa mudança se propaga. Ela se espalha pela infraestrutura distribuída da Azion, data center por data center, ao longo de vários minutos. Enquanto isso, as requisições podem receber a configuração anterior ou a atualizada, dependendo do data center que responde. Por isso, a Azion não garante quando um conjunto atribuído começa a ser servido. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). +Atribuir um conjunto é uma mudança no deployment do Workload, e essa mudança chega aos data centers ao longo de vários minutos, sem tempo garantido. Para mais informações, consulte [Como Custom Pages funciona](/pt-br/documentacao/plataforma/custom-pages/como-funciona/#o-deployment) e [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). Na API v4, **Custom Pages** substitui Error Responses, as configurações de página de erro de uma Application na API v3. Cada campo da v3 tem um equivalente na v4: @@ -40,7 +40,7 @@ Na API v4, **Custom Pages** substitui Error Responses, as configurações de pá | URI | **Page Path (URI)**, `uri` | | Custom Status Code | **Response Custom Status Code**, `custom_status_code` | -Os dois modelos localizam o arquivo da página de formas diferentes. Uma URI da v3 é anexada ao domínio da Application e buscada na origem que o campo **Set Origin** define. Uma `uri` da v4 é buscada no Connector da página. Para uma Application que ainda roda na API v3, consulte [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/). +Os dois modelos localizam o arquivo da página de formas diferentes. Uma URI da v3 é anexada ao domínio da Application e buscada na origem que o campo **Set Origin** define. Uma `uri` da v4 é buscada no Connector da página. Para uma Application que ainda roda na API v3, consulte [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/). --- @@ -80,13 +80,13 @@ Cada entrada de `pages` atribui uma página a um status code. Uma página do tip | **Page Path (URI)** | `page.attributes.uri` | string, ou `null` | 1 a 250 caracteres | nenhum | | **Response Custom Status Code** | `page.attributes.custom_status_code` | integer, ou `null` | 100 a 599 | nenhum | -Uma página age sobre o status code que um Connector retorna à Azion. Quando esse código tem uma página no conjunto, o visitante recebe o conteúdo da página no lugar da resposta, sem redirecionamento. O Azion Console oferece dois tipos de página, _Page Connector_ e _Page Default_. Com _Page Default_, o Console mostra os campos **Content Type** e **Response** no lugar dos campos do Connector, e a API não tem formato documentado para esse tipo. +Uma página age sobre o status code que um Connector retorna à Azion. Quando esse código tem uma página no conjunto, o cliente recebe o conteúdo da página no lugar da resposta, sem redirecionamento. Azion Console oferece dois tipos de página, _Page Connector_ e _Page Default_. Com _Page Default_, o Console mostra os campos **Content Type** e **Response** no lugar dos campos do Connector, e a API não tem formato documentado para esse tipo. `page.attributes.uri` é o caminho a partir do qual o Connector da página entrega o conteúdo. Por exemplo, com o caminho `/myerrors/505.html` e um Connector cujo endereço é `myconnector.azion.com`, a Azion busca e entrega o conteúdo de `myconnector.azion.com/myerrors/505.html`. `page.attributes.ttl` define o tempo de vida (TTL, time to live) da página de erro: o tempo de cache dela, em segundos. Para as configurações de expiração do cache da própria Application, consulte [Cache settings](/pt-br/documentacao/plataforma/applications/cache/cache-settings/#browser-cache). -`page.attributes.custom_status_code` é o status code que o visitante recebe no lugar do original. Por exemplo, uma página com `code` definido como `"403"` e `custom_status_code` definido como `404` responde a um `403` do Connector com um `404`. +`page.attributes.custom_status_code` é o status code que o cliente recebe no lugar do original. Por exemplo, uma página com `code` definido como `"403"` e `custom_status_code` definido como `404` responde a um `403` do Connector com um `404`. --- @@ -132,12 +132,27 @@ Seis dos códigos trazem mais detalhes: ## Corpo da requisição -O corpo JSON abaixo cria um conjunto com uma página. Ele substitui um `404` do Connector pelo documento do caminho `/html` no Connector da página e responde com status `404`. O mesmo corpo funciona para `POST /v4/workspace/custom_pages` e para o arquivo de `azion create custom-pages --file`: +Um corpo de requisição com uma página cria um conjunto que substitui um `404` do Connector. A página serve o documento do caminho `/html` no Connector dela, com status `404`. O mesmo corpo funciona para `POST /v4/workspace/custom_pages` e para o arquivo de `azion create custom-pages --file`: ```json -{"name": "my-custom-pages", "active": true, "pages": [ - {"code": "404", "page": {"type": "page_connector", "attributes": {"connector": , "ttl": 0, "uri": "/html", "custom_status_code": 404}}} -]} +{ + "name": "my-custom-pages", + "active": true, + "pages": [ + { + "code": "404", + "page": { + "type": "page_connector", + "attributes": { + "connector": , + "ttl": 0, + "uri": "/html", + "custom_status_code": 404 + } + } + } + ] +} ``` Envie-o com a CLI, com o corpo salvo como `cp.json`: @@ -163,31 +178,31 @@ ID NAME ACTIVE LAST EDITOR LAST MODIFIED ```json { - "active": true, - "created_at": "2026-01-01T12:00:00.00000Z", - "id": , - "is_versioned": false, - "last_editor": "", - "last_modified": "2026-01-01T12:00:00.000000Z", - "name": "my-custom-pages", - "pages": [ - { - "code": "404", - "page": { - "attributes": { - "connector": , - "custom_status_code": 404, - "ttl": 0, - "uri": "/html" - }, - "type": "page_connector" - } - } - ], - "product_version": "1.0", - "version": null, - "version_id": null, - "version_state": null + "active": true, + "created_at": "2026-01-01T12:00:00.00000Z", + "id": , + "is_versioned": false, + "last_editor": "", + "last_modified": "2026-01-01T12:00:00.000000Z", + "name": "my-custom-pages", + "pages": [ + { + "code": "404", + "page": { + "attributes": { + "connector": , + "custom_status_code": 404, + "ttl": 0, + "uri": "/html" + }, + "type": "page_connector" + } + } + ], + "product_version": "1.0", + "version": null, + "version_id": null, + "version_state": null } ``` @@ -230,9 +245,9 @@ A API recusa um conjunto com a lista `pages` vazia, e o Console se recusa a salv - Crie um conjunto de custom pages, atribua-o no deployment de um Workload e veja uma página substituir um erro. - Cada campo de um Workload e do deployment dele, que define a Application, o Firewall e o conjunto de custom pages. - As configurações de página de erro de uma Application na API v3, para contas que ainda rodam na API v3. - O caminho que uma requisição percorre de um domínio, pelo Workload, até a Application e o Connector. + Como uma página substitui uma resposta de erro, quais códigos recebem a página de erro padrão da Azion e como um conjunto atribuído se propaga. + Substitua as respostas de erro de vários status codes de uma vez, cada página com o próprio tempo de cache. + O escopo de Custom Pages, o número mínimo de páginas de um conjunto e a faixa de cada campo desta página. + A correção para um conjunto recusado sem página e para uma página de erro que não chega ao cliente. diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/error-responses.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/error-responses.mdx new file mode 100644 index 0000000000..fa5703b67e --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/error-responses.mdx @@ -0,0 +1,119 @@ +--- +title: Error Responses +description: >- + Personalize a página de erro que uma Application na API v3 entrega para cada + status code de erro de cliente ou de servidor recebido da origem. +meta_tags: 'erros, application, http, páginas de erro' +namespace: documentation_edge_application_error_responses +permalink: /documentacao/plataforma/custom-pages/error-responses/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' +import VersionDeprecated from '~/includes/snippets/versionDeprecated/pt/snippet.mdx' + +[Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) + +**Error Responses** é uma feature de Applications na API v3: as configurações de página de erro que personalizam a página que um usuário recebe para um status code da origem. Na API v4, [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) substitui Error Responses. + +Quando um usuário solicita conteúdo de uma Application, a Azion envia a requisição para os servidores de origem. A origem responde com um status code HTTP, que indica se a requisição foi concluída. + +Os status codes HTTP são números de três dígitos, agrupados em cinco categorias: + +- Respostas de informação (1xx): o status da conexão ou o progresso antes de a requisição ser concluída. +- Respostas de sucesso (2xx): a origem recebeu, compreendeu, aceitou e processou a requisição. +- Mensagens de redirecionamento (3xx): a requisição precisa de um redirecionamento para ser atendida. +- Respostas de erro do cliente (4xx): a requisição não pôde ser concluída por causa de um aparente erro do lado do cliente. +- Respostas de erro do servidor (5xx): o servidor não consegue processar a requisição. + +Para mais informações sobre status HTTP, consulte as [especificações de status codes HTTP](https://httpwg.org/specs/rfc9110.html#overview.of.status.codes). + +Error Responses personaliza como uma Application trata as respostas de erro de cliente (4xx) e de erro de servidor (5xx). Quando uma requisição chega a uma URL que a origem não encontra, ou o servidor não consegue responder, o usuário é redirecionado para uma página de erro personalizada, cujo conteúdo pode ser armazenado em cache. + +--- + +## Status Code + +O código que a Azion recebe quando se conecta à origem. + +--- + +## Error Caching TTL + +O tempo, em segundos, que a página de erro fica em cache antes de a Azion atualizá-la. Para mais informações sobre as configurações de expiração, consulte [Cache settings](/pt-br/documentacao/plataforma/applications/cache/cache-settings/#browser-cache). + +:::tip[dica] +Uma página de erro costuma ser estática e muda pouco, então a Azion recomenda um tempo de cache alto. Um valor alto melhora a performance da Application e reduz o custo de processamento na origem. +::: + +--- + +## URI + +O caminho do arquivo, geralmente HTML, que contém o conteúdo da página de erro. A Azion anexa esse caminho ao domínio da Application, por exemplo, `/404.html`. + +--- + +## Custom Status Code + +O status code que o usuário recebe no lugar do original. Por exemplo, uma página pode entregar o código `404` em resposta a um erro `403`. + +--- + +## Set Origin + +A origem que contém o arquivo da URI. Você só pode alterá-la depois de informar uma URI, e configura a origem em **Origins**. Para mais informações, consulte [Origins](/pt-br/documentacao/plataforma/connectors/origins/). + +--- + +## Códigos de erro disponíveis + +Error Responses aceita estes status codes de erro de cliente e de erro de servidor: + +| Status code | Descrição | +| --- | --- | +| 400: Bad Request | Um erro na requisição, como parâmetros inválidos ou ausência de parâmetros obrigatórios. | +| 401: Unauthorized | A requisição não tem o header HTTP `Authentication`. | +| 403: Forbidden | O usuário não tem permissão para executar a operação. | +| 404: Not Found | O recurso solicitado não existe. | +| 405: Method Not Allowed | O método solicitado não pode ser aplicado à URL. | +| 406: Not Acceptable | O header `Accept` falta ou pede um formato ou uma versão que a API não suporta. | +| 408: Request Timeout | A requisição chega mais devagar do que o servidor está preparado para esperar, então o servidor quer encerrar a conexão. | +| 409: Conflict | A requisição gera um conflito na execução, como criar um registro que já existe. | +| 410: Gone | O conteúdo solicitado foi excluído do servidor permanentemente, sem endereço de redirecionamento predefinido. | +| 411: Length Required | O servidor rejeitou a requisição porque o header obrigatório `Content-Length` não está definido. | +| 414: URI Too Long | A URI solicitada é maior do que os limites do servidor. | +| 415: Unsupported Media Type | O servidor não suporta o formato de mídia dos dados solicitados, então os rejeita. | +| 416: Request Range Not Satisfiable | O servidor não consegue atender ao valor do header `Range`, provavelmente fora dos dados da URI de destino. | +| 426: Upgrade Required | O servidor recusa a requisição no protocolo atual e a aceita depois que o cliente troca de protocolo. | +| 429: Too Many Requests | A requisição foi rejeitada por um tempo porque excedeu os limites de operação. | +| 431: Request Header Fields Too Large | Os headers da requisição são longos demais, ou a requisição envia cookies demais. | +| 500: Internal Server Error | Uma falha não intencional e não identificada ocorreu durante o processamento da requisição. | +| 501: Not Implemented | O servidor não suporta o método da requisição, e o método não pode ser modificado. | +| 502: Bad Gateway | O servidor, atuando como gateway para obter uma resposta de que a requisição precisa, recebeu uma resposta inválida. | +| 503: Service Unavailable | O servidor não está pronto para tratar a requisição, geralmente porque está sobrecarregado ou em manutenção. | +| 504: Gateway Timeout | O servidor, atuando como gateway, não recebe uma resposta a tempo. | +| 505: HTTP Version Not Supported | O servidor não suporta a versão HTTP usada na requisição. | + +Seis dos códigos trazem mais detalhes: + +- **408**: essa resposta é comum porque alguns navegadores, como Chrome, Firefox 27+ e IE9, usam pré-conexão HTTP para acelerar a navegação. Alguns servidores também encerram a conexão sem enviar essa mensagem. +- **410**: quando esse erro acontece, os caches e os links para o recurso devem ser removidos. A especificação HTTP descreve esse código para "serviços promocionais limitados", e uma API não deve usá-lo para indicar quais recursos foram removidos. +- **426**: o servidor envia um header `Upgrade` na resposta para indicar os protocolos que exige. +- **429**: o cliente deve aguardar até o momento definido no header `X-Ratelimit-Reset` antes de tentar novamente. +- **501**: os únicos métodos que um servidor precisa suportar são `GET` e `HEAD`, então um servidor não retorna esse código para eles. +- **503**: envie, com essa resposta, uma página que explique o problema. O código serve para condições temporárias, e o header `Retry-After` deve trazer o tempo estimado para recuperar o serviço. Tome cuidado com os headers de cache enviados com essa resposta, porque uma condição temporária normalmente não deve ser armazenada em cache. + +--- + +## Recursos relacionados + + + + O modelo da API v4 que substitui Error Responses e o caminho que uma resposta percorre por um conjunto de custom pages. + Todos os campos de Custom Pages e o campo de Error Responses que cada um substitui. + Substitua as respostas de erro de vários status codes de uma vez, cada página com o próprio tempo de cache. + Crie a sua primeira Application, o primeiro passo antes de personalizar as páginas de erro dela. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/glossario.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/glossario.mdx new file mode 100644 index 0000000000..1fdb9ff645 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/glossario.mdx @@ -0,0 +1,15 @@ +--- +title: Glossário +description: Consulte o que Custom Pages, conjunto de custom pages e custom page significam nas páginas que documentam Custom Pages. +meta_tags: 'custom pages, glossary, terms, custom page, custom page set, error pages, status codes' +namespace: documentation_products_custom_pages_glossary +permalink: /documentacao/plataforma/custom-pages/glossario/ +--- + +Definições dos termos que a documentação de **Custom Pages** usa. + +| Termo | Definição | +| --- | --- | +| conjunto de custom pages | A lista nomeada que agrupa custom pages, pelo menos uma por conjunto, servida na API em `/v4/workspace/custom_pages`. Azion Console a chama de custom page, na página **Create Custom Page**. Um [Workload](/pt-br/documentacao/plataforma/workloads/) usa um conjunto de custom pages somente depois que o [deployment](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment) desse Workload define esse conjunto, como mostra [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/custom-pages/primeiros-passos/). | +| custom page | Uma entrada de um conjunto de custom pages: a página que a Azion entrega no lugar de uma resposta com status code 4xx ou 5xx de um [Connector](/pt-br/documentacao/plataforma/connectors/), selecionada pelo status code da página. Com uma página `page_connector`, a Azion busca o documento em `uri` no Connector da página, guarda-o em cache por `ttl` e responde com `custom_status_code`, quando definido, então o cliente é atendido no mesmo endereço, e não redirecionado. [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) documenta todos os campos. | +| Custom Pages | Um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, uma página por status code de erro, por meio do conjunto de custom pages que o deployment de um Workload define. Ele substitui as [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/) de uma [Application](/pt-br/documentacao/plataforma/applications/) na API v3. [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) o descreve. | diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/limites.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/limites.mdx new file mode 100644 index 0000000000..f2f03eb2f0 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/limites.mdx @@ -0,0 +1,49 @@ +--- +title: Limites do Custom Pages +description: Confira o escopo de Custom Pages e os limites de um conjunto de custom pages e das páginas dele, do número mínimo de páginas à faixa de cada campo. +meta_tags: 'custom pages, limits, scope, custom page set, pages, name, ttl, uri, custom status code, error page' +namespace: documentation_products_custom_pages_limits +permalink: /documentacao/plataforma/custom-pages/limites/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +[Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um [Connector](/pt-br/documentacao/plataforma/connectors/), uma página por status code de erro. Um conjunto de custom pages é a lista nomeada que agrupa essas páginas. Esta página informa onde Custom Pages age e os limites que a Azion aplica a um conjunto e a cada página dele. + +--- + +## Escopo + +- **Status codes**: uma página só pode substituir um status code entre os 22 de [Status codes](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#status-codes), 16 erros de cliente (4xx) e seis erros de servidor (5xx). +- **Workloads**: um [Workload](/pt-br/documentacao/plataforma/workloads/) usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Um Workload guarda no máximo um deployment, então um conjunto cobre todos os hostnames do Workload. Para os campos do deployment, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). +- **Tempo**: um conjunto atribuído só é servido depois que a mudança no deployment se propaga, ao longo de vários minutos, e a Azion não garante quando. Repita a requisição até a página responder, como explica [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). +- **API v3**: Custom Pages é o modelo da API v4 para páginas de erro. Uma Application que ainda roda na API v3 define as páginas de erro dela em [Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/), cujos campos correspondem aos campos de Custom Pages em [Interfaces](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#interfaces). + +--- + +## Limites padrão + +Esta tabela informa o número de páginas de um conjunto de custom pages e o que acontece com um conjunto abaixo dele. + +| Escopo | Limite | Ao ultrapassar o limite | +| --- | --- | --- | +| Páginas por conjunto de custom pages | No mínimo 1 | O conjunto é recusado. | + +A API recusa um conjunto vazio com `Ensure this field has at least 1 elements.` Azion CLI imprime essa mensagem dentro de `Error: Failed to create Custom Page: [...]`, e Azion Console mostra `You must have at least one custom page code`. + +Mais quatro limites se aplicam: o `name` de um conjunto aceita de 1 a 255 caracteres, o `ttl` de uma página aceita de 0 a 31.536.000 segundos, o `uri` de uma página aceita de 1 a 250 caracteres e o `custom_status_code` de uma página aceita de 100 a 599. Para os campos a que esses limites se aplicam, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/). + +--- + +## Recursos relacionados + + + + Os campos de um conjunto de custom pages e das páginas dele, com o tipo, o padrão e os valores a que cada limite desta página se aplica. + Como uma página substitui uma resposta de erro e quais status codes recebem a página de erro padrão da Azion. + A correção para um conjunto de custom pages recusado sem página e para uma página de erro que não aparece. + Os campos do deployment que definem a Application, o Firewall e o conjunto de custom pages de um Workload. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/primeiros-passos.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/primeiros-passos.mdx index 9ae35d1a91..fccd379f78 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/primeiros-passos.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/primeiros-passos.mdx @@ -3,7 +3,7 @@ title: Primeiros passos com Custom Pages description: Crie um conjunto de custom pages que substitui o 404 da sua origem por uma página sua, atribua-o no deployment do Workload e veja-a ser servida. meta_tags: 'custom pages, quickstart, error page, 404, connector, deployment, workloads' namespace: documentation_products_custom_pages_quickstart -permalink: /documentacao/plataforma/workloads/custom-pages/primeiros-passos/ +permalink: /documentacao/plataforma/custom-pages/primeiros-passos/ --- import DocCardGroup from '@aziontech/webkit/doc-card-group' import DocCard from '@aziontech/webkit/doc-card' @@ -12,7 +12,7 @@ import DocStep from '@aziontech/webkit/doc-step' import Tabs from '~/components/webkit/Tabs.vue' import Code from '~/components/webkit/CodeBlock.vue' -Este guia orienta você a substituir o `404` que a sua origem retorna pela sua primeira página de [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages). +Este guia orienta você a substituir o `404` que a sua origem retorna pela sua primeira página de [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/). - Crie um conjunto de custom pages com uma página para o status code `404`. - Atribua o conjunto no deployment do seu [Workload](/pt-br/documentacao/plataforma/workloads/). @@ -25,7 +25,9 @@ Quatro elementos participam, e cada um leva ao seguinte: 3. O **deployment** do Workload define o conjunto de custom pages, ao lado da Application que ele já define. 4. A **requisição** chega a um caminho que o Connector que a sua Application usa responde com `404`, e o conjunto de custom pages substitui essa resposta. -Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. A partir daí, quando o Connector que a sua Application usa responde `404`, o visitante recebe o conteúdo da sua página no lugar dessa resposta. A resposta não traz redirecionamento, e o status code dela é o que a página define. Este guia trata do Azion Console e da API, e você atribui o conjunto no Azion Console. A Azion CLI não tem comando que atualiza um deployment, e a referência publicada da API v4 não tem endpoint para um deployment. +Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. A partir daí, quando o Connector que a sua Application usa responde `404`, o cliente recebe o conteúdo da sua página no lugar dessa resposta. A resposta não traz redirecionamento, e o status code dela é o que a página define. + +Este guia trata do Azion Console e da API, e você atribui o conjunto no Azion Console. A Azion CLI não tem comando que atualiza um deployment, e a referência publicada da API v4 não tem endpoint para um deployment. --- @@ -207,7 +209,7 @@ A referência publicada da API v4 da Azion não tem endpoint para o deployment d A verificação é a mesma, qualquer que seja a interface que atribuiu o conjunto. No comando, substitua `` pelo workload domain do seu Workload, no formato `.map.azionedge.net`. Substitua `` pelo caminho que o Connector que a sua Application usa responde com `404`. -Um conjunto atribuído não serve de imediato. A alteração no deployment se espalha pela infraestrutura distribuída da Azion, e isso leva vários minutos, sem duração garantida. Enquanto ela se espalha, uma requisição pode receber o `404` da sua origem ou a sua página. Repita a requisição até a sua página responder. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). +Um conjunto atribuído não serve de imediato. A alteração no deployment se espalha pela infraestrutura distribuída da Azion, e isso leva vários minutos, sem duração garantida. Enquanto ela se espalha, uma requisição pode receber o `404` da sua origem ou a sua página. Repita a requisição até a sua página responder, como explica [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). Envie uma requisição para o caminho ausente e imprima os cabeçalhos da resposta com o corpo: @@ -234,8 +236,8 @@ A resposta não traz o cabeçalho `Location`, então o cliente não é redirecio ## Próximos passos - + - + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/solucao-de-problemas.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/solucao-de-problemas.mdx new file mode 100644 index 0000000000..5729a176c3 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/solucao-de-problemas.mdx @@ -0,0 +1,53 @@ +--- +title: Solucione problemas do Custom Pages +description: Corrija um conjunto de custom pages recusado por não ter página e uma página de erro que não substitui a resposta de erro de um Connector. +meta_tags: 'custom pages, troubleshooting, error page, custom page set, ensure this field has at least 1 elements, deployment, connector, propagation, errors' +namespace: documentation_products_custom_pages_troubleshooting +permalink: /documentacao/plataforma/custom-pages/solucao-de-problemas/ +--- + +import FrameBox from '@aziontech/webkit/frame-box' +import ItemList from '@aziontech/webkit/item-list' +import DocItem from '@aziontech/webkit/doc-item' + +Esta página cobre dois sintomas de [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/): um conjunto de custom pages recusado e uma página de erro que não chega ao cliente. Custom Pages é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, e as páginas ficam em um conjunto de custom pages. Para saber onde Custom Pages age sobre uma requisição, consulte [Caminho da requisição](/pt-br/documentacao/plataforma/custom-pages/#caminho-da-requisicao). Uma recusa citada é a mensagem da API, a menos que a entrada nomeie outra fonte. + +--- + +## Um conjunto de custom pages é recusado com Ensure this field has at least 1 elements + +Criar um conjunto de custom pages falha com `Ensure this field has at least 1 elements.`, ou Azion Console se recusa a salvá-lo com `You must have at least one custom page code`. Azion CLI imprime a mensagem da API dentro de `Error: Failed to create Custom Page: [...]`. + +Um conjunto de custom pages contém pelo menos uma página, e a requisição enviou `"pages": []`, como mostram os erros de [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#erros). No Azion Console, a tabela **Page Codes** não tinha nenhuma linha. + +- **Adicione uma página a `pages`**: uma página substitui um status code de erro por um conteúdo de um Connector, como mostra o corpo em [Corpo da requisição](/pt-br/documentacao/plataforma/custom-pages/configuracoes/#corpo-da-requisicao). +- **Adicione um código de página no Azion Console**: a tabela **Page Codes** precisa de uma linha antes que você salve o conjunto. + +Azion CLI então imprime `Created Custom Page with ID `. + +--- + +## Uma página de erro não aparece + +A resposta de erro do Connector chega ao cliente sem alteração, mesmo com uma página para o status code dela no conjunto de custom pages. + +Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Uma página também age apenas sobre o status code que lista, e uma mudança no deployment leva vários minutos para se propagar. + +- **Defina o conjunto de custom pages no deployment**: no Azion Console, selecione-o no campo **Custom Page** de **Deployment Settings**, ou passe `--custom-page` para `azion create workload-deployment` ao criar o deployment. A Azion CLI não tem comando que atualiza um deployment. Para os passos, consulte [Personalize uma página de erro](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/personalizar-pagina-resposta-erro/#atribua-o-conjunto-no-deployment-do-workload). +- **Verifique o status code que o Connector retorna**: compare-o com o `code` de cada página do conjunto, como `"404"`. +- **Espere a mudança se propagar**: a Azion não garante uma duração, então repita a requisição até a página responder. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). + +O cliente então recebe o conteúdo da página no lugar da resposta, com o `custom_status_code` da página quando definido, e sem header `Location`. + +--- + +## Recursos relacionados + + + + Todos os campos de um conjunto de custom pages e das páginas dele, com as recusas que a API e Azion Console retornam e o que fazer em cada uma. + Como uma página substitui uma resposta de erro depois que o deployment define o conjunto, base da maioria das correções desta página. + Crie um conjunto com uma página para cada código e atribua-o no deployment do Workload, pelo Azion Console, pela CLI ou pela API. + O número mínimo de páginas de um conjunto e a faixa de cada campo de uma página. + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/visao-geral.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/visao-geral.mdx new file mode 100644 index 0000000000..4c729c3e42 --- /dev/null +++ b/apps/docs/src/content/docs/pt-br/pages/secure/custom-pages/visao-geral.mdx @@ -0,0 +1,66 @@ +--- +title: Custom Pages +description: Substitua as respostas de erro da sua origem por páginas suas, uma página por status code, entregues pelo deployment de um Workload. +meta_tags: 'custom pages, custom page set, error pages, status codes, 404, connector, deployment, workloads' +namespace: documentation_products_custom_pages +permalink: /documentacao/plataforma/custom-pages/ +--- + +import DocButton from '~/components/webkit/DocButton.vue' +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' +import VersionRollingOut from '~/includes/snippets/versionRollingOut/pt/snippet.mdx' + +[Error Responses](/pt-br/documentacao/plataforma/custom-pages/error-responses/) + +**Custom Pages** é um recurso da plataforma que substitui a resposta de erro de um [Connector](/pt-br/documentacao/plataforma/connectors/) por uma página sua, na infraestrutura distribuída da Azion. Uma página de erro personalizada é o documento que um site serve no lugar do erro padrão do servidor para um status code, como `404`. Use Custom Pages para exibir sua página para um recurso ausente ou uma origem sem resposta, com tempo de cache e status code próprios. Use também [Configurações de custom page](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) para consultar os campos de um conjunto, das páginas dele e os status codes que uma página substitui. + + + + +## Caminho da requisição + +Criar um conjunto de custom pages não altera respostas: um [Workload](/pt-br/documentacao/plataforma/workloads/) só usa o conjunto depois que o deployment desse Workload define esse conjunto. + +Este diagrama acompanha uma resposta, do status code do Connector até o que o cliente recebe. As setas contínuas levam as requisições, e as setas pontilhadas levam as respostas. Cada rótulo começa com o número do passo a que pertence. + +```mermaid +%%{init: {"layout": "elk", "elk": {"preset": "modelOrder", "keepEntryNodeOnTop": true}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% +flowchart TD + Client(["Cliente"]) + WL["Workload"] + App["Application"] + Conn["Connector"] + Origin[["origem"]] + Set["conjunto de custom pages"] + PConn["Connector da página"] + Client -->|"1. requisição"| WL + WL -->|"1. requisição"| App + App -->|"1. requisição"| Conn + Conn -->|"1. requisição"| Origin + Origin -.->|"1. status code"| Conn + Conn -.->|"2. busca o status code"| Set + Set -.->|"2. sem página: resposta inalterada"| Client + Set -.->|"2. sem página, código listado: página padrão"| Client + Set -->|"3. página encontrada: busca o uri"| PConn + PConn -.->|"3. conteúdo"| Set + Set -.->|"4. página no lugar, sem redirecionamento"| Client +``` + +1. O Workload encaminha a requisição para a [Application](/pt-br/documentacao/plataforma/applications/) que o deployment dele define. A Application envia a requisição à origem por um Connector, e o Connector responde com um status code. +2. A Azion procura uma página com esse status code no conjunto de custom pages que o deployment define. Quando o conjunto não tem página para o status code, o cliente recebe a resposta do Connector sem alteração, exceto nos status codes `400`, `401`, `403`, `406`, `500`, `502`, `503` e `504`, que recebem a página de erro padrão da Azion. +3. Quando uma página corresponde, a Azion busca o conteúdo dela no Connector da página, no `uri` da página. O `ttl` da página define o tempo de cache dela. +4. O cliente recebe esse conteúdo no lugar da resposta, sem redirecionamento e sem header `Location`. O status é o `custom_status_code` da página, quando definido. + +--- + +## Próximos passos + + + + + + + + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/firewall/como-funciona.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/firewall/como-funciona.mdx index 0cb4f2e44d..eb6d49d6d6 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/firewall/como-funciona.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/firewall/como-funciona.mdx @@ -60,7 +60,7 @@ Um firewall executa as suas regras em sequência até que uma delas bloqueie ou A ordem, portanto, muda resultados que as regras sozinhas não mostram. Por exemplo, uma regra que aplica um rate limit a um caminho de login nunca conta as requisições que uma regra anterior nega, porque essas requisições nunca chegam a ela. -A ordem das regras também define a ordem em que as proteções do firewall agem sobre uma requisição. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) age primeiro: avalia se cada requisição traz um ataque DoS ou DDoS e a bloqueia ou a permite antes que qualquer regra seja executada. WAF, Network Shield, Bot Manager e as funções não têm uma ordem fixa própria, porque cada um age apenas por meio de uma regra. Network Shield age pelo critério _Network_ de uma regra, WAF por _Set WAF_, e Bot Manager e as demais funções por _Run Function_. Eles agem, portanto, na ordem das regras que os chamam, e nenhum deles age sobre uma requisição que uma regra anterior interrompeu. Dentro de uma regra, _Set WAF_ e _Run Function_ são executados na ordem em que a regra os organiza. +A ordem das regras também define a ordem em que as proteções do firewall agem sobre uma requisição. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) age primeiro: avalia se cada requisição traz um ataque DoS ou DDoS e a bloqueia ou a permite antes que qualquer regra seja executada. WAF, Network Shield, Bot Manager e as funções não têm uma ordem fixa própria, porque cada um age apenas por meio de uma regra. Network Shield age pelo critério _Network_ de uma regra, WAF por _Set WAF_, e Bot Manager e as demais funções por _Run Function_. Eles agem, portanto, na ordem das regras que os chamam, e nenhum deles age sobre uma requisição que uma regra anterior interrompeu. Dentro de uma regra, _Set WAF_ e _Run Function_ são executados na ordem em que a regra os organiza. Uma regra pertence ao firewall em que foi criada, e a API a mantém em `/v4/workspace/firewalls//request_rules` desse firewall. Uma regra, portanto, não pode ser compartilhada com outro firewall. Para começar um firewall a partir das regras de outro, clone-o: a lista **Firewalls** no Azion Console oferece **Clone** em cada linha. A API descreve um clone como uma cópia profunda do firewall, incluindo as instâncias de função e as regras do Rules Engine dele. @@ -127,7 +127,7 @@ Um firewall novo começa com três deles ativados. Um firewall criado pela API a A página **Create Firewall** no Azion Console começa com os mesmos interruptores ativados. Um firewall criado a partir de um drawer do Console, e não dessa página, começa com **Functions** desativado, então verifique esse interruptor antes de contar com _Run Function_. -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) está sempre ativado. O seu interruptor carrega a tag **Automatically enabled in all accounts** e não pode ser desativado, e a API trata `ddos_protection` como somente leitura. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) está sempre ativado. O seu interruptor carrega a tag **Automatically enabled in all accounts** e não pode ser desativado, e a API trata `ddos_protection` como somente leitura. Cada um dos outros três controla o que uma regra pode usar. Uma opção controlada continua visível no formulário do Rules Engine enquanto o seu produto está desativado, desabilitada e com um rótulo que nomeia o produto de que precisa: diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/firewall/glossario.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/firewall/glossario.mdx index d6bd50e7de..b584dbd2e7 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/firewall/glossario.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/firewall/glossario.mdx @@ -32,7 +32,7 @@ permalink: /documentacao/plataforma/firewall/glossario/ | critério Network | O critério do [Rules Engine para Firewall](/pt-br/documentacao/plataforma/firewall/rules-engine/#criterios) que compara o endereço IP do cliente de uma requisição com uma network list: _Network_ no Azion Console e `${network}` na API. É o único critério que Network Shield acrescenta, então, enquanto Network Shield está desativado, Azion Console mostra _Network - required Network Shield_ e a API responde `25047 Missing Required Modules`. O argumento dele é o ID da lista como um inteiro JSON, e uma string falha com `25042 Invalid Operator Argument Type`. | | Custom Allowed Rules | Um nome descontinuado das exceções de WAF, que não aparece em nenhuma interface da Azion. A aba do Azion Console diz **Allowed Rules**, e a API e a CLI chamam o objeto de exceção. | | data de expiração | A data em que um item de uma lista `ip_cidr` expira, anotada no próprio item: `--LT` e uma data e hora em UTC no formato `YYYY-MM-DDTHH:MM:SSZ`, como em `192.0.2.2 --LT2030-01-01T00:00:00Z`. A Azion só a verifica quando você grava os itens da lista, então um item com data passada é descartado nesse momento, e um item cuja data passa depois continua correspondendo até que você grave os itens de novo. A ajuda do Console a chama de expiration date, e [Network Lists](/pt-br/documentacao/plataforma/firewall/network-shield/network-lists/#anotacoes-de-item) documenta a sintaxe dela. | -| DDoS Protection | A mitigação de ataques de negação de serviço distribuída (DDoS) que todo firewall executa, mostrada na seção **Modules** como **DDoS Protection Unmetered** e marcada com **Automatically enabled in all accounts**. O switch dela não pode ser desativado, e a API informa `modules.ddos_protection.enabled` como `true`. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) a documenta. | +| DDoS Protection | A mitigação de ataques de negação de serviço distribuída (DDoS) que todo firewall executa, mostrada na seção **Modules** como **DDoS Protection Unmetered** e marcada com **Automatically enabled in all accounts**. O switch dela não pode ser desativado, e a API informa `modules.ddos_protection.enabled` como `true`. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) a documenta. | | Debug Rules | A seção de **Main Settings** que registra em log as regras do Rules Engine que cada requisição executou, `debug` na API e desativada quando você cria um firewall. Com o switch **Active** ativado, as regras executadas aparecem no campo `$traceback` em [Data Stream](/pt-br/documentacao/plataforma/data-stream/) e em [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/), e no campo `stacktrace` da [API GraphQL do Real-Time Events](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-events/). [Depure regras criadas com Rules Engine](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/debug-regras/) mostra como lê-las. | | does not match | O rótulo, no Azion Console, do operador de comparação que é verdadeiro quando um valor não corresponde a uma expressão regular ou, no critério Network, quando o endereço IP do cliente não tem correspondência na network list, caso em que ele envia `is_not_in_list`. Com o comportamento `deny` no critério Network, ele transforma a lista em uma allowlist. [Rules Engine para Firewall](/pt-br/documentacao/plataforma/firewall/rules-engine/#operadores) lista os operadores que cada variável aceita. | | exceção | Uma entrada em um rule set que isenta parte de uma requisição de uma regra interna do WAF, ou de todas elas, para que um falso positivo deixe de ser bloqueado. Azion Console a chama de allowed rule, e a API e a CLI a chamam de exceção. [Exceções](/pt-br/documentacao/plataforma/firewall/waf/custom-allowed-rules/#campos) documenta o ID da regra, as condições e o operador que ela carrega. | diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/boas-praticas.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/boas-praticas.mdx index 6778cd55cb..5f5d67f910 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/boas-praticas.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/boas-praticas.mdx @@ -1,7 +1,7 @@ --- title: Boas práticas de Workloads -description: Teste mudanças em um Workload de staging, feche o endereço padrão que a Azion gera quando o seu domínio servir tráfego e troque certificados sem interrupção. -meta_tags: 'workloads, best practices, staging, workload domain, mtls, sni, certificate manager, certificate replacement, lets encrypt' +description: Teste mudanças em um Workload de staging, feche o endereço padrão que a Azion gera quando o seu domínio servir tráfego e mantenha o mTLS estrito na produção. +meta_tags: 'workloads, best practices, staging, workload domain, mtls, permissive, enforce, sni' namespace: documentation_products_workloads_best_practices permalink: /documentacao/plataforma/workloads/boas-praticas/ --- @@ -10,19 +10,21 @@ import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' import Code from '~/components/webkit/CodeBlock.vue' -O ponto de entrada de um site decide quem pode alcançá-lo e se uma conexão é confiável. Erros nesse ponto raramente aparecem como um erro no seu código. Uma mudança testada no tráfego real alcança todos os visitantes de uma vez. Um endereço que você esqueceu fica aberto a qualquer pessoa que o encontre. Um certificado que expira deixa de proteger o tráfego no dia em que vence. +O ponto de entrada de um site decide quem pode alcançá-lo e se uma conexão é confiável. Erros nesse ponto raramente aparecem como um erro no seu código: uma mudança testada no tráfego real alcança todos os visitantes de uma vez, e um endereço que você esqueceu fica aberto a qualquer pessoa que o encontre. -Estas práticas se aplicam a um [Workload](/pt-br/documentacao/plataforma/workloads/), aos hostnames e às configurações de Transport Layer Security (TLS) que ele guarda e aos certificados que ele usa. Os mecanismos por trás delas estão em [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/), e cada campo está em [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/). +Estas práticas se aplicam a um [Workload](/pt-br/documentacao/plataforma/workloads/) e aos hostnames e às configurações de Transport Layer Security (TLS) que ele guarda. As práticas para os certificados que um Workload usa estão em [Boas práticas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/boas-praticas/). Os mecanismos por trás dessas práticas estão em [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/), e cada campo está em [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/). Uma mudança em um Workload leva vários minutos para alcançar toda a infraestrutura distribuída da Azion, sem duração garantida. Nesse meio-tempo, as requisições podem receber a configuração antiga ou a nova, como descreve [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). Cada verificação desta página só vale quando requisições repetidas concordam. -As quatro primeiras práticas se aplicam a todo Workload: testar uma mudança em um Workload de staging antes da produção, fechar o workload domain quando o seu domínio servir tráfego, usar o TLS mútuo (mTLS) permissive apenas para testes e garantir que toda aplicação cliente envie Server Name Indication (SNI). As práticas para os certificados que um Workload usa vêm em seguida, em Certificate Manager. +As práticas, em ordem: testar uma mudança em um Workload de staging antes da produção, fechar o workload domain quando o seu domínio servir tráfego, usar o TLS mútuo (mTLS) permissive apenas para testes e garantir que toda aplicação cliente envie Server Name Indication (SNI). --- ## Teste uma mudança em um Workload de staging antes da produção -Um Workload de staging é um Workload criado na infraestrutura de staging, com `infrastructure` definido como `2` na API. Ele roda na rede de staging, separado da rede de produção, então um erro ali não alcança nenhum visitante do seu site. Ele responde apenas no workload domain dele, `.preview.azionedge.net`, porque um Workload de staging não aceita domínio personalizado. O custo é um segundo Workload com o próprio deployment, que você mesmo mantém em sincronia com a produção. A infraestrutura é fixada na criação, então uma configuração testada chega à produção como um novo Workload, não como uma edição do Workload de staging. Para a mesma escolha no Azion Console, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura). +Um Workload de staging é um Workload criado na infraestrutura de staging, com `infrastructure` definido como `2` na API. Ele roda na rede de staging, separado da rede de produção, então um erro ali não alcança nenhum visitante do seu site. Ele responde apenas no workload domain dele, `.preview.azionedge.net`, porque um Workload de staging não aceita domínio personalizado. + +O custo é um segundo Workload com o próprio deployment, que você mesmo mantém em sincronia com a produção. A infraestrutura é fixada na criação, então uma configuração testada chega à produção como um novo Workload, não como uma edição do Workload de staging. Para a mesma escolha no Azion Console, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura). Este arquivo, enviado com `azion create workload --file`, cria um Workload de staging por meio de `"infrastructure": 2`. Os outros valores são os padrões de um Workload de produção. Copie os valores do seu próprio Workload de produção, para que o staging teste a mesma configuração. @@ -61,7 +63,9 @@ A CLI responde `Updated Workload with ID `. Depois que a mudança s ## Use mTLS permissive apenas para testes -TLS mútuo ([mTLS](/pt-br/documentacao/plataforma/workloads/mtls/)) é um handshake TLS no qual o cliente também apresenta um certificado. Depois, o Workload verifica se uma autoridade certificadora (CA) em que você confia assinou esse certificado. No modo `enforce`, um cliente sem esse certificado falha no handshake. No modo `permissive`, o handshake se completa, então uma regra de Firewall que testa a variável Client Certificate Validation precisa recusar o cliente. Sem essa regra, um Workload permissive admite os clientes que o mTLS deveria recusar. +TLS mútuo ([mTLS](/pt-br/documentacao/plataforma/workloads/mtls/)) é um handshake TLS no qual o cliente também apresenta um certificado. Depois, o Workload verifica se uma autoridade certificadora (CA) em que você confia assinou esse certificado. + +No modo `enforce`, um cliente sem esse certificado falha no handshake. No modo `permissive`, o handshake se completa, então uma regra de Firewall que testa a variável Client Certificate Validation precisa recusar o cliente. Sem essa regra, um Workload permissive admite os clientes que o mTLS deveria recusar. Use `permissive` para testar o acesso em condições específicas e sirva a produção com `enforce`, como neste corpo para `azion update workload --file`: @@ -83,57 +87,11 @@ Para a regra de Firewall de que um Workload permissive precisa, consulte [Modos ## Garanta que toda aplicação cliente envie SNI -Server Name Indication (SNI) é a extensão de TLS na qual um cliente nomeia o host que deseja durante o handshake. Todo domínio servido com um certificado vinculado ao Workload, enviado ou do Let's Encrypt, depende dela. Uma conexão sem SNI alcança a configuração padrão da Azion, que apresenta o certificado SAN da Azion em vez do seu. Esse é o certificado da própria Azion, com hostnames da Azion listados como Subject Alternative Names (SAN), como `*.map.azionedge.net` e `*.azion.app`. Em um Workload com mTLS no modo `enforce`, a Azion fecha essa conexão antes que ela chegue à sua aplicação, e o cliente não recebe resposta. - -A configuração fica em cada cliente, como o cliente de API de um parceiro ou um serviço que chama o seu Workload, então a Azion não pode adicioná-la por eles. Confirme com o responsável por cada aplicação cliente que a biblioteca TLS dela envia, como nome do servidor, o hostname que ela chama. Se um cliente com um certificado válido nunca alcança a sua aplicação, verifique primeiro se ele envia SNI. Para os demais requisitos do mTLS, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#requisitos). - ---- - -## Certificate Manager - -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) é um recurso da plataforma que armazena os certificados que um Workload usa para TLS. Ele armazena os certificados de servidor que os Workloads apresentam aos clientes e os certificados de CA confiável que verificam certificados de cliente no mTLS. Ele também solicita e renova certificados Let's Encrypt. As práticas desta seção são substituir um certificado de servidor antes que ele expire, manter o registro de desafio de um domínio hospedado fora do [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), escolher um certificado validado por domínio a menos que precise de mais, limitar as credenciais de DNS-01 aos registros de desafio e manter certificados wildcard fora de sistemas críticos de produção. - -### Substitua um certificado de servidor antes que ele expire - -Um certificado de servidor que você envia não se renova sozinho e, depois que a data em `validity` passa, ele deixa de proteger o tráfego. Trocar enquanto o certificado antigo ainda é válido deixa tempo para confirmar que o novo funciona e para voltar ao antigo se ele não funcionar. A entrada antiga permanece em Certificate Manager depois da troca, então o custo é mais um certificado para excluir. A Azion renova os certificados Let's Encrypt que gerencia, como descreve [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). - -Envie o novo certificado e, depois, aponte `tls.certificate` para o ID dele com `azion update workload --file`. Mantenha `ciphers` e `minimum_version` nos valores que o Workload já tem, para que o certificado seja o único valor que muda: - -, - "tls": { "certificate": , "ciphers": 7, "minimum_version": "tls_1_3" } -}`} /> - -A CLI responde `Updated Workload with ID `. Em seguida, `azion list digital-certificate --details` mostra o novo certificado como `active` e o antigo como `inactive` quando nenhum Workload o usa mais. Quando o novo certificado estiver `active` e a mudança tiver se propagado, exclua a entrada antiga. Para o envio em si, consulte [Envie um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/). - -### Mantenha o registro de desafio de um domínio hospedado fora do Edge DNS - -A Azion renova um certificado Let's Encrypt gerenciado antes que ele expire, executando o desafio dele novamente. Quando a zona do domínio de um certificado DNS-01 está no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), a própria Azion escreve o registro `_acme-challenge`. Quando a zona está hospedada em outro provedor de DNS, você adiciona um registro canonical name (CNAME), `_acme-challenge.`, que aponta para `.letsencrypt.azion.com`. Excluir esse CNAME depois faz a próxima renovação falhar, e o certificado então expira. - -Mantenha o CNAME no seu provedor enquanto um Workload usar o certificado. A renovação começa 30 dias antes do fim da validade de 90 dias. Para verificar, confirme antes disso que o CNAME ainda existe e que o status do certificado em Certificate Manager não é `failed`. Para o registro a criar, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). - -### Escolha um certificado validado por domínio, a menos que precise de mais - -A autoridade certificadora que emite um certificado que você envia valida a solicitação em um de três níveis. Domain Validation (DV) confirma o seu direito de usar o domínio. Organization Validation (OV) acrescenta verificações sobre a organização solicitante, e Extended Validation (EV) pede documentos que comprovem a existência física, jurídica e operacional dela. +Server Name Indication (SNI) é a extensão de TLS na qual um cliente nomeia o host que deseja durante o handshake. Todo domínio servido com um certificado vinculado ao Workload, enviado ou do Let's Encrypt, depende dela. Uma conexão sem SNI alcança a configuração padrão da Azion, que apresenta o [certificado SAN da Azion](/pt-br/documentacao/plataforma/certificate-manager/glossario/) em vez do seu. Esse é o certificado da própria Azion, com hostnames da Azion listados como Subject Alternative Names (SAN), como `*.map.azionedge.net` e `*.azion.app`. -Use DV na maioria dos casos. OV e EV são mais complexos de obter, e as verificações extras dão garantias sobre a sua organização, não sobre o domínio. Peça OV ou EV somente quando um requisito que você consiga nomear exigir essas verificações. Para os três níveis, consulte [Níveis de validação](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#niveis-de-validacao). +Em um Workload com mTLS no modo `enforce`, a Azion fecha essa conexão antes que ela chegue à sua aplicação, e o cliente não recebe resposta. -### Limite as credenciais de DNS-01 aos registros de desafio - -Esta prática vale quando você mesmo obtém um certificado, com um cliente Automatic Certificate Management Environment (ACME) como o Certbot, para uma zona hospedada fora do Edge DNS. Um certificado Let's Encrypt que a Azion gerencia não precisa dela: basta o CNAME de [Mantenha o registro de desafio de um domínio hospedado fora do Edge DNS](#mantenha-o-registro-de-desafio-de-um-dominio-hospedado-fora-do-edge-dns). O seu cliente escreve o registro `_acme-challenge` no provedor de DNS, então guarda as credenciais de API do provedor. Credenciais que alcançam todos os registros dão a quem as obtiver o controle do domínio e de todos os registros dele. - -Restrinja essas credenciais a registros `_acme-challenge`, para que um vazamento exponha apenas o desafio. O custo é uma credencial separada para criar e manter só para esse cliente. Para verificar, confirme no seu provedor que as permissões da credencial nomeiam apenas registros `_acme-challenge`. - -### Mantenha certificados wildcard fora de sistemas críticos de produção - -Um certificado wildcard, como um para `*.example.com`, cobre os subdomínios de `example.com`, como `blog.example.com`, com uma única chave privada. Se essa chave vazar, ou se o certificado for revogado, todos os subdomínios que ele cobre são afetados de uma vez. Um certificado wildcard é adequado quando: - -- A gestão centralizada é uma prioridade. -- A mesma equipe gerencia os subdomínios. -- Existe uma arquitetura de proxy reverso bem definida. -- As suas políticas de segurança permitem o compartilhamento controlado de chaves. - -Sob requisitos mais rígidos, dê a cada sistema crítico de produção o seu próprio certificado, mantenha certificados separados para ambientes de desenvolvimento e deixe o wildcard para serviços de menor criticidade. O custo é uma substituição por certificado em vez de uma para todos. Mantenha a chave privada de um wildcard em Certificate Manager, vinculada a Workloads, em vez de espalhada por servidores: depois de salva, a chave não pode ser lida de volta pelo Azion Console nem pela API. Para verificar, liste os Workloads que usam cada certificado wildcard com `GET /v4/workspace/workloads?digital_certificate_id=` e dê a qualquer Workload crítico de produção um certificado próprio. +A configuração fica em cada cliente, como o cliente de API de um parceiro ou um serviço que chama o seu Workload, então a Azion não pode adicioná-la por eles. Confirme com o responsável por cada aplicação cliente que a biblioteca TLS dela envia, como nome do servidor, o hostname que ela chama. Se um cliente com um certificado válido nunca alcança a sua aplicação, verifique primeiro se ele envia SNI. Para os demais requisitos do mTLS, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#requisitos). --- @@ -142,7 +100,7 @@ Sob requisitos mais rígidos, dê a cada sistema crítico de produção o seu pr Cada campo que estas práticas alteram, da infraestrutura e dos domínios ao TLS e ao mTLS, com o seu tipo e valor padrão. - Os tipos, os status e os níveis de validação de certificado por trás das práticas de Certificate Manager. + Substitua um certificado de servidor antes que ele expire, mantenha cada caminho de renovação funcionando e escolha o tipo certo de certificado. O que os modos enforce e permissive fazem com cada cliente e os requisitos que um Workload precisa atender. Sintomas ao longo do caminho da requisição, com as suas causas e correções, para quando uma prática foi ignorada. diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/como-funciona.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/como-funciona.mdx index 93ce37181b..9e634acb88 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/como-funciona.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/como-funciona.mdx @@ -1,7 +1,7 @@ --- title: Como Workloads funciona description: Acompanhe uma requisição do DNS a um Workload, por TLS e mTLS, até a Application, o Firewall e o conjunto de custom pages que o deployment do Workload define. -meta_tags: 'workloads, how it works, workload domain, custom domain, tls, mtls, deployment, infrastructure, staging, certificate manager, custom pages, ddos protection' +meta_tags: 'workloads, how it works, workload domain, custom domain, tls, mtls, deployment, infrastructure, staging, propagation, ddos protection' namespace: documentation_products_workloads_how_it_works permalink: /documentacao/plataforma/workloads/como-funciona/ --- @@ -17,15 +17,19 @@ Antes que um site responda a uma requisição, três coisas acontecem: Só depois disso algum código da aplicação é executado. -Na Azion, esse ponto de entrada é um Workload. [Workloads](/pt-br/documentacao/plataforma/workloads/) é um recurso da plataforma que recebe as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Um Workload guarda os hostnames pelos quais uma requisição pode chegar, as configurações de TLS da conexão e as portas e versões HTTP que aceita. O deployment do Workload define a [Application](/pt-br/documentacao/plataforma/applications/) que responde e, opcionalmente, o [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e o conjunto de custom pages que substitui as respostas de erro. Na API v3, um objeto Domains guardava os hostnames e o certificado, e as Main Settings de uma Application guardavam as configurações de protocolo e de TLS. Na API v4, o Workload e o deployment dele os substituem, e [Migração para API v4](/pt-br/documentacao/fundamentos/api-v4-migration/) mapeia os dois modelos. +Na Azion, esse ponto de entrada é um Workload. [Workloads](/pt-br/documentacao/plataforma/workloads/) é um recurso da plataforma que recebe as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Um Workload guarda os hostnames pelos quais uma requisição pode chegar, as configurações de TLS da conexão e as portas e versões HTTP que aceita. O deployment do Workload define a [Application](/pt-br/documentacao/plataforma/applications/) que responde e, opcionalmente, o [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e o conjunto de custom pages de [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/) que substitui as respostas de erro. -Esta página cobre os mecanismos, não os campos: cada campo está em [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/), e cada limite está em [Limites de Workloads](/pt-br/documentacao/plataforma/workloads/limites/). As seções cobrem, nesta ordem, o caminho que uma requisição percorre, o workload domain e os domínios personalizados, a infraestrutura, TLS e as versões HTTP, o deployment e a propagação. Certificate Manager, Custom Pages e DDoS Protection fecham a página, nessa ordem. +Na API v3, um objeto Domains guardava os hostnames e o certificado, e as Main Settings de uma Application guardavam as configurações de protocolo e de TLS. Na API v4, o Workload e o deployment dele os substituem, e [Migração para API v4](/pt-br/documentacao/fundamentos/api-v4-migration/) mapeia os dois modelos. + +Esta página cobre os mecanismos, não os campos: cada campo está em [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/), e cada limite está em [Limites de Workloads](/pt-br/documentacao/plataforma/workloads/limites/). As seções cobrem, nesta ordem, o caminho que uma requisição percorre, o workload domain e os domínios personalizados, a infraestrutura, TLS e as versões HTTP, o deployment e a propagação. [DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) fecha a página. --- ## O caminho que uma requisição percorre -Uma requisição chega a um Workload pelo hostname que o cliente pede. Esse hostname é o workload domain que a Azion gera ou um hostname dos domínios do Workload. Antes que a Application receba a requisição, o Workload completa o handshake TLS e, com o [TLS mútuo (mTLS)](/pt-br/documentacao/plataforma/workloads/mtls/) ativado, verifica o certificado do cliente. Quando o deployment desse Workload define um Firewall, as regras desse Firewall são executadas em seguida. A Application recebe apenas as requisições que passaram por cada uma dessas verificações. +Uma requisição chega a um Workload pelo hostname que o cliente pede. Esse hostname é o workload domain que a Azion gera ou um hostname dos domínios do Workload. + +Antes que a Application receba a requisição, o Workload completa o handshake TLS e, com o [TLS mútuo (mTLS)](/pt-br/documentacao/plataforma/workloads/mtls/) ativado, verifica o certificado do cliente. Quando o deployment desse Workload define um Firewall, as regras desse Firewall são executadas em seguida. A Application recebe apenas as requisições que passaram por cada uma dessas verificações. Este diagrama acompanha uma requisição, da consulta DNS até a resposta. As setas contínuas levam a requisição, e as setas pontilhadas levam o que volta ao cliente. Cada rótulo começa com o número do passo a que pertence. @@ -81,27 +85,35 @@ Mais dois tipos de hostname entram nos domínios do Workload: um hostname `azion ### O hostname azion.app -O hostname gratuito em `azion.app`, como `my-site.azion.app`, é o que Azion Console chama de **Azion Custom Domain**. Um Workload guarda no máximo um, e um nome que outro Workload já guarda não está disponível. A Azion o serve por HTTPS com o certificado SAN da Azion. Esse certificado é da própria Azion e lista os hostnames que cobre como Subject Alternative Names (SANs). Então, o hostname `azion.app` não precisa de nenhum certificado seu. +O hostname gratuito em `azion.app`, como `my-site.azion.app`, é o que Azion Console chama de **Azion Custom Domain**. Um Workload guarda no máximo um, e um nome que outro Workload já guarda não está disponível. + +A Azion o serve por HTTPS com o [certificado SAN da Azion](/pt-br/documentacao/plataforma/certificate-manager/glossario/), da própria Azion, então o hostname `azion.app` não precisa de nenhum certificado seu. ### Domínios personalizados -Um domínio personalizado é um hostname de um domínio que você já tem, como `www.example.com`. Você lista cada um no Workload e, depois, o aponta para o workload domain com um registro CNAME no seu provedor de DNS. Quando [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) hospeda a zona do domínio, Edge DNS pode ligar o domínio à Azion. No Azion Console, você pode, então, selecionar o domínio dessa zona no campo **Domain** do Workload. A conta precisa ter permissão para todo domínio que o Workload lista, e a API recusa um domínio sem essa permissão. Para essa recusa, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#um-dominio-e-recusado-com-this-account-is-not-allowed-to-use-the-following-cnames). +Um domínio personalizado é um hostname de um domínio que você já tem, como `www.example.com`. Você lista cada um no Workload e, depois, o aponta para o workload domain com um registro CNAME no seu provedor de DNS. Quando [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) hospeda a zona do domínio, Edge DNS pode ligar o domínio à Azion, e o Workload pode, então, receber o domínio dessa zona, como mostra [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios). + +A conta precisa ter permissão para todo domínio que o Workload lista, e a API recusa um domínio sem essa permissão. Para essa recusa, consulte [Solucione problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/#um-dominio-e-recusado-com-this-account-is-not-allowed-to-use-the-following-cnames). :::caution[Atenção] -Um domínio personalizado só serve HTTPS com um certificado de servidor que o cubra. O certificado SAN da Azion cobre o workload domain, que fica em uma zona que a Azion compartilha com outros clientes, e o hostname `azion.app`. Ele não cobre nenhum domínio seu. Para o certificado, consulte [O certificado](/pt-br/documentacao/plataforma/workloads/como-funciona/#o-certificado). +Um domínio personalizado só serve HTTPS com um certificado de servidor que o cubra, porque o certificado SAN da Azion cobre apenas nomes da Azion, como o workload domain, em uma zona que a Azion compartilha com outros clientes. Para o certificado, consulte [O certificado](/pt-br/documentacao/plataforma/workloads/como-funciona/#o-certificado). ::: Por exemplo, um site que roda em `www.example.com` em outro provedor passa para a Azion com três mudanças. Você adiciona `www.example.com` aos domínios do Workload, vincula um certificado de servidor que o cobre e substitui o registro DNS dele por um CNAME para o workload domain. Os visitantes alcançam o Workload assim que os resolvers deles obtêm o novo registro. Para os registros DNS passo a passo, consulte [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion/). ### Acesso ao workload domain -O workload domain continua acessível ao lado dos seus próprios hostnames enquanto `workload_domain_allow_access` é `true`, que é o padrão. Azion Console chama essa configuração de **Workload Domain Allow Access**. Defina-a como `false` quando o Workload precisar responder apenas nos seus próprios hostnames: o workload domain passa a responder `404`, enquanto os seus domínios continuam servindo. Um Workload não pode fechar o seu workload domain sem outro hostname em que responder, então a API recusa essa mudança em um Workload cuja lista de domínios está vazia. Para as regras que a API aplica a cada hostname, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios). +O workload domain continua acessível ao lado dos seus próprios hostnames enquanto `workload_domain_allow_access` é `true`, que é o padrão. Azion Console chama essa configuração de **Workload Domain Allow Access**. + +Defina-a como `false` quando o Workload precisar responder apenas nos seus próprios hostnames: o workload domain passa a responder `404`, enquanto os seus domínios continuam servindo. Um Workload não pode fechar o seu workload domain sem outro hostname em que responder, então a API recusa essa mudança em um Workload cuja lista de domínios está vazia. Para as regras que a API aplica a cada hostname, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios). --- ## Infraestrutura -A infraestrutura de um Workload é a rede que o serve. A rede de produção dá disponibilidade global em toda a infraestrutura distribuída da Azion, e a rede de staging serve para testes, com propagação limitada. Você escolhe a infraestrutura ao criar o Workload, no campo `infrastructure` da API. A escolha também define o sufixo do workload domain: `.map.azionedge.net` em produção e `.preview.azionedge.net` em staging. Para a mesma escolha no Azion Console, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura). +A infraestrutura de um Workload é a rede que o serve. A rede de produção dá disponibilidade global em toda a infraestrutura distribuída da Azion, e a rede de staging serve para testes, com propagação limitada. + +Você escolhe a infraestrutura ao criar o Workload, no campo `infrastructure` da API. A escolha também define o sufixo do workload domain: `.map.azionedge.net` em produção e `.preview.azionedge.net` em staging. Para a mesma escolha no Azion Console, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura). Um Workload de staging não aceita hostname `azion.app` nem domínio personalizado, então você o alcança apenas pelo workload domain dele. As mudanças que você faz nele não afetam um Workload de produção. @@ -113,11 +125,15 @@ A infraestrutura é fixada na criação, e a API recusa uma atualização que a ## TLS e versões HTTP -Transport Layer Security (TLS) é o protocolo que criptografa a conexão entre o cliente e o Workload. No handshake desse protocolo, o Workload apresenta um certificado para o hostname, e o cliente e o Workload combinam uma versão de TLS e uma cifra. As configurações `tls` do Workload guardam esse certificado, a versão mínima de TLS que o Workload aceita e o conjunto de cifras que ele oferece. Essas configurações protegem o trecho do cliente até a Azion. A conexão da Azion até a sua origem é definida no [Connector](/pt-br/documentacao/plataforma/connectors/) que a Application usa. +Transport Layer Security (TLS) é o protocolo que criptografa a conexão entre o cliente e o Workload. No handshake desse protocolo, o Workload apresenta um certificado para o hostname, e o cliente e o Workload combinam uma versão de TLS e uma cifra. As configurações `tls` do Workload guardam esse certificado, a versão mínima de TLS que o Workload aceita e o conjunto de cifras que ele oferece. + +Essas configurações protegem o trecho do cliente até a Azion. A conexão da Azion até a sua origem é definida no [Connector](/pt-br/documentacao/plataforma/connectors/) que a Application usa. ### O certificado -O certificado que o Workload apresenta vem de um de dois lugares. Com [`tls.certificate`](/pt-br/documentacao/plataforma/workloads/#estrutura-do-workload) definido como `null`, o Workload apresenta o certificado SAN da Azion, que cobre o workload domain e o hostname `azion.app`. Para um domínio seu, você vincula um certificado de servidor do [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager), e o Workload apresenta esse certificado para esse domínio. A API não compara os nomes do certificado com os domínios do Workload, então aceita um certificado que não os cobre. Verifique os nomes antes de vincular um certificado. +O certificado que o Workload apresenta vem de um de dois lugares. Com [`tls.certificate`](/pt-br/documentacao/plataforma/workloads/configuracoes/#tls) definido como `null`, o Workload apresenta o certificado SAN da Azion, que cobre o workload domain e o hostname `azion.app`. Para um domínio seu, você vincula um certificado de servidor armazenado no [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), e o Workload apresenta esse certificado para esse domínio. + +A API não compara os nomes do certificado com os domínios do Workload, então aceita um certificado que não os cobre. Verifique os nomes antes de vincular um certificado. Este diagrama acompanha o certificado, do Workload até a verificação do cliente. As setas contínuas levam o handshake do cliente e a escolha do certificado, e as setas pontilhadas levam o certificado de volta. Cada rótulo começa com o número do passo a que pertence. @@ -142,9 +158,13 @@ flowchart TD 3. Para um domínio personalizado, com um certificado de servidor vinculado em `tls.certificate`, o Workload apresenta esse certificado. 4. O cliente verifica se os nomes do certificado cobrem o hostname que pediu. Uma divergência só aparece neste passo, como um handshake que falha. +Para saber como um Workload vincula cada tipo de certificado e o que um certificado não vinculado mostra, consulte [Como Certificate Manager funciona](/pt-br/documentacao/plataforma/certificate-manager/como-funciona/). + ### Versão mínima de TLS e conjunto de cifras -A versão mínima de TLS e o conjunto de cifras decidem quais clientes conseguem completar o handshake. A versão mínima é a mais baixa que o Workload aceita, então uma sessão ainda pode usar uma versão mais nova. O conjunto de cifras é uma lista nomeada de cifras, e o cliente e o Workload negociam uma cifra dela para cada sessão. Uma versão mínima mais alta recusa clientes que suportam apenas versões mais antigas, e uma mais baixa os admite, até o TLS 1.0. O TLS 1.0 e o TLS 1.1 estão descontinuados. Para as cifras que cada conjunto contém, consulte [Conjuntos de cifras](/pt-br/documentacao/plataforma/workloads/configuracoes/#conjuntos-de-cifras). +A versão mínima de TLS e o conjunto de cifras decidem quais clientes conseguem completar o handshake. A versão mínima é a mais baixa que o Workload aceita, então uma sessão ainda pode usar uma versão mais nova. O conjunto de cifras é uma lista nomeada de cifras, e o cliente e o Workload negociam uma cifra dela para cada sessão. + +Uma versão mínima mais alta recusa clientes que suportam apenas versões mais antigas, e uma mais baixa os admite, até o TLS 1.0. O TLS 1.0 e o TLS 1.1 estão descontinuados. Para as cifras que cada conjunto contém, consulte [Conjuntos de cifras](/pt-br/documentacao/plataforma/workloads/configuracoes/#conjuntos-de-cifras). ### Clientes sem SNI @@ -152,15 +172,17 @@ Server Name Indication (SNI) é a extensão de TLS na qual um cliente nomeia o h ### HTTP/3 -O HTTP/3 roda sobre QUIC, e um cliente o alcança por meio de um upgrade. Na primeira requisição, o handshake e a resposta usam TCP com HTTP/1.1 ou HTTP/2. A resposta carrega um header `Alt-Svc` que anuncia o HTTP/3. Um navegador que suporta HTTP/3 envia, então, as requisições seguintes por QUIC, até que a resposta `Alt-Svc` em cache falte ou expire. A API aceita `http3` nas versões HTTP de um Workload apenas junto com `http1` e `http2`. No Azion Console, **HTTP/3 support** também exige que **HTTPS support** esteja ativado. +O HTTP/3 roda sobre QUIC, e um cliente o alcança por meio de um upgrade. Na primeira requisição, o handshake e a resposta usam TCP com HTTP/1.1 ou HTTP/2. A resposta carrega um header `Alt-Svc` que anuncia o HTTP/3. Um navegador que suporta HTTP/3 envia, então, as requisições seguintes por QUIC, até que a resposta `Alt-Svc` em cache falte ou expire. + +A API aceita `http3` nas versões HTTP de um Workload apenas junto com `http1` e `http2`, e o HTTP/3 também exige o HTTPS ativado, como descreve [Protocolos e portas](/pt-br/documentacao/plataforma/workloads/configuracoes/#protocolos-e-portas). --- ## O deployment -Um Workload guarda hostnames e configurações de TLS, mas nenhuma Application. Um deployment é a parte de um Workload que define a Application, que é obrigatória, e, opcionalmente, um Firewall e um conjunto de custom pages. No Azion Console, esses são os campos **Application**, **Firewall** e **Custom Page** de **Deployment Settings**. +Um Workload guarda hostnames e configurações de TLS, mas nenhuma Application. Um deployment é a parte de um Workload que define a Application, que é obrigatória, e, opcionalmente, um Firewall e um conjunto de custom pages de [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/). -Um Workload recebe o Firewall dele somente pelo deployment: o Firewall não tem domínio próprio, e os campos do Workload não definem nenhum Firewall. Até que o deployment de um Workload defina um Firewall, as regras desse Firewall não veem nenhuma requisição a esse Workload. O mesmo vale para um conjunto de custom pages: um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. +Um Workload recebe o Firewall dele somente pelo deployment: o Firewall não tem domínio próprio, e os campos do Workload não definem nenhum Firewall. Até que o deployment de um Workload defina um Firewall, as regras desse Firewall não veem nenhuma requisição a esse Workload. O mesmo vale para um conjunto de custom pages: um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Para as respostas que um conjunto de custom pages substitui, consulte [Como Custom Pages funciona](/pt-br/documentacao/plataforma/custom-pages/como-funciona/). Um Workload guarda no máximo um deployment, e a API recusa um segundo. Então, todo hostname do Workload alcança a mesma Application e, quando o deployment os define, o mesmo Firewall e o mesmo conjunto de custom pages. Mudar qualquer um deles significa editar esse único deployment, e a edição vale para todos os hostnames do Workload. Uma mudança no deployment se propaga como qualquer outra mudança do Workload, como descreve [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). @@ -187,97 +209,13 @@ Para os campos do deployment, consulte [Configurações de Workload](/pt-br/docu ## Propagação -Uma mudança salva em um Workload ou no deployment dele só alcança o tráfego depois de se propagar. A propagação espalha a mudança pela infraestrutura distribuída da Azion, data center por data center, e leva vários minutos. A Azion não garante uma duração para a propagação. +Uma mudança salva em um Workload ou no deployment dele só alcança o tráfego depois de se propagar. A propagação espalha a mudança pela infraestrutura distribuída da Azion, data center por data center, e leva vários minutos. A Azion não garante uma duração: a propagação é de melhor esforço (best-effort). Enquanto uma mudança se espalha, as requisições podem receber a configuração antiga ou a nova, dependendo do data center que responde. Cada data center serve uma configuração ou a outra, e a parcela de data centers na nova cresce até que todos concordem. Por exemplo, logo depois que o mTLS é ativado no modo `enforce`, um cliente sem certificado ainda pode receber `200` de um data center que não tem a mudança. Enquanto isso, um data center que a tem recusa o handshake do mesmo cliente. -Então, uma única requisição logo depois de uma mudança prova pouco. Verifique uma mudança repetindo a requisição até que ela responda como esperado e as respostas concordem. O preço de uma propagação sem duração garantida é que nenhuma mudança é atômica. Projete cada mudança para que a configuração antiga e a nova possam servir lado a lado. Por exemplo, mantenha o workload domain aberto até que os seus próprios hostnames respondam em todos os lugares e, depois, defina `workload_domain_allow_access` como `false`. - ---- - -## Certificate Manager - -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) é um recurso da plataforma que armazena os certificados que um Workload usa para TLS. Um certificado de servidor é um certificado TLS para os seus próprios domínios, que o Workload apresenta para provar que detém um hostname. Você o envia com a chave privada dele, ou a Azion o solicita ao Let's Encrypt e o renova para você. Um certificado de CA confiável é o certificado de uma autoridade certificadora (CA) em que você confia para assinar certificados de cliente. Certificate Manager também armazena listas de revogação de certificados (CRLs) e cria solicitações de assinatura de certificado (CSRs). - -Um Workload usa um certificado apenas depois que você o vincula. Um certificado de servidor vai em [`tls.certificate`](/pt-br/documentacao/plataforma/workloads/#estrutura-do-workload), um certificado de CA confiável vai em `mtls.config.certificate`, e as CRLs vão em `mtls.config.crl`. A API recusa um certificado enviado no campo destinado ao outro tipo. Um certificado enviado fica `inactive` até que você o vincule a um Workload, e `active` a partir de então, então o status mostra se algum Workload o usa. - -### Onde Certificate Manager age sobre uma requisição - -Certificate Manager age durante o handshake TLS, antes que um Firewall ou uma Application veja a requisição. - -Este diagrama acompanha um handshake, do hello do cliente até a requisição que continua, com os certificados que Certificate Manager fornece. As setas contínuas levam o handshake e a requisição, e as setas pontilhadas levam o que volta ao cliente. A seta grossa leva os certificados que você vinculou antes da requisição. Cada rótulo começa com o número do passo a que pertence. - -```mermaid -%%{init: {"layout": "elk", "elk": {"cycleBreakingStrategy": "MODEL_ORDER"}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% -flowchart TD - Client(["Cliente"]) - WL["Workload"] - CM["Certificate Manager"] - FW["Firewall"] - App["Application"] - Client -->|"1, 4. TLS hello, depois o certificado de cliente"| WL - CM ==>|"2, 4. certificado de servidor, CA confiável"| WL - WL -.->|"2. certificado de servidor"| Client - WL -.->|"5. enforce, ausente ou não confiável: o handshake termina"| Client - WL -->|"3, 5. com Firewall"| FW - WL -->|"3, 5. sem Firewall"| App - FW -->|"3, 5. permitida"| App - FW -.->|"5. recusada por uma regra"| Client -``` - -1. O cliente abre uma conexão TLS com um dos hostnames do Workload e nomeia esse hostname por SNI. -2. O Workload apresenta o certificado de servidor dele. Para o workload domain, ou com `tls.certificate` definido como `null`, esse é o certificado SAN da Azion. Para um domínio personalizado com um certificado de servidor vinculado, é esse certificado. -3. Com o mTLS desativado, o handshake se completa, e a requisição continua até a Application, pelo Firewall quando o deployment define um Firewall. -4. Com o mTLS ativado, o Workload solicita um certificado de cliente e o verifica contra o certificado de CA confiável em `mtls.config.certificate`. -5. No modo `enforce`, um cliente sem certificado, ou com um certificado que outra autoridade assinou, não consegue completar o handshake. No modo `permissive`, o handshake se completa. Quando o deployment define um Firewall, uma regra que testa a variável Client Certificate Validation pode recusar a requisição. - -Armazenar os certificados separados do Workload permite substituir um deles sem editar as outras configurações do Workload. O preço é que o certificado e o Workload são verificados separadamente. A API aceita um certificado cujos nomes não cobrem os domínios do Workload, e vincular um certificado é uma mudança do Workload que se propaga ao longo de vários minutos. Para saber como `enforce` e `permissive` tratam cada cliente, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#modos-de-verificacao). - -Para saber como a Azion solicita um certificado Let's Encrypt, conclui o desafio dele e o renova, consulte [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/). - ---- - -## Custom Pages - -Quando uma origem não encontra um recurso, ou não responde a tempo, o cliente recebe uma resposta de erro, como `404` ou `504`. Uma custom page substitui essa resposta por um conteúdo que você escolhe, para um status code de cada vez. - -[Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, uma página por status code de erro. Um conjunto de custom pages é a lista nomeada que agrupa essas páginas. Uma página do tipo `page_connector` define um Connector e o caminho do conteúdo da página nesse Connector. Ela também define um tempo de cache e um status code opcional para a resposta. Uma página só pode substituir um status code de uma lista fixa de status codes de erro de cliente (4xx) e de erro de servidor (5xx). Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. - -### Onde Custom Pages age sobre uma requisição - -Uma custom page age depois que a Application recebe uma resposta da origem. O status code dessa resposta diz se a requisição teve sucesso e decide se uma página se aplica. - -Este diagrama acompanha uma resposta, do status code do Connector até o que o cliente recebe. As setas contínuas levam as requisições, e as setas pontilhadas levam as respostas. Cada rótulo começa com o número do passo a que pertence. - -```mermaid -%%{init: {"layout": "elk", "elk": {"preset": "modelOrder", "keepEntryNodeOnTop": true}, "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 36, "padding": 8, "wrappingWidth": 150, "useMaxWidth": true}, "sequence": {"width": 120, "actorMargin": 30, "useMaxWidth": true}}}%% -flowchart TD - Client(["Cliente"]) - App["Application"] - Conn["Connector"] - Origin[["origem"]] - Set["conjunto de custom pages"] - PConn["Connector da página"] - Client -->|"1. requisição"| App - App -->|"1. requisição"| Conn - Conn -->|"1. requisição"| Origin - Origin -.->|"1. status code"| Conn - Conn -.->|"2. busca o status code"| Set - Set -.->|"2. sem página: resposta inalterada"| Client - Set -.->|"2. sem página, código listado: página padrão"| Client - Set -->|"3. página encontrada: busca o uri"| PConn - PConn -.->|"3. conteúdo"| Set - Set -.->|"4. página no lugar, sem redirecionamento"| Client -``` - -1. A Application envia a requisição à origem por um Connector, e o Connector responde com um status code. -2. A Azion procura uma página com esse status code no conjunto de custom pages que o deployment define. Quando o conjunto não tem página para o status code, o cliente recebe a resposta do Connector sem alteração, exceto nos status codes `400`, `401`, `403`, `406`, `500`, `502`, `503` e `504`, que recebem a página de erro padrão da Azion. Um Workload cujo deployment não define um conjunto de custom pages entrega toda resposta sem alteração. -3. Quando uma página corresponde, a Azion busca o conteúdo dela no Connector da página, no `uri` da página. O `ttl` da página define o tempo de cache dela. -4. O cliente recebe esse conteúdo no lugar da resposta, sem redirecionamento e sem header `Location`. O status é o `custom_status_code` da página, quando definido. - -Por exemplo, a sua origem responde `404` para a página de um produto removido. Uma página para o status code `404` serve, então, o documento do `uri` dela, como `/myerrors/404.html`, ainda com o status `404`. O navegador permanece na URL que pediu e mostra a sua página. +Então, uma única requisição logo depois de uma mudança prova pouco. Verifique uma mudança repetindo a requisição até que ela responda como esperado e as respostas concordem. -Para os campos de um conjunto e das suas páginas, e para os status codes que uma página pode substituir, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/). +O preço de uma propagação sem duração garantida é que nenhuma mudança é atômica. Projete cada mudança para que a configuração antiga e a nova possam servir lado a lado. Por exemplo, mantenha o workload domain aberto até que os seus próprios hostnames respondam em todos os lugares e, depois, defina `workload_domain_allow_access` como `false`. --- @@ -285,7 +223,7 @@ Para os campos de um conjunto e das suas páginas, e para os status codes que um Um ataque de negação de serviço (DoS) inunda um serviço com tráfego até que as requisições legítimas não consigam passar. Ele pode vir de um único endereço IP. Um ataque distribuído de negação de serviço (DDoS) envia esse tráfego de uma botnet de muitas máquinas ao mesmo tempo. Mitigar um ataque significa distinguir o tráfego de ataque do tráfego real antes que qualquer um deles alcance o serviço, e descartar o primeiro. -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) é uma feature da Azion Platform que mitiga esses ataques em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. Ela se aplica quer a sua origem rode on-premise, quer em uma nuvem, e quer a sua rede seja IPv4, IPv6 ou ambos. +[DDoS Protection](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) é uma feature da Azion Platform que mitiga esses ataques em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. Ela se aplica quer a sua origem rode on-premise, quer em uma nuvem, e quer a sua rede seja IPv4, IPv6 ou ambos. ### Onde DDoS Protection age sobre uma requisição diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/configuracoes.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/configuracoes.mdx index d6f3d5e895..cb28a866bb 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/configuracoes.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/configuracoes.mdx @@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -Um [Workload](/pt-br/documentacao/plataforma/workloads/) é a entidade que recebe, como ponto de entrada, as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Um Workload guarda um workload domain que a Azion gera, os domínios que você adiciona, as configurações de Transport Layer Security (TLS) e de TLS mútuo (mTLS), as portas e as versões HTTP que aceita e a infraestrutura em que roda. Depois de receber uma requisição, o Workload a encaminha para a [Application](/pt-br/documentacao/plataforma/applications/) que o deployment desse Workload define. O deployment também pode definir o [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e o [conjunto de custom pages](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/) que substitui as respostas de erro. +Um [Workload](/pt-br/documentacao/plataforma/workloads/) é a entidade que recebe, como ponto de entrada, as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Um Workload guarda um workload domain que a Azion gera, os domínios que você adiciona, as configurações de Transport Layer Security (TLS) e de TLS mútuo (mTLS), as portas e as versões HTTP que aceita e a infraestrutura em que roda. Depois de receber uma requisição, o Workload a encaminha para a [Application](/pt-br/documentacao/plataforma/applications/) que o deployment desse Workload define. O deployment também pode definir o [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e o [conjunto de custom pages](/pt-br/documentacao/plataforma/custom-pages/configuracoes/) que substitui as respostas de erro. Esta página lista cada campo do Workload pelo nome na API, com o controle do Azion Console nas tabelas que o mapeiam. Ela lista cada campo do deployment pelo controle do Azion Console. Para os limites numéricos em um só lugar, consulte [Limites de Workloads](/pt-br/documentacao/plataforma/workloads/limites/). Para o caminho que uma requisição percorre do Workload até a Application, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/). @@ -129,9 +129,9 @@ O Transport Layer Security (TLS) é o protocolo que criptografa a conexão entre | **Minimum TLS version** | `tls.minimum_version` | enum | `tls_1_0` (TLS 1.0, obsoleto), `tls_1_1` (TLS 1.1, obsoleto), `tls_1_2` (TLS 1.2), `tls_1_3` (TLS 1.3) | `tls_1_3` | apenas `--file` | | **Cipher suite** | `tls.ciphers` | integer | `1` a `8`, um por conjunto em Conjuntos de cifras | `7` | apenas `--file` | -O HTTPS precisa de um certificado X.509. Você pode fazer upload do seu próprio certificado no [Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) ou solicitar um certificado Let's Encrypt gerenciado pela Azion, ambos sem custo adicional. No Azion Console, digitar um domínio troca **Digital Certificate** de _Azion (SAN)_ para _New Let's Encrypt Certificate (DNS-01)_. Depois, **Save** solicita esse certificado antes de salvar o Workload. +O HTTPS precisa de um certificado X.509. Você pode fazer upload do seu próprio certificado no [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/certificados/) ou solicitar um certificado Let's Encrypt gerenciado pela Azion, ambos sem custo adicional. No Azion Console, digitar um domínio troca **Digital Certificate** de _Azion (SAN)_ para _New Let's Encrypt Certificate (DNS-01)_. Depois, **Save** solicita esse certificado antes de salvar o Workload. -Com `tls.certificate` definido como `null`, o Workload apresenta o certificado SAN da Azion, que cobre o Azion Custom Domain e o workload domain. Esse certificado é da própria Azion, com os hostnames dele listados como Subject Alternative Names (SAN). Um certificado de outro tipo é recusado. Por exemplo, um certificado de CA confiável, o certificado de uma autoridade certificadora (CA) em que você confia para assinar certificados de cliente, retorna `Invalid certificate type, MUST be an Edge Certificate.` em `tls.certificate`. +Com `tls.certificate` definido como `null`, o Workload apresenta o [certificado SAN da Azion](/pt-br/documentacao/plataforma/certificate-manager/glossario/), que cobre o Azion Custom Domain e o workload domain. Esse certificado é da própria Azion, com os hostnames dele listados como Subject Alternative Names (SAN). Um certificado de outro tipo é recusado. Por exemplo, um [certificado de CA confiável](/pt-br/documentacao/plataforma/certificate-manager/glossario/), o certificado de uma autoridade certificadora (CA) em que você confia para assinar certificados de cliente, retorna `Invalid certificate type, MUST be an Edge Certificate.` em `tls.certificate`. `tls.minimum_version` define um piso, não a versão exata que uma sessão usa. Um Workload com `tls_1_2` ainda pode atender uma sessão em TLS 1.3, dependendo da cifra que o cliente e o Workload negociam a partir do conjunto. A Azion bloqueia a renegociação de TLS por padrão. Para alterar isso, entre em contato com o time de Vendas. @@ -342,7 +342,9 @@ Um deployment é a parte de um Workload que define a Application, que é obrigat | **Firewall** | integer | o ID de um Firewall | | **Custom Page** | integer | o ID de um conjunto de custom pages | -Um deployment não define nada além desses três campos. Na Azion CLI, `azion create workload-deployment` cria o deployment e define a Application dele com `--application-id`, como em `azion create workload-deployment --workload-id --name my-deployment --application-id `. Um deployment sem Firewall mostra _Select a Firewall_ no campo **Firewall** do Azion Console. Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Um Workload que ainda usa um Firewall impede que esse Firewall seja excluído, e excluir o deployment não o libera: exclua o Workload primeiro. +Um deployment não define nada além desses três campos. Na Azion CLI, `azion create workload-deployment` cria o deployment e define a Application dele com `--application-id`, como em `azion create workload-deployment --workload-id --name my-deployment --application-id `. Um deployment sem Firewall mostra _Select a Firewall_ no campo **Firewall** do Azion Console. + +Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Um Workload que ainda usa um Firewall impede que esse Firewall seja excluído, e excluir o deployment não o libera: exclua o Workload primeiro. --- @@ -423,7 +425,43 @@ Created Workload with ID Pela API, `POST /v4/workspace/workloads` responde com HTTP `202` e `state` definido como `pending`. Um Workload de produção criado apenas com `name`, `active`, `infrastructure` e `workload_domain_allow_access` retorna todos os padrões: ```json -{"state":"pending","data":{"id":,"name":"my-workload","active":true,"last_editor":"","last_modified":"2026-01-01T12:00:00.000000Z","created_at":"2026-01-01T12:00:00.000000Z","infrastructure":1,"tls":{"certificate":null,"ciphers":7,"minimum_version":"tls_1_3"},"protocols":{"http":{"versions":["http1","http2","http3"],"http_ports":[80],"https_ports":[443],"quic_ports":[443]}},"mtls":{"enabled":false,"config":{"certificate":null,"crl":null,"verification":null}},"domains":[],"workload_domain_allow_access":true,"workload_domain":".map.azionedge.net","product_version":"1.0"}} +{ + "state": "pending", + "data": { + "id": , + "name": "my-workload", + "active": true, + "last_editor": "", + "last_modified": "2026-01-01T12:00:00.000000Z", + "created_at": "2026-01-01T12:00:00.000000Z", + "infrastructure": 1, + "tls": { + "certificate": null, + "ciphers": 7, + "minimum_version": "tls_1_3" + }, + "protocols": { + "http": { + "versions": ["http1", "http2", "http3"], + "http_ports": [80], + "https_ports": [443], + "quic_ports": [443] + } + }, + "mtls": { + "enabled": false, + "config": { + "certificate": null, + "crl": null, + "verification": null + } + }, + "domains": [], + "workload_domain_allow_access": true, + "workload_domain": ".map.azionedge.net", + "product_version": "1.0" + } +} ``` --- @@ -462,6 +500,6 @@ A API recusa cada requisição abaixo com a mensagem da primeira coluna. Para um Como um Workload verifica certificados de cliente nos modos enforce e permissive, com a CA confiável que usa e as CRLs que lista. Cada limite de um Workload, dos domínios dele e do deployment dele, com o que acontece além de cada um. O caminho que uma requisição percorre de um domínio, pelo Workload, até a Application e o Firewall dele. - Os certificados de servidor e de CA confiável que um Workload aceita, e como fazer upload de um ou solicitá-lo. + Os certificados de servidor e de CA confiável que um Workload aceita, e como fazer upload de um ou solicitá-lo.
diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/glossario.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/glossario.mdx index d21084b235..7d92970996 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/glossario.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/glossario.mdx @@ -1,39 +1,28 @@ --- title: Glossário -description: O que Workload, workload domain, deployment, Azion custom domain, CA confiável, CRL, custom page e os demais termos de Workloads significam. -meta_tags: 'workloads, glossary, terms, workload domain, deployment, certificate manager, custom pages, ddos protection' +description: Consulte o que Workload, workload domain, deployment, Azion custom domain, enforce, permissive e os demais termos de Workloads significam. +meta_tags: 'workloads, glossary, terms, workload domain, deployment, azion custom domain, mtls, ddos protection' namespace: documentation_products_workloads_glossary permalink: /documentacao/plataforma/workloads/glossario/ --- -Os termos deste glossário têm um significado próprio em [Workloads](/pt-br/documentacao/plataforma/workloads/) e no que atua sobre um Workload: [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager), [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) e [DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection). +Definições dos termos que a documentação de **Workloads** usa. | Termo | Definição | | --- | --- | -| Azion custom domain | O hostname `azion.app` gratuito em que um Workload pode responder, definido no Azion Console com o switch **Custom Domain** e o campo **Azion Custom Domain**. O campo recebe um nome como `my-custom-name`, acrescenta `.azion.app` e armazena o hostname completo em `domains`, onde um Workload guarda no máximo um, um nome que outro Workload já guarda é recusado e um Workload de staging não recebe nenhum. Ele não é o workload domain, e [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios) lista todas as regras que ele segue. | -| certificado de CA confiável | O certificado de uma autoridade certificadora que você envia para que um Workload possa verificar certificados de cliente em mTLS, `trusted_ca_certificate` na API e **Trusted CA Certificate** no Azion Console; o envio aceita certificados intermediários. Um Workload o define em `mtls.config.certificate`, e um certificado de servidor nesse campo retorna `Invalid certificate type, MUST be a Trusted CA.` Para enviar um, consulte [Configure mTLS em um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/associar-um-certificado-mtls/). | -| certificado digital | O nome que Azion Console e Azion CLI dão a qualquer certificado no Certificate Manager, do campo **Digital Certificate** de um Workload ao comando `azion create digital-certificate`. O `type` dele é `edge_certificate` para um certificado de servidor ou `trusted_ca_certificate` para um certificado de CA confiável, e um certificado Let's Encrypt é um certificado que a Azion solicita e renova. [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) compara os tipos. | -| certificado Let's Encrypt | Um certificado TLS gratuito assinado pela autoridade certificadora Let's Encrypt, que a Azion solicita e renova para você. A Azion valida o domínio com um desafio HTTP-01 ou DNS-01, e a renovação começa 30 dias antes do fim da validade de 90 dias. [Emissão e renovação](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/) cobre os desafios e a política de novas tentativas. | -| certificado SAN da Azion | O certificado TLS da própria Azion, que lista os hostnames que cobre como Subject Alternative Names (SAN). Um Workload o apresenta no workload domain, e em todo hostname enquanto `tls.certificate` é `null`, e ele cobre o workload domain e o Azion custom domain sem custo adicional. Para apresentar um certificado para o seu próprio domínio, consulte [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). | -| Certificate Manager | Um recurso da plataforma que armazena os certificados que um Workload usa para TLS, servido na API em `/v4/workspace/tls/` e listado no Azion Console na página **Certificate Manager**. Ele guarda certificados de servidor que você envia, certificados Let's Encrypt que a Azion solicita e renova, certificados de CA confiável, listas de revogação de certificados e CSRs. [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) descreve o que ele faz por um Workload, e [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/) vincula um primeiro certificado. | +| Azion custom domain | O hostname `azion.app` gratuito em que um Workload pode responder, que Azion Console rotula como **Azion Custom Domain**. Você escolhe um nome como `my-custom-name`, a Azion acrescenta `.azion.app` e o hostname completo fica armazenado em `domains`, onde um Workload guarda no máximo um, um nome que outro Workload já guarda é recusado e um Workload de staging não recebe nenhum. Ele não é o workload domain, e [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios) lista todas as regras que ele segue. | | conjunto de cifras | Um dos oito conjuntos nomeados de [cifras](https://www.azion.com/pt-br/learning/) que um Workload oferece para TLS, escolhido pelo número em `tls.ciphers`, de `1` (`TLSv1.2_2018`) a `8` (`Legacy_v2017Q1`). O padrão é `7` (`Modern_v2025Q1`), e o cliente e o Workload negociam uma cifra do conjunto para cada sessão. [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#conjuntos-de-cifras) lista as cifras de cada conjunto. | -| conjunto de custom pages | A lista nomeada que agrupa custom pages, pelo menos uma por conjunto, servida na API em `/v4/workspace/custom_pages`. Azion Console a chama de custom page, na página **Create Custom Page**. Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto, no campo **Custom Page** no Azion Console, como mostra [Primeiros passos com Custom Pages](/pt-br/documentacao/plataforma/workloads/custom-pages/primeiros-passos/). | -| custom page | Uma entrada de um conjunto de custom pages: a resposta que a Azion entrega no lugar de um status code 4xx ou 5xx que recebe de um [Connector](/pt-br/documentacao/plataforma/connectors/), selecionada pelo status code da página. Uma página `page_connector` busca o documento em `uri` de um Connector, define o tempo de cache dele em `ttl` e responde com `custom_status_code`, quando definido, então o cliente é atendido no mesmo endereço, e não redirecionado. [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/) documenta todos os campos. | -| Custom Pages | Um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, uma página por status code de erro, por meio do conjunto de custom pages que o deployment de um Workload define. Ele substitui as [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/) de uma aplicação v3. [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) o descreve. | | DDoS Protection | Uma feature da Azion Platform que mitiga ataques de [negação de serviço distribuída (DDoS)](https://www.azion.com/pt-br/learning/) em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. [Mitigação de ataques](/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/) descreve como a plataforma mitiga um ataque. | -| deployment | A parte de um Workload que define a [Application](/pt-br/documentacao/plataforma/applications/) que responde às requisições dele e, opcionalmente, um [Firewall](/pt-br/documentacao/plataforma/firewall/) e um conjunto de custom pages. Um Workload guarda no máximo um deployment, e no Azion Console você o edita na seção **Deployment Settings** do Workload. Um segundo deployment é recusado com `The maximum number of deployments allowed per workload is 1.`, como [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment) documenta. | +| deployment | A parte de um Workload que define a [Application](/pt-br/documentacao/plataforma/applications/) que responde às requisições dele e, opcionalmente, um [Firewall](/pt-br/documentacao/plataforma/firewall/) e um [conjunto de custom pages](/pt-br/documentacao/plataforma/custom-pages/glossario/). Um Workload guarda no máximo um deployment, e um segundo é recusado com `The maximum number of deployments allowed per workload is 1.`, como [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment) documenta. | | Domains | O objeto v3 que guardava os domínios de uma aplicação, o domínio Azion dela e o certificado dela, substituído na API v4 pelo Workload e pelo deployment dele. [Domains](/pt-br/documentacao/plataforma/workloads/domains/) o documenta para contas que executam a API v3, e [Migração para API v4](/pt-br/documentacao/fundamentos/api-v4-migration/) mapeia um modelo no outro. | -| domínio personalizado | Um domínio seu, como `www.example.com`, em que um Workload de produção responde além do workload domain dele. Você o lista em `domains` e o aponta para o workload domain com um registro CNAME no seu provedor de DNS, como mostra [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/). No Azion Console, **Add Domain** na seção **Domains** o adiciona, enquanto o switch **Custom Domain** ativa, em vez disso, o Azion custom domain. | -| enforce | O modo de `mtls.config.verification` em que um Workload recusa o handshake TLS de um cliente que não apresenta certificado, ou que apresenta um que o certificado de CA confiável dele não assinou. Um cliente cujo certificado a CA confiável assinou é atendido. [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) o compara com permissive. | +| domínio personalizado | Um domínio seu, como `www.example.com`, em que um Workload de produção responde além do workload domain dele. Você o lista em `domains` e o aponta para o workload domain com um registro CNAME no seu provedor de DNS, como mostra [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/). | +| enforce | O modo de `mtls.config.verification` em que um Workload recusa o handshake TLS de um cliente que não apresenta certificado, ou que apresenta um que o [certificado de CA confiável](/pt-br/documentacao/plataforma/certificate-manager/glossario/) dele não assinou. Um cliente cujo certificado a CA confiável assinou é atendido. [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) o compara com permissive. | | hostname | Um nome de domínio totalmente qualificado que um cliente requisita, como `www.example.com`. Um Workload responde no workload domain dele e nos hostnames em `domains`, onde toda entrada precisa seguir a RFC 1035, então um wildcard como `*.azion.app` é recusado com `The domain does not conform to the format defined in RFC 1035.` [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios) lista as outras regras. | | infraestrutura | O campo de um Workload que escolhe a rede que o atende: `1`, o padrão, para a rede de produção, para disponibilidade global, ou `2` para a rede de staging, para testes com propagação limitada. Ele define o sufixo do workload domain, `.map.azionedge.net` na produção e `.preview.azionedge.net` no staging, e um Workload de staging não aceita domínio personalizado. O campo é fixado na criação: uma atualização que o altera retorna `The infrastructure cannot be changed after Workload creation.` [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura) compara os dois valores. | -| lista de revogação de certificados (CRL) | Uma lista de certificados de cliente revogados antes da data de expiração, assinada pela autoridade certificadora que os emitiu. Você a envia ao Certificate Manager e a anexa a um Workload em `mtls.config.crl`, no máximo 100 por Workload, ao lado do certificado de CA confiável. [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) documenta os campos dela. | -| mTLS | TLS mútuo, em que o cliente também apresenta um certificado e o Workload o verifica contra um certificado de CA confiável. Um Workload o ativa no objeto `mtls` dele, com um modo de verificação enforce ou permissive e listas de revogação de certificados opcionais. [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) documenta os dois modos, e o [Learning Center](https://www.azion.com/pt-br/learning/) cobre o protocolo genérico. | +| mTLS | TLS mútuo, em que o cliente também apresenta um certificado e o Workload o verifica contra um [certificado de CA confiável](/pt-br/documentacao/plataforma/certificate-manager/glossario/). Um Workload o ativa no objeto `mtls` dele, com um modo de verificação enforce ou permissive e listas de revogação de certificados opcionais. [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) documenta os dois modos, e o [Learning Center](https://www.azion.com/pt-br/learning/) cobre o protocolo genérico. | | origem | O servidor de onde vem o conteúdo de uma requisição. Um Workload não define nenhuma origem: o deployment dele define uma Application, e quando uma regra dessa Application define um [Connector](/pt-br/documentacao/plataforma/connectors/), esse Connector encaminha a requisição à sua origem. | -| permissive | O modo de `mtls.config.verification` em que um Workload conclui o handshake TLS com todo cliente, com ou sem um certificado que o certificado de CA confiável dele assinou. A requisição segue até a Application, pelo Firewall quando o deployment define um Firewall, e uma regra desse Firewall sobre Client Certificate Validation pode recusá-la. [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) o compara com enforce. | -| solicitação de assinatura de certificado (CSR) | Uma solicitação de certificado que você cria no Certificate Manager e envia a uma autoridade certificadora (CA). O **Common Name** (`common_name`) define o domínio que o certificado cobre, e a CSR cria uma entrada de certificado ainda sem certificado. Depois que a CA assina o certificado, você adiciona o certificado codificado em PEM a essa entrada, e [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/) lista todos os campos. | +| permissive | O modo de `mtls.config.verification` em que um Workload conclui o handshake TLS com todo cliente, com ou sem um certificado que o [certificado de CA confiável](/pt-br/documentacao/plataforma/certificate-manager/glossario/) dele assinou. A requisição segue até a Application, pelo Firewall quando o deployment define um Firewall, e uma regra desse Firewall sobre Client Certificate Validation pode recusá-la. [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/) o compara com enforce. | | versão mínima de TLS | A menor versão de TLS que um Workload aceita, definida em `tls.minimum_version` como `tls_1_0`, `tls_1_1`, `tls_1_2` ou `tls_1_3`, o padrão. Ela é um piso, então um Workload definido como `tls_1_2` ainda pode atender uma sessão em TLS 1.3. [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#tls) documenta os campos de TLS. | | Workload | A entidade que você cria em Workloads: o ponto de entrada que recebe as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Um Workload guarda um workload domain que a Azion gera, os domínios que você adiciona, as configurações de TLS e mTLS, as portas e as versões HTTP que aceita e a infraestrutura em que roda. Depois de receber uma requisição, o Workload a encaminha para a Application que o deployment desse Workload define. [Workloads](/pt-br/documentacao/plataforma/workloads/) descreve o recurso da plataforma, e [Primeiros passos com Workloads](/pt-br/documentacao/plataforma/workloads/primeiros-passos/) cria um. | -| workload domain | O hostname somente leitura que a Azion atribui a um Workload na criação, `workload_domain`: `.map.azionedge.net` na produção e `.preview.azionedge.net` no staging. Os clientes alcançam o Workload nele enquanto `workload_domain_allow_access` é `true`, e os seus domínios personalizados apontam para ele com um registro CNAME, como mostra [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion/). Ele não é o Azion custom domain, que é um hostname `azion.app` que você escolhe. | -| Workload Domain Allow Access | A configuração de um Workload, `workload_domain_allow_access` na API e um switch no Azion Console, que permite que os clientes alcancem o Workload pelo workload domain dele, ativa por padrão. Com ela desativada, o workload domain responde `404`, e `domains` precisa ter pelo menos um hostname, ou a API retorna `When the workload hostname access is blocked, the workload requires alternate domains or domains.` [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios) documenta o campo. | +| workload domain | O hostname somente leitura que a Azion atribui a um Workload na criação, `workload_domain`: `.map.azionedge.net` na produção e `.preview.azionedge.net` no staging. Os clientes alcançam o Workload nele enquanto `workload_domain_allow_access` é `true`, o padrão, e os seus domínios personalizados apontam para ele com um registro CNAME, como mostra [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion/). Ele não é o Azion custom domain, que é um hostname `azion.app` que você escolhe. | | zona | Os registros DNS de um domínio, junto com os nameservers que respondem por eles. Na Azion, uma zona fica no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), e não em um Workload: um Workload não guarda registros DNS e responde nos hostnames em `domains` onde quer que a zona deles esteja hospedada. | diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/limites.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/limites.mdx index 178f798c4b..7925d4e281 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/limites.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/limites.mdx @@ -1,7 +1,7 @@ --- title: Limites de Workloads -description: Confira os limites de um Workload, dos domínios, portas e deployment dele e de Certificate Manager, Custom Pages e DDoS Protection. -meta_tags: 'workloads, limits, quotas, domains, certificates, custom pages, ddos protection, plans' +description: Confira o escopo de um Workload e os limites do nome, dos domínios, das portas, das versões HTTP, da infraestrutura e do deployment dele. +meta_tags: 'workloads, limits, scope, quotas, domains, ports, infrastructure, deployment, plans' namespace: documentation_products_workloads_limits permalink: /documentacao/plataforma/workloads/limites/ --- @@ -10,15 +10,32 @@ import FrameBox from '@aziontech/webkit/frame-box' import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' -[Workloads](/pt-br/documentacao/plataforma/workloads/) é um recurso da plataforma que recebe, como ponto de entrada, as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Depois de receber uma requisição, um Workload a encaminha para a [Application](/pt-br/documentacao/plataforma/applications/) que o deployment desse Workload define. O deployment também pode definir o [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e o conjunto de custom pages que substitui as respostas de erro. Esta página informa os limites que a Azion aplica a um Workload, aos certificados e custom pages que ele usa e a DDoS Protection. +[Workloads](/pt-br/documentacao/plataforma/workloads/) é um recurso da plataforma que recebe, como ponto de entrada, as requisições feitas aos seus domínios, na infraestrutura distribuída da Azion. Depois de receber uma requisição, um Workload a encaminha para a [Application](/pt-br/documentacao/plataforma/applications/) que o deployment desse Workload define. O deployment também pode definir o [Firewall](/pt-br/documentacao/plataforma/firewall/) que inspeciona as requisições primeiro e o conjunto de custom pages que substitui as respostas de erro. Esta página informa onde um Workload termina e os limites que a Azion aplica a ele. -Cada limite desta página é verificado em toda chamada, e a chamada falha quando ele é ultrapassado. Um plano de serviço também inclui uma quantidade de uso antes que uma tarifa se aplique. Essa quantidade é um valor de cobrança: ultrapassá-la muda o valor cobrado da conta, e não o que a chamada retorna. A página [Preços da Azion](https://www.azion.com/pt-br/precos/) lista os planos e o uso que cada um inclui. Para as tarifas, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#workloads). +Cada limite desta página é verificado em toda chamada, e a chamada falha quando ele é ultrapassado. + +Um plano de serviço também inclui uma quantidade de uso antes que uma tarifa se aplique. Essa quantidade é um valor de cobrança: ultrapassá-la muda o valor cobrado da conta, e não o que a chamada retorna. A página [Preços da Azion](https://www.azion.com/pt-br/precos/) lista os planos e o uso que cada um inclui. Para as tarifas, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#workloads). + +--- + +## Escopo + +- **Domínios**: um Workload responde no workload domain dele, `.map.azionedge.net` em produção e `.preview.azionedge.net` em staging, assim que o deployment dele se propaga, antes de você ter qualquer domínio. Cada domínio que você adiciona aponta para o workload domain com um registro CNAME. Um Workload de produção também pode responder em um hostname `azion.app`, que Azion Console rotula como **Azion Custom Domain**. Para cada regra que um hostname segue, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#dominios), e para os registros DNS, consulte [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion/). +- **Acesso ao workload domain**: com `workload_domain_allow_access` definido como `false`, o workload domain responde `404`, e o Workload responde somente nos hostnames de `domains`. Esse valor serve a um Workload cujos próprios domínios já atendem o tráfego, e a API o aceita somente enquanto `domains` tem pelo menos um hostname. Para a ordem dessa mudança, consulte [Boas práticas de Workloads](/pt-br/documentacao/plataforma/workloads/boas-praticas/#feche-o-workload-domain-quando-o-seu-dominio-servir-trafego). +- **DNS**: um Workload não guarda registros DNS. A zona de um domínio fica no seu provedor de DNS ou no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), e o Workload responde aos hostnames que lista, onde quer que a zona deles esteja hospedada. +- **Infraestrutura**: um Workload roda na rede de produção, para disponibilidade global, ou na rede de staging, para testes com propagação limitada. A escolha é fixada na criação, e um Workload de staging não aceita domínio personalizado. Por exemplo, uma configuração testada em um Workload de staging chega à produção como um segundo Workload, criado na infraestrutura de produção. Para a escolha em cada interface, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#infraestrutura). +- **TLS**: as configurações de Transport Layer Security (TLS) de um Workload protegem a conexão do cliente até a Azion, enquanto a conexão com a sua origem é configurada no [Connector](/pt-br/documentacao/plataforma/connectors/). O [certificado SAN da Azion](/pt-br/documentacao/plataforma/certificate-manager/glossario/) cobre o workload domain e o hostname `azion.app`, então um domínio seu precisa de um certificado de servidor. A Azion bloqueia a renegociação TLS por padrão. Para as versões de TLS e os conjuntos de cifras, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#tls). +- **mTLS**: com TLS mútuo (mTLS) ativado, um Workload verifica certificados de cliente somente em conexões HTTPS, com um [certificado de CA confiável](/pt-br/documentacao/plataforma/certificate-manager/glossario/), no modo `enforce` ou `permissive`. Para os dois modos e todos os requisitos, consulte [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/). +- **Certificados e custom pages**: um Workload apresenta os certificados que você vincula do [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), e o deployment dele pode definir um conjunto de custom pages de [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/). Os limites de um certificado, de uma chave privada, de uma lista de revogação de certificados (CRL), de um conjunto de custom pages e das páginas dele estão em [Limites do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/limites/) e em [Limites do Custom Pages](/pt-br/documentacao/plataforma/custom-pages/limites/). +- **Deployment**: um Workload criado pela API ou por Azion CLI começa sem deployment. A referência publicada da API v4 não tem endpoint para o deployment, então Azion Console, Azion CLI e [Terraform](/pt-br/documentacao/devtools/terraform/workloads/) o escrevem. Para os campos dele, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#deployment). +- **Propagação**: uma mudança salva em um Workload ou no deployment dele leva vários minutos para alcançar toda a infraestrutura distribuída da Azion, sem duração garantida. Enquanto isso, as requisições podem receber a configuração antiga ou a nova, então repita uma requisição até que as respostas concordem. Por exemplo, logo depois que você ativa o mTLS no modo `enforce`, alguns data centers ainda respondem a um cliente sem certificado. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). +- **Observabilidade**: a página de erro da Azion carrega um header `x-azion-request-id` que identifica a requisição. [Data Stream](/pt-br/documentacao/plataforma/data-stream/) coleta os eventos dos Workloads que você associa a um stream, como mostra [Associe workloads a um stream](/pt-br/documentacao/guias/plataforma/observabilidade/data-stream-associar-workloads/). --- ## Workloads -Um Workload guarda um workload domain que a Azion gera, os domínios que você adiciona, as configurações de Transport Layer Security (TLS) e de TLS mútuo (mTLS), as portas e as versões HTTP que aceita e a infraestrutura em que roda. Ele também guarda no máximo um deployment. Os limites desta seção se aplicam a todo Workload, em todo plano de serviço, a menos que uma tabela indique um plano. +Os limites desta seção se aplicam a todo Workload, em todo plano de serviço, a menos que uma tabela indique um plano. Eles cobrem o que um Workload guarda: o workload domain e os domínios que você adiciona, as configurações de Transport Layer Security (TLS) e de TLS mútuo (mTLS), as portas e as versões HTTP, a infraestrutura e no máximo um deployment. ### Limites padrão @@ -34,12 +51,12 @@ A API rejeita uma chamada que ultrapassa um limite desta tabela com a mensagem d | Portas HTTP | Somente `80`, `8008`, `8080` e `8880` | `Invalid choices for multiple choices field: [80, 8008, 8080, 8880].` | | Versões de HTTP com `http3` | `versions` também contém `http1` e `http2` | `Missing required choices for multiple choices field: ['http1', 'http2'].` | | Conjunto de cifras, `tls.ciphers` | `1` a `8` | `"9" is not a valid choice.` A mensagem cita o valor enviado. | -| Infraestrutura | Definida na criação | `The infrastructure cannot be changed after Workload creation.` | +| Infraestrutura | Fixada na criação | `The infrastructure cannot be changed after Workload creation.` | | Domínios personalizados em um Workload de staging | Nenhum; um Workload de staging responde somente no workload domain dele | `Custom hostname is not available in the environment 'Staging Infrastructure'.` | Um domínio `azion.app` pertence a um Workload em uma conta e não pode ser compartilhado entre contas ou configurações. Por exemplo, para mover um domínio `azion.app` para um novo Workload, remova-o primeiro do Workload que o detém. -Mais quatro limites se aplicam: um Workload lista até 50 domínios por padrão, `http_ports` contém de 1 a 4 entradas, `https_ports` contém de 1 a 12 entradas e `quic_ports` contém até 12 entradas. Para as 12 portas HTTPS que um Workload aceita, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#protocolos-e-portas). +Mais cinco limites se aplicam: um Workload lista até 50 domínios por padrão, `http_ports` contém de 1 a 4 entradas, `https_ports` contém de 1 a 12 entradas, `quic_ports` contém até 12 entradas e `mtls.config.crl` lista até 100 CRLs. Para as 12 portas HTTPS que um Workload aceita, consulte [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#protocolos-e-portas). Os limites de porta se aplicam às portas em que um Workload escuta. A porta à qual a Azion se conecta na sua origem é definida em um [Connector](/pt-br/documentacao/plataforma/connectors/) e pode ser qualquer porta que exista na origem. Para as combinações de portas de entrega e de origem, consulte [Configure portas HTTP e HTTPS](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/configurar-portas/). @@ -47,57 +64,13 @@ A Azion aumenta o limite de 50 domínios por Workload mediante solicitação, de --- -## Certificate Manager - -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) é um recurso da plataforma que armazena os certificados que um Workload usa para TLS. Ele armazena os certificados de servidor que um Workload apresenta e os certificados de CA confiável que verificam certificados de cliente no mTLS. Ele também armazena as listas de revogação de certificados (CRLs) que um Workload lista e solicita os certificados Let's Encrypt que a Azion gerencia para você. Certificate Manager não tem quantidade incluída por plano. - -### Limites padrão - -Azion API aplica estes limites a um certificado, a uma chave privada e a uma CRL: - -- Um certificado, de servidor ou de CA confiável, aceita até 1.000.000 caracteres. -- Uma chave privada aceita até 64.000 caracteres. -- Uma CRL aceita até 30.720.000 caracteres. -- Um Workload anexa até 100 CRLs, em `mtls.config.crl`. -- Um certificado Let's Encrypt cobre até 50 dos domínios do Workload. - -Os nomes que um certificado Let's Encrypt cobre vêm dos domínios do Workload. - -O suporte da Azion a certificados Let's Encrypt depende da disponibilidade e dos limites do serviço Let's Encrypt. Para esses limites, consulte os [rate limits do Let's Encrypt](https://letsencrypt.org/docs/rate-limits/). - ---- - -## Custom Pages - -[Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, uma página por status code de erro. Um conjunto de custom pages é a lista nomeada que agrupa essas páginas. Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. Os limites desta seção se aplicam ao conjunto e a cada página dele. - -### Limites padrão - -Um conjunto de custom pages contém pelo menos uma página. A API e Azion Console rejeitam um conjunto vazio com a mensagem da coluna Ao ultrapassar o limite. - -| Escopo | Limite | Ao ultrapassar o limite | -| --- | --- | --- | -| Páginas por conjunto de custom pages | No mínimo 1 | A API retorna `Ensure this field has at least 1 elements.` Azion Console mostra `You must have at least one custom page code`. | - -Mais quatro limites se aplicam: o `name` de um conjunto aceita de 1 a 255 caracteres, o `ttl` de uma página aceita de 0 a 31.536.000 segundos, o `uri` de uma página aceita de 1 a 250 caracteres e o `custom_status_code` de uma página aceita de 100 a 599. Para os campos a que esses limites se aplicam, consulte [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/). - ---- - -## DDoS Protection - -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) é uma feature da Azion Platform que mitiga ataques de negação de serviço em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. Para saber como a mitigação de DDoS Protection é cobrada, incluindo o que não é medido, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#ddos-protection). - -Você pode contatar o [Security Response Team (SRT)](/pt-br/documentacao/servicos/security-response-team/) durante ou depois de um ataque, ou antes dele, para criar regras personalizadas. O SRT é um contrato à parte: um pacote mensal de horas. - ---- - ## Recursos relacionados Todos os campos de um Workload e do deployment dele, com o tipo, o padrão e os valores permitidos a que se aplicam os limites desta página. - Os certificados de servidor e de CA confiável que um Workload usa, as CRLs que ele lista e como enviar ou solicitar um certificado. - Os campos de um conjunto de custom pages e das páginas dele, e os status codes que uma página pode substituir. + O tamanho de um certificado, de uma chave privada e de uma CRL, e os nomes que um certificado Let's Encrypt cobre. + Os limites de um conjunto de custom pages e de cada página dele. A tarifa que se aplica a Workloads, transferência de dados e requisições além de cada quantidade incluída. diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/primeiros-passos.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/primeiros-passos.mdx index a782115bb1..9d4a76d263 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/primeiros-passos.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/primeiros-passos.mdx @@ -27,9 +27,7 @@ Depois de receber uma requisição, o Workload a encaminha para a Application qu Este guia mantém os padrões de um Workload novo: a infraestrutura de produção, as configurações padrão de Transport Layer Security (TLS), as portas `80` e `443` e nenhum domínio seu. -O Workload que este guia deixa pronto é o ponto de partida de outros dois primeiros passos. Com [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager), você vincula um certificado ao Workload. Com [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages), você define um conjunto de custom pages no deployment do Workload para substituir respostas de erro. - -[DDoS Protection](/pt-br/documentacao/plataforma/workloads/#ddos-protection) é uma feature da Azion Platform que mitiga ataques de negação de serviço em todo Workload. Ela está sempre ativa e não precisa de ativação nem de configuração. +O Workload que este guia deixa pronto é o ponto de partida de outros dois primeiros passos. Com [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/), você vincula um certificado ao Workload. Com [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/), você define um conjunto de custom pages no deployment do Workload para substituir respostas de erro. --- @@ -125,7 +123,9 @@ Para criar o Workload no Azion Console: -Azion Console mostra a mensagem "Your Workload has been created. After propagation the domain will be available in the Workload URL. You also can add a custom domain." Para copiar o workload domain para o qual você envia a requisição, selecione **Copy Workload URL**. A mensagem fecha depois de alguns segundos, e a coluna **Workload Domain** da lista de Workloads também mostra o workload domain. O Workload existe, e o deployment dele define a sua Application. +Azion Console mostra a mensagem "Your Workload has been created. After propagation the domain will be available in the Workload URL. You also can add a custom domain." Para copiar o workload domain para o qual você envia a requisição, selecione **Copy Workload URL**. + +A mensagem fecha depois de alguns segundos, e a coluna **Workload Domain** da lista de Workloads também mostra o workload domain. O Workload existe, e o deployment dele define a sua Application. @@ -361,7 +361,9 @@ O deployment do Workload define a sua Application. A verificação é a mesma, qualquer que seja a interface que criou o Workload. Nos comandos, substitua `` pelo workload domain do Workload que você criou, no formato `.map.azionedge.net`. -Um Workload novo responde com a sua Application somente depois que o deployment dele se propaga pela infraestrutura distribuída da Azion. Isso leva vários minutos, sem duração garantida. Até lá, o workload domain responde `404` com a página de erro HTML da Azion. Enquanto o deployment se propaga, as respostas à mesma requisição podem alternar entre esse `404` e a resposta da sua Application. Envie a requisição de novo até a sua Application responder. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). +Um Workload novo responde com a sua Application somente depois que o deployment dele se propaga pela infraestrutura distribuída da Azion. Isso leva vários minutos, sem duração garantida. Até lá, o workload domain responde `404` com a página de erro HTML da Azion. + +Enquanto o deployment se propaga, as respostas à mesma requisição podem alternar entre esse `404` e a resposta da sua Application. Envie a requisição de novo até a sua Application responder. Para mais informações, consulte [Propagação](/pt-br/documentacao/plataforma/workloads/como-funciona/#propagacao). Antes que o deployment se propague, uma requisição `HEAD` recebe `404` e os cabeçalhos da página de erro da Azion: @@ -387,8 +389,8 @@ A resposta é a que a sua Application retorna para `/`: o status, os cabeçalhos ## Próximos passos - - + + diff --git a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/solucao-de-problemas.mdx b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/solucao-de-problemas.mdx index c9c77bd879..3da84b1b78 100644 --- a/apps/docs/src/content/docs/pt-br/pages/secure/workloads/solucao-de-problemas.mdx +++ b/apps/docs/src/content/docs/pt-br/pages/secure/workloads/solucao-de-problemas.mdx @@ -1,7 +1,7 @@ --- title: Solucione problemas de Workloads -description: Encontre a causa de um 404, de um domínio ou configuração recusados, de um cliente que falha no TLS mútuo (mTLS) e de um certificado não emitido. -meta_tags: 'workloads, troubleshooting, 404, domains, mtls, handshake, certificate manager, lets encrypt, pending, custom pages, errors' +description: Encontre a causa de um 404, de um domínio ou configuração recusados, de um cliente que falha no TLS mútuo (mTLS) e de um certificado recusado no Workload. +meta_tags: 'workloads, troubleshooting, 404, domains, mtls, handshake, propagation, certificate, deployment, errors' namespace: documentation_products_workloads_troubleshooting permalink: /documentacao/plataforma/workloads/solucao-de-problemas/ --- @@ -11,7 +11,7 @@ import ItemList from '@aziontech/webkit/item-list' import DocItem from '@aziontech/webkit/doc-item' import Code from '~/components/webkit/CodeBlock.vue' -Esta página cobre os sintomas de um [Workload](/pt-br/documentacao/plataforma/workloads/) no tráfego real ou em uma requisição recusada, incluindo os de [Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) e de [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages). Uma recusa citada é a mensagem da API, a menos que a entrada nomeie outra fonte. Azion CLI imprime a mesma mensagem dentro de `Error: Failed to ... [...]`. +Esta página cobre os sintomas de um [Workload](/pt-br/documentacao/plataforma/workloads/) no tráfego real ou em uma requisição recusada. Para um certificado do [Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/) ou um conjunto de custom pages do [Custom Pages](/pt-br/documentacao/plataforma/custom-pages/), consulte [Solucione problemas do Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/) e [Solucione problemas do Custom Pages](/pt-br/documentacao/plataforma/custom-pages/solucao-de-problemas/). Uma recusa citada é a mensagem da API, a menos que a entrada nomeie outra fonte. Azion CLI imprime a mesma mensagem dentro de `Error: Failed to ... [...]`. --- @@ -78,7 +78,7 @@ O cliente então aceita o certificado, e o domínio personalizado serve HTTPS. Salvar os domínios do Workload falha com `This account is not allowed to use the following CNAMEs: example.com.`, em que a mensagem nomeia cada domínio recusado. -A conta não tem permissão para um domínio em `domains`, e a API recusa a requisição inteira, como os erros de [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#erros) mostram. No Azion Console, uma opção _New Let's Encrypt Certificate_ solicita um certificado primeiro, e essa solicitação falha como [Uma solicitação de certificado é recusada](#uma-solicitacao-de-certificado-e-recusada-com-this-account-cannot-use-certain-common-or-alternative-names) descreve. +A conta não tem permissão para um domínio em `domains`, e a API recusa a requisição inteira, como os erros de [Configurações de Workload](/pt-br/documentacao/plataforma/workloads/configuracoes/#erros) mostram. No Azion Console, uma opção _New Let's Encrypt Certificate_ solicita um certificado primeiro, e essa solicitação falha como [Uma solicitação de certificado é recusada](/pt-br/documentacao/plataforma/certificate-manager/solucao-de-problemas/#uma-solicitacao-de-certificado-e-recusada-com-this-account-cannot-use-certain-common-or-alternative-names) descreve. - **Remova o domínio que a mensagem nomeia** e salve o restante da lista. - **Liste apenas domínios para os quais a sua conta tem permissão**. @@ -177,7 +177,7 @@ Um cliente não recebe resposta: o curl termina com o código `56` depois da sol O Workload tem TLS mútuo (mTLS) no modo `enforce`, e o cliente não apresentou certificado, ou apresentou um que uma autoridade certificadora (CA) em que você não confia assinou. Uma conexão sem Server Name Indication (SNI) também é encerrada antes que chegue à sua aplicação. -- **Apresente um certificado que a sua CA confiável assinou**: o certificado de CA confiável é o certificado da CA que assina os certificados dos seus clientes. O Workload o lê de `mtls.config.certificate`, e o curl envia um certificado de cliente com `--cert` e `--key`. +- **Apresente um certificado que a sua CA confiável assinou**: o [certificado de CA confiável](/pt-br/documentacao/plataforma/certificate-manager/glossario/) é o certificado da CA que assina os certificados dos seus clientes. O Workload o lê de `mtls.config.certificate`, e o curl envia um certificado de cliente com `--cert` e `--key`. - **Envie SNI de todo cliente**: em um Workload `enforce`, uma conexão sem ele nunca alcança a sua aplicação, como [mTLS](/pt-br/documentacao/plataforma/workloads/mtls/#requisitos) lista. - **Admita clientes enquanto testa**: `permissive` completa o handshake e deixa a decisão para uma regra de Firewall, como [Modos de verificação](/pt-br/documentacao/plataforma/workloads/mtls/#modos-de-verificacao) descreve. - **Espere uma mudança de modo se propagar**: até lá, alguns data centers respondem com o modo anterior. @@ -223,109 +223,13 @@ Azion CLI então imprime `Updated Workload with ID `, e o certifica --- -## Certificate Manager - -[Certificate Manager](/pt-br/documentacao/plataforma/workloads/#certificate-manager) é um recurso da plataforma que armazena os certificados que um Workload usa para TLS. Ele solicita certificados Let's Encrypt para os domínios de um Workload, guarda os que você envia e mostra o estado de cada um em `status`. Para saber onde ele age sobre uma requisição, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/#certificate-manager). - -### Um certificado fica pendente - -Um certificado Let's Encrypt mantém o status `pending` ou `challenge_verification`, e, no Azion Console, o campo **Digital Certificate** do Workload avisa "This certificate is pending validation and HTTPS may not work until it’s validated". - -O desafio não valida um dos nomes: no HTTP-01, o Let's Encrypt busca um arquivo no hostname, então todo nome precisa apontar para a Azion. No DNS-01, ele lê um registro `_acme-challenge` no DNS do domínio, como [Validação de domínio](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#validacao-de-dominio) explica. - -- **Verifique os nomes**: um certificado solicitado pelo formulário do Workload no Azion Console cobre os **Domains** do Workload, então confirme que cada um está correto. -- **Para o HTTP-01, aponte todo nome para a Azion**, incluindo os nomes alternativos. -- **Para o DNS-01 em outro provedor de DNS, adicione o CNAME**: `_acme-challenge.` com o valor `.letsencrypt.azion.com`. No Edge DNS, a Azion grava o registro ela mesma. -- **Se o certificado continuar falhando, verifique os registros CNAME de novo**: a Azion tenta de novo uma emissão que falhou em intervalos crescentes, como [Tempo de emissão e novas tentativas](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas) lista. - -Depois que uma tentativa posterior valida, o certificado aparece como `active` enquanto um Workload o usa, ou `inactive` até lá. Para os registros passo a passo, consulte [Solicite um certificado Let's Encrypt](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/como-gerar-um-certificado-lets-encrypt/). - -### Uma solicitação de certificado é recusada com This account cannot use certain common or alternative names - -Uma solicitação Let's Encrypt, uma solicitação de assinatura de certificado (CSR) ou o salvamento de um domínio novo no Azion Console falha com `This account cannot use certain common or alternative names because it does not have permission for their domain names.` - -Um nome da solicitação pertence a um domínio para o qual a conta não tem permissão. Um hostname `azion.app` também é recusado, mesmo um que um Workload da conta tenha, como os erros de [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#erros) mostram. - -- **Nomeie apenas hostnames em domínios para os quais a sua conta tem permissão**, em `common_name` e `alternative_names`. -- **Não solicite certificado para um hostname `azion.app`**: com `tls.certificate` definido como `null`, o Workload apresenta o certificado SAN da Azion, que cobre o hostname `azion.app` e o workload domain. -- **No Azion Console, remova o domínio recusado de Domains**: adicionar um domínio troca **Digital Certificate** de _Azion (SAN)_ para _New Let's Encrypt Certificate (DNS-01)_. **Save** então solicita esse certificado antes de salvar o Workload, e não salva nada quando a solicitação é recusada. - -Uma solicitação aceita retorna o `id` do certificado com o status `pending`, e Azion Console mostra "Your workload has been updated". - -### A emissão de um certificado falha - -Um certificado Let's Encrypt aparece como `failed`, e, no Azion Console, o campo **Digital Certificate** do Workload avisa "This digital certificate failed and HTTPS cannot be used until the issue is resolved". - -A validação falhou, e a Azion registra o motivo no campo `status_detail` do certificado. Um valor nomeia o hostname cujo registro deve ser verificado: - -```text -An error has occurred while issuing the requested certificate. Please verify the following domains CNAME: www.example.com -``` - -Outro não nomeia hostname, então verifique todos os nomes do certificado, como [Um certificado fica pendente](#um-certificado-fica-pendente) lista: - -```text -domain ownership validation failed - verify DNS records or HTTP challenge accessibility -``` - -Leia `status_detail` em qualquer interface e corrija o registro ou o nome para o qual ele aponta: - -- **Azion Console**: em **Certificate Manager**, o ícone de erro do certificado o mostra. -- **Azion CLI**: `azion describe digital-certificate --digital-certificate-id --format json` o imprime ao lado de `status`. -- **API**: `GET /v4/workspace/tls/certificates/` o retorna com o certificado. - -Uma tentativa posterior no [cronograma de novas tentativas](/pt-br/documentacao/plataforma/workloads/certificate-manager/emissao-e-renovacao/#tempo-de-emissao-e-novas-tentativas) pode então emitir o certificado, e um certificado emitido em uso aparece como `active`, com `status_detail` em `""`. - -### Uma chave privada enviada é recusada - -O envio de um certificado de servidor falha com `The provided private key is invalid. Please check the key and try again.` - -A API não consegue ler a `private_key` enviada com o certificado, como os erros de [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#erros) mostram. - -- **Envie a chave que corresponde ao certificado**. -- **Envie-a em PEM**, com as suas linhas `-----BEGIN` e `-----END` e sem passphrase, como [Algoritmos e formatos de chave](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#algoritmos-de-chave-e-formatos) lista. -- **Mantenha a chave como uma única string JSON em um corpo de API**, com cada quebra de linha escrita como `\n`. - -Azion CLI então imprime `Created Digital Certificate with ID `, e o certificado aparece como `inactive` até que um Workload o use. - ---- - -## Custom Pages - -[Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages) é um recurso da plataforma que substitui por uma página sua a resposta de erro retornada por um Connector, uma página por status code de erro. As páginas ficam em um conjunto de custom pages. Para saber onde ele age sobre uma requisição, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/#custom-pages). - -### Um conjunto de custom pages é recusado com Ensure this field has at least 1 elements - -Criar um conjunto de custom pages falha com `Ensure this field has at least 1 elements.`, ou Azion Console se recusa a salvá-lo com `You must have at least one custom page code`. - -Um conjunto contém pelo menos uma página, e a requisição enviou `"pages": []`, como os erros de [Configurações de custom page](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/#erros) mostram. - -- **Adicione uma página a `pages`**: uma página substitui um status code de erro por um conteúdo de um Connector, como mostra [Corpo da requisição](/pt-br/documentacao/plataforma/workloads/custom-pages/configuracoes/#corpo-da-requisicao). -- **Adicione um código de página no Azion Console**: a tabela **Page Codes** precisa de uma linha antes que você salve o conjunto. - -Azion CLI então imprime `Created Custom Page with ID `. - -### Uma página de erro não aparece - -A resposta de erro do Connector chega ao cliente sem alteração, mesmo que um conjunto de custom pages contenha uma página para o status code dela. - -Um Workload usa um conjunto de custom pages somente depois que o deployment desse Workload define esse conjunto. - -- **Defina o conjunto de custom pages no deployment**: no Azion Console, selecione-o no campo **Custom Page** de **Deployment Settings**, ou passe `--custom-page` para `azion create workload-deployment` ao criar o deployment. A Azion CLI não tem comando que atualiza um deployment. Para os passos, consulte [Personalize uma página de erro](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/primeiros-passos/personalizar-pagina-resposta-erro/#atribua-o-conjunto-no-deployment-do-workload). -- **Verifique o status code que o Connector retorna**: uma página age apenas sobre o código que lista, como `"404"`. -- **Espere a mudança se propagar**. - -O cliente então recebe o conteúdo da página no próprio lugar, com o `custom_status_code` da página quando definido, e sem header `Location`. - ---- - ## Recursos relacionados Cada campo de um Workload e do deployment dele, com a tabela completa de recusas e o que fazer em cada uma. O caminho que uma requisição percorre pelo Workload, pelo deployment e pela propagação, no qual a maioria das correções desta página se apoia. - Os tipos de certificado, os status e os formatos de chave que um Workload aceita, com os erros que um envio ou uma solicitação retorna. + Um certificado que fica pendente, falha na emissão ou é recusado na solicitação ou no envio. Como os modos enforce e permissive tratam um certificado de cliente e como é um handshake recusado. diff --git a/apps/docs/src/data/docs-home/en.ts b/apps/docs/src/data/docs-home/en.ts index 4f2b42a943..9cf7410492 100644 --- a/apps/docs/src/data/docs-home/en.ts +++ b/apps/docs/src/data/docs-home/en.ts @@ -238,7 +238,7 @@ export const en: DocsHomeContent = { links: [ { label: 'DDoS Protection', - href: '/en/documentation/platform/workloads/#ddos-protection', + href: '/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/', }, { label: 'WAF Rule Sets', href: '/en/documentation/platform/firewall/waf/rules-set/' }, { diff --git a/apps/docs/src/data/docs-home/pt-br.ts b/apps/docs/src/data/docs-home/pt-br.ts index 8cb8684e29..52add6a043 100644 --- a/apps/docs/src/data/docs-home/pt-br.ts +++ b/apps/docs/src/data/docs-home/pt-br.ts @@ -237,7 +237,7 @@ export const ptBr: DocsHomeContent = { links: [ { label: 'DDoS Protection', - href: '/pt-br/documentacao/plataforma/workloads/#ddos-protection', + href: '/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/', }, { label: 'WAF Rule Sets', diff --git a/apps/docs/src/data/platform-topology/en.ts b/apps/docs/src/data/platform-topology/en.ts index d2552a3d7d..017b134ead 100644 --- a/apps/docs/src/data/platform-topology/en.ts +++ b/apps/docs/src/data/platform-topology/en.ts @@ -26,7 +26,7 @@ export const en: PlatformTopologyContent = { { id: 'certificate-manager', label: 'Certificate Manager', - href: '/en/documentation/platform/workloads/#certificate-manager', + href: '/en/documentation/platform/certificate-manager/', }, ], href: '/en/documentation/platform/workloads/', @@ -45,7 +45,7 @@ export const en: PlatformTopologyContent = { { id: 'ddos-protection', label: 'DDoS Protection', - href: '/en/documentation/platform/workloads/#ddos-protection', + href: '/en/documentation/platform/workloads/ddos-protection/ddos-mitigation/', }, { id: 'bot-manager', @@ -93,7 +93,7 @@ export const en: PlatformTopologyContent = { tag: OPTIONAL, role: 'Error pages', terminal: true, - href: '/en/documentation/platform/workloads/#custom-pages', + href: '/en/documentation/platform/custom-pages/', }, ], [ diff --git a/apps/docs/src/data/platform-topology/pt-br.ts b/apps/docs/src/data/platform-topology/pt-br.ts index 7bb77a4dee..a1143f5d62 100644 --- a/apps/docs/src/data/platform-topology/pt-br.ts +++ b/apps/docs/src/data/platform-topology/pt-br.ts @@ -26,7 +26,7 @@ export const ptBr: PlatformTopologyContent = { { id: 'certificate-manager', label: 'Certificate Manager', - href: '/pt-br/documentacao/plataforma/workloads/#certificate-manager', + href: '/pt-br/documentacao/plataforma/certificate-manager/', }, ], href: '/pt-br/documentacao/plataforma/workloads/', @@ -45,7 +45,7 @@ export const ptBr: PlatformTopologyContent = { { id: 'ddos-protection', label: 'DDoS Protection', - href: '/pt-br/documentacao/plataforma/workloads/#ddos-protection', + href: '/pt-br/documentacao/plataforma/workloads/ddos-protection/ddos-mitigation/', }, { id: 'bot-manager', @@ -97,7 +97,7 @@ export const ptBr: PlatformTopologyContent = { tag: OPCIONAL, role: 'Páginas de erro', terminal: true, - href: '/pt-br/documentacao/plataforma/workloads/#custom-pages', + href: '/pt-br/documentacao/plataforma/custom-pages/', }, ], [ diff --git a/apps/docs/src/includes/migration-guides/en/certificate-cli.mdx b/apps/docs/src/includes/migration-guides/en/certificate-cli.mdx index 64538e2169..1164e61b23 100644 --- a/apps/docs/src/includes/migration-guides/en/certificate-cli.mdx +++ b/apps/docs/src/includes/migration-guides/en/certificate-cli.mdx @@ -1 +1 @@ -To set mTLS or the certificate of a workload with the Azion CLI, run `azion update workload --file` with the workload body. For the certificate commands, refer to [Certificate Manager quickstart](/en/documentation/platform/workloads/certificate-manager/quickstart/). +To set mTLS or the certificate of a workload with the Azion CLI, run `azion update workload --file` with the workload body. For the certificate commands, refer to [Certificate Manager quickstart](/en/documentation/platform/certificate-manager/quickstart/). diff --git a/apps/docs/src/includes/migration-guides/en/certificate-console.mdx b/apps/docs/src/includes/migration-guides/en/certificate-console.mdx index 0ad4ebe3b0..e34be61dd5 100644 --- a/apps/docs/src/includes/migration-guides/en/certificate-console.mdx +++ b/apps/docs/src/includes/migration-guides/en/certificate-console.mdx @@ -29,4 +29,4 @@ To request the certificate in Azion Console: The first attempt runs up to 5 minutes after you save, and retries follow at 5, 10, 15, 20, and 30 minutes, then on a slower schedule. The status moves from `pending` to `challenge_verification`, then to `active` or `failed`. -To upload a certificate you already have, go to **Certificate Manager** and create a digital certificate with the **Server Certificate** preset. Paste the PEM certificate and the private key. Intermediate certificates go in the same field as the certificate. Then select it in the **Digital Certificate** field of the workload. For the steps, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/), and for every certificate field, to [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/). +To upload a certificate you already have, go to **Certificate Manager** and create a digital certificate with the **Server Certificate** preset. Paste the PEM certificate and the private key. Intermediate certificates go in the same field as the certificate. Then select it in the **Digital Certificate** field of the workload. For the steps, refer to [Upload a digital certificate](/en/documentation/guides/application-security/tls-and-certificates/digital-certificates/), and for every certificate field, to [Certificates](/en/documentation/platform/certificate-manager/certificates/). diff --git a/apps/docs/src/includes/migration-guides/pt-br/certificate-cli.mdx b/apps/docs/src/includes/migration-guides/pt-br/certificate-cli.mdx index dde34ced72..50f061e13f 100644 --- a/apps/docs/src/includes/migration-guides/pt-br/certificate-cli.mdx +++ b/apps/docs/src/includes/migration-guides/pt-br/certificate-cli.mdx @@ -1 +1 @@ -Para definir o mTLS ou o certificado de um workload com Azion CLI, execute `azion update workload --file` com o corpo do workload. Para os comandos de certificado, consulte [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/workloads/certificate-manager/primeiros-passos/). +Para definir o mTLS ou o certificado de um workload com Azion CLI, execute `azion update workload --file` com o corpo do workload. Para os comandos de certificado, consulte [Primeiros passos com Certificate Manager](/pt-br/documentacao/plataforma/certificate-manager/primeiros-passos/). diff --git a/apps/docs/src/includes/migration-guides/pt-br/certificate-console.mdx b/apps/docs/src/includes/migration-guides/pt-br/certificate-console.mdx index 73624b3097..e1920c7652 100644 --- a/apps/docs/src/includes/migration-guides/pt-br/certificate-console.mdx +++ b/apps/docs/src/includes/migration-guides/pt-br/certificate-console.mdx @@ -29,4 +29,4 @@ Para solicitar o certificado no Azion Console: A primeira tentativa acontece em até 5 minutos depois de salvar, e as novas tentativas seguem aos 5, 10, 15, 20 e 30 minutos, depois em um ritmo mais lento. O status passa de `pending` para `challenge_verification` e depois para `active` ou `failed`. -Para enviar um certificado que você já tem, vá para **Certificate Manager** e crie um certificado digital com o preset **Server Certificate**. Cole o certificado PEM e a chave privada. Os certificados intermediários vão no mesmo campo do certificado. Depois selecione-o no campo **Digital Certificate** do workload. Para os passos, consulte [Faça upload de um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/), e para cada campo de certificado, [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/). +Para enviar um certificado que você já tem, vá para **Certificate Manager** e crie um certificado digital com o preset **Server Certificate**. Cole o certificado PEM e a chave privada. Os certificados intermediários vão no mesmo campo do certificado. Depois selecione-o no campo **Digital Certificate** do workload. Para os passos, consulte [Faça upload de um certificado digital](/pt-br/documentacao/guias/seguranca-de-aplicacoes/tls-e-certificados/certificado-digital/), e para cada campo de certificado, [Certificados](/pt-br/documentacao/plataforma/certificate-manager/certificados/). diff --git a/apps/docs/src/includes/snippets/LetsEncryptExpiration/en/snippet.mdx b/apps/docs/src/includes/snippets/LetsEncryptExpiration/en/snippet.mdx index 8331a32953..fc6a3ba79c 100644 --- a/apps/docs/src/includes/snippets/LetsEncryptExpiration/en/snippet.mdx +++ b/apps/docs/src/includes/snippets/LetsEncryptExpiration/en/snippet.mdx @@ -1,7 +1,7 @@ :::note[Note] Let's Encrypt certificates cross-signed by IdenTrust expired on September 30th, 2024. Devices and applications using the [Let's Encrypt certificate that uses IdenTrust will become invalid](https://letsencrypt.org/2023/07/10/cross-sign-expiration.html). This could impact the functionality of devices and applications utilizing these certificates, mainly users of older Android devices (pre-7.1). It'll be necessary to take the following actions: -- **For users of Let's Encrypt Certificates with IdenTrust**: you must migrate to the new Let's Encrypt signing technology or an [Azion server certificate](/en/documentation/platform/workloads/certificate-manager/certificates/#server-certificate). +- **For users of Let's Encrypt Certificates with IdenTrust**: you must migrate to the new Let's Encrypt signing technology or an [Azion server certificate](/en/documentation/platform/certificate-manager/certificates/#server-certificate). - **For users of other types of Let's Encrypt**: no immediate action is necessary, considering other certificates remain unaffected with this update, since the problem is caused by outdated certificate chains on the device. - **For user with applications using Let's Encrypt in Azion**: no action needed. Certificates are automatically updated, although an affected device must have its CAs updated as well. ::: \ No newline at end of file diff --git a/apps/docs/src/includes/snippets/LetsEncryptExpiration/pt/snippet.mdx b/apps/docs/src/includes/snippets/LetsEncryptExpiration/pt/snippet.mdx index 5c4690d8fc..d01ce7c55f 100644 --- a/apps/docs/src/includes/snippets/LetsEncryptExpiration/pt/snippet.mdx +++ b/apps/docs/src/includes/snippets/LetsEncryptExpiration/pt/snippet.mdx @@ -1,7 +1,7 @@ :::caution[Atenção] -Os certificados Let's Encrypt assinados cruzadamente pela IdenTrust expiraram em 30 de setembro de 2024. Dispositivos e aplicações que usam o [certificado Let's Encrypt ligado ao IdenTrust se tornaram inválidos](https://letsencrypt.org/2023/07/10/cross-sign-expiration.html). Se você utiliza esse tipo de certificado, é necessário migrar para a nova tecnologia de assinatura Let's Encrypt ou para um [certificado de servidor da Azion](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-de-servidor). Isso pode impactar a funcionalidade de dispositivos e aplicações que utilizam esses certificados, principalmente usuários de dispositivos Android mais antigos (anterior ao 7.1). Será necessário tomar as seguintes ações: +Os certificados Let's Encrypt assinados cruzadamente pela IdenTrust expiraram em 30 de setembro de 2024. Dispositivos e aplicações que usam o [certificado Let's Encrypt ligado ao IdenTrust se tornaram inválidos](https://letsencrypt.org/2023/07/10/cross-sign-expiration.html). Se você utiliza esse tipo de certificado, é necessário migrar para a nova tecnologia de assinatura Let's Encrypt ou para um [certificado de servidor da Azion](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-de-servidor). Isso pode impactar a funcionalidade de dispositivos e aplicações que utilizam esses certificados, principalmente usuários de dispositivos Android mais antigos (anterior ao 7.1). Será necessário tomar as seguintes ações: -- **Para usuários de Certificados Let's Encrypt com IdenTrust**: você deve migrar para a nova tecnologia de assinatura do Let's Encrypt ou para um [certificado de servidor da Azion](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/#certificado-de-servidor). +- **Para usuários de Certificados Let's Encrypt com IdenTrust**: você deve migrar para a nova tecnologia de assinatura do Let's Encrypt ou para um [certificado de servidor da Azion](/pt-br/documentacao/plataforma/certificate-manager/certificados/#certificado-de-servidor). - **Para usuários de outros tipos de Certificados Let's Encrypt**: nenhuma ação imediata é necessária, considerando que outros certificados não são afetados com esta atualização, uma vez que o problema é causado por cadeias de certificados desatualizadas no dispositivo. - **Para usuários com aplicações usando Let's Encrypt na Azion**: nenhuma ação é necessária. Os certificados são atualizados automaticamente, embora um dispositivo afetado também deva ter seus CAs atualizados. ::: \ No newline at end of file diff --git a/apps/docs/src/nav/root.json b/apps/docs/src/nav/root.json index 15a1ad2fca..db3a11f846 100644 --- a/apps/docs/src/nav/root.json +++ b/apps/docs/src/nav/root.json @@ -54,6 +54,12 @@ { "tree": "ai-inference" }, + { + "tree": "certificate-manager" + }, + { + "tree": "custom-pages" + }, { "tree": "real-time-metrics" }, diff --git a/apps/docs/src/nav/trees/certificate-manager.json b/apps/docs/src/nav/trees/certificate-manager.json new file mode 100644 index 0000000000..207fa64b20 --- /dev/null +++ b/apps/docs/src/nav/trees/certificate-manager.json @@ -0,0 +1,148 @@ +{ + "id": "certificate-manager", + "title": { + "en": "Certificate Manager" + }, + "description": { + "en": "Certificates for TLS on your Workloads", + "pt-br": "Certificados para TLS nos seus Workloads" + }, + "parent": "root", + "path": { + "en": "platform/certificate-manager", + "pt-br": "plataforma/certificate-manager" + }, + "root": "documentation_products_certificate_manager", + "groups": [ + { + "items": [ + { + "page": "documentation_products_certificate_manager", + "label": { + "en": "Overview", + "pt-br": "Visão geral" + } + }, + { + "page": "documentation_products_certificate_manager_quickstart", + "label": { + "en": "Quickstart", + "pt-br": "Primeiros passos" + }, + "slug": { + "en": "quickstart", + "pt-br": "primeiros-passos" + } + }, + { + "page": "documentation_products_certificate_manager_how_it_works", + "label": { + "en": "How it works", + "pt-br": "Como funciona" + }, + "slug": { + "en": "how-it-works", + "pt-br": "como-funciona" + } + }, + { + "page": "documentation_products_certificate_manager_guides", + "label": { + "en": "Guides and tutorials", + "pt-br": "Guias e tutoriais" + }, + "slug": { + "en": "guides", + "pt-br": "guias" + } + }, + { + "label": { + "en": "Reference", + "pt-br": "Referência" + }, + "page": "documentation_hub_workloads_certificate_manager_reference", + "slug": { + "en": "reference", + "pt-br": "referencia" + }, + "landing": true, + "items": [ + { + "page": "documentation_products_certificate_manager_issuance_and_renewal", + "label": { + "en": "Issuance and renewal", + "pt-br": "Emissão e renovação" + }, + "slug": { + "en": "issuance-and-renewal", + "pt-br": "emissao-e-renovacao" + } + }, + { + "page": "documentation_digital_certificates", + "label": { + "en": "Certificates", + "pt-br": "Certificados" + }, + "slug": { + "en": "certificates", + "pt-br": "certificados" + } + } + ] + }, + { + "page": "documentation_products_certificate_manager_limits", + "label": { + "en": "Limits", + "pt-br": "Limites" + }, + "slug": { + "en": "limits", + "pt-br": "limites" + } + }, + { + "page": "documentation_products_certificate_manager_best_practices", + "label": { + "en": "Best practices", + "pt-br": "Boas práticas" + }, + "slug": { + "en": "best-practices", + "pt-br": "boas-praticas" + } + }, + { + "page": "documentation_products_certificate_manager_troubleshooting", + "label": { + "en": "Troubleshooting", + "pt-br": "Solução de problemas" + }, + "slug": { + "en": "troubleshooting", + "pt-br": "solucao-de-problemas" + } + }, + { + "page": "documentation_products_certificate_manager_glossary", + "label": { + "en": "Glossary", + "pt-br": "Glossário" + }, + "slug": { + "en": "glossary", + "pt-br": "glossario" + } + }, + { + "tree": "changelog", + "label": { + "en": "Changelog" + } + } + ] + } + ] +} diff --git a/apps/docs/src/nav/trees/custom-pages.json b/apps/docs/src/nav/trees/custom-pages.json new file mode 100644 index 0000000000..265bbe378a --- /dev/null +++ b/apps/docs/src/nav/trees/custom-pages.json @@ -0,0 +1,134 @@ +{ + "id": "custom-pages", + "title": { + "en": "Custom Pages" + }, + "description": { + "en": "Your own pages for error responses", + "pt-br": "Suas próprias páginas para respostas de erro" + }, + "parent": "root", + "path": { + "en": "platform/custom-pages", + "pt-br": "plataforma/custom-pages" + }, + "root": "documentation_products_custom_pages", + "groups": [ + { + "items": [ + { + "page": "documentation_products_custom_pages", + "label": { + "en": "Overview", + "pt-br": "Visão geral" + } + }, + { + "page": "documentation_products_custom_pages_quickstart", + "label": { + "en": "Quickstart", + "pt-br": "Primeiros passos" + }, + "slug": { + "en": "quickstart", + "pt-br": "primeiros-passos" + } + }, + { + "page": "documentation_products_custom_pages_how_it_works", + "label": { + "en": "How it works", + "pt-br": "Como funciona" + }, + "slug": { + "en": "how-it-works", + "pt-br": "como-funciona" + } + }, + { + "page": "documentation_products_custom_pages_guides", + "label": { + "en": "Guides and tutorials", + "pt-br": "Guias e tutoriais" + }, + "slug": { + "en": "guides", + "pt-br": "guias" + } + }, + { + "label": { + "en": "Reference", + "pt-br": "Referência" + }, + "page": "documentation_hub_workloads_custom_pages_reference", + "slug": { + "en": "reference", + "pt-br": "referencia" + }, + "landing": true, + "items": [ + { + "page": "documentation_secure_custom_pages", + "label": { + "en": "Settings", + "pt-br": "Configurações" + }, + "slug": { + "en": "settings", + "pt-br": "configuracoes" + } + }, + { + "page": "documentation_edge_application_error_responses", + "slug": { + "en": "error-responses", + "pt-br": "error-responses" + }, + "hidden": true + } + ] + }, + { + "page": "documentation_products_custom_pages_limits", + "label": { + "en": "Limits", + "pt-br": "Limites" + }, + "slug": { + "en": "limits", + "pt-br": "limites" + } + }, + { + "page": "documentation_products_custom_pages_troubleshooting", + "label": { + "en": "Troubleshooting", + "pt-br": "Solução de problemas" + }, + "slug": { + "en": "troubleshooting", + "pt-br": "solucao-de-problemas" + } + }, + { + "page": "documentation_products_custom_pages_glossary", + "label": { + "en": "Glossary", + "pt-br": "Glossário" + }, + "slug": { + "en": "glossary", + "pt-br": "glossario" + } + }, + { + "tree": "changelog", + "label": { + "en": "Changelog" + } + } + ] + } + ] +} diff --git a/apps/docs/src/nav/trees/workloads.json b/apps/docs/src/nav/trees/workloads.json index 16cc863ae3..561758028d 100644 --- a/apps/docs/src/nav/trees/workloads.json +++ b/apps/docs/src/nav/trees/workloads.json @@ -45,121 +45,6 @@ "pt-br": "como-funciona" } }, - { - "label": { - "en": "Certificate Manager", - "pt-br": "Certificate Manager" - }, - "segment": "certificate-manager", - "product": "certificate-manager", - "page": "documentation_hub_workloads_certificate_manager", - "landing": true, - "items": [ - { - "page": "documentation_products_certificate_manager_quickstart", - "label": { - "en": "Quickstart", - "pt-br": "Primeiros passos" - }, - "slug": { - "en": "quickstart", - "pt-br": "primeiros-passos" - } - }, - { - "label": { - "en": "Reference", - "pt-br": "Referência" - }, - "page": "documentation_hub_workloads_certificate_manager_reference", - "slug": { - "en": "reference", - "pt-br": "referencia" - }, - "landing": true, - "items": [ - { - "page": "documentation_products_certificate_manager_issuance_and_renewal", - "label": { - "en": "Issuance and renewal", - "pt-br": "Emissão e renovação" - }, - "slug": { - "en": "issuance-and-renewal", - "pt-br": "emissao-e-renovacao" - } - }, - { - "page": "documentation_digital_certificates", - "label": { - "en": "Certificates", - "pt-br": "Certificados" - }, - "slug": { - "en": "certificates", - "pt-br": "certificados" - } - } - ] - } - ] - }, - { - "label": { - "en": "Custom Pages", - "pt-br": "Custom Pages" - }, - "segment": "custom-pages", - "product": "custom-pages", - "page": "documentation_hub_workloads_custom_pages", - "landing": true, - "items": [ - { - "page": "documentation_products_custom_pages_quickstart", - "label": { - "en": "Quickstart", - "pt-br": "Primeiros passos" - }, - "slug": { - "en": "quickstart", - "pt-br": "primeiros-passos" - } - }, - { - "label": { - "en": "Reference", - "pt-br": "Referência" - }, - "page": "documentation_hub_workloads_custom_pages_reference", - "slug": { - "en": "reference", - "pt-br": "referencia" - }, - "landing": true, - "items": [ - { - "page": "documentation_secure_custom_pages", - "label": { - "en": "Settings", - "pt-br": "Configurações" - }, - "slug": { - "en": "settings", - "pt-br": "configuracoes" - } - }, - { - "page": "documentation_edge_application_error_responses", - "slug": { - "en": "error-responses", - "pt-br": "error-responses" - }, - "hidden": true - } - ] - } - ] - }, { "label": { "en": "DDoS Protection",