Орта айнымалылары мен құпиялар дегеніміз не? Қарапайым нұсқаулық

Орта айнымалысы — бұл атауы бар баптау, мысалы DATABASE_URL немесе STRIPE_SECRET_KEY. Ол қолданба іске қосылған кезде оған беріледі, кодқа жазылмайды. Құпия — мәні жеке сақталуы тиіс орта айнымалысы: API кілті, құпиясөз немесе қолтаңба кілті. Бұл мәндерді кодтан тыс ұстау арқылы қолданбаны өңдемей-ақ өзгертуге, сынақ пен нақты клиенттер үшін түрлі мәндерді пайдалануға және кодты бөліскен немесе жариялаған кезде оның ашылып қалуының алдын алуға болады.

Неліктен бұл AI көмегімен құрастырғанда маңызды

Қолданба басқа сервиспен пайдалы жұмыс істей бастаған сәтте, мысалы төлем қабылдаса, электрондық хат жіберсе немесе AI моделін шақырса, оған кілт қажет болады. AI құрастырушылары бұл кілттерді жиі сұрайды, ал кілт қай жерде тұрғаны қолданбаның қауіпсіздігін анықтайды.

AI арқылы құрастырылған қолданбаларда екі қате жиі кездеседі:

• Кілт чатқа немесе кодқа қойылады. Сонда ол чат тарихында, жоба файлдарында және кез келген экспортта немесе репозиторийде қалады. Оны көрген адам сіздің аккаунтыңызды пайдалана алады.
• Кілт браузерде пайдаланылады. Stripe немесе OpenAI-ды шақыратын код бетте жұмыс істесе, кілт әрбір келушіге жіберіледі. Адамдар мұны тексереді, ал автоматты сканерлер ашық кілттерді үнемі іздейді.

Орта айнымалыларын түсіну осы екі қателіктің екеуін де байқауға және түзетуді сұрауға көмектеседі.

Күнделікті ұқсастық: қонақ үй сейфі

Қолданбаңыздың коды — бөлме сияқты. Қонақтар (және тазалаушылар, және кілт карточкасын берген кез келген адам) сол жерден өтеді. Паспортыңызды үстелге қалдырмайсыз.

Орта айнымалылары — бөлмедегі сейф. Бөлмеде сейфтің бар екенін және қажет болғанда оны қалай ашуға болатынын біледі, бірақ паспорт ашық жатпайды. Ал егер бөлме ауыстырылса, мысалы сынақ орнатымнан нақты сайтқа көшсеңіз, интерьерді өзгертпей-ақ сол бөлменің сейфіне басқа паспорт саласыз.

Ол қалай жұмыс істейді

Сіздің кодыңыз мәнді емес, атауды сілтейді. Серверде JavaScript-те бұл process.env.STRIPE_SECRET_KEY түрінде көрінеді. Қолданба іске қосылғанда, оны жұрттық платформа атаудың мәнін толтырады. Мәнді платформа параметрлерінде өзгертіп, қайта іске қосқанда немесе қайта жариялағанда, қолданба жаңасын пайдаланады — кодты өзгертудің қажеті жоқ.

Мәндердің қайдан келетіні қолданбаның қай жерде жұмыс істеуіне байланысты:

Ашық және құпия айнымалылар

Барлық орта айнымалылары құпия бола бермейді. Оларды екі топқа бөлу пайдалы:

Веб-фреймворктер бұл бөлуді анық көрсетеді. Vite-та тек VITE_ префиксі бар айнымалылар браузер кодына кіреді; Next.js-те префикс — NEXT_PUBLIC_. Бұл қауіпсіздік функциясы: осы префикстері бар нәрсе әрбір келушінің жүктейтін файлдарына түседі, сондықтан құпияға ешқашан мұндай префикс берілмеуі керек.

Жұмыс мысалы: AI түйіндеме батырмасы

Сізге AI моделін шақыратын «Осы жазбаны қысқартып беру» батырмасы керек.

Қауіпті нұсқа: браузерде жұмыс істейтін батырма кодында AI провайдеріне тікелей, API кілті жазылған күйде сұрау жібереді. Ол алдын ала қарауда жұмыс істейді. Бірақ бұл кез келген адамның браузердің әзірлеуші құралдарын ашып, кілтті көшіріп, сіздің аккаунтыңыздан шығын жасауына мүмкіндік береді.

Қауіпсіз нұсқа:

1. AI провайдерінде кілтті жасап, оны жоба параметрлерінде OPENAI_API_KEY (немесе осыған ұқсас) атауымен құпия ретінде сақтайсыз.
2. Бэкендте POST /api/summarise маршруты болады, ол process.env.OPENAI_API_KEY мәнін оқиды, пайдаланушының кірген-кірмегенін тексереді және провайдерді шақырады.
3. Батырма провайдерді емес, сіздің маршрутыңызды шақырады. Браузер кілтті ешқашан көрмейді.
4. Жарияланған қолданбаның параметрлеріне дәл сол құпияны қосып, қайта жариялайсыз, сонда тірі сайтта да ол болады.

