MasomoJinsi ya kuweka funguo za API nje ya msimbo wa kivinjari

Somo fupi 15 kati ya 30 · Akaunti na ufikiaji

Jua thamani inayopaswa kubaki binafsi

Somo hili ni la nani?

Kwa watu wanaounganisha tovuti na AI au huduma nyingine yenye ruhusa maalumu. Msaidizi wa programu anaweza kuunganisha mradi ulio tayari; unahitaji kuelewa mahali siri yako inaruhusiwa kutumiwa, si kuandika msimbo wa seva.

Kivinjari kitumie kipengele chako bila kupokea siri ya mtoa huduma.

Utakachojifunza katika somo hili

  • Weka siri ya mtoa huduma kwenye mazingira binafsi ya seva pekee.
  • Endesha kitendo kilichotolewa bila kufichua ufunguo kwa wageni.
  • Kagua majaribio ya ufikiaji yaliyofaulu na yaliyokataliwa.
Maelezo, mfano uliotatuliwa na zoezi

Kabla ya kuanza

Unahitaji ufikiaji wako wa Google AI Studio API na mradi tofauti wa Netlify Functions. Tumia msaidizi na faili kamili pamoja na mazingira binafsi. Thibitisha modeli na mipaka ya akaunti, pamoja na gharama zozote, kabla ya kutuma maombi. Zoezi lina msimbo tofauti wa mwenyewe; si huduma ya AI tayari kwa umma.

Angalia ujuzi wa kuanzia

Huu ni ujuzi muhimu, si sharti la kumaliza kozi zilizofungwa. Ukiujua, anza hapa; la sivyo fungua maandalizi. Faili za kuanzia zimetolewa, kwa hiyo huhitaji tovuti yako ya awali.

  1. Jinsi ya kuchapisha tovuti yako kutoka GitHub

    Unganisha hifadhi ya mazoezi na huduma ya upangishaji.

Muda unaokadiriwa: 20–32 dakika

Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Usanidi wa huduma/akaunti unaweza kuchukua muda zaidi. Matumizi yanafuata masharti na kikomo cha sasa cha akaunti yako.

Elewa wazo

Fungua mradi uliotolewa na msaidizi wako. Tambua ufunguo wa mtoa huduma kama thamani binafsi ya akaunti na msimbo tofauti wa mazoezi kama kidhibiti cha mwenye mradi cha ufikiaji kwa maabara hii ndogo.

Faili kuitwa .env haitoshi ikiwa ujenzi wa programu unanakili thamani yake kwenye hati za umma. Mwombe msaidizi akague faili halisi zinazomfikia mgeni.

Mfano halisi

Sehemu iliyofichwa ya fomu bado ni ya kivinjari na haiwezi kuficha ufunguo wa mtoa huduma.

Fungua warsha hii tayari ya ufunguo wa API na uongoze usanidi wa run-locally.txt. Weka ufunguo wa mtoa huduma na uchaguzi wa modeli kwenye seva na utumie msimbo tofauti wa ufikiaji wa mazoezi. Usiweke siri kwenye faili za umma au kuniomba nizibandike kwenye ujumbe unaoshirikiwa. Nisaidie kuchunguza kinachopokelewa na kivinjari na kujaribu maombi yanayoruhusiwa na kukataliwa. Eleza ushahidi unaoonekana badala ya kunitaka nitekeleze endpoint.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Ni thamani ipi lazima ibaki nje ya ukurasa wa mgeni, na utamwomba msaidizi akague ushahidi gani?

Onyesha mfano wa suluhisho

Mpango wa faragha wa mfano: “GEMINI_API_KEY ni siri ya mtoa huduma. LAB_TOKEN ni msimbo tofauti wa zoezi, si jina jingine la ufunguo huo. Msaidizi atakagua skripti za umma zinazotolewa na maombi ya kivinjari kuona kama siri imevuja.”

