OSGi 設定

🔗 OSGはAEMのテクノロジスタックの基本要素です。AEMの複合バンドルとその設定を制御するために使用されます。

OSGi は標準化されたプリミティブを提供し、小さく再利用が可能で連携機能に優れたコンポーネントを組み合わせてアプリケーションを構築することを可能にします。これらのコンポーネントからアプリケーションを作成し、デプロイすることができます。**

これにより、 バンドルの管理が容易になり、バンドルを個別に停止、インストール、開始できます。相互依存関係は自動的に処理されます。各OSGiコンポーネント（OSGi仕様を参照）は、様々なバンドルの1つに含まれています。 AEMで作業する場合、このようなバンドルの設定を管理する方法はいくつかあります。詳細と推奨プラクティスについては、OSGiの設定を参照してください。

次の OSGi 設定（バンドルに従ったリスト）は、プロジェクトの実装に関連しています。すべての設定に調整が必要なわけではなく、一部の設定は AEM の動作を説明する目的で言及されています。

AEMレプリケーションイベント ListenerConfigure:

• 実行モード。このモードでは、レプリケーションイベントがリスナーに配布されます。 たとえば、authorと定義した場合、これはレプリケーションを「開始」するシステムです。

• プロジェクトコードがパブリッシュ環境でレプリケーションイベント（逆複製）を処理する場合は、実行モード​publish​を追加する必要があります。 例えば、ディスパッチャーを使用して発行環境からフラッシュする場合や、他の発行インスタンスへの標準複製が発生する場合などです。

AEMリポジトリ変更 リスナーの設定：

• パス。リポジトリイベントをリッスンして配布準備が整っている場所です。

CRX Sling Client Repository基盤となるコンテンツリポジトリへのアクセスを設定します。

• 管理者パスワード​は、インスタンスのセキュリティを確保するために、インストール後に変更する必要があります。
• その他の変更は必要なく、リポジトリへのアクセスに影響を与える可能性があるので、注意が必要です。

Wikiメール サービスWikiから送信される電子メールの電子メール設定を構成します。

Apache Felix OSGi Management Console設定：

• Plugins：Apache Felix Web Management Console で最上位のメニュー項目として使用できる、メインのナビゲーション項目（コンソールプラグイン）です。それぞれ容量とリソースが必要なので、不要なものは無効にしてください。

Apache Slingカスタマイズ可能な要求データ ロガー設定：

• Logger Nameおよび Log Formatを使用して、要求およびアクセスログの場所と形式を設定します(デフォルト： request.log)をクリックします。 このログファイルは、Webチェーンに関連するパフォーマンスやデバッグ機能を分析する際に不可欠です。これは Apache Sling Request Logger とペアで使用されます。

詳しくは、AEM のログおよび Sling のログに関するページを参照してください。

Apache Sling Eventing Thread Pool設定：

• Min Pool Size および Max Pool Size：イベントスレッドを保持するために使用するプールのサイズ。

• Queue Size：プールを使い果たした場合のスレッドキューの最大サイズ。推奨値は-1です。これにより、キューは無制限に設定されます。制限を設定すると、制限を超えた場合に損失が発生する可能性があります。

• これらの設定を変更すると、イベント数が非常に多い状況（例：AEM DAM またはワークフローの使用頻度が高い場合）におけるパフォーマンスの強化に役立ちます。

• テストを実施して、状況に応じた値を確立する必要があります。

• これらの設定はインスタンスのパフォーマンスに影響を及ぼす可能性があるので、変更の際は十分な理由と検討が必要です。

Apache SlingGET サーブレットレンダリングの設定

• Auto Index：閲覧のためのディレクトリのレンダリングを有効または無効にします。
• Enable（または Disable）：デフォルトのレンディション（HTML、Plain Text、JSON、XML など）を有効または無効にします。JSON を無効にしないでください。

Apache Sling Java Script Handlerスクリプト（サーブレット）としての.javaファイルのコンパイルの設定。

特定の設定がパフォーマンスに影響を及ぼす可能性があります。可能な場合（特に、実稼動インスタンスの場合）は、それらを無効にしてください。

