변경 이력

서버와 연동 가이드의 변경 사항입니다. 연동 서비스에 영향이 있는 변경은 굵게 표시하며, 등록된 담당자에게 별도로 안내합니다.

최종 확인 2026-10-02

---

예정

항목	연동 서비스 영향
소셜 로그인 prod 반영	로그인 화면에 버튼이 추가됩니다. 연동 코드 영향은 없습니다
화면 · 메일 문구의 명칭 표기를 "MBOX 통합회원"으로 변경	연동 코드 영향은 없습니다

2026-10-02

• 전환 · 가입 요청(prompt=create)에서 통합회원 세션이 있으면 계정 확인 화면을 표시합니다. 이전에는 전환 화면을 생략하고 세션 계정으로 진행했습니다. 공용 기기에 남은 다른 사용자의 통합회원이 현재 회원에 연결되는 것을 막기 위한 변경입니다. 사용자는 "이 계정으로 계속" · "다른 계정으로 로그인" · "새로 가입" 중 하나를 선택합니다. 연동 서비스의 요청과 콜백 처리는 변경되지 않습니다. stage 에 반영되었습니다. — 활용하기 › 기존 회원 연결

2026-10-01

• 연동 가이드의 서비스 명칭을 MBOX 통합회원(줄여서 통합회원)으로 통일했습니다. 기존 문서의 "멤버십" · "통합 회원"과 같은 대상입니다. 프로토콜, 주소, 클레임은 변경되지 않았습니다.
• stage 계정 관리 화면(/account)에 카카오 · Google · Apple 로그인이 추가되었습니다. 간편 로그인으로만 가입한 사용자도 연결 해제와 탈퇴를 직접 수행할 수 있으며, 비밀번호가 없는 계정은 탈퇴 시 계정 이메일을 다시 입력해 확인합니다. 연동 코드 영향은 없습니다.
• stage 가입 화면의 인증 코드 입력 단계에 "인증 코드 다시 받기"가 추가되었습니다. 발송 횟수 제한은 기존과 같습니다. 연동 코드 영향은 없습니다.

2026-09-30

• 연동 가이드의 문서 구성을 변경했습니다. 이해하기 · 설정하기 · 활용하기 · REST API · 문제 해결 · 변경 이력으로 구성됩니다. 기존 시작하기 · 로그인 구현 · 회원 연결 · 로그아웃과 토큰 · 앱 문서는 설정하기와 활용하기로, 오류와 점검은 문제 해결로 통합했으며, 샘플 클라이언트 문서는 삭제했습니다. 기존 문서 주소를 저장한 경우 새 주소로 변경해야 합니다.
• 기존 회원 연결 기준을 명시했습니다. sub 로 조회되지 않은 사용자는 이메일 또는 연동 서비스 회원가입 입력 정보로 기존 계정을 조회하고, 해당 계정으로 로그인한 후에만 연결해야 합니다(활용하기 › 기존 회원 연결).
• 인가 요청에 login_hint 없이 prompt=create 를 추가하면 통합회원 가입 화면이 표시됩니다. 연동 서비스의 회원가입 버튼에 사용합니다. login_hint 를 포함한 기존 회원 전환은 변경되지 않았습니다.
• stage 로그인 화면의 비밀번호 찾기가 계정 찾기로 변경되었습니다. 입력한 이메일로 가입된 계정이 있으면 가입 수단과 비밀번호 재설정 링크를 메일로 발송합니다. 연동 코드 영향은 없습니다.
• stage 테스트 계정은 제공하지 않습니다. stage 로그인 화면에서 직접 가입하여 사용합니다.
• 통합회원은 가입 시 본인인증을 수집하지 않습니다. 명의 휴대폰이 없는 사용자도 가입할 수 있도록 하기 위함입니다.

2026-09-29

