17.4.09 — Примечания к выпуску Edge для частного облака

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

С момента выхода предыдущего выпуска функционала Edge for Private Cloud произошли следующие релизы, которые включены в данный релиз:

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

Обзор релиза

Наиболее важной новой функцией в этом релизе является добавление поддержки языка разметки утверждений безопасности (SAML) 2.0 в качестве механизма аутентификации для Edge, API BaaS и портала служб разработчиков. Использование SAML с Edge позволяет поддерживать единый вход (SSO) для пользовательского интерфейса Edge и API, а также для любых других предоставляемых вами сервисов, которые также поддерживают SAML.

Аутентификация SAML предоставляет ряд преимуществ. Используя SAML, вы можете:

• Получите полный контроль над управлением пользователями. Когда пользователи покидают вашу организацию и их учетные данные централизованно удаляются, им автоматически отказывается в доступе к Edge.
• Настройте способ аутентификации пользователей для доступа к Edge. Вы можете выбрать разные типы аутентификации для разных организаций, использующих Edge.
• Контролируйте политики аутентификации. Ваш поставщик SAML может поддерживать политики аутентификации, которые в большей степени соответствуют стандартам вашей организации.
• Вы можете отслеживать входы в систему, выходы из системы, неудачные попытки входа и действия, представляющие высокий риск, в вашей системе Edge.
• Обратите внимание, что SAML используется только для аутентификации. Авторизация по-прежнему контролируется ролями пользователей Edge.

Дополнительную информацию см. в разделе «Поддержка SAML на периферии для частного облака» .

В этот релиз включен ряд других важных функций, в том числе:

• Возможность миграции портала «Сервисы для разработчиков» с Apache/MySQL на Postgres/Nginx.
• Команда для отключения TLS в пользовательском интерфейсе Edge.
• Новые параметры для настройки установки Edge.
• Пользовательские правила именования ключей и секретов потребителя
• Поддержка Red Hat/CentOS версии 7.4

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

Амортизация и списание активов

В этом выпуске следующие функции были признаны устаревшими или выведены из эксплуатации. Дополнительную информацию см. в политике устаревания Edge .

Амортизация

Снятие с эксплуатации защищенных хранилищ Apigee (хранилищ).

Защищенное хранилище Apigee, также известное как «хранилища ключей», устаревает и будет выведено из эксплуатации в апреле 2018 года. Хранилища ключей, обеспечивающие зашифрованное хранение пар ключ/значение, создаются с помощью API управления и доступны во время выполнения с помощью функций в модуле Node.js apigee-access.

Вместо защищенного хранилища используйте зашифрованные карты ключ-значение (KVM), как описано в разделе «Работа с картами ключ-значение» . Зашифрованные KVM так же безопасны, как и хранилища, и предоставляют больше возможностей для создания и извлечения данных. (MGMT-3848)

Устаревшая функция добавления путей на вкладке «Производительность» API-прокси.

До этой версии вы могли перейти к API-прокси в пользовательском интерфейсе управления, перейти на вкладку «Производительность» и создать различные пути для сравнения на основе диаграмм на вкладке «Производительность» прокси и на панели мониторинга «Бизнес-транзакции». Эта функция теперь недоступна в пользовательском интерфейсе. Альтернативный вариант этой функциональности см. в следующей статье сообщества Apigee: Альтернатива API бизнес-транзакций (EDGEUI-902).

Новые функции и обновления

Ниже перечислены новые функции и улучшения в этом выпуске. Помимо перечисленных улучшений, этот выпуск также содержит множество улучшений в плане удобства использования, производительности, безопасности и стабильности.

Частное облако

Добавлена ​​поддержка SAML в Edge, API BaaS и портал Developer Services.

