Paso 1: Configurar los permisos e iniciar el control de tareas (STC)Paso 2: Crear buckets de Amazon S3 Paso 3: Cree una clave de AWS KMS cifrado gestionada por el cliente Paso 4: Cree un AWS Secrets Manager secreto para las credenciales del mainframe Paso 5: Crear una política IAM Paso 6: Cree un IAM usuario con credenciales de acceso a largo plazo Paso 7: Cree un IAM rol para que lo asuma el agente Paso 8: Configuración del agente

Configurar un agente de transferencia de archivos

Una vez que haya instalado un agente de transferencia de archivos, siga estos pasos para configurarlo. Si necesita instalar un agente nuevo, siga las instrucciones de la Instalación de un agente de File Transfer página.

Temas

Paso 1: Configurar los permisos e iniciar el control de tareas (STC)
Paso 2: Crear buckets de Amazon S3
Paso 3: Cree una clave de AWS KMS cifrado gestionada por el cliente
Paso 4: Cree un AWS Secrets Manager secreto para las credenciales del mainframe
Paso 5: Crear una política IAM
Paso 6: Cree un IAM usuario con credenciales de acceso a largo plazo
Paso 7: Cree un IAM rol para que lo asuma el agente
Paso 8: Configuración del agente

Paso 1: Configurar los permisos e iniciar el control de tareas (STC)

