# Варианты аутентификации агента

Подключитесь к ключу API или MCP OAuth, проверьте доступ без платного запроса и повторно используйте его для последующих задач.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/agent-access
Разработчик: 2026-11-05 by FlashData

<a id="access"></a>

## 1. Выберите и соедините

Уже связались? Перейдите прямо к бесплатной проверке на шаге 2. В противном случае выберите доступ к вашему приложению или агенту.

| Вы соединяете | Использовать | Кто хранит полномочия? |
| --- | --- | --- |
| Приложение, SDK, CLI или запланированный сценарий | Владелец ключа API | Секретный магазин вашего сервера или профиль CLI |
| Инструменты исследования Codex или OpenClaw | MCP OAuth | Хост после согласия браузера |
| Агент, пытающийся взломать FlashData без аккаунта | Временный ключ API | Сохраненный профиль агента, а затем доступ владельца после заявления |

### Ключ API

Создайте ключ в API Keys с источниками, необходимыми для вашей задачи, или повторно используйте существующий ключ. Поставьте его на свой SDK или отправьте его как X-API-Key из вашего бэкэнда. Bash и PowerShell на этапе 2 работают напрямую с API; установка CLI не требуется.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Сохранить ключ в CLI](https://flashdata.dev/ru/docs/guides/agent-access/reference.md#import-key)
- [Настройка ключа SDK и HTTP](https://flashdata.dev/ru/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Используйте хост, настроенный для FlashData OAuth. Владелец учетной записи завершает регистрацию или вход и согласие в браузере; хост сохраняет токены. Это соединение не устанавливает ключ CLI и не требует пробной версии.

#### Хостинг соединения MCP

```text
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:research
```

- [Подключение Codex](https://flashdata.dev/ru/docs/integrations/codex/reference.md#setup)
- [Подключение OpenClaw](https://flashdata.dev/ru/docs/integrations/openclaw/reference.md#setup)
- [Другие клиенты MCP](https://flashdata.dev/ru/docs/integrations/mcp-clients/reference.md#connect)

### Суд над агентом

Для агента без ключа, discover имеет право на участие в текущем испытании перед регистрацией. Повторно использовать существующий тест и его профиль. YouTube Download и повторяющиеся задачи требуют доступа владельца.

#### Обнаружить без регистрации

```bash
flashdata discover --profile research --json
```

- [Начните пробный доступ и привяжите его к аккаунту](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md)
- [Протокол проверки подлинности агента](https://flashdata.dev/auth.md)


<a id="permissions"></a>

### Какие источники могут использовать эту верительные грамоты?

Используйте X-API-Key для обычных запросов HTTP и API-ключ MCP соединений. Токены-носители OAuth работают только на хостинговой конечной точке MCP. YouTube Download нужен ключ API с youtube_download и хранилищем назначения.

| Полномочия | Доступные источники |
| --- | --- |
| Владелец ключа API | Источники, предоставленные ключу, в том числе youtube_download при утверждении. |
| Временный ключ API | Только разрешённые источники, доступные в пробном режиме. Читайте scopes в текущем ответе проверки личности. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


<a id="import-key"></a>

### Сохранить ключ в CLI

Пропустите импорт, если у CLI уже есть доступ или ваш секретный менеджер поставляет FLASHDATA_API_KEY. В противном случае выберите метод ниже и сохраните тот же профиль исследования для более поздних команд. Сохраненный ключ CLI недоступен автоматически ни для SDK, ни для локальных серверов MCP.

#### Интерактивный терминал

Вставьте ключ в скрытый терминал.

##### Импортировать один раз

```bash
flashdata auth login --profile research
```


#### Автоматизация: Bash

Установите FLASHDATA_KEY_FILE на путь существующего защищенного файла ключа. Команда читает его через stdin; держите ключ в стороне от чата и командных аргументов.

##### Защищенный секрет с помощью stdin

```bash
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
```


- [Установка CLI](https://flashdata.dev/ru/docs/guides/flashdata-cli/reference.md#install)

<a id="verify"></a>

## 2. Проверить соединение

Запустите бесплатную проверку в окружающей среде, которая выполнит поставленную задачу. Проверки CLI и HTTP используют ключ API; проверка MCP использует собственное сохраненное соединение хоста.

### Bash / cURL

Требуется Bash и cURL 7.76+. Пропустите скрытый ключ, если ваша среда уже поставляет FLASHDATA_API_KEY. Запускайте команды чтения в том же терминале.

#### Установить ключ · пропустить, если уже настроен

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### Прочитать аккаунт JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

Пропустите скрытый ключ, если FLASHDATA_API_KEY уже установлен. Запускайте команды чтения в том же терминале.

#### Установить ключ · пропустить, если уже настроен

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### Прочитать аккаунт JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


### CLI

Используйте пользователя OS, профиль и каталог состояния из входа в систему. Замените исследование, если вы используете другой профиль; добавьте --state-dir PATH, если это необходимо. FLASHDATA_API_KEY перекрывает сохраненный ключ. Ожидайте ok: true и data.accessVerified: true; затем проверьте поля идентификации ниже.

#### Бесплатный аккаунт читать

```bash
flashdata auth status --profile research --json --non-interactive
```

- [Настройка ключа](https://flashdata.dev/ru/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

Отправьте это на новый сеанс вашего агента. Замените google_search на источник, необходимый для выполнения задачи. Ожидайте, что оба инструмента будут успешными; проверьте цены и баланс отдельно перед оплачиваемой работой. Один только перечисленный сервер не проверяет доступ.

#### Проверка соединения

```text
Используйте существующее соединение флэш-данных MCP.
Звоните get_pricing с {"source":"google_search","request_count":1}.
Звоните get_balance с {}.
Сообщите, удалось ли сделать оба звонка, есть ли у источника доступная цена.
и доступного кредитного баланса. Нулевой баланс не является ошибкой аутентификации.
Не запускайте поиск или загрузку, не создавайте пробную версию или не меняйте учетные данные.
```



<a id="identity-result"></a>

### Прочитайте ключ API

Поля идентификации HTTP находятся на верхнем уровне. В CLI JSON, прочитайте data.identity.identity и потребуйте data.accessVerified: true. Одного HTTP 200 или CLI ok: true недостаточно.

| Проверить | Необходимый результат |
| --- | --- |
| Предполагаемый счет | accountId и apiKeyId идентифицируют учетную запись и ключ, который вы намеревались использовать. |
| Удобный доступ | access: ready |
| Разрешение на задание | Сферы содержат источник, такой как google_search. CLI также содержит список разрешенных источников в data.identity.permittedSources. |
| Повторяющаяся задача | accountType: owned · installed: true · recurringAllowed: true |

- [Автоматизация этих проверок перед планированием](https://flashdata.dev/ru/docs/guides/agent-access/reference.md#recurring-check)

<a id="trial-result"></a>

### Активное исследование является действительным соединением

Пробный доступ может пройти проверку разовой задачи при recurringAllowed: false. Проверьте фактические разрешения и срок действия; привяжите существующий пробный доступ к аккаунту до настройки расписания.

#### Временная идентификация · иллюстративные поля

```json
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}
```


<a id="codex"></a>

### Найти соединение в Codex

Перечислите настроенные серверы, а затем используйте /mcp в новой сессии Codex. Запустите проверку MCP выше, чтобы проверить учетные данные.

#### Список серверов

```bash
codex mcp list
```

- [Настройка Codex и первая задача](https://flashdata.dev/ru/docs/integrations/codex/reference.md)

<a id="openclaw"></a>

### Проверьте соединение в OpenClaw

Проверьте сохраненный сервер, а затем запустите проверку MCP выше в вашем активном разговоре.

#### Проверить сервер

```bash
openclaw mcp doctor flashdata --probe
```

- [Настройка OpenClaw и первая задача](https://flashdata.dev/ru/docs/integrations/openclaw/reference.md)

<a id="refresh"></a>

## 3. Повторное использование доступа для более поздних задач

Держите хранилище учетных данных частным и постоянным при перезапуске процесса. Перепроверьте доступ в новом процессе, прежде чем включить планировщик.

| Полномочия | Для следующей задачи |
| --- | --- |
| Владелец ключа API | Повторное использование сохраненного ключа. У него нет шага обновления OAuth; замените его, если он истек или отменен. |
| MCP OAuth | Хост обновляет одночасовые токены доступа OAuth с помощью вращающихся токенов обновления. Повторное подключение, когда срок действия гранта 90 истекает или аннулируется. Каждая установка имеет свой магазин токенов; не делитесь файлами обновлений между хостами. |
| Временный ключ API | Завершите требование владельца и передачу полномочий перед повторной работой. Повторно используйте исходный профиль; не регистрируйтесь повторно для каждого запуска. |

- [Повторяющийся рабочий процесс задачи](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md)

<a id="recurring-check"></a>

### Проверьте задачу CLI перед планированием

Требуется Bash и jq. Установите источник для задания. Сценарий использует исследование по умолчанию; установите FLASHDATA_PROFILE и FLASHDATA_STATE_DIR для другого профиля или каталога состояния. Выход 0 с идентификационным номером JSON означает, что ключ владельца готов, установлен и разрешен для этого источника. Пусть ваш планировщик остановится на любом другом выходе. Запрос не подается.

#### Проверка доступа к новому процессу · Bash

```bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)
```

- [Добавьте цены, баланс и повторяющийся бегун](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md#prepare)

<a id="claim"></a>

### Если доступ все еще является пробным

Завершите испытание и заявляйте руководство с оригинальным профилем. После одобрения владельца и передачи учетных данных, бесплатный чек должен показывать доступ и recurringAllowed: true. Продолжительные запросы используют общий баланс владельца; неиспользованные пробные кредиты не передаются. Логин MCP OAuth является отдельным соединением и не претендует на эту пробную версию.

- [Команды пробного доступа и привязки](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

<a id="revoke"></a>

## Отменить доступ

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

| Подключение | Где отозвать |
| --- | --- |
| MCP OAuth | Settings → Connected apps → грант приложения. |
| Заявленный агент API ключ | Settings → Connected apps → Агентские соединения. |
| Ключ API | API Keys — ключ, используемый в этой интеграции. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [Устранение ошибок доступа](https://flashdata.dev/ru/docs/guides/troubleshooting/reference.md#credentials)

<a id="fixes"></a>

## Исправить неудавшийся чек

| Результат | Меры |
| --- | --- |
| accessVerified: false | Читать фазу и nextCommand. Отложенный профиль может вернуть ok: true до того, как ключ будет использоваться. Завершите сохраненную регистрацию или заявку; сохраните тот же профиль. |
| access: blocked | Остановитесь, даже если ответ HTTP был 200. Просмотрите учетную запись или соединение в консоли; не рассматривайте ответ на идентификацию как разрешение на запрос. |
| accountType: temporary | Используйте приемлемое испытание для разовой работы. Заявите об этом перед планированием; новое соединение OAuth не претендует на этот профиль. |
| installed: false | После одобрения владельца запустите флеш-данные auth finish --wait с исходным профилем и каталогом состояния. Затем повторите проверку. |
| 401 / invalid_grant | Воссоедините просроченные или аннулированные учетные данные в своем первоначальном хосте. Не начинайте еще одно испытание, чтобы обойти его. |
| 403 / source_forbidden | Проверьте области действия ключа или список источников OAuth. YouTube Download использует ключ владельца API. |
| Действительный доступ, нулевой баланс | Аутентификация работает. Проверьте Billing перед оплаченной работой; не заменяйте действительный ключ. |

- [Billing](https://flashdata.dev/app/billing)
- [Восстановление прерванного соединения](https://flashdata.dev/ru/docs/guides/agent-recovery/reference.md)
