.. _windows-agent:

Windows Agent 설치
========================

GPO, CWP (Captive Web Portal)를 통해 Windows 단말에 **에이전트** 를 설치 하거나 메일, USB 등을 이용하여 수동으로 **에이전트** 를 설치할 수 있습니다.

Windows 에이전트 설치
-------------------------

- `에이전트 다운로드 페이지를 통해 다운로드 및 설치`_
- `CWP를 통한 에이전트 설치`_
- `Active Directory GPO를 통한 에이전트 MSI 패키지 설치`_
- `Windows Agent 설치 확인`_
- `Windows 단말 에이전트 로그 위치`_

에이전트 다운로드 페이지를 통해 다운로드 및 설치
----------------------------------------------------

#. 에이전트 다운로드

   -  \https://(*IP 또는 도메인*)/agent

#. 에이전트 선택 : 파일명 충돌을 피하기 위해 파일 이름을 변경하지 마십시오.
  
   -  Windows 설치 관리자 버전 : GnUpdate_(*IP 또는 FQDN*) .exe

#. 에이전트 설치 토큰

   - **환경설정 > 에이전트** 의 **토큰 미사용 에이전트 차단** 옵션이 활성화 되어 있을 경우 사용자는 에이전트 설치 할 때 설치 토큰을 입력해야 합니다.

.. note:: 사용자에게 파일 설치 권한이 없는 경우 설치 프로그램을 실행할 수 없으므로 파일 설치 권한으로 관리자 권한으로 실행해야합니다.


CWP를 통한 에이전트 설치
-------------------------------------------------------------------------

에이전트를 설치하지 않으면 제어정책에 의해 네트워크가 차단되고 에이전트 설치를 위한 CWP(Captive Web Portal)로 리다이렉션 될 수 있습니다.
CWP 화면에서 에이전트 설치 버튼을 클릭하여 에이전트를 다운로드하고 설치합니다. 

"에이전트 설치" 정책 옵션을 적용하려면

#. 상단 패널의 **정책** 으로 이동합니다.
#. **노드 정책** 으로 이동 하십시오.
#. "노드 정책 ID"를 클릭하여 정책을 적용 할 위치를 지정합니다.
#. **에이전트 정책** 항목을 찾습니다.
#. **에이전트** 체크박스에서 **on** 을 선택합니다.
#. 좌측메뉴의 **제어정책** 을 선택하여 **에이전트 미설치 차단** 정책을 활성화합니다.

.. note:: 노드 정책을 할당 받은 노드는 에이전트가 설치되지 않은 경우 제어정책(에이전트 미설치 차단 정책)에 의해 CWP 페이지로 리다이렉션 되고 CWP 페이지에 "에이전트 설치 버튼"을 표시합니다.

Active Directory GPO를 통한 에이전트 MSI 패키지 설치
----------------------------------------------------------

MSI 설치패키지 다운로드 
''''''''''''''''''''''''''''''''''
#. 관리 WebUI에 접속하여 상단 **시스템** 메뉴로 이동합니다. 좌측 **업데이트 관리 > 소프트웨어** 메뉴로 이동합니다. 
#. 현재 정책서버에 에이전트가 업로드가 되어있다면 **Genian ZTNA Agent for Windows** 항목 우측의 ``MSI`` 버튼을 클릭하면 MSI 설치패키지가 다운로드 됩니다. 

.. note::
   
   Genian ZTNA 버전은 :ref:`windows-agent-gpodeploy` 과정을 바로 진행합니다

      
   .. toctree::
      :maxdepth: 1

      install-orca
        
.. _windows-agent-gpodeploy:

Active Directory GPO정책을 이용한 에이전트 배포
''''''''''''''''''''''''''''''''''''''''''''''''''''

.. note:: 로그인한 계정의 권한이 사용자권한일 경우 에이전트가 제대로 작동하지 않을 수 있으며 **로컬 시스템 계정** 으로 에이전트 수행 계정을 변경해야합니다.

아래 순서에 따라 노드정책 에이전트의 수행계정을 수정합니다.:

#. 상단 패널의 정책 으로 이동합니다.
#. 노드 정책 으로 이동 하십시오.
#. "노드 정책 ID"를 클릭하여 정책을 적용 할 위치를 지정합니다.
#. 에이전트 정책 항목을 찾습니다.
#. 수행 계정에 로컬 시스템 계정 선택
#. 수정 및 변경정책적용 클릭
#. Active Directory GPO를 통하여 MSI 패키지 배포
 
   .. toctree::
      :maxdepth: 1

      deploy-msi-agent


Windows Agent 설치 확인
---------------------------

#. **관리 > 노드** 를 선택합니다.
#. 노드 리스트 창에서 **NT AG SS** 열을 클릭하십시오. (*노드에 설치된 에이전트가있는 경우 에이전트 아이콘* 이 표시 됩니다.)

Windows 단말의 Genian 에이전트 옵션
-----------------------------------------------

#. Windows 단말의 화면 우측하단 **TrayIcon** 위치로 이동합니다.
#. **Genians 에이전트 아이콘** 을 찾아 마우스 오른쪽 버튼으로 클릭합니다.
#. 나열된 옵션을 사용하여 다음을 수행 할 수 있습니다.

   -  **공지사항 보기:** 관리자로부터 현재 공지 사항을 보여 줍니다.
   -  **알림 메세지 보기:** 관리자의 현재 메시지를 표시합니다.
   -  **내상태 확인:** 현재 단말의 보안정책 만족상태를 웹페이지를 통해 보여줍니다.
   -  **사용자 인증 (L):** 사용자가 로그인 할 수 있으며 로그인 성공시 CWP 페이지가 표시 됩니다.
   -  **사용자 인증 해제 (O):** 사용자가 로그 아웃 할 수 있습니다.
   -  **사용자 인증 정보:** 사용자가 로그인 성공 시 계정 정보를 볼 수 있습니다.
   -  **네트워크 연결 정보:** 사용자가 활성화 된 네트워크 연결 단말를 볼 수 있습니다.
   -  **USB장치 정보:** 사용자가 USB 단말의 정보를 볼 수 있게합니다.
   -  **원격 에이전트 삭제:** (*사용자는 설치 된 에이전트를 삭제할 수 없습니다.이 작업은 관리자가 수행해야합니다*)
   -  **프로그램 정보:** 설치 된 Agent에 대한 버전 정보를 볼 수 있습니다.

.. _windows-agent-log:

Windows 단말 에이전트 로그 위치
--------------------------------------------------

#. Windows 단말에서 **파일 탐색기** 열기
#. **C: / Program Files / Geni / Genian / Logs** 로 이동합니다.
#. **수정 된 날짜** 로 정렬

.. note::

   에이전트 설치와 관련된 인스톨로그는 Windows 디렉토리에 ``Installer"년월일".log`` 로 존재합니다.

.. _windows-agent-os-info:

Windows 지원 목록
-----------------------------
.. csv-table::   
   :header: "Microsoft Windows OS (32bit/64bit)", "v6.0.x"
   :widths: 80 20


   "Microsoft Windows 8", "6.0.0~"
   "Microsoft Windows 8.1", "6.0.0~"
   "Microsoft Windows 10", "6.0.0"
   "Microsoft Windows 11", "6.0.0~"
   "Microsoft Windows Server 2012", "6.0.0~"
   "Microsoft Windows Server 2016", "6.0.0~"
   "Microsoft Windows Server 2019", "6.0.0~"
   "Microsoft Windows Server 2022", "6.0.24~"