관리 콘솔 및 운영

Thinkfree Drive는 일반 사용자 화면과 분리된 두 가지 관리 화면을 제공합니다. 아래 주소의 {drive-host}는 Drive 서비스 도메인입니다. 관리자 포털에는 해당 tenant의 도메인으로 접속합니다. 슈퍼어드민 포털은 서버 IP 또는 최초 tenant의 도메인으로도 접속할 수 있습니다.

화면	역할	로그인 주소
관리자 포털	Tenant Admin이 해당 tenant의 사용자, 시스템 설정, 보안, 브랜딩을 관리합니다.	https://{drive-host}/admin/login
슈퍼어드민 포털	Super Admin이 시스템 전체와 모든 tenant를 관리합니다.	https://{drive-host}/superadmin/login

위 주소로 접속하면 로그인하지 않은 상태에서는 로그인 화면이, 이미 로그인한 상태에서는 해당 포털의 관리 화면이 열립니다.

Drive 준비하기의 Trial 이미지를 실행했다면 컨테이너를 실행한 컴퓨터에서 관리자 포털 또는 슈퍼어드민 포털에 접속하고, 해당 문서의 Trial 계정으로 로그인합니다. 관리 화면 언어는 오른쪽 위 프로필 아이콘 > 계정 설정에서 바꿀 수 있으며 기본값은 브라우저 언어입니다.

Trial 환경에서 도메인을 사용하는 기능

Trial 가이드는 도메인 대신 로컬 IP 주소로 접속하는 방법을 안내합니다. 따라서 도메인이 필요한 일부 관리자 기능은 Trial 환경에서 정상적으로 동작하지 않을 수 있습니다. 여러 tenant를 운영하는 기능을 테스트하려면 tenant별 도메인을 설정하고 TLS를 적용해 HTTPS로 접속해야 합니다.

기본 계정의 비밀번호를 먼저 변경하세요

설치 시 제공되는 superadmin, admin 계정의 기본 비밀번호는 공개되어 있습니다. 서비스를 운영하기 전에 반드시 변경하세요. 비밀번호를 한 번도 변경하지 않은 계정으로 슈퍼어드민 포털에 로그인하면 비밀번호 설정 안내가 표시됩니다.

관리자 포털

관리자는 자신이 속한 tenant의 사용자와 서비스 설정을 관리합니다.

계정 관리

메뉴	기능
계정 관리 > 사용자	사용자를 추가·수정·비활성화·삭제합니다. 사용자는 직접 가입할 수 없고 관리자가 계정을 만듭니다.
계정 관리 > 관리자	관리자 계정을 사용자와 같은 방식으로 관리합니다.
계정 관리 > 삭제 대기 계정	삭제한 계정을 복원하거나 완전히 삭제합니다.

• 사용자 추가: 사용자 ID(이메일), 비밀번호, 이름, 스토리지 용량이 필수입니다. 스토리지 용량의 기본값은 1GB입니다.
• 일괄 등록: 등록 화면에서 CSV 템플릿을 내려받아 사용자 목록을 입력한 뒤 가져오기로 업로드합니다. 이메일 발송을 선택하면 등록된 사용자에게 계정 등록 안내 메일을 보냅니다. 메일을 보내려면 SMTP 설정이 필요합니다.
• 비밀번호 변경 / 2FA 초기화: 사용자 수정 화면에서 비밀번호를 바꾸거나, 인증 기기를 분실·교체한 사용자의 2FA 정보를 초기화합니다. 2FA를 등록하지 않은 사용자는 초기화 버튼이 비활성화됩니다.
• 보안 이력: 사용자의 로그인·로그아웃 위치, IP, 일시를 확인합니다.
• 비활성화 / 삭제: 비활성화된 사용자는 로그인할 수 없습니다. 삭제한 계정은 30일 동안 삭제 대기 목록에 보관되어 복원할 수 있고, 이후 자동으로 완전히 삭제됩니다.

노트

현재 로그인한 본인 계정은 삭제하거나 비활성화할 수 없습니다.

시스템 설정

메뉴	기능
시스템 설정 > 시스템 정보	현재 tenant의 도메인과 제품 버전을 확인합니다. 제품 버전은 읽기 전용입니다.
시스템 설정 > SMTP 설정	계정 등록 안내·알림 메일을 보낼 SMTP 서버를 설정합니다. 저장한 뒤 테스트 이메일 발송으로 동작을 확인합니다.
시스템 설정 > 라이선스 관리	라이선스 유효기간과 유형을 확인하고, 새 라이선스 파일을 업로드해 갱신합니다. 사용자 수 기반 라이선스에서는 현재 사용자 수와 허용 사용자 수도 확인할 수 있습니다.
시스템 설정 > Office 설정	Thinkfree Office 서버 주소와 어댑터 이름을 설정합니다.
시스템 설정 > 스토리지 설정	연결된 스토리지 유형과 접속 정보를 확인합니다.
시스템 설정 > 노트 설정 (Beta)	Intellect 노트 기능을 켜거나 끕니다. 끄면 사용자 화면에 노트 메뉴가 표시되지 않습니다.

