Edge for Private Cloud v4.19.01
Edge を初めてインストールしたときに、sysadmin ユーザーと呼ばれる特別な種類のユーザーが作成され、それと同時に、このユーザーの詳細情報を使用して追加の構成ファイルが更新されました。メールアドレス以外のユーザー名を使用して認証するように外部 LDAP を構成した場合や、この sysadmin ユーザーの外部 LDAP に別のパスワードがある場合は、このセクションで説明する変更を行う必要があります。
更新が必要な場所は次の 2 つです。
- Edge UI は、Edge UI の構成ファイルに保存されている認証情報を使用して Management Server にログインします。sysadmin ユーザーのユーザー名またはパスワードのいずれかまたは両方が異なる場合、この更新が必要です。
- Edge では、sysadmin のユーザー名を別のファイルに保存します。このファイルは、さまざまなユーティリティ スクリプトの実行時に使用されます。この更新は、sysadmin ユーザーのユーザー名が異なる場合にのみ必要です。
Edge UI のパスワードの変更
Edge UI のパスワードの変更方法は、外部 LDAP サーバーでのユーザー名の表現方法によって異なります。
- ユーザー名がメールアドレスの場合は、
setup.sh
ユーティリティを使用して Edge UI を更新します。 - ユーザー名がメールアドレスではなく ID の場合は、API 呼び出しとプロパティ ファイルを使用して Edge UI を更新します。
以下では、両方の手順について説明します。
メールアドレスの Edge UI 認証情報を変更する
- Edge UI のインストールに使用したサイレント構成ファイルを編集して、次のプロパティを設定します。
ADMIN_EMAIL=newUser APIGEE_ADMINPW=newPW SMTPHOST=smtp.gmail.com SMTPPORT=465 SMTPUSER=foo@gmail.com SMTPPASSWORD=bar SMTPSSL=y SMTPMAILFROM="My Company <myco@company.com>"
UI のすべてのプロパティがリセットされるため、新しいパスワードを渡すときに SMTP プロパティを含める必要があります。
apigee-setup
ユーティリティを使用して、構成ファイルから Edge UI のパスワードを再設定します。/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
ユーザー ID の Edge UI 認証情報を変更する
- ユーザー ID とパスワードを暗号化します。
java -cp "/opt/apigee/edge-ui/conf:/opt/apigee/edge-ui/lib/*" utils.EncryptUtil 'userName:PWord'
- エディタで
ui.properties
ファイルを開きます。ファイルが存在しない場合は作成します。vi /opt/apigee/customer/application/ui.properties
ui.properties
で、conf_apigee_apigee.mgmt.credential
トークンをステップ 1 の呼び出しで返された値に設定します:conf_apigee_apigee.mgmt.credential="STRING_RETURNED_IN_STEP_1"
ui.properties
のオーナーを「apigee」に設定します。chown apigee:apigee /opt/apigee/customer/application/ui.properties
- Edge UI を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
構成のテスト
- ブラウザで、
http://management_server_IP:9000/
の管理 UI を開きます。例:
http://192.168.52.100:9000/
- 新しい認証情報でログインします。ログインに成功すると、構成は正しくなっています。
Apigee ユーティリティ スクリプト用の Edge sysadmin ユーザー名ストアの編集
- Edge UI のインストールに使用したサイレント構成ファイルを編集して、次のプロパティを設定し、ADMIN_EMAIL の値を外部 LDAP の sysadmin ユーザーに使用するユーザー名に変更します。
APIGEE_EMAIL=newUser IS_EXTERNAL_AUTH="true"
IS_EXTERNAL_AUTH
プロパティは、メールアドレスではなくアカウント名をユーザー名としてサポートするように Edge を構成します。 apigee-setup
ユーティリティを使用して、構成ファイルからすべての Edge コンポーネントのユーザー名をリセットします。/opt/apigee/apigee-setup/bin/setup.sh -p edge -f configFile
このコマンドは、すべての Edge ノード(Management Server、Router、Message Processor、Qpid、Postgres など)のすべての Edge コンポーネントで実行する必要があります。
構成のテスト
セントラル POD にアクセスできることを確認します。Management Server で、次の CURL コマンドを実行します。
curl -u sysAdminEmail:password http://localhost:8080/v1/servers?pod=central
出力は次の形式のようになります。
[ { "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "central", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ ] }, "type" : [ "application-datastore", "scheduler-datastore", "management-server", "auth-datastore", "apimodel-datastore", "user-settings-datastore", "audit-datastore" ], "uUID" : "d4bc87c6-2baf-4575-98aa-88c37b260469" }, { "externalHostName" : "localhost", "externalIP" : "192.168.1.11", "internalHostName" : "localhost", "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "central", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ { "name" : "started.at", "value" : "1454691312854" }, ... ] }, "type" : [ "qpid-server" ], "uUID" : "9681202c-8c6e-4da1-b59b-23e3ef092f34" } ]