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

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

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

SymasLDAP パスワードを再設定する

SymasLDAP パスワードの再設定方法は、構成によって異なります。Edge の構成 に応じて、SymasLDAP は次のようにインストールできます。

  • Management Server ノードにインストールされた SymasLDAP の単一インスタンス。たとえば、 2 ノード、5 ノード、9 ノードの Edge 構成などです。
  • Management Server ノードにインストールされ、SymasLDAP レプリケーションで構成された複数の SymasLDAP インスタンス。たとえば、12 ノードの Edge 構成などです。
  • 独自のノードにインストールされ、SymasLDAP レプリケーションで構成された複数の SymasLDAP インスタンス。たとえば、13 ノードの Edge 構成などです。

Management Server にインストールされた SymasLDAP の単一インスタンスの場合は、次の操作を行います。

  1. Management Server ノードで次のコマンドを実行して、新しい SymasLDAP password: を作成します。
    /opt/apigee/apigee‑service/bin/apigee‑service apigee‑openldap \ 
      change‑ldap‑password ‑o OLD_PASSWORD ‑n NEW_PASSWORD
  2. 次のコマンドを実行して、Management Server がアクセスするための新しいパスワードを保存します。
    /opt/apigee/apigee‑service/bin/apigee‑service edge‑management‑server \ 
      store_ldap_credentials ‑p NEW_PASSWORD

    このコマンドを実行すると、Management Server が再起動します。

Management Server ノードに SymasLDAP がインストールされた SymasLDAP レプリケーションの設定では、両方の Management Server ノードで上記の手順に沿ってパスワードを更新します。

Management Server 以外のノードに SymasLDAP がある SymasLDAP レプリケーションの設定 では、まず両方の SymasLDAP ノードでパスワードを変更してから、両方の Management Server ノードでパスワードを変更します。

システム管理者のパスワードを再設定する

システム管理者のパスワードを再設定するには、次の 2 か所でパスワードを再設定する必要があります。

  • 管理サーバー
  • 新しい Edge UI

システム管理者のパスワードを再設定するには:

  1. 新しい 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>"

    新しいパスワードを渡すときは、SMTP プロパティを含める必要があります。これは、新しい Edge UI のすべての プロパティがリセットされるためです。

  2. 新しい Edge UI ノードで、新しい Edge UI を停止します。
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  3. apigee-setup ユーティリティを使用して、構成ファイルから新しい Edge UI のパスワードを再設定します。
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
  4. (新しい Edge UI で TLS が有効になっている場合のみ) 新しい Edge UI の TLS の構成の説明 に沿って、新しい Edge UI で TLS を再度有効にします。
  5. 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>
  6. 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 の管理者パスワードを更新します。

  7. 作成した XML ファイルを削除します。パスワードは、平文で永続的に保存しないでください。

複数の Management Server を使用する SymasLDAP レプリケーション 環境では、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

ユーザー パスワードを変更するには、ユーザーの更新 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: 小文字が 2 文字以上

conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$

8: 大文字が 2 文字以上

conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$

9: 数字が 2 文字以上

conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$

10: 特殊文字が 2 文字以上(アンダースコアを除く)

conf_security_password.validation.regex.11=^.*[_]{2,}.*$

11: アンダースコアが 2 文字以上

次のルールでは、パスワードの内容に基づいてパスワードの安全度を決定します。各ルールには、前のセクションの正規表現が 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 文字以上含まれるパスワードの強度の評価が 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、ルーター、Qpid サーバー、Postgres サーバーを新しいパスワードで更新します。

詳細については、CQL コマンドをご覧ください。

Cassandra パスワードを再設定するには:

  1. cqlsh ツールとデフォルト の認証情報を使用して、いずれかの Cassandra ノードにログインします。Cassandra ノードでパスワードを変更するだけで、リング内のすべての Cassandra ノードにブロードキャストされます。
    /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p 'cassandra'

    ここで

    • cassIP は Cassandra ノードの IP アドレスです。
    • 9042 は Cassandra ポートです。
    • デフォルトのユーザーは cassandra です。
    • デフォルトのパスワードは 'cassandra' です。以前にパスワードを変更した場合は、 現在のパスワードを使用します。パスワードに特殊文字が含まれている場合は、 単一引用符で囲む必要があります。
  2. cqlsh> プロンプトで次のコマンドを実行して、パスワードを更新します。
    ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

    新しいパスワードに単一引用符が含まれている場合は、単一引用符を前に付けてエスケープします。

  3. cqlsh ツールを終了します。
    exit
  4. 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 が自動的に再起動します。

  5. 次の手順 4 を繰り返します。
    • すべての Message Processor
    • すべてのルーター
    • すべての Qpid サーバー(edge-qpid-server)
    • Postgres サーバー(edge-postgres-server)

これで、Cassandra パスワードが変更されました。

PostgreSQL パスワードを再設定する

デフォルトでは、PostgreSQL データベースには postgres と apigee の 2 つのユーザーが定義されています。 どちらのユーザーもデフォルトのパスワードは postgres です。デフォルトのパスワードを変更するには、次の手順を行います。

すべての Postgres マスターノードでパスワードを変更します。マスター/スタンバイ モードで 2 つの Postgres サーバーが構成されている 場合は、マスターノードのパスワードを変更するだけで済みます。詳細については、 Postgres のマスター / スタンバイ レプリケーションを設定する をご覧ください。

  1. マスター Postgres ノードで、ディレクトリを /opt/apigee/apigee-postgresql/pgsql/bin に変更します。
  2. 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
  3. 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 ユーザーのパスワードは、同じ値または異なる 値に設定できます。

  4. APIGEE_HOME を設定します。
    export APIGEE_HOME=/opt/apigee/edge-postgres-server
  5. 新しいパスワードを暗号化します。
    sh /opt/apigee/edge-analytics/utils/scripts/utilities/passwordgen.sh new_password

    このコマンドは、暗号化されたパスワードを返します。暗号化されたパスワードは「:」 文字の後に始まり、「:」は含まれません。たとえば、「apigee1234」 の暗号化されたパスワードは次のようになります。

    Encrypted string:WheaR8U4OeMEM11erxA3Cw==
  6. 新しい 暗号化された パスワードで Management Server ノードを更新します。 postgres ユーザーと apigee ユーザーのパスワードです。
    1. Management Server で、ディレクトリを /opt/apigee/customer/application に変更します。
    2. management-server.properties ファイルを編集して、次のプロパティを設定します。 このファイルが存在しない場合は、作成します。
    3. ファイルの所有者が apigee ユーザーであることを確認します。
      chown apigee:apigee management-server.properties
  7. 新しい暗号化されたパスワードで、すべての Postgres サーバーノードと Qpid サーバーノードを更新します。
    1. Postgres サーバーまたは Qpid サーバーノードで、次のディレクトリに変更します。
      /opt/apigee/customer/application
    2. 次のファイルを開いて編集します。
      • postgres-server.properties
      • qpid-server.properties

      これらのファイルが存在しない場合は、作成します。

    3. 次のプロパティをファイルに追加します:
      • 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
  8. 次のコンポーネントを次の順序で再起動します。
    1. PostgreSQL データベース:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    2. Qpid サーバー:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    3. Postgres サーバー:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
    4. 管理サーバー:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart