Большинство прототипов Gemini начинаются одинаково. Вы получаете API-ключ в Google AI Studio, а затем вставляете его в своего агента кодирования, чтобы начать создание прототипа. Такая скорость имеет решающее значение, и замедлять ее не стоит.
Проблемы начинаются позже, когда у прототипа появляются реальные пользователи, а ключ остается прежним. К тому моменту это обычно уже не один ключ. У каждого разработчика есть свой собственный, а часто и несколько, которые хранятся в .env-файлах, профилях оболочки и темах чатов. У приложения есть еще один — зашитый в его конфигурацию.
Например, представьте аккаунт, который обычно тратит 180 долларов в месяц. Один из таких ключей попадает в публичный репозиторий, канал Slack или дистрибутив мобильного приложения. Автоматизированные сканеры находят его за считанные минуты и используют для запуска тяжелых нагрузок. К моменту получения первого уведомления о счете сумма исчисляется десятками тысяч. Согласно модели общей ответственности, клиент оплачивает использование, совершенное с использованием его собственных действительных учетных данных. Для посевной компании это означает исчерпание бюджета всего за выходные.
В нашей недавней статье «10 вопросов, на которые должен ответить каждый стартап перед выходом в продакшн с ИИ-прототипом» мы рассмотрели весь путь от прототипа до продакшна. Эта статья более подробно освещает один из его этапов: полный отказ от незащищенных API-ключей.
Вот что рассматривается в этом руководстве:
- Авторизуйте ваших сотрудников. Дайте каждому участнику команды единый вход с помощью Application Default Credentials (учетных данных приложения по умолчанию) и используйте его для вызова Gemini, Claude и открытых моделей. Шаги 1 и 2 занимают около пяти минут.
Авторизуйте ваших сотрудников. Дайте каждому участнику команды единый вход с помощью Application Default Credentials (учетных данных приложения по умолчанию) и используйте его для вызова Gemini, Claude и открытых моделей. Шаги 1 и 2 занимают около пяти минут.
- Авторизуйте ваше приложение. Запустите приложение под собственной учетной записью службы с необходимым минимумом прав. Шаги 3 и 4.
Авторизуйте ваше приложение. Запустите приложение под собственной учетной записью службы с необходимым минимумом прав. Шаги 3 и 4.
- Защитите то, что осталось. Перенесите оставшиеся ключи в Secret Manager, а затем добавьте лимиты расходов, защитные механизмы и мониторинг. Шаг 5 и заключительные разделы.
Защитите то, что осталось. Перенесите оставшиеся ключи в Secret Manager, а затем добавьте лимиты расходов, защитные механизмы и мониторинг. Шаг 5 и заключительные разделы.
Код для каждого шага находится в сопутствующем репозитории с готовыми к запуску примерами и автономными тестами.
Чем необработанный ключ отличается от других
Ключ AI Studio — это маркер доступа (bearer token). Всякий, кто владеет им, может использовать его. Он не истекает сам по себе. Он не привязан к машине, человеку или рабочей нагрузке. У него нет лимита расходов, если вы его не установите. Когда кто-то уходит из компании, никто не знает, какие именно ключи нужно отозвать.
Это нормально на вашем ноутбуке, пока вы являетесь единственным пользователем. Это перестает быть нормальным, если верно хотя бы одно из следующих условий:
- Ключ покинул ваш ноутбук. Он был передан в чате, зафиксирован в репозитории или развернут на сервере.
Ключ покинул ваш ноутбук. Он был передан в чате, зафиксирован в репозитории или развернут на сервере.
- К API необходимо обращаться более чем одному человеку в команде.
К API необходимо обращаться более чем одному человеку в команде.
- Вы тратите более нескольких сотен долларов в месяц или собираетесь подключить платящих клиентов.
Вы тратите более нескольких сотен долларов в месяц или собираетесь подключить платящих клиентов.
Если что-то из этого относится к вам, выполните переход на этой неделе.
Прежде чем что-либо менять, выясните, где находятся ваши ключи. Репозиторий включает небольшой сканер, который ищет строки, похожие на ключи Google API, и api_key= с конкретным значением. Он сообщает файл и строку, но никогда не показывает сам ключ. Он также завершает работу с ошибкой, поэтому вы можете добавить его в CI:
Шаг первый: дайте каждому человеку индивидуальный вход
Каждый участник команды выполняет одну команду:
Откроется окно браузера, вы войдете под своей рабочей учетной записью, и gcloud сохранит недолговечные учетные данные на вашем компьютере. Каждый SDK Google Cloud находит их автоматически. Здесь нет ключа, который можно скопировать, вставить или случайно скомпрометировать.
Затем укажите своим инструментам проект команды:
Кто-то должен сначала предоставить вам доступ к проекту. Шаг 4 показывает, как это сделать.
Шаг второй: вызывайте любую модель с помощью этих учетных данных
Эти единые учетные данные работают для каждой модели в Model Garden, а не только для Gemini. Вам не нужны новые учетные записи, новые ключи или отдельные счета. Внутри каждого SDK переключение моделей сводится к изменению одной строки.
Gemini с использованием Google Gen AI SDK. Если ваш прототип создает клиент с помощью api_key=..., это единственное изменение:
Параметр enterprise=True направляет вызов на платформу Gemini вместо AI Studio. В более старых примерах используется тот же флаг vertexai=True, и текущие версии SDK принимают оба варианта.
Claude с использованием SDK от Anthropic и тех же учетных данных:
Открытые модели, такие как gpt-oss от OpenAI, с SDK OpenAI, настроенным на Google Cloud:
Две вещи, которые нужно знать:
- Партнерские модели, такие как Claude, требуют однократного включения (Enable) на карточке Model Garden в каждом проекте. После этого все пользователи, имеющие доступ, смогут их вызывать.
Партнерские модели, такие как Claude, требуют однократного включения (Enable) на карточке Model Garden в каждом проекте. После этого все пользователи, имеющие доступ, смогут их вызывать.
- Модели GPT-6 от OpenAI появились в Model Garden 21 октября в режиме предварительного доступа для избранных корпоративных клиентов. Когда они станут доступны всем, эти же учетные данные будут работать и для них.
Модели GPT-6 от OpenAI появились в Model Garden 21 октября в режиме предварительного доступа для избранных корпоративных клиентов. Когда они станут доступны всем, эти же учетные данные будут работать и для них.
Каждый вызов попадает в единый счет Google Cloud, что упрощает сравнение моделей по стоимости и качеству.
Шаг третий: предоставьте вашему приложению собственную идентичность
Вашему приложению требуется то же самое, что только что получили ваши разработчики: идентичность вместо ключа. Для рабочей нагрузки этой идентичностью является учетная запись службы (service account).
Хорошая новость заключается в том, что код из Шага 2 не меняется. На вашем ноутбуке ADC подхватывает ваш собственный логин. На Cloud Run, GKE или Compute Engine он подхватывает недолговечный токен для учетной записи службы, привязанной к рабочей нагрузке, и обновляет его автоматически. Таким образом, в вашей кодовой базе нечего скомпрометировать. Утекший токен живет недолго (обычно около часа) и обладает правами только одной учетной записи службы.
Создайте учетную запись службы и выполните развертывание с ее помощью:
Разделяйте разработчиков и продакшн. Разработчики работают в my-startup-dev под своими учетными записями, а приложение работает в my-startup-prod под своей учетной записью службы. Ошибка в одном окружении не затрагивает бюджет другого.
Шаг четвертый: предоставьте каждой идентичности только необходимые права
Удаление ключей решает проблему утечки. Следующий вопрос заключается в том, что именно разрешено делать каждой идентичности. Если человек или учетная запись службы обладают ролью Редактора (Editor) или Владельца (Owner), украденный логин или токен все равно смогут удалять ресурсы, изменять разрешения или читать данные, которые им никогда не были нужны.
Для вызова моделей требуется всего одна роль — roles/aiplatform.user. Выделение прав выглядит одинаково для обоих типов идентичностей.
Для людей предоставляйте доступ группе Google, а не отдельным лицам. Подключение и отключение сотрудников в таком случае сводится к изменению членства в группе:
Для приложения предоставьте доступ учетной записи службы:
Это занимает примерно на 30 секунд больше времени, чем предоставление роли Редактора. Если что-то будет скомпрометировано позже, злоумышленник получит одну узкую роль вместо доступа ко всему проекту. Когда кто-то уходит, удалите его из группы, и его доступ прекратится везде одновременно.
В Cloud Console в диалоговом окне предоставления доступа (Grant access) есть кнопка «Помочь мне выбрать роли» (Help me choose roles). Вы описываете задачу на обычном языке, а Gemini предлагает предопределенные роли. По умолчанию предложения охватывают распространенные задачи, что обычно означает широкие роли Администратора, Редактора или Читателя для сервиса. Чтобы получить более узкие роли, укажите это:
Какой минимальный уровень доступа необходим сервисному аккаунту для вызова моделей Gemini на Agent Platform?
Стоит знать еще о трех элементах управления:
- Если ваш проект находится в организации, политика vertexai.allowedModels ограничивает, какие модели может вызывать любой пользователь. Вы перечисляете такие значения, как publishers/google/models/gemini-4-hydrogen:predict, и все остальное блокируется.
Если ваш проект находится в организации, политика vertexai.allowedModels ограничивает, какие модели может вызывать любой пользователь. Вы перечисляете такие значения, как publishers/google/models/gemini-4-hydrogen:predict, и все остальное блокируется.
- Репозиторий включает в себя аудит в одну строку, который выводит каждый сервисный аккаунт, имеющий роль Владельца (Owner) или Редактора (Editor) в проекте. Запускайте его время от времени перед каждым запуском.
Репозиторий включает в себя аудит в одну строку, который выводит каждый сервисный аккаунт, имеющий роль Владельца (Owner) или Редактора (Editor) в проекте. Запускайте его время от времени перед каждым запуском.
- Чтобы предотвратить создание новых ключей, примените политики организации (Org Policies), запрещающие действие CREATE для apikeys.googleapis.com/Key в отношении ключей API и iam.managed.disableServiceAccountKeyCreation в отношении ключей сервисных аккаунтов.
Чтобы предотвратить создание новых ключей, примените политики организации (Org Policies), запрещающие действие CREATE для apikeys.googleapis.com/Key в отношении ключей API и iam.managed.disableServiceAccountKeyCreation в отношении ключей сервисных аккаунтов.
Шаг 5: Поместите оставшиеся ключи в Secret Manager
Некоторые ключи никуда не денутся — например, от Stripe, Slack или вашего почтового провайдера. Им место в Secret Manager, а не в файлах .env, ветках чата или репозитории. Доступ работает так же, как на Шаге 4: предоставьте права на чтение каждого секрета той учетной записи, которой они необходимы.
Тестовые ключи отправляются группе разработчиков:
Любой участник группы может получить ключ под собственной учетной записью:
Рабочие ключи остаются в производственном проекте и доступны для чтения только сервисному аккаунту приложения. Приложение считывает их при запуске:
Чтение из стандартного ввода с помощью флага --data-file=- защищает значение от попадания в историю командной строки. Каждая операция чтения привязана к конкретному человеку или сервисному аккаунту, а ротация ключа означает добавление одной новой версии. Ничего не переразвертывается, и никакой файл не копируется между ноутбуками.
Затем завершите работу. Перейдите на страницу ключей API AI Studio и удалите каждый ключ (личный или общий), который когда-либо покидал ноутбук. Ключ, от использования которого вы отказались, остается активным до тех пор, пока вы его не удалите.
Что дает вам новая настройка
Как только ваши сотрудники и приложение начинают работать под учетными записями в проекте Google Cloud, становятся доступны несколько средств защиты, которые обычный ключ предоставить не может. Вам не обязательно использовать их все в первый день. О них стоит знать до вашего первого запуска.
Лимит расходов, приостанавливающий работу сервиса
Стандартные бюджетные оповещения отправляют электронные письма, в то время как счет продолжает расти. Бюджет с лимитом расходов (на данный момент в режиме предварительного просмотра) делает больше. Когда предполагаемые расходы на один сервис в одном проекте превышают установленную вами сумму, новые запросы к этому сервису приостанавливаются до тех пор, пока вы не снимете лимит или не начнется следующий месяц. Оповещения отправляются администраторам выставления счетов и владельцам проектов при достижении 50%, 80% и 100%.
Вы можете создать его в консоли в разделе «Бюджеты и оповещения» (Budgets & alerts), выбрав «Принудительное применение лимита расходов» (Spend cap enforcement), либо через API бюджета. Репозиторий оборачивает вызов API и имеет флаг тестового прогона (dry-run), чтобы вы могли сначала проверить запрос:
Изучите ограничения, прежде чем полагаться на них. Каждый лимит распространяется на один проект и один сервис. В настоящее время поддерживаются Agent Platform, API Gemini, Cloud Run и функции Cloud Run. Принудительное применение работает на основе предполагаемой стоимости и происходит не мгновенно. Любое превышение тарифицируется в обычном порядке, поэтому устанавливайте сумму ниже той, которую вы действительно можете позволить себе потерять. Лимит также приостанавливает использование, покрываемое обязательствами, а после его снятия сервису может потребоваться до часа на восстановление.
Установите один лимит на проект разработки, а другой — на рабочий проект. Тогда эксперимент не сможет исчерпать бюджет, от которого зависят ваши клиенты. В качестве второго уровня защиты снизьте квоты Agent Platform до действительно необходимых вам значений, чтобы ошибка или зациклившийся агент уперлись в потолок, а не в лимит вашей банковской карты.
Системы защиты для промптов и ответов
Как только реальные пользователи смогут писать в ваше приложение, кто-нибудь попытается заставить его игнорировать инструкции. Model Armor проверяет промпты и ответы на предмет инъекций промптов, попыток обхода защиты (jailbreak), вредоносных URL-адресов и конфиденциальных данных. Вы один проверяете каждый промпт и вызываете модель только тогда, когда он оказывается безопасным. В репозитории есть обе составляющие.
Песочница для написания кода моделью
Если ваш продукт позволяет модели писать и запускать код (например, для анализа электронной таблицы клиента), этот код не должен выполняться внутри процесса вашего приложения. С помощью функции выполнения кода модель запускает Python в управляемой Google песочнице и возвращает результат:
Сгенерированный код никогда не видит ваши переменные окружения, файлы или базу данных.
Инструмент для отслеживания необычного поведения
Security Command Center выявляет угрозы и неправильные конфигурации по всему проекту — например, когда сервисный аккаунт внезапно вызывает API, которым никогда не пользовался, или когда рабочая нагрузка связывается с незнакомым хостом. В сочетании с Cloud Audit Logs, которые фиксируют, кто, что и когда изменил, это также дает ответы, которые потребуются во время проверки безопасности вашим первым корпоративным клиентом. Поскольку теперь каждый вызов исходит от конкретного человека или сервисного аккаунта, эти логи имеют реальную ценность.
Ваш 20-минутный контрольный список
Для вашей команды:
- Каждый выполняет gcloud auth application-default login.
Каждый выполняет gcloud auth application-default login.
- Предоставьте роли roles/aiplatform.user одной группе Google и включите нужные партнерские модели.
Предоставьте роли roles/aiplatform.user одной группе Google и включите нужные партнерские модели.
- Переместите общие тестовые ключи в Secret Manager с доступом на чтение для этой группы.
Переместите общие тестовые ключи в Secret Manager с доступом на чтение для этой группы.
Для вашего приложения:
- Выполните развертывание с помощью сервисного аккаунта, у которого есть роль roles/aiplatform.user и никаких более широких прав.
Выполните развертывание с помощью сервисного аккаунта, у которого есть роль roles/aiplatform.user и никаких более широких прав.
- Переместите рабочие ключи сторонних сервисов в Secret Manager с доступом на чтение только для этого сервисного аккаунта.
Переместите рабочие ключи сторонних сервисов в Secret Manager с доступом на чтение только для этого сервисного аккаунта.
- Установите для каждого проекта лимит расходов ниже суммы, которую вы можете позволить себе потерять.
Установите для каждого проекта лимит расходов ниже суммы, которую вы можете позволить себе потерять.
Для обоих случаев: запустите сканер ключей, а затем удалите каждый ключ AI Studio на .
Ничто из этого не замедляет разработку. Вы сохраняете скорость прототипа, и каждая модель в Model Garden остается на расстоянии одной строки кода. Никому в команде больше не придется охранять ключ. Весь код, включая примеры для каждого шага и дополнительные материалы, находится в сопутствующем репозитории.
У вас есть сценарий, который вы бы хотели, чтобы мы рассмотрели в следующий раз? Свяжитесь с нами в Google Cloud for Startups.
- Разработчики и практики
- ИИ и машинное обучение












