configured로 판단합니다.SNS 로그인 | Appbox Android SDK 가이드
Android SDK 연동
SNS 로그인 개요
| 전제 | 내용 |
|---|---|
| 필요 artifact | 제공자별 appbox-auth-* + 초기화 설정의 auth |
| 전제 미충족 시 | 콜백 error로 AppBoxAuthUnavailableException 또는 AppBoxAuthNotConfiguredException → 예외 카탈로그 |
| 웹 브릿지 대응 | application.googleSnsLogin, appleSnsLogin, kakaoSnsLogin, naverSnsLogin, snsLogout |
제공자별 전제는 다음과 같습니다.
| 제공자 | artifact | 추가 전제 |
|---|---|---|
appbox-auth-google | auth 설정의 해당 key | |
| Apple | appbox-auth-apple | provider별 key 없음. auth 설정만 전달하면 configured가 true가 됩니다 (다른 제공자보다 약한 신호) |
| Naver | appbox-auth-naver | auth 설정의 해당 key |
| Kakao | appbox-auth-kakao | key + kakao_scheme 문자열 리소스 + 카카오 Maven 저장소 → 1단계: 저장소 접근 설정 |
initialize에 auth 설정을 아예 넘기지 않으면 Apple을 포함한 모든 제공자의 configured가 false입니다. artifact만으로는 true가 되지 않습니다.
로그인 제공자 목록 조회
로그인 제공자 목록 조회
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
List<AppBoxAuthProviderDescriptor> | 제공자 목록. 동기 함수이며 즉시 반환됩니다 |
[].type | AuthProviderType. GOOGLE, APPLE, NAVER, KAKAO |
[].identifier | "google", "apple", "naver", "kakao" |
[].configured | 로그인에 필요한 key와 설정이 갖춰졌는지 (true | false) |
identifier 문자열로 제공자를 구분합니다. 목록의 순서나 열거형 순번을 사용하지 않습니다. 목록에 포함된다는 것은 artifact를 추가했다는 의미입니다(확인의 사다리 ① 층). configured는 key와 설정 완비(③ 층)를 뜻하며, provider SDK 초기화 성공까지 보장하지 않습니다. 실제 동작은 signIn 결과로 확인합니다.
로그인
로그인
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| type | 필수 | AuthProviderType. GOOGLE, APPLE, NAVER, KAKAO | - |
| activity | 필수 | 로그인 화면을 표시할 foreground Activity | - |
| callback | 필수 | AppBoxValueCallback<UserAuthData> | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
user | UserAuthData. 실패 시 null |
user.uid | 사용자 식별자 |
user.email, user.displayName, user.photoURL | 프로필 정보. 비어 있을 수 있습니다 |
user.token | Google, Apple에서 제공 |
user.accessToken, user.refreshToken | Kakao, Naver에서 제공 |
| 오류 | AuthCancelledException: 사용자가 로그인 화면을 닫음. 정상 취소이며 오류가 아닙니다(제공자 오류): provider SDK가 전달한 실패. 미설정 제공자 호출 포함 |
token 값을 로그나 분석 도구에 남기지 않습니다. callback은 최대 한 번 호출됩니다.
웹 브릿지에서는 제공자별 application.{provider}SnsLogin입니다.
제공자 로그아웃
제공자 로그아웃
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| type | 필수 | 로그아웃할 제공자 | - |
| callback | 필수 | AppBoxOperationCallback | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
success | 로그아웃 처리 성공 여부 (true | false) |
해당 제공자가 configured 상태여야 합니다. 설정하지 않은 제공자를 로그아웃하면 오류입니다.
웹 브릿지에서는 SNS 로그아웃의 application.snsLogout입니다.
모든 제공자 로그아웃
모든 제공자 로그아웃
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| callback | 필수 | AppBoxOperationCallback | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
success | 전체 로그아웃 성공 여부 (true | false) |
초기화된 제공자가 하나도 없으면 즉시 성공을 반환합니다. 판정 기준은 로그인 세션 보유 여부가 아니라 provider 초기화 여부이므로, 성공이 곧 실제 세션 해제를 뜻하지 않습니다. 반대로 로그인한 적이 없어도 초기화된 제공자가 있으면 그 제공자의 로그아웃이 실제로 호출되고 실패가 보고될 수 있습니다. 모든 제공자 처리가 끝난 뒤 첫 번째 오류만 보고합니다. 어느 제공자가 실패했는지 구분해야 하면 제공자 로그아웃을 각각 호출합니다.
웹 브릿지에서는 SNS 로그아웃의 application.snsLogout입니다.