경고

• 라이선스 유효기간을 확인하고 만료 전에 갱신하세요.
• Office 설정에는 사용할 Thinkfree Office 서버 주소와 해당 Office에 등록한 어댑터 이름을 입력합니다. Office의 설정 방법은 관리 콘솔 및 운영을 참고하세요.
• 스토리지 유형과 접속 정보는 관리자 포털에서 조회만 할 수 있습니다. 단일 파일 업로드 용량 제한은 변경할 수 있습니다.

보안 / 인증 관리

2FA

보안/인증 관리 > 인증 설정 > 2FA에서 해당 tenant의 일반 사용자에게 2단계 인증을 필수로 설정할 수 있습니다. 기본값은 비활성화이며, 관리자와 슈퍼어드민 로그인에는 적용되지 않습니다. 사용자가 인증 기기를 분실하거나 교체한 경우 계정 관리 > 사용자 > 수정에서 해당 사용자의 2FA 정보를 초기화합니다.

로그인 방식

보안/인증 관리 > 인증 설정 > 로그인 설정에서 로그인 방식을 선택합니다.

방식	설명
로컬 로그인	이메일과 비밀번호로 로그인합니다. 기본값입니다.
JWT 자동 인증	미리 연동한 외부 시스템이 발급한 JWT로 로그인 화면 없이 자동으로 인증합니다.
OIDC 로그인	외부 OpenID Connect 제공자(IdP)와 연동해 로그인합니다.

JWT 자동 인증을 선택하면 다음 항목을 입력합니다.

항목	필수	설명
Provider Name	✓	JWT 제공자 식별 이름
Issuer	✓	JWT의 iss 값과 일치해야 하는 발급자 식별값
Login Page URL	✓	토큰 인증에 실패하거나 직접 접속했을 때 이동할 고객사 로그인 페이지 URL
Audience	-	JWT 수신 대상 식별값
Email Claim Name	-	JWT에서 이메일을 가져올 claim 이름
Key Type	✓	공개키를 직접 입력하는 public_key 또는 JWKS에서 가져오는 jwks
Public Key	public_key 선택 시	JWT 서명 검증용 공개키
JWKS URI	jwks 선택 시	JWT 서명 검증용 공개키를 가져올 JWKS 주소

OIDC 로그인을 선택하면 IdP를 추가합니다. IdP는 여러 개 등록할 수 있지만 동시에 하나만 사용할 수 있습니다.

항목	필수	설명
IdP 이름	✓	IdP 구분 이름
Issuer URL	✓	IdP 발급자 URL
Client ID	✓	IdP가 발급한 클라이언트 식별자
Client Secret	✓	IdP가 발급한 클라이언트 secret. 등록한 뒤에는 마스킹되어 표시됩니다.

경고

로그인 방식을 변경하면 이후 일반 사용자의 로그인부터 적용됩니다. 이미 로그인한 사용자가 로그아웃되지는 않으며, 관리자와 슈퍼어드민의 로그인 방식에는 영향을 주지 않습니다. 저장 전에 입력값을 확인하세요.

API Key 관리

보안/인증 관리 > API Key 관리에서 외부 연동에 사용할 API Key를 발급하고 관리합니다. API Key는 외부 시스템에서 사용자 계정 관리, 일괄 등록, 스토리지 용량 관리 등의 API를 호출할 때 사용합니다. 호출 방법과 권한은 Authentication을 참고하세요.

• 생성: API Key 이름, 사용 용도, 만료일을 입력합니다. 기본 유효기간은 90일입니다. API Key 값은 생성 직후 한 번만 전체 표시되므로 바로 안전한 곳에 저장하세요.
• 비활성화 / 활성화: 비활성화한 API Key는 이후 API 호출에 사용할 수 없으며, 필요하면 다시 활성화할 수 있습니다. 활성화된 API Key도 만료일이 지나면 사용할 수 없습니다.
• 만료일 변경: 필요에 따라 만료일을 변경합니다. 비활성화된 API Key의 만료일을 연장해도 자동으로 활성화되지는 않습니다.
• 재발급: 기존 API Key 값을 폐기하고 새 값으로 교체하며, 만료일은 그대로 유지됩니다. 새 값도 한 번만 표시되므로 연동 중인 시스템의 설정도 함께 변경해야 합니다. 만료된 API Key는 재발급만으로는 다시 사용할 수 없으며, 만료일도 변경해야 합니다.

접근 제한 설정

보안/인증 관리 > 접근 제한 설정에서 일반 사용자가 접속할 수 있는 국가와 IP 대역을 지정합니다. 기본값은 비활성화입니다. 국가와 IP를 함께 설정하면 둘 중 하나라도 해당하는 접속을 허용합니다. 국가만 설정한 경우 국가를 확인할 수 없는 IP에서의 접속은 차단하지 않습니다.

저장한 정책은 이후 요청부터 적용됩니다. 관리자 계정에는 적용되지 않으며, 관리자 접근 허용 IP는 슈퍼어드민 포털에서 별도로 설정합니다.

