> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 체크인 문제 해결

> macOS 및 Windows에서 Iru Agent 체크인 실패를 진단하고 해결합니다. 네트워크 문제, 인증서 오류 및 연결 문제를 해결합니다.

<Callout icon="list-check" color="#B84A7A" iconType="regular">이 가이드는 Mac 컴퓨터 및 Windows 컴퓨터에 적용됩니다</Callout>

### 에이전트 체크인 문제 정보

Iru Endpoint에 등록된 macOS 및 Windows 컴퓨터는 다양한 관리 작업에 Iru Agent를 사용합니다. 에이전트는 15분마다 체크인을 시도합니다. 디바이스가 예상대로 체크인하지 않는 경우 다음 단계를 통해 통신을 복원할 수 있습니다.

<Note>
  **2026년 4월 8일**부로 앱의 브랜딩이 **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" />에서 **Iru** <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" />로 업데이트되었습니다. 앱 이름이 **Kandji Self Service**에서 **Iru Self Service**로, **Kandji Agent**에서 **Iru Agent**로 변경되었습니다. 수동 등록 포털도 이제 Iru 브랜딩을 사용합니다. 이전 앱 이름을 여전히 참조하는 **스크립트, 자동화 및 유틸리티**를 업데이트하십시오.
</Note>

### 작동 방식

Iru Agent는 Iru Endpoint 서버와 통신하여 구성 업데이트, 정책 변경 및 애플리케이션 배포를 받습니다. 체크인이 실패하면 디바이스가 중요한 업데이트를 받지 못해 규정 준수 문제나 오래된 구성이 발생할 수 있습니다.

### 인터넷 연결 확인

디바이스가 [엔터프라이즈 네트워크에서 Iru 사용](/ko/iru/requirements/using-iru-on-enterprise-networks)에 설명된 도메인 및 포트에 액세스할 수 있는 활성 인터넷 연결을 갖추고 있는지 확인하십시오.

빠른 문제 해결 단계는 다음과 같습니다.

* 모바일 핫스팟과 같은 다른 네트워크에 디바이스를 연결해 봅니다
* 체크인이 재개되면 원래 네트워크의 필터링 또는 방화벽 구성에 문제가 있을 수 있습니다

### 플랫폼별 문제 해결

