Pular para o conteúdo principal

Configurar autenticação para Oracle Eloqua

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect para Oracle Eloqua na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Para permitir que o conector Oracle Eloqua do Lakeflow Connect se autentique, registro um aplicativo no Oracle Eloqua AppCloud Developer Framework e encontre a URL base da API da sua instância do Oracle Eloqua. Use as credenciais recuperadas dos passos desta página para criar uma conexão do Unity Catalog no Databricks.

Pré-requisitos​

  • Uma instância do Oracle Eloqua e um usuário do Oracle Eloqua com permissões para os recursos que o conector ingere.
  • Um usuário Oracle Eloqua em um grupo de segurança com a permissão de ação Acesso ao Desenvolvedor de App Cloud . Esta permissão é necessária para fazer o registro de um aplicativo. Consulte a lista de permissões de ação do Oracle Eloqua.
  • A URL do seu workspace Databricks, para definir a URL de callback OAuth do aplicativo.

Configurar o Oracle Eloqua​

O conector Oracle Eloqua autentica com OAuth 2.0 usando a concessão de código de autorização. Para obter as credenciais do cliente, registro um aplicativo no Oracle Eloqua AppCloud Developer Framework. Em seguida, localize o URL base da API da sua instância do Oracle Eloqua.

O passo 1: registro um aplicativo Oracle Eloqua​

Consulte Registro seu aplicativo e Autenticar usando OAuth 2.0 na documentação do Oracle Eloqua.

  1. Entre no Oracle Eloqua.
  2. Selecione Configurações > Programador de AppCloud .
  3. Na página Desenvolvedor de aplicativos , clique em Criar aplicativo .
  4. Insira um Nome e uma Descrição para o aplicativo e insira a URL de uma imagem no campo Ícone . Todos os três campos são obrigatórios.
  5. Em OAuth Callback URL , insira https://<workspace-url>/login/oauth/http.html, onde <workspace-url> é o URL do seu workspace do Databricks.
  6. Ativar URL , Configurar URL , Status URL e Desinstalar URL são opcionais.
  7. Clique em Salvar .
  8. Registre a ID do cliente e o segredo do cliente do aplicativo. Para view o segredo do cliente , clique em Mostrar . O senhor deve inserir os dois valores ao criar a conexão.

O passo 2: Encontre o URL base da sua API​

O Oracle Eloqua hospeda cada instância em um dos vários data centers, chamados pods. A conexão requer a URL base do pod da sua instância, por exemplo https://secure.p03.eloqua.com. O endpoint https://login.eloqua.com/id retorna esta URL base. Veja Como determinar URLs base na documentação do Oracle Eloqua.

  1. Chame o endpoint /id com autenticação básica HTTP. Use o nome da sua empresa (nome do site), nome de usuário e senha no formato <site-name>\<username>:<password>:

    Bash
    curl --user '<site-name>\<username>:<password>' https://login.eloqua.com/id

    Para chamar esse endpoint, o usuário deve ter pelo menos as permissões de Usuários Avançados - Marketing .

  2. Na resposta, encontre o valor de urls.base. Use este valor como o URL Base da API ao criar a conexão. Insira apenas o esquema e o host, sem caminho ou barra final.

Os passos seguintes​

Crie uma conexão Oracle Eloqua no Databricks. Consulte Criar uma conexão Oracle Eloqua.