안녕하십니까, Kiosk 이용자 여러분. Kiosk를 운영하는 Freezm 입니다. 

본 게시글은 Kiosk Desktop Client 프로그램의 사용 방법에 대해 기술하고 있습니다.

데스크톱 환경 또는 모바일 웹 브라우저를 통해 본 게시글을 열람하시는 경우,

Ctrl+F 버튼을 눌러 단어 검색을 통해 원하는 정보를 찾으실 수 있습니다.

목차

• 설치 방법
• 이용 방법
• 설정 조작
  1. 설정 창
  2. 대기열 관리
• 업데이트 방법
• 수동 종료 및 실행 방법
  1. 수동 종료
  2. 수동 실행
  3. 바로가기 직접 추가
• 삭제 방법
  1. 기본 삭제
  2. 수동 삭제
• 호환성 정보
• 오작동 사례
• 악성코드 오진 사례 및 대응 방법
  1. 설치 파일 다운로드 시: 일부 웹 브라우저
  2. 설치 파일 실행 시: Windows SmartScreen
• Disclaimer
  1. 공증서 미비
  2. 공식 배포처는 Kiosk 웹사이트 내 Desktop 메뉴
  3. 설치 파일 한정 악성코드 오진 사례 존재

설치 방법

1. Kiosk 웹사이트 좌측 상단의 햄버거 버튼(☰)을 눌러 좌측 사이드바 메뉴를 펼칩니다.

2. 사이드바 메뉴 중 Desktop 을 눌러 나타난 클라이언트 전용 웹 페이지에서 Download 버튼을 누릅니다.

이 때 반드시 인터넷이 연결되어 있어야 하며, 인터넷이 연결되어 있지 않거나 인트라넷에만 연결된 경우엔 이용이 불가능합니다.

3. EXE 포맷의 설치 파일을 내려 받습니다.

4. 설치 파일을 실행하면 나타나는 창에서 Install 버튼을 누릅니다.

창에 언급된 최종 사용자 라이센스 계약(EULA)은 Kiosk Terms of Service 를 의미합니다.

5. 설치가 완료되면 화면 우측 하단의 작업표시줄 위쪽에 프로그램 창이 한 번 나타납니다.

6. 클라이언트의 실행 여부는 다음과 같이 확인하실 수 있습니다.

• Windows 10/11 기준, 화면 우측 하단의 작업 표시줄에 Kiosk 아이콘이 나타납니다.
• 작업 관리자에 백그라운드 프로세스 목록에서 Kiosk Deskop Client 항목을 확인할 수 있습니다.

이용 방법

Step 1. 브라우저에서 다운로드 버튼 누르기

클라이언트가 실행 중인 상태에서 웹 브라우저에서 공유 링크 등을 통해 Kiosk 컬렉션에 접근한 뒤,

웹 페이지 내에서 컬렉션 전체 또는 일부 파일에 대한 다운로드 버튼을 누릅니다.

클라이언트는 웹 브라우저와 다른 방식으로 파일 전송을 하므로, 이 때엔 전송 옵션 선택 메뉴가 나타나지 않습니다.

Step. 2. 클라이언트로의 작업 전환

웹 페이지 하단에 푸른색 체크 표시와 함께 Download started on desktop application 이라는,

전송 작업이 클라이언트에서 시작되었다는 토스트 알림이 나타납니다.

작업 현황은 화면 우측 하단의 작업 표시줄에서 Kiosk 아이콘을 누르면 확인할 수 있습니다.

Step. 3. 전송 완료

다운로드의 경우, 전송이 완료되면 클라이언트에 설정된 저장 경로에서 다운로드 된 파일 및 폴더를 확인하실 수 있습니다.

설정 조작

1. 설정 창

작업 표시줄에서 Kiosk 아이콘을 더블 클릭하면 클라이언트 창이 나타납니다.

해당 창의 우측 상단 구석에 있는 설정 버튼을 누르면 클라이언트 설정 창이 나타납니다.

Download Directory

클라이언트가 다운로드 한 파일 및 폴더를 저장할 위치를 선택합니다.

기본 위치는 Windows OS 기준 사용자 문서 폴더 내 kiosk 폴더입니다.

Update Channel

자동 업데이트 시 내려 받을 패치 종류를 선택할 수 있으나, 가급적 조작하지 않는 것을 권장합니다.

