Dernière modification : 12 septembre 2025
“Les clés d’accès CMS personnelles sont une forme d’authentification destinée à être utilisée par des développeurs travaillant sur HubSpot. Elles sont liées à un utilisateur spécifique dans un compte.”; 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

​
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'