OpenAI మ్యూచువల్ TLS సంస్థలు తమ OpenAI API ట్రాఫిక్ కోసం అదనపు భద్రతా పొరను కాన్ఫిగర్ చేసుకోవడానికి అనుమతిస్తుంది. కాన్ఫిగర్ చేసిన తర్వాత, API రిక్వెస్ట్‌లు https://mtls.api.openai.comకి (లేదా EU డేటా రెసిడెన్సీ కస్టమర్‌ల కోసం https://mtls-eu.api.openai.comకి) చేయాలి, అలాగే సరైన API కీ మరియు క్లయింట్ సర్టిఫికేట్ అందించినప్పుడు మాత్రమే ట్రాఫిక్ అంగీకరించబడుతుంది. mTLS https://platform.openai.com Dashboardకు వర్తించదు. ఈ ఫీచర్ ప్రస్తుతం బీటాలో ఉంది.

mTLS ఇంటిగ్రేషన్‌ను ఎలా సెటప్ చేయాలి?

సెట్టింగ్‌ల నావిగేషన్ బార్‌లో, మీకు “మ్యూచువల్ TLS” ట్యాబ్ కనిపిస్తుంది.

సర్టిఫికేట్‌ను అప్‌లోడ్ చేయండి

సర్టిఫికేట్‌ను యాక్టివేట్ చేయండి

మీ సర్టిఫికేట్‌ను అప్‌లోడ్ చేసిన తర్వాత, తదుపరి దశ మీ సర్టిఫికేట్‌ను యాక్టివేట్ చేయడం. ప్రాజెక్ట్ కోసం సర్టిఫికేట్ యాక్టివేట్ అయిన తర్వాత, ఆ ప్రాజెక్ట్‌కు వెళ్లే అన్ని API రిక్వెస్ట్‌లకు సరిపోలే క్లయింట్ సర్టిఫికేట్ కూడా అవసరం అవుతుంది. ప్రాజెక్ట్‌లో అనేక సర్టిఫికేట్‌లు యాక్టివేట్ అయి ఉంటే, మీరు సరిపోలే ఏదైనా క్లయింట్ సర్టిఫికేట్‌ను పాస్ చేయవచ్చు. సంస్థ కోసం సర్టిఫికేట్ యాక్టివేట్ చేయబడితే, అది అన్ని API రిక్వెస్ట్‌లకు వర్తిస్తుంది మరియు అన్ని ప్రాజెక్ట్‌ల ద్వారా “వారసత్వంగా” పొందబడుతుంది.

CA సర్టిఫికేట్ అవసరాలు

క్రింది అవసరాలను తీర్చే PEM ఫార్మాట్‌లోని ఏ X.509 CA సర్టిఫికేట్‌నైనా మీరు అప్‌లోడ్ చేయవచ్చు:

1. మీరు ఉపయోగించాలనుకుంటున్న క్లయింట్ సర్టిఫికేట్‌లపై నేరుగా సంతకం చేస్తుంది, లేదా మీ క్లయింట్ చూపించే చెల్లుబాటు అయ్యే సర్టిఫికేట్ చైన్‌కు యాంకర్‌గా ఉంటుంది.

2. Certificate Authority, Subject Key Identifier, మరియు Authority Key Identifier (KeyIdentifier ఫార్మాట్‌లో) ఎక్స్‌టెన్షన్‌లను కలిగి ఉంటుంది

3. Key Usage: “Certificate Sign, CRL Sign” అనుమతులను కలిగి ఉంటుంది

4. 1 రోజులో గడువు ముగిసేలా సెట్ చేయబడలేదు

5. మొత్తం సర్టిఫికేట్ పరిమాణం 16kb కంటే తక్కువగా ఉండాలి.

క్లయింట్ సర్టిఫికేట్ అవసరాలు

మీ సంస్థకు సర్టిఫికేట్ చైన్ మద్దతు ప్రారంభించబడి ఉంటే, యాక్టివ్‌గా అప్‌లోడ్ చేసిన సర్టిఫికేట్ వరకు చెల్లుబాటు అయ్యే చైన్‌ను నిర్మించడానికి అవసరమైన మధ్యవర్తి సర్టిఫికేట్(ల)తో పాటు లీఫ్ క్లయింట్ సర్టిఫికేట్‌ను మీ క్లయింట్ చూపవచ్చు. లేకపోతే, క్లయింట్ సర్టిఫికేట్‌లు మీరు ముందుగానే అప్‌లోడ్ చేసిన సర్టిఫికేట్‌ల ద్వారా నేరుగా సంతకం చేయబడి ఉండాలి. ఇవి కాకుండా, మీ క్లయింట్ సర్టిఫికేట్‌లు క్రింది అవసరాలను తీర్చాలి:

