Esta documentación ha sido traducida automáticamente por IA.
Variables y Claves Secretas
This feature is provided by the plugin «Variables y secretos»Introducción
Configure y gestione de forma centralizada las variables de entorno y las claves secretas para el almacenamiento de datos sensibles, la reutilización de datos de configuración y el aislamiento de la configuración del entorno.
Diferencias con .env
| Característica | Archivo .env | Variables de Entorno y Claves Secretas Configuradas Dinámicamente |
|---|---|---|
| Ubicación de Almacenamiento | Se almacenan en el archivo .env en el directorio raíz del proyecto. | Se almacenan en la tabla environmentVariables de la base de datos. |
| Método de Carga | Se cargan en process.env utilizando herramientas como dotenv durante el inicio de la aplicación. | Se leen dinámicamente y se cargan en app.environment durante el inicio de la aplicación. |
| Método de Modificación | Requiere la edición directa del archivo, y la aplicación debe reiniciarse para que los cambios surtan efecto. | Permite la modificación en tiempo de ejecución; los cambios surten efecto inmediatamente después de recargar la configuración de la aplicación. |
| Aislamiento del Entorno | Cada entorno (desarrollo, pruebas, producción) requiere el mantenimiento independiente de sus archivos .env. | Cada entorno (desarrollo, pruebas, producción) requiere el mantenimiento independiente de los datos en la tabla environmentVariables. |
| Escenarios Aplicables | Adecuado para configuraciones estáticas fijas, como la información de la base de datos principal de la aplicación. | Adecuado para configuraciones dinámicas que requieren ajustes frecuentes o están vinculadas a la lógica de negocio, como bases de datos externas, información de almacenamiento de archivos, etc. |
Instalación
Es un plugin incorporado, por lo que no necesita instalarlo por separado.
Uso
Reutilización de Datos de Configuración
Por ejemplo, si varios puntos en un flujo de trabajo (workflow) requieren nodos de correo electrónico y configuración SMTP, puede almacenar la configuración SMTP común en variables de entorno.
Almacenamiento de Datos Sensibles
Permite el almacenamiento de información de configuración de diversas bases de datos externas, claves de almacenamiento de archivos en la nube y otros datos sensibles.
Aislamiento de la Configuración del Entorno
En diferentes entornos, como desarrollo, pruebas y producción, se utilizan estrategias de gestión de configuración independientes para asegurar que las configuraciones y los datos de cada entorno no interfieran entre sí. Cada entorno tiene sus propias configuraciones, variables y recursos independientes, lo que evita conflictos entre los entornos de desarrollo, pruebas y producción, y garantiza que el sistema funcione como se espera en cada uno.
Por ejemplo, la configuración de los servicios de almacenamiento de archivos puede variar entre los entornos de desarrollo y producción, como se muestra a continuación:
Entorno de Desarrollo
Entorno de Producción
Gestión de Variables de Entorno
Añadir Variables de Entorno
- Permite añadir variables individualmente o en lotes.
- Soporta almacenamiento en texto plano y cifrado.
Añadir Individualmente
Añadir en Lotes
Consideraciones
Reiniciar la Aplicación
Después de modificar o eliminar variables de entorno, aparecerá un aviso en la parte superior para reiniciar la aplicación. Los cambios en las variables de entorno solo surtirán efecto después de reiniciar la aplicación.
Almacenamiento Cifrado
Los datos cifrados de las variables de entorno utilizan cifrado simétrico AES. La CLAVE PRIVADA para el cifrado y descifrado se almacena en el directorio storage. Por favor, guárdela de forma segura; si se pierde o se sobrescribe, los datos cifrados no podrán descifrarse.
Plugins que Actualmente Soportan Variables de Entorno
Acción: Solicitud Personalizada
Autenticación: CAS
Autenticación: DingTalk
Autenticación: LDAP
Autenticación: OIDC
Autenticación: SAML
Autenticación: WeCom
Fuente de Datos: MariaDB Externa
Fuente de Datos: MySQL Externa
Fuente de Datos: Oracle Externa
Fuente de Datos: PostgreSQL Externa
Fuente de Datos: SQL Server Externo
Fuente de Datos: KingbaseES
Fuente de Datos: API REST
Almacenamiento de Archivos: Local
Almacenamiento de Archivos: Aliyun OSS
Almacenamiento de Archivos: Amazon S3
Almacenamiento de Archivos: Tencent COS
Almacenamiento de Archivos: S3 Pro
No adaptado
Mapa: AMap
Mapa: Google
Configuración de Correo Electrónico
No adaptado
Notificación: Correo Electrónico
Formularios Públicos
Configuración del Sistema
Verificación: SMS de Aliyun
Verificación: SMS de Tencent
Flujo de Trabajo
