Masharti ya awali

Ili kusanidi SSO, ni lazima:

1. Uwe na mpango wa OpenAI wenye Dashibodi ya Msimamizi Mkuu

2. Uwe Msimamizi Mkuu

Kabla ya kuendelea, tafadhali pitia kurasa zetu za nyaraka za Muhtasari wa SSO na Usimamizi wa Watumiaji ili kuhakikisha unaelewa usanifu wetu wa SSO.

Ikiwa hapo awali ulisanidi SSO kwa shirika la Jukwaa la API au eneokazi la ChatGPT, mipangilio yako ya SSO inapaswa kuwa tayari inapatikana kusanidiwa kwenye ukurasa wa Utambulisho wa OpenAI. Ikiwa eneokazi au shirika ambalo unataka kuliwezesha SSO halionekani katika Dashibodi yako ya Msimamizi Mkuu, tafadhali wasiliana na support@openai.com.

Kujaribu SSO

Ikiwa ungependa kujaribu mchakato wa usanidi bila kuhatarisha kuathiri watumiaji wako, unaweza kufanya hivyo kupitia programu hapa.

Kukamilisha muunganisho kwa mafanikio kwenye programu hii ya majaribio hakutahusishwa na shirika lako la uzalishaji, wala hakutahifadhi muunganisho (ili uweze kutumia tena vigezo vilevile katika tukio lako la uzalishaji utakapokuwa tayari). Hii inamaanisha ni salama kuitumia kama sanduku la majaribio au uwanja wa mazoezi unapojizoesha mahitaji na kushughulikia masharti yoyote ya awali yanayokosekana.

Kuwezesha SSO

Ili kuanza, nenda kwenye ukurasa wa Utambulisho wa OpenAI kutoka kwenye Dashibodi ya Msimamizi Mkuu. Unaweza pia kufikia ukurasa huo kutoka kwenye kiungo kilicho kwenye ukurasa wa “Utambulisho na Utoaji” chini ya mipangilio yako ya “Dhibiti Eneokazi” katika ChatGPT au kichupo cha Utambulisho katika mipangilio ya shirika lako la Jukwaa la API.

Baadhi ya mifano hapa chini itaonyesha usanidi katika Okta, lakini mantiki ileile inapaswa kutumika kwa IdP zote za SAML.

Uthibitishaji wa Domeni

Ili kuwezesha SSO, tunahitaji kwanza uthibitishe angalau domeni moja.

Bofya kitufe cha "+ Add Domain" na uweke DNS yako ili kuanza:

Baada ya kuwasilisha, tunakupa ufunguo wa kuthibitisha umiliki wa domeni yako. Nenda kwa mtoa huduma wako wa DNS, kisha ongeza rekodi ya TXT yenye thamani uliyopewa:

Rekodi yako ya TXT lazima ipatikane kupitia utafutaji wa DNS ili ukaguzi wa uthibitishaji ufaulu.

Baada ya kukamilisha hili kwa mtoa huduma wako wa DNS, rudi kwenye ukurasa wa usanidi na ubofye kitufe cha "Check". Ikiwa umiliki wa domeni yako umethibitishwa kwa mafanikio, utaona hali ikisasishwa kuwa "Verified."

Unaweza kuongeza hadi domeni 99 zilizothibitishwa kwa kila Tovuti ya Msimamizi, na tunatoa kipindi cha siku 7 kwako kukamilisha ukaguzi wa uthibitishaji kabla ya kuweka domeni kama imeisha muda. Domeni zinaweza kuthibitishwa kwenye Tovuti moja tu ya Msimamizi. Ikiwa unahitaji kuthibitisha domeni hiyo hiyo kwenye shirika au eneokazi ambalo halimo kwenye Tovuti yako ya Msimamizi, tafadhali wasiliana na Usaidizi.

Kusanidi Programu Yako

Baada ya kuthibitisha kikoa chako kwa mafanikio, unaweza kuendelea na usanidi wa SSO kwa kusanidi programu yako ya IdP.

Ili kuanza, bofya kitufe cha “Sanidi SSO”:

Kuchagua Mtoa Huduma wako wa Utambulisho