1. Subject Key Identifier మరియు Authority Key Identifier ఎక్స్‌టెన్షన్‌ను (KeyIdentifier ఫార్మాట్‌లో) కలిగి ఉంటుంది

2. Key Usage: “Digital Signature, Key Encipherment” అనుమతులను కలిగి ఉంటుంది

3. Extended Key Usage: “TLS Web Client Authentication” అనుమతిని కలిగి ఉంటుంది

4. Subject Alternate Name ఎక్స్‌టెన్షన్‌ను కలిగి ఉంటుంది

API mTLS కోసం సర్టిఫికేట్ చైన్ మద్దతు

సర్టిఫికేట్ చైన్ మద్దతుతో, యాక్టివ్‌గా అప్‌లోడ్ చేసిన సర్టిఫికేట్ వరకు చెల్లుబాటు అయ్యే చైన్‌ను నిర్మించడానికి అవసరమైన మధ్యవర్తి సర్టిఫికేట్(ల)తో పాటు లీఫ్ క్లయింట్ సర్టిఫికేట్‌ను మీ క్లయింట్ చూపగలదు.

ట్రస్ట్ యాంకర్‌గా ఉపయోగించే యాక్టివ్‌గా అప్‌లోడ్ చేసిన సర్టిఫికేట్ చెల్లుబాటులో ఉన్నంత వరకు, ప్రతి కొత్త మధ్యవర్తిని అప్‌లోడ్ చేయకుండా మధ్యవర్తి సర్టిఫికేట్‌లను రొటేట్ చేయడానికి ఇది మీకు వీలు కల్పించగలదు.

సర్టిఫికేట్ చైన్ మద్దతు ప్రస్తుతం అభ్యర్థనపై అందుబాటులో ఉంది. యాక్సెస్ కోరడానికి మీ Account Directorను సంప్రదించండి లేదా సపోర్ట్ టికెట్‌ను తెరవండి.

మీ క్లయింట్ అవసరమైన అన్ని మధ్యవర్తి సర్టిఫికేట్‌లను చూపాలి. OpenAI AIA ద్వారా లేని మధ్యవర్తి సర్టిఫికేట్‌లను పొందదు. CRL మరియు OCSP తనిఖీలకు మద్దతు ఇప్పటికీ లేదు.

తరచుగా అడిగే ప్రశ్నలు

నేను API ద్వారా mTLSను కాన్ఫిగర్ చేయగలనా?

అవును — మరింత సమాచారం కోసం https://platform.openai.com/docs/api-reference/ వద్ద API సూచనను చూడవచ్చు.

ఏ ఎండ్‌పాయింట్‌లు mTLSకు మద్దతు ఇస్తాయి?

ఈ బీటా వ్యవధిలో, mTLSకు అధికారికంగా మద్దతు ఉన్నవి

• /v1/chat/completions (with all supported extensions e.g. image, audio, streaming, etc.)

• /v1/completions

• /v1/embeddings

• /v1/audio/transcriptions

• /v1/audio/speech

• /v1/files

• /v1/batches

• /v1/responses

• /v1/images

• /v1/moderations

• /v1/realtime (via server-side web sockets)

• /v1/fine_tuning

• /v1/tunnels

నా అభ్యర్థనతో క్లయింట్ సర్టిఫికేట్‌లను ఎలా పంపాలి?

cURL అభ్యర్థన కోసం, మీరు --cert మరియు --key ఎంపికలను ఉపయోగించవచ్చు (man పేజీని ఇక్కడ చూడండి). చాలా ఇతర HTTP క్లయింట్లలో కూడా క్లయింట్ సర్టిఫికేట్‌లను పాస్ చేసే మార్గాలు ఉంటాయి. ఉదాహరణలు: Pythonలో requests, JSలో fetch. మా అధికారిక SDKల ద్వారా HTTP క్లయింట్‌ను ఓవర్‌రైడ్ చేయడానికీ మేము మద్దతు ఇస్తాము — Python ఉదాహరణ కోసం ఇక్కడ చూడండి.

