Você está aqui:
Suporte a zonas SCAPI para B2C Commerce
Uma zona SCAPI é a zona eCDN gerenciada pela Salesforce que está à frente do tráfego da Salesforce Commerce API (SCAPI). A partir do B2C Commerce 26.10, a instância de Production inclui um subconjunto de controles e análises de segurança do eCDN para essa zona no Business Manager e na API da CDN, sem necessidade de nenhum caso de suporte.
Use a zona SCAPI para responder a tráfego abusivo de API, como preenchimento de credenciais em pontos de extremidade de logon, e para inspecionar o tráfego HTTP e de segurança para seu nome de host SCAPI. Os guardrails da plataforma rejeitam configurações que interromperiam o roteamento ou o cache do SCAPI.
O que é uma zona SCAPI?
Uma zona SCAPI é a zona eCDN que direciona o tráfego SCAPI para seu realm. Identifique-o por seu nome de host baseado em código curto.
Formato de nome de host da zona SCAPI: <shortcode.api.commercecloud.salesforce.com>
Ao contrário das zonas de vitrine:
- Não é possível criar uma zona SCAPI. O Salesforce o provisiona automaticamente, que aparece na lista de zonas Configurações da CDN integrada e no seletor Configurar zonas na instância de Production. Para uma zona SCAPI, Adicionar nome de host mostra 0 nomes de host disponíveis.
- Não é possível adicionar ou remover nomes de host em uma zona SCAPI. O nome de host e os certificados são gerenciados pela plataforma.
- A guia Crypto é somente leitura. A tabela Certificados inclui a contagem de certificados e a tabela Certificados (nome do host, status do certificado, status do nome do host, expiração, emissor, assinatura e versão mínima do TLS). Você não pode carregar, excluir, renovar ou gerenciar certificados. Esse é o mesmo modelo somente leitura usado para o Domínio Padrão. Consulte Suporte de domínio padrão para o B2C Commerce.
- Há uma zona SCAPI para Desenvolvimento, Preparação e Produção. Uma regra adicionada aplica-se a todos os três ambientes, a menos que você a defina como escopo. Defina o escopo de cada regra pelo ID da organização no caminho do URL da expressão da regra para que ela não afete outros ambientes. Business Manager mostra um banner de aviso na guia Regras de segurança para lembrá-lo.
- Abra e configure a zona SCAPI somente na instância de Production. A zona não aparece no Business Manager ou na CDN API em Development ou Staging.
- Algumas regras são gerenciadas e bloqueadas pelo Salesforce. As regras gerenciadas pela plataforma (por exemplo, uma lista de permissões para tráfego MRT (Managed Runtime) válido para SCAPI que ignora verificações de WAF personalizadas, limitadas de taxa e gerenciadas) são visíveis, mas não editáveis.
Guia Regras de segurança para uma zona SCAPI
Acessar a zona SCAPI
Há uma zona SCAPI para Desenvolvimento, Preparação e Produção. Depois que o Salesforce provisionar a zona, abra-a na instância de Production. A zona não aparece no Business Manager ou na CDN API em Development ou Staging.
- Em Business Manager na instância de Production, clique em Iniciador de Aplicativos e selecione .
- Localize a zona SCAPI pelo nome de
<host shortcode.api.commercecloud.salesforce.com>. - Abra o menu suspenso da linha e selecione Configurar zona.
Configurações da CDN integrada — Zona SCAPI na lista de zonas
A tela Configurar zonas para uma zona SCAPI fornece três guias —Crypto (somente leitura), Regras de segurança (regras personalizadas, regras de limite de taxa e listas de IP, com subguias Zona e Realm) e Analytics (HTTP e Segurança) — além de um botão Limpar cache. Os controles que não se aplicam a zonas SCAPI não são mostrados.
Configurar zonas — guia Crypto para uma zona SCAPI
Controles disponíveis nas zonas SCAPI
Na instância de Production, as configurações que quebrariam o roteamento ou o cache SCAPI são rejeitadas no momento do envio com um erro claro, antes de serem aplicadas. Os controles que não se aplicam a zonas SCAPI não são mostrados em Business Manager e são rejeitados no nível da CDN API.
| Disponível em Production Business Manager | Não disponível em zonas SCAPI |
|---|---|
| Regras personalizadas (guia Regras de segurança, Regras de segurança de zona e Regras de segurança de realm) | Regras gerenciadas WAF eCDN |
| Regras de limite de taxa (guia Regras de segurança, regras de segurança de zona) | TLS mútuo (mTLS) |
| Listas de acesso IP (guia Regras de segurança, Regras de segurança do realm) | Configuração do TLS 1.3 |
| Analytics — visualizações de tráfego HTTP e de segurança | Regras de roteamento MRT |
| Limpeza de cache (por tag ou caminho) | Segurança de Transporte Estrita de HTTP (HSTS) |
| Guia Crypto — exibição de certificado somente leitura | Gerenciamento de nome de host e certificado |
Esses controles também não estão disponíveis nas zonas SCAPI: Configurações de velocidade, no Modo de Ataque, páginas de erro personalizadas, Módulo Página, notificações, Logpull, Logpush, Substituição de cabeçalho do host e regras de cache (o cache SCAPI é gerenciado por plataforma).
Guia Analytics para uma zona SCAPI
Tarefas relacionadas
Os fluxos de gerenciamento para os controles compatíveis correspondem às zonas do Storefront. Para procedimentos, consulte:
- Criar uma regra de firewall personalizada para uma zona eCDN
- Verificar solicitações de terceiros com cabeçalhos secretos
- Criar uma regra de limite de taxa para uma zona eCDN
- Criar e gerenciar listas de endereços IP confiáveis
- Analisar HTTP e tráfego de segurança para uma zona eCDN
- Limpar o cache do eCDN
- Regras de cache do eCDN e limpeza de cache
- Configurar uma zona eCDN para o B2C Commerce no Business Manager
