Edge for Private Cloud v4.18.01
После завершения установки можно сбросить пароли системного администратора OpenLDAP и Apigee Edge, пользователя организации Edge и Cassandra.
Как сбросить пароль OpenLDAP
В зависимости от конфигурации Edge OpenLDAP можно установить как:
- Один экземпляр OpenLDAP, установленный на узле сервера управления. Например, в конфигурации Edge с двумя, пятью или девятью узлами.
- На узлах сервера управления установлено несколько экземпляров OpenLDAP, настроенных с репликацией OpenLDAP. Например, в конфигурации Edge с 12 узлами.
- Несколько экземпляров OpenLDAP, установленных на собственных узлах и настроенных с репликацией OpenLDAP. Например, в конфигурации Edge с 13 узлами.
Способ сброса пароля OpenLDAP зависит от вашей конфигурации.
Если на сервере управления установлен один экземпляр OpenLDAP, выполните следующие действия:
- На узле сервера управления выполните следующую команду, чтобы создать новый пароль OpenLDAP:
> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword - Выполните следующую команду, чтобы сохранить новый пароль для доступа к серверу управления:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword
Эта команда перезапускает сервер управления.
Если вы используете репликацию OpenLDAP с OpenLDAP, установленным на узлах сервера управления, выполните описанные выше действия на обоих узлах сервера управления, чтобы обновить пароль.
Если вы используете репликацию OpenLDAP, при которой OpenLDAP находится на узле, отличном от сервера управления, сначала измените пароль на обоих узлах OpenLDAP, а затем на обоих узлах сервера управления.
Как сбросить пароль системного администратора
Чтобы сбросить пароль системного администратора, вам нужно сделать это в двух местах:
- Сервер управления
- Интерфейс
Предупреждение. Перед сбросом пароля системного администратора Edge UI необходимо остановить. Поскольку вы сначала сбрасываете пароль на сервере управления, в течение короткого периода времени в интерфейсе может использоваться старый пароль. Если интерфейс пользователя выполнит более трех вызовов с использованием старого пароля, сервер OpenLDAP заблокирует аккаунт системного администратора на три минуты.
Чтобы сбросить пароль системного администратора:
- На узле интерфейса остановите интерфейс Edge:
> /opt/apigee/apigee-service/bin/apigee-service edge-ui stop - На сервере управления выполните следующую команду, чтобы сбросить пароль:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW - Измените файл конфигурации, который вы использовали для установки интерфейса Edge, чтобы задать следующие свойства:
APIGEE_ADMINPW=newPW
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y
SMTPMAILFROM="My Company <myco@company.com>"
Обратите внимание, что при передаче нового пароля необходимо включить свойства SMTP, поскольку все свойства в интерфейсе сбрасываются. - Чтобы сбросить пароль в интерфейсе Edge из файла конфигурации, используйте утилиту apigee-setup:
> /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile - (Только если TLS включен в интерфейсе) Снова включите TLS в интерфейсе Edge, как описано в разделе Настройка TLS для интерфейса управления.
В среде репликации OpenLDAP с несколькими серверами управления сброс пароля на одном из них автоматически обновит пароль на других серверах управления. Однако вам придется обновлять все узлы Edge UI по отдельности.
Как сбросить пароль пользователя организации
Чтобы сбросить пароль пользователя организации, используйте утилиту apigee-servce для вызова apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password [-h] [-u USER_EMAIL] [-p USER_PWD] [-a ADMIN_EMAIL] [-P APIGEE_ADMINPW] [-f configFile]
Пример:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password -u user@myCo.com -p foo12345 -a admin@myCo.com -P adminPword
Ниже приведен пример файла конфигурации, который можно использовать с параметром "-f":
USER_NAME= user@myCo.com USER_PWD= "foo12345" APIGEE_ADMINPW= adminPword
Вы также можете использовать API Update user (Обновить пользователя), чтобы изменить пароль пользователя.
Правила для паролей системного администратора и пользователей организации
В этом разделе можно задать требования к длине и надежности паролей для пользователей, управляющих API. В настройках используется ряд предварительно настроенных (и уникально пронумерованных) регулярных выражений для проверки содержимого пароля (например, заглавных и строчных букв, цифр и специальных символов). Запишите эти настройки в файл /opt/apigee/customer/application/management-server.properties. Если такого файла нет, создайте его.
После редактирования файла management-server.properties перезапустите сервер управления:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Затем вы можете задать уровни надежности паролей, сгруппировав разные комбинации регулярных выражений. Например, можно определить, что пароль, содержащий хотя бы одну прописную и одну строчную букву, получает оценку надежности "3", а пароль, содержащий хотя бы одну строчную букву и одну цифру, получает более высокую оценку "4".
|
Ресурсы |
Описание |
|---|---|
|
conf_security_password.validation.minimum. conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum. |
Используйте их, чтобы определить общие характеристики допустимых паролей. Минимальная оценка надежности пароля по умолчанию (описана ниже в таблице) – 3. Обратите внимание, что значение password.validation.default.rating=2 ниже минимального требуемого значения, поэтому, если введенный пароль не соответствует заданным вами правилам, он получит оценку 2 и будет считаться недействительным (ниже минимальной оценки 3). |
|
Ниже приведены регулярные выражения, которые определяют характеристики пароля. Обратите внимание, что каждый из них пронумерован. Например, "password.validation.regex.5=…" – это выражение № 5. Эти числа будут использоваться в более позднем разделе файла для настройки различных комбинаций, определяющих общую надежность пароля. |
|
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1 – все символы повторяются. |
|
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2 – хотя бы одна строчная буква. |
|
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3 – хотя бы одна заглавная буква. |
|
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4 – хотя бы одна цифра. |
|
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5 – хотя бы один специальный символ (кроме подчеркивания). |
|
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6 – хотя бы один символ подчеркивания. |
|
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$ |
7 – более одной строчной буквы. |
|
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$ |
8 – более одной заглавной буквы. |
|
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$ |
9 – более одной цифры. |
|
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10 – более одного специального символа (кроме символа подчеркивания). |
|
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11 – несколько символов подчеркивания |
|
Надежность пароля определяется по следующим правилам: Каждое правило включает одно или несколько регулярных выражений из предыдущего раздела и присваивает им числовое значение силы. Числовая надежность пароля сравнивается с числом conf_security_password.validation.minimum.rating.required в верхней части этого файла, чтобы определить, является ли пароль действительным. |
|
|
conf_security_password.validation.rule.1=1,AND,0 conf_security_password.validation.rule.2=2,3,4,AND,4 conf_security_password.validation.rule.3=2,9,AND,4 conf_security_password.validation.rule.4=3,9,AND,4 conf_security_password.validation.rule.5=5,6,OR,4 conf_security_password.validation.rule.6=3,2,AND,3 conf_security_password.validation.rule.7=2,9,AND,3 conf_security_password.validation.rule.8=3,9,AND,3 |
Каждое правило пронумеровано. Например, "password.validation.rule.3=…" – это правило № 3. Каждое правило имеет следующий формат (справа от знака равенства): <regex-index-list>,<AND|OR>,<rating> regex-index-list – это список регулярных выражений (по номеру из предыдущего раздела) вместе с оператором AND|OR (то есть учитывать все или любое из перечисленных выражений). rating – числовая оценка силы каждого правила. Например, правило 5 означает, что любой пароль, содержащий хотя бы один специальный символ ИЛИ одно подчеркивание, получает оценку надежности 4. С помощью правила password.validation.minimum. |
|
conf_security_rbac.password.validation.enabled=true |
Если включена система единого входа (SSO), установите для параметра проверки пароля при управлении доступом на основе ролей значение false. Значение по умолчанию – true. |
Сброс пароля Cassandra
По умолчанию аутентификация в Cassandra отключена. Если вы включите аутентификацию, будет использоваться предопределенный пользователь с именем cassandra и паролем cassandra. Вы можете использовать этот аккаунт, задать для него другой пароль или создать нового пользователя Cassandra. Добавляйте, удаляйте и изменяйте пользователей с помощью операторов Cassandra CREATE/ALTER/DROP USER.
Информацию о том, как включить аутентификацию Cassandra, можно найти в разделе Включение аутентификации Cassandra.
Чтобы сбросить пароль Cassandra, необходимо:
- Задайте пароль на любом узле Cassandra, и он будет передан всем узлам Cassandra в кольце.
- Обновите сервер управления, процессоры сообщений, маршрутизаторы, серверы Qpid, серверы Postgres и стек BaaS на каждом узле, используя новый пароль.
Дополнительную информацию можно найти на странице http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html.
Чтобы сбросить пароль Cassandra:
- Войдите в любой узел Cassandra, используя инструмент cqlsh и учетные данные по умолчанию. ?Вам нужно изменить пароль только на одном узле Cassandra, и он будет передан всем узлам Cassandra в кольце:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Где:- cassIP – IP-адрес узла Cassandra.
- 9042 – порт Cassandra.
- По умолчанию используется пользователь cassandra.
- Пароль по умолчанию – cassandra. Если вы меняли пароль ранее, используйте текущий.
- Выполните следующую команду в командной строке cqlsh>, чтобы обновить пароль:
cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Если новый пароль содержит одинарную кавычку, экранируйте ее, поставив перед ней одинарную кавычку. - Чтобы выйти из инструмента cqlsh, выполните следующие действия:
cqlsh> exit - На узле сервера управления выполните следующую команду:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD
При необходимости вы можете передать команде файл, содержащий новое имя пользователя и пароль:
> apigee-service edge-management-server store_cassandra_credentials -f configFile
где configFile содержит следующие строки:
CASS_USERNAME=CASS_USERNAME
CASS_PASSWORD=CASS_PASSWROD
Эта команда автоматически перезапускает сервер управления. - Повторите шаг 4 для следующих элементов:
- Все процессоры сообщений
- Все маршрутизаторы
- Все серверы Qpid (edge-qpid-server)
- Серверы Postgres (edge-postgres-server)
- На узле BaaS Stack для версии 4.16.05.04 и более поздних версий:
- Выполните следующую команду, чтобы создать зашифрованный пароль:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
Эта команда запросит у вас пароль в виде обычного текста и вернет зашифрованный пароль в следующем формате:
SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050 - Задайте следующие токены в файле /opt/apigee/customer/application/usergrid.properties.
Если такого файла нет, создайте его:
usergrid-deployment_cassandra.username=cassandra
usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
В этом примере используется имя пользователя по умолчанию для Cassandra. Если вы изменили имя пользователя, задайте соответствующее значение для параметра usergrid-deployment_cassandra.username.
Убедитесь, что пароль начинается с префикса SECURE:. В противном случае BaaS Stack интерпретирует значение как незашифрованное.
Примечание. У каждого узла стека BaaS есть собственный уникальный ключ, используемый для шифрования пароля. Поэтому зашифрованное значение необходимо генерировать на каждом узле BaaS Stack отдельно. - Измените владельца файла usergrid.properties на пользователя apigee:
> chown apigee:apigee /opt/apigee/customer/application/usergrid.properties - Настройте узел Stack:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure - Перезапустите стек BaaS:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart - Повторите эти шаги для всех узлов BaaS Stack.
- Выполните следующую команду, чтобы создать зашифрованный пароль:
Пароль Cassandra изменен.
Как сбросить пароль PostgreSQL
По умолчанию в базе данных PostgreSQL определены два пользователя: postgres и apigee. У обоих пользователей пароль по умолчанию – postgres. Чтобы изменить пароль по умолчанию, выполните следующие действия:
Измените пароль на всех основных узлах Postgres. Если у вас настроены два сервера Postgres в режиме "основной/резервный", вам нужно изменить пароль только на основном узле. Подробнее о том, как настроить репликацию "основной – резервный" для Postgres…
- На главном узле Postgres перейдите в каталог /opt/apigee/apigee-postgresql/pgsql/bin.
- Установите пароль пользователя postgres в PostgreSQL:
- Войдите в базу данных PostgreSQL, используя команду:
> psql -h localhost -d apigee -U postgres - Когда появится запрос, введите пароль пользователя postgres: postgres.
- В командной строке PostgreSQL введите следующую команду, чтобы изменить пароль по умолчанию:
apigee=> ALTER USER postgres WITH PASSWORD 'apigee1234'; - Выйдите из базы данных PostgreSQL, используя команду:
apigee=> \q
- Войдите в базу данных PostgreSQL, используя команду:
- Задайте пароль пользователя PostgreSQL apigee:
- Войдите в базу данных PostgreSQL, используя команду:
> psql -h localhost -d apigee -U apigee - Когда появится запрос, введите пароль пользователя apigee как postgres.
- В командной строке PostgreSQL введите следующую команду, чтобы изменить пароль по умолчанию:
apigee=> ALTER USER apigee WITH PASSWORD 'apigee1234'; - Выйдите из базы данных PostgreSQL, используя команду:
apigee=> \q
- Войдите в базу данных PostgreSQL, используя команду:
- Задайте значение переменной APIGEE_HOME:
> export APIGEE_HOME=/opt/apigee/edge-postgres-server - Зашифруйте новый пароль:
> sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234
Эта команда возвращает зашифрованный пароль, как показано ниже. Зашифрованный пароль начинается после символа ":" и не включает его.
Зашифрованная строка :WheaR8U4OeMEM11erxA3Cw== - Обновите узел сервера управления, указав новые зашифрованные пароли для пользователей postgres и apigee.
- На сервере управления перейдите в каталог /opt/apigee/customer/application.
- Измените файл management-server.properties, чтобы задать следующие свойства. Если этого файла нет, создайте его:
Примечание. Некоторые свойства принимают зашифрованный пароль пользователя postgres, а некоторые – зашифрованный пароль пользователя apigee.- conf_pg-agent_password=newEncryptedPasswordForPostgresUser
- conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
- conf_query-service_pgDefaultPwd=newEncryptedPasswordForApigeeUser
- conf_query-service_dwDefaultPwd=newEncryptedPasswordForApigeeUser
- conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Убедитесь, что владельцем файла является пользователь apigee:
> chown apigee:apigee management-server.properties
- Обновите все узлы Postgres Server и Qpid Server, используя новый зашифрованный пароль.
- На узле сервера Postgres или Qpid перейдите в каталог /opt/apigee/customer/application.
- Измените следующие файлы. Если этих файлов нет, создайте их:
- postgres-server.properties
- qpid-server.properties
- Добавьте к файлам следующие свойства:
Примечание. Для всех этих свойств используется зашифрованный пароль пользователя postgres.- conf_pg-agent_password=newEncryptedPasswordForPostgresUser
- conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
- conf_query-service_pgDefaultPwd=newEncryptedPasswordForPostgresUser
- conf_query-service_dwDefaultPwd=newEncryptedPasswordForPostgresUser
- conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Убедитесь, что файлы принадлежат пользователю apigee:
> chown apigee:apigee postgres-server.properties
> chown apigee:apigee qpid-server.properties
- Перезапустите следующие компоненты в указанном порядке:
- База данных PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Qpid Server:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart - Сервер Postgres:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart - Сервер управления:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- База данных PostgreSQL: