Мақсаты
Бұл нұсқаулық әкімшілер мен IT топтарына ChatGPT немесе Платформа аккаунттарында SSO (бірыңғай кіру) конфигурацияламас бұрын ескеру қажет ақпаратты беруге арналған. SSO (бірыңғай кіру) Business, Enterprise және Edu клиенттері үшін қолжетімді.
Негізгі архитектура және терминология
Қазіргі уақытта SSO (бірыңғай кіру) ChatGPT үшін де, API платформасы үшін де SAML аутентификациясы арқылы қолдау көрсетіледі.
Жұмыс кеңістігі ChatGPT инстанциясын білдіреді
Ұйым API платформасының инстанциясын білдіреді
Сәйкестендіру провайдері (IdP) цифрлық сәйкестендіруді басқару үшін пайдаланатын қызметіңізді білдіреді. Біз SAML қолдайтын барлық IdP арқылы қосылымдарды қолдаймыз. Біз қосылған ең жиі кездесетін IdP-тердің кейбірі:
Okta
Azure Active Directory/Entra ID
Google Workspace
Duo
Қолдау көрсетілетін IdP-тердің толық тізімін WorkOS-тың Интеграциялар бетінен қараңыз. Біз осы беттегі SAML немесе OIDC арқылы қосыла алатын барлық үшінші тарап интеграцияларын қолдаймыз.
Қазіргі уақытта әрбір ChatGPT жұмыс кеңістігіне сәйкес Платформа ұйымы байланыстырылған. Бұл Enterprise Платформасының «Жалпы» бетінде табатын Organization ID (org-id) Enterprise ChatGPT жұмыс кеңістігіңізге байланыстырылған сол Organization ID (org-id) екенін білдіреді. Нәтижесінде жұмыс кеңістігіңіз бен ұйымыңыз бір аутентификация қабатын ортақ пайдаланады:
Осы архитектураға байланысты ескеретін бірнеше маңызды жайт бар:
Бір Organization ID (org-id) тек бір IdP конфигурациясын ғана қолдай алады.
Доменді растаулар және SAML SSO (бірыңғай кіру) параметрлері ChatGPT пен API платформасы арасында ортақ пайдаланылады.
SSO (бірыңғай кіру) ChatGPT пен API платформасында бөлек қосылуы керек. Алайда оны біреуінде конфигурациялағаннан кейін, екіншісіндегі «баптау» негізінен тек қосқышты қосу және қажет болса, IdP ішінде бетбелгі қолданбасын қосумен шектеледі.
SSO (бірыңғай кіру) бойынша жұмысты бастау
Аккаунтыңызда SSO (бірыңғай кіру) конфигурацияламас бұрын, алдымен OpenAI-дың SSO (бірыңғай кіру) функциясына қатысты негізгі ұғымдарды түсіну маңызды.
Жалпы сәйкестендіру терминологиясы
Қамтамасыз ету OpenAI пайдаланушылар контекстінде қамтамасыз ету туралы айтқанда, біз нақты шақыруларды қамтамасыз етуді меңзейміз. Біз пайдаланушы аккаунттарын жасауды қамтамасыз етуді тікелей қолдамаймыз. Шақыруларды мына жолдармен қамтамасыз етуге болады:
SCIM (ChatGPT SCIM интеграциясында да, API платформасының SCIM интеграциясында да қолдау көрсетіледі)
ChatGPT немесе API платформасының «Мүшелер» беті
Аккаунтты автоматты жасау
Шақырулар API
Шақыруларды қамтамасыз ету — SSO (бірыңғай кіру) арқылы орындалатын аутентификациядан бөлек қадам.
Аутентификация – «Сіз өзіңіз айтқан адамсыз ба?»
Мысал: IdP пайдаланушыны біздің қызметімізде аутентификациялайды, сондықтан кірген кезде оның өзі айтқан адам екенін білеміз.
Авторизация – «Сізге не істеуге немесе нені көруге рұқсат етілген?»
Мысал: IdP сізді аутентификациялағаннан кейін, біз сіздің қай ChatGPT жұмыс кеңістігіне мүше екеніңізді анықтаймыз.
OpenAI SSO (бірыңғай кіру) параметрлерімен танысу
Доменді растау Бұл SSO (бірыңғай кіру) және аккаунтты автоматты жасау мүмкіндігін қосу үшін міндетті шарт. Қарапайым айтқанда: «Бұл домен сізге тиесілі ме?»
chatgpt.com немесе platform.openai.com арқылы кіргенде және SSO (бірыңғай кіру) да бапталған болса, расталған домен пайдаланушыны біздің құпиясөз бетіне ме, әлде оның IdP-іне ме бағыттау керектігін анықтайды
Жұмыс кеңістігіңізде домен расталғаннан кейін, сол доменнен электрондық поштасы бар және жұмыс кеңістігіне шақырылған кез келген пайдаланушы келесі кіргенде жеке аккаунтын біріктіруге шақырылады.
ChatGPT аутентификациясы доменге ЖӘНЕ жұмыс кеңістігіне негізделеді: домен расталып, жұмыс кеңістігінде SSO (бірыңғай кіру) қосылған кезде, сол жұмыс кеңістігіндегі домені ортақ пайдаланушылар ғана SSO (бірыңғай кіру) қызметіне бағытталады. Домені ортақ, бірақ жұмыс кеңістігінің бөлігі ЕМЕС пайдаланушылар (яғни доменіңіздегі Free, Plus, Pro немесе Team аккаунт пайдаланушылары) электрондық пошта/құпиясөз немесе әлеуметтік әдіс арқылы кіруді жалғастырады.
Платформа аутентификациясы доменге негізделеді: домен расталып, SSO (бірыңғай кіру) қосылған кезде, сол домен астындағы барлық Платформа пайдаланушылары құпиясөзбен кіру мүмкіндігін жоғалтады. Толығырақ ақпарат алу үшін төмендегі «ChatGPT пен API платформасында доменді растау» бөлімін қараңыз.
Ішкі домендер жоғарғы деңгейлі домендерден бөлек расталуы керек
Доменіңізді растауды сәтті өңдеуіміз үшін TXT жазбаңыз DNS іздеуі арқылы оқылатын болуы керек.
(Тек ChatGPT) Аккаунтты автоматты жасау (AAC) ChatGPT жұмыс кеңістігінде қосылғанда, электрондық поштасы расталған домендерге сәйкес келетін жаңа пайдаланушы тіркелген кезде Enterprise жұмыс кеңістігіне автоматты түрде шақыру алады. SCIM пайдаланып жатсаңыз, AAC қосуды ұсынбаймыз.
(Тек ChatGPT) Сыртқы домен шақыруларына рұқсат беру Бұл параметр расталмаған домендері бар пайдаланушыларды жұмыс кеңістігіне шақыруға болатынын-болмайтынын басқарады. Сыртқы домендерден келген пайдаланушылардан SSO (бірыңғай кіру) арқылы кіру талап етілмейді, өйткені SSO (бірыңғай кіру) параметрлері тек расталған доменге жататын пайдаланушыларға қолданылады.
SSO (бірыңғай кіру) қосу Бұл параметр конфигурацияланған SSO (бірыңғай кіру) параметрлерінің жұмыс кеңістігіне және/немесе ұйымға қолданылатынын-қолданылмайтынын анықтайды.
SSO (бірыңғай кіру) міндеттеу
Өшірілген кезде бұл параметр расталған домені бар пайдаланушыларға SSO (бірыңғай кіру) арқылы немесе әлеуметтік кіру арқылы кіруді таңдауға мүмкіндік береді.
Global Admins әкімшілері Admin Console ішіндегі Manage SSO бетінен ChatGPT және API платформасы үшін Enforce SSO параметрін Required мәніне тікелей қоя алады. Қосылған кезде бұл параметр расталған домені бар пайдаланушылардың SSO (бірыңғай кіру) қосылған жұмыс кеңістігіне немесе ұйымға тек SSO (бірыңғай кіру) арқылы кіруін қамтамасыз етеді. Құпиясөз және әлеуметтік аутентификация жұмыс кеңістігі/ұйым үшін енді жарамды емес, бірақ домені расталмаған басқа жұмыс кеңістіктерінде/ұйымдарда әлі де пайдаланылуы мүмкін.
ChatGPT пен API платформасында доменді растау
Бұрын талқыланғандай, доменді растау ортақ ChatGPT және Платформа инстанцияларында қолданылады. Алайда SSO (бірыңғай кіру) қосылған болса, доменді растаудың ChatGPT пен Платформаға кіруге әсер етуінде маңызды айырмашылық бар:
API платформасындағы SSO (бірыңғай кіру) толығымен доменге негізделген. Бұл домен кез келген ұйымда расталып, SSO (бірыңғай кіру) қосылғаннан кейін, сол домені бар БАРЛЫҚ пайдаланушылар құпиясөзбен кіру мүмкіндігін жоғалтады дегенді білдіреді. Егер оларда әлеуметтік аутентификация тәсілі болмаса, IdP қатынасу тобына кірмеген жағдайда өз ұйымдарына кіре алмай қалады.
Ал ChatGPT жағында домен расталған жұмыс кеңістігіне кіретін пайдаланушылар ғана әсерге ұшырайды. IdP-дің қатынасу тобына кірмейтін пайдаланушылар келесі бөлімде талқыланған әдістермен жұмыс кеңістіктеріне кіре алады.
Пайдаланушыларыңыздың кіру тәжірибесі
OpenAI үш түрлі аутентификация әдісін қолдайды:
Пайдаланушы аты + құпиясөз
Microsoft/Google/Apple арқылы әлеуметтік аутентификация
SSO (бірыңғай кіру)
Пайдаланушы ChatGPT-ке ме, әлде API платформасына ма кіретініне, оның домені расталған-расталмағанына және тиісті жұмыс кеңістіктері/ұйымдарында SSO (бірыңғай кіру) міндеттелген-міндеттелмегеніне қарай әрекет әртүрлі болатынын ескеріңіз.
SP бастамасымен кіру
Барлық пайдаланушылар кіру үшін тікелей chatgpt.com немесе platform.openai.com сайтына өте алады. Бұл опцияны пайдаланғанда, әртүрлі аутентификация әдістерін төменде көрсетілгендей іске қосуға болады:
Егер пайдаланушы бірнеше жұмыс кеңістігіне кірсе, соның ішінде домені үшін SSO (бірыңғай кіру) қосылған біреуі болса, одан қай жұмыс кеңістігіне кіру керектігін таңдау сұралады.
ChatGPT-те SP бастамасымен кіру
Енгізілген электрондық пошта домені расталған жұмыс кеңістігіне тиесілі екенін анықтасақ, пайдаланушыны аутентификация үшін оның IdP-іне бағыттаймыз. Әйтпесе, пайдаланушы құпиясөзін енгізу арқылы кіруге бағытталады.
Егер пайдаланушы бірнеше жұмыс кеңістігіне кірсе және олардың кемінде бірінде оның домені үшін SSO (бірыңғай кіру) қосылған болса, одан кіру үшін қай әдісті пайдалану керектігін таңдау сұралады:
Ескертпе: егер белгілі бір жұмыс кеңістігі үшін «SSO (бірыңғай кіру) міндеттелсін» қосылған болса, расталған домені бар пайдаланушылар тек SSO (бірыңғай кіру) арқылы кіре алады. Әлеуметтік және құпиясөз арқылы аутентификация қолжетімді болмайды.
Платформада SP бастамасымен кіру
Жоғарыда айтылғандай, расталған домені бар пайдаланушы Платформаға кіру бетінде электрондық поштасын енгізгенде, ол аутентификация үшін IdP-іне әрқашан бағытталады.
Сондықтан Платформа үшін SSO (бірыңғай кіру) қоспас бұрын мұны толық түсіну өте маңызды. Әйтпесе, жеке аккаунттардағы Платформа пайдаланушыларын қателесіп кіре алмайтындай ету өте оңай.
IdP бастамасымен кіру
Тиісті сәйкестендіру беттерінен SSO (бірыңғай кіру) конфигурациялағанда, ChatGPT үшін де, API платформасы үшін де берілген бірегей Tile URL мекенжайын табасыз:
ChatGPT: https://chatgpt.com/auth/login?sso=true&connection=conn_012abcdef
Платформа: https://platform.openai.com/enterprise/conn_012abc/login
Бұл Tile URL мекенжайларын IdP ішінде конфигурациялап, пайдаланушыларыңызға бір рет басу арқылы автоматты түрде кіруге/аутентификациялануға мүмкіндік беруге болады.
Келесі қадамдар
Енді архитектурамыз туралы жақсы негіз қалыптастырған соң, өз қолдану жағдайыңызға ең қолайлы іске асыруды анықтау үшін «Мінсіз пайдаланушы басқару баптауыңызды түсіну» бетіне өтіңіз. Осыдан кейін аккаунтыңызда SSO (бірыңғай кіру) және SCIM қалай конфигурацияланатынын көрсетеміз.