1. Liferay Help Center
  2. Liferay DXP 7.1デプロイメントガイド
  3. 検索エンジンのインストール

ドキュメンテーション

Liferay Enterprise Searchセキュリティのインストール

X-Packをインストールしたら、組み込みのユーザーパスワードを設定してElasticsearchの保護を開始します。

X-Packセキュリティの有効化

まず、X-Packセキュリティを有効化します。以下の設定をelasticsearch.ymlに追加します：

xpack.security.enabled: true

これでX-Packユーザーを設定できます。

X-Packユーザーの設定

以下の組み込みX-Packユーザーは、X-PackセキュリティとX-Packモニタリングを使用するシステムにとって重要です：

  • kibana
  • elastic

すべてのX-Packのbuilt-in usersのパスワードを設定してください 。 setup-passwordsコマンドは、組み込みユーザーの初回使用パスワードを初めて設定する最も簡単な方法です。その後パスワードを更新するには、KibanaのUIまたはChange Password APIを使用してください。

Interactive引数は、すべての組み込みユーザーのパスワードを設定します。これらの記事に示されている設定方法では、すべてのパスワードがliferayに設定してあることを前提としています 。しかし、これはプロダクションシステムにはお勧めできません。

./bin/elasticsearch-setup-passwords interactive

Elasticのsetup-passwords commandのドキュメンテーションに追加のオプションが記載されています。

Elasticsearchを保護しているので、elasticユーザーのパスワードを忘れないでください。

各ノードでトランスポート層セキュリティを有効化します。

トランスポート層セキュリティの有効化

TLSを有効にするための以下の手順では、パスワードが必要な時はいつもliferayをパスワードとして使用しています。 インストール時には独自のパスワードを使用してください。

ノード証明書を生成する

各ノードに対してGenerate a node certificate。認証局を使用してノード証明書を取得することもできます。

  1. X-Packのcertutilコマンドを使用して認証局を作成します 。

    ./bin/elasticsearch-certutil ca --pem --ca-dn CN=localhost

    これをすることによりZIPファイルを生成します。 内容を安全な場所に解凍します。

  2. ステップ1のCAを使用してX.509の証明書と秘密鍵を生成します。

    ./bin/elasticsearch-certutil cert --pem --ca-cert /path/to/ca.crt --ca-key /path/to/ca.key --dns localhost --ip 127.0.0.1 --name localhost

    これをすることにより、別のZIPファイルを生成します。[Elasticsearch Home]/configフォルダ内のどこかにコンテンツを抽出します。

TLSを有効化する

elasticsearch.ymlを使って各ノードのTLSを有効化します。（詳細：Enable TLS）

  1. 証明書、キー、および認証局のパスを各ノードのelasticsearch.ymlに追加します。

    xpack.ssl.certificate: /path/to/[Elasticsearch Home]/config/localhost.crt
xpack.ssl.key: /path/to/[Elasticsearch Home]/config/localhost.key
xpack.ssl.certificate_authorities: ["/path/to/ca.crt"]

    上記のパス例は証明書をElasticsearch Home/config/に追加したことを仮定としています。

  2. トランスポート層TLSを以下の設定でelasticsearch.yml内で有効にします。

    xpack.security.transport.ssl.enabled: true
xpack.security.transport.ssl.verification_mode: certificate

  3. クライアント通信を暗号化するためにHTTPレイヤ上でTLSを有効にします。

    xpack.security.http.ssl.enabled: true

X-PackをインストールしてTLSを有効にしたら、Liferay DXPでX-Packセキュリティアダプターを設定します。

X-PackセキュリティにLiferayコネクタのインストールと設定を行う

Liferay Enterprise Search Premiumを購読している場合は 、Liferay ConnectorをX-Packセキュリティ[[Elastic Stack 6.x]]にdownloadしてください。LPKGファイルをLiferay Home/deployフォルダにコピーしてインストールします。

X-Packアダプターを設定するには、[Control Panel] >[Configuration] > *[System Settings]に行きます。[Search]*カテゴリを見つけて、X-Pack Securityエントリをクリックします。 ここに直接プロパティ値を入力できますが、 [Liferay Home]/osgi/configsにデプロイしてある configuration fileを使用する方が一般的 です。X-Packアダプターの場合は、以下のファイルを作成します：

com.liferay.portal.search.elasticsearch6.xpack.security.internal.configuration.XPackSecurityConfiguration.config

ファイルの正確な内容は、X-Packの設定によって異なります。ここに記載されているElasticsearchセットアップに従ってアダプターを設定するには、以下のようにファイルを入力します：

sslKeyPath="/path/to/[Elasticsearch Home]/config/localhost.key"
sslCertificatePath="/path/to/[Elasticsearch Home]/config/localhost.crt"
certificateFormat="PEM"
requiresAuthentication="true"
username="elastic"
password="liferay"
sslCertificateAuthoritiesPaths="/path/to/[Elasticsearch Home]/config/ca.crt"
transportSSLVerificationMode="certificate"
transportSSLEnabled="true"

ここで使用しているpasswordは上記のX-Packのパスワードを設定した時に使用したものと同じものを使ってください。

認証を有効化するために、requires Authenticationでtrueを選択し、Elasticsearchユーザーに資格情報を提供してください。SSLの場合は、トランスポートSSLを有効にし、証明書検証モードと証明書フォーマットを設定した後、証明書、キー、および認証局へのパスを提供します。しかし、正確な値はX-Packの設定によって異なります。

以下はX-Pack Connectorの設定オプションの完全なリストで：

  • sslKeyPath
  • sslCertificatePath
  • sslCertificateAuthoritiesPaths
  • certificateFormat
  • requiresAuthentication
  • username
  • password
  • transportSSLVerificationMode
  • transportSSLEnabled
  • sslKeystorePath
  • sslKeyStorePassword
  • sslTruststorePath
  • sslTruststorePassword

X-Packセキュリティの設定が終了したら、Elasticsearchを再起動してください。これらの手順では、クラスタ全体を再起動する必要があります。

« Liferay Enterprise SearchのインストールLiferay Enterprise Search Monitoringのインストール »
この記事は役に立ちましたか？
1人中1人がこの記事が役に立ったと言っています