<Tabs>
  <Tab title="macOS" icon="apple" iconType="brands">
    ### 체크인 강제 실행(macOS)

    #### Self Service

    * 최종 사용자는 **Iru Self Service**를 열고 **Device Info**로 이동하여 **동기화**를 선택할 수 있습니다

    #### 명령줄

    * **Terminal**에서 다음 명령을 실행하여 체크인을 강제로 실행합니다.

    ```bash theme={null}
    sudo iru run -F
    ```

    출력에 추가 세부 정보가 표시될 수 있습니다.

    ### Iru Agent 재설치

    macOS에서는 Iru 웹 앱에서 Iru Agent를 재설치할 수 있습니다.

    <Steps>
      <Step title="디바이스 레코드에 액세스">
        Iru 웹 앱에서 디바이스 레코드로 이동합니다
      </Step>

      <Step title="에이전트 재설치">
        디바이스 작업 메뉴에서 **Reinstall Agent**를 선택합니다
      </Step>

      <Step title="설치 상태 모니터링">
        **활동** 탭에서 상태를 모니터링합니다. `InstallEnterpriseApplication` MDM 명령을 찾습니다
      </Step>
    </Steps>

    <Note>
      명령이 **NotNow**(디바이스가 사용 중)를 반환하는 경우:

      * Mac에 사용자가 로그인되어 있고 전원에 연결되어 있는지 확인한 후 다시 시도하십시오. [Apple 개발자 문서](https://developer.apple.com/documentation/devicemanagement/implementing_device_management/handling_notnow_status_responses)를 참조하십시오
    </Note>

    ### 재시동 고려 사항

    * 재시동 후 Iru는 macOS가 업데이트 및 백그라운드 작업을 완료할 수 있도록 체크인하기까지 최대 30분 동안 기다릴 수 있습니다

    ### 에이전트 상태 확인

    에이전트 상태 확인:

    ```bash theme={null}
    sudo iru library --state
    ```
  </Tab>

  <Tab title="Windows" icon="microsoft" iconType="brands">
    ### 체크인 강제 실행(Windows)

    #### Iru Agent 서비스 다시 시작

    * **Windows** 아이콘을 마우스 오른쪽 버튼으로 클릭하고 **Run**을 선택합니다
    * `services.msc`를 입력하고 **Enter**를 누릅니다
    * 서비스 목록에서 **Iru Agent**를 찾습니다
    * **Iru Agent**를 마우스 오른쪽 버튼으로 클릭하고 **재시작**을 선택합니다

    이렇게 하면 즉시 체크인이 강제로 실행됩니다.

    #### 명령줄

    * 관리자 권한으로 **PowerShell**에서 다음 명령을 실행합니다.

    ```powershell theme={null}
    dsregcmd /status
    ```

    ### Iru Agent 재설치

    Windows에서는 새 앱이나 정책을 디바이스에 푸시하거나, 에이전트가 설치될 수 있도록 다시 등록할 수 있습니다.

    ### 재시동 고려 사항

    * 체크인은 일반적으로 15분 Agent 주기 내에 재개됩니다

    ### 에이전트 로그 확인

    에이전트 로그 위치:

    ```
    %ProgramData%\kandji\agent\logs
    ```

    ### 에이전트 상태 확인

    다음 위치에서 에이전트 상태를 확인합니다.

    * **설정** > **계정** > **Access work or school**
    * **Event Viewer** > **Applications and Services Logs** > **Microsoft** > **Windows** > **DeviceManagement-Enterprise-Diagnostics-Provider**
  </Tab>
</Tabs>

### 재시동

디바이스를 재시동하면 멈춘 프로세스가 해결되어 Iru Agent가 정상적인 체크인을 재개할 수 있습니다.

### 다시 등록

위 단계로 문제가 해결되지 않으면 디바이스를 수동으로 다시 등록하십시오.

<Steps>
  <Step title="기존 등록 제거">
    기존 MDM 등록을 제거합니다
  </Step>

  <Step title="디바이스 다시 등록">
    올바른 **등록 코드**를 사용하여 다시 등록합니다
  </Step>
</Steps>

<Note>
  디바이스를 등록할 때 올바른 Blueprint가 선택되었는지 확인하십시오. 다른 Blueprint를 선택하면 디바이스는 해당 Blueprint에 할당된 Library Items 및 Parameters를 적용합니다. 다시 등록한 후에도 디바이스 레코드는 중복되지 않습니다. Iru Endpoint는 새 등록을 기존 디바이스 레코드에 연결합니다.
</Note>

### 고급 문제 해결

다음 항목에 대한 로그를 검토합니다.

* 설치 오류
* 정책 실패
* 통신 문제
* 네트워크 연결 문제

### 네트워크 진단

<Steps>
  <Step title="연결 테스트">
    네트워크 진단 도구를 사용하여 Iru 서비스에 대한 연결을 테스트합니다
  </Step>

  <Step title="방화벽 확인">
    방화벽 규칙이 Iru 도메인과의 통신을 허용하는지 확인합니다
  </Step>

  <Step title="DNS 테스트">
    Iru 도메인에 대한 DNS 확인이 작동하는지 확인합니다
  </Step>

  <Step title="프록시 확인">
    해당하는 경우 프록시 설정을 확인합니다
  </Step>
</Steps>

### 일반적인 문제 및 해결 방법

<AccordionGroup>
  <Accordion title="에이전트가 응답하지 않음">
    **증상:**

    * Iru에서 디바이스가 오프라인으로 표시됨
    * 디바이스 레코드에 최근 체크인이 없음
    * 정책이 적용되지 않음

    **해결 방법:**

    * 인터넷 연결 확인
    * 디바이스 재시동
    * 수동 체크인 강제 실행
    * 필요한 경우 에이전트 재설치
  </Accordion>

  <Accordion title="체크인 실패">
    **증상:**

    * 에이전트 로그의 오류 메시지
    * 네트워크 연결 문제
    * 방화벽이 통신을 차단함

    **해결 방법:**

    * 네트워크 연결 확인
    * 방화벽 규칙 확인
    * 다른 네트워크로 테스트
    * 에이전트 로그에서 특정 오류 검토
  </Accordion>

  <Accordion title="에이전트 설치 문제">
    **증상:**

    * 등록 후 에이전트가 설치되지 않음
    * 로그의 설치 오류
    * 디바이스가 Iru에 표시되지 않음

    **해결 방법:**

    * 디바이스가 요구 사항을 충족하는지 확인
    * 등록 중 네트워크 연결 확인
    * 설치 로그 검토
  </Accordion>
</AccordionGroup>

### 모범 사례

<CardGroup cols={2}>
  <Card title="정기적으로 모니터링" icon="eye">
    디바이스 체크인 상태를 정기적으로 모니터링하여 문제를 조기에 식별하십시오
  </Card>

  <Card title="연결 테스트" icon="wifi">
    관리되는 디바이스에서 Iru 서비스에 대한 네트워크 연결을 테스트하십시오
  </Card>

  <Card title="로그 검토" icon="file-text">
    잠재적인 문제가 있는지 에이전트 로그를 정기적으로 검토하십시오
  </Card>

  <Card title="문제 문서화" icon="book">
    향후 참조를 위해 반복되는 문제와 해결 방법을 문서화하십시오
  </Card>
</CardGroup>