Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Edge のパスワードのリセット

Edge for Private Cloud v4.19.01

インストールが完了したら、次のパスワードをリセットできます。

OpenLDAP
Apigee Edge システム管理者
Edge 組織ユーザー
Cassandra

これらのパスワードをリセットする手順については、以降のセクションをご覧ください。

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 を下回るため）。
パスワードの特性を識別する正規表現は次のとおりです。各ステップには番号が付けられています。たとえば、`password.validation.regex.5=...` は式番号 5 です。これらの数値は、ファイルの後のセクションで、パスワードの全体的な安全度を決定するさまざまな組み合わせを設定するために使用します。
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	各ルールには番号が付けられています。たとえば、`password.validation.rule.3=...` はルール番号 3 です。各ルールは次の形式（等号の右側）を使用します。 `regex-index-list`,[AND\|OR],`rating` `regex-index-list` は、正規表現のリスト（前のセクションの番号順）と `AND\|OR` 演算子（リストされているすべての式または任意の式を考慮することを意味します）です。 `rating` は、各ルールに割り当てられた数値の強度評価です。たとえば、ルール 5 は、1 つ以上の特殊文字または 1 つのアンダースコアを含むパスワードの強度評価が 4 になることを意味します。ファイルの先頭に `password.validation.minimum.rating.required=3` がある場合、評価が 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」ユーザーのパスワードを設定します。
1. 次のコマンドを使用して PostgreSQL データベースにログインします。
```
psql -h localhost -d apigee -U postgres
```
2. プロンプトが表示されたら、既存の「postgres」ユーザーのパスワードを「postgres」として入力します。
3. PostgreSQL コマンドプロンプトで、次のコマンドを入力してデフォルトのパスワードを変更します。
```
ALTER USER postgres WITH PASSWORD 'new_password';
```
  成功すると、PostgreSQL は次のレスポンスを返します。
```
ALTER ROLE
```
4. 次のコマンドを使用して PostgreSQL データベースを終了します。
```
\q
```
PostgreSQL の「apigee」ユーザーのパスワードを設定します。
1. 次のコマンドを使用して PostgreSQL データベースにログインします。
```
psql -h localhost -d apigee -U apigee
```
2. プロンプトが表示されたら、「apigee」ユーザーのパスワードとして「postgres」と入力します。
3. PostgreSQL コマンドプロンプトで、次のコマンドを入力してデフォルトのパスワードを変更します。
```
ALTER USER apigee WITH PASSWORD 'new_password';
```
4. 次のコマンドを使用して PostgreSQL データベースを終了します。
```
\q
```
「postgres」ユーザーと「apigee」ユーザーのパスワードは、同じ値に設定することも、異なる値に設定することもできます。

APIGEE_HOME を設定します。

export APIGEE_HOME=/opt/apigee/edge-postgres-server

新しいパスワードを暗号化します。
```
sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh new_password
```
このコマンドは、暗号化されたパスワードを返します。暗号化されたパスワードは「:」文字の後に始まり、「:」は含まれません。たとえば、「apigee1234」の暗号化されたパスワードは次のようになります。
```
Encrypted string:WheaR8U4OeMEM11erxA3Cw==
```
「postgres」ユーザーと「apigee」ユーザーの新しい暗号化パスワードを使用して、Management Server ノードを更新します。
1. Management Server で、ディレクトリを /opt/apigee/customer/application に変更します。
2. management-server.properties ファイルを編集して、次のプロパティを設定します。このファイルが存在しない場合は作成します。
  NOTE: 一部のプロパティは、暗号化された「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
3. ファイルの所有者が「apigee」ユーザーであることを確認します。
```
chown apigee:apigee management-server.properties
```
すべての Postgres Server ノードと Qpid Server ノードを新しい暗号化されたパスワードで更新します。
1. Postgres サーバーまたは Qpid サーバーのノードで、次のディレクトリに移動します。
```
/opt/apigee/customer/application
```
2. 編集する次のファイルを開きます。
  - postgres-server.properties
  - qpid-server.properties
  これらのファイルが存在しない場合は作成します。
3. ファイルに次のプロパティを追加します。
  NOTE: これらのプロパティはすべて、暗号化された「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
4. ファイルの所有者が「apigee」ユーザーであることを確認します。
```
chown apigee:apigee postgres-server.properties
chown apigee:apigee qpid-server.properties
```
SSO コンポーネントを更新します（SSO が有効になっている場合）。
1. apigee-sso コンポーネントが実行されているノードに接続するか、ログインします。これは SSO サーバーとも呼ばれます。
  
  AIO または 3 ノードのインストールでは、このノードは Management Server と同じノードです。
  
  apigee-sso コンポーネントを実行しているノードが複数ある場合は、各ノードでこれらの手順を実行する必要があります。
2. 次のファイルを編集用に開きます。
```
/opt/apigee/customer/application/sso.properties 
```
  ファイルが存在しない場合は作成します。
3. 次の行をファイルに追加します。
```
conf_uaa_database_password=new_password_in_plain_text
```
  次に例を示します。
```
conf_uaa_database_password=apigee1234
```
4. 次のコマンドを実行して、構成の変更を apigee-sso コンポーネントに適用します。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-sso configure
```
5. 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