앱 사용자를 위한 로그인
앱에는 계정 기능이 기본으로 포함됩니다
Kliv로 만든 앱에는 자체 사용자가 있습니다. 제품을 사용하는 쪽의 고객, 구성원, 팀원입니다. 모든 앱에는 해당 사용자를 위한 완전한 로그인 시스템이 처음부터 내장되어 있습니다. 인증 공급자를 연동하거나 비밀번호 저장을 직접 관리할 필요가 없습니다. 로그인할 수 있는 사람을 설명하고 나머지는 Kliv가 처리합니다.
구분해서 알아 두세요. 이 페이지는 앱 사용자에 관한 내용입니다. Kliv에서 함께 앱을 만드는 팀원의 로그인(조직에서 사용하는 엔터프라이즈 SSO 포함)은 별개이며 사용자 관리에서 다룹니다.
로그인 방법
앱 사용자는 다음을 사용하여 로그인할 수 있습니다.
- 이메일 및 비밀번호 — 확인된 이메일 주소가 있는 기존 계정
- Google로 로그인 및 Facebook으로 로그인 — 이미 가지고 있는 계정으로 원클릭 소셜 로그인
- 패스키(WebAuthn) — 기기의 생체 인식 또는 보안 키를 사용하여 비밀번호 없이 로그인
- 2단계 인증(TOTP) — 두 번째 단계로 인증 앱의 시간 기반 코드
앱이 어떤 방법을 제공해야 하는지 대화를 통해 Kliv에 알려주세요. "사용자가 이메일 또는 Google로 가입하고 패스키를 지원하도록 허용"하면 충분합니다.
조직과 역할
사용자는 단순 목록일 필요는 없습니다. 앱 사용자는 조직에 속할 수 있으며 조직 내에서 각 사용자는 역할을 갖습니다. 이는 팀 제품과 B2B 앱의 자연스러운 형태입니다. 회사가 가입하고, 직원을 초대하고, 각 사람이 할 수 있는 일은 자신의 역할에 따릅니다. 필요한 역할을 설명하고 Kliv가 이를 설정합니다.
로그인 및 데이터 액세스
로그인은 단순히 입구를 여는 절차가 아닙니다. 각 사용자가 접근할 수 있는 대상을 결정합니다. 데이터 액세스는 데이터베이스의 행 수준 보안 규칙을 따르므로 로그인한 사용자는 해당 규칙이 허용하는 행만 읽고 씁니다. 행 수준 보안의 작동 방식은 데이터베이스를 참고하세요.
에이전트의 경우에도 마찬가지입니다. 앱에 에이전트가 포함된 경우 사용자의 로그인 상태는 에이전트가 사용자를 대신하여 읽을 수 있는 범위를 지정합니다. 즉, 한 사용자의 질문에 답하는 에이전트는 그 사용자가 직접 볼 수 없는 행을 활용할 수 없습니다. 에이전트와 데이터를 참고하세요.
자체 Google 또는 Facebook 자격 증명 사용
Google 및 Facebook 로그인은 Kliv에서 관리하는 키로 바로 작동하며, 제공업체에 따로 등록할 것이 없습니다. 자체 키 사용은 선택 사항입니다. 자체 키를 사용하면 제공업체의 동의 화면에 Kliv 대신 앱 이름이 표시됩니다.
자체 키를 사용하는 경우, 방문자가 로그인하는 모든 주소에 대해 제공업체에 리디렉션 URI를 등록해야 합니다.
https://<사이트 주소>/api/v2/auth/oauth/<제공업체>/complete
예: https://example.com/api/v2/auth/oauth/google/complete. 주소마다 하나씩 필요합니다. 사용자 지정 도메인마다 하나씩, 그리고 방문자가 사이트의 <사이트-키>.kliv.site 주소를 사용한다면 그 주소에도 하나가 필요합니다. 기본 도메인으로 리디렉션되는 www 주소에는 필요하지 않습니다.
URI를 직접 만들 필요는 없습니다. 사이트 설정 → 소셜 로그인 → 자체 OAuth 자격 증명 사용에 사이트에 맞는 정확한 URI가 복사 버튼과 함께 표시됩니다.
등록 위치:
- Google: Google Cloud Console에서 OAuth 클라이언트를 열고 승인된 리디렉션 URI(Authorized redirect URIs)에 추가하세요. 승인된 JavaScript 원본은 비워 두어도 됩니다.
- Facebook: Meta 개발자 앱에서 Facebook 로그인 설정을 열고 유효한 OAuth 리디렉션 URI(Valid OAuth Redirect URIs)에 추가하세요.
Apple로 로그인은 Kliv에서 관리하는 키만 지원합니다.
미리보기 주소에서는 자체 키로 로그인할 수 없으므로 게시된 사이트에서 테스트하세요.
관련 문서
- 데이터베이스 → — 행 수준 보안 규칙
- 에이전트와 데이터 → — 에이전트가 사용자 액세스를 존중하는 방법
- 사용자 관리 → — 자신의 팀에 대한 로그인 및 역할