Saltar al contenido principal
Los conectores permiten que Acrity trabaje con proveedores de código que no deben ser accedidos directamente por la nube de Acrity. Usa Consola > Conectores para crear un conector, generar secretos de instalación, descargar artefactos de deploy, dar seguimiento a liveness y asociar repositorios.
Los conectores requieren un administrador del Workspace (los administradores de la plataforma también tienen acceso). Los roles son conjuntos de capacidades fijos definidos por Acrity, por lo que ningún otro rol puede crear, editar ni revalidar un conector.

​
Cuándo usar

Usa conectores cuando:
  • el VCS está en una red privada;
  • el proveedor es self-hosted;
  • el acceso al VCS debe originarse desde una red controlada por la organización;
  • políticas internas impiden almacenar tokens de VCS en servicios externos;
  • necesitas atravesar un proxy corporativo o una CA privada.
Para proveedores SaaS con instalación oficial, evalúa primero Consola > Aplicaciones conectadas.

​
Cómo funciona a alto nivel

  1. Un administrador del Workspace crea el conector en la Consola.
  2. La Consola muestra los secretos de instalación una sola vez.
  3. El equipo instala el componente local en el ambiente de la organización.
  4. El conector abre una conexión saliente solo de egreso hacia Acrity y alcanza el VCS privado de forma local.
  5. Los repositorios pueden entonces ser descubiertos y asociados desde la Consola.
La nube de Acrity no guarda credenciales de VCS. Solo el conector local, que se ejecuta dentro de tu red, guarda las credenciales de tu VCS privado. El conector abre una conexión saliente segura y solo de egreso hacia Acrity, por lo que no necesitas abrir ningún puerto de entrada en tu red.
Los detalles de seguridad, retención y tratamiento de datos están en Seguridad > Tratamiento de datos y Seguridad > Credenciales y tokens.

​
Crear un conector

1

Abrir conectores

Accede a Consola > Conectores.
2

Iniciar wizard

Elige crear un nuevo conector.
3

Ingresar datos

Completa nombre, proveedor y URL base de la instancia cuando corresponda.
4

Generar secretos

Genera el token del conector y el secreto de relay cuando se solicite.
5

Guardar los valores

Copia y almacena los valores en un cofre seguro. Solo se muestran una vez.
6

Descargar artefacto

Descarga el formato de instalación compatible con el ambiente de la organización.
7

Instalar y validar

Instala el conector, espera el heartbeat y ejecuta Revalidate cuando esté disponible.
Página de conectores que lista los conectores locales y su estado de salud
El token del conector es almacenado por Acrity solo como un hash SHA-256. Como Acrity no conserva ninguna copia recuperable del secreto, nunca puede volver a mostrarse después de su creación. Si lo pierdes, genera un nuevo token y actualiza la instalación local.

​
Campos principales

CampoPara qué sirve
NombreIdentifica el conector en la Consola.
ProveedorDefine el tipo de VCS o integración atendida por el conector.
URL base de la instanciaDirección de la instalación self-hosted u organización cuando sea necesario.
Token del conectorSecreto usado por el componente local para identificarse. Se muestra una sola vez.
Secreto de relaySecreto usado para proteger la conexión saliente del conector hacia Acrity. Se muestra una sola vez.
Formato de deployPaquete o manifiesto usado para instalar el conector en el ambiente local.

​
Estados de salud

La Consola muestra un estado de salud para cada conector, basado en el heartbeat y el Revalidate más reciente.
EstadoSignificado
ConectadoEl conector se comunica normalmente y alcanza el VCS.
DegradadoEl conector responde, pero con una limitación o falla parcial (por ejemplo, respuestas lentas o un subconjunto de repositorios inalcanzable).
OfflineAcrity no ha recibido comunicación reciente del conector.
ErrorHay una falla que requiere corregir configuración, red o credenciales locales.
Usa Revalidate para forzar una verificación inmediata de conectividad y credenciales en lugar de esperar el siguiente heartbeat automático. Después de corregir un problema, ejecuta Revalidate para confirmar que el conector vuelve al estado conectado.

​
Descargar artefacto de instalación

Después de crear el conector:
  1. Accede a Consola > Conectores.
  2. Abre el conector.
  3. Elige el formato de deploy soportado por tu infraestructura.
  4. Descarga el artefacto.
  5. Entrega el paquete al equipo responsable de la instalación local.
No publiques artefactos con secretos en repositorios compartidos. Trata los archivos de configuración como material sensible.

​
Asociar repositorios

Cuando el conector esté online:
  1. Accede a Consola > Repositorios > Conectar repositorio.
  2. Elige el conector como origen de acceso al VCS.
  3. Selecciona o ingresa los repositorios objetivo.
  4. Completa las configuraciones de branch, PM y revisión.
  5. Guarda y valida el estado del repositorio.

​
Rotar secretos

Rota secretos cuando:
  • alguien con acceso al secreto salió del equipo;
  • se sospecha de una exposición;
  • la política interna exige rotación periódica;
  • el ambiente local fue recreado;
  • el conector se moverá a otra infraestructura.
Después de generar nuevos secretos, actualiza la instalación local y ejecuta Revalidate para confirmar que el conector volvió al estado conectado.

​
Problemas comunes

SíntomaQué verificar
Conector offlineVerifica instalación local, red, proxy, DNS, firewall y secreto configurado.
La revalidación fallaConfirma URL base, credenciales locales y acceso del conector al VCS.
Los repositorios no aparecenVerifica permisos en el VCS, alcance del conector y actualización de la lista.
Perdí el token mostradoGenera un nuevo token y actualiza la instalación local.
Error de certificadoConfirma la CA corporativa y la configuración TLS del ambiente local.

​
Buenas prácticas

  • Instala conectores en infraestructura administrada por la organización.
  • Guarda secretos en un cofre seguro.
  • Usa cuentas de servicio con alcance mínimo.
  • Monitorea el heartbeat y las alertas de la Consola.
  • Revoca conectores no utilizados.
  • Documenta internamente quién opera cada conector.