보안 엔드포인트 API 개요 이해

문제

이 문서에서는 Cisco SE(Secure Endpoints) API 사용에 대해 설명합니다.

해결

SE API를 사용하려면 SE 콘솔에서 API 자격 증명을 생성합니다.

이 문서의 예에서는 Windows 7 끝점을 사용합니다.

1. 콘솔에 로그인하고 Accounts(계정) > API Credentials(API 자격 증명)로 이동합니다.

1. 새 키 집합을 생성하려면 새 API 자격 증명을 클릭합니다.

2. 지원명을 입력합니다. 읽기 전용 또는 읽기 및 쓰기 범위를 선택합니다.

참고: 읽기 및 쓰기 범위가 포함된 API 자격 증명은 Cisco SE 컨피그레이션을 변경하여 엔드포인트에 심각한 문제를 일으킬 수 있습니다.  Cisco SE Console에 내장된 일부 입력 보호는 API에 적용되지 않습니다.

3. 생성 버튼을 클릭합니다. API Key Details(API 키 세부사항) 페이지가 나타납니다. 화면에서 나간 후 일부 정보를 사용할 수 없으므로 이 정보를 저장합니다.

참고: API 자격 증명(API 클라이언트 ID 및 API 키)을 사용하면 다른 프로그램에서 Cisco SE 데이터를 검색하고 수정할 수 있습니다. 사용자 이름 및 비밀번호와 기능적으로 동일하며, 그렇게 취급해야 합니다.

주의: API 자격 증명은 한 번만 표시됩니다. 자격 증명을 분실한 경우 새 자격 증명을 생성해야 합니다.

애플리케이션이 손상된 것으로 의심되는 경우 애플리케이션의 API 자격 증명을 삭제하고 새 자격 증명을 생성합니다.  API 자격 증명을 삭제하면 기존 자격 증명을 사용하는 클라이언트가 잠기므로 새 자격 증명으로 업데이트합니다.

환경

• 테스트된 엔드포인트: Windows 7 엔드포인트.
• 제품: Cisco SE
• 액세스: API 자격 증명을 만들고 삭제할 수 있는 권한이 있는 콘솔 액세스
• API: SE API 버전 3, 버전 1 및 버전 0(예: 버전 1 사용).
• 클라이언트 도구: API 요청을 실행하는 데 사용되는 시스템에 curl이 설치되어 있습니다.

SE API에는 현재 세 가지 버전이 있습니다. 버전 3, 버전 1 및 버전 0. 버전 3은 버전 1 및 버전 0과 비교하여 추가 기능을 제공합니다. 버전 3 API 설명서는 이 링크에서 사용할 수 있습니다. 버전 3을 사용하여 이 정보를 검색합니다.

• 감사 로그
• 장치 제어
• 디바이스
• 제외
• 호스트 방화벽
• IOC
• MSSP
• 조직
• 정책
• 컴퓨터
• 취약점

문서에서 관련 명령을 클릭하여 사용 예를 확인합니다. 

API 명령 분석 및 예

각 API 명령은 유사한 정보를 포함하며 다음과 같이 curl 명령으로 나뉩니다.

curl -o yourfilename.json https://client_id:api_key@api.example.com/v1/whatyouwanttodo

curl 명령을 -o 옵션과 함께 사용하면 출력을 파일에 저장할 수 있습니다. 이 경우 파일 이름은 "yourfilename.json"입니다. 

팁: .json 파일에 대한 자세한 내용은 JSON 웹 사이트를 참조하십시오.

curl 명령의 다음 부분에서는 @ 기호 앞에 자격 증명을 지정합니다. API 자격 증명을 생성한 후에는 URL의 이 부분에 있는 API 클라이언트 ID 및 API 키를 사용합니다.

https://client_id:api_key@

버전 번호 및 수행할 작업을 추가합니다. 이 예에서는 GET /v1/computers를 실행합니다. 전체 명령은 다음과 같습니다.

curl -o computers.json https://client_id:api_key@api.example.com/v1/computers

명령을 실행하면 명령을 시작한 디렉토리에 computers.json 파일이 나타납니다.

참고: Curl은 온라인에서 사용할 수 있으며 Windows를 비롯한 여러 플랫폼에서 컴파일됩니다(일반적으로 Win32 - 일반 버전을 사용하려고 함).

파일을 열면 모든 데이터가 한 줄에 나타납니다. 포맷된 레이아웃으로 보려면 JSON 포맷을 제공하는 브라우저 플러그인을 설치하고 브라우저에서 파일을 엽니다. 이 출력은 다음과 같은 컴퓨터에 대한 정보를 표시합니다.

connector_guid, hostname, active, links, connector_version, operating_system, internal_ips, external_ip, group_guid, network_addresses, policy guid 및 policy name.

{
version: "v1.0.0",
metadata: {
links: {
self: "https://api.amp.cisco.com/v1/computers"
},
results: {
total: 4,
current_item_count: 4,
index: 0,
items_per_page: 500
}
},
data: [
{
connector_guid: "abcdef-1234-5678-9abc-def123456789",
hostname: "host.example.com",
active: true,
links: {
computer: "https://api.amp.cisco.com/v1/computers/abcdef-1234-5678-9abc-def123456789",
trajectory: "https://api.amp.cisco.com/v1/computers/abcdef-1234-5678-9abc-def123456789/trajectory",
group: "https://api.amp.cisco.com/v1/groups/abcdef-1234-5678-9abc-def123456789"
},
connector_version: "4.4.2.10200",
operating_system: "Windows 7, SP 1.0",
internal_ips: [
"10.1.1.2",
" 192.168.1.2",
" 192.168.2.2",
" 169.254.245.1"
],
external_ip: "192.0.2.10",
group_guid: "abcdef-1234-5678-9abc-def123456789",
network_addresses: [
{
mac: "ab:cd:ef:01:23:45",
ip: "10.1.1.2"
},
{
mac: "bc:de:f0:12:34:56",
ip: "192.168.1.2"
},
{
mac: "cd:ef:01:23:45:67",
ip: "192.168.2.2"
},
{
mac: "de:f0:12:34:56:78",
ip: "169.254.245.1"
}
],
policy: {
guid: "abcdef-1234-5678-9abc-def123456789",
name: "Protect Policy"
}
}
]
}

이 예에서는 기본 API 요청을 보여줍니다. 이제 다른 명령 옵션을 사용하여 환경에서 데이터를 검색하고 수정할 수 있습니다.

관련 콘텐츠

• Cisco AMP for Endpoints API 설명서
• 기술 지원 및 문서 − Cisco Systems

개정 이력

개정	게시 날짜	의견
2.0	26-Oct-2026	재인증
1.0	20-Mar-2017	최초 릴리스