기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon OpenSearch Service에 서드 파티 플러그인 설치
Amazon OpenSearch Service는 선택한 파트너의 서드 파티 플러그인을 지원합니다. 이러한 플러그인은 사용자 지정 분석기, 토크나이저 또는 암호화 기능과 같은 추가 기능으로 OpenSearch 설정을 개선할 수 있습니다. 서드 파티 개발자가 제공하는 구체적인 설치 및 구성 지침에 따라 OpenSearch Service 도메인과 적절하게 통합되도록 합니다.
**참고**
서드 파티 개발자로부터 직접 유효한 라이선스를 획득하고 유지해야 합니다. 일부 공급자는 플러그인을 전혀 활성화하지 않을 수 AWS 리전있으므로 플러그인 공급자에게 가용성을 확인하세요.
OpenSearch Service에서 사용할 수 있는 서드 파티 플러그인은 다음과 같습니다.
+ **Portal26 암호화 플러그인(Titanium-lockbox)** - NIST FIPS 140-2 인증 암호화를 사용하여 인덱싱 시에 데이터를 암호화합니다. 여기에는 보안 강화를 위해 암호화 키를 관리할 수 있는 Bring Your Own Key(BYOK) 지원이 포함됩니다. 플러그인은 [Portal26](https://portal26.ai/)에서 제공하며 OpenSearch 버전 2.15 이상이 필요합니다.
+ **이름 일치(RNI)** - 24개 이상의 언어로 이름, 조직, 주소 및 날짜를 매칭하여 보안 및 규정 준수를 개선합니다. 플러그인은 [Babel Street](https://www.babelstreet.com/)에서 제공하며 OpenSearch 버전 2.15 이상이 필요합니다.
**Topics**
+ [사전 조건](#prerequisites-partner-plugins)
+ [서드 파티 플러그인 설치](#third-party-partner-plugins-install)
+ [다음 단계](#third-party-partner-plugins-next)
## 사전 조건
서드 파티 플러그인을 설치하기 전에 다음 단계를 수행합니다.
+ 플러그인 구성 및 라이선스 파일을 가져와 Amazon S3 버킷에 업로드합니다. 버킷은 도메인 AWS 리전 과 동일한에 있어야 합니다.
+ 서드 파티 플러그인은 사용자 지정 플러그인의 한 유형입니다. 도메인이 사용자 지정 플러그인의 [사전 조건](custom-plugins.md#custom-plugin-prerequisites)을 충족하는지 확인합니다.
## 서드 파티 플러그인 설치
서드 파티 플러그인을 OpenSearch Service 도메인과 연결하려면 먼저 *라이선스* 패키지, *구성* 패키지 및 *플러그인* 패키지의 세 가지 개별 패키지를 업로드해야 합니다.
+ **라이선스** 패키지에는 플러그인과 연결된 라이선스 정보 또는 메타데이터가 .json 또는 .xml 형식으로 포함되어 있습니다.
+ **구성** 패키지에는 플러그인 구성 파일과 지원되는 자산 및 설정이 포함되어 있습니다. 이들 파일은 플러그인이 OpenSearch와 작동하거나 통합되는 방식을 정의합니다.
+ **플러그인** 패키지에는 OpenSearch가 실행하는 실행 파일 코드인 컴파일된 플러그인 바이너리가 포함되어 있습니다. 이는 플러그인 기능의 핵심입니다.
두 패키지를 모두 업로드하고 나면 플러그인과 라이선스를 호환되는 도메인과 연결할 수 있습니다.
### 콘솔
서드 파티 플러그인을 도메인에 연결하려면 먼저 플러그인 라이선스 및 구성을 패키지로 가져옵니다.
**서드 파티 플러그인을 설치하려면**
1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home) Amazon OpenSearch Service 콘솔에 로그인합니다.
1. 왼쪽 탐색 창에서 **패키지**를 선택합니다.
1. 먼저 라이선스 패키지를 가져옵니다. [**패키지 가져오기(Import package)**]를 선택합니다.
1. **패키지 유형**에서 **라이선스**를 선택합니다.
1. **패키지 소스**에 Amazon S3의 라이선스 JSON 또는 XML 파일의 경로를 입력합니다.
1. **가져오기**를 선택합니다. 패키지는 **패키지** 페이지의 **라이선스** 탭에 표시됩니다.
1. 이제 플러그인 구성을 가져옵니다. **패키지 가져오기**를 다시 선택합니다.
1. **패키지 유형**에서 **구성**을 선택합니다.
1. **패키지 소스**에 Amazon S3의 플러그인 구성 ZIP 파일의 경로를 입력합니다.
1. **가져오기**를 선택합니다.
1. 마지막으로 플러그인 자체를 가져옵니다. [**패키지 가져오기(Import package)**]를 선택합니다.
1. **패키지 유형**에서 **플러그인**을 선택합니다.
1. **패키지 소스**에 Amazon S3의 플러그인 ZIP 파일 경로를 입력합니다.
1. 플러그인이 지원하는 OpenSearch 엔진 버전을 선택합니다.
1. **가져오기**를 선택합니다.
**서드 파티 플러그인을 도메인에 연결하려면**
1. 이제 플러그인 라이선스 및 구성을 도메인과 연결합니다. 왼쪽 탐색 창에서 **도메인**을 선택합니다.
1. 도메인 이름을 선택하여 해당 클러스터 구성을 엽니다.
1. **플러그인** 탭으로 이동합니다.
1. **패키지 연결**을 선택하고 방금 가져온 플러그인, 라이선스 및 구성 패키지를 선택합니다.
1. **선택**을 선택하세요.
1. **다음**을 선택합니다. 연결할 패키지를 검토하고 **연결**을 선택합니다.
### CLI
먼저 [create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) 명령을 사용하여 플러그인 라이선스가 포함된 새 패키지를 생성합니다. `S3Key`는 라이선스 텍스트 또는 메타데이터가 포함된 Amazon S3의 .json 또는 .xml 파일을 가리켜야 합니다.
```
aws opensearch create-package \
--package-name {{plugin-license-package}} \
--package-type PACKAGE-LICENSE \
--package-source S3BucketName={{my-bucket}},S3Key={{licenses/my-plugin-license.json}}
```
[create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) 명령을 다시 사용하여 플러그인 구성이 포함된 패키지를 생성합니다. `S3Key`는 플러그인에 필요한 디렉터리 구조를 준수하는 Amazon S3의 .zip 파일을 가리켜야 합니다.
```
aws opensearch create-package \
--package-name {{plugin-config-package}} \
--package-type PACKAGE-CONFIG \
--package-source S3BucketName={{my-bucket}},S3Key={{path/to/package.zip}}
```
[create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) 명령을 다시 사용하여 플러그인 자체가 포함된 패키지를 생성합니다. `S3Key`는 Amazon S3의 플러그인 .zip 파일을 가리켜야 합니다.
```
aws opensearch create-package \
--package-name {{plugin-package}} \
--package-type ZIP-PLUGIN \
--package-source S3BucketName={{my-bucket}},S3Key={{path/to/package.zip}}
```
마지막으로 [associate-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/associate-package.html) 명령으로 각 패키지의 패키지 ID를 지정하여 파트너 플러그인, 라이선스 및 구성을 호환 도메인에 연결합니다. 플러그인 ID를 다른 패키지의 사전 조건으로 지정합니다. 즉, 플러그인 ID를 다른 패키지보다 먼저 도메인과 연결해야 합니다.
```
aws opensearch associate-packages \
--domain-name {{my-domain}} \
--package-list '[{"PackageID": "{{plugin-package-id}}"},{"PackageID": "{{license-package-id}}","PrerequisitePackageIDList":["{{plugin-package-id}}"]},{"PackageID":"{{config-package-id}}","PrerequisitePackageIDList":["{{plugin-package-id}}"]}]'
```
## 다음 단계
연결이 완료되면 특정 인덱스에서 플러그인을 활성화하거나 요구 사항에 따라 구성할 수 있습니다. 서드 파티 플러그인 기능을 특정 인덱스에 적용하려면 인덱스 생성 중에 인덱스 설정을 수정하거나 기존 인덱스를 업데이트합니다. 예를 들어 타사 플러그인에 [사용자 지정 분석기](https://opensearch.org/docs/latest/analyzers/custom-analyzer/)가 포함된 경우 인덱스 설정에서 참조합니다.
플러그인 기능을 여러 인덱스에 일관되게 적용하려면 플러그인 구성이 포함된 [인덱스 템플릿](https://opensearch.org/docs/latest/im-plugin/index-templates/)을 사용합니다. OpenSearch 설정에 맞게 기능을 구성하는 방법은 언제든 플러그인 설명서를 참조하세요.