• Source VM および Target VM：ランタイム JVM として使用する JDK バージョンを定義します。

• 実稼動インスタンスの場合：

  • 「Generate Debug Info」を無効化

Apache Sling JCR Installerこれらのパラメーターは、おそらく設定は必要ありませんが、開発時やデバッグ時に知っておくと役立ちます。例えば、インストールフォルダーはパッケージのチェックイン／チェックアウトまたは作成に役立つ場合があります。

• インストールフォルダ名 regexpandインストールフォルダの階層の最大深度 ​​ — インストールするリソースを検索する場所と深さを指定します。ワイルドカードを使用する場合（.など）*/install)適切なすべての一致が検索されます（例：/libs/sling/install、/libs/cq/core/install）。

• Search Path：インストールするリソースを jcrinstall が検索するパスのリストです。そのパスの重み付け係数を示す数値も表示されます。

Apache Slingジョブイベント ハンドラジョブスケジュールを管理する設定パラメーター：

• 再試行間隔、 最大再試行数、最大並列ジョブ数 、​認識待ち時間 ​​など。

• これらの設定を変更すると、ジョブ数が多いシナリオでのパフォーマンスが向上します。例えば、AEM DAMやワークフローを大量に使用している場合などです。

• テストを実施して、状況に応じた値を確立する必要があります。

• これらの設定は理由なく変更しないでください。変更は、考慮が必要な場合にのみ行ってください。

Apache Sling JSPスクリプト ハンドラJSPスクリプトハンドラのパフォーマンス関連の設定を行います。パフォーマンスを向上するには、可能な限り設定を無効にしてください。

特に、実稼動インスタンスの場合は、次の設定を無効にします。

• 「Generate Debug Info」を無効化
• Keep Generated Java
• Mapped Content
• Display Source Fragments

Apache Slingログの 設定：

• Log Level および Log File：主要なログ設定（error.log）の場所とログレベルを定義します。レベルは、DEBUG、INFO、WARN、ERROR、FATALのいずれかに設定できます。

• Number of Log Files および Log File Threshold：ログファイルのサイズとバージョンのローテーションを定義します。

• Message Pattern：ログメッセージの形式を定義します。

詳しくは、AEM のログおよび Sling のログに関するページを参照してください。

Apache Sling Logging Logger Configuration（ファクトリ設定） 設定：

• Log Level、Log File および Message Format：ログファイルとメッセージの詳細を定義します。

• Logger：カテゴリを定義します（例：com.day.cq のログのみ）。

• 「Factory Configurations」を使用することにより、必要とされる様々なログレベルとカテゴリに応じて、任意の数の設定を追加できます。

• このような設定は開発時に役立ちます。例えば、特定のログファイルで、特定のサービスのトレースメッセージをログに記録する場合などです。

• このような設定は実稼動環境で役立ちます。例えば、特定のサービスに関するメッセージを個々のログファイルに記録して、簡単に監視できるようにする場合などです。

詳しくは、AEM のログおよび Sling のログに関するページを参照してください。

Apache Sling Logging Writerの設定（工場出荷時の設定） 設定：

• Log File：ログファイルの有無を定義します。

• Number of Log Files：バージョンのローテーションを定義します。

• ライターは Apache Sling Logging Logger Configuration 設定で使用できます。

• このような設定は開発時に役立ちます。例えば、特定のログファイルで、特定のサービスのトレースメッセージをログに記録する場合などです。

• このような設定は実稼動環境で役立ちます。例えば、特定のサービスに関するメッセージを個々のログファイルに記録して、簡単に監視できるようにする場合などです。

詳しくは、AEM のログおよび Sling のログに関するページを参照してください。

Apache Sling Main ServletConfigure:

• Number of Calls per Request および Recursion Depth：無限再帰および過度のスクリプトの呼び出しからシステムを保護します。

Apache Sling MIME Type ServiceConfigure:

• MIME Types：プロジェクトで必要な MIME タイプをシステムに追加します。これにより、ファイルに対する GET 要求において、ファイル形式とアプリケーションをリンクするための適切な content-type ヘッダーを設定できます。

