Apple Business Manager는 이제 Apple Business입니다. Apple School Manager는 변경되지 않았습니다. 자세한 내용은 Introducing Apple Business 및 Apple Business Manager is now Apple Business를 참조하세요.
ADE 토큰 관리 정보
Automated Device Enrollment(ADE) 토큰은 디바이스 등록 기능을 유지하기 위해 주기적인 갱신 및 관리가 필요합니다. 이 프로세스를 통해 API 자동화를 사용하여 여러 ADE 토큰을 효율적으로 관리할 수 있으므로 수동 작업을 줄이고 일관된 토큰 수명 주기 관리를 보장할 수 있습니다.작동 방식
ADE 토큰 관리에는 Postman을 통해 Iru Endpoint API를 사용하여 여러 토큰에 대한 대량 작업을 수행하는 것이 포함됩니다. 이 프로세스에는 API 액세스 구성, 환경 변수 설정, Apple Business 또는 Apple School Manager에서 토큰 다운로드, 자동화된 워크플로를 사용한 효율적인 토큰 갱신, 업데이트 또는 삭제가 포함됩니다.사전 요구 사항
- API 토큰 생성 권한이 있는 Iru Endpoint 액세스
- 설치 및 구성된 Postman 애플리케이션
- Apple Business 또는 Apple School Manager 액세스
- 갱신 또는 관리가 필요한 여러 ADE 토큰
- API 작업 및 Postman 워크플로에 대한 기본적인 이해
Iru Endpoint API 토큰 구성
API 토큰을 준비하여 안전한 위치에 저장하세요. 자세한 내용은 Iru Endpoint API 문서를 참조하세요. 이미 API 토큰을 준비한 경우 이 섹션을 건너뛸 수 있습니다.1
API 토큰 생성 또는 수정
필요한 권한으로 새 API 토큰을 생성하거나 기존 토큰을 수정하세요.
2
API 토큰 열기
Iru Endpoint 테넌트의 사이드바에서 계정 메뉴 버튼을 선택한 다음 액세스 → API 토큰을 선택하세요.
3
권한 구성
모든 Automated Device Enrollment 관련 권한을 포함하도록 API 토큰을 생성하거나 기존 API 토큰을 수정하세요.
Postman 준비
이후 대부분의 단계는 디바이스의 Postman 애플리케이션에서 수행됩니다. 이미 Postman을 구성한 경우 이 섹션을 건너뛸 수 있습니다.1
컬렉션 구조 확인
컬렉션에 Automated Device Enrollment integrations 폴더가 있는지 확인하세요.
2
API URL 정의
API URL이 정의되지 않은 경우 컬렉션 상단의 Iru Endpoint API 폴더에서 정의하세요.
3
환경 변수 구성
How to Set Up the Iru Endpoint API in Postman 문서에 따라 환경 변수에서 API 토큰을 정의하세요.
Postman 환경 변수 구성
이제 Postman의 기본 사항이 구성되었으므로 Automated Device Enrollment 서버를 추적하기 위해 Postman에서 몇 가지 환경 변수를 정의해야 합니다.1
환경 변수 생성
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
- Initial Value:
<subdomain>을 테넌트의 실제 하위 도메인으로 바꾸거나 테넌트에서 기본 URL을 직접 복사하세요. 테넌트에 표시되는 URL은 api.kandji.io 도메인을 사용할 수 있습니다. <subdomain>.api.iru.com과 <subdomain>.api.kandji.io 모두 수정 없이 작동합니다.- Variable:
token- Initial Value:
your_api_token_here - Current Value:
your_api_token_here
- Initial Value:
2
기존 변수에 추가
이미 환경 변수가 구성되어 있는 경우 기존 변수에 새 항목을 추가할 수 있습니다.
3
ADE 통합 나열
컬렉션에서 Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations로 이동하세요.
4
요청 실행
보내기 버튼을 선택하여 요청을 실행하세요.
5
토큰 ID 복사
결과의 Body 섹션에서 각 Automated Device Enrollment 토큰의 최상위 ID를 복사하세요.
6
토큰 변수 생성
각 토큰 ID에 대해
ade_token_1, ade_token_2 등과 같이 토큰마다 숫자를 증가시키는 명명 체계로 환경 변수를 생성하세요.7
서버 이름 기록
각 토큰과 연결된
server_name을 기록해 두세요. Apple Business 또는 Apple School Manager에서 토큰을 다운로드할 때 이 정보가 필요합니다.8
변수 값 설정
각 토큰의 ID 값을 해당
ade_token_# 변수(예: ade_token_1, ade_token_2)에 붙여 넣으세요.9
변수 보호
변수 유형을 secret으로 설정하여 변수 값이 보이지 않도록 할 수 있습니다.
ADE 토큰 다운로드
1
Apple Business 또는 Apple School Manager에 액세스
Apple Business 또는 Apple School Manager 계정에 로그인하세요.
2
기기 탭 열기
페이지 상단에서 기기 탭을 선택하세요.
3
Management 열기
왼쪽 사이드바에서 Management를 선택하세요.
4
일치하는 디바이스 관리 서비스 선택
Management Services 목록에서 앞서 Postman에서 만든 목록의 첫 번째 ADE 통합의
server_name과 이름이 일치하는 서비스를 선택하세요.5
서비스 작업 메뉴 열기
해당 서비스의 줄임표(…)를 선택하세요.
6
토큰 다운로드
Download Token을 선택하세요.
7
모든 토큰에 대해 반복
갱신할 각 토큰에 대해 이 프로세스를 반복하세요.
Postman 폴더 템플릿 생성
Postman에서 폴더를 생성하면 Automated Device Enrollment 토큰을 더 쉽게 추적할 수 있습니다.1
폴더 옵션에 액세스
Automated Device Enrollment Integrations 폴더 옆의 줄임표를 선택하세요.
2
새 폴더 추가
Add folder를 선택하세요.
3
폴더 이름 지정
폴더 이름을 ADE_Token1로 지정하세요.
4
통합 항목 선택
Automated Device Enrollment Integrations 폴더로 이동하여 Renew ADE Integration 및 Update ADE Integration 항목을 선택하세요.
5
항목 복사
선택한 항목을 마우스 오른쪽 버튼으로 클릭(또는 Control-클릭)한 다음 복사를 선택하세요.
6
새 폴더에 액세스
ADE_Token1 폴더 옆의 줄임표를 선택하세요.
7
항목 붙여 넣기
Paste를 선택하여 복사한 항목을 새 폴더에 추가하세요.
Renew 항목 수정
1
Renew 항목 선택
토큰 폴더에서 Renew ADE Integration 항목을 선택하세요.
2
항목 이름 변경
이름을 Renew ADE1 Integration(또는 토큰 번호에 따라 Renew ADE2 Integration 등)으로 변경하세요.
3
주소 표시줄 업데이트
오른쪽 섹션에서 보내기 버튼 왼쪽의 주소 표시줄을 선택하세요.
4
토큰 변수 업데이트
{{ade_token_ade}} 안의 텍스트를 선택하고 {{ade_token_1}}(또는 토큰 번호에 따라 {{ade_token_2}} 등)로 업데이트하세요.5
본문 구성
아래의 Body 탭을 선택하세요.
6
토큰 세부 정보 입력
토큰과 연결할
blueprint_id, phone 및 email을 입력하세요.7
토큰 파일 선택
파일의 경우 현재 파일 옆의 x를 선택한 다음 Select Files 버튼을 선택하세요.
8
P7M 파일 선택
이 ADE 토큰과 일치하는 .p7m 파일을 선택하세요.
9
변경 사항 저장
변경 사항을 저장하세요.
Update 항목 수정
1
업데이트 항목 선택
토큰 폴더에서 Update ADE Integration 항목을 선택하세요.
2
항목 이름 변경
이름을 Update ADE1 Integration(또는 토큰 번호에 따라 Update ADE2 Integration 등)으로 변경하세요.
3
주소 표시줄 업데이트
오른쪽 섹션에서 보내기 버튼 왼쪽의 주소 표시줄을 선택하세요.
4
토큰 변수 업데이트
{{ade_token_ade}} 안의 텍스트를 선택하고 {{ade_token_1}}(또는 토큰 번호에 따라 {{ade_token_2}} 등)로 업데이트하세요.5
본문 구성
아래의 Body 탭을 선택하세요.
6
업데이트 정보 입력
여기에서 새
blueprint_id, phone 및 email 정보를 입력할 수 있습니다.7
변경 사항 저장
변경 사항을 저장하세요.
ADE_Token 폴더 복제
1
폴더 옵션에 액세스
ADE_Token1 폴더 옆의 줄임표를 선택하세요.
2
폴더 복제
Duplicate를 선택하세요.
3
폴더 내용 업데이트
위의 프로세스를 사용하여 폴더의 내용을 업데이트하세요.
4
추가 폴더 생성
각 ADE 토큰에 대해 폴더의 복제본을 만드세요.
ADE 통합 갱신
이제 모든 구성이 완료되었으므로 Renew 명령을 보낼 수 있습니다.1
Renew 명령 선택
생성한 특정 토큰 폴더(예: ADE_Token1, ADE_Token2 등)로 이동하여 토큰 번호에 해당하는 Renew ADE1 Integration(또는 Renew ADE2 Integration 등) 항목을 선택하세요.
2
명령 실행
Send 버튼을 선택하세요.
ADE 통합 업데이트
ADE 통합을 업데이트하면 연결된 Blueprint ID, 전화번호 및 이메일 주소를 변경할 수 있습니다.1
업데이트 명령 선택
생성한 특정 토큰 폴더(예: ADE_Token1, ADE_Token2 등)로 이동하여 토큰 번호에 해당하는 Update ADE1 Integration(또는 Update ADE2 Integration 등) 항목을 선택하세요.
2
세부 정보 업데이트
Body 섹션에서 업데이트가 필요한 세부 정보를 업데이트하세요.
3
명령 실행
Send 버튼을 선택하세요.
현재 통합 확인
Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations 명령은 현재의 모든 ADE 통합을 반환하므로 통합이 성공적으로 갱신 또는 업데이트되었는지 확인할 수 있습니다.1
List 명령 선택
컬렉션에서 Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations를 선택하세요.
2
명령 실행
Send 버튼을 선택하세요.
3
갱신 확인
Renew 명령이 성공했다면
days_left 변수가 364여야 합니다.4
업데이트 확인
업데이트를 확인하려면 ADE 토큰과 연결된 정보를 확인하여 업데이트되었는지 검증하세요.
통합 삭제
Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration 명령은 제공된 ADE 토큰 ID와 연결된 ADE 통합을 삭제합니다.1
삭제 명령 선택
컬렉션에서 Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration을 선택하세요.
2
토큰 ID 설정
ade_token_id 변수에 ADE 토큰의 ID를 입력하세요.3
명령 실행
Send 버튼을 선택하세요.
고려 사항
API 보안, Postman 및 환경 설정
API 보안, Postman 및 환경 설정
- API 토큰 보안: API 토큰이 안전하게 저장되어 있고 ADE 작업에 적절한 권한이 있는지 확인하세요
- Postman 구성: API 작업을 성공적으로 수행하려면 올바른 Postman 설정이 필수적입니다
- 환경 변수: 환경 변수를 사용하여 여러 토큰 ID를 효율적으로 관리하세요
- 오류 처리: API 오류 및 토큰 검증 문제를 해결할 준비를 하세요
토큰, 파일 및 Apple 포털 액세스
토큰, 파일 및 Apple 포털 액세스
- 토큰 수명 주기: ADE 토큰에는 만료 날짜가 있으며 등록 기능을 유지하려면 주기적으로 갱신해야 합니다
- 토큰 파일 관리: 다운로드한 .p7m 파일을 추적하고 올바른 토큰 ID와 연결하세요
- Apple Business 또는 Apple School Manager 액세스: 포털에 로그인하여 토큰을 다운로드할 수 있는지 확인하세요
- 확인 프로세스: 통합 상태와 토큰 만료를 확인하여 작업이 성공했는지 항상 검증하세요
대량 작업 및 액세스 제어
대량 작업 및 액세스 제어
- 대량 작업: 폴더 템플릿을 사용하여 여러 토큰을 효율적으로 관리하세요
- 액세스 제어: 승인된 담당자만 토큰 관리 작업에 액세스할 수 있도록 하세요
테스트, 모니터링 및 연속성
테스트, 모니터링 및 연속성
- 테스트: 대량 작업을 수행하기 전에 소규모로 작업을 테스트하세요
- 모니터링: 토큰 만료 날짜 및 갱신 일정을 정기적으로 모니터링하세요
- 문서화: 토큰 구성 및 연결된 서버 이름에 대한 기록을 유지하세요
- 백업 전략: 토큰 구성 및 API 설정의 백업을 유지하세요