Изменения в Cato API

Изменение: Обновленный API

Название функции: Выравнивание источников подключения политики доступа с API файервола Интернета и WAN

API политики приватного доступа (Бета) заменяет устаревшее полеconnectionOrigin (PrivateAccessPolicyOriginEnum) на connectionsOriginList (ConnectionOriginsEnum). Эти изменения применяются к policy.privateAccess.addRule, policy.privateAccess.updateRule, и к правилам, возвращаемым в ответах на запросы.

• Сайт, REMOTE_CLIENT, REMOTE_EXTENSION, и REMOTE_BROWSER остаются неизменными. Происхождение расширений и браузеров остаются зависимыми от доступности учетной записи

• Используйте пустой список вместо ANY для соответствия любому источнику подключения

• REMOTE и REMOTE_PORTAL не поддерживаются в новом поле

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

Устаревшее поле и перечисление будут удалены в будущих изменениях.

Для Terraform атрибут connection_origins и его значения остаются неизменными. Перед удалением будет опубликовано обновление для версии провайдера. После удаления старые версии провайдера не будут поддерживать операции политики частного доступа план/применение. Применение политики не влияет

Изменение: Обновленный API

Заголовок функции: Упрощенное администрирование пользователей через внешние рабочие процессы и системы управления идентификацией

API поддерживает активацию пользователей (enableUser) и отключение пользователей (disableUser).

Изменение: Обновленный API

Заголовок функции: Улучшенная аналитика для сгруппированных результатов API AppStats и События

При выполнении запроса к данным API AppStats или События и группировке по измерению, такому как страна или тип устройства, вы можете выбрать отображение записей без значения для этого измерения как пустой группы. Это помогает обеспечить согласованность итогов в запросах API и показывает ранее скрытые данные на панелях мониторинга CMA и в отчетах.

• Новый параметр уровня запроса: IncludeEmptyDimension, без воздействия на существующие скрипты API

• Применяется к запросам API и данным, показанным в CMA

Изменение: Обновленный API

Название функции: Обновления для appStats API для метрик качества работы приложений

Новые поля для API appStats доступны для метрик качества работы приложений, чтобы разрешить программный доступ к данным пользователя, хоста и приложений:

• experience_score_level - Индикатор агрегированной оценки качества работы

• ttfb - Время до первого байта, измеряет отзывчивость сервера

• tls_latency - Время установления соединения TLS

• tcp_latency - Время настройки соединения TCP

• http_latency - Концевая задержка запроса HTTP

• http_error_rate - Уровень HTTP ошибок

Примечание: Эти поля доступны только для клиентов с DEM-лицензией.

Изменение: Новый API

Название функции: Поддержка API для управления Webhook, списками рассылки и группами подписок

• Используйте следующие API для назначения, замены, обновления и удаления лицензий сайта через API для отдельных и пуловых лицензий

  • • Управляйте интеграциями webhook, используя createWebhook, updateWebhook, deleteWebhook, webhook, webhookList, и testWebhook

    • Управляйте списками рассылки, используя createMailingList , updateMailingList , deleteMailingList , mailingList , и mailingListList

    • Объедините webhooks и списки рассылки в группы подписки, используя createSubscriptionGroup , updateSubscriptionGroup , deleteSubscriptionGroup , subscriptionGroup , и subscriptionGroupList

  Для получения информации по управлению уведомлениями в CMA обратитесь к статьям базы знаний Уведомления

Изменение: Обновленный API

Заголовок функции: Обновления к SplitTunnelPolicyMutations

• Следующие API были изменены для более точного соответствия поведению функции в Приложение Управления Cato.

  • Эти изменения применяются ко всем мутациям для Политика Раздельного Туннеля: 

    • Exclude - изменено на RouteAllToCatoExcept

    • Include - изменено на RouteOnlySelected

    • Coverage - изменено на ConnectionMode

    • dnsExclusion - изменено на dnsSuffix

Эти API в настоящее время доступны в качестве бета-версии.

Изменение: Новый API

Название функции: Поддержка API для управления лицензиями на пропускную способность сайта

• Используйте следующие API для назначения, замены, обновления и удаления лицензий сайта через API для отдельных и пуловых лицензий

  • API изменения: 

    • assignSiteBwLicense - присваивает лицензию сайту

    • updateSiteBwLicense - для общих лицензий обновляет пропускную способность сайта

    • replaceSiteBwLicense - заменяет лицензию сайта без простоя

    • removeSiteBwLicense - удаляет лицензию с сайта

Эти API в настоящее время доступны в качестве бета-версии.

Изменение: Новый API

Название функции: Поддержка API для запроса Каталога приложений и типов контента DLP

• Каталог приложений - Запрос данных для приложений, включая Compliance, Security и CASB Activities:

  • catalogApplicationList - Все приложения и данные

  • catalogApplication - Одно приложение

• Контент DLP - Запрос типов контента для правила Инлайн защиты данных DLP

  • contentTypeGroupList

Эти API в настоящее время доступны в качестве бета-версии.

Изменение: Новый API

Название функции: Поддержка API для вторичного vSocket для HA конфигураций

• Используйте следующие API , чтобы установить вердикты историй, изменить статус и добавить комментарии

  • API изменения: 

    • addSecondaryAwsVSocketInput для AWS vSocket с конфигурацией HA добавляет вторичный vSocket

    • AddSecondaryAzureVSocketInput для AWS vSocket с конфигурацией HA добавляет вторичный vSocket

Эти API в настоящее время доступны в качестве бета-версии.

Изменение: Новый API

Название функции: Поддержка API для XDR историй и комментариев

• Используйте следующие API , чтобы установить вердикты историй, изменить статус и добавить комментарии

  • API изменения: 

    • addStoryComment Отправьте комментарии, которые помогут отслеживать расследование истории

    • analystFeedback Управляйте действиями по истории, такими как вердикт, тип и классификация истории.

    • deleteStoryComment Удалите ранее отправленный комментарий, используя ID комментария

Этот API в настоящее время доступен в Beta.

Изменение: Улучшение для API

Название функции: Установка значений пропускной способности сайта с одной десятичной точкой (например, 1,5 Мбит/с) для большей точности

• Используйте следующие API , чтобы установить вердикты историй, изменить статус и добавить комментарии

  • Затронутые типы для API: 

    • LastMileBwInput  

    • InterfaceInfo  

    • SocketInterfaceBandwidthInput  

Эти типы API в настоящее время доступны в Beta.

Изменение: Обновление значения Primary на Primary 1

Название функции: Поддержка API для сайтов IPsec IKEv2

Значение, полученное из поля InterfaceId в запросах accountSnapshot и accountMetrics, изменяется с началом постепенного выпуска поддержки конфигураций Active/Active 12 янв. 2025.

Изменение: Новый API

Название функции: Поддержка API для BGP Peering

• Используйте следующие API для упрощения настройки и мониторинга BGP пиров для сайтов

  • API изменения: 

    • addBgpPeer Добавьте новый пир BGP на сайт

    • updateBgpPeer Обновите настройки существующей конфигурации BGP пира

    • removeBgpPeer Удалите конфигурацию BGP пира для сайта

  • Query API: 

    • bgpPeer Получите информацию о конкретном пире BGP

    • siteBgpStatus Показать текущий статус BGP, включая детали сессии и информацию о маршруте

Этот API в настоящее время доступен в Beta.