Бұл үлгі — браузер сіздің серверге сұрау жібереді, сервер кілтті ұстап, қызметті өзі шақырады — төлемдерге, электрондық поштаға, карталарға және басқа ақылы API үшін де қолданылады. LLM API-ларын пайдалану нұсқаулығында AI жағдайы толығырақ түсіндірілген.

Негізгі терминдер

• .env файлы: жергілікті әзірлеуде қолданылатын NAME=value жолдарынан тұратын мәтін файлы. Ол git-ке түспеуі үшін .gitignore ішіне жазыңыз.
• .env.example: атаулары бар, бірақ нақты мәндері жоқ көшірме. Басқалар қандай айнымалыларды орнату керек екенін білуі үшін оны коммит жасайсыз.
• Ауыстыру (rotate): құпияны жаңасына ауыстыру және ескісін қайтарып алу.
• Шектеу / рұқсаттар: көптеген провайдерлер тек белгілі бір әрекеттерге рұқсат беретін кілттер жасауға мүмкіндік береді. Тек хат жіберуге рұқсаты бар кілт барлық нәрсеге рұқсаты бар кілттен қауіпсіз.
• Сынақ және тірі кілттер: Stripe сияқты провайдерлер сынақ үшін және нақты ақша үшін бөлек кілттер береді. Іске қосқанға дейін сынақ кілттерін пайдаланыңыз.
• Қолтаңба құпиясы: хабарлама, мысалы вебхук, шынымен жіберушіден келгенін тексеру үшін қолданылатын құпия.

Жиі кездесетін қателер мен түсініспеушіліктер

• «Репозиторий жабық, сондықтан ішінде кілттер болса да қауіпсіз.» Жабық репозиторийлер де бөлісіледі, көшіріледі, экспортталады және ноутбуктерге клондалады. Кілттің онда орны жоқ. Жобаны GitHub-қа қоссаңыз, ішінде .env файлы жоқ екеніне көз жеткізіңіз.
• «Өшірдім, демек жоқ.» Git тарихты сақтайды, ал чат журналдарында хабарламалар қалады. Кілт бір рет ашылып қалса, оны ауыстырыңыз.
• Құпияға ашық префикс қою. VITE_OPENAI_KEY кілтті браузер жинағына салады.
• Қайта жариялауды ұмыту. Параметрлерде айнымалыны өзгерту әдетте тек қолданба қайта іске қосылғанда немесе қайта жарияланғанда күшіне енеді.
• Бәрі үшін бір кілт. Сынақ пен тірі үшін және әр қолданба үшін бөлек кілттер бір кілтті басқаларын бұзбай қайтарып алуға мүмкіндік береді.
• Шығын шегі жоқ. Ақылы API-лар үшін кілт ашылып қалған жағдайға дайындықпен провайдердің бақылау тақтасында бюджет немесе шек қойыңыз.

AI құрастырушыңызға не сұрау керек

• «Stripe құпия кілтін STRIPE_SECRET_KEY деп аталатын орта айнымалысынан оқы. Оны тек серверде пайдалан.»
• «Ешбір құпия клиенттік кодта пайдаланылмасын және оған VITE_ / NEXT_PUBLIC_ префиксі берілмесін.»
• «Қолданбаға қажет барлық айнымалылардың атауларын мәнсіз .env.example файлында тізіп жаз, ал .env git-ке елемейтін болсын.»
• «Құрастырылған фронтенд файлдарын API кілтіне ұқсайтын жолдар үшін тексер.»

Жариялауға дейін тексеретін басқа да нәрселермен қатар құпияларды қамтитын AI көмегімен құрастырылған қолданбаларға арналған қауіпсіздік тізімі нұсқаулығын оқыңыз.

Mythex-та құпиялар

Mythex-та құпиялар — жоба орта айнымалылары, олар хабарлама жіберуге арналған алдын ала қарау ортасына да, жарияланған қолданбаға да енгізіледі. Оларды жоба параметрлері → Secrets бөлімінде немесе чатта /secrets командасымен қосасыз. Агенттің кілтке қажеті болғанда, ол чатта құпиялар карточкасын көрсетеді, сонда мән хабарлама тарихына емес, форма өрісіне түседі. Тірі қолданбаның құпиясын өзгерткен кезде, деплой оны алуы үшін қайта жариялаңыз. Жоба экспорттарында құпиялар қосылмайды, ал импортталған .env файлдары тазаланады, сондықтан оларды параметрлерде қайта қосасыз. Қосымша мәліметті құжаттарда орта айнымалылары және құпиялар және чаттағы құпиялар бөлімдерінен табасыз.

Сұрақтар