సర్టిఫికేట్ చైన్ మద్దతు ప్రారంభించినప్పుడు, లీఫ్ క్లయింట్ సర్టిఫికేట్‌ను మరియు అవసరమైన అన్ని మధ్యవర్తి సర్టిఫికేట్‌లను చూపించేలా మీ HTTP క్లయింట్‌ను కాన్ఫిగర్ చేయండి. ఖచ్చితమైన కాన్ఫిగరేషన్ మీ HTTP క్లయింట్‌పై ఆధారపడి ఉంటుంది.

ప్రొడక్షన్ ట్రాఫిక్‌కు mTLSను అమలు చేయడానికి ముందు, మీరు ఉపయోగిస్తున్న HTTP క్లయింట్ క్లయింట్ సర్టిఫికేట్ అభ్యర్థనలతో సరిగ్గా పనిచేస్తుందని నిర్ధారించుకోండి (కొన్ని, ఉదాహరణకు కొన్ని బ్రౌజర్లలోని WebSockets, అలా చేయవు). క్లయింట్ సర్టిఫికేట్ అభ్యర్థనలో మా సర్వర్ certificate_authorities జాబితాను అందించదని గమనించండి.

సర్టిఫికేట్‌లను ఎవరు యాక్సెస్ చేసి సవరించగలరు?

https://platform.openai.com/settings/organization/mtls Dashboard UI ద్వారా, సంస్థ యజమానులు సర్టిఫికేట్‌లను యాక్సెస్ చేసి సవరించగలరు. Admin API Key ఉన్న ఎవరైనా (https://platform.openai.com/settings/organization/admin-keys) సర్టిఫికేట్‌లను యాక్సెస్/సవరించగలరు; అయితే జాగ్రత్త — మీరు సంస్థ స్థాయిలో మ్యూచువల్ TLSను యాక్టివేట్ చేస్తే, ఈ API రిక్వెస్ట్‌లపైనా సర్టిఫికేట్‌లను అమలు చేస్తారు. అన్ని mTLS మార్పులు ఆడిట్ లాగ్‌లలో కనిపిస్తాయి.

నేను ఎన్ని సర్టిఫికేట్‌లను కలిగి ఉండవచ్చు?

ప్రతి సంస్థ గరిష్ఠంగా 50 సర్టిఫికేట్‌లను అప్‌లోడ్ చేయవచ్చు; వాటిని ప్రాజెక్ట్‌ల మధ్య షేర్ చేయవచ్చు కానీ ఇతర సంస్థలతో షేర్ చేయలేరు. మీరు ఒకేసారి 10 ప్రాజెక్ట్‌ల కోసం సర్టిఫికేట్‌ను అణు స్థాయిలో యాక్టివేట్/డీయాక్టివేట్ చేయవచ్చు. లేదా, మీ సంస్థ కోసం లేదా 1 నిర్దిష్ట ప్రాజెక్ట్ కోసం ఒకేసారి 10 సర్టిఫికేట్‌లను యాక్టివేట్/డీయాక్టివేట్ చేయవచ్చు.

నేను సర్టిఫికేట్‌లను అప్‌డేట్ చేయగలనా లేదా తొలగించగలనా?

మీరు మీ సర్టిఫికేట్‌ల పేర్లను అప్‌డేట్ చేయవచ్చు, కానీ కంటెంట్‌ను కాదు. సర్టిఫికేట్‌లు ప్రస్తుతం ఏ స్కోప్‌లోనూ యాక్టివ్‌గా లేకపోతే, మీరు వాటిని కూడా తొలగించవచ్చు.

సర్టిఫికేట్ రద్దు ఎలా పనిచేస్తుంది?

ప్రస్తుతం, మేము CRL లేదా OCSP తనిఖీలకు మద్దతు ఇవ్వము. దానికి బదులుగా మీ API కీని తొలగించడం లేదా రొటేట్ చేయడం సిఫార్సు చేసిన ప్రత్యామ్నాయం. మీరు మీ CA సర్టిఫికేట్‌లను మార్చుకోవచ్చు లేదా తక్కువ చెల్లుబాటు వ్యవధి ఉన్న క్లయింట్ సర్టిఫికేట్‌లను ఉపయోగించవచ్చు.

ఎక్కువ పొడవైన సర్టిఫికేట్ చైన్‌లను ఉపయోగించవచ్చా?

అవును, మీ సంస్థకు సర్టిఫికేట్ చైన్ మద్దతు ప్రారంభించబడి ఉంటే. OpenAI ఆ చైన్‌ను యాక్టివ్‌గా అప్‌లోడ్ చేసిన సర్టిఫికేట్ వరకు ధృవీకరించగలిగేలా, మీ క్లయింట్ లీఫ్ క్లయింట్ సర్టిఫికేట్‌ను మరియు అవసరమైన మధ్యవర్తి సర్టిఫికేట్(ల)ను చూపాలి. యాక్సెస్ కోరడానికి మీ Account Directorను సంప్రదించండి లేదా సపోర్ట్ టికెట్‌ను తెరవండి.