Jina la faili binafsi pekee si ushahidi: build inaweza kunakili yaliyomo kwenye matokeo ya umma. Nitaweka thamani halisi nje ya picha za skrini na maelezo yanayoshirikiwa.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anatambua ufunguo wa mtoa huduma kama siri na msimbo wa zoezi kama mpaka tofauti wa majaribio.
  • Anataja faili za umma na maombi ya kivinjari kama mahali pa kutafuta uvujaji wa ufunguo.
Jinsi inavyofanya kazi (si lazima)

Weka funguo za siri za API nje ya msimbo wa kivinjari

Kivinjari cha mgeni kinaweza kukagua kila faili unalokitumia.

Siri ya huduma inaweza kuruhusu gharama au vitendo vya mamlaka ya juu. Kuiweka kwenye JavaScript ya umma, sehemu iliyofichwa au kigezo cha mazingira kinachoingizwa wakati wa build ya frontend bado huituma kwenye kivinjari.

Mfano huuliza Gemini swali moja la kufundishia lililowekwa kwenye function yako ya seva. Kivinjari hupokea jibu; ufunguo wa huduma hubaki kwenye mazingira ya seva. Si kila ufunguo ni wa siri: funguo za publishable za Supabase zimekusudiwa kwa kivinjari pamoja na sera za ufikiaji, lakini funguo zake za siri hazijakusudiwa hivyo.

Mfano uliotatuliwa

Fungua insecure-example.txt. Thamani ya bandia inaonekana kwa sababu imo kwenye msimbo uliotumwa. Kufupisha msimbo huo kungefanya usomeke kwa shida zaidi, lakini hakubadilishi anayepokea.

Zoezi la ziada la utekelezaji

Ufunguo unahifadhiwa kwenye .env kisha kuingizwa kwenye kifurushi cha JavaScript cha umma wakati wa build. Je, wageni hawawezi kuuona?

Onyesha mfano wa suluhisho

Hapana. Eneo lake la awali halina maana baada ya kuingizwa kwenye kifurushi cha umma. Hamisha kitendo chenye mamlaka kwenye function ya seva na ubakishe thamani huko.

  • Anafuatilia ufunguo hadi kifurushi kinachotumwa.
  • Anatofautisha mazingira ya seva na kuingiza thamani kwenye frontend.

Hatua 1 · Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari

Anzisha kitendo kilicholindwa kilichotolewa

Mruhusu msaidizi asanidi njia iliyopo ya seva.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Fuata run-locally.txt na server-env.example.txt kwa msaada. Thibitisha akaunti/modeli na masharti, weka ufunguo kwa faragha seva na zalisha msimbo tofauti. Endesha mradi kamili na ufungue URL ya ndani. Maandalizi haya ni ya lazima; kuandika function ni hiari.

Kivinjari kiwasiliane na kipengele chako cha seva huku seva ikiita mtoa huduma kwa faragha. Usanidi, ufikiaji au mgao ukishindwa, ripoti hatua hiyo badala ya kubuni jibu.

Mfano halisi

Msimbo wa mazoezi wa fomu si ufunguo wa mtoa huduma Google.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Kitendo kilifanya kazi, na ni hatua ipi ya usanidi binafsi au mtoa huduma bado imekwama?

Onyesha mfano wa suluhisho

Matokeo ya mfano: “Mradi kamili ulifunguka kwenye URL ya proxy. Kwa msimbo wa zoezi, tendo la seva lilirudisha maelezo mafupi ya seva ya tovuti. Siri na uchaguzi wa modeli vilibaki katika mazingira binafsi.”

Mfano uliokwama ni “Programu inaendeshwa, lakini mtoa huduma anasema mgao haupo; hakuna jibu lililofaulu lililoonekana.” Kagua modeli, mipaka na gharama kabla ya kurudia; somo hili haliahidi maombi ya bure au yasiyo na kikomo.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaandika anwani halisi ya programu ya ndani na tendo lililoruhusiwa au kikwazo kamili cha usanidi/mtoa huduma.
  • Anahifadhi siri/modeli kwenye seva na kukagua masharti ya akaunti kabla ya kuita.
