Администраторските ключове позволяват на упълномощени собственици и администратори на работното пространство да свързват инструменти и услуги с поддържаните API за администриране на ChatGPT и Codex. В зависимост от избраното работно пространство и разрешения ключът може да поддържа анализи, управление на потребители и групи, покани, ограничения за използване, съответствие и регистри за активността или администриране на служебни акаунти.
Всеки администраторски ключ важи за едно работно пространство в ChatGPT. Той не предоставя достъп до други работни пространства, администриране на целия клиент, организации в API платформата, рекламни акаунти, модели или изпълнение на извод с модел.
За помощ при избора на клиент или работно пространство вижте: Управление на клиента ви в конзолата за администриране.
Проверка на наличността и достъпа до работното пространство
Администраторските ключове са налични за отговарящи на условията управлявани работни пространства в ChatGPT, включително работни пространства в ChatGPT Enterprise, ChatGPT Edu и ChatGPT за здравеопазването. Трябва да имате роля Собственик или Администратор в конкретното работно пространство, което искате да управлявате.
Достъпът зависи от ролята Собственик или Администратор, зададена в избраното работно пространство в ChatGPT. Ролята на глобален администратор, собственик на организация в API платформата или потребител с персонализирана роля в работното пространство сама по себе си не предоставя достъп до администраторски ключове.
За подробности относно вградените роли в работното пространство вижте: Управление на членове, типове места, роли и достъп в ChatGPT Enterprise.
Разбиране на достъпа според ролята
Собствениците на работното пространство могат да създават ключове с разрешения Всички, Само за четене или Персонализирани. Те могат да редактират или отменят всеки администраторски ключ в работното си пространство.
Администраторите на работното пространство създават ключове с персонализиран обхват, като избират наличното ниво на достъп за всяка категория разрешения. Полученият ключ е означен като Персонализиран. Те могат да редактират или отменят само създадените от тях ключове и само когато разрешенията на ключа са налични за текущата им роля.
Глобалните администратори без роля Собственик или Администратор в избраното работно пространство не могат да създават или управляват администраторските му ключове.
Избор на разрешения за администраторски ключ
Предварително зададени разрешения за собственици
Собствениците на работното пространство могат да изберат една от следните предварително зададени конфигурации на разрешенията:
Всички предоставя наличните администраторски разрешения за избраното работно пространство, включително разрешенията само за собственици, когато са налични.
Само за четене предоставя наличните разрешения само за четене за избраното работно пространство.
Персонализирани ви позволява да изберете наличното ниво на достъп за всяка категория разрешения.
Администраторски разрешения по категории
Администраторите на работното пространство не виждат селектора за предварително зададените конфигурации Всички, Само за четене или Персонализирани. В Разрешения те избират Няма, Четене или Запис за всяка налична категория. Полученият ключ е означен като Персонализиран.
В зависимост от работното ви пространство наличните категории може да включват Приложения, Ограничения за използването, Управление на групи, Потребители, Покани, API за анализи на Codex, API за корпоративни анализи, Анализи на работното пространство, Разходи и Служебни акаунти. Някои категории поддържат само Четене или Запис, а други се показват само когато съответната функция е налична.
Често срещаните съответствия на разрешенията включват:
API за анализи на Codex > Четене:
codex.enterprise.analytics.read.Ограничения за използването > Четене:
chatgpt.enterprise.usage_limit.read.Ограничения за използването > Запис:
chatgpt.enterprise.usage_limit.writeиchatgpt.enterprise.usage_limit.read.Потребители > Четене:
chatgpt.enterprise.user.read, когато е налично.
Широките разрешения за съответствие, Съобщения в разговорите и Роли и разрешения са достъпни само за собственици на работното пространство, когато се поддържат. Администраторите на работното пространство може все пак да могат да избират отделни категории регистри за активността, като регистри за одит или удостоверяване.
Създаване на администраторски ключ
Влезте в Конзолата за администриране.
Ако е необходимо, изберете клиента си, след което изберете работното пространство в ChatGPT, където имате роля Собственик или Администратор.
Отворете Идентификационни данни, след което изберете Администраторски ключове.
Изберете Създаване на нов администраторски ключ и въведете описателно име.
Изберете срок на валидност: Безсрочно, 30 дни, 60 дни, 90 дни или Персонализиран. Персонализираният срок на валидност може да бъде между 1 и 365 дни.
Изберете разрешенията, от които се нуждае интеграцията ви. Собствениците на работното пространство могат да изберат Всички, Само за четене или Персонализирани, а администраторите избират наличното разрешение за всяка категория.
Изберете Изпращане, след което копирайте тайната стойност и я съхранете сигурно. Няма да можете да видите тайната стойност отново.
За ключовете на собственици на работното пространство може по подразбиране да са зададени Всички разрешения, а срокът на валидност — Безсрочно. Прегледайте и двете настройки, преди да създадете ключ.
Преглед, редактиране или отмяна на администраторски ключ
Отворете работното пространство в ChatGPT от конзолата за администриране, след което отидете на Идентификационни данни > Администраторски ключове. Прегледайте името, състоянието, идентификатора за проследяване, скритата тайна стойност, създателя, разрешенията, датата на последно използване и срока на валидност на всеки ключ.
За да промените името или разрешенията на ключ, отворете менюто му за още опции (•••), изберете Редактиране, направете промените и изберете Запазване на промените.
За да спрете използването на ключ, отворете менюто му за още опции (•••), изберете Отмяна и потвърдете с Отмяна на администраторския ключ.
Собствениците на работното пространство могат да редактират или отменят всеки ключ за избраното работно пространство. Администраторите на работното пространство могат да редактират или отменят само създадените от тях ключове и само когато разрешенията на ключа са налични за текущата им роля. Помолете собственик на работното пространство да управлява ключовете с разрешения само за собственици. Съществуващите дати на изтичане не могат да се променят.
Отменените ключове спират да работят, след като промяната влезе в сила. Преди да отмените ключ, който все още се използва, създайте заместващ ключ и актуализирайте всички засегнати интеграции.
Съответствие и чувствителни данни
Някои разрешения за администраторски ключ могат да разкрият чувствителна активност или съдържание от работното пространство. Само собствениците на работното пространство могат да предоставят широк достъп до данни за съответствие или достъп до Съобщения в разговорите.
Администраторите на работното пространство може да могат да предоставят достъп до поддържани отделни категории регистри, включително регистри за одит, удостоверяване или приложения. Преглеждайте внимателно всяка категория. Отделните регистри също може да съдържат чувствителна информация.
За информация относно API за съответствие и достъпа до данни вижте: Платформа за съответствие на OpenAI за клиенти на Enterprise и Edu.
Заявките към Admin API за работни пространства в ChatGPT използват https://api.chatgpt.com/v1. Например използвайте /manage/workspaces/{workspace_id}/users, за да изведете списък с текущите членове на работното пространство. Крайните точки в /v1/organization/ управляват организации в API платформата и изискват администраторски ключ за организация в API платформата.
За пътищата на крайните точки, схемите на заявките и отговорите и необходимите обхвати вижте справочната документация за Admin API.
Разграничаване на администраторските ключове от другите идентификационни данни
Администраторските ключове на работното пространство удостоверяват достъпа до поддържаните API за администриране на ChatGPT и Codex за едно работно пространство в ChatGPT. Те не предоставят достъп до изпълнение на извод с модел.
Токените за достъп на служебни акаунти в Codex удостоверяват нечовешка самоличност в работното пространство за автоматизация с Codex. Те не удостоверяват заявки към Admin API. За указания за настройване вижте: Създаване и управление на служебни акаунти в Codex.
Администраторските ключове на организации в API платформата се управляват отделно в API платформата и не администрират работни пространства в ChatGPT.
Ако ви е необходим ключ за организация в API платформата, отворете Администраторски ключове на организация в API платформата. Използвайте специфичните за работното пространство крайни точки на ChatGPT Admin API с администраторски ключ за работното пространство. Крайните точки за организации в API платформата изискват отделни идентификационни данни.
Отстраняване на проблеми с достъпа и липсващите разрешения
Уверете се, че сте влезли с правилния акаунт в OpenAI и сте избрали желания клиент и работно пространство в ChatGPT.
Проверете дали членството ви в работното пространство е активно и ролята ви е Собственик или Администратор.
Уверете се, че работното ви пространство в ChatGPT отговаря на условията за администраторски ключове. Наличността може да се различава според плана и етапа на внедряване.
Ако липсва категория разрешения, проверете дали функцията е налична в избраното работно пространство и дали ролята ви позволява достъп. Ако необходимата категория все още не е налична, свържете се с поддръжката на OpenAI, вместо да избирате несвързано разрешение.
Ако не можете да редактирате или отмените ключ, проверете дали сте го създали и дали разрешенията му са налични за текущата ви роля. Помолете собственик на работното пространство да управлява ключовете с разрешения само за собственици.
Ако ключ, който преди е работил, спре да работи, проверете неговите Състояние и Срок на валидност, уверете се, че не е изтекъл или отменен, и проверете дали създателят му все още има активна роля в работното пространство с необходимите разрешения.
Ако проблемът продължава, свържете се с поддръжката на OpenAI. При поискване посочете идентификатора на клиента, името или идентификатора на работното пространство и приложете екранна снимка, но никога не споделяйте тайната стойност на администраторски ключ.
Защита на администраторските ключове
Изберете Персонализирани разрешения и предоставете само достъпа, от който се нуждае интеграцията ви.
Когато е възможно, задайте срок на валидност. Безсрочно означава, че ключът няма планирана дата на изтичане. Ключът все пак може да спре да работи, ако бъде отменен, създателят му загуби необходимия достъп до работното пространство или акаунтът на създателя бъде деактивиран.
Използвайте отделни ключове за различните интеграции или работни процеси.
Съхранявайте тайните стойности в защитен диспечер на тайни стойности. Никога не ги изпращайте по имейл, в чат или чрез заявка до поддръжката.
Редовно преглеждайте използването и срока на валидност и отменяйте ключовете, които вече не са ви необходими.