Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración y uso de SFTP conectores

El propósito de un conector es establecer una relación entre su AWS almacenamiento y el SFTP servidor de un socio. Puede enviar archivos desde Amazon S3 a un destino externo propiedad de un socio. También puede usar un SFTP conector para recuperar archivos del SFTP servidor de un socio.

En este tutorial se muestra cómo configurar un SFTP conector y, a continuación, transferir archivos entre el almacenamiento de Amazon S3 y un SFTP servidor.

Un SFTP conector recupera SFTP las credenciales AWS Secrets Manager para autenticarse en un SFTP servidor remoto y establecer una conexión. El conector envía o recupera archivos del servidor remoto y los almacena en Amazon S3. Se utiliza un IAM rol para permitir el acceso al bucket de Amazon S3 y a las credenciales almacenadas en Secrets Manager. Y puedes iniciar sesión en Amazon CloudWatch.

Paso 1: Crear los recursos de apoyo necesarios

Puede utilizar SFTP conectores para copiar archivos entre Amazon S3 y cualquier SFTP servidor remoto. Para este tutorial, utilizamos un AWS Transfer Family servidor como SFTP servidor remoto. Necesitamos crear y configurar los siguientes recursos:

Creación de buckets de Amazon S3

Para obtener información completa sobre la creación de buckets de Amazon S3, consulte ¿Cómo creo un bucket de S3? en la Guía del usuario de Amazon Simple Storage Service.

Cree un IAM rol con los permisos necesarios

Para el rol de acceso, cree una política con los siguientes permisos.

El siguiente ejemplo concede los permisos necesarios para acceder al DOC-EXAMPLE-BUCKET en Amazon S3 y el secreto especificado almacenado en Secrets Manager.

{
  "Version": "2012-10-17",
  "Statement": [
    {
        "Sid": "AllowListingOfUserFolder",
        "Action": [
            "s3:ListBucket",
            "s3:GetBucketLocation"
        ],
        "Effect": "Allow",
        "Resource": [
            "arn:aws:s3:::DOC-EXAMPLE-BUCKET"
        ]
    },
    {
        "Sid": "HomeDirObjectAccess",
        "Effect": "Allow",
        "Action": [
            "s3:PutObject",
            "s3:GetObject",
            "s3:DeleteObject",
            "s3:DeleteObjectVersion",
            "s3:GetObjectVersion",
            "s3:GetObjectACL",
            "s3:PutObjectACL"
        ],
        "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*"
    },
    {
        "Sid": "GetConnectorSecretValue",
        "Effect": "Allow",
        "Action": [
            "secretsmanager:GetSecretValue"
        ],
        "Resource": "arn:aws:secretsmanager:region:account-id:secret:aws/transfer/SecretName-6RandomCharacters"
    }
  ]
}

Sustituya los artículos de la siguiente manera:

También debes asegurarte de que esta función contenga una relación de confianza que permita al conector acceder a tus recursos cuando atienda las solicitudes de transferencia de los usuarios. Para obtener más información sobre cómo establecer una relación de confianza, consulte Para establecer una relación de confianza.

Cree y almacene un secreto en AWS Secrets Manager

Necesitamos almacenar un secreto en Secrets Manager para almacenar las credenciales de usuario de su SFTP conector. Puedes usar una contraseña, una clave SSH privada o ambas. Para el tutorial, usaremos una clave privada.

Antes de comenzar el procedimiento para almacenar el secreto, recupere y formatee su clave privada. La clave privada debe corresponder a la clave pública que está configurada para el usuario en el SFTP servidor remoto. Para nuestro tutorial, la clave privada debe corresponder a la clave pública que está almacenada para nuestro usuario de prueba en el SFTP servidor Transfer Family que utilizamos como servidor remoto.

Para ello, ejecute el siguiente comando:

jq -sR . path-to-private-key-file

Por ejemplo, si el archivo de clave privada se encuentra en~/.ssh/sftp-testuser-privatekey, el comando es el siguiente.

jq -sR . ~/.ssh/sftp-testuser-privatekey

Esto devuelve la clave en el formato correcto (con caracteres de nueva línea incrustados) a la salida estándar. Copie este texto en alguna parte, ya que tendrá que pegarlo en el siguiente procedimiento (en el paso 6).

Paso 2: Crear y probar un SFTP conector

En esta sección, creamos un SFTP conector que utiliza todos los recursos que hemos creado anteriormente. Para obtener más información, consulte Configure SFTP los conectores.

Tras crear un SFTP conector, le recomendamos que lo pruebe antes de intentar transferir cualquier archivo con el nuevo conector.

Test a connector using the console

Para probar un SFTP conector

1. Abra la AWS Transfer Family consola en https://console.aws.amazon.com/transfer/.

2. En el panel de navegación izquierdo, seleccione Conectores y seleccione un conector.

3. En el menú Acciones, seleccione Evento de prueba.

   

El sistema devuelve un mensaje que indica si la prueba se supera o no. Si la prueba no es satisfactoria, el sistema muestra un mensaje de error en función del motivo por el que no se ha realizado la prueba.

Test a connector using the CLI

Para probar un conector mediante el AWS Command Line Interface, ejecute el siguiente comando en una línea de comandos (sustituya connector-id con su ID de conector actual):

aws transfer test-connection --connector-id c-connector-id

Si la prueba se realiza correctamente, se devuelven las siguientes líneas:

{
   "Status": "OK",
   "StatusMessage": "Connection succeeded"
}

Si la prueba no tiene éxito, recibirá un mensaje de error descriptivo, por ejemplo:

