Defender for Cloud Apps REST API

이 문서에서는 HTTPS를 통해 Defender for Cloud Apps 상호 작용하는 방법을 설명합니다.

Microsoft Defender for Cloud Apps API는 REST API 엔드포인트를 통해 Defender for Cloud Apps 프로그래밍 방식으로 액세스할 수 있도록 합니다. 애플리케이션은 API를 사용하여 Defender for Cloud Apps 데이터 및 개체에 대한 읽기 및 업데이트 작업을 수행할 수 있습니다. 예를 들어 Defender for Cloud Apps API는 사용자 개체에 대해 다음과 같은 일반적인 작업을 지원합니다.

• 클라우드 검색을 위한 로그 파일 업로드
• 블록 스크립트 생성
• 활동 및 경고 나열
• 경고 해제 또는 resolve

API URL 구조

Defender for Cloud Apps API를 사용하려면 먼저 테넌트에서 API URL을 가져와야 합니다. API URL은 형식 https://<portal_url>/api/<endpoint>을 사용합니다.

테넌트용 Defender for Cloud Apps API URL을 가져오려면 다음 단계를 수행합니다.

1. Microsoft Defender 포털에서 설정을 선택합니다. 그런 다음 , Cloud Apps를 선택합니다. 시스템 아래에서 정보를 선택합니다.

2. Defender for Cloud Apps 화면에서 API URL을 볼 수 있습니다.

   

API URL이 있으면 접미사를 추가하여 /api API URL을 가져옵니다. 예를 들어 포털의 URL이 https://mytenant.us2.contoso.com인 경우 API URL은 입니다 https://mytenant.us2.portal.cloudappsecurity.com/api.

API 토큰

Defender for Cloud Apps 다음과 같이 서버에 대한 모든 API 요청의 헤더에 API 토큰이 필요합니다.

Authorization: Token <your_token_key>

개인 API 토큰은 어디에 <your_token_key> 있나요?

API 토큰에 대한 자세한 내용은 API 토큰 관리를 참조하세요.

API 토큰 - 예제

curl -XGET -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/example-endpoint"

지원되는 작업은 무엇인가요?

다음 표에서는 지원되는 작업에 대해 설명합니다.

여기서 Resource 는 관련 엔터티 그룹을 나타냅니다.

지원되는 필드 형식은 무엇인가요?

다음 표에서는 지원되는 필드 형식에 대해 설명합니다.

타임 스탬프

Defender for Cloud Apps API의 타임스탬프에 대한 언급은 Unix 타임스탬프(밀리초)를 참조합니다. 이 타임스탬프는 1970-01-01 0:00:00 이후의 밀리초 수에 따라 결정됩니다. get-date PowerShell cmdlet을 사용하여 날짜를 타임스탬프로 변환할 수 있습니다.

제한

요청에 제한 매개 변수를 제공하여 요청을 제한하도록 선택할 수 있습니다.

다음 메서드는 limit 매개 변수를 제공하기 위해 지원됩니다.

• URL로 인코딩됨(헤더 포함 Content-Type: application/x-www-form-urlencoded )
• 양식 데이터
• JSON 본문( Content-Type: multipart/form-data 및 적절한 경계 헤더 포함)

필터

많은 수의 결과가 있는 경우 필터를 사용하여 요청을 미세 조정하는 것이 유용합니다. 이 섹션에서는 필터와 함께 사용할 수 있는 및 연산자의 구조에 대해 설명합니다.

구조

일부 API 엔드포인트는 쿼리를 수행할 때 필터를 지원합니다. 관련 섹션에서는 사용 가능한 모든 필터링 가능한 필드와 해당 리소스에 대해 지원되는 연산자를 나열하는 참조를 찾을 수 있습니다.

대부분의 필터는 강력한 쿼리를 제공하기 위해 여러 값을 지원합니다. 필터와 연산자를 결합할 때는 AND를 필터 간의 논리 연산자로 사용합니다.

필터 - 예제

curl -XGET -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/example-endpoint" -d '{
  "filters": {
    "some.field": {
      "eq": ["value1", "value2"],
      "isset": true
    },
    "some.field2": {
      "gte": 5
    }
  },
  "skip": 5,
  "limit": 10
}'

연산자

다음 표에서는 지원되는 연산자를 설명합니다.

다음 단계

문제가 발생하면 도움을 드리겠습니다. 제품 문제에 대한 지원 또는 지원을 받으려면 지원 티켓을 여세요.