사용자 관리
Security365 관리센터의 사용자 관리 메뉴에서는 조직 내 사용자의 등록, 조회, 수정, 삭제 등 전반적인 사용자 라이프사이클을 관리할 수 있습니다.
목차
기본 기능
-
사용자 조회 및 검색 - 기본 조회, 검색, 미접속 기간 필터
사용자 등록 및 관리
-
사용자 등록 - 수동 등록, 일괄등록, 계정 동기화
보안 및 계정 관리
백업 및 복원
- 백업 및 복원 - 백업 생성, 복원, 자동 백업
참고 자료
1. 화면 구성
사용자 관리 화면은 세 개의 주요 탭으로 구성됩니다.
사용자 목록 탭
사용자를 조회, 검색, 필터링하고 일괄등록을 수행할 수 있는 메인 화면입니다.
관리 이력 탭
사용자 목록 관련 작업의 이력을 조회할 수 있는 화면입니다.
백업 및 복원 탭
사용자·그룹 데이터의 백업 목록 조회, 수동 백업 생성, 특정 시점으로의 복원(롤백)을 수행할 수 있는 화면입니다.
2. 사용자 조회 및 검색
기본 조회
사용자 목록 탭에서 등록된 모든 사용자의 정보를 확인할 수 있습니다.
확인 가능한 정보:
- 이름
- 이메일
- 아이디
- 그룹
- 할당된 라이선스
- 활성화 여부
- 연동 정보 (Microsoft, SCI Server, Google 등)
- 마지막 접속
- 수정된 날짜
마지막 접속 컬럼은 기존 "활성화 여부" 컬럼과 "수정된 날짜" 컬럼 사이에 위치하며, 각 사용자의 가장 최근 접속 시각을 상대적 시간 형식으로 표시합니다.
| 경과 시간 범위 | 표시 형식 | 예시 |
|---|---|---|
| 1시간 미만 | N분 전 | 23분 전 |
| 24시간 미만 | N시간 전 | 3시간 전 |
| 30일 미만 | N일 전 | 14일 전 |
| 30일 이상 | 날짜 표시 | 2025-12-01 |
| 접속 이력 없음 | - | - |
- 컬럼 값에 마우스 오버 시 정확한 접속 일시(예:
2026-02-19 09:22:15)를 표시합니다. - 컬럼 클릭으로 오름차순/내림차순 정렬이 가능하며, 접속 이력이 없는 사용자("-")는 정렬 시 최하단에 위치합니다.
검색 기능
화면 우측 상단의 검색창에서 이름, 아이디 또는 그룹으로 사용자를 검색할 수 있습니다.
필터 기능
미접속 기간 필터
특정 기간 이상 접속하지 않은 사용자를 필터링하여 조회할 수 있습니다. 프리셋 옵션을 선택하거나 직접 일수를 입력할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| 선택 안함 (기본값) | 필터 미적용, 전체 목록 표시 |
| 7일 이상 | 최근 7일간 접속하지 않은 사용자 |
| 30일 이상 | 최근 30일간 접속하지 않은 사용자 |
| 60일 이상 | 최근 60일간 접속하지 않은 사용자 |
| 90일 이상 | 최근 90일간 접속하지 않은 사용자 |
| 직접 입력 | 1 이상의 정수 입력 후 [적용] 버튼 클릭 (소수점·음수·0 입력 불가) |
- 필터가 적용된 상태에서는 상단에 필터 상태 배지가 표시됩니다. (예:
미접속 30일 이상: 12명 [필터 해제 X]) - [필터 해제 X] 클릭 시 필터가 초기화되고 전체 목록으로 복귀합니다.
- 미접속 기간 필터는 기존 검색 및 활성화 상태 필터 조건과 AND 조건으로 결합됩니다.
- 필터가 적용된 상태에서 [다운로드] 버튼 클릭 시 필터링된 목록만 다운로드되며, 다운로드 파일에 마지막 접속 컬럼이 포함됩니다.
활성화 관리
검색창 좌측의 활성화 관리 버튼을 통해 전체 또는 검색된 사용자에 대하여 사용자 활성화/비활성화를 설정 할 수 있습니다.
테이블 커스터마이징
화면 우측 상단의 톱니바퀴 아이콘을 클릭하여 테이블 칼럼을 사용자 맞춤 설정할 수 있습니다.
- 체크박스로 표시할 칼럼 선택
- 드래그 앤 드롭으로 칼럼 순서 변경
3. 사용자 리스트 다운로드
사용자 정보를 CSV 파일로 다운로드할 수 있습 니다.
다운로드 옵션
다운로드버튼을 클릭하여 사용자 리스트를 CSV 파일로 다운로드할 수 있습니다.- 전체 다운로드: 현재 표시된 모든 사용자 정보를 다운로드합니다.
- 선택 다운로드: 체크박스로 선택한 사용자들의 정보만 다운로드합니다.
- CSV 파일에는 이름, 아이디, 이메일, 연동 정보, 할당된 라이선스, 활성화 여부, 생성일이 포함됩니다.
- 활성화 여부는 Active/Inactive로 표시됩니다.
- 여러 값이 있는 경우 세미콜론(;)으로 구분됩니다.
4. 사용자 등록
사용자를 등록하는 방법은 수동 등록과 동기화 방식으로 나뉩니다.
수동 사용자 등록
Security365 관리센터에서 직접 사용자를 생성하는 방법입니다.
개별 사용자 등록
진입 방법:
- 사용자 목록 탭 상단의
+사용자 등록버튼 클릭 - 사용자 정보 입력 폼 표시
입력 항목:
- 이름 (필수)
- 이메일 (필수)
- 아이디 (선택)
- 미입력 시 이메일 주소로 자동 설정됩니다.
- 그룹 (선택)
- 사용자가 소속될 그룹을 선택할 수 있습니다.
- 활성화 여부
- 활성화/비활성화 옵션 선택이 가능합니다.
- 비활성화 시 사용자는 Security365서비스를 이용할 수 없습니다.
등록 절차:
- 필수 항목 입력
- 하단의
저장버튼 클릭 - 등록 완료 후 사용자의 이메일로 임시 비밀번호 자동 발송
사용자 일괄등록
여러 사용자를 CSV 파일을 통해 한 번에 등록하는 방법입니다.
진입 방법:
- 사용자 목록 탭 상단의
일괄등록버튼 클릭 - 사용자 일괄등록 슬라이드 오픈
일괄등록 프로세스:
Step 1: CSV 파일 준비
- 슬라이드의 CSV 템플릿 다운로드
- 템플릿 파일에 사용자 정보 입력
CSV 파일 형식:
UserName,Email,UserId,GroupIdList,ActiveStatus
홍길동,hong@example.com,hong@example.com,dept_001 dept_002,ACTIVE
김철수,kim@example.com,kim@example.com,dept_003,INACTIVE
컬럼 설명:
| 컬럼 | 필수 | 설명 | 예시 |
|---|---|---|---|
| UserName | O | 사용자 이름 | 홍길동 |
| O | 이메일 주소 (이메일 형식 필수) | hong@example.com | |
| UserId | O | 사용자 고유 ID (이메일 형식) | hong@example.com |
| GroupIdList | - | 소속 그룹 ID (공백으로 구분) | dept_001 dept_002 |
| ActiveStatus | - | 활성화 상태 (기본값: ACTIVE) | ACTIVE 또는 INACTIVE |
참고: GroupIdList는 그룹 관리 메뉴에서 등록한 그룹의 ID를 입력합니다.
Step 2: CSV 파일 업로드
- 작성한 CSV 파일을 드래그 앤 드롭 또는
파일 선택버튼으로 업로드 - CSV 파일을 검증하여 정상/오류 항목에 대한 데이터를 표시합니다.
- 오류 항목의 경우 다운로드하여 어떤 행에 어떤 오류가 발생했는지 확인할 수 있습니다.
- 한 행에 여러 오류가 있는 경우 세미콜론(;)으로 구분하여 표시됩니다.
- 처리 옵션 선택을 선택합니다.
CSV에 없는 기존 사용자 처리 방법 선택:
-
비활성화: CSV 파일에 포함되지 않은 기존 사용자를 자동으로 비활성화합니다.
- 퇴사자 등 더 이상 시스템을 사용하지 않는 사용자를 일괄 정리할 때 유용합니다.
- 예: 시스템에 10만 명이 있고 CSV에 9만 명만 있는 경우, 누락된 1만 명을 비활성화합니다.
-
유지: 기존 사용자의 상태를 그대로 유지합니다.
- 첫 동기화 시 또는 일부 사용자만 업데이트할 때 권장됩니다.
- 예: 신규 입사자만 CSV에 추가하여 등록하는 경우
-
정상 항목(유효한 데이터)에 대해 일괄등록을 이어서 진행하려면
등록버튼을 클릭합니다. -
등록 진행상태가 토스트 메시지로 안내되며, 작업이 완료된 경우
관리 내역탭에서 결과를 확인 할 수 있습니다. -
관리 내역 상세 보기:
- 완료 토스트의
관리 내역 상세 보기버튼 클릭 또는 - 관리 내역 탭에서 해당 작업 행 클릭
확인 가능한 정보:
- 등록 파일명
- 타입
- 실행자 (이름, 이메일)
- 상태: 등록중 / 일부 등록 / 등록 완료 / 등록 미처리
- 원본 파일 다운로드
- 처리 결과 통계
- 전체 건수
- 성공 건수 (신규 생성, 업데이트, 변경 없음, 비활성화, 유지)
- 등록 미처리 항목 (시스템 오류로 인해 등록에 실패한 항목)
- CSV 오류 항목 (CSV파일에 오류가 있는 경우 표시)
처리 결과 CSV 형식:
UserName,Email,UserId,GroupIdList,ActiveStatus,STATUS,CHANGED_FIELDS
홍길동,hong@example.com,hong@example.com,dept_001,ACTIVE,CREATED,
김철수,kim@example.com,kim@example.com,dept_002,ACTIVE,UPDATED,email groupIdList
이영희,lee@example.com,lee@example.com,dept_003,ACTIVE,UNCHANGED,
| STATUS | 설명 |
|---|---|
| CREATED | 신규 생성된 사용자 |
| UPDATED | 정보가 업데이트된 사용자 (CHANGED_FIELDS에 변경된 필드명 표시) |
| UNCHANGED | 변경사항이 없는 사용자 |
오류 발생 시 CSV 형식:
UserName,Email,UserId,GroupIdList,ActiveStatus,STATUS,ERROR
홍길동,,user1@domain.com,dept_001,ACTIVE,FAILED,EMAIL_REQUIRED
김철수,dup@example.com,dup@example.com,dept_002,ACTIVE,FAILED,DUPLICATE_EMAIL
⚠️ 일괄등록 시 주의사항
중복 처리:
- CSV 파일 내의 사용자와 이미 등록된 사용자의 이메일 정보가 일치하는 경우, CSV 파일 내의 정보로 업데이트됩니다.
- CSV 파일 내에서 동일한 UserId나 Email이 중복되는 경우 해당 행은 등록되지 않습니다.
필수 정보:
- UserName, Email, UserId는 반드시 입력되어야 합니다.
- 필수 정보가 누락된 경우 해당 행은 등록되지 않습니다.
비동기 처리:
- 대용량 CSV 파일(수만~수십만 건)의 경우 백그라운드에서 처리됩니다.
- 작업이 진행되는 동안 다른 메뉴를 사용할 수 있습니다.
- 단, 동시에 하나의 일괄등록 작업만 실행할 수 있습니다.
동시 실행 제한:
- 회사당 하나의 CSV 동기화 작업만 동시에 실행할 수 있습니다.
- 작업이 진행 중일 때
일괄등록을 추가로 진행하려고 하면 비활성화 안내 팝업이 표시됩니다.
계정 동기화 방식
외부 시스템의 계정을 동기화하여 사용자를 추가할 수 있습니다.
Microsoft 365 계정 동기화
조직 내 Microsoft 365 사용자를 자동으로 동기화할 수 있습니다.
설정 방법:
설정 > 계정 동기화 설정메뉴 이동- Microsoft 365 동기화 활성화
- Azure AD 연동 설정
- 동기화 실행
SCI Server 계정 동기화
SCI Server 사용자를 자동으로 동기화할 수 있습니다.
설정 방법:
설정 > 계정 동기화 설정메뉴 이동- SCI Server 동기화 활성화
- SCI Server 연동 설정
- 동기화 실행
사용자 등록 완료
임시 비밀번호 발송:
- 사용자 추가(개별, 일괄 등록) 시 등록된 사용자의 이메일로 임시 비밀번호가 자동으로 전송됩니다.
- 사용자는 이메일에 포함된 임시 비밀번호로 첫 로그인 후 비밀번호를 변경할 수 있습니다.
로그인 및 초기 설정:
- 이메일로 전송된 임시 비밀번호 확인
- Security365 로그인 페이지에서 임시 비밀번호로 로그인
- 최초 로그인 시 비밀번호 변경 화면 표시
- 새 비밀번호 설정 완료
5. 사용자 상세 정보 조회 및 편집
상세 정보 조회
진입 방법: 사용자 목록에서 확인하고자 하는 사용자를 클릭하면 상세 정보 슬라이드가 오픈됩니다.
사용자 정보 수정
수정 절차:
- 변경할 정보 수정
- 하단의
저장버튼 클릭 - 수정 완료 확인
수정 가능 항목:
- 이름
- 이메일
- 아이디
- 그룹 및 대표그룹
- 활성화 여부
- 메모 (최대 200자, 자유 입력 가능)
비활성화 사유 (읽기 전용)
계정이 비활성 상태인 경우, "활성화 여부" 항목 하단에 비활성화 사유 필드가 자동으로 표시됩니다. 이 필드는 시스템이 자동으로 기록하며 관리자가 직접 수정할 수 없습니다.
| 사유 유형 | 화면 표시 텍스트 |
|---|---|
| 미사용 계정 자동 비활성화 | 미사용 계정 자동 비활성화 (N일 이상 미접속) |
| CSV 동기화에 의한 비활성화 | CSV 동기화에 의해 비활성화됨 |
| 관리자 수동 비활성화 | 관리자에 의해 비활성화됨 |
| 사유 없음 | - |
- 계정이 다시 활성화되면 비활성화 사유가 초기화됩니다.
- 메모 필드는 계정 활성/비활성 상태와 무관하게 항상 표시되며, 관리자가 자유롭게 입력·수정할 수 있습니다. 비어있을 경우
-로 표시됩니다.
동기화 계정 수정 시 주의사항:
- Azure AD 동기화로 추가된 사용자도 수정 가능합니다.
- 단, 재동기화 시 Azure AD의 정보로 덮어씌워집니다.
- 동기화 계정의 정보를 영구적으로 변경하려면 원본 시스템(Azure AD, SCI Server 등)에서 수정해야 합니다.
연동 계정 해제
SCI Server 계정이 잘못 연동되어 있는 경우 연동을 해제할 수 있습니다.
해제 방법:
- 사용자 상세 화면에서 연동 정보 확인
- 연동 계정 우측의
삭제버튼 클릭 - 확인 팝업에서
확인클릭 - 연동 해제 완료
6. 사용자 활성화 관리
활성화된 사용자만 Security365 서비스를 이용할 수 있습니다. 비활성화된 사용자는 서비스에 접근할 수 없습니다.
개별 활성화 설정
방법: 사용자 목록에서 각 사용자 행의 활성화 토글을 클릭하여 개별적으로 활성화 여부를 변경할 수 있습니다.
일괄 활성화 설정
방법:
- 사용자 목록에서 변경할 사용자들을 체크박스로 선택
- 화면 상단에 [활성화 관리] 버튼을 이용하여
사용자 활성화또는사용자 비활성화체크 후 [적용] 클릭 - 선택한 모든 사용자의 활성화 여부 일괄 변경
활용 예시:
- 신규 입사자 여러 명을 동시에 활성화
- 퇴사자 여러 명을 동시에 비활성화
7. 사용자 비밀번호 초기화
Security365 관리센터에서는 사용자 비밀번호를 초기화하는 두 가지 방법을 제공합니다.
이메일을 통한 비밀번호 초기화
사용자가 직접 비밀번호를 설정할 수 있도록 이메일로 비밀번호 재설정 링크를 발송하는 방법입니다.
초기화 절차:
- 비밀번호 초기화가 필요한 사용자를 체크박스로 선택 (복수 선택 가능)
- 화면 상단의
비밀번호 초기화(이메일)버튼 클릭 - 확인 팝업에서
확인클릭 - 선택된 사용자의 이메일로 비밀번호 설정 링크 발송
이메일 링크 유효기간:
- 링크는 발송 후 10분간 유효합니다.
- 유효기간 만료 시 재발송이 필요합니다.
동기화 계정 주의사항:
- Microsoft, SCI Server, Google 등 외부 시스템과 동기화된 계정의 경우 Security365 내부 비밀번호만 초기화됩니다.
- 외부 시스템의 비밀번호는 변경되지 않습니다.
사용자 비밀번호 재설정 절차:
- 이메일에서 비밀번호 재설정 링크 클릭
- 비밀번호 재설정 페이지 접속
- 새 비밀번호 입력 및 확인
- 비밀번호 재설정 완료
관리자가 직접 임시 비밀번호 생성
관리자가 즉시 임시 비밀번호를 생성하여 사용자에게 전달하는 방법입니다.
초기화 절차:
- 비밀번호 초기화가 필요한 사용자를 선택 (단일 선택)
- 목록 상단의 체크 옵션에서
비밀번호 초기화(이메일)또는비밀번호 초기화(생성)버튼 클릭- 비밀번호 초기화(이메일) :
- 해당 사용자의 이메일로 임시 비밀번호가 발송됩니다.
- 비밀번호 초기화(생성) :
- 생성된 임시 비밀번호가 포함된 결과 화면 표시
- 임시 비밀번호를 복사하여 해당 사용자에게 안전하게 전달
- 비밀번호 초기화(이메일) :
- [확인] 버튼 클릭
사용자 첫 로그인:
- 임시 비밀번호로 로그인한 사용자는 최초 1회 비밀번호를 변경해야합니다.
8. 사용자 삭제
더 이상 필요하지 않은 사용자 계정을 시스템에서 완전히 제거할 수 있습니다.
삭제 방법
개별 삭제:
- 삭제할 사용자를 체크박스로 선택
- 화면 상단의
사용자 삭제버튼 활성화 확인 사용자 삭제버튼 클릭- 삭제 확인 팝업에서
확인클릭 - 사용자 삭제 완료
일괄 삭제:
- 삭제할 여러 사용자를 체크박스로 선택
- 화면 상단의
사용자 삭제버튼 클릭 - 삭제 확인 팝업에서
확인클릭 - 선택한 모든 사용자 삭제 완료
삭제 시 주의사항
⚠️ 데이터 복구 불가:
- 삭제된 사용자 정보는 복구할 수 없습니다.
- 삭제 전 반드시 데이터 백업 또는 비활성화 처리를 검토하세요.
권장사항:
- 퇴사자의 경우 즉시 삭제보다는 비활성화 처리를 권장합니다.
- 감사 및 규정 준수를 위해 일정 기간 비활성 상태로 유지 후 삭제를 고려하세요.
9. 백업 및 복원
사용자·그룹 데이터를 특정 시점으로 저장(백업)하고, 문제 발생 시 해당 시점으로 되돌릴(복원) 수 있는 기능입니다. CSV 동기화 등으로 데이터가 잘못 변경되었을 때 안전하게 이전 상태로 복구할 수 있습니다.
백업은 사용자와 그룹 데이터를 항상 함께 생성합니다. 사용자 또는 그룹 단독 백업은 지원하지 않습니다.
백업 목록 화면
백업 및 복원 탭을 선택하면 생성된 백업 목록이 표시됩니다.
확인 가능한 정 보:
| 컬럼 | 설명 |
|---|---|
| 생성 일시 | 백업이 생성된 날짜 및 시각 |
| 구분 | 수동 (관리자가 직접 생성) / 자동 (시스템이 복원 직전 자동 생성) |
| 사용자 | 해당 백업 시점의 사용자 레코드 수 |
| 그룹 | 해당 백업 시점의 그룹 레코드 수 |
| 상태 | 복원 가능 / 생성 중 / 생성 실패 / 복원 중 |
백업 최대 보관 수: 수동·자동 구분 없이 전체 합산 최대 10개까지 보관됩니다. 10개 초과 시 가장 오래된 백업부터 자동 삭제됩니다.
백업 생성
현재 사용자·그룹 데이터 상태를 수동으로 백업합니다.
생성 방법:
- 백업 및 복원 탭 상단의
+ 백업 생성버튼 클릭 - 확인 팝업에서
백업 생성버튼 클릭 - 백업이 목록에 추가되며 생성이 완료되면 상태가 복원 가능으로 변경됩니다.
CSV 동기화 중에는 백업 생성이 불가능합니다. 동기화 완료 후 다시 시도하세요.
복원
백업 목록에서 원하는 시점을 선택하여 현재 데이터를 해당 시점으로 되돌립니다.
복원 방법:
- 백업 목록에서 복원할 시점의 행에 마우스를 올리면
복원버튼이 표시됩니다. 복원버튼 클릭 시 복원 확인 팝업이 표시됩니다.- 팝업에서 변경 내역을 확인한 후
복원하기버튼을 클릭하면 복원이 시작됩니다.
복원 확인 팝업
복원 실행 전 현재 데이터와의 차이를 미리 확인할 수 있습니다.
팝업에서 확인 가능한 정보:
- 복원할 백업 시점: 선택한 백업의 생성 일시
- 변경 내역 미리보기: 현재 건수와 복원 진행 후 건수를 사용자/그룹별로 비교 표시
- 예: 현재 사용자 15,200건 → 복원 후 15,000건 (-200건), 현재 그룹 17,750건 → 복원 후 17,950건 (+200건)
- 괄호 안의 숫자는 현재 대비 증감 건수를 나타냅니다.
⚠️ 복원 시 현재 데이터가 해당 백업 시점으로 되돌아가며, 이 작업은 취소할 수 없습니다.
자동 백업 (복원 전)
복원을 실행하면 복원 직전 현재 상태가 자동으로 백업됩니다. 이 백업이 목록의 구분 컬럼에 자동으로 표시됩니다.
- 자동 백업은 회사당 1개만 유지되며, 새로운 복원 실행 시 기존 자동 백업을 덮어씁니다.
- 복원이 잘못됐을 때 이 자동 백업을 이용해 복원 이전 상태로 다시 되돌릴 수 있습니다.
복원 시 주의사항
⚠️ 복원 전 반드시 확인하세요:
- 복원은 현재 운영 데이터 전체를 선택한 백업 시점으로 교체합니다.
- 복원 작업은 완료 후 취소할 수 없습니다.
- CSV 동기화가 진행 중인 경우 복원을 시작할 수 없습니다. 동기화 완료 후 다시 시도하세요.
- 복원 실패 시 현재 운영 데이터는 변경되지 않습니다.
10. CSV 검증 오류 코드
CSV 파일 업로드 시 발생할 수 있는 오류 코드와 해결 방법입니다.
파일 레벨 오류
파일 전체가 거부되어 등록이 불가능한 오류입니다.
| 오류 코드 | 오류 이름 | 설명 | 해결 방법 |
|---|---|---|---|
| 2700 | CSV_FILE_UPLOAD_REQUIRED | CSV 파일이 업로드되지 않음 | CSV 파일을 선택하여 업로드하세요 |
| 2701 | CSV_PARSE_ERROR | CSV 파싱 중 예외 발생 | CSV 파일 형식을 확인하세요 (쉼표 구분, 따옴표 처리 등) |
| 2702 | CSV_ENCODING_UNSUPPORTED | 지원하지 않는 인코딩 | 파일을 UTF-8 인코딩으로 저장 후 다시 업로드하세요 |
| 2703 | CSV_HEADER_MISMATCH | 헤더 불일치 | 필수 헤더(UserName, Email, UserId)가 포함되어 있는지 확인하세요 |
| 2705 | CSV_FILE_EMPTY | 빈 파일 | 데이터가 포함된 CSV 파일을 업로드하세요 |
| 2706 | CSV_FILE_SIZE_LIMIT_EXCEEDED | 파일 크기 초과 (100MB) | 파일을 100MB 이하로 분할하여 업로드하세요 |
| 2707 | CSV_FILE_SIZE_UNEXPECTED_EXCEPTION | 파일 크기 조회 중 예외 발생 | 파일을 다시 저장 후 업로드해보세요 |
| 2708 | CSV_FILE_SAVE_FAILED | 파일 저장 실패 | 잠시 후 다시 시도하세요 |
| 2709 | CSV_FILE_NOT_FOUND | 파일을 찾을 수 없음 | 파일을 다시 업로드하세요 |
| 2710 | CSV_FILE_DELETE_FAILED | 파일 삭제 실패 | 시스템 관리자에게 문의하세요 |
| 2711 | CSV_FILE_INVALID_TYPE | 잘못된 파일 타입 | CSV 파일인지 확인하세요 (.csv 확장자) |
데이터 검증 오류
CSV 파일 내 개별 행에서 발생하는 오류입니다. 오류가 있는 행은 제외되고 나머지는 정상 처리됩니다.
| 오류 코드 | 설명 | 해결 방법 |
|---|---|---|
| USER_ID_REQUIRED | UserId 값 누락 | UserId 컬럼에 사용자 ID를 입력하세요 (이메일 형식) |
| USER_NAME_REQUIRED | UserName 값 누락 | UserName 컬럼에 사용자 이름을 입력하세요 |
| EMAIL_REQUIRED | Email 값 누락 | Email 컬럼에 이메일 주소를 입력하세요 |
| USER_ID_INVALID | UserId가 이메일 형식이 아님 | UserId를 올바른 이메일 형식으로 수정하세요 (예: user@domain.com) |
| EMAIL_INVALID | Email이 이메일 형식이 아님 | Email을 올바른 이메일 형식으로 수정하세요 |
| DUPLICATE_ID | CSV 내부에 동일한 UserId 중복 | 중복된 UserId를 제거하거나 고유한 값으로 변경하세요 |
| DUPLICATE_EMAIL | CSV 내부에 동일한 Email 중복 | 중복된 Email을 제거하거나 고유한 값으로 변경하세요 |
| CSV_RECORD_SIZE_MISMATCH | 헤더와 데이터 컬럼 수 불일치 | 각 행의 컬럼 개수가 헤더와 일치하는지 확인하세요 |
작업 실행 오류
작업 실행 시 발생하는 시스템 레벨 오류입니다.
| 오류 코드 | 오류 이름 | 설명 | 해결 방법 |
|---|---|---|---|
| 2712 | SYNC_JOB_NOT_FOUND | 작업을 찾을 수 없음 | 작업 ID를 확인하세요 |
| 2713 | SYNC_JOB_ID_FORMAT_INVALID | 잘못된 작업 ID 형식 | 올바른 작업 ID를 사용하세요 |
| 2714 | SYNC_JOB_ALREADY_REQUESTED | 동시 요청 (락 충돌) | 이전 요청이 완료될 때까지 기다리세요 |
| 2715 | SYNC_JOB_ALREADY_RUNNING | 이미 실행 중 | 현재 실행 중인 작업이 완료될 때까지 기다리세요 |
비밀번호 정책 오류
비밀번호 초기화 시 발생할 수 있는 오류입니다.
| 오류 코드 | 오류 이름 | 설명 | 해결 방법 |
|---|---|---|---|
| 2800 | PASSWORD_POLICY_NOT_FOUND | 비밀번호 정책 미설정 | 관리자가 비밀번호 정책을 설정해야 합니다 |
| 2801 | PASSWORD_POLICY_DISABLED | 비밀번호 정책 비활성화 | 관리자가 비밀번호 정책을 활성화해야 합니다 |
| 2802 | PASSWORD_POLICY_INVALID_FORMAT | 비밀번호 정책 형식 오류 | 관리자에게 문의하여 정책 설정을 확인하세요 |
| 2803 | DEFAULT_PASSWORD_DISABLED | 기본 비밀번호 사용 비활성화 | 관리자가 기본 비밀번호를 활성화해야 합니다 |
| 2804 | DEFAULT_PASSWORD_EMPTY | 기본 비밀번호 미설정 | 관리자가 기본 비밀번호를 설정해야 합니다 |
| 2805 | DEFAULT_PASSWORD_INVALID_FORMAT | 기본 비밀번호 형식 오류 | 관리자에게 문의하세요 |
| 2806 | DEFAULT_PASSWORD_DECRYPT_FAILED | 기본 비밀번호 복호화 실패 | 관리자에게 문의하세요 |