> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ko/user-and-project-management/user-management.md). # 사용자 관리 ## 관리자 사용자 생성 Overleaf Toolkit 배포: {% code title="Overleaf Toolkit" overflow="wrap" %} ```bash $ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com" ``` {% endcode %} 레거시 docker-compose.yml 배포: {% code title="레거시 docker-compose" overflow="wrap" %} ```bash $ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com" ``` {% endcode %} 이 명령은 제공된 이메일 주소를 가진 사용자가 아직 없으면 해당 사용자를 생성하고 관리자 권한을 부여합니다. 명령 출력에는 이 사용자의 비밀번호를 설정하고 처음 로그인할 수 있는 방문 URL이 포함됩니다. {% hint style="info" %} 프로그램 방식으로 처리하려면 동일한 스크립트를 사용하여 관리자뿐 아니라 일반 사용자도 생성할 수 있습니다. 일반 사용자의 경우 --admin 플래그를 생략하세요. {% endhint %} 인증에 내부 계정을 사용하고 기존 사용자를 인스턴스 관리자로 승격하거나 관리자 권한을 취소해야 하는 경우 다음을 수행하세요: {% stepper %} {% step %} ### 관리자 UI를 통해 * 기존 관리자 계정으로 로그인합니다. * Admin -> Manage Users를 클릭합니다. * 사용자를 검색한 다음 이메일 주소를 클릭합니다. * Site Admin 섹션으로 스크롤한 다음 (show) 링크를 클릭합니다. * Is Site Admin 체크박스를 선택합니다. * 완료하려면 Save를 클릭합니다. {% endstep %} {% endstepper %} *** ## 사용자 삭제 우리의 안내서 [라이선스 사용량 이해하기](broken://pages/bdba42cbf22a75768e1a32454f45b5723fee2b43)에서 설명한 대로, 계정이 더 이상 필요하지 않은 경우가 아니라면 삭제하지 않는 것이 일반적으로 좋습니다. 계정을 삭제하면 해당 계정이 제거되고 공동 작업자들은 프로젝트 접근 권한을 잃게 됩니다. 현재 계정을 비활성화하는 방법은 없으며, 계정은 데이터를 유지한 상태로 존재하거나 삭제되거나 둘 중 하나입니다. 기본적으로 계정은 소프트 삭제됩니다. 인스턴스에서 사용자를 영구적으로 제거하는 방법은 다음을 참조하세요 `ENABLE_CRON_RESOURCE_DELETION` 를 [환경 변수](broken://pages/906d29a7f121d3d121ddd462343b3b44ff90041a) 가이드. {% hint style="info" %} 계정은 기본적으로 소프트 삭제됩니다. 다음을 참조하세요 `ENABLE_CRON_RESOURCE_DELETION` 영구 삭제 동작에 대해. {% endhint %} ### Admin -> Manage Users를 통해 {% stepper %} {% step %} * 관리자 계정으로 로그인합니다. * Admin -> Manage Users를 클릭합니다. * 사용자를 검색한 다음 이메일 주소 옆의 체크박스를 선택합니다. * 휴지통 아이콘을 클릭합니다. * 확인하려면 Delete를 클릭합니다. {% endstep %} {% endstepper %} ### 명령줄을 통해 다음 명령을 사용하여 사용자 계정(및 해당 프로젝트)을 삭제할 수 있습니다. Overleaf Toolkit 배포: {% code title="Overleaf Toolkit" %} ```bash $ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com" ``` {% endcode %} 레거시 docker-compose.yml 배포: {% code title="레거시 docker-compose" %} ```bash $ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com" ``` {% endcode %} {% hint style="danger" %} 삭제 스크립트는 하드코딩된 force 옵션을 사용하므로 계정 삭제 이메일 발송에 실패하더라도(예: 사용자의 이메일이 더 이상 사용되지 않는 경우) 삭제가 계속 진행됩니다. {% endhint %} {% hint style="info" %} 버전 5.5.0부터는 --skip-email 옵션을 사용하여 삭제된 사용자에게 안내 이메일이 전송되지 않도록 할 수 있습니다. {% endhint %} *** ## 소프트 삭제된 사용자 복원 사용자가 소프트 삭제만 된 경우 계정과 프로젝트를 복원할 수 있습니다. {% stepper %} {% step %} * 관리자 계정으로 로그인합니다. * Admin -> Manage Users를 클릭합니다. * 복원하려는 사용자를 검색합니다. * Display deleted users 버튼을 클릭합니다. * 삭제된 사용자의 이메일 주소를 클릭합니다. * Recover This Account를 클릭합니다. * 확인하려면 Recover를 클릭합니다. {% endstep %} {% endstepper %} {% hint style="danger" %} ENABLE\_CRON\_RESOURCE\_DELETION이 true로 설정되어 있으면 소프트 삭제된 계정은 90일 이내에 복원할 수 있습니다. 90일이 지나면 계정 복구는 불가능합니다. {% endhint %} *** ## 사용자 수 계산 admin UI 사용자 수를 확인할 수 있습니다. 프로그램 방식의 확인 및 내보내기에는 다음 예시가 도움이 될 수 있습니다. 총 사용자 수: {% code title="총 사용자 수" %} ```bash echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex # overleaf [direct: primary] sharelatex> 16 ``` {% endcode %} 메트릭 엔드포인트를 사용한 총 사용자 수: {% code title="메트릭의 활성 사용자 수" %} ```bash docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users # # HELP num_active_users num_active_users # # TYPE num_active_users gauge # num_active_users{app="web-api",host="b3ae4ff549d8"} 16 ``` {% endcode %} 활성 사용자 총 수(예: 지난 365일 동안 활동한 사용자): {% code title="활성 사용자 총 수" %} ```bash echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex # overleaf [direct: primary] sharelatex> 10 ``` {% endcode %} *** ## 사용자 계정 정보 업데이트 계정 업데이트 방식은 SSO 사용 여부에 따라 달라집니다. * SSO를 사용하지 않는 경우: * 관리자는 Admin -> Manage Users를 통해 사용자 계정 정보(이메일, 이름, 성, 비밀번호 재설정 링크 생성)를 수정할 수 있습니다. * 일반 사용자는 Account -> Account Settings를 통해 자신의 세부 정보(비밀번호 변경 및 Git 인증 토큰 생성 포함)를 업데이트할 수 있습니다. * SSO를 사용하는 경우: * Server Pro는 인증 시스템을 기반으로 로그인 시 사용자의 이름과 성을 업데이트하도록 구성할 수 있습니다. * OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN 또는 OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN이 true이면 사용자 세부 정보 양식이 비활성화되고 이름/성은 ID 관리 시스템에서만 설정할 수 있습니다. 자세한 내용은 다음을 참조하세요: * SAML 2.0 구성: * LDAP 구성: *** 4개월 전 마지막 업데이트 이 문서 페이지에는 외부 가이드 및 구성 페이지로 연결되는 링크가 포함되어 있습니다. 모든 링크와 쿼리 매개변수는 원본 콘텐츠와 동일하게 유지됩니다. --- # 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, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/ko/user-and-project-management/user-management.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.