Aller au contenu principal

Configurer l’authentification pour Productboard

info

Bêta

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

Pour permettre au connecteur Productboard de Lakeflow Connect de s'authentifier, enregistrez une application OAuth serveur à serveur dans Productboard et upload la clé publique d'une paire de clés RSA. Le connecteur utilise l'OAuth serveur à serveur de Productboard, signant un jeton Web JSON (JWT) avec votre clé privée. Utilisez les identifiants récupérés à partir des étapes décrites dans cette page pour créer une connexion Unity Catalog dans Databricks.

Prérequis​

  • Accès administrateur au workspace Productboard. Productboard nécessite un accès administrateur de workspace pour enregistrer une application OAuth serveur à serveur.
  • Un utilisateur Productboard activé dans ce workspace. Le connecteur se connecte en tant qu'utilisateur, son e-mail correspond donc à l' e-mail de l'utilisateur sur la connexion.
  • Un outil permettant de générer une paire de clés RSA, comme OpenSSL.

Configurer Productboard​

Enregistrez une application OAuth serveur à serveur dans Productboard et upload la moitié publique d'une paire de clés RSA. Pour en savoir plus, consultez Serveur à serveur OAuth dans la documentation pour développeurs de Productboard.

  1. Générez une paire de clés RSA d'au moins 2048 bits au format PEM. Par exemple :

    Bash
    openssl genrsa -out productboard_private_key.pem 2048
    openssl rsa -in productboard_private_key.pem -pubout -out productboard_public_key.pem
  2. Connectez-vous à Productboard en tant qu'administrateur de workspace et allez sur https://app.productboard.com/oauth2/applications.

  3. Cliquez sur Nouvelle application .

  4. Sur la page Nouvelle application OAuth , sous Type d’application , sélectionnez Serveur à serveur .

  5. Dans Nom , saisissez un nom pour l'application.

  6. Dans Workspace , sélectionnez le workspace à partir duquel vous souhaitez effectuer l'ingestion. Vous ne pouvez pas changer le workspace après avoir créé l'application.

  7. Dans Clé publique , collez le contenu de productboard_public_key.pem, y compris les lignes -----BEGIN PUBLIC KEY----- et -----END PUBLIC KEY-----. Gardez la clé privée sur votre système. Productboard ne délivre pas de secret client pour ce flux.

  8. Sous Portées , dans la liste Portées d'API V2 , sélectionnez les portées de lecture suivantes, que le connecteur demande :

Portée

Tables

entities:read

features, products, components, feature_statuses, companies, users, release_groups, releases, objectives, key_results, initiatives, feature_relationships, component_relationships, field_definitions

notes:read

notes, note_field_definitions

members:read

members

teams:read

teams

members:pii:read

Les adresses e-mail du propriétaire et du créateur ne sont pas expurgées dans les tables d'entités et dans notes, et les noms des membres, les noms d'utilisateur et les adresses e-mail ne sont pas expurgés dans members.

users:pii:read

Noms d’utilisateurs et adresses e-mail non expurgés dans users.

Portée

Tables

entities:read

features, products, components, feature_statuses, companies, users, release_groups, releases, objectives, key_results, initiatives, feature_relationships, component_relationships, field_definitions

notes:read

notes, note_field_definitions

members:read

members

teams:read

teams

members:pii:read

Les adresses e-mail du propriétaire et du créateur ne sont pas expurgées dans les tables d'entités et dans notes, et les noms des membres, les noms d'utilisateur et les adresses e-mail ne sont pas expurgés dans members.

users:pii:read

Noms d’utilisateurs et adresses e-mail non expurgés dans users.

Si l’application ne dispose pas de members:pii:read ou users:pii:read, Productboard renvoie [redacted] à la place de ces valeurs.

Sélectionnez les portées dans API V2 Scopes , et non dans API V1 Scopes (Classic) . Le connecteur utilise l’API Productboard v2. 9. Cliquez sur Créer une application .

  1. Consignez les valeurs suivantes. Vous les saisissez lors de la création d’une connexion dans Databricks :

    • L’ ID client de l’application.
    • Adresse e-mail de l'utilisateur Productboard activé avec laquelle le connecteur se connecte.
    • Le contenu complet du fichier de clé privée, incluant les lignes -----BEGIN et -----END.

Étapes suivantes​

Créez une connexion Productboard dans Databricks. Consultez Créer une connexion Productboard.