Avis de traduction IA

Cette documentation a été traduite automatiquement par IA.

Variables et Secrets

Variables et secretsCommunity Edition+

Introduction

Ce chapitre couvre la configuration et la gestion centralisées des variables d'environnement et des secrets. Ces outils sont essentiels pour le stockage sécurisé des données sensibles, la réutilisation des données de configuration et l'isolation des configurations entre les différents environnements.

Différences avec .env

CaractéristiqueFichier .envVariables et secrets configurés dynamiquement
Emplacement de stockageStocké dans le fichier .env à la racine du projetStocké dans la table environmentVariables de la base de données
Méthode de chargementChargé dans process.env via des outils comme dotenv au démarrage de l'applicationLu dynamiquement et chargé dans app.environment au démarrage de l'application
Méthode de modificationNécessite une édition directe du fichier et un redémarrage de l'application pour que les changements prennent effetPrend en charge la modification à l'exécution ; les changements sont appliqués immédiatement après le rechargement de la configuration de l'application
Isolation des environnementsChaque environnement (développement, test, production) nécessite une maintenance distincte des fichiers .envChaque environnement (développement, test, production) nécessite une maintenance distincte des données dans la table environmentVariables
Scénarios applicablesConvient aux configurations statiques et fixes, comme les informations de la base de données principale de l'applicationConvient aux configurations dynamiques nécessitant des ajustements fréquents ou liées à la logique métier (bases de données externes, stockage de fichiers, etc.)

Installation

C'est un plugin intégré, vous n'avez donc pas besoin de l'installer séparément.

Utilisation

Réutilisation des données de configuration

Par exemple, si plusieurs étapes d'un flux de travail nécessitent des nœuds d'e-mail et donc une configuration SMTP, vous pouvez stocker la configuration SMTP commune dans les variables d'environnement.

20250102181045

Stockage des données sensibles

Utilisez-les pour stocker des informations de configuration de bases de données externes, des clés de stockage de fichiers cloud et d'autres données sensibles.

20250102103513

Isolation de la configuration des environnements

Dans les différents environnements (développement, test, production), nous utilisons des stratégies de gestion de configuration indépendantes. Cela garantit que les configurations et les données de chaque environnement ne s'interfèrent pas mutuellement. Chaque environnement dispose de ses propres paramètres, variables et ressources, ce qui permet d'éviter les conflits et de s'assurer que le système fonctionne comme prévu dans chaque contexte.

Par exemple, la configuration des services de stockage de fichiers peut différer entre les environnements de développement et de production, comme illustré ci-dessous :

Environnement de développement

FILE_STORAGE_OSS_BASE_URL=dev-storage.nocobase.com
FILE_STORAGE_OSS_BUCKET=dev-storage

Environnement de production

FILE_STORAGE_OSS_BASE_URL=prod-storage.nocobase.com
FILE_STORAGE_OSS_BUCKET=prod-storage

Gestion des variables d'environnement

20250102155314

Ajout de variables d'environnement

  • Vous pouvez les ajouter individuellement ou par lots.
  • Le stockage en clair et chiffré est pris en charge.

20250102155509

Ajout individuel

20250102155731

Ajout par lots

20250102155258

Remarques importantes

Redémarrage de l'application

Après avoir modifié ou supprimé des variables d'environnement, une notification de redémarrage de l'application apparaîtra en haut de l'écran. Les modifications ne prendront effet qu'après le redémarrage de l'application.

20250102155007

Stockage chiffré

Les données chiffrées des variables d'environnement utilisent le chiffrement symétrique AES. La CLÉ PRIVÉE pour le chiffrement et le déchiffrement est stockée dans le répertoire de stockage. Veuillez la conserver en lieu sûr ; si elle est perdue ou écrasée, les données chiffrées ne pourront plus être déchiffrées.

./storage/environment-variables/<app-name>/aes_key.dat

Plugins prenant actuellement en charge les variables d'environnement

Action : Requête personnalisée

20250102180751

Authentification : CAS

20250102160129

Authentification : DingTalk

20250102160205

Authentification : LDAP

20250102160312

Authentification : OIDC

20250102160426

Authentification : SAML

20250102160652

Authentification : WeCom

20250102160758

source de données : MariaDB externe

20250102160935

source de données : MySQL externe

20250102173602

source de données : Oracle externe

20250102174153

source de données : PostgreSQL externe

20250102175630

source de données : SQL Server externe

20250102175814

source de données : KingbaseES

20250102175951

source de données : API REST

20250102180109

Stockage de fichiers : Local

20250102161114

Stockage de fichiers : Aliyun OSS

20250102161404

Stockage de fichiers : Amazon S3

20250102163730

Stockage de fichiers : Tencent COS

20250102173109

Stockage de fichiers : S3 Pro

Non adapté

Carte : AMap

20250102163803

Carte : Google

20250102171524

Paramètres d'e-mail

Non adapté

Notification : E-mail

20250102164059

Formulaires publics

20250102163849

Paramètres système

20250102164139

Vérification : SMS Aliyun

20250102164247

Vérification : SMS Tencent

20250102165814

flux de travail

20250102180537