Jinsi inavyofanya kazi (si lazima)

Weka ombi kwa huduma nyuma ya endpoint yako

Sanidi seva kisha utume ombi dogo linalohitajika na kipengele pekee.

Soma netlify/functions/mini-explain.mjs, chapisha mradi tofauti na uweke GEMINI_API_KEY, GEMINI_MODEL na LAB_TOKEN kwenye seva yake. Chagua modeli ya maandishi inayoungwa mkono katika akaunti yako badala ya kunakili jina la zamani kutoka mafunzo.

Ingiza msimbo tofauti wa mazoezi kwenye fomu. Kivinjari huita /.netlify/functions/mini-explain; function huita endpoint ya HTTPS iliyowekwa ya Google kwa x-goog-api-key. Msimbo ni mpaka wa mmiliki wa zoezi, si ufunguo wa Gemini wala mfumo kamili wa kikomo cha matumizi ya umma.

GEMINI_MODEL ni ID halisi ya modeli inayopatikana kwa akaunti yako ya API, si lebo ya kuonyesha iliyonakiliwa kutoka picha. generate ni function saidizi kwenye faili lilelile la seva. Ufunguo na function saidizi visiwe kwenye public/. Ombi sahihi linaweza bado kushindwa kikomo kikiisha au huduma isipatikane.

Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.

Tumia mwongozo wa sasa wa modeli hapa chini au endesha list-text-models.mjs kwenye mzizi wa siri wa warsha kwa mazingira yako. Inaorodhesha modeli zinazoweza kutumia generateContent na kuonekana kwenye akaunti bila kuchapisha ufunguo. Chagua modeli ya maandishi inayoungwa mkono, kagua masharti/kikomo na unakili ID yake halisi ya API kwenye GEMINI_MODEL ya seva.

Kabla ya ombi la kwanza, endesha zana ya orodha na uchague modeli ya maandishi ya sasa inayoruhusu sehemu za ombi la generateContent zinazotumiwa hapa, ikijumuisha systemInstruction. Orodha hutoa chaguo, si kikomo wala kila uwezo wa modeli. Faili lote la netlify/functions/mini-explain.mjs huendesha kwenye seva; public/app.js hutumwa kwa kila mgeni. Kagua pia muda wa juu wa functions kwenye hosting: muda wa sekunde 20 wa huduma hauwezi kuongeza kikomo kifupi zaidi cha hosting.

Mfano uliotatuliwa

Swali la huduma limewekwa kwenye seva, kwa hiyo mwombaji hawezi kugeuza njia hii kuwa maswali makubwa yoyote. Function pia huweka kikomo cha jibu na husubiri ombi kwa huduma kwa sekunde 20 tu.

Gemini generateContent API · Funguo za Gemini API · Gemini: ID na uwezo wa sasa wa modeli · Node.js: hali ya usaidizi wa matoleo

Zoezi la ziada la utekelezaji

Ni maombi gani mawili yaliyopo katika mchakato, na lipi lisitokee kwenye zana za Network za kivinjari?

Onyesha mfano wa suluhisho

Kivinjari huonyesha ombi kwa function yako na jibu lililorudi. Seva ndiyo hufanya ombi kwa huduma; ombi la Google lenye ufunguo wake lisitokee kuwa ombi la kivinjari.

  • Anaona ombi la kivinjari kwa function ya tovuti yake.
  • Anahifadhi ombi la Google lenye ufunguo kwenye seva.

Hatua 2 · Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari

Kagua faragha na kushindwa pamoja

Jibu lenye manufaa halihalalishi ufunguo uliofichuliwa.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Mwombe msaidizi akusaidie kuchunguza faili za umma zilizowasilishwa na maombi ya kivinjari kutafuta siri ya mtoa huduma bila kuionyesha kwenye kumbukumbu zinazoshirikiwa. Jaribu msimbo usio sahihi wa mazoezi na hali ya usanidi uliokosekana kwenye mradi wa kutupwa.

