목차
로그인 및 /마운트
FilingBox MEGA2 v2 Linux Client는 command-line interface를 통해서, 모든 동작이 수행된다. (별도의 GUI interface는 제공하지 않는다.)
cd /namusoft/megaclient
./fbmegas –mount mount_path –addr xxx.xxx.xxx.xxx–port yyyy –id abc
위 명령어에 대해서, 세부적인 설명은 아래 설명을 참고한다.
- 마운트 정보 입력
장치 내 디렉토리 중에 FilingBox MEGA2 v2 Server에 마운트할 폴더의 경로를 지정한다.
입력 규칙은 아래와 같다.- mount:
-
- 입력 규칙 : 문자, 숫자, 특수문자 제한없음
- 입력값 길이 : 1 ~ 128 자
- Default 값 : 없음
주의
반드시, 절대 경로 값으로 입력해야 한다.
‘mount’ 옵션)
./fbmegas –mount mount_path –addr xxx.xxx.xxx.xxx –port yyyy –id abc
‘mount’ 옵션을 지정하고, 해당 값을 입력하지 않거나, ‘mount’ 옵션 자체를 지정하지 않는 경우, 아래와 같은, 에러 메시지가 출력된다.
‘mount’옵션에 존재하지 않거나 128자를 초과하는 마운트 경로 입력했을 때, 아래와 같은, 에러 메시지가 출력된다.
‘mount’ 옵션에, 파일이 존재하는 마운트 경로 지정 시 아래와 같은, 에러 메시지가 출력된다.
- 서버 접속 정보 입력
클라이언트가 접속할 서버의 정보(IP 주소, port 정보)를 입력한다.
각각의 옵션 및 입력 규칙은 아래와 같다.
- addr
-
클라이언트가 로그인할 FilingBox MEGA2 v2 Server의 IP 주소를 입력한다.
- 입력 규칙 : 문자, 숫자, 특수문자 제한없음
- 입력값 길이 : 1 ~ 20 자
- Default 값 : 없음
참고
로그인할 FilingBox MEGA2 v2 Server의 IP 주소 정보는 FilingBox MEGA2 v2 Server 관리자에게 문의해서 입력한다.
./fbmegas –mount mount_path –addrxxx.xxx.xxx.xxx –port yyyy–id abc
‘address’ 옵션을 지정하고, 해당 값을 입력하지 않는 경우, 아래와 같은, 에러 메시지가 출력된다.
‘address’ 옵션에 Server ip 주소 값을 올바르지 않게 입력했을 때, 아래와 같은, 에러 메시지가 출력된다.
- port
-
클라이언트가 로그인할 FilingBox MEGA2 v2 Server의 port 정보를 입력한다.
- 입력 규칙: 문자, 숫자, 특수문자 제한없음
- 입력값 길이: 1 ~ 6 자
- Default 값: 없음
참고
로그인할 FilingBox MEGA2 v2 Server의 port 정보는 FilingBox MEGA2 v2 Server 관리자에게 문의해서 입력한다.
‘port’ 옵션)
./fbmegas –mount mount_path –addr xxx.xxx.xxx.xxx –port yyyy –id abc
‘port’ 옵션에 올바르지 않은 Server port 정보를 입력했을 때, 아래와 같은, 에러 메시지가 출력된다.
‘port’ 옵션을 지정하고, 해당 값을 입력하지 않는 경우, 아래와 같은, 에러 메시지가 출력된다.
- 로그인 아이디 입력
클라이언트가 서버에 로그인할 아이디를 입력한다.
입력 규칙은 아래와 같다.
- id
- 클라이언트와 연동된 장치 관리자의 로그인 ID
- 입력 규칙: 문자, 숫자, 특수문자 제한없음
- 입력값 길이: 1 ~ 20자
- Default 값: 없음
참고
로그인할 FilingBox MEGA2 v2 Server의 로그인 아이디 정보는 FilingBox MEGA2 v2 Server 관리자에게 문의해서 입력한다.
‘id’옵션)
./fbmegas –mount mount_path –addr xxx.xxx.xxx.xxx –port yyyy –id abc
‘id’ 옵션에 올바르지 않은 장치 관리자 아이디 입력 시, 아래와 같은, 에러 메시지가 출력된다.
‘id’ 옵션을 지정하고, 해당 값을 입력하지 않는 경우, 아래와 같은, 에러 메시지가 출력된다.
- 로그인 패스워드 입력
클라이언트가 서버에 로그인할 패스워드를 입력한다.
입력 규칙은 아래와 같다.
- 입력 규칙: 문자, 숫자, 특수문자 제한없음
- 입력값 길이: 1 ~ 20자
- Default 값: 없음
패스워드를 잘못 입력하는 경우, 아래와 같은, 에러 문구가 표시된다.
- OTP 입력
클라이언트에 로그인하기 위해서는 2차 인증을 수행해야 한다. 사전에, 관리자 폰에 설치한 OTP 앱을 실행시킨 후, 현재 출력되고 있는 6자리 숫자를 입력한다.
입력 규칙은 아래와 같다.
- 입력 규칙: 숫자
- 입력값 길이: 6 자
- Default 값: 없음
OTP를 잘못 입력하는 경우, “Admin authentication failed. Invalid a passcode!”라는 에러 문구가 표시된다.
2차 인증에 성공하면, 아래와 같이, ‘mount’ 명령으로 마운트 결과를 확인할 수 있다.
로그인 (최초 로그인 시)
클라이언트를 설치하고 최초로 Linux Client에 로그인을 시도하는 경우, 2차 인증 수단을 등록하고, 임시 비밀번호를 변경하는 절차가 수행된다.
- 2차 인증 수단 등록 클라이언트에, 최초로, 로그인을 시도하면 아래와 같이, 2차 인증 수단을 등록하는 화면이 출력된다.
클라이언트는, 로그인, 허용앱 등록/삭제 동작을 수행할 때, 2차 인증을 요구하기 때문에, 화면에 표시된 QR 코드를 관리자의 폰에 설치되어 있는 OTP 앱에 등록해주어야 한다. (예, 구글 Authenticator, 등)
구글 OTP 앱 실행 후, ‘QR 코드 스캔’ 메뉴를 선택하면, 카메라 기능이 실행된다. 카메라의 격자 내에, 위에 출력된 QR 코드 이미지를 위치시키면, 구글 OTP 앱에 이 계정이 등록된다.
QR 코드가 정상적으로 관리자 폰에 등록되어 있는 지를 확인하기 위하여, OTP 앱을 실행시킨 후, 로그인을 시도한 계정 정보와 동일한 항목 아래, 현재 출력되고 있는, 6자리 숫자를 ‘totp’ 프롬프트에 입력하고, ‘enter’ 키를 입력한다. 정상적으로 등록되었다면, ‘totp authentication succeeded.”라는 메시지가 출력된다.
구글 OTP 앱 상에 계정이 등록된 화면 (로그인할 ID가 ‘demo1’이라는 가정임)
OTP 인증에 성공하면, “totp authentication succeeded.” 라는 메시지가 출력된다.
주의
2차 인증 수단으로 OTP를 사용하기 때문에, 클라이언트와 서버의 시간 정보가 일치하여야 한다. 만약, 두 시스템의 시스템 시간이 1분 이상 차이가 발생되면, 2차 인증에 실패할 수 있다. 2차 인증에 실패하는 경우, 시스템 관리자에게 연락한다.
- 비밀번호 설정
클라이언트를 설치한 후 Linux Client에 처음 로그인할 때는 임시 비밀번호를 입력해야 합니다. 입력한 비밀번호가 서버에 등록된 암호와 일치하면, 비밀번호 변경 절차가 자동으로 진행됩니다.
이는 관리자 웹 UI에서 장치 관리자를 생성할 때 최고 관리자가 설정한 암호가 임시 비밀번호로 지정되기 때문입니다. 따라서, 장치 관리자는 클라이언트에 로그인한 후 새 비밀번호를 설정해야 합니다.- new password
- 변경하고자 하는 비밀번호 (숫자, 영문대문자, 영문소문자, 특수문자가 최소 1개씩 포함되어야 하며, 길이는 9자 ~ 20자 이내)
-
입력 규칙:
영대문자, 영소문자, 숫자, 특수문자($!@%*#?&)를 각각1개 이상씩, 반드시,입력해야 한다.
위 규칙을 어기고 입력 시, 아래와 같은 에러 문구가 표시된다.- 대문자가 빠졌을 때 : “no big chars (ex: A-Z)”
- 소문자가 빠졌을 때 : “no small chars (ex: a-z)”
- 특수문자가 빠졌을 때 : “no special chars (ex:$!@%*#?&*-)”
- 숫자가 빠졌을 때 : “no numeric chars (ex:0-9)”
동일한 문자나, 숫자를, 3회 이상, 연속적으로 입력하면 안된다.
위 규칙을 어기고 입력 시, “same pattern test:111,222” 에러 문구가 표시된다.키보드상의 연속된 문자 또는 숫자를 순차적으로 입력하면 안된다.
위 규칙을 어기고 입력 시, “sequencial pattern (ex:123, qwe)” 에러 문구가 표시된다.직전에 사용된 패스워드를 재 입력하면 안된다.
위 규칙을 어기고 입력 시, “same as previous password” 에러 문구가 표시된다. -
입력값 길이 : 9 ~ 20 자
위 규칙을 어기고 입력 시, 아래와 같은, 에러 문구가 표시된다.- 길이가 9자 미만일 경우 : “more than 9 chars”
- 길이가 20자를 초과한 경우 : “less than 21 chars”
- Default 값 : 없음
- confirm password
- 'new password' 필드에 입력한 값을 확인하기 위해서, ‘new password’ 필드에 입력한 값과 동일한 값을 입력한다.
이 필드에 입력하는 값의 입력 규칙, 입력값 길이 및 Default 값 정보는 ‘new password’ 필드와 동일하다.
입력한 값이, ‘new password’ 필드에 입력한 값과 다른 경우, 아래와 같은 에러 문구가 표시된다.
정상적으로 패스워드 설정이 완료된 경우, 아래와 같이, ‘password change succeeded.’ 라는 문구가 출력되고, 로그인 및 마운트 작업이 수행된다.
정상적으로 패스워드 설정이 완료된 화면
정상적으로 마운트가 수행된 화면
로그인 (비밀번호 초기화)
관리자 웹 UI 사이트에서, 특정 계정의 비밀번호를 초기화할 수 있다. 이런 경우, 비밀번호가 초기화된 계정으로 클라이언트에 로그인을 시도하면, 아래와 같이, 비밀번호를 재 등록하는 절차가 수행된다.
- new password
-
변경하고자 하는 비밀번호 (숫자, 영문대문자, 영문소문자, 특수문자가 최소 1개씩 포함되어야 하며, 길이는 9자 ~ 20자 이내)
-
입력 규칙 :
영대문자, 영소문자, 숫자, 특수문자($!@%*#?&)를 각각1개 이상씩, 반드시,입력해야 한다.위 규칙을 어기고 입력 시, 아래와 같은 에러 문구가 표시된다.
- 대문자가 빠졌을 때 : “no big chars (ex: A-Z)”
- 소문자가 빠졌을 때 : “no small chars (ex: a-z)”
- 특수문자가 빠졌을 때 : “no special chars (ex:$!@%*#?&*-)”
- 숫자가 빠졌을 때 : “no numeric chars (ex:0-9)”
동일한 문자나, 숫자를, 3회 이상, 연속적으로 입력하면 안된다.
위 규칙을 어기고 입력 시, “same pattern test:111,222” 에러 문구가 표시된다.키보드상의 연속된 문자 또는 숫자를 순차적으로 입력하면 안된다.
위 규칙을 어기고 입력 시, “sequencial pattern (ex:123, qwe)” 에러 문구가 표시된다.직전에 사용된 패스워드를 재 입력하면 안된다.
위 규칙을 어기고 입력 시, “same as previous password” 에러 문구가 표시된다. -
입력값 길이 : 9 ~ 20 자
위 규칙을 어기고 입력 시, 아래와 같은, 에러 문구가 표시된다.- 길이가 9자 미만일 경우 : “more than 9 chars”
- 길이가 20자를 초과한 경우 : “less than 21 chars”
- Default 값 : 없음
- confirm password
- 'new password' 필드에 입력한 값을 확인하기 위해서, ‘new password’필드에 입력한 값과 동일한 값을 입력한다.
이 필드에 입력하는 값의 입력 규칙, 입력값 길이 및 Default 값 정보는 ‘new password’ 필드와 동일하다.입력한 값이, ‘new password’ 필드에 입력한 값과 다른 경우, 아래와 같은 에러 문구가 표시된다.
정상적으로 패스워드 설정이 완료된 경우, 아래와 같이, ‘password change succeeded.’ 라는 문구가 출력되고, 로그인 및 마운트 작업이 수행된다.
정상적으로 패스워드 설정이 완료된 화면
정상적으로 마운트가 수행된 화면
로그인 실패
클라이언트 로그인에 실패하는 경우는 아래와 같다.
서버에 등록되어 있는 장치 관리자 정보와 다른 정보로 로그인을 시도한 경우
장치가 서버에 등록되어 있지 않거나, 장치와 장치관리자가 연동되어 있지 않은 경우
주의
5번 이상, 암호를 잘못 입력하여, 로그인에 실패하는 경우, 계정이 잠긴다. 계정이 잠긴 상태에서는, 로그인을 할 수 없으며, 600초가 경과되면, 자동으로 잠금 상태가 해제된다. 반복적으로 로그인에 실패하는 경우, FilingBox MEGA2 v2 Server 관리자에게 연락해서, 계정 정보를 다시 확인하고, 계정이 잠겨 있는지를 확인하는 것이 필요하다.
단, 로그인 실패를 카운트하는 기준은, FilingBox MEGA2 v2 Server에 등록되어 있는 ID를 입력하고, FilingBox MEGA2 v2 Server에 저장되어 있는 암호와 다른 값을 입력한 경우에만 해당된다.