인텔® Endpoint Management Assistant(인텔® EMA) API(응용 프로그래밍 인터페이스) 가이드

문서

제품 정보 및 문서

000055621

2024-10-24

인텔® EMA API 가이드는 IT 관리자와 개발자를 위해 인텔® Endpoint Management Assistant(인텔® EMA) API(응용 프로그래밍 인터페이스)에 대한 개요를 제공합니다.

메모: PDF 파일은 어도비 아크로 뱃 리더 *가 필요 합니다.

크기: 207 KB
날짜: 2024년 8월

PDF 문서는 개발자를 위한 인텔® EMA API(Application Programming Interface)에 대한 일반 정보를 제공합니다. 개별 API URI(예: 설명 및 매개 변수)에 대한 자세한 정보는 다음 두 HTML 파일에 포함되어 있습니다. Latestswagger.html 에는 항상 최신 릴리스 API 버전을 가리키는 API 경로가 포함되어 있습니다. 또한 버전 9 API URI 세부 정보 파일인 V9swagger.html도 제공됩니다. 이 자세한 API URI 정보를 보려면 원하는 HTML 파일을 다운로드하여 브라우저에서 엽니다 (Chrome이 가장 적합함).

추가 인텔 EMA API 세부 정보:
인텔® Endpoint Management Assistant(인텔® EMA) API는 개발자와 IT 관리자가 인텔® EMA 상호 작용할 수 있도록 설계된 프로그래밍 인터페이스 집합입니다. 이 API는 엔드포인트 장치의 관리 및 모니터링을 용이하게 하고, 관리 작업을 자동화하며, 인텔® EMA 기능을 다른 소프트웨어 솔루션에 통합합니다.

필수 환경:
인텔® EMA 서버가 설치되어 실행 중이어야 합니다.
적절한 API 액세스 권한 및 자격 증명이 필요합니다.

주요 특징 및 기능:

장치 관리:
엔드포인트 장치를 원격으로 관리하고 모니터링합니다.
자동화: 소프트웨어 업데이트, 장치 재부팅 및 구성 변경과 같은 관리 작업을 자동화합니다.
통합: 인텔® EMA 기능을 다른 소프트웨어 솔루션 및 워크플로에 통합합니다.
보안: 인증 및 권한 부여 메커니즘을 통해 장치를 안전하게 관리합니다.

사용 사례:
자동화된 장치 프로비저닝: 새 장치를 자동으로 프로비저닝하고 구성합니다.
원격 문제 해결: 엔드포인트 장치의 문제를 원격으로 진단하고 해결합니다.
소프트웨어 배포: 소프트웨어 업데이트 및 패치 배포를 자동화합니다.
규정 준수 모니터링: 디바이스가 조직 정책 및 표준을 준수하는지 확인합니다.

시작:

소프트웨어 요구 사항:
인텔® EMA 서버가 설치되어 실행 중이어야 합니다.
액세스 권한: 적절한 API 액세스 권한 및 자격 증명이 필요합니다. 이러한 권한은 Swagger JSON 파일에 자세히 설명되어 있습니다.
API 키 생성: 인텔® EMA 콘솔에서 API 키를 생성합니다.
구성: 네트워크 설정을 구성하고 인텔® EMA 서버에 액세스할 수 있는지 확인합니다.

인증 및 보안:

토큰 인증:
EMA 서버 계정에 사용자 이름 및 관련 암호를 사용합니다.
Active Directory 인증: Active Directory의 자격 증명을 사용합니다. 인텔® EMA이 Windows* 도메인 인증 모드로 설치되어 있고 인텔® EMA 서버가 Active Directory 도메인에 가입되어 있는 경우에만 사용할 수 있습니다.
클라이언트 자격 증명 인증: EMA 서버에 대한 API 액세스를 위해 설계되었습니다. EMA 서버에서 클라이언트 자격 증명 계정 및 클라이언트 암호를 생성해야 합니다.
Microsoft* Entra 인증: 인텔® EMA 1.9.0에 도입된 것으로, Microsoft Entra라고 하는 Azure Active Directory를 사용하여 인텔® EMA 웹 인터페이스를 인증할 수 있습니다.

보안 모범 사례:
HTTPS 사용: 항상 HTTPS를 사용하여 전송 중인 데이터를 암호화합니다.
최소 권한: API 사용자에게 필요한 최소 권한을 부여합니다.
암호 해싱: 암호를 일반 텍스트 파일에 저장하지 마십시오.
오류 처리 및 문제 해결:

일반적인 오류 코드:
400 잘못된 요청: 잘못된 입력 매개 변수입니다.
401 권한 없음: 인증 자격 증명이 잘못되었거나 누락되었습니다.
404 찾을 수 없음: 리소스를 찾을 수 없습니다.
500 내부 서버 오류: 서버에 예기치 않은 조건이 발생했습니다.

문제 해결 팁:
API 키 확인: API 키가 유효하고 필요한 권한이 있는지 확인합니다.
입력 유효성 검사: 입력 매개 변수가 올바르고 형식이 올바른지 확인합니다.
네트워크 문제: 클라이언트와 인텔® EMA 서버 간에 네트워크 연결 문제가 없는지 확인합니다.