外部サーブレットへのCData Sync のデプロイ

​

Apache Tomcat での設定

​

WAR ファイルの配布

• webapps フォルダにWAR ファイルをコピーする。
• Tomcat の管理コンソール内でWAR ファイルの配布を行う。Apache Tomcat のドキュメントには、この方法のさらに詳しい説明があります。お使いのTomcat のバージョンのドキュメントを参照してください。

<multipart-config>
     <!-- 200-MB max -->
  <max-file-size>209715200</max-file-size>
  <max-request-size>209715200</max-request-size>
  <file-size-threshold>0</file-size-threshold>
</multipart-config>

​

Java 認証・承認サービス（JAAS）の設定

​

ログインモジュールの作成

Sync {
  sync.LoginModule required;
};

Sync {
  com.sun.security.auth.module.LdapLoginModule REQUIRED
    userProvider="ldaps://ab1cdef234.wfsaas.net:636/CN=Users,DC=example,DC=com"
    authIdentity="{USERNAME}@example.com"
    userFilter="(&(|(samAccountName={USERNAME})(userPrincipalName={USERNAME})(cn={USERNAME}))(objectClass=user))"
    useSSL=false;
  sync.LoginModule optional;
};

​

JAASRealm モジュールの作成（または変更）

<Context>
  <Realm className="org.apache.catalina.realm.JAASRealm" appName="Sync"
    userClassNames="sync.SimplePrincipal"
    roleClassNames="sync.GroupPrincipal" />
</Context>

<Host name="localhost" appBase="webapps" unpackWARS="true" autoDeploy="true" copyXML="true">
  ...
</Host>

​

ログインモジュールの表示

java.security.auth.login.config=${catalina.base}/conf/jaas.config

​

データディレクトリ権限の設定

• Windows： C:\ProgramData\CData\Sync\
• Linux： ~/cdata/sync

​

ログインのロックアウト

• LockoutFailedAttempts - ロックアウトのトリガーとなる不正なパスワードの数。ロックアウトを無効にするには、LockoutFailedAttempts を0に設定します。
• LockoutMinutes - ロックアウトする時間。デフォルトは30分です。
• LockoutTimeCheckPeriod - 失敗した試行回数を0にリセットするまでの時間。デフォルトは5分です。

<Context>
  <Parameter name="LockoutFailedAttempts" value="0" />
</Context>

​

WebSphere での設定

​

WebSphere クラスローダーの設定

1. WebSphere で、アプリケーション -> アプリケーション・タイプ -> WebSphere エンタープライズ・アプリケーションに移動します。
2. Sync を選択します。
3. クラス・ロードおよび更新の検出を選択します。
4. 最初にローカル・クラス・ローダーをロードしたクラス（親が最後） を選択します。
5. アプリケーションの単一クラス・ローダーを選択します。
6. OK をクリックします。その後保存をクリックします。

​

Java 認証・承認サービス（JAAS）の設定

1. Sync をデプロイします。
   1. アプリケーションセキュリティを有効化します（セキュリティー -> グローバル・セキュリティー -> アプリケーション・セキュリティーを使用可能にする）。
   2. 次のように、システムログインにカスタムログインモジュールを追加します。
      1. セキュリティー -> グローバル・セキュリティー -> Java 認証・承認サービス -> システム・ログイン -> WEB_INBOUND に移動します。新規をクリックしてsync.LoginModule という名前の新しいエントリを追加します。sync.LoginModule はcom.ibm.ws.security.server.lm.ltpaLoginModule の前にある必要があることに注意してください。
      2. ログイン・モジュール・プロキシーの使用チェックボックスを選択します。
      3. 認証ストラテジーのOPTIONAL を選択します。
      4. カスタム・プロパティーのisWebSphere を追加してtrue に設定します。
2. グループを作成します。
   1. ユーザーおよびグループ -> グループの管理 -> 作成に移動します。
   2. cdata_admin、cdata_standard、および cdata_support グループを作成します。
3. グループをロールにマップします。
   1. アプリケーション -> アプリケーション・タイプ -> WebSphere エンタープライズ・アプリケーション -> sync_war -> ユーザー / グループへのセキュリティー・ロールのマッピングに移動します。
   2. cdata_admin グループを cdata_admin ロールにマップします。
   3. cdata_standard グループを cdata_standard ロールにマップします。
   4. cdata_support グループを cdata_support ロールにマップします。
   5. アプリケーションのレルム内で認証済みすべてを cdata_user ロールにマップします。
4. com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual プロパティをtrue に設定します。
   1. サーバー -> サーバー・タイプ -> Web Sphere Application Server に移動し、Sync がホストされているサーバーを選択します。
   2. コンテナー設定 -> Web コンテナー設定 -> Web コンテナーを選択します。
   3. 追加プロパティー -> カスタム・プロパティーを選択します。
   4. 新規プロパティ：com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual を追加します。
   5. 値をtrue に設定します。
5. WebSphere を再起動します。

​

データディレクトリ権限の設定

• Windows： C:\ProgramData\CData\Sync\
• Linux： ~/cdata/sync

​

Jetty での設定

​

WAR ファイルの配布

​

Java 認証・承認サービス（JAAS）の設定

​

JAAS モジュールの追加

java -jar {JETTY_HOME}/start.jar --add-to-start=jaas

​

ログインモジュールの作成

Sync {
    sync.LoginModule required debug=true;
};

​

セキュリティハンドラの更新

<Set name="securityHandler">
  <New class="org.eclipse.jetty.security.ConstraintSecurityHandler">
   <Set name="loginService">
     <New class="org.eclipse.jetty.jaas.JAASLoginService">
          <!-- This name is the same as **login-config > realm-name** in web.xml.  -->
       <Set name="name">SyncRealm</Set>
          <!-- LoginModuleName must match the name of your LoginModule, as declared in your login-module configuration file. -->
       <Set name="loginModuleName">Sync</Set>
       <!-- Set the principal class name for the custom role. -->
       <Set name="roleClassNames">
           <Array type="java.lang.String">
             <Item>sync.GroupPrincipal</Item>
           </Array>
         </Set>
     </New>
   </Set>
  </New>
</Set>

​

データディレクトリ権限の設定

• Windows： C:\ProgramData\CData\Sync\
• Linux： ~/cdata/sync

​

アプリケーションディレクトリの設定

• Sync の複数インスタンスのクラスタリング
• アプリケーションデータ用の共有ネットワークドライブの使用
• 同じフォルダにアクセスする他のシステム内へのSync の組み込み

​

アプリケーションデータベースの設定

• ジョブ
• タスク
• 接続
• 履歴（ジョブとタスク両方）
• アプリケーションログ（アプリケーションレベルのエラーとイベント）
• 監査ログ（ユーザーによるSync の設定変更）

​

データベース接続の設定

• ターゲットデータベースの接続プロパティを含むJNDI データソースを定義。
• APP_DB 環境変数をJDBC 接続文字列に設定。

​

暗号化された接続文字列を使用したデータベース資格情報の保護

java -jar sync.jar -EncryptConnectionString "jdbc:cdata:mysql:Server=serverName;Port=1234;Database=databaseName;User=userName;Password=passwordSample"

ENCRYPTEDA:5TWyjE0U4GBEVNkd51SqbMXaBwVGqj5uyMfTHt48y/F5l3sDPZynNnPMb/ppXzuFTzFPywA1/SSKUgLy9nAuvA7RAdZj7WsKI1xAgDMmEFNQ68/lHjFYZpS10sIaoUloyZVDkj4uLHTZ0SaMD5PPUA==