Apache Sling転送者 フィルタCRX WebDAVとApache SlingのCross-Site Request Forgery(CSRF)に関する既知のセキュリティの問題に対処するには、転送者フィルタを設定する必要があります。

リファラーフィルターサービスは OSGi のサービスの 1 つであり、次の設定が可能です。

• フィルター処理する HTTP メソッド
• 空のリファラーヘッダーを使用できるかどうか
• サーバ・ホストに加えて、サーバのリストも許可されます。

詳しくは、「セキュリティチェックリスト」のクロスサイトのリクエスト偽造に関する問題を参照してください。

Apache Sling要求 ロガー設定：

• 要求をログに記録する方法を定義するための様々なパラメーター。

• Enable Request Log：有効または無効にします。

• Enable Access Log：有効または無効にします。

これは Apache Sling Customizable Request Data Logger とペアで使用されます。

詳しくは、AEM のログおよび Sling のログに関するページを参照してください。

Apache Sling Resource Resolver FactorySlingリソース解決の中心的側面を設定します。

• リソース検索パス（複数可）、プロジェクト固有のパスを追加します(削除 /libs や /apps削除はしません)。

• Virtual URLs：バニティー URL のマッピングを定義します。

• URL マッピングを使用してエイリアスを定義します。例えば、から /content に /。

• マッピングの場所、で外部化されたマッパー設定 /etc/map。

• ローカルインストールを使用して（例えば、https://localhost:4502/system/console/jcrresolverを使用して）、どのリソースリゾルバーがアクティブかを判断します。

詳しくは、https://cwiki.apache.org/confluence/display/SLING/Flexible+Resource+Resolution を参照してください。

Apache Slingサーブレット/スクリプトリゾルバーとエラー ハンドラーSlingサーブレットとスクリプトリゾルバーには複数のタスクがあります。

1. ServletResolver として使用され、要求を処理するために呼び出す Servlet または Script を選択します。

2. SlingScriptResolverとして機能します。

3. エラー処理を管理します。そのためには、要求処理のサーブレット／スクリプトの解決に使用するのと同じアルゴリズムを使用してエラー処理のサーブレット／スクリプトを選択する ErrorHandler インターフェイスを実装します。

次のような様々なパラメーターを設定できます。

• Execution Paths：実行可能なスクリプトを検索するパスを表示します。特定のパスを設定することで、実行可能なスクリプトを制限できます。パスが設定されていない場合は、デフォルトが使用されます(/ = root)。これにより、すべてのスクリプトが実行されます。

設定したパス値がスラッシュで終わる場合は、サブツリー全体が検索されます。末尾にスラッシュを指定しないと、完全一致の場合にのみスクリプトが実行されます。

• Script User：このオプションのプロパティでは、スクリプトの読み取りに使用するリポジトリユーザーアカウントを指定できます。アカウントを指定しない場合は、admin ユーザーがデフォルトで使用されます。

• Default Extensions：デフォルトの動作が使用される拡張子のリストです。つまり、リソースタイプの最後のパスセグメントをスクリプト名として使用できます。

Day Commons GFX Font Helperグラフィックのレンダリング時に、DrawTextを使用してテキストを埋め込むことができます。そのために、独自のフォントをインストールすることも可能です。

• プロジェクト固有のフォントを検索する​フォントパス​を定義します。
  例えば、/apps/myapp/fontsです。

Apache HTTPコンポーネントプロキシ 設定Apache HTTPクライアントを使用するすべてのコードのプロキシ設定。HTTPが作成されたときに使用されます。例えば、レプリケーション時に

新しい設定を作成する場合は、ファクトリの設定を変更せず、代わりに、次のURLで提供されているConfiguration Managerを使用して、このコンポーネントの新しいファクトリ設定を作成します。https://localhost:4502/system/console/configMgr/. プロキシ設定は​org.apache.http.proxyconfiguratorで入手できます。

Day CQ Antispam使用するスパム対策サービス(Akismet)を設定します。次の項目を登録する必要があります。

• プロバイダー
• API キー
• 登録済みの URL

