> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/system-bo/undefined.md).

# 개인 관리

사용자는 편리한 즐겨찾기 관리와 안전한 비밀번호 변경을 수행할 수 있으며, 시스템 관리자는 로그 이력을 통해 보안성을 강화할 수 있습니다.

## 주요 기능

* **즐겨찾기 목록 관리**
  * 관리자 시스템에서 사용자의 즐겨찾기 목록을 효과적으로 관리합니다.
* **비밀번호 변경**
  * 사용자는 자체 비밀번호를 변경할 수 있으며, 이를 통해 보안성을 강화합니다.
* **로그인/로그아웃 이력 관리**
  * 관리자 시스템에서 사용자의 로그인 및 로그아웃 이력을 생성하고 관리합니다.
  * 로그인 관련 유효성을 체크하여 보안성을 강화합니다.

***

## 프로세스 정의 — 즐겨찾기 관리 및 비밀번호 변경

관리자 시스템 사용자의 즐겨찾기 목록과 비밀번호 변경을 진행합니다.

<figure><img src="/files/4HLD8Mpw0qMXlZNZOOA5" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 즐겨찾기 그룹 목록 조회

사용자가 즐겨찾기를 등록한 목록과 건수를 조회합니다.
{% endstep %}

{% step %}

### 즐겨찾기 그룹 목록 수정/삭제

사용자의 즐겨찾기 목록을 수정 또는 삭제합니다.
{% endstep %}

{% step %}

### 기존 비밀번호 일치 확인

비밀번호 변경을 위한 유효성 체크를 진행합니다.

* 변경할 비밀번호가 기존 비밀번호와 일치하면 변경 불가능합니다.
* 변경할 비밀번호가 최근 비밀번호를 사용하면 변경 불가능합니다.
  {% endstep %}

{% step %}

### 비밀번호 변경

유효성 체크에 통과 시 비밀번호를 변경 처리합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의 — 관리자 시스템 접속 관리

관리자 시스템에 로그인, 로그아웃 할 수 있습니다.

<figure><img src="/files/TB16HwLGfyQtWrEugzmm" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 아이디 조회

최근 사용일시가 3개월이 넘으면 아이디를 잠금 처리합니다.

로그인 시 입력한 아이디, 비밀번호로 존재하는 사용자 계정을 조회합니다.

조회한 사용자 계정에 대한 유효성 체크를 진행합니다.
{% endstep %}

{% step %}

### 계정 비밀번호 실패횟수 증가 처리

아이디·비밀번호로 조회한 사용자 계정이 존재하지 않을 경우 아이디의 비밀번호 실패횟수를 증가시킵니다.
{% endstep %}

{% step %}

### 로그인 이력 생성

사용자 계정에 대한 로그인 이력을 생성합니다.
{% endstep %}

{% step %}

### 계정 비밀번호 실패횟수 초기화 처리

로그인에 성공 시 비밀번호 실패횟수를 0으로 초기화합니다.
{% endstep %}

{% step %}

### 비밀번호 변경

아이디·비밀번호로 조회한 사용자 계정이 비밀번호를 변경한 지 3개월이 넘었을 때 비밀번호 변경 팝업으로 이동합니다.

* 비밀번호 변경 시 변경할 비밀번호가 최근 비밀번호와 일치하는지, 현재 비밀번호와 일치하는지 체크합니다.
  {% endstep %}

{% step %}

### 비밀번호 초기화

관리자 시스템 메인에서 비밀번호를 초기화할 수 있습니다.

* 초기화 시 입력한 아이디와 휴대폰 번호로 유효 사용자인지 확인합니다.
* 초기화 후 초기화된 비밀번호를 알림톡으로 전송합니다.
* 비밀번호 변경 이력을 생성합니다.
  {% endstep %}

{% step %}

### 로그아웃 이력 생성

로그아웃을 하면 로그아웃 이력을 생성합니다.
{% endstep %}
{% endstepper %}

***

## API 기능 목록 — 즐겨찾기 관리

