Cassandra 認証を有効にする

デフォルトでは、Cassandra は認証を有効にせずにインストールされます。つまり、誰でもアクセスでき CassandraEdge のインストール後に、またはインストールの一環として認証を有効にできます。 プロセスです

Cassandra の CREATE/ALTER/DROP ROLES ステートメントを使用して、ロールを追加、削除、変更できます。詳しくは以下をご覧ください。

一般的な考慮事項

  • Cassandra 認証を有効にすると、デフォルトのスーパー ユーザー cassandra(パスワードは cassandra)が Cassandra によって自動的に作成されます。これは広く知られているスーパー ユーザーであるため、本番環境のニーズに合わせて使用しないでください。さらに、このスーパー ユーザーによる認証にはクォーラムの整合性が必要です。したがって、このユーザーを介した Cassandra 認証へのすべての接続には、より厳格な整合性が必要となり、その結果、パフォーマンスが遅くなり、フォールト トレラントが低下します。
  • 一般的なワークフローでは、Cassandra で認証を有効にし、構成ファイルを介してカスタムのユーザー名とパスワードを渡します。これにより、ニーズに応じて安全に使用できるカスタムのユーザーとパスワードが作成されます。このようなユーザーを介して認証を行う場合は、クォーラム整合性の制限は適用されません。
  • カスタム ユーザーが作成されても、Cassandra は引き続きデフォルトの cassandra スーパー ユーザーを作成し、Cassandra クラスタにはこのスーパー ユーザーを介してアクセスできることに注意してください。Cassandra 認証が Apigee 全体で正常に有効になった後は、通常、ALTER ROLE コマンドを使用して、この cassandra ユーザーのパスワードをデフォルトの cassandra 以外のものに変更する必要があります。このパスワードは、後で参照できるように記録しておいてください。
  • edge-* コンポーネントが認証に使用しているロールのパスワードは変更しないでください。すぐにサービスが中断されます。代わりに、新しいユーザーを作成し、その新しいユーザーを使用するように edge-* コンポーネントを変更します。完了したら、DROP ROLE コマンドを使用して古いユーザーを削除します。
  • edge-* コンポーネントが Cassandra 認証に使用するロールを変更するには、次の手順に沿って操作します。 <ph type="x-smartling-placeholder">
      </ph>
    1. 認証を有効にするセクションの手順に従って、新しいユーザーを作成します。クラスタで認証がすでに有効になっており、cassandra ユーザーのパスワードを変更した場合は、CASS_EXISTING_USERNAMECASS_EXISTING_PASSWORD で既存のユーザーのユーザー名とパスワードの組み合わせを渡す必要があります。
    2. 完了したら、cqlsh を使用して、新旧ユーザーの両方を介して Cassandra に接続できることを確認します。
    3. Cassandra に接続する Edge コンポーネントを更新するの手順に沿って、新しく作成されたユーザーを使用して Cassandra に接続するように、すべての edge-* コンポーネントを指定します。
    4. 最後に、すべてのコンポーネントが新しいユーザーを使用して Cassandra と通信したら、DROP ROLE コマンドを使用して古いユーザーを削除できます。デフォルトの cassandra ロールは削除しないでください。Cassandra との通信に edge-* コンポーネントで使用されていないカスタム作成ロールは削除できます。
  • Edge コンポーネントのインストールまたはアップグレードに使用する構成ファイル内で、機能している Cassandra のユーザー名とパスワードを必ず更新してください。これにより、エッジ オペレーション中の中断が排除または最小化されます。

Cassandra 認証を有効にする 設置

インストール時に Cassandra 認証を有効にできます。

インストール時に Cassandra 認証を有効にするには、CASS_AUTH を含めます。 プロパティをすべての Cassandra ノードの構成ファイルで設定し、

CASS_AUTH=y # The default value is n.

Cassandra にアクセスする Edge コンポーネントは次のとおりです。

  • 管理サーバー
  • Message Processor
  • ルーター
  • Qpid サーバー
  • Postgres サーバー

これらのコンポーネントをインストールするときに、 使用します。

CASS_USERNAME=cassandra_username
CASS_PASSWORD=cassandra_password

Cassandra の認証情報は、Cassandra のインストール後に変更できます。ただし、 Management Server、Message Processor、Router、Qpid サーバー、Postgres がすでにインストールされている 新しい認証情報を使用するようにコンポーネントを更新する必要もあります。