Unaweza kuchagua kutoka kwenye orodha ya IdP maarufu zaidi zinazotumia miunganisho ya SAML moja kwa moja. Ikiwa huoni IdP yako kwenye orodha, au ikiwa ungependa kutumia muunganisho wa OIDC, unaweza kuchagua kitufe husika cha muunganisho Maalum kinachoonyeshwa chini:

Kuunda/Kuunganisha Programu

Sasa unaweza kufuata mchawi wa usanidi wa hatua kwa hatua ili kusaidia kuunda na kuunganisha programu yako ya IdP nasi. Kulingana na IdP unayotumia, maagizo yako yanaweza kutofautiana kidogo, lakini usanidi wa jumla unabaki uleule:

Kumbuka kuwa URL zinazotolewa katika hatua ya kuunda zitakuwa za kipekee kwa shirika lako:

Baada ya kukamilisha usanidi wa URL, unaweza kuendelea kufafanua upangaji wa sifa kwa watumiaji wanaothibitishwa kupitia programu yako.

Ulinganishaji wa Sifa

Ulinganishaji wa sifa unaofafanua katika programu yako ya SSO ndio hatimaye huamua akaunti zipi za OpenAI zitathibitishwa na jinsi watumiaji wako wanavyoonekana katika bidhaa za OpenAI. Muundo wetu wa sasa wa mtumiaji unaauni sifa tatu:

1. Anwani ya Barua Pepe (inahitajika katika jibu la SAML, huamua akaunti inayofikiwa)

2. Jina la Kwanza (hiari, lakini linapendekezwa)

3. Jina la Mwisho (hiari, lakini linapendekezwa)

Kulingana na IdP yako, upangaji halisi wa sifa utatofautiana. Tunapendekeza ufuate hasa upangaji unaoonyeshwa kwa IdP yako katika mwongozo wa usanidi, kwa mfano Okta itakuwa:

Ikiwa unaona watumiaji wapya wakija huku anwani zao za barua pepe zikiwa zimewekwa kama jina lao la kuonyesha, tafadhali pitia upangaji wa sifa zako na uthibitishe kuwa husimbi majibu yako.

Vinginevyo, ikiwa watumiaji wapya wanaombwa waweke jina lao na tarehe yao ya kuzaliwa, huenda hii inaonyesha kwamba hatutambui thamani sahihi ya jina kutoka kwenye jibu lako la sifa.

Mabadiliko ya Barua Pepe

Mara kwa mara, anwani ya barua pepe ya mtumiaji inaweza kusasishwa katika IdP yako, k.m.

• Mabadiliko ya jina la kisheria baada ya ndoa

• Kampuni yao ilinunuliwa na sasa wana kikoa kipya

• n.k.

Ikiwa hili litabadilisha thamani ya dai la emailaddress katika SSO SAMLResponse, mtumiaji tofauti wa OpenAI aliyehusishwa na anwani mpya ya barua pepe atafikiwa (na kuundwa ikiwa hakuwepo awali) baada ya SSO kufanikiwa. Mtumiaji huyu atahitaji kualikwa kwenye Shirika au Eneokazi kando na mtumiaji wa awali.

Anwani Kuu za Barua Pepe

Katika baadhi ya hali, unaweza kuwa na watumiaji wenye anwani kadhaa tofauti za barua pepe. Hii ni hali ya kawaida katika kampuni kubwa zilizo na mifumo ya barua pepe iliyosambazwa au kwa wateja wa sekta ya elimu wenye shule tofauti, k.m.

• user_a@main_school.edu

• user_a@business_main_school.edu

Katika hali hii, tunapendekeza kuhakikisha kuwa jibu lako la SAML linajumuisha anwani moja tu ya barua pepe katika sifa zake, kwa kuwa kujumuisha barua pepe nyingi kunaweza kuleta mkanganyiko tunapojaribu kuihusisha na mtumiaji mpya au aliyepo.

Zaidi ya hayo, ikiwa watumiaji wana anwani ya barua pepe isiyobadilika (k.m. UPN), tunapendekeza uitumie katika ulinganishaji wa sifa ili kuhakikisha watakuwa na akaunti thabiti ya mtumiaji wa OpenAI ambayo haitaathiriwa anwani zao nyingine za barua pepe zitakapobadilishwa.

Kutoa Ufikiaji wa Programu ya IdP