• stage 로그인 화면에 카카오 · Google · Apple 로그인이 추가되었습니다. 연동 서비스가 전달받는 값(sub, email, email_verified)과 연동 코드는 변경되지 않습니다.
• 머니박스에서 전환한 계정은 사용자가 이메일을 확인하기 전까지 email_verified 가 false 입니다. 이메일로 기존 회원을 조회하는 경우 email_verified 를 반드시 확인해야 합니다.

2026-09-28

• client_secret 은 만료 기한과 정기 교체 주기가 없습니다. 분실 · 노출 시에만 재발급하며, 재발급 즉시 기존 값은 무효가 됩니다. 이전에 안내한 "24시간 병행 유효"는 취소합니다.
• 통합회원 화면은 전체 페이지 이동으로 여는 것을 기본으로 합니다. 팝업은 권장하지 않으며, iframe 은 차단됩니다(X-Frame-Options: DENY).
• 클라이언트 신청 항목을 클라이언트 등록 · 법무 및 운영 · 사전 파악으로 구분했습니다. prod 클라이언트는 법무 및 운영 항목이 모두 확인된 후 발급합니다.

2026-09-27

• 서비스에 처음 연결할 때 표시되는 화면을 두 가지로 구분합니다. 통합회원과 다른 법인의 서비스에는 제3자 제공 동의 화면(거부 가능), 같은 법인의 서비스에는 안내 화면(거부 버튼 없음)이 표시됩니다. 연동 서비스에는 항상 동의 화면이 표시되므로 연동 코드 영향은 없습니다.
• 사용자의 서비스 연결 해제를 모든 서비스에 허용합니다. 해제 후 다시 로그인하면 동의 화면을 거쳐 같은 sub 가 전달됩니다.

2026-09-26

• 사용자 표시 이름을 "머니박스 ID"에서 **"MBOX 통합회원"**으로 변경했습니다. 통합회원 화면, 메일, 로그인 버튼 문구가 변경됩니다. 프로토콜, 주소, 클레임은 변경되지 않았습니다.

2026-09-25

• stage(https://stage-membership.m-box.com)를 개방했습니다. stage 데이터는 예고 없이 초기화될 수 있습니다.
• 통합회원 로그아웃을 요청한 서비스의 액세스 · 리프레시 토큰을 통합회원이 함께 폐기합니다. 사용자가 로그아웃과 로그인 유지 중 어느 쪽을 선택해도 동일하며, 다른 서비스의 토큰에는 영향이 없습니다.
• 인증 코드와 비밀번호 재설정 메일은 no-reply@m-box.com 에서 발송됩니다.

2026-09-24

변경	연동 서비스 영향
클라이언트 인증은 client_secret_post 만 지원합니다	HTTP Basic 헤더로 토큰 · 폐기를 요청하면 401 invalid_client 가 반환됩니다. 요청 본문 방식으로 변경해야 합니다
디스커버리에서 PAR 항목 제거	디스커버리 정보가 실제 지원 범위와 일치합니다
prompt=create 지원	기존 회원 전환 화면을 사용할 수 있습니다
로그아웃 확인 화면, post_logout_redirect_uri 등록	로그아웃 후 복귀 주소를 지정할 수 있으며, 등록된 값만 허용됩니다
연결 해제 · 탈퇴 시 토큰 무효화	토큰 갱신은 400 invalid_grant, 사용자 정보 조회는 401 invalid_token 을 반환합니다
계정 관리 화면(/account)	사용자가 비밀번호 변경 · 재설정, 연결 해제, 탈퇴를 직접 수행합니다
로그인 실패 시 IP 차단 시간 증가	같은 IP 에서 1분에 5회 실패 시 1분 차단되며, 반복 시 최대 60분까지 증가합니다

2026-09-23

• 연동 가이드 1판을 게시했습니다. 이메일 · 비밀번호 로그인, 회원가입(인증 코드), 제3자 제공 동의, Authorization Code + PKCE, pairwise sub, 리프레시 토큰 교체, 토큰 폐기를 지원합니다.