기본 설정은 Stable으로, 공개 배포된 업데이트를 받으실 수 있습니다.

Beta는 실험용으로 배포된 업데이트이며, 사실상 Kiosk 개발자 전용 설정입니다.

2. 대기열 관리

작업 표시줄에서 Kiosk 아이콘을 더블 클릭하면 클라이언트 창이 나타납니다.

창에는 전송 작업 항목들이 나열되어 있으며, 각 항목에 마우스 커서를 갖다 대고 우클릭을 하면 컨텍스트 메뉴가 나타납니다.

폴더 열기

특정 항목에 대해 컨텍스트 메뉴를 열은 경우, 폴더 열기 버튼을 누르면 해당 항목이 저장된 폴더를 열 수 있습니다.

완료된 작업 삭제

컨텍스트 메뉴에 있는 해당 버튼을 누르면 대기열 내 전송이 이미 완료된 항목이 모두 사라집니다.

다운로드 된 파일은 이에 영향을 받지 않고 저장된 위치에 그대로 남아 있습니다. 

업데이트 방법

클라이언트는 자동 업데이트 기능을 탑재하고 있으며, 이는 클라이언트 실행 시에 자동으로 기능합니다.

또한, 클라이언트는 설치 직후 Windows 환경 기준 시작 프로그램에 등록됩니다.

즉, 데스크톱을 부팅 할 때 마다 클라이언트의 실행과 업데이트 체크, 그리고 업데이트가 자동으로 한 번에 이루어집니다.

만약 재부팅 없이 업데이트를 받길 원하시는 경우,

아래 항목을 참고하시어 클라이언트를 수동으로 종료 후 다시 실행하시기 바랍니다.

수동 종료 및 실행 방법

클라이언트는 기본적으로 백그라운드에서 작동되는 프로그램인 만큼, 별도의 실행 또는 종료 버튼이 없습니다.

클라이언트를 수동으로 종료 또는 다시 실행하길 원하시는 경우, 아래 방법을 참고하여 주시기 바랍니다.

수동 종료

작업 표시줄과 작업 관리자 양쪽에서 클라이언트가 없는 경우, 클라이언트는 이미 실행되지 않고 있는 상태입니다.

1. Windows 화면 우측 하단의 작업 표시줄을 펼칩니다.
2. 작업 표시줄에 있는 Kiosk 웹사이트 아이콘에 마우스 커서를 갖다 대어 우클릭 합니다.
3. 나타난 컨텍스트 메뉴의 Quit 버튼을 눌러 클라이언트를 종료하며, 없는 경우엔 생략합니다.
4. Ctrl + Alt + Del 세 개 버튼을 동시에 누른 후 작업 관리자를 켭니다.
5. 작업 관리자의 백그라운드 프로세스 항목에서 알파벳 순으로 나열된 프로세스 중 Kiosk Desktop Client 를 찾습니다.
6. 클라이언트 항목을 누르고 우클릭 하면 나타나는 컨텍스트 메뉴에서 End task를 누릅니다.

수동 실행

1. 키보드의 Win + R 버튼 동시에 눌러 실행 창을 켭니다.
2. 실행 창에 아래 경로를 복사 및 붙여넣기 한 다음 Enter 키를 누르면 클라이언트가 다시 실행됩니다.
   • {USER} 란에는 현재 사용 중인 Windows 사용자 이름을 입력하며, 기본 설정은 USER 입니다.
   • C:\Users\{USER}\AppData\Local\kiosk\kiosk.exe

바로가기 직접 추가

아래 방법대로 클라이언트 실행 파일의 숏컷을 만들 수 있습니다.

1. 바로가기를 만들 위치에 마우스를 우클릭하여 컨텍스트 메뉴를 실행하기
2. 메뉴 중 New > Shortcut 선택
3. 입력 란에 아래 경로를 복사 및 붙여넣기 한 다음 Enter 키 누르기
4. 바로가기에 붙일 이름을 원하는 대로 설정한 다음 Enter 키 누르기

삭제 방법

기본 삭제

[GMT +00] 06/25/2024 기준 배포 본에선 기본 삭제 방법이 구현되어 있지 않으므로, 아래 수동 삭제 방법을 따르십시오.

