

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Installazione di plug-in di terze parti in Amazon Service OpenSearch
<a name="plugins-third-party"></a>

Amazon OpenSearch Service supporta plug-in di terze parti di partner selezionati. Questi plugin possono migliorare la OpenSearch configurazione con funzionalità aggiuntive come analizzatori personalizzati, tokenizzatori o funzionalità di crittografia. Segui le istruzioni specifiche di installazione e configurazione fornite dagli sviluppatori di terze parti per garantire la corretta integrazione con il tuo dominio di servizio. OpenSearch 

**Nota**  
È necessario ottenere e mantenere licenze valide direttamente dagli sviluppatori di terze parti. Alcuni provider potrebbero non abilitare completamente i propri plug-in Regioni AWS, quindi verifica la disponibilità con il fornitore del plug-in.

I seguenti plugin di terze parti sono disponibili per l'uso con OpenSearch Service:
+ **Plugin di crittografia Portal26 (Titanium-lockbox)**: utilizza la crittografia certificata NIST FIPS 140-2 per crittografare i dati durante l'indicizzazione. Include il supporto Bring Your Own Key (BYOK), che consente di gestire le chiavi di crittografia per una maggiore sicurezza. Il plugin è fornito da [Portal26](https://portal26.ai/) e richiede la OpenSearch versione 2.15 o successiva.
+ **Name Match (RNI)**: abbina nomi, organizzazioni, indirizzi e date in oltre 24 lingue, il che migliora la sicurezza e la conformità. Il plugin è fornito da [Babel Street](https://www.babelstreet.com/) e richiede la OpenSearch versione 2.15 o successiva.

**Topics**
+ [Prerequisiti](#prerequisites-partner-plugins)
+ [Installazione di plugin di terze parti](#third-party-partner-plugins-install)
+ [Fasi successive](#third-party-partner-plugins-next)

## Prerequisiti
<a name="prerequisites-partner-plugins"></a>

Prima di installare un plug-in di terze parti, effettuate le seguenti operazioni:
+ Ha ottenuto i file di configurazione e licenza del plug-in e li ha caricati in un bucket Amazon S3. Il bucket deve appartenere allo stesso Regione AWS dominio.
+ Un plug-in di terze parti è un tipo di plug-in personalizzato. Assicurati che il dominio soddisfi i [prerequisiti per i](custom-plugins.md#custom-plugin-prerequisites) plugin personalizzati.

## Installazione di plugin di terze parti
<a name="third-party-partner-plugins-install"></a>

Per associare un plug-in di terze parti a un dominio di OpenSearch servizio, devi prima caricare tre pacchetti separati: il pacchetto di *licenza*, il pacchetto di *configurazione* e il pacchetto del *plug-in*.
+ Il pacchetto di **licenza** include le informazioni sulla licenza o i metadati associati al plug-in, in formato.json o.xml.
+ Il pacchetto **di configurazione** contiene i file di configurazione del plug-in e le risorse e le impostazioni di supporto. Questi file definiscono il comportamento o l'integrazione del plugin con. OpenSearch
+ Il pacchetto del **plugin** contiene il file binario del plugin compilato, che è il codice eseguibile che OpenSearch viene eseguito. Questo è il fulcro della funzionalità del plugin.

Dopo aver caricato entrambi i pacchetti, puoi associare il plugin e la licenza a un dominio compatibile.

### Console
<a name="third-party-partner-plugins-console"></a>

Per associare un plug-in di terze parti a un dominio, importate innanzitutto la licenza e la configurazione del plug-in come pacchetti.

**Per installare un plug-in di terze parti**

1. Accedi alla console di Amazon OpenSearch Service da [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home).

1. Nel riquadro di navigazione a sinistra, scegli **Pacchetti**.

1. Innanzitutto, importa il pacchetto di licenza. Scegli **Importa pacchetto**.

1. Per **Tipo di pacchetto**, scegli **Licenza**.

1. Per **Package source**, inserisci il percorso del file JSON o XML della licenza in Amazon S3.

1. Scegli **Importa**. **Il pacchetto viene visualizzato nella scheda **Licenze** della pagina Pacchetti.** 

1. Ora, importa la configurazione del plugin. Scegli nuovamente **Importa pacchetto**.

1. Per **Tipo di Package**, scegli **Configuration**.

1. Per **Package source**, inserisci il percorso del file ZIP di configurazione del plug-in in Amazon S3.

1. Scegli **Importa**.

1. Infine, importa il plugin stesso. Scegli **Importa pacchetto**.

1. Per **Tipo di pacchetto**, scegli **Plugin**.

1. Per **Package source**, inserisci il percorso del file ZIP del plug-in in Amazon S3.

1. Seleziona la versione OpenSearch del motore supportata dal plug-in.

1. Scegli **Importa**.

**Per associare un plug-in di terze parti a un dominio**

1. Ora associa la licenza e la configurazione del plugin al dominio. Nel riquadro di navigazione a sinistra, scegli **Domains** (Domini).

1. Scegli il nome del dominio per aprire la configurazione del cluster.

1. Vai alla scheda **Plugin**.

1. Scegli **Associa pacchetti** e seleziona il plugin, la licenza e i pacchetti di configurazione che hai appena importato.

1. Scegli **Seleziona**.

1. Scegli **Next (Successivo)**. Esamina i pacchetti da associare e scegli **Associa**.

### CLI
<a name="third-party-partner-plugins-cli"></a>

Innanzitutto, utilizzate il comando [create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) per creare un nuovo pacchetto che contenga la licenza del plugin. `S3Key`Deve puntare a un file.json o.xml in Amazon S3 che includa il testo o i metadati della licenza.

```
aws opensearch create-package \
  --package-name plugin-license-package \
  --package-type PACKAGE-LICENSE \
  --package-source S3BucketName=my-bucket,S3Key=licenses/my-plugin-license.json
```

Usa nuovamente il comando [create-package per creare un pacchetto](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) che contenga la configurazione del plugin. `S3Key`Deve puntare a un file.zip in Amazon S3 che aderisca alla struttura di directory prevista dal plug-in.

```
aws opensearch create-package \
  --package-name plugin-config-package \
  --package-type PACKAGE-CONFIG \
  --package-source S3BucketName=my-bucket,S3Key=path/to/package.zip
```

Usa nuovamente il comando [create-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/create-package.html) per creare un pacchetto che contenga il plugin stesso. `S3Key`Deve puntare al file.zip del plugin in Amazon S3.

```
aws opensearch create-package \
  --package-name plugin-package \
  --package-type ZIP-PLUGIN \
  --package-source S3BucketName=my-bucket,S3Key=path/to/package.zip
```

Infine, usa il comando [associate-package](https://docs.aws.amazon.com/cli/latest/reference/opensearch/associate-package.html) per collegare il plug-in partner, la licenza e la configurazione a un dominio compatibile specificando il pacchetto per ciascuno. IDs Specificate l'ID del plugin come prerequisito per gli altri pacchetti, il che significa che deve essere associato al dominio prima degli altri pacchetti.

```
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"]}]'
```

## Fasi successive
<a name="third-party-partner-plugins-next"></a>

Una volta completata l'associazione, potete abilitare il plugin su indici specifici o configurarlo secondo necessità in base alle vostre esigenze. Per applicare la funzionalità dei plug-in di terze parti a indici specifici, modifica le impostazioni dell'indice durante la creazione dell'indice o aggiorna gli indici esistenti. Ad esempio, se il tuo plug-in di terze parti include un [analizzatore personalizzato](https://opensearch.org/docs/latest/analyzers/custom-analyzer/), fai riferimento a esso nelle impostazioni dell'indice. 

Per applicare le funzionalità del plug-in in modo uniforme su più indici, utilizzate [modelli di indice](https://opensearch.org/docs/latest/im-plugin/index-templates/) che includono le configurazioni del plug-in. Consultate sempre la documentazione del plugin per capire come configurarne le funzionalità per la vostra configurazione. OpenSearch 