목차

소개

Umbrella API 개요

API 엔드포인트 및 관리

API 활용 사례 및 엔드포인트 그룹

API 키 액세스 및 만료

인증 및 토큰 수명 주기

설명서 및 리소스

지원

소개

이 문서에서는 Umbrella API 플랫폼의 기능, 구성 옵션 및 사용 가능한 리소스에 대해 설명합니다.

Umbrella API 개요

Umbrella API 플랫폼은 Umbrella를 구축, 확장 및 통합할 수 있는 안전한 환경을 제공합니다. API를 사용하여 다른 보안 솔루션과 위협 인텔리전스를 통합하는 교차 플랫폼 워크플로를 생성하여 시행을 확대하고 가시성을 높이며 사고 대응을 자동화할 수 있습니다.

API 엔드포인트 및 관리

- 모든 Umbrella API 엔드포인트는에서api.umbrella.com호스팅됩니다.

- 엔드포인트는 활용 사례별로 그룹화되며, 각각 특정 경로가 있습니다.

- Umbrella 대시보드의 Admin(관리) > API keys(API 키) 아래 또는 KeyAdmin API를 사용하여 프로그래밍 방식으로 API 키를 관리합니다.

API 활용 사례 및 엔드포인트 그룹

다음과 같은 기본 활용 사례에 따라 그룹화된 세분화된 범위로 각 API 키를 구성합니다.

- 관리 API 엔드포인트: API 키 및 사용자를 프로비저닝 및 관리하고, 역할을 보고, 공급자 및 매니지드 공급자에 대한 고객을 관리합니다.

- 인증 API 엔드포인트: Umbrella와 다른 서비스 간의 통합을 승인합니다.

- 구축 API 엔드포인트: 네트워크 및 엔터티를 프로비저닝, 모니터링 및 관리하고 기존 Umbrella 정책에서 구성하여 보호합니다.

- 정책 API 엔드포인트: 대상 목록 및 목록별 대상을 프로비저닝하고 관리합니다.

- API 엔드포인트 조사: Umbrella 확인기에서 관찰한 도메인, IP 주소 및 URL을 조사합니다.

- API 엔드포인트를 보고합니다. 구축에 대한 실시간 보안 정보를 읽고 감사합니다. App Discovery API는 클라우드 기반 애플리케이션에 대한 통찰력을 제공합니다.

API 키 액세스 및 만료

- 사용 용도에 따라 각 범위에 대한 액세스 수준을 읽기/쓰기 또는 읽기 전용으로 설정합니다.

- 필요에 따라 사전 정의된 날짜에 만료되도록 API 키를 구성합니다.

15143392160916

인증 및 토큰 수명 주기

- API 자격 증명은 60분 동안 유효한 액세스 토큰을 생성합니다.

- 인증 프로세스에서는 OAuth 2.0 클라이언트 자격 증명 흐름을 사용합니다.

- 다중 조직 또는 서비스 공급자 환경에서 상위 조직 API 자격 증명은 권한 부여 중 지정된 하위 조직에 대해 동일한 범위의 액세스 토큰을 생성할 수 있습니다.

설명서 및 리소스

- 포괄적인 지침 및 활용 사례 문서에 액세스합니다.

- 각 API 활용 사례는 API Reference(API 참조)에 설명되어 있습니다.

- 모든 엔드포인트와 매개변수는 각 활용 사례 개요의 하단에 연결된 OpenAPI 사양에 나열되어 있습니다.

- 레거시 Umbrella API를 사용하는 경우 API Migration Guide를 검토합니다.

- 초기 테스트에는 Umbrella API의 Postman 컬렉션을 사용합니다.

- Cisco 개발자 페이지의 Cloud Security 섹션에서 추가 리소스, 학습 랩 및 API 테스트용 샌드박스를 살펴보십시오.

지원

Umbrella API에 대한 질문이나 추가 지원이 필요한 경우 Umbrella 지원에 문의하십시오.