సిఫార్సు చేసిన సెటప్ ఏమిటి?

ఈ ఫీచర్‌ను మొదట సెటప్ చేసేటప్పుడు, అధికారిక ప్రొడక్షన్ ట్రాఫిక్‌ను సర్వ్ చేయని స్టేజింగ్ ప్రాజెక్ట్‌తో ప్రారంభించాలని మేము సిఫార్సు చేస్తున్నాము. మీ సర్టిఫికేట్‌లు మీ మెషీన్‌లపై సరిగ్గా సెటప్ చేయబడ్డాయని మరియు మీరు API ట్రాఫిక్‌ను విజయవంతంగా పంపగలరని నిర్ధారించుకోవడానికి ఈ అవకాశాన్ని ఉపయోగించండి. ఇది కాకుండా, మీ అవసరాలను ఉత్తమంగా అర్థం చేసుకోవడానికి మీ సంస్థ భద్రతా బృందంతో సంప్రదించాలని మేము సిఫార్సు చేస్తున్నాము.

అదనపు మద్దతు

మీరు డ్యాష్‌బోర్డ్ మరియు API ద్వారా mTLS ఫీచర్‌ను పూర్తిగా స్వయంగా నిర్వహించవచ్చు. అయితే, మొదట mTLSని షాడో మోడ్‌లో ప్రారంభించాలనుకుంటే, దయచేసి మీ అకౌంట్ డైరెక్టర్‌ను సంప్రదించండి లేదా ఈ పేజీ కుడి దిగువ మూలలో కొత్త చాట్‌ను ప్రారంభించి సపోర్ట్ టికెట్‌ను తెరవండి.

అనుబంధం: పరిభాష

• CA సర్టిఫికేట్: క్లయింట్ సర్టిఫికేట్‌లను ధృవీకరించడానికి ఉపయోగించే మీ విశ్వసనీయ సర్టిఫికేట్‌లలో ఒకటి. అది మీరు అభ్యర్థనలతో పంపే క్లయింట్ సర్టిఫికేట్‌లపై నేరుగా సంతకం చేయవచ్చు లేదా మీ క్లయింట్ చూపించే సర్టిఫికేట్ చైన్‌కు యాంకర్‌గా ఉండవచ్చు. మీరు self-signed CA సర్టిఫికేట్‌లను ఉపయోగించవచ్చు.

• సర్టిఫికేట్‌ను అప్‌లోడ్ చేయడం: మీ ఖాతాకు CA సర్టిఫికేట్‌ను జోడించడం. ఇది ఇంకా mTLS కోసం ఎక్కడా అమలు చేయబడదు, కానీ మీరు దీనిని కాన్ఫిగర్ చేయడం ప్రారంభించవచ్చు.

• పరిధి: ఒక నిర్దిష్ట ప్రాజెక్ట్ లేదా మీ మొత్తం సంస్థ.

• ఒక పరిధిలో CA సర్టిఫికేట్‌ను యాక్టివేట్ చేయడం: ఆ పరిధి కోసం ప్రత్యేకంగా mTLSను ప్రారంభిస్తుంది, అలాగే అన్ని API-key ఆధారిత అభ్యర్థనలు యాక్టివ్ CA సర్టిఫికేట్‌తో ధృవీకరించగలిగే క్లయింట్ సర్టిఫికేట్‌ను కలిగి ఉండాలి.

• ఒక పరిధిలో CA సర్టిఫికేట్‌ను డీయాక్టివేట్ చేయడం: ఈ పరిధిలో అభ్యర్థనలను ధృవీకరించడానికి ఈ సర్టిఫికేట్ వినియోగాన్ని నిలిపివేస్తుంది. ఆ పరిధికి మీ వద్ద ఎలాంటి సర్టిఫికేట్‌లు మిగలకపోతే, mTLS వాస్తవానికి ఆఫ్ అవుతుంది.

• సర్టిఫికేట్‌ను వారసత్వంగా పొందడం: మీరు మీ సంస్థ కోసం సర్టిఫికేట్‌ను యాక్టివేట్ చేస్తే, అది అన్ని ప్రాజెక్టులకూ యాక్టివేట్ అవుతుంది.