> 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개월 이상이면 로그인 불가 (비밀번호 변경 팝업으로 이동)
  * 잠금처리된 계정 로그인 불가

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/back-office/system-bo/undefined.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.