기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# GuardDuty API의 보호 계획에 대한 기능 이름
<a name="guardduty-features-activation-model"></a>

Amazon GuardDuty를 처음 활성화하면 AWS 환경 내에서 [기본 데이터 소스](guardduty_data-sources.md) 처리가 시작됩니다. GuardDuty는 이러한 데이터 소스를 사용하여 VPC 흐름 로그, DNS 로그 및 AWS CloudTrail 관리 이벤트와 같은 독립적인 이벤트 스트림을 처리합니다. 그런 다음 이러한 이벤트를 분석하여 잠재적 보안 위협을 식별하고 계정에서 결과를 생성합니다.

하나 이상의 보호 계획이 활성화되면 GuardDuty는 AWS 환경의 다른 AWS 서비스의 추가 데이터를 사용하여 잠재적 보안 위협을 모니터링하고 분석합니다. 이러한 추가 데이터 소스를 기능이라고 합니다.

## 데이터 원본에서 기능으로 변경
<a name="guardduty-features"></a>

S3 보호, 런타임 모니터링, 람다 보호 등과 같은 GuardDuty 보호 기능을 추가하는 경우 보호 계획에 해당하는 GuardDuty 기능을 구성할 수 있습니다. 예전에는 GuardDuty가 API의 `dataSources`에서 호출되었습니다. 하지만 2023년 3월 이후에는 이제 새로운 GuardDuty 보호 계획이 `dataSources`가 아닌 `features`로 구성됩니다. 2023년 3월 이전에 출시된 보호 요금제는 여전히 API를 통해 `dataSources`로 구성할 수 있지만, 새로운 보호 요금제는 `features`로만 사용할 수 있습니다. 영향을 받는 보호 계획에 대한 자세한 내용은 [GuardDuty API 변경 사항](guardduty-feature-object-api-changes-march2023.md)을 참조하세요.

