Πιστοποίηση και Ασφάλεια
Σε αυτήν τη σελίδα
Μάθημα ξαναγράφηκε στις 3 Νοεμβρίου 2026 με βάση την τεκμηρίωση των προσθέτων Authentication και Security & Privacy της OpenAI. Η προηγούμενη έκδοση περιέγραφε την πιστοποίηση μέσω κλειδιού API και μια διαμόρφωση
authσε ένα ανύπαρκτο manifest· το ChatGPT δεν μπορεί να παρουσιάσει προσαρμοσμένο κλειδί API και ακολουθεί αντ’ αυτού τη ροή εξουσιοδότησης που ορίζεται στην προδιαγραφή MCP (OAuth 2.1). Πηγές: Authentication · Security & Privacy.
Ποιοι χρειάζεται να πιστοποιηθούν
Πολλοί διακομιστές MCP μπορούν να λειτουργούν σε λειτουργία μόνο ανάγνωσης ανώνυμα. Ωστόσο, οποιοσδήποτε διακομιστής εκθέτει δεδομένα συγκεκριμένα για τον χρήστη ή εκτελεί εγγραφές πρέπει να πιστοποιεί τον χρήστη. Η σύμβαση εξουσιοδότησης ακολουθεί την προδιαγραφή MCP, η οποία είναι ίδια στο ChatGPT και στο Codex: μια ροή OAuth 2.1 που εμπλέκει τρεις φορείς.
- Ο διακομιστής πόρων: Ο δικός σας διακομιστής MCP, ο οποίος εκθέτει εργαλεία και επαληθεύει το διακριτικό πρόσβασης σε κάθε αίτημα.
- Ο διακομιστής εξουσιοδότησης: Ο πάροχος ταυτότητάς σας, ο οποίος εκδίδει διακριτικά και δημοσιεύει τα μεταδεδομένα ανακάλυψής του.
- Ο πελάτης: Ο οικοδεσπότης της OpenAI (ChatGPT ή Codex), που ενεργεί εξ ονόματος του χρήστη.
Η OpenAI συνιστά ανεπιφύλακτα να βασιστείτε σε έναν καθιερωμένο πάροχο ταυτότητας αντί να χτίσετε την πιστοποίηση από την αρχή· η τεκμηρίωσή τους επισημαίνει συγκεκριμένα τους Auth0 και Stytch.
Τι απαιτεί η προδιαγραφή
Μεταδεδομένα Προστατευμένου Πόρου. Ο διακομιστής MCP σας πρέπει να δημοσιεύει ένα έγγραφο, για παράδειγμα στο https://your-mcp.example.com/.well-known/oauth-protected-resource, που να περιέχει το κανονικό του αναγνωριστικό (resource), τους διακομιστές εξουσιοδότησής του (authorization_servers) και προαιρετικά τις υποστηριζόμενες εμβέλειες (scopes_supported). Όταν φτάνει ένα αίτημα χωρίς έγκυρη πιστοποίηση, ο διακομιστής πρέπει να απαντά με 401 Unauthorized και μια κεφαλίδα που δείχνει σε αυτό το έγγραφο:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Μεταδεδομένα Διακομιστή Εξουσιοδότησης, που βρίσκονται στο /.well-known/oauth-authorization-server ή /.well-known/openid-configuration, πρέπει να περιλαμβάνουν τον εκδότη (issuer), τα τελικά σημεία εξουσιοδότησης και διακριτικών, και το code_challenge_methods_supported που περιέχει το S256. Χωρίς αυτό, ο διακομιστής MCP δεν υποστηρίζεται, καθώς το PKCE είναι υποχρεωτικό.
Η παράμετρος resource από άκρο σε άκρο. Το ChatGPT προσθέτει resource=… στα αιτήματα εξουσιοδότησης και διακριτικών. Ο διακομιστής εξουσιοδότησής σας πρέπει να αντιγράψει αυτό στην τιμή του διακριτικού (συχνά ως δήλωση aud), και ο διακομιστής MCP σας πρέπει να απορρίπτει οποιοδήποτε διακριτικό δεν έχει εκδοθεί συγκεκριμένα για αυτόν.
Πώς το ChatGPT εγγράφεται ως πελάτης
Συνυπάρχουν τρεις μέθοδοι. Η προτιμώμενη μέθοδος είναι το CIMD (Client ID Metadata Documents): το ChatGPT χρησιμοποιεί το URL ενός εγγράφου μεταδεδομένων που φιλοξενείται σε HTTPS ως client_id, το οποίο διαβάζει ο διακομιστής εξουσιοδότησής σας. Ενεργοποιήστε το δημοσιεύοντας client_id_metadata_document_supported: true. Το ChatGPT υποστηρίζει δύο μεθόδους πιστοποίησης στο τελικό σημείο διακριτικών: none (δημόσιος πελάτης προστατευμένος από PKCE) και private_key_jwt (υπογεγραμμένη βεβαίωση επαληθεύσιμη με το δημόσιο κλειδί που δημοσιεύει το ChatGPT). Η Δυναμική Εγγραφή Πελάτη (DCR) παραμένει δυνατή εάν δημοσιεύσετε ένα registration_endpoint: το ChatGPT εγγράφεται μία φορά ανά σύνδεση και επαναχρησιμοποιεί αυτόν τον πελάτη. Ένας προκαθορισμένος πελάτης OAuth είναι η τρίτη επιλογή.
Όσον αφορά τις ανακατευθύνσεις, αντιγράψτε το ακριβές URI που εμφανίζεται στη σελίδα διαχείρισης διακομιστή MCP στο ChatGPT στη λίστα επιτρεπόμενων του διακομιστή εξουσιοδότησής σας. Αυτό το URI εξαρτάται από την υποστήριξη της Αναγνώρισης Εκδότη (RFC 9207, η παράμετρος iss που επιστρέφεται σε κάθε απόκριση εξουσιοδότησης).
Η ροή προς τον χρήστη
- Το ChatGPT διαβάζει τα μεταδεδομένα προστατευμένου πόρου του διακομιστή σας.
- Προσδιορίζει τον εαυτό του ως πελάτη OAuth (μέσω CIMD, DCR ή προκαθορισμένου πελάτη).
- Κατά την πρώτη κλήση σε ένα προστατευμένο εργαλείο, ξεκινά τη ροή κωδικού εξουσιοδότησης + PKCE: ο χρήστης συνδέεται και δίνει τη συγκατάθεσή του για τις ζητούμενες εμβέλειες.
- Το ChatGPT ανταλλάσσει τον κωδικό με ένα διακριτικό και το επισυνάπτει σε επόμενα αιτήματα MCP (
Authorization: Bearer …). - Ο διακομιστής σας επαληθεύει το διακριτικό σε κάθε αίτημα πριν εκτελέσει το εργαλείο.
Δήλωση ποια εργαλεία απαιτούν λογαριασμό
Το ChatGPT εμφανίζει τη διεπαφή σύνδεσης λογαριασμού μόνο εάν ο διακομιστής σας σηματοδοτήσει ότι το OAuth είναι διαθέσιμο ή απαιτείται. Αυτό απαιτεί και τα δύο μέρη: μεταδεδομένα και σφάλμα χρόνου εκτέλεσης.
Πρώτον, τα μεταδεδομένα: κάθε εργαλείο δηλώνει την πολιτική του στο _meta.securitySchemes. Το noauth σημαίνει ότι μπορεί να κληθεί ανώνυμα, ενώ το oauth2 απαιτεί διακριτικό με τις υποδεικνυόμενες εμβέλειες. Η δήλωση και των δύο σηματοδοτεί ότι το εργαλείο μπορεί να ξεκινήσει χωρίς λογαριασμό, αλλά η σύνδεση ξεκλειδώνει περισσότερη λειτουργικότητα. Δηλώστε το ανά εργαλείο, ακόμα και αν ολόκληρος ο διακομιστής ακολουθεί την ίδια πολιτική.
server.registerTool(
"create_doc",
{
title: "Create Document",
description: "Creates a new document in the user's account.",
inputSchema: { title: z.string().min(1) },
_meta: { securitySchemes: [{ type: "oauth2", scopes: ["docs.write"] }] },
},
async ({ title }, extra) => {
const token = await verifyToken(extra); // signature, iss, aud, exp, scopes
if (!token) {
return {
isError: true,
content: [{ type: "text", text: "Login required to create a document." }],
_meta: {
"mcp/www_authenticate": [
'Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", error="insufficient_scope", error_description="Link your account to continue"',
],
},
};
}
// … create document for token.sub
}
);
Δεύτερον, το σφάλμα χρόνου εκτέλεσης: όταν λείπει το διακριτικό ή είναι άκυρο, το εργαλείο πρέπει να επιστρέφει ένα αποτέλεσμα σφάλματος που περιέχει το _meta["mcp/www_authenticate"] με τις παραμέτρους error και error_description. Αυτό το περιεχόμενο είναι που ενεργοποιεί πραγματικά τη διεπαφή σύνδεσης. Το verifyToken είναι η συνάρτηση επαλήθευσής σας· τα SDK MCP για Python και TypeScript παρέχουν βοηθήματα για τη συγγραφή του.
Επαλήθευση κάθε διακριτικού
Μόλις ολοκληρωθεί η ροή, το ChatGPT επισυνάπτει το διακριτικό ως έχει σε κάθε αίτημα. Αντιμετωπίστε το ως μη έμπιστο και εκτελέστε μόνοι σας όλες τις τυπικές επαληθεύσεις διακομιστή πόρων: επαλήθευση υπογραφής χρησιμοποιώντας κλειδιά που δημοσιεύονται από τον διακομιστή εξουσιοδότησής σας (JWKS) και τη δήλωση iss· χρονική εγκυρότητα (exp, nbf); κοινό (aud ή resource) και απαιτούμενες εμβέλειες· ακολουθούμενες από τους δικούς σας επιχειρηματικούς κανόνες. Σε περίπτωση αποτυχίας: επιστρέψτε 401 και μια κεφαλίδα WWW-Authenticate, η οποία επανεκκινεί τη ροή OAuth.
Αναγνώριση του ChatGPT ως πελάτη
Για να επαληθεύσετε ότι ένα αίτημα προέρχεται πραγματικά από το ChatGPT, υπάρχουν δύο μέθοδοι. Το ChatGPT παρουσιάζει ένα διαχειριζόμενο από την OpenAI πιστοποιητικό πελάτη κατά τη διάρκεια της σύνδεσης TLS (mTLS). Επαληθεύστε ότι αλυσιδώνεται στην ενδιάμεση αρχή που δημοσιεύεται από την OpenAI, ότι είναι έγκυρο για πιστοποίηση πελάτη και ότι έχει το dnsName mtls.prod.connectors.openai.com. Μην καρφιτσώνετε το δακτυλικό αποτύπωμα του πιστοποιητικού φύλλου, καθώς η OpenAI μπορεί να το περιστρέψει. Μπορείτε επίσης να κάνετε φιλτράρισμα με βάση τα δημοσιευμένα εύρη διευθύνσεων IP. Το mTLS πιστοποιεί το ChatGPT· το OAuth συνεχίζει να πιστοποιεί τον χρήστη.
Το ChatGPT δεν υποστηρίζει δικαιώματα μηχανής προς μηχανή (client credentials, λογαριασμοί υπηρεσίας, βεβαιώσεις JWT bearer), προσαρμοσμένα κλειδιά API ή πιστοποιητικά mTLS που παρέχονται από τον πελάτη.
Αρχές ασφαλείας της OpenAI
- Ελάχιστο προνόμιο: Ζητήστε μόνο τις εμβέλειες, την αποθήκευση και την πρόσβαση στο δίκτυο που είναι απαραίτητες.
- Ρητή συγκατάθεση: Οι χρήστες πρέπει να κατανοούν πότε συνδέουν έναν λογαριασμό ή χορηγούν πρόσβαση εγγραφής· χρησιμοποιήστε επιβεβαιώσεις οικοδεσπότη για καταστροφικές ενέργειες.
- Άμυνα σε βάθος: Υποθέστε ότι οι ενέσεις προτροπών και οι κακόβουλες είσοδοι θα φτάσουν στον διακομιστή σας. Επικυρώστε όλες τις εισόδους στην πλευρά του διακομιστή, ακόμη και εκείνες που παρέχονται από το μοντέλο, και διατηρήστε αρχεία ελέγχου.
Όσον αφορά τα δεδομένα: συμπεριλάβετε μόνο ό,τι χρειάζεται το αίτημα στο structuredContent, δημοσιεύστε μια πολιτική διατήρησης, τιμήστε τα αιτήματα διαγραφής και αποκρύψτε τα προσωπικά δεδομένα στα αρχεία καταγραφής. Όσον αφορά τη διεπαφή: το στοιχείο εκτελείται σε ένα απομονωμένο iframe υπό μια αυστηρή Πολιτική Ασφαλείας Περιεχομένου, χωρίς πρόσβαση στα window.alert, window.prompt, window.confirm ή navigator.clipboard. Όσον αφορά τις λειτουργίες: διεξάγετε έλεγχο ασφαλείας πριν από την κυκλοφορία, ειδοποιήστε για επαναλαμβανόμενες αποτυχίες πιστοποίησης και διατηρήστε τις εξαρτήσεις ενημερωμένες.
Δοκιμή πιστοποίησης
Ξεκινήστε με έναν χώρο ανάπτυξης (tenant) που εκδίδει διακριτικά μικρής διάρκειας, περιορίστε την πρόσβαση σε αξιόπιστους δοκιμαστές πριν ανοίξετε σε όλους και σχεδιάστε για ανάκληση, ανανέωση και αλλαγές εμβέλειας. Αντιμετωπίστε ένα λείπον ή ληγμένο διακριτικό ως έλλειψη πιστοποίησης, παρέχοντας ένα χρήσιμο μήνυμα σφάλματος. Οι ρυθμίσεις Auth στο MCP Inspector σας επιτρέπουν να εντοπίσετε τη ροή OAuth βήμα προς βήμα για να δείτε πού αποτυγχάνει.
Βασικά σημεία
- Ιδιωτικά δεδομένα ή εγγραφές: OAuth 2.1 σύμφωνα με την προδιαγραφή MCP, με PKCE
S256 - Ο διακομιστής δημοσιεύει μεταδεδομένα προστατευμένου πόρου και απαντά με
401+WWW-Authenticate - Το CIMD είναι η προτιμώμενη μέθοδος εγγραφής· το DCR και οι προκαθορισμένοι πελάτες παραμένουν επιλογές
- Διεπαφή σύνδεσης:
securitySchemesανά εργαλείο και ένα σφάλμα που περιέχει_meta["mcp/www_authenticate"] - Επαληθεύστε κάθε διακριτικό σε κάθε αίτημα· το mTLS αναγνωρίζει το ChatGPT, το OAuth αναγνωρίζει τον χρήστη