개발 정보 관리

📗 APP 가이드

APP 식별을 위한 기본 정보와 API 연동에 필요한 설정을 입력하는 단계입니다.

참고 화면 — 개발 정보 관리

⚠️

탭 이동 전 반드시 저장해 주세요

다른 탭으로 이동 시 저장되지 않은 정보는 초기화됩니다. 반드시 [저장] 버튼을 클릭한 후 이동해 주세요.

기본 정보

메이크샵은 OIDC와 OAuth 2.1 프레임워크를 사용하여 인증을 진행합니다. 아래 기본 정보를 입력하여 APP 인증 환경을 구성하세요.

항목	설명	필수 여부
상품명	APP의 관리용 상품명	필수
APP URL	APP 설치 시 랜딩할 URL. 프로토콜, 포트 지정이 필요한 경우 함께 입력. HTTPS 등록을 권장합니다.	필수
URL 표시 방식	새 창 열기(기본값) 또는 팝업 중 선택	필수
접근 허용 IP	보안을 위해 등록된 IP에서만 쇼핑몰 API에 접근할 수 있습니다. xxx.xxx.xxx.xxx 형식으로 입력하며, 엔터로 구분해 최대 10개까지 입력 가능합니다.	필수

APP이 동작하는 데 필요한 API 권한(Scope)을 설정하는 단계입니다. Scope란 APP이 쇼핑몰 데이터에 접근할 수 있는 범위를 의미하며, 선택한 권한은 APP 설치 시 쇼핑몰 운영자에게 동의 요청으로 표시됩니다.

권한은 Read(읽기)와 Write(쓰기)로 구분되며, APP 기능에 실제로 필요한 항목만 선택해야 합니다. 설정 가능한 전체 권한 항목은 파트너 관리자 > APP 등록 > 개발 정보 관리 화면에서 확인할 수 있습니다.

불필요한 권한을 과도하게 요청하는 경우 심사 단계에서 반려될 수 있습니다. APP 동작과 직접적으로 관련된 권한만 선택하고, 추후 기능 추가로 권한이 필요해지는 경우에는 재심사를 통해 변경할 수 있습니다.

APP 등록 시 인증 정보가 자동으로 생성됩니다. 인증 정보는 APP 연동의 핵심 보안 요소이므로 외부 노출에 주의해 주세요.

항목	설명
유형	Web application (일반) : Authorization Code
Client ID	APP 최초 생성 시 자동 생성됩니다. 복사 버튼으로 확인할 수 있습니다.
Client Secret Key	마스킹 처리된 상태로 제공됩니다. [보기] 버튼으로 확인, [재발급] 버튼으로 교체가 가능합니다.
Service Key	할인/배송 등 특수 기능 제공 시 필요한 무결성 검증용 값입니다.

⚠️

Secret Key 재발급 시 주의사항

재발급은 Key 유출이나 인증 장애가 발생한 경우에만 사용하세요. 재발급 시 기존 Key로 동작 중인 APP 서비스에 영향을 줄 수 있습니다.