AdobeGranite HTML Library Managerクライアントライブラリ（cssまたはjs）の処理を制御するように設定します。例えば、基になる構造体の見え方を含む。

• 実稼動インスタンスの場合：

  • 「Minify」を有効化（CRLF および空白文字を削除）
  • 「Gzip」を有効化（1 回の要求でファイルを gzip してアクセスするため）
  • 「Debug」を無効化
  • 「Timing」を無効化

• JS 開発の場合（特に、Firebug を使用するか、デバッグをおこなう場合）：

  • 「Minify」を無効にします。
  • 「Debug」を有効にして、デバッグ用のファイルを分離し、Firebug で使用します。
  • 「Timing」を有効にします（タイミングに関する設定をおこなう場合）。
  • Debug コンソールを有効にして、JS コンソールのログメッセージを確認します。

Day CQ HTTP Header Authentication HandlerHTTPリクエストの基本的な認証方法に関する全体的な設定。

閉じられたユーザーグループを使用すると、（特に）以下を設定できます。

• HTTP レルム
• デフォルトのログインページ

Day CQ Link Checker ServiceCheckと、必要に応じて次の設定を行います。

• Scheduler Period：外部リンクを自動的にチェックする間隔を定義します。

• Bad Link Tolerance Interval：失敗した外部リンクが無効と見なされるまでの期間を指定します。

• Link Check Override Patterns：リンクチェックから除外するパスを定義します。

Day CQ Link Checker Task単一のリンクチェッカー タスク(外部リンクをチェックするタスク)の設定：

• Good Link Test Interval および Bad Link Test Interval で定義されている間隔をチェックします。

• リンクをチェックする際に外部アクセスのために必要な、インターネットアクセスおよび NTLM 用のプロキシに関連する様々なパラメーターを設定します。

Day CQ Mail Serviceメールサーバーのホスト名とアクセスの詳細を設定します。「Mail Serviceの設定」の節を参照してください。

Day CQ MCM ニュースレターニュースレターで使用する様々な設定を指定します。

Day CQ Root Mapping設定：

• ターゲット パスを使用して、「 /」へのリクエストがリダイレクトされる先を定義します。

AEM では次の 2 つの UI を使用できます。

• タッチ操作対応 UI が標準の UI です。
• 廃止されたクラシック UI も引き続き完全に機能します。

AEM ルートマッピングを使用すると、希望する UI を、インスタンスのデフォルトとして設定できます。

• タッチ対応UIをデフォルトのUIにするには、ターゲットパス​が次を指すようにします。

     /projects.html
  

• クラシックUIをデフォルトのUIにするには、ターゲットパス​が次を指すようにします。

     /welcome.html
  

AdobeGranite SSO認証 ハンドラーシングルサインオン(SSO)の設定の詳細；これらは、多くの場合、エンタープライズ作成者の設定で必要となり、LDAPと組み合わせて使用されます。

様々な設定プロパティがあります。

• Path​この認証ハンドラーをアクティブにする対象のパス。このパラメーターを空のままにすると、認証ハンドラーは無効になります。例えば、/ というパスを指定すると、認証ハンドラーはリポジトリ全体に対して使用されます。

• サービス
  のランキングOSGiフレームワークサービスのランキング値は、このサービスの呼び出しに使用される順序を示します。これは、
  int 値を大きくすると、優先順位が高くなります。デフォルト値は 0 です。

• Header Names
  ユーザー ID を含む可能性のあるヘッダーの名前です。

• Cookie Names
  ユーザー ID を含む可能性のある cookie の名前です。

• Parameter Names
  ユーザー ID を指定する可能性のある要求パラメーターの名前です。

• ユーザ
  マップ選択したユーザに対して、HTTP要求から抽出されたユーザ名を、credentialsオブジェクト内の別のユーザ名に置き換えることができます。マッピングはここで定義します。ユーザー名
  admin がマップの両側に表示される場合、マッピングは無視されます。「=」の文字は、先頭に「\」を付けてエスケープする必要があります。

