OpenAI Mutual TLS સંસ્થાઓને તેમના OpenAI API ટ્રાફિક માટે સુરક્ષાનું વધારાનું સ્તર કન્ફિગર કરવાની મંજૂરી આપે છે. કન્ફિગર થયા પછી, API વિનંતીઓ https://mtls.api.openai.com પર (અથવા EU ડેટા રેસિડન્સી ગ્રાહકો માટે https://mtls-eu.api.openai.com પર) કરવી જોઈએ અને ટ્રાફિક ત્યારે જ સ્વીકારવામાં આવશે જ્યારે યોગ્ય API key અને ક્લાયન્ટ પ્રમાણપત્ર પ્રદાન કરવામાં આવે. mTLS https://platform.openai.com ડેશબોર્ડ પર લાગુ પડતું નથી. આ સુવિધા હાલમાં બીટામાં છે.
હું mTLS ઇન્ટિગ્રેશન કેવી રીતે સેટ કરું?
સેટિંગ્સ નેવિગેશન બાર પર, તમને “મ્યુચ્યુઅલ TLS” ટૅબ દેખાશે.
પ્રમાણપત્ર અપલોડ કરો
પ્રમાણપત્ર સક્રિય કરો
તમારું પ્રમાણપત્ર અપલોડ કર્યા પછી, આગળનું પગલું તમારા પ્રમાણપત્રને સક્રિય કરવાનું છે. પ્રોજેક્ટ માટે પ્રમાણપત્ર સક્રિય થઈ જાય પછી, તે પ્રોજેક્ટ પર જતી તમામ API વિનંતીઓ માટે સંબંધિત ક્લાયન્ટ પ્રમાણપત્ર પણ જરૂરી બનશે. જો કોઈ પ્રોજેક્ટમાં અનેક પ્રમાણપત્રો સક્રિય હોય, તો તમે કોઈપણ સંબંધિત ક્લાયન્ટ પ્રમાણપત્ર પાસ કરી શકો છો. જો સંસ્થા માટે કોઈ પ્રમાણપત્ર સક્રિય હોય, તો તે તમામ API વિનંતીઓ પર લાગુ થશે અને તમામ પ્રોજેક્ટ્સ દ્વારા “વારસામાં” મેળવાશે.
CA પ્રમાણપત્રની આવશ્યકતાઓ
તમે નીચેની આવશ્યકતાઓ પૂર્ણ કરતું PEM ફોર્મેટમાં કોઈપણ X.509 CA પ્રમાણપત્ર અપલોડ કરી શકો છો:
તમે ઉપયોગ કરવા માંગો છો તે ક્લાયન્ટ પ્રમાણપત્રો પર સીધી સહી કરે છે, અથવા તમારા ક્લાયન્ટ દ્વારા રજૂ કરાયેલી માન્ય પ્રમાણપત્ર ચેઇનને એન્કર કરે છે.
તેમાં Certificate Authority, Subject Key Identifier, અને Authority Key Identifier (KeyIdentifier ફોર્મેટમાં) એક્સ્ટેન્શન હોય છે
તેમાં Key Usage: “Certificate Sign, CRL Sign” પરવાનગીઓ હોય છે
તે 1 દિવસની અંદર સમાપ્ત થવા માટે સેટ ન હોય
કુલ પ્રમાણપત્ર કદ 16kb કરતાં ઓછું હોવું જોઈએ.
ક્લાયન્ટ પ્રમાણપત્રની આવશ્યકતાઓ
જો તમારી સંસ્થા માટે પ્રમાણપત્ર ચેઇન સપોર્ટ સક્ષમ હોય, તો તમારો ક્લાયન્ટ સક્રિય અપલોડ કરાયેલા પ્રમાણપત્ર સુધી માન્ય ચેઇન બનાવવા માટે જરૂરી લીફ ક્લાયન્ટ પ્રમાણપત્ર અને મધ્યવર્તી પ્રમાણપત્રો રજૂ કરી શકે છે. નહીંતર, ક્લાયન્ટ પ્રમાણપત્રો પર તમે અગાઉથી અપલોડ કરેલા પ્રમાણપત્રો દ્વારા સીધી સહી થયેલી હોવી જોઈએ. આ સિવાય, તમારા ક્લાયન્ટ પ્રમાણપત્રોએ નીચેની આવશ્યકતાઓ પૂર્ણ કરવી આવશ્યક છે:
તેમાં Subject Key Identifier અને Authority Key Identifier એક્સ્ટેન્શન (KeyIdentifier ફોર્મેટમાં) હોય છે
તેમાં Key Usage: “Digital Signature, Key Encipherment” પરવાનગીઓ હોય છે
તેમાં Extended Key Usage: “TLS Web Client Authentication” પરવાનગી હોય છે
તેમાં 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 વિકલ્પોનો ઉપયોગ કરી શકો છો (મેન પેજ અહીં જુઓ). મોટાભાગના અન્ય HTTP ક્લાયન્ટમાં પણ ક્લાયન્ટ પ્રમાણપત્રો પાસ કરવાની રીતો હોય છે. ઉદાહરણો: Python માં requests, JS માં fetch. અમારા સત્તાવાર SDK દ્વારા, અમે HTTP ક્લાયન્ટને ઓવરરાઇડ કરવાનું પણ સપોર્ટ કરીએ છીએ — Python ઉદાહરણ માટે અહીં જુઓ.
જ્યારે પ્રમાણપત્ર ચેઇન સપોર્ટ સક્ષમ હોય, ત્યારે તમારા HTTP ક્લાયન્ટને લીફ ક્લાયન્ટ પ્રમાણપત્ર અને બધા જરૂરી મધ્યવર્તી પ્રમાણપત્રો રજૂ કરવા માટે ગોઠવો. ચોક્કસ ગોઠવણી તમારા HTTP ક્લાયન્ટ પર આધાર રાખે છે.
પ્રોડક્શન ટ્રાફિક માટે mTLS લાગુ કરતા પહેલાં, ખાતરી કરો કે તમે ઉપયોગમાં લેતા HTTP ક્લાયન્ટનું ક્લાયન્ટ પ્રમાણપત્ર વિનંતીઓ સાથેનું વર્તન યોગ્ય છે (કેટલાક, જેમ કે ચોક્કસ બ્રાઉઝરમાં WebSockets, યોગ્ય નથી). નોંધો કે અમારું સર્વર ક્લાયન્ટ પ્રમાણપત્ર વિનંતીમાં certificate_authorities સૂચિ પ્રદાન કરતું નથી.
પ્રમાણપત્રોને કોણ ઍક્સેસ અને ફેરફાર કરી શકે?
https://platform.openai.com/settings/organization/mtls ડેશબોર્ડ UI દ્વારા, સંસ્થાના માલિકો પ્રમાણપત્રોને ઍક્સેસ અને ફેરફાર કરી શકે છે. Admin API Key ધરાવનાર કોઈપણ વ્યક્તિ (https://platform.openai.com/settings/organization/admin-keys) પણ પ્રમાણપત્રોને ઍક્સેસ/ફેરફાર કરી શકે છે, જોકે સાવચેત રહો — જો તમે સંસ્થા સ્તરે Mutual TLS સક્રિય કરો છો, તો તમે આ API વિનંતીઓ પર પણ પ્રમાણપત્રો લાગુ કરશો. બધા mTLS ફેરફારો ઓડિટ લોગ્સમાં દેખાય છે.
મારી પાસે કેટલા પ્રમાણપત્રો હોઈ શકે?
દરેક સંસ્થા 50 સુધી પ્રમાણપત્રો અપલોડ કરી શકે છે, જેને પ્રોજેક્ટ્સમાં શેર કરી શકાય છે પરંતુ અન્ય સંસ્થાઓ સાથે નહીં. તમે એક સમયે 10 પ્રોજેક્ટ્સ માટે કોઈ પ્રમાણપત્રને એટોમિક રીતે સક્રિય/નિષ્ક્રિય કરી શકો છો. વૈકલ્પિક રીતે, તમે તમારી સંસ્થા માટે અથવા 1 ચોક્કસ પ્રોજેક્ટ માટે એક સમયે 10 પ્રમાણપત્રો સક્રિય/નિષ્ક્રિય કરી શકો છો.
શું હું પ્રમાણપત્રો અપડેટ અથવા કાઢી નાખી શકું?
તમે તમારા પ્રમાણપત્રોના નામ અપડેટ કરી શકો છો, પરંતુ સામગ્રી નહીં. જો પ્રમાણપત્રો હાલમાં કોઈપણ સ્કોપમાં સક્રિય ન હોય, તો તમે તેમને કાઢી પણ શકો છો.
પ્રમાણપત્ર રદ કરવું કેવી રીતે કાર્ય કરે છે?
હાલમાં, અમે CRL અથવા OCSP ચેક્સને સપોર્ટ કરતા નથી. તેના બદલે તમારી API કી કાઢી નાખવી અથવા રોટેટ કરવી ભલામણ કરાયેલ વિકલ્પ છે. તમે તમારા CA પ્રમાણપત્રો પણ બદલી શકો છો અથવા ટૂંકી માન્યતા અવધિવાળા ક્લાયન્ટ પ્રમાણપત્રોનો ઉપયોગ કરી શકો છો.
શું હું વધુ લાંબી પ્રમાણપત્ર ચેઇનનો ઉપયોગ કરી શકું?
હા, જો તમારી સંસ્થા માટે પ્રમાણપત્ર ચેઇન સપોર્ટ સક્ષમ હોય. તમારા ક્લાયન્ટે લીફ ક્લાયન્ટ પ્રમાણપત્ર અને કોઈપણ જરૂરી મધ્યવર્તી પ્રમાણપત્રો રજૂ કરવા જરૂરી છે, જેથી OpenAI ચેઇનને સક્રિય અપલોડ કરાયેલા પ્રમાણપત્ર સુધી ચકાસી શકે. ઍક્સેસની વિનંતી કરવા માટે તમારા Account Director નો સંપર્ક કરો અથવા સપોર્ટ ટિકિટ ખોલો.
ભલામણ કરેલ સેટઅપ શું છે?
આ સુવિધાનું પ્રારંભિક સેટઅપ કરતી વખતે, અમે એવા સ્ટેજિંગ પ્રોજેક્ટથી શરૂ કરવાની ભલામણ કરીએ છીએ જે સત્તાવાર પ્રોડક્શન ટ્રાફિક સેવા આપતો ન હોય. તમારા પ્રમાણપત્રો તમારા મશીનો પર યોગ્ય રીતે સેટ થયા છે અને તમે API ટ્રાફિક સફળતાપૂર્વક મોકલી શકો છો તેની ખાતરી કરવા માટે આ તકનો ઉપયોગ કરો. આ સિવાય, તમારી જરૂરિયાતોને શ્રેષ્ઠ રીતે સમજવા માટે અમે તમારી સંસ્થાની સુરક્ષા ટીમ સાથે સલાહ લેવાની ભલામણ કરીએ છીએ.
વધારાનો સપોર્ટ
તમે ડેશબોર્ડ અને API દ્વારા mTLS સુવિધાને સંપૂર્ણપણે સ્વ-સેવા રૂપે વાપરી શકો છો. જો કે, જો તમે શરૂઆતમાં શેડો મોડમાં mTLS સક્ષમ કરવા માંગતા હો, તો કૃપા કરીને તમારા એકાઉન્ટ ડિરેક્ટરનો સંપર્ક કરો અથવા આ પેજના નીચે-જમણા ખૂણે નવી ચેટ શરૂ કરીને સપોર્ટ ટિકિટ ખોલો.
પરિશિષ્ટ: શબ્દાવલી
CA પ્રમાણપત્ર: ક્લાયન્ટ પ્રમાણપત્રો ચકાસવા માટે ઉપયોગમાં લેવાતા તમારા વિશ્વસનીય પ્રમાણપત્રોમાંથી એક. તે તમે વિનંતીઓ સાથે મોકલો છો તે ક્લાયન્ટ પ્રમાણપત્રો પર સીધી સહી કરી શકે છે અથવા તમારા ક્લાયન્ટ દ્વારા રજૂ કરાયેલી પ્રમાણપત્ર ચેઇનને એન્કર કરી શકે છે. તમે સ્વ-હસ્તાક્ષરિત CA પ્રમાણપત્રોનો ઉપયોગ કરી શકો છો.
પ્રમાણપત્ર અપલોડ કરો: તમારા એકાઉન્ટમાં CA પ્રમાણપત્ર ઉમેરવું. તે હજી mTLS માટે ક્યાંય લાગુ કરવામાં આવતું નથી, પરંતુ તમે તેને ગોઠવવાનું શરૂ કરી શકો છો.
સ્કોપ: ચોક્કસ પ્રોજેક્ટ અથવા તમારી સંપૂર્ણ સંસ્થા.
સ્કોપ પર CA પ્રમાણપત્ર સક્રિય કરો: તે ખાસ તે સ્કોપ માટે mTLS સક્ષમ કરે છે, અને API કી આધારિત બધી વિનંતીઓમાં એવો ક્લાયન્ટ પ્રમાણપત્ર શામેલ હોવો જોઈએ જે સક્રિય CA પ્રમાણપત્ર સામે ચકાસી શકાય.
સ્કોપ પર CA પ્રમાણપત્ર નિષ્ક્રિય કરો: આ સ્કોપ પર વિનંતીઓ ચકાસવા માટે આ પ્રમાણપત્રનો ઉપયોગ અક્ષમ કરે છે. જો સ્કોપ માટે તમારા પાસે કોઈ પ્રમાણપત્ર બાકી ન હોય, તો mTLS અસરકારક રીતે બંધ થઈ જાય છે.
પ્રમાણપત્ર વારસામાં મળવું: જો તમે તમારી સંસ્થા માટે કોઈ પ્રમાણપત્ર સક્રિય કરો છો, તો તે બધા પ્રોજેક્ટ માટે પણ સક્રિય થશે.