항목	입력 형식	예시
접근 허용 국가	ISO 2자리 국가 코드	KR, US, JP
접근 허용 IP	IP 주소 또는 CIDR	192.168.0.12, 192.168.0.0/24

감사 로그

보안/인증 관리 > 감사 로그에서 로그인, 파일 접근, 공유, 권한 변경, 관리 기능 수행 이력을 조회합니다. 관리자 계정만 감사 로그를 조회하고 CSV로 내보낼 수 있습니다.

필터	설명
사용자	이름 또는 이메일로 검색합니다. 입력하면 일치하는 사용자가 자동완성됩니다.
검색 기간	조회 시작일과 종료일을 지정합니다.
이벤트	로그인, 파일·폴더, 공유, 사용자 관리, 설정 등의 카테고리와 상세 이벤트를 여러 개 선택할 수 있습니다.
결과	전체, 성공, 실패 중 하나를 선택합니다.
채널	전체 또는 이벤트가 발생한 경로(Web, API, MCP, SYSTEM) 중 하나를 선택합니다.

목록에는 사용자, 이벤트, 결과, 리소스, 대상, 채널, IP, 일시가 표시됩니다. 조건을 설정해 조회한 뒤 내보내기를 선택하면 조회 조건에 맞는 해당 tenant의 로그를 CSV로 내려받습니다. 현재 페이지뿐 아니라 전체 조회 결과가 포함됩니다. 한 번에 내보낼 수 있는 기간은 최대 92일입니다. API로 조회하려면 Audit logs를 참고하세요.

개인정보 관리 책임

감사 로그에는 사용자 이름, 이메일, 접속 IP 같은 개인정보가 포함될 수 있습니다. Thinkfree Drive는 고객사가 직접 운영하는 제품이므로 로그의 접근 권한, 보관 기간, 파기 관리 책임은 고객사에 있습니다.

서비스 관리

메뉴	기능
서비스 관리 > 브랜딩 설정	브라우저 탭 제목과 서비스 이름을 설정합니다. 기본 로고를 사용하거나 파비콘·심볼형 로고(로그인 화면)·기본형 로고(사이드바)·이메일 로고를 직접 업로드할 수 있습니다.
서비스 관리 > 공유 설정	공유 기능 사용 여부, 외부 공유 허용 여부, 접근 권한 허용 범위(제한됨·조직 내부 공개·전체 공개)를 설정합니다.

공유 비활성화

공유 기능을 끄고 저장하면 해당 tenant 소유 파일과 폴더의 기존 공유가 모두 해제됩니다. 외부 공유나 공개 범위를 제한할 때도 해당하는 공유와 접근 권한이 해제될 수 있습니다. 설정을 다시 허용해도 해제된 공유는 복원되지 않으므로 필요한 항목을 다시 공유해야 합니다. 슈퍼어드민 포털에서 전체 적용하면 이 변경이 모든 tenant에 적용됩니다.

슈퍼어드민 포털

슈퍼어드민은 Drive 시스템 전체와 모든 tenant를 관리합니다. 여러 tenant를 운영하려면 도메인과 TLS(HTTPS)를 반드시 설정해야 합니다. Drive는 접속한 도메인으로 tenant를 구분하므로, 각 tenant의 도메인에 HTTPS로 접속할 수 있도록 설정하세요.

설치할 때 설정 파일에 슈퍼어드민 포털 접속 허용 IP를 지정했다면 해당 IP에서만 접속할 수 있습니다.

메뉴	기능
테넌트 관리 > 테넌트 목록	모든 tenant를 조회하고 추가·수정합니다. tenant 삭제 기능은 제공하지 않습니다.
시스템 설정 > 시스템 정보	전체 시스템에 사용할 베이스 도메인을 설정하고 제품 버전을 확인합니다.
서비스 기능 관리 > 공유 설정 / 로그인 설정	공유 기능과 로그인 방식을 전체 tenant에 일괄 적용하거나 tenant별로 적용합니다.
계정 설정	슈퍼어드민 계정 정보를 확인합니다.

tenant 추가

tenant를 추가하려면 먼저 시스템 설정에서 베이스 도메인을 저장해야 합니다. tenant를 추가할 때는 tenant 이름, tenant 도메인, 관리자 접근 허용 IP, 어드민 대표 계정을 입력합니다. 관리자 접근 허용 IP를 비워 두면 모든 IP에서 관리자 포털에 접속할 수 있으며, 나중에 수정할 수 있습니다.

노트

어드민 대표 계정은 tenant를 만들 때만 입력할 수 있습니다. 추가 관리자 계정은 해당 tenant의 관리자 포털에서 만듭니다.

전체 적용 전환

공유·로그인 설정을 전체 적용으로 바꾸면 모든 tenant에 같은 설정이 적용되며, tenant별로 변경할 수 없습니다. 기존 tenant별 설정은 삭제되지 않으며, 개별 적용으로 되돌리면 다시 적용됩니다. 단, 공유 정책 변경으로 이미 해제된 공유는 복원되지 않습니다.