Noslēpumi un vides mainīgie bez atslēgu ievietošanas tērzēšanā

Lielākajai daļai reālu lietotņu vajag vismaz vienu noslēpumu: maksājumu sniedzēja atslēgu, e-pasta pakalpojuma atslēgu vai atslēgu AI API. Mythex šos ierakstus neielīmē uzvednē. Kad aģentam vajag atslēgu, tērzēšanā parādās noslēpuma pieprasījuma kartīte, tu ievadi vērtību kartītē, un tā tiek saglabāta kā projekta noslēpums, ko tava lietotne var nolasīt, bez tā, ka atslēga nonāk sarunā.

Ko tas dara

Katrā Mythex projektā var glabāt vides mainīgos: nosauktas vērtības, piemēram, STRIPE_SECRET_KEY, ko lietotne nolasa, kad darbojas, tā vietā, lai tās būtu ierakstītas kodā. Noslēpumi ir vides mainīgie, kuru vērtībām jāpaliek privātām.

Tās pašas vērtības ir pieejamas divās vietās:

• Smilškastē, kur aģents veido un palaiž tavu lietotni, kamēr tu strādā.
• Tavās publicētajās izvietošanās, ko izmanto apmeklētāji.

Tās var pievienot trijos veidos:

1. Noslēpuma pieprasījuma kartīte, ko aģents parāda tērzēšanā, kad tam vajag atslēgu, lai kaut ko pabeigtu.
2. Projekta iestatījumi → Noslēpumi, kur vari jebkurā brīdī pievienot vai rediģēt vērtības.
3. /secrets tērzēšanā, lai pēc pieprasījuma pievienotu vai atjauninātu noslēpumus.

Kāpēc tas palīdz

Acīmredzamais veids, kā dot AI aģentam atslēgu, ir ielīmēt to savā ziņojumā. Tas darbojas, bet tad atslēga kļūst par daļu no tavas tērzēšanas vēstures, un tā paliek vienkāršā tekstā blakus visam pārējam, ko esi rakstījis.

Noslēpuma kartīte atslēgu tur ārpus stenogrammas. Vērtību ieraksti kartītes laukos, nevis ziņojuma lodziņā, un tā tiek saglabāta kā projekta noslēpums. Aģents turpina darbu, un atslēga ir pieejama smilškastē.

Atslēgu glabāšana projekta iestatījumos, nevis kodā, dod arī citas priekšrocības:

• Atslēgas paliek ārpus versiju kontroles. Tavs kods atsaucas uz atslēgu pēc nosaukuma, un vērtība atrodas projekta iestatījumos.
• Aģents un tavs darbojošais lietotne redz vienu un to pašu konfigurāciju. Nav kopijas, kas noveco.
• Atslēgu var nomainīt bez koda pārrakstīšanas. Nomaini vērtību iestatījumos, kods joprojām to nolasa pēc nosaukuma.

Ja vides mainīgie tev ir jauni, mūsu ceļvedis par to, kas ir vides mainīgie un noslēpumi, izskaidro šo ideju no paša sākuma.

Kā lietot noslēpuma kartīti

1. Pieprasi funkciju, piemēram: „nosūti sveiciena e-pastu, kad kāds reģistrējas“.
2. Kad aģentam vajag atslēgu, tērzēšanā parādās noslēpuma pieprasījuma kartīte ar vērtību, kas nepieciešama.
3. Ieraksti vērtību kartītes laukos, nevis ziņojuma lodziņā.
4. Apstiprini. Vērtība tiek saglabāta kā projekta noslēpums.
5. Aģents turpina, un atslēga ir pieejama smilškastē.

Kā pievienot noslēpumus pašam

1. Atver projekta iestatījumus un pēc tam Noslēpumi.
2. Pievieno atslēgas, piemēram, STRIPE_SECRET_KEY, OPENAI_API_KEY vai sava pakalpojuma pieejas datus.
3. Lūdz aģentam nolasīt tās standarta veidā tavam ietvaram, piemēram, no process.env Node lietotnē.
4. Publicē vēlreiz, ja publicētajai lietotnei vajag jaunās vērtības.

Tāpat tērzēšanā vari ierakstīt /secrets, lai tos pievienotu vai atjauninātu.

Noslēpuma mainīšana publicētā lietotnē

Publicēta lietotne noslēpumus paņem publicēšanas brīdī. Pēc tam, kad pievieno vai maini kādu, publicē vēlreiz, lai tiešraides izvietošana saņemtu jauno vērtību. Līdz tam apmeklētāji izmanto lietotni ar veco konfigurāciju.

Drošības padomi

• Nekad neiekļauj noslēpumus repozitorijā. Glabā tos projekta iestatījumos.
• Privilēģētām darbībām izmanto tikai servera atslēgas. Atslēga, kas var iekasēt maksājumus vai sūtīt e-pastus, pieder kodam, kas darbojas serverī, nevis kaut kam, ko apmeklētāja pārlūks lejupielādē.
• Ja atslēga kādreiz parādās tērzēšanas vēsturē, nomaini to. Izveido jaunu atslēgu pie pakalpojuma sniedzēja, atsauc veco un atjaunini vērtību projekta iestatījumos. Uzskati jebkuru atslēgu, kas ievietota tērzēšanā, par apdraudētu.

Ierobežojumi

• Kartīte palīdz tikai tad, ja to izmanto. Ja tomēr ielīmē atslēgu ziņojuma lodziņā, tā ir stenogrammā. Nomaini to pie pakalpojuma sniedzēja un atjaunini saglabāto vērtību.
• Publicētām lietotnēm vajag jaunu publicēšanu, lai saņemtu jaunus vai mainītus noslēpumus.
• Atslēgas drošā glabāšana nepadara drošu katru tās izmantošanu. Svarīga ir arī vieta, kur atslēga tiek lietota. Privilēģētās atslēgas glabā lietotnes servera pusē.

Vairāk par lietotnes drošību pirms kopīgošanas lasi mūsu drošības kontrolsarakstu AI veidotām lietotnēm.

Detalizētāka informācija ir dokumentācijā: Vides mainīgie un noslēpumi un Noslēpumi tērzēšanā.