위치:
B2C Commerce에 대한 SCAPI 영역 지원
SCAPI 영역은 Salesforce Commerce API(SCAPI) 트래픽을 처리하는 Salesforce 관리 eCDN 영역입니다. B2C Commerce 26.10부터 프로덕션 인스턴스에는 Business Manager 및 CDN API에서 이 영역에 대한 eCDN 보안 제어 및 분석의 하위 세트가 포함되며, 지원 사례는 필요하지 않습니다.
SCAPI 영역을 사용하여 로그인 엔드포인트에 대한 자격 증명 스터핑과 같은 악의적인 API 트래픽에 대응하고 SCAPI 호스트 이름에 대한 HTTP 및 보안 트래픽을 검사합니다. 플랫폼 가드레일은 SCAPI 라우팅 또는 캐싱을 중단할 수 있는 구성을 거부합니다.
SCAPI 영역이란?
SCAPI 영역은 영역에 대한 SCAPI 트래픽을 처리하는 eCDN 영역입니다. 단축 코드 기반 호스트 이름으로 식별합니다.
SCAPI 영역 호스트 이름 형식:<shortcode.api.commercecloud.salesforce.com>
스토어프런트 영역과 달리 다음을 수행합니다.
- SCAPI 영역은 만들 수 없습니다. Salesforce에서 자동으로 프로비저닝하며, 프로덕션 인스턴스의 임베디드 CDN 설정 영역 목록과 영역 구성 선택기에 표시됩니다. SCAPI 영역의 경우호스트 이름 추가에 사용 가능한 호스트 이름이 0개 표시됩니다.
- SCAPI 영역에서는 호스트 이름을 추가하거나 제거할 수 없습니다. 호스트 이름과 인증서는 플랫폼에서 관리됩니다.
- 암호화 탭은 읽기 전용입니다. 인증서 테이블에는 인증서 수와 인증서 테이블(호스트 이름, 인증서 상태, 호스트 이름 상태, 만료, 발급자, 서명 및 최소 TLS 버전)이 포함됩니다. 인증서를 업로드, 삭제, 갱신 또는 관리할 수 없습니다. 이 모델은 기본 도메인에 사용되는 것과 동일한 읽기 전용 모델입니다. B2C Commerce의 기본 도메인 지원을참조하십시오.
- 개발, 스테이징 및 프로덕션을 위한 하나의 SCAPI 영역이 있습니다. 추가하는 규칙은 범위를 지정하지 않는 한 세 가지 환경 모두에 적용됩니다. 다른 환경에 영향을 주지 않도록 규칙 표현식의 URL 경로에 있는 조직 ID를 기준으로 모든 규칙의 범위를 지정합니다. Business Manager의 보안 규칙 탭에 경고 배너를 표시하여 이를 상기시킵니다.
- Production 인스턴스에서만 SCAPI 영역을 열고 구성하십시오. 영역은 개발 또는 스테이징의 Business Manager 또는 CDN API에 표시되지 않습니다.
- 일부 규칙은 Salesforce에서 관리되고 잠겨 있습니다. 플랫폼 관리 규칙(예: 사용자 지정, 속도 제한 및 관리형 WAF 검사를 건너뛰는 유효한 MRT(Managed Runtime)에서 SCAPI 트래픽에 대한 허용 목록)은 표시되지만 편집할 수는 없습니다.
SCAPI 영역의 보안 규칙 탭
SCAPI 영역에 액세스
개발, 스테이징 및 프로덕션을 위한 하나의 SCAPI 영역이 있습니다. Salesforce가 영역을 프로비저닝한 후 Production 인스턴스에서 엽니다. 영역은 개발 또는 스테이징의 Business Manager 또는 CDN API에 표시되지 않습니다.
- Business Manager의 Production 인스턴스에서 App Launcher를 클릭한 다음선택합니다.
shortcode.api.commercecloud.salesforce.com> 호스트 이름으로 SCAPI 영역을<찾습니다.- 행의 드롭다운 메뉴를 열고영역 구성을선택합니다.
임베디드 CDN 설정 — 영역 목록의 SCAPI 영역
SCAPI 영역의 Configure Zones(영역 구성) 화면에는Crypto (읽기 전용), Security Rules (사용자 지정 규칙, 속도 제한 규칙, IP 목록, Zone 및 Realm 하위 탭 포함), Analytics (HTTP 및 보안)의 세 가지 탭과캐시 제거버튼이 있습니다. SCAPI 영역에 적용되지 않는 컨트롤은 표시되지 않습니다.
영역 구성 — SCAPI 영역의 암호화 탭
SCAPI 영역에서 사용할 수 있는 컨트롤
Production 인스턴스에서 SCAPI 라우팅 또는 캐싱을 중단하는 구성은 제출 시 명백한 오류와 함께 거부된 후 적용됩니다. SCAPI 영역에 적용되지 않는 컨트롤은 Business Manager에 표시되지 않으며 CDN API 수준에서 거부됩니다.
| Production Business Manager에서 사용 가능 | SCAPI 영역에서는 사용할 수 없습니다. |
|---|---|
| 사용자 지정 규칙(Security Rules(보안 규칙) 탭, Zone Security Rules(영역 보안 규칙) 및 Realm Security Rules(영역 보안 규칙)) | eCDN WAF 관리형 규칙 |
| 속도 제한 규칙(보안 규칙 탭, 영역 보안 규칙) | 상호 TLS(mTLS) |
| IP 액세스 목록(Security Rules(보안 규칙) 탭, Realm Security Rules(영역 보안 규칙)) | TLS 1.3 구성 |
| Analytics - HTTP 및 보안 트래픽 보기 | MRT 라우팅 규칙 |
| 캐시 제거(태그 또는 경로별) | HSTS(HTTP Strict Transport Security) |
| 암호화 탭 — 읽기 전용 인증서 보기 | 호스트 이름 및 인증서 관리 |
이러한 컨트롤은 SCAPI 영역에서도 사용할 수 없습니다. 속도 설정, 공격 모드, 사용자 지정 오류 페이지, Page Shield, 알림, Logpull, Logpush, 호스트 헤더 재정의 및 캐시 규칙(SCAPI 캐싱은 플랫폼에서 관리됨).
SCAPI 영역의 분석 탭
관련 태스크
지원되는 컨트롤에 대한 관리 흐름은 스토어프런트 영역과 일치합니다. 프로시저는 다음을 참조하십시오.