• Format
  ユーザー ID を指定する際の形式を示します。次のいずれかを使用します。

  • Basic：ユーザー ID が HTTP Basic 認証形式でエンコードされている場合
  • AsIs：ユーザー ID がプレーンテキストで指定されている場合や、正規表現が適用されている値をそのまま、または正規表現として使用する必要がある場合

Day CQ WCM Debug Filterこれは、ページにアクセスする際に？debug=layoutなどのサフィックスを使用できる開発時に役立ちます。例えば、https://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layoutは開発者にとって興味のあるレイアウト情報を提供します。

• パフォーマンスとセキュリティを確保するために、実稼動インスタンスではこれを無効にします。

Day CQ WCM Filter設定：

• WCMモード​を使用して、デフォルトのモードを定義します。

• 作成者インスタンスでは、edit、disable,preview、analyticsのいずれかになります。
  その他のモードはサイドキックからアクセスできます。または、サフィックス?wcmmode=disabledを使用して実稼動環境をエミュレートできます。

• パブリッシュインスタンスでは、disabled に設定して、その他のモードにアクセスできないようにする必要があります。

Day CQ WCM Link Checker Configurator設定：

• 書き換え設定のリスト：コンテンツベースのリンクチェックツール設定の場所のリストを指定します。設定は実行モードに基づくことができます。これはオーサー環境とパブリッシュ環境を区別するために重要です。それぞれの環境でリンクチェッカーの設定が異なる場合があるからです。

Day CQ WCM Page Processor設定：

• パス：システムが jcr:Event をトリガーする前にページの変更をリッスンする場所のリストです。

Adobeページインプレッション数 トラッカー作成者インスタンスに対して次のように設定します。

• sling.auth.requirements:このプロパティの値を -/libs/wcm/stats/tracker

Day CQ WCM Page Statisticsパブリッシュインスタンスの設定：

• URL to send data：ページ統計の追跡に使用する URL を設定します（トラッカー要求が Dispatcher を経由する場合は必須）。例えば、デフォルトは https://localhost:4502/libs/wcm/stats/tracker です。

• Tracking script enabled：ページ上の追跡スクリプトのインクルードを有効化（true）または無効化（false）します。デフォルト値は false です。

Day CQ WCM Version ManagerControlは、システムでバージョンが管理されているかどうか、および管理方法を示します。

• Create Version on Activation：標準インストールで有効になります。

• Enable Purging

• Purge Paths：検索アクションで検索するパス。

• Implicit Versioning Paths：暗黙のバージョン管理がアクティブなパス。

• Max Version Age：バージョンの最長有効期間（日数）。

• Max Number Versions：保存するバージョンの最大数。

詳しくは、バージョンのパージを参照してください。

Day CQワークフロー電子メール通知 サービスワークフローから送信される通知の電子メール設定を指定します。

Day CQSE HTTP ServiceCQサーブレットエンジンの制御：

• HTTPの場合はNIO、​HTTPにNIOを使用するかどうか。デフォルトはtrueです。HTTPが有効な場合にのみ使用されます。

• 接続タイムアウト。​接続タイムアウト（ミリ秒）。このプロパティは、HTTP接続とHTTPS接続の両方に適用されます。初期設定は60秒です。

• HTTPSを有効にする、HTTPSが有効 かどうかを指定します。デフォルトはfalseです。

• Session Timeout（セッションタイムアウト）。HTTPセッションのデフォルトの有効期間（分単位）です。タイムアウトが0以下の場合、セッションはタイムアウトしません。デフォルトは10分です。

• デバッグログ（DEBUGレベルのメッセージを書き込むかどうか）。デフォルトはfalseです。

• Request Buffer Size、要求のバッファーのサイズ（バイト単位）。初期設定は8KBです。

• スレッドの最大数、要求の処理に使用するスレッドの最大数。初期設定は200です。

以下のプロパティは、HTTPS が有効な場合にのみ適用されます。