Ufunguo halisi usionekane kwenye faili au maombi ya kivinjari. Maombi yaliyokataliwa au yasiyopatikana yabaki kuwa hitilafu, yakiwa na njia inayotumika ya kujaribu tena.

Mfano halisi

Jibu la kuaminisha pamoja na ufunguo uliofichuliwa kwenye app.js bado ni jukumu lisilokamilika.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Ukaguzi wa matokeo ya umma na jaribio lililokataliwa vilionyesha nini kweli?

Onyesha mfano wa suluhisho

Rekodi ya faragha/kosa ya mfano: “Msaidizi alikagua matokeo ya umma na ombi la kivinjari kwa seva yangu; ufunguo haukuwepo. Msimbo batili ulikataliwa. Usanidi binafsi ulipoondolewa katika mradi wa kufutika, tendo lilishindwa badala ya kuonyesha maelezo ya kubuni.”

Hii inarekodi mpaka uliokaguliwa, si ukaguzi wote wa usalama. Ufunguo ukipatikana kwenye matokeo ya umma, acha kushiriki build hiyo na ubadilishe siri iliyovuja kwa mtoa huduma kabla ya kuitumia tena.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anataja matokeo/maombi ya umma yaliyokaguliwa bila kuonyesha siri ya mtoa huduma.
  • Anaandika ombi la ufikiaji lililokataliwa na lisilo na usanidi kama kushindwa.
Jinsi inavyofanya kazi (si lazima)

Hakikisha mpaka na jibu vyote

Jibu lililofaulu pekee halithibitishi ufunguo umebaki wa siri.

Tafuta ufunguo halisi wa huduma kwenye HTML na skripti za umma zilizochapishwa bila kuubandika kwenye picha au rekodi zinazoshirikiwa. Kagua maombi ya kivinjari: msimbo wa mazoezi unaweza kuonekana kwa mmiliki, lakini ufunguo wa Gemini usionekane.

Jaribu msimbo usio sahihi na usanidi wa huduma unaokosekana katika mradi wa mazoezi. Kushindwa kubaki kushindwa. Hali 429 ya huduma inaweza kueleza kikomo cha matumizi/kasi; 401 au 403 zinaweza kueleza tatizo la ufikiaji/usanidi. Usizigeuze zote kuwa jibu la AI la kubuni.

Mfano uliotatuliwa

Msimbo sahihi wa mazoezi na mipangilio sahihi ya huduma vinapaswa kutoa jibu halisi. Endpoint hiyo hiyo yenye msimbo usio sahihi ikatae kabla ya ombi lolote kwa huduma.

Zoezi la ziada la utekelezaji

Jibu linafanya kazi lakini ufunguo pia unaonekana kwenye public/app.js. Je, kazi imekamilika?

Onyesha mfano wa suluhisho

Hapana. Ondoa ufunguo kwenye faili za umma, ubatilishe na ubadilishe kwa sababu ulifichuliwa, sasisha mpangilio wa seva na ukague deployment mpya na historia ya repository kwa ufichuzi unaobaki.

  • Hakubali jibu lililofaulu kuwa ushahidi unaotosha.
  • Anaondoa uvujaji na kubatilisha na kubadilisha ufunguo uliofichuliwa.

Hatua 3 · Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari

Fanya badiliko moja lenye mipaka kwa usalama

Hifadhi mpaka uleule wa siri unapobadilisha kipengele.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Mwombe msaidizi abadilishe operesheni isiyobadilika iliyotolewa ieleze DNS kwa ufupi. Hifadhi mipangilio ya modeli na ufunguo kwenye seva na mpaka wa mazoezi wa mwenye mradi pekee.

