.. _deleting-agent:

에이전트 삭제
=================

사용자 단말에서 에이전트를 제거하는 방법은 아래와 같습니다. 
   - 노드 정책의 **에이전트정책**
   - 에이전트 설정의 **인증코드 사용**
   - 에이전트 설정의 **인증코드 미사용**

노드정책의 에이전트정책을 사용하여 에이전트 삭제
----------------------------------------------------------------

다음은 관리자가 다수의 장치에서 에이전트를 일괄삭제하는 방법입니다.

#. **노드 그룹** 을 생성하여 에이전트를 삭제할 노드를 추가 하십시오.

#. **노드 정책** 을 생성하여 선택한 노드에서 에이전트를 삭제 하십시오.
  
   - 아래 : **노드정책** 에서 에이전트 정책 항목 메뉴의 Delete 옵션을 설정합니다. 

#. 노드 정책을 작성한 후 오른쪽 상단 의 **적용** 옵션을 클릭하십시오. 

그러면 노드 정책이 에이전트에서 업데이트 될 때 지정된 장치에서 에이전트가 자동으로 삭제 됩니다.  

.. note:: Active Directory의 GPO정책으로 설치한 단말의 에이전트는 반드시 단말의 GPO정책을 제거해야합니다. 

관리자 인증코드를 사용하여 에이전트 삭제 
------------------------------------------------------

이 방법은 **인증코드 사용** 설정일때 사용합니다. 사용자가 삭제 요청 > 관리자 코드 발급 방식으로 진행됩니다.

**엔드포인트 사용자** 삭제 요청 :

#. Windows 또는 macOS 시스템의 작업 표시줄로 이동하여 Genians 아이콘을 찾습니다.
#. 로고를 마우스 오른쪽 단추로 클릭하고 **원격 에이전트 삭제 (D)** 옵션을 선택하십시오.
#. 팝업 창에서 **에이전트 코드** 를 찾아 Genian ZTNA 관리자에게 제공하여 **인증 코드** 를 요청하십시오. 
#. 제공받은 **인증 코드** 를 입력하고 **삭제** 버튼을 클릭하십시오.

**관리자 인증코드** 발급 :

#. 정책서버 관리WebUI에 로그인하십시오. 
#. 상단 **관리 > 신청** 메뉴를 선택하십시오.
#. 좌측 하단 **에이전트 인증코드 발급** 을 선택하여 **에이전트 인증코드 발급** 메뉴로 이동 하십시오.
#. 엔드 포인트 사용자가 제공 한 **에이전트 코드** 를 입력하고 **인증코드 발급** 버튼을 클릭하십시오.
#. **인증 코드** 가 표시 됩니다. 최종 사용자에게 이 코드를 제공하십시오. 

.. note:: #. 에이전트가 오프라인 상태여도 정책서버에서 발급한 인증코드를 사용하여 에이전트 삭제가 가능합니다. 
          #. 에이전트 인증코드 발급 결과 부분은 다음에 :ref:`agent-authentication-code-result` 참고하시기 바랍니다.

**정책서버를 이용하여 삭제코드를 발급 할수 없는 경우**

에이전트를 삭제하기 위해서는 에이전트 설치에 사용 된 정책 서버가 필요합니다. 
이 정책 서버를 더 이상 사용할 수 없으면 새로운 정책 서버가 필요합니다.

#. 새로운 정책 서버를 설치하십시오.
#. 새 정책 서버의 에이전트를 설치하십시오. 기존 에이전트를 삭제하고 새 에이전트로 덮어쓰기 됩니다.
#. 노드 정책 또는 삭제 코드를 사용하여 에이전트를 삭제하십시오.

.. _deleting-agent-self:

사용자 직접 삭제 방법
------------------------------

이 방법은 **인증코드 미사용** 설정일때 사용합니다. 사용자가 에이전트를 직접 삭제하는 방법입니다. 

**사용자 직접삭제** 방법 :

#. Windows 또는 macOS의 트레이 바에서 ZTNA 아이콘을 찾습니다.
#. 아이콘을 마우스 우측 버튼으로 클릭하여 **원격 에이전트 삭제 (D)** 를 선택합니다.

.. note:: 에이전트 삭제방식이 **지원 안함** 인 경우에는 트레이 메뉴에서 에이전트를 삭제 할 수 없습니다.