> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação de banco de dados com AWS IAM (RDS/Aurora)

> Este artigo mostra como os clientes do ClickPipes podem usar o controle de acesso baseado em funções para se autenticar no Amazon RDS/Aurora e acessar o banco de dados com segurança.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

Este artigo demonstra como os clientes do ClickPipes podem usar o controle de acesso baseado em funções para se autenticar no Amazon Aurora e no RDS e acessar seus bancos de dados com segurança.

<div id="setup">
  ## Configuração
</div>

<div id="before-you-start">
  ### Antes de começar
</div>

<div id="make-sure-iam-authentication-is-enabled">
  #### Certifique-se de que a autenticação IAM esteja habilitada
</div>

1. Faça login na sua conta da AWS e vá até a instância do RDS que você quer configurar.
2. Clique no botão **Modify**.
3. Role a página para baixo até a seção **Database authentication**.
4. Ative a opção **Password and IAM database authentication**.
5. Clique no botão **Continue**.
6. Revise as alterações e clique na opção **Apply immediately**.

<div id="setting-up-the-database-user">
  #### Configurando o usuário do banco de dados
</div>

Conecte-se à sua instância do RDS/Aurora e crie um usuário do banco de dados com a autenticação IAM habilitada. Em seguida, siga as demais etapas do seu guia de configuração da origem para configurar sua instância para o ClickPipes:

* [Guia de configuração da origem do AWS Aurora para PostgreSQL](/docs/pt-BR/integrations/clickpipes/postgres/source/aurora#configure-database-user)
* [Guia de configuração da origem do AWS RDS para PostgreSQL](/docs/pt-BR/integrations/clickpipes/postgres/source/rds#configure-database-user)
* [Guia de configuração da origem do AWS Aurora para MySQL](/docs/pt-BR/integrations/clickpipes/mysql/source/aurora#configure-database-user)
* [Guia de configuração da origem do AWS RDS para MySQL](/docs/pt-BR/integrations/clickpipes/mysql/source/rds#configure-database-user)

<div id="obtaining-the-clickhouse-service-iam-role-arn">
  ### Obtendo o ARN da função IAM do serviço ClickHouse
</div>

1 - Faça login na sua conta do ClickHouse Cloud.

2 - Selecione o serviço ClickHouse para o qual você deseja criar a integração

3 - Selecione a aba **Settings**

4 - Role a página até a seção **Network security information** na parte inferior da página

5 - Copie o valor de **Service role ID (IAM)** associado ao serviço, como mostrado abaixo.

<Image img="https://mintcdn.com/private-7c7dfe99/7KTNIE_ER4ouwRNt/images/cloud/security/secures3_arn.webp?fit=max&auto=format&n=7KTNIE_ER4ouwRNt&q=85&s=1b8e4dd1eccec32d9a7308147df29e06" alt="ARN do S3 seguro" size="lg" border width="1222" height="254" data-path="images/cloud/security/secures3_arn.webp" />

Vamos chamar esse valor de `{ClickHouse_IAM_ARN}`. Essa é a função IAM que será usada para acessar sua instância do RDS/Aurora.

<div id="setting-up-iam-role">
  ### Como configurar a função IAM
</div>

<div id="obtaining-the-rds-resource-id">
  #### Obtendo o ID do recurso do RDS/Aurora
</div>

1. Faça login na sua conta da AWS e navegue até a instância do RDS ou o cluster do Aurora que você deseja configurar.
2. Clique na guia **Configuration**.
3. Anote o valor de **Resource ID**. Ele deve se parecer com `db-xxxxxxxxxxxxxx` para RDS ou `cluster-xxxxxxxxxxxxxx` para um cluster do Aurora. Vamos chamar esse valor de `{RDS_RESOURCE_ID}`. Esse é o ID do recurso que será usado na política do IAM para permitir o acesso à instância do RDS.

<div id="manually-create-iam-role">
  #### Criar função IAM manualmente.
</div>

1 - Faça login na sua conta da AWS no navegador com um usuário do IAM que tenha permissão para criar e gerenciar funções IAM.

2 - Acesse o Console do IAM

3 - Crie uma nova função IAM com a seguinte política de IAM e de confiança.

Política de confiança (substitua `{ClickHouse_IAM_ARN}` pelo ARN da função IAM pertencente à sua instância do ClickHouse):

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "{ClickHouse_IAM_ARN}"
      },
      "Action": [
        "sts:AssumeRole",
        "sts:TagSession"
      ]
    }
  ]
}
```

Política do IAM (substitua `{RDS_RESOURCE_ID}` pelo ID do recurso da sua instância do RDS). Certifique-se de substituir `{RDS_REGION}` pela região da sua instância do RDS/Aurora e `{AWS_ACCOUNT}` pelo ID da sua conta da AWS:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "rds-db:connect"
      ],
      "Resource": [
        "arn:aws:rds-db:{RDS_REGION}:{AWS_ACCOUNT}:dbuser:{RDS_RESOURCE_ID}/clickpipes_iam_user"
      ]
    }
  ]
}
```

4 - Copie o novo **ARN da função IAM** após a criação. Isso é necessário para acessar com segurança seu banco de dados da AWS a partir do ClickPipes. Vamos chamá-lo de `{RDS_ACCESS_IAM_ROLE_ARN}`.

Agora você pode usar essa função IAM para se autenticar na sua instância RDS/Aurora a partir do ClickPipes.