• HTTPSポート。HTTPS要求をリッスンするポートです。初期設定は433です。
• HTTPS用のNIO。HTTPにNIOを使用するかどうか。HTTPプロパティのデフォルト値はNIOです。
• キーストア、HTTPSに使用するキーストアの絶対パス。HTTPSが有効な場合は必須です。
• キーストアパスワード、キーストアにアクセスするためのパスワード。
• Key Alias（キーストア内の秘密鍵のエイリアス）。
• Key Password, Password（キーストア内の秘密鍵のロックを解除するためのパスワード）。
• クライアント証明書、有効な証明書を提供するためのクライアントの要件。初期設定はnoneです。

SSL関連のオプションの詳細およびCQSEでHTTPSを有効にする方法の詳細については、「HTTP Over SSLの有効化」も参照してください。

CQ Rewriter HTML Parser Factory

CQ リライターの HTML パーサーを制御します。

• Additional Tags to Process - パーサーで処理する HTML タグを追加または削除できます。デフォルトで処理されるタグは、A、IMG、AREA、FORM、BASE、LINK、SCRIPT、BODY、HEAD です。
• キャメルケースを保持 — デフォルトでは、HTMLパーサーはキャメルケース（eBayなど）の属性を小文字（ebayなど）に変換します。キャメルケースの属性を保持するには、これをオフにします。これは、Angular 2 などのフロントエンドフレームワークを使用する際に役立ちます。

Day Commons JDBC Connections Poolコンテンツのソースとして使用されている外部データベースへのアクセスを設定します。

これはファクトリ設定なので、複数のインスタンスを設定できます。

Adobe CQメディアDPSセッション サービスパブリケーションで使用するDPSセッションの管理

具体的には、dps.session.service.url.name、 を定義できます。デフォルトは https://dpsapi2.digitalpublishing.acrobat.com/webservices/sessions に設定されています。

CDN リライターAEMとCDNの間の通信は、アセット/バイナリがエンドユーザーに安全な方法で配信されるように保証する必要があります。この方法では 2 つのタスクをおこないます。

• 最初（またはキャッシュ内のリソースが期限切れになった後）に、CDN を介して AEM からリソースにアクセスします。
• CDN にリソースがキャッシュされた後は、CDN にキャッシュされたリソースに安全にアクセスします。要求は AEM に送信されず、そのリソースにアクセスできるすべてのユーザーの処理は CDN でおこなわれます。

AEM は、内部アセットの URL を外部の CDN URL に書き直すリライターを提供しています。これにより、JWS 署名および有効期限を含む、CDN に渡すリンクが書き直され、アセットに安全にアクセスできるようになります。この機能は、オーサーインスタンスで使用されます。

全体的なフローは次のとおりです。

1. ユーザーが AEM で認証をおこない、アセットを含むページを要求します。

2. 要求されたページには/content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.pngと類似したアセットが含まれています

3. リライターがJWS署名を含むCDN URLにリンクを変換します。
   CDN_domain/content/dam/geometrixx-media/articles/paladin_trailer.jpg/_jcr_content/renditions/cq5dam.thumbnail.319.319.png?cdn_sign=JWS_SIGNATURE

4. ユーザーのブラウザーによって、CDN サーバーにアセット要求が転送されます。

5. 要求が cdn_sign パラメーターと共に AEM に転送されるように、CDN を設定する必要があります。

6. 認証ハンドラーによって cdn_sign パラメーターが検証され、CDN にアセットが返された後、アセットがユーザーに配信されます。

次の図に、ユーザーのブラウザー、CDN および AEM の間のフローを示します。

​​CDNConfigServiceImplCDN設定を提供

CDN書き換え機能は、com.adobe.cq.cdn.rewriter.impl.CDNConfigServiceImplの設定に​CDN配布ドメイン名​を指定することで有効にできます。

また、このサービスには、CDN 書き直しの有効化／無効化、CDN 書き直しが実行されるパスのプレフィックス、TTL 値、プロトコル（HTTP または HTTPS）など、その他の設定オプションも含まれます。

CDNRewriter内部 画像URLをCDN URLに書き換えるためのリライタ

com.adobe.cq.cdn.rewriter.impl.CDNRewriterの​タグ属性​値は、選択されたイメージリンクのみを書き換えるように定義できます。