インストールが完了したら、次のパスワードをリセットできます。
これらのパスワードをリセットする手順については、以降のセクションをご覧ください。
OpenLDAP パスワードをリセットする
OpenLDAP パスワードをリセットする方法は、構成によって異なります。Edge の構成に応じて、OpenLDAP は次のようにインストールできます。
- Management Server ノードにインストールされた OpenLDAP の単一インスタンス。たとえば、2 ノード、5 ノード、9 ノードの Edge 構成です。
- Management Server ノードにインストールされ、OpenLDAP レプリケーションで構成された複数の OpenLDAP インスタンス。たとえば、12 ノードの Edge 構成の場合。
- 独自のノードにインストールされ、OpenLDAP レプリケーションで構成された複数の OpenLDAP インスタンス。たとえば、13 ノードの Edge 構成の場合。
Management Server にインストールされている OpenLDAP の単一インスタンスに対して、次の操作を行います。
- Management Server ノードで、次のコマンドを実行して新しい OpenLDAP パスワードを作成します。
/opt/apigee/apigee‑service/bin/apigee‑service apigee‑openldap \ change‑ldap‑password ‑o OLD_PASSWORD ‑n NEW_PASSWORD
- 次のコマンドを実行して、Management Server がアクセスできるように新しいパスワードを保存します。
/opt/apigee/apigee‑service/bin/apigee‑service edge‑management‑server \ store_ldap_credentials ‑p NEW_PASSWORD
このコマンドは、Management Server を再起動します。
Management Server ノードに OpenLDAP がインストールされている OpenLDAP レプリケーション設定では、両方の Management Server ノードで上記の手順に沿ってパスワードを更新します。
OpenLDAP が Management Server 以外のノードにある OpenLDAP レプリケーション設定では、まず両方の OpenLDAP ノードでパスワードを変更してから、両方の Management Server ノードでパスワードを変更します。
システム管理者パスワードをリセットする
システム管理者パスワードをリセットするには、次の 2 つの場所でパスワードをリセットする必要があります。
- 管理サーバー
- UI
システム管理者パスワードをリセットするには:
- Edge UI のインストールに使用したサイレント構成ファイルを編集して、次のプロパティを設定します。
APIGEE_ADMINPW=NEW_PASSWORD SMTPHOST=smtp.gmail.com SMTPPORT=465 SMTPUSER=foo@gmail.com SMTPPASSWORD=bar SMTPSSL=y SMTPMAILFROM="My Company <myco@company.com>"
UI のすべてのプロパティがリセットされるため、新しいパスワードを渡すときに SMTP プロパティを含める必要があります。
- UI ノードで、Edge UI を停止します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui stop
apigee-setupユーティリティを使用して、構成ファイルから Edge UI のパスワードをリセットします。/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
- (UI で TLS が有効になっている場合のみ)管理 UI の TLS の構成の説明に従って、Edge UI で TLS を再度有効にします。
- Management Server で、新しい XML ファイルを作成します。このファイルで、ユーザー ID を「admin」に設定し、次の形式でパスワード、名、姓、メールアドレスを定義します。
<User id="admin"> <Password><![CDATA[password]]></Password> <FirstName>first_name</FirstName> <LastName>last_name</LastName> <EmailId>email_address</EmailId> </User>
- Management Server で、次のコマンドを実行します。
curl ‑u "admin_email_address:admin_password" ‑H \ "Content‑Type: application/xml" ‑H "Accept: application/json" ‑X POST \ "http://localhost:8080/v1/users/admin_email_address" ‑d @your_data_file
ここで、your_data_file は前の手順で作成したファイルです。
Edge が Management Server の管理者パスワードを更新します。
- 作成した XML ファイルを削除します。パスワードは、クリアテキストで永続的に保存しないでください。
複数の Management Server が存在する OpenLDAP レプリケーション環境では、1 つの Management Server でパスワードをリセットすると、他の Management Server も自動的に更新されます。ただし、すべての 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
cp ~/Documents/tmp/hybrid_root/apigeectl_beta2_a00ae58_linux_64/README.md ~/Documents/utilities/README.md
「-f」オプションで使用できる構成ファイルの例を次に示します。
USER_NAME=user@myCo.com USER_PWD="Foo12345" APIGEE_ADMINPW=ADMIN_PASSWORD
Update user API を使用してユーザー パスワードを変更することもできます。
SysAdmin と組織ユーザーのパスワード ルール
このセクションでは、API 管理ユーザーに、必要なレベルのパスワードの長さと強度を適用します。この設定では、一連の事前構成された(一意の番号が付けられた)正規表現を使用して、パスワードの内容(大文字、小文字、数字、特殊文字など)をチェックします。これらの設定を /opt/apigee/customer/application/management-server.properties ファイルに書き込みます。このファイルが存在しない場合は作成します。
management-server.properties を編集した後、Management Server を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
次に、正規表現のさまざまな組み合わせをグループ化して、パスワードの安全度の評価を設定できます。たとえば、大文字と小文字をそれぞれ 1 文字以上含むパスワードの強度評価を「3」とし、小文字と数字をそれぞれ 1 文字以上含むパスワードの強度評価を「4」とすることができます。
| プロパティ | 説明 |
|---|---|
conf_security_password.validation.minimum.password.length=8 conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum.rating.required=3 |
これらを使用して、有効なパスワードの全体的な特性を判断します。パスワードの安全度のデフォルトの最小評価(表の後半で説明)は 3 です。 password.validation.default.rating=2 は、必要な最小評価よりも低くなっています。つまり、入力されたパスワードが構成したルールに適合しない場合、パスワードは 2 と評価され、無効になります(最小評価の 3 を下回るため)。 |
|
パスワードの特性を識別する正規表現は次のとおりです。各ステップには番号が付けられています。たとえば、 |
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1: すべての文字が繰り返される |
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2: 少なくとも 1 つの小文字 |
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3: 1 文字以上の大文字 |
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4: 1 桁以上 |
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5: 1 つ以上の特殊文字(アンダースコア _ を除く) |
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6: 1 つ以上のアンダースコア |
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: 2 桁以上 |
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10: 複数の特殊文字(アンダースコアを除く) |
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11: 複数のアンダースコア |
|
パスワードの内容に基づいてパスワードの安全度を判断するルールは次のとおりです。 各ルールには、前のセクションの正規表現が 1 つ以上含まれており、数値の強度が割り当てられます。パスワードの数値強度は、このファイルの先頭にある 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 |
各ルールには番号が付けられています。たとえば、 各ルールは次の形式(等号の右側)を使用します。 regex-index-list,[AND|OR],rating regex-index-list は、正規表現のリスト(前のセクションの番号順)と rating は、各ルールに割り当てられた数値の強度評価です。 たとえば、ルール 5 は、1 つ以上の特殊文字または 1 つのアンダースコアを含むパスワードの強度評価が 4 になることを意味します。ファイルの先頭に |
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 ノードにブロードキャストされます。
- 各ノードの Management Server、Message Processor、Router、Qpid サーバー、Postgres サーバーを新しいパスワードで更新します。
詳細については、http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html をご覧ください。
Cassandra のパスワードをリセットするには:
cqlshツールとデフォルトの認証情報を使用して、任意の Cassandra ノードにログインします。1 つの Cassandra ノードでパスワードを変更するだけで、リング内のすべての Cassandra ノードにブロードキャストされます。/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p 'cassandra'
ここで
cassIPは Cassandra ノードの IP アドレスです。9042は Cassandra ポートです。- デフォルトのユーザーは
cassandraです。 - デフォルトのパスワードは「
cassandra」です。以前にパスワードを変更した場合は、現在のパスワードを使用します。パスワードに特殊文字が含まれている場合は、一重引用符で囲む必要があります。
cqlsh>プロンプトで次のコマンドを実行して、パスワードを更新します。ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
新しいパスワードに一重引用符が含まれている場合は、その前に一重引用符を付けてエスケープします。
cqlshツールを終了します。exit
- Management Server ノードで、次のコマンドを実行します。
/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'
このコマンドにより、Management Server が自動的に再起動されます。
- 次のデバイスでステップ 4 を繰り返します。
- すべての Message Processor
- すべてのルーター
- すべての Qpid サーバー(edge-qpid-server)
- Postgres サーバー(edge-postgres-server)
Cassandra のパスワードが変更されました。
PostgreSQL のパスワードをリセットする
デフォルトでは、PostgreSQL データベースには「postgres」と「apigee」の 2 つのユーザーが定義されています。どちらのユーザーもデフォルトのパスワードは「postgres」です。デフォルトのパスワードを変更するには、次の手順を行います。
すべての Postgres マスターノードでパスワードを変更します。2 つの Postgres サーバーがマスター/スタンバイ モードで構成されている場合は、マスターノードのパスワードのみを変更する必要があります。詳細については、Postgres のマスター / スタンバイ レプリケーションを設定するをご覧ください。
- マスター Postgres ノードで、ディレクトリを
/opt/apigee/apigee-postgresql/pgsql/binに変更します。 - PostgreSQL の「postgres」ユーザーのパスワードを設定します。
- 次のコマンドを使用して PostgreSQL データベースにログインします。
psql -h localhost -d apigee -U postgres
- プロンプトが表示されたら、既存の「postgres」ユーザーのパスワードを「postgres」として入力します。
- PostgreSQL コマンド プロンプトで、次のコマンドを入力してデフォルトのパスワードを変更します。
ALTER USER postgres WITH PASSWORD 'new_password';
成功すると、PostgreSQL は次のレスポンスを返します。
ALTER ROLE
- 次のコマンドを使用して PostgreSQL データベースを終了します。
\q
- 次のコマンドを使用して PostgreSQL データベースにログインします。
- PostgreSQL の「apigee」ユーザーのパスワードを設定します。
- 次のコマンドを使用して PostgreSQL データベースにログインします。
psql -h localhost -d apigee -U apigee
- プロンプトが表示されたら、「apigee」ユーザーのパスワードとして「postgres」と入力します。
- PostgreSQL コマンド プロンプトで、次のコマンドを入力してデフォルトのパスワードを変更します。
ALTER USER apigee WITH PASSWORD 'new_password';
- 次のコマンドを使用して PostgreSQL データベースを終了します。
\q
「postgres」ユーザーと「apigee」ユーザーのパスワードは、同じ値に設定することも、異なる値に設定することもできます。
- 次のコマンドを使用して PostgreSQL データベースにログインします。
APIGEE_HOMEを設定します。export APIGEE_HOME=/opt/apigee/edge-postgres-server
- 新しいパスワードを暗号化します。
sh /opt/apigee/edge-analytics/utils/scripts/utilities/passwordgen.sh new_password
このコマンドは、暗号化されたパスワードを返します。暗号化されたパスワードは「:」文字の後に始まり、「:」は含まれません。たとえば、「apigee1234」の暗号化されたパスワードは次のようになります。
Encrypted string:WheaR8U4OeMEM11erxA3Cw==
- 「postgres」ユーザーと「apigee」ユーザーの新しい暗号化パスワードを使用して、Management Server ノードを更新します。
- Management Server で、ディレクトリを
/opt/apigee/customer/applicationに変更します。 management-server.propertiesファイルを編集して、次のプロパティを設定します。このファイルが存在しない場合は作成します。- ファイルの所有者が「apigee」ユーザーであることを確認します。
chown apigee:apigee management-server.properties
- Management Server で、ディレクトリを
- すべての Postgres Server ノードと Qpid Server ノードを新しい暗号化されたパスワードで更新します。
- Postgres サーバーまたは Qpid サーバーのノードで、次のディレクトリに移動します。
/opt/apigee/customer/application
- 編集する次のファイルを開きます。
postgres-server.propertiesqpid-server.properties
これらのファイルが存在しない場合は作成します。
- ファイルに次のプロパティを追加します。
conf_pg-agent_password=newEncryptedPasswordForPostgresUserconf_pg-ingest_password=newEncryptedPasswordForPostgresUserconf_query-service_pgDefaultPwd=newEncryptedPasswordForPostgresUserconf_query-service_dwDefaultPwd=newEncryptedPasswordForPostgresUserconf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- ファイルの所有者が「apigee」ユーザーであることを確認します。
chown apigee:apigee postgres-server.properties
chown apigee:apigee qpid-server.properties
- Postgres サーバーまたは Qpid サーバーのノードで、次のディレクトリに移動します。
- SSO コンポーネントを更新します(SSO が有効になっている場合)。
apigee-ssoコンポーネントが実行されているノードに接続するか、ログインします。これは SSO サーバーとも呼ばれます。AIO または 3 ノードのインストールでは、このノードは Management Server と同じノードです。
apigee-ssoコンポーネントを実行しているノードが複数ある場合は、各ノードでこれらの手順を実行する必要があります。- 次のファイルを編集用に開きます。
/opt/apigee/customer/application/sso.properties
ファイルが存在しない場合は作成します。
- 次の行をファイルに追加します。
conf_uaa_database_password=new_password_in_plain_text
次に例を示します。
conf_uaa_database_password=apigee1234
- 次のコマンドを実行して、構成の変更を
apigee-ssoコンポーネントに適用します。/opt/apigee/apigee-service/bin/apigee-service apigee-sso configure
- SSO サーバーごとにこの手順を繰り返します。
- 次のコンポーネントを次の順序で再起動します。
- PostgreSQL データベース:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Qpid サーバー:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- Postgres サーバー:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- Management Server:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- SSO サーバー:
/opt/apigee/apigee-service/bin/apigee-service apigee-sso restart
- PostgreSQL データベース: