> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acrity.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectores
> Configura conectores locales para acceder a proveedores de VCS privados, self-hosted o restringidos a la organización.
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.
```mermaid theme={null}
flowchart LR
subgraph customer["Red del cliente"]
vcs["VCS privado"]
connector["Conector local
(guarda las credenciales locales del VCS)"]
end
subgraph acrity["Nube de Acrity"]
broker["Broker / gateway
(no guarda credenciales de VCS)"]
engine["Motor de revisión"]
end
vcs -- "El evento de PR / MR se origina aquí" --> connector
connector -- "conexión saliente segura solo de egreso
(sin puertos de entrada)" --> broker
broker --> engine
```
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
Accede a `Consola > Conectores`.
Elige crear un nuevo conector.
Completa nombre, proveedor y URL base de la instancia cuando corresponda.
Genera el token del conector y el secreto de relay cuando se solicite.
Copia y almacena los valores en un cofre seguro. Solo se muestran una vez.
Descarga el formato de instalación compatible con el ambiente de la organización.
Instala el conector, espera el heartbeat y ejecuta Revalidate cuando esté disponible.
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
| Campo | Para qué sirve |
| ------------------------ | ---------------------------------------------------------------------------------------------------- |
| Nombre | Identifica el conector en la Consola. |
| Proveedor | Define el tipo de VCS o integración atendida por el conector. |
| URL base de la instancia | Dirección de la instalación self-hosted u organización cuando sea necesario. |
| Token del conector | Secreto usado por el componente local para identificarse. Se muestra una sola vez. |
| Secreto de relay | Secreto usado para proteger la conexión saliente del conector hacia Acrity. Se muestra una sola vez. |
| Formato de deploy | Paquete 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.
| Estado | Significado |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Conectado | El conector se comunica normalmente y alcanza el VCS. |
| Degradado | El conector responde, pero con una limitación o falla parcial (por ejemplo, respuestas lentas o un subconjunto de repositorios inalcanzable). |
| Offline | Acrity no ha recibido comunicación reciente del conector. |
| Error | Hay 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íntoma | Qué verificar |
| ---------------------------- | ------------------------------------------------------------------------------ |
| Conector offline | Verifica instalación local, red, proxy, DNS, firewall y secreto configurado. |
| La revalidación falla | Confirma URL base, credenciales locales y acceso del conector al VCS. |
| Los repositorios no aparecen | Verifica permisos en el VCS, alcance del conector y actualización de la lista. |
| Perdí el token mostrado | Genera un nuevo token y actualiza la instalación local. |
| Error de certificado | Confirma 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.