Теперь Edge поддерживает язык разметки утверждений безопасности (SAML) 2.0 в качестве механизма аутентификации для Edge, API BaaS и портала служб разработчиков. SAML поддерживает среду единого входа (SSO). Используя SAML, вы можете поддерживать SSO для Edge в дополнение к любым другим предоставляемым вами сервисам, которые также поддерживают SAML.

См. раздел «Поддержка SAML на периферии для частного облака» .

Добавлена ​​утилита apigee-ssoadminapi.sh.

После включения SAML вы можете использовать новый скрипт apigee-ssoadminapi.sh для выполнения многих административных задач, таких как создание пользователей и организаций.

См. раздел «Использование apigee-ssoadminapi.sh» .

(DOS-5118)

Теперь можно перенести портал Developer Services с Apache/MySQL/MariaDB на Nginx/postgres.

В установке портала Developer Services на основе архива .tar используются Apache и MySQL или MariaDB. Теперь вы можете перенести существующую установку портала на использование Nginx и Postgres. Эта миграция необходима, если вы хотите обновить портал до версии 4.17.09.

См. раздел «Преобразование портала на основе tar-архива в портал на основе RPM-архива» .

Добавлена ​​поддержка Red Hat/CentOS версии 7.4.

Теперь вы можете развернуть Edge для частного облака, API BaaS и портала Developer Services на Red Hat/CentOS версии 7.4.

См. раздел «Поддерживаемое программное обеспечение и поддерживаемые версии» .

Добавлено свойство, позволяющее установщику проверять требования к процессору и памяти во время установки.

В файле конфигурации установки Edge теперь поддерживается следующее свойство:

ENABLE_SYSTEM_CHECK=y 

Если значение равно "y", установщик проверяет, соответствует ли система требованиям к процессору и памяти для устанавливаемого компонента. Требования к каждому компоненту см. в разделе "Требования к установке" . Значение по умолчанию - "n", проверка отключена.

См. Справочник по файлам конфигурации Edge .

(DOS-4772)

Добавлена ​​опция, позволяющая выбрать IP-адрес, используемый установщиком на сервере с несколькими сетевыми картами.

Если сервер имеет несколько сетевых карт, команда "hostname -i" возвращает список IP-адресов, разделенных пробелами. По умолчанию установщик Edge использует первый возвращенный IP-адрес, что может быть некорректно во всех ситуациях. В качестве альтернативы можно установить следующее свойство в файле конфигурации установки:

ENABLE_DYNAMIC_HOSTIP=y

Если для этого параметра установлено значение "y", установщик предложит вам выбрать IP-адрес, который будет использоваться при установке. Значение по умолчанию — "n".

См. Справочник по файлам конфигурации Edge .

(DOS-5117)

Доступны новые параметры пользовательского интерфейса и API для настройки TLS.

Бета-версия новой функции самообслуживания TLS/SSL для облака теперь доступна в частном облаке в качестве бета-функции. Используя эту бета-версию, вы можете:

• Создавайте, изменяйте и удаляйте хранилища ключей и доверенных сертификатов как в пользовательском интерфейсе, так и через API.
• Загрузите TLS-сертификаты в формате PKCS12/PFX.
• Генерируйте самоподписанные сертификаты через пользовательский интерфейс или API.
• Проверьте корректность хранилища ключей или доверенных сертификатов в пользовательском интерфейсе.

Документация по бета-версии (PDF) этих функций доступна по адресу:

• Использование пользовательского интерфейса Edge Cloud для создания хранилищ ключей и доверенных сертификатов.
• Использование Edge API для создания хранилищ ключей и доверенных сертификатов.

Для получения более подробной информации обратитесь к дополнительной документации (PDF):

• Параметры настройки TLS
• Настройка доступа по протоколу TLS к API для облачных сервисов.
• Настройка TLS от Edge к бэкэнду
• Обновить TLS-сертификат для облака

(EDGEUI-1058)

Добавлена ​​команда для зашифрованного пароля.

