Tabla de contenidos
¿Qué son las Integraciones Privadas?
Private Integrations le permite crear potentes integraciones personalizadas entre su cuenta y cualquier otra aplicación de terceros.
Si está buscando integrar su cuenta con una aplicación de terceros, tiene dos opciones:
1. Encuentre e instale la aplicación relevante desde App Marketplace
2. Cree su propia integración privada usted mismo o con la ayuda de un desarrollador que utiliza API.
Private Integrations te ayuda a lograr el #2 de forma segura.
Las ventajas clave del uso de las Integraciones Privadas son:
Simple: Genere tokens de Integración privada desde la configuración de su cuenta y administrelos con facilidad.
Seguro: Puede restringir los alcances/permisos a los que un desarrollador puede acceder en su cuenta
¿Cuál es la diferencia entre las Integraciones Privadas y las Claves API?
Las integraciones privadas, en pocas palabras, son una alternativa más poderosa pero segura a las Claves API.
Integraciones Privadas | Claves API |
Más Seguro: Puede restringir los alcances/permisos a los que un desarrollador puede acceder en su cuenta | Menos Seguro: Un desarrollador obtiene acceso sin restricciones a todos los datos de su cuenta |
Estado de la técnica: Private Integrations le permite acceder a API v2.0, que es de última generación. | Apagado: Las claves API funcionan en API v1.0 que ha llegado al final de su vida útil y ya no se mantiene. |
Más Características: API v2.0 tiene API más potentes y admite webhooks(capacidad para que las aplicaciones de terceros sean notificadas cuando ocurren eventos específicos en su cuenta). | Menos Características: API v1.0 tiene API limitadas y no admite webhooks. |
¿Cuál es la diferencia entre las Integraciones Privadas y los Tokens de Acceso OAuth2?
Las integraciones privadas, en pocas palabras, son Tokens de Acceso OAuth2 estáticos/fijos.
Integraciones Privadas | Tokens de acceso OAuth2 |
Generado a partir de la UI: El token de integración privada se puede generar fácilmente desde la interfaz de usuario. | Generación Programática: Los tokens API se generan intercambiando el código de acceso de OAuth por los tokens que utilizan Obtener Access Token API. |
Estático/Fijo: Los Tokens de Integración Privada son estáticos/fijos y no se actualizan automáticamente a menos que los gire desde la interfaz de usuario. | Diariamente Refrescado: Los tokens de acceso caducan diariamente y deben actualizarse. |
¿Cómo uso las Integraciones Privadas?
Los tokens de integración privada se utilizan en el encabezado Autorización, al igual que otros Tokens de Acceso.
Por ejemplo, puede usar Póngase en contacto con el Token de Integración Privada en el encabezado Autorización.
curl --request GET \ --url https://services.leadconnectorhq.com/contacts/ocQHyuzHvysMo5N5VsXc \ --header 'Accept: application/json' \ --header 'Authorization: <YOUR PRIVATE INTEGRATION TOKEN>' \ --header 'Version: 2021-07-28'
Genérico
¿Cómo uso las Integraciones Privadas?
¿Quién puede crear Integraciones Privadas?
De forma predeterminada, todos los administradores de cuentas pueden crear y administrar Integraciones privadas.
Sin embargo, puede restringir este permiso a nivel de usuario. Para hacer esto, Navegue a Configuración > Mi Personal > Edite el administrador de cuenta específico > Roles y Permisos, y habilite/deshabilite Integraciones privadas para el administrador.
¿Dónde puedo encontrar Integraciones Privadas?
Para administrar Integraciones privadas, vaya a Configuración y desplácese hacia abajo hasta la sección 'Otras configuraciones' en el menú de navegación de la izquierda.
Si no encuentra la configuración, asegúrese de haber habilitado la función en Labs.
¿Cómo creo una nueva Integración Privada?
Paso 1: Haga clic en "Crear nueva integración"
Paso 2: Dale a tu Integración Privada un nombre y una descripción para ayudarte a ti y a tu equipo a identificar para qué sirve.
Paso 3: Seleccione los alcances/permisos a los que desea que la integración privada tenga acceso en su cuenta. Asegúrese de seleccionar solo los alcances requeridos para una mejor seguridad de los datos.
Paso 4: Copie el token generado y compártalo con su desarrollador de aplicaciones externo.
Asegúrese de compartir el token solo con partes de confianza. No lo compartas públicamente.
Nota: No olvide copiar el token generado ya que no podrá volver a hacerlo más tarde.
¿Cuáles son algunas de las mejores prácticas para mantener la seguridad de mi token de integración privada?
Le recomendamos que gire sus tokens de Integración Privada cada 90 días.
Así es como puedes hacerlo.
Paso 1: Navegue a Integraciones privadas en la configuración y haga clic en la Integración privada que ha creado.
Paso 2: Haga clic en "Rotar y caducar este token más tarde".
Paso 3: Haga clic en "Continuar" en respuesta al mensaje de advertencia si está seguro de que desea continuar con la rotación.
Paso 4: Copie el nuevo token y actualícelo en su aplicación de terceros. Tendrá una ventana de 7 días donde tanto los tokens antiguos como los nuevos continuarán funcionando. Después de 7 días, el token antiguo caducará. En esta ventana de 7 días, tendrá la opción de:
1. "Cancelar rotación" si, por ejemplo, su desarrollador necesita más tiempo para actualizar el token en la aplicación de terceros.
2. "Expirar ahora", si, por ejemplo, la aplicación de terceros se ha actualizado con el nuevo token.
Nota: No olvide copiar el token generado ya que no podrá volver a hacerlo más tarde.
¿Mi token ha sido comprometido? ¿Qué debo hacer?
Paso 1: Navegue a Integraciones privadas en la configuración y haga clic en la Integración privada que ha creado.
Paso 2: Haga clic en "Rotar y caducar este token ahora".
Paso 3: Haga clic en "Continuar" en respuesta al mensaje de advertencia si está seguro de que desea continuar con la rotación.
Paso 4: Copie el nuevo token y actualícelo en su aplicación de terceros.
Nota: No olvide copiar el token generado ya que no podrá volver a hacerlo más tarde.
¿Puedo editar los permisos de Integración privada sin actualizar el token?
Sí, puede editar el nombre, la descripción y los alcances/permisos de la Integración privada en cualquier momento después de haberla creado.
Así es como puedes hacerlo.
Paso 1: Navegue a Integraciones privadas en la configuración y seleccione "Editar" en el menú de tres puntos.
Paso 2: Actualizar el Nombre y descripción de la integración privada si es necesario. Haga clic en "Siguiente".
Paso 3: Si es necesario, actualizar los alcances/permisos a los que desea que la integración privada tenga acceso en su cuenta. Asegúrese de seleccionar solo los alcances requeridos para una mejor seguridad de los datos. Haga clic en "Actualizar" para guardar las actualizaciones realizadas.
Nota: Actualizar los detalles de Integración privada no genera un nuevo token. El token existente continuará funcionando.
¿Cómo elimino la Integración Privada una vez que ya no la necesito?
Puede eliminar la Integración privada una vez que ya no esté utilizando la aplicación de terceros.
Para hacerlo, navegue a Integraciones privadas en la configuración y seleccione "Eliminar" en el menú de tres puntos.