# Elasticsearch Integration ## Elasticsearch Configuration Process. #### Welcome to Pier Cloud! This document aims to be a guide so that you can prepare the environment to connect the Pier Cloud platform with Elasticsearch using an API connection. ### In the Elasticsearch environment As a premise, you need to create an API Key in Elasticsearch. Below, you will find a detailed step-by-step guide on how to configure this. #### To start the configuration, log in to the elastic cloud portal at the link: . * Enter the registered email and password provided by your organization. \ Note: To perform this procedure, you must be an “Organization owner”.
1. Here click on the user icon in the upper right corner, then select the Organization option, as illustrated in the image below.
2. Here click on **API keys**, as illustrated in the image below.
3. In this step click on **Create API key**.
4. In **Step 1**, under **Add name**, add a name to identify the API key. In **Step 2**, under **Set expiration**, select the API expiration period (in this case, we will choose 1 year). In **Step 3**, under **Assign roles**, enable the **Billing Admin** option. Then, click on **Create API key**, as illustrated in the image below. Note: This procedure must be performed by the **Organization Owner**.
5. Here, copy the generated key and paste it into a notepad or click on **Download API key**, as illustrated in the image below.
6. API key created successfully! * Note down the **Organization ID**, as illustrated in the image below. * With the **Organization ID** and the **key generated** when creating the API key, we can now proceed to the configuration on the Platform.
### On the Pier Cloud Platform 1. On the Pier Cloud platform, click on your user icon, then **settings**.
2. Here click on **Secrets**, as shown in the image below:
3. In this step, click on **+ Add.**
4. In the **Name** field, enter a name to identify the Secret, such as "Elastic Cloud API\_Key". In the **Type** field, select the type of Secret to be created; in this case, choose "API Key". In the **API Key** field, enter the API key generated in the step 10. Finally, click **Save** to complete the Secret creation.
5. The Secret for Elasticsearch has been successfully created! We can move on to the next step, so click on **Data Connectors** in the menu on the left, and then click on **+ Add**, to create the data connector, as illustrated below.
7. In the **Data Connector** field, select the data connector type, which in this case will be "Elastic Cloud". Then, in the **Data Connector Identifier Name** field, enter a name to identify the connector, such as "Elastic Cloud". In the **Select the Secret for this data connector** field, choose the secret created in the previous step, called "Elastic Cloud API\_Key". In the **Organization ID** field, enter the Organization ID obtained in the step 11. Finally, click **Save** to create the data connector, as illustrated in the image below.
8. The ElasticSearch Data connectors have been successfully created! As illustrated in the image below.