Аутентификация

Для работы Cyberstrike требуется аутентификация хотя бы с одним ИИ-провайдером. В этом руководстве описана настройка учётных данных для поддерживаемых провайдеров.

Подключение провайдера

Самый простой способ аутентификации — выполните в TUI:

/connect

Выберите провайдера из интерактивного меню:

? Select provider
❯ cyberstrike (recommended)
  anthropic (Claude Max or API key)
  github-copilot
  openai (ChatGPT Plus/Pro or API key)
  google
  openrouter
  …

Список формируется динамически из каталога моделей и упорядочен по приоритету, поэтому конкретные пункты могут отличаться. Это поле с автодополнением, а не фиксированное меню.

Настройка по провайдерам

Anthropic

Получите API-ключ на console.anthropic.com
Выполните /connect, выберите Anthropic, введите API-ключ

OpenAI

Получите API-ключ на platform.openai.com
Выполните /connect, выберите OpenAI, введите API-ключ

GitHub Copilot

Имейте активную подписку GitHub Copilot
Выполните /connect, выберите Login with GitHub Copilot
Авторизуйтесь через OAuth-процесс в браузере — API-ключ не нужен

Подробнее см. GitHub Copilot.

OpenRouter

OpenRouter предоставляет доступ к множеству моделей с бесплатным планом:

Получите API-ключ на openrouter.ai/keys
Выполните /connect, выберите OpenRouter, введите API-ключ

Google Gemini

Получите API-ключ на ai.google.dev
Выполните /connect, выберите Google, введите API-ключ

Ollama (Локально)

Ollama не требует API-ключа, но должен быть запущен локально:

# Запустить Ollama
ollama serve

# Скачать модель
ollama pull llama3.3

Затем используйте /models для выбора модели Ollama.

Переменные окружения

Установите учётные данные через переменные окружения для CI/CD или автоматизации:

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI
export OPENAI_API_KEY="sk-..."

# Google
export GOOGLE_GENERATIVE_AI_API_KEY="AI..."

# OpenRouter
export OPENROUTER_API_KEY="sk-or-..."

# Groq
export GROQ_API_KEY="gsk_..."

Добавьте в профиль оболочки для сохранения:

# ~/.bashrc или ~/.zshrc
export ANTHROPIC_API_KEY="sk-ant-..."

Файл конфигурации

Храните учётные данные в файле конфигурации:

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

Tip

Используйте синтаксис {env:VAR_NAME} для ссылки на переменные окружения в файлах конфигурации.

Управление учётными данными

Просмотр статуса

Используйте /status в TUI для просмотра подключённых провайдеров и активных учётных данных.

Смена модели

Используйте /models для переключения между моделями любого подключённого провайдера. Или установите значение по умолчанию в конфигурации:

{
  "model": "anthropic/claude-sonnet-4-20250514"
}

Корпоративная аутентификация

AWS Bedrock

# Настройка учётных данных AWS
aws configure

# Или через переменные окружения
export AWS_ACCESS_KEY_ID="..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"

Затем выполните /connect и выберите Amazon Bedrock.

Azure OpenAI

export AZURE_API_KEY="..."
export AZURE_RESOURCE_NAME="your-resource"

Google Vertex AI

gcloud auth application-default login

Лучшие практики безопасности

Никогда не коммитьте API-ключи в систему контроля версий
Используйте переменные окружения для конфиденциальных значений
Регулярно ротируйте ключи для безопасности
Используйте ключи с ограниченными правами когда это возможно
Отслеживайте использование в панели управления провайдера

Устранение неполадок

Недействительный API-ключ

Error: Invalid API key

Убедитесь, что ключ правильный (без лишних пробелов)
Проверьте, не истёк ли срок действия ключа
Убедитесь, что биллинг активен у провайдера

Превышение лимитов

Error: Rate limit exceeded

Подождите и повторите попытку
Проверьте лимиты в панели управления провайдера
Рассмотрите обновление плана

Проблемы с сетью

Error: Connection refused

Проверьте интернет-соединение
Убедитесь, что прокси/файрвол не блокирует подключение
Попробуйте другую сеть