Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Autentifikācija, API atslēgas un organizācija

Nodarbība 3 no 22 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Autentifikācija, API atslēgas un organizācija
  2. Izveido savu kontu un iegūsti atslēgu
  3. Kuru atslēgas veidu izvēlēties
  4. Organizācijas un projekti
  5. Nekad neizpauž savas atslēgas
  6. Pārbaudi savu konfigurāciju
  7. Galvenās atziņas

Autentifikācija, API atslēgas un organizācija

Pirms uzraksti pirmo koda rindiņu, tev ir jākonfigurē piekļuve API. Šajā nodarbībā apskatīsim, kā izveidot atslēgas, strukturēt piekļuvi, izmantojot organizācijas un projektus, kā arī drošības pasākumus, kas novērš klasisko murgu: nejaušu atslēgas augšupielādi publiskā repozitorijā, kur svešinieks to izlieto vienas nakts laikā.

Izveido savu kontu un iegūsti atslēgu

Process sastāv no trim soļiem. Pirmkārt, dodies uz platform.openai.com un izveido kontu; tu automātiski saņemsi bezmaksas kredītus eksperimentu uzsākšanai. Tālāk dodieties uz vadības paneļa sadaļu API Keys un ģenerē jaunu atslēgu. Šo atslēgu redzēsi tikai vienreiz: nekavējoties to nokopē, bet neielīmē to savā kodā.

# Tava API atslēga izskatās šādi (nekad to nekopīgo!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Labākā prakse: izmanto vides mainīgo
import os
api_key = os.environ.get("OPENAI_API_KEY")

Trešais solis ir vides mainīgā deklarēšana, kas ir atkarīga no tavas platformas. Izstrādes datorā .env fails, ko ielādē python-dotenv, bieži vien ir ērtākais risinājums. Serverī dod priekšroku vides mainīgajam, ko definē tavs orķestrators vai noslēpumu serviss.

# Linux / macOS — pievieno ~/.bashrc vai ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"

# .env fails (ar python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here

Kuru atslēgas veidu izvēlēties

Projekta atslēgas, ko var atpazīt pēc to sk-proj- prefiksa, ir saistītas ar konkrētu projektu un nodrošina vislabāko kontroli. Tu tās izmantosi gandrīz visos gadījumos. SDK tās automātiski atpazīst, tiklīdz ir iestatīts vides mainīgais, tāpēc OpenAI() tiek inicializēts bez argumentiem visos šī kursa piemēros.

from openai import OpenAI

# SDK automātiski atpazīst OPENAI_API_KEY
client = OpenAI()

# Vai norādi eksplicīti (nav ieteicams ražošanas videi)
client = OpenAI(api_key="sk-proj-...")

Servisa atslēgas ir otrais veids. Tās ir paredzētas servera lietotnēm, kurām nepieciešama paaugstināta piekļuve; tās piešķir papildu atļaujas, tāpēc prasa īpašu piesardzību: glabā tās noslēpumu glabātuvē un nekad nepārsūti to vērtību uz izstrādes darbstaciju.

Organizācijas un projekti

Piekļuve ir strukturēta trīs ligzdotos līmeņos:

  1. Organizācija: Tavs uzņēmums vai komanda
  2. Projekts: Loģiska grupēšana (piemēram, „Ražošanas čatbots”, „Datu analīze”)
  3. API atslēga: Saistīta ar konkrētu projektu

Ja piederi vairākām organizācijām, norādi to, kuru plāno izmantot, inicializējot klientu:

from openai import OpenAI

# Norādi organizāciju (noderīgi, ja piederi vairākām)
client = OpenAI(
    organization="org-xxxxxxxxxxxx",
    project="proj-xxxxxxxxxxxx"
)

Velti laiku, lai sadalītu savu lietojumu projektos, nevis novirzītu visu caur vienu atslēgu. Tu redzēsi ieguvumu jau pie pirmajām grūtībām. Katram projektam ir sava lietojuma izsekošana, kas ļauj piesaistīt izmaksas konkrētai funkcijai, nevis neskaidram mēneša kopsummai. Arī ātruma ierobežojumi ir atdalīti: nakts batch uzdevums, kas izsmels savu kvotu, netraucēs tavam čatbotam atbildēt klientiem. Tad vari piešķirt dažādus dalībniekus katram projektam un, kas ir visbūtiskāk, atsaukt apdraudētu atslēgu, nepārtraucot citu lietotņu darbību.

Nekad neizpauž savas atslēgas

Noteikums ir vienkāršs un absolūts: atslēga nekad neparādās pirmkodā. Kontrasts starp abiem tālāk redzamajiem fragmentiem runā skaļāk nekā gara lekcija.

# SLIKTI — iekodēta atslēga kodā
client = OpenAI(api_key="sk-proj-abc123")  # BĪSTAMI!

# LABI — vides mainīgais
client = OpenAI()  # Automātiski nolasa OPENAI_API_KEY

# LABI — .env fails ar python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()

Secinājums attiecas uz tavu .gitignore, kurā lokālie konfigurācijas faili ir jāizslēdz pirms pirmās fiksācijas (commit), nevis pēc tam. Atslēga, kas ir publicēta un pēc tam dzēsta, paliek repozitorija vēsturē.

# VIENMĒR pievieno šīs rindiņas savam .gitignore
.env
.env.local
.env.production
*.key

Visbeidzot, plāno regulāru atslēgu rotāciju ik pēc 90 dienām. To vari izdarīt bez dīkstāves: izveido jaunu atslēgu, atjaunini savas izvietošanas versijas (deployments) un tikai tad, kad nekas vairs to neizmanto, dzēs veco.

Pārbaudi savu konfigurāciju

Pirms dodies tālāk, palaid šo skriptu. Tas pārbauda atslēgas esamību, parāda saīsinātu versiju, lai apstiprinātu, ka tā ir pareizā, un pēc tam veic reālu izsaukumu. Atkārto šo testu katru reizi, kad vide uzvedas dīvaini.

from openai import OpenAI
import os

def verify_configuration():
    """Pārbauda, vai API konfigurācija ir pareiza."""
    
    # Pārbauda atslēgas esamību
    api_key = os.environ.get("OPENAI_API_KEY")
    if not api_key:
        print("KĻŪDA: OPENAI_API_KEY nav definēts")
        return False
    
    print(f"Atslēga noteikta: {api_key[:8]}...{api_key[-4:]}")
    
    # Pārbauda savienojumu
    try:
        client = OpenAI()
        response = client.responses.create(
            model="gpt-5.6-terra",
            input="Reply only: OK"
        )
        print(f"Savienojums veiksmīgs: {response.output_text}")
        return True
    except Exception as e:
        print(f"Savienojuma KĻŪDA: {e}")
        return False

verify_configuration()
# Paredzamais rezultāts:
# Atslēga noteikta: sk-proj-...xxxx
# Savienojums veiksmīgs: OK

Galvenās atziņas

  • Katrai lietotnei izmanto projekta atslēgas (sk-proj-...)
  • Glabā savas atslēgas vides mainīgajos, nekad kodā
  • Organizē savu piekļuvi, izmantojot hierarhiju Organizācija → Projekts → Atslēga
  • Veic regulāru atslēgu rotāciju (ik pēc 90 dienām)
  • Vienmēr pievieno .env savam .gitignore