Edge for Private Cloud v4.19.01
デフォルトでは、Cassandra は認証を有効にせずにインストールされます。つまり、誰でも Cassandra にアクセスできます。認証は、Edge のインストール後、またはインストール プロセスの一環として有効にできます。
Cassandra で認証を有効にすると、次のデフォルトの認証情報が使用されます。
- username = 'cassandra'
- password = 'cassandra'
このアカウントを使用するか、このアカウントに別のパスワードを設定するか、新しい Cassandra ユーザーを作成できます。Cassandra の CREATE/ALTER/DROP USER ステートメントを使用して、ユーザーを追加、削除、変更します。
詳細については、Cassandra SQL シェルコマンドをご覧ください。
インストール時に Cassandra 認証を有効にする
Cassandra 認証はインストール時に有効にできます。ただし、Cassandra のインストール時に認証を有効にすることはできますが、デフォルトのユーザー名とパスワードを変更することはできません。Cassandra のインストールが完了したら、この手順を手動で実行する必要があります。
インストール時に Cassandra 認証を有効にするには、すべての Cassandra ノードの構成ファイルに CASS_AUTH プロパティを含めます。
CASS_AUTH=y # The default value is n.
次の Edge コンポーネントが Cassandra にアクセスします。
- 管理サーバー
- Message Processor
- ルーター
- Qpid サーバー
- Postgres サーバー
したがって、これらのコンポーネントをインストールするときは、構成ファイルで次のプロパティを設定して Cassandra の認証情報を指定する必要があります。
CASS_USERNAME=cassandra CASS_PASSWORD=cassandra
Cassandra の認証情報は、Cassandra のインストール後に変更できます。ただし、Management Server、Message Processor、Router、Qpid サーバー、Postgres サーバーをすでにインストールしている場合は、それらのコンポーネントも更新して新しい認証情報を使用する必要があります。
Cassandra のインストール後に Cassandra の認証情報を変更するには:
cqlshツールとデフォルトの認証情報を使用して、任意の Cassandra ノードにログインします。1 つのノードでパスワードを変更するだけで、リング内のすべての 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、Message Processor、Router、Qpid サーバー、Postgres サーバーをまだインストールしていない場合は、構成ファイルで次のプロパティを設定してから、これらのコンポーネントをインストールします。
CASS_USERNAME=cassandra CASS_PASSWORD=NEW_PASSWORD
- Management Server、Message Processor、Router、Qpid サーバー、Postgres サーバーをすでにインストールしている場合は、Edge パスワードのリセットで、新しいパスワードを使用するようにこれらのコンポーネントを更新する手順をご覧ください。
インストール後に Cassandra 認証を有効にする
認証を有効にするには:
- Cassandra に接続するすべての Edge コンポーネントを、Cassandra のユーザー名とパスワードで更新します。
- すべての Cassandra ノードで認証を有効にします。
- 任意の 1 つのノードで Cassandra のユーザー名とパスワードを設定します。1 つの Cassandra ノードで認証情報を変更するだけで、リング内のすべての Cassandra ノードにブロードキャストされます。
Cassandra と通信するすべての Edge コンポーネントを新しい認証情報で更新するには、次の手順を使用します。この手順は、実際に Cassandra 認証情報を更新する前に行います。
- Management Server ノードで、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u cassandra_username -p cassandra_password
必要に応じて、新しいユーザー名とパスワードを含むファイルをコマンドに渡すことができます。
apigee-service edge-management-server store_cassandra_credentials -f configFile
ここで、configFile には次のものが含まれます。
CASS_USERNAME=cassandra_username # Default is cassandra CASS_PASSWORD=cassandra_password # Default is cassandra
このコマンドにより、Management Server が自動的に再起動されます。
- 次の各サービスについて、ステップ 1 を繰り返します。
- すべての Message Processor
- すべてのルーター
- すべての Qpid サーバー（edge-qpid-server）
- Postgres サーバー（edge-postgres-server）
サービスごとにステップ 1 を繰り返す場合は、上記のコマンドの
edge-management-serverを適切なサービス名に置き換えます。たとえば、Router サービスのステップを実行する場合は、次のコマンドを使用します。/opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u cassandra -p cassandra
Cassandra 認証を有効にしてユーザー名とパスワードを設定するには、次の手順を行います。
- 最初の Cassandra ノードにログインします。
- 次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra enable_cassandra_authentication -e y
このコマンドは認証を有効にし、Cassandra を再起動します。
- すべての Cassandra ノードで手順 1 と 2 を繰り返します。
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>プロンプトで次のコマンドを実行して、キースペースが常に使用可能であることを確認します。 単一のデータセンターの場合:ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3'};ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3', 'dc-2': '3'};cqlshツールを終了します。exit
nodetool repairを実行して、変更がすべての Cassandra ノードに伝播されていることを確認します。/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] repair system_auth
ユーザー名とパスワードを渡す必要があるのは、Cassandra の JMX 認証を有効にした場合のみです。