--- schema_version: "1" id: 2291dd4a5f70bb50e0ec66caff2f3b95680916caa6913c097894fb9ba1732a96 title: Configurar o Amazon Athena IAM OAuth collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/pro/desktop/amazon_athena_idp.md canonical_url: https://help.tableau.com/current/pro/desktop/pt-br/amazon_athena_idp.htm source_site: help.tableau.com content_type: documentation content_hash: 1d9420ba45db3ab4a8db8177c74aad0409a28cb41b1b7fc2c17b51340e846568 description: Set up OAuth 2.0/OIDC identity federation from an external IdP to Amazon Athena for Tableau. --- [Pular para o conteúdo principal](#main-content) # Configurar o Amazon Athena IAM OAuth A partir do Tableau 2023.2, você pode usar o OAuth 2.0/OIDC para federar a identidade de um provedor de identidade externo (IDP) para o Amazon Athena. Dependendo do fornecedor de identidade, existem diferentes passos necessários para configurar a integração. O Tableau fornece apenas instruções detalhadas sobre como configurar os produtos Tableau. Para obter instruções sobre como configurar seu provedor de identidade (como Okta), consulte a ajuda e os tutoriais desse produto. Este documento fornece uma visão geral resumida do processo de configuração. **Observação**: tokens de atualização de uso único (às vezes chamados de tokens de atualização contínua ou rotação de tokens de atualização) não são suportados para conexões OAuth usando o Tableau Bridge para o Tableau Cloud. O suporte para esses tokens está planejado para uma versão futura. **Observação:**etapas e links que estão fora do conteúdo do Tableau e do Salesforce podem não ser atualizados ou precisos. ## Configurar o provedor de identidades (IDP) 1. Crie clientes OAuth no IDP para Tableau Desktop e Tableau Server. O cliente Desktop habilita [PKCE](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) e usa redirecionamentos [http://localhost](http://localhost/). 2. Adicione quaisquer declarações personalizadas para autorização de funções. Para obter mais detalhes sobre reivindicações e escopos, consulte [Escopos vs Reivindicações](https://curity.io/resources/learn/scopes-vs-claims/). 3. Crie o arquivo de configuração do Tableau OAuth. Para obter detalhes sobre como fazer isso, consulte [Configuração e uso do OAuth](https://tableau.github.io/connector-plugin-sdk/docs/oauth) em [github](https://tableau.github.io/connector-plugin-sdk/docs/oauth), e exemplos [aqui](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth). Certifique-se de prefixar as IDs de configuração do Tableau OAuth com “custom\_”. 4. Instalar arquivos de configuração do Tableau OAuth em máquinas Tableau Desktop, Tableau Server e sites do Tableau Cloud, conforme explicado no tópico de configuração do OAuth vinculado acima. ## Configurar o IDP na AWS 1. Crie a entidade IDP. Veja os documentos da Amazon [Federação de Identidade Web](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_oidc.html), [Criar provedor de identidade OIDC](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html). 2. O IDP deve ser configurado para federar ao Athena de uma forma que funcione com o plug-in de driver do Tableau. As seguintes informações do provedor são usadas para fluxos do Tableau Server e do Tableau Desktop: AwsCredentialsProviderClass=com.simba.athena.iamsupport.plugin.JwtCredentialsProvider role\_session\_name=AthenaJWT 3. Criar funções e políticas especificamente para o PDI. Confira [Criar função para OIDC](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html) nos documentos da AWS. ## Configurar funções para Athena Anexe as políticas necessárias para o Athena. Há muitas maneiras de fazer isso. Uma delas é usar declarações personalizadas. Você pode usar declarações personalizadas no token openID para autorizar funções. Essas funções recebem acesso a outros recursos. Para obter mais informações, consulte: - Tutorial: [Configuração do acesso federado para usuários do Okta ao Athena usando Lake Formation e JDBC](https://docs.aws.amazon.com/athena/latest/ug/security-athena-lake-formation-jdbc-okta-tutorial.html). - [Acesso refinado a bancos de dados e tabelas no AWS Glue Data Catalog.](https://docs.aws.amazon.com/athena/latest/ug/fine-grained-access-to-glue-resources.html) ## Conectar-se ao Athena O usuário deve especificar a função ARN (Amazon Resource Name) da AWS a ser assumida e, em seguida, em Provedor do OAuth, selecionar a configuração do OAuth instalada anteriormente. Observe que o menu suspenso para selecionar uma configuração só aparecerá se houver várias configurações para escolher. Quando configurado corretamente, o usuário é redirecionado ao IDP para autenticar e autorizar tokens para o Tableau. O Tableau recebe tokens openid e de atualização. A AWS é capaz de validar o token e a assinatura do IDP, extrair o declarações do token, pesquisar o mapeamento do usuário para a função IAM e permitir ou bloquear o Tableau de assumir a função em nome do usuário. [Exemplo: AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html) ![faça login na janela do athena](/tableau/current/pt-br/pro/desktop/pt-br/Img/athenaidp_signin.png) ## Tokens Por padrão, o Athena OAuth IAM passa o token de ID ao driver. Para clientes locais, incluindo aqueles que usam o Tableau Bridge, você pode usar um arquivo TDC para transmitir o token de acesso. Para obter mais informações sobre como configurar e instalar arquivos .tdc, consulte [Personalizar e ajustar uma conexão](https://help.tableau.com/current/pro/desktop/pt-br/connect_customize.htm). ## Configuração do Okta Se estiver usando o Okta, é melhor usar um “servidor de autorização personalizado” em vez do “servidor de autorização organizacional”. Os servidores de autorização personalizados são mais flexíveis. Existe um servidor de autorização personalizado criado por padrão, chamado “default”. A URL de autorização pode se parecer com os seguintes exemplos. `https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize` ![painel okta](/tableau/current/pt-br/pro/desktop/pt-br/Img/athena_okta.png)