ST_SecureCredentials

Descripción general

Tipo:

Estructura

Disponible desde:

V1.4.3.0

Hereda de:

Descripción

La estructura ST_SecureCredentials contiene la información específica del usuario para establecer una conexión segura a través de TLS con un servidor FTP externo.

NOTA: Los comandos para gestionar un inicio de sesión no se incluyen en la enumeración ET_FtpCommand. Las credenciales de usuario se utilizan para establecer una conexión segura a través de TLS con el host especificado automáticamente después de habilitar el bloque de funciones. El puerto 21 es el puerto supervisado predeterminado para el servidor FTP. Para modificar esas credenciales, deshabilite la función y vuelva a habilitarla con la nueva información.

Gestión de archivos de certificado (clave)

La estructura ST_SecureCredentials permite configurar el certificado de cliente. El certificado de cliente puede utilizarlo opcionalmente el servidor en conexiones FTP seguras para verificar que se trata del cliente correcto al que conectarse.

Para configurar el certificado de servidor necesario para establecer una conexión FTP segura a través de TLS, consulte Declaración de la conexión al servidor FTP como de confianza.

  • Certificado de controlador

    Para utilizar el certificado predeterminado del controlador, las entradas i_sCertFileName e i_sKeyFileName deben contener una cadena nula.

    Este certificado de controlador predeterminado se muestra en el editor Pantalla de seguridad de EcoStruxure Machine Expert Logic Builder: En la carpeta Certificados propios de la ficha Dispositivos cuando se selecciona el controlador. Para obtener más información, consulte la Guía del usuario Cómo gestionar certificados en el controlador.

  • Certificado específico del cliente

    Para utilizar su propio certificado, debe almacenar los siguientes archivos externos en el sistema de archivos del controlador.

    • Dos archivos individuales: Un archivo que contiene el certificado que se debe asignar a la entrada i_sCertFileName y otro archivo que contiene la información de clave que se debe asignar a la entrada i_sKeyFileName.

    • O un archivo que contenga información tanto de certificado como de clave. En este caso, asigne el mismo archivo a las entradas i_sCertFileName y i_sKeyFileName.

Los diferentes archivos deben estar disponibles en formato Base64 PEM estándar. Estos archivos se pueden generar mediante herramientas de freeware como Open SSL o FileZilla Server.

En el ejemplo siguiente, se muestra la opción de FileZilla Server para generar un archivo PEM:

En la figura siguiente, solo se muestra un archivo *.crt generado automáticamente que contiene el certificado y la información de clave generada con FileZilla Server y almacenada en el sistema de archivos de un Modicon M262 Logic/Motion Controller.

Elementos de la estructura

Nombre

Tipo de datos

Descripción

i_sServerIp

STRING [15]

La dirección IP del servidor FTP externo.

i_sUsername

STRING [255]

El nombre de usuario para acceder al servidor FTP externo.

i_sPassword

STRING [255]

La contraseña para acceder al servidor FTP externo.

i_sCertFileName

STRING [255]

Especifica el archivo de certificado externo opcional del cliente FTP.

i_sKeyFileName

STRING [255]

Especifica el archivo de clave de cliente externo opcional del cliente FTP.

Utilizado por

  • FB_FtpSecureClient