Secrets i variables d'entorn sense enganxar claus al xat

La majoria d'aplicacions reals necessiten almenys un secret: la clau d'un proveïdor de pagaments, la clau d'un servei de correu, una clau per a una API d'IA. A Mythex no les enganxes en un prompt. Quan l'agent en necessita una, mostra una targeta de sol·licitud de secrets al xat, escrius el valor dins la targeta i es guarda com a secret del projecte que la teva aplicació pot llegir, sense que la clau acabi a la conversa.

Què fa

Cada projecte de Mythex pot guardar variables d'entorn: valors amb nom, com STRIPE_SECRET_KEY, que la teva aplicació llegeix en executar-se en lloc d'escriure'ls al codi. Els secrets són variables d'entorn els valors de les quals han de romandre privats.

Els mateixos valors estan disponibles en dos llocs:

• El sandbox, on l'agent construeix i executa la teva aplicació mentre treballes.
• Els teus desplegaments publicats, on els visitants fan servir l'aplicació.

Hi ha tres maneres d'afegir-los:

1. La targeta de sol·licitud de secrets, que l'agent mostra al xat quan necessita una clau per acabar alguna cosa.
2. Configuració del projecte → Secrets, on pots afegir o editar valors en qualsevol moment.
3. /secrets al xat, per afegir o actualitzar secrets quan ho demanis.

Per què ajuda

La manera òbvia de donar una clau a un agent d'IA és enganxar-la al missatge. Funciona, però la clau queda aleshores dins de l'historial del xat, en text pla, al costat de tot el que has dit.

La targeta de secrets manté el valor fora de la transcripció. L'introdueixes als camps de la targeta, no al quadre de missatges, i es guarda com a secret del projecte. L'agent continua amb la clau disponible al sandbox.

Mantenir les claus a la configuració del projecte, i no al codi, té altres avantatges:

• Les claus queden fora del control de versions. El teu codi es refereix a una clau pel nom; el valor viu a la configuració del projecte.
• L'agent i la teva aplicació en marxa veuen la mateixa configuració. No hi ha cap còpia que es desfasi.
• Pots rotar una clau sense reescriure el codi. Canvies el valor a la configuració; el codi continua llegint-lo pel nom.

Si les variables d'entorn són noves per a tu, la nostra guia sobre què són les variables d'entorn i els secrets explica la idea des de zero.

Com fer servir la targeta de secrets

1. Demana la funcionalitat, per exemple «envia un correu de benvinguda quan algú es registri».
2. Quan l'agent necessiti una clau, apareix una targeta de sol·licitud de secrets al xat, amb el valor que necessita.
3. Introdueix el valor als camps de la targeta, no al quadre de missatges.
4. Confirma. El valor es guarda com a secret del projecte.
5. L'agent continua, amb la clau disponible al sandbox.

Com afegir secrets tu mateix

1. Obre la configuració del projecte i després Secrets.
2. Afegeix claus com STRIPE_SECRET_KEY, OPENAI_API_KEY o les credencials del teu propi servei.
3. Demana a l'agent que les llegeixi de la manera estàndard del teu framework, per exemple des de process.env en una aplicació Node.
4. Torna a publicar si una aplicació publicada necessita els nous valors.

També pots escriure /secrets al xat per afegir-los o actualitzar-los allà.

Canviar un secret en una aplicació publicada

Una aplicació publicada recull els secrets en el moment de la publicació. Després d'afegir-ne o canviar-ne un, publica de nou perquè el desplegament en viu rebi el nou valor. Fins aleshores, els visitants continuen fent servir l'aplicació amb la configuració anterior.

Consells de seguretat

• Mai no guardis secrets al repositori. Guarda'ls a la configuració del projecte.
• Prefereix claus només de servidor per a operacions privilegiades. Una clau que pot cobrar targetes o enviar correus pertany al codi que s'executa al servidor, no a res que el navegador d'un visitant descarregui.
• Si una clau apareix alguna vegada a l'historial del xat, rota-la. Crea una clau nova al proveïdor, revoca l'antiga i actualitza el valor a la configuració del projecte. Considera exposada qualsevol clau que s'hagi enganxat en un xat.

Límits

• La targeta només ajuda si la fas servir. Si enganxes una clau al quadre de missatges de totes maneres, queda a la transcripció. Rota-la al proveïdor i actualitza el valor guardat.
• Les aplicacions publicades necessiten tornar a publicar per recollir els secrets nous o canviats.
• Guardar una clau de manera segura no fa segur cada ús que se'n faci. On s'utilitza la clau continua important: mantén les claus privilegiades al costat del servidor de la teva aplicació.

Per saber més sobre com mantenir una aplicació segura abans de compartir-la, consulta la nostra llista de comprovació de seguretat per a aplicacions creades amb IA.

Els documents tenen els detalls: Variables d'entorn i secrets i Secrets al xat.