{
   "Status": "ERROR",
   "StatusMessage": "Unable to assume the configured access role"
}

Paso 3: envíe y recupere archivos mediante el SFTP conector

Para simplificar, asumimos que ya tiene archivos en su bucket de Amazon S3.

En primer lugar, enviamos un archivo desde nuestro bucket de Amazon S3 al SFTP servidor remoto. Desde una línea de comandos, ejecuta el siguiente comando:

aws transfer start-file-transfer --connector-id c-connector-id --send-file-paths "/s3-storage-east/SEND-to-SERVER.txt" /
   --remote-directory-path "/sftp-server-storage-east/incoming"

Su sftp-server-storage-east depósito ahora debería tener este aspecto.

Si no ves el archivo como esperabas, comprueba CloudWatch los registros.

Si se realiza correctamente, la entrada de registro tendrá el siguiente aspecto:

{
    "operation": "SEND",
    "timestamp": "2023-12-18T15:26:57.346283Z",
    "connector-id": "connector-id",
    "transfer-id": "transfer-id",
    "file-transfer-id": "transfer-id/file-transfer-id",
    "url": "sftp://server-id.server.transfer.us-east-1.amazonaws.com",
    "file-path": "/s3-storage-east/SEND-to-SERVER.txt",
    "status-code": "COMPLETED",
    "start-time": "2023-12-18T15:26:56.915864Z",
    "end-time": "2023-12-18T15:26:57.298122Z",
    "account-id": "500655546075",
    "connector-arn": "arn:aws:transfer:us-east-1:500655546075:connector/connector-id",
    "remote-directory-path": "/sftp-server-storage-east/incoming"
}

Si la transferencia del archivo ha fallado, la entrada de registro contiene un mensaje de error que especifica el problema. Las causas más comunes de los errores son los problemas con los IAM permisos y las rutas de archivo incorrectas.

A continuación, recuperamos un archivo del SFTP servidor y lo colocamos en un bucket de Amazon S3. Desde una línea de comandos, ejecute el siguiente comando:

aws transfer start-file-transfer --connector-id c-connector-id --retrieve-file-paths "/sftp-server-storage-east/RETRIEVE-to-S3.txt" --local-directory-path "/s3-storage-east/incoming"

Si la transferencia se realiza correctamente, su bucket de Amazon S3 contiene el archivo transferido, como se muestra aquí.

Si se realiza correctamente, la entrada de registro tendrá el siguiente aspecto:

{
    "operation": "RETRIEVE",
    "timestamp": "2023-12-18T15:36:40.017800Z",
    "connector-id": "c-connector-id",
    "transfer-id": "transfer-id",
    "file-transfer-id": "transfer-id/file-transfer-id",
    "url": "sftp://s-server-id.server.transfer.us-east-1.amazonaws.com",
    "file-path": "/sftp-server-storage-east/RETRIEVE-to-S3.txt",
    "status-code": "COMPLETED",
    "start-time": "2023-12-18T15:36:39.727626Z",
    "end-time": "2023-12-18T15:36:39.895726Z",
    "account-id": "500655546075",
    "connector-arn": "arn:aws:transfer:us-east-1:500655546075:connector/c-connector-id",
    "local-directory-path": "/s3-storage-east/incoming"
}

Procedimientos para crear un servidor Transfer Family para usarlo como SFTP servidor remoto

A continuación, describimos los pasos para crear un servidor Transfer Family que sirva como SFTP servidor remoto para este tutorial. Tenga en cuenta lo siguiente:

Crear un SFTP servidor Transfer Family y un usuario

La mayoría de los usuarios no necesitarán crear un SFTP servidor Transfer Family y un usuario, ya que ya tienes un SFTP servidor con usuarios y puedes usar este servidor para transferir archivos de ida y vuelta. Sin embargo, para este tutorial, para simplificar, utilizamos un servidor Transfer Family para que funcione como SFTP servidor remoto.

Siga el procedimiento descrito en Cree un SFTP servidor habilitado para crear un servidor y Paso 3: agregar un usuario de servicio administradas añadir un usuario. Estos son los detalles del usuario que vamos a utilizar para el tutorial:

Función combinada de usuario y de acceso

Para el tutorial, utilizamos un único rol combinado. Usamos este rol tanto para nuestro SFTP usuario como para acceder al conector. El siguiente ejemplo contiene los detalles de este rol, por si desea realizar las tareas del tutorial.

El siguiente ejemplo concede los permisos necesarios para acceder a nuestros dos buckets en Amazon S3 y al secreto denominado aws/transfer/sftp-connector1 almacenado en Secrets Manager. En el tutorial, este rol recibe un nombresftp-connector-role.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowListingOfUserFolder",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::sftp-server-storage-east",
                "arn:aws:s3:::s3-storage-east"
            ]
        },
        {
            "Sid": "HomeDirObjectAccess",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:DeleteObject",
                "s3:DeleteObjectVersion",
                "s3:GetObjectVersion",
                "s3:GetObjectACL",
                "s3:PutObjectACL"
            ],
            "Resource": [
                "arn:aws:s3:::sftp-server-storage-east/*",
                "arn:aws:s3:::s3-storage-east/*"
            ]
        },
        {
            "Sid": "GetConnectorSecretValue",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:us-east-1:500655546075:secret:aws/transfer/sftp-connector1-6RandomCharacters"
        }
    ]
}

Para obtener información completa sobre la creación de roles para Transfer Family, siga el procedimiento descrito en Creación de un rol de usuario Para crear un rol.