Cassandra のインストール後に Cassandra の認証情報を変更するには:

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

    ここで

    1. cassIP は、Cassandra ノードの IP アドレスです。
    2. 9042 は、デフォルトの Cassandra ポートです。
  2. cqlsh> で次のコマンドを実行します。パスワードを更新するよう求めるメッセージが表示されます。
    ALTER ROLE <username> WITH PASSWORD='';
  3. 次の例のように、cqlsh ツールを終了します。
    exit
  4. Management Server、Message Processor、 ルーター、Qpid サーバー、Postgres サーバーを使用する場合は、 それらのコンポーネントをインストールします。
    CASS_USERNAME=cassandra_username
    CASS_PASSWORD=new_cassandra_password
  5. Management Server をすでにインストールしている場合、メッセージ プロセッサ、Router、Qpid サーバー、Postgres サーバー。これらを更新する手順については、Edge のパスワードを再設定するをご覧ください。 新しいパスワードを使用するように設定してください。

Cassandra 認証の有効化 設置

インストール後に認証を有効にするには:

Cassandra に接続する Edge コンポーネントを更新する

Cassandra と通信するすべての Edge コンポーネントを更新するには、次の操作を行います。 新しい認証情報でログインします。この手順は、Cassandra を実際に更新する前に行うことに注意してください。 認証情報:

  1. 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; wrap in single quotes if it includes special chars

    このコマンドを実行すると、Management Server が自動的に再起動されます。

  2. 次の各サービスに対して、ステップ 1 を繰り返します。 <ph type="x-smartling-placeholder">
      </ph>
    • すべての Message Processor
    • すべてのルーター
    • すべての Qpid サーバー(edge-qpid-server)
    • Postgres サーバー(edge-postgres-server)

    サービスごとに手順 1 を繰り返す場合は、edge-management-server コマンドを適切なサービス名に置き換えます。たとえば、Compute Engine の 設定するには、次のコマンドを使用します。

    /opt/apigee/apigee-service/bin/apigee-service edge-router
      store_cassandra_credentials -u cassandra -p cassandra

認証を有効にする

次の手順で Cassandra 認証を有効にし、ユーザー名とパスワードを設定します。 パスワード:

  1. 以下の内容でサイレント構成ファイルを作成します。
    # Specify IP address or DNS name of cassandra node
    IP1=192.168.1.1
    IP2=192.168.1.2
    IP3=192.168.1.3
    # Must resolve to IP address or DNS name of host
    HOSTIP=$(hostname -i)
    # Set to ‘y’ to enable Cassandra authentication.
    CASS_AUTH=y # Possible values are ‘y/n’
    # Cassandra username. If it does not exist, this user would be created as a SUPERUSER
    CASS_USERNAME=cassandra_username # Default value is cassandra - don't use for production
    # Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password
    CASS_PASSWORD=cassandra_password # Default value is cassandra - don't use for production
    # Space-separated IP/DNS names of the Cassandra hosts
    CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
    
    # Username of an existing C* user. Only needed if you have disabled or changed details of the default cassandra user(‘cassandra’)
    CASS_EXISTING_USERNAME=existing_cassandra_username
    # Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’)
    CASS_EXISTING_PASSWORD=existing_cassandra_password
    # Cassandra port
    CASS_PORT=9042 # The default port is 9042.
  2. 最初の Cassandra ノードにログインして、次のコマンドを実行します。

    apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

    必要に応じて、プロパティをコマンド引数としてスクリプトに渡すことができます。 次の例をご覧ください。

    CASS_AUTH=y HOSTIP=$(hostname -i) CASS_PORT=9042 CASS_EXISTING_USERNAME=existing_cassandra_username CASS_EXISTING_PASSWORD=existing_cassandra_password CASS_USERNAME=cassandra_username CASS_PASSWORD=cassandra_password  CASS_HOSTS="192.168.1.1:1,1 192.168.1.2:1,1 192.168.1.3:1,1" apigee-service apigee-cassandra enable_cassandra_authentication

    注:

    • デフォルト 設定するには、上記のコマンドで Cassandra 認証を有効にして再起動します。 Cassandra
    • デフォルト以外の認証情報の場合、このコマンドはレプリケーション係数も変更し、 スーパーユーザーであり、system_auth keyspace で修復を実行します。
  3. すべての Cassandra ノードで手順 1 と 2 を繰り返します。