9.1 KiB
9.1 KiB
title, description, sidebar_position
| title | description | sidebar_position |
|---|---|---|
| Tenant 설정 | ABC User Feedback의 테넌트 정보, 로그인 방식, 사용자 관리 등 조직 전체에 영향을 주는 설정을 관리하는 방법을 안내합니다. | 1 |
Tenant 설정
테넌트 설정은 ABC User Feedback의 최상위 관리 기능으로, 조직 전체에 영향을 주는 중요한 설정들을 다룹니다. 이 문서에서는 테넌트 정보 관리, 로그인 방식 설정, 전체 사용자 관리 방법을 설명합니다.
주의: 이 설정들은 Super Admin 권한을 가진 사용자만 접근할 수 있습니다.
Tenant 설정
테넌트는 조직의 최상위 단위로, 모든 프로젝트와 사용자가 포함되는 범위입니다.
접근 방법
- 우측 상단 메뉴에서 Home 아이콘을 클릭합니다
- 좌측 메뉴에서 Tenant Information을 선택합니다
수정 가능한 항목
| 항목 | 설명 | 수정 가능 여부 | 예시 |
|---|---|---|---|
| ID | 테넌트 고유 식별자 (시스템 자동 생성) | ❌ 수정 불가 | 1 |
| Name | 테넌트 이름 (조직명, 회사명 등) | ✅ 수정 가능 | ABC Company |
| Description | 테넌트 설명 (선택사항) | ✅ 수정 가능 | 고객 피드백 관리 시스템 |
정보 수정 방법
- Name 또는 Description 필드를 수정합니다
- 우측 상단의 Save 버튼을 클릭합니다
- 저장 완료 시 성공 메시지가 표시됩니다
테넌트 이름은 로그인 UI에 표시될 수 있습니다.
로그인 설정
사용자가 시스템에 접근할 때 사용할 인증 방식을 설정합니다.
접근 방법
- 우측 상단 메뉴에서 Home 아이콘을 클릭합니다
- 좌측 메뉴에서 Login Management를 선택합니다
지원하는 로그인 방식
1. 이메일 로그인
기본적으로 제공되는 이메일 + 비밀번호 조합 방식입니다.
특징:
- 별도 설정 없이 기본 활성화
- 사용자 초대 → 이메일 인증 → 비밀번호 설정 순서
- 비밀번호 재설정 기능 제공
비밀번호 정책:
- 최소 8자 이상
- 영문자, 숫자, 특수문자 포함 권장
- 연속 문자 금지 (예:
aa,11)
2. Google 로그인
Google OAuth 2.0을 통한 소셜 로그인 방식입니다.
설정 방법:
- Google 로그인 활성화: 토글을 ON으로 전환합니다
- Google Cloud Console 설정이 필요합니다:
참고: Google OAuth 연동의 상세한 구현 방법은 OAuth 연동 가이드를 참조하세요.
3. 커스텀 OAuth 로그인
자체 OAuth 서버나 다른 OAuth 제공자를 사용하는 방식입니다.
설정 항목:
| 항목 | 설명 | 예시 |
|---|---|---|
| Provider Name | 로그인 버튼에 표시될 이름 | Microsoft로 로그인 |
| Client ID | OAuth 클라이언트 ID | abc123xyz |
| Client Secret | OAuth 클라이언트 시크릿 | supersecret |
| Auth URL | 인증 요청 URL | https://auth.example.com/oauth2/auth |
| Token URL | 토큰 요청 URL | https://auth.example.com/oauth2/token |
| User Info URL | 사용자 정보 요청 URL | https://auth.example.com/oauth2/userinfo |
| Scope | 요청할 권한 범위 | openid email profile |
| Email Key | 사용자 정보에서 이메일 필드명 | email |
설정 순서:
- 각 필드에 OAuth 서버 정보를 입력합니다
- Save 버튼을 클릭하여 저장합니다
- 로그인 화면에서 설정된 Provider Name으로 버튼이 표시됩니다
로그인 방식 조합
여러 로그인 방식을 동시에 활성화할 수 있습니다:
- 이메일만: 기본 로그인 폼만 표시
- 이메일 + Google: 로그인 폼 + "Google로 로그인" 버튼
- 이메일 + 커스텀: 로그인 폼 + 커스텀 OAuth 버튼
로그인 설정 테스트
설정 변경 후 반드시 테스트를 진행하세요:
- 브라우저 시크릿 모드로 로그인 페이지 접속
- 설정한 로그인 방식들이 정상 표시되는지 확인
- 각 방식으로 실제 로그인 테스트 수행
사용자 관리
테넌트 전체 사용자를 중앙에서 통합 관리하는 기능입니다.
접근 방법
- 우측 상단 메뉴에서 Home 아이콘을 클릭합니다
- 좌측 메뉴에서 User Management를 선택합니다
사용자 목록 조회
표시되는 정보
| 컬럼 | 설명 | 표시 예시 |
|---|---|---|
| 로그인 계정 이메일 | user@company.com |
|
| Name | 사용자 이름 (프로필 기준) | 김사용자 |
| Department | 소속 부서 | 개발팀 |
| Type | 사용자 유형 | SUPER / GENERAL |
| Project | 접근 가능한 프로젝트 목록 | 프로젝트A, 프로젝트B |
| Created | 계정 생성일시 | 2024-03-15 14:30 |
사용자 유형 설명
| 유형 | 설명 | 권한 범위 |
|---|---|---|
SUPER |
모든 프로젝트 및 설정 접근 가능. 전체 시스템 관리자 역할 | 테넌트 전체 |
GENERAL |
지정된 프로젝트에만 접근 가능 | 특정 프로젝트만 |
사용자 검색 및 필터링
대량의 사용자가 있을 때 원하는 사용자를 빠르게 찾을 수 있습니다.
필터 기능
상단의 Filter 버튼을 클릭하여 조건을 설정합니다.
필터 조건:
- Email: 이메일 주소로 검색
- Name: 사용자 이름으로 검색
- Department: 부서명으로 검색
연산자 옵션:
- CONTAINS: 포함하는 경우
- IS: 정확히 일치하는 경우
사용자 초대
새로운 사용자를 시스템에 초대합니다.
초대 방법
- 우측 상단의 Invite User 버튼을 클릭합니다
- 초대 정보를 입력합니다
| 항목 | 설명 | 선택 사항 |
|---|---|---|
| 초대할 사용자의 이메일 주소 | 필수 입력 | |
| Type | 사용자 유형 | GENERAL / SUPER |
| Project | 접근 허용할 프로젝트 | 프로젝트 목록에서 선택 |
| Role | 해당 프로젝트에서의 역할 | Admin / Editor / Viewer |
- Invite 버튼을 클릭하여 초대를 완료합니다
초대 후 프로세스
- 초대된 사용자에게 이메일이 발송됩니다
- 사용자가 이메일의 링크를 클릭하여 가입 절차를 진행합니다
- 가입 완료 후 지정된 프로젝트에 자동으로 추가됩니다
사용자 정보 수정
기존 사용자의 정보와 권한을 수정할 수 있습니다.
수정 방법
- 사용자 목록에서 수정하려는 사용자를 클릭합니다
- Edit User 팝업이 열립니다
수정 가능한 항목
| 항목 | 수정 가능 여부 | 설명 |
|---|---|---|
| ❌ 수정 불가 | 계정 식별자로 변경 불가 | |
| Type | ✅ 수정 가능 | GENERAL ↔ SUPER 변경 가능 |
저장 및 적용
- 필요한 정보를 수정합니다
- Save 버튼을 클릭합니다
- 변경사항이 즉시 적용되며, 해당 사용자의 다음 로그인부터 반영됩니다
사용자 삭제
더 이상 시스템을 사용하지 않는 사용자를 삭제할 수 있습니다.
삭제 방법
- 사용자 수정 팝업에서 하단의 Delete 버튼을 클릭합니다
- 확인 대화상자에서 삭제를 승인합니다
삭제 시 주의사항
- 복구 불가능: 삭제된 사용자 계정은 되돌릴 수 없습니다
- 접근 권한 즉시 제거: 삭제 즉시 모든 시스템 접근이 차단됩니다
관련 문서
- 프로젝트 관리 - 프로젝트별 멤버 및 권한 관리
- OAuth 연동 가이드 - OAuth 설정의 기술적 구현 방법
- API 연동 - API를 통한 사용자 관리 방법