1. Windows 설정 > 앱 > 앱 및 기능 메뉴에서 Kiosk Desktop Client 라는 문구를 검색합니다.
2. Kiosk Desktop Client 이 목록에 나타나면, 항목을 한 번 누른 뒤 제거 버튼을 클릭합니다.

수동 삭제 (완전 삭제)

기본 삭제 방법이 작동하지 않거나 예기치 못한 오류로 프로그램을 직접 삭제해야 되는 경우, 아래 방법을 따르시기 바랍니다.

1. 키보드의 Win + R 버튼 동시에 눌러 실행 창을 켭니다.
2. 실행 창에 아래 두 경로를 각각 따로 복사 및 붙여넣기 한 다음 Enter 키를 누릅니다.
   {USER} 란에는 현재 사용 중인 Windows 사용자 이름을 입력하며, 기본 설정은 USER 입니다.
   • C:\Users\{USER}\AppData\Local\kiosk
   • C:\Users\{USER}\\AppData\Roaming\kiosk
3. 나타난 두 파일 탐색기 창 속에 있는 파일 및 폴더들을 kiosk.exe 를 포함하여 모두 삭제하십시오.

호환성 정보

데스크톱: 부분 지원

• Windows AMD64 OS: Windows 10/11 32 bits 및 64 bits 환경 지원
• Linux OS: 추후 지원 예정
• Arch Linux 계열 OS: 지원 미정
• macOS: 추후 지원 예정

모바일 환경: 미지원

• 모바일 환경에는 대응되는 별도의 어플리케이션이 현재 개발 중에 있습니다.
• 해당 어플리케이션은 본 클라이언트과는 달리 웹 브라우저와 독립적으로 작동합니다.

오작동 사례

클라이언트 강제 종료

일부 조건에서 드물게 클라이언트가 별도의 알림 없이 저절로 종료되는 오류가 발견되었습니다.

이 경우, 아래 사진과 같이 작업 표시줄만, 혹은 작업 관리자 백그라운드 프로세스에서도 클라이언트가 나타나지 않게 됩니다.

동시에 웹 브라우저로 Kiosk에서 파일을 다운로드 하여도, 클라이언트에서 작업이 시작되었다는 토스트 알림만 뜨고

클라이언트는 아무런 작업도 수행하지 않을 수도 있습니다.

[GMT +00] 06/24/2024 기준 보완 업데이트가 배포되었으므로,

이미 클라이언트를 설치하셨던 분들은 클라이언트를 수동으로 종료 후 재실행하여 업데이트를 받으시길 바랍니다.

클라이언트를 다시 실행할 때 파일을 내려 받는 창이 잠시 나타난다면 업데이트가 진행된 것입니다.

만약 업데이트를 받았음에도 동일한 문제가 나타난다면 아래와 같이 시도하시기 바랍니다.

1. Ctrl + Alt + Del 버튼을 동시에 눌러 작업 관리자를 켭니다.
2. 본 게시글 본문의 수동 종료 및 실행 방법 섹션을 참고하시어 클라이언트를 재실행하면 정상적으로 서비스 이용이 가능합니다.
3. 이후 해당 현상을 아카라이브 Kioskloud 채널로 제보하여 주시면 문제 개선에 큰 도움이 됩니다.

UI 깨짐 현상

클라이언트 창 내 요소들이 바른 위치에 있지 않고 깨지는 현상이 매우 드물게 나타날 수 있습니다.

이 경우, 아카라이브 Kioskloud 채널에 제보하여 주시면 문제 개선에 큰 도움이 됩니다.

악성코드 오진 사례 및 대응 방법

오진 사례와 관련된 개괄적인 설명은 아래 Disclaimer 3번 항목을 참고하시기 바랍니다.

1. 설치 파일 다운로드 시: 일부 웹 브라우저

Microsoft Edge 등 일부 웹 브라우저, 또는 웹 브라우저 별 이용자가 변경한 설정에 따라 

클라이언트 설치 파일을 악성코드로 오진하고 다운로드를 제한할 수 있습니다.

이 경우, 위 이미지와 같이 예외 처리 설정 후 설치 파일을 받으시면 됩니다.

테스트 환경 기준, 설치 파일을 내려 받는 과정에서 Windows 보안(디펜더)는 별도의 악성코드 진단을 내놓지 않았습니다.

2. 설치 파일 실행 시: Windows SmartScreen

Windows OS에서 설치 파일을 실행할 경우, 스마트 스크린이 설치 파일을 악성코드로 오진할 수 있습니다.

