> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/pam/administration/sessions/file-transfer.md).

# Transferencia de archivos

Las cuatro formas de mover archivos entre la estación de trabajo del usuario y un activo protegido (explorador en el navegador, subida masiva, cliente SFTP externo y línea de comandos) y qué registra

## Qué es esto y cuándo usarlo

Los archivos llegan a un activo protegido a través de la solución, no esquivándola. Todas las vías descritas abajo comparten las mismas dos propiedades: el usuario nunca tiene en la mano la credencial del activo, y cada subida y cada descarga se escribe en el registro de auditoría con una copia recuperable del archivo.

En activos Linux la transferencia va sobre **SFTP** y, por defecto, usa el mismo puerto que SSH: el puerto **22** del activo.

Existen cuatro vías, y no son intercambiables:

| Método                                 | Dónde                           | Subida                       | Descarga | Alcance                                                    |
| -------------------------------------- | ------------------------------- | ---------------------------- | -------- | ---------------------------------------------------------- |
| **Explorador de archivos**             | Navegador, pestaña nueva        | Sí                           | Sí       | Cualquier directorio sobre el que la cuenta tenga derechos |
| **Transferencia de archivos** (masiva) | Navegador, página de la consola | Sí, muchos archivos a la vez | **No**   | Solo `/tmp/`                                               |
| **Cliente SFTP**                       | FileZilla, WinSCP, MobaXterm    | Sí                           | Sí       | Cualquier directorio sobre el que la cuenta tenga derechos |
| **SFTP por línea de comandos**         | Terminal                        | Sí                           | Sí       | Cualquier directorio sobre el que la cuenta tenga derechos |

{% hint style="warning" %}
Hay dos puertos distintos en juego, y confundirlos es el error más frecuente aquí. El puerto **22** es el puerto SSH/SFTP del propio activo, que la solución usa para alcanzar el destino. El puerto **2222** es el listener SFTP de la propia solución, y es al que se conecta un cliente externo. Un cliente SFTP apuntado al puerto 22 de la dirección del PAM no funcionará.
{% endhint %}

## Antes de empezar

* El usuario necesita las acciones de **Transferir** en la regla de autorización que le concede el activo: **Subir**, **Descargar** y **Eliminar** se conceden por separado. Sin ellas, la conexión se establece y la operación de archivo se rechaza. Consulte [Autorizaciones](/es/pam/administration/access/authorizations.md).
* El puerto SFTP del activo debe ser alcanzable desde la solución.
* Una cuenta en el activo con derechos de sistema de archivos sobre los directorios en cuestión. La solución aplica sus propios permisos por encima de los del sistema operativo; no los anula.

## Explorador de archivos en el navegador

La opción más completa: un administrador de archivos con navegación libre, subida y descarga.

Hay dos entradas, y ambas llevan al mismo sitio:

* En la lista de acceso a dispositivos, haga clic con el botón derecho en el activo, elija conectar, seleccione el protocolo **SFTP**, escoja la cuenta, fije el método de conexión en **Web** y haga clic en **Conectar**.
* En **Cockpit › Explorador de archivos**, y después despliegue el árbol de activos en la barra lateral **Places**, a la izquierda, y seleccione el dispositivo.

Con el explorador abierto:

* **Subida**: navegue hasta el directorio de destino y, a continuación, arrastre los archivos al panel principal, o haga clic con el botón derecho en una zona vacía del panel de archivos y elija **Subir archivos**.
* **Descarga**: haga clic con el botón derecho en el archivo y elija **Descargar**, o haga doble clic sobre él.

## Subida masiva

Use **Cockpit › Transferencia de archivos** cuando necesite empujar muchos archivos a muchos activos de una vez y no necesite recuperar nada.

1. Abra **Cockpit › Transferencia de archivos**.
2. En el **Árbol de activos**, a la derecha, seleccione el activo de destino en la lista de dispositivos disponibles.
3. En **Account information**, introduzca o seleccione la cuenta con la que se ejecutará la transferencia.
4. Revise **Upload to directory**. Muestra `/tmp/` y es fijo.
5. Arrastre los archivos al área de subida, o use **click here to upload** para escogerlos desde su estación de trabajo.
6. Haga clic en **Transferir**.
7. Vigile la sección **Pendiente**, que lista cada archivo con su estado de éxito o de fallo.

{% hint style="warning" %}
Este método **solo sube**: no hay descarga. Y el destino está fijado en `/tmp/` en el activo; no se puede elegir otro directorio. Si necesita otra ruta, o necesita recuperar un archivo, use el explorador de archivos.
{% endhint %}

{% hint style="info" %}
Cada archivo puede ocupar hasta **200 MB**. El límite subyacente es el parámetro `CLIENT_MAX_BODY_SIZE`, cuyo valor por defecto es `4096m`; subir o bajar el techo por archivo es un cambio en el despliegue, así que consulte al proveedor antes de contar con un valor distinto.
{% endhint %}

## Cliente SFTP externo

