장치 보안 점수 가져오기

적용 대상:

• 엔드포인트용 Microsoft Defender 플랜 1
• 엔드포인트용 Microsoft Defender 플랜 2
• Microsoft Defender XDR

엔드포인트용 Microsoft Defender를 경험하고 싶으신가요? 무료 평가판을 신청하세요.

참고

미국 정부 고객인 경우 미국 정부 고객용 엔드포인트용 Microsoft Defender에 나열된 URI를 사용하세요.

팁

성능을 향상시키려면 서버를 지리적 위치에 더 가깝게 사용할 수 있습니다.

• us.api.security.microsoft.com
• eu.api.security.microsoft.com
• uk.api.security.microsoft.com
• au.api.security.microsoft.com
• swa.api.security.microsoft.com
• ina.api.security.microsoft.com

디바이스에 대한 Microsoft 보안 점수를 검색합니다. 장치에 대한 Microsoft 보안 점수가 높을수록 엔드포인트가 사이버 보안 위협 공격으로부터 더 탄력적임을 의미합니다.

권한

이 API를 호출하려면 다음 권한 중 하나가 필요합니다. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 엔드포인트용 Microsoft Defender API 사용을 참조하세요.

사용 권한 유형	사용 권한	사용 권한 표시 이름
응용 프로그램	Score.Read.All	'위협 및 취약성 관리 점수 읽기'
위임됨(회사 또는 학교 계정)	Score.Read	'위협 및 취약성 관리 점수 읽기'

HTTP 요청

GET /api/configurationScore

요청 헤더

이름	유형	설명
권한 부여	String	전달자 {token}. 필수입니다.

요청 본문

비우다

응답

성공하면 이 메서드는 응답 본문에 디바이스 보안 점수 데이터를 사용하여 200 OK를 반환합니다.

예제

요청 예제

다음은 요청의 예입니다.

GET https://api.securitycenter.microsoft.com/api/configurationScore

응답 예제

다음은 응답의 예입니다.

참고

여기에 표시된 응답 목록은 간결하게 잘립니다.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

참고 항목

• 엔드포인트용 Microsoft Defender를 사용하여 OData 쿼리

팁

더 자세히 알아보고 싶으신가요? Microsoft 기술 커뮤니티: 엔드포인트용 Microsoft Defender 기술 커뮤니티에서 Microsoft 보안 커뮤니티에 참여하세요.