> 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-1.md).

# 사용자 관리

쇼핑몰 운영 사용자를 관리하기 위한 사용자 관리 기능을 제공하는 서비스입니다. 사용자 정보, 사용자 조직(부서), 권한 그룹, 개별 권한에 대한 편리한 관리를 지원합니다.

***

## 주요 기능

* **사용자 정보 관리**
  * 사용자 목록을 조회하고, 사용자의 상세 정보를 확인하며 등록 및 수정이 가능합니다.
  * 사용자는 다양한 부서와 권한 그룹에 속할 수 있습니다.
* **사용자 조직(부서) 관리**
  * 부서를 조회하고, 새로운 부서를 등록하며, 기존 부서를 수정 및 삭제할 수 있습니다.
* **권한 그룹 관리**
  * 다양한 그룹에 대한 권한을 조회하고, 권한을 부여하거나 해제할 수 있습니다.
  * 각 그룹은 백오피스, 고객센터, 파트너 등 큰 그룹으로 구분됩니다.
* **개별 권한 관리**
  * 각 사용자에 대해 개별적인 권한을 부여하거나 해제할 수 있습니다.
  * 사용자마다 세밀한 권한 조정이 가능합니다.

## 프로세스 정의 — 사용자 정보 및 조직 관리

사용자 정보를 조회하고 사용자를 등록하거나 수정할 수 있습니다.

사용자 조직(부서)을 조회하고 부서를 등록하거나 수정, 삭제할 수 있습니다.

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

{% stepper %}
{% step %}

### 사용자 목록 조회

사용자 목록을 조회합니다.
{% endstep %}

{% step %}

### 사용자 상세 정보 조회

사용자 목록 조회 후 사용자를 선택하여 사용자 수정 팝업이 열리며 해당 사용자에 상세 정보를 조회할 수 있습니다.
{% endstep %}

{% step %}

### 사용자 등록/수정 팝업

사용자를 등록/수정할 수 있습니다.\
권한 그룹 조회, 부서 목록 조회, 협력사 목록 조회는 각각의 팝업을 통해 이루어집니다.\
사용자를 등록할 때 사용자 아이디 개수 조회 API를 통해 아이디 중복체크를 진행해야 합니다.\
사용자 수정에서 사용자의 비밀번호 잠김을 해제와 비밀번호 초기화를 할 수 있습니다. 비밀번호 초기화 시 비밀번호는 인코딩된 랜덤한 값으로 변경되며 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다.
{% endstep %}

{% step %}

### 사용자 정보 DB

사용자를 등록/수정 합니다. 권한그룹이 협력사일 경우 협력사 번호는 필수로 입력되어야 합니다.\
사용자 수정 시 사용여부 로그, 개인정보취급여부 로그, 업무그룹변경 로그, 권한그룹변경 로그 이력을 저장합니다.
{% endstep %}

{% step %}

### 부서 계층구조 목록 조회

부서 계층 구조를 조회하며 각각의 부서의 하위 부서를 조회하고 등록, 수정, 삭제합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의 — 권한 그룹 및 개별 권한 관리

권한 그룹 목록을 조회해 관리합니다. 각 권한에 맞는 메뉴를 조회하고 해당 메뉴에 있는 버튼 권한을 조회하여 버튼 권한을 관리합니다.

사용자 개별 권한 목록을 조회합니다. 개별 사용자의 메뉴권한을 조회하고 해당 메뉴의 버튼 권한을 조회해 관리합니다.

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

{% stepper %}
{% step %}

### 권한 그룹 목록 조회

권한 그룹 목록을 조회하고 등록하거나 수정합니다.
{% endstep %}

{% step %}

### 메뉴 트리 목록 조회

그룹에 맞는 메뉴권한 목록을 트리구조로 조회하고 메뉴 권한 사용여부를 수정합니다. 메뉴 정보 관리에 있는 API를 사용합니다.
{% endstep %}

{% step %}

### 권한 그룹 버튼 목록 조회

해당 메뉴에 맞는 버튼 권한 목록을 조회합니다. 권한을 부여하거나 해제합니다.
{% endstep %}

{% step %}

### 개별 권한 목록 조회

개별 권한 목록을 조회하고 등록하거나 수정합니다.
{% endstep %}

{% step %}

### 메뉴 권한 목록 조회 (개별 사용자)

개별 사용자의 메뉴 권한을 트리구조로 조회하고 메뉴 권한 사용 여부를 수정합니다. 메뉴 권한 사용 여부 수정은 메뉴 정보 관리에 있는 API를 사용합니다.
{% endstep %}

{% step %}

### 권한 그룹 버튼 목록 조회 (개별 사용자)

해당 메뉴에 맞는 버튼 권한 목록을 조회합니다. 권한을 부여하거나 해제합니다.
{% endstep %}
{% endstepper %}

***

## API 기능 목록 — 사용자 정보 관리