Apunte cualquier cliente SFTP a la propia solución y no al activo. Usted se autentica con **sus** credenciales del PAM, nunca con las del activo, y se pide MFA si está habilitado en su perfil. Lo que ve entonces es un árbol de directorios con los activos y las cuentas disponibles para usted: navegue hasta el servidor de destino, escoja la cuenta y transfiera con normalidad.

| Parámetro      | Valor                          |
| -------------- | ------------------------------ |
| **Protocolo**  | SFTP                           |
| **Host**       | La dirección IP de la solución |
| **Puerto**     | 2222                           |
| **Usuario**    | Su nombre de usuario del PAM   |
| **Contraseña** | Su contraseña del PAM          |

* **FileZilla**: introduzca `sftp://<PAM_IP>` como host, puerto `2222`, su usuario y contraseña del PAM, y después **Quickconnect**. Transfiera arrastrando y soltando.
* **WinSCP**: protocolo **SFTP**, host con la dirección del PAM, puerto `2222`, sus credenciales del PAM, y después **Login**.
* **MobaXterm**: el panel SFTP aparece automáticamente a la izquierda al conectar, de modo que los archivos pueden arrastrarse en cualquier sentido.

### Desde la línea de comandos

```
sftp -P 2222 user@pam_address
```

| Comando     | Acción               |
| ----------- | -------------------- |
| `ls`        | Lista archivos       |
| `cd dir`    | Cambia de directorio |
| `get file`  | Descarga un archivo  |
| `put file`  | Sube un archivo      |
| `rm file`   | Elimina un archivo   |
| `mkdir dir` | Crea un directorio   |

## Estrategia ante conflicto de archivos

Cuando ya existe un archivo con el mismo nombre en el destino, el comportamiento es una preferencia por usuario, fijada en **Personal settings › Preferencias › File conflict strategy**:

| Estrategia    | Resultado                                            |
| ------------- | ---------------------------------------------------- |
| **Overwrite** | Sustituye el archivo existente                       |
| **Skip**      | Conserva el original y descarta el archivo entrante  |
| **Renombrar** | Conserva ambos; el archivo entrante recibe un sufijo |

## Cómo verificar que funcionó

No se fíe solo del indicador de progreso: confirma que la subida llegó a la solución, no que el archivo aterrizó en el activo.

1. Abra **Auditoría › Registros de transferencia de archivos**. La transferencia debe aparecer como un registro propio, con el usuario, el activo, la cuenta usada, la operación (**Subir** o **Descargar**) y el nombre del archivo.
2. Use el botón de acción del registro para **descargar una copia del archivo transferido** y confirme que es el archivo que pretendía enviar. Esa es la comprobación que demuestra el contenido, y no solo la intención.
3. Para una subida masiva, vuelva a conectarse por el explorador de archivos y liste `/tmp/` en el activo. Un archivo que allí no está pero figura como correcto en **Pendiente** señala a los derechos de la cuenta de destino, no a la transferencia.

Una transferencia que tuvo éxito pero no produjo registro de auditoría es un hallazgo que merece investigación: se supone que todos los métodos anteriores registran.

## Errores frecuentes

| Síntoma                                                  | Causa                                                                            | Solución                                                                                                  |
| -------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| La transferencia se rechaza en mitad de la sesión        | Las acciones de **Transferir** no se concedieron en la autorización              | Conceda Subir, Descargar o Eliminar según haga falta en la regla                                          |
| El cliente SFTP no conecta en absoluto                   | Apuntado al puerto 22 de la dirección del PAM, o directamente al activo          | Use la dirección del PAM en el puerto **2222**                                                            |
| El cliente conecta y después rechaza el inicio de sesión | Se usó la credencial del activo en lugar de su propia credencial del PAM         | Autentíquese con su usuario y contraseña del PAM; la cuenta del activo se elige después, dentro del árbol |
| El inicio de sesión se acepta y luego se queda colgado   | El MFA está habilitado en su perfil y el desafío no se respondió                 | Complete el desafío de MFA que presenta el cliente                                                        |
| No aparece ninguna opción de descarga en la pantalla     | Está en la página de **Transferencia de archivos** masiva, que es solo de subida | Use el **Explorador de archivos**                                                                         |
| La subida no puede colocarse en el directorio previsto   | La transferencia masiva está fijada en `/tmp/`                                   | Use el explorador de archivos, que alcanza cualquier directorio sobre el que la cuenta tenga derechos     |
| La subida falla con un archivo grande                    | El archivo supera el límite por archivo, 200 MB por defecto                      | Divida el archivo, o pida que se revise el límite para el despliegue                                      |
| Un archivo con el mismo nombre no cambió en silencio     | La estrategia ante conflicto está fijada en **Skip**                             | Cambie la estrategia a Overwrite o Renombrar                                                              |

## Páginas relacionadas

* [Autorizaciones](/es/pam/administration/access/authorizations.md)
* [Métodos de conexión](/es/pam/administration/sessions/connection-methods.md)
* [Inventario de activos](/es/pam/administration/assets/inventory.md)
* [Cuentas gestionadas](/es/pam/administration/accounts/managed-accounts.md)
* [Filtrado de comandos](/es/pam/administration/access/command-filtering.md)
