eSIM 활성화 코드(LPA)

이동통신사 eSIM 활성화 이메일의 QR은 GSMA SGP.22에 따른 LPA(로컬 프로파일 어시스턴트) 활성화 코드입니다. 폰이 이를 스캔하고 SM-DP+ 서버에 접속하여 암호화된 eSIM 프로파일을 다운로드하고 설치합니다, 고객이 아무것도 입력할 필요 없이.

Canonical spec:GSMA SGP.22, Remote SIM Provisioning Architecture for Consumer Devices v3.0 (current, 2024). The activation-code format is defined in §4.1.1.
Native support: iOS 17.4+ (2024) and Android 13+ (2022) scan these directly from the camera app to provision eSIM profiles.

개요

활성화 코드 페이로드는 $로 구분된 3개 또는 4개 부분으로 구성된 고정 형식 문자열입니다:

LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]

LPA:1, LPA URI 스키마 식별자 + 활성화 코드 버전. 필수 리터럴.
SM-DP+ 주소, 이동통신사 프로비저닝 서버의 FQDN (예: rsp.example.com). https:// 접두사 없음, 호스트명만.
Matching ID, SM-DP+ 서버의 특정 eSIM 프로파일에 활성화 코드를 연결하는 고유 ID (보통 16–32 영숫자).
Confirmation Code(선택사항), 다운로드를 승인하기 위해 사용자가 입력해야 하는 추가 비밀코드. 일부 이동통신사가 활성화 흐름의 두 번째 인증 수단으로 사용.

이것은 형식 전용 예시입니다, 실제 LPA 활성화 코드는 특정 SM-DP+의 특정 프로파일에 연결됩니다. 테스트 벡터는 형식을 인코딩하며 스캔-설치 흐름이 아닙니다.

케이스	입력값	예상 인코딩 문자열
최소 (확인 코드 없음)	`smdp=rsp.example.com code=K2-LM3N4P5Q-R6S7T`	`LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T`
확인 코드 포함	`smdp=rsp.example.com code=K2-LM3N4P5Q-R6S7T confirm=1234`	`LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234`
서브도메인 이동통신사	`smdp=esim.carrier.com code=ABCDEFGH12345678`	`LPA:1$esim.carrier.com$ABCDEFGH12345678`
포팅된 MSISDN 워크플로	`smdp=rsp.smdpplus.example code=PORT-MSISDN-0123456789 confirm=99`	`LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99`

SM-DP+ 필드의 https:// 접두사. SGP.22 §4.1.1은 순수한 FQDN을 요구합니다. 해당 슬롯에서 https://rsp.example.com을 보는 폰은 활성화 코드를 잘못된 형식으로 간주하고 다운로드를 거부합니다.
Matching ID의 $ 문자. Matching ID는 영숫자입니다. 그 안의 $는 필드 구분자와 충돌합니다. Matching ID를 자동 생성하는 이동통신사는 알파벳에서 $를 제외해야 합니다.
일회성 사용 기대. 대부분의 SM-DP+ 서버는 첫 번째 성공적인 프로파일 다운로드 후 Matching ID를 무효화합니다. 고객이 스캔한 후 QR을 다시 공유하면 실패합니다.
프로파일 재다운로드. 고객이 공장 초기화하거나 폰을 바꾸면 이전 QR을 다시 스캔할 수 없습니다. 이동통신사에 연락하여 새 Matching ID와 새 QR을 발급받아야 합니다.
듀얼 SIM 프로비저닝. iOS 17.4+는 8개의 eSIM 프로파일을 보유할 수 있지만 동시에 2개만 사용할 수 있습니다. 스캔 시 OS는 어떤 물리적 SIM 슬롯을 대체할지 묻습니다.
MDM 관리 폰. Apple Business Manager와 Android Enterprise는 QR 단계 없이 프로그래밍 방식으로 eSIM을 프로비저닝할 수 있습니다. 기기 집합이 MDM으로 관리되는 경우 사용자에게 QR 코드를 건네는 대신 API를 사용하세요.

기기 / OS	지원	참고
iOS 17.4+	네이티브	카메라 앱이 LPA 페이로드를 인식하고 eSIM 프로파일 설치를 제안합니다.
iOS 16.x–17.3	설정 > 모바일 데이터 통해 네이티브	카메라 대신 설정 > 모바일 데이터 > eSIM 추가에서 스캔하세요. 카메라 스캔 지원은 17.4에 추가.
Android 13+	네이티브	설정 > 네트워크 및 인터넷 > SIM > eSIM 추가 > QR 스캔.
Android 9–12	OEM별	Samsung Galaxy, Google Pixel, 일부 OnePlus 기기는 카메라 스캔을 지원합니다. 다른 OEM은 설정을 통한 수동 입력이 필요합니다.
Third-party camera apps	네이티브 미지원	QR을 디코딩하지만 eSIM 설치를 트리거하지 않습니다. 사용자가 수동으로 설정에 문자열을 복사해야 합니다.
Older / non-eSIM phones	해당 없음	물리적 eSIM 하드웨어 없음. 페이로드는 디코딩되지만 아무것도 발생하지 않습니다.