Última modificação: 12 de setembro de 2025
Com as ferramentas de desenvolvimento local, é recomendado usar as chaves de acesso pessoal como forma de autenticação. As chaves de acesso pessoal funcionam de maneira semelhante às chaves de API, mas estão vinculadas a um usuário específico em uma conta. As chaves de acesso pessoal funcionam apenas com as ferramentas de desenvolvimento local.

​
Chaves de acesso pessoal em comparação com outros métodos de autenticação

A vantagem das chaves de acesso pessoal em relação a implementações como chaves de API é que estas têm permissões de superadministrador. As chaves de acesso pessoal estão limitadas às permissões que o usuário individual tem no portal. Se o usuário tiver permissões de Superadministrador, ele não verá diferença em sua funcionalidade, mas a vantagem é que, se um desenvolvedor individual precisar ser removido de uma conta, bastará desativar seu usuário na conta para desativar suas capacidades de desenvolvimento local. Como as chaves de acesso pessoal estão vinculadas ao usuário individual em uma conta, podemos exibir informações mais úteis, por exemplo, se um desenvolvedor alterar ou enviar um arquivo usando as ferramentas de desenvolvimento local usando uma chave de acesso pessoal, podemos atribuir a alteração no aplicativo a esse usuário. Isso facilita o trabalho em equipe e a compreensão de quem fez o quê. As chaves de acesso pessoal estão vinculadas ao usuário individual na conta específica da HubSpot, e não diretamente ao usuário. O que isso significa é que, usando as ferramentas de desenvolvimento local, você precisará gerar uma nova chave de acesso pessoal para cada conta na qual deseja usar as ferramentas de desenvolvimento. Assim, é adicionada uma camada de segurança para as contas, pois caso um agente malicioso obtivesse sua chave de acesso, ele somente poderia afetar os portais individuais e o usuário individual.

​
Semelhança com OAuth2

​
Proteja suas credenciais

Proteja suas chaves de acesso pessoal como se fossem uma senha de conta; não as compartilhe com ninguém. Elas permitem que o portador se autentique como se fosse você e tome qualquer ação que você pessoalmente possa tomar.

​
Usar chaves de acesso pessoal com as ferramentas de desenvolvimento local

As chaves de acesso pessoal foram criadas para serem usadas com as ferramentas de desenvolvimento local. Comece a usar as ferramentas de desenvolvimento local. Veja sua chave de acesso pessoal do CMS. Quando usado para autenticação nas ferramentas de desenvolvimento local, seu arquivo hubspot.config.yml será semelhante a este: 
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'