Pular para o conteúdo principal
Última atualização em

Configurar autenticação para Xero

info

Beta

Este recurso está na versão Beta. Para usá-lo, um administrador de workspace deve habilitar o Lakeflow Connect para Xero na página Prévias . Consulte Gerenciar prévias do Databricks.

Para permitir que o conector Xero do Lakeflow Connect seja autenticado, crie um aplicativo da web no portal do desenvolvedor do Xero e observe o tenant ID da organização a ser ingerida. Use as credenciais obtidas nos passos nesta página para criar uma conexão do Unity Catalog no Databricks.

Pré-requisitos​

  • Uma organização Xero em uma inscrição Xero de avaliação ou paga. Para testar o conector, use a Xero Demo Company. Consulte Começar.
  • Uma account de desenvolvedor Xero, que é gratuita. O nível de preços para desenvolvedores do seu aplicativo define a quantidade de organizações às quais ele pode se conectar e seu limite diário de chamadas de API.
  • O usuário que autoriza a conexão deve ter acesso Standard, Adviser ou Administrator à organização com a permissão Connected Apps. Veja Permissões.
  • Para ingerir a tabela projects, a organização deve adicionar o Xero Projects à sua inscrição e o usuário que autoriza deve ter uma função de usuário do Xero Projects. Consulte Gerenciar sua inscrição no Xero Projects e a visão geral da API de projetos.
  • O domínio do seu workspace do Databricks, para definir o URI de redirecionamento do aplicativo.

Configurar Xero​

O conector Xero autentica com a autorização de usuário para máquina (U2M) OAuth através de um aplicativo Web Xero. Neste passo, crie um aplicativo, registre a URI de redirecionamento do Databricks e anote as credenciais que você inserir na página de conexão. Para obter mais informações, consulte a Visão geral do Xero OAuth 2.0.

  1. Entre no portal do desenvolvedor do Xero e clique em Meus aplicativos .
  2. Clique em Novo aplicativo .
  3. Na caixa de diálogo Adicionar um novo aplicativo Xero , insira um Nome do aplicativo e selecione Aplicativo Web como o Tipo de integração .
  4. Responda às perguntas sobre o treinamento de modelos de AI e os requisitos mínimos de segurança do Xero.
  5. Em URL da empresa ou aplicação , insira a URL da sua empresa.
  6. Em URI de redirecionamento do OAuth 2.0 , insira https://<your-databricks-workspace-domain>/login/oauth/http.html.
  7. Marque a caixa de seleção para concordar com os Termos e Condições da Plataforma de Desenvolvedores do Xero e clique em Criar aplicativo .
  8. No aplicativo, clique na tab Configuration e clique em Generate a secret . O Xero mostra o segredo apenas uma vez.
  9. Observe o Id do cliente e o segredo do cliente. Use essas credenciais para criar uma conexão Unity Catalog no Databricks.

O conector solicita um conjunto fixo de escopos somente leitura quando você entra, portanto, o aplicativo não precisa de configuração de escopo. Para obter a lista, consulte Permissões OAuth necessárias.

Encontre a ID do tenant​

Cada pipeline ingere uma organização Xero, que as opções tenant_id necessárias nomes. O Xero identifica cada organização à qual um aplicativo se conecta com uma ID de tenant. Veja tenant.

  1. Chame GET https://api.xero.com/connections com um access token autorizado para a organização. A solicitação não precisa do cabeçalho Xero-Tenant-Id. Por exemplo, abra o Explorador de API do Xero, clique em Connect your Xero organisation (Conectar sua organização Xero), selecione a organização e faça a execução da solicitação.
  2. A resposta lista uma entrada para cada tenant conectado. Encontre a entrada cujo tenantName corresponda à sua organização e anote seu valor de tenantId. Use tenantId, não id, que identifica a conexão.

Próximos os passos​

Crie uma conexão Xero no Databricks. Consulte Criar uma conexão Xero.

Nesta página