Добавлена ​​команда для генерации зашифрованного пароля, позволяющая любому компоненту генерировать зашифрованный пароль. Сгенерировать зашифрованный пароль можно с помощью следующей команды на сервере управления Edge:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Введите новый пароль, а затем подтвердите его в командной строке. В целях безопасности текст пароля не отображается. Эта команда вернет пароль в следующем формате:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

См. раздел «Настройка TLS/SSL для локальной среды Edge» .

(TBD-250)

Добавлена ​​новая команда для маскировки нового пароля при изменении пароля пользователя организации.

Для сброса пароля пользователя организации теперь можно использовать утилиту apigee-service для вызова apigee-openldap :

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Вам будет предложено ввести пароль системного администратора, а затем пароль нового пользователя. Из соображений безопасности текст паролей не отображается по мере их ввода.

См. раздел «Сброс паролей Edge» .

(DBS-1733)

Добавить команду для отключения TLS в пользовательском интерфейсе Edge.

Теперь вы можете использовать следующую команду для отключения TLS в пользовательском интерфейсе Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

См. раздел «Настройка TLS» для интерфейса управления .

(EDGEUI-1114)

Добавлено свойство для управления форматом метки времени в сообщениях журнала.

По умолчанию метка времени в сообщениях журнала, создаваемых политикой ведения журнала сообщений, имеет следующий формат:

yyyy-MM-dd'T'HH:mm:ss.sssZ

Например:

2017-05-08T13:33:00.000+0000

Для управления этим форматом можно использовать свойство conf_system_apigee.syslogger.dateFormat в обработчике сообщений Edge.

См. политику ведения журнала сообщений .

(APIRT-4196)

Добавлен новый обязательный параметр конфигурации SMTP для установки API BaaS.

Теперь необходимо использовать параметр SMTPMAILFROM в файле конфигурации установки API BaaS. Этот параметр указывает адрес электронной почты, используемый при отправке автоматических писем API BaaS, например, когда пользователь запрашивает сброс пароля.

См. Справочник по конфигурационным файлам BaaS .

(APIBAAS-2103)

Добавлена ​​поддержка доступа к портам ниже 1000 для пограничного маршрутизатора и веб-сервера Nginx, используемых порталом.

Теперь вы можете использовать маршрутизатор и веб-сервер Nginx для доступа к портам ниже 1000 без необходимости запуска их от имени другого пользователя. В предыдущих версиях маршрутизатор и веб-сервер Nginx не могли получить доступ к портам ниже 1000 без запуска их от имени специального пользователя.

Изменен способ настройки уровня логирования для пользовательского интерфейса Edge.

Изменились параметры, используемые для настройки уровня логирования для пользовательского интерфейса Edge. См. раздел «Настройка уровня логирования для компонента Edge» для получения информации о новых параметрах и порядке действий.

(EDGEUI-886)

API-сервисы

Пользовательские правила именования ключей и секретов потребителя

Внесены изменения в правила именования и проверки для создания пользовательского ключа и секрета потребителя для приложения разработчика . Ключи и секреты потребителя могут содержать буквы, цифры, подчеркивания и дефисы. Другие специальные символы не допускаются.

Процесс создания пользовательского ключа/секрета более подробно описан в документе «Импорт существующих ключей и секретов потребителей » (MGMT-3916).

Проверка имен хранилища ключей и целевого сервера

Имена хранилищ ключей и целевых серверов могут содержать максимум 255 символов и включать буквы, цифры, пробелы, дефисы, подчеркивания и точки. Edge теперь проверяет это при создании. (MGMT-4098)

Исправлены ошибки

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

Частное облако 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (управление API и среда выполнения)

Облако 17.07.31 (управление API)

Cloud 17.07.17 (управление API и среда выполнения)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Облако 17.05.22.01 (Монетизация)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (управление API)

Cloud 17.05.08 (UI)

Облако 17.04.22 (управление API)

Известные проблемы

В данной версии обнаружены следующие известные проблемы: