SLAS 프라이빗 클라이언트 사용

SLAS(Shopper Login and API Access) API 클라이언트를 사용하면 애플리케이션에서 구매자를 인증하고 승인할 수 있습니다. SLAS 클라이언트는 퍼블릭과 프라이빗의 두 가지 유형으로 제공됩니다.

SLAS 프라이빗 클라이언트는 퍼블릭 클라이언트에 비해 다음과 같은 몇 가지 이점을 제공합니다.

  • 게스트 구매자가 매장에 대한 액세스를 요청할 수 있는 권한을 사전에 부여하여 페이지 로드 시간을 단축합니다.
  • 암호 없는 로그인 및 암호 재설정을 포함하여 SLAS 퍼블릭 클라이언트에서 사용할 수 없는 기능을 사용할 수 있습니다. 프라이빗 SLAS 클라이언트 사용 사례를 참조하십시오.

SLAS 프라이빗 클라이언트를 활용하려면 프로젝트에서 클라이언트 암호를 안전하게 저장할 수 있어야 합니다.

프로젝트가 클라이언트 측에서 실행되고 SLAS와 직접 통신해야 하는 경우 퍼블릭 클라이언트를 사용하는 것이 좋습니다.

PWA Kit 3.5 이상은 SLAS 퍼블릭 및 프라이빗 클라이언트의 사용을 모두 지원합니다.

PWA Kit 3.5 이전의 모든 PWA 버전은 SLAS 퍼블릭 클라이언트만 지원합니다.

SLAS 퍼블릭 클라이언트를 사용하는 기존 PWA Kit 사이트가 있는 경우 계속 읽고 퍼블릭 클라이언트로 전환하는 것을 고려하십시오.

이 가이드의 명령을 실행하기 전에 Placeholder를 실제 값으로 바꿉니다. Placeholder는 $PLACEHOLDER와 같은 형식입니다.

프라이빗 클라이언트로 작업할 때는 클라이언트 비밀 정보가 구매자 및 클라이언트 측 브라우저에 노출되지 않도록 주의해야 합니다.

클라이언트 비밀 정보를 보호하기 위해 PWA Kit Retail React App는 환경 변수를 사용하여 비밀 정보를 서버 측에 저장합니다. 클라이언트 비밀 정보를 저장하는 방법에 대한 자세한 내용은 환경 변수 설정을 참조하십시오.

개략적으로 설명하면, 다음을 수행하여 PWA Kit 사이트에서 SLAS 프라이빗 클라이언트를 설정합니다.

  • SLAS 프라이빗 클라이언트 생성
  • PWA Kit 구성
  • 환경 변수 설정

먼저 구매자 API 승인 및 API 액세스 설정의 지침을 완료하여 SLAS 프라이빗 클라이언트를 생성합니다.

SLAS 프라이빗 클라이언트를 생성한 후 아래의 단계에 따라 PWA Kit 사이트에서 사용합니다.

  1. PWA Kit v3.5 이상으로 업데이트합니다.
  2. ssr.js에서 runtime.createHandler에 전달되는 옵션의 useSLASPrivateClient 속성을 true로 설정합니다.
  3. _app-config/index.js에서 <CommerceAPIProvider>의 enablePWAKitPrivateClient 속성을 true로 설정합니다.
  4. PWA Kit 구성 파일에서 commerceAPI clientId를 SLAS 프라이빗 클라이언트 ID로 설정합니다.
  5. 사용자 환경에서 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수를 SLAS 프라이빗 클라이언트 암호로 설정합니다.
  1. PWA Kit 구성 파일에서 commerceAPI clientId를 SLAS 프라이빗 클라이언트 ID로 설정합니다.
  2. 사용자 환경에서 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수를 SLAS 프라이빗 클라이언트 암호로 설정합니다.

다음 명령을 실행하여 활성 명령 프롬프트에서 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수를 로컬로 설정합니다.

  • Mac/Unix에서는 export PWA_KIT_SLAS_CLIENT_SECRET=$YOUR_CLIENT_SECRET을 실행합니다.
  • Windows에서는 set PWA_KIT_SLAS_CLIENT_SECRET=$YOUR_CLIENT_SECRET을 실행합니다.

로컬 개발 환경에서는 새 명령 프롬프트를 열 때 자동으로 포함되도록 PWA_KIT_SLAS_CLIENT_SECRET을 더 영구적으로 설정할 수 있습니다.

Mac/Unix에서는 컴퓨터의 .bashrc 파일에서 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수를 설정하여 이 작업을 수행할 수 있습니다. Windows에서는 제어판 -> 시스템 -> 고급 -> 환경 변수를 통해 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수를 설정하여 이 작업을 수행할 수 있습니다.

Managed Runtime에서 원격으로 PWA Kit 사이트를 실행하는 경우 환경에 맞게 변수를 바꾼 후 터미널에서 다음 명령을 실행하여 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수를 설정할 수 있습니다.

Managed Runtime API 키 및 원격 환경의 기타 속성을 가져오는 방법에 대한 자세한 내용은 푸시 및 배포 번들 가이드를 참조하십시오.

자세한 내용은 환경 변수를 참조하십시오.

위에서 설명한 PWA Kit 설정 단계 외에도, PWA Kit와 SFRA를 모두 사용하는 단계별 출시 스토어프런트에서 SLAS 프라이빗 클라이언트를 사용하도록 플러그인 SLAS를 업데이트할 수 있습니다. SFRA와 연동되도록 SLAS 프라이빗 클라이언트를 설정하는 방법에 관한 지침은 플러그인 SLAS Readme를 참조하십시오.

암호 없는 로그인과 같은 프라이빗 클라이언트가 필요한 다른 SLAS 엔드포인트를 사용하도록 PWA Kit 구현을 확장하는 경우 runtime.createHandler에 applySLASPrivateClientToEndpoints 옵션을 사용하여 사용 가능한 엔드포인트 세트를 확장할 수 있습니다.

  • SLAS /authorize에 대한 HTTP 400 호출이 표시되면 PWA Kit 사이트에서 프라이빗 클라이언트 ID와 함께 SLAS 퍼블릭 클라이언트 흐름을 사용하고 있는 것입니다. _app-config/index.js 파일에서 CommerceAPIProvider 내부의 enablePWAKitPrivateClient 속성을 true로 설정합니다.

  • 로컬 개발 환경에서는 ssr.js에 useSLASPrivateClient 속성이 활성화되어 있고 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수가 설정되지 않은 경우 PWA Kit 서버가 시작되지 않습니다. 계속하려면 환경 변수를 SLAS 클라이언트 비밀 정보로 설정합니다.

  • PWA Kit 사이트를 Managed Runtime에 배포한 후 SLAS를 호출할 때 HTTP 501 오류가 표시되면 PWA_KIT_SLAS_CLIENT_SECRET 환경 변수가 설정되지 않았음을 의미할 수 있습니다. 설정 후 변경 사항이 적용될 때까지 몇 분 정도 기다리십시오.