Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Connexion à Productboard Productboard est le système de gestion des produits qui aide les équipes produit à commercialiser les bons produits plus rapidement. Plus de 3 000 entreprises modernes axées sur les produits, comme Zendesk UiPath et Microsoft, utilisent Productboard pour comprendre ce dont les utilisateurs ont réellement besoin, hiérarchiser les prochaines étapes et rallier tout le monde autour de leur feuille de route. **Topics** + [AWS Glue support pour Productboard](productboard-support.md) + [Politiques contenant les opérations API pour la création et l’utilisation des connexions](productboard-configuring-iam-permissions.md) + [Configuration de Productboard](productboard-configuring.md) + [Configuration de connexions Productboard](productboard-configuring-connections.md) + [Lecture à partir d’entités Productboard](productboard-reading-from-entities.md) + [Options de connexion Productboard](productboard-connection-options.md) + [Création d’un compte Productboard](productboard-create-account.md) + [Limitations](productboard-connector-limitations.md) # AWS Glue support pour Productboard AWS Glue prend en charge Productboard comme suit : **Prise en charge en tant que source ?** Oui. Vous pouvez utiliser les tâches AWS Glue ETL pour interroger les données de Productboard. **Prise en charge en tant que cible ?** Non. **Versions de l’API Productboard prises en charge** v1 # Politiques contenant les opérations API pour la création et l’utilisation des connexions L'exemple de politique suivant décrit les AWS autorisations requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes : + [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement. + [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console. # Configuration de Productboard Avant de pouvoir AWS Glue utiliser le transfert depuis Productboard, vous devez satisfaire aux exigences suivantes : ## Configuration requise + Vous disposez d’un compte Productboard avec adresse e-mail et mot de passe. Pour plus d’informations sur la création d’un compte, consultez [Creating a Productboard account](productboard-create-account.md). + Vous devez avoir créé AWS un compte avec l'accès au service à AWS Glue. + Vous disposez des informations d'authentification d'un compte Productboard : soit un jeton JWT si vous souhaitez utiliser une authentification personnalisée, soit un identifiant client et un code secret si vous souhaitez utiliser .0. OAuth2 + Si l'utilisateur souhaite l'utiliser`OAuth2.0`, [enregistrez votre application auprès de Productboard](https://app.productboard.com/oauth2/applications/new) et configurez-la en suivant les instructions de la section [Comment intégrer Productboard via OAuth2 la documentation destinée aux développeurs](https://developer.productboard.com/docs/how-to-integrate-with-productboard-via-oauth2-developer-documentation). Si vous répondez à ces exigences, vous êtes prêt à vous connecter AWS Glue à votre compte Productboard. Pour les connexions classiques, vous n’avez rien d’autre à faire dans Productboard. # Configuration de connexions Productboard Productboard prend en charge l’authentification personnalisée et `OAuth2.0`. Pour `OAuth2.0`, Productboard prend en charge le type d’autorisation `AUTHORIZATION_CODE`. + Ce type d’autorisation est considéré comme `OAuth` tridimensionnel, car il repose sur la redirection des utilisateurs vers le serveur d’autorisation tiers pour authentifier l’utilisateur. Il est utilisé lors de la création de connexions via la AWS Glue console. L'utilisateur qui crée une connexion peut par défaut s'appuyer sur une application connectée AWS Glue dont il est propriétaire et où il n'a pas besoin de fournir d'informations `OAuth` connexes, à l'exception de son identifiant client Productboard et de son secret client. La AWS Glue console redirige l'utilisateur vers Productboard où il doit se connecter et autoriser AWS Glue les autorisations demandées pour accéder à son instance Productboard. + Les utilisateurs peuvent toujours choisir de créer leur propre application connectée dans Productboard et de fournir leur propre identifiant client et leur propre secret client lors de la création de connexions via la AWS Glue console. Dans ce scénario, ils seront toujours redirigés vers Productboard pour se connecter et autoriser l'accès AWS Glue à leurs ressources. + Ce type d’autorisation donne lieu à un jeton d’actualisation et à un jeton d’accès. Le jeton d’accès est de courte durée et peut être actualisé automatiquement sans interaction de l’utilisateur à l’aide du jeton d’actualisation. + Pour consulter la documentation publique de Productboard sur la création d'une application connectée pour `AUTHORIZATION_CODE OAuth` Flow, consultez [Comment intégrer à Productboard via OAuth2 la documentation destinée aux développeurs](https://developer.productboard.com/docs/how-to-integrate-with-productboard-via-oauth2-developer-documentation). Pour configurer une connexion Productboard : 1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes : + Pour l’authentification `OAuth` : pour l’application connectée gérée par le client, le secret doit contenir le secret du consommateur de l’application connectée avec `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` comme clé. + Pour `Custom auth` : pour l’application connectée gérée par le client, le secret doit contenir le `JWT token` de l’application connectée avec `access_token` comme clé. **Note** Il est indispensable de créer un secret par connexion dans AWS Glue. 1. Dans AWS Glue Studio, créez une connexion sous **Connexions de données** en suivant les étapes ci-dessous : 1. Lorsque vous sélectionnez une **source de données**, sélectionnez Productboard. 1. Sélectionnez le rôle IAM pour lequel AWS Glue vous pouvez assumer et qui dispose des autorisations nécessaires pour effectuer les actions suivantes : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Sélectionnez le type d’authentification pour vous connecter à une source de données : + Pour l’authentification `OAuth` : indiquez le `Token URL` et l’`User Managed Client Application ClientId` de l’application Productboard. 1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons. 1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau. 1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`. 1. Dans la configuration de votre AWS Glue tâche, fournissez `connectionName` une connexion réseau supplémentaire. # Lecture à partir d’entités Productboard **Conditions préalables** Un objet Productboard à partir duquel vous souhaitez lire. Reportez-vous au tableau des entités prises en charge ci-dessous pour vérifier les entités disponibles. **Entités prises en charge** + [Abuse-reports](https://productboard.com/developer/marketing/api/campaign-abuse/) + [Automation](https://productboard.com/developer/marketing/api/automation/list-automations/) + [Campagnes](https://productboard.com/developer/marketing/api/campaigns/list-campaigns/) + [Click-details](https://productboard.com/developer/marketing/api/link-clickers/) + [Lists](https://productboard.com/developer/marketing/api/link-clickers/) + [Membres](https://productboard.com/developer/marketing/api/list-segment-members/) + [Open-details](https://productboard.com/developer/marketing/api/list-members/) + [Segments](https://productboard.com/developer/marketing/api/list-segments/) + [Stores](https://productboard.com/developer/marketing/api/ecommerce-stores/list-stores/) + [Unsubscribed](https://productboard.com/developer/marketing/api/unsub-reports/) | Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge | | --- | --- | --- | --- | --- | --- | | Caractéristiques | Oui | Oui | Non | Oui | Oui | | Éléments | Non | Oui | Non | Oui | Non | | Produits | Non | Oui | Non | Oui | Non | | Statuts des fonctionnalités | Non | Oui | Non | Oui | Oui | | Définitions de champs personnalisés | Non | Oui | Non | Oui | Non | | Valeurs de champs personnalisés | Oui | Oui | Non | Oui | Non | **Exemple** ``` Productboard_read = glueContext.create_dynamic_frame.from_options( connection_type="Productboard", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "feature", "API_VERSION": "1" } ``` **Détails des entités et des champs Productboard** + [Fonctions](https://developer.productboard.com/#tag/features) + [Composants](https://developer.productboard.com/#tag/components) + [Statuts des fonctionnalités](https://developer.productboard.com/#tag/statuses) + [Produits](https://developer.productboard.com/#tag/products) + [Définitions de champs personnalisés](https://developer.productboard.com/#tag/hierarchyEntitiesCustomFields) + [Valeurs de champs personnalisés](https://developer.productboard.com/#tag/hierarchyEntitiesCustomFieldsValues) # Options de connexion Productboard Les options de connexion pour Productboard sont les suivantes : + `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Le nom de votre objet dans Productboard. + `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Version d’API Rest de Productboard Engage que vous souhaitez utiliser. Par exemple : 3.0. + `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’objet. + `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark. + `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète. # Création d’un compte Productboard 1. Accédez à la [page de connexion à Productboard](https://app.productboard.com/), saisissez votre adresse e-mail et votre mot de passe, puis choisissez **M’inscrire**. 1. Dans le champ **Nom du compte**, saisissez le nom de votre compte Productboard, puis cochez la case **J’accepte la politique de confidentialité**. 1. Sur la page **Créez à présent votre espace de travail**, dans le champ **URL de l’espace de travail**, entrez l’URL de votre nouvel espace de travail. Choisissez ensuite **Continuer** pour passer à la page suivante et fournir les informations restantes. Cela permet de créer votre compte d’essai. Le compte d’essai est gratuit pendant 15 jours. Une fois votre période d’essai expirée, vous pouvez acheter un forfait payant. Notez votre adresse e-mail, votre mot de passe et l’URL de votre espace de travail. Vous aurez besoin de ces informations pour accéder à votre compte à l’avenir. **Enregistrement d’une application `OAuth2.0`** 1. Accédez à la [page de connexion à Productboard](https://login.productboard.com/?locale=en), saisissez votre adresse e-mail et votre mot de passe, puis choisissez **Se connecter**. 1. Sélectionnez l’icône **Utilisateur** dans le coin supérieur droit, puis choisissez **Compte et facturation** dans le menu déroulant. 1. Sélectionnez **Extras** et choisissez **Applications enregistrées** dans le menu déroulant. 1. Recherchez et choisissez **Enregistrer une application**. 1. Entrez les détails suivants : + **Nom de l’application** : nom de l’application. + **Entreprise/organisation** : nom de votre entreprise ou organisation. + **Site Web de l’application** : site Web de l’application. + **URI de redirection** : un modèle d’URI de redirection est un chemin d’URI (ou une liste de chemins séparés par des virgules) vers lequel Productboard peut rediriger (si demandé) une fois le flux de connexion terminé. Par exemple, `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com` 1. Choisissez **Créer**. 1. L’**ID client** et le **secret client** seront désormais visibles. Copiez-les et enregistrez-les dans un endroit sûr. Ensuite, choisissez **Terminé**. **Note** Vos chaînes d'ID client et de secret client sont des informations d'identification utilisées pour établir une connexion avec ce connecteur lors de l'utilisation de AppFlow ou AWS Glue. **Récupération des informations d'identification CustomAuth** 1. Accédez à la [page de connexion à Productboard](https://app.productboard.com/), saisissez votre adresse e-mail et votre mot de passe, puis choisissez **Se connecter**. Vous serez ensuite redirigé vers la page d’accueil. 1. Sur la page d'accueil, accédez à **Paramètres de l'espace de travail** > **Intégrations** > **Public APIs** > **Jeton d'accès**. **Note** Si la APIs section **publique** n'est pas visible, votre compte est peut-être associé au forfait Essentials. L’accès aux jetons d’API nécessite au minimum un forfait Pro. Les fonctionnalités et les noms des forfaits sont susceptibles d’être modifiés. Pour plus d’informations sur les packages, consultez [Productboard pricing](https://www.productboard.com/pricing/). 1. Choisissez **\$1** pour générer un jeton et assurez-vous de le stocker en toute sécurité pour une référence future. **Création d’informations d’identification `OAuth2.0`** Pour utiliser l’authentification `OAuth2.0` avec le connecteur Productboard, vous devez enregistrer votre application sur la plateforme Productboard et générer un `Client ID` et un `Client Secret`. 1. Accédez à la [page de connexion à Productboard](https://app.productboard.com/), saisissez votre adresse e-mail et votre mot de passe, puis choisissez **Se connecter**. 1. Pour enregistrer une nouvelle OAuth2 application avec votre compte Productboard, rendez-vous sur la page [Producboard](to register new OAuth2 application with your Productboard account). 1. Complétez les champs obligatoires et sélectionnez les portées nécessaires pour chaque entité à laquelle vous souhaitez accéder. **Note** Vous avez choisi les quatre portées suivantes, qui sont obligatoires pour les six entités prises en charge. 1. L’**URL de redirection** doit être au format suivant : `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com`. **Note** Les redirections Appflow URLs sont susceptibles d'être modifiées. Une fois disponible, veuillez mettre à jour la redirection URLs pour la AWS Glue plateforme. 1. L’**ID client** et le **secret client** seront désormais visibles. Copiez-les et enregistrez-les dans un endroit sûr. 1. Vous pouvez configurer et vérifier `OAuth2` en suivant les étapes décrites dans la section [Comment intégrer à Productboard via la documentation destinée aux OAuth2 développeurs](https://developer.productboard.com/docs/how-to-integrate-with-productboard-via-oauth2-developer-documentation). # Limitations Les restrictions du connecteur Productboard sont les suivantes : + Productboard ne prend en charge ni le partitionnement basé sur les champs, ni le partitionnement basé sur les enregistrements.