Actualice y envíe uno de SYS2.AWS.M2.SAMPLIB(SEC#RACF) (para configurar RACF los permisos) o SYS2.AWS.M2.SAMPLIB(SEC#TSS) (para configurar TSS los permisos) de acuerdo con sus instrucciones. Estos miembros se crearon en el paso CPY#PDS anterior.

nota
SYS2.AWS.M2es el calificador de alto nivel (HLQ) que se eligió durante la instalación.
Actualice la PWD exportación en el SYS2.AWS.M2.SAMPLIB(M2AGENT) STCJCL, si se ha cambiado la ruta de directorio predeterminada del agente de transferencia de archivos (/usr/lpp/aws/m2-agent).
Actualice y copie el archivo SYS2.AWS.M2.SAMPLIB(M2AGENT) JCL aSYS1.PROCLIB.
SYS2.AWS.M2.LOADLIBAñádalo a la APF lista mediante el siguiente comando:
```
SETPROG APF ADD DSNAME(SYS2.AWS.M2.LOADLIB) SMS
```
Defina el grupo y el propietario del agente logs y diag de las carpetas en el usuario/grupo del agente (M2 /M2). USER GROUP Utilice el siguiente comando:
```
chown -R M2USER:M2GROUP $AGENT_DIR/current-version/logs
chown -R M2USER:M2GROUP $AGENT_DIR/current-version/diag
```

Paso 2: Crear buckets de Amazon S3

AWSLa transferencia de archivos de modernización del mainframe requiere un bucket intermedio de Amazon S3 como área de trabajo. Recomendamos crear un bucket específico para ello.

Si lo desea, cree un nuevo bucket de Amazon S3 de destino para los conjuntos de datos transferidos. De lo contrario, también puede utilizar su bucket de Amazon S3 existente. Para obtener más información sobre la creación de buckets de Amazon S3, consulte Creación de un bucket.

Paso 3: Cree una clave de AWS KMS cifrado gestionada por el cliente

Para crear una clave gestionada por el cliente en AWS KMS

Abra la AWS KMS consola enhttps://console.aws.amazon.com/kms.
Seleccione Claves administradas por el cliente en el panel de navegación izquierdo.
Elija Create key.
En Configurar clave, seleccione Tipo de clave como simétrico y Uso de clave como cifrado y descifrado. Utilice otras configuraciones predeterminadas.
En Añadir etiquetas, añade el alias y la descripción de la clave.
Elija Next (Siguiente).
En Definir permisos administrativos clave, elige al menos un IAM usuario y un rol que administre esta clave.
Elija Next (Siguiente).
En la página de revisión, añada la siguiente sintaxis a la política clave. Esto permite que el servicio de modernización del AWS mainframe lea y utilice estas claves para el cifrado y el descifrado.

importante
Añada la declaración a las declaraciones existentes. No sustituyas lo que ya está en la política.
```
{
    "Sid" : "Enable AWS M2 File Transfer Permissions",
    "Effect" : "Allow",
    "Principal" : {
        "Service" : "m2.amazonaws.com"
    },
    "Action" : [
        "kms:Encrypt",
        "kms:Decrypt"
    ],
   "Resource" : "*"
},
```

Guarde la clave gestionada ARN por el cliente una vez creada. Se usará en la política más adelante.

Paso 4: Cree un AWS Secrets Manager secreto para las credenciales del mainframe

Las credenciales del mainframe son necesarias para acceder a los conjuntos de datos que se van a transferir y estas deben almacenarse en secreto. AWS Secrets Manager

Para crear un secreto AWS Secrets Manager

Abre la consola del administrador de Secrets enhttps://console.aws.amazon.com/secretsmanager.
En Elegir tipo de secreto, selecciona Otro tipo de secreto.
Utilice el valor userId clave del ordenador central userId que tiene acceso a los conjuntos de datos.
Utilice el valor clave password para el campo de contraseña.
En Clave de cifrado, elija la clave gestionada por el AWS cliente que se creó anteriormente.
Elija Next (Siguiente).
En la página Configurar el secreto, proporcione un nombre y una descripción.

En la misma página, edite los permisos de los recursos y utilice la siguiente política de recursos para que el servicio de modernización del AWS mainframe pueda acceder a ellos.


{
  "Version" : "2012-10-17",
  "Statement" : [ {
    "Effect" : "Allow",
    "Principal" : {
        "Service" : "m2.amazonaws.com"
    },
    "Action" : [ "secretsmanager:GetSecretValue", 
                 "secretsmanager:DescribeSecret" ],
    "Resource" : "*"
  } ]
}

Seleccione Guardar para guardar los permisos actualizados antes de elegir Siguiente.
Vaya a la página Configurar rotaciones y seleccione Siguiente.
En la página de revisión, compruebe todas las configuraciones y seleccione Guardar para guardar el secreto.

importante

La clave password secreta userId y la clave distinguen mayúsculas de minúsculas y se deben introducir tal y como se muestra.

Paso 5: Crear una política IAM

Para crear una nueva política con los permisos necesarios para el agente

Cambie del editor visual al JSON editor y sustituya el contenido por la siguiente plantilla:


{
"Version": "2012-10-17",
    "Statement": [
        {
         "Sid": "FileTransferAgentSQSReceive",
            "Effect": "Allow",
            "Action": [
                "sqs:DeleteMessage",
                "sqs:ReceiveMessage"
            ],
            "Resource": "arn:aws:sqs:*:111122223333:m2-*-request-queue.fifo"
        },
        {
         "Sid": "FileTransferAgentSQSSend",
            "Effect": "Allow",
            "Action": "sqs:SendMessage",
            "Resource": "arn:aws:sqs:*:111122223333:m2-*-response-queue.fifo"
        },
        {
         "Sid": "FileTransferWorkingS3",
            "Effect": "Allow",
            "Action": "s3:PutObject",
            "Resource": "<file-transfer-endpoint-intermediate-bucket-arn>/*"
        },
        {
         "Sid": "FileTransferAgentKMSDecrypt",
            "Effect": "Allow",
            "Action": "kms:Decrypt",
            "Resource": "<kms-key-arn>"
        }
    ]
}

Sustituya las 111122223333 de la cola de solicitudes y las de la cola de respuestas por su cuentaARN.

nota
Se trata ARN de caracteres comodín que coinciden con las dos SQS colas de Amazon creadas durante la inicialización del punto final de transferencia de datos. Tras crear un punto final de transferencia de archivos, si lo desea, sustituya estos ARN valores por los valores reales de AmazonSQS.
file-transfer-endpoint-intermediate-bucket-arnARNSustitúyalos por el del depósito de transferencia creado anteriormente. Deje el comodín «/*» al final.
kms-key-arnSustitúyala ARN por la AWS KMS clave creada anteriormente.

Paso 6: Cree un IAM usuario con credenciales de acceso a largo plazo

Cree un IAM usuario que permita que el agente de mainframe se conecte a su AWS cuenta. El agente se conectará con este usuario y, a continuación, asumirá una función que usted defina con permisos para usar las colas de SQS respuestas y solicitudes de Amazon y para guardar conjuntos de datos en los buckets de Amazon S3.

Para crear este usuario IAM

Navegue a AWS IAM la consola enhttps://console.aws.amazon.com/iam.
En las opciones de permisos, elija la opción Adjuntar políticas directamente, pero no adjunte ninguna política de permisos. Estos permisos los administrará un rol que se adjuntará.
Una vez creado el usuario, selecciónelo y abra la pestaña de credenciales de seguridad.
En Crear clave de acceso, selecciona Otra cuando se te pregunte en Caso de uso.
Copie y guarde de forma segura la clave de acceso y la clave de acceso secreta generadas. Se usarán más adelante.

Para obtener más información sobre la creación de claves de IAM acceso, consulte Administrar las claves de acceso para IAM los usuarios.

importante

Guarde la Clave de acceso y la Clave de acceso secreta que aparecen en la última página del asistente de creación de claves de acceso antes de seleccionar Listo. Estas claves se utilizan para configurar el agente de mainframe.

nota

Guarde el IAM usuario ARN utilizado para establecer una relación de confianza con un IAM rol.

Paso 7: Cree un IAM rol para que lo asuma el agente

Para crear un nuevo IAM rol para el agente

Elija Roles en la IAM consola enhttps://console.aws.amazon.com/iam.
Elija Crear rol.
En la página Seleccionar entidad de confianza, elija Política de confianza personalizada para el tipo de entidad de confianza.

Sustituya la política de confianza personalizada por la siguiente y <iam-user-arn> sustitúyala por la ARN del usuario creado anteriormente.


{
    "Version": "2012-10-17",
    "Statement": [ {
         "Sid": "FileTransferAgent",
         "Effect": "Allow",
         "Principal": {
            "AWS": "<IAM-User-arn>"
         },
         "Action": "sts:AssumeRole"
    } ]
}

Elija Next (Siguiente).
En Agregar permisos, filtre por el nombre de la política que creó anteriormente y elíjalo.
Elija Next (Siguiente).
Asigne un nombre al rol y elija Crear rol.

nota

Guarde el nombre de rol, que utilizará más adelante para configurar el agente de mainframe.

Paso 8: Configuración del agente

Para configurar el agente de transferencia de archivos

Vaya a $AGENT_DIR/current-version/config.
Edite el archivo de configuración del agente appication.properties para agregar una configuración de entorno mediante el siguiente comando:
```
oedit $AGENT_DIR/current-version/config/application.properties
```
Por ejemplo:
```
agent.environments[0].account-id=<AWS_ACCOUNT_ID>
agent.environments[0].agent-role-name=<AWS_IAM_ROLE_NAME>
agent.environments[0].access-key-id=<AWS_IAM_ROLE_ACCESS_KEY>
agent.environments[0].secret-access-id=<AWS_IAM_ROLE_SECRET_KEY>
agent.environments[0].bucket-name=<AWS_S3_BUCKET_NAME>
agent.environments[0].environment-name=<AWS_REGION>
agent.environments[0].region=<AWS_REGION>
zos.complex-name=<File_Transfer_Endpoint_Name>
```
Donde:
- AWS_ACCOUNT_IDes el identificador de la AWS cuenta.
- AWS_IAM_ROLE_NAMEes el nombre del IAM rol creado enPaso 7: Cree un IAM rol para que lo asuma el agente.
- AWS_IAM_ROLE_ACCESS_KEYes la clave de acceso del IAM usuario creado enPaso 6: Cree un IAM usuario con credenciales de acceso a largo plazo.
- AWS_IAM_ROLE_SECRET_KEYes la clave secreta de acceso del IAM usuario creado enPaso 6: Cree un IAM usuario con credenciales de acceso a largo plazo.
- AWS_S3_BUCKET_NAME es el nombre del bucket de transferencia creado con el punto de conexión de transferencia de datos.
- AWS_REGION es la región en la que se configura el agente de File Transfer.
  
  nota
  Puede hacer que el agente de transferencia de archivos se transfiera a varias regiones y cuentas AWS definiendo varios entornos.
- (Opcional). zos.complex-namees el nombre complejo que creó al crear un punto final de transferencia de archivos.
  
  nota
  Este campo solo es necesario si desea personalizar el nombre complejo (que por defecto es su nombre de sysplex), que es el mismo que definió al crear el punto final de transferencia de archivos. Para obtener más información, consulte Cree puntos finales de transferencia de datos para la transferencia de archivos.
importante
Puede haber varias secciones de este tipo, siempre que el índice entre corchetes, [0], se incremente para cada una de ellas.

Debe reiniciar el agente para que los cambios surtan efecto.

Requisitos

Cuando se agrega o elimina un parámetro, hay que detener e iniciar el agente. Inicie el agente de transferencia de archivos mediante el siguiente comando en: CLI
```
/S M2AGENT
```
Para detener el agente M2, utilice el siguiente comando enCLI:
```
/P M2AGENT
```

Puede hacer que el agente de transferencia de archivos se transfiera a varias regiones y cuentas AWS definiendo varios entornos.

nota

Sustituya los valores por los valores de los parámetros que creó y configuró anteriormente.


#Region 1
agent.environments[0].account-id=AWS_ACCOUNT_ID
agent.environments[0].agent-role-name=AWS_IAM_ROLE_NAME
agent.environments[0].access-key-id=AWS_IAM_ROLE_ACCESS_KEY
agent.environments[0].secret-access-id=AWS_IAM_ROLE_SECRET_KEY
agent.environments[0].bucket-name=AWS_S3_BUCKET_NAME
agent.environments[0].environment-name=AWS_REGION
agent.environments[0].region=AWS_REGION

#Region 2
agent.environments[1].account-id=AWS_ACCOUNT_ID
agent.environments[1].agent-role-name=AWS_IAM_ROLE_NAME
agent.environments[1].access-key-id=AWS_IAM_ROLE_ACCESS_KEY
agent.environments[1].secret-access-id=AWS_IAM_ROLE_SECRET_KEY
agent.environments[1].bucket-name=AWS_S3_BUCKET_NAME
agent.environments[1].environment-name=AWS_REGION
agent.environments[1].region=AWS_REGION

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Instalación de un agente de File Transfer

Cree puntos finales de transferencia de datos