<table><thead><tr><th width="142.3333740234375">API</th><th width="302.111083984375">설명</th><th width="93.5555419921875">Server</th><th width="92.4444580078125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>즐겨찾기 그룹 목록 건수 조회</td><td>사용자의 즐겨찾기 그룹 목록 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%A6%90%EA%B2%A8%EC%B0%BE%EA%B8%B0%20%EA%B4%80%EB%A6%AC&#x26;path=getUserFavoriteMenuListCount">🔗API 확인하기 ></a></td></tr><tr><td>즐겨찾기 그룹 목록 조회</td><td>사용자의 즐겨찾기 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%A6%90%EA%B2%A8%EC%B0%BE%EA%B8%B0%20%EA%B4%80%EB%A6%AC&#x26;path=getUserFavoriteMenuList">🔗API 확인하기 ></a></td></tr><tr><td>즐겨찾기 그룹 목록 수정/삭제</td><td>사용자의 즐겨찾기 목록을 수정, 삭제합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%A6%90%EA%B2%A8%EC%B0%BE%EA%B8%B0%20%EA%B4%80%EB%A6%AC&#x26;path=saveUserFavoriteMenu">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## API 기능 목록 — 비밀번호 변경

<table><thead><tr><th width="100.111083984375">API</th><th width="254.3333740234375">설명</th><th width="92.111083984375" align="center">Server</th><th width="94.4443359375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>비밀번호 변경</td><td>사용자 비밀번호를 변경합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%B9%84%EB%B0%80%EB%B2%88%ED%98%B8%20%EB%B3%80%EA%B2%BD&#x26;path=changePassword">🔗API 확인하기 ></a></td></tr><tr><td>최근 비밀번호 일치 확인</td><td>변경할 비밀번호가 최근 비밀번호와 일치한지 확인합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%B9%84%EB%B0%80%EB%B2%88%ED%98%B8%20%EB%B3%80%EA%B2%BD&#x26;path=checkRecentPassword">🔗API 확인하기 ></a></td></tr><tr><td>기존 비밀번호 일치 확인</td><td>변경할 비밀번호가 기존 비밀번호와 일치한지 확인합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%B9%84%EB%B0%80%EB%B2%88%ED%98%B8%20%EB%B3%80%EA%B2%BD&#x26;path=checkCurrentPassword">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## API 기능 목록 — 로그인

<table><thead><tr><th width="147.888916015625">API</th><th width="293.3333740234375">설명</th><th width="93.5556640625" align="center">Server</th><th width="91.3333740234375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>로그인 이력 생성</td><td>로그인 후 로그인 이력을 생성합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updateStLoginLog">🔗API 확인하기 ></a></td></tr><tr><td>로그아웃 이력 생성</td><td>로그아웃 후 로그아웃 이력을 생성합니다.</td><td align="center">BO</td><td align="center">PUT</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updateStLoginLog">🔗API 확인하기 ></a></td></tr><tr><td>비밀번호 초기화</td><td>비밀번호를 초기화합니다.</td><td align="center">BO</td><td align="center">PUT</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=initializePasswordOnLogin">🔗API 확인하기 ></a></td></tr><tr><td>비밀번호 변경</td><td>비밀번호를 변경합니다.</td><td align="center">BO</td><td align="center">PUT</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updatePasswordByPasswordInitialize">🔗API 확인하기 ></a></td></tr><tr><td>아이디 잠금 처리</td><td>사용자 아이디를 잠금 처리 합니다.</td><td align="center">BO</td><td align="center">PUT</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updateIdLockYnCheck">🔗API 확인하기 ></a></td></tr><tr><td>계정 비밀번호 <br>실패횟수 초기화 처리</td><td>사용자 비밀번호 실패횟수를 초기화합니다.</td><td align="center">BO</td><td align="center">PUT</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updateLoginSuccess">🔗API 확인하기 ></a></td></tr><tr><td>계정 비밀번호 <br>실패횟수 증가 <br>처리</td><td>사용자 비밀번호 실패횟수를 증가 처리 합니다.</td><td align="center">BO</td><td align="center">PUT</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updateLoginFailCntAdd">🔗API 확인하기 ></a></td></tr><tr><td>존재하는 아이디 조회</td><td>존재하는 아이디인지 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="http://apibo.x2bee.com/content?bo=system&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=updateLoginFailCntAdd">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## 기타 참고 사항

* 로그인 시 유효성 체크
  * x2bee-bo 프로젝트의 properties 파일 "loginFailCount" 보다 계정 로그인 실패횟수가 많으면 로그인 불가
  * 아이디/비밀번호로 조회된 계정 없으면 로그인 불가
  * 접근허용 IP(사용자 IP 주소와 접근한 IP가 서로 다른 경우) 가 아니면 로그인 불가
  * 사용 시작일자와 사용 종료일자에 충족하지 않으면 로그인 불가
  * 최근 로그인 시점이 3개월 이상이면 로그인 불가 (비밀번호 변경 팝업으로 이동)
  * 잠금처리된 계정 로그인 불가

***