Configurer l’authentification auprès de Xero

info

Bêta

Cette fonctionnalité est en version Bêta. Pour l'utiliser, un administrateur de workspace doit activer Lakeflow Connect for Xero depuis la page Previews . Consultez Gérer les aperçus Databricks.

Pour permettre au connecteur Lakeflow Connect Xero de s’authentifier, créez une application web dans le portail Xero Developer et notez l’ID du tenant de l’organisation à ingérer. Utilisez les identifiants récupérés à partir des étapes de cette page pour créer une connexion au Unity Catalog dans Databricks.

Prérequis

• Une organisation Xero avec un abonnement Xero en version d'essai ou payant. Pour tester le connecteur, utilisez la Demo Company de Xero. Voir Getting start.
• Un compte développeur Xero, gratuit. Le niveau de Tarifs développeur de votre application définit le nombre d’organisations auxquelles l’application peut se connecter et sa limite quotidienne d’appels d’API.
• L’utilisateur qui autorise la connexion doit avoir un accès Standard, Conseiller ou Administrateur à l’organisation avec l’autorisation Applications connectées. Voir Autorisations.
• Pour ingérer la table projects, l’organisation doit ajouter Xero Projects à son abonnement, et l’utilisateur autorisateur doit avoir un rôle d’utilisateur Xero Projects. Voir Gérer votre abonnement Xero Projects et l’ aperçu de l’API Projects.
• Votre domaine de Workspace Databricks pour définir l’URI de redirection de l’application.

Configurer Xero

Le connecteur Xero s'authentifie à l'aide de l'autorisation OAuth utilisateur-machine (U2M) via une application web Xero. Dans cette étape, créez une application, enregistrez l'URI de redirection Databricks et notez les identifiants que vous saisissez sur la page de connexion. Pour plus d'informations, voir la vue d'ensemble de Xero OAuth 2.0.

1. Connectez-vous au portail des développeurs Xero et cliquez sur My Apps .
2. Cliquez sur Nouvelle application .
3. Dans la boîte de dialogue Ajouter une nouvelle application Xero , saisissez un Nom d’application et sélectionnez Application web comme Type d’intégration .
4. Répondez aux questions concernant l'entraînement des modèles IA et les exigences de sécurité minimales de Xero.
5. Pour Company or application URL , saisissez l'URL de votre entreprise.
6. Pour OAuth 2.0 redirect URI , saisissez https://<your-databricks-workspace-domain>/login/oauth/http.html.
7. Cochez la case pour accepter les conditions générales de la plateforme développeur Xero, puis cliquez sur Créer une application .
8. Dans l’application, cliquez sur le tab Configuration , puis cliquez sur Générer un secret . Xero n’affiche le secret qu’une seule fois.
9. Notez l' ID client et le secret client. Utilisez ces informations d'identification pour créer une connexion Unity Catalog dans Databricks.

Le connecteur demande un ensemble fixe de portées en lecture seule lors de votre connexion ; l'application n'a donc besoin d'aucune configuration de portée. Pour consulter la liste, reportez-vous aux autorisations OAuth requises.

Trouver l’ID du tenant

Chaque pipeline ingère une organisation Xero, dont le nom est indiqué par l’option tenant_id obligatoire. Xero identifie chaque organisation à laquelle une application se connecte à l’aide d’un ID de tenant. Consultez les tenants.

1. Appelez GET https://api.xero.com/connections avec un jeton d’accès autorisé pour l’organisation. La requête ne nécessite pas d’en-tête Xero-Tenant-Id. Par exemple, ouvrez le Xero API Explorer, cliquez sur Connectez votre organisation Xero , sélectionnez l’organisation, puis exécutez la requête.
2. La réponse liste une entrée pour chaque tenant connecté. Trouvez l'entrée dont le tenantName correspond à votre organisation et notez sa valeur tenantId. Utilisez tenantId et non id, qui identifie la connexion.

Étapes suivantes

Créer une connexion Xero dans Databricks. Voir Créer une connexion Xero.