Seadista API võtmed

Rakenduse täielikuks kasutamiseks on vaja seadistada GenAI API võti tehisintellekti funktsioonide jaoks. Serveripoolne andmebaasiühendus on nüüd automaatne!

1. GenAI API võti

Vajalik tehisintellekti mudelite kasutamiseks (nt aruannete genereerimine).

Samm 1: Loo või leia API võti

Mine Google Cloud API & Services lehele ja loo uus API võti või kasuta olemasolevat.

Samm 2: Eemalda piirangud (äärmiselt oluline!)

Kliki oma API võtme nimel ja veendu, et jaotises "Application restrictions" oleks valitud "None". See on kriitiline serveripoolsete päringute lubamiseks.

Hoiatus

Kui see samm vahele jätta, ebaõnnestuvad kõik AI-päringud veaga `403 Forbidden`.

Samm 3: Sisesta ja kopeeri

Kleepige oma API võti allolevasse lahtrisse ja kopeerige genereeritud rida oma projekti .env faili.

GEMINI_API_KEY=

2. Firebase'i serveriühendus (automaatne)

Serveripoolne autentimine on nüüd automaatne ja ei vaja eraldi seadistamist koodis.

Kuidas see töötab?

Rakendus kasutab Application Default Credentials (ADC) meetodit. See tähendab, et server tuvastab automaatselt, et see töötab Google Cloudi keskkonnas, ja kasutab selle keskkonna teenusekontot turvaliseks autentimiseks, ilma et oleks vaja hallata eraldi võtmefaile.

Lokaalne arendus vs. Live keskkond

Lokaalselt arendades: Selleks, et server saaks sinu arvutis andmebaasiga ühendust, pead sa ennast autentima `gcloud` CLI tööriistaga. Ava oma terminal ja käivita käsk:
```
gcloud auth application-default login
```
See seob sinu Google'i konto arenduskeskkonnaga ja annab serverile ajutiselt samad õigused, mis on sinu kasutajal.
Live keskkonnas (pärast paigaldamist): Kui rakendus on Firebase App Hostingusse paigaldatud, loob Google automaatselt spetsiaalse teenusekonto (nt. `...@gcp-sa-apphosting.iam.gserviceaccount.com`). Rakendus kasutab seda kontot automaatselt. Sa pead lihtsalt tagama, et sellel teenusekontol on IAM lehel piisavad õigused (nt. roll "Editor").

Tähtis

Pärast .env faili muutmist (API võtme lisamist) või `gcloud` käsu käivitamist peate oma arendusserveri taaskäivitama, et muudatused jõustuksid. See võib võtta mõne minuti.