Jaribu tena jibu lililokusudiwa na msimbo batili wa ufikiaji. Kabla ya matumizi ya umma, amua kuhusu uthibitishaji halisi, vidhibiti vya matumizi vya kudumu na ufuatiliaji wa bajeti ya mtoa huduma wako.

Mfano halisi

Kubadilisha mada ya jibu kusihamishe thamani binafsi za akaunti kwenda ukurasa.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Toa kitendo kilichobadilishwa na ukaguzi wa faragha, maombi halali na batili uliofanya kweli.

Unachopaswa kuandaa: Rekodi iliyofichwa taarifa nyeti ya mpaka wa ufunguo na maombi halali na batili ya kitendo kilichotolewa.

Onyesha mfano wa suluhisho

Rekodi ya mfano: “Tendo sasa linaeleza DNS kwa sentensi mbili. Ombi halali lilirudisha mada hiyo; msimbo batili ulikataliwa; ukaguzi wa umma haukuona ufunguo wa mtoa huduma.”

“Kabla ya kuifungulia watu nisiowajua, nahitaji uthibitishaji halisi wa akaunti, mipaka ya kudumu ya matumizi na ufuatiliaji wa bajeti.” Msimbo wa pamoja ni mpaka mdogo wa zoezi, si ushahidi wa huduma kamili ya umma.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anabadilisha mada ya jibu la kudumu kuwa DNS huku ufunguo/modeli vikibaki seva pekee.
  • Anapima tena maombi halali na yaliyokataliwa na kutaja udhibiti wa gharama/ufikiaji unaohitajika kwa umma.
Jinsi inavyofanya kazi (si lazima)

Kazi yako: hamisha kitendo cha pili kilichowekwa wazi

Rudia mpaka kwa makusudi badala ya kuupanua kwa bahati.

Badilisha swali lililowekwa kwenye seva lieleze DNS kwa sentensi mbili. Weka funguo, chaguo la modeli na kikomo cha jibu kwenye seva; kivinjari kisiujue ufunguo wa huduma.

Rekodi matokeo kwa msimbo sahihi na usio sahihi. Eleza utakachoongeza kabla ya ufikiaji wa umma: watumiaji waliothibitishwa au mpaka mwingine wa maana wa ufikiaji, vikomo vya matumizi vinavyodumu na ufuatiliaji wa bajeti ya huduma.

Mfano uliotatuliwa

Kubadilisha swali lililowekwa huthibitisha unaelewa tabia ya huduma inadhibitiwa wapi. Kukubali modeli, endpoint au kikomo cha jibu chochote kutoka kivinjari kungeondoa udhibiti huo.

Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.

Zoezi la ziada la utekelezaji

Tengeneza toleo la DNS na rekodi fupi ya kujaribu mpaka.

Onyesha mfano wa suluhisho

Katika function ya seva pekee ya mini-explain, badilisha swali la seva ya tovuti kuwa “Explain DNS in two sentences for a beginner.”, yaani eleza DNS kwa sentensi mbili kwa anayeanza. Weka ufunguo/modeli kwenye vigezo vya mazingira ya seva; function kamili ya marejeo inaonyesha badiliko halisi.

Kagua skripti zinazotumwa kwa kivinjari na maombi ya Network. Kivinjari hutuma ombi kwa function yako; kisitume GEMINI_API_KEY kwa Google chenyewe. Msimbo wa zoezi unaoingizwa na mmiliki ni tofauti na ufunguo wa huduma.

Jaribu msimbo usio sahihi: tarajia kukataliwa kabla ya ombi lolote kwa huduma. Kushindwa kwa kikomo/mtandao kubaki kushindwa kwa uaminifu, si jibu la mafanikio lililoandaliwa. Siri halisi ikifichuliwa, iondoe na uibadilishe; kupuuza faili baadaye hakubatilishi ufichuzi.

  • Hakuna siri ya huduma inayotumwa kwenye kivinjari.
  • Ufikiaji usio sahihi hukataliwa na kushindwa halisi kwa huduma huonekana.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.