Pular para o conteúdo principal
Este artigo demonstra como os clientes do ClickPipes podem usar o acesso baseado em funções para se autenticar no Amazon Kinesis e acessar seus streams de dados com segurança.

Pré-requisitos

Para seguir este guia, você precisará de:
  • Um serviço ClickHouse Cloud ativo
  • Uma conta AWS

Introdução

Antes de entrar na configuração do acesso seguro ao Kinesis, é importante entender o mecanismo. Veja a seguir uma visão geral de como o ClickPipes pode acessar streams do Amazon Kinesis ao assumir uma função nas contas AWS dos clientes. Com essa abordagem, os clientes podem gerenciar todo o acesso aos streams de dados do Kinesis em um único lugar (a política do IAM da função assumida), sem precisar modificar individualmente a política de acesso de cada stream.

Configuração

Obtendo o ARN da função de IAM do serviço ClickHouse

    1. Faça login na sua conta do ClickHouse Cloud.
    1. Selecione o serviço do ClickHouse para o qual você deseja criar a integração
    1. Selecione a guia Settings
    1. Role a página até a seção Network security information, na parte inferior da página
    1. Copie o valor de Service role ID (IAM) do serviço, como mostrado abaixo.

Configurar a assunção de função no IAM

Criar uma função de IAM manualmente.

    1. Faça login na sua conta AWS no navegador com um usuário do IAM que tenha permissão para criar e gerenciar uma função de IAM.
    1. Acesse o Console do IAM
    1. Crie uma nova função de IAM com Trusted Entity Type igual a AWS account. Observe que o nome da função de IAM deve começar com ClickHouseAccessRole- para que isso funcione.
    i. Configure a política de confiança A política de confiança permite que a função de IAM do ClickHouse assuma essa função de IAM. Substitua {ClickHouse_IAM_ARN} pelo ARN da função de IAM do seu serviço ClickHouse (obtido na etapa anterior).
    ii. Configure a política de permissões A política de permissões concede acesso ao seu stream do Kinesis. Substitua os seguintes placeholders:
    • {REGION}: Sua região da AWS (por exemplo, us-east-1)
    • {ACCOUNT_ID}: O ID da sua conta AWS
    • {STREAM_NAME}: O nome do seu stream do Kinesis
    1. Copie o novo IAM Role Arn após a criação. É isso que você precisará para acessar seu stream do Kinesis.
Última modificação em 25 de junho de 2026