Πιστοποίηση, Κλειδιά API και Οργάνωση
Σε αυτήν τη σελίδα
Πιστοποίηση, Κλειδιά API και Οργάνωση
Πριν γράψετε την πρώτη γραμμή κώδικα, πρέπει να ρυθμίσετε την πρόσβασή σας στο API. Αυτό το μάθημα καλύπτει τη δημιουργία κλειδιών, τη δομή πρόσβασης μέσω οργανισμών και έργων, καθώς και τα μέτρα ασφαλείας που αποτρέπουν τον κλασικό εφιάλτη: την κατά λάθος δημοσίευση ενός κλειδιού σε δημόσιο αποθετήριο, όπου ένας άγνωστος μπορεί να το καταναλώσει μέσα σε μία νύχτα.
Δημιουργία Λογαριασμού και Απόκτηση Κλειδιού
Η διαδικασία αποτελείται από τρία βήματα. Πρώτον, μεταβείτε στο platform.openai.com και δημιουργήστε έναν λογαριασμό· θα λάβετε αυτόματα δωρεάν πιστώσεις για να ξεκινήσετε τα πειράματά σας. Στη συνέχεια, πλοηγηθείτε στην ενότητα API Keys του πίνακα ελέγχου και δημιουργήστε ένα νέο κλειδί. Θα δείτε αυτό το κλειδί μόνο μία φορά: αντιγράψτε το αμέσως, αλλά μην το επικολλήσετε στον κώδικά σας.
# Το κλειδί API σας μοιάζει με αυτό (μην το κοινοποιείτε ποτέ!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Βέλτιστη πρακτική: χρήση μεταβλητής περιβάλλοντος
import os
api_key = os.environ.get("OPENAI_API_KEY")
Το τρίτο βήμα είναι η δήλωση της μεταβλητής περιβάλλοντος, η οποία εξαρτάται από την πλατφόρμα σας. Σε ένα μηχάνημα ανάπτυξης, ένα αρχείο .env που φορτώνεται από το python-dotenv είναι συχνά η πιο βολική λύση. Σε έναν διακομιστή, προτιμήστε μια μεταβλητή περιβάλλοντος που ορίζεται από τον orchestrator ή την υπηρεσία μυστικών (secrets service) σας.
# Linux / macOS — προσθήκη στο ~/.bashrc ή ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# Αρχείο .env (με python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Ποιον Τύπο Κλειδιού να Επιλέξετε
Τα κλειδιά έργου, αναγνωρίσιμα από το πρόθεμα sk-proj-, συνδέονται με ένα συγκεκριμένο έργο και προσφέρουν τον καλύτερο έλεγχο. Θα τα χρησιμοποιείτε σχεδόν σε κάθε περίπτωση. Το SDK τα εντοπίζει αυτόματα μόλις οριστεί η μεταβλητή περιβάλλοντος, γι’ αυτό και η κλήση OpenAI() δεν απαιτεί ορίσματα σε όλα τα παραδείγματα αυτού του μαθήματος.
from openai import OpenAI
# Το SDK εντοπίζει αυτόματα το OPENAI_API_KEY
client = OpenAI()
# Ή ορισμός ρητά (δεν συνιστάται για παραγωγή)
client = OpenAI(api_key="sk-proj-...")
Τα κλειδιά υπηρεσίας είναι ο δεύτερος τύπος. Σχεδιασμένα για εφαρμογές διακομιστή που απαιτούν αυξημένη πρόσβαση, χορηγούν πρόσθετα δικαιώματα και επομένως απαιτούν extra προσοχή: αποθηκεύστε τα σε θησαυροφυλάκιο μυστικών (secrets vault) και μην διανέμετε ποτέ την τιμή τους σε σταθμό εργασίας ανάπτυξης.
Οργανισμοί και Έργα
Η πρόσβαση δομείται σε τρία ιεραρχικά επίπεδα:
- Οργανισμός: Η εταιρεία ή η ομάδα σας
- Έργο: Μια λογική ομαδοποίηση (π.χ. “Production Chatbot”, “Data Analysis”)
- Κλειδί API: Συνδεδεμένο με ένα συγκεκριμένο έργο
Εάν ανήκετε σε πολλούς οργανισμούς, καθορίστε αυτόν που προτίθεστε να χρησιμοποιήσετε κατά τη δημιουργία του client:
from openai import OpenAI
# Καθορισμός του οργανισμού (χρήσιμο αν ανήκετε σε πολλούς)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Αφιερώστε χρόνο για να διαχωρίσετε τη χρήση σας σε έργα, αντί να διοχετεύετε τα πάντα μέσω ενός μοναδικού κλειδιού. Θα δείτε το όφελος στο πρώτο σημάδι προβλήματος. Κάθε έργο έχει τη δική του παρακολούθηση χρήσης, επιτρέποντάς σας να αποδίδετε το κόστος σε ένα συγκεκριμένο χαρακτηριστικό και όχι σε ένα αδιαφανές μηνιαίο σύνολο. Τα όρια ρυθμού (rate limits) διαχωρίζονται επίσης: μια νυχτερινή εργασία batch που κορεσμένο το όριό της δεν θα εμποδίσει το chatbot σας να απαντήσει στους πελάτες. Μπορείτε στη συνέχεια να αναθέσετε διαφορετικά μέλη σε κάθε έργο και, το σημαντικότερο, να ανακαλέσετε ένα compromised κλειδί χωρίς να διακόψετε άλλες εφαρμογές.
Μην Εκθέτετε Ποτέ τα Κλειδιά Σας
Ο κανόνας είναι απλός και απόλυτος: ένα κλειδί δεν εμφανίζεται ποτέ στον πηγαίο κώδικα. Η αντίθεση μεταξύ των δύο αποσπασμάτων παρακάτω μιλάει πιο δυνατά από οποιαδήποτε διάλεξη.
# ΚΑΚΟ — κλειδί ενσωματωμένο στον κώδικα
client = OpenAI(api_key="sk-proj-abc123") # ΚΙΝΔΥΝΟΣ!
# ΚΑΛΟ — μεταβλητή περιβάλλοντος
client = OpenAI() # Διαβάζει αυτόματα το OPENAI_API_KEY
# ΚΑΛΟ — αρχείο .env με python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Το συνακόλουθο αφορά το .gitignore σας, το οποίο πρέπει να εξαιρεί τα τοπικά αρχεία διαμόρφωσης πριν την πρώτη σας commit, όχι μετά. Ένα κλειδί που δημοσιεύεται και στη συνέχεια διαγράφεται παραμένει παρόν στο ιστορικό του αποθετηρίου.
# ΠΡΟΣΘΕΣΤΕ ΠΑΝΤΑ αυτές τις γραμμές στο .gitignore σας
.env
.env.local
.env.production
*.key
Τέλος, σχεδιάστε την τακτική περιστροφή (rotation) των κλειδιών, κάθε 90 ημέρες. Μπορείτε να το κάνετε αυτό χωρίς διακοπή λειτουργίας: δημιουργήστε ένα νέο κλειδί, ενημερώστε τις αναπτύξεις (deployments) σας και στη συνέχεια διαγράψτε το παλιό μόνο όταν τίποτα δεν το χρησιμοποιεί πλέον.
Επαλήθευση της Διαμόρφωσής Σας
Πριν προχωρήσετε, εκτελέστε αυτό το σενάριο. Ελέγχει την παρουσία του κλειδιού, εμφανίζει μια περικομμένη έκδοση για να επιβεβαιώσει ότι είναι το σωστό και στη συνέχεια πραγματοποιεί μια πραγματική κλήση. Επαναλάβετε αυτό το τεστ όποτε ένα περιβάλλον συμπεριφέρεται περίεργα.
from openai import OpenAI
import os
def verify_configuration():
"""Επαλήθευση ότι η διαμόρφωση του API είναι σωστή."""
# Έλεγχος για το κλειδί
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("ΣΦΑΛΜΑ: Το OPENAI_API_KEY δεν έχει οριστεί")
return False
print(f"Κλειδί εντοπίστηκε: {api_key[:8]}...{api_key[-4:]}")
# Δοκιμή σύνδεσης
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Η σύνδεση ήταν επιτυχής: {response.output_text}")
return True
except Exception as e:
print(f"ΣΦΑΛΜΑ σύνδεσης: {e}")
return False
verify_configuration()
# Αναμενόμενο αποτέλεσμα:
# Κλειδί εντοπίστηκε: sk-proj-...xxxx
# Η σύνδεση ήταν επιτυχής: OK
Βασικά σημεία
- Χρησιμοποιήστε κλειδιά έργου (
sk-proj-...) για κάθε εφαρμογή - Αποθηκεύστε τα κλειδιά σας σε μεταβλητές περιβάλλοντος, ποτέ στον κώδικα
- Οργανώστε την πρόσβασή σας με την ιεραρχία Οργανισμός → Έργο → Κλειδί
- Πραγματοποιείτε τακτική περιστροφή των κλειδιών σας (κάθε 90 ημέρες)
- Προσθέτετε πάντα το
.envστο.gitignoreσας