<table><thead><tr><th width="127.888916015625">API</th><th width="253.888916015625">설명</th><th width="92.4444580078125">Server</th><th width="91.5555419921875">메소드</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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getUserListInUserMenu">🔗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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getUserListInUserMenuCount">🔗API 확인하기 ></a></td></tr><tr><td>사용자 정보 조회</td><td>사용자의 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EC%95%8C%EB%A6%BC%EB%A9%94%EC%8B%9C%EC%A7%80&#x26;path=sendMessage">🔗API 확인하기 ></a> 화면에서는 사용하지 않고 타 서비스 혹은 API에 제공합니다.</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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getUserDetail">🔗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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getUserCount">🔗API 확인하기 ></a></td></tr><tr><td>비밀번호 잠김 해제</td><td>비밀번호가 잠김 처리된 사용자를 잠김 해제 처리합니다.</td><td>BO</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EC%95%8C%EB%A6%BC%EB%A9%94%EC%8B%9C%EC%A7%80&#x26;path=sendMessage">🔗API 확인하기 ></a></td></tr><tr><td>비밀번호 <br>초기화</td><td>사용자의 비밀번호를 임의 값으로 초기화하고 변경된 비밀번호는 사용자의 휴대폰 번호로 알림톡이 발송됩니다. *알림메시지 단건 전송:/api/common/v1/common/sendMessage</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=modifyInitializePassword">🔗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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveUser">🔗API 확인하기 ></a></td></tr><tr><td>사용자 권한<br>그룹 목록 조회</td><td>사용자 권한그룹 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getUserRightGroupInfo">🔗API 확인하기 ></a></td></tr><tr><td><p>사용자 권한</p><p>그룹 목록 건수 조회</p></td><td>사용자 권한그룹 목록 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%82%AC%EC%9A%A9%EC%9E%90%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getUserRightGroupListCount">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## API 기능 목록 — 사용자 조직 관리

<table><thead><tr><th width="132.3333740234375">API</th><th width="275.22216796875">설명</th><th width="98">Server</th><th width="91.333251953125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>부서 계층구조 목록 조회</td><td>현재 저장되어 있는 부서 목록을 <br>계층 구조로 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%82%AC%EC%9A%A9%EC%9E%90%20%EC%A1%B0%EC%A7%81%20%EA%B4%80%EB%A6%AC&#x26;path=getUserDeptListWithHierarchy">🔗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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A1%B0%EC%A7%81%20%EA%B4%80%EB%A6%AC&#x26;path=getUserDeptList">🔗API 확인하기 ></a></td></tr><tr><td>하위 부서 목록 건수 조회</td><td>하위 부서 목록 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EC%95%8C%EB%A6%BC%EB%A9%94%EC%8B%9C%EC%A7%80&#x26;path=sendMessage">🔗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%82%AC%EC%9A%A9%EC%9E%90%20%EC%A1%B0%EC%A7%81%20%EA%B4%80%EB%A6%AC&#x26;path=saveUserDeptList">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## API 기능 목록 — 권한 그룹 관리

<table><thead><tr><th width="111.22216796875">API</th><th width="287.888916015625">설명</th><th width="93.5555419921875" align="center">Server</th><th width="93.5555419921875" align="center">메소드</th><th>비고</th></tr></thead><tbody><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=%EA%B6%8C%ED%95%9C%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getRightGroupBaseList">🔗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=%EA%B6%8C%ED%95%9C%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getRightGroupBaseListCount">🔗API 확인하기 ></a></td></tr><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=%EA%B6%8C%ED%95%9C%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=saveRightGroupBaseList">🔗API 확인하기 ></a></td></tr><tr><td>권한 그룹 버튼<br>권한 저장</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=%EA%B6%8C%ED%95%9C%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=saveRightTargetBaseMenu">🔗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=%EA%B6%8C%ED%95%9C%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getRightGroupButtonList">🔗API 확인하기 ></a></td></tr><tr><td>대시보드 <br>권한그룹 <br>조회</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=%EA%B6%8C%ED%95%9C%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getRtInfo">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## API 기능 목록 — 개별 권한 관리

<table><thead><tr><th width="103.4444580078125">API</th><th width="291">설명</th><th width="94.6666259765625" align="center">Server</th><th width="90.111083984375" align="center">메소드</th><th>비고</th></tr></thead><tbody><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=%EA%B0%9C%EB%B3%84%20%EA%B6%8C%ED%95%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getIndividualRightList">🔗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=%EA%B0%9C%EB%B3%84%20%EA%B6%8C%ED%95%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getDisplayTemplateListCount">🔗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=%EA%B0%9C%EB%B3%84%20%EA%B6%8C%ED%95%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getIndividualMenuTreeList">🔗API 확인하기 ></a></td></tr><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=%EA%B0%9C%EB%B3%84%20%EA%B6%8C%ED%95%9C%20%EA%B4%80%EB%A6%AC&#x26;path=saveIndividualRightList">🔗API 확인하기 ></a></td></tr><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=%EA%B0%9C%EB%B3%84%20%EA%B6%8C%ED%95%9C%20%EA%B4%80%EB%A6%AC&#x26;path=saveIndividualRightButtonGridList">🔗API 확인하기 ></a></td></tr></tbody></table>

***