Baada ya kufanikiwa kuunda ulinganishaji wa sifa, mchawi utakuongoza hatua kwa hatua kutoa ufikiaji kwa watumiaji husika kupitia vikundi unavyotaka.

Tafadhali pitia mapendekezo yetu kuhusu Usimamizi wa Watumiaji kwa mbinu bora.

Kuweka Metadata ya IdP

Katika hatua hii ya usanidi, una chaguo mbili tofauti za kufafanua metadata ya IdP yako: Usanidi Unaobadilika na Usanidi wa Kutumia Mkono.

Usanidi Unaobadilika

Hili ndilo chaguo linalopendekezwa na lililo rahisi zaidi. Kwa Usanidi Unaobadilika, unahitaji tu kutoa Metadata URL (sasa imejazwa na SSO URL na Entity ID ulizosanidi awali) inayohusishwa na programu yako. Mchawi wa usanidi utakuonyesha mahali unapoweza kuipata katika IdP yako:

Usanidi wa Kutumia Mkono

Kama jina linavyoonyesha, Usanidi wa Kutumia Mkono unahitaji kazi zaidi kidogo. Kulingana na IdP yako, utahitaji kuingiza SSO URL husika na mtoaji wa IdP, pamoja na cheti cha x.509:

Kuingia Kunakoanzishwa na IdP

Ikiwa ungependa watumiaji wako waweze kubofya kigae kwenye dashibodi yao na kuthibitishwa kiotomatiki, unaweza kusanidi uthibitishaji unaoanzishwa na IdP kwa programu yako kama sehemu ya mchakato wa usanidi. Ingawa mchakato mahususi utatofautiana kulingana na IdP yako, mchakato wa jumla utatumia URL iliyotolewa katika muundo wa:

• ChatGPT: https://chatgpt.com/auth/login?sso=true&connection=conn_0123abc

• Jukwaa la API: https://platform.openai.com/enterprise/conn_01ABC02DEF/login

Kwa mfano, Okta itakuongoza kuunda Programu mpya ya Alamisho kwa URL hii:

Nayo Entra ID itakuruhusu kuingiza “URL ya Kuingia” iliyotolewa kwenye fomu inayofaa:

Kukamilisha Usanidi

Baada ya kusanidi metadata ya IdP yako, unaweza kubofya “Endelea” ili kuendelea kusanidi programu zozote za alamisho za hiari. Hatua ya mwisho ya lazima ya usanidi itakuwa kwenye ukurasa wa “Jaribu Kuingia Mara Moja”:

Baada ya kubofya “Endelea kuingia,” mchawi utajaribu muunganisho wako mpya. Ikiwa kila kitu kitafaulu, utakuwa umewezesha SSO kikamilifu. Sasa unapaswa kuona hili likionekana kwenye ukurasa wako wa usanidi:

Watumiaji katika kikundi chako cha IdP walio na akaunti au mialiko husika sasa wanapaswa kuweza kuingia kwa SSO:

• Wanaweza kwenda chatgpt.com au platform.openai.com, kuweka barua pepe yao, kisha kuthibitishwa baada ya sisi kuwaelekeza kwa IdP yao

• Wanaweza kutumia URL ya Kigae cha Alamisho ulichosanidi (kwa hiari) wakati wa usanidi

Ukigundua kuwa watumiaji wako hawawezi kuthibitishwa kwa mafanikio, na unapata shida kurejesha mabadiliko, tafadhali wasiliana na Usaidizi kwa msaada wa haraka.

Kumbuka kwamba kuwezesha SSO kwenye Jukwaa la API hutekeleza uthibitishaji wa kikoa kwa watumiaji wote walio na kikoa hicho. Hii inamaanisha kwamba, hata kama watumiaji si sehemu ya shirika lako la Enterprise, bado watahitajika kuwa sehemu ya kikundi chako cha IdP ili kufikia mashirika yao binafsi.

Kutatua Matatizo ya Kuingia

Ikiwa baada ya kuwezesha SSO unakumbana na matatizo ya kuingia, unaweza kupitia ukurasa wetu wa Maswali Yanayoulizwa Mara kwa Mara na Utatuzi wa Matatizo kwa usaidizi wa kutambua hitilafu za kawaida. Usipopata jibu la kutosha hapo, tafadhali usisite kuwasiliana na Usaidizi.