Todentaminen, API-avaimet ja organisaatio
Tällä sivulla
Todentaminen, API-avaimet ja organisaatio
Ennen kuin kirjoitat riviäkään koodia, sinun on määritettävä API-yhteytesi. Tämä oppitunti käsittelee avainten luomista, käytön rakentamista organisaatioiden ja projektien kautta sekä niitä turvallisuustoimia, jotka estävät klassisen painajaisen: avaimen vahingossa julkiseen repositorioon työntämisen, jossa vieras henkilö voi kuluttaa sen yön aikana.
Tilin luominen ja avaimen hankkiminen
Prosessi vie kolme vaihetta. Siirry ensin osoitteeseen platform.openai.com ja luo tili; saat automaattisesti ilmaisia krediittejä kokeilujen aloittamiseen. Siirry sen jälkeen kojelaudan API Keys -osioon ja luo uusi avain. Näet tämän avaimen vain kerran: kopioi se välittömästi, mutta älä liitä sitä koodiisi.
# API-avaimesi näyttää tältä (älä koskaan jaa sitä!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Paras käytäntö: käytä ympäristömuuttujaa
import os
api_key = os.environ.get("OPENAI_API_KEY")
Kolmas vaihe on ympäristömuuttujan määrittäminen, mikä riippuu alustastasi. Kehityskoneella python-dotenv:n lataama .env-tiedosto on usein kätevin ratkaisu. Palvelimella on suositeltavaa käyttää orkestraattorin tai salaisuuspalvelun määrittelemää ympäristömuuttujaa.
# Linux / macOS — lisää tiedostoon ~/.bashrc tai ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env-tiedosto (python-dotenv:n kanssa)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Minkä tyyppisen avaimen valita
Projektikohtaiset avaimet, jotka tunnistaa sk-proj--etuliitteestä, on sidottu tiettyyn projektiin ja tarjoavat parhaan hallinnan. Käytät näitä lähes kaikissa tilanteissa. SDK havaitsee ne automaattisesti, kun ympäristömuuttuja on asetettu, minkä vuoksi OpenAI() alustetaan ilman argumentteja kaikissa tämän kurssin esimerkeissä.
from openai import OpenAI
# SDK havaitsee OPENAI_API_KEY:n automaattisesti
client = OpenAI()
# Tai määritä eksplisiittisesti (ei suositeltu tuotantoon)
client = OpenAI(api_key="sk-proj-...")
Palveluavaimet ovat toinen tyyppi. Ne on suunniteltu palvelinsovelluksille, jotka vaativat laajempia oikeuksia. Ne myöntävät lisäoikeuksia ja vaativat siksi erityistä huolellisuutta: säilytä ne salaisuusholvissa äläkä koskaan siirrä niiden arvoa kehitystyöasemalle.
Organisaatiot ja projektit
Käyttöoikeudet on jäsennetty kolmelle sisäkkäiselle tasolle:
- Organization: Yrityksesi tai tiimisi
- Project: Looginen ryhmittely (esim. “Tuotantokeskustelubotti”, “Data-analyysi”)
- API Key: Sidottu tiettyyn projektiin
Jos kuulut useampaan organisaatioon, määritä käytettävä organisaatio asiakasta alustaessasi:
from openai import OpenAI
# Määritä organisaatio (hyödyllistä, jos kuulut useampaan)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Kannattaa käyttää hetki käytön jakamiseen projekteihin sen sijaan, että ohjaisit kaiken yhden avaimen kautta. Huomaat hyödyn heti ensimmäisten ongelmien ilmetessä. Jokaisella projektilla on oma käyttöseuranta, joten voit kohdistaa kustannukset tiettyyn ominaisuuteen eikä vain läpinäkymättömään kuukausisummaan. Nopeusrajoitukset on myös erotettu toisistaan: yöllinen eräajo, joka kyllästää kiintiönsä, ei estä keskustelubottiasi vastaamasta asiakkaille. Voit tämän jälkeen osoittaa eri jäseniä kuhunkin projektiin ja mikä tärkeintä, mitätöidä vaarantuneen avaimen keskeyttämättä muita sovelluksia.
Älä koskaan paljasta avaimiasi
Sääntö on yksinkertainen ja ehdoton: avain ei koskaan esiinny lähdekoodissa. Alla olevien kahden koodinpätkän kontrasti puhuu enemmän kuin pitkä luento.
# HUONO — kovakoodattu avain koodissa
client = OpenAI(api_key="sk-proj-abc123") # VAARA!
# HYVÄ — ympäristömuuttuja
client = OpenAI() # Lukee automaattisesti OPENAI_API_KEY:n
# HYVÄ — .env-tiedosto python-dotenv:n kanssa
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Seuraus koskee .gitignore-tiedostoasi, jonka on suljettava paikalliset määritystiedostot pois ennen ensimmäistä commitia, ei sen jälkeen. Avain, joka julkaistaan ja myöhemmin poistetaan, pysyy edelleen repositorion historiatiedoissa.
# LISÄÄ NÄMÄ RIVIT AINA .gitignore-tiedostoosi
.env
.env.local
.env.production
*.key
Suunnittele lopuksi säännöllinen kierto 90 päivän välein. Voit tehdä tämän ilman käyttökatkoja: luo uusi avain, päivitä käyttöönotot ja poista vanha avain vasta, kun mikään ei enää käytä sitä.
Varmista määrityksesi
Ennen kuin jatkat, suorita tämä skripti. Se tarkistaa avaimen olemassaolon, näyttää siitä katkaistun version vahvistaakseen, että kyseessä on oikea avain, ja tekee sitten todellisen pyynnön. Suorita tämä testi uudelleen aina, kun ympäristö käyttäytyy oudosti.
from openai import OpenAI
import os
def verify_configuration():
"""Varmista, että API-määritykset ovat oikein."""
# Tarkista avain
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("VIRHE: OPENAI_API_KEY ei ole määritetty")
return False
print(f"Avain havaittu: {api_key[:8]}...{api_key[-4:]}")
# Testaa yhteys
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Yhteys onnistui: {response.output_text}")
return True
except Exception as e:
print(f"Yhteysvirhe: {e}")
return False
verify_configuration()
# Odotettu tulos:
# Avain havaittu: sk-proj-...xxxx
# Yhteys onnistui: OK
Keskeiset asiat
- Käytä projektikohtaisia avaimia (
sk-proj-...) jokaiseen sovellukseen - Säilytä avaimesi ympäristömuuttujissa, älä koskaan koodissa
- Jäsennä käyttöoikeutesi Organization → Project → Key -hierarkian mukaisesti
- Suorita avainten säännöllinen kierto (90 päivän välein)
- Lisää
.envaina.gitignore-tiedostoosi