Apple Business에서 API 계정 생성
개요
Apple Business API를 통해 기기 관리 할당 편집, 기기 정보 확인, 기기 할당 워크플로 자동화와 타사 플랫폼에 기기 재고 데이터를 통합할 수 있으며, 수동으로 웹 포털에서 열람할 필요가 없도록 하는 사용자 설정 대시보드 제작을 진행할 수도 있습니다. API는 OAuth 2를 지원하며, 이를 사용하면 앱은 자격 증명을 통해 인증을 받고, 인증된 API를 요청할 수 있는 액세스 토큰을 발급받습니다.
해당 API를 사용하려면 먼저 Apple Business에서 API 계정을 생성해야 합니다. “조직 책임자” 역할의 사용자만 API 계정을 생성할 수 있습니다.
참고: API 계정은 최대 50개까지 보유할 수 있습니다.
데이터 접근
API 계정이 올바르게 구성되어 있으면 해당 계정은 앱이 다음 정보에 접근하도록 허용할 수 있습니다.
카테고리 | 권한 이름 | 설명 |
|---|---|---|
기기 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 자동 기기 등록을 사용하여 등록된 조직 내 기기 목록을 가져옵니다. |
기기 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 기기 모델, 주문 번호 및 부품 번호와 같은 조직 내 기기에 대한 정보를 가져옵니다. |
기기 관리 서비스 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 조직 내 기기 관리 서비스 목록을 가져옵니다. |
기기 관리 서비스 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 기기 관리 서비스에 할당된 기기 일련 번호의 목록을 가져옵니다. |
기기 관리 서비스 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 기기에 할당된 기기 관리 서비스 ID 정보를 가져옵니다. |
기기 관리 서비스 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 기기에 할당된 기기 관리 서비스 정보를 가져옵니다. |
기기 관리 서비스 | 기기 관리 서비스 보기, 기본 플랫폼 할당 관리, Apple Configurator를 사용하여 기기 추가. | 할당 또는 할당 취소와 같이 기기 관리 작업으로 생성되는 조직 기기 활동에 대한 정보를 가져옵니다. |
기기 관리 서비스 | 기기를 기기 관리 서비스에 할당 | 기기 관리 서비스에 기기를 할당하거나 할당 취소합니다. |
사용자 관리 서비스 | 조직의 사용자 목록을 가져옵니다. | |
사용자 관리 서비스 | 조직의 특정 사용자에 대한 정보를 가져옵니다. | |
사용자 그룹 관리 서비스 | 조직의 사용자 그룹 목록을 가져옵니다. | |
사용자 그룹 관리 서비스 | 조직의 특정 사용자 그룹에 대한 정보를 가져옵니다. | |
사용자 그룹 관리 서비스 | 조직의 사용자 그룹에 할당된 사용자 목록을 가져옵니다. | |
관리 계획 | 관리 계획 보기 | 조직의 관리 계획 목록을 가져옵니다. |
관리 계획 | 관리 계획 관리. | 조직에 관리 계획을 생성합니다. |
관리 계획 | 관리 계획 관리. | 조직의 관리 계획에 대한 정보를 가져옵니다. |
관리 계획 | 관리 계획 관리. | 조직의 관리 계획을 업데이트합니다. |
관리 계획 | 관리 계획 관리. | 조직의 관리 계획을 삭제합니다. |
관리 계획 | 관리 계획 관리. | 조직의 관리 계획 내에서 지정된 유형의 구성원을 가져오거나 수정합니다. |
구성 | 기기 구성 보기. | 조직의 구성 목록을 가져옵니다. |
구성 | 기기 구성 보기. | 조직의 구성 세부사항을 가져옵니다. |
구성 | 기기 구성 생성, 편집 및 삭제 | 조직에 구성을 생성합니다(CUSTOM_SETTING 유형). |
구성 | 기기 구성 생성, 편집 및 삭제 | 조직의 구성을 업데이트합니다(CUSTOM_SETTING 유형). |
구성 | 기기 구성 생성, 편집 및 삭제 | 조직의 구성을 삭제합니다. |
패키지 | 기본으로 제공되는 기기 관리를 사용하여 기기 보기 및 관리 | 조직의 패키지를 가져옵니다. |
앱 | 앱 보기. | 조직의 사용권이 부여된 앱을 가져옵니다. |
감사 이벤트 | 관리자 API를 사용하여 시스템 감사 이벤트 액세스 | 다양한 기준으로 필터링된 조직의 감사 이벤트 목록을 검색합니다. 감사 이벤트는 기기 추가 또는 삭제와 같은 조직 내 활동을 나타냅니다. |
개인 키 생성
Apple Business에 대한 연결을 안전하게 유지하려면 비공개 키를 생성해야 합니다. 키의 파일 이름은 “.pem”으로 끝나며, 이 키는 한 번만 생성할 수 있습니다.
API 계정 생성 및 비공개 키 다운로드
Apple Business 에서 “조직 책임자” 역할의 사용자로 로그인합니다.
“API 계정 추가”를 선택하고, 사용자의 이름과 역할을 선택한 다음, “다음”을 선택합니다.
다음 중 하나를 선택합니다.
“생성 및 다운로드”를 통해 키를 생성하고 다운로드할 수 있습니다.
파일이 자동으로 브라우저 환경설정의 파일 다운로드 위치에 다운로드되며, 다운로드 위치가 없는 경우 파일을 저장할 위치를 묻는 메시지가 표시됩니다.
나중에 비공개 키를 생성하려면 “나중에”를 선택합니다.
“편집”을 선택하여 연결을 생성하는 데 필요한 정보를 확인합니다.
연결을 생성하는 방법은 Apple 개발자 문서를 참고하십시오.
Apple Business Manager 또는 Apple Business Essentials에서 이동한 기존 API 계정 편집
Apple Business Manager 또는 Apple Business Essentials에서 Apple Business로 이동했으며, 이와 동시에 API 계정이 있었던 경우, 해당 계정은 이제 사사용자 설정 역할을 보유하게 됩니다. 모든 API 계정 정보를 검토하고 편집할 수 있습니다.
Apple Business 에서 “조직 책임자” 역할의 사용자로 로그인합니다.
기존 API 계정 옆에 있는 “편집”을 선택합니다.
필요한 경우 다음 작업을 수행합니다.
계정 이름 변경
역할 변경
사용자 설정 역할은 기기 API 관리자입니다. 역할의 권한을 편집하려면 역할 및 권한 소개를 확인하십시오.
“클라이언트 ID”를 클립보드에 복사합니다
“키 ID”를 클립보드에 복사합니다
비공개 키를 무효화합니다.
“저장”을 선택합니다.
연결을 관리하는 방법은 Apple 개발자 문서를 참고하십시오.