# General Translation Platform: API-ключи
URL: https://generaltranslation.com/ru/docs/platform/api-keys.mdx
---
title: API-ключи
description: Управляйте ключами аутентификации с гибко настраиваемыми разрешениями
---

API-ключи используются для аутентификации приложений, задач CI и средств автоматизации при работе с сервисами General Translation. Создавайте ключи на уровне проекта для одного проекта или на уровне организации для автоматизации, которой требуется более широкий доступ.

Скопируйте ключ целиком сразу после создания. На панели управления он отображается только один раз.

## Области действия ключей

| Область действия | Лучше всего подходит для                                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Project**      | Один проект, развернутое приложение, локальная разработка, превью и инструменты на уровне проекта                              |
| **Organization** | Автоматизация на уровне организации, CI, работающий между проектами, и инструменты, которым требуются настраиваемые разрешения |

Ключи проекта и ключи организации создаются по-разному. Ключи проекта создаются как production- или development-ключи. Для ключей организации используется селектор разрешений.

## Ключи проекта

Создавайте ключи проекта в разделе **Project -> API Keys**.

| Тип             | Префикс    | Сценарий использования                                                                  |
| --------------- | ---------- | --------------------------------------------------------------------------------------- |
| **Production**  | `gtx-api-` | Развернутые приложения и автоматизация для Production                                   |
| **Development** | `gtx-dev-` | Локальная разработка, окружения предварительного просмотра и автоматизация тестирования |

Ключи проекта привязаны к выбранному проекту. В большинстве сценариев работы с SDK и CLI проекта используйте ключ вместе с вашим project ID:

```bash
GT_API_KEY=gtx-api-...
GT_PROJECT_ID=...
```

## Ключи организации

Создавайте ключи организации в разделе **Organization -> API Keys**.

Ключи организации используют префикс `gtx-org-` и могут быть настроены с настраиваемым набором разрешений. Используйте их для автоматизации на уровне организации или процессов, которым нужен доступ к проектам по всей организации.

## Разрешения ключей организации

Разрешения настраиваются для каждого ресурса. `Write` включает `Read`.

| Ресурс                          | Чтение                                 | Запись или включение                                           |
| ------------------------------- | -------------------------------------- | -------------------------------------------------------------- |
| **Файлы**                       | Чтение файлов проекта и переводов      | Загрузка исходного контента и запись переведённых файлов       |
| **Контекст**                    | Чтение контекста проекта и организации | Управление группами контекста, глоссарием и директивами        |
| **Перевод во время выполнения** | Неприменимо                            | Переводить контент по запросу                                  |
| **Очередь перевода**            | Неприменимо                            | Ставить задачи перевода файлов в очередь для фоновой обработки |
| **Настройки проекта**           | Неприменимо                            | Обновление настроек проекта, таких как локаль по умолчанию     |

Предоставляйте каждому ключу только те разрешения, которые ему нужны.

## Ротация или отзыв ключей

Откройте список ключей проекта или организации, чтобы просмотреть существующие ключи. Отзовите ключи, которые больше не используются, и создайте новые при ротации учётных данных.

## Рекомендации по безопасности

* Никогда не коммитьте ключи в систему контроля версий
* Храните ключи в переменных окружения или в менеджере секретов
* Используйте отдельные ключи для разработки, стейджинга и продакшена
* Периодически ротируйте ключи и отзывайте те, которые больше не используются
* По возможности выбирайте минимально необходимую для интеграции область действия