Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Installation de plugins tiers dans Amazon OpenSearch Service
Amazon OpenSearch Service prend en charge les plug-ins tiers de partenaires sélectionnés. Ces plugins peuvent améliorer votre OpenSearch configuration grâce à des fonctionnalités supplémentaires telles que des analyseurs personnalisés, des tokeniseurs ou des fonctionnalités de chiffrement. Suivez les instructions d'installation et de configuration spécifiques fournies par les développeurs tiers pour garantir une intégration correcte avec votre domaine OpenSearch de service.
**Note**
Vous devez obtenir et conserver des licences valides directement auprès des développeurs tiers. Il se peut que certains fournisseurs n'activent pas du tout leurs plug-ins Régions AWS, alors vérifiez auprès du fournisseur de plug-in pour en connaître la disponibilité.
Les plugins tiers suivants peuvent être utilisés avec le OpenSearch Service :
+ **Plug-in de chiffrement Portal26 (Titanium-LockBox)** — Utilise le cryptage certifié NIST FIPS 140-2 pour chiffrer les données au fur et à mesure de leur indexation. Il inclut le support BYOK (Bring Your Own Key), qui vous permet de gérer vos clés de chiffrement pour une sécurité renforcée. Le plugin est fourni par [Portal26](https://portal26.ai/) et nécessite la OpenSearch version 2.15 ou supérieure.
+ **Name Match (RNI) : fait** correspondre les noms, les organisations, les adresses et les dates dans plus de 24 langues, ce qui améliore la sécurité et la conformité. Le plugin est fourni par [Babel Street](https://www.babelstreet.com/) et nécessite la OpenSearch version 2.15 ou supérieure.
**Topics**
+ [Conditions préalables](#prerequisites-partner-plugins)
+ [Installation de plugins tiers](#third-party-partner-plugins-install)
+ [Étapes suivantes](#third-party-partner-plugins-next)
## Conditions préalables
Avant d'installer un plug-in tiers, effectuez les opérations suivantes :
+ J'ai obtenu les fichiers de configuration et de licence du plugin et je les ai téléchargés dans un compartiment Amazon S3. Le bucket doit se trouver dans le même domaine Région AWS que le domaine.
+ Un plugin tiers est un type de plugin personnalisé. Assurez-vous que le domaine répond aux [conditions requises pour les](custom-plugins.md#custom-plugin-prerequisites) plugins personnalisés.
## Installation de plugins tiers
Pour associer un plug-in tiers à un domaine de OpenSearch service, vous devez d'abord télécharger trois packages distincts : le package de *licence*, le package de *configuration* et le package de *plug-in*.
+ Le package **de licence** inclut les informations de licence ou les métadonnées associées au plugin, au format .json ou .xml.
+ Le package **de configuration** contient les fichiers de configuration du plugin ainsi que les ressources et paramètres associés. Ces fichiers définissent le comportement ou l'intégration du plugin. OpenSearch
+ Le package du **plugin** contient le binaire du plugin compilé, qui est le code exécutable qui OpenSearch s'exécute. C'est le cœur de la fonctionnalité du plugin.
Après avoir chargé les deux packages, vous pouvez associer le plugin et la licence à un domaine compatible.
### Console
Pour associer un plugin tiers à un domaine, importez d'abord la licence et la configuration du plugin sous forme de packages.
**Pour installer un plugin tiers**
1. Connectez-vous à la console Amazon OpenSearch Service à la [https://console.aws.amazon.com/aos/maison](https://console.aws.amazon.com/aos/home).
1. Dans le volet de navigation de gauche, choisissez **Packages**.
1. Importez d'abord le package de licence. Choisissez **Import package (Importer un package)**.
1. Pour **Type de package**, choisissez **Licence**.
1. Dans le **champ Source du package**, entrez le chemin d'accès au fichier JSON ou XML de licence dans Amazon S3.
1. Choisissez **Importer**. Le package apparaît dans l'onglet **Licences** de la page **Packages**.
1. Importez maintenant la configuration du plugin. Choisissez à nouveau **Importer le package**.
1. Pour **Type de package**, choisissez **Configuration**.
1. Dans le **champ Source du package**, entrez le chemin d'accès au fichier ZIP de configuration du plugin dans Amazon S3.
1. Choisissez **Importer**.
1. Enfin, importez le plugin lui-même. Choisissez **Import package (Importer un package)**.
1. Pour le **type de package**, choisissez **Plugin**.
1. Dans le **champ Source du package**, entrez le chemin d'accès au fichier ZIP du plugin dans Amazon S3.
1. Sélectionnez la version OpenSearch du moteur prise en charge par le plugin.
1. Choisissez **Importer**.
**Pour associer un plugin tiers à un domaine**
1. Associez maintenant la licence et la configuration du plugin au domaine. Dans le volet de navigation de gauche, choisissez **Domaines**.
1. Choisissez le nom du domaine pour ouvrir sa configuration de cluster.
1. Accédez à l'onglet **Plugins**.
1. Choisissez **Associer des packages**, puis sélectionnez les packages de plug-in, de licence et de configuration que vous venez d'importer.
1. Choisissez **Select (Sélectionner)**.
1. Choisissez **Suivant**. Passez en revue les packages à associer et choisissez **Associer**.
### INTERFACE DE LIGNE DE COMMANDE (CLI)
Tout d'abord, utilisez la commande [create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) pour créer un nouveau package contenant la licence du plugin. Ils `S3Key` doivent pointer vers un fichier .json ou .xml dans Amazon S3 qui inclut le texte de licence ou les métadonnées.
```
aws opensearch create-package \
--package-name plugin-license-package \
--package-type PACKAGE-LICENSE \
--package-source S3BucketName=my-bucket,S3Key=licenses/my-plugin-license.json
```
Utilisez à nouveau la commande [create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) pour créer un package contenant la configuration du plugin. `S3Key`Il doit pointer vers un fichier .zip dans Amazon S3 qui respecte la structure de répertoire attendue par le plugin.
```
aws opensearch create-package \
--package-name plugin-config-package \
--package-type PACKAGE-CONFIG \
--package-source S3BucketName=my-bucket,S3Key=path/to/package.zip
```
Utilisez à nouveau la commande [create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) pour créer un package contenant le plugin lui-même. `S3Key`Il doit pointer vers le fichier .zip du plugin dans Amazon S3.
```
aws opensearch create-package \
--package-name plugin-package \
--package-type ZIP-PLUGIN \
--package-source S3BucketName=my-bucket,S3Key=path/to/package.zip
```
Enfin, utilisez la commande [associate-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/associate-package.html) pour lier le plugin, la licence et la configuration partenaires à un domaine compatible en spécifiant le package IDs pour chacun d'eux. Spécifiez l'ID du plugin comme condition préalable pour les autres packages, ce qui signifie qu'il doit être associé au domaine avant les autres packages.
```
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"]}]'
```
## Étapes suivantes
Lorsque l'association est terminée, vous pouvez activer le plugin sur des index spécifiques ou le configurer selon vos besoins en fonction de vos besoins. Pour appliquer des fonctionnalités de plug-in tiers à des index spécifiques, modifiez les paramètres d'index lors de la création de l'index ou mettez à jour les index existants. Par exemple, si votre plug-in tiers inclut un [analyseur personnalisé](https://opensearch.org/docs/latest/analyzers/custom-analyzer/), référencez-le dans les paramètres d'index.
Pour appliquer les fonctionnalités du plugin de manière cohérente sur plusieurs index, utilisez des [modèles d'index](https://opensearch.org/docs/latest/im-plugin/index-templates/) qui incluent les configurations du plugin. Consultez toujours la documentation du plugin pour comprendre comment configurer ses fonctionnalités pour votre OpenSearch installation.