> ## 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.

# Iru API를 사용하여 ADE 토큰 갱신, 업데이트 또는 삭제

> Iru Endpoint API로 Automated Device Enrollment 토큰을 갱신, 업데이트 또는 삭제하여 만료를 방지하고 Apple Business 연결을 유지합니다.

<Note title="Apple Business 이름 변경">
  **Apple Business Manager**는 이제 **Apple Business**입니다. **Apple School Manager**는 변경되지 않았습니다. 자세한 내용은 [Introducing Apple Business](https://www.apple.com/newsroom/2026/03/introducing-apple-business-a-new-all-in-one-platform-for-businesses-of-all-sizes/) 및 [Apple Business Manager is now Apple Business](https://support.apple.com/guide/apple-business-manager/apple-business-manager-is-now-apple-business-axmd79d79dea/web)를 참조하세요.
</Note>

### ADE 토큰 관리 정보

Automated Device Enrollment(ADE) 토큰은 디바이스 등록 기능을 유지하기 위해 주기적인 갱신 및 관리가 필요합니다. 이 프로세스를 통해 API 자동화를 사용하여 여러 ADE 토큰을 효율적으로 관리할 수 있으므로 수동 작업을 줄이고 일관된 토큰 수명 주기 관리를 보장할 수 있습니다.

### 작동 방식

ADE 토큰 관리에는 Postman을 통해 Iru Endpoint API를 사용하여 여러 토큰에 대한 대량 작업을 수행하는 것이 포함됩니다. 이 프로세스에는 API 액세스 구성, 환경 변수 설정, Apple Business 또는 Apple School Manager에서 토큰 다운로드, 자동화된 워크플로를 사용한 효율적인 토큰 갱신, 업데이트 또는 삭제가 포함됩니다.

<Warning>
  이 프로세스를 직접 완료하는 데 자신이 없는 경우 추가 안내를 위해 [Iru Endpoint 지원팀](/ko/iru/iru-support/access-to-iru-support)에 문의하세요.
</Warning>

### 사전 요구 사항

* API 토큰 생성 권한이 있는 Iru Endpoint 액세스
* 설치 및 구성된 Postman 애플리케이션
* Apple Business 또는 Apple School Manager 액세스
* 갱신 또는 관리가 필요한 여러 ADE 토큰
* API 작업 및 Postman 워크플로에 대한 기본적인 이해

### Iru Endpoint API 토큰 구성

API 토큰을 준비하여 안전한 위치에 저장하세요. 자세한 내용은 [Iru Endpoint API](/en/endpoint/api/iru-api-overview) 문서를 참조하세요. 이미 API 토큰을 준비한 경우 이 섹션을 건너뛸 수 있습니다.

<Steps>
  <Step title="API 토큰 생성 또는 수정">
    필요한 권한으로 새 API 토큰을 생성하거나 기존 토큰을 수정하세요.
  </Step>

  <Step title="API 토큰 열기">
    Iru Endpoint 테넌트의 사이드바에서 [**계정 메뉴 버튼**](/ko/iru/platform-overview/account-menu)을 선택한 다음 **액세스** → **API 토큰**을 선택하세요.
  </Step>

  <Step title="권한 구성">
    모든 Automated Device Enrollment 관련 권한을 포함하도록 API 토큰을 생성하거나 기존 API 토큰을 수정하세요.
  </Step>
</Steps>

### Postman 준비

이후 대부분의 단계는 디바이스의 Postman 애플리케이션에서 수행됩니다. 이미 Postman을 구성한 경우 이 섹션을 건너뛸 수 있습니다.

<Steps>
  <Step title="컬렉션 구조 확인">
    컬렉션에 Automated Device Enrollment integrations 폴더가 있는지 확인하세요.
  </Step>

  <Step title="API URL 정의">
    API URL이 정의되지 않은 경우 컬렉션 상단의 Iru Endpoint API 폴더에서 정의하세요.
  </Step>

  <Step title="환경 변수 구성">
    How to Set Up the Iru Endpoint API in Postman 문서에 따라 환경 변수에서 API 토큰을 정의하세요.
  </Step>
</Steps>

### Postman 환경 변수 구성

이제 Postman의 기본 사항이 구성되었으므로 Automated Device Enrollment 서버를 추적하기 위해 Postman에서 몇 가지 환경 변수를 정의해야 합니다.

<Steps>
  <Step title="환경 변수 생성">
    Postman의 왼쪽 사이드바에서 **Environments** 탭을 선택한 다음 **Create Environment**를 선택하여 새 환경을 생성하세요. 환경 이름을 지정하고(예: "Iru Endpoint API") 다음 변수를 추가하세요.

    * **Variable**: `base_url`
      * **Initial Value**: `https://<subdomain>.api.iru.com/api/v1`
      * **Current Value**: `https://<subdomain>.api.iru.com/api/v1`

    <Note>`<subdomain>`을 테넌트의 실제 하위 도메인으로 바꾸거나 테넌트에서 기본 URL을 직접 복사하세요. 테넌트에 표시되는 URL은 `api.kandji.io` 도메인을 사용할 수 있습니다. `<subdomain>.api.iru.com`과 `<subdomain>.api.kandji.io` 모두 수정 없이 작동합니다.</Note>

    * **Variable**: `token`
      * **Initial Value**: `your_api_token_here`
      * **Current Value**: `your_api_token_here`

    **저장**을 선택하여 환경을 저장한 다음 오른쪽 상단의 환경 드롭다운에서 새로 생성한 환경을 선택하세요.
  </Step>

  <Step title="기존 변수에 추가">
    이미 환경 변수가 구성되어 있는 경우 기존 변수에 새 항목을 추가할 수 있습니다.
  </Step>

  <Step title="ADE 통합 나열">
    컬렉션에서 **Iru Endpoint API** > **Automated Device Enrollment Integrations** > **GET List ADE Integrations**로 이동하세요.
  </Step>

  <Step title="요청 실행">
    **보내기** 버튼을 선택하여 요청을 실행하세요.
  </Step>

  <Step title="토큰 ID 복사">
    결과의 **Body** 섹션에서 각 Automated Device Enrollment 토큰의 최상위 ID를 복사하세요.
  </Step>

  <Step title="토큰 변수 생성">
    각 토큰 ID에 대해 `ade_token_1`, `ade_token_2` 등과 같이 토큰마다 숫자를 증가시키는 명명 체계로 환경 변수를 생성하세요.
  </Step>

  <Step title="서버 이름 기록">
    각 토큰과 연결된 `server_name`을 기록해 두세요. Apple Business 또는 Apple School Manager에서 토큰을 다운로드할 때 이 정보가 필요합니다.
  </Step>

  <Step title="변수 값 설정">
    각 토큰의 ID 값을 해당 `ade_token_#` 변수(예: `ade_token_1`, `ade_token_2`)에 붙여 넣으세요.
  </Step>

  <Step title="변수 보호">
    변수 유형을 secret으로 설정하여 변수 값이 보이지 않도록 할 수 있습니다.
  </Step>
</Steps>

### ADE 토큰 다운로드

<Steps>
  <Step title="Apple Business 또는 Apple School Manager에 액세스">
    [Apple Business](https://business.apple.com) 또는 [Apple School Manager](https://school.apple.com) 계정에 로그인하세요.
  </Step>

  <Step title="기기 탭 열기">
    페이지 상단에서 **기기** 탭을 선택하세요.
  </Step>

  <Step title="Management 열기">
    왼쪽 사이드바에서 **Management**를 선택하세요.
  </Step>

  <Step title="일치하는 디바이스 관리 서비스 선택">
    **Management Services** 목록에서 앞서 Postman에서 만든 목록의 첫 번째 ADE 통합의 `server_name`과 이름이 일치하는 서비스를 선택하세요.
  </Step>

  <Step title="서비스 작업 메뉴 열기">
    해당 서비스의 줄임표(**…**)를 선택하세요.
  </Step>

  <Step title="토큰 다운로드">
    **Download Token**을 선택하세요.
  </Step>

  <Step title="모든 토큰에 대해 반복">
    갱신할 각 토큰에 대해 이 프로세스를 반복하세요.
  </Step>
</Steps>

### Postman 폴더 템플릿 생성

Postman에서 폴더를 생성하면 Automated Device Enrollment 토큰을 더 쉽게 추적할 수 있습니다.

<Steps>
  <Step title="폴더 옵션에 액세스">
    Automated Device Enrollment Integrations 폴더 옆의 줄임표를 선택하세요.
  </Step>

  <Step title="새 폴더 추가">
    Add folder를 선택하세요.
  </Step>

  <Step title="폴더 이름 지정">
    폴더 이름을 ADE\_Token1로 지정하세요.
  </Step>

  <Step title="통합 항목 선택">
    **Automated Device Enrollment Integrations** 폴더로 이동하여 **Renew ADE Integration** 및 **Update ADE Integration** 항목을 선택하세요.
  </Step>

  <Step title="항목 복사">
    선택한 항목을 마우스 오른쪽 버튼으로 클릭(또는 Control-클릭)한 다음 **복사**를 선택하세요.
  </Step>

  <Step title="새 폴더에 액세스">
    ADE\_Token1 폴더 옆의 줄임표를 선택하세요.
  </Step>

  <Step title="항목 붙여 넣기">
    **Paste**를 선택하여 복사한 항목을 새 폴더에 추가하세요.
  </Step>
</Steps>

### Renew 항목 수정

<Steps>
  <Step title="Renew 항목 선택">
    토큰 폴더에서 **Renew ADE Integration** 항목을 선택하세요.
  </Step>

  <Step title="항목 이름 변경">
    이름을 **Renew ADE1 Integration**(또는 토큰 번호에 따라 **Renew ADE2 Integration** 등)으로 변경하세요.
  </Step>

  <Step title="주소 표시줄 업데이트">
    오른쪽 섹션에서 **보내기** 버튼 왼쪽의 주소 표시줄을 선택하세요.
  </Step>

  <Step title="토큰 변수 업데이트">
    `{{ade_token_ade}}` 안의 텍스트를 선택하고 `{{ade_token_1}}`(또는 토큰 번호에 따라 `{{ade_token_2}}` 등)로 업데이트하세요.
  </Step>

  <Step title="본문 구성">
    아래의 Body 탭을 선택하세요.
  </Step>

  <Step title="토큰 세부 정보 입력">
    토큰과 연결할 `blueprint_id`, phone 및 email을 입력하세요.
  </Step>

  <Step title="토큰 파일 선택">
    파일의 경우 현재 파일 옆의 x를 선택한 다음 Select Files 버튼을 선택하세요.
  </Step>

  <Step title="P7M 파일 선택">
    이 ADE 토큰과 일치하는 .p7m 파일을 선택하세요.
  </Step>

  <Step title="변경 사항 저장">
    변경 사항을 저장하세요.
  </Step>
</Steps>

### Update 항목 수정

<Steps>
  <Step title="업데이트 항목 선택">
    토큰 폴더에서 **Update ADE Integration** 항목을 선택하세요.
  </Step>

  <Step title="항목 이름 변경">
    이름을 **Update ADE1 Integration**(또는 토큰 번호에 따라 **Update ADE2 Integration** 등)으로 변경하세요.
  </Step>

  <Step title="주소 표시줄 업데이트">
    오른쪽 섹션에서 **보내기** 버튼 왼쪽의 주소 표시줄을 선택하세요.
  </Step>

  <Step title="토큰 변수 업데이트">
    `{{ade_token_ade}}` 안의 텍스트를 선택하고 `{{ade_token_1}}`(또는 토큰 번호에 따라 `{{ade_token_2}}` 등)로 업데이트하세요.
  </Step>

  <Step title="본문 구성">
    아래의 Body 탭을 선택하세요.
  </Step>

  <Step title="업데이트 정보 입력">
    여기에서 새 `blueprint_id`, phone 및 email 정보를 입력할 수 있습니다.
  </Step>

  <Step title="변경 사항 저장">
    변경 사항을 저장하세요.
  </Step>
</Steps>

### ADE\_Token 폴더 복제

<Steps>
  <Step title="폴더 옵션에 액세스">
    ADE\_Token1 폴더 옆의 줄임표를 선택하세요.
  </Step>

  <Step title="폴더 복제">
    Duplicate를 선택하세요.
  </Step>

  <Step title="폴더 내용 업데이트">
    위의 프로세스를 사용하여 폴더의 내용을 업데이트하세요.
  </Step>

  <Step title="추가 폴더 생성">
    각 ADE 토큰에 대해 폴더의 복제본을 만드세요.
  </Step>
</Steps>

### ADE 통합 갱신

이제 모든 구성이 완료되었으므로 Renew 명령을 보낼 수 있습니다.

<Steps>
  <Step title="Renew 명령 선택">
    생성한 특정 토큰 폴더(예: **ADE\_Token1**, **ADE\_Token2** 등)로 이동하여 토큰 번호에 해당하는 **Renew ADE1 Integration**(또는 **Renew ADE2 Integration** 등) 항목을 선택하세요.
  </Step>

  <Step title="명령 실행">
    Send 버튼을 선택하세요.
  </Step>
</Steps>

### ADE 통합 업데이트

ADE 통합을 업데이트하면 연결된 Blueprint ID, 전화번호 및 이메일 주소를 변경할 수 있습니다.

<Steps>
  <Step title="업데이트 명령 선택">
    생성한 특정 토큰 폴더(예: **ADE\_Token1**, **ADE\_Token2** 등)로 이동하여 토큰 번호에 해당하는 **Update ADE1 Integration**(또는 **Update ADE2 Integration** 등) 항목을 선택하세요.
  </Step>

  <Step title="세부 정보 업데이트">
    Body 섹션에서 업데이트가 필요한 세부 정보를 업데이트하세요.
  </Step>

  <Step title="명령 실행">
    Send 버튼을 선택하세요.
  </Step>
</Steps>

### 현재 통합 확인

Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations 명령은 현재의 모든 ADE 통합을 반환하므로 통합이 성공적으로 갱신 또는 업데이트되었는지 확인할 수 있습니다.

<Steps>
  <Step title="List 명령 선택">
    컬렉션에서 Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations를 선택하세요.
  </Step>

  <Step title="명령 실행">
    Send 버튼을 선택하세요.
  </Step>

  <Step title="갱신 확인">
    Renew 명령이 성공했다면 `days_left` 변수가 364여야 합니다.
  </Step>

  <Step title="업데이트 확인">
    업데이트를 확인하려면 ADE 토큰과 연결된 정보를 확인하여 업데이트되었는지 검증하세요.
  </Step>
</Steps>

### 통합 삭제

Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration 명령은 제공된 ADE 토큰 ID와 연결된 ADE 통합을 삭제합니다.

<Steps>
  <Step title="삭제 명령 선택">
    컬렉션에서 Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration을 선택하세요.
  </Step>

  <Step title="토큰 ID 설정">
    `ade_token_id` 변수에 ADE 토큰의 ID를 입력하세요.
  </Step>

  <Step title="명령 실행">
    Send 버튼을 선택하세요.
  </Step>
</Steps>

### 고려 사항

<AccordionGroup>
  <Accordion title="API 보안, Postman 및 환경 설정">
    * **API 토큰 보안**: API 토큰이 안전하게 저장되어 있고 ADE 작업에 적절한 권한이 있는지 확인하세요
    * **Postman 구성**: API 작업을 성공적으로 수행하려면 올바른 Postman 설정이 필수적입니다
    * **환경 변수**: 환경 변수를 사용하여 여러 토큰 ID를 효율적으로 관리하세요
    * **오류 처리**: API 오류 및 토큰 검증 문제를 해결할 준비를 하세요
  </Accordion>

  <Accordion title="토큰, 파일 및 Apple 포털 액세스">
    * **토큰 수명 주기**: ADE 토큰에는 만료 날짜가 있으며 등록 기능을 유지하려면 주기적으로 갱신해야 합니다
    * **토큰 파일 관리**: 다운로드한 .p7m 파일을 추적하고 올바른 토큰 ID와 연결하세요
    * **Apple Business 또는 Apple School Manager 액세스**: 포털에 로그인하여 토큰을 다운로드할 수 있는지 확인하세요
    * **확인 프로세스**: 통합 상태와 토큰 만료를 확인하여 작업이 성공했는지 항상 검증하세요
  </Accordion>

  <Accordion title="대량 작업 및 액세스 제어">
    * **대량 작업**: 폴더 템플릿을 사용하여 여러 토큰을 효율적으로 관리하세요
    * **액세스 제어**: 승인된 담당자만 토큰 관리 작업에 액세스할 수 있도록 하세요
  </Accordion>

  <Accordion title="테스트, 모니터링 및 연속성">
    * **테스트**: 대량 작업을 수행하기 전에 소규모로 작업을 테스트하세요
    * **모니터링**: 토큰 만료 날짜 및 갱신 일정을 정기적으로 모니터링하세요
    * **문서화**: 토큰 구성 및 연결된 서버 이름에 대한 기록을 유지하세요
    * **백업 전략**: 토큰 구성 및 API 설정의 백업을 유지하세요
  </Accordion>
</AccordionGroup>