> ## 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.

# Credenciales

> Registra y valida credenciales manuales usadas por proveedores conectados a Acrity.

Las credenciales manuales permiten que Acrity acceda a proveedores cuando una aplicación conectada o un conector local no es la mejor opción.

Usa `Consola > Credenciales` para crear, editar, validar, resincronizar y eliminar credenciales del workspace.

## Cuándo usar

Usa credenciales manuales cuando:

* el proveedor no ofrece un flujo de aplicación conectada para el caso de uso;
* un repositorio o PM requiere un token específico;
* la organización necesita separar credenciales por equipo, proyecto o entorno;
* una integración existente todavía depende de un token manual.

Cuando esté disponible, prefiere `Consola > Aplicaciones conectadas` para proveedores con autorización gestionada o `Consola > Conectores` para proveedores VCS privados y self-hosted.

## Quién puede acceder

Trabajar con credenciales requiere un admin de workspace (los admins de plataforma también tienen acceso). Los roles son conjuntos fijos de capacidades definidos por Acrity, por lo que otros roles no ven este menú.

## Campos principales

| Campo                | Para qué sirve                                                                                  |
| -------------------- | ----------------------------------------------------------------------------------------------- |
| Nombre               | Identifica la credencial en la Consola. Usa nombres claros, como equipo, proveedor y finalidad. |
| Proveedor            | Define qué campos se solicitarán y dónde podrá usarse la credencial.                            |
| Campos sensibles     | Tokens, contraseñas, app passwords o secretos exigidos por el proveedor.                        |
| Metadatos            | Información no sensible usada para identificación, alcance o conexión.                          |
| Estado de validación | Indica si la credencial está válida, inválida, pendiente o necesita otra verificación.          |

## Crear una credencial

<Steps>
  <Step title="Abrir credenciales">
    Accede a `Consola > Credenciales`.
  </Step>

  <Step title="Crear nueva">
    Elige `Nueva credencial`.
  </Step>

  <Step title="Seleccionar proveedor">
    Elige el proveedor correcto. La pantalla mostrará los campos necesarios para ese proveedor.
  </Step>

  <Step title="Completar datos">
    Ingresa el nombre y los campos solicitados. Usa el menor alcance posible en el proveedor de origen.
  </Step>

  <Step title="Validar">
    Ejecuta la validación cuando esté disponible. Corrige los mensajes antes de usar la credencial en repositorios.
  </Step>

  <Step title="Guardar">
    Guarda la credencial y asóciala a los repositorios o integraciones necesarias.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/techdriven/eiJQrWxdoD9fo1DY/images/console/credentials.png?fit=max&auto=format&n=eiJQrWxdoD9fo1DY&q=85&s=755c1962608c0246831de70797ebc268" alt="Lista de credenciales en la Consola que muestra las credenciales de proveedores registradas y su estado de validación" width="2213" height="1262" data-path="images/console/credentials.png" />
</Frame>

## Editar una credencial

Al editar una credencial, los campos sensibles pueden aparecer vacíos o enmascarados. Esto evita que los secretos queden expuestos en la Consola.

Para cambiar un secreto:

1. Accede a `Consola > Credenciales`.
2. Abre la credencial.
3. Elige editar.
4. Completa el campo sensible que se cambiará.
5. Guarda y valida.

Si no quieres cambiar un secreto, deja el campo según lo indicado por la pantalla.

## Validar y resincronizar

Usa la validación cuando:

* la credencial acaba de crearse;
* el proveedor cambió permisos;
* una revisión o conexión falló;
* la Consola muestra una alerta de credencial inválida;
* el token fue rotado en el proveedor.

Usa la resincronización cuando la credencial está válida, pero los metadatos, permisos u objetos del proveedor necesitan actualizarse.

## Asociar credenciales a repositorios

Las credenciales pueden elegirse al conectar o editar repositorios.

Flujo recomendado:

1. Crea y valida la credencial en `Consola > Credenciales`.
2. Accede a `Consola > Repositorios`.
3. Conecta o abre un repositorio.
4. Selecciona la credencial apropiada para VCS o PM.
5. Guarda y revisa el estado del repositorio.

## Buenas prácticas

* Usa un nombre que indique proveedor, equipo y finalidad.
* Evita credenciales personales cuando la organización pueda usar una cuenta de servicio.
* Aplica el conjunto mínimo de permisos en el proveedor.
* Define un proceso de rotación periódica.
* Elimina las credenciales no usadas.
* Prefiere aplicaciones conectadas o conectores locales cuando cubran el caso de uso.

## Seguridad

Los campos sensibles no se muestran en texto plano después del registro. El almacenamiento y la protección de credenciales se describen en `Seguridad > Credenciales y tokens`.

<Warning>
  No pegues tokens en descripciones, nombres de credenciales, nombres de repositorios, plantillas de webhook u otros campos que no estén destinados a secretos.
</Warning>

## Problemas comunes

| Síntoma                                    | Qué verificar                                                                                      |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| Credencial inválida                        | Revisa token, expiración, permisos y organización/proyecto en el proveedor.                        |
| El campo sensible desapareció al editar    | Este es el comportamiento esperado. Ingresa un nuevo valor solo si quieres cambiar el secreto.     |
| El repositorio no puede usar la credencial | Verifica que la credencial sea del proveedor correcto y tenga acceso al repositorio.               |
| La validación queda pendiente              | Espera unos instantes e intenta de nuevo. Si persiste, revisa el estado del proveedor.             |
| No veo el proveedor deseado                | Revisa `Consola > Aplicaciones conectadas` o confirma la compatibilidad del proveedor con soporte. |