엔터티 API
참고
Microsoft Cloud App Security 이름이 바뀌었습니다. 이제 Microsoft Defender for Cloud Apps 호출되었습니다. 앞으로 몇 주 안에 여기와 관련 페이지에서 스크린샷과 지침을 업데이트할 예정입니다. 변경에 대한 자세한 내용은 이 공지 사항을 참조하세요. Microsoft 보안 서비스의 최근 이름 바꾸기에 대한 자세한 내용은 Microsoft Ignite 보안 블로그를 참조하세요.
Microsoft Defender for Cloud Apps 이제 Microsoft 365 Defender 일부입니다. Microsoft 365 Defender 포털을 사용하면 보안 관리자가 한 위치에서 보안 작업을 수행할 수 있습니다. 이렇게 하면 워크플로가 간소화되고 다른 Microsoft 365 Defender 서비스의 기능이 추가됩니다. Microsoft 365 Defender Microsoft ID, 데이터, 디바이스, 앱 및 인프라 전반에서 보안을 모니터링하고 관리하는 가정이 될 것입니다. 이러한 변경에 대한 자세한 내용은 Microsoft 365 Defender Microsoft Defender for Cloud Apps 참조하세요.
참고
이 API는 Office 365 Cloud App Security 사용할 수 없습니다.
Entities API는 조직의 클라우드 앱을 사용하는 사용자 및 계정에 대한 기본 정보를 제공하므로 서비스 사용 패턴을 이해할 수 있습니다.
다음은 지원되는 요청을 나열합니다.
필터
필터 작동 방식에 대한 자세한 내용은 필터를 참조하세요.
다음 표에서는 지원되는 필터에 대해 설명합니다.
| 필터 | 유형 | 연산자 | Description |
|---|---|---|---|
| type | 문자열 | eq, neq | 형식별로 엔터티 필터링 |
| isAdmin | 문자열 | eq | 관리자인 엔터티 필터링 |
| 엔터티 | 엔터티 pk | eq, neq | 특정 엔터티 pk를 사용하여 엔터티를 필터링합니다. 사용자가 선택된 경우 모든 계정도 반환합니다. 예: [{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
| userGroups | 문자열 | eq, neq | 연결된 그룹 ID로 엔터티 필터링 |
| app | integer | eq, neq | 지정된 SaaS ID가 있는 서비스를 사용하여 엔터티 필터링(예: 11770) |
| 인스턴스 | integer | eq, neq | 지정된 Appstances(SaaS ID 및 인스턴스 ID)가 있는 서비스를 사용하여 엔터티 필터링(예: 11770, 1059065 |
| isExternal | boolean | eq | 엔터티의 소속입니다. 가능한 값은 다음과 같습니다. true: 외부 false: 내부 null: 값 없음 |
| 도메인 | 문자열 | eq, neq, isset, isnotset | 엔터티의 관련 도메인 |
| organization | 문자열 | eq, neq, isset, isnotset | 지정된 조직 구성 단위를 사용하여 엔터티 필터링 |
| 상태 | 문자열 | eq, neq | 상태별로 엔터티를 필터링합니다. 가능한 값은 다음과 같습니다. 0: 해당/A 1: 스테이징 2: 활성 3: 일시 중단됨 4: 삭제됨 |
| score | integer | lt, gt, isset, isnotset | 조사 우선 순위 점수를 기준으로 엔터티 필터링 |
문제가 발생하는 경우 지원받을 수 있습니다. 제품 문제에 대해 도움이나 지원을 받으려면 지원 티켓을 여세요.