콘솔을 통해 GuardDuty 구성 및 보호 계을 관리하는 경우 이 변경의 직접적인 영향을 받지 않으므로 별도의 조치를 취할 필요가 없습니다. 이 변경 사항은 GuardDuty를 활성화하기 위해 호출되는 API의 동작 또는 GuardDuty 내의 보호 계획에 영향을 미칩니다. APIs AWS CLI 를 사용하여 보호 계획의 구성을 활성화하거나 편집하는 경우 연결된 기능 이름을 사용해야 합니다. 자세한 내용은 [`dataSources`를 `features`로 매핑](guardduty-feature-object-api-changes-march2023.md#guardduty-feature-enablement-datasource-relation) 단원을 참조하십시오.

# 2023년 3월 GuardDuty API 변경 사항
<a name="guardduty-feature-object-api-changes-march2023"></a>

GuardDuty API는 [GuardDuty 기본 데이터 소스](guardduty_data-sources.md) 목록에 속하지 않는 보호 기능을 구성합니다. 기능 객체에는 기능 이름 및 상태와 같은 기능 세부 정보가 포함되며 일부 보호 계획에 대한 추가 구성이 포함될 수 있습니다. 이 마이그레이션은 Amazon GuardDuty API 참조**에 있는 다음 API에 영향을 미칩니다.
+ [CreateDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_CreateDetector.html)
+ [GetDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetDetector.html)
+ [UpdateDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateDetector.html)
+ [GetMemberDetectors](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetMemberDetectors.html)
+ [UpdateMemberDetectors](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateMemberDetectors.html)
+ [DescribeOrganizationConfiguration](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_DescribeOrganizationConfiguration.html)
+ [UpdateOrganizationConfiguration](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateOrganizationConfiguration.html)
+ [GetRemainingFreeTrialDays](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetRemainingFreeTrialDays.html)
+ [GetUsageStatistics](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html)

## 기능과 데이터 소스 비교
<a name="comparison-datasources-features-activation"></a>

지금까지 모든 GuardDuty 기능은 API의 `dataSources` 객체를 통해 전달되었습니다. 2023년 3월부터 GuardDuty는 API에서 `dataSources` 객체 대신 `features` 객체를 선호합니다. 이전의 모든 데이터 소스에는 해당 기능이 있지만 최신 기능에는 해당 데이터 소스가 없을 수 있습니다.

다음 목록은 API를 통해 전달된 `dataSources` 및 `features` 객체 간의 비교를 보여줍니다.
+ `dataSources` 객체에는 각 보호 유형에 대한 객체와 상태가 포함되어 있습니다. `features` 객체는 GuardDuty 내의 각 보호 유형에 해당하는 사용 가능한 기능 목록입니다.

  2023년 3월부터 사용자 AWS 환경에서 새로운 GuardDuty 기능을 구성하는 유일한 방법은 기능 활성화입니다.
+ API 요청 또는 응답의 `dataSources` 스키마는 GuardDuty를 사용할 수 있는 각 AWS 리전 에서 동일합니다. 하지만 일부 리전에서는 모든 기능을 사용하지 못할 수 있습니다. 따라서 사용 가능한 기능 이름은 리전에 따라 다를 수 있습니다.

## 기능이 있는 API의 작동 방식 이해
<a name="understanding-how-feature-activation-works"></a>

GuardDuty API는 해당하는 경우 계속해서 `dataSources` 객체를 반환하고, 동일한 정보가 포함된 `features` 객체도 다른 형식으로 반환합니다. 2023년 3월 이전에 출시된 GuardDuty 기능은 `dataSources` 객체와 `features` 객체를 통해 사용할 수 있습니다. 2023년 3월 이후에 출시된 GuardDuty 기능은 `features` 객체를 통해서만 사용할 수 있습니다. 동일한 API 요청에서 `dataSources` 및 `features` 객체 표기법을 AWS Organizations 사용하여 감지기를 생성 또는 업데이트하거나를 설명할 수 없습니다. GuardDuty 보호 유형을 활성화하려면 `features` 객체도 포함된 동일한 API를 사용하여 기존 데이터 소스를 `features` 객체로 마이그레이션해야 합니다.

**참고**  
GuardDuty는 이번 수정 이후 새 데이터 소스를 추가하지 않습니다.

GuardDuty는 보호 요금제와 관련된 데이터 소스 사용을 더 이상 사용하지 않습니다. 하지만 [GuardDuty 기본 데이터 소스](guardduty_data-sources.md) 지원은 계속됩니다. GuardDuty 모범 사례에서는 계정의 모든 보호 요금제에 대한 구성을 사용 설정하거나 편집하는 기능을 사용할 것을 권장합니다.

## API의 기능 변경 사항 통합
<a name="features-activation-incorporating-changes"></a>
+ APIs, SDKs 또는 CloudFormation 템플릿을 통해 GuardDuty 구성을 관리하고 잠재적인 새 GuardDuty 기능을 활성화하려면 각각 코드와 템플릿을 수정해야 합니다. 자세한 내용은 [Amazon GuardDuty API 참조](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)**의 업데이트된 API를 참조하세요.
+ 이 업그레이드 전에 구성된 GuardDuty 기능의 경우 APIs, SDKs 또는 CloudFormation 템플릿을 계속 사용할 수 있습니다. 하지만 `feature` 객체 사용으로 전환하는 것이 좋습니다.

  모든 데이터 소스에는 동일한 기능 객체가 있습니다. 자세한 내용은 [`dataSources`를 `features`로 매핑](#guardduty-feature-enablement-datasource-relation) 단원을 참조하십시오.
+ 현재 `features` 객체의 `additionalConfiguration`은 특정 보호 유형에서만 사용 가능합니다.
  + 이러한 보호 유형의 경우 기능의 `AdditionalConfiguration` `status`가 `ENABLED`로 설정되어 있지만 기능 구성 `status`가 `ENABLED`로 설정되지 않은 경우 GuardDuty는 어떠한 조치도 취하지 않습니다.
  + 이로 인해 영향을 받는 API는 다음과 같습니다.
    + [UpdateDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateDetector.html)
    + [UpdateMemberDetectors](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateMemberDetectors.html)
    + [UpdateOrganizationConfiguration](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateOrganizationConfiguration.html) 

## `dataSources`를 `features`로 매핑
<a name="guardduty-feature-enablement-datasource-relation"></a>

다음 표는 보호 유형, `dataSources` 및 `features`의 매핑을 보여줍니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/guardduty/latest/ug/guardduty-feature-object-api-changes-march2023.html)

\$1GetUsageStatistics는 고유한 `dataSource` 이름을 사용합니다. 자세한 내용은 [GuardDuty 사용량 모니터링 및 비용 추정](monitoring_costs.md) 또는 [https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html)을 참조하세요.