이 경우, 위와 같이 경고를 무시하고 설치 파일을 실행하시면 됩니다.

테스트 환경 기준, 설치 파일을 실행하는 과정에서 아래 백신 및 보안 시스템은 별도의 악성코드 진단을 내놓지 않았습니다.

• Windows 보안(디펜더)
• Bitdefender

Disclaimer

이용자는 클라이언트를 이용함으로서 아래와 같은 Freezm의 면책 및 유의 사항에 동의하시는 것으로 간주합니다.

1. 공증서 미비

클라이언트에는 CodeSign과 같은 별도의 온라인 배포 프로그램 전용 공증서가 내장되어 있지 않습니다.

이러한 공증서의 발급엔 법인 자격이 필요한 만큼, 현재 별도의 법인이 없는 Freezm은 클라이언트에 공증서를 갖추지 못한 상태입니다.

이는 해당 클라이언트가 온라인 배포 프로그램으로서 공적인 신뢰성이 낮을 수 있음을 의미합니다.

2. 공식 배포처는 Kiosk 웹사이트 내 Desktop 메뉴 한 곳만.

현재 설치 파일은 Kiosk 웹사이트 내 클라이언트 페이지 ( https://kiosk.ac/desktop  )에서만 공식 배포하고 있으며,

해당 페이지 내의 Download 버튼을 이용자가 직접 누를 때에만 설치 파일을 받으실 수 있습니다.

앞서 언급한 공증서의 부재로 인해, 공식 배포처 이외의 경로를 통해 설치 및 프로그램 실행 파일을 받는 경우

해당 파일들에 대한 제3자에 의한 악의적인 가공 여부를 분간하기 어려울 수 있습니다.

따라서, 설치 파일은 반드시 공식 배포처를 통해서만 받으시기 바랍니다.

또한, 공식 설치 파일을 통해 클라리언트가 설치되는 과정 중 생성되는 경우를 제외한 나머지 별도의 프로그램 실행 파일을 별도로 구해 이용하지 마시기 바랍니다.

Freezm은 이러한 배포처 및 배포 방식 외에 방법으로 클라이언트의 설치 파일이나 프로그램 실행 파일을 배포하지 않습니다.

Kiosk 파일 공유 서비스를 통해서도 배포하지 않으므로, 만약 Kiosk 컬렉션 공유 링크를 통해 배포되는 파일이 있다면 이를 받거나 실행하지 마시길 바랍니다.

해당 비공식 배포 사례는 Freezm 측에 해당 공유 링크를 제보하여 주시면 향후 운영 관리에 큰 도움이 됩니다.

3. 설치 파일 한정 악성코드 오진 사례 존재

테스트 환경 기준 클라이언트 실행 파일(kiosk.exe) 및 프로그램 실행 중에는 별도의 오진 사례가 나타나지 않았습니다.

• 확인 사항: Windows 보안 (Windows Defender 기본 설정 기준), 서드파티 백신(Bitdefender 기본 설정 기준) 등

다만 Windows SmartScreen 및 일부 웹 브라우저, 그리고 위 이미지와 같이 VirusTotal의 일부 마이너 벤더 엔진은 Kiosk Desktop Client의 설치 파일을 악성 코드로 오진하는 경우가 있습니다.

위와 같은 VirusTotal 검진 결과는 Kiosk 웹사이트 내 클라이언트 다운로드 버튼 하단의 Safe to Install 를 눌러 확인하실 수 있습니다.

이와 같이 오진 사례가 나타나는 데에는 다음과 같은 원인으로 인한 것으로 추정됩니다.

• 앞서 언급한 공증서의 부재
• 웹 브라우저 및 서드파티 백신 개발사 별 오진 예외 처리 요청 미흡
• 프로그램의 작동 방식: 별도 프로그램인 웹 브라우저 및 외부 서버와의 통신 등의 행동

오진 경고를 받아 들여 설치 파일을 받지 않는 것은 이용자의 정당한 권리입니다.

다만 이는 동시에 이용자가 Kiosk Desktop Client 및 해당 프로그램이 제공하는 서비스를 이용하실 수 없음을 의미합니다.

주요한 오진 사례 및 대응 방법에 대해선 Disclaimer 바로 위 '오진 사례 및 대응 방법' 섹션을 참고하시기 바랍니다.