Última modificación: 12 de septiembre de 2025
Las claves de acceso personal son la forma recomendada de autenticarse con herramientas de desarrollo local. Las claves de acceso personal funcionan de forma similar a las claves de API, pero están vinculadas a un usuario específico en una cuenta. Las claves de acceso personal solo funcionan con herramientas de desarrollo local.

​
Claves de acceso personal en comparación con otros métodos de autenticación

La ventaja de las claves de acceso personal sobre las implementaciones como las claves de API es que las claves de API tienen efectivamente permisos de superadministrador. Las claves de acceso personal se limitan a los permisos que tiene el usuario individual en el portal. Si el usuario tiene Super Admin, no ven ninguna diferencia en su funcionalidad, pero la ventaja es que si un desarrollador individual necesita ser eliminado de una cuenta, el acto de deshabilitar a su usuario en la cuenta deshabilitará sus capacidades de desarrollo local. Debido a que las claves de acceso personal están vinculadas al usuario individual en una cuenta, podemos mostrar información más útil, por ejemplo, si un desarrollador cambia o carga un archivo usando las herramientas de desarrollo local mientras usa una clave de acceso personal, podemos atribuir el cambio en la aplicación a ese usuario. Esto hace que sea más fácil trabajar con equipos y entender quién hizo qué. Las claves de acceso personal están vinculadas al usuario individual en la cuenta específica de HubSpot y no al usuario directamente. Lo que esto significa es que usando las herramientas de desarrollo local necesitarás generar una nueva clave de acceso personal para cada cuenta con la que desees usar las herramientas de desarrollo. Esto proporciona una capa de seguridad para las cuentas, ya que un actor malicioso que obtiene tu clave de acceso solo podría afectar a los portales individuales y a ese usuario individual.

​
Parecido a OAuth2

​
Proteger tus credenciales

Protege tus claves de acceso personal como si fueran la contraseña de tu cuenta, no las compartas con nadie. Permiten a quienquiera que las tenga autenticarse como si fueras tú y tomar cualquier acción que tú personalmente puedas tomar.

​
Uso de claves de acceso personal con las herramientas de desarrollo local

Las claves de acceso personal se construyeron para ser utilizadas con herramientas de desarrollo local. Comenzar con las herramientas de desarrollo local. Ve tu clave de acceso CMS personal. Cuando se usa para auth en las herramientas de desarrollo local, tu archivo hubspot.config.yml se asemejará a esto: 
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'