Clé d'accès personnelle

Last updated:

Les clés d'accès personnelles sont le moyen recommandé pour s'authentifier avec les outils de développement local. Les clés d'accès personnelles fonctionnent de la même manière que les clés d'API, mais sont liées à un utilisateur spécifique dans un compte. Les clés d'accès personnelles sont compatibles uniquement avec des outils de développement local.

Comparaison entre les clés d'accès personnelles et les autres méthodes d'authentification

L'avantage des clés d'accès personnelles sur des implémentations telles que les clés d'API est que ces dernières ont des autorisations de super administrateur. Les clés d'accès personnelles sont limitées aux autorisations dont dispose l'utilisateur individuel dans le portail. Si l'utilisateur est un super administrateur, il ne voit aucune différence dans leurs fonctionnalités, mais l'avantage est que si, par exemple, un développeur individuel doit être supprimé d'un compte, le fait de désactiver son utilisateur sur le compte désactivera ses capacités de développement local.

Étant donné que les clés d'accès personnelles sont liées à l'utilisateur individuel dans un compte, nous sommes en mesure d'afficher des informations plus utiles, par exemple, si un développeur modifie ou télécharge un fichier à l'aide des outils de développement local tout en utilisant une clé d'accès personnelle, nous pouvons attribuer le changement dans l'application à cet utilisateur. Cela permet de travailler plus facilement avec les équipes et de comprendre qui a fait quoi.

Les clés d'accès personnelles sont liées à l'utilisateur individuel dans le compte HubSpot spécifique et non à l'utilisateur directement. Autrement dit, en utilisant les outils de développement local, vous devrez générer une nouvelle clé d'accès personnelle pour chaque compte avec lequel vous souhaitez utiliser les outils de développement. Cela fournit une couche de sécurité pour les comptes, car un acteur malveillant obtenant votre clé d'accès ne serait alors en mesure d'affecter que les portails individuels et en tant qu'utilisateur individuel.

Similitude avec OAuth2

Les clés d'accès personnelles agissent en fait comme OAuth2. Lorsque vous générez une clé d'accès personnelle, vous choisissez les autorisations que vous souhaitez que cette clé possède. Vous ne pouvez avoir qu'une seule clé d'accès par utilisateur et par compte HubSpot. Une fois que vous aurez généré votre clé d'accès, une application sera connectée à votre compte HubSpot, appelée « Outils de développement local HubSpot ». Cette application HubSpot de premier niveau facilite l'authentification pour les outils de développement local lors de l'utilisation d'une clé d'accès personnelle. La déconnexion de cette application supprimera toutes les clés d'accès que vous avez générées précédemment. Ainsi, vos outils de développement local ne pourront plus se connecter via ces clés d'accès. Vous devrez générer une nouvelle clé et mettre à jour votre fichier hubspot.config.yml.

personalcmsaccesskey

Protégez vos identifiants

Protégez vos clés d'accès personnelles comme s'il s'agissait du mot de passe de votre compte. Ne les partagez avec personne. Toute personne disposant de ces clés peut s'authentifier comme s'il s'agissait de vous et mener toutes les actions que vous pouvez effectuer en votre nom.

Utilisation des clés d'accès personnelles avec les outils de développement local

Les clés d'accès personnelles ont été conçues pour être utilisées avec des outils de développement local.

Découvrez les outils de développement local.

Consultez votre clé d'accès CMS personnelle.

Lorsqu'il est utilisé pour l'authentification dans les outils de développement local, votre fichier hubspot.config.yml ressemblera à ceci :

defaultPortal: production portals: - name: production portalId: <portalId> authType: personalaccesskey personalAccessKey: >- CJDVnLanLRICEQIYyLu8LyDh9E4opf1GMhkAxGuU5XN_O2O2QhX0khw7cwIkPkBRHye-OfIADgLBAAADAIADAAAAAAAAAAJCGQC8a5TlhtSU8T-2mVLxOBpxS18aM42oGKk auth: tokenInfo: accessToken: >- CJDVnLanLRICEQIYyLu8LyDh9E4opf1GMhkAxGuU5XN_O2O2QhX0khw7cwIkPkBRHye-OfIADgLBAAADAIADAAAAAAAAAAJCGQC8a5TlhtSU8T-2mVLxOBpxS18aM42oGKk expiresAt: '2020-01-01T00:00:00.000Z'
Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.