AWS Encryption SDK for Java

이 주제에서는 AWS Encryption SDK for Java를 설치 및 사용하는 방법을 설명합니다. 를 사용한 프로그래밍에 대한 자세한 내용은AWS Encryption SDK for Java, 단원을 참조하십시오.aws-encryption-sdk-java리포지토리 GitHub. API 설명서는 다음을 참조하십시오.자바독를 위해AWS Encryption SDK for Java.

주제

• 사전 조건
• 설치
• 예제

사전 조건

AWS Encryption SDK for Java를 설치하려면 먼저 다음 사전 조건이 충족되어야 합니다.

Java 개발 환경

Java 8 이상이 필요합니다. Oracle 웹 사이트에서 다음으로 이동하십시오.Java SE 다운로드Java SE 개발 키트 (JDK) 를 다운로드하고 설치합니다.

Oracle JDK를 사용하는 경우 다음 항목도 다운로드하여 설치해야 합니다.Java Cryptography Extension (JCE).

바운시 캐슬

AWS Encryption SDK for Java에는 Bouncy Castle이 필요합니다.

• AWS Encryption SDK for Java 버전 1.6.1 이상은 Bouncy Castle을 사용하여 암호화 객체를 직렬화하고 역직렬화합니다. 이 요구 사항을 충족하기 위해 Bouncy Castle 또는 Bouncy Castle FIPS를 사용할 수 있습니다. Bouncy Castle FIPS 설치 및 구성에 대한 도움말은 BC FIPS 설명서, 특히 사용 설명서 및 보안 정책 PDF를 참조하십시오.

• AWS Encryption SDK for Java의 이전 버전은 Bouncy Castle의 Java용 암호화 API를 사용합니다. 이 요구 사항은 비 FIPS Bouncy Castle만 만족합니다.

바운시 캐슬이 (가) 없는 경우바운시 캐슬 최신 출시JDK에 해당하는 프로바이더 파일을 다운로드하세요. 도 사용할 수 있습니다.Apache Maven표준 바운시 캐슬 제공자의 아티팩트를 받으려면 (bcprov-ext-jdk15on) 또는 바운시 캐슬 FIPS의 아티팩트 (bc-fips).

AWS SDK for Java(선택 사항)

이AWS Encryption SDK for Java필요하지 않습니다AWS SDK for Java. 그러나AWS SDK for Java사용하려면AWS Key Management Service(AWS KMS) 를 마스터 키 제공자로 사용합니다. 이 안내서의 일부 Java 코드 예제에도 필요합니다.

에서 시작AWS Encryption SDK for Java버전 2.4.0AWS Encryption SDK for Java의 버전 1.x 및 2.x를 지원합니다.AWS SDK for Java.AWS Encryption SDK에 대한 코드AWS SDK for Java1.x와 2.x는 상호 운용이 가능합니다. 예를 들어 다음과 같이 데이터를 암호화할 수 있습니다.AWS Encryption SDK지원하는 코드AWS SDK for Java1.x를 입력하고 지원하는 코드를 사용하여 해독합니다.AWS SDK for Java 2.x(또는 그 반대). 의 버전AWS Encryption SDK for Java2.4.0 이전 버전만 지원AWS SDK for Java1.x. 버전 업데이트에 대한 자세한 내용은AWS Encryption SDK, 참조하세요.마이그레이션AWS Encryption SDK.

업데이트 할 때AWS Encryption SDK for Java에서 가져온 코드AWS SDK for Java1.x toAWS SDK for Java 2.x, 에 대한 참조 바꾸기AWSKMS인터페이스에서AWS SDK for Java1.x에 대한 참조 포함KmsClient인터페이스에서AWS SDK for Java 2.x. 이AWS Encryption SDK for Java는 지원하지 않습니다KmsAsyncClient인터페이스. 또한 코드를 업데이트하여AWS KMS의 관련 객체kmssdkv2네임스페이스, 대신kms네임스페이스.

AWS SDK for Java를 설치하려면 Apache Maven을 사용합니다.

• 전체 AWS SDK for Java를 종속성으로 가져오려면 pom.xml 파일에 선언하십시오.

• 에 대한 종속성만 만들려면AWS KMS모듈 입력AWS SDK for Java1.x, 다음 지침을 따르십시오특정 모듈 지정, 그리고 설정artifactId에aws-java-sdk-kms.

• 에 대한 종속성만 만들려면AWS KMS모듈 입력AWS SDK for Java2.x, 다음 지침을 따르십시오.특정 모듈 지정. 다음을 설정합니다.groupId에software.amazon.awssdk그리고artifactId에kms.

추가 변경 사항은 을 참조하십시오.그 사이의 차이점은 무엇입니까?AWS SDK for Java1.x 및 2.x에서AWS SDK for Java 2.x개발자 안내서.

의 Java 예제AWS Encryption SDK개발자 안내서 사용AWS SDK for Java 2.x.

설치

의 최신 버전을 설치하려면AWS Encryption SDK for Java.

참고

의 모든 버전AWS Encryption SDK for Java2.0.0 이전 버전은end-of-support단계.

버전 2.0에서 안전하게 업데이트할 수 있습니다.x그리고 나중에는 최신 버전으로AWS Encryption SDK for Java코드나 데이터 변경 없이 그러나,새로운 보안 기능버전 2.0에 도입되었습니다.x이전 버전과 호환되지 않습니다. 1.7 이전 버전에서 업데이트하려면x버전 2.0에x나중에 먼저 최신 버전으로 업데이트해야 합니다.x의 버전AWS Encryption SDK. 자세한 내용은 마이그레이션AWS Encryption SDK 단원을 참조하세요.

다음 방법을 사용하여 AWS Encryption SDK for Java를 설치할 수 있습니다.

직접 만들기

를 설치하려면AWS Encryption SDK for Java, 복제 또는 다운로드aws-encryption-sdk-java GitHub리포지.

Apache Maven 사용

AWS Encryption SDK for Java는 다음 종속성 정의를 사용하여 Apache Maven을 통해 사용할 수 있습니다.

<dependency>
  <groupId>com.amazonaws</groupId>
  <artifactId>aws-encryption-sdk-java</artifactId>
  <version>2.0.0</version>
</dependency>

SDK를 설치한 후 다음을 살펴보고 시작하십시오.예제 Java 코드단원을 참조하십시오.자바독 온 GitHub.