Управление доступом в Yandex AI Studio
Об управлении доступом
Все операции в Yandex Cloud проверяются в сервисе Yandex Identity and Access Management. Если у субъекта нет необходимых разрешений, сервис вернет ошибку.
Чтобы выдать разрешения к ресурсу, назначьте роли на этот ресурс субъекту, который будет выполнять операции. Роли можно назначить аккаунту на Яндексе, сервисному аккаунту, локальному пользователю, федеративному пользователю, группе пользователей, системной группе или публичной группе. Подробнее читайте в разделе Как устроено управление доступом в Yandex Cloud.
На какие ресурсы можно назначить роль
Роль можно назначить на организацию, облако и каталог. Роли, назначенные на организацию, облако или каталог, действуют и на вложенные ресурсы.
Какие роли действуют в сервисе
Сервисные роли
ai.playground.user
Роль ai.playground.user позволяет использовать AI Playground в консоли управления Yandex Cloud, а также получать список всех доступных моделей.
ai.languageModels.user
Роль ai.languageModels.user позволяет использовать модели генерации текста, векторного представления текста и классификаторов в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.imageGeneration.user
Роль ai.imageGeneration.user позволяет использовать модели генерации изображений YandexART в сервисе Yandex AI Studio, а также просматривать информацию об облаке, каталоге и квотах сервиса.
ai.assistants.auditor
Роль ai.assistants.auditor позволяет просматривать информацию о загруженных файлах и поисковых индексах Vector Store, а также о квотах сервиса Yandex AI Studio, об облаке и каталоге.
ai.assistants.viewer
Роль ai.assistants.viewer позволяет просматривать информацию о файлах и поисковых индексах Vector Store, а также выполнять поиск по таким индексам.
Пользователи с этой ролью могут:
- просматривать информацию о загруженных файлах и содержимое таких файлов;
- просматривать информацию о поисковых индексах Vector Store, а также выполнять поиск по таким индексам;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.auditor.
ai.assistants.editor
Роль ai.assistants.editor позволяет использовать AI-агентов, а также управлять файлами и поисковыми индексами Vector Store.
Пользователи с этой ролью могут:
- использовать AI-агентов;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.viewer.
ai.assistants.admin
Роль ai.assistants.admin позволяет использовать AI-агентов, а также управлять файлами и поисковыми индексами Vector Store.
Пользователи с этой ролью могут:
- использовать AI-агентов;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- просматривать информацию о квотах сервиса Yandex AI Studio;
- просматривать информацию об облаке;
- просматривать информацию о каталоге.
Включает разрешения, предоставляемые ролью ai.assistants.editor.
ai.datasets.auditor
Роль ai.datasets.auditor позволяет просматривать метаданные датасетов.
ai.datasets.viewer
Роль ai.datasets.viewer позволяет просматривать информацию о датасетах.
Включает разрешения, предоставляемые ролью ai.datasets.auditor.
ai.datasets.user
Роль ai.datasets.user позволяет просматривать информацию о датасетах и использовать их для дообучения моделей в AI Studio.
Включает разрешения, предоставляемые ролью ai.datasets.viewer.
ai.datasets.editor
Роль ai.datasets.editor позволяет просматривать информацию о датасетах, создавать, изменять и удалять датасеты, а также использовать их для дообучения моделей в AI Studio.
Включает разрешения, предоставляемые ролью ai.datasets.user.
ai.datasets.admin
Роль ai.datasets.admin позволяет просматривать информацию о датасетах, создавать, изменять и удалять датасеты, а также использовать их для дообучения моделей в AI Studio.
Включает разрешения, предоставляемые ролью ai.datasets.editor.
ai.models.auditor
Роль ai.models.auditor позволяет просматривать метаданные моделей генерации текста Yandex AI Studio.
ai.models.viewer
Роль ai.models.viewer позволяет просматривать информацию о моделях генерации текста Yandex AI Studio.
Включает разрешения, предоставляемые ролью ai.models.auditor.
ai.models.user
Роль ai.models.user позволяет использовать AI-агентов и модели генерации текста и изображений, векторного представления текста и классификаторов в Yandex AI Studio, а также использовать сервисы Yandex Translate, Yandex Vision OCR и Yandex SpeechKit.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи.
Включает разрешения, предоставляемые ролью ai.models.viewer.
ai.models.editor
Роль ai.models.editor позволяет управлять дообучением моделей Yandex AI Studio, а также использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи.
Включает разрешения, предоставляемые ролью ai.models.user.
ai.models.admin
Роль ai.models.admin позволяет управлять дообучением моделей Yandex AI Studio, а также использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи.
Включает разрешения, предоставляемые ролью ai.models.editor.
serverless.mcpGateways.auditor
Роль serverless.mcpGateways.auditor позволяет просматривать информацию об MCP-серверах и назначенных правах доступа к ним.
serverless.mcpGateways.viewer
Роль serverless.mcpGateways.viewer позволяет просматривать информацию об MCP-серверах и назначенных правах доступа к ним.
Включает разрешения, предоставляемые ролью serverless.mcpGateways.auditor.
serverless.mcpGateways.invoker
Роль serverless.mcpGateways.invoker позволяет обращаться к MCP-серверам, в том числе через MCP Hub.
serverless.mcpGateways.anonymousInvoker
Роль serverless.mcpGateways.anonymousInvoker позволяет обращаться к MCP-серверам, в том числе через MCP Hub.
serverless.mcpGateways.editor
Роль serverless.mcpGateways.editor позволяет создавать, изменять и удалять MCP-серверы, просматривать информацию о них и назначенных правах доступа к ним.
Включает разрешения, предоставляемые ролью serverless.mcpGateways.viewer.
serverless.mcpGateways.admin
Роль serverless.mcpGateways.admin позволяет управлять MCP-серверами и доступом к ним.
Пользователи с этой ролью могут:
- просматривать информацию об MCP-серверах, а также создавать, изменять и удалять их;
- просматривать информацию о назначенных правах доступа к MCP-серверам, а также изменять такие права доступа;
- обращаться через MCP Hub к MCP-серверам, в том числе внешним.
Включает разрешения, предоставляемые ролями serverless.mcpGateways.editor, serverless.mcpGateways.invoker и serverless.mcpGateways.anonymousInvoker.
ai.auditor
Роль ai.auditor позволяет просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio, о загруженных файлах, поисковых индексах Vector Store, датасетах и моделях генерации текста Yandex AI Studio, а также об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.assistants.auditor, ai.datasets.auditor и ai.models.auditor.
ai.viewer
Роль ai.viewer позволяет просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio, о моделях генерации текста, датасетах, загруженных файлах и поисковых индексах Vector Store в Yandex AI Studio, выполнять чтение таких файлов и поиск по таким индексам, а также просматривать информацию об облаке и каталоге.
Включает разрешения, предоставляемые ролями ai.auditor, ai.assistants.viewer, ai.datasets.viewer и ai.models.viewer.
ai.editor
Роль ai.editor позволяет использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи;
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- просматривать информацию о датасетах, использовать их для дообучения моделей, а также создавать, изменять и удалять датасеты;
- просматривать информацию об облаке и каталоге;
- просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Включает разрешения, предоставляемые ролями ai.viewer, ai.translate.user, ai.vision.user, ai.speechkit-stt.user, ai.speechkit-tts.user, ai.languageModels.user, ai.imageGeneration.user, ai.assistants.editor, ai.datasets.editor и ai.models.editor.
ai.admin
Роль ai.admin позволяет использовать сервисы Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Пользователи с этой ролью могут:
- использовать сервис Yandex Translate для перевода текста;
- использовать сервис Yandex Vision OCR для анализа изображений;
- использовать сервис Yandex SpeechKit для распознавания и синтеза речи;
- просматривать информацию о моделях генерации текста Yandex AI Studio;
- использовать AI-агентов, а также модели генерации текста и изображений, модели векторного представления текста и классификаторов в сервисе Yandex AI Studio;
- просматривать информацию о загруженных файлах, а также загружать, изменять, просматривать и удалять такие файлы;
- просматривать информацию о поисковых индексах Vector Store, создавать, изменять и удалять поисковые индексы, а также выполнять поиск по ним;
- дообучать модели Yandex AI Studio, а также создавать, изменять и удалять дообученные модели;
- просматривать информацию о датасетах, использовать их для дообучения моделей, а также создавать, изменять и удалять датасеты;
- просматривать информацию об облаке и каталоге;
- просматривать информацию о квотах сервисов Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio.
Включает разрешения, предоставляемые ролями ai.editor, ai.assistants.admin, ai.datasets.admin и ai.models.admin.
Примитивные роли
Примитивные роли позволяют пользователям совершать действия во всех сервисах Yandex Cloud.
auditor
Роль auditor предоставляет разрешения на чтение конфигурации и метаданных любых ресурсов Yandex Cloud без возможности доступа к данным.
Например, пользователи с этой ролью могут:
- просматривать информацию о ресурсе;
- просматривать метаданные ресурса;
- просматривать список операций с ресурсом.
Роль auditor — наиболее безопасная роль, исключающая доступ к данным сервисов. Роль подходит для пользователей, которым необходим минимальный уровень доступа к ресурсам Yandex Cloud.
viewer
Роль viewer предоставляет разрешения на чтение информации о любых ресурсах Yandex Cloud.
Включает разрешения, предоставляемые ролью auditor.
В отличие от роли auditor, роль viewer предоставляет доступ к данным сервисов в режиме чтения.
editor
Роль editor предоставляет разрешения на управление любыми ресурсами Yandex Cloud, кроме назначения ролей другим пользователям, передачи прав владения организацией и ее удаления, а также удаления ключей шифрования Key Management Service.
Например, пользователи с этой ролью могут создавать, изменять и удалять ресурсы.
Включает разрешения, предоставляемые ролью viewer.
admin
Роль admin позволяет назначать любые роли, кроме resource-manager.clouds.owner и organization-manager.organizations.owner, а также предоставляет разрешения на управление любыми ресурсами Yandex Cloud, кроме передачи прав владения организацией и ее удаления.
Прежде чем назначить роль admin на организацию, облако или платежный аккаунт, ознакомьтесь с информацией о защите привилегированных аккаунтов.
Включает разрешения, предоставляемые ролью editor.
Вместо примитивных ролей мы рекомендуем использовать роли сервисов. Такой подход позволит более гранулярно управлять доступом и обеспечить соблюдение принципа минимальных привилегий.
Подробнее о примитивных ролях см. в справочнике ролей Yandex Cloud.