Oracle® Fusion Middleware Oracle WebCenter Portal管理者ガイド

11gリリース1(11.1.1.6.0)

B72085-01(原本部品番号:E12405-18)

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

新機能

- リリース11.1.1.6の新機能

第I部 Oracle WebCenter Portalの概要

1 Oracle WebCenter Portalの管理の概要

- 1.1 Oracle WebCenter Portalの概要

- 1.2 Oracle WebCenter Portalのアーキテクチャ

- 1.2.1 WebCenter Portal: Framework

- 1.2.2 Application Development Framework

- 1.2.3 Composer

- 1.2.4 WebCenter Portal: Spaces

- 1.2.5 WebCenter Portal: Services

- 1.2.6 ディスカッション・サーバー

- 1.2.7 分析

- 1.2.8 アクティビティ・グラフ

- 1.2.9 パーソナライズ・サーバー

- 1.2.10 ポータル

- 1.2.11 コンポジット・アプリケーション

- 1.3 Oracle WebCenter Portalのトポロジ

- 1.3.1 初期設定のWebCenter Portalトポロジ

- 1.3.2 WebCenter Portal管理対象サーバー

- 1.3.3 WebCenter Portalの起動順序

- 1.3.4 WebCenter Portalの依存性

- 1.3.5 WebCenter Portalの構成に関する考慮事項

- 1.3.6 WebCenter Portalの状態および構成の永続性

- 1.3.7 WebCenter Portalのログ・ファイルの場所

- 1.4 Spacesアプリケーション

- 1.5 Frameworkアプリケーション

- 1.6 WebCenter Portalのインストールの計画

- 1.7 WebCenter Portal 11gのインストールの理解

- 1.8 管理操作、ロールおよびツールの理解

- 1.9 パフォーマンスの監視および診断

- 1.10 セキュリティの理解

- 1.11 WebCenter Portalアプリケーションのデプロイ

- 1.12 データの移行、バックアップおよびリカバリ

- 1.13 Oracle WebCenter Portalの管理ツール

- 1.13.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

- 1.13.1.1 Fusion Middleware Controlコンソールの表示

- 1.13.2 Oracle WebLogic Server管理コンソール

- 1.13.3 Oracle WebLogic Scripting Tool (WLST)

- 1.13.3.1 Oracle WebLogic Scripting Tool (WLST)コマンドの実行

- 1.13.4 システムMBeanブラウザ

- 1.13.5 Spaces管理ページ

- 1.13.6 WebCenter Portal管理コンソール

第II部 Oracle WebCenter Portalの管理の概要

2 Spacesアプリケーションの起動および実行

- 2.1 Fusion Middleware管理者のロール

- 2.2 Spaces管理者のロール

- 2.3 WebCenter Portal: Spacesのインストール

- 2.4 Spacesの初回の設定(ロードマップ)

- 2.5 Spacesの初回のカスタマイズ(ロードマップ)

3 Spacesアプリケーションのメンテナンス

- 3.1 Fusion Middleware管理者のロール

- 3.2 Spaces管理者のロール

- 3.3 Spacesのためのシステム管理(ロードマップ)

- 3.4 Spacesのためのアプリケーション管理(ロードマップ)

4 Frameworkアプリケーションの起動および実行

- 4.1 Oracle WebCenter PortalおよびFrameworkライブラリのインストール

- 4.2 Frameworkアプリケーションの初回のデプロイ(ロードマップ)

5 Frameworkアプリケーションのメンテナンス

- 5.1 Frameworkアプリケーションのためのシステム管理(ロードマップ)

第III部 Oracle WebCenter Portalの基本的なシステム管理

6 Enterprise Manager Fusion Middleware Controlの起動

- 6.1 Fusion Middleware Controlコンソールの表示

- 6.2 Spacesアプリケーションのホームページへの移動

- 6.3 Frameworkアプリケーションのホームページへの移動

- 6.4 依存コンポーネントへの移動

7 WebCenter Portal: Frameworkアプリケーションのデプロイ

- 7.1 Frameworkアプリケーションのデプロイ

- 7.1.1 デプロイメント・ロードマップ

- 7.1.2 デプロイメントの前提条件

- 7.1.3 アプリケーションEARファイルの準備

- 7.1.3.1 EARファイル・コンテンツ

- 7.1.4 管理対象サーバーの作成

- 7.1.5 メタデータ・サービス・リポジトリの作成および登録

- 7.1.5.1 リポジトリ作成ユーティリティを使用したMDSスキーマの作成

- 7.1.5.2 Fusion Middleware Controlを使用したMDSスキーマの登録

- 7.1.5.3 WLSTを使用したMDSスキーマの登録

- 7.1.6 WebLogic管理対象サーバーへのアプリケーションのデプロイ

- 7.1.6.1 情報アーティファクト・ストアの選択

- 7.1.6.2 データ・ソースの選択

- 7.1.6.3 Oracle JDeveloperを使用したアプリケーションのデプロイ

- 7.1.6.4 Fusion Middleware Controlを使用したアプリケーションのデプロイ

- 7.1.6.5 WLSTを使用したアプリケーションのデプロイ

- 7.1.6.6 WLS管理コンソールを使用したアプリケーションのデプロイ

- 7.1.6.7 デプロイ・プランの保存と再利用

- 7.1.7 カスタマイズおよびデータの環境間の移行

- 7.1.8 分散環境で実行するためのアプリケーションの構成

- 7.2 Frameworkアプリケーションのアンデプロイ

- 7.2.1 Fusion Middleware Controlを使用したFrameworkアプリケーションのアンデプロイ

- 7.2.2 WLSTを使用したFrameworkアプリケーションのアンデプロイ

- 7.2.3 アプリケーションの資格証明マップの削除

- 7.3 Frameworkアプリケーションの再デプロイ

- 7.3.1 再デプロイに関する考慮事項

- 7.3.1.1 アプリケーション構成の保持

- 7.3.1.1.1 WLSTを使用したデプロイ時の構成の保持

- 7.3.1.2 サービスおよびユーザー・カスタマイズの保持

- 7.3.1.3 リソース・カスタマイズの保持

- 7.3.1.4 ポートレット・カスタマイズの保持

- 7.3.2 Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ

- 7.3.3 WLSTを使用したFrameworkアプリケーションの再デプロイ

- 7.4デプロイ後の構成

- 7.4.1 デプロイ後のセキュリティ構成の確認

- 7.4.2 デプロイ後のアプリケーション接続の確認

- 7.4.3 データ・ソース接続の確認

- 7.4.4 アプリケーションのチューニング

8 WebCenter Portalアプリケーションの起動および停止

- 8.1 ノード・マネージャの起動

- 8.2 WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

- 8.3 Spacesアプリケーションの起動および停止

- 8.3.1 Fusion Middleware Controlを使用したSpacesの起動

- 8.3.2 WLSTを使用したSpacesの起動

- 8.3.3 Fusion Middleware Controlを使用したSpacesの停止

- 8.3.4 WLSTを使用したSpacesの停止

- 8.4 Frameworkアプリケーションの起動および停止

- 8.4.1 Fusion Middleware Controlを使用したFrameworkアプリケーションの起動

- 8.4.2 WLSTを使用したFrameworkアプリケーションの起動

- 8.4.3 Fusion Middleware Controlを使用したFrameworkアプリケーションの停止

- 8.4.4 WLSTを使用したFrameworkアプリケーションの停止

9 WebCenter Portalアプリケーションのプロパティの設定

- 9.1 Spacesアプリケーションのアプリケーション・プロパティの設定

- 9.2 Frameworkアプリケーションのアプリケーション・プロパティの設定

- 9.3 SpacesワークフローをホスティングするBPELサーバーの指定

- 9.4 検索クローラの構成

- 9.5 検索オプションの設定

- 9.6 通知メッセージのチャネルの選択

- 9.7 プロキシ・サーバーの設定

- 9.7.1 Fusion Middleware Controlを使用したプロキシ・サーバーの設定

- 9.7.2 WLSTを使用したプロキシ・サーバーの設定

- 9.8 前のリリースからSpacesテンプレートを公開

- 9.9 Spacesアプリケーションのセッション・タイムアウトの設定

第IV部 サービス、ポートレット・プロデューサおよび外部アプリケーションの管理

10 Oracle WebCenter Portalサービスの管理

- 10.1 サービス管理の概要

- 10.1.1 MDSリポジトリの設定

- 10.1.2 データベース接続の設定

- 10.1.3 外部アプリケーション接続の設定

11 コンテンツ・リポジトリの管理

- 11.1 コンテンツ・リポジトリに関する必要な知識

- 11.2 Oracle WebCenter Content Serverリポジトリの構成

- 11.2.1 Content Serverを構成するための前提条件

- 11.2.1.1 インストールに関する前提条件

- 11.2.1.2 構成に関する前提条件

- 11.2.1.3 セキュリティに関する前提条件

- 11.2.2 Content Serverの構成ロードマップ

- 11.2.3 WebCenter Portalアプリケーション用のContent Serverの構成

- 11.2.3.1 必須コンポーネントの有効化

- 11.2.3.1.1 WebCenterConfigureコンポーネントに関する必要な知識

- 11.2.3.2 Dynamic Converterコンポーネントの構成

- 11.2.3.3 Inbound Refineryの構成

- 11.2.3.3.1 送信プロバイダの作成

- 11.2.3.3.2 Inbound RefineryでのPDFExportConverterの有効化

- 11.2.3.3.3 変換するファイル・フォーマットの選択

- 11.2.3.3.4 WikiおよびブログのPDFへの変換の有効化

- 11.2.3.4 Content Serverに対するSSLの設定

- 11.2.3.5 WebCenter PortalでのiFrame化UIの有効化

- 11.2.3.6 SESクローラの構成

- 11.2.3.7 Site Studioの設定

- 11.2.3.8 OracleTextSearchの有効化

- 11.2.3.9 Content Serverでのコンテンツ・プロファイルの作成

- 11.2.3.10 WebCenter Portalアプリケーションでのアイテム・レベル・セキュリティの構成

- 11.2.3.10.1 アイテム・レベル・セキュリティに関する必要な知識

- 11.2.3.10.2 アイテム・レベル・セキュリティの構成

- 11.2.3.10.3 WebCenter Portal: Frameworkアプリケーション用の追加設定の構成

- 11.2.3.11 追加のオプション構成

- 11.2.3.11.1 File Store Providerの構成

- 11.2.3.11.2 ノード・マネージャの設定

- 11.2.3.12 Content ServerとWebCenter Portal: Frameworkアプリケーション間のセキュリティの構成

- 11.2.3.12.1 Content Serverコンソールを使用したセキュリティ・グループの作成

- 11.2.3.12.2 Content Serverコンソールを使用したロールの作成

- 11.2.3.12.3 Fusion Middleware Controlを使用したロール(グループ)の作成

- 11.2.3.12.4 Content Serverコンソールを使用したフォルダの作成

- 11.2.3.12.5 Fusion Middleware Controlを使用したユーザーの作成

- 11.2.3.12.6 Fusion Middleware Controlを使用したユーザーへのロールの付与

- 11.2.3.12.7 本番環境へのセキュリティの移行

- 11.2.3.12.8 セキュリティ・グループおよびロール構成の確認

- 11.2.3.13 Content Server接続の登録

- 11.2.3.13.1 Frameworkアプリケーション用のContent Server接続の構成

- 11.2.3.13.2 Spaces用のContent Server接続の構成

- 11.2.3.13.3 Content ServerにシードされたSpacesデータの確認

- 11.3 Microsoft SharePointリポジトリの構成

- 11.3.1 Microsoft SharePoint: インストール

- 11.3.1.1 Microsoft SharePoint Serverのインストールに関する必要な知識

- 11.3.1.2 Microsoft SharePoint用Oracle WebCenterアダプタのインストール

- 11.3.1.3 Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール

- 11.3.2 Microsoft SharePoint: 構成

- 11.3.3 Microsoft SharePoint: セキュリティに関する考慮事項

- 11.3.4 Microsoft SharePoint: WebCenter Portalでの制限事項

- 11.3.5 WLSTを使用したMicrosoft SharePoint接続の管理

- 11.3.5.1 createJCRSharePointConnection

- 11.3.5.2 setJCRSharePointConnection

- 11.3.5.3 listJCRSharePointConnections

- 11.4 Oracle Portalリポジトリの構成

- 11.4.1 Oracle Portal: インストール

- 11.4.2 Oracle Portal: 構成

- 11.4.3 Oracle Portal: セキュリティに関する考慮事項

- 11.4.4 Oracle Portal: WebCenter Portalでの制限事項

- 11.5 ファイル・システム・リポジトリの構成

- 11.5.1 ファイル・システム: セキュリティに関する考慮事項

- 11.5.2 ファイル・システム: WebCenter Portalでの制限事項

- 11.6 コンテンツ・リポジトリの登録

- 11.6.1 Spaces用のコンテンツ・リポジトリの登録に関する必要な知識

- 11.6.2 Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録

- 11.6.3 WLSTを使用したコンテンツ・リポジトリの登録

- 11.7 アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

- 11.7.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

- 11.7.2 WLSTを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

- 11.8 コンテンツ・リポジトリ接続の詳細の変更

- 11.8.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の詳細の変更

- 11.8.2 WLSTを使用したコンテンツ・リポジトリ接続の詳細の変更

- 11.8.3 コンテンツ・プレゼンタのキャッシュ設定の変更

- 11.9 コンテンツ・リポジトリ接続の削除

- 11.9.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の削除

- 11.9.2 WLSTを使用したコンテンツ・リポジトリ接続の削除

- 11.10 Spacesコンテンツ・リポジトリの接続プロパティの設定

- 11.10.1 Fusion Middleware Controlを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定

- 11.10.2 WLSTを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定

- 11.11 コンテンツ・リポジトリ接続のテスト

- 11.11.1 Content Server接続のテスト

- 11.11.2 Oracle Portal接続のテスト

- 11.12 最大ファイル・アップロード・サイズの変更

12 アクティビティ・グラフ・サービスの管理

- 12.1 アクティビティ・グラフ・サービスに関する必要な知識

- 12.2 アクティビティ・グラフ・サービスの構成ロードマップ

- 12.3 アクティビティ・グラフ・サービスの前提条件

- 12.4 アクティビティ・グラフ・サービスのデータの準備

- 12.4.1 アクティビティ・グラフ・エンジンのスケジュール実行

- 12.4.2 アクティビティ・グラフ・エンジンのオンデマンド実行

- 12.5 類似度計算の理由文字列のカスタマイズ

- 12.6 アクティビティ・グラフ・スキーマのカスタマイズの管理

- 12.6.1 アクティビティ・グラフ・メタデータのエクスポート

- 12.6.2 プロバイダ構成のエクスポート

- 12.6.3 アクティビティ・グラフ・メタデータのインポート

- 12.6.4 アクティビティ・グラフ・メタデータの削除

- 12.6.5 アクション名およびノード・クラス名の変更

- 12.7 Oracle Secure Enterprise Searchのアクティビティ・ランクの設定

- 12.8 推奨に関する問題のトラブルシューティング

- 12.8.1 アクティビティ・グラフ・エンジンの「スケジュールとステータス」ページのトラブルシューティング

13 分析サービスの管理

- 13.1 WebCenter Portalでの分析に関する必要な知識

- 13.1.1 分析のコンポーネント

- 13.1.2 分析タスク・フロー

- 13.2 分析サービスの構成ロードマップ

- 13.3 分析の前提条件

- 13.3.1 分析: インストール

- 13.3.2 分析: 構成

- 13.3.3 分析: セキュリティに関する考慮事項

- 13.3.4 分析: 制限事項

- 13.4 分析コレクタ設定の構成

- 13.4.1 WLSTを使用した分析コレクタ・プロパティの設定

- 13.4.2 Fusion Middleware Controlを使用した分析コレクタ・プロパティの設定

- 13.5 アプリケーション用の分析コレクタの登録

- 13.5.1 Fusion Middleware Controlを使用した分析コレクタの登録

- 13.5.2 WLSTを使用した分析コレクタの登録

- 13.5.3 WebCenterイベント収集の無効化

- 13.5.3.1 Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化

- 13.5.3.2 WLSTを使用したWebCenter Portalイベント収集の無効化

- 13.6 ユーザー・プロファイル・イベントのタイミングの構成

- 13.7 分析イベント収集の検証

- 13.8 現在のWebCenter Portalの分析イベント・リストの表示

- 13.9 分析データのパージ

- 13.10 分析データのパーティション化

- 13.11 分析に関する問題のトラブルシューティング

14 お知らせおよびディスカッション・サービスの管理

- 14.1 ディスカッション・サーバー接続に関する必要な知識

- 14.2 ディスカッション・サーバーの前提条件

- 14.2.1 ディスカッション・サーバー: インストール

- 14.2.1.1 ディスカッション・サーバー: 高可用性インストール

- 14.2.2 ディスカッション・サーバー: 構成

- 14.2.3 ディスカッション・サーバー: セキュリティに関する考慮事項

- 14.2.4 ディスカッション・サーバー: 制限事項

- 14.3 ディスカッション・サーバーの登録

- 14.3.1 Fusion Middleware Controlを使用したディスカッション・サーバーの登録

- 14.3.2 WLSTを使用したディスカッション・サーバーの登録

- 14.4 ディスカッションおよびお知らせ用のアクティブな接続の選択

- 14.4.1 Fusion Middleware Controlを使用したディスカッションおよびお知らせ用のアクティブな接続の選択

- 14.4.2 WLSTを使用したディスカッションおよびお知らせ用のアクティブなディスカッションの選択

- 14.5 ディスカッション・サーバー接続の詳細の変更

- 14.5.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の詳細の変更

- 14.5.2 WLSTを使用したディスカッション・サーバー接続の詳細の変更

- 14.6 ディスカッション・サーバー接続の削除

- 14.6.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の削除

- 14.6.2 WLSTを使用したディスカッション・サーバー接続の削除

- 14.7 ディスカッション・サービスのデフォルトの設定

- 14.8 お知らせサービスのデフォルトの設定

- 14.9 ディスカッション・サーバー接続のテスト

- 14.10 ディスカッション・サーバーの管理者権限の付与

- 14.11 ディスカッション・サーバーの管理者ロールの付与

- 14.11.1 WLSTを使用したディスカッション・サーバー管理者ロールの付与

- 14.11.2 管理コンソールを使用したディスカッション・サーバー管理者ロールの付与

- 14.11.3 ディスカッション・サーバー管理者ロールの取消し

- 14.12 お知らせおよびディスカッションに関する問題のトラブルシューティング

- 14.12.1 認証に失敗した

- 14.12.2 スペースでディスカッションを有効化できない

- 14.12.3 ログインに失敗した

- 14.12.4 Oracle Access Managerの構成後にログインが正しく機能しない

- 14.12.5 カテゴリが見つからないという例外

15 イベント・サービスの管理

- 15.1 イベント接続に関する必要な知識

- 15.2 イベント・サービスの個人イベントの構成ロードマップ

- 15.3 イベント・サービスの個人イベントに関する前提条件

- 15.3.1 Microsoft Exchange Server 2007に関する前提条件

- 15.3.1.1 Microsoft Exchange Server 2007: インストール

- 15.3.1.2 Microsoft Exchange Server 2007: 構成

- 15.3.1.3 Microsoft Exchange Server 2007: セキュリティに関する考慮事項

- 15.3.1.4 Microsoft Exchange Server 2007: 制限事項

- 15.3.2 Microsoft Exchange Server 2003に関する前提条件

- 15.3.2.1 Microsoft Exchange Server 2003: インストール

- 15.3.2.2 Microsoft Exchange Server 2003: 構成

- 15.3.2.3 Microsoft Exchange Server 2003: セキュリティに関する考慮事項

- 15.3.2.4 Microsoft Exchange Server 2003: 制限事項

- 15.4 イベント・サーバーの登録

- 15.4.1 Fusion Middleware Controlを使用したイベント・サーバーの登録

- 15.4.2 WLSTを使用したイベント・サーバーの登録

- 15.5 アクティブなイベント・サーバー接続の選択

- 15.5.1 Fusion Middleware Controlを使用したアクティブなイベント・サーバーの選択

- 15.5.2 WLSTを使用したアクティブなイベント・サーバー接続の選択

- 15.6 イベント・サーバー接続の詳細の変更

- 15.6.1 Fusion Middleware Controlを使用したイベント・サーバー接続の詳細の変更

- 15.6.2 WLSTを使用したイベント・サーバー接続の詳細の変更

- 15.7 イベント・サーバー接続の削除

- 15.7.1 Fusion Middleware Controlを使用したイベント・サーバー接続の削除

- 15.7.2 WLSTを使用したイベント・サーバー接続の削除

- 15.8 イベント・サーバー接続のテスト

- 15.9 イベントに関する問題のトラブルシューティング

16 インスタント・メッセージおよびプレゼンス・サービスの管理

- 16.1 インスタント・メッセージおよびプレゼンス接続に関する必要な知識

- 16.2 インスタント・メッセージおよびプレゼンス・サーバーの前提条件

- 16.2.1 Microsoft Live Communications Server (LCS)の前提条件

- 16.2.1.1 Microsoft LCS: インストール

- 16.2.1.2 Microsoft LCS: 構成

- 16.2.1.3 Microsoft LCS: セキュリティに関する考慮事項

- 16.2.2 Microsoft Office Communications Server (OCS)の前提条件

- 16.2.2.1 Microsoft OCS: インストール

- 16.2.2.2 Microsoft OCS: 構成

- 16.2.2.2.1 シンプル・デプロイ

- 16.2.2.2.2 リモート・デプロイ

- 16.2.2.2.3 Application Provisionerの構築

- 16.2.2.2.4 OCSサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

- 16.2.2.2.5 IISサーバーの構成

- 16.2.2.2.6 UCMA v2.0のインストール

- 16.2.2.2.7 WebCenter PortalのProxyアプリケーションのインストール

- 16.2.2.3 Microsoft OCS: セキュリティに関する考慮事項

- 16.2.3 Microsoft Lyncの前提条件

- 16.2.3.1 Microsoft Lync: インストール

- 16.2.3.2 Microsoft Lync: 構成

- 16.2.3.2.1 シンプル・デプロイ

- 16.2.3.2.2 リモート・デプロイ

- 16.2.3.2.3 Application Provisionerの構築

- 16.2.3.2.4 LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

- 16.2.3.2.5 WBemTestを使用したAllowedDomainsの追加

- 16.2.3.2.6 Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス エントリの移行

- 16.2.3.2.7 IISサーバーの構成

- 16.2.3.2.8 UCMA v2.0のインストール

- 16.2.3.2.9 WebCenter PortalのProxyアプリケーションのインストール

- 16.2.3.3 Microsoft Lync: セキュリティに関する考慮事項

- 16.3 インスタント・メッセージおよびプレゼンス・サーバーの登録

- 16.3.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

- 16.3.2 WLSTを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

- 16.4 インスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

- 16.4.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

- 16.4.2 WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

- 16.5 インスタント・メッセージおよびプレゼンス接続の詳細の変更

- 16.5.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

- 16.5.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

- 16.6 インスタント・メッセージおよびプレゼンス接続の削除

- 16.6.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の削除

- 16.6.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の削除

- 16.7 インスタント・メッセージおよびプレゼンス・サービスのデフォルトの設定

- 16.8 インスタント・メッセージおよびプレゼンス接続のテスト

17 メール・サービスの管理

- 17.1 メール・サーバー接続に関する必要な知識

- 17.2 メール・サービスの構成ロードマップ

- 17.3 メール・サーバーの前提条件

- 17.3.1 メール・サーバー: インストール

- 17.3.2 メール・サーバー: 構成

- 17.3.2.1 WebCenter PortalのためのMicrosoft Exchange Server 2007または2010の構成

- 17.3.2.1.1 Microsoft Exchange Serverからの証明書の取得

- 17.3.2.1.2 WebCenter Portalキーストアへの証明書の追加

- 17.3.2.1.3 Microsoft Exchange Serverに関する考慮事項

- 17.3.3 メール・サーバー: セキュリティに関する考慮事項

- 17.3.4 メール・サーバー: 制限事項

- 17.4 メール・サーバーの登録

- 17.4.1 Fusion Middleware Controlを使用したメール・サーバーの登録

- 17.4.2 WLSTを使用したメール・サーバーの登録

- 17.5 アクティブな(またはデフォルトの)メール・サーバー接続の選択

- 17.5.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

- 17.5.2 WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

- 17.6 メール・サーバー接続の詳細の変更

- 17.6.1 Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更

- 17.6.2 WLSTを使用したメール・サーバー接続の詳細の変更

- 17.7 メール・サーバー接続の削除

- 17.7.1 Fusion Middleware Controlを使用したメール接続の削除

- 17.7.2 WLSTを使用したメール接続の削除

- 17.8 メール・サービスのデフォルトの設定

- 17.9 メール・サーバー接続のテスト

- 17.10 メールに関する問題のトラブルシューティング

- 17.10.1 セキュア・モードでメール・サービスにアクセスできない

- 17.10.2 非セキュア・モードでメール・サービスにアクセスできない

- 17.10.3 非セキュア・モードで配信リストを作成できない

- 17.10.4 セキュア・モードで配信リストを作成できない

- 17.10.5 ダウンロードするメールの件数を構成できない

- 17.10.6 スペース・メールを公開およびアーカイブできない

- 17.10.7 Microsoft Exchangeでのパスワードの変更

- 17.10.8 メールの内容が添付ファイルとして送信される

18 ピープル・コネクション・サービスの管理

- 18.1 ピープル・コネクション・サービスに関する必要な知識

- 18.2 ピープル・コネクションの前提条件

- 18.3 アクティビティ・ストリームのプロキシ・サーバーの設定

- 18.4 アクティビティ・ストリーム・スキーマのアーカイブ

- 18.5 プロファイル・サービスのキャッシュ・オプションの構成

19 サブスクリプションおよび通知の管理

- 19.1 デフォルトのサブスクリプション・プリファレンスの設定

- 19.1.1 サブスクリプションのデフォルトに関する必要な知識

- 19.1.2 サブスクリプションのデフォルトの設定

- 19.1.3 Spacesでのサブスクリプション・プリファレンスの設定

- 19.2 通知の設定

- 19.2.1 接続チャネルに関する必要な知識

- 19.2.2 通知の前提条件

- 19.2.2.1 インストール

- 19.2.2.2 構成

- 19.2.2.3 セキュリティ

- 19.2.2.4 制限事項

- 19.2.3 通知の構成ロードマップ

- 19.2.4 Fusion Middleware Controlを使用した通知チャネルの指定

- 19.2.5 WLSTを使用した通知チャネルの指定

- 19.2.6 例: WLSTを使用したSpacesアプリケーションのメール通知の設定

- 19.3 カスタム通知テンプレートの作成および適用

- 19.3.1 デフォルト通知テンプレートの上書きに関する必要な知識

- 19.3.2 デフォルト通知テンプレートの上書き

- 19.4 通知接続のテスト

- 19.5 通知に関する問題のトラブルシューティング

20 WebCenter Portalのパーソナライズの管理

- 20.1 WebCenter Portalのパーソナライズに関する必要な知識

- 20.2 開始前の作業: 必要な構成の実行

- 20.2.1 概要

- 20.2.2 アイデンティティ・アサータの構成

- 20.2.3 WebLogic Server資格証明ストアの構成

- 20.3 パーソナライズのその他の前提条件

- 20.3.1 パーソナライズのインストール要件

- 20.3.2 パーソナライズの構成要件

- 20.3.3 パーソナライズのセキュリティ

- 20.3.4 パーソナライズの制限事項

- 20.3.5 パーソナライズの構成オプション

- 20.4 WebCenter OPSSトラスト・サービスの構成

- 20.4.1 WebCenter Portalドメインでのトラスト・サービスの構成

- 20.4.2 統合WLSドメインでのトラスト・サービスの構成

- 20.4.3 ドメイン間トラストの構成

- 20.5 プロバイダの構成

- 20.5.1 プロバイダ接続設定の作成または変更

- 20.5.1.1 パーソナライズ接続情報の概要

- 20.5.1.2 接続構成の属性

- 20.5.1.3 WLSTを使用した接続の構成

- 20.5.1.4 JConsoleを使用した接続の構成

- 20.5.1.4.1 JConsoleを使用した新規接続の作成

- 20.5.1.4.2 JConsoleを使用した接続設定の編集

- 20.5.1.5 Fusion Middleware Controlを使用した接続の構成

- 20.5.1.6 カスタム構成クラスの記述

- 20.5.2 CMISプロバイダの構成

- 20.5.3 アクティビティ・グラフ・プロバイダの構成

- 20.5.4 Oracle People Connectionsロケータの構成

- 20.5.5 カスタム・プロバイダの構成

- 20.6 Coherenceの構成

- 20.7 コンテンツ・プレゼンタの構成

- 20.7.1 WebCenter PortalアプリケーションのContent Server接続の構成

- 20.7.1.1 WLSTを使用したSpacesアプリケーションの接続の構成

- 20.7.1.2 Fusion Middleware Controlを使用したSpacesアプリケーションの接続の構成

- 20.7.2 コンテンツ・プレゼンタ・タスク・フローのパラメータの構成

- 20.7.3 コンダクタのシナリオ・タグの構成

- 20.8 シングル・サインオンの構成

- 20.9 デフォルトのセキュリティ設定のオーバーライド

- 20.9.1 シナリオの匿名実行の許可

- 20.9.2 匿名ユーザーによるシナリオの作成の禁止

- 20.9.3 認証されたユーザーによるシナリオの作成の禁止

21 RSSサービスの管理

- 21.1 RSSサービスに関する必要な知識

- 21.2 RSSの前提条件

- 21.3 外部RSSニュース・フィードのためのプロキシ・サーバーの設定

- 21.4 外部RSSニュース・フィード接続のテスト

22 WebCenter PortalでのOracle SES検索の管理

- 22.1 Oracle SESでのWebCenter Portalの検索に関する必要な知識

- 22.2 WebCenter PortalでのOracle SESの構成ロードマップ

- 22.3 Oracle SESを使用するための前提条件

- 22.3.1 Oracle SES: インストール

- 22.3.2 Oracle SES: 構成

- 22.3.3 Oracle SES: セキュリティ

- 22.4 Oracle SES接続の設定

- 22.4.1 Oracle Secure Enterprise Searchサーバーの登録

- 22.4.1.1 Fusion Middleware Controlを使用したOracle SES検索接続の登録

- 22.4.1.2 WLSTを使用したOracle SES接続の登録

- 22.4.2 アクティブなOracle SES接続の選択

- 22.4.2.1 Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

- 22.4.2.2 WLSTを使用したアクティブなOracle SES接続の選択

- 22.4.3 Oracle SES接続の詳細の変更

- 22.4.3.1 Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

- 22.4.3.2 WLSTを使用したOracle SES接続の詳細の変更

- 22.4.4 Oracle SES接続の削除

- 22.4.4.1 Fusion Middleware Controlを使用した検索接続の削除

- 22.4.4.2 WLSTを使用した検索接続の削除

- 22.4.5 Oracle SES接続のテスト

- 22.5 Frameworkアプリケーションを検索するためのOracle SESの構成

- 22.5.1 Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定

- 22.5.2 Oracle SES検索のためのOracle WebCenter Portalのディスカッション・サーバーの設定

- 22.5.3 WebCenter Portalを検索するためのOracle SESの設定

- 22.5.3.1 Oracle SES管理ツールへのログオン

- 22.5.3.2 ドキュメントを検索するためのOracle SESの設定

- 22.5.3.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

- 22.5.3.4 追加のOracle SES構成

- 22.5.4 Oracle SES検索のためのWebCenter Portal: Frameworkの設定

- 22.5.4.1 デプロイ後のFrameworkアプリケーションの構成

- 22.5.4.1.1 WLSTを使用した検索パラメータの変更

- 22.5.4.1.2 WLSTを使用した検索クローラの構成

- 22.5.4.1.3 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

- 22.6 Spacesアプリケーションを検索するためのOracle SESの構成

- 22.6.1 Oracle SES検索のためのWebCenter Portal: Spacesの設定

- 22.6.1.1 WLSTを使用した検索パラメータの構成

- 22.6.1.2 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

- 22.6.2 Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定

- 22.6.3 Oracle SES検索のためのOracle WebCenter Portalディスカッション・サーバーの設定

- 22.6.4 WebCenter Portalを検索するためのOracle SESの設定

- 22.6.4.1 Oracle SES管理ツールへのログオン

- 22.6.4.2 ドキュメントを検索するためのOracle SESの設定

- 22.6.4.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

- 22.6.4.4 スペース、リスト、ページおよび人を検索するためのOracle SESの設定

- 22.6.4.5 スペース・クローラからのサービスの除外

- 22.6.4.6 追加のOracle SES構成

- 22.6.5 WLSTを使用した検索クローラの構成

- 22.6.6 Pythonスクリプトを使用したSpacesのためのOracle SES検索の構成

- 22.6.7 ページ・コンテンツのクロールのヒント

- 22.7 Oracle SES検索に関する問題のトラブルシューティング

- 22.7.1 検索結果が見つからない

- 22.7.1.1 Oracle SES接続

- 22.7.1.2 ドキュメントとディスカッションの接続

- 22.7.1.3 WebCenter Portalのクロール構成

- 22.7.1.4 Oracle SES構成

- 22.7.1.5 ユーザー認証

- 22.7.1.6 Oracle SESのクロール

- 22.7.1.7 Oracle SESの認可

- 22.7.2 検索失敗のエラー

- 22.7.3 WebCenter Portalに「表示」権限を付与できない

- 22.7.4 ソース・グループまたはソース・タイプによるOracle SESの結果の制限

- 22.7.5 検索結果に保護されたリソースが含まれない

- 22.7.6 検索結果にドキュメントが含まれない

- 22.7.7 検索結果にディスカッションとお知らせが含まれない

- 22.7.8 検索結果に最近追加されたリソースが含まれない

- 22.7.9 検索結果に認可の変更が反映されない

- 22.7.10 検索結果に幅広いユーザーに利用可能なリソースが含まれない

23 ワークリスト・サービスの管理

- 23.1 ワークリスト・サービスの構成ロードマップ

- 23.1.1 ロードマップ: WebCenter Portal: Spaces用のワークリスト・サービスの構成

- 23.1.2 ロードマップ: Frameworkアプリケーション用のワークリスト・サービスの構成

- 23.2 BPEL接続に関する必要な知識

- 23.3 BPELサーバーの前提条件

- 23.3.1 BPELサーバー: インストールと構成

- 23.3.2 BPELサーバー: セキュリティに関する考慮事項

- 23.3.3 BPELサーバー: WebCenter Portalでの制限事項

- 23.4 ワークリスト接続の設定

- 23.4.1 ワークリスト接続に関する必要な知識

- 23.4.2 ワークリスト接続の登録

- 23.4.2.1 Fusion Middleware Controlを使用したワークリスト接続の登録

- 23.4.2.2 WLSTを使用したワークリスト接続の登録

- 23.4.3 ワークリスト接続のアクティブ化

- 23.4.3.1 Fusion Middleware Controlを使用したワークリスト接続のアクティブ化

- 23.4.3.2 WLSTを使用したワークリスト接続のアクティブ化

- 23.4.4 ワークリスト接続の詳細の変更

- 23.4.4.1 Fusion Middleware Controlを使用したワークリスト接続の詳細の変更

- 23.4.4.2 WLSTを使用したワークリスト接続の詳細の変更

- 23.4.5 ワークリスト接続の削除

- 23.4.5.1 Fusion Middleware Controlを使用したワークリスト接続の削除

- 23.4.5.2 WLSTを使用したワークリスト接続の削除

- 23.5 ワークリストに関する問題のトラブルシューティング

- 23.5.1 アプリケーションの構成の問題が原因でワークリスト・サービスが使用できない

- 23.5.1.1 adf-config.xmlが存在しないBPEL接続を参照している

- 23.5.1.2 adf-config.xmlにBPEL接続への参照が含まれていない

- 23.5.1.3 「行がまだありません」というメッセージが表示される

- 23.5.2 サーバーの障害が原因でワークリスト・サービスが使用できない

- 23.5.2.1 アイデンティティ・ストア内のユーザーが一致しない

- 23.5.2.2 共有ユーザー・ディレクトリにweblogicユーザーが含まれていない

- 23.5.2.3 wsm-pmアプリケーションの問題

- 23.5.2.4 クロックの同期のずれが5分を超えている

- 23.5.2.5 ワークリスト・サービスがタイムアウトしたか無効になっている

24 ポートレット・プロデューサの管理

- 24.1 ポートレット・プロデューサに関する必要な知識

- 24.2 WSRPプロデューサの登録

- 24.2.1 Fusion Middleware Controlを使用したWSRPプロデューサの登録

- 24.2.2 WLSTを使用したWSRPプロデューサの登録

- 24.2.3 マップされたユーザーIDのための権限のポリシー・ストアへの追加

- 24.2.4 WebCenter Portal: SpacesでのWSRPポートレット・プロデューサの登録

- 24.2.5 WebCenter Portal: FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録

- 24.3 WSRPプロデューサの接続テスト

- 24.4 Oracle PDK-Javaプロデューサの登録

- 24.4.1 Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録

- 24.4.2 WLSTを使用したOracle PDK-Javaプロデューサの登録

- 24.4.3 WebCenter Portal: SpacesでのOracle PDK-Javaポートレット・プロデューサの登録

- 24.4.4 WebCenter Portal: FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録

- 24.5 Oracle PDK-Javaプロデューサの接続テスト

- 24.6 プロデューサ登録情報の編集

- 24.6.1 Fusion Middleware Controlを使用したプロデューサ登録情報の編集

- 24.6.2 WLSTを使用したプロデューサ登録情報の編集

- 24.6.3 WSRPプロデューサ・メタデータの新しいWSDL URLへの移行

- 24.7 プロデューサの登録解除

- 24.7.1 Fusion Middleware Controlを使用したプロデューサの登録解除

- 24.7.2 WLSTを使用したプロデューサの登録解除

- 24.7.3 WebCenter Portal: Spacesでのプロデューサの登録解除

- 24.7.4 WebCenter Portal: Frameworkアプリケーションでのプロデューサの登録解除

- 24.8 ポートレット・プロデューサ・アプリケーションのデプロイ

- 24.8.1 ポートレット・プロデューサ・アプリケーションのデプロイの理解

- 24.8.2 JSR 286ポートレット・プロデューサEARファイルのWSRP EARファイルへの変換

- 24.8.3 Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 24.8.4 Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 24.8.5 Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 24.8.6 WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 24.9 WebCenterサービス・ポートレットの構成

- 24.9.1 サービス・バックエンド接続の構成

- 24.9.1.1 ドキュメント・サービスのコンテンツ・リポジトリとの接続の構成

- 24.9.1.2 ワークリスト・サービスとの接続の構成

- 24.9.1.3 ディスカッション・サービスおよびお知らせサービスとの接続の構成

- 24.9.1.4 メール・サービスとの接続の構成

- 24.9.2 WebCenterサービス・ポートレットのセキュリティの構成

- 24.9.3 WebCenterサービス・ポートレットのトラブルシューティング

- 24.9.3.1 ドキュメント・マネージャおよびブログ・ポートレットでリッチ・テキスト・エディタが機能しない

- 24.9.3.2 リスト・ポートレットのリストを管理できない

- 24.9.3.3 ポートレットのタイム・ゾーンまたは日付および時間形式が正しくない

- 24.9.3.4 ポートレットにリモート・ポートレット通信エラーが表示される

- 24.10 ポートレット・プロデューサ問題のトラブルシューティング

- 24.10.1 WebCenter Portal: Frameworkアプリケーションにプロデューサを登録できない

- 24.10.2 ポートレットを使用できない: 例外WSM-00101

25 Oracle WebCenter Portalのページレット・プロデューサの管理

- 25.1 ページレット・プロデューサについて

- 25.1.1 主要な概念

- 25.1.2 WSRPおよびOracle JPDKポートレットのサポート

- 25.1.3 OpenSocialガジェットのサポート

- 25.1.4 Oracle WebCenter Interactionポートレットのサポート

- 25.2 ページレット・プロデューサの登録

- 25.2.1 Fusion Middleware Controlを使用したページレット・プロデューサのWebCenter Portalアプリケーション用の登録

- 25.2.2 WLSTを使用したページレット・プロデューサのWebCenter Portalアプリケーション用の登録

- 25.2.3 ページレット・プロデューサ・サービスの構成

- 25.2.4 WebCenter Portal: Spacesを使用したページレット・プロデューサの登録

- 25.3 ページレット・プロデューサの設定の構成

- 25.3.1 ロギング設定

- 25.3.2 プロキシ設定

- 25.3.3 変換設定

- 25.3.4 CSP設定

- 25.3.5 Kerberos設定

- 25.3.6 OpenSocial設定

- 25.4 リソースの作成

- 25.4.1 構成ページ: WebおよびCSPリソース

- 25.4.1.1 全般

- 25.4.1.2 CSP

- 25.4.1.3 ポリシー

- 25.4.1.4 自動ログイン

- 25.4.1.4.1 フォーム・ログイン

- 25.4.1.4.2 「基本ログイン」と「NTLMログイン」

- 25.4.1.4.3 Kerberosログイン

- 25.4.1.4.4 認証のソース

- 25.4.1.5 ヘッダー

- 25.4.2 WSRP/JPDKリソース用の構成ページ(WSRPおよびOracle JPDKポートレット・プロデューサ)

- 25.4.2.1 全般

- 25.4.2.2 ポリシー

- 25.4.3 OpenSocialリソース用の構成ページ(OpenSocialガジェット・プロデューサ)

- 25.4.3.1 全般

- 25.4.3.2 ポリシー

- 25.5 ページレットの作成

- 25.5.1 全般

- 25.5.2 プリファレンス

- 25.5.3 パラメータ

- 25.5.4 クリップ

- 25.5.5 ドキュメント

- 25.6 Webインジェクタの作成

- 25.6.1 全般

- 25.6.2 コンテンツ

- 25.7 カスタム・パーサーの作成

- 25.8 ホストされたファイルの作成

- 25.9 WSRPおよびOracle JPDKポートレット・プロデューサの登録

- 25.9.1 WSRPポートレット・プロデューサの登録

- 25.9.2 Oracle JPDKポートレット・プロデューサの登録

- 25.9.3 WSRPおよびOracle JPDKポートレットの使用

- 25.10 トラブルシューティング

26 外部アプリケーションの管理

- 26.1 外部アプリケーションに関する必要な知識

- 26.2 外部アプリケーションの登録

- 26.2.1 Fusion Middleware Controlを使用した外部アプリケーションの登録

- 26.2.2 WLSTを使用した外部アプリケーションの登録

- 26.2.3 Spacesアプリケーションでの外部アプリケーションの登録

- 26.2.4 Frameworkアプリケーションでの外部アプリケーションの登録

- 26.3 外部アプリケーション接続の詳細の変更

- 26.3.1 Fusion Middleware Controlを使用した外部アプリケーション接続の変更

- 26.3.2 WLSTを使用した外部アプリケーション接続の変更

- 26.4 外部アプリケーション接続のテスト

- 26.5 外部アプリケーション接続の削除

- 26.5.1 Fusion Middleware Controlを使用した外部アプリケーション接続の削除

- 26.5.2 WLSTを使用した外部アプリケーション接続の削除

- 26.5.3 WebCenter Portal: Spacesでの外部アプリケーション接続の削除

- 26.5.4 WebCenter Portal: Frameworkアプリケーションでの外部アプリケーション接続の削除

27 RESTサービスの管理

- 27.1 RESTサービスに関する必要な知識

- 27.2 RESTの有効化に必要な手動構成の実行

- 27.3 セキュリティ・トークンの概要

- 27.4 プロキシ・サーバーの構成

- 27.5 RESTのルート名の変更

- 27.6 圧縮の使用

- 27.7 認証の処理

第V部 Oracle WebCenter Portalの詳細なシステム管理

28 WebCenter Portalアプリケーションのセキュリティ管理

- 28.1 WebCenter Portalアプリケーションのセキュリティの概要

- 28.2 デフォルトのセキュリティ構成

- 28.2.1 管理者アカウント

- 28.2.2 アプリケーション・ロールとエンタープライズ・ロール

- 28.2.3 デフォルトのアイデンティティ・ストアおよびポリシー・ストア

- 28.2.3.1 ファイルベースの資格証明ストア

- 28.2.4 デフォルトのポリシー・ストアの権限および付与

- 28.2.4.1 権限ベースの認可

- 28.2.4.2 ロール・マッピングベースの認可

- 28.2.4.3 Spacesのデフォルトのポリシー・ストア権限

- 28.2.4.4 デフォルトのコードベース権限

- 28.2.5 デプロイ後のセキュリティ構成タスク

- 28.3 セキュリティ構成に関する問題のトラブルシューティング

- 28.3.1 SpacesアプリケーションでLDAPプロバイダのユーザーが見つからない

- 28.3.2 OIDユーザーとしてログインしている場合にスペースを作成するとエラーが発生する

- 28.3.3 Active Directoryを使用してSpacesを構成するとユーザーが自己登録できない

- 28.3.4 管理者に設定されたユーザーが管理者権限を使用できない

- 28.3.5 SSO環境のOmniPortletプロデューサで認可例外が発生する

- 28.3.6 SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する

- 28.3.7 SAMLシングル・サインオンを構成すると403エラーが発生する

29 アイデンティティ・ストアの構成

- 29.1 外部LDAPサーバーへのアイデンティティ・ストアの再関連付け

- 29.2 アイデンティティ・ストアのパフォーマンス・チューニング

- 29.2.1 SSLを使用する場合のアイデンティティ・ストアのチューニング

- 29.2.2 OVDを使用する場合のパフォーマンス・チューニング

- 29.2.3 Active Directoryを使用する場合のパフォーマンス・チューニング

- 29.3 外部LDAPアイデンティティ・ストア用のGUID属性の構成

- 29.4 組込みLDAPアイデンティティ・ストアへのユーザーの追加

- 29.4.1 WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加

- 29.4.2 LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加

- 29.5 外部LDAPサーバーへの管理者アカウントの移行

- 29.5.1 外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行

- 29.5.2 管理者グループ名の変更

- 29.6 Oracle Content ServerとSpacesでアイデンティティ・ストアLDAPサーバーを共有するための構成

- 29.7 libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約

- 29.7.1 アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成

- 29.7.2 アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成

- 29.7.3 単一オーセンティケータの復元

- 29.8 Spacesアプリケーション用の動的ロールの構成

- 29.8.1 動的ロールの構成の概要

- 29.8.2 動的ロールの構成の前提条件

- 29.8.3 OVDプラグインのインストール

- 29.8.4 動的ロールの構成

- 29.8.4.1 OESの構成

- 29.8.4.2 OVDプラグインの構成

- 29.8.4.3 パーソナライズ属性の構成

- 29.8.4.4 Spacesアプリケーションで動的ロールを使用するための構成

- 29.9 Spacesアプリケーション用の動的グループの構成

- 29.9.1 LDIFファイルを使用した動的グループの作成

- 29.9.2 Oracle Directory Services Managerを使用した動的グループの作成

- 29.10 RESTサービス・アイデンティティ・アサータの構成

- 29.10.1 RESTサービス・インスタンスおよびアイデンティティ・アサータの概要

- 29.10.2 クライアント・アプリケーションの設定

- 29.10.3 WLSトラスト・サービス・アサータの構成

30 ポリシーおよび資格証明ストアの構成

- 30.1 ルート・ノードの作成

- 30.2 Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け

- 30.3 WLSTを使用した資格証明およびポリシー・ストアの再関連付け

- 30.4 ポリシーおよび資格証明ストアのデータベースとの再関連付け

- 30.5 資格証明の管理

- 30.6 ユーザーおよびアプリケーション・ロールの管理

- 30.6.1 Spaces管理者ロールの付与

- 30.6.1.1 Fusion Middleware Controlを使用したSpaces管理者ロールの付与

- 30.6.1.2 WLSTを使用したSpaces管理者ロールの付与

- 30.6.2 アプリケーション・ロールの付与

- 30.6.2.1 Fusion Middleware Controlを使用したアプリケーション・ロールの付与

- 30.6.2.2 WLSTを使用したアプリケーション・ロールの付与

- 30.6.3 実行時管理ページの使用

- 30.7 Spacesアプリケーションにおける招待による自己登録の構成

- 30.8 ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定

- 30.8.1 ポリシー・ストアのリフレッシュ間隔の設定

- 30.8.2 接続プール・キャッシュの設定

- 30.8.3 ユーザー・キャッシュ設定の設定

- 30.8.4 グループ・キャッシュ設定の設定

31 シングル・サインオンの構成

- 31.1 シングル・サインオンの概要

- 31.2 Oracle Access Manager (OAM)の構成

- 31.2.1 OAMのコンポーネントとトポロジ

- 31.2.2 OAM構成のロードマップ

- 31.2.3 OAMのインストールと構成

- 31.2.3.1 OAM 11gのインストールと構成

- 31.2.3.1.1 OAM 11gのインストールと構成

- 31.2.3.1.2 Oracle HTTP Serverのインストールと構成

- 31.2.3.1.3 Web層でのWebGateのインストール

- 31.2.3.1.4 WebGateエージェントの登録

- 31.2.3.2 OAM 10gのインストールと構成

- 31.2.3.2.1 OAM 10gのインストールと構成

- 31.2.3.2.2 Oracle HTTP Serverのインストールと構成

- 31.2.3.2.3 WebCenter Portalポリシー・ドメインの構成

- 31.2.3.2.4 Web層でのWebGate 10gのインストール

- 31.2.4 OAM用のWebLogicドメインの構成

- 31.2.4.1 Oracle Internet Directoryオーセンティケータの構成

- 31.2.4.2 OAMアイデンティティ・アサータの構成

- 31.2.4.3 デフォルト・オーセンティケータとプロバイダの順序の構成

- 31.2.4.4 OAMシングル・サインオン・プロバイダの追加

- 31.2.5 Oracle HTTP Serverのインストールと構成

- 31.2.6 追加のシングル・サインオン構成

- 31.2.6.1 SSO用のWebCenter Portal: Spacesの構成

- 31.2.6.2 SSO用のディスカッション・サーバーの構成

- 31.2.6.2.1 Spaces用のディスカッション・サーバー接続の作成

- 31.2.6.3 SSO用のワークリスト・サービスの構成

- 31.2.6.4 外部リーダーを使用したRSSフィード用のOAMの構成

- 31.2.6.4.1 OAM 11gのRSSフィードの非保護

- 31.2.6.4.2 OAM 10gのRSSフィードの非保護

- 31.2.6.5 OAM 10g用のWebLogic Server管理コンソールとEnterprise Managerの構成

- 31.2.6.6 OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成

- 31.2.6.7 SSO用のSecure Enterprise Searchの構成

- 31.2.6.8 SSO用のContent Serverの構成

- 31.2.6.9 接続フィルタを使用したアクセスの制限

- 31.2.6.10 ポートレット・プロデューサと追加コンポーネントの構成

- 31.2.7 OAMインストールのテスト

- 31.3 Oracle Single Sign-On (OSSO)の構成

- 31.3.1 OSSO構成のロードマップ

- 31.3.2 OSSOのコンポーネントとトポロジ

- 31.3.3 Oracle HTTP Serverと関連モジュールの構成

- 31.3.4 OSSOIdentityAsserterの構成

- 31.3.5 Oracle SSOへのOHSの登録

- 31.3.6 追加構成

- 31.3.6.1 SSO用のWebCenter Portal: Spacesの構成

- 31.3.6.2 Web層OHSポートを使用したアクセスの制限

- 31.3.6.3 SSO用のディスカッション・サーバーの構成

- 31.3.6.4 SSO用のワークリスト・サービスの構成

- 31.3.6.5 SSO用のOracle Content Serverの構成

- 31.3.6.6 外部リーダーを使用したRSSフィード用のOSSOの構成

- 31.3.6.7 SSO用のSESクロールの構成

- 31.4 SAMLベースのシングル・サインオンの構成

- 31.4.1 SAMLのコンポーネントとトポロジ

- 31.4.2 SAMLベースのシングル・サインオンの構成

- 31.4.2.1 SAMLシングル・サインオンの前提条件

- 31.4.2.1.1 SAML SSO用のOracle Content Serverの構成

- 31.4.2.1.2 SAML SSO用のディスカッション・サーバーの構成

- 31.4.2.1.3 証明書の構成とエクスポート

- 31.4.2.1.4 SSLのセットアップ

- 31.4.2.2 SAMLベースのSSOの構成

- 31.4.2.2.1 シングル・サインオンのスクリプト

- 31.4.2.2.2 スクリプトの使用

- 31.4.2.3 外部リーダーを使用したRSS用のSAML SSOの構成

- 31.4.2.4 構成のチェック

- 31.4.2.5 SAML SSO構成の無効化

- 31.4.2.6 SAML SSO構成の削除

- 31.5 Microsoftクライアント用のSSOの構成

- 31.5.1 MicrosoftクライアントSSOの概念

- 31.5.2 システム要件

- 31.5.3 Microsoftクライアントの構成

- 31.5.3.1 ネゴシエート・アイデンティティ・アサーション・プロバイダの構成

- 31.5.3.2 Active Directory認証プロバイダの構成

- 31.5.3.3 WebCenter Portal: Spacesの構成

- 31.5.3.4 SSO用のディスカッション・サーバーの構成

- 31.6 仮想ホストを使用したSSOの構成

- 31.6.1 仮想ホストの必要性の概要

- 31.6.2 OSSO用の仮想ホストの構成

- 31.6.3 OAM 10g用の仮想ホストの構成

- 31.6.4 OAM 11g用の仮想ホストの構成

- 31.6.5 仮想ホスト用のWebCenter Portalの構成

- 31.6.6 構成のテスト

32 シングル・サインオン向けのFrameworkアプリケーションの構成

- 32.1 構成の概要

- 32.2 シングル・サインオンの前提条件

- 32.2.1 web.xmlへのCLIENT-CERTの追加

- 32.2.2 JSESSIONIDのCookieパスの設定

- 32.2.3 アプリケーションの公開URIおよび保護対象URIの指定

- 32.2.4 埋込みログインの意味

- 32.2.5 ログアウトの処理

- 32.3 Web層の構成

- 32.4 OAMに対するFrameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成

- 32.4.1 OAM 10gに対するFrameworkアプリケーションの構成

- 32.4.2 OAM 10gに対するポートレット・プロデューサ・アプリケーションの構成

- 32.4.3 OAM 11gに対するFrameworkアプリケーションの構成

- 32.4.4 OAM 11gに対するポートレット・プロデューサ・アプリケーションの構成

- 32.5 OSSOに対するFrameworkアプリケーションの構成

- 32.6 SAML SSOに対するFrameworkアプリケーションの構成

- 32.6.1 宛先のFrameworkアプリケーションへのSAML SSOの構成

- 32.6.1.1 宛先サイトの有効化

- 32.6.1.2 リライイング・パーティの構成

- 32.6.1.3 アサーティング・パーティの構成

- 32.6.2 ソースのFrameworkアプリケーションへのSAML SSOの構成

- 32.6.2.1 SAML ITSの保護

- 32.6.2.2 JSESSIONIDのCookieパスの設定

- 32.6.2.3 SSOプロパティのTrueとしての設定

- 32.6.2.4 SAML資格証明マッピング・プロバイダの構成

- 32.6.2.5 リライイング・パーティの構成

- 32.6.2.6 ソース・サイトのフェデレーション・サービスの構成

- 32.6.2.7 SAMLアイデンティティ・アサーション・プロバイダの構成

- 32.6.2.8 宛先サイトのフェデレーション・サービスの構成

- 32.6.2.9 その他の宛先アプリケーションの構成

33 SSLの構成

- 33.1 SSLを使用したブラウザからSpacesへの接続の保護

- 33.1.1 カスタム・キーストアの作成

- 33.1.2 カスタムIDキーストアおよびJava信頼キーストアの構成

- 33.1.3 SSL接続の構成

- 33.2 SSLを使用したブラウザからFrameworkアプリケーションへの接続の保護

- 33.3 SSLを使用したOracle HTTP ServerからSpacesへの接続の保護

- 33.3.1 IDキーストアおよび信頼キーストアの構成

- 33.3.2 SSL接続の構成

- 33.3.3 Oracle HTTP Serverのインストール

- 33.3.4 SpacesポートからHTTP Serverへのワイヤリング

- 33.3.5 SSL証明書の構成

- 33.4 SSLを使用したブラウザからディスカッション・サービスへの接続の保護

- 33.4.1 カスタム・キーストアの作成

- 33.4.2 IDキーストアおよび信頼キーストアの構成

- 33.4.3 SSL接続の構成

- 33.5 SSLを使用したSpacesからポートレット・プロデューサへの接続の保護

- 33.5.1 IDキーストアおよび信頼キーストアの構成

- 33.5.2 SSL接続の構成

- 33.5.3 SSL対応WSRPプロデューサの登録およびポートレットの実行

- 33.5.4 SSL対応PDK-Javaプロデューサの登録およびポートレットの実行

- 33.6 SpacesからLDAPアイデンティティ・ストアへの接続の保護

- 33.6.1 OID認証局(CA)のエクスポート

- 33.6.2 WebLogicサーバーの設定

- 33.7 SSLを使用したSpacesからContent Serverへの接続の保護

- 33.7.1 クライアント・サイドでのキーストアおよびキーの構成

- 33.7.2 サーバー・サイドでのキーストアおよびキーの構成

- 33.7.3 信頼できるクライアントのシグネチャの検証

- 33.7.4 アイデンティティ伝搬の保護

- 33.8 SSLを使用したSpacesからIMAPおよびSMTPへの接続の保護

- 33.9 SSLを使用したFrameworkアプリケーションからIMAPおよびSMTPへの接続の保護

- 33.10 SSLを使用したOracle SESへの接続の保護

- 33.11 SSLを使用したSpacesからMicrosoft Live Communication ServerおよびOffice Communication Serverへの接続の保護

- 33.12 SSLを使用したSpacesから外部BPELサーバーへの接続の保護

34 WS-Securityの構成

- 34.1 単純トポロジの場合のWS-Securityの構成

- 34.1.1 単純トポロジの場合のWS-Securityの構成のロードマップ

- 34.1.2 WebCenter Portalドメイン・キーストアの設定

- 34.1.2.1 WebCenter Portalドメイン・キーストアの作成

- 34.1.2.2 WLSTを使用したキーストアの構成

- 34.1.2.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.1.3 単純トポロジの場合のディスカッション・サーバーの構成

- 34.1.3.1 ディスカッション・サービス・エンド・ポイントの保護

- 34.1.3.1.1 Fusion Middleware Controlを使用したディスカッション・サーバー・エンド・ポイントの保護

- 34.1.3.1.2 WLSTを使用したディスカッション・サーバー・エンド・ポイントの保護

- 34.1.3.2 ディスカッション・サーバーの接続設定の構成

- 34.1.4 単純トポロジの場合のコマンド・サマリー

- 34.2 標準トポロジの場合のWS-Securityの構成

- 34.2.1 標準トポロジの場合のWS-Securityの構成のロードマップ

- 34.2.2 WebCenter Portalドメイン・キーストアの設定

- 34.2.2.1 WebCenter Portalドメイン・キーストアの作成

- 34.2.2.2 WLSTを使用したキーストアの構成

- 34.2.2.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.2.3 標準トポロジの場合のディスカッション・サーバーの構成

- 34.2.4 SOAドメインの設定

- 34.2.4.1 SOAドメイン・キーストアの作成

- 34.2.4.2 WLSTを使用したキーストアの構成

- 34.2.4.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.2.5 標準トポロジの場合のコマンド・サマリー

- 34.3 複合トポロジの場合のWS-Securityの構成

- 34.3.1 複合トポロジの場合のWS-Securityの構成のロードマップ

- 34.3.2 WebCenter Portalドメイン・キーストアの設定

- 34.3.2.1 WebCenter Portalドメイン・キーストアの作成

- 34.3.2.2 WLSTを使用したキーストアの構成

- 34.3.2.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.3.3 複合トポロジの場合のディスカッション・サーバーの構成

- 34.3.3.1 ディスカッション・サービスのエンド・ポイントの保護

- 34.3.3.2 ディスカッション・サーバー・キーストアの作成

- 34.3.3.3 資格証明ストアの更新

- 34.3.3.4 ディスカッション・サーバーの接続設定の構成

- 34.3.4 1つ目のSOAドメインの設定

- 34.3.4.1 SOAドメイン・キーストアの作成

- 34.3.4.2 WLSTを使用したキーストアの構成

- 34.3.4.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.3.5 2つ目のSOAドメインの設定

- 34.3.5.1 SOAドメイン・キーストアの作成

- 34.3.5.2 WLSTを使用したキーストアの構成

- 34.3.5.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.3.5.4 2つ目のSOAサーバーのSpacesワークリスト接続の構成

- 34.3.6 外部ポートレット・ドメイン・キーストアの設定

- 34.3.6.1 外部ポートレット・ドメイン・キーストアの作成

- 34.3.6.2 WLSTを使用したキーストアの構成

- 34.3.6.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.3.7 外部WebCenter Portalドメイン・キーストアの設定

- 34.3.7.1 外部WebCenter Portalドメイン・キーストアの作成

- 34.3.7.2 WLSTを使用したキーストアの構成

- 34.3.7.3 Fusion Middleware Controlを使用したキーストアの構成

- 34.3.8 複合トポロジの場合のコマンド・サマリー

- 34.4 Spaces Client APIを使用するアプリケーションに対するWS-Securityを使用したSpacesの保護

- 34.4.1 SpacesクライアントAPIを使用するアプリケーションの単純トポロジの構成

- 34.4.2 SpacesクライアントAPIを使用するアプリケーションの標準トポロジの構成

- 34.4.3 SpacesクライアントAPIを使用するアプリケーションの複合トポロジの構成

35 ポートレット・プロデューサのセキュリティの構成

- 35.1 WSRPプロデューサの保護

- 35.1.1 プロデューサのデプロイ

- 35.1.2 プロデューサ・エンドポイントへのポリシーの添付

- 35.1.3 キーストアの設定

- 35.2 PDK-Javaプロデューサの保護

- 35.2.1 パスワード資格証明としての共有鍵の定義

- 35.2.1.1 Fusion Middleware Controlを使用した共有鍵の定義

- 35.2.1.2 WLSTを使用した共有鍵の定義

36 WebCenter Portal管理コンソールの使用

- 36.1 WebCenter Portal管理コンソールの概要

- 36.2 WebCenter Portal管理コンソールへのアクセス

- 36.3 アプリケーションのデフォルト設定の構成

- 36.3.1 デフォルト・ページ・テンプレートの選択

- 36.3.2 デフォルト・リソース・カタログの選択

- 36.3.3 デフォルト・ナビゲーションの選択

- 36.3.4 デフォルト・スキンの選択

- 36.3.5 デフォルト・ベース・リソースURLの選択

- 36.4 アプリケーション・メンバーおよびロールの管理

- 36.4.1 ユーザーの概要

- 36.4.2 アプリケーション・ロールおよび権限の概要

- 36.4.2.1 アプリケーション・ロールの概要

- 36.4.2.1.1 デフォルトのアプリケーション・ロール

- 36.4.2.1.2 カスタム・アプリケーション・ロール

- 36.4.2.2 アプリケーション権限の概要

- 36.4.2.2.1 アプリケーション権限

- 36.4.2.2.2 ディスカッション・サーバーのロール・マッピング

- 36.4.2.2.3 エンタープライズ・グループのロール・マッピングの概要

- 36.4.3 ユーザーの管理

- 36.4.3.1 アプリケーション・ロールへのメンバーの追加

- 36.4.3.2 ユーザーへの異なるロールの割当て

- 36.4.3.3 ユーザーへの管理権限の付与

- 36.4.3.4 アプリケーション・ロールの取消し

- 36.4.3.5 ユーザーの追加または削除

- 36.4.4 アプリケーション・ロールおよび権限の管理

- 36.4.4.1 アプリケーション・ロールの定義

- 36.4.4.2 アプリケーション・ロールの権限の変更

- 36.4.4.3 認証されていないユーザーへのロールの付与または削除

- 36.4.4.4 認証されているすべてのユーザーへのロールの付与

- 36.4.4.5 アプリケーション・ロールの削除

- 36.5 アプリケーション・リソースの管理

- 36.5.1 ページの使用

- 36.5.1.1 ページの作成

- 36.5.1.2 サブページの作成

- 36.5.1.3 ページのアクセス権限の設定

- 36.5.1.3.1 個々のページの権限の設定

- 36.5.1.3.2 ルート・ノードの権限の設定

- 36.5.1.4 ページの並替え

- 36.5.1.5 ページ階層内のページの移動

- 36.5.1.6 ページ名の変更

- 36.5.2 リソースの作成

- 36.5.3 リソースのコピー

- 36.5.4 リソースの編集

- 36.5.4.1 リソースのソース・コードの編集

- 36.5.4.2 「編集」ダイアログを使用したリソースの編集

- 36.5.5 リソースのプロパティの設定

- 36.5.5.1 リソースの「プロパティの編集」ダイアログへのアクセス

- 36.5.5.2 リソースの名前変更、説明および分類

- 36.5.5.3 アイコンとリソースの関連付け

- 36.5.5.4 リソースの属性の使用

- 36.5.5.4.1 属性とリソースの関連付け

- 36.5.5.4.2 リソースの属性の削除

- 36.5.6 リソースの表示と非表示

- 36.5.7 リソース・セキュリティの設定

- 36.5.8 リソースのダウンロードとアップロード

- 36.5.9 リソースのプレビュー

- 36.5.10 リソースの削除

- 36.6 サービス、ポートレット・プロデューサおよび外部アプリケーションの管理

- 36.6.1 コンテンツの管理

- 36.6.1.1 新規フォルダの作成

- 36.6.1.2 Wikiページの作成

- 36.6.1.3 ファイルの編集

- 36.6.1.4 ドキュメントのアップロード

- 36.6.1.5 ドキュメントのチェックアウト

- 36.6.1.6 ドキュメントの新規バージョンのアップロード

- 36.6.1.7 コンテンツ・アイテムのバージョン履歴の表示

- 36.6.1.8 ドキュメントのダイレクトURLとダウンロードURLの取得

- 36.6.1.9 表示コンテンツの列の整理

- 36.6.1.9.1 列の表示

- 36.6.1.9.2 列の並替え

- 36.6.1.10 フォルダとドキュメントのセキュリティの設定

- 36.6.2 ポートレット・プロデューサの管理

- 36.6.2.1 ポートレット・プロデューサの登録

- 36.6.2.2 ポートレット・プロデューサの編集と削除

- 36.6.3 外部アプリケーションの管理

- 36.6.3.1 外部アプリケーションの登録

- 36.6.3.2 外部アプリケーションの編集と削除

- 36.6.4 投票の作成と構成

- 36.6.4.1 投票サービスに関する必要な知識

- 36.6.4.2 投票の作成、構成および分析

37 複数言語ポータルの管理

- 37.1 Spacesアプリケーションの言語に関する必要な知識

- 37.1.1 Spacesによってデフォルトでサポートされる言語

- 37.2 特定の文字列またはスペースへの編集の制限

- 37.2.1 文字列のリソース・キーの確認

- 37.2.2 スペースのGUIDの確認

- 37.3 文字列の変更

- 37.4 Spacesへの新規言語のサポートの追加

- 37.5 コンテンツ・プレゼンタ・テンプレートによる翻訳済コンテンツの表示

38 Oracle WebCenter Portalのパフォーマンスの監視

- 38.1「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」

- 38.1.1 WebCenter Portalのメトリック収集: 最近の履歴および起動時以降

- 38.1.2 共通のWebCenter Portalのメトリック

- 38.1.3 共通のWebCenter Portalのパフォーマンスの問題およびアクション

- 38.1.4 WebCenter Portalサービス固有のメトリック

- 38.1.4.1 お知らせのメトリック

- 38.1.4.2 BPELワークリストのメトリック

- 38.1.4.3 コンテンツ・リポジトリのメトリック

- 38.1.4.4 ディスカッションのメトリック

- 38.1.4.5 イベントのメトリック

- 38.1.4.6 外部アプリケーションのメトリック

- 38.1.4.7 インスタント・メッセージおよびプレゼンス(IMP)のメトリック

- 38.1.4.8 インポートおよびエクスポートのメトリック

- 38.1.4.9 リストのメトリック

- 38.1.4.10 メールのメトリック

- 38.1.4.11 ノートのメトリック

- 38.1.4.12 ページのメトリック

- 38.1.4.13 ポートレット・プロデューサのメトリック

- 38.1.4.14 ポートレットのメトリック

- 38.1.4.15 ピープル・コネクションのメトリック

- 38.1.4.16 投票のメトリック

- 38.1.4.17 RSSニュース・フィードのメトリック

- 38.1.4.18 最近のアクティビティのメトリック

- 38.1.4.19 検索のメトリック

- 38.1.5 WebCenter Portalサービス固有のパフォーマンスの問題およびアクション

- 38.1.5.1 お知らせサービス

- 38.1.5.2 BPELワークリスト・サービス

- 38.1.5.3 コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス

- 38.1.5.4 ディスカッション・サービス

- 38.1.5.5 外部アプリケーション・サービス

- 38.1.5.6 イベント・サービス

- 38.1.5.7 インスタント・メッセージおよびプレゼンス(IMP)サービス

- 38.1.5.8 インポートおよびエクスポート

- 38.1.5.9 リスト・サービス

- 38.1.5.10 メール・サービス

- 38.1.5.11 ノート・サービス

- 38.1.5.12 ページ・サービス

- 38.1.5.13 ポートレットおよびプロデューサ

- 38.1.5.14 ピープル・コネクション・サービス

- 38.1.5.15 投票サービス

- 38.1.5.16 RSSサービス

- 38.1.5.17 最近のアクティビティ・サービス

- 38.1.5.18 検索サービス

- 38.1.6 スペースのメトリック

- 38.1.7 ページのメトリック

- 38.2 パフォーマンス情報の表示

- 38.2.1 Spacesアプリケーションの監視

- 38.2.1.1 サービスのメトリックの監視

- 38.2.1.2 スペースのメトリックの監視

- 38.2.1.3 Spacesアプリケーションのページのメトリックの監視

- 38.2.1.4 メトリック・パレットを通じたすべてのメトリックの監視

- 38.2.2 Frameworkアプリケーションの監視

- 38.2.2.1 サービスのメトリックの監視

- 38.2.2.2 Frameworkアプリケーションのページのメトリックの監視

- 38.2.2.3 メトリック・パレットを通じたすべてのメトリックの監視

- 38.3 ログ情報の表示および構成

- 38.3.1 Spacesアプリケーションのログ

- 38.3.2 Frameworkアプリケーションのログ

39 WebCenter Portalのエクスポート、インポート、バックアップおよびリカバリの管理

- 39.1 データ移行のためのSpacesアプリケーションのエクスポートおよびインポート

- 39.1.1 Spacesのエクスポートおよびインポートの理解

- 39.1.2 Spacesアプリケーションのエクスポートおよびインポートの前提条件

- 39.1.3 Spacesアプリケーション全体のバックエンド・コンポーネントの移行

- 39.1.3.1 LDAPアイデンティティ・ストアのエクスポート

- 39.1.3.2 LDAPアイデンティティ・ストアのインポート

- 39.1.3.3 LDAP資格証明ストアのエクスポートおよびインポート

- 39.1.3.4 LDAPポリシー・ストアのエクスポートおよびインポート

- 39.1.3.5 ファイルベースの資格証明ストアのエクスポートおよびインポート

- 39.1.3.6 ファイルベースのポリシー・ストアのエクスポートおよびインポート

- 39.1.3.7 ディスカッション・サーバー・データのエクスポート

- 39.1.3.8 ディスカッション・サーバー・データのインポート

- 39.1.3.9 Oracle Content Serverデータのエクスポート

- 39.1.3.10 Oracle Content Serverデータのインポート

- 39.1.3.11 Oracle WebLogic Communications Serverのエクスポート

- 39.1.3.12 Oracle WebLogic Communications Serverのインポート

- 39.1.3.13 ポートレット・プロデューサのエクスポート

- 39.1.3.14 ポートレット・プロデューサのインポート

- 39.1.4 Spacesアプリケーション全体のエクスポート

- 39.1.4.1 Fusion Middleware Controlを使用したSpacesアプリケーションのエクスポート

- 39.1.4.2 WLSTを使用したSpacesアプリケーションのエクスポート

- 39.1.5 Spacesアプリケーション全体のインポート

- 39.1.5.1 Fusion Middleware Controlを使用したSpacesアプリケーションのインポート

- 39.1.5.2 WLSTを使用したSpacesアプリケーションのインポート

- 39.1.5.3 インポートされたSpacesアプリケーションの確認

- 39.1.6 個々のスペースのエクスポートおよびインポートの前提条件

- 39.1.7 個々のスペースのバックエンド・コンポーネントの移行

- 39.1.7.1 スペースのディスカッションのエクスポート

- 39.1.7.2 スペースのディスカッションのインポート

- 39.1.7.3 スペースのドキュメントのエクスポート

- 39.1.7.4 スペースのドキュメントのインポート

- 39.1.7.5 ドキュメント移行ユーティリティを使用したスペース・ドキュメントのエクスポート/インポート

- 39.1.7.5.1 ドキュメント移行ユーティリティの実行に必要なプロパティ

- 39.1.7.5.2 ドキュメント移行ユーティリティを使用したコンテンツの移行

- 39.1.7.5.3 追加のログを指定したドキュメント移行ユーティリティの実行

- 39.1.8 個々のスペースのエクスポート

- 39.1.8.1 Spacesアプリケーションを使用した個々のスペースのエクスポート

- 39.1.8.2 WLSTを使用した個々のスペースのエクスポート

- 39.1.9 個々のスペースのインポート

- 39.1.9.1 Spacesアプリケーションを使用した個々のスペースのインポート

- 39.1.9.2 WLSTを使用した個々のスペースのインポート

- 39.1.10 スペース・テンプレートのバックエンド・コンポーネントの移行

- 39.1.11 スペース・テンプレートのエクスポート

- 39.1.11.1 Spacesアプリケーションを使用したスペース・テンプレートのエクスポート

- 39.1.11.2 WLSTを使用したスペース・テンプレートのエクスポート

- 39.1.12 スペース・テンプレートのインポート

- 39.1.12.1 Spacesアプリケーションを使用したスペース・テンプレートのインポート

- 39.1.12.2 WLSTを使用したスペース・テンプレートのインポート

- 39.1.13 Spacesリソースのエクスポート

- 39.1.13.1 Spacesアプリケーションを使用したWebCenterリソースのエクスポート

- 39.1.13.2 WLSTを使用したWebCenterリソースのエクスポート

- 39.1.14 Spacesリソースのインポート

- 39.1.14.1 Spacesアプリケーションを使用したWebCenterリソースのインポート

- 39.1.14.2 WLSTを使用したWebCenterリソースのインポート

- 39.2 データ移行のためのFrameworkアプリケーションのエクスポートおよびインポート

- 39.2.1 Frameworkアプリケーションのエクスポートおよびインポートの理解

- 39.2.2 Frameworkアプリケーションのエクスポートおよびインポートの前提条件

- 39.2.3 ポートレット・クライアント・メタデータのエクスポート(Frameworkアプリケーション)

- 39.2.4 ポートレット・クライアント・メタデータのインポート(Frameworkアプリケーション)

- 39.2.5 WebCenter Portalリソースのエクスポート(Frameworkアプリケーション)

- 39.2.6 WebCenter Portalリソースのインポート(Frameworkアプリケーション)

- 39.2.7 WebCenter Portalサービス・メタデータおよびデータのエクスポート(Frameworkアプリケーション)

- 39.2.8 WebCenter Portalサービス・メタデータおよびデータのインポート(Frameworkアプリケーション)

- 39.2.9 WebCenter Portalアプリケーションのセキュリティの移行

- 39.2.10 データの移行(WebCenter Portalアプリケーション)

- 39.2.10.1データのエクスポート(WebCenter Portalアプリケーション)

- 39.2.10.2 データのインポート(WebCenter Portalアプリケーション)

- 39.3 他のWikiアプリケーションからのWikiドキュメントの移行

- 39.3.1 スペースおよびスペース・テンプレートのドキュメント・コンテンツの理解

- 39.3.1.1 スペースの理解

- 39.3.1.2 スペース・テンプレートの理解

- 39.3.1.3 フォルダおよびフォルダのファイル制限の理解

- 39.3.1.4 スペースおよびスペース・テンプレートのエクスポート/インポートの理解

- 39.3.2 WikiドキュメントおよびWikiページの理解

- 39.3.2.1 Wikiドキュメントの理解

- 39.3.2.2 Wikiページの理解

- 39.3.3 ドキュメント移行ユーティリティの理解

- 39.3.3.1 ドキュメント移行ユーティリティのエクスポート機能の理解

- 39.3.3.2 ドキュメント移行ユーティリティのインポート機能の理解

- 39.3.3.2.1 ドキュメント移行ユーティリティのメタデータの処理方法の理解

- 39.3.3.2.2 ドキュメント移行アーカイブ

- 39.3.4 ソースWikiアプリケーションからSpacesへのデータの移行

- 39.3.4.1 WikiコンテンツのインポートのためのWebCenter Portal: Spacesの準備

- 39.3.4.2 Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

- 39.3.4.2.1 Wikiコンテンツの抽出と配置

- 39.3.4.2.2 WikiドキュメントのソースHTMLのクリーンアップ

- 39.3.4.2.3 URLのリライト

- 39.3.4.2.4 ExportImportData.xmlドキュメントの構築

- 39.3.4.2.5 アーカイブ・ファイルの構築

- 39.3.4.3 ドキュメント移行ユーティリティを使用したターゲット・スペースへのアーカイブのインポート

- 39.3.4.4 Content Serverのコンテンツに対するSpacesのWikiページの作成

- 39.4 WebCenter Portalアプリケーションのバックアップおよびリカバリ

- 39.5 Spacesのインポートおよびエクスポート問題のトラブルシューティング

- 39.5.1 ResourceLimitExceptionの問題

- 39.5.2 スペースおよびスペース・テンプレートがインポート後に使用できない

- 39.5.3 マルチバイト言語でのスペースのエクスポートおよびインポート

- 39.5.4 インポート後にページまたはスペースでメッセージが見つからない

- 39.5.5 スペース・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

- 39.5.6 リストが適切にインポートされない

- 39.5.7 Spacesカスタマイズのインポート

- 39.5.8 サービスが構成されているスペースのエクスポートおよびインポート

第VI部 付録

A WebCenter Portalの構成

- A.1 構成ファイル

- A.1.1 adf-config.xmlおよびconnections.xml

- A.1.2 web.xml

- A.1.2.1 Spacesのweb.xmlプロパティの編集

- A.1.2.2 WebCenter Portalアプリケーションのweb.xmlプロパティの編集

- A.1.3 webcenter-config.xml

- A.2 クラスタ構成

- A.3 構成ツール

- A.4 Oracle WebCenter Portalのパフォーマンスのチューニング

- A.5 WebCenter Portalアプリケーションの構成に関する問題のトラブルシューティング

- A.5.1 WebCenter PortalがFusion Middleware Controlの「アプリケーションのデプロイ」メニューに表示されない

- A.5.2 使用不可の構成オプション

- A.5.3 あるアプリケーションで実行された構成が別のアプリケーションに反映される

- A.5.4 Spacesアプリケーションのログはオープン・ファイルが多すぎることを示している

- A.6 WLSTコマンドの問題のトラブルシューティング

- A.6.1 WebCenter Portal WLSTコマンドがいずれも機能しない

- A.6.2 WLSTコマンドが特定のサービスに対して機能しない

- A.6.3 Connection_Nameという名前の接続がすでに存在している

- A.6.4 WLSTシェルがOracle WebLogic管理対象サーバー・インスタンスに接続されない

- A.6.5 同じ名前のアプリケーションがドメインにすでに存在している

- A.6.6 同じ名前のアプリケーションが管理対象サーバーにすでに存在している

- A.6.7 ドメイン・ランタイム・ツリーにすでにメッセージが表示される

B WebCenter PortalのOracle HTTP Server構成

用語集

索引

Oracle® Fusion Middleware

Oracle WebCenter Portal管理者ガイド

11gリリース1(11.1.1.6.0)

B72085-01(原本部品番号:E12405-18)

2012年12月

Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド, 11gリリース1(11.1.1.6.0)

B72085-01

Copyright © 2007, 2012, Oracle and/or its affiliates. All rights reserved.

原本主著者:  Rosie Harvey

原本協力著者: Ingrid Snedecor, Joan Carter, Michele Cyran, Peter Jacobsen, Promila Chitkara, Sarah Bernau, Savita Thakur, Sue Highmoor

原本協力者: Alan Jalife, Alison Macmillan, Alistair Wilson, Annesharmila Immanueljoseph, Artem Stemkovski, Avinash Rajendran, Chandrahasa Peddamallu, Chris Bales, Christian Hauser, Chung Cheng, Corinne Pelote, Dan Mullen, David Pattelena, Diego Sabaris, Harsha Ramesh, Howard Wu, Gaston Martino, Greg Gutkin, Igor Polyakov, Jamie Lord, Jeff Prehm, Jeni Ferns, John Whiting, Karl Bilawski, Ken Young, Kim-Phung Dinh, Lei Oh , Madhu Muppagowni, Mahima Subbaraman, Manish Devgan, Marcus Diaz, Mark Rossi, Michele Chen Chock, Nagaraju Suravarjjala, Nazar Doroshenko, Nicolas Pombourcq, Nitin Shah, Pankaj Mittal, Preeti Yarashi, Pushkar Kapasi, Rahmath Baig, Ravi Baranwal, Rich Nessel, Robin Fisher, Rohit Kularni, Roopam Bahl, Sachin Parashar, Sarah Maslin, Seshan Kannan, Shin Huang, Shakeb Sagheer, Shaolin Shen, Sharmila Jayaram, Sunil Franklin, Stephen Thornhill, Steve Roth, Tim Lake, Yueh-Hong Lin, Vaibhav Lole, Ved Singh, Vineet Duggal

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracleおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』をお読みいただきありがとうございます。このガイドでは、Oracle WebCenter Portal、WebCenter Portal: Spaces、およびWebCenter Portal: Frameworkを使用して構築された他のアプリケーション・デプロイメントの管理方法について説明します。

ここでは、WebCenter Portalアプリケーションの開始および停止方法、WebCenter Portalのコンポーネント、バックエンド・サービスおよびセキュリティの構成方法、さらにWebCenter Portalアプリケーションおよびサービスのバックアップ、リカバリおよび移行方法について説明します。

対象読者

このドキュメントは次の読者を対象としています。

- WebCenter PortalのインストールおよびWebCenter Portalアプリケーションのデプロイ(Spaces含む)を担当するFusion Middleware管理者

- WebCenter Portalアプリケーションの管理者(WebCenter Portal管理コンソールでAdministratorロールを付与されたユーザー)

このガイドでは、読者が『Oracle Fusion Middleware管理者ガイド』に記述された概念および内容について理解していることを前提としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

お客様は、My Oracle Supportから電子サポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs(聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、次のOracle Fusion Middleware 11gリリース1(11.1.1)のドキュメントを参照してください。

- 『Oracle Fusion Middleware管理者ガイド』

- Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイド

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』

- Oracle Fusion Middleware Oracle WebCenter Portal開発者チュートリアル

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

新機能

リリース11.1.1.6の新機能の例としては、より高速なパフォーマンス、簡略化された接続インタフェース、および向上したデザインタイム体験などがあります。このリリースでの新機能の要約、およびより詳細な情報への指針として、このクイック・リファレンス・ページを参照してください。

注意:

パッチ適用には、既存インストールでのファイルの小さな集合のコピーが含まれます。パッチは、通常はOracle製品の特定のリリースに関連付けられており、製品のマイナー・リリースから同じ製品の新しいマイナー・リリースへの更新を含みます(たとえば、リリース11.1.1.5.0からリリース11.1.1.6.0)。パッチ・セットは、一緒に適用されるよう設計されたパッチの集合を含む単一のパッチです。

引き続き同じサポートを得るために、すべてのユーザーはリリース11.1.1.6.0に移行する必要があります。

リリース11.1.1.6の新機能

次の表では、このリリースでの新機能をリストして説明し、ガイド内のより詳細な情報へのリンクを示します。

機能

説明

詳細は、次のリンクを参照してください

ブログ

ブログ名には、より多くの特殊文字を使用可能です。

- ブログ作成時には、ブログ名に、文字および数値のほかに次の特殊文字を使用できるようになりました。
? \ / : [ ] * ' " |

拡張されたコメント:

- コメント機能が、エントリ自体だけでなく、ブログ・エントリのリストを表示する場合にも使用可能になりました。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのブログでの作業に関する項

動作保証

WebCenter Portalアプリケーション・プラットフォームに対して、より多くのテクノロジが認定されています。

- Microsoft Lync 2010 for IMP

- WebSphere Application Server V7

- Internet Explorer 9ブラウザ

- Chrome Browser 10およびクロム・サポート

- Windows XPでのMicrosoft Office 2010 (32ビットおよび64ビット)

- 第16.2.3項「Microsoft Lyncの前提条件」

- http://www.oracle.com/technology/software/products/ias/files/fusion_certification.htmlのOracle Fusion Middlewareでのサポートされるシステム構成に関するページ

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのMicrosoft OfficeおよびExplorer Integrationでの作業に関する項

ディスカッション・サービス

- ディスカッション・タスク・フローは、使いやすさの向上のために合理化されています。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・サービスでの作業に関する項

ドキュメント・サービス

- Oracle WebCenterコンテンツ・リポジトリへの接続のための明確な一連の手順に従ってください。

- ドラッグ・アンド・ドロップしてデスクトップから複数のファイルをアップロードします。

- ドキュメント・エクスプローラから一度に複数のファイルを選択してアップロードします。

- ファイルのアップロードの進行状況を表示します。

- より簡単にドキュメントを共有します。

- コンテキスト内のワークフローの承認を実行します。承認者は、編集モードに入る必要なしに、投稿モードから、リリースされていないコンテンツを表示および承認するか拒否できます。

- ワークフロー内のコンテンツのあるページ(HTMLまたはSite Studioのどちらか)上で投稿承認モードに入ります。編集モードに入ることなく、投稿承認モードから、リリースされていないコンテンツを表示および承認するか拒否します。

- 第11章「コンテンツ・リポジトリの管理」

- 第24.9.1.1項「ドキュメント・サービスのコンテンツ・リポジトリ接続の構成」

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの新規ファイルのアップロードに関する項

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのドキュメント・サービス・タスク・フローおよびドキュメント・コンポーネントでの作業に関する項

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタの使用によるコンテンツの公開に関する項

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのワークフロー内のファイルの承認または拒否に関する項

イベント・サービス

- タスク・フローは、ユーザビリティの向上のために合理化されています。たとえば、ユーザーは、カレンダおよびリスト・ビューの両方からイベントへのリンクを表示できるようになりました。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのイベント・サービスでの作業に関する項

通知

- サブスクリプション・メッセージは、イベントに関する通知のためにiCalではなくIMIPを使用するようになりました。このため、イベント通知は、通知の添付ファイルを開いてユーザー自身でそれを追加する必要なしに、Outlook予定表に自動的に追加されます。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのイベントのサブスクライブに関する項

ページレット・プロデューサ

より堅牢なページレット・プロデューサ:

- Kerberos認証を要求するものなど、SharePoint Webパーツを使用します。

- プロキシとリソースの間のHTTPトラフィックのロギングのサポートを含みます。

- 詳細なページレット・デバッグ・ロギングが追加されました。

- 標準準拠でないWebアプリケーションのための統合プロデューサとして使用可能です。

- iGoogleなど、他のOpenSocialコンテナからのガジェットの消費、およびWebCenter Portalサイト、他のOracleポータルまたはOracle Web Content Management for WebCenterサイトによって消費できるページレットとしてのそれらの公開が可能になります。

- OpenSocialガジェットの生産、およびガジェットとしての既存のすべてのページレットの公開が可能になります。

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle WebCenter Portalのページレット・プロデューサでのページレットの作成に関する項

- 第25章「Oracle WebCenter Portalのページレット・プロデューサの管理」

ページ

- 新しい管理者レベルの「パーソナライズの削除」オプションにより、ビジネス・ロール・ページまたは個人用ページから一度にすべてのユーザーのカスタマイズを削除できるようになります。

- 新しいシステム・ページは、アプリケーションのメトリック、スペース・メンバーシップ、スペースおよびスペース・テンプレートの表示および管理をサポートするために使用可能です。

- サブスクライブ・システム・ページは、現在、そのユース・ケースをより詳細に反映するためにセルフサービス・メンバーシップと名付けられています。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのビジネス・ロール・ページからのすべてのユーザーのカスタマイズの削除に関する項

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの個人用ページからのすべてのユーザーのカスタマイズの削除に関する項

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのシステム・ページでの作業に関する項

パフォーマンス

デザインタイムおよびランタイムでの高速化されたパフォーマンス:

- より高速な初期のページ・ダウンロードを体験してください。

- WebCenter Portal: Frameworkアプリケーションの作成時間がより短縮されたことを実感してください。

ポートレット・プロデューサ

- 新しいEnterprise 2.0ポートレット・プロデューサは、ポートレットとしてWebCenter Portalサービスからタスク・フローを公開するために使用可能です。ポートレットをWebCenter Portalアプリケーション、Oracle WebLogic PortalおよびOracle WebCenter Interactionと統合します。
新しいEnterprise 2.0ポートレット・プロデューサは、WebSphere、MySQL、Internet Explorer 9およびChrome 10での動作が保証されています。

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のポートレットの概要に関する項

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のE2.0ポートレット・プロデューサのポートレットの消費に関する項

- 第24.9項「WebCenterサービス・ポートレットの構成」

パブリッシャ

- パブリッシャ・タスク・フローによって一度に複数のファイルをアップロードします。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのパブリッシャ・タスク・フローによるファイルの共有に関する項

検索サービス

- 検索の範囲を制限する、より多くのタスク・フロー・パラメータがあります。管理者は、特定のスペース、サービスおよびドキュメント・タイプに検索の範囲を絞り込むことができます。また、属性を、各検索結果アイテムとともに返される標準属性のリストに追加することや、検索結果とともにユーザーが使用できる標準の絞込み機能を非表示にすることもできます。

- SES、およびGoogleやBingなどのパブリック検索エンジンを使用可能にするナビゲーション・モデルを使用してポータルを構築し、ページのフル・テキスト・コンテンツをクロールおよび索引付けできるようになりました。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの検索サービスでの作業に関する項

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のポータルのためのナビゲーション・モデルの構築に関する項

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の検索サービスの統合に関する項

- 第22章「WebCenter PortalでのOracle SES検索の管理」

セキュリティ

- サポートは、Oracle Entitlements Server 10gとの統合を介したグループ・メンバーシップの動的な決定のために利用可能です。

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebCenter Portal: Frameworkアプリケーションの保護に関する項

- 第28章「WebCenter Portalアプリケーションのセキュリティ管理」

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのセキュリティの理解に関する項

タグ・サービス

- ドキュメント・エクスプローラ・タスク・フローで編集タグのユーザー・インタフェースを更新しました。

- 「タグ」ボタン・コンポーネントおよびEdit Tagsタスク・フローには、開発者に共有制御を無効にできるようにする新しいパラメータがあります。

- 前に名付けられた"Tag Cloud"タスク・フローは、現在は"Tag Selection"タスク・フローと呼ばれるようになりました。また、新しいスタンドアロンTag Cloudタスク・フローは、デザインタイム・カタログで使用可能です。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのタグ・サービスでの作業に関する項

- 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のタグ・サービスの統合に関する項

Wiki

- 使いやすさが向上したWiki作成機能へのアクセス: ドキュメント・サービス・タスク・フローまたはWiki自体で「新規Wikiドキュメント」ボタンを使用します。

- Wikiのロード、Wikiエディタの起動、およびWikiへの変更の保存に関して向上したパフォーマンスを体験してください。

- Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの新規Wikiドキュメント・アクションの使用によるWikiドキュメントの作成に関する項

第I部

Oracle WebCenter Portalの概要

管理者ガイドのこの部では、Oracle WebCenter Portalおよび管理ツールの概要を示します。

第I部の内容は次のとおりです。

- 第1章「Oracle WebCenter Portalの管理の概要」

1 Oracle WebCenter Portalの管理の概要

Oracle WebCenter Portalへようこそ。

この章では、Oracle WebCenter Portalおよび管理ツールの概要を示します。内容は次のとおりです。

- 第1.1項「Oracle WebCenter Portalの概要」

- 第1.2項「Oracle WebCenter Portalのアーキテクチャ」

- 第1.3項「Oracle WebCenter Portalのトポロジ」

- 第1.4項「Spacesアプリケーション」

- 第1.5項「Frameworkアプリケーション」

- 第1.6項「WebCenter Portalのインストールの計画」

- 第1.7項「WebCenter Portal 11gのインストールの理解」

- 第1.8項「管理操作、ロールおよびツールの理解」

- 第1.9項「パフォーマンスの監視および診断」

- 第1.11項「WebCenter Portalアプリケーションのデプロイ」

- 第1.12項「データの移行、バックアップおよびリカバリ」

- 第1.13項「Oracle WebCenter Portalの管理ツール」

『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』は、特にOracle WebLogic Server (Oracle WebCenter PortalなどのOracle Fusion Middlewareソフトウェア・コンポーネントのためのプライマリ・プラットフォーム)向けに記述されています。

1.1 Oracle WebCenter Portalの概要

Oracle WebCenter Portalは、標準ベースの、サービス指向アーキテクチャの上に構築された、統合された一連のコンポーネントであり、ソーシャル・アプリケーション、エンタープライズ・ポータル、コラボレーティブ・コミュニティおよびコンポジット・アプリケーションを作成できます。Oracle WebCenter Portalは、機能豊富なインターネット・アプリケーション、統合されたマルチチャネルのポータル・フレームワークの柔軟性および力、およびコンテンツ、コラボレーション、プレゼンスおよびソーシャル・ネットワーキング機能を提供するサービスとして提供される一連の水平型のEnterprise 2.0機能を開発する、動的なユーザー・インタフェース・テクノロジを結合します。これらのコンポーネントを基に、Oracle WebCenter Portalは、個人およびグループがより効果的に作業およびコラボレーションできる構成可能な作業環境とともに、Spacesと呼ばれる、すぐに利用できる、エンタープライズ対応のカスタマイズ可能なアプリケーションも提供します。

Oracle WebCenter Portalは、ユーザーがインスタント・メッセージ、ドキュメント、コンテンツ管理、ディスカッション・フォーラム、Wiki、ブログ、およびポータルまたはアプリケーションのコンテキスト内からの直接のタグ付けなどのサービスと直接対話できる、オープンで拡張可能なソリューションを提供します。これらのツールおよびサービスは、エンド・ユーザーおよびITに、次世代のコラボレーティブなアプリケーションおよびポータルの構築およびデプロイを可能にします。

次の項では、Oracle WebCenter Portalのコンポーネントおよびアーキテクチャについて説明します。

- 第1.2項「Oracle WebCenter Portalのアーキテクチャ」

- 第1.3項「Oracle WebCenter Portalのトポロジ」

- 第1.4項「Spacesアプリケーション」

- 第1.5項「Frameworkアプリケーション」

1.2 Oracle WebCenter Portalのアーキテクチャ

Oracle WebCenter Portalは、次のコンポーネントで構成されています(図1-1)。

- WebCenter Portal: Framework

- Application Development Framework

- WebCenter Portal: Spaces

- WebCenter Portal: Services

- Composer

- ディスカッション・サーバー

- 分析

- アクティビティ・グラフ

- パーソナライズ・サーバー

- ポータル

- コンポジット・アプリケーション

図1-1 Oracle WebCenter Portalのアーキテクチャ

1.2.1 WebCenter Portal: Framework

次のものを含むポータル機能をADFに挿入します。

- ランタイム・アプリケーションのカスタマイズ(アプリケーションを再度デプロイすることなくComposerを使用してWebCenter Portalアプリケーションにインプレース変更を行うことができます)

- JSR-168およびJSR-286標準ベースのWSRPポートレット、およびPDK-Javaポートレットのサポート

- Oracle WebCenter Content Server、Oracle Portalおよびファイル・システムなどのコンテンツ・リポジトリへの、JCR (JSR170)を介したコンテンツ統合

- JSFページおよびOracle ADFタスク・フローを標準ベースのポートレットとして公開できる、Oracle JSF Portlet Bridge

1.2.2 Application Development Framework

Oracle Application Development Framework (ADF)は、JSFの上に存在する生産性レイヤーであり、次のものを提供します。

- データベース、Webサービス、XML、CSVおよびBPELなど、バックエンドへの統合されたアクセス

- バックエンドのデータ制御によりユーザー・インタフェースに接続する、データ・バインディング(JSR 227)

- 100個を超えるデータ認識JSFビュー・コンポーネント

- タスク・フローを含むネイティブ・コンポーネント・モデル

- ファイングレインJAASセキュリティ・モデル

1.2.3 Composer

Composerは、次のものを提供します。

- ブラウザでランタイム・アプリケーションおよびインプレースのユーザー・カスタマイズを実行する能力

- 次のことが行える、機能豊富で直観的なユーザー・エクスペリエンス

- タスク・フローおよびポートレットなど、リソースの参照およびページへの追加

- ページ・レイアウトの再配置

- ページおよびコンポーネント・プロパティの設定

- 前後関係によるコンポーネントの関連付け

1.2.4 WebCenter Portal: Spaces

JSF、Oracle ADF、WebCenter Portal: Framework、WebCenter Portal: ServicesおよびComposerを使用して構築される、WebCenter Portalアプリケーション。Spacesアプリケーションは、次のものを提供します。

- エンタープライズ・ポータル、複数のサイト、およびコミュニティを作成するためのブラウザ・ベースのプラットフォーム

- ユーザーごとのホーム・スペース(個人コンテンツを格納するためのプライベートな作業領域の提供、ノートの保持、ビジネス・プロセスの割当ての表示および応答、電子メールの送受信など)

- スレッドで構成されるディスカッション、ブログ、Wiki、ワークリスト、お知らせ、RSS、最近のアクティビティ、検索など

1.2.5 WebCenter Portal: Services

表1-1に、WebCenter Portalアプリケーションで使用可能なWebCenter Portalサービスをリストします。

表1-1 WebCenter Portalサービス

AからNまでのサービス

PからWまでのサービス

分析

ページ

お知らせ

ピープル・コネクション

ディスカッション

パーソナライズ

ドキュメント(Wikiおよびブログを含む)

投票

イベント脚注参照 2

RSS脚注 1

インスタント・メッセージおよびプレゼンス(IMP)

最近のアクティビティ

リンク

アクティビティ・グラフ

リスト脚注参照 2

検索

メール

タグ

ノート脚注 2

ワークリスト

脚注 1 RSSニュース・フィードは、Spacesのみから利用可能です。RSS Viewerタスク・フローは、Spacesおよび他のWebCenter Portalアプリケーションで利用可能です。

脚注 2 Spacesのみ。

WebCenter Portalサービスは、次のものを提供します。

- エンタープライズレベルのサービスとのシームレスな統合

- バックエンド・サービスを抽象化するシン・アダプタ・レイヤー。次に例を示します。

- コンテンツ・アダプタ: Oracle WebCenter Content ServerおよびOracle Portal

- プレゼンス・アダプタ: Microsoft Live Communications Server、Microsoft Office Communications ServerおよびMicrosoft Lync

- 統合された接続アーキテクチャによって表されるバックエンド・システム

- 機能豊富なタスク・フロー・コンポーネントによって提示されるサービスへのユーザー・インタフェース

1.2.6 ディスカッション・サーバー

ディスカッション・サーバーは、WebCenter Portalとともに提供されます。そのため、ディスカッション・フォーラムおよびお知らせをアプリケーションに統合できます。

1.2.7 分析

WebCenter Portalの分析機能により、ユーザーは、次のような様々なユーザー・アクティビティを表示できます。

- ログイン・データ

- ページ・ビュー

- ポートレット・ビュー

- ドキュメント・ビュー

- 検索メトリック

- ページ・レスポンス・データ

- 領域使用量

1.2.8 アクティビティ・グラフ

WebCenter Portal内のアクティビティ・グラフ・サービスにより、ユーザーは、WebCenter Portal分析によって収集された様々な統計を分析できます。オブジェクトおよびユーザーのための様々な類似度スコアが収集され、推奨を提示するために使用されます。スコアは、アクティビティ・グラフ・データベースに格納されます。

1.2.9 パーソナライズ・サーバー

WebCenter Portalのパーソナライズ・サーバーにより、選択した条件に基づいて、対象とするユーザーにアプリケーションのコンテンツを提供できます。

1.2.10 ポータル

ポータルは、パーソナライズされた、Webベース・アプリケーションと対話できる単一の場、および個々のユーザーまたはユーザーのクラスに関連する情報への、共通のインタフェース(Webページ)を提供します。ポータルの作成の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』を参照してください。

1.2.11 コンポジット・アプリケーション

コンポジット・アプリケーションは、単一のアプリケーションとして設計されデプロイされた、サービス、サービス・コンポーネント、ワイヤおよび参照の集合体です。コンポジット・アプリケーションの詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。

1.3 Oracle WebCenter Portalのトポロジ

次の項では、Oracle WebCenter Portalのトポロジおよび構成について説明します。

- 第1.3.1項「初期設定のWebCenter Portalトポロジ」

- 第1.3.2項「WebCenter Portal管理対象サーバー」

- 第1.3.3項「WebCenter Portalの起動順序」

- 第1.3.4項「WebCenter Portalの依存性」

- 第1.3.5項「WebCenter Portalの構成に関する考慮事項」

- 第1.3.6項「WebCenter Portalの状態および構成の永続性」

- 第1.3.7項「WebCenter Portalのログ・ファイルの場所」

1.3.1 初期設定のWebCenter Portalトポロジ

Oracle WebCenter Portalのインストールにより、Oracle Middleware HomeディレクトリおよびOracle Common Homeディレクトリの下に、WebCenter Portalのバイナリおよびサポートしているファイルが含まれるWebCenter Portal Oracle Homeが作成されます(図1-2)。

図1-2 Oracle WebCenter Portalのインストールのディレクトリ構造

また、インストールによって、様々なWebCenter Portalコンポーネントをホストする管理サーバーおよび複数の管理対象サーバーを含むWebCenter Portalドメイン(base_domain)も作成されます。図1-3では、アプリケーションは黄色で表示され、それらが実行される管理対象サーバーは茶色で表示されます。

図1-3 初期設定のWebCenter Portalトポロジ

初期設定の管理対象サーバーは、次のWebCenter Portalコンポーネントをホストします。

- WC_Spaces - Spacesアプリケーションをホストします

- WC_Portlet - 初期設定のポートレット、ページレット・プロデューサおよびWebCenter Services Producerをホストします

- WC_Collaboration - ディスカッション・サーバーおよび統合のために選択する追加のWebCenter Portalサービスをホストします

- WC_Utilities - アクティビティ・グラフ、分析およびパーソナライズ・サービスをホストします

オプションの5台目の管理対象サーバー(アプリケーション・サーバー)は、WebCenter Portal: Frameworkを使用して開発者が構築したアプリケーションを実行するために使用できます。このようなアプリケーションは、Frameworkアプリケーションと呼ばれます。追加の管理対象サーバーを作成する場合、それらは、Spacesアプリケーションと同じ外部リソースを利用できるよう、適切なライブラリでプロビジョニングされます。管理対象サーバーの詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle Fusion Middlewareの概要の理解に関する項を参照してください。

1.3.2 WebCenter Portal管理対象サーバー

Oracle WebCenter Portalのインストール時に、管理対象サーバーは、システム・ライブラリおよびOracle ADFライブラリでプロビジョニングされます。表1-2に、管理対象サーバー、およびそれらで実行するアプリケーションをリストします。

表1-2 Oracle WebCenter Portal管理対象サーバーおよびアプリケーション

管理対象サーバー

インストールされるアプリケーション

アプリケーション名

WC_Spaces

Spaces

Spacesオンライン・ヘルプ

webcenter

webcenter-help

WC_Portlet

OmniPortletおよびWeb Clipping

WSRPツール

ページレット・プロデューサ

WebCenter Services Producer

portalTools

wsrp-tools

pagelet-producer

services-producer

WC_Collaboration

ディスカッション・サーバー

owc_discussions

WC_Utilities

分析コレクタ

アクティビティ・グラフ・エンジン

パーソナライズ・サービス

analytics-collector

activitygraph-engines

wcps-services

1.3.3 WebCenter Portalの起動順序

管理対象サーバーの起動時には、アプリケーションおよびライブラリは次の順序で起動されます。

1. JRFライブラリとして知られるOracleシステム・ライブラリ

2. Oracle ADFライブラリ

3. Oracle DMSおよびOracle Web Services Manager (wsm-pm)アプリケーションなどのインストゥルメンテーション・アプリケーション

4. 表1-2で示したWebCenter Portalアプリケーション

起動順序は、依存の順序でもあります。依存するコンポーネントが正常にデプロイされない場合は、後のコンポーネントが正しく機能しない可能性があります。

アプリケーションの起動は、ディスカッション・サーバーまたは他のバックエンド・サーバーなどの外部サービスが使用可能かどうかには依存しません。詳細は、第1.3.4項「WebCenter Portalの依存性」を参照してください。

1.3.4 WebCenter Portalの依存性

WebCenter Portalアプリケーションは、複数の外部サーバーおよびサービスを使用します(表1-3)。「構成」列に、接続を構成または初期化するためにWebCenter Portalに提供される情報のタイプをリストします。「アクセス」列に、サービスの実行時アクセスで使用されるプロトコルをリストします。

表1-3 依存するリソース - アクセス・タイプ

外部サーバー/サービス

構成

アクセス

分析

分析コレクタへのUDPアクセス

UDP

アクティビティ・グラフ

アクティビティ・グラフ管理へのHTTPアクセス

HTTP

ディスカッション・サーバー

ディスカッション・サーバー管理へのHTTPアクセス

SOAP/HTTP

Oracle WebCenter Content Server (ドキュメント)

管理サーバーへのソケット接続。Oracle WebCenter Content ServerがWebCenter外からアクセスされる必要がある場合のみ、HTTPアクセスが必要になります。

ソケットまたはHTTPでのJCR 1.0

インスタント・メッセージおよびプレゼンス・サーバー

インスタント・メッセージおよびプレゼンス・サーバー管理へのHTTPアクセス

SOAP/HTTP

メール・サーバー

IMAP/SMTPサーバー

IMAP/SMTP

個人イベント・サーバー

カレンダ・サービスへのHTTPアクセス

SOAP/HTTP

パーソナライズ・サーバー

パーソナライズ・サーバーへのJBDCアクセス

JDBC REST

ポートレット

プロバイダWSDLのHTTPロケーション

SOAP/HTTP

検索サーバー

検索サーバーへのHTTPアクセス

HTTP

ワークリスト

BPELサーバーへのHTTPアクセス

SOAP/HTTP

MDSおよびスキーマ

JDBC

JDBC

サーバーまたはサービスが利用できないことで、WebCenter Portalアプリケーションを起動できなくはなりませんが、アプリケーションの実行時にエラーが表示される場合があります。唯一の例外は、Oracle Metadata Repository (MDS)です(WebCenter Portalアプリケーションはこれがないと機能しないため)。

Spacesは、WebCenter Portalリポジトリなしで部分的に機能しますが、それがMDSリポジトリと異なる物理データベースの場合のみです。WebCenter Portalリポジトリは、イベント、リンク、リスト、ピープル・コネクション、投票およびタグを含む、複数のサービスのための情報を格納します。また、これらのサービスは、WebCenter Portalリポジトリを利用できない場合には機能しません。

1.3.5 WebCenter Portalの構成に関する考慮事項

WebCenter Portalアプリケーションのための主な構成ファイルを、表1-4にリストして説明します。これらのファイルは、WebCenter Portalアプリケーションのデプロイメントの.EARファイル内で供給されます。

表1-4 WebCenter Portalの構成ファイル

アーティファクト

用途

adf-config.xml

Application Development Framework (ADF)およびWebCenter Portalアプリケーションの設定(ディスカッション・サーバーまたはメール・サーバーのWebCenter Portalアプリケーションが現在使用しているもの)のための基本構成を格納します。

connections.xml

外部サービスへの接続のための基本構成を格納します。

WebCenter Portalアプリケーションおよびポートレット・プロデューサの両方は、Oracle Metadata Services (MDS)リポジトリを使用して、それらの構成データを格納します。この両方が、Oracle WebLogicフレームワーク内のJDBCデータ・ソースとしてMDSリポジトリにアクセスします。

MDSリポジトリは、アプリケーションのカスタマイズとして、WebCenter Portalアプリケーションおよびポートレット・プロデューサへのデプロイ後の構成変更を格納します。MDSは、デプロイされた元バージョンのadf-config.xmlおよびconnections.xmlをベース・ドキュメントとして使用し、単一のカスタマイズ・レイヤーを使用して後続のすべてのアプリケーション・カスタマイズを別個にMDSに格納します。

WebCenter Portalアプリケーションが起動すると、MDSに格納されたアプリケーション・カスタマイズが適切なベース・ドキュメントに適用され、WebCenter Portalアプリケーションは、マージされたドキュメント(カスタマイズされているベース・ドキュメント)を構成プロパティの最終セットとして使用します。

サーバー・クラスタにデプロイされるWebCenter Portalアプリケーションの場合、クラスタのすべてのメンバーは、MDSリポジトリ内の同じ場所から読み取ります。

Oracleはデプロイ後構成のための複数の管理ツールを提供するため、一般には、管理者は、adf-config.xmlおよびconnections.xmlなどのファイルのためにベース・ドキュメントのコンテンツ(またはMDSカスタマイズ・データ)を調べたり手動で変更したりする必要はありません。ベース・ドキュメントを見つける必要や、MDS内の情報を確認する必要がある場合は、付録A「WebCenter Portal Configuration」を参照してください。

利用可能なWebCenter Portalアプリケーション構成ツールの詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。

注意:

構成ミスをもたらす可能性があるため、adf-config.xmlまたはconnections.xmlを手動で編集することはお薦めしません。

WebCenter Portalアプリケーションは、デプロイ後の構成情報をMDSに格納しますが、ポートレット・プロデューサおよびディスカッション・サーバーのための構成情報は、ファイル・システムまたはデータベースに格納されます(表1-5を参照)。

表1-5 WebCenter Portalの構成の場所

アプリケーション

構成はMDSに
格納されている

構成はファイル・システムに
格納されている

構成はデータベースに
格納されている

Spacesアプリケーション

はい

いいえ

いいえ

Frameworkアプリケーション

はい

いいえ

いいえ

ポートレット・プロデューサ

いいえ

はい

いいえ

ディスカッション・サーバー

いいえ

はい

はい

ディスカッション・サーバー

WebCenter Portalのディスカッション・サーバーは、構成情報をそのデータベースに格納します。また、起動構成情報を$DOMAIN_HOME/config/fmwconfig/servers/WC_COLLABORATION/owc_discussionsに格納します。このディレクトリには、jive_startup.xml、jive.licenseファイル、およびディスカッション・サーバー・インスタンスのためのログ・ファイルを含むlogsディレクトリが含まれます。

1.3.6 WebCenter Portalの状態および構成の永続性

WebCenter Portalアプリケーションは、アプリケーションの状態および構成がMDSリポジトリまで存続するJ2EEアプリケーションとして動作します。アプリケーション内のユーザー・セッション情報は、ローカルでメモリーに保持されます。クラスタ環境では、この状態は、クラスタの他のメンバーにレプリケートされます。

ポートレットまたはサービス環境内のアプリケーション・カスタマイズは、そのサービスによって存続します。初期設定では、Oracleポートレット、構築した任意のカスタム・ポートレット、およびディスカッション・サーバーには、すべて、それら固有のデータベース永続性メカニズムがあります。

分析

WebCenter Portalの分析機能には、状態はありません。分析コレクタによって受け取られた要求は、すぐに実行されます。WebCenter Portalアプリケーションによって開始される要求、または分析コレクタによって処理される要求など、送信中状態は保証されません。

アクティビティ・グラフ

WebCenter Portalのアクティビティ・グラフは、次の2つのコンポーネントで構成されています。

- アクティビティ・グラフ・サービス: メモリー内状態は維持しません。アクティビティ・グラフ・タスク・フローは、アクティビティ・グラフ・データベースを照会し、推奨のリストとして結果を表示します。状態は、次のものによって更新されます。

- タスク・フロー構成パラメータ

- パーソナライズ設定

- "関心のない"機能

最初の2つは、状態を管理する、標準のOracle Composer/Oracle ADF/MDSフレームワーク上に構築されます。最後は、ユーザーが、特定の推奨に関心がないと示すことができる機能です。この入力は、データベースで同期的に存続します。

- アクティブ・グラフ・エンジン: データベース内の表をトランザクションで更新する、バッチ・データ分析プロセスを実行します。エンジンはクラスタ化またはフェイルオーバーをサポートしていませんが、障害からリカバリできます。

管理者は、アクティビティ・グラフ・スケジューラを使用して、夜間のスケジュールを設定および監視します。分析(推奨)の結果は、アクティビティ・グラフ・タスク・フローによって提示されます。

アクティビティ・グラフ・エンジンは、数時間存続する、夜間のジョブの実行時間かどうかをチェックするために定期的に起動するバックグラウンド・スレッドがあるシングルトン・アプリケーションです。スケジュールはデータベースで存続します。管理対象サーバーに障害が発生した場合、ジョブは、管理対象サーバーの次回起動時に続きます。

パーソナライズ・サーバー

WebCenter Portalのパーソナライズ・サーバーは、ステートレスRESTfulアプリケーションです。すべての状態は、クライアントの要求において管理されます。

1.3.7 WebCenter Portalのログ・ファイルの場所

WebCenter Portalアプリケーション、ポートレット・プロデューサ、ディスカッション・サーバーなどによって実行される操作は、アプリケーションが実行されているWebLogic管理対象サーバーに直接ログ記録されます。

<base_domain>/servers/<WC_Server>/logs/<WC_Server>-diagnostic.log

たとえば、Spacesアプリケーションのための診断は、/base_domain/servers/WC_Spaces/logs/WC_Spaces-diagnostic.logにログ記録されます。

各WebLogic管理対象サーバーのログ・ファイルは、Oracle WebLogic Server管理コンソールから表示できます。ログを表示するには、Oracle WebLogic Server管理コンソールhttp://<admin_server_host>:<port>/consoleにアクセスし、診断ログ・ファイルをクリックします。

Fusion Middleware Controlから診断ログを表示および構成することもできます。第38.3項「ログ情報の表示および構成」を参照してください。

1.4 Spacesアプリケーション

Spacesは、ソーシャル・ネットワーキング、コミュニケーション、コラボレーションおよび個人の生産性のための最新のテクノロジを提供する、Webベースのアプリケーションです。Spacesでは、堅牢な一連のサービスおよびアプリケーションにより、他のユーザーとの意見交換、個人的および仕事関連の作業の経過の記録、重要なアプリケーションとの対話、および独自のプロジェクトと関心事に集中するために必要なすべてが結合され、これらのすべてを単一の統合環境内で提供します。

サービスのための自動構成

一部のサービスは、インストール・プロセスの間に、Spacesアプリケーション用に自動的に構成されます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドを参照してください。

デフォルトの接続名を表1-6に示します。

表1-6 Spacesアプリケーション用に自動的に構成される接続

WebCenter Portalサービス/コンポーネント

デフォルト接続名

ディスカッションおよびお知らせサービス

WebCenterSpaces-Discussions

ドキュメント・サービス

WebCenterSpaces-ucm

ページレット・プロデューサ

WebCenterSpaces-PageletProducer

パーソナライズ・サービス

Conductor-WCPSSpacesおよびProperties-WCPSSpaces

事前構成済ポートレット・プロデューサ

wc-OmniPortlet

wc-WebClipping

wc-WSRPTools

ワークリスト・サービス

Spacesのワークフロー

WebCenterSpaces-Worklist

Spacesアプリケーションのインストール後の構成

作業の際は次を参照してください。

- 第2章「Spacesアプリケーションの起動および実行」

Spacesの管理の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドでSpaces管理ページへのアクセスに関する項を参照してください。

1.5 Frameworkアプリケーション

JDeveloperおよびWebCenter Portal: Frameworkを使用して独自のポータル・アプリケーションを開発し、それらをカスタムWebLogic管理対象サーバーにデプロイできます。WebCenter Portal: Frameworkを使用して構築されたポータル・アプリケーションは、Frameworkアプリケーションと呼ばれます。

独自のポータル・アプリケーションの開発の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』を参照してください。

作業の際は次を参照してください。

- 第4章「Frameworkアプリケーションの起動および実行」

- 第5章「Frameworkアプリケーションのメンテナンス」

- 第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」

1.6 WebCenter Portalのインストールの計画

WebCenter Portalアプリケーションのインストールには、多少の計画が必要です。考慮する質問の一部には、次のものがあります。

- どのWebCenter Portalコンポーネントを使用しますか。

- 何人のユーザーがこのデプロイメントにアクセスしますか。

- WebCenter Portalのエンタープライズ・デプロイメントのためにどのように高可用性を提供できますか。

- WebCenter Portalをどのように保護できますか。

WebCenter Portalのインストールの計画の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイド、Oracle Fusion Middleware Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

1.7 WebCenter Portal 11gのインストールの理解

初期設定のWebCenter Portalトポロジは、第1.3項「Oracle WebCenter Portalのトポロジ」で簡潔に説明しています。WebCenter Portalトポロジの特定の領域は、対応する章で説明しています。たとえば、WebCenter Portalトポロジのセキュリティ関連の側面は、第28章「WebCenter Portalアプリケーションのセキュリティ管理」で説明しています。

Oracle WebCenter Portalのインストールおよびインストール後の管理作業の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドを参照してください。

インストール後のエンタープライズ構成の場合は、Oracle Fusion Middleware Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイドを参照してください。

インストール後の高可用性構成の場合は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

インストール後のセキュリティ構成の場合は、第28章「デプロイ後のセキュリティ構成タスク」を参照してください。

1.8 管理操作、ロールおよびツールの理解

Oracle WebCenter Portalは、WebCenter Portalアプリケーションをデプロイ、構成、起動および停止、および維持する、複数の異なるツールを提供します。これらすべてのツールは、第1.13項「Oracle WebCenter Portalの管理ツール」で説明しています。

WebCenter Portal管理作業を実行する能力は、割り当てられているOracle WebLogic Serverロール(Admin、OperatorまたはMonitor)によって異なります。表1-7に、一般的な操作のために必要なOracle WebLogic Serverロールをリストします。これらのロールは、操作がFusion Middleware Control、WLSTコマンドまたはWebLogic Server管理コンソールを介して実行されるかどうかに該当します。

表1-7 WebCenterポータルの操作およびOracle WebLogic Serverロール

操作

Admin
ロール

Operator
ロール

Monitor
ロール

WebCenter Portalのすべてのアプリケーション

起動および停止

はい

はい

いいえ

パフォーマンス・メトリックの表示

はい

はい

はい

ログ情報の表示

はい

はい

はい

ログ・ファイルの構成

はい

はい

はい

構成の表示

はい

はい

はい

新しい接続の構成

はい

はい

いいえ

接続の編集

はい

はい

いいえ

接続の削除

はい

はい

いいえ

アプリケーションのデプロイ

はい

いいえ

いいえ

セキュリティの構成

はい

いいえ

いいえ

セキュリティの表示(アプリケーション・ロール/ポリシー)

はい

はい

はい

Spacesアプリケーションのみ

Spacesのエクスポート

はい

いいえ

いいえ

Spacesのインポート

はい

いいえ

いいえ

表1-8に、WebCenter Portalアプリケーションに関連する様々な管理操作を実行するために使用できるツールをまとめます。

表1-8 WebCenter Portalの操作および管理ツール

操作

Fusion Middleware Control

WLSTコマンド

WebLogic Server管理コンソール

Spacesアプリケーション管理

WebCenter Portalのすべてのアプリケーション

起動および停止

はい

はい

はい

いいえ

パフォーマンス・メトリックの表示

はい

いいえ

いいえ

いいえ

ログ情報の表示

はい

いいえ

いいえ

いいえ

ログ・ファイルの構成

はい

いいえ

いいえ

いいえ

構成の表示

はい

はい

いいえ

いいえ

新しい接続の構成

はい

はい

いいえ

いいえ

接続の編集

はい

はい

いいえ

いいえ

接続の削除

はい

はい

いいえ

いいえ

ポートレット・プロデューサの管理

はい

はい

いいえ

はい

外部アプリケーションの管理

はい

はい

いいえ

はい

アプリケーションのデプロイ

はい

はい

はい

いいえ

セキュリティの構成

はい

はい

はい

いいえ

Spacesアプリケーションのみ

ワークフローの構成

はい

はい

いいえ

いいえ

Spacesアプリケーションのエクスポート

はい

はい

いいえ

いいえ

Spacesアプリケーションのインポート

はい

はい

いいえ

いいえ

Spacesアプリケーションのカスタマイズ

いいえ

いいえ

いいえ

はい

アプリケーション・ユーザーおよびロールの管理

いいえ

いいえ

いいえ

はい

ページの管理

いいえ

いいえ

いいえ

はい

スペースの管理

いいえ

いいえ

いいえ

はい

個々のスペースのエクスポート

いいえ

いいえ

いいえ

はい

個々のスペースのインポート

いいえ

いいえ

いいえ

はい

1.9 パフォーマンスの監視および診断

パフォーマンス監視は、管理者が環境内の問題やパフォーマンスのボトルネックを特定する際に役立ちます。第38章「Oracle WebCenter Portalパフォーマンスの監視」では、WebCenter Portalアプリケーションに利用可能なパフォーマンス・メトリックの範囲、およびFusion Middleware Controlを使用してそれらを監視する方法を説明しています。また、WebCenter Portal診断ログ・ファイルに記録された情報を分析して問題のトラブルシューティングを行う方法についても説明します。

1.10 セキュリティの理解

Oracle WebCenter Portalの推奨セキュリティ・モデルは、Java Authentication and Authorization Service (JAAS)モデルを実装するOracle ADF Securityに基づいています。次の章では、WebCenter Portalアプリケーションのセキュリティ構成について説明します。

- 第28章「WebCenter Portalアプリケーションのセキュリティ管理」

- 第29章「アイデンティティ・ストアの構成」

- 第30章「ポリシーおよび資格証明ストアの構成」

- 第31章「シングル・サインオンの構成」

- 第32章「Frameworkアプリケーションのシングル・サインオンの構成」

- 第33章「SSLの構成」

- 第34章「WS-Securityの構成」

- 第35章「ポートレット・プロデューサのセキュリティの構成」

1.11 WebCenter Portalアプリケーションのデプロイ

第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」では、Oracle JDeveloperで作成した.EARファイルからのFrameworkアプリケーションのデプロイ、再デプロイおよびアンデプロイについて説明します。

第24.8項「ポートレット・プロデューサ・アプリケーションのデプロイ」では、WSRPおよびPDK-Javaポートレット・プロデューサのデプロイについて説明します。

注意:

WebCenter PortalのSpacesアプリケーションは、インストール時にデプロイされます(.EARファイルとしてデプロイできない)。Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドのOracle WebCenter Portalのインストールに関する項を参照してください。

1.12 データの移行、バックアップおよびリカバリ

Oracle WebCenter Portalでは、様々な機能領域についての構成および内容に関連するデータが複数の場所に格納されています。WebCenter Portalには、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にするための一連のユーティリティが用意されており、それによりこのデータをバックアップし、ステージング環境と本番環境のWebCenter Portalアプリケーションの間でデータを移動できます。

第39章「WebCenter Portalのエクスポート、インポート、バックアップおよびリカバリの管理」では、バックアップ、インポートおよびエクスポート機能、およびこれらの作業に利用可能なツールについて説明します。

1.13 Oracle WebCenter Portalの管理ツール

WebCenter Portalには、次の管理ツールがあります。

- Oracle Enterprise Manager Fusion Middleware Controlコンソール

- Oracle WebLogic Server管理コンソール

- Oracle WebLogic Scripting Tool (WLST)

- システムMBeanブラウザ

これらの管理ツールは、Spacesを含む、すべてのWebCenter Portalアプリケーションに適用されます。また、管理者は、管理作業を実行するために、構成ファイルを編集するのではなくこれらのツールを使用する必要があります。最適なツールを決定するためのヘルプは、付録A「構成ツール」を参照してください。

システム管理ツールのほかに、個々のアプリケーションは、次の実行時管理ページも提供します。

- Spaces管理ページ

- WebCenter Portal管理コンソール

1.13.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

Oracle Enterprise Manager Fusion Middleware Controlコンソールは、Oracle WebCenter Portalをインストールする際にデプロイされるブラウザ・ベースの管理アプリケーションです。Fusion Middleware Controlコンソールから、ファーム(Oracle WebCenter PortalおよびWebCenter Portalアプリケーションを含むものなど)を監視および管理できます。

Fusion Middleware Controlでは、多種多様なパフォーマンス・データおよび管理機能を整理し、個別のWebベースのホームページで提供しています。これらのホームページでは、Webブラウザから、WebCenter Portalコンポーネントの最も重要な監視データおよび最も一般的な管理機能をすぐに見つけることができます。Fusion Middleware Controlコンソールの一般情報は、『Oracle Fusion Middleware管理者ガイド』のOracle Enterprise Manager Fusion Middlewareコンソールの概要に関する項を参照してください。

Fusion Middleware Controlは、Oracle WebCenter Portalの主要管理ツールです。このツールを使用して、次のことができます。

- WebCenter Portalアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- バックエンド・サービスの構成

- セキュリティ管理の構成

- プロセス・ライフサイクルの制御

- ログ・ファイルへのアクセスおよびログ構成の管理

- データ移行の管理

- パフォーマンスの監視

- 実行時の問題の診断

- 関連コンポーネントの管理(親管理対象サーバー、MDS、ポートレット・プロデューサなど)

1.13.1.1 Fusion Middleware Controlコンソールの表示

Fusion Middleware Controlの起動の詳細は、第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

1.13.2 Oracle WebLogic Server管理コンソール

Oracle WebLogic Server管理コンソールは、WebLogic Serverドメインの管理に使用されるブラウザ・ベースのグラフィカル・ユーザー・インタフェースです。

管理サーバーは、管理コンソール(管理サーバー管理対象サーバーのホスト・アプリケーションへネットワーク・アクセスできる、サポートされている任意のWebブラウザからアクセス可能なWebアプリケーション)をホストします。

管理コンソールは、次のことのために使用します。

- WebLogic Serverインスタンスの構成、起動および停止

- WebLogic Serverクラスタの構成

- データベース接続性(JDBC)およびメッセージング(JMS)などのWebLogic Serverサービスの構成

- ユーザー、グループおよびロールの作成および管理を含むセキュリティ・パラメータの構成

- アプリケーションの構成およびデプロイ

- サーバーおよびアプリケーションのパフォーマンスの監視

- サーバーおよびドメイン・ログ・ファイルの表示

- アプリケーションのデプロイメント記述子の表示

- 選択したランタイム・アプリケーションのデプロイメント記述子エレメントの編集

Oracle WebLogic Server管理コンソールの詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

ドメイン構成のロック

構成を変更する前に、ドメインのための構成設定をロックする必要があります。管理コンソールのチェンジ・センター(図1-4)に移動し、「ロックして編集」をクリックします。

構成の更新が完了したら、「構成の解放」をクリックして変更を解放します。

図1-4 Oracle WebLogic Server管理コンソール内のチェンジ・センター

1.13.3 Oracle WebLogic Scripting Tool (WLST)

WebLogic Scripting Tool (WLST)により、コマンドラインから、Oracle WebCenter PortalなどのOracle Fusion Middlewareコンポーネントを管理できます。

WLSTは、Javaスクリプト・インタプリタであるJythonに基づいた、Oracle WebLogic Serverドメインを管理するための完全なコマンドライン・スクリプト環境です。WLSTは、ローカル変数、条件変数およびフロー制御文などのJythonの標準機能に対するサポートに加えて、Oracle WebLogic Serverに固有の一連のスクリプト機能(コマンド)も提供します。Jython言語構文に従って、要件に合せてWebLogicスクリプト言語を拡張できます。

WebCenter Portalアプリケーション接続(コンテンツ・リポジトリ、ポートレット・プロデューサ、外部アプリケーションおよび他のバックエンド・サービスへの接続)を管理するためのWLSTコマンドも用意されています。すべてのWebCenter Portal WLSTコマンドは、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のWebCenter PortalのカスタムWLSTコマンドに関する項で説明されています。

1.13.3.1 Oracle WebLogic Scripting Tool (WLST)コマンドの実行

すべてのWebCenter Portal WLSTコマンドは、WebCenter Portal Oracleホーム・ディレクトリ(WC_ORACLE_HOME)から実行する必要があります。

注意:

間違ったディレクトリからWebCenter Portal WLSTコマンドを起動しようとすると、NameErrorが表示されます。このエラーを回避するには、次に説明するように、常にWebCenter Portal WLSTコマンドをWebCenter Portal Oracleホーム(WC_ORACLE_HOME/common/bin)から実行します。

第A.6項「WLSTコマンド問題のトラブルシューティング」も参照してください。

コマンドラインからWLSTを実行する手順は、次のとおりです。

1. 次のように、WebCenter Portal Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。
(UNIX) WC_ORACLE_HOME/common/bin/wlst.sh

(Windows) WC_ORACLE_HOME\common\bin\wlst.cmd

2. WLSTコマンド・プロンプトで、次のコマンドを入力してWebCenter Portalの管理サーバーに接続します。

wls:/offline>connect('user_name','password', 'host_name:port_number')

各要素の意味は次のとおりです。

- user_nameは、管理サーバーに接続しているオペレータのユーザー名です。

- passwordは、管理サーバーに接続しているオペレータのパスワードです。

- host_nameは、管理サーバーのホスト名です。

- port_numberは、管理サーバーのポート番号です。

次に例を示します。

connect(username='weblogic', password='mypassword', url='myhost.example.com:7001')

次のように、対話モードでパラメータなしで管理サーバーに接続することもできます。

wls:/offline> connect()
Please enter your username :weblogic
Please enter your password :
Please enter your server URL [t3://localhost:7001]:t3://myhost.example.com:7001
Connecting to t3://myhost.example.com:7001 with userid weblogic ...
Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

このコマンドのヘルプについては、WLSTコマンド・プロンプトでhelp('connect')と入力してください。

注意:

SSLが使用可能になっている場合は、wlst.shまたはwlst.cmdファイルを編集して、次のJVM_ARGSに追加する必要があります。

-Dweblogic.security.SSL.ignoreHostnameVerification=true
-Dweblogic.security.TrustKeyStore=DemoTrust

またはsetenv CONFIG_JVM_ARGS

-Dweblogic.security.SSL.ignoreHostnameVerification=true
-Dweblogic.security.TrustKeyStore=DemoTrust

3. 管理サーバーに接続したら、WebCenter Portal WLSTコマンドおよび他の任意の汎用WLSTコマンドを実行できます。

WebCenter Portal WLSTコマンドの実行のヒント

- WebCenter Portal WLSTコマンドをリストするには、WLSTコマンド・プロンプトで、help('webcenter')と入力します。
メッセージ「WebCenterのヘルプが見つかりません...」が表示される場合は、WLSTスクリプトを誤ったディレクトリから実行している可能性があります。たとえば、wlst.shまたはwlst.cmdを、WC_ORACLE_HOME/common/binではなくoracle_commonディレクトリから実行している可能性があります。

- 特定のコマンドのヘルプについては、WLSTコマンド・プロンプトで、help('WLST_command_name')と入力します。

- コマンドの実行時と、特にWLSTスクリプトの記述時に、引数名を含めます。たとえば、次のように入力することをお薦めします。
createExtAppConnection(appName='webcenter', name='myXApp'...

次のように入力することはお薦めしません。

createExtAppConnection('webcenter', 'myXApp'...

どちらの構文も有効ですが、引数名を含める場合に、エラーまたは構成ミスの可能性が少なくなります。また、将来、引数を追加する場合も、コマンドが失敗することや誤ったプロパティを構成することがありません。

- WebCenter Portal WLSTコマンドのオンライン・ドキュメントは、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のWebCenter PortalのカスタムWLSTコマンドに関する項から入手可能です。

1.13.4 システムMBeanブラウザ

Fusion Middleware Controlは、Oracle WebLogic Serverまたは選択されたアプリケーションのためにMBeanを参照できる、一連のMBeanブラウザを提供します。

注意:

システムMBeanブラウザからWebCenter PortalアプリケーションのMBeanを監視および構成できますが、構成のためのツールとしてはお薦めしません。WLSTコマンドを使用するか、Fusion Middleware ControlのWebCenter Portalの設定メニュー・オプション(アプリケーションのホームページから使用可能)を介してWebCenter Portalアプリケーションを構成することをお薦めします。

WebCenter PortalアプリケーションのアプリケーションMBeanにアクセスする手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションでは、「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Frameworkアプリケーションでは、「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」を開きます。

4. 表示または構成するMBeanに移動します。
たとえば、Frameworkアプリケーションの場合は、次のようにadf-config.xmlおよびconnections.xmlのMBeanに移動できます(図1-5)。

- adf-config - 「oracle.adf.share.config」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConfig」→「ADFConfig」→「ADFConfig」をクリックします。

- connections - 「oracle.adf.share.connections」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConnnections」→「ADFConnnections」をクリックします。

5. MBeanの属性を表示するには、「属性」タブを選択します。一部の属性は、値を変更できます。これを行うには、「値」列に値を入力します。

図1-5 システムMBeanブラウザ

6. 「適用」をクリックして属性値を更新します。

7. 親MBean (たとえば、ADFConfigまたはADFConnections)に移動して「操作」タブを選択し、「保存」をクリックして変更を保存します。

8. WebCenter Portalアプリケーションがデプロイされる管理対象サーバーを再起動します。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

1.13.5 Spaces管理ページ

Spacesアプリケーションには、複数の独自の管理ページがあります。管理ページは、管理者のユーザー名とパスワードを使用してアプリケーションにログインしたユーザーのみに表示されます。

Spacesの管理ページでは、次のことができます。

- Spacesアプリケーションのカスタマイズ

- ユーザーおよびロールの管理

- Spacesアプリケーションのためのサービス設定の管理

- ポートレット・プロデューサおよび外部アプリケーションの管理

- 個々のスペースおよびスペース・テンプレートの管理

- ビジネス・ロール・ページの作成および管理

- 個人用ページの管理

- 個々のスペースおよびスペース・テンプレートのエクスポートおよびインポート

詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理ページへのアクセスに関する項を参照してください。

1.13.6 WebCenter Portal管理コンソール

WebCenter Portal: Frameworkを使用して構築されたポータル・アプリケーションには、管理者が実行時に一般的な管理作業を実行できる、管理ページを含むこともできます。詳細は、第36章「WebCenter Portal管理コンソールの使用」を参照してください。

第II部

Oracle WebCenter Portalの管理の概要

管理者ガイドのこの部では、Oracle WebCenter Portalの管理を始める際に役立つチェックリストを提供します。

第II部の内容は次のとおりです。

- 第2章「Spacesアプリケーションの起動および実行」

- 第3章「Spacesアプリケーションのメンテナンス」

- 第4章「Frameworkアプリケーションの起動および実行」

- 第5章「Frameworkアプリケーションのメンテナンス」

2 Spacesアプリケーションの起動および実行

WebCenter PortalのSpacesアプリケーションを起動および実行して使用できる状態にするには、Fusion Middleware管理者とSpaces管理者の両方からの入力が必要です。この章では、各管理者のロールおよび職責について説明します(1人の管理者が兼任する場合もあります)。

また、この章では、インストールの後にSpacesを起動して実行するために必要な作業の概要も示します。このプロセスを説明するためのいくつかのロードマップが提供されます。

この章の内容は次のとおりです。

- 第2.1項「Fusion Middleware管理者のロール」

- 第2.2項「Spaces管理者のロール」

- 第2.3項「WebCenter Portal: Spacesのインストール」

- 第2.4項「Spacesの初回の設定(ロードマップ)」

- 第2.5項「Spacesの初回のカスタマイズ(ロードマップ)」

対象読者

この章の内容は、Spacesアプリケーションを担当するFusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)およびSpaces管理者(Spaces管理ページを使用してAdministratorロールを付与されたユーザー)を対象としています。

注意:

WebCenter Portal: Frameworkを使用して開発されたポータル・アプリケーションを扱う管理者は、第4章「Frameworkアプリケーションの起動および実行」を参照してください。

2.1 Fusion Middleware管理者のロール

Oracle Fusion Middlewareでは、すべての管理能力を有する単一の管理ロール(Adminロール)を提供します。このロールを有するFusion Middleware管理者は、セキュリティの影響を受ける管理作業の全範囲、およびすべてのインストール、構成および監査作業を実行できます。この管理者は、Spacesアプリケーションをインストールした後に速やかに設定および構成し、Spacesおよびその他のOracle WebCenter Portalコンポーネントの継続的な管理タスクを実行する必要があります。このドキュメントでは、この管理者をFusion Middleware管理者と呼びます。

インストール中に、weblogicという名前の1つのFusion Middleware管理者アカウントが作成されます。このパスワードは、インストール中に提供されます。

この管理者アカウントを使用して、Fusion Middleware ControlコンソールおよびSpacesにログインし、管理権限を他のユーザーに割り当てます。

- Fusion Middleware Control: Oracle WebLogic管理コンソールまたはOracle WebLogic Scripting Tool (WLST)を使用して、Administratorグループにユーザーをもう1人追加します。詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の管理ユーザーおよびロールに関する項を参照してください。
Oracle WebLogic Serverは、Adminロールに加えて、OperatorおよびMonitorという他の2つのロールを提供します。これらのロールの詳細は、第1.8項「管理操作、ロールおよびツールの理解」の表1-7「WebCenterポータルの操作およびOracle WebLogic Serverロール」を参照してください。

- Spaces管理: Spaces管理ページを使用して、もう1人のユーザーにAdministratorロールを割り当てます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのユーザーへの管理権限の付与に関する項を参照してください。

Spacesを起動および実行するためにFusion Middleware管理者が行う必要があるその他の作業を知るには、 「ロードマップ - Spacesアプリケーションの初回の設定」の下にリストされる手順に従ってください。

注意:

Fusion Middleware管理者は、継続的なすべての管理作業も担当します。詳細は、第3.3項「Spacesのためのシステム管理(ロードマップ)」を参照してください。

2.2 Spaces管理者のロール

Spaces管理者には、Spacesアプリケーション自体の中で最も高いアプリケーション権限があります。管理者は、Spacesアプリケーションのすべての側面の表示およびカスタマイズ、ユーザーおよびロールの管理、および別のユーザーへの職責の委任を行うことができます。

初期の設定では、Fusion Middleware管理者(weblogic)は、SpacesのAdministratorロールを割り当てられた唯一のユーザーです。このパスワードは、インストール中に提供されます。この管理者アカウントを使用してSpacesにログインし、追加のユーザーにAdministratorロールを割り当てます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのユーザーへの管理権限の付与に関する項を参照してください。

初期設定のSpacesをカスタマイズするためにSpaces管理者が実行できることを知るには、「ロードマップ - Spacesの初回のカスタマイズ」に従ってください

注意:

Spaces管理者は、継続的なすべての管理作業も担当します。詳細は、第3.4項「Spacesのためのアプリケーション管理(ロードマップ)」を参照してください。

2.3 WebCenter Portal: Spacesのインストール

WebCenter Portal: Spacesのインストールは、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドで説明しています。

2.4 Spacesの初回の設定(ロードマップ)

この項の図2-1および表2-1で示されているフロー・チャートは、Spacesアプリケーションを起動および実行するために必要な作業の概要を示しています。

図2-1 Spacesアプリケーションの初回の設定

「図2-1 Spacesアプリケーションの初回の設定」の説明

表2-1 ロードマップ - Spacesアプリケーションの初回の設定

担当者

タスク

サブタスク

ノート

管理者

1. Spacesのインストールの検証

1.a WebCenter Portal: Spacesのインストール

1.b ノード・マネージャの起動

1.c 管理対象サーバーの起動

1.d デフォルトの管理者としてSpacesアプリケーションにログイン

1.e 他のユーザーへの管理権限の付与

管理者

2. 次のツールのどちらかを使用してバックエンド・コンポーネントへの接続を追加または変更

- Fusion Middleware Control

- WLST

バックエンド・コンポーネントには次のものが含まれる可能性があります。

- コンテンツ・リポジトリ脚注 1

- BPELサーバー脚注参照 1

- 分析コレクタ

- アクティビティ・グラフ・エンジン

- ディスカッション・サーバー脚注参照 1

- イベント・サーバー

- メール・サーバー

- プレゼンス・サーバー

- Oracle Secure Enterprise Search

- パーソナライズ・サーバー脚注参照 1

- WebCenter Portalリポジトリ脚注参照 1

- MDS脚注参照 1

管理者

3. 次のツールのどちらかを使用して、外部アプリケーションおよびポートレット・プロデューサに接続

- Fusion Middleware Control

- WLST

ポートレット・プロデューサには、次のものが含まれる可能性があります。

- WSRPプロデューサ脚注参照 1

- Oracle PDK-Javaプロデューサ脚注参照 1

- ページレット・プロデューサ脚注参照 1

管理者

4. バックエンド・サーバーをSpacesアプリケーションと同じアイデンティティ・ストアへ接続

バックエンド・サーバーには次のものが含まれる可能性があります。

- Oracle WebCenter Content Server

- Oracle Secure Enterprise Search

- BPELサーバー

- ディスカッション・サーバー

- プレゼンス・サーバー

管理者

5. Spacesアプリケーションとの通信の保護

5.a シングル・サインオンの構成

5.b SSLの構成

5.c WS-Securityの構成

管理者

6. (オプション) Spacesのオプションの構成:

- Spacesワークフロー脚注参照 1

- 通知メッセージ・チャネル

- 検索クローラ

- 検索設定

- RSSニュース・フィード

管理者

7. WC_Spaces (Spacesアプリケーションがデプロイされる管理対象サーバー)の再起動

Spaces管理者

8. Spacesへのログイン

Spaces管理者

9. グローバル・オプションの設定およびSpacesのカスタマイズ

Spaces管理者

10. アプリケーション・ロールの付与

脚注 1 初期設定で自動構成済

2.5 Spacesの初回のカスタマイズ(ロードマップ)

表2-2のロードマップは、Spaces管理者が新しいターゲット・ユーザーのためにSpacesをカスタマイズするために実行できる作業の概要を示しています。

表2-2 ロードマップ - Spacesの初回のカスタマイズ

タスク

ドキュメント

担当者

1. Spacesへのログイン

Spacesに管理権限でログインし、管理ページにアクセスします。

- Spaces管理ページへのアクセス

ヒント:

SpacesのURLは、http://<host>:<port>/webcenterです。

Spaces管理のURLは、http://<host>:<port>/webcenter/spaces/adminです。

Spaces管理者

2. Spacesのカスタマイズ

Spacesをターゲット・ユーザー向けにカスタマイズします。アプリケーションの名前およびロゴの選択、企業ブランドの適用、言語オプションの設定などがあります。詳細は、次を参照してください。

- Spaces管理ページでのアクションの実行

- グローバルなデフォルトの構成

- サービス、ポートレット・プロデューサおよび外部アプリケーションの構成

- ポータルの初期画面の準備

- ポータル・リソースの管理

Spaces管理者

3. 自己登録ポリシーの決定

新規ユーザー登録に関するポリシーを設定します。Spacesコミュニティの外部ユーザーによる自己登録を招待のみに限定するか、自己登録を広く一般に許可します。

- 招待者限定の自己登録の有効化

- すべてのユーザーの自己登録の有効化

Spaces管理者

4. パブリック・ユーザー・エクスペリエンスの計画

第一印象は、非常に重要です。ようこそページに表示されるコンテンツ、およびユーザーがログインする前のSpacesの外観を決定します。

- ようこそページのカスタマイズ

- ログイン・ページのカスタマイズ

- 自己登録ページのカスタマイズ

- デフォルトの表示言語の選択

- パブリック・ユーザーへの権限の付与

Spaces管理者

5. ロールの作成および他のユーザーへの責任の委任

ロールを作成してユーザーのグループの特性を示し、Spacesアプリケーションでユーザーが何を表示でき、どのような操作を実行できるかを決定します。アイデンティティ・ストアでユーザー・ロールの管理および割当てを行います。

- Spacesでのセキュリティの概要

- ユーザー(およびグループ)へのロールの割当て

- アプリケーション・ロールの定義

- ユーザーへの管理権限の付与

- アプリケーション・ロールの権限の変更

Spaces管理者

6. ホーム・スペースのカスタマイズ

Spacesユーザーのためのデフォルトのホーム・スペースを設計します。各ユーザーのロールに関連のある重要な情報およびアプリケーションに即時にアクセスできるようにします。

- ビジネス・ロール・ページのためのページ作成のデフォルトの設定

- ビジネス・ロール・ページの作成

デフォルトのページ・スキームおよびページ・テンプレートにより、一貫性のあるルック・アンド・フィールを奨励または強制します。

- 新しいページのためのデフォルトのルック・アンド・フィールの選択

Spaces管理者

7. ディスカッション・フォーラムおよびお知らせの設定

ディスカッション・フォーラムおよびお知らせのデフォルト・オプションを構成します。

- Spacesのためのディスカッション・フォーラム・オプションの構成

Spaces管理者

8. ピープル・コネクション・コンポーネントの設定

アクティビティ・ストリーム、個人プロファイル、接続、メッセージ・ボードおよびフィードバックのデフォルトを構成します。

- Spacesのためのピープル・コネクションのデフォルトの構成

Spaces管理者

9. メール通知の設定

すべてのユーザーのメールのためのデフォルト・オプションを構成します。

- Spacesアプリケーションのためのメール通知の送信の構成

Spaces管理者

10. 既存のスペースおよびスペース・テンプレートの提供

ユーザーは集中管理なしで独自のスペースを作成および管理できます。作成する可能性があるタイプのワークスペースおよびコミュニティのテンプレートを事前に作成しておき、ユーザーに提供します。

- スペースの構築

- カスタム・スペース・テンプレートの作成

Spaces管理者

3 Spacesアプリケーションのメンテナンス

起動され実行されているSpacesアプリケーションを維持するには、Fusion Middleware管理者とSpaces管理者の両方からの入力が必要です。この章では、各管理者のロールおよび職責について説明します(1人の管理者が兼任する場合もあります)。

このプロセスを説明するために役立ついくつかのロードマップも提供されます。

この章の内容は次のとおりです。

- 第3.1項「Fusion Middleware管理者のロール」

- 第3.2項「Spaces管理者のロール」

- 第3.3項「Spacesのためのシステム管理(ロードマップ)」

- 第3.4項「Spacesのためのアプリケーション管理(ロードマップ)」

対象読者

この章の内容は、Spacesを担当するFusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)およびSpaces管理者(Spaces管理ページを使用してAdministratorロールを付与されたユーザー)を対象としています。

注意:

WebCenter Portal: Frameworkを使用して構築されたポータル・アプリケーションをメンテナンスする管理者は、第5章「Frameworkアプリケーションのメンテナンス」を参照する必要があります。

3.1 Fusion Middleware管理者のロール

Oracle Fusion Middlewareでは、すべての管理能力を有する単一の管理ロール(Adminロール)を提供します。Fusion Middleware管理者は、セキュリティの影響を受ける管理作業の全範囲、およびすべてのインストール、構成および監査作業を実行できます。この管理者は、Spacesアプリケーションをインストールした後に速やかに設定および構成し、Spacesおよびその他のOracle WebCenter Portalコンポーネントの継続的な管理タスクを実行する必要があります。このドキュメントでは、この管理者をFusion Middleware管理者と呼びます。

Fusion Middlewareのインストール時に、1 つのFusion Middleware管理者アカウント(デフォルトではweblogic)が設定されます。パスワードは、インストールの際に入力したパスワードです。

Fusion Middleware管理者がSpacesに関して実行することが予想される継続的な管理作業を知るには、「ロードマップ - Spacesの管理および監視」に従ってください。

注意:

Fusion Middleware管理者は、初期設定でのSpacesアプリケーションの起動および実行も担当します。詳細は、第2.4項「Spacesの初回の設定(ロードマップ)」を参照してください。

3.2 Spaces管理者のロール

Spaces管理者には、Spacesアプリケーション自体の中で最も高いアプリケーション権限があります。管理者は、Spacesアプリケーションのすべての側面の表示およびカスタマイズ、ユーザーおよびロールの管理、および別のユーザーへの職責の委任を行うことができます。

初期の設定では、Fusion Middleware管理者(weblogic)は、SpacesのAdministratorロールを割り当てられた唯一のユーザーです。このパスワードは、インストール中に提供されます。

Spaces管理者が実行することが予想される継続的な管理作業を知るには、「ロードマップ - Spacesの起動および実行の維持」に従ってください。

注意:

Spaces管理者は、初期設定のSpacesアプリケーションのカスタマイズも担当します。詳細は、第2.5項「Spacesの初回のカスタマイズ(ロードマップ)」を参照してください。

3.3 Spacesのためのシステム管理(ロードマップ)

表3-1のロードマップに、起動され実行されているSpacesアプリケーションを維持するためにFusion Middleware管理者が実行できる一般的な作業の概要を示します。

表3-1 ロードマップ - Spacesの管理および監視

タスク

ドキュメント

ロール

管理対象サーバーの起動および停止

構成の変更を有効にするためか所定のメンテナンスのために、Spacesアプリケーションがデプロイされる管理対象サーバーを再起動します。

- WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

ヒント: Spaces用の管理対象サーバーの名前はWC_Spacesです。

Fusion Middleware管理者

ログ・ファイルの表示および管理

ログ・ファイルからの問題の識別および診断Spacesのログには、すべてのイベント・タイプが記録されます。起動と停止の情報、エラー、警告およびその他の情報が含まれます。

- ログ情報の表示および構成

Fusion Middleware管理者

パフォーマンスの監視

Fusion Middleware ControlコンソールでSpacesアプリケーションのパフォーマンスを分析し、現在の状態を監視します。

- パフォーマンス情報の表示

- Spacesアプリケーションの監視

ロールAdmin、Operator、Monitorのいずれかを付与されたFusion Middleware管理者は、パフォーマンス・メトリックを表示できます。詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

Spaces管理者は、WebCenter Portalの分析機能を使用して、アプリケーションのパフォーマンスおよび使用状況を監視できます。

- WebCenter Spacesの「WebCenter Spacesの分析管理ページの理解」ページの理解

Fusion Middleware管理者

Spaces管理者

アプリケーションのプロパティの調整

WebCenter Portal環境、SpacesアプリケーションおよびWebCenter Portalサービスのためのパフォーマンス関連のパラメータを再構成します。

- Oracle WebCenter Portalのパフォーマンスの調整

Fusion Middleware管理者

Spacesの停止および起動

Fusion Middleware管理者は、メンテナンスの目的でSpacesアプリケーションを停止してから再起動する場合があります。

- Fusion Middleware Controlを使用したSpacesの起動

- Fusion Middleware Controlを使用したSpacesの停止

Fusion Middleware管理者

バックエンド・サービスの変更

Fusion Middleware Controlコンソールで接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- コンテンツ・リポジトリ

- コンテンツ・リポジトリの管理

- メール・サーバー

- メール・サービスの管理

- BPELサーバー

- ワークリスト・サービスの管理

- コラボレーション・サービス

- お知らせおよびディスカッション・サービスの管理

- インスタント・メッセージおよびプレゼンス・サービスの管理

- カレンダ・サービス

- イベント・サービスの管理

- Secure Enterprise Search

- WebCenter PortalでのOracle SES検索の管理

- 分析サービス

- 分析サービスの管理

- アクティビティ・グラフ・サービス

- アクティビティ・グラフ・サービスの管理

- パーソナライズ・サービス

- WebCenter Portalのパーソナライズの管理

- イベント、リンク、リスト、ノート、タグおよびピープル・コネクション

- データベース接続の設定

- MDSリポジトリの設定

外部アプリケーションおよびポートレット・プロデューサの変更

Fusion Middleware Controlコンソールで接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- 外部アプリケーション

- 外部アプリケーションの管理

- ポートレット・プロデューサ

- WSRPプロデューサの登録

- Oracle PDK-Javaプロデューサの登録

- ページレット・プロデューサの登録

SSL通信の構成

セキュアな通信を構成します。

- SSLの構成

- WS-Securityの構成

- シングル・サインオンの構成

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』も参照してください。

Fusion Middleware管理者

アイデンティティ、ポリシーおよび資格証明ストアの再関連付け

アイデンティティまたはポリシー・ストアの再関連付け

- アイデンティティ・ストアの構成

- ポリシーおよび資格証明ストアの構成

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』も参照してください。

Fusion Middleware管理者

WebCenterのリポジトリの再構成

WebCenter Portalリポジトリを再構成します。

- データベース接続の設定

Fusion Middleware管理者

MDSリポジトリの再構成

アプリケーションのMDSリポジトリを再構成します。

- MDSリポジトリの設定

『Oracle Fusion Middleware管理者ガイド』も参照してください。

- MDSリポジトリの管理

- 異なるMDSリポジトリまたはパーティションを使用するためのアプリケーションの構成

- テスト・システムから本番システムへのメタデータの移動

Fusion Middleware管理者

Spacesワークフローの再構成

異なるBPELサーバーへSpacesワークフローをインストールし、接続を再構成します。

- Spacesワークフローのインストール

- SpacesワークフローをホスティングするBPELサーバーの指定

Fusion Middleware管理者

Spacesアプリケーションのエクスポート

エクスポート機能を使用して、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

- Spacesアプリケーション全体のエクスポート

- 個々のスペースのエクスポート

- 個々のスペース・テンプレートのエクスポート

Fusion Middleware管理者

Spacesアプリケーションのインポート

インポート機能を使用して、バックアップからのSpacesのリストア、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

- Spacesアプリケーション全体のインポート

- 個々のスペースのインポート

- 個々のスペース・テンプレートのインポート

Fusion Middleware管理者

3.4 Spacesのためのアプリケーション管理(ロードマップ)

表3-2のロードマップでは、Spaces管理者がSpacesの起動時および実行時に実行する可能性がある一般的な作業の概要を示します。

メンテナンスのためにSpacesをオフラインにする必要がある場合は、オフライン中にアプリケーションへのアクセスを試みるユーザーに対して適切なメッセージが表示されることを確認してください。

表3-2 ロードマップ - Spacesの起動および実行の維持

タスク

ドキュメント

ロール

アプリケーション設定の変更

アプリケーション全体の設定を必要に応じて変更します。

- Spaces管理ページでのアクションの実行

- グローバルなデフォルトの構成

- サービス、ポートレット・プロデューサおよび外部アプリケーションの構成

- ポータルの初期画面の準備

- ポータル・リソースの管理

Spaces管理者

ホーム・スペースの管理

個人用ページおよびビジネス・ロール・ページを管理します。コンテンツをホーム・スペースにプッシュします。

- ビジネス・ロール・ページでの作業

- 個人用ページでの作業

- システム・ページでの作業

Spaces管理者

スペースの管理

任意のスぺースを一時的にオフラインにし、非アクティブなスぺースを終了します。任意のスぺースを編集および削除します。

- スぺース情報の表示

- スぺースのステータスの変更

Spaces管理者

スぺース・テンプレートの管理

スぺース・テンプレートを管理します。任意のテンプレートを確認および削除します。

- スぺース・テンプレートの管理

Spaces管理者

ユーザーおよびロールのメンテナンス

セキュリティをメンテナンスします。ユーザー・ロールの権限の変更、新しいロールの割当てを行います。

- アプリケーション・ロールの権限の変更

- ユーザーへの異なるロールの割当て

Spaces管理者

外部アプリケーションの管理

外部アプリケーションをメンテナンスします。エントリを追加、変更および削除します。

- 外部アプリケーションの登録

Spaces管理者

AppConnectionManager

ポートレット・プロデューサの管理

ポートレット・プロデューサをメンテナンスします。エントリを追加、変更および削除します。

- ポートレット・プロデューサの登録

Spaces管理者

AppConnectionManager

4 Frameworkアプリケーションの起動および実行

Frameworkアプリケーションは、WebCenter Portal: Frameworkを使用して構築されたポータル・アプリケーションです。この章では、インストールの後、Fusion Middleware管理者がFrameworkアプリケーションを起動して実行するために必要な作業の概要を示します。このプロセスを説明するために役立つロードマップが提供されます。

この章の内容は、次のとおりです。

- 第4.1項「Oracle WebCenter PortalおよびFrameworkライブラリのインストール」

- 第4.2項「Frameworkアプリケーションの初回のデプロイ(ロードマップ)」

SpacesはWebCenter Portal: Frameworkを使用して構築されたものですが、Spacesでは、他のFrameworkアプリケーションには必要のないいくつかの特別な管理作業を実行する必要があります。これらのタスクを網羅したリストは、第2章「Spacesアプリケーションの起動および実行」を参照してください。

対象読者

この章の内容は、Frameworkアプリケーションの管理を担当するFusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。

4.1 Oracle WebCenter PortalおよびFrameworkライブラリのインストール

Oracle WebCenter Portalのインストールは、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドで説明しています。

Frameworkアプリケーションの構築に必要な、Oracle JDeveloperのインストールは、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』で説明しています。

Frameworkアプリケーションは、WebCenter PortalのFramework共有ライブラリ・ファイルでプロビジョニングされている任意のWebLogic Serverインスタンスにデプロイできます。詳細は、第7.1.4項「管理対象サーバーの作成」を参照してください。

4.2 Frameworkアプリケーションの初回のデプロイ(ロードマップ)

表4-1のロードマップでは、Fusion Middleware管理者が、WebCenter Portal: Frameworkで開発されたアプリケーションをデプロイし、それを起動および実行するために行う必要がある作業の概要を示します。

注意:

Spacesアプリケーションでは、他のFrameworkアプリケーションでは必要のない、追加の管理作業が必要です。これらのタスクを網羅したリストは、第2章「Spacesアプリケーションの起動および実行」を参照してください。

表4-1 ロードマップ - Frameworkアプリケーションの初回の起動および実行

手順

ドキュメント

ロール

手順1: Oracle WebCenter Portalのインストールの検証

Oracle WebCenter Portalのインストールおよび設定を検証します。次を参照してください。

- Oracle WebCenter PortalおよびFrameworkライブラリのインストール

- ノード・マネージャの起動

Fusion Middleware管理者

手順2: Fusion Middleware Controlの起動

Fusion Middleware Controlコンソール(WebCenter Portalアプリケーション用のWebベースの管理ツール)を起動します。次を参照してください。

- Fusion Middleware Controlコンソールの表示

- Frameworkアプリケーションのホームページへの移動

コマンドライン管理ツールWLSTについて理解します。「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

Fusion Middleware管理者

手順3: Frameworkアプリケーションのデプロイ

Frameworkアプリケーション・アーカイブのデプロイに適切なコンテナを作成します。

- 管理対象サーバーの作成

- メタデータ・サービス・リポジトリの作成および登録

- WebLogic管理対象サーバーへのアプリケーションのデプロイ

「WebCenter Portal: Frameworkアプリケーションのデプロイ」も参照してください。

Fusion Middleware管理者

手順4: バックエンド・サーバーの再構成

必要な場合は、Fusion Middleware Controlから、バックエンド・サーバー接続を再構成します。

Fusion Middleware管理者

- コンテンツ・リポジトリ

- コンテンツ・リポジトリの管理

- メール・サーバー

- メール・サービスの管理

- BPELサーバー

- ワークリスト・サービスの管理

- コラボレーション・サービス

- お知らせおよびディスカッション・サービスの管理

- インスタント・メッセージおよびプレゼンス・サービスの管理

- Secure Enterprise Search

- WebCenter PortalでのOracle SES検索の管理

- 分析サービス

- 分析サービスの管理

- アクティビティ・グラフ・サービス

- アクティビティ・グラフ・サービスの管理

- パーソナライズ・サービス

- WebCenter Portalのパーソナライズの管理

- 外部アプリケーション

- 外部アプリケーションの管理

- ポートレット・プロデューサ

- WSRPプロデューサの登録

- Oracle PDK-Javaプロデューサの登録

- ページレット・プロデューサの登録

- グループ・イベント、リンク、リスト、ノートおよびタグ

- データベース接続の設定

- MDSリポジトリの設定

手順5: アイデンティティ・ストアへの接続

アイデンティティ・ストアがインストールおよび構成され、必要なすべてのユーザー・データが含まれていることを確認します。次を参照してください。

- アイデンティティ・ストアの構成

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』も参照してください。

Fusion Middleware管理者

手順6: 管理対象サーバーの再起動

アプリケーションがデプロイされる管理対象サーバーを再起動します。次を参照してください。

- WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

Fusion Middleware管理者

手順7: Frameworkアプリケーションの構成の検証

アプリケーションにログインして、アイデンティティ・ストア、サービス、アプリケーションなどの構成を検証します。

- WebCenter Portal管理コンソールの使用

Frameworkアプリケーション管理者

手順8: WebCenter Portal管理ページを使用した管理作業の実行

管理作業を実行します。

- アプリケーションレベルのプリファレンスの設定

- ユーザーの管理およびアプリケーション・ロールの付与

- アプリケーション・リソースの管理および構成

- コンテンツの管理および構成

- ポートレット・プロデューサの管理および構成

- 外部アプリケーションの管理および構成

- 投票の作成および管理

「WebCenter Portal管理コンソールの使用」を参照してください。

アプリケーション管理者

5 Frameworkアプリケーションのメンテナンス

この章では、起動され実行されているFrameworkアプリケーションを維持するためにFusion Middleware管理者に必要な作業の概要を示します。次のロードマップは、このプロセスを説明するために役立ちます。

- 第5.1項「Frameworkアプリケーションのためのシステム管理(ロードマップ)」

SpacesアプリケーションはWebCenter Portal: Frameworkを使用して構築されましたが、Spacesアプリケーションでは、Frameworkアプリケーションには必要のないいくつかの特別なメンテナンス作業を実行する必要があります。これらの作業を網羅したリストは、第3章「Spacesアプリケーションのメンテナンス」を参照してください。

対象読者

この章の内容は、Frameworkアプリケーションの管理を担当するFusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。

5.1 Frameworkアプリケーションのためのシステム管理(ロードマップ)

表5-1のロードマップに、起動され実行されているFrameworkアプリケーションを維持するためにFusion Middleware管理者が実行できる一般的な作業の概要を示します。

メンテナンスのためにFrameworkアプリケーションを一時的に停止する必要がある場合は、オフライン中にアプリケーションへのアクセスを試みるユーザーに対して適切なメッセージが表示されることを確認してください。

表5-1 ロードマップ - Frameworkアプリケーションのメンテナンス

タスク

ドキュメント

ロール

管理対象サーバーの起動および停止

構成の変更を有効にするため、または所定のメンテナンスのために、Frameworkアプリケーションがデプロイされる管理対象サーバーを再起動します。

- WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

Fusion Middleware管理者

Frameworkアプリケーションの停止および起動

メンテナンスのためにアプリケーションを停止してから再起動します。

- Frameworkアプリケーションの起動および停止

Fusion Middleware管理者

バックエンド・サービスのメンテナンス

Fusion Middleware Controlコンソールで接続を追加、変更および削除します。

Fusion Middleware管理者

- コンテンツ・リポジトリ

- コンテンツ・リポジトリの管理

- メール・サーバー

- メール・サービスの管理

- BPELサーバー

- ワークリスト・サービスの管理

- コラボレーション・サービス

- お知らせおよびディスカッション・サービスの管理

- インスタント・メッセージおよびプレゼンス・サービスの管理

- Secure Enterprise Search

- WebCenter PortalでのOracle SES検索の管理

- 分析サービス

- 分析サービスの管理

- アクティビティ・グラフ・サービス

- アクティビティ・グラフ・サービスの管理

- パーソナライズ・サービス

- WebCenter Portalのパーソナライズの管理

外部アプリケーションおよびポートレット・プロデューサのメンテナンス

Oracle Enterprise Manager Fusion Middleware Controlコンソールで接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- 外部アプリケーション

- 外部アプリケーションの管理

- ポートレット・プロデューサ

- WSRPプロデューサの登録

- Oracle PDK-Javaプロデューサの登録

- ページレット・プロデューサの登録

アイデンティティ、ポリシーおよび資格証明ストアの再関連付け

アイデンティティまたはポリシー・ストアの再関連付け

- アイデンティティ・ストアの構成

- ポリシーおよび資格証明ストアの構成

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』も参照してください。

Fusion Middleware管理者

MDSリポジトリの再構成

- MDSリポジトリの設定

Fusion Middleware管理者

WebCenterのリポジトリの再構成

- データベース接続の設定

Frameworkアプリケーションのデータのエクスポート

リモート・インスタンスにデータを移行したり、ステージング環境と本番環境の間でデータを移行します。

- WebCenter Portalサービス・メタデータおよびデータのエクスポート(Frameworkアプリケーション)

- ポートレット・クライアント・メタデータのエクスポート(Frameworkアプリケーション)

- WebCenter Portalアプリケーションのセキュリティの移行

- データの移行(WebCenter Portalアプリケーション)

「WebCenter Portalのエクスポート、インポート、バックアップおよびリカバリの管理」も参照してください。

Fusion Middleware管理者

Frameworkアプリケーションのデータのインポート

インポート機能を使用して、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

- WebCenter Portalサービス・メタデータおよびデータのインポート(Frameworkアプリケーション)

- ポートレット・クライアント・メタデータのインポート(Frameworkアプリケーション)

- WebCenter Portalアプリケーションのセキュリティの移行

- データの移行(WebCenter Portalアプリケーション)

Fusion Middleware管理者

ログ・ファイルの表示および管理

ログ・ファイルからの問題の識別および診断Frameworkアプリケーションのログには、すべてのイベント・タイプが記録されます。起動と停止の情報、エラー、警告およびその他の情報が含まれます。

- ログ情報の表示および構成

Fusion Middleware管理者

パフォーマンスの監視

Fusion Middleware ControlコンソールでFrameworkアプリケーションのパフォーマンスを分析し、現在の状態を監視します。

- パフォーマンス情報の表示

- Frameworkアプリケーションの監視

Fusion Middleware管理者

アプリケーションのプロパティの調整

WebCenter Portal環境、アプリケーションおよびサービスのためのパフォーマンス関連のパラメータを再構成します。

- Oracle WebCenter Portalのパフォーマンスの調整

Fusion Middleware管理者

WebCenter Portal管理ページを使用したアプリケーション管理作業の実行

アプリケーションの管理作業を実行します。

- アプリケーションレベルのプリファレンスの設定

- ユーザーの管理およびアプリケーション・ロールの付与

- アプリケーション・リソースの管理および構成

- コンテンツの管理および構成

- ポートレット・プロデューサの管理および構成

- 外部アプリケーションの管理および構成

- 投票の作成および管理

「WebCenter Portal管理コンソールの使用」を参照してください。

アプリケーション管理者

第III部

Oracle WebCenter Portalの基本的なシステム管理

管理者ガイドのこの部では、Spacesアプリケーションおよびデプロイする他の任意のWebCenter Portalアプリケーションなど、Oracle WebCenter PortalおよびWebCenter Portalアプリケーションのためのシステム管理作業について説明します。

第III部の内容は次のとおりです。

- 第6章「Enterprise Manager Fusion Middleware Controlの起動」

- 第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」

- 第8章「WebCenter Portalアプリケーションの起動および停止」

- 第9章「Setting WebCenter Portal Application Properties」

6 Enterprise Manager Fusion Middleware Controlの起動

この章では、Oracle Enterprise Manager Fusion Middleware Controlコンソールにアクセスする方法と、必要なすべての構成、監視および管理作業を実行できるWebCenter Portal関連ページを表示する方法について説明します。

この章の内容は次のとおりです。

- 第6.1項「Fusion Middleware Controlコンソールの表示」

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

- 第6.4項「依存コンポーネントへの移動」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdmin、Operator、Monitorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

6.1 Fusion Middleware Controlコンソールの表示

Fusion Middleware管理者は、Fusion Middleware Controlコンソールにログインして、WebCenter Portalを管理するためのページにアクセスできます。ロールによって、ログイン後に表示および実行できることが決まります。詳細は、表1-7「WebCenter Portalの操作およびOracle WebLogic Serverロール」を参照してください。

Fusion Middleware Controlコンソールにアクセスする手順は、次のとおりです。

1. Fusion Middleware Controlを起動します。
Fusion Middleware Controlはドメインに対して構成されており、Oracle WebLogic Server管理サーバーの起動時に自動的に起動されます。『Oracle Fusion Middleware管理者ガイド』のFusion Middleware Controlの起動および停止に関する項を参照してください。

2. http://host_name.domain_name:port_number/emのURLにナビゲートします。
例: http://myhost.mycompany.com:7001/em

管理ポート番号を含む正確なURLは、config.xml内に示されています。

- Windows上: DOMAIN_HOME\config\config.xml

- UNIX上: DOMAIN_HOME/config/config.xml

『Oracle Fusion Middleware管理者ガイド』のポートの管理に関する項も参照してください。

3. ファームの管理者「ユーザー名」および「パスワード」の有効な詳細を入力します。
管理者ユーザーのためのデフォルトのユーザー名は、weblogicです。これは、最初にFusion Middleware Controlにログインするために使用できるアカウントです。

4. 「ログイン」をクリックします。
最初に表示されるページは、「ファーム」ホームページです。このページは、ナビゲーション・ペイン(図6-1)でファーム名を選択すると、いつでも表示できます。

ヒント:

ログインできない場合は、WebLogic管理コンソールにログインし、ホスト、ポートおよび資格証明の確認を試みてください。Weblogic管理コンソールはFusion Middleware Controlと同じホストおよびポートでアクセスできます。(http://host_name.domain_name:port_number/console)

図6-1 ファーム・ホームページ

ナビゲーション・ペインからドリルダウンして、Spacesアプリケーションおよびデプロイした可能性のある任意のFrameworkアプリケーションを含む、ファーム内のすべてのコンポーネントを表示および管理できます。詳細な手順は、次の項を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

6.2 Spacesアプリケーションのホームページへの移動

Spacesアプリケーションを管理するための最初のページは、Spacesのホームページです。このページには、Spacesアプリケーションを構成するすべてのコンポーネントとサービスのステータス、パフォーマンスおよび可用性が表示されます。

図6-2 Spacesのホームページ

このページからは、次の操作を実行できます。

- Spacesアプリケーションのステータスの確認

- 主要なスペース関連のパフォーマンス・データの表示。アプリケーションが様々な負荷の下でどのように実行されるかを確認するためとシステム・リソースの問題を診断するための、ユーザー・アクセス率と比較した全体的なレスポンス時間の追跡。最も使用されるスペース、最も遅い実行者の迅速な確認、および最も多くのエラーを記録しているスペースの判別。

- WebLogic ServerインストールおよびMDSリポジトリを含む、他の主要なコンポーネントへの移動

- アプリケーションで使用されるWebCenter Portalサービスのステータスおよび主要なパフォーマンス・メトリックの表示

- 個々のスペース、サービス、外部アプリケーション、ポートレットおよびプロデューサの詳細なパフォーマンス情報へのドリルダウン

Spacesのホームページには、「WebCenterポータル」メニュー(図6-3)も表示されます。

図6-3 Spacesアプリケーションの「WebCenterポータル」メニュー

「WebCenterポータル」メニューから、次のことが行えます。

- Spacesアプリケーションの起動および停止

- アプリケーション設定の構成

- バックエンド・サービスの管理

- 外部アプリケーションの管理

- ポートレット・プロデューサの登録および管理

- すべてのコンポーネントの詳細なパフォーマンス・メトリックの監視

- ライブ・メトリックの選択および図表化

- 診断情報の分析およびログの構成

- Spacesアプリケーションのエクスポートおよびインポート

- セキュリティ・ポリシーおよびロールの構成

- ADFおよびMDSオプションの構成

- Webサービス関連の情報の表示

Spacesのメイン・ホームページに移動する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲータ(図6-4)で、「WebCenter」→「ポータル」→「Spaces」を開きます。

3. 「WebCenter」を選択して、Spacesのインストールのホームページに移動します(図6-4)。

図6-4 Spacesのホームページへの移動

ナビゲータ・メニューがどのように「WebCenterポータル」に変わるかに注意してください(図6-5)。

図6-5 Spacesのホームページおよびメニューの表示

特定のコンポーネントのためのコンテキスト・メニューにアクセスする別の方法は、ナビゲーション・ツリーでノードを右クリックすることです。たとえば、左の「webcenter(11.1.1.4.0)」で「Spaces」ノードを右クリックすると、同じ「WebCenterポータル」メニューが表示されます。

6.3 Frameworkアプリケーションのホームページへの移動

WebCenter Portal: Frameworkで開発されたポータル・アプリケーション・デプロイメントを管理するための最初のページは、J2EEの「アプリケーション・デプロイメント」ホームページ(図6-6)です。このページには、Frameworkアプリケーションを構成するすべてのコンポーネントとサービスのステータス、パフォーマンスおよび可用性が表示されます。

注意:

Spacesアプリケーションには異なるホームページがあります。「Spacesアプリケーションのホームページへの移動」を参照してください。

図6-6 Frameworkアプリケーションのホームページ

このページからは、次の操作を実行できます。

- Frameworkアプリケーションのステータスの確認

- Oracle WebLogic Server管理コンソールへの移動

- 様々な「アプリケーション・デプロイメント」メニュー・オプションへのアクセス

- アプリケーションの起動、再起動および停止

- ログ・ファイルの表示および構成

- アプリケーションのアンデプロイおよび再デプロイ

- セキュリティ・ポリシーおよびロールの構成

- ADFおよびMDSオプションの構成

- パフォーマンス・サマリーの表示、アプリケーションのエントリ・ポイントの表示、アプリケーションに関連付けられたWebサービスとモジュールの表示、および秒当たりのリクエスト数とリクエスト処理時間を示すレスポンス・データとロード・データの表示

- Frameworkアプリケーションの主要コンポーネントへの移動

- 個々のモジュールおよびサービスの詳細なパフォーマンス情報へのドリルダウン

Frameworkアプリケーションの場合、「アプリケーション・デプロイメント」メニューに追加で「WebCenterポータル」メニュー・オプションが表示されます。「WebCenterポータル」メニューからは、次のようなWebCenter Portal固有の作業を実行できます。

- 外部アプリケーションの管理(第26章「外部アプリケーションの管理」を参照)

- バックエンド・サービスの管理(第10章「Oracle WebCenter Portalサービスの管理」を参照)

- ポートレット・プロデューサの管理(第24章「ポートレット・プロデューサの管理」を参照)

- WebCenterサービスの詳細なパフォーマンス・メトリックの監視(第38章「Oracle WebCenter Portalのパフォーマンスの監視」を参照)

Frameworkアプリケーションのメイン・ホームページに移動する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲータ(図6-7)で、「アプリケーション・デプロイメント」を開きます。

図6-7 Frameworkアプリケーションのホームページへの移動

3. Frameworkアプリケーションの名前を選択して、アプリケーションのホームページを表示します。
「アプリケーション・デプロイメント」メニュー(図6-8)に「WebCenterポータル」メニュー・オプションが表示されていることに注意してください。

図6-8 Frameworkアプリケーションのホームページおよびメニューの表示

6.4 依存コンポーネントへの移動

WebCenter Portalのページから、WebLogic Serverドメイン、サーバー、Javaコンポーネント、MDSリポジトリなどの関連するコンポーネントに属するページに移動することは簡単です。

- Spacesアプリケーション: ホームページから「関連コンポーネント」内のリンクをクリックして、Spacesアプリケーション自体、WebLogic Serverインストール・ページ、およびFusion Middleware Control内のMDSリポジトリ・ページへ移動します。第6.2項「Spacesアプリケーションのホームページへの移動」も参照してください。

- Frameworkアプリケーション: J2EEアプリケーションのホームページ上の「アプリケーション・デプロイメント」メニューから、Oracle WebLogic Server管理コンソール、およびWebCenter Portal、ADF、MDSリポジトリおよびセキュリティの構成と管理に関連するページへ直接移動できます。第6.3項「Frameworkアプリケーションのホームページへの移動」も参照してください。

7 WebCenter Portal: Frameworkアプリケーションのデプロイ

この章では、Oracle JDeveloperで作成されたEnterprise Archiveファイル(またはEARファイル)から(EARファイルの作成方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle JDeveloperでのデプロイメント・プロファイルの作成方法に関する項を参照)、WebCenter Portal: Frameworkアプリケーションをデプロイ、アンデプロイおよび再デプロイする方法について説明します。

この章には、Spacesアプリケーションのデプロイおよびインストールに関する手順は含まれていません。Spacesおよび他のWebCenter Portalコンポーネントのインストールの詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドのOracle WebCenter Portalのインストールに関する項を参照してください。WSRPおよびPDK-Javaのポートレット・プロデューサ・アプリケーションのデプロイの詳細は、第24.8項「ポートレット・プロデューサ・アプリケーションのデプロイ」を参照してください。

この章の内容は次のとおりです。

- 第7.1項「Frameworkアプリケーションのデプロイ」

- 第7.2項「Frameworkアプリケーションのアンデプロイ」

- 第7.3項「Frameworkアプリケーションの再デプロイ」

- 第7.4項「デプロイ後の構成」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールでAdminまたはDeployerロールが付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

7.1 Frameworkアプリケーションのデプロイ

この項では、JDeveloperで作成されたFrameworkアプリケーションを本番ドメインにデプロイするために必要な手順について説明します。この項のデプロイ手順では、EARファイルをデプロイすること、その場所が判明していること、およびデプロイ先のドメインが存在することを前提としています。

WebLogic Serverドメインの作成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの新しいドメインの作成に関する項を参照してください。アプリケーションのデプロイの詳細は、Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイを参照してください。

この項の内容は次のとおりです。

- 第7.1.1項「デプロイメント・ロードマップ」

- 第7.1.2項「デプロイメントの前提条件」

- 第7.1.3項「アプリケーションEARファイルの準備」

- 第7.1.4項「管理対象サーバーの作成」

- 第7.1.5項「メタデータ・サービス・リポジトリの作成および登録」

- 第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」

- 第7.1.7項「カスタマイズおよびデータの環境間の移行」

- 第7.1.8項「分散環境で実行するためのアプリケーションの構成」

7.1.1 デプロイメント・ロードマップ

この項のフロー・チャートと表は、FrameworkアプリケーションをOracle WebLogic管理対象サーバーにデプロイするための前提条件と必要なタスクの概要を示しています。図7-1に、Frameworkアプリケーションのデプロイ手順およびそれらを実行するロールを示します。

図7-1 管理対象サーバーへのFrameworkアプリケーションのデプロイ

「図7-1 管理対象サーバーへのFrameworkアプリケーションのデプロイ」の説明

表7-1に、JDeveloperからFrameworkアプリケーションをデプロイするためのタスク、サブタスクおよびそれらの実行担当者を示します。

表7-1 管理対象サーバーへのFrameworkアプリケーションのデプロイ

担当者

タスク

サブタスク

ノート

開発者

1. アプリケーションのパッケージ化

1.a データ・ソース・タイプの選択(データベース接続のパッケージ化)

グローバル・データ・ソースまたはアプリケーションレベルのデータ・ソースのどちらかを使用できます。

グローバル・データ・ソースを使用する場合、デプロイする前にWLS管理コンソールでデータ・ソースを作成する必要があります。

アプリケーションレベルのデータ・ソースを使用する場合、デプロイした後にWLS管理コンソールで資格証明のマッピングを追加する必要があります。

1.b アプリケーション・セキュリティ・データのパッケージ化

このサブタスクには、資格証明、アイデンティティ・データおよびアプリケーション・ポリシーのパッケージ化が含まれます。

1.c デプロイメント・プロファイルの作成

このサブタスクには、WARおよびEARのファイルの作成が含まれます。

管理者

2. ターゲット環境の準備

2.a 管理対象サーバーの作成およびプロビジョニング

2.b MDSリポジトリの作成および登録

2.c ターゲット環境の構成

2.d サーバー接続の作成

開発者

3. 管理対象サーバーへのアプリケーションのデプロイ

最終手順として、Fusion Middleware Control、WLSTまたはWLS管理コンソールのいずれかを使用して、アプリケーションを管理対象サーバーにデプロイします。

7.1.2 デプロイメントの前提条件

Frameworkアプリケーションは、Oracle WebCenter PortalライブラリでプロビジョニングされるWebLogic管理対象サーバー・インスタンスにデプロイできます。

注意:

インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにFrameworkアプリケーションをデプロイすることはお薦めしません。Frameworkアプリケーションの場合、デプロイする前に新しいWLS管理対象サーバーを作成してプロビジョニングするには、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの既存ドメインの拡張に関する項の手順を実行してください。ポートレット・プロデューサ・アプリケーションの場合、オプションで新しいWebLogic管理対象サーバーを作成するか、WC_Portletサーバーにデプロイできます。

デプロイする前に必要な作業は次のとおりです。

- 第7.1.3項「アプリケーションEARファイルの準備」で説明されているように、アプリケーションEARファイルを準備します。

- 第7.1.4項「管理対象サーバーの作成」で説明されているように、WebLogic管理対象サーバーを作成します。

- 第7.1.5項「メタデータ・サービス・リポジトリの作成および登録」で説明されているように、Metadata Service (MDS)リポジトリを作成して登録します。

注意:

ページ、接続またはタスク・フローなどのアーティファクトに大規模な変更が加えられた更新アプリケーションをデプロイする前に、ランタイム・カスタマイズ(JDeveloperを使用しないカスタマイズ)を削除する必要があります。

これらの手順を完了したら、第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」の説明に従ってアプリケーションをデプロイすることで続行してください。

7.1.3 アプリケーションEARファイルの準備

アプリケーションをデプロイする前に、まずデプロイメント・プロファイルを作成する必要があります。アプリケーションがEARファイルとしてOracle WebLogic管理対象サーバーにデプロイできるように、デプロイメント・プロファイルによって、Frameworkアプリケーションおよびその関連ファイルをパッケージ化あるいはアーカイブします。

アプリケーション用デプロイメント・プロファイル(およびその結果のEARファイル)の作成方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebLogic管理対象サーバーへのFrameworkアプリケーションのパッケージ化およびデプロイに関する項を参照してください。

7.1.3.1 EARファイル・コンテンツ

EARファイルは、複数の情報アーティファクトをパッケージ化します。次のものが含まれます。

- アプリケーション自体: .jspx、.jarおよび.classファイルなどのアプリケーションの物理的部分です。

- アプリケーション構成: このアプリケーション用に構成されたサービスとプロデューサとの接続プロパティ、およびURLエンドポイントが含まれます。

- アプリケーション・メタデータ: アプリケーションのデザイン時に作成されたアプリケーション・メタデータのエクスポートです。

- ポートレット・カスタマイズ: ポートレット用のカスタマイズ設定とデータが含まれます。この情報はプロデューサ内に保持されますが、登録されたプロデューサのあるアプリケーションがパッケージ化されるときにエクスポートされます。カスタマイズ・データは、Frameworkアプリケーションの残りのメタデータでパッケージ化されます。

7.1.4 管理対象サーバーの作成

Frameworkアプリケーションをデプロイする前に、必要な共有ライブラリおよびMDSリポジトリが含まれているOracle WebCenter Portal Frameworkテンプレートに基づいて、WebLogic管理対象サーバーを作成する必要があります。Frameworkアプリケーションがポートレット化されている場合、Oracle WebCenter Portal Custom Services Producerサーバー(WC_CustomServicesProducer)にデプロイしてください。ポートレット化されたアプリケーションは、Oracle WebCenter Portal Custom Portalサーバーにはデプロイできません。必要なポートレット・ライブラリが不足しているからです。MDSスキーマだけでなく、WebCenter PortalおよびアクティビティもOracle WebCenter Portal Custom Services ProducerサーバーおよびOracle WebCenter Portal Custom Portalサーバーがターゲットです。

新しい管理対象サーバーの作成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの既存ドメインの拡張に関する項を参照してください。新しいドメインの作成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドの新しいドメインの作成に関する項を参照してください。

7.1.5 メタデータ・サービス・リポジトリの作成および登録

アプリケーションを管理対象サーバーにデプロイする前に、そのアプリケーション用のMetadata Service (MDS)リポジトリ・スキーマをWebLogicドメインの管理サーバー・インスタンスに作成して登録する必要がある場合があります。ターゲット・サーバー(Oracle WebCenter Portal Custom PortalサーバーまたはOracle WebCenter Portal Custom Services Producerサーバー)にはすでにMDSデータ・ソースが構成されているため、事前に構成されたサーバーMDSデータ・ソースを使用しない場合のみ、この手順が必要です。ただし、他のアプリケーションで共有している場合、新しいMDSスキーマは作成しないでください。

注意:

この項で説明しているカスタム・スキーマを使用するかわりに、WebCenter Portalのインストール時に作成されたMDSスキーマを使用してデプロイすると、これらのスキーマのデータを壊す危険性があります。

デプロイ時には、本番環境で使用できるように、EARファイルにエクスポートされた一部の構成情報およびアプリケーション・メタデータをMDSスキーマにインポートする必要があります。ターゲット・メタデータ・スキーマを選択したら、メタデータのインポートはデプロイ時に自動的に実行されます(第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照)。

MDSスキーマは、リポジトリ作成ユーティリティ(RCU)を使用して作成します。MDSスキーマを作成したら、Fusion Middleware Controlを使用するか、WLSTを使用したコマンドラインから登録する必要があります。

この項の内容は次のとおりです。

- 第7.1.5.1項「リポジトリ作成ユーティリティを使用したMDSスキーマの作成」

- 第7.1.5.2項「Fusion Middleware Controlを使用したMDSスキーマの登録」

- 第7.1.5.3項「WLSTを使用したMDSスキーマの登録」

7.1.5.1 リポジトリ作成ユーティリティを使用したMDSスキーマの作成

アプリケーションをデプロイする前に、まずリポジトリ作成ユーティリティ(RCU)を使用してMDSスキーマをデータベース・サーバーのインスタンスに作成し、デプロイ先ドメインの管理サーバーに登録して、アプリケーションのメタデータもデプロイできるようにする必要があります。

次の手順を実行するときは、MDSスキーマ名と、アクセスするためのログイン資格証明を必ずメモに記録してください。この情報は、デプロイメント処理の続きの手順で必要になります。

MDSスキーマの作成手順は、次のとおりです。

1. RCU_HOME/binに移動し、次のコマンドを実行してRCUを起動します。

rcu

RCUの「ようこそ」ページが表示されます(図7-2を参照)。

図7-2 RCUの「ようこそ」ページ

「図7-2 RCUの「ようこそ」ページ」の説明

2. 「次へ」をクリックします。

3. 「作成」を選択して「次へ」をクリックします。
「データベース接続の詳細」ページが表示されます(図7-3を参照)。

図7-3 「データベース接続の詳細」ページ

「図7-3 「データベース接続の詳細」ページ」の説明

4. 「データベース・タイプ」を選択し、「ホスト名」、「ポート」、「サービス名」、「ユーザー名」および「パスワード」に入力して、スキーマを追加するデータベースの接続詳細を指定したら、「次へ」をクリックします。

5. 「前提条件」ポップアップが表示されたら、「OK」をクリックします。
「コンポーネントの選択」ページが表示されます(図7-4を参照)。

図7-4 「コンポーネントの選択」ページ

「図7-4 「コンポーネントの選択」ページ」の説明

6. 「接頭辞の新規作成」を選択して、スキーマ名に付加する接頭辞を入力します。

7. 「Metadata Services」コンポーネントを選択します。他のコンポーネントが選択されていないことを確認してください。

8. 「次へ」をクリックし、「前提条件」ポップアップが表示されたら、「OK」をクリックします。
「スキーマ・パスワード」ページが表示されます(図7-5を参照)。

図7-5 「スキーマ・パスワード」ページ

「図7-5 「スキーマ・パスワード」ページ」の説明

9. スキーマ・パスワードの適用方法を選択し、パスワードを入力して確認します。

10. 「次へ」をクリックします。

11. 「表領域のマップ」ページで、「次へ」をクリックします。

12. 表領域作成のプロンプトが表示されたら、「OK」をクリックし、操作が完了したら再度「OK」をクリックします。

13. 「サマリー」ページで「作成」をクリックして、スキーマを作成します。

14. 「完了サマリー」ページでスキーマの作成が正常に完了したことが確認できたら、「閉じる」をクリックします。

7.1.5.2 Fusion Middleware Controlを使用したMDSスキーマの登録

アプリケーションをデプロイする前に、ドメインに新しいMDSスキーマを登録して、管理対象サーバーで実行しているアプリケーションがアクセスできるようにする必要があります。

Fusion Middleware Controlを使用してMDSリポジトリを登録する手順は、次のとおりです。

1. Fusion Middleware Controlを開き、ターゲット・ドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. 「ナビゲーション・ペイン」で、「ファーム」を開き、次に「WebLogicドメイン」を開きます。

3. デプロイ先のドメインを選択します。

4. 「WebLogicドメイン」メニューから「メタデータ・リポジトリ」を選択します。
「メタデータ・リポジトリ」ページが表示されます(図7-6を参照)。

図7-6 「メタデータ・リポジトリ」ページ

「図7-6 「メタデータ・リポジトリ」ページ」の説明

5. 「データベース・ベース・リポジトリ」セクションで、「登録」をクリックします。
「データベース・ベースのメタデータ・リポジトリの登録」ページが表示されます(図7-7を参照)。

図7-6 「データベース・ベースのメタデータ・リポジトリの登録」ページ

「図7-7 「データベース・ベースのメタデータ・リポジトリの登録」ページ」の説明

6. 「データベース接続」セクションで、次の情報を入力します。

- データベース: データベースのタイプを選択します。

- ホスト名: ホストの名前を入力します。

- ポート: データベースのポート番号を入力します(例: 1521)。

- サービス名: データベースのサービス名を入力します。データベースのデフォルトのサービス名は、orclなどのデータベース名、およびexample.comなどのドメイン名で構成されるグローバル・データベース名です。この場合、orcl.example.comがサービス名になります。

- ユーザー名: SYSDBAロールが割り当てられた、データベースのユーザー名を入力します(例: SYS)。

- パスワード: ユーザーのパスワードを入力します。

- ロール: データベースのロールを選択します(例: SYSDBA)。

7. 「問合せ」をクリックします。
データベースで使用可能なスキーマおよびそれらのメタデータ・リポジトリのリストがある表が表示されます。

8. リポジトリを選択し、次の情報を入力します。

- リポジトリ名: MDSスキーマの名前を入力します。

- スキーマ・パスワード: スキーマを作成したときに指定したスキーマ・パスワードを入力します。

9. 「OK」をクリックします。
リポジトリが、Oracle WebLogic Serverドメインに登録されます。

7.1.5.3 WLSTを使用したMDSスキーマの登録

データベース・ベースのMDSリポジトリは、WLSTを使用して、コマンドラインからregisterMetadataDBRepositoryコマンドを実行することによっても登録できます。

WLSTを使用してMDSスキーマを登録する手順は、次のとおりです。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

2. 次のコマンドを使用して、MDSスキーマを登録します。

registerMetadataDBRepository(name='mds_name', dbVendor='db_vendor', host='host_name', port='port_number',
dbName='db_name', user='username', password='password', targetServers='target_server')

各要素の意味は次のとおりです。

- mds_nameは、登録するMDSスキーマの名前です。

- db_vendorは、使用されるデータベースのベンダーです。

- host_nameは、Database Serverのデータベース・サーバーの完全修飾サーバー名です。

- port_numberは、Database Serverのポート番号です。

- db_nameは、MDSの格納に使用されるデータベースの名前です。

- usernameは、データベース・スキーマのユーザー名です。

- passwordは、データベース・スキーマのパスワードです。

- target_serverは、ターゲット・サーバーの名前です。複数のターゲットの場合、ターゲット・サーバーの名前をカンマで区切ってください。必ずターゲットのリストにWLS管理サーバーを含めて、アプリケーションをデプロイするときにMDSデータベース・リポジトリ名が「デプロイ・プラン」ダイアログに表示されるようにします。

たとえば、example.comというホストIDのターゲット・サーバーserver1上のOracleデータベースorclにMDSスキーマmds1を登録するには、次のコマンドを実行してください。

registerMetadataDBRepository(name='mds1', dbVendor='ORACLE', host='example.com',
port='1521',dbName='orc1', user='username', password='password',  targetServers='server1','AdminServer')

7.1.6 WebLogic管理対象サーバーへのアプリケーションのデプロイ

JDeveloperで作成されたFrameworkアプリケーションの場合、デプロイする前に、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの既存ドメインの拡張に関する項の説明に従って、新しいOracle WebCenter Portal Custom Portalサーバー、あるいはポートレット化されている場合はOracle WebCenter Portal Custom Services Producerサーバーを作成してプロビジョニングします。

表7-2 デプロイ・ターゲット

アプリケーション・タイプ

管理対象サーバー名

Frameworkアプリケーション

WC_CustomPortal

WebCenter Portal Portlet Producerアプリケーション

WC_CustomServicesProducer

WebCenter Portal Portlet Producerアプリケーション以外

WC_Portlet

ポートレット・プロデューサ・アプリケーションの場合、管理対象サーバー・インスタンスを作成するか、WC_Portletサーバーにデプロイできます。

注意:

インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにFrameworkアプリケーションをデプロイすることはお薦めしません。

Frameworkアプリケーションをデプロイできる方法は複数あります。それらの方法について次の項で説明します。

- 第7.1.6.1項「情報アーティファクト・ストアの選択」

- 第7.1.6.2項「データ・ソースの選択」

- 第7.1.6.3項「Oracle JDeveloperを使用したアプリケーションのデプロイ」

- 第7.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」

- 第7.1.6.5項「WLSTを使用したアプリケーションのデプロイ」

- 第7.1.6.6項「WLS管理コンソールを使用したアプリケーションのデプロイ」

- 第7.1.6.7項「デプロイ・プランの保存と再利用」

7.1.6.1 情報アーティファクト・ストアの選択

第7.1.3項「アプリケーションEARファイルの準備」で説明したように、パッケージ化されたEARファイルは、アプリケーション・バイナリ、アプリケーション構成、アプリケーション・メタデータおよびポートレット・カスタマイズを含めて、複数の情報アーティファクトで構成されます。

デプロイメント中に、これらの情報アーティファクトは、アプリケーションがデプロイされるインスタンスで正しい情報ストアに移動される必要があります。これらのアーティファクトのターゲット情報ストアを表7-3に示します。

表7-3 情報アーティファクトのターゲット・ストア

情報アーティファクト

ターゲット情報ストア

アプリケーション・バイナリ

ターゲット・サーバー・インスタンス

アプリケーション構成

MDS

アプリケーション・メタデータ

MDS

ポートレット・カスタマイズ

ターゲット・プロデューサ

デプロイ用に選択したツールにかかわらず、正しくデプロイするには、ターゲット情報ストアの場所を指定する必要があります。アプリケーションのデプロイは、MDSの場所が間違っていたり指定されないと失敗します。ただし、ターゲット・プロデューサが間違って指定されていてもアプリケーションはデプロイされます。ターゲット・プロデューサを間違って指定したら、ポートレットは自動的にはインポートされないため使用できません。その場合、次のいずれかを実行してください。

- Fusion Middleware Control (第24.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第24.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第24.2.2項「WLSTを使用したWSRPプロデューサの登録」または第24.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用して、デプロイ後のポートレット・プロデューサ接続を編集します。

- WLSTコマンドを使用して、ポートレット・カスタマイズをエクスポートおよびインポートします(第39.2項「データ移行のためのFrameworkアプリケーションのエクスポートおよびインポート」を参照)。

注意:

アプリケーションのデプロイ時に、すでに存在するターゲット・プロデューサが間違って指定された場合、間違ったプロデューサにポートレットはインポートされるため、それらのポートレットは使用できません。

7.1.6.2 データ・ソースの選択

データ・ソースには次の3つの基本オプションがあります。

- すでに存在するデータ・ソースを使用して、WebCenter Portal Custom Portal管理対象サーバーにデプロイします

- WebCenterDSやActivitiesDSの名前でないグローバル・データ・ソースを使用して、管理対象サーバーにデプロイします

- ローカル・アプリケーション・コンテキストの任意の名前のデータ・ソースを使用して、管理対象サーバーにデプロイします

この項では、これらのオプションのメリットとデメリットについて説明します。

すでに存在するデータ・ソースを使用して、WebCenter Portal Custom Portal管理対象サーバーにデプロイします

このオプションは、必要なデータ・ソースにアクセスするためのFrameworkアプリケーションの有効化を最も簡単にでき、推奨デプロイメント・パスです。

すでに存在するデータ・ソースを使用してデプロイするには、JDeveloperの「アプリケーション・プロパティ・デプロイメント」画面で、「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」チェック・ボックスの選択を解除してください。

アプリケーションに、WebCenterDSまたはActivitiesDS (あるいはその両方)用に構成された既存データベース接続があり、それらの名前がそれぞれwebcenter/CustomPortalおよびactivities/CustomPortalではない場合、デプロイ前にデータベース接続をアプリケーションから削除するか、データベース接続を作成してネーミング規則に沿って名前を付ける必要があります。

WebCenterDSやActivitiesDSの名前でないグローバル・データ・ソースを使用して、管理対象サーバーにデプロイします

Oracle WebCenter Custom Portalテンプレートを使用して作成された管理対象サーバーでアプリケーションを実行しない場合、あるいはWebCenterDSまたはActivitiesDS以外の名前のカスタム・データ・ソースに対してアプリケーションを実行する場合、このデプロイメント・パスを使用します。

このオプションの場合、Frameworkアプリケーションにデータベース接続があり、WEBCENTERまたはACTIVITIESのスキーマと関連付けられている必要があります。JDeveloperの「アプリケーション・プロパティ・デプロイメント」画面の「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」チェック・ボックスの選択は解除してください。WLSサーバーでグローバル・データ・ソースを使用する場合、JDeveloperプロジェクトでアプリケーション用に作成されたデータベース接続の名前に一致するJNDI名で作成されている必要があります。詳細は、OTNのJDBCデータ・ソースの作成に関する項を参照してください。

ローカル・アプリケーション・コンテキストの任意の名前のデータ・ソースを使用して、管理対象サーバーにデプロイします。

ローカル・アプリケーション・コンテキストのデータ・ソースで十分な場合、このデプロイメント・パスを使用してください。

このオプションを使用するには、WebCenterDSまたはActivitiesDS(あるいはその両方)用にデータベース接続がFrameworkアプリケーションに作成されており関連付けられている必要があります。どのデータ・ソースかは、アプリケーションで使用されているサービスに依存します。JDeveloperの「アプリケーション・プロパティ・デプロイメント」画面では、「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」チェック・ボックスを選択してください。

7.1.6.3 Oracle JDeveloperを使用したアプリケーションのデプロイ

WebLogicサーバーにアクセスするために必要な資格証明があれば、Oracle JDeveloperを使用して、Frameworkアプリケーションを開発環境からWebLogicサーバー・インスタンスに直接デプロイできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebLogic管理対象サーバー接続の作成に関する項および管理対象サーバーへのFrameworkアプリケーションのデプロイに関する項を参照してください。

7.1.6.4 Fusion Middleware Controlを使用したアプリケーションのデプロイ

Fusion Middleware Controlを使用してFrameworkアプリケーションをデプロイするには、アプリケーション・アーカイブの場所と、アプリケーションのデプロイ・プランが存在するかどうかを確認する必要があります。デプロイ・プランの詳細は、第7.1.6.7項「デプロイ・プランの保存と再利用」を参照してください。

注意:

デプロイするときに指定したメタデータ・リポジトリおよびADF接続の詳細は、デプロイ・プランの一部として格納されません。これらのデプロイ・プロパティは、アプリケーションをデプロイするたびに指定する必要があります。

更新する予定があり、アプリケーションを頻繁にデプロイするためにこれらの構成変更を保存する場合、WLSTまたはFusion Middleware Controlを使用して、デプロイ後にこれらの構成変更を行うことをお薦めします。こうした構成変更は、デプロイ・プランに保存されてMDSリポジトリに保持されるため、アプリケーションを再デプロイするときに再設定する必要はありません。

Fusion Middleware Controlを使用してFrameworkアプリケーションをデプロイする手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲーション・ペインで「WebLogicドメイン」を開き、ターゲットの管理対象サーバーが作成されたドメインをクリックします。

3. 「WebLogicドメイン」メニューから、「アプリケーション・デプロイメント」→「デプロイ」を選択します。
「アーカイブの選択」ページが表示されます(図7-8を参照)。

図7-8 「アーカイブの選択」ページ

「図7-8 「アーカイブの選択」ページ」の説明

4. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを実行します。

- 「アーカイブはこのWebブラウザが稼働しているマシンに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

- 「アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

5. 「デプロイ・プラン」セクションで、次のいずれかを実行します。

- 「デプロイ構成が行われるとき、新規デプロイ・プランを作成します。」を選択し、再デプロイ処理の後に、新しいデプロイ・プランを自動的に作成します。

- 「デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

- 「デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます(図7-9を参照)。

図7-9 「ターゲットの選択」ページ

「図7-9 「ターゲットの選択」ページ」の説明

7. アプリケーションをデプロイするためにターゲット・サーバーを選択して(ターゲットの選択の概要については、第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照)、「次へ」を選択します。
「アプリケーション属性」ページが表示されます(図7-10を参照)。

図7-10 「アプリケーション属性」ページ

「図7-10 「アプリケーション属性」ページ」の説明

8. 「ターゲット・メタデータ・リポジトリ」で、「メタデータ・リポジトリの選択」ウィンドウを表示するためのアイコンをクリックします。図7-11に示すように、このウィンドウからアプリケーションのリポジトリを選択できます。「リポジトリ」ドロップダウンを使用して必要なリポジトリを選択し、「OK」をクリックします。

注意:

「ターゲット・メタデータ・リポジトリ」オプションは、MDSリポジトリにインポートされるメタデータがアプリケーションに含まれている場合にのみ表示されます。このオプションは、ポートレット・プロデューサ・アプリケーションの場合は表示されません。

図7-11 「メタデータ・リポジトリの選択」ウィンドウ

「図7-11 「メタデータ・リポジトリの選択」ウィンドウ」の説明

9. リポジトリで使用するパーティションの名前を入力します(通常はアプリケーションの名前)。各アプリケーションには、リポジトリで一意のパーティションが設定されている必要があります。

10. 「次へ」をクリックします。
「デプロイ設定」ページが表示されます(図7-12を参照)。

図7-12 「デプロイ設定」ページ

「図7-12 「デプロイ設定」」の説明

これで、ターゲットMDSの場所の指定は完了です(第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照)。

11. 「ADF接続の構成」の「編集」アイコンをクリックして、Frameworkアプリケーションに関連付けられた接続設定をチェックします。
「ADF接続の構成」ページが表示されます(図7-13を参照)。

図7-13 「ADF接続の構成」ページ

「図7-13 「ADF接続の構成」ページ」の説明

12. 接続ごとに「編集」アイコンをクリックして、接続設定がターゲット環境に対して正しいことを確認します(本番やステージングなど)。
たとえば、ディスカッション・フォーラム接続の場合(図7-14を参照)、ディスカッション・サーバーへのURL、およびサーバーとの接続に使用されるユーザー・アカウントが、ターゲット環境に対して正しいことを確認してください。

図7-14 ディスカッション・フォーラム接続の設定

「図7-14 ディスカッション・フォーラム接続の設定」の説明

WSRPプロデューサの場合、WSRPプロデューサ接続およびWebサービス接続がプロデューサごとに表示されます。通常、Webサービス接続のみターゲット・プロデューサに合せて変更する必要があります。これには4つのURLエンドポイントが含まれていますが、これらをすべて変更する必要があります。WSRPプロデューサ接続では、アプリケーション・サーバー用に、デフォルトのプロキシ設定とは個別に設定できるプロキシ設定のみ必要に応じて構成します。

EARファイルのポートレット・プロデューサへの接続を、ターゲット・デプロイ環境のプロデューサを指すように変更する必要がある場合、必ずここで変更してください。これで、アプリケーションが起動したときに、ポートレット・カスタマイズがターゲット・プロデューサにインポートされます。詳細は、第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照してください。

注意:

アプリケーションが初めて起動したときに、接続できるターゲット・プロデューサがなかった場合、インポートは失敗します。ポートレット・プロデューサに接続できるようになったら、アプリケーションを再起動してインポートを再実行してください。

「ADF接続の構成」ページを使用してプロデューサ接続を修正しないまま間違ったプロデューサの場所(例: 開発環境のプロデューサ)を指しており、そのプロデューサが接続可能な場合、ポートレットは間違ったプロデューサにインポートされます。

デプロイ後に修正するには、Fusion Middleware Control (第24.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第24.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第24.2.2項「WLSTを使用したWSRPプロデューサの登録」または第24.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用してプロデューサのURLエンドポイントを変更してから、アプリケーションを再デプロイしてください(第7.3.2項「Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ」を参照)。

13. 必要に応じて、Webモジュールなどの追加デプロイ・オプションを指定して、アプリケーションやセキュリティ移行設定に含めます。

14. オプションで、「デプロイ・プラン」セクションの「デプロイ・プランの編集」をクリックし、現在選択しているデプロイ・プランを編集します。

15. オプションで、「デプロイ・プラン」セクションの「デプロイ・プランの保存」をクリックし、アプリケーションを再デプロイするときに再利用できるように、現在選択しているデプロイ・プランを保存します。

16. デプロイ・プロセスを開始するには、「デプロイ」をクリックします。
Fusion Middleware Controlに処理メッセージが表示されます。

17. 「正常にデプロイされました」ページで「閉じる」をクリックします。
これで、Frameworkアプリケーション(およびそのデプロイ・プラン)が、WebLogic管理対象サーバー・インスタンスでデプロイされました。

18. Fusion Middleware Controlセッション中にアプリケーションをデプロイしたWebLogic管理対象サーバーを再起動する場合、「ファーム」メニューから「ファーム」をリフレッシュして、アプリケーションのステータスを更新します。

注意:

デプロイ時に接続を構成した場合、それらはデプロイ・プランの一部として格納されません。次回デプロイするときは、これらの接続詳細を再度指定する必要があります。

7.1.6.5 WLSTを使用したアプリケーションのデプロイ

WLSTコマンドラインを使用してFrameworkアプリケーションをデプロイするには、WLSTが管理サーバーと接続している必要があります。管理サーバーをホストしているコンピュータで、deployコマンドを起動する必要があります。

WLSTを使用してFrameworkアプリケーションをデプロイする手順は、次のとおりです。

1. WLSTシェルを起動します。
WLSTシェルの起動の詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_id:port")

各要素の意味は次のとおりです。

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: weblogic)。

- host_idは、管理サーバーのホストIDです(例: myserver.example.com)。

- portは、管理サーバーのポート番号です(デフォルトは7001)。
次のメッセージが表示されます。

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

3. 次のコマンドを実行して、MDS構成を取得します。

archive = getMDSArchiveConfig(fromLocation='ear_file_path')

ear_file_pathは、デプロイするEARファイルのパスとファイル名です(例: /tmp/myEarFile.ear)。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のgetMDSArchiveConfigコマンドに関する項を参照してください。

4. MDS構成情報をEARファイルから取得した後、WebCenter Portalの設定に応じて、適切なMDSスキーマ情報を設定する必要があります(たとえば、アプリケーションは、特定のスキーマに基づいたデータベース接続を使用している場合があります)。MDSスキーマ情報を設定するには、次のコマンドを実行してください。

archive.setAppMetadataRepository(repository='respository',partition='partition',type='DB',jndi='jndi')

各要素の意味は次のとおりです。

- repositoryは、データベース・スキーマの名前です(例: mds-Feb23demo)。

- partitionは、リポジトリ内の個々のエンティティです。これによって、各アプリケーションが独自のネームスペースを持つことができます(例: webcenter)。

- jndiは、アプリケーション・サーバーの他のコンポーネントによるアクセスを可能にするために使用するパスおよび名前です(例: jdbc/mds/Feb23demo)。

5. MDSリポジトリ情報を設定した後、次のコマンドを使用してMDS構成情報を保存します。

archive.save()

6. WLSTのdeployコマンドを使用して、Frameworkアプリケーションをデプロイします。

deploy(app_name, path, [targets] [stageMode], [planPath], [options])

各要素の意味は次のとおりです。

- appNameは、デプロイするFrameworkアプリケーションの名前です(例: composerWLSTApp)。

- pathは、デプロイするEARファイルへのパスです(例: /tmp/customApp.ear)。

- targetsには、アプリケーションのデプロイ先管理対象サーバーを指定します(例: CustomAppServer)。オプションで、カンマで区切れば複数のターゲットを指定できます。異なるサーバー上にアプリケーション・アーカイブの異なるモジュールをデプロイできるようにするには、たとえばmodule1@server1のように、各ターゲットをモジュール名で修飾します。この引数は、WLSTが現在接続されているサーバーにデフォルト設定されます。

- [stageMode]には、オプションで、デプロイするアプリケーションのステージング・モードを定義します。有効な値は、stage、nostageおよびexternal_stageです。

- [planPath]には、オプションで、デプロイ・プラン・ファイルの名前を定義します。ファイル名は、絶対名にすることも、アプリケーション・ディレクトリに対する相対名にすることもできます。この引数は、アプリケーション・ディレクトリ内のplan/plan.xmlファイル（存在する場合）にデフォルト設定されます。

- [options]は、オプションで、名前と値のペアとして指定したデプロイメント・オプションのカンマ区切りリストです。有効なオプションの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のWLSTのdeployコマンドに関する項を参照してください。

次のメッセージが表示されたら、アプリケーションが正常にデプロイされて、アクセスの準備ができたことを意味します。

Completed the deployment of Application with status completed

注意:

WLSTはデプロイ時に接続変更のプロンプトを表示しないため、EARファイルの接続情報を使用して、前回の起動時のターゲット・プロデューサの場所を特定します。その場所に到達できない場合、ターゲット・プロデューサの起動およびアプリケーションの再起動を行ってアプリケーションをデプロイした後に、場所を修正してください。ポートレット・カスタマイズの移行は自動的に開始されます。

プロデューサ接続が、接続可能な間違ったプロデューサを指している場合(たとえば、開発プロデューサ)、ポートレット・カスタマイズの移行はそれらのプロデューサを使用して開始されます。間違っていても移行は完了しているため、アプリケーションを再起動しても移行処理は自動的には起動されません。

デプロイ後にこれを修正するには、Fusion Middleware Control (第24.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第24.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第24.2.2項「WLSTを使用したWSRPプロデューサの登録」または第24.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用してプロデューサのURLエンドポイントを編集してから、アプリケーションを再デプロイしてください(第7.3.2項「Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ」を参照)。

7.1.6.6 WLS管理コンソールを使用したアプリケーションのデプロイ

WLS管理コンソールを使用すると、Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをデプロイできます。しかし、コンソールでは、基本的なMDS接続も含め、ADF接続を変更できません。このコンソールを使用してFrameworkアプリケーションをデプロイするには、EARファイルのMDS接続をターゲット・デプロイメント・リポジトリに合せて構成する必要があります。第7.1.6.5項「WLSTを使用したアプリケーションのデプロイ」の手順1-5を実行したら、次の手順を実行して、WLS管理コンソールからFrameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをデプロイしてください。

注意:

インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにFrameworkアプリケーションをデプロイすることはお薦めしません。JDeveloperで作成されたFrameworkアプリケーションの場合、デプロイする前に、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの既存ドメインの拡張に関する項の説明に従って、新しいWLS管理対象サーバーを作成してプロビジョニングしてください。ポートレット・プロデューサ・アプリケーションの場合、管理対象サーバー・インスタンスを作成するか、オプションでWC_Portletサーバーにデプロイできます。

WLS管理コンソールを使用してFrameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをデプロイする手順は、次のとおりです。

1. WLS管理コンソールにログインします。
WLS管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン」ペインで、「デプロイメント」をクリックします。
「デプロイ・サマリー」ペインが表示されます(図7-15を参照)。

図7-15 「デプロイ・サマリー」ペイン

「図7-15 「デプロイ・サマリー」ペイン」の説明

3. 「デプロイメント・サマリー」ペインで、「インストール」をクリックします。
「アプリケーション・インストール・アシスタント」ページが表示されます(図7-16を参照)。

図7-16 「アプリケーション・インストール・アシスタント」ページ

「図7-16 「アプリケーション・インストール・アシスタント」ページ」の説明

4. 「アプリケーション・インストール・アシスタント」の「パス」フィールドを使用して、インストールするWebアプリケーションまたはポートレット・プロデューサ・アプリケーションに対応するEARファイルを検索します。EARファイルを選択して、「次へ」をクリックします。
「アプリケーション・インストール・アシスタント」ページの2ページ目が表示されます(図7-17を参照)。

図7-17 「アプリケーション・インストール・アシスタント」 - 2ページ目

「図7-17 「アプリケーション・インストール・アシスタント」 - 2ページ目」の説明

5. 「このデプロイメントをアプリケーションとしてインストールする」(Frameworkアプリケーションとポートレット・プロデューサの両方用)を選択して、「次へ」をクリックします。
「アプリケーション・インストール・アシスタント」の3ページ目が表示されます(図7-18を参照)。

図7-18 「アプリケーション・インストール・アシスタント」 - 3ページ目

「図7-18 「アプリケーション・インストール・アシスタント」 - 3ページ目」の説明

6. Webアプリケーションのデプロイ先デプロイ・ターゲットを選択し、「次へ」をクリックします。

7. 指定した構成設定を確認し、「終了」をクリックしてインストールを完了します。
デプロイ後にプロデューサのURLを変更するには、Fusion Middleware Control (第24.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第24.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第24.2.2項「WLSTを使用したWSRPプロデューサの登録」または第24.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用してプロデューサのURLエンドポイントを編集してから、アプリケーションを再デプロイしてください(第7.3.2項「Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ」を参照)。

7.1.6.7 デプロイ・プランの保存と再利用

デプロイ・プランには、アーカイブを管理対象サーバーにデプロイするために必要な構成データが含まれています。アプリケーションを作成またはテストしている間、あるいは第7.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」で説明されているように、Fusion Middleware Controlを使用してEARファイルをデプロイするときに、デプロイ・プランを作成できます。EARファイル内にパッケージ化されたデプロイメント・ディスクリプタがある場合、デプロイはこれらのファイルのデータを使用します。web.xmlファイルを変更する必要がある場合、デプロイ・プランを作成することをお薦めします。

作成したら、デプロイ・プランを、アプリケーション・プロパティの一部としてターゲットの管理対象サーバーに保存しておけば、アプリケーションを再デプロイするときに再利用できます。再デプロイは、第7.3.2項「Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ」の説明に従ってFusion Middleware Controlを使用するか、第7.3.3項「WLSTを使用したFrameworkアプリケーションの再デプロイ」の説明に従ってWLSTを使用して行います。

7.1.7 カスタマイズおよびデータの環境間の移行

デプロイされたアプリケーションのページ、WebCenter Portalサービスおよびポートレット(PDK-JavaおよびWSRPバージョン2のプロデューサ)に対して行われたカスタマイズは、エクスポートおよびインポートできます。詳細は、第39章「データ移行のためのFrameworkアプリケーションのエクスポートおよびインポート」を参照してください。

7.1.8 分散環境で実行するためのアプリケーションの構成

分散環境で実行するためのFrameworkアプリケーションの構成の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド、および『Oracle Fusion Middleware高可用性ガイド』のOracle ADFおよびWebCenter Portalアプリケーションのための高可用性の構成に関する項を参照してください。

7.2 Frameworkアプリケーションのアンデプロイ

この項では、Fusion Middleware Controlを使用するか、WLSTを使用したコマンドラインから、Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをアンデプロイする方法について説明します。

注意:

Frameworkアプリケーションをアンデプロイしても、アプリケーションを同じドメインに再デプロイするときのために、そのアプリケーションの資格証明およびMDSカスタマイズは保持されます。アプリケーションをこのドメインに再デプロイしない場合、または次の再デプロイまでに初期状態にリセットする必要がある場合、第7.2.3項「アプリケーションの資格証明マップの削除」で説明されているように、アプリケーションをアンデプロイした後に、資格証明ストアからアプリケーションの資格証明マップを削除できます。また、『Oracle Fusion Middleware管理者ガイド』のリポジトリからメタデータ・パーティションの削除に関する項で説明されているように、MDSリポジトリ・パーティションを削除することもできます。

この項の内容は次のとおりです。

- 第7.2.1項「Fusion Middleware Controlを使用したFrameworkアプリケーションのアンデプロイ」

- 第7.2.2項「WLSTを使用したFrameworkアプリケーションのアンデプロイ」

- 第7.2.3項「アプリケーションの資格証明マップの削除」

7.2.1 Fusion Middleware Controlを使用したFrameworkアプリケーションのアンデプロイ

この項では、Fusion Middleware Controlを使用してFrameworkアプリケーションをアンデプロイする方法について説明します。

Fusion Middleware Controlを使用してFrameworkアプリケーションをアンデプロイする手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲーション・ペインで「アプリケーション・デプロイメント」を開き、アンデプロイするアプリケーションをクリックします。

3. 「アプリケーション・デプロイメント」メニューから、「アプリケーション・デプロイメント」→「アンデプロイ」を選択します。

4. 確認ページで「アンデプロイ」をクリックします。

5. 操作が完了したら、「閉じる」をクリックします。

7.2.2 WLSTを使用したFrameworkアプリケーションのアンデプロイ

この項では、WLSTを使用してFrameworkアプリケーションをアンデプロイする方法について説明します。

WLSTを使用してFrameworkアプリケーションをアンデプロイする手順は、次のとおりです。

1. WLSTシェルを起動します。
WLSTシェルの起動の詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_id:7001")

各要素の意味は次のとおりです。

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: weblogic)。

- host_idは、管理サーバーのホストIDです(例: myserver.example.com)。
次のメッセージが表示されます。

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

3. undeployコマンドを使用して、アプリケーションをアンデプロイします。

undeploy(app_name,[targets],[options])

各要素の意味は次のとおりです。

- app_nameは、デプロイされたアプリケーションのデプロイ名です。
[targets]は、アプリケーションを削除するターゲット・サーバーのリストです。これはオプションです。指定しなかった場合、デフォルトで、現在のすべてのターゲットが含まれます。

- [options]は、名前と値のペアとして指定されたデプロイ・オプションのカンマ区切りリストです。これはオプションです。すべてのオプションを表示するには、deployコマンドに関する項を参照してください。

7.2.3 アプリケーションの資格証明マップの削除

Frameworkアプリケーションをアンデプロイしても、そのアプリケーションの資格証明は削除されません。そのため、アンデプロイ後に、Fusion Middleware Controlを使用して、アプリケーションで使用された資格証明マップを手動で削除する必要があります。

Fusion Middleware Controlを使用してアプリケーションの資格証明マップを削除する手順は、次のとおりです。

1. アプリケーションのadf-config.xmlのコンテンツを参照し、adfAppUIDの値を確認して、そのアプリケーションによって使用された資格証明マップ名を特定します。次に例を示します。

<adf:adf-properties-child xmlns="http://xmlns.oracle.com/adf/config/properties">
<adf-property name="adfAppUID" value="Veeva-7209"/>
</adf:adf-properties-child>

この場合、アプリケーションによって使用された資格証明マップ名は、Veeva-7209です。

2. Fusion Middleware Controlにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

3. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、ターゲット・ドメイン(wc_domainなど)をクリックします。

4. 「WebLogicドメイン」ドロップダウン・メニューから、「セキュリティ」→「資格証明」を選択します。
「資格証明」ペインが表示されます(図7-19を参照)。

図7-19 「資格証明」ペイン

「図7-19 「資格証明」ペイン」の説明

5. 資格証明マップを選択し、「削除」をクリックします。

6. 「はい」をクリックして資格証明マップの削除を確定します。

7.3 Frameworkアプリケーションの再デプロイ

この項では、Fusion Middleware Controlを使用するか、WLSTを使用したコマンドラインから、Frameworkアプリケーションを再デプロイする方法について説明します。新しいバージョンのアプリケーションを再デプロイすると、次を変更できません。

- アプリケーションのデプロイ・ターゲット

- アプリケーションのセキュリティ・モデル

デプロイ・ターゲットまたはアプリケーションのセキュリティ設定を変更するには、アクティブなバージョンのアプリケーションを最初にアンデプロイする必要があります。アプリケーションをアンデプロイする方法の詳細は、第7.2項「Frameworkアプリケーションのアンデプロイ」を参照してください。

注意:

wcps-services.earおよびwsrp-tools-as.earなどのシステム.EARファイルの中には、バージョニングされずに、再デプロイが意図されていないものもあります。これらのファイルを再デプロイするとエラーが発生します。

この項の内容は次のとおりです。

- 第7.3.1項「再デプロイに関する考慮事項」

- 第7.3.2項「Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ」

- 第7.3.3項「WLSTを使用したFrameworkアプリケーションの再デプロイ」

7.3.1 再デプロイに関する考慮事項

アプリケーションを再デプロイするとき、アプリケーション・データへの変更は保持しようと考える場合がほとんどです。デプロイ後の実行時に、アプリケーションに関する3つの重要な情報が変更することがあります。

- アプリケーション構成: 接続情報が含まれます。

- アプリケーション・メタデータ: アプリケーション自体に対するカスタマイズおよびパーソナライズが含まれます。これらは、ユーザーがページを編集してコンテンツを追加するなどしたときに作成されます。

- ポートレット・プリファレンス: ポートレット・インスタンスのカスタマイズおよびパーソナライズが含まれます。

注意:

ページ、接続またはタスク・フローなどのアーティファクトに大規模な変更が加えられた更新アプリケーションを再デプロイする前に、ランタイム・カスタマイズ(JDeveloperを使用しないカスタマイズ)を削除する必要があります。

次の項では、アプリケーションに関するこれら3種類の情報を保持する方法について説明します。

- 第7.3.1.1項「アプリケーション構成の保持」

- 第7.3.1.2項「サービスおよびユーザー・カスタマイズの保持」

- 第7.3.1.3項「リソース・カスタマイズの保持」

- 第7.3.1.4項「ポートレット・カスタマイズの保持」

注意:

アプリケーション情報を保持するには、初期デプロイを使用して作成または使用された同じMDSパーティションを使用して再デプロイする必要があります。

7.3.1.1 アプリケーション構成の保持

ほとんどの場合、サービスのエンドポイントおよびポートレット・プロデューサは、本番環境よりもテスト環境またはステージング環境で異なります。そのため、アプリケーションを本番環境に再デプロイするとき、アプリケーションを再構成して、本番環境のサービスおよびプロデューサで稼働できるようにするか、以前使用された構成を再利用できるようにする必要があります。Fusion Middlewareは、MDSリポジトリに構成情報を格納することによってこれを容易にします。

アプリケーションを初めてデプロイしたとき、アプリケーション構成のベース・ドキュメントがMDSリポジトリに作成されます。この構成は、EARファイルにパッケージ化されている、アプリケーションの接続およびそれらのプロパティのすべてが含まれたセットです。デプロイ後は、本番環境の仕様に合せて、Fusion Middleware ControlまたはWLSTを使用して接続を編集する必要がある場合があります。この再構成によって、構成変更のためのカスタマイズのレイヤーがMDSリポジトリに作成されます。

アプリケーションを再デプロイすると、アプリケーションでパッケージ化された構成がベース・ドキュメントとして使用されますが、構成へのカスタマイズは保持されます。したがって、アプリケーションの再デプロイ設定は最新の構成と一致します。

ただし、カスタマイズが完全に保持されるのは、ベース・ドキュメントに変更がない場合のみです。パッケージ化された接続情報が変更されたアプリケーションを再デプロイすると、次の結果が予想されます。

- パッケージ化された構成に新しい接続が追加されます。
新しい接続は問題なく表示されます。

- パッケージ化された構成から接続が削除されます。
前回のデプロイ後にこの接続を構成した場合、デプロイ後にこの接続は表示されないため再作成する必要があります。

- パッケージ化された構成で接続プロパティが変更されます。
カスタマイズされたプロパティが使用されます。接続のカスタマイズは、プロパティ・レベルではなく、個々の接続レベルで管理されます。

7.3.1.1.1 WLSTを使用したデプロイ時の構成の保持

WLSTコマンドを使用してFrameworkアプリケーションを構成する場合、それらをまとめて、本番インスタンスの構成用にすべての接続を削除して再作成する単一スクリプトを簡単に作成できます。このアプローチを使用すれば、パッケージ化された構成の詳細を知らなくても、ターゲットの構成に合せてアプリケーションを常に再構成できます。

7.3.1.2 サービスおよびユーザー・カスタマイズの保持

アプリケーション・メタデータは、デプロイ後の実行時にユーザーが行ったカスタマイズによって変更されます。ほとんどの場合、アプリケーションを再デプロイするとき、以前にユーザーに表示されていた環境を正確に再現できるようにカスタマイズ情報を保持する必要があります。

アプリケーションおよびユーザー・カスタマイズはMDSリポジトリに格納され、構成設定の保持に関するルールがアプリケーション・メタデータの保持にも適用します。

アプリケーションが再デプロイされると、すべてのアプリケーション・アーティファクトのベース・ドキュメントは、EARファイルにパッケージ化されているもので置換されます。ただし、カスタマイズは保持されます。ベース・アーティファクトが変更されないかぎり、この情報への影響はありません。その場合、構成設定と同じルールが適用されます。これらを次に説明します。

- 新しい要素がパッケージに追加された場合、そのまま表示されます。

- 作成されたカスタマイズの要素がパッケージから削除された場合、それらのカスタマイズは無視されます。

- 要素が変更された場合、その影響は変更内容によって異なるため、検証する必要があります。

ベスト・プラクティスに関する注意:

状況に応じて、本番アプリケーションのインスタンスにあるすべてのアプリケーションおよびユーザー・カスタマイズをエクスポートして、テストまたはステージングのインスタンスにインポートしてください。その後、それらのカスタマイズに対してアプリケーションをテストすれば、新しい変更によって意図しない影響が発生するかどうかを確認できます。

7.3.1.3 リソース・カスタマイズの保持

リソース・マネージャを使用すれば、ユーザーは実行時に新しいリソースを作成できます。アプリケーションを再デプロイするとき、実行時に作成されたリソースを保持するには、再デプロイ前に、まず実行中のアプリケーションからリソースをダウンロードして、そのアーカイブ・ファイルをデザインタイム環境にインポートする必要があります。

実行時に作成されたリソースのダウンロードとインポートを実行しなかった場合、アプリケーションを再デプロイすると失われます。リソース・マネージャではそれらは使用できませんが、失われたリソースを使用し実行時に作成された新しいページは使用できます。これは、新しいリソースが作成されると実行時に更新されるgeneric-site-resources.xmlファイルが、デザインタイム・バージョンのファイルによって、再デプロイ時に上書きされるためです。

7.3.1.4 ポートレット・カスタマイズの保持

ポートレット・カスタマイズは、メタデータでEARファイルにパッケージ化されます。デプロイ後にアプリケーションを起動すると、ターゲット・プロデューサへのポートレット・カスタマイズの移行が開始します。ターゲット・プロデューサは、接続カスタマイズの解決によって特定されます。再デプロイ前にプロデューサ接続を編集した場合、編集された接続がターゲット・プロデューサの特定に使用されます。事前に存在するファイルと同じチェックサム(つまり同じファイル)のEARファイルを再デプロイすると、ポートレット・カスタマイズおよびパーソナライズは上書きされません。

7.3.2 Fusion Middleware Controlを使用したFrameworkアプリケーションの再デプロイ

この項では、Fusion Middleware Controlを使用してFrameworkアプリケーションを再デプロイする方法について説明します。

Fusion Middleware Controlを使用してFrameworkアプリケーションを再デプロイする手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。詳細は、第6.1項「Fusion Middleware Controlの表示」を参照してください。

2. ナビゲーション・ペインから、ファーム、「WebLogicドメイン」、続いてドメインを開きます。

3. アプリケーションの再デプロイ先サーバーを選択し、右クリックしてメニューから「アプリケーション・デプロイメント - 再デプロイ」を選択します。
「アプリケーションの選択」ページが表示されます(図7-20を参照)。

図7-20 「アプリケーションの選択」ページ

「図7-20 「アプリケーションの選択」ページ」の説明

4. 再デプロイするアプリケーションを選択します。

5. 「次へ」をクリックし、「アーカイブの選択」ページを表示します(図7-21を参照)。

図7-21 「アーカイブの選択」ページ

「図7-21 「アーカイブの選択」ページ」の説明

6. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを実行します。

- 「アーカイブはこのWebブラウザが稼働しているマシンに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

- 「アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

7. 「デプロイ・プラン」セクションで、次のいずれかを実行します。

- 「デプロイ構成が行われるとき、新規デプロイ・プランを作成します。」を選択し、再デプロイ処理の後にデプロイ・プランを自動的に作成します。

- 「デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

- 「デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

8. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます(図7-22を参照)。

図7-22 「アプリケーション属性」ページ

「図7-22 「アプリケーション属性」ページ」の説明

9. application.xmlにアプリケーションのコンテキスト・ルートを指定しなかった場合、「Webモジュールのコンテキスト・ルート」セクションで指定します。コンテキスト・ルートはWebモジュールのURIです。Webサービスを含む各WebモジュールまたはEJBモジュールには、コンテキスト・ルートが存在する場合があります。

10. 「ターゲット・メタデータ・リポジトリ」セクションで、MDSリポジトリを選択し、「パーティション」に入力します。

注意:

最初にアプリケーションをデプロイしたときに使用したリポジトリ接続およびパーティション名を使用してください。そうしなければ、すべてのカスタマイズは失われます。

11. 「次へ」をクリックします。
「デプロイ設定」ページが表示されます(図7-23を参照)。

図7-23 「デプロイ設定」ページ

「図7-23 「デプロイ設定」ページ」の説明

12. このページでは、アプリケーションをデプロイする前に、接続を構成するなどの共通タスクを実行したり、デプロイ・プランを編集したり、ディスクに保存できます。次を実行できます。

- Webモジュールの構成

- アプリケーション・ロールおよびポリシー用のアプリケーション・セキュリティを構成します。

- ADF接続設定の構成

13. 「ADF接続の構成」の「編集」アイコンをクリックして、Frameworkアプリケーションに関連付けられた接続設定をチェックします。

注意:

ADF接続の編集は、前回デプロイした後に設定されていない接続に対してのみ必要です。前回デプロイした後に構成された接続は、この手順で指定された設定を上書きします。

「ADF接続の構成」ページが表示されます(図7-24を参照)。

図7-24 「ADF接続の構成」ページ

「図7-24 「ADF接続の構成」ページ」の説明

14. 接続ごとに「編集」アイコンをクリックして、接続設定がターゲット環境に対して正しいことを確認します(本番やステージングなど)。
たとえば、ディスカッション・フォーラム接続の場合(図7-14を参照)、ディスカッション・サーバーへのURL、およびサーバーとの接続に使用されるユーザー・アカウントが、ターゲット環境に対して正しいことを確認してください。

図7-25 ディスカッション・フォーラム接続の設定

「図7-25 ディスカッション・フォーラム接続の設定」の説明

15. 必要に応じて、Webモジュールなどの追加デプロイ・オプションを指定して、アプリケーションやセキュリティ移行設定に含めます。

16. 「デプロイ・プラン」を開きます。
「デプロイ・プラン」設定が表示されます(図7-26を参照)。

図7-26 「デプロイ設定」ページ - 「デプロイ・プラン」セクション

「図7-26 「デプロイ設定」ページ - 「デプロイ・プラン」セクション」の説明

必要に応じて、デプロイ・プランを編集してローカル・ハード・ドライブに保存しておけば、後でアプリケーションを再デプロイするときにこれらの設定を再利用できます。デプロイ・プランの詳細は、第7.1.6.7項「デプロイ・プランの保存と再利用」を参照してください。

17. 「再デプロイ」をクリックします。

18. 再デプロイが完了したら、「閉じる」をクリックします。

注意:

Fusion Middleware Controlセッション中にアプリケーションをデプロイしたWebLogic管理対象サーバーを再起動する場合、「ファーム」メニューから「ファーム」をリフレッシュして、アプリケーションのステータスを更新します。

7.3.3 WLSTを使用したFrameworkアプリケーションの再デプロイ

WLSTコマンドラインを使用してFrameworkアプリケーションを再デプロイするには、WLSTが管理サーバーと接続している必要があります。管理サーバーをホストしているコンピュータで、redeployコマンドを起動する必要があります。

WLSTを使用してFrameworkアプリケーションを再デプロイする手順は、次のとおりです。

1. WLSTシェルを起動します。
WLSTシェルの起動の詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_id:port")

各要素の意味は次のとおりです。

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: weblogic)。

- host_idは、管理サーバーのホストIDです(例: myserver.example.com)。

- portは、管理サーバーのポート番号です(デフォルトは7001)。
次のメッセージが表示されます。

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

3. redeployコマンドを使用して、アプリケーションを再デプロイします。

redeploy(app_name,[planPath],[options])

各要素の意味は次のとおりです。

- app_nameは、再デプロイするアプリケーションのデプロイ名です。

- [planPath]は、デプロイ・プラン・ファイルの名前です。このファイル名には、アプリケーション・ディレクトリへの絶対パスまたは相対パスのどちらでも指定できます。これはオプションです。この引数のデフォルトは、アプリケーション・ディレクトリのplan/plan.xmlファイル(存在する場合)です。

- [options]は、名前と値のペアとして指定されたデプロイ・オプションのカンマ区切りリストです。これはオプションです。すべてのオプションを表示するには、deployコマンドに関する項を参照してください。

7.4 デプロイ後の構成

Frameworkアプリケーションがデプロイされたら、デプロイされた設定が、ターゲットの管理対象サーバーに対して有効かどうかを確認する必要があります。確認の対象設定は、セキュリティ、接続およびデータ・ソースの設定です。

この項の内容は次のとおりです。

- 第7.4.1項「デプロイ後のセキュリティ構成の確認」

- 第7.4.2項「デプロイ後のアプリケーション接続の確認」

- 第7.4.3項「データ・ソース接続の確認」

- 第7.4.4項「アプリケーションのチューニング」

7.4.1 デプロイ後のセキュリティ構成の確認

アプリケーションをデプロイする前に、ターゲットの管理対象サーバーで、アイデンティティ・ストア、ポリシーおよび資格情報ストアを設定する必要があります。デプロイ後は、アプリケーション構成がターゲット・サーバーの構成に一致することを確認してください。また、第28.2.5項「デプロイ後のセキュリティ構成タスク」で説明されているように、SSLおよびシングル・サインオンなど、デプロイ後に適用可能な他のすべてのセキュリティ構成が適切に構成されていることも確認してください。

7.4.2 デプロイ後のアプリケーション接続の確認

Frameworkアプリケーションをデプロイした後、アプリケーションによって使用されるすべての接続が適切に設定されていることを確認してください。構成または再構成する必要があると考えられる接続は、次のとおりです。

- BPELワークリスト

- 外部アプリケーション

- ディスカッション・サーバー

- メール・サーバー

- インスタント・メッセージおよびプレゼンス(IMP)サーバー

- 検索

- WSRPプロデューサ

- PDK-Javaポートレット・プロデューサ

- Webサービス

- コンテンツ・リポジトリ

- 個人イベント・サーバー

- 分析コレクタ

7.4.3 データ・ソース接続の確認

Frameworkアプリケーションをカスタム管理対象サーバーにデプロイした後、テスト時に構成したデータ・ソースが、デプロイしたアプリケーションに対して有効かどうかを確認してください。FrameworkアプリケーションでMetadata Service (MDS)リポジトリ用のデータ・ソースを構成する方法の詳細は、Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理のJDBCデータ・ソースの構成に関する項を参照してください。データ・ソースを設定するとき、パスワードを指定する必要があります。指定しないと、アプリケーションをデプロイするときに接続が作成されない可能性があります。

7.4.4 アプリケーションのチューニング

Frameworkアプリケーションをデプロイして適切に構成した後、第A.4項「Oracle WebCenter Portalのパフォーマンスのチューニング」で説明されているように、システム・ファイルの制限、データ・ソース設定およびJRockit仮想マシン(JVM)の引数を確認してください。また、パフォーマンス問題の診断方法の詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』の「Oracle WebCenter Portalのパフォーマンスの調整」、および第38章「Oracle WebCenter Portalのパフォーマンスの監視」も参照してください。

8 WebCenter Portalアプリケーションの起動および停止

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portalアプリケーション構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。たとえば、お知らせ、ディスカッション、ドキュメントおよびメールなどのWebCenter Portalサービスの接続詳細を追加または変更したら、アプリケーションの対象管理サーバーを再起動する必要があります。

例外もいくつかあります。ポートレット・プロデューサおよび外部アプリケーションの登録は動的です。登録した新規ポートレット・プロデューサや外部アプリケーションは、WebCenter Portalアプリケーションで即座に使用可能になります。既存の接続に対して行った変更も即座に有効になります。

この章の内容は次のとおりです。

- 第8.1項「ノード・マネージャの起動」

- 第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」

- 第8.3項「Spacesアプリケーションの起動および停止」

- 第8.4項「Frameworkアプリケーションの起動および停止」

すべての起動および停止操作は、Oracle WebLogic Server管理コンソールからも実行できます。Oracle Fusion Middleware Oracle WebLogic Serverサーバーの起動および停止の管理のサーバーの起動および停止に関する項も参照してください。

注意:

Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用して、管理サーバー、管理対象サーバーおよびWebCenter Portalアプリケーションを起動および停止する前に、ノード・マネージャは実行している必要があります。

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

8.1 ノード・マネージャの起動

Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用して、管理サーバー、管理対象サーバーおよびWebCenter Portalアプリケーションを起動および停止する前に、ノード・マネージャは実行している必要があります。ノード・マネージャはインストールの後に起動されるため、ノード・マネージャを再起動する必要があるのは意図的に停止された場合のみです。

startNodeManager.shを使用してノード・マネージャを起動する方法の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverノード・マネージャ管理者ガイドのノード・マネージャの使用方法に関する項を参照してください。

8.2 WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portal構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

管理対象サーバーを起動または再起動すると、その管理対象サーバーにデプロイされているすべてのアプリケーションは自動的に起動します。詳細は、表8-1も参照してください。

表8-1 Oracle WebCenter Portal管理対象サーバーおよびアプリケーション

管理対象サーバー

アプリケーション

WC_Spaces

webcenter (Spacesアプリケーション)

webcenter-help (Spacesオンライン・ヘルプ)

WC_Portlet

portalTools (OmniPortletおよびWeb Clipping)

wsrp-tools (WSRPツール)

pagelet-producer (ページレット・プロデューサ)

services-producer (WebCenterサービス・プロデューサ)

WC_Collaboration

owc_discussions (ディスカッション・サーバー)

WC_Utilities

analytics-collector (分析)

activitygraph-engines (アクティビティ・グラフ)

wcps-services (パーソナライズ・サービス)

WC_CustomPortal

<WebCenter_Portal_Frameworkアプリケーション名>

注意:

この項の説明は、表8-1に示すWebCenter Portal管理対象サーバーの起動および停止手順です。他のコンポーネントの管理対象サーバーを起動および停止するには、次を参照してください。

- Oracle WebCenter Content管理対象サーバーは、Oracle WebCenter Contentインストレーション・ガイドを参照してください。

- Oracle SOA Server管理対象サーバーは、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイドを参照してください。

管理対象サーバーに特定の起動順序はありませんが、複数の管理対象サーバーを起動する必要がある場合、SpacesまたはFrameworkのアプリケーションがデプロイされている管理サーバーを最後に起動することをお薦めします。

Fusion Middleware Controlを使用してWebCenter Portal管理対象サーバーを起動、停止または再起動する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。

2. 「ターゲット・ナビゲーション・ペイン」で、「WebLogicドメイン」を開きます。

3. 「wc_domain」を開き、起動または停止する管理対象サーバーを選択します。
管理対象サーバーのホームページが表示されます(図8-2)。

図8-1 管理対象サーバーのホームページ

4. 「WebLogic Server」メニュー:

- 管理対象サーバーを起動するには、「制御」→「起動」を選択します。

- 管理対象サーバーを停止するには、「制御」→「停止」を選択します。

図8-2 管理対象サーバーの起動または停止

あるいは、「ターゲット・ナビゲーション・ペイン」で管理対象サーバーの名前を右クリックして、管理対象サーバーのメニュー・オプションにアクセスします。

コマンドライン・ツールを使用してWebCenter Portal管理対象サーバーを起動または停止するには、『Oracle Fusion Middleware管理者ガイド』のコマンドラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

8.3 Spacesアプリケーションの起動および停止

Fusion Middleware ControlからSpacesを起動、再起動および停止する操作は簡単です。

- Fusion Middleware Controlを使用したSpacesの起動

- Fusion Middleware Controlを使用したSpacesの停止

あるいは、WLSTを使用することもできます。

- WLSTを使用したSpacesの起動

- WLSTを使用したSpacesの停止

Oracle WebLogic Server管理コンソールを使用してSpacesを起動することもできます。

注意:

アプリケーション構成を変更したら、SpacesがデプロイされているWC_Spaces管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

8.3.1 Fusion Middleware Controlを使用したSpacesの起動

Spacesを起動すると、ユーザーがアプリケーションを使用できるようになり、停止すると使用できなくなります。

Fusion Middleware Controlを使用してSpacesを起動する手順は、次のとおりです。

1. Fusion Middleware Controlで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. WebCenter Portalのメイン・メニューから、「WebCenter」→「ポータル」→「制御」→「起動」を選択します。
あるいは、「WC_Spaces」を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

進行状況メッセージが表示されます。

3. 「閉じる」をクリックします。

アプリケーションのステータスが「稼働中」(緑色の矢印)に変化する様子に注意してください。

8.3.2 WLSTを使用したSpacesの起動

WLSTコマンドのstartApplicationを使用して、Spacesを起動します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstartApplicationに関する項を参照してください。

Spacesアプリケーションの場合、appName引数は必ずwebcenterになります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

8.3.3 Fusion Middleware Controlを使用したSpacesの停止

Spacesアプリケーションを停止すると、使用できなくなります。アプリケーションを停止してもそのソース・ファイルはサーバーから削除されません。停止したアプリケーションを後で再起動すると、再び利用できます。

Spacesを停止しても、Spacesアプリケーションがデプロイされている管理対象サーバー(WC_Spaces)は引き続き使用できます。

Fusion Middleware Controlを使用してSpacesアプリケーションを停止する手順は、次のとおりです。

1. Fusion Middleware Controlで、Spacesのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. メイン・メニューから、「WebCenter」→「ポータル」→「制御」→「停止」を選択します。
あるいは、「WC_Spaces」を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

3. 「OK」をクリックして続行します。
進行状況メッセージが表示されます。

4. 「閉じる」をクリックします。

ステータスが「停止中」(赤色の矢印)に変化する様子に注意してください。

8.3.4 WLSTを使用したSpacesの停止

WLSTコマンドのstopApplicationを使用して、Spacesアプリケーションを停止します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstopApplicationに関する項を参照してください。

Spacesアプリケーションの場合、appName引数は必ずwebcenterになります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

8.4 Frameworkアプリケーションの起動および停止

Fusion Middleware ControlからFrameworkアプリケーションを起動および停止する操作は簡単です。

- Fusion Middleware Controlを使用したFrameworkアプリケーションの起動

- Fusion Middleware Controlを使用したFrameworkアプリケーションの停止

あるいは、WLSTを使用することもできます。

- WLSTを使用したFrameworkアプリケーションの起動

- WLSTを使用したFrameworkアプリケーションの停止

Oracle WebLogic Server管理コンソールを使用してFrameworkアプリケーションを起動することもできます。

注意:

アプリケーション構成を変更したら、Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

8.4.1 Fusion Middleware Controlを使用したFrameworkアプリケーションの起動

Frameworkアプリケーションを起動すると、ユーザーが使用できるようになり、停止すると使用できなくなります。

Frameworkアプリケーションを停止しても、それがデプロイされている管理対象サーバーは引き続き使用できます。

Fusion Middleware Controlを使用してFrameworkアプリケーションを起動する手順は、次のとおりです。

1. Fusion Middleware Controlで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーション・デプロイメント」メニューから、「アプリケーション・デプロイメント」→「制御」→「起動」を選択します。
あるいは、Frameworkアプリケーションの名前を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

進行状況メッセージが表示されます。

3. 「閉じる」をクリックします。

アプリケーションのステータスが「稼働中」(緑色の矢印)に変化する様子に注意してください。

8.4.2 WLSTを使用したFrameworkアプリケーションの起動

WLSTコマンドのstartApplicationを使用して、Frameworkアプリケーションを起動します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstartApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

8.4.3 Fusion Middleware Controlを使用したFrameworkアプリケーションの停止

Frameworkアプリケーションを停止すると、使用できなくなります。アプリケーションを停止してもそのソース・ファイルはサーバーから削除されません。停止したアプリケーションを後で再起動すると、再び利用できます。

注意:

Oracle WebLogic Server管理コンソールを使用してWebCenter Portal: Spacesを停止することもできます。

Frameworkアプリケーションを停止する手順は、次のとおりです。

1. Fusion Middleware Controlで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. メイン・メニューから、「アプリケーション・デプロイメント」→「制御」→「停止」を選択します。
あるいは、Frameworkアプリケーションの名前を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

3. 「OK」をクリックして続行します。
進行状況メッセージが表示されます。

4. 「閉じる」をクリックします。

ステータスが「停止中」(赤色の矢印)に変化する様子に注意してください。

8.4.4 WLSTを使用したFrameworkアプリケーションの停止

WLSTコマンドのstopApplicationを使用して、Frameworkアプリケーションを停止します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstopApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

9 WebCenter Portalアプリケーションのプロパティの設定

この章の内容は次のとおりです。

- 第9.1項「Spacesアプリケーションのアプリケーション・プロパティの設定」

- 第9.2項「Frameworkアプリケーションのアプリケーション・プロパティの設定」

- 第9.3項「SpacesワークフローをホスティングするBPELサーバーの指定」

- 第9.4項「検索クローラの構成」

- 第9.5項「検索オプションの設定」

- 第9.6項「通知メッセージのチャネルの選択」

- 第9.7項「プロキシ・サーバーの設定」

- 第9.8項「前のリリースからSpacesテンプレートを公開」

- 第9.9項「Spacesアプリケーションのセッション・タイムアウトの設定」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

9.1 Spacesアプリケーションのアプリケーション・プロパティの設定

Spacesアプリケーションのデプロイを構成するための最初のページは、Spacesホームページ(Fusion Middleware Control内)です。他のJ2EEアプリケーションと同様に、ADF、MDS、セキュリティ・ポリシーおよびロールの構成などをここでできます。また、Spacesアプリケーションのバックエンド・サービス接続、外部アプリケーションおよびポートレット・プロデューサの構成もできます。このページにアクセスするには、第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

さらに、SpacesワークフローおよびOracle SES検索クローリングをSpacesで構成するための、アプリケーションレベル設定もいくつかあります。アプリケーション設定は、次の各項で説明します。

- 第9.3項「SpacesワークフローをホスティングするBPELサーバーの指定」

- 第9.4項「検索クローラの構成」

- 第9.5項「検索オプションの設定」

- 第9.6項「通知メッセージのチャネルの選択」

- 第9.7項「プロキシ・サーバーの設定」

- 第9.8項「前のリリースからSpacesテンプレートを公開」

- 第9.9項「Spacesアプリケーションのセッション・タイムアウトの設定」

9.2 Frameworkアプリケーションのアプリケーション・プロパティの設定

WebCenter Portal: Frameworkで開発されたアプリケーション・デプロイメントを構成するための最初のページは、「J2EEアプリケーションのデプロイ」ホームページ(Fusion Middleware Control内)です。他のJ2EEアプリケーションと同様に、ADF、MDS、セキュリティ・ポリシーおよびロールの構成などをここでできます。また、バックエンド・サービス接続、外部アプリケーションおよびポートレット・プロデューサの構成もできます。このページにアクセスするには、第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

さらに、プロキシ・サーバー、検索設定およびFrameworkアプリケーションの通知チャネルを構成するためのアプリケーションレベル設定もいくつかあります。アプリケーション設定は、次の各項で説明します。

- 第9.4項「検索クローラの構成」

- 第9.5項「検索オプションの設定」

- 第9.6項「通知メッセージのチャネルの選択」

- 第9.7項「プロキシ・サーバーの設定」

付録A「Oracle WebCenter Portalのパフォーマンスの調整」も参照してください。

9.3 SpacesワークフローをホスティングするBPELサーバーの指定

Spacesは、Oracle SOA Suiteに付属するBPELサーバーを使用して、スペース・メンバーシップ通知やスペース・サブスクリプション・リクエストなどの内部ワークフローをホストします。Spacesアプリケーション内のワークフロー機能を有効化するには、BPELサーバーとの接続が必要です。

注意:

使用するようにSpacesが構成されているSOA管理対象サーバーにSpacesワークフローをデプロイする必要があります。Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドのSpacesワークフローのバックエンド要件に関する項も参照してください。

Spacesワークフローとの接続を構成する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portal: Spacesのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

図9-1 SpacesワークフローをデプロイするBPELサーバーの選択

3. 「接続名」ドロップダウンから、必要な接続名を選択します。
選択可能な接続は、Spacesでワークリスト・サービスに対して現在構成されている接続です。

必ず、SpacesワークフローがデプロイされているSOAインスタンスを指す接続を選択してください。その接続がリストにない場合は作成する必要があります。接続を定義するには、第23.4項「ワークリスト接続の設定」を参照してください。

4. 「適用」をクリックします。

5. 変更を有効にするために、Spacesアプリケーションがデプロイされる管理対象サーバーを再起動します。
第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

9.4 検索クローラの構成

デプロイした後、管理者は、SpacesまたはそれらのFrameworkアプリケーションのための検索クローラを構成できます。SpacesおよびFrameworkのアプリケーションは、Oracle Secure Enterprise Search (SES)またはWebCenter Portal独自の検索アダプタのどちらかを使用できます。Spacesアプリケーション用の検索クローラ構成は、他のFrameworkアプリケーションとは少し異なるため、自分のアプリケーションに適したドキュメントを参照してください。

Spacesアプリケーション

出荷時には、Spacesアプリケーションは、Spacesコンテンツを検索して返すためにWebCenter Portal独自の検索サービスを使用します。必要に応じてOracle Secure Enterprise Search (SES)を使用すれば、ドキュメント、ディスカッション、お知らせ、スペース、リスト、ページ、WikiおよびブログなどのほとんどのSpacesリソースを検索して、統合した結果を返すことができます。Oracle SES検索を設定するには、第22.6項「Spacesアプリケーションを検索するためのOracle SESの構成」を参照してください。

Frameworkアプリケーション

デフォルトでは、Frameworkアプリケーションは、Oracle SESクローラを使用するように構成されています。Oracle SESを使用しない場合、かわりにWebCenter Portal独自の検索アダプタを使用するように指定できます。詳細は、第22.5項「Frameworkアプリケーションを検索するためのOracle SESの構成」を参照してください。

9.5 検索オプションの設定

デプロイした後、管理者は、WebCenter Portalアプリケーションに適した検索設定を詳細にチューニングできます。たとえば、適切な検索タイムアウトの設定や、検索結果を返して表示する対象の数の指定などです。

注意:

次の手順では、Fusion Middleware Controlを使用して検索オプションを設定する方法について説明します。WLSTコマンドを使用して同じオプションを設定できますが、詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

Fusion Middleware Controlを使用して検索パラメータを設定する手順は、次のとおりです。

1. Fusion Middleware Controlにログインして、WebCenter Portalアプリケーションのホームページに移動します。
第6.2項「スペース・アプリケーションのホームページへの移動」

第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 必要に応じて、「検索設定」を構成します。

要素

説明

Oracle Secure Enterprise Searchデータ・グループ

検索するOracle SESデータ・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

実行タイムアウト(ミリ秒)

サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

実行者の準備タイムアウト(ミリ秒)

サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

サービス当たりの結果数 - 保存済検索タスク・フロー

サービスごとに保存済検索タスク・フローに表示する検索結果の数を入力します。

サービス当たりの結果数 - 検索ページ

メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

検索ページの保存済の検索の数

「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

4. 「適用」をクリックします。

5. 変更を有効にするために、Spacesアプリケーションがデプロイされる管理対象サーバーを再起動します。
第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

9.6 通知メッセージのチャネルの選択

SpacesおよびFrameworkのアプリケーションでは、ユーザーは、特に興味のあるサービスやアプリケーションのオブジェクトをサブスクライブできます。そのため、サブスクライブしたサービスやオブジェクトに影響のある変更や更新がユーザーに通知されます。

通知メッセージは、BPELサーバーまたはメール・サーバーを使用してルーティングできます。使用されるチャネルは、システム管理者が構成します。詳細は、第19.2「通知の設定」を参照してください。

9.7 プロキシ・サーバーの設定

外部RSSニュース・フィードおよび外部リンクをWebCenter Portalアプリケーションでアクティビティ・ストリームのタスク・フローで有効化するには、プロキシ・サーバーが必要です。RSSサービスおよびアクティビティ・ストリーム・サービスは、同じプロキシ・サーバー設定を共有します。

プロキシ・サーバーは、Fusion Middleware ControlまたはWLSTを使用して設定できます。

この項の内容は次のとおりです。

- 第9.7.1項「Fusion Middleware Controlを使用したプロキシ・サーバーの設定」

- 第9.7.2項「WLSTを使用したプロキシ・サーバーの設定」

9.7.1 Fusion Middleware Controlを使用したプロキシ・サーバーの設定

Fusion Middleware Controlを使用してプロキシ・サーバーを設定する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページにナビゲートします。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「アプリケーション構成」を選択します。

3. 「プロキシ・サーバー」セクションに、プロキシ・サーバーのホスト名とポート番号を入力します。詳細は、表9-1を参照してください。

表9-1 RSSプロキシ・サーバーの詳細

フィールド

説明

プロキシ・ホスト

プロキシ・サーバーのホスト名を入力します。

プロキシ・ポート

プロキシ・サーバーが実行されているポート番号を入力します。

4. 「適用」をクリックして、この接続を保存します。

5. WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動します。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

9.7.2 WLSTを使用したプロキシ・サーバーの設定

WLSTコマンドsetRssProxyConfigを使用して、RSSニュース・フィードおよびアクティビティ・ストリーム・タスク・フローによって使用されるプロキシ・ホストおよびポート番号を指定します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetRssProxyConfigに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しいプロキシ詳細を使用して起動するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

getRssProxyConfigコマンドを使用して、RSSおよびアクティビティ・ストリーム・タスク・フローによって使用されている現在のプロキシ・ホストおよびポートを検出します。プロキシ・ホストおよびポートの現在の設定を削除する場合、unsetRssProxyConfigコマンドを使用します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のRSSニュース・フィードに関する項を参照してください。

9.8 前のリリースからSpacesテンプレートを公開

出荷時には、Spacesアプリケーションに、「チーム・サイト」、「ポータル・サイト」、「ドキュメント交換」など、スペースを作成するための複数のテンプレートが含まれています。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpacesテンプレートでの作業に関する項を参照してください。

Spacesの前のリリースでは、「基本」、「関心のあるコミュニティ」および「グループ・プロジェクト」という異なるテンプレート・セットが提供されていました。これらのテンプレートの使用は非推奨ですが、次の手順を実行すると、これらを最新のSpacesバージョンで公開できます。

1. WebCenter PortalデータベースのDBAまたは別の管理ユーザーとして、SQLPlusにログインします。

2. 次の1つ以上のコマンドを実行します。

- 「基本」テンプレートを公開する手順は、次のとおりです。

insert into WC_SPACE_HEADER values

('webcenter', 'sdfcd3cd3_8a53_4a7c_872f_74de46969cef','Basic','Basic','Template for a Space with minimal initial content',

'Y','N','N','N','N','N','N','N',1,'/oracle/webcenter/space/metadata/spacetemplate/Basic/images/wc_blank_icon.png',

'/oracle/webcenter/space/metadata/spacetemplate/Basic/images/wc_blank_logo.png','Blank','system','30-OCT-09 12.00.00.000000000 AM',

'weblogic','30-OCT-09 12.00.00.000000000 AM','','','','Y',0,0,1);

- 「関心のあるコミュニティ」テンプレートを公開する手順は、次のとおりです。

insert into WC_SPACE_HEADER values

('webcenter', 's5dd6d6b3_7f5f_4f1c_8ee6_ce305469f1b3','ProjectSpace','Group Project','Template for a Space based on completing a project',

'Y','N','N','N','N','N','N','N',1,'/oracle/webcenter/space/metadata/spacetemplate/ProjectSpace/images/wc_prj_icon.png',

'/oracle/webcenter/space/metadata/spacetemplate/ProjectSpace/images/wc_prj_logo.png','project,group,team','system','30-OCT-09 12.00.00.000000000 AM',

'weblogic','30-OCT-09 12.00.00.000000000 AM','','','','Y',0,0,1);

- 「グループ・プロジェクト」テンプレートを公開する手順は、次のとおりです。

insert into WC_SPACE_HEADER values

('webcenter', 'sb175bdde_4cb8_4da8_bcdb_eff13e59da2d','CommunityOfInterest','Community of Interest','Template for a Space based on a common interest',

'Y','N','N','N','N','N','N','N',1,'/oracle/webcenter/space/metadata/spacetemplate/CommunityOfinterest/images/coi_icon.png',

'/oracle/webcenter/space/metadata/spacetemplate/CommunityOfinterest/images/coi_logo.png','community','system','30-OCT-09 12.00.00.000000000 AM',

'weblogic','30-OCT-09 12.00.00.000000000 AM','','','','Y',0,0,1);

これらのテンプレートはすぐに使用可能になります。Spacesアプリケーションを再起動する必要はありません。

9.9 Spacesアプリケーションのセッション・タイムアウトの設定

Spacesアプリケーションのデフォルトのセッション・タイムアウトは、web.xmlで指定されているHTTPセッション・タイムアウトから取得されます。出荷時のweb.xmlの<session-timeout>は、45分に設定されています。

管理者は、必要に応じて、webcenter-config.xmlのwcSessionTimeoutPeriod属性を使用してセッション・タイムアウトを増減できます。

Spacesアプリケーションのセッション・タイムアウトを変更する手順は、次のとおりです。

1. 最新のwebcenter-config.xmlをMDSからエクスポートします。
次に例を示します。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcenter-config.xml.xml')

webcenter-config.xmlファイルは、Spaces管理で「一般」設定を初めて構成したときに作成されます。付録A「webcenter-config.xml」も参照してください。

注意:

webcenter-config.xmlファイルは、Spaces管理で「一般」設定を初めて構成したときにMDSに作成されます。ファイルがMDSに存在しない場合、webcenter-config.xmlを直接編集できます。ファイルは、/oracle/webcenter/webcenterapp/metadata/webcenter-config.xmlにあります。

2. MDSからエクスポートされたwebcenter-config.xml.xmlをテキスト・エディタで開き、次のスニペットを追加します。

<mds:replace node="wcSessionTimeoutPeriod(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/webcenterapp))/mds_ns1:value"/>
<mds:insert after="wcSessionTimeoutPeriod(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/webcenterapp))/mds_ns1:type" parent="wcSessionTimeoutPeriod">
<value xmlns="http://xmlns.oracle.com/webcenter/webcenterapp">15</value>
</mds:insert>

3. valueに、必要なタイムアウト時間を指定します(分単位)。

4. webcenter-config.xml.xmlを保存して閉じます。

5. 更新したwebcenter-config.xml.xmlファイルをMDSにインポートします。
次に例を示します。

importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcenter-config.xml.xml')

第IV部

サービス、ポートレット・プロデューサおよび外部アプリケーションの管理

この部の章では、Oracle WebCenter Portalのサービス、ポートレット・プロデューサおよび外部アプリケーションの管理タスクについて説明します。

第IV部の内容は次のとおりです。

- 第10章「Oracle WebCenter Portalサービスの管理」

- 第11章「コンテンツ・リポジトリの管理」

- 第12章「アクティビティ・グラフ・サービスの管理」

- 第13章「分析サービスの管理」

- 第14章「お知らせおよびディスカッション・サービスの管理」

- 第15章「イベント・サービスの管理」

- 第16章「インスタント・メッセージおよびプレゼンス・サービスの管理」

- 第17章「メール・サービスの管理」

- 第19章「サブスクリプションおよび通知の管理」

- 第20章「WebCenter Portalのパーソナライズの管理」

- 第21章「RSSサービスの管理」

- 第22章「WebCenter PortalでのOracle SES検索の管理」

- 第23章「ワークリスト・サービスの管理」

- 第24章「ポートレット・プロデューサの管理」

- 第25章「Oracle WebCenter Portalのページレット・プロデューサの管理」

- 第26章「外部アプリケーションの管理」

- 第27章「RESTサービスの管理」

10 Oracle WebCenter Portalサービスの管理

この章では、WebCenter Portalアプリケーションでのサービス管理の概要について説明します。また、様々なサービスに必要なバックエンド・リポジトリについても説明します。

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

10.1 サービス管理の概要

WebCenter Portalは、サービスを使用して、コラボレーション、ソーシャル・ネットワーキングおよび個人生産性の機能を公開します。かわりにサービスは、タスク・フローを使用して、それらの機能のサブセットを公開します。タスク・フローは、特定のサービスから使用可能なすべてまたは一部の機能を公開できる再利用可能な機能を提供します。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。

注意:

Fusion Middleware ControlまたはWLSTを使用してサービス構成に対して加えた変更のほとんどは、動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

表10-1は、サービスのデータが格納されている場所の一覧です。リポジトリが使用できないときに影響を受けるサービスを知っておくと便利です。

- サービスによっては、接続メタデータをメタデータ・サービス・リポジトリ(MDS)に格納します。デプロイした後にアプリケーションに加えた変更は、MDSにカスタマイズとして格納されます。詳細は、第1.3.5項「WebCenter Portalの構成に関する考慮事項」および第10.1.1項「MDSリポジトリの設定」を参照してください。

- サービスによっては、関連情報(リレーションシップ・マッピングなど)が格納されているデータベース・スキーマとの接続が必要です。詳細は、第10.1.2項「データベース接続の設定」を参照してください。

- サービスによっては、関連情報が格納されている外部データ・リポジトリ(コンテンツ・サーバー、プレゼンス・サーバーまたはメール・サーバーなど)との接続が必要です。これらの接続の設定方法の詳細は、そのサービスの章を参照してください。

表10-1 サービス・データ・リポジトリ

WebCenter Portalサービス

説明

MDS

データベース・スキーマ

外部アプリケーション

関連情報

アクティビティ・グラフ

収集された情報を活用して、検索およびソーシャル・アプリケーションを支援します。

ACTIVITIESスキーマ

第10.1.2項「データベース接続の設定」

分析

ポータル・アプリケーションの使用状況とパフォーマンスのメトリックを表示できます。

ACTIVITIESスキーマ

X

第10.1.2項「データベース接続の設定」

第13章「分析サービスの管理」

お知らせ

重要なアクティビティおよびイベントに関するお知らせを投稿できる機能を、認証されたすべてのユーザーに提供します。

X

X

第10.1.1項「MDSリポジトリの設定」

第14章「お知らせおよびディスカッション・サービスの管理」

ディスカッション

スレッドで構成されるディスカッションの作成、質問の投稿と返信、および回答の検索が可能な機能を提供します。

X

X

第10.1.1項「MDSリポジトリの設定」

第14章「お知らせおよびディスカッション・サービスの管理」

ドキュメント

コンテンツのアップロード、ファイルやフォルダの作成と管理、ファイルのチェックアウト、バージョニングなどを含めて、コンテンツの管理およびストレージの機能を提供します。

X

WEBCENTERスキーマ: コメントおよびアクティビティ・ストリームを含めるドキュメント用(Wikiとブログを含む)

X

第10.1.1項「MDSリポジトリの設定」

第10.1.2項「データベース接続の設定」

第11章「コンテンツ・リポジトリの管理」

イベント

認証されたユーザーの広範囲なグループに関連するイベントのスケジュールの作成およびメンテナンスの機能を提供します。

X

X (個人イベント)

第10.1.1項「MDSリポジトリの設定」

第15章「イベント・サービスの管理」

インスタント・メッセージおよびプレゼンス(IMP)

認証された他のユーザーのステータス(オンライン、オフライン、ビジーまたは退席中)を確認したり、ユーザーに即時に連絡できる機能を提供します。

X

第16章「インスタント・メッセージおよびプレゼンス・サービスの管理」

リンク

関連情報の表示、アクセスおよび関連付けの機能を提供します。たとえば、ディスカッションからドキュメントにリンクできます。

WEBCENTERスキーマ

第10.1.2項「データベース接続の設定」

リスト

リストを作成、公開および管理できる機能を提供します。

X

WEBCENTERスキーマ

第10.1.1項「MDSリポジトリの設定」

第10.1.2項「データベース接続の設定」

メール

IMAPおよびSMTPのメール・サーバーとの容易な統合を提供します。これにより、メッセージの表示、添付ファイルを含むメールの作成、メッセージの返信と転送、およびメッセージの削除などのメール機能を実行できます。

X

X

第10.1.1項「MDSリポジトリの設定」

第17章「メール・サービスの管理」

ノート

素早く書き留める機能、および様々な個人関連情報を保持する機能を提供します。

注意: このサービスは、Oracle WebCenter Portal: Spacesでのみ使用できます。

X

第10.1.1項「MDSリポジトリの設定」

通知

サービスおよびアプリケーション・オブジェクトをサブスクライブして、それらのオブジェクトが変更されると1つ以上のメッセージング・チャネルから通知を受信するための手段を提供します。

第19章「サブスクリプションおよび通知の管理」

ピープル・コネクション

個人プロファイルの作成、現在のステータスの表示、および他のユーザーの最新アクティビティの表示などのソーシャル・ネットワーキング機能を提供します。

WEBCENTERスキーマ

第10.1.2項「データベース接続の設定」

パーソナライズ

選択した条件に基づいて、アプリケーション内のコンテンツをターゲットのアプリケーション・ユーザーに配信できます。

第20章「WebCenter Portalのパーソナライズの管理」

投票

関係者の調査(意見および経験レベルなど)、重要な情報を思い出すことができるかどうかの確認、およびフィードバックの収集ができます。

WEBCENTERスキーマ

第10.1.2項「データベース接続の設定」

最近のアクティビティ

ドキュメント、ディスカッションおよびお知らせに対する最新の変更のサマリー・ビューを提供します。

X

第10.1.1項「MDSリポジトリの設定」

RSS

単一の場所(ニュース・リーダー)から多数の異なるWebサイトのコンテンツにアクセスできる機能を提供します。

X

第10.1.1項「MDSリポジトリの設定」

検索

サービス、アプリケーションまたはサイト全体を検索できる機能を提供します。

(これにはOracle Secure Enterprise Searchの統合が含まれます。)

X

X

第10.1.1項「MDSリポジトリの設定」

第22章「WebCenter PortalでのOracle SES検索の管理」

タグ

1つ以上の個人関連キーワードを特定のページまたはドキュメントに割り当てる機能を提供します。

X

WEBCENTERスキーマ

第10.1.1項「MDSリポジトリの設定」

第10.1.2項「データベース接続の設定」

ワークリスト

注目する必要のあるビジネス・プロセスの個人ビューを提供します。

X

X

第10.1.1項「MDSリポジトリの設定」

第23章「ワークリスト・サービスの管理」

10.1.1 MDSリポジトリの設定

サービスによっては、メタデータ・サービス・リポジトリ(MDS)に情報を格納します。WebCenter Portalアプリケーションでこれらのサービスを有効化するには、MDSリポジトリを構成する必要があります。詳細は、第7.1.5項「メタデータ・サービス・リポジトリの作成および登録」を参照してください。

関連項目:

『Oracle Fusion Middleware管理者ガイド』のOracle Metadata Repositoryの管理に関する項およびOracle WebCenter Portalデータのパージに関する項を参照してください。

10.1.2 データベース接続の設定

多数のサービスは、WebCenter Portalリポジトリに情報を格納します。このリポジトリは、WebCenter Portalスキーマ(WEBCENTER)がインストールされているデータベースです。たとえば、リンク・サービスでは、どのオブジェクトがどのオブジェクトにリンクされているかといった、関連マッピング情報をデータベースに格納します。WebCenter Portalスキーマは製品に含まれています。

WebCenter Portal: Frameworkアプリケーションでは、WebCenter Portalリポジトリとのデータベース接続を設定する必要があります。このデータベース接続は、JDBCデータ・ソースまたはJDBC URLのどちらかのタイプにできます。

注意:

WebCenter Portal: Spacesの場合、WebCenter Portalリポジトリは出荷時に構成されているため、リポジトリ接続を再構成する必要はありません。

関連項目:

- 接続の作成およびスキーマのインストールの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のデータベース接続の設定に関する項を参照してください。

- アプリケーションを本番環境にデプロイするときのデータ・ソースの注意点は、第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照してください。

- この情報のバックアップおよび移行の詳細は、第39章「WebCenter Portalのエクスポート、インポート、バックアップおよびリカバリの管理」を参照してください。

アプリケーションで使用される接続タイプに応じて、次のいずれかを実行します。

- 間接パスワードを使用するアプリケーションレベルのデータ・ソースがアプリケーションに含まれていない場合、グローバル・データ・ソースを作成します。グローバル・データ・ソースの作成手順の詳細は、Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理のJDBCデータ・ソースの作成に関する項を参照してください。

- 間接パスワードを使用するアプリケーションレベルのデータ・ソースをアプリケーションが使用している場合、接続資格証明をマップします。パスワードの設定は、Oracle WebLogic管理コンソールを使用して、「セキュリティ」の「資格証明マッピング」タブで行います。「構成」の「接続プール」タブで間接データ・ソースのパスワードを変更しても、影響はありません。資格証明マッピングの詳細は、Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理のJDBCデータ・ソースの作成に関する項でJDBCデータ・ソースのセキュリティの資格証明マッピングに関する記載を参照してください。

- アプリケーションがJDBC URL接続を使用する場合、グローバル・アプリケーション・ストアの情報とアプリケーション資格証明ストアに格納されている情報をマージします。資格証明の移行動作の詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの資格証明ストアの構成に関する項を参照してください。

典型的なビジネスのシナリオでは、アプリケーションは別々の管理対象サーバーにデプロイされて、それらのアプリケーションのために複数のデータベースがリポジトリとして使用されます。開発環境で使用するリポジトリは、本番環境で使用するリポジトリとは異なります。そのため、WebCenter Portal: Frameworkアプリケーションを開発環境から本番環境に移行するときは、データベース接続を再構成する必要があります。

リポジトリ接続を再構成すると、WARファイルのWEB-INFディレクトリにあるローカルのdatasourceファイルおよび*-jdbc.xmlファイルは、新しい接続詳細で更新されます。ただし、JNDI Nameおよびdata source名は変更されません。なんらかの理由でJNDI Nameを変更したら、adf-config.xmlファイルも更新する必要があります。JNDI名は、jdbc/connection-nameDSの形式で指定する必要があります。たとえば、connection1という接続名がアプリケーションで使用されている場合、JNDI名はjdbc/connection1DSとなります。

10.1.3 外部アプリケーション接続の設定

自身の認証を行うアプリケーションとサービスが対話する場合、資格証明プロビジョニングをできるように、そのアプリケーションと外部アプリケーション定義を関連付けることができます。

サービスと接続したり接続用の認証を定義する外部アプリケーションを使用できるのは、次のサービスです。

- ドキュメント

- イベント

- インスタント・メッセージおよびプレゼンス

- メール

- RSSビューア(保護されているRSSフィード使用時)

関連項目:

第26章「外部アプリケーションの管理」

11 コンテンツ・リポジトリの管理

この章では、WebCenter Portalアプリケーションで使用されるコンテンツ・リポジトリを構成および管理する方法について説明します。

この章の内容は次のとおりです。

- 第11.1項「コンテンツ・リポジトリに関する必要な知識」

- 第11.2項「Oracle WebCenter Content Serverリポジトリの構成」

- 第11.3項「Microsoft SharePointリポジトリの構成」

- 第11.4項「Oracle Portalリポジトリの構成」

- 第11.5項「ファイル・システム・リポジトリの構成」

- 第11.6項「コンテンツ・リポジトリの登録」

- 第11.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」

- 第11.8項「コンテンツ・リポジトリ接続の詳細の変更」

- 第11.9項「コンテンツ・リポジトリ接続の削除」

- 第11.10項「Spacesコンテンツ・リポジトリの接続プロパティの設定」

- 第11.11項「コンテンツ・リポジトリ接続のテスト」

- 第11.12項「最大ファイル・アップロード・サイズの変更」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

11.1 コンテンツ・リポジトリに関する必要な知識

Oracle WebCenter PortalはJCR 1.0のオープン・ドキュメント標準をサポートしているため、複数のバックエンド・コンテンツ・ストアとの統合が可能です。Oracle WebCenter Portalは、コンテンツ・リポジトリとして、Oracle WebCenter Content Server (Content Server)、Microsoft SharePoint、Oracle Portalおよびファイル・システムをサポートしています。

Oracle WebCenter Portalでは、次のものを使用したコンテンツ統合が可能です。

- コンテンツ・リポジトリ・データ・コントロール: コンテンツ・リポジトリへの読取り専用アクセスを可能にし、WebCenter Portal: Frameworkアプリケーションへのコンテンツの表示方法の厳格な制御を維持します。

- ドキュメント・サービス: 組織のコンテンツ・リポジトリに含まれているドキュメントおよび他のタイプのコンテンツをユーザーが表示および管理できるようにします。

- コンテンツ・プレゼンタ: エンド・ユーザーが様々な方法でコンテンツを選択し、利用可能な表示テンプレートを使用してコンテンツ・アイテムを表示できるようにします。WebCenter Portal: Frameworkアプリケーションの開発中に、コンテンツ・プレゼンタ・タスク・フローを追加できます。または、実行時に編集可能なページにこのタスク・フローを追加できます。

WebCenter Portalアプリケーションのコンテンツの管理と組込みの詳細は、次の関連項目も参照してください。

- 分散コンテンツへのアクセスを提供するコンテンツ・リポジトリ接続の構成については、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のコンテンツの統合に関する項を参照してください。

- コンテンツ・プレゼンタを使用してWebCenter Portalアプリケーション内で分散コンテンツを統合および公開するためのカスタム表示テンプレートの作成については、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のカスタムのコンテンツ・プレゼンタ表示テンプレートの作成に関する項を参照してください。

- Javaコンテンツ・リポジトリ(JCR)コントロールを使用してコンテンツ・リポジトリへの読取り専用アクセスを可能にする方法については、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のコンテンツ・リポジトリ接続の構成に関する項を参照してください。

- 実行時のドキュメントの管理、表示および検索用の使いやすいインタフェースをエンド・ユーザーに提供するための、WebCenter Portal: Frameworkアプリケーションでのドキュメント・サービスの統合については、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のドキュメント・サービスの統合に関する項を参照してください。

- WebCenter Portalアプリケーションでの実行時のドキュメント・サービスおよびタスク・フローの使用については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのドキュメント・サービスの使用に関する項を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったコンテンツ・リポジトリ構成の変更は、動的ではありません。変更を有効にするには、WebCenter Portal: Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

次の各項では、各コンテンツ・リポジトリの前提条件について説明します。

- 第11.2項「Oracle WebCenter Content Serverリポジトリの構成」

- 第11.3項「Microsoft SharePointリポジトリの構成」

- 第11.4項「Oracle Portalリポジトリの構成」

- 第11.5項「ファイル・システム・リポジトリの構成」

WebCenter Portalユーザーは、ファイルを格納、公開および共有する必要があります。ドキュメント・サービスは、WebCenter Portalアプリケーションにコンテンツの管理および格納機能を提供します。これには、コンテンツのアップロード、ファイルとフォルダの作成および管理、ファイルのチェックアウト、バージョニングなどが含まれます。これらの機能を提供するためには、ドキュメント・サービスは少なくとも1つのコンテンツ・リポジトリ接続をアクティブ(デフォルト)にする必要があります(WebCenter Portalアプリケーションでは複数のコンテンツ・リポジトリ接続をサポートできます)。

- WebCenter Portal: Spaces: Spacesアプリケーションでは、すべてのホーム・スペース、およびドキュメント・サービスがプロビジョニングされたあらゆるスペースに、そのスペース固有のドキュメント・フォルダがあります。このデータはOracle WebCenter Content Server (Content Server)リポジトリに格納されます。このリポジトリはSpacesのプライマリ・コンテンツ・リポジトリとして構成されている必要があります。SpacesではContent Serverをアクティブまたはデフォルトのコンテンツ・リポジトリにする必要がありますが、サポートされている他のいずれかのリポジトリにSpacesを接続することも可能です。デフォルトのコンテンツ・リポジトリの設定、およびSpacesコンテンツ・リポジトリに必要な追加のドキュメント・スペース・プロパティの設定の詳細は、第11.8項「コンテンツ・リポジトリ接続の詳細の変更」を参照してください。

- その他のWebCenter Portal: Frameworkアプリケーション: コンテンツ・リポジトリをアクティブに設定すると(第11.8項「コンテンツ・リポジトリ接続の詳細の変更」を参照)、特定の接続詳細が指定されていないインスタンスでは、そのコンテンツ・リポジトリがドキュメント・サービス・タスク・フローで使用されます。使用するデフォルトのコンテンツ・リポジトリについては、特定の要件はありません。

Content Serverがプライマリ・アクティブ・コンテンツ・リポジトリである場合(Spacesでは必須)、WebCenter Portalアプリケーションで使用されるものと同じアイデンティティ・ストアにドキュメント・サービスとContent Serverを接続する必要があります。

他のサービス接続と同様に、デプロイ後のコンテンツ・リポジトリ接続は、Fusion Middleware ControlまたはWLSTコマンドライン・ツールを使用して登録および管理されます。接続情報は構成ファイルおよびMDSリポジトリに格納されます。詳細は、第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にWebCenter Portalアプリケーションに対して行った変更は、Oracle Metadata Service (MDS)リポジトリにカスタマイズとして格納されます。

接続の詳細が定義されると、WebCenter Portalアプリケーション・ユーザーは、<af:image>、<af:inlineFrame>、<af:goLink>などの複数のADF Facesコンポーネント、および組込みのドキュメント・サービス・タスク・フロー(ドキュメント・マネージャ、フォルダ・ビューアおよび最近のドキュメント)を使用して、接続されたコンテンツ・リポジトリのコンテンツを公開できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページ・コンテンツの使用に関する項とドキュメント・サービスの使用に関する項を参照してください。

11.2 Oracle WebCenter Content Serverリポジトリの構成

この項では、Oracle WebCenter Content Server 11g (Content Server)コンテンツ・リポジトリをWebCenter Portal: SpacesおよびWebCenter Portal: Frameworkアプリケーション用に構成するための手順を説明します。特に明記しないかぎり、次の手順はSpacesおよびFrameworkアプリケーションの両方に共通です。

この項の内容は次のとおりです。

- 第11.2.1項「Content Serverを構成するための前提条件」

- 第11.2.2項「Content Serverの構成ロードマップ」

- 第11.2.3項「WebCenter Portalアプリケーション用のContent Serverの構成」

11.2.1 Content Serverを構成するための前提条件

この項では、第11.2.3項「WebCenter Portalアプリケーション用のContent Serverの構成」に進む前に理解する必要がある前提条件と他の考慮事項について説明します。

この項の内容は次のとおりです。

- 第11.2.1.1項「インストールに関する前提条件」

- 第11.2.1.2項「構成に関する前提条件」

- 第11.2.1.3項「セキュリティに関する前提条件」

11.2.1.1 インストールに関する前提条件

Content Server

Oracle WebCenter Content Server 11g (Content Server)を構成するには、Content Serverがすでにインストールされていることが必要です。Content Serverは、Oracle Fusion MiddlewareのコンポーネントであるOracle WebCenter Contentの一部としてインストールされます。Oracle WebCenter Contentについては、Oracle WebCenter Contentインストール・ガイドで説明しています。

旧バージョンのContent Serverがすでにインストールされている場合は、Oracle WebCenter Content Server 11gにアップグレードしてから、Content Server 11gの構成を行ってください。Oracle WebCenter Content Server 11gへのアップグレードの詳細は、Oracle Fusion Middleware Enterprise Content Managementアップグレード・ガイドのOracle Enterprise Content Management Suite環境のアップグレードに関する項を参照してください。

Inbound Refinery

インストールの一部として、Oracle WebCenter Content: Inbound Refinery (Inbound Refinery)もインストールすることをお薦めします。Inbound Refineryは、ドキュメント、デジタル・イメージ、モーション・ビデオなどの電子アセットのファイル変換を管理する変換サーバーです。ドキュメントやイメージのサムネイル機能や、ビデオのストーリーボード機能も提供します。Inbound Refineryを使用して、Content Serverに格納されているコンテンツ・アイテムを変換できます。Inbound Refineryのインストールについては、Oracle WebCenter Contentインストール・ガイドでも説明しています。

注意:

Content ServerとInbound Refineryは、同じドメインにインストールする必要があります。Content ServerとInbound Refineryは、WebCenter Portalと同じドメインにインストールすることをお薦めします。これらを同じドメインにインストールすると、外部LDAP認証プロバイダを使用するための追加構成は必要なくなります。

11.2.1.2 構成に関する前提条件

Content ServerとInbound Refineryをインストールした後は、インストール後の初期設定の構成も完了しておく必要があります。この構成については、Oracle WebCenter Contentインストール・ガイドのContent Serverインスタンスの構成に関する項で説明しています。次の表に示すWebCenter Portal固有の追加指示も含めて、Content ServerとInbound Refineryの両方の設定を構成します。設定を更新した後は、必ずサーバーを再起動してください。

Content Server

設定

説明

サーバーのソケット・ポート

これは、RIDCを使用して接続するintradocポートです。この値は、IntradocServerPortとして管理対象サーバーの構成ファイルに格納されます。

受信ソケット接続アドレス・セキュリティ・フィルタ

どのマシンがソケット接続によってContent Serverにアクセスできるかを指定するサーバー・フィルタ。この値は、SocketHostAddressSecurityFilterとして管理対象サーバーの構成ファイルに格納されます。

フルテキスト検索

(オプションですがお薦めします)

内部

Inbound Refinery

設定

説明

サーバーのソケット・ポート

これは、RIDCを使用して接続するintradocポートです。この値は、IntradocServerPortとして管理対象サーバーの構成ファイルに格納されます。

受信ソケット接続アドレス・セキュリティ・フィルタ

どのマシンがRIDCによってInbound Refineryにアクセスできるかを指定するサーバー・フィルタ。この値は、SocketHostAddressSecurityFilterとして管理対象サーバーの構成ファイルに格納されます。

フルテキスト検索

(オプションですがお薦めします)

内部

11.2.1.3 セキュリティに関する前提条件

SpacesアプリケーションまたはFrameworkアプリケーションと同じアイデンティティ・ストアLDAPサーバーを使用するように、Content Serverを構成する必要があります。アイデンティティ・ストアを外部のLDAPサーバーに再度関連付ける方法の詳細は、第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照してください。

Content ServerとInbound Refineryは、同じドメインにインストールする必要があります。Content ServerとInbound Refineryは、WebCenter Portalと同じドメインにインストールすることをお薦めします。これらを同じドメインにインストールすると、外部LDAP認証プロバイダを使用するための追加構成は必要なくなります。

11.2.2 Content Serverの構成ロードマップ

図11-1のフロー・チャートは、WebCenter Portalアプリケーション(SpacesおよびFrameworkアプリケーション)でContent Serverを機能させるための前提条件と必要なタスクの概要を示しています。フロー・チャート内の手順については、表11-1と、第11.2.3項「WebCenter Portalアプリケーション用のContent Serverの構成」内の各項で説明します。

図11-1 WebCenter Portalアプリケーション用のContent Serverの構成

「図11-1 WebCenter Portalアプリケーション用のContent Serverの構成」の説明

表11-1 WebCenter Portal固有のContent Server構成タスク

タスク

説明

ドキュメント

必須コンポーネントの有効化

必須

Folders_gコンポーネント(Content Server内でコンテンツへの階層フォルダ・インタフェースを提供するコンポーネント)と、WebCenterConfigureコンポーネント(WebCenter Portalアプリケーション用にContent Serverのインスタンスを構成するコンポーネント)を有効化する必要があります。また、FrameworkFoldersフォルダ・コンポーネント(Folders_gコンポーネントと非互換のコンポーネント)を無効化する必要があります。

第11.2.3.1項「必須コンポーネントの有効化」を参照してください。

Dynamic Converterコンポーネントの構成

オプションですが、強くお薦めします

このコンポーネントによってHTMLレンディションが可能になります。DynamicConverterコンポーネントとWebCenterConfigureコンポーネントの両方がインストールされている場合、WebCenter Portalでスライド・プレビューアを使用できます。

第11.2.3.2項「Dynamic Converterコンポーネントの構成」を参照してください。

Inbound Refineryの構成

オプションですが、強くお薦めします

これは、ドキュメント、デジタル・イメージ、モーション・ビデオなどの電子アセットのファイル変換を管理する変換サーバーです。ドキュメントやイメージのサムネイル機能や、ビデオのストーリーボード機能も提供します。Inbound Refineryを使用して、Content Serverに格納されているコンテンツ・アイテムを変換できます。

第11.2.3.3項「Inbound Refineryの構成」を参照してください。

Content Server用のSecure Sockets Layer (SSL)の構成

オプションですが、強くお薦めします

セキュアなアイデンティティ伝播を保証するには、Content Serverに対してSSLを設定します。

第33.7項「SSLを使用したSpacesからContent Serverへの接続の保護」を参照してください。

また、第11.2.3.4項「Content Serverに対するSSLの設定」も参照してください。

WebCenter PortalでのiFrame化UIの有効化

オプションですが、強くお薦めします

iFrame化が構成されていない場合、ドキュメント・マネージャのドキュメント・レンディション・サポート、拡張メタデータ編集、IFRAME機能などの一部の機能が使用できなくなります。

第11.2.3.5項「WebCenter PortalでのiFrame化UIの有効化」を参照してください。

詳細は、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

SESクローラの構成

オプション

デフォルトの検索アダプタを上書きして、ドキュメント、ページ、人などのWebCenter Portalリソースの統合ランキング結果の取得にOracle SESを使用できます。

第22.6.2項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」を参照してください。

また、第11.2.3.6項「SESクローラの構成」も参照してください。

Site Studioの構成

オプションですがお薦めします

Site Studioを構成すると、Site Studioを使用してSite Studioアセット(リージョン定義および表示テンプレート)を作成し、そのアセットをコンテンツ・プレゼンタで使用できるようになります。

第11.2.3.7項「Site Studioの設定」を参照してください。

詳細は、Oracle WebCenter Content Content Serverシステム管理者ガイドのコンポーネントの有効化と無効化に関する項と、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタでのコンテンツの公開に関する項も参照してください。Oracle WebCenter Site Studio管理者ガイドも参照してください。

OracleTextSearchの有効化

オプションですがお薦めします

フルテキストの検索および索引付け機能の構成はオプションですが、フルテキスト検索用にOracleTextSearchオプションを使用することをお薦めします。このオプションは、Oracle Databaseとの組合せでのみ使用可能なことに注意してください。

第11.2.3.8項「OracleTextSearchの有効化」を参照してください。

詳細は、Oracle WebCenter Contentインストール・ガイドのOracle Content Server用のOracle Text Searchの構成に関する項と、Oracle WebCenter Content Serverアプリケーション管理者ガイドのSite Studioの統合に関する項も参照してください。

コンテンツ・プロファイルの作成

オプション

WebCenter PortalアプリケーションでiFrame化が有効化されている場合、ユーザーは必要に応じて、Content Serverプロファイルに基づいてコンテンツをアップロードできます。

第11.2.3.9項「Content Serverでのコンテンツ・プロファイルの作成」を参照してください。

コンテンツ・プロファイルの作成の詳細は、Oracle WebCenter Content Serverアプリケーション管理者ガイドの「メタデータの管理」の章を参照してください。

アイテム・レベル・セキュリティの構成

オプション

ドキュメント・サービスでは、アイテム・レベル・セキュリティ(ILS)を使用して、デフォルトのSpacesドキュメント・セキュリティ・モデルを上書きしたり、FrameworkアプリケーションでContent Serverドキュメント・セキュリティを公開することができます。ILSにより、Content Serverフォルダ(およびその子)または個々のドキュメントが一意のセキュリティ権限を保有できます。

第11.2.3.10項「WebCenter Portalアプリケーションでのアイテム・レベル・セキュリティの構成」を参照してください。

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのフォルダまたはファイルのセキュリティ・オプションの設定に関する項も参照してください。

追加オプション構成

オプション

残りの構成が完了したら、必要に応じてFileStore Providerコンポーネントの構成およびノード・マネージャの設定が可能です。

第11.2.3.11項「追加のオプション構成」を参照してください。

Content ServerとFrameworkアプリケーション間のセキュリティの構成

Frameworkアプリケーションでは必須(Spacesには適用されません)

Frameworkアプリケーションと連携するようにContent Serverを構成するには、まず開発環境でコンテンツ・セキュリティとユーザーを設定してから、これらを本番環境に移行する必要があります。

第11.2.3.12項「Content ServerとWebCenter Portal: Frameworkアプリケーション間のセキュリティの構成」を参照してください。

Content Server接続の登録

必須

Frameworkアプリケーションについては、アプリケーションからContent Serverへの接続を構成する必要があります。Spacesについては、ほとんどの場合、Spacesの最初の起動時に接続が構成されますが、少なくとも接続のテストを行って、接続が使用している環境用に正しく構成されていること、およびデータが正しくシードされていることを確認してください。

Frameworkアプリケーションについては、第11.2.3.13.1項「Frameworkアプリケーション用のContent Server接続の構成」を参照してください。Spacesについては、第11.2.3.13.2項「Spaces用のContent Server接続の構成」を参照してください。Spacesについては、第11.2.3.13.3項「Content ServerにシードされたSpacesデータの確認」の説明に従って、シードされたデータを確認する必要もあります。

11.2.3 WebCenter Portalアプリケーション用のContent Serverの構成

Content Server 11gのインストールまたはこのバージョンへのアップグレードが完了したら、表11-1に示す構成タスクを実行します。特に明記しないかぎり、これらのタスクはSpacesおよびFrameworkアプリケーションの両方に共通です。

注意:

構成を開始する前に、この項の構成手順の開始点を定義した第11.2.1項「Content Serverを構成するための前提条件」で説明しているインストール手順と構成手順を完了しておく必要があります。

この項の内容は次のとおりです。

- 第11.2.3.1項「必須コンポーネントの有効化」

- 第11.2.3.2項「Dynamic Converterコンポーネントの構成」

- 第11.2.3.3項「Inbound Refineryの構成」

- 第11.2.3.4項「Content Serverに対するSSLの設定」

- 第11.2.3.5項「WebCenter PortalでのiFrame化UIの有効化」

- 第11.2.3.6項「SESクローラの構成」

- 第11.2.3.7項「Site Studioの設定」

- 第11.2.3.8項「OracleTextSearchの有効化」

- 第11.2.3.9項「Content Serverでのコンテンツ・プロファイルの作成」

- 第11.2.3.10項「WebCenter Portalアプリケーションでのアイテム・レベル・セキュリティの構成」

- 第11.2.3.11項「追加のオプション構成」

- 第11.2.3.12項「Content ServerとWebCenter Portal: Frameworkアプリケーション間のセキュリティの構成」

- 第11.2.3.13項「Content Server接続の登録」

11.2.3.1 必須コンポーネントの有効化

必須

次の手順に従って、Content Serverが必要とするコンポーネントを有効化します。これには、FrameworkFoldersフォルダ・コンポーネント(Folders_gコンポーネントと非互換のコンポーネント)が無効化されていることの確認、Folders_gコンポーネント(Content Server内のコンテンツへの階層フォルダ・インタフェースを提供するコンポーネント)の有効化、およびWebCenterConfigureコンポーネント(WebCenter Portalアプリケーション用にContent Serverのインスタンスを構成するコンポーネント)の有効化が含まれます。WebCenterConfigureコンポーネントの機能の詳細は、第11.2.3.1.1項「WebCenterConfigureコンポーネントに関する必要な知識」を参照してください。

必須コンポーネントを有効化する手順は次のとおりです。

1. 管理サーバーにログオンし、「管理サーバー」ページを開きます。
「管理サーバー」ページには、Content Serverで「管理」→「管理サーバー」と移動することによりアクセスできます。

2. 「コンポーネント・マネージャ」をクリックします。
「コンポーネント・マネージャ」ページが表示されます。

3. 「FrameworkFolders」チェック・ボックスが選択解除されていることを確認します。

4. 「WebCenterConfigure」のチェック・ボックスと、有効化する他のコンポーネントのチェック・ボックスを選択します。
Inbound Refineryがインストールされており、これを使用することを予定している場合は、「コンポーネント・マネージャ」ページで「InboundRefinerySupport」チェック･ボックスが選択されていることを確認します。また、Dynamic Converterを使用することを予定している場合は、後で有効化しなくてすむように、これもここで選択できます。

5. 「更新」をクリックします。

6. 「拡張コンポーネント・マネージャ」をクリックします。
「コンポーネント・マネージャ」ページが表示されます。

7. 「無効なコンポーネント」リスト・ボックスでFolders_gを選択して、「有効化」をクリックします。

8. Content Serverインスタンスを再起動します。

11.2.3.1.1 WebCenterConfigureコンポーネントに関する必要な知識

WebCenterConfigureコンポーネントを有効化すると、Content Serverで次のタスク(表11-2)が実行されます。

表11-2 WebCenterConfigureコンポーネントに関連付けられたタスク

タスク

タスクの完了を検証するポインタ

アカウントの有効化

「Content Server」→「管理」→「管理サーバー」→「一般構成」→「アカウントの有効化」チェック・ボックス

または

FMW_HOME/user_projects/domains/ucm_domain/ucm/cs/config/config.cfgファイル。このファイル内の設定がUseAccounts=1となります。

リリース前のドキュメントに対する更新の許可

「Content Server」→「管理」→「管理サーバー」→「一般構成」→「追加の構成変数」

または

FMW_HOME/user_projects/domains/ucm_domain/ucm/cs/config/config.cfg

設定がAllowUpdateForGenwww=1となります。

フォルダのキャッシュの無効化

Folders_gコンポーネントが有効化されると、サーバーが起動されるたびに、WebCenterConfigureコンポーネントによってCollectionUseCacheがfalseに設定されます。この設定は、「管理」→「システム監査情報」→「構成エントリ情報」→「すべての環境キー」をクリックしてすべての環境設定を表示することによって確認できます。

または

FMW_HOME/user_projects/domains/ucm_domain/ucm/cs/config/config.cfgファイルを参照します。この設定がCollectionUseCache=1となります。

次のメタデータ・フィールドの追加

- xWCTags

- xWCPageId

- xWCWorkflowAssignment

- xWCWorkflowApproverUserList

メタデータ・フィールドの表示、編集および追加は、「Content Server」→「管理」→「管理アプレット」→「構成マネージャ」→「情報フィールド」タブで行えます。

次のフォルダ設定の設定(Folders_gコンポーネントが有効化されている場合)

- システムのデフォルト情報のフィールド構成: 「ドキュメント・タイプ」=「ドキュメント」

- フィールド情報の継承構成
xWCWorkflowAssignment
xWCWorkflowApproverUserList

「Content Server」→「管理」→「フォルダ構成」→「システムのデフォルト情報のフィールド構成」

「Content Server」→「管理」→「フォルダ構成」→「フィールド情報の継承構成」

WCWorkflowApproverUserTokenワークフロー・トークンの追加

「Content Server」→「管理」→「管理アプレット」→「ワークフロー管理」→「オプション」→「トークン」メニュー

3つのDynamicConverterテンプレートの追加

DynamicConverterコンポーネントが有効化されると、DynamicConverterサービスがコールされ、次の3つのDynamicConverterテンプレートが作成されます。

- SLIDE-PREVIEW

- SLIDE-PREVIEW-TEXT

- SLIDE-PREVIEW-LARGE

Site StudioをWebCenter Portal環境で動作させるための、Site Studioコンテンツの切替えウィザードの特定の動作の上書き

それによって、コンテンツ・プレゼンタ内からSite Studioコンテンツの切替えウィザードとSite Studioコントリビュータ・エディタにアクセスして、WebCenter PortalからSite Studioドキュメントの追加および編集を行えるようになります。

- contentwizard.hcspファイルとcontentwizard.jsファイルが/WebCenterConfigure.zip/component/WebCenterConfigure/publish/contentwizard/ディレクトリからOCS_HOME/cs/weblayout/resources/wcm/custom/sitestudio/contentwizard/webcenter/ディレクトリにコピーされます。

- wcm.sitestudio.form.jsファイルが/WebCenterConfigure.zip/component/WebCenterConfigure/publish/contentwizard/ディレクトリからOCS_HOME/cs/weblayout/resources/wcm/custom/sitestudio/ディレクトリにコピーされます。

11.1.1.6.0形式へのPersonalSpaceロールとデフォルト属性のアップグレード

Content Serverに旧バージョン(11.1.1.5.0およびこれより前)のPersonalSpaceロール形式が含まれている場合、WebCenterConfigureを有効化すると、PersonalSpaceロールとデフォルト属性が11.1.1.6.0形式にアップグレードされます。

11.1.1.5.0およびこれより前の形式:

ロール:

- PersonalSpacesセキュリティ・グループに対するRWD権限を持つPersonalSpaceRole

デフォルトの属性:

- すべてのユーザー(パブリックおよび認証済)がPersonalSpaceRoleを取得します

11.1.1.6.0形式:

ロール:

- PersonalSpacesセキュリティ・グループに対するR権限を持つPersonalSpaceRole

- PersonalSpacesセキュリティ・グループに対するRWDを持つPersonalSpaceAuthenRole

デフォルトの属性:

- すべてのパブリック・ユーザーがPersonalSpaceRoleを取得します

- すべての認証済ユーザーがPersonalSpaceAuthenRoleを取得します

11.2.3.2 Dynamic Converterコンポーネントの構成

オプションですが、強くお薦めします

この構成は、WebCenter Portalのスライド・プレビューア機能用に必要です。この機能では、Dynamic Converterによってオンザフライで生成されるHTMLレンディションが使用されます。

Dynamic Converterの構成には、Dynamic Converterの有効化と、Dynamic Converterの利用が可能なファイル・タイプの定義の2つの手順が含まれます。必須コンポーネントを有効化したときにすでにDynamic Converterを有効化してある場合は、有効化の手順はスキップして、ファイル・タイプの定義の手順に直接進むことができます。

Dynamic Converterの有効化

Dynamic Converterを有効化する手順は次のとおりです。

1. 管理サーバーにログオンし、「管理サーバー」ページを開きます。
「管理サーバー」ページには、Content Serverで「管理」→「管理サーバー」と移動することによりアクセスできます。

2. 「コンポーネント・マネージャ」ページで「DynamicConverter」チェック・ボックスを選択します。

3. 「更新」をクリックします。

4. Content Serverインスタンスを再起動します。

Dynamic Converterに送信するファイル・タイプの設定

Dynamic Converterの利用が可能なファイル・タイプを定義する手順は次のとおりです。

1. Content Serverにログインして、「管理」→「Dynamic Converterの管理」→「構成設定」→「変換フォーマット」を選択します。
「Dynamic Converterの管理」メニュー・オプションは、Dynamic Converterコンポーネントを有効化した後にContent Serverインスタンスを再起動しないと、表示されません。

2. Dynamic Converterを有効化するファイル・フォーマットをドロップダウン・リストから選択します。HTMLレンディションを必要とするすべてのドキュメント・フォーマット(Word、Excel、PowerPoint、PDFなど)を選択します。

11.2.3.3 Inbound Refineryの構成

オプションですが、強くお薦めします

Inbound Refineryは、ドキュメント、デジタル・イメージ、モーション・ビデオなどの電子アセットのファイル変換を管理する変換サーバーです。ドキュメントやイメージのサムネイル機能や、ビデオのストーリーボード機能も提供します。Inbound Refineryを使用して、Content Serverに格納されているコンテンツ・アイテムを変換できます。

Inbound Refineryを構成するには、Content ServerからInbound Refineryへの送信プロバイダを設定し、変換するファイル・タイプを指定する必要があります。また、Inbound RefineryでPDFExportConverterを有効化し、他の変換設定を設定する必要もあります。必要に応じて、wikiおよびブログのPDFへの変換も有効化します。

Inbound Refineryの構成前に、次のことを完了しておきます。

- Inbound Refineryのインストール(第11.2.1.1項「インストールに関する前提条件」を参照)

- インストール後の初期構成(第11.2.1.2項「構成に関する前提条件」を参照)

- InboundRefinerySupportコンポーネントが有効化されていることの確認(第11.2.3.1項「必須コンポーネントの有効化」を参照)

この項の内容は次のとおりです。

- 第11.2.3.3.1項「送信プロバイダの作成」

- 第11.2.3.3.2項「Inbound RefineryでのPDFExportConverterの有効化」

- 第11.2.3.3.3項「変換するファイル・フォーマットの選択」

- 第11.2.3.3.4項「WikiおよびブログのPDFへの変換の有効化」

11.2.3.3.1 送信プロバイダの作成

変換するファイルをContent ServerからInbound Refineryに送信できるようにするには、「Inbound Refinery変換ジョブの処理」オプションを選択して、Content ServerからInbound Refineryへの送信プロバイダを設定する必要があります。

送信プロバイダを作成する手順は次のとおりです。

1. 「Content Serverの管理」メニューから「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」セクションで、「送信」行にある「追加」をクリックします。

3. 次のフィールドに値を入力します。

- プロバイダ名: 送信プロバイダの対象であるInbound Refineryインスタンスについて説明する、空白を含まない任意の短い名前。Inbound Refineryのインスタンス名と同じ名前を使用することをお薦めします。

- プロバイダの説明: 送信プロバイダの説明。

- サーバー・ホスト名: Inbound Refineryインスタンスを実行するホスト・マシン名(例: myhost.example.com)。

- HTTPサーバー・アドレス: Inbound Refineryインスタンスのアドレス(http://myhost.example.com:16250など。16250はWebポートです)。

- サーバー・ポート: Inbound RefineryインスタンスのIntradocServerPort値。この値はインストール後の構成ページで入力されており、Inbound Refineryの構成情報ページにある「サーバー・ポート」で確認できます。また、FMW_HOME/user_projects/domains/ucm_domain/ucm/ibr/config/config.cfgファイル内のIntradocServerPortでも確認できます。
Inbound Refinery構成情報ページを表示する手順は次のとおりです。

- Content Serverにログインして、「管理」→「<instanceName>の構成」を選択します。

- 「サーバーの構成」をクリックしてサーバーの構成を表示します。

- インスタンス名: Inbound Refineryのインスタンス名(config.cfgファイル内のIDC_Name値)。この値はインストール後の構成ページで「コンテンツ・サーバーのインスタンス名」として入力されており、Inbound Refineryの構成情報ページで確認できます。

- 相対Webルート: Inbound RefineryインスタンスのWebルート(例: /ibr/)。

4. 「変換オプション」で、「Inbound Refinery変換ジョブの処理」を選択します。「Inbound Refineryの読取り専用モード」は選択しないでください。

5. 「追加」をクリックします。

6. Content Serverを再起動します。

7. 「プロバイダ」ページに戻り、プロバイダの「接続状態」の値がgoodになっていることを確認します。
値がgoodでない場合は、これまでのすべての入力値に誤りがないことを再確認するとともに、Content ServerインスタンスとInbound Refineryインスタンスが互いにping可能なことを確認します。

11.2.3.3.2 Inbound RefineryでのPDFExportConverterの有効化

PDFExportConverterはOutsideInを使用してドキュメントをPDFファイルに直接変換します。この変換はプラットフォームをまたがって実行でき、サード・パーティ製品は何も必要としません。Inbound Refineryに対してPDFExportConverterをサーバー機能として有効化できます。

Inbound RefineryでPDFExportConverterを有効化する手順は次のとおりです。

1. 「Inbound Refinery管理」メニューから「管理サーバー」を選択し、「コンポーネント・マネージャ」を選択します。

2. 「PDFExportConverter」を選択して「更新」をクリックします。

3. 「OK」をクリックして、この機能を有効化します。

4. Inbound Refineryを再起動します。

PDFコンバータ設定を設定する手順は次のとおりです。

1. Inbound Refineryに再びログインします。

2. 「変換設定」を選択し、「プライマリWebレンディション」を選択します。

3. 「PDFエクスポートによるPDFへの変換」を選択します。

4. 「変換設定」を選択し、「追加レンディション」を選択します。

5. 「Outside Inを使用するサムネイル・イメージの作成」を選択します。

6. 「変換設定」→「サードパーティ・アプリケーションの設定」→「標準のOutsideInフィルタ・オプション」→「オプション」を選択します。

7. フォントへのパスをInbound Refineryシステム上のフォントに設定します。

8. 「UNIXレンダリング・オプション」で、「内部グラフィック・レンダリングの使用」を選択します。

9. 「更新」をクリックします。

詳細は、Oracle Fusion Middleware Conversion管理者ガイドのプライマリWeb表示可能レンディションとしてのPDFファイルの設定に関する項を参照してください。

11.2.3.3.3 変換するファイル・フォーマットの選択

どのファイルを変換対象としてInbound Refineryに送信するかをContent Serverに示すために、ファイル・フォーマットを選択する必要があります。

変換するファイル・フォーマットを選択する手順は次のとおりです。

1. 「Content Serverの管理」メニューから、「リファイナリ管理」を選択し、ファイル・フォーマット・ウィザードを選択します。

注意:

Inbound Refineryインスタンスへの有効な送信プロバイダがない場合や、InboundRefinerySupportコンポーネントが有効化されていない場合には、「リファイナリ管理」はリストに表示されません。

Content Serverによって「ファイル・フォーマット・ウィザード」ページが表示されます。このページでは、Content Serverへのチェックイン時に変換対象としてInbound Refineryに送信するファイル・フォーマットを構成します。

2. 変換対象のフォーマットを選択します。
変換対象としてInbound Refineryに送信するすべてのファイル・タイプを確実に選択してください。HTMLは選択しません。また、wikiとブログについても、WebCenterConversionsコンポーネントを介してこれらの変換を有効化していない場合は選択しないでください。この有効化については、第11.2.3.3.4項「WikiおよびブログのPDFへの変換の有効化」で説明します。

3. 「更新」をクリックします。

11.2.3.3.4 WikiおよびブログのPDFへの変換の有効化

オプション

WebCenter PortalアプリケーションでwikiおよびブログのPDFへの変換を有効化するためには、まず次のことを実行する必要があります。

- Inbound RefineryとのOpenOffice統合の設定。詳細は、Oracle Fusion Middleware Conversion管理者ガイドのプライマリWeb表示可能レンディションとしてのPDFファイルの設定に関する項を参照してください。

- Oracle Fusion Middleware Conversion管理者ガイドのOpenOfficeクラス・ファイルのクラスパスの設定に関する項で説明している手順を実行します(ホストにログインしないでOpenOfficeを使用する方法に関する項も参照してください)。

wikiおよびブログのPDFへの変換を有効化するには、まず、Inbound RefineryサーバーとContent Serverのそれぞれで、WebCenterConversionsコンポーネントをインストールし、HTMLのPDFへの変換を実行するOpenOfficeを構成する必要があります。WebCenterConversionsコンポーネントによってHtmToPDFOpenOffice変換オプションが追加されます。このオプションでは、Inbound RefineryでOpenOffice変換が活用されます(したがって、そのInbound Refineryに対してOpenOfficeが構成されていることが必要です)。

次に示す手順は順序どおり実行する必要がある点に注意してください。Inbound Refineryをインストールおよび有効化せずに、ファイル・フォーマット・ウィザードでWikiおよびブログを選択して有効化すると、Inbound Refineryの変換キューでWikiおよびブログ・ドキュメントがスタックします。

ヒント:

Oracle Fusion Middleware Conversion管理者ガイドのOpenOfficeによってPDFに変換されるファイル・フォーマットに関する項も参照してください。

WebCenterConversionコンポーネントをインストールする手順は次のとおりです。

1. Inbound Refineryサーバーにログインします。

2. 「管理」をクリックし、「管理サーバー」を選択します。
Inbound Refineryの「管理サーバー」ページが表示されます。

3. 「コンポーネント・マネージャ」で、「拡張コンポーネント・マネージャ」リンクをクリックします。
「コンポーネント・マネージャ」ページが表示されます。

4. 「新規コンポーネントのインストール」セクションで、コンパニオンCDから「WebCenterConversions.zip」を選択して「インストール」をクリックします。
WebCenterConversionコンポーネントが「無効なコンポーネント」ボックスに表示されます。

5. 「WebCenterConversion」を選択して「有効化」を選択します。

6. Inbound Refineryサーバーを再起動します。

WebCenterConversionコンポーネントを有効化する手順は次のとおりです。

1. Inbound Refineryサーバーで、「変換設定」の下にある「変換リスト」リンクをクリックします。
これにより、「変換リスト」ページが表示されます。

2. 「変換」表で、HtmToPDFOpenOfficeに対して「承認」チェック・ボックスを選択して「更新」をクリックします。

関連付けられたContent Serverインスタンスの、Content Serverのファイル・フォーマット・ウィザードで、Wikiとブログのオプションが表示されるようになります。

Content ServerでWikiおよびブログのPDFへの変換を有効化する手順は次のとおりです。

1. Content Serverにログインします。

2. 「管理」ノードを開き、「リファイナリ管理」を開いて、ファイル・フォーマット・ウィザードをクリックします。

3. 「ファイル・タイプの選択」で、「Wiki」および「ブログ」チェック・ボックスを選択して「更新」をクリックします。

11.2.3.4 Content Serverに対するSSLの設定

リポジトリ接続を作成するSpacesまたはFrameworkアプリケーションとContent Serverが、同じシステム上または信頼できる同じプライベート・ネットワーク上にない場合、アイデンティティ伝播はセキュアではありません。セキュアなアイデンティティ伝播を保証するには、さらにContent Serverに対してSSLを設定する必要があります。Content Serverに対するSSLの設定手順の詳細は、第33.7項「SSLを使用したSpacesからContent Serverへの接続の保護」を参照してください。

11.2.3.5 WebCenter PortalでのiFrame化UIの有効化

オプションですが、強くお薦めします

WebCenter Portalアプリケーション(つまり、SpacesおよびFrameworkアプリケーション)では、ドキュメント・マネージャのドキュメント・レンディションや拡張メタデータ編集などの特定の機能に対して、iFrameに表示されたContent Server UIが使用されます。iFrameはドメイン間の通信をサポートしていないため、WebCenter PortalアプリケーションとContent Serverが(Webアドレスにおいて)同じドメインにない場合は、後述の説明に従ってOracle HTTP Server (OHS)を構成する必要があります。この構成を行わないと、iFrame化機能を使用できません。

注意:

iFrame化のサポートを有効化する前に、第31.2.5項「Oracle HTTP Serverのインストールと構成」の説明に従って、Oracle HTTP Server (OHS)のインストールと構成を完了しておく必要があります。

WebCenter PortalアプリケーションでiFrame化UIを有効化する手順は次のとおりです。

1. mod_wl_ohs.confファイルを開いて、このファイルが適切なContent Serverインスタンスを指していることを確認します。
このファイルのデフォルトの場所は、OHS_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1/mod_wl_ohs.confです。

2. Content Serverの接続プロパティを次のように更新します。
webContextRoot='/cs'

この設定は、OHSが設定されていない場合や、正しく動作していない場合には、設定しないでください。

3. Content Serverが複数ある場合には、別のコンテキスト・ルートを使用するように2番目のサーバーを再構成します。

4. Content ServerおよびadfAuthentication保護URI情報でmod_wl_ohs.confファイルを更新することによって、OHSを構成します。次に例を示します。

<Location /cs>
SetHandler weblogic-handler
WeblogicHost example.com
WeblogicPort 9400
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WeblogicHost example.com
WeblogicPort 9400
</Location>

mod_wl_ohs.confファイルによるOHSの構成の詳細は、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

5. SpacesまたはFrameworkアプリケーションを開いて、iFrame化機能が使用可能なことを確認します。
これでWebCenter PortalアプリケーションのフロントエンドがOHSになったため、SpacesまたはFrameworkアプリケーションにはOHSを介してアクセスする必要がある点に注意してください。したがって、次のように指定してアプリケーションにアクセスします。

http://<host>:<OHSPort>/webcenter

次に例を示します。

http://example.com:7777/webcenter

11.2.3.6 SESクローラの構成

オプション

SESクローラの構成は、第22.6.2項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」の手順に従ってください。

11.2.3.7 Site Studioの設定

オプションですがお薦めします

Site Studioの構成はオプションですが、この構成を行わないと、コンテンツ・プレゼンタでのSite Studio関連のアセットの作成および使用はできません。

Site Studioを有効化する手順は次のとおりです。

1. Content Serverにログインして、「管理サーバー」ページを開きます。
「コンポーネント・マネージャ」ページが表示されます。

2. 「すべての機能」をクリックします。
ドキュメント管理、フォルダ、Inbound Refinery、統合およびWebコンテンツ管理カテゴリのすべてのコンポーネントが表示されます。

3. 有効化する各コンポーネントのチェック・ボックスを選択します。次のコンポーネントを有効化する必要があります。

- LinkManager

- SiteStudio

- SiteStudioExternalApplications

- DBSearchContainsOpSupport (Oracle Text Searchに対しては不要)
Site Studioでは、Oracle Text Searchまたはフルテキスト検索がサポートされています(メタデータ検索はサポートされていません)。Oracle Text Searchを構成する場合は、DBSearchContainsOpSupportは有効化しないでください。しかし、フルテキスト検索を構成する場合は、Site Studio Designerを正しく動作させるためにDBSearchContainsOpSupportを有効化する必要があります。

4. 「更新」をクリックします。

5. Content Serverインスタンスを再起動します。

6. Content Serverに再度ログインして、「管理」ページを開きます。

7. 「Site Studioの管理」を選択し、「デフォルトのプロジェクト・ドキュメント情報の設定」を選択します。

8. デフォルトを受け入れて「更新」をクリックします。

9. 「Site Studioの管理」を選択し、「デフォルトのWebアセット・ドキュメント情報の設定」を選択します。

10. デフォルトを受け入れて「更新」をクリックします。

11. Site Studio Designerを使用するには、Content Serverコンソールにログインし、「ダウンロード」に移動して、Site Studio Designerのダウンロードとインストールを実行します。

11.2.3.8 OracleTextSearchの有効化

オプションですがお薦めします

OracleTextSearchはオプションですが、フルテキスト検索用にOracleTextSearchオプションを使用することをお薦めします。デフォルトでは、Content Serverが使用するデータベースは、メタデータのみの検索および索引付けの機能を提供するように設定されます。しかし、フルテキストの検索および索引付け機能も追加でサポートするように、データベースのデフォルト構成を変更できます。

このオプションはOracle Databaseとの組合せでのみ使用可能なことに注意してください。メイン・スキーマに対して使用するデータベース・タイプにかかわらず、Oracle DatabaseにOracleTextSearchの索引が常に含まれている必要があります。詳細は、Oracle WebCenter Contentインストール・ガイドのOracle Content Server用のOracle Text Searchの構成に関する項と、Oracle WebCenter Content Serverアプリケーション管理者ガイドのSite Studioの統合に関する項を参照してください。

11.2.3.9 Content Serverでのコンテンツ・プロファイルの作成

オプション

WebCenter PortalアプリケーションでiFrame化が有効化されている場合、ユーザーは必要に応じて、Content Serverプロファイルを使用してコンテンツをアップロードできます。Content Serverプロファイルの詳細は、Oracle WebCenter Content Serverアプリケーション管理者ガイドのプロファイルを使用したコンテンツ画面のカスタマイズに関する項を参照してください。

Oracle WebCenter Content Serverユーザーズ・ガイドの付録「ユーザー・インタフェース」にあるコンテンツ・チェックイン・フォームに関する項で説明している各フィールド(表を参照)は、Content Serverでは必須です。どのコンテンツ・プロファイルもこれらを含んでいる必要があります。含んでいないと、チェックインが失敗します。表に示されているように、一部のフィールドは非表示フィールドまたは情報フィールドとしてプロファイルに追加できます。

Content Serverプロファイルには、Content Serverにファイルをアップロードするために必要となる必須フィールドに加えて、ドキュメント・ライブラリおよびSpacesでアップロード・プロファイルを正しく動作させるための次のフィールドも含める必要があります。

- xCollectionID: フォルダ名の永続化用

- xIdcProfile: プロファイル値の永続化用

- dRevLabel: 新しいバージョンのチェックインを可能にするために、CHECKIN_SEL_FORM APIで必要

これらのフィールドを非表示フィールドとしてプロファイルに追加できます。

11.2.3.10 WebCenter Portalアプリケーションでのアイテム・レベル・セキュリティの構成

オプション

ドキュメント・サービスでは、アイテム・レベル・セキュリティ(ILS)を使用して、デフォルトのSpacesドキュメント・セキュリティ・モデルを上書きしたり、FrameworkアプリケーションでContent Serverドキュメント・セキュリティを公開することができます。ILSにより、Content Serverフォルダ(およびその子)または個々のドキュメントが一意のセキュリティ権限を保有できます。

この項の内容は次のとおりです。

- 第11.2.3.10.1項「アイテム・レベル・セキュリティに関する必要な知識」

- 第11.2.3.10.2項「アイテム・レベル・セキュリティの構成」

- 第11.2.3.10.3項「WebCenter Portal: Frameworkアプリケーション用の追加設定の構成」

11.2.3.10.1 アイテム・レベル・セキュリティに関する必要な知識

Oracle WebCenter Portalでは、ファイルまたはフォルダにカスタムの権限を設定できます。この機能は、アイテム・レベル・セキュリティ(ILS)と呼ばれます。この機能を構成した後は、ファイルまたはフォルダが表示されているときに、WebCenter Portal管理コンソールから「ファイル」→「セキュリティ」を選択することによって、この機能にアクセスできます(第36.6.1項「コンテンツの管理」を参照)。

注意:

Spacesでは、ユーザー数が増大すると、スペースのプライマリ・セキュリティ・メカニズムとしてILSを使用することは管理が困難になる場合があります。また、ILSはSpacesセキュリティ・モデルほど効果的でないことがあります。そのためILSの使用は、Spacesセキュリティ・モデルに収まらないドキュメントまたはフォルダに対してセキュリティを定義する場合のみとすることをお薦めします。たとえば、限定されたユーザー・セットのみがアクセス可能なドキュメントおよびフォルダなどです。セキュリティの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペースのロールと権限の管理に関する項を参照してください。

ILSを使用して、既存のファイルまたはフォルダのセキュリティをカスタムの権限セットに置換できます。

- カスタム権限は、ファイルに適用された場合は、そのファイルにのみ影響します。

- フォルダに適用された場合は、更新後のセキュリティがすべての子のファイルとフォルダに再帰的に伝播され、固有のカスタム権限が設定されたフォルダが検出されると、そこで伝播が停止されます。ファイルに固有のカスタム権限がすでに設定されている場合、そのファイルには伝播は影響しません。

注意:

ILSは、Spacesアプリケーション内のスペースのルート・フォルダには適用できません。これは、スペースのファイルまたはフォルダのアイテム・レベル・セキュリティが削除されたときに、そのファイルまたはフォルダに対して、そのスペースのセキュリティを適切にリストアするためです。

Content Server内で、ILSはACL、アカウントおよび他のメタデータ・フィールド設定の組合せとして実装されます。ILSを有効化するには、Content Serverが適切に構成されていることが必要です。第11.2.3.10項「WebCenter Portalアプリケーションでのアイテム・レベル・セキュリティの構成」および第11.2.3.12項「Content ServerとWebCenter Portal: Frameworkアプリケーション間のセキュリティの構成」を参照してください。

カスタム権限を設定したときにContent Serverで行われる処理

「アイテム・レベルのセキュリティ」ダイアログでファイルまたはフォルダに対してカスタム権限を設定すると、Content Serverで次の処理が実行されます。

- アカウントがアカウントWCILS/original_accountに変更されます。
デフォルトですべてのAUTHENTICATEDユーザーにアカウントWCILSに対するRWDAが付与され、すべてのPUBLICユーザーにWCILSに対するRが付与されます。アカウントがWCILS/original_accountに変更されることで、確実にカスタム権限のみによってコンテンツのセキュリティが決定されるようになります。

- ACLコンテンツ・メタデータ・フィールドxClbraUserListおよびxClbraRoleListがカスタム権限によって更新されます。(xClbraUserListにはドキュメントまたはフォルダに対してユーザーが持つ権限が格納され、xClbraRoleListにはそのドキュメントまたはフォルダに対してグループが持つ権限が格納されます。)

- コンテンツ・メタデータ・フィールドxInhibitUpdateがtrueに設定され、ILSがアイテム自体のカスタム・セキュリティを親フォルダのカスタム権限で上書きしないようにします。

カスタム権限を削除したときにContent Serverで行われる処理

フォルダまたはファイルからカスタム権限を削除すると、そのアイテムのセキュリティをそのアイテムの親フォルダに設定されたセキュリティに戻す処理が試みられます。カスタム権限を削除すると、Content Server内で次の変更が行われます。

- そのアイテムのアカウントが親フォルダのアカウントに変更されます。

- そのアイテムのACLコンテンツ・メタデータ・フィールドxClbraUserListおよびxClbraRoleListが消去されます。

- コンテンツ・メタデータ・フィールドxInhibitUpdateがfalseに設定されます。

これらの変更は、アイテム・レベル・セキュリティの設定時と同じように伝播されます。

WebCenter Portal: Frameworkアプリケーションでアイテム・レベル・セキュリティを使用するときの前提条件

WebCenter Portalアプリケーションにおいて、アイテム・レベル・セキュリティ(ILS)機能は、そのアプリケーションのContent Serverセキュリティ構成が特定の前提条件を満たしている場合にのみサポートされます。ほとんどのシナリオではILSは必要ではないため、明示的に必要な場合以外はILSを有効化しないでください。一般に、ILSは、アプリケーションでセキュリティ・ポリシーの例外ケースを処理するために、ドキュメントごとに個別ユーザーまたはユーザー・グループに対してContent Serverセキュリティ・モデルを上書きまたは補足する必要がある場合に使用されます。ILSの使用時にはパフォーマンスへの影響と追加の管理オーバーヘッドが発生する点に注意してください。

注意:

Content Serverセキュリティは、アイテム・レベル・セキュリティよりも効果的で、また多数のユーザーおよびコンテンツ・オブジェクトに対して適応しやすいため、Content Serverセキュリティを使用することをお薦めします。管理面では、Content Serverのセキュリティはメンテナンスもより容易です。セキュリティの構成の詳細は、第11.2.3.12項「Content ServerとWebCenter Portal: Frameworkアプリケーション間のセキュリティの構成」を参照してください。

WebCenter PortalアプリケーションでのContent ServerのセキュリティにおけるILSの前提条件は次のとおりです。

- セキュリティがContent Serverのアカウントのみに基づいていること。
すべてのコンテンツにセキュリティ・グループが設定されていることも必要であるため、これは、アプリケーションのすべてのユーザーに、そのアプリケーションのセキュリティ・グループに対するRWD権限が付与されている必要があることを意味します。この要件は、カスタム権限を設定すると、そのアカウントは自動的に、すべてのユーザーにRWDAが付与されるアカウントWCILS/original_accountに変更されるというILSの動作によるものです。この変更によって、ドキュメントまたはフォルダのセキュリティがカスタム権限のみによって決定されるようになります。

- アプリケーション・コンテンツ全体に対して、コンテンツ・メタデータ・フィールドxForceFolderSecurityがtrueに設定されていること。それによって、Folderのセキュリティ設定がその子のフォルダとドキュメントに強制されます。これは、カスタム権限の伝播をサポートするために必要です。

11.2.3.10.2 アイテム・レベル・セキュリティの構成

アイテム・レベル・セキュリティ(ILS)を構成する手順は次のとおりです。

1. Content Serverインスタンスにログオンします。

2. 「管理」メニューから「管理サーバー」を選択して「コンポーネント・マネージャ」を開きます。

3. 「コンポーネント・マネージャ」セクションで、「拡張コンポーネント・マネージャ」リンクをクリックします。

4. 「拡張コンポーネント・マネージャ」ページで、下へスクロールして「無効なコンポーネント」リストに移動し、「RoleEntityACL」(図11-2を参照)を選択して「有効化」をクリックします。

関連項目:

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのファイルのセキュリティ・オプションの設定に関する項

図11-2 拡張コンポーネント・マネージャ: RoleEntityACLコンポーネント

「図11-2 拡張コンポーネント・マネージャ: RoleEntityACLコンポーネント」の説明

5. 左側の「オプション」ペインで「一般構成」を選択します。

6. 「一般構成」ページの「追加の構成変数」ボックスに次のパラメータを追加します。

UseEntitySecurity=1
SpecialAuthGroups=PersonalSpaces,securityGroup

各要素の意味は次のとおりです。

SpecialAuthGroupsは、セキュリティ・グループのカンマ区切りリストです(値間に空白は入れないでください)。ILSオプションはこれらのセキュリティ・グループのコンテンツに対してのみ有効化されます。

- WebCenter Portalアプリケーションの場合、securityGroupはコンテンツの作成場所のセキュリティ・グループ名です。

- Spacesの場合、Spacesデータを格納するセキュリティ・グループの名前は、ドキュメント・スペース・プロパティのアプリケーション名と同じです。アプリケーション名はFusion Middleware ControlまたはWLSTを使用して見つけることができます。
Fusion Middleware Controlでは、アプリケーション名は、Spaces接続にContent Serverのデフォルト接続の一部として表示されます。

WLSTでは、アプリケーション名は、listDocumentsSpacesPropertiesコマンドを使用することによって、表示されます。次に例を示します。

listDocumentsSpacesProperties('webcenter')

The Documents Spaces container is "/myspacesroot"
The Documents repository administrator is "weblogic"
The Documents application name is "myspacesapp" <- applicationName
The Documents primary connection is "myucm"

7. Content Serverを再起動します。

11.2.3.10.3 WebCenter Portal: Frameworkアプリケーション用の追加設定の構成

Frameworkアプリケーションの場合は、第11.2.3.10.2項「アイテム・レベル・セキュリティの構成」で説明している手順に加えて、デフォルトですべてのユーザーにWCILSアカウントに対するRWDAが確実に付与されるようにする必要もあります。そのためには、SET_DEFAULT_ATTRIBUTESサービスを使用します。SET_DEFAULT_ATTRIBUTESサービスの詳細は、Oracle WebCenter Content Servicesリファレンス・ガイドのSET_DEFAULT_ATTRIBUTESに関する項を参照してください。

ブラウザを使用してSET_DEFAULT_ATTRIBUTESサービスを実行する手順は次のとおりです。

1. ブラウザから、管理ユーザーとしてContent Serverにログインします。

2. ページのソースを表示し、var idcToken =を含む行を検索することによって、idcTokenの値(例: var idcToken = 1316188662243:6FE5F809A3B122277B7A1D19912FBB5)を見つけます。

3. また、同じブラウザ・ウィンドウで次の形式のURLを入力します。

http://host:port/cs/idcplg?IdcService=SET_DEFAULT_ATTRIBUTES&dECPropSubKey=<Security Group>&dDefAttribs=account,WCILS,15&idcToken=<idcToken>&IsSoap=1

次に例を示します。

http://myhost.com:4444/cs/idcplg?IdcService=SET_DEFAULT_ATTRIBUTES&dECPropSubKey=Custom&dDefAttribs=account,WCILS,15&idcToken=1291297336399:6E324367FC9D2F8BE525F4CEBF4463FC&IsSoap=1

11.2.3.11 追加のオプション構成

この項では、追加のオプション構成について説明します。これらの構成はContent Serverを適切に機能させるために必須ではありませんが、これらに構成によって価値が得られ、Content Serverのエンタープライズ・インストールのベスト・プラクティスが確立されます。

この項の内容は次のとおりです。

- 第11.2.3.11.1項「File Store Providerの構成」

- 第11.2.3.11.2項「ノード・マネージャの設定」

11.2.3.11.1 File Store Providerの構成

Content Serverシステムでは、コンテンツの格納および整理のための従来のファイル・システムのかわりに、データ管理用のファイル・ストアが使用されます。File Store Providerコンポーネントは、(ドキュメントが格納されていない)新しいContent Serverインスタンスに対して、デフォルトでインストール、有効化およびアップグレードされます。File Store Providerコンポーネントは、このコンポーネントによって公開される機能(Web、ボールトおよびWeb URLパス表現の変更など)を活用するために、デフォルトのファイル・ストア(DefaultFileStore)を自動的にアップグレードします。

File Store ProviderコンポーネントはContent Serverインタフェースでファイル・ストア機能を公開し、追加の構成オプションを使用可能にします。たとえば、バイナリ・ラージ・オブジェクト(BLOB)データ型を使用して、ファイル・システムのかわりにデータベースにコンテンツを格納するように、Content Serverインスタンスを構成できます。

File Store Providerでは、チェックインされたコンテンツおよび関連付けられたメタデータが、システム管理者が設定した基準に基づいて調べられ、これらにストレージ・ルールが割り当てられます。基準には、メタデータ、プロファイルまたはその他の考慮事項を含めることができます。ストレージ・ルールによって、Content ServerシステムによるボールトおよびWebファイルの格納方法と、これらへのWebサーバーからのアクセス方法が決まります。

File Store Providerコンポーネントを使用することによって、Content Serverシステムの管理対象のコンテンツの格納とコンテンツへのアクセスのためのデータドリブン・ルールを定義できます。次に示す構成手順では、ファイル・システム上ではなくデータベースにコンテンツが確実に格納されるようにするためのストレージ・ルールが作成されます。

ストレージ・ルールを作成する手順は次のとおりです。

1. システム管理者としてContent Serverインスタンスにログインします。

2. 「管理」を選択し、「プロバイダ」を選択します。
「プロバイダ」ページが表示されます。

3. DefaultFileStoreプロバイダの隣にある「アクション」列で「情報」をクリックします。
「ファイル・ストア・プロバイダ情報」ページが表示されます。

4. ルール名(例: DBStorage)を指定し、JDBCストレージを選択します。

5. 「OK」をクリックします。
「ファイル・ストア・プロバイダの編集」ページが表示されます。

6. 「更新」をクリックします。

7. Content Serverインスタンスを再起動します。

11.2.3.11.2 ノード・マネージャの設定

Content Serverおよびこのサーバーが配置されているドメイン内の他のサーバーの構成および管理の追加手順として、Oracle WebLogic Serverノード・マネージャの使用も考えられます。ノード・マネージャを使用すると、WebLogic Serverインスタンスのリモートからの起動および停止、これらの監視、および予期しない障害発生後の自動再起動が可能になります。Content Server、管理サーバーおよびノード・マネージャが同じWebLogic Serverドメイン内でともに動作するように、これらを構成できます。ノード・マネージャは、いずれかのサーバー・インスタンスをホストするすべてのマシンにインストールされます。ノード・マネージャの使用の詳細は、Oracle WebCenter Contentインストール・ガイドのOracle WebCenter Contentでのノード・マネージャの使用に関する項を参照してください。

11.2.3.12 Content ServerとWebCenter Portal: Frameworkアプリケーション間のセキュリティの構成

Frameworkアプリケーションでは必須

Frameworkアプリケーションと連携するようにContent Serverを構成するには、まず開発環境でコンテンツ・セキュリティとユーザーを設定してから、これらを本番環境に移行する必要があります。セキュリティの詳細は、Oracle WebCenter Content Content Serverシステム管理者ガイドの「セキュリティとユーザー・アクセスの管理」の章も参照してください。

この項では、次の必須手順について説明します。

- セキュリティ・グループの作成: フォルダかドキュメントかを問わず、コンテンツ・アイテムはすべて、セキュリティ・グループ内に配置されている必要があります。フォルダ・コンテンツの表示、編集または管理を誰が行うかに基づいて、フォルダ・コンテンツを制限したり、コンテンツへのアクセスをカスタマイズしたりできるようにするために、フォルダにはセキュリティ・グループが必要です。セキュリティ・グループを作成するには、第11.2.3.12.1項「Content Serverコンソールを使用したセキュリティ・グループの作成」の手順に従ってください。

- ロールの作成: ロールは、読取り、書込み、削除、管理などの様々な権限付きで作成され、セキュリティ・グループに対する権限の定義に使用されます。まず、第11.2.3.12.2項「Content Serverコンソールを使用したロールの作成」の説明に従って、Content Serverでロールを作成し、その後、第11.2.3.12.3項「Fusion Middleware Controlを使用したロール(グループ)の作成」の説明に従って、WebCenter Portalアプリケーションに対してロールを作成する必要があります。

- フォルダの作成: フォルダ内には、ファイル、サブフォルダ、イメージなどのコンテンツが含まれます。フォルダを作成するには、第11.2.3.12.4項「Content Serverコンソールを使用したフォルダの作成」の手順に従ってください。

- ユーザーの作成: 各ユーザーには、組織内におけるそれぞれのロールと職責に基づいて異なるロールが割り当てられます。第11.2.3.12.5項「Fusion Middleware Controlを使用したユーザーの作成」の説明に従ってユーザーを作成し、その後、第11.2.3.12.6項「Fusion Middleware Controlを使用したユーザーへのロールの付与」の説明に従ってこれらのユーザーにロールを付与します。

- セキュリティの移行: これらのセキュリティ・グループ、フォルダ、ユーザーおよびロールを本番環境に移行します。詳細は、第11.2.3.12.7項「本番環境へのセキュリティの移行」を参照してください。

- 構成の確認: セキュリティ・グループとロールが正しく作成されていることを、第11.2.3.12.8項「セキュリティ・グループおよびロール構成の確認」の説明に従って確認します。

この項で説明する手順は、ドキュメント・サービス(wikiおよびブログを含む)とコンテンツ・プレゼンタに適用されます。

11.2.3.12.1 Content Serverコンソールを使用したセキュリティ・グループの作成

セキュリティ・グループを作成する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「管理」メニューから「管理アプレット」を選択します。

3. 「管理アプレット」ページで「ユーザー管理」をクリックし、「ユーザー管理」ダイアログを表示します。

4. 「セキュリティ」メニューから「グループの権限」を選択します。

5. 「グループの権限」ダイアログで、「グループの追加」をクリックします。

6. 「新しいグループの追加」ダイアログで、WikiBlogなどのグループ名を入力します。

7. 「OK」をクリックします。

セキュリティ・グループが作成されます。このセキュリティ・グループは、第11.2.3.12.4項「Content Serverコンソールを使用したフォルダの作成」でフォルダを作成するときに使用します。

11.2.3.12.2 Content Serverコンソールを使用したロールの作成

この項では、Frameworkアプリケーションで設定するロールを模倣した2つのロール(セキュリティ・グループに対する読取り権限のみを付与するロールと、セキュリティ・グループに対するすべての権限を付与するロール)をContent Serverで設定する方法を説明します。

ロールを作成する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「管理」メニューから「管理アプレット」を選択します。

3. 「管理アプレット」ページで「ユーザー管理」をクリックし、「ユーザー管理」ダイアログを表示します。

4. 完全なアクセス権を持つ新しいロールを作成します。

1. 「セキュリティ」メニューから「ロールの権限」を選択します。

2. 「グループの権限」ダイアログで、「新しいロールの追加」をクリックします。

3. 「新しいロールの追加」ダイアログで、WikiBlogなどの名前を入力します。

4. 「OK」をクリックします。これにより、「ロールの権限」ダイアログが表示されます。

5. 「グループ/権限」列で、第11.2.3.12.1項「Content Serverコンソールを使用したセキュリティ・グループの作成」の説明に従って事前に作成したセキュリティ・グループ(例: WikiBlog)を選択します。

6. 「アクセス権の編集」をクリックします。

7. 「アクセス権の編集」ダイアログで、「読取り」、「書込み」、「削除」および「管理者」のすべてのチェック・ボックスを選択して「OK」をクリックします。
RWDAアクセス権が有効化されます(図11-3)。

図11-3 RWDA権限

「図11-3 RWDA権限」の説明

5. 読取りアクセス権のみを持つ別のロール(例: WikiBlogRO)を作成します。4aから4fまでの手順に従い、手順4gの「アクセス権の編集」ダイアログで「読取り」チェック・ボックスを選択します。

11.2.3.12.3 Fusion Middleware Controlを使用したロール(グループ)の作成

この項では、Framworkアプリケーションで2つのロール(読取りアクセス権を持つロールと、読取り、書込み、削除および管理の完全なアクセス権を持つロール)を作成する手順について説明します。

ロール(グループ)を作成する手順は次のとおりです。

1. 管理者としてFusion Middleware Controlにログインします。

2. 「ドメイン構造」で「セキュリティ・レルム」をクリックします。

3. 「セキュリティ・レルムのサマリー」セクションの表で、「myrealm」などをクリックします。
重要: myrealmでは、Oracle WebCenter Portalに付属している組込みLDAPが使用されます。インストール環境で別のLDAPを使用している場合は、組込みLDAPではなく、使用しているLDAPを選択する必要があります。

4. 「ユーザーとグループ」タブを選択し、「グループ」サブタブを選択します。

5. 「グループ」セクションで「新規」をクリックして、「新しいグループの作成」セクションを表示します。

6. 「名前」フィールドに、Content Serverで、第11.2.3.12.2項「Content Serverコンソールを使用したロールの作成」の説明に従って完全アクセス権を付与したロール(例: WikiBlog)を入力して、「OK」をクリックします。

7. 手順5および6を実行して、読取り権限を持つロールまたはグループ(例: WikiBlogRO)を作成します。このロールの名前は、Content Serverで第11.2.3.12.2項「Content Serverコンソールを使用したロールの作成」の説明に従って指定した名前と一致している必要があります。

11.2.3.12.4 Content Serverコンソールを使用したフォルダの作成

フォルダを作成する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「コンテンツの参照」メニューから「コントリビューション・フォルダ」を選択して、フォルダの作成先のルート・ディレクトリを表示します。

3. 「コントリビューション・フォルダ」ページで、「新規アイテム」メニューから「新規フォルダ」を選択して、「階層フォルダ構成」ページを表示します。

4. 「仮想フォルダ名」フィールドに、わかりやすい名前(例: WikiBlog)を入力します。

5. 「フォルダ情報」セクションの「タイトル」フィールドに、わかりやすいタイトル(例: WikiBlog)を入力します。

6. 「セキュリティ・グループ」ドロップダウンから、第11.2.3.12.1項「Content Serverコンソールを使用したセキュリティ・グループの作成」の説明に従って作成したセキュリティ・グループを選択します。
このフォルダ内のすべてのアイテムが、このセキュリティ・グループからセキュリティを継承します。

7. 「保存」をクリックします。

11.2.3.12.5 Fusion Middleware Controlを使用したユーザーの作成

この項では、2人のユーザー(読取りロールのユーザーと、読取り、書込み、削除および管理の完全なアクセス・ロールのユーザー)を作成する手順について説明します。

ユーザーを作成する手順は次のとおりです。

1. 管理者としてFusion Middleware Controlにログインします。

2. 「ドメイン構造」で「セキュリティ・レルム」をクリックします。

3. 「セキュリティ・レルムのサマリー」の表で「myrealm」(統合LDAPと連携する組込みレルム)をクリックします。

4. 「ユーザーとグループ」タブを選択し、「ユーザー」サブタブを選択します。

5. 「ユーザー」セクションで「新規」をクリックして、「新しいユーザーの作成」セクションを表示します。

6. 「名前」フィールドに名前(例: Joe)を入力します。

7. 「パスワード」フィールドにパスワードを指定します。

8. 「パスワードの確認」フィールドにパスワードを再入力して、「OK」をクリックします。

9. 手順4から8を実行して、もう1人のユーザーを作成します。

11.2.3.12.6 Fusion Middleware Controlを使用したユーザーへのロールの付与

この項では、第11.2.3.12.3項「Fusion Middleware Controlを使用したロール(グループ)の作成」で作成したロールを、第11.2.3.12.5項「Fusion Middleware Controlを使用したユーザーの作成」で作成したユーザーに割り当てる手順について説明します。

ユーザーにロールを割り当てる手順は次のとおりです。

1. 管理者としてFusion Middleware Controlにログインします。

2. 「ドメイン構造」で「セキュリティ・レルム」をクリックします。

3. 「セキュリティ・レルムのサマリー」の表で「myrealm」(統合LDAPと連携する組込みレルム)をクリックします。

4. 「ユーザーとグループ」タブを選択し、「ユーザー」サブタブを選択します。

5. 「ユーザー」セクションの表で、第11.2.3.12.5項「Fusion Middleware Controlを使用したユーザーの作成」で作成したユーザーの名前をクリックして、設定セクションを表示します。

6. 「グループ」タブを選択します。

7. 「親グループ」の「使用可能」列で、第11.2.3.12.3項「Fusion Middleware Controlを使用したロール(グループ)の作成」で作成した読取り権限を持つロール(例: WikiBlogRO)を選択します。

8. このロールを「選択済み」列に移動して「保存」をクリックします。

9. 手順5から8を繰り返して、作成したもう1人のユーザーに完全なアクセス権限を持つロールを付与します。

11.2.3.12.7 本番環境へのセキュリティの移行

開発環境から本番環境へのセキュリティの移行の詳細は、第28.2.5項「デプロイ後のセキュリティ構成タスク」を参照してください。

11.2.3.12.8 セキュリティ・グループおよびロール構成の確認

構成が完了したら、次の手順に従って、セキュリティ・グループおよびロールが正しく作成されていることと、ルート・フォルダが作成されていることを確認します。

セキュリティ・グループおよびロールが作成されていることを確認する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「管理」メニューから「管理アプレット」を選択します。

3. 「管理アプレット」ページで「ユーザー管理」をクリックし、「ユーザー管理」ダイアログを表示します。

4. 「セキュリティ」メニューから「グループの権限」を選択します。

5. 「グループの権限」ダイアログで、セキュリティ・グループが「グループ」リストに表示されていることを確認します。セキュリティ・グループIDの名前は、Spacesドキュメント・プロパティにあるアプリケーション名と同じである必要があります。

6. 「グループ」リストでセキュリティ・グループを選択します。

7. 「ロール」リストに、グループ・スペースに対するR権限を持つ<applicationName>Userロールと、RWD権限を持つ<applicationName>AuthenUserロールの2つが含まれていることを確認します。

ルート・フォルダが作成されていることを確認する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「コンテンツの参照」メニューで、ルート・フォルダが表示されていることを確認して、そのフォルダを選択します。

3. 子のフォルダspacetemplateが表示されていることを確認します。

4. 「情報」をクリックして、「階層フォルダ情報」画面を表示します。

5. セキュリティ・グループが正しいことを確認します。

11.2.3.13 Content Server接続の登録

Frameworkアプリケーションでは必須/Spacesではオプションですが強くお薦めします

Frameworkアプリケーションの場合、構成したContent Serverを使用するには、アプリケーションとContent Server間の接続を構成する必要があります。Spacesの場合、アプリケーションの最初の起動時に接続が自動的に構成されますが、少なくとも接続のテストを行って、期待されるデータが正しくシードされていることを確認してください。

この項の内容は次のとおりです。

- 第11.2.3.13.1項「Frameworkアプリケーション用のContent Server接続の構成」

- 第11.2.3.13.2項「Spaces用のContent Server接続の構成」

- 第11.2.3.13.3項「Content ServerにシードされたSpacesデータの確認」

11.2.3.13.1 Frameworkアプリケーション用のContent Server接続の構成

Content Serverのインストールと構成が完了したら、次に、FrameworkアプリケーションとContent Server間の接続を構成します。接続の構成の詳細は、第11.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」または第11.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」を参照してください。

11.2.3.13.2 Spaces用のContent Server接続の構成

SpacesとContent Server間の接続は、アプリケーションの最初の起動時に自動的に構成されますが、少なくとも接続のテストを行って、使用している環境用に正しく構成されていることを確認してください。高可用性環境やシングル・サインオン環境では、Spacesのホストおよびポート設定を変更する必要がある場合があります。

Content Serverのインストールおよび構成が完了し、Spacesを再起動したら、第11.11.1項「Content Server接続のテスト」の説明に従って、SpacesからContent Serverへの接続が正しく構成されていることを確認します。接続が正しく構成されていなかった場合は、第11.10項「Spacesコンテンツ・リポジトリの接続プロパティの設定」の説明に従って接続を構成します。Content Serverは、Spacesインスタンスを再起動する前に必ず稼働させておく必要があります。

ドキュメント・サービスなどの一部のWebCenter Portalコンポーネントは、Spacesの最初の起動時にContent Serverにシードされるデータを使用します。Spacesで他のコンポーネントを構成する前に、期待されるデータが正しくシードされていることを、第11.2.3.13.3項「Content ServerにシードされたSpacesデータの確認」の説明に従って確認してください。また、次のことにも注意してください。

11.2.3.13.3 Content ServerにシードされたSpacesデータの確認

Spacesの最初の起動時には、デフォルトのデータ・セットがContent Serverにシードされます。Spacesインスタンスに対してContent Serverにシードされるデータは、アクティブなコンテンツ・リポジトリ接続のドキュメント・スペース・プロパティに基づきます。次に例を示します。

Root folder = /WebCenter1
Application Name= WC1

データが正しくない場合や、部分的にしかシードされていない場合は、SpacesのログとContent Serverの構成を確認して、ドキュメント・スペース・プロパティに必要な修正を行います。その後、Spacesインスタンスを再起動してデータを再シードしてください。Content Serverは、Spacesインスタンスを再起動する前に必ず稼働させておく必要があります。デフォルトのコンテンツ・リポジトリの設定、およびSpacesコンテンツ・リポジトリに必要な追加のドキュメント・スペース・プロパティの設定の詳細は、第11.8項「コンテンツ・リポジトリ接続の詳細の変更」を参照してください。

表11-3は、シードされるグループ・スペース・データ(「シードされるデータ」)、シードされるデータのネーミング(「ネーミング」)、およびContent Serverにデータがシードされていることの確認方法(「検証」)を示しています。

表11-3 シードされるグループ・スペース・データ

シードされるデータ

ネーミング

検証

セキュリティ・グループ

1つのセキュリティ・グループがシードされます。

ApplicationName

例: WC1

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「グループの権限」に移動します。

ロール

2つのロールがシードされます。

- ApplicationName
User (セキュリティ・グループに対するR権限を持つ)

- ApplicationName
AuthenUser (セキュリティ・グループに対するRWD権限を持つ)

例: WC1UserおよびWC1AuthenUser

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「ロールの権限」に移動します。

ルート・フォルダ名

RootFolder
(Security Group =<ApplicationName>)

例: /WebCenter1

コンテンツを参照します(フォルダはトップレベルのフォルダとしてリストされます)。

デフォルト属性 - パブリック・ユーザー

すべてのパブリック・ユーザーには次の権限があります。

- アカウント接頭辞PUBLICに対する読取り権限

- アカウント接頭辞WCILSに対する読取り権限

- ApplicationNameUserロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントPUBLICおよびWCILSと、ロール<ApplicationName>Userが含まれていることを確認します。

デフォルト属性 - 認証されたユーザー

認証されたすべてのユーザーには次の権限があります。

- アカウント接頭辞AUTHENに対する読取り権限

- アカウント接頭辞WCILSに対する読取り、書込み、削除、管理権限

- ApplicationNameAuthenUserロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントAUTHENおよびWCILSと、ロールApplicationNameAuthenUserが含まれていることを確認します。

ワークフロー

次の3つのワークフローがシードされます。

- ApplicationNameAllApprover

- ApplicationNameAllReviewer

- ApplicationNameSingleApprover

例: WC1AllApprover、WC1AllReviewerおよびWC1SingleApprover

Content Serverで、「管理」→「ユーザー管理」→「ワークフロー管理」→「条件」タブに移動します。

同じContent Serverを使用しているSpacesインスタンスの数にかかわらず、個人用スペースのデータはContent Serverに1回のみシードされます。したがって、複数のSpacesインスタンスで同じContent Serverを使用している場合、これらのインスタンスは同じ個人用スペース・データを共有することになります。

表11-4は、シードされる個人用スペース・データ(「シードされるデータ」)、シードされるデータのネーミング(「ネーミング」)、およびContent Serverにデータがシードされていることの確認方法(「検証」)を示しています。

表11-4 シードされる個人用スペース・データ

シードされるデータ

ネーミング

検証

セキュリティ・グループ

1つのセキュリティ・グループがシードされます。

PersonalSpaces

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「グループの権限」に移動します。

ロール

2つのロールがシードされます。

- PersonalSpacesRole (セキュリティ・グループPersonalSpacesに対するR権限を持つ)

- PersonalSpacesAuthenRole
(セキュリティ・グループPersonalSpacesに対するRWD権限を持つ)

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「ロールの権限」に移動します。

ルート・フォルダ名

PersonalSpaces
(Security Group=PersonalSpaces)

コンテンツを参照します(フォルダはトップレベルのフォルダとしてリストされます)。

デフォルト属性 - パブリック・ユーザー

すべてのパブリック・ユーザーには次の権限があります。

- ルート・フォルダのアカウントに対する読取り権限

- PersonalSpacesロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントPEWebCenter/PUと、ロールPersonalSpacesRoleが含まれていることを確認します。

デフォルト属性 - 認証されたユーザー

認証されたすべてのユーザーには次の権限があります。

- PersonalSpacesAuthenRoleロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、ロールPersonalSpacesAuthenRoleが含まれていることを確認します。

11.3 Microsoft SharePointリポジトリの構成

WebCenter PortalアプリケーションからMicrosoft SharePointコンテンツ・リポジトリにアクセスするには、Microsoft SharePoint用Oracle WebCenterアダプタをインストールする必要があります。Microsoft SharePoint用Oracle WebCenterアダプタは次の機能をサポートしています。

- Microsoft SharePointリポジトリのコンテンツおよびメタデータの読取り

- SharePointドキュメント・ライブラリへのファイルおよびフォルダの書込み

- Microsoft SharePointシステムに対する問合せの実行

- Microsoft SharePointのネイティブ認証および認可の活用による、アクセス対象コンテンツに対するSharePointセキュリティ設定の有効化

すべての機能は、Microsoft SharePointコンテンツおよびサービスへのインタフェースとしてMicrosoft SharePointのネイティブWebサービスを使用して実装されます。

この項では、WebCenter PortalアプリケーションをMicrosoft SharePointに接続するための前提条件について説明します。

- 第11.3.1項「Microsoft SharePoint: インストール」

- 第11.3.2項「Microsoft SharePoint: 構成」

- 第11.3.3項「Microsoft SharePoint: セキュリティに関する考慮事項」

- 第11.3.4項「Microsoft SharePoint: WebCenter Portalでの制限事項」

- 第11.3.5項「WLSTを使用したMicrosoft SharePoint接続の管理」

注意:

SpacesでMicrosoft SharePoint接続を有効にするには、Oracle Technology Network (http://www.oracle.com/technetwork/middleware/webcenter/overview/index.html)で提供されているホワイトペーパー、SharePoint 2007アダプタのWebCenter Spacesとの統合を参照してください。

11.3.1 Microsoft SharePoint: インストール

この項の内容は次のとおりです。

- 第11.3.1.1項「Microsoft SharePoint Serverのインストールに関する必要な知識」

- 第11.3.1.2項「Microsoft SharePoint用Oracle WebCenterアダプタのインストール」

- 第11.3.1.3項「Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール」

11.3.1.1 Microsoft SharePoint Serverのインストールに関する必要な知識

Oracle WebCenter Portalは次のMicrosoft SharePointバージョンをサポートしています。

- Microsoft Office SharePoint Server (MOSS) 2007 SP2

- Microsoft Windows SharePoint Services (WSS)バージョン3 SP2

注意:

anonymousアクセス用に構成されたMicrosoft SharePointサイトについては、アダプタによるサポートの対象外です。

インストールの詳細は、該当するMicrosoft SharePointドキュメントを参照してください。

Oracle WebCenter Portalは、Microsoft SharePoint 2007ドキュメント・ライブラリの次のバージョン設定をサポートしています。

- チェックアウトを必須にする: いいえ

- コンテンツの承認: いいえ

- ドキュメントの改訂履歴: バージョンを管理しない

他のバージョン設定が構成されている場合、Microsoft SharePoint用Oracle WebCenterアダプタは正しく機能しません。たとえば、Require CheckOutがyesに設定されていると、アップロード操作が失敗します。同様に、ドキュメントの改訂履歴またはコンテンツの承認が有効化されていると、新しいバージョンまたはドキュメントの表示が制限されます。

11.3.1.2 Microsoft SharePoint用Oracle WebCenterアダプタのインストール

Microsoft SharePoint用Oracle WebCenterアダプタのファイルは、Oracle WebCenter Companion DVD内のofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zipファイルに含まれています。このZIPファイルを一時的な場所に抽出すると、TEMP_LOCATION/WebCenter/services/content/adaptersディレクトリにアダプタ・ファイルが見つかります。

開始前の作業:

Microsoft SharePoint用WebCenterアダプタは、WebCenter Portalアプリケーションと同じ管理対象サーバーにインストールする必要があります。WebCenter Portalアプリケーション・デプロイメントに適した管理対象サーバーをまだ作成していない場合は、第7.1.4項「管理対象サーバーの作成」および第7.1.5項「メタデータ・サービス・リポジトリの作成および登録」の説明に従って作成してください。

WebCenter Portalアプリケーション用にMicrosoft SharePoint用WebCenterアダプタをインストールする手順は次のとおりです。

1. WLS管理コンソールにログインします。
WLS管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. WLS管理コンソールのホーム・ページに移動します。

3. 「ドメイン構造」ペインで「デプロイメント」をクリックします。

4. 「デプロイメントのサマリー」セクションの「制御」で「インストール」をクリックします。

5. 「アプリケーション・インストール・アシスタント」の注意で、テキストの本文内の「ファイルをアップロード」リンクをクリックします。

6. 「デプロイメント・アーカイブ」の隣にある「参照」をクリックして、TEMP_LOCATION/WebCenter/services/content/adaptersディレクトリからoracle.webcenter.content.jcr.sharepoint.earファイルを選択します。これは、Oracle WebCenter Companion DVDからofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zipのコンテンツを抽出した一時ディレクトリです。「次へ」をクリックします。

7. EARファイルが正常にアップロードされたことを通知するメッセージ(図11-4)が表示されたら、「次へ」をクリックします。

図 11-4 アプリケーション・インストール・アシスタント

「11-4 アプリケーション・インストール・アシスタント」の説明

8. 「このデプロイメントをライブラリとしてインストールする」を選択して、「次へ」をクリックします。

9. 「デプロイ・ターゲットの選択」で、WebCenter Portal: Frameworkアプリケーションをデプロイする管理対象サーバーを選択します。これは、WebCenter Portalの初期設定の管理対象サーバーの1つではなく、(カスタム・ポータル・テンプレートに基づく)カスタムの管理対象サーバーである必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドのテンプレートを使用したカスタムの管理対象サーバーの作成に関する項を参照してください。

10. 「次へ」をクリックします。

11. 「オプション設定」で、デフォルトを受け入れて「終了」をクリックします。

11.3.1.3 Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール

1. Oracle WebCenter Companion DVDに含まれているofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zipファイルから、DocLibSharePointWLST.pyファイルとDocLibGenericWLST.pyファイルを抽出します。これらのファイルは/WebCenter/services/content/adaptersディレクトリにあります。

2. 抽出したDocLibSharePointWLST.pyファイルとDocLibGenericWLST.pyファイルをコピーして、ORACLE_HOME/common/wlstディレクトリに貼り付けます。

3. WLSTコマンドを実行するには、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WLSTを使用した接続の管理の詳細は、第11.3.5項「WLSTを使用したMicrosoft SharePoint接続の管理」を参照してください。

11.3.2 Microsoft SharePoint: 構成

WebCenter PortalアプリケーションでMicrosoft SharePoint接続を有効化するには、次のタスクを実行する必要があります。

1. WebCenter Portalアプリケーションをデプロイすることを計画している管理対象サーバーに、Microsoft SharePoint用Oracle WebCenterアダプタをインストールします。

2. JDeveloperで、Microsoft SharePointリポジトリへの接続を構成します。これは、アプリケーション・ナビゲータの「アプリケーション・リソース」に作成されたアプリケーション接続である必要があります。

3. (オプション) JDeveloperで、Microsoft SharePointリポジトリ接続を使用するドキュメント・タスク・フローを追加します。

4. WebCenter Portalアプリケーションをデプロイします。
デプロイ後、JDeveloperで構成したMicrosoft SharePointリポジトリにWebCenter Portalアプリケーションからアクセスできます。

5. (オプション)必要に応じて、デプロイ後にMicrosoft SharePoint接続の詳細を再構成します。

1. デプロイ後にMicrosoft SharePoint接続を管理するためのWLSTコマンド・スクリプトをインストールします。

2. 既存の接続の詳細を変更するか(setJCRSharePointConnection)、または新しいMicrosoft SharePointリポジトリ接続を作成します(createJCRSharePointConnection)。

注意:

SpacesでMicrosoft SharePoint接続を有効にするには、Oracle Technology Network (http://www.oracle.com/technetwork/middleware/webcenter/overview/index.html)で提供されているホワイトペーパー、SharePoint 2007アダプタのWebCenter Spacesとの統合を参照してください。

11.3.3 Microsoft SharePoint: セキュリティに関する考慮事項

Microsoft SharePoint接続では、アイデンティティ伝播による認証はサポートされていません。しかし、外部アプリケーションを使用して、Microsoft SharePointリポジトリに対してユーザーを認証できます。使用する外部アプリケーションを指定するには、WLST引数extAppIdを使用します。詳細は、第11.3.5.1項「createJCRSharePointConnection」を参照してください。extAppIdで参照している外部アプリケーション接続に対してパブリック資格証明も共有資格証明も定義されていない場合は、ドキュメント・タスク・フローによって資格証明の入力が求められます。これによって、アイデンティティ伝播の代替方法として、ユーザーごとの資格証明のマッピングが可能になります。

11.3.4 Microsoft SharePoint: WebCenter Portalでの制限事項

Spacesアプリケーションでは、Microsoft SharePointはプライマリ・ドキュメント・ストアとしてサポートされていません。したがって、かわりにOracle WebCenter Contentを使用する必要があります。

11.3.5 WLSTを使用したMicrosoft SharePoint接続の管理

デプロイ後にSharePointコンテンツ・リポジトリへの接続を管理するには、表11-5に示すコマンドを使用します。

これらのWebCenter Portal WLSTコマンドを使用して行った構成変更は、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動しないと有効になりません。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

表11-5 SharePointコンテンツ・リポジトリWLSTコマンド

コマンド

目的

WLSTの状態

createJCRSharePointConnection

Microsoft SharePoint 2007リポジトリ接続の作成

オンライン

setJCRSharePointConnection

Microsoft SharePoint 2007リポジトリ接続の編集

オンライン

listJCRSharePointConnections

WebCenter Portalアプリケーション用に構成されているすべてのMicrosoft SharePoint 2007接続のリスト

オンライン

Microsoft SharePoint用WLSTスクリプトのインストール方法の詳細は、第11.3.1.3項「Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール」を参照してください。

11.3.5.1 createJCRSharePointConnection

createJCRSharePointConnection WLSTコマンドは、Microsoft SharePoint 2007リポジトリへの接続を作成します。このWLSTコマンドの構文およびその他の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateJCRSharePointConnectionに関する項を参照してください。

注意:

WebCenter Portalアプリケーションについては、createJCRSharePointConnectionコマンドは、アプリケーションがMicrosoft SharePoint接続をサポートするように最初から開発されている場合にのみ機能します。元のWebCenter Portalアプリケーション・デプロイメントにMicrosoft SharePoint接続が含まれていない場合、このコマンドを使用して作成する新しいMicrosoft SharePoint接続をサポートするために必要なコードはアプリケーションに組み込まれません。第11.3.2項「Microsoft SharePoint: 構成」も参照してください。

11.3.5.2 setJCRSharePointConnection

このWLSTコマンドは、既存のMicrosoft SharePoint 2007リポジトリ接続を編集します。このWLSTコマンドの構文およびその他の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetJCRSharePointConnectionに関する項を参照してください。

11.3.5.3 listJCRSharePointConnections

このWLSTコマンドは、指定されたWebCenter Portalアプリケーション用に構成されているすべてのSharePoint接続をリストします。このWLSTコマンドの構文およびその他の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistJCRSharePointConnectionに関する項を参照してください。

11.4 Oracle Portalリポジトリの構成

次の各項では、Oracle Portalコンテンツ・リポジトリの前提条件について説明します。

- 第11.4.1項「Oracle Portal: インストール」

- 第11.4.2項「Oracle Portal: 構成」

- 第11.4.3項「Oracle Portal: セキュリティに関する考慮事項」

- 第11.4.4項「Oracle Portal: WebCenter Portalでの制限事項」

11.4.1 Oracle Portal: インストール

Oracle Portalのインストールの詳細は、Oracle Fusion Middleware Installation Oracle Portal、Forms、ReportsおよびDiscovererインストール・ガイドを参照してください。

11.4.2 Oracle Portal: 構成

最新のパッチの適用によりOracle Portalが最新の状態になっていることが必要です。パッチの詳細は、製品のリリース・ノートを参照してください。Oracle Fusion Middleware Oracle Portal管理者ガイドも参照してください。

11.4.3 Oracle Portal: セキュリティに関する考慮事項

なし。

11.4.4 Oracle Portal: WebCenter Portalでの制限事項

Oracle WebCenter PortalとのOracle Portal統合は読取り専用です。Oracle WebCenter PortalからOracle Portalにコンテンツを作成することはできません。

Oracle PortalでポートレットとしてOracle Portalページを公開することによって、フェデレーテッド・ポータル・アダプタを使用してWebCenter PortalアプリケーションでOracle Portalページを公開できます。次のものはフェデレーテッド・ポータル・アダプタによって返されないため、Oracle WebCenter Portalでは表示されません。

- シードされたページ・グループ:

- Oracle Portalリポジトリ

- Oracle Portalデザインタイム・ページ

- 次のタイプのページ:

- モバイル

- URL

- ナビゲーション・ページ

- 次のタイプのアイテム:

- ナビゲーション・アイテム

- PLSQLアイテム

- ポートレット

- ポートレット・インスタンス

- URLアイテム

- モバイル・アイテム

- ページ・リンク

- アイテム・リンク

- 次のように定義されているアイテム:

- 期限切れ

- 非表示

11.5 ファイル・システム・リポジトリの構成

次の各項では、ファイル・システム・コンテンツ・リポジトリの前提条件について説明します。

- 第11.5.1項「ファイル・システム: セキュリティに関する考慮事項」

- 第11.5.2項「ファイル・システム: WebCenter Portalでの制限事項」

注意:

ファイル・システム接続は、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。この機能は、開発用としてのみ提供されます。ファイル・システム・アダプタを使用して作成した接続は、Oracle JDeveloperを使用したWebCenter Portalアプリケーションの開発時に使用できます。

WebCenter Portal: Spacesアプリケーションでは、ファイル・システム接続はサポートされていません。

11.5.1 ファイル・システム: セキュリティに関する考慮事項

すべての操作が、JVMの実行元であるシステム・ユーザーとして実行され、その権限を継承します。

11.5.2 ファイル・システム: WebCenter Portalでの制限事項

ファイル・システム接続は、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。また、索引がないため、検索機能が制限され、低速です。この機能は、開発用としてのみ提供されます。

11.6 コンテンツ・リポジトリの登録

この項の内容は次のとおりです。

- 第11.6.1項「Spaces用のコンテンツ・リポジトリの登録に関する必要な知識」
第11.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」

- 第11.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」

11.6.1 Spaces用のコンテンツ・リポジトリの登録に関する必要な知識

WebCenter Portal: Spaces用のコンテンツ・サーバー・リポジトリを登録する際には、次の点を考慮してください。

- Spacesは、起動時に、Spacesのプライマリ/アクティブ/デフォルト・リポジトリにシード・データを作成します(このデータがまだ存在しない場合)。

- Spacesでは、Microsoft SharePointなどの別のリポジトリが使用可能になっている場合でも、Content Serverリポジトリ接続をプライマリ接続として常に提供する必要があります。

- Content Serverインスタンスに対する管理権限を持つユーザー名が必要です(Content Administrator)。Spacesコンテンツ、セキュリティ・グループおよびロール用のフォルダの作成と保守、およびコンテンツへのアクセス権の管理には、このユーザーが使用されます。デフォルトのコンテンツ管理者はsysadminです。
Spacesユーザーにかわって操作を実行できるようにするために、この接続には管理権限が必要です。

- Root FolderとApplication Nameの値:

- Spacesでのアクティブな接続用に、Root FolderとApplication Nameの値を使用してSpacesリポジトリにシード・データが作成され、それによってスペース関連データの格納が可能になります。

警告:

Root FolderとApplication Nameの値は個別に変更しないでください。これらは常に両方変更する必要があります。つまり、Spacesを構成し、実行した後にRoot Folder値を変更する場合は、Application Nameも変更する必要があります(逆の場合も同様です)。つまり、Spacesアプリケーションにすでにシード・データが格納されている場合は、両方(Root FolderおよびApplication Name)の値を一意の値に変更する必要があります。

これらの値を変更しても、Content Serverリポジトリ内の既存のシード・データの名前は変更されません。かわりに、アプリケーションを起動したときに、新しい値を使用して新しいシード・データが作成されます。アプリケーションが起動すると、新しいRoot Folderの下に新しいSpacesデータが作成され、以前のRoot Folderの下の既存のデータは使用できなくなります。つまり、以前、Root Folderの変更前にドキュメント・サービスが有効であったSpacesで、ドキュメント・サービスが無効化されます。

注意:

Root FolderとApplication Nameの値が変わっても、以前のルート・コンテンツ・リポジトリ・フォルダは、Content Serverの他のあらゆるルート・フォルダと同様に、引き続き検索結果に表示されます。

- Root Folder値は、すべてのSpacesコンテンツの格納場所である、コンテンツ・リポジトリ内のルート・フォルダの名前として使用されます。Root Folder値には、まだ存在していないコンテンツ・リポジトリ・フォルダを指定する必要があります。形式は/foldernameを使用します。たとえば、/MyWebCenterSpacesのようになります。Root Folderを/ (ルート自体)にすることはできません。また、様々なWebCenter Portalアプリケーション間で一意にする必要があります。WebCenter Portalアプリケーションの起動時に、指定したフォルダが作成されます。無効なエントリの例: /、/foldername/、/foldername/subfolder。

- Application Nameはこのコンテンツ・リポジトリ内でSpacesアプリケーションを識別します。これには一意の値(例: MyWCS)を指定する必要があります。この名前は14文字以内とし、英字を先頭に、英数字またはアンダースコア文字の任意の組合せで構成する必要があります。ここで指定した名前は、<applicationName><WorkflowName>および<applicationName><WorkflowStepName>として、ドキュメント関連のワークフローのネーミングにも使用されます。ワークフローのネーミング時には、Application Nameの先頭の14文字のみが使用されます。
Application Name値の用途は次のとおりです。

- 複数のSpacesアプリケーションが同じコンテンツ・リポジトリを共有しており、アプリケーション間で一意にする必要があるときにデータを分離するために使用する。

- シードされるワークフローおよびワークフロー手順の接頭辞として使用する。

- Spacesアプリケーションで作成されたすべてのデータを格納するセキュリティ・グループの名前として使用する。

- ロールの接頭辞として使用する(名前の書式はapplicationNameUserおよびapplicationNameAuthenUser)。

- 特定のSpacesアプリケーション用にアカウントに対するユーザー権限をストライプ化するために使用する。

- 特定のSpacesアプリケーション用にデフォルトの属性をストライプ化するために使用する。

セキュリティ・グループおよびロールの詳細は、Content Serverのセキュリティとユーザー・アクセスの管理を参照してください。フォルダの詳細は、フォルダおよびWebDav管理ガイドを参照してください。これらのガイドは、http://download.oracle.com/docs/cd/E10316_01/owc.htmで利用できます。

11.6.2 Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録

Fusion Middleware Controlを使用してContent Server、Oracle Portalまたはファイル・システムのコンテンツ・リポジトリを登録するには、次の手順に従ってください。SharePointリポジトリを登録するには、第11.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」に説明に従ってWLSTを使用する必要があります。WLSTを使用したContent Serverリポジトリの登録方法の詳細は、第11.10.2項「WLSTを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定」を参照してください。

Content Server、Oracle Portalまたはファイル・システムのコンテンツ・リポジトリを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesまたはFrameworkアプリケーションのホーム・ページに移動します。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portal: Spacesの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- WebCenter Portal: Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenterサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 新規のコンテンツ・リポジトリに接続するには、「追加」をクリックします(図11-5)。

図11-5 コンテンツ・リポジトリ接続の構成

5. この接続の一意の名前を入力し、コンテンツ・リポジトリ・タイプを指定して、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します。表11-6を参照してください。

表11-6 コンテンツ・リポジトリ接続の管理

フィールド

説明

接続名

このコンテンツ・リポジトリ接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

リポジトリ・タイプ

接続先のリポジトリのタイプを選択します。次のうちから選択します。

- Content Server: Oracle Universal Content Managementリポジトリ。第11.2項「Oracle WebCenter Content Serverリポジトリの構成」を参照してください。

- Oracle Portal: Oracle Portalコンテンツ・リポジトリ。第11.4項「Oracle Portalリポジトリの構成」を参照してください。

- ファイル・システム: コンピュータ・ファイル・システム。第11.5項「ファイル・システム・リポジトリの構成」を参照してください。
注意: ファイル・システム接続は、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。この機能は、開発用としてのみ提供されます。

(Spaces) Spaces用のバックエンド・コンテンツ・リポジトリ、つまりスペース関連のドキュメントを格納するためにSpacesで使用するリポジトリを設定する場合は、「Content Server」を選択する必要があります。

アクティブな接続

このフィールドを選択した場合、これがWebCenter Portalアプリケーションのデフォルトまたはプライマリのコンテンツ・リポジトリとなります。

WebCenter Portalアプリケーションを複数のコンテンツ・リポジトリに接続できます。すべての接続が使用されます。1つの接続をデフォルトの(またはアクティブな)接続として指定する必要があります。次のいずれかを実行します。

- Spacesアプリケーションの場合:
このフィールドを選択した場合、これがアクティブな接続、つまりスペース関連のドキュメントを格納するためにSpacesで使用されるバックエンド・リポジトリとなります。アクティブな接続は、接続先がContent Serverである必要があります。

この接続がSpacesのアクティブな接続である場合は、いくつかの追加構成が必要になります。第11.6.1項「Spaces用のコンテンツ・リポジトリの登録に関する必要な知識」を参照してください。

- Frameworkアプリケーションの場合:
このフィールドを選択した場合、これがアクティブな接続となります。つまり、コンテンツ・プレゼンタ、ドキュメント・マネージャ、ドキュメント・リスト・ビューアおよび最近のドキュメント・タスク・フローのデフォルトの接続となります。これらのタスク・フローに特定の接続の詳細が指定されていない場合は、このデフォルトの(プライマリ、アクティブとも呼ばれます)接続が使用されます。

このオプションの選択を解除しても、コンテンツ・リポジトリ接続は無効化されません。コンテンツ・リポジトリが不要になった場合は、その接続を削除する必要があります。

6. (Spacesのアクティブな接続に対してのみ。) Spacesリポジトリの追加の詳細を入力します。詳細は、第11.6.1項「Spaces用のコンテンツ・リポジトリの登録に関する必要な知識」を参照してください。

7. コンテンツ・リポジトリの接続の詳細を入力します。パラメータの詳細は、次の表を参照してください。

- 表11-7「Content Serverの接続パラメータ」

- 表11-8「接続: Content Server: キャッシュ詳細」

- 表11-9「Oracle Portalの接続パラメータ」

- 表11-10「ファイル・システムの接続パラメータ」

表11-7 Content Serverの接続パラメータ

フィールド

説明

RIDCソケット・タイプ

Content Serverをコンテンツ・サーバー・リスナー・ポートとWebサーバー・ポートのどちらで接続するか、およびリスナー・ポートがSSL対応かどうかを指定します。次のうちから選択します。

- ソケット: intradocソケット接続を使用してContent Serverに接続します。クライアントIPアドレスをContent Serverの認証済アドレスのリストに追加する必要があります。この場合、クライアントはOracle WebCenter Portalを実行しているマシンです。

- ソケットSSL: SSLプロトコルを使用して保護されているContent Serverに、intradocソケット接続を使用して接続します。接続を可能にするには、クライアントの証明書をサーバーのトラスト・ストアにインポートする必要があります。これは最もセキュアなオプションであり、(Spacesなどで)アイデンティティ伝播が必要な場合の推奨オプションです。

- Web: HTTP(S)接続を使用してContent Serverに接続します。

- JAX-WS: HTTP(S)接続を使用してContent Serverに接続します。

Spacesの場合、「Web」オプションではアイデンティティ伝播ができないため、このオプションはアクティブな接続、つまりスペース関連のドキュメントの格納に使用するバックエンドのContent Serverリポジトリには適しません。

サーバー・ホスト

Content Serverを実行しているマシンのホスト名を入力します。

例: mycontentserver.mycompany.com

「RIDCソケット・タイプ」を「ソケット」または「ソケットSSL」に設定した場合は、「サーバー・ホスト」の指定が必須です。

サーバー・ポート

Content Serverがリスニングするポートを入力します。

- ソケット: サーバーでincomingプロバイダに対して指定されているポート

- ソケットSSL: サーバーでsslincomingプロバイダに対して指定されているポート

このプロパティは、Content Server構成ファイルのIntradocServerPort設定に対応するものであり、デフォルトはポート4444です。

「RIDCソケット・タイプ」を「ソケット」または「ソケットSSL」に設定した場合は、「サーバー・ポート」の指定が必須です。

Web URL

Content ServerのWebサーバーURLを入力します。

http://hostname:portnumber/web_root/plugin_rootという形式を使用します。

例: http://mycontentserver/cms/idcplg

「Web URL」は、「RIDCソケット・タイプ」を「Web」に設定した場合に適用されます。

WebサービスURL

JAX-WSプロトコルの使用時にContent Serverへの接続に必要となるWebサービスURLを入力します。

http://hostname:port/web_rootという形式を使用します。

例: http://myhost.com:9044/idcnativews

「WebサービスURL」は、「RIDCソケット・タイプ」を「JAX-WS」に設定した場合に適用されます。

接続タイムアウト(ミリ秒)

Content Serverへのログインに許容される時間(ミリ秒)を指定します。この時間を超えると、接続タイムアウト・メッセージが発行されます。タイムアウトを設定しない場合、ログイン操作での時間制限はありません。

認証方式

次のうちから選択します。

- アイデンティティ伝播: Content ServerとWebCenter Portalアプリケーションで、ユーザーの認証に同じアイデンティティ・ストアを使用します。
(Spaces) Spaces用のアクティブな接続、つまり、スペース関連のドキュメントの格納に使用するコンテンツ・リポジトリでは、「アイデンティティ伝播」を選択する必要があります。

- 外部アプリケーション: 外部アプリケーションによって、Content Serverに対するユーザーの認証を行います。パブリック資格証明、共有資格証明またはマップされた資格証明を使用する場合は、このオプションを選択します。『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のドキュメント・サービスのセキュリティの設定に関する項も参照してください。

認証に外部アプリケーションを使用する場合は、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用して、アプリケーションを指定します。目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

Webサーバー・コンテキスト・ルート

Content ServerのWebサーバー・コンテキスト・ルートを入力します。/<context_root>の形式を使用します。たとえば、/csとなります。

指定した場合、WebCenter Portalアプリケーションで、iFrameに基づく複数のContent Server機能が使用可能になります。これには次が含まれます。

- Content Serverへの新しいファイルや更新されたファイルのアップロード時における、ファイルへのコンテンツ・プロファイルの関連付け
詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの新規ファイルのアップロードに関する項と既存のファイルの新規バージョンのアップロードに関する項を参照してください。

- Oracle AutoVueで利用できるドキュメント確認機能の使用
詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのAutoVueを使用したドキュメントの確認とコラボレーションに関する項を参照してください。

- 拡張ドキュメント・プロパティの編集
詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのファイル・プロパティの使用に関する項を参照してください。

- フォルダおよびファイルのワークフローの詳細の表示
詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのワークフロー割当ての表示に関する項を参照してください。

- スライド・ビューアでのファイルのプレビュー
詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのファイルを開く方法に関する項を参照してください。

- Site Studioの統合
OHS (およびWebContextRoot構成)がなくても、コンテンツ・プレゼンタ内からSite Studioコンテンツの作成や編集を行えますが、作成および編集アクションは、コンテンツ・プレゼンタ・タスク・フロー内で開かれるのではなく、新しいブラウザ・ウィンドウ(またはタブ)が起動されます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタを使用したOracle Site Studioコンテンツの作成または編集に関する項を参照してください。

「Webサーバー・コンテキスト・ルート」プロパティは、「認証方式」を「アイデンティティ伝播」に設定した場合にのみ適用されます。

注意: Webサーバー・コンテキスト・ルートを指定した場合、WebCenter PortalアプリケーションのフロントエンドがOHSになることを表します。Webサーバー・コンテキスト・ルートを指定したにもかかわらず、OHSを介して接続しないと、ドキュメント・ビューアでの拡張メタデータの編集、プロファイルを使用したアップロード、またはスペースでのワークフロー内のコンテンツ・アイテムに対する「詳細」のクリック時に404エラーが発生します。WebCenter PortalアプリケーションのフロントエンドになるOHSの設定の詳細は、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

WebCenter Portalアプリケーションが複数のContent Serverサーバーに接続されている場合は、OHSリダイレクションが正しく動作するように、各Content Serverサーバーに一意のWeb Serverコンテキスト・ルートを設定することをお薦めします。

関連付けられている外部アプリケーション

Content Serverに対するユーザーの認証に使用する外部アプリケーションを選択します。

「関連付けられている外部アプリケーション」は、「RIDCソケット・タイプ」を「Web」に設定した場合、および「RIDCソケット・タイプ」が「ソケット」または「ソケットSSL」(「認証方式」を「外部アプリケーション」に設定)である場合に適用されます。

クライアント・セキュリティ・ポリシー

「RIDCソケット・タイプ」が「JAX-WS」のときに使用するクライアント・セキュリティ・ポリシーを入力します。例: oracle/wss11_saml_token_with_message_protection_service_policy

JAX-WSクライアント・セキュリティ・ポリシーには有効な任意のOWSMポリシーを使用できますが、Content ServerのネイティブWebサービスのIdcWebLoginサービスに対して構成されているセキュリティ・ポリシーに一致していることが必要です。IdcWebLoginサービスの詳細は、『Oracle WebCenter Content Content Server開発者ガイド』のWebCenter Content Webサービスに関する項を参照してください。

使用している環境でグローバル・ポリシー・アタッチメント(GPA)をサポートしている場合は、このフィールドを空白のままにします。

管理者ユーザー名

このContent Serverインスタンスに対する管理権限を持つユーザー名を入力します。このユーザーは、プロファイルに基づくコンテンツ・タイプ情報のフェッチと、キャッシュ無効化のためのドキュメントの変更の追跡に使用されます。

デフォルトはsysadminです。

管理者のパスワード

Content Server管理者のパスワードを入力します。

キー・ストアの場所

セキュリティ・アサーションの署名に使用する秘密鍵が含まれるキーストアの場所を指定します。キー・ストアの場所は絶対パスで指定する必要があります。

例: D:\keys\keystore.xyz

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「キー・ストアの場所」の指定が必須です。

キー・ストア・パスワード

キーストアへのアクセスに必要なパスワードを入力します。

例: T0PS3CR3T

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「キー・ストア・パスワード」の指定が必須です。

秘密鍵の別名

キーストアの中のクライアント秘密鍵の別名を入力します。この秘密鍵は、サーバーに対してメッセージを署名するために使用されます。この秘密鍵に対応する公開鍵をサーバー・キーストアにインポートする必要があります。

特殊文字および空白を含まない別名を指定する必要があります。例: enigma

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「秘密鍵の別名」の指定が必須です。

秘密鍵のパスワード

キー・ストアの秘密鍵の別名とともに使用するパスワードを入力します。

例: c0d3bR3ak3R

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「秘密鍵のパスワード」の指定が必須です。

表11-8 接続:Content Server: キャッシュ詳細

要素

説明

キャッシュ無効化間隔(分)

外部Content Serverコンテンツの変更を確認する頻度を指定します(分単位)。変更されたアイテムは、WebCenter Portalによって自動的にキャッシュから消去されます。

デフォルトは0です。これはキャッシュ無効化を無効にすることを意味します。

最小間隔は2分です。

キャッシュされたドキュメントの最大サイズ(バイト)

Content Serverバイナリ・ドキュメントのキャッシュ可能な最大サイズを入力します(バイト単位)。このサイズより大きいドキュメントは、WebCenter Portalによってキャッシュされません。

デフォルトは102400バイト(100K)です。

使用マシンのメモリー構成と、キャッシュされることが期待されるバイナリ・ドキュメントのタイプに基づいて、この値を調整してください。

表11-9 Oracle Portalの接続パラメータ

フィールド

説明

データソース名

ポータルへの接続に使用するJNDIデータソースの場所を入力します。

例: jdbc/MyPortalDS

データソースは、WebCenter Portalアプリケーションのデプロイ先のサーバーに配置されていることが必要です。

接続タイムアウト(ミリ秒)

Oracle Portalへのログインに許容される時間(ミリ秒)を指定します。この時間を超えると、接続タイムアウト・メッセージが発行されます。タイムアウトを設定しない場合、ログイン操作での時間制限はありません。

認証方式

Oracle Portalに対するユーザーの認証方法を指定します。次のうちから選択します。

- アイデンティティ伝播: WebCenter PortalアプリケーションとOracle Portalで同じユーザー・アイデンティティ・ストアを使用する場合は、このオプションを選択します。

- 外部アプリケーション: Oracle Portalに対するユーザーの認証に外部アプリケーションを使用します。パブリック資格証明、共有資格証明またはマップされた資格証明を使用する場合は、このオプションを選択します。

認証に外部アプリケーションを使用する場合は、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用して、アプリケーションを指定します。

関連付けられている外部アプリケーション

Oracle Portalを外部アプリケーションに関連付けます。外部アプリケーションの資格証明情報を使用してOracle Portalユーザーが認証されます。ドロップダウン・リストから既存の外部アプリケーションを選択するか、または「新規作成」をクリックして、新しい外部アプリケーションを構成できます。

表11-10 ファイル・システムの接続パラメータ

フィールド

説明

ベース・パス

コンテンツを格納するローカル・ファイル・システム上のフォルダへのフルパスを入力します。例: C:\MyContent

注意: ファイル・システム・コンテンツは、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。この機能は、開発用としてのみ提供されます。

8. 「OK」をクリックして、この接続を保存します。

9. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。正常な接続の場合、新しい(アクティブな)接続の使用を開始するにはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。

登録された接続がドキュメント・サービスおよびコンテンツ・プレゼンタ・タスク・フローで使用可能になります。これらのタスク・フローは、WebCenter Portal: SpacesまたはWebCenter Portal: Frameworkアプリケーションでページに追加できます。Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのドキュメント・サービスのタスク・フローおよびドキュメント・コンポーネントでの作業に関する項も参照してください。

11.6.3 WLSTを使用したコンテンツ・リポジトリの登録

Frameworkアプリケーションの新しいコンテンツ・リポジトリ接続の登録には、次のWLSTコマンドを使用します。WLSTを使用したSpaces用のContent Serverリポジトリの登録方法の詳細は、第11.10.2項「WLSTを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定」を参照してください。

- Content Server: createJCRContentServerConnection

- ファイル・システム: createJCRFileSystemConnection

- Oracle Portal: createJCRPortalConnection

- Microsoft SharePoint: createJCRSharePointConnection

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

特定の接続をデフォルト接続として構成するには、isPrimary='1'を設定します。第11.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

11.7 アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

WebCenter Portalアプリケーションでは複数のコンテンツ・リポジトリ接続がサポートされていますが、アクティブな(またはデフォルトの)接続として指定できるコンテンツ・リポジトリ接続は1つのみです。

Spacesでは、アクティブな接続はスペースおよびホーム・スペース・ドキュメントのデフォルトのバックエンド・リポジトリになります。このリポジトリはContent Serverである必要があります。アクティブな接続は、ドキュメント・サービスおよびコンテンツ・プレゼンタ・タスク・フローのデフォルトの接続としても使用されます。

他のWebCenter Portalアプリケーションの場合は、アクティブな接続は、コンテンツ・プレゼンタ、ドキュメント・マネージャ、ドキュメント・リスト・ビューア、最近のドキュメントなどのデフォルトの接続になります。これらのタスク・フローに特定の接続の詳細が指定されていない場合は、デフォルトの(アクティブな)接続が使用されます。

この項の内容は次のとおりです。

- 第11.7.1項「Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」

- 第11.7.2項「WLSTを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」

11.7.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続を変更する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portal: SpacesアプリケーションまたはWebCenter Portal: Frameworkアプリケーションのホームページに移動します。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portal: Spacesの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- WebCenter Portal: Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。
「コンテンツ・リポジトリ接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 「テスト」をクリックして、アクティブ化した接続が機能するかどうかを検証します。接続が正常にアクティブ化されると、更新した接続の使用を開始するにはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。

11.7.2 WLSTを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

既存のコンテンツ・リポジトリ接続をデフォルトの接続として指定するには、次のWLSTコマンドを使用し、isPrimary='1'と指定します。

- Content Server: setJCRContentServerConnection

- ファイル・システム: setJCRFileSystemConnection

- Oracle Portal: setJCRPortalConnection

- Microsoft SharePoint: setJCRSharePointConnection
「listJCRSharePointConnections」も参照してください。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

後からデフォルトのコンテンツ・リポジトリ接続を無効化するには、isPrimary='false'と指定して同じWLSTコマンドを実行します。接続の詳細は保持されますが、この接続はadf-config.xml内に主要な接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

11.8 コンテンツ・リポジトリ接続の詳細の変更

この項の内容は次のとおりです。

- 第11.8.1項「Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の詳細の変更」

- 第11.8.2項「WLSTを使用したコンテンツ・リポジトリ接続の詳細の変更」

- 第11.8.3項「コンテンツ・プレゼンタのキャッシュ設定の変更」

11.8.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の詳細の変更

コンテンツ・リポジトリ接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portal: SpacesアプリケーションまたはWebCenter Portal: Frameworkアプリケーションのホームページに移動します。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、次の表を参照してください。

- 表11-7「Content Serverの接続パラメータ」

- 表11-9「Oracle Portalの接続パラメータ」

- 表11-10「ファイル・システムの接続パラメータ」

6. 「OK」をクリックして、変更を保存します。

7. 「テスト」をクリックして、更新した接続が機能するかどうかを検証します。接続が正常に更新されると、更新した接続の使用を開始するにはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。

11.8.2 WLSTを使用したコンテンツ・リポジトリ接続の詳細の変更

次のWLSTコマンドを使用して、コンテンツ・リポジトリ接続を編集します。

- Oracle WebCenter Content Server: setJCRContentServerConnection

- ファイル・システム: setJCRFileSystemConnection

- Oracle Portal: setJCRPortalConnection

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

特定の接続をアクティブな(またはデフォルトの)接続として構成するには、isPrimary='1'を設定します。第11.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新した(アクティブな)接続の詳細の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

11.8.3 コンテンツ・プレゼンタのキャッシュ設定の変更

すぐに使用できるコンテンツ・プレゼンタ用コンテンツ管理コード、Content Management Interoperability Services (CMIS) REST APIなどがローカル(メモリー内)キャッシュに付属して出荷されます。デフォルトではこのコードでCoherenceは使用されませんが、本番環境ではキャッシュ・メカニズムにCoherenceを使用することをお薦めします。HA環境の場合はCoherenceが必須です。キャッシュに対するCoherenceの有効化は、content-coherence-cache-config.xmlファイルで設定できます。WebCenter Portal: Spacesの場合、このファイルはORACLE_HOME/user_projects/applications/wc_domain/custom.webcenter.spaces.fwk/APP-INF/classes/ディレクトリに格納されています。WebCenter Portalアプリケーションの場合は、開発者が、アプリケーション(EAR)のクラスパスまたはサーバーのシステム・クラスパスにcontent-coherence-cache-config.xmlファイルを作成する必要があります。

例11-1で示しているサンプルのCoherence構成ファイルは、content-app-lib.earファイル内にあります。このEARファイルの場所は、ORACLE_HOME/webcenter/modules/oracle.webcenter.content.integration_11.1.1/content-app-lib.earです。サンプル・ファイルの場所は、/content-app-lib.ear/APP-INF/classes/sample-content-coherence-cache-config.xmlファイルです。このファイルをコピーしてファイル名をcontent-coherence-cache-config.xmlに変更し、顧客のデプロイのニーズに合った値を設定できます。表11-11で、このファイルのキャッシュ・エントリについて説明します。

例11-1 サンプルのCoherence構成ファイル

<!DOCTYPE cache-config SYSTEM "cache-config.dtd">
<cache-config>
<caching-scheme-mapping>
<cache-mapping>
<cache-name>repo.ucm.nodeUidCache.*</cache-name>
<scheme-name>ContentNodeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.nodePathToUidCache.*</cache-name>
<scheme-name>ContentNodeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.securityInfoCache.*</cache-name>
<scheme-name>ContentNodeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.typeNameCache.*</cache-name>
<scheme-name>ContentTypeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.typeNamesCache.*</cache-name>
<scheme-name>ContentTypeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>binaryCache.*</cache-name>
<scheme-name>ContentBinaryCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.searchCriteriaCache.*</cache-name>
<scheme-name>ContentSearchCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name> repo.ucm.indexedFieldsCache.*</cache-name>
<scheme-name>ContentSearchCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.securityUserCache.*</cache-name>
<scheme-name>ContentSecurityCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.profileTriggerValueCache.*</cache-name>
<scheme-name>ContentProfileCaches</scheme-name>
</cache-mapping>
</caching-scheme-mapping>
<caching-schemes>
<!--    The following schemes are all local.  For a clustered deployment,
a distributed, replcated, or other clustered scheme is recommended.
See Coherence documentation for more information.
-->
<local-scheme>
<scheme-name>ContentNodeCaches</scheme-name>
<expiry-delay>1m</expiry-delay>
<high-units>100</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentTypeCaches</scheme-name>
<expiry-delay>30m</expiry-delay>
<high-units>50</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentBinaryCaches</scheme-name>
<expiry-delay>1m</expiry-delay>
<high-units>100000</high-units>
<unit-calculator>
<class-scheme>
<class-name>com.tangosol.net.cache.SimpleMemoryCalculator</class-name>
</class-scheme>
</unit-calculator>
</local-scheme>
<local-scheme>
<scheme-name>ContentSearchCaches</scheme-name>
<expiry-delay>5m</expiry-delay>
<high-units>50</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentSecurityCaches</scheme-name>
<expiry-delay>10m</expiry-delay>
<high-units>50</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentProfileCaches</scheme-name>
<expiry-delay>1h</expiry-delay>
<high-units>100</high-units>
</local-scheme>
<!--
<class-scheme>
<scheme-name>ContentDisabledCaches</scheme-name>
<class-name>com.tangosol.util.NullImplementation$NullMap</class-name>
</class-scheme>
-->
</caching-schemes>
</cache-config>

表11-11 content-coherence-cache-config.xml内のキャッシュ・エントリ

キャッシュ・エントリ名

説明

repo.ucm.nodeUidCache.*

IDに基づくリポジトリのノード・リストを格納します。このキャッシュ・エントリのサイズは、アクティブ・リポジトリ内のノード数に依存します。このキャッシュの期限切れは、ノード・データのリフレッシュのタイミングと、別のアプリケーションからのデータの変更回数に基づきます。キー: ノードのUID: 文字列

値: Content Serverノード・オブジェクト

repo.ucm.nodePathToUidCache.*

パスに基づくリポジトリのノード・リストを格納します。このキャッシュのサイズは、アクティブ・リポジトリ内のノード数に依存します。このキャッシュ・エントリの期限切れは、ノード・データのリフレッシュのタイミングと、別のアプリケーションからのデータの変更回数に基づきます。サイズと有効期限は、nodeUidCacheと同じにする必要があります。

キー: ノードのパス: 文字列

値: ノードのUID: 文字列

repo.ucm.securityInfoCache.*

ノードのキャッシュされたセキュリティ情報を格納します。このキャッシュのサイズは、リポジトリ内のノード数に依存します。このキャッシュの期限切れは、ノードのセキュリティ・データの更新頻度に基づきます。

キー: ノードのUID: 文字列

値: ノードのセキュリティ情報

repo.ucm.typeNameCache.*

コンテンツ・タイプ情報をキャッシュします。このキャッシュのサイズは、リポジトリ内のタイプ数に依存します。このキャッシュの期限切れは、タイプ情報のリフレッシュのタイミングと、別のアプリケーションからのタイプの変更回数に基づきます。

キー: コンテンツ・タイプのUID: 文字列

値: ContentTypeオブジェクト

repo.ucm.typeNamesCache.*

Content Serverに認識されているすべてのタイプ名をキャッシュします。すべてのタイプ名がまとめてキャッシュされるため(1つのキー)、すべてが同時に期限切れになります。

このキャッシュの期限切れは、新規タイプの作成またはタイプの削除の頻度に基づきます。

キー: このキャッシュのキーは"typeNames"1つのみです。

値: 各タイプ名を示すArrayList<String>

binaryCache.*

バイナリ・プロパティ・データをキャッシュします。リポジトリ構成プロパティBinaryCacheMaxEntrySizeよりも小さいバイナリのみがキャッシュされます。

このキャッシュのサイズは、比較的小さい(BinaryCacheMaxEntrySize設定よりも小さい)バイナリ・プロパティの数と使用頻度に依存するか、またはバイナリ・キャッシュに対して使用される合計メモリー量に基づきます。

このキャッシュの期限切れは、バイナリ・データのリフレッシュのタイミングと、別のアプリケーションからのバイナリ・データの変更回数に基づきます。

キー: ノードのUIDとバイナリ・プロパティのUID (nodeUid.propUid): 文字列

値: バイナリ・ストリーム・データ: byte[]

repo.ucm.searchCriteriaCache.*

Content Serverの検索構文に基づくパラメータの検索問合せセットをキャッシュします。このキャッシュのサイズは、繰り返し実行されることが想定される一意の検索数に依存します。

使用されない検索が最終的に期限切れになり、キャッシュ・メモリーを節約できるように、有効期限を設定する必要があります。

キー: 検索問合せパラメータ・セット

値: Content Serverにおける検索問合せパラメータ・セット

repo.ucm.indexedFieldsCache.*

リポジトリの索引付けされた(検索可能な)システム・パラメータを保持します。このキャッシュには次の3つのキーがあります。

- "indexedFields": Content Serverのすべての索引付きフィールドを保持します。

- "indexedFolderProps": フォルダの索引付きシステム・プロパティを保持します。

- "indexedDocProps": ドキュメントの索引付きシステム・パラメータを保持します。

このキャッシュの期限切れは、索引付きフィールドの変更頻度に基づきます。

キー: 文字列

値: Map<String,Boolean>に、各索引付きプロパティ名のキーを保持し、ブール値によって、そのプロパティがソートも可能かどうかを示します。

repo.ucm.securityUserCache.*

ローカル・ユーザー名(現在のアプリケーション)と同じユーザーのContent Serverでの名前とのマッピングをキャッシュします。このキャッシュのサイズは、同時ユーザー数、頻繁なユーザー数またはこの両方に依存します。

このキャッシュの期限切れは、ユーザー・アイデンティティのマッピングの更新頻度に基づきます。

キー: ローカル・ユーザーID: 文字列

値: Content ServerのユーザーID: 文字列

repo.ucm.profileTriggerValueCache.*

ドキュメントの作成時に使用できるように、特定のプロファイルのプロファイル・トリガー値をキャッシュします。このキャッシュの最大エントリ数は、Content Serverサーバーの最大プロファイル数に暗黙的に制限されます。キャッシュ・エントリのサイズは小さくなります。変動のある主なエントリは有効期限です。これは、Content Serverでのプロファイル・トリガー・フィールド値の変更頻度に依存します。この値は、Content Serverシステムでのプロファイルの構成後めったに変わりません。そのため、適切に有効期限を設定してください。

キー: Content Serverのプロファイル名: 文字列

値: Content Serverのプロファイル・トリガー値: 文字列

11.9 コンテンツ・リポジトリ接続の削除

この項の内容は次のとおりです。

- 第11.9.1項「Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の削除」

- 第11.9.2項「WLSTを使用したコンテンツ・リポジトリ接続の削除」

注意:

コンテンツ・リポジトリ接続の削除は、その接続を使用していない場合にのみ行ってください。接続がアクティブとしてマークされている場合は、アクティブ・リストからその接続を除外してから削除します。

11.9.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の削除

コンテンツ・リポジトリ接続を削除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portal: SpacesアプリケーションまたはWebCenter Portal: Frameworkアプリケーションのホームページに移動します。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

11.9.2 WLSTを使用したコンテンツ・リポジトリ接続の削除

WLSTコマンドのdeleteConnectionを使用して、コンテンツ・リポジトリ接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

11.10 Spacesコンテンツ・リポジトリの接続プロパティの設定

スペースおよびホーム・スペース・ドキュメントを格納するためにSpacesで使用されているバックエンドContent Serverリポジトリの接続プロパティを表示、変更および削除できます。具体的には、スペース・コンテンツの格納先のルート・フォルダ、コンテンツ・リポジトリ管理者の名前、およびContent Server上でアプリケーション・データを分離するための一意のアプリケーション識別子を定義できます。

この項の内容は次のとおりです。

- 第11.10.1項「Fusion Middleware Controlを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定」

- 第11.10.2項「WLSTを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定」

11.10.1 Fusion Middleware Controlを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定

Spaces用のコンテンツ・リポジトリの接続プロパティを設定する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、Spacesアプリケーションのホームページに移動します。第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. (Spacesのアクティブな接続に対してのみ。) Spacesリポジトリの接続プロパティを設定します。詳細は、第11.6.1項「Spaces用のコンテンツ・リポジトリの登録に関する必要な知識」を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新した(アクティブな)接続プロパティの使用を開始するには、Spacesアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

11.10.2 WLSTを使用したSpacesコンテンツ・リポジトリの接続プロパティの設定

次のコマンドは、スペースとホーム・スペース・ドキュメントを格納するためにSpacesで使用されているContent ServerリポジトリのプロパティをSpaceアプリケーションで表示、設定および削除する目的でのみ有効です。

- listDocumentsSpacesProperties

- setDocumentsSpacesProperties

- deleteDocumentsSpacesProperties

コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

11.11 コンテンツ・リポジトリ接続のテスト

コンテンツ・リポジトリ接続の設定が完了したら、次の各項の説明に従って接続のテストを行い、コンテンツ・リポジトリにアクセスできることを確認できます。

- 第11.11.1項「Content Server接続のテスト」

- 第11.11.2項「Oracle Portal接続のテスト」

11.11.1 Content Server接続のテスト

ソケット・タイプがwebの接続を検証するには、Content ServerのWebインタフェースにadministratorとしてログインします。ソケット・タイプ接続のURLは、Fusion Middleware Controlから次の手順で取得できます。

1. Fusion Middleware Controlで、「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します(図11-6)。

図11-6 Fusion Middleware Controlの「WebCenterポータル」メニュー

2. 「コンテンツ・リポジトリ接続の管理」ページで、接続を選択して「編集」をクリックします(図11-7)。

図11-7 「コンテンツ・リポジトリ接続の管理」ページ

3. 「コンテンツ・リポジトリ接続の編集」ページでWeb URLをコピーします(図11-8)。

注意:

使用前に、URLから/idcplg/接尾辞を削除してください。

URLの形式: http://host_name/web_root/
例: http://mycontentserver/cms/

図11-8 「コンテンツ・リポジトリ接続の編集」ページ

11.11.2 Oracle Portal接続のテスト

Oracle Portal接続の完全な状態を検証する手順は次のとおりです。

1. Oracle WebLogic管理コンソールの「ドメイン構造」で、「サービス」→「JDBC」を開いて、「データ・ソース」をダブルクリックします(図11-9)。

図11-9 Oracle WebLogic管理コンソール

2. 「JDBCデータ・ソースのサマリー」ページで、テストするデータ・ソースを選択します(図11-10)。

図11-10 「JDBCデータ・ソースのサマリー」ページ

3. 「datasource_nameの設定」セクションで、「監視」タブを選択し、「テスト」タブを選択します。データ・ソースのターゲット・サーバーを選択し、「データ・ソースのテスト」をクリックして、接続をテストします(図11-11)。

図11-11 データ・ソース設定セクション

11.12 最大ファイル・アップロード・サイズの変更

デフォルトでは、ファイルの最大アップロード・サイズは次のとおりです。

- WebCenter Portal: Frameworkアプリケーションでは2MB。このデフォルトは、ブラウザからアプリケーション・サーバーへのファイルのアップロードを処理するApache MyFaces Trinidadによって設定されます。
Frameworkアプリケーション開発者は、web.xmlファイルでorg.apache.myfaces.trinidad.UPLOAD_MAX_DISK_SPACEパラメータを設定することによって、最大ファイル・アップロード・サイズを設計時にカスタマイズできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のコンテンツ・リポジトリにファイルをアップロードするためのパラメータの設定に関する項を参照してください。

デプロイ後に最大アップロード・ファイル・サイズを変更するには、web.xmlファイルを編集する必要があります。詳細は、第A.1.2.2項「WebCenter Portalアプリケーションのweb.xmlプロパティの編集」を参照してください。

- Spacesアプリケーションでは2MB。
システム管理者は、webcenter-config.xmlファイルでuploadedFileMaxDiskSpaceパラメータを編集することによって、最大ファイル・アップロード・サイズをカスタマイズできます。詳細は、第A.1.3項「webcenter-config.xml」を参照してください。

12 アクティビティ・グラフ・サービスの管理

この章では、Oracle WebCenter Portalアプリケーションで使用されるアクティビティ・グラフ・サービスを構成および管理する方法について説明します。

アクティビティ・グラフ・サービスを確認および構成する際には、アクティビティ・グラフ管理、Fusion Middleware ControlまたはWLSTコマンドライン・ツールを必ず使用してください。手動によるファイルの編集は、構成ミスにつながる可能性があるため、(手動による編集を特に指示している場合を除いて)お薦めしません。

この章の内容は次のとおりです。

- 第12.1項「アクティビティ・グラフ・サービスに関する必要な知識」

- 第12.2項「アクティビティ・グラフ・サービスの構成ロードマップ」

- 第12.3項「アクティビティ・グラフ・サービスの前提条件」

- 第12.4項「アクティビティ・グラフ・サービスのデータの準備」

- 第12.5項「類似度計算の理由文字列のカスタマイズ」

- 第12.6項「アクティビティ・グラフ・スキーマのカスタマイズの管理」

- 第12.7項「Oracle Secure Enterprise Searchのアクティビティ・ランクの設定」

- 第12.8項「推奨に関する問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

12.1 アクティビティ・グラフ・サービスに関する必要な知識

アクティビティ・グラフ・サービスは、コネクションの相手としてユーザーが関心を持つ可能性がある人々を、既存のコネクションと、アプリケーション内のオブジェクトとの共有された対話に基づいて提案します。また、現在ユーザーが表示しているスペースやアイテムとの類似する対話に基づいて、ユーザーが関心を持つ可能性があるスペースやコンテンツをユーザーに示します。

アクティビティ・グラフ・サービスが表示するこれらの提案は、アクティビティ・グラフ・エンジンによって収集および分析されたデータに基づきます。アクティビティ・グラフ・エンジンは、エンタープライズ・アプリケーションによって収集されたアクションのセントラル・リポジトリとして機能します。数学的なグラフの観点から考えた場合、アプリケーション・ユーザー、およびユーザーが対話を行うエンタープライズ・コンテンツはそれぞれがノードであり、ユーザー間およびユーザーとコンテンツ間で実行されるアクションは有向エッジです(図12-1)。

図12-1 アクティビティ・グラフ

「図12-1 アクティビティ・グラフ」の説明

アクティビティ・グラフ・サービスでは、次の3つの主要コンポーネントが使用されます。

- Oracle Analytics Event Collector: OpenUsage APIを使用してイベント・データを収集し、アクティビティ・データベースに保存します。

- アクティビティ・グラフ・エンジン: データの収集、類似度スコアの計算および検索ランキングの計算を実行する各エンジンが含まれています。

- アクティビティ・グラフ問合せAPI: アクションの生データと処理済の推奨データを公開するとともに、アクセス権がないために結果を表示したり最新のメタデータによって結果を装飾することができない人々からの結果をフィルタ処理するためのメカニズム(QRPP)を公開します。

図12-2は、これらの異なるコンポーネントがいかに連動するかを示しています。このプロセスについて次に説明します。

図12-2 アクティビティ・グラフ・サービスのアーキテクチャ

「図12-2 アクティビティ・グラフ・サービスのアーキテクチャ」の説明

たとえば、Montyが自分のドキュメントを表示している、などのアクションがWebCenter Portalで発生すると、分析イベント・コレクタによってそのアクションがピックアップされ、アクティビティ・データベース内のイベント表に記録されます。

アクティビティ・データ収集プロセスが開始されると、分析アクティビティ・プロバイダが分析イベント表からアクションを読み取り、登録されているマッピング・セットを使用してアクティビティを生成します。アクティビティはアクションの1回の発生を表します。アクティビティを使用して、アクションの複数の発生が集計されたリレーションが決定され、リレーション表に格納されます。たとえば、Montyが特定のドキュメントを5回表示したという事実は、1つのリレーションを表します。リレーション表内の情報は、推奨と検索ランクの決定に使用されます。

アクティビティ・グラフ問合せAPIは、アクティビティ・グラフ・サービス・タスク・フローで使用され、レシピを使用して推奨用の問合せをリレーション表に対して実行するJava APIです。レシピは類似度計算の重み付けリストです。類似度計算では、特定の基準に基づく2つのオブジェクトの類似度を示す類似度スコア(0から1の範囲の数値)が生成されます。各計算の重み付けにより、推奨スコア全体を決定する際の各計算の重要度が決まります。推奨は、そのトータル推奨スコアで順序付けられます。WebCenter Portalはデフォルトの類似度計算群を備えており、これらの計算がアクティビティ・グラフ・サービス・タスク・フローで使用されます。これらの類似度計算を編集したり、カスタムの類似度計算を作成したりすることが可能です。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のカスタムの類似度計算の定義に関する項を参照してください。

特定のオブジェクトに関する推奨の初期リストが生成された後は、より適切で有用な結果をユーザーに示すために結果をフィルタ処理できます。これには、問合せ結果ポスト・プロセッサ(QRPP)が使用されます。QRPPは推奨結果の現在のリストを取り込み、変更済リストを出力として返します。QRPPでは、現在のユーザーが表示を許可されていないオブジェクトに関する推奨の削除など、推奨のフィルタ処理を実行したり、結果メタデータの追加や変更を行ったりすることができます。

その後、アクティビティ・グラフ・サービス・タスク・フローを通じて、ユーザーに推奨が示されます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のアクティビティ・グラフ・サービス・タスク・フローに関する項を参照してください。

12.2 アクティビティ・グラフ・サービスの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- ロードマップ: Spacesアプリケーション用のアクティビティ・グラフ・サービスの構成
この項のフロー・チャート(図12-3)と表(表12-1)は、Spacesアプリケーションでアクティビティ・グラフ・サービスを動作させるための前提条件と必要なタスクの概要を示しています。

図12-3 Spacesアプリケーション用のアクティビティ・グラフ・サービスの構成

「図12-3 Spacesアプリケーション用のアクティビティ・グラフ・サービスの構成」の説明

表12-1 Spacesアプリケーション用のアクティビティ・グラフ・サービスの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter Portalと分析サービスおよびアクティビティ・グラフ・サービスのバックエンド・コンポーネントをインストールします

2. 次のツールのいずれかを使用して、WebCenter Portal: Spacesと分析コレクタ間の接続を構成します

- Fusion Middleware Control

- WLST

3. (オプション)アクティビティ・グラフ・エンジン・スケジュールを設定します

エンド・ユーザー/

管理者

4. アクティビティ・グラフ・データがSpacesアプリケーションで使用可能なことをテストします

4.a Spacesにログインし、コンテンツの追加などによりこれと対話します(エンド・ユーザー)

4.b アクティビティ・グラフ・エンジンを実行します(管理者)

4.c アクティビティ・グラフ・タスク・フロー(プロファイル・ページでの推奨接続タスク・フローなど)で推奨を表示します(エンド・ユーザー)

- ロードマップ: Frameworkアプリケーション用のアクティビティ・グラフ・サービスの構成
この項のフロー・チャート(図12-4)と表(表12-2)は、Frameworkアプリケーションでアクティビティ・グラフ・サービスを動作させるための前提条件と必要なタスクの概要を示しています。

図12-4 Frameworkアプリケーション用のアクティビティ・グラフ・サービスの構成

「図12-4 Frameworkアプリケーション用のアクティビティ・グラフ・サービスの構成」の説明

表12-2 Frameworkアプリケーション用のアクティビティ・グラフ・サービスの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter Portalと分析サービスおよびアクティビティ・グラフ・サービスのバックエンド・コンポーネントをインストールします

開発者

2. アクティビティ・グラフ・サービスをアプリケーションに統合します

2.a JDeveloperで、WebCenter Portalスキーマへの接続を構成します

2.b JDeveloperで、アクティビティ・データベースへの接続を構成します

2.c JDeveloperで、分析コレクタへの接続を構成します

2.d JDeveloperで、アクティビティ・グラフ・タスク・フローをページに追加します

管理者

3. (オプション)アクティビティ・グラフ・エンジン・スケジュールを設定します

開発者/

管理者

4. 次のツールのいずれかを使用してアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール (管理者)

開発者/

管理者

5. (オプション)次のいずれかのツールを使用して接続パラメータを追加または変更します

- JDeveloper。その後アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー/

管理者

6. アクティビティ・グラフ・データがアプリケーションで使用可能なことをテストします

6.a アプリケーションにログインし、コンテンツの追加などによりこれと対話します(エンド・ユーザー)

6.b アクティビティ・グラフ・エンジンを実行します(管理者)

6.c アクティビティ・グラフ・タスク・フロー(プロファイル・ページでの推奨接続タスク・フローなど)で推奨を表示します(エンド・ユーザー)

12.3 アクティビティ・グラフ・サービスの前提条件

アクティビティ・グラフ・サービスを使用するには、アクティビティ・グラフ・エンジン・アプリケーションをインストールおよび構成する必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドを参照してください。

また、アプリケーションで、WebCenter Portalスキーマおよびアクティビティ・データベースへの接続を作成する必要があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のデータベース接続の設定に関する項を参照してください。

分析イベント・コレクタに使用状況イベントを送信するように、アプリケーションを構成する必要があります。詳細は、第13.5項「アプリケーション用の分析コレクタの登録」を参照してください。

アクティビティ・グラフ・サービスが推奨を行うには、アクティビティ・グラフ・エンジンが少なくとも1回実行され、データが収集されて、類似度スコアが計算されていることが必要です。詳細は、第12.4項「アクティビティ・グラフ・サービスのデータの準備」を参照してください。

類似アイテム・タスク・フローで提案されるアイテムは、アプリケーションで使用できるサービスに依存します。たとえばドキュメントは、ドキュメント・サービスが使用可能な場合にのみ推奨されます。アプリケーションでサービスを使用可能にする方法の詳細は、そのサービスに関連する章を参照してください。また、アイテムを所有するサービスのリソース認可者が、そのアイテムを推奨からフィルタで除外することも可能です。

クラスタ環境では、アクティビティ・グラフ・エンジン・アプリケーションのインスタンスを1つだけにし、他のすべてのインスタンスを無効にする必要があります。詳細は、『Oracle Fusion Middleware高可用性ガイド』のアクティビティ・グラフの構成に関する項を参照してください。

12.4 アクティビティ・グラフ・サービスのデータの準備

アクティビティ・グラフ・エンジンは、データの収集、類似度スコアの計算および検索ランキングの計算を実行する3つの個別エンジンで構成されています。3つのエンジンは次のとおりです。

- 収集エンジン: 登録されているアクティビティ・プロバイダ・セットを介して、分析表および他のリポジトリからアクティビティを収集します。

- 共同フィルタ・エンジン(CFE): オブジェクトのペアに関する類似度スコアを計算し、後で類似度の推奨を生成するためにアクティビティ・グラフにスコアを格納します。これは、類似度計算セットの実行により行われます。類似度計算は、ドメインとバックグラウンドのノード・クラスの特定のセットに対する類似度スコアの計算方法を共同フィルタ・エンジンに通知するオブジェクトです。計算結果の各類似度スコアは、特定の基準に基づく2つのオブジェクトの類似度を示す0から1の範囲の数値です。類似度計算の指定には、ドメインとバックグラウンド・クラス、距離関数、およびリレーションの組合せがプロパティとして使用されます。

- ランク・エンジン: アクティビティ・グラフの各ノードの重要度のメジャーを計算します。このアクティビティ・ランクを検索索引に格納し、問合せ時に問合せ依存スコアと組み合せて使用して検索結果を順序付けることができます。詳細は、第12.7項「Oracle Secure Enterprise Searchのアクティビティ・ランクの設定」を参照してください。このスコアはコンテキストに依存しない推奨の順序付けにも役立ちます。そのため、リレーション・ストアにも格納されます。

アクティビティ・グラフ・サービスがオブジェクトの推奨を開始するには、これらのエンジンが少なくとも1回実行され、データが収集されて、類似度スコアが計算されていることが必要です。この初期実行後は、必要に応じて、またはスケジュールに基づいてエンジンを実行することによって、新しいアクティビティが確実に取得され、分析されるようにすることができます。

この項の内容は次のとおりです。

- 第12.4.1項「アクティビティ・グラフ・エンジンのスケジュール実行」

- 第12.4.2項「アクティビティ・グラフ・エンジンのオンデマンド実行」

12.4.1 アクティビティ・グラフ・エンジンのスケジュール実行

アクティビティ・グラフ・エンジンをスケジュールに基づいて実行することによって、新しいアクティビティが定期的に確実に取得され、分析されるようにすることができます。これは、トラフィック量が多く、コンテンツが頻繁に更新されるアプリケーションで役立ちます。

アクティビティ・グラフ・エンジンをスケジュールに基づいて実行する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。

2. ナビゲーション・ペインを使用して、「WebCenter」→「ポータル」→「アクティビティ・グラフ・エンジン」→「アクティビティ・グラフ」(WC_Utilities)→「activitygraph-engines」に移動します。

3. 「Webモジュール」の下で、「アクティビティ・グラフのスケジュールとステータス」ページのURLをクリックし、ログインします。

注意:

このページにアクセスするには、Administratorsグループのメンバーである必要があります。

「アクティビティ・グラフのスケジュールとステータス」ページでは、マルチバイトのユーザー名およびパスワードをサポートしていないため、ASCIIのみのユーザー名およびパスワードを使用してログインする必要があります。

ヒント:

「アクティビティ・グラフのスケジュールとステータス」ページには、次のURLに直接進んでアクセスすることもできます。

http://host:port/activitygraph-engines

ここで、http://host:portはWC_Utilities管理対象サーバーのURLです。

4. 「アクティビティ・グラフのスケジュールとステータス」ページで、「スケジュールで実行」を選択します。

5. 「開始日」フィールドに、スケジュールの開始日を入力します。

6. 「実行」フィールドに、プロセスの定期的な実行間隔を示す値を入力します。たとえば、プロセスを毎日実行する場合は、このフィールドに1と入力します。プロセスを1日おきに実行する場合は、このフィールドに2と入力します。

7. 「日時」ドロップダウン・リストから、プロセスを開始する時刻を選択します。

8. 「開始」をクリックします。
指定した日付の選択した時刻にプロセスが実行され、その後、スケジュールしたとおりに継続して実行されます。

12.4.2 アクティビティ・グラフ・エンジンのオンデマンド実行

アプリケーションのデータがそれほど頻繁には変わらない可能性がある場合は、必要が生じたときにアクティビティ・グラフ・エンジンをオンデマンド実行できます。このオプションは、定期的なスケジュール実行間隔中に、アクティビティ・グラフ・エンジンをオンデマンドで実行する目的でも使用できます。

アクティビティ・グラフ・エンジンをオンデマンドで実行する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。

2. ナビゲーション・ペインを使用して、「WebCenter」→「ポータル」→「アクティビティ・グラフ・エンジン」→「アクティビティ・グラフ」(WC_Utilities)→「activitygraph-engines」に移動します。

3. 「Webモジュール」の下で、「アクティビティ・グラフのスケジュールとステータス」ページのURLをクリックし、ログインします。

注意:

このページにアクセスするには、Administratorsグループのメンバーである必要があります。

「アクティビティ・グラフのスケジュールとステータス」ページでは、マルチバイトのユーザー名およびパスワードをサポートしていないため、ASCIIのみのユーザー名およびパスワードを使用してログインする必要があります。

ヒント:

「アクティビティ・グラフのスケジュールとステータス」ページには、次のURLに直接進んでアクセスすることもできます。

http://host:port/activitygraph-engines

ここで、http://host:portはWC_Utilities管理対象サーバーのURLです。

4. 「今すぐ1回実行」を選択します。

5. アクティビティ・グラフ・エンジンの前回の実行以後に発生したアクティビティによって表を更新する場合は、「増分更新」を選択します。
既存のすべてのデータを削除し、すべてのアクティビティを表に再移入する場合は、「完全再ビルド」を選択します。この場合、時間がかかることがあります。

6. 「開始」をクリックします。
ダイアログの「ステータス」セクションで、プロセスの進行状況を監視できます。

7. 必要に応じて「停止」をクリックすることによって、随時プロセスを停止できます。

8. プロセスのオンデマンド実行後に定期的なスケジュールに戻す場合は、「スケジュールで実行」を必ず選択し、詳細に誤りがないことを確認して、「開始」をクリックします。それにより、スケジュールが再開されます。

12.5 類似度計算の理由文字列のカスタマイズ

類似度計算には、特定の推奨がなぜ行われたかをユーザーが理解するのに役立つ理由文字列を関連付けることができます。人またはオブジェクトが推奨されたときに、最も高いスコアリングに関連する類似度計算に理由文字列が関連付けられている場合、その文字列がタスク・フローに表示されます。類似度計算で表示される理由文字列は編集可能であり、また、追加の文字列を作成することもできます。

各類似度計算では、個々の理由ごとに単数形と複数形の2つのフレーズを定義できます。

理由文字列は次のトークンを使用してカスタマイズできます。

- {RECOMMENDED_ITEM}: 現在の推奨アイテムの名前。

- {NUMBER_OF_ITEMS}: 共通するオブジェクト数。これはコンポーネント・スコアの分子に対応します。

- {TOTAL_ITEMS}: 共通するアイテムの合計数。これはコンポーネント・スコアの分母に対応します。意味は上位類似度URNに関連付けられた類似度関数に依存します。

- {SIMILARITY_CALCULATION}: 上位類似度計算の名前。

たとえば、user-connect類似度計算では、次の2つの理由文字列が定義されています。

reason-user-connect=You share {NUMBER_OF_ITEMS} connections with {RECOMMENDED_ITEM}.

reason-user-connect=You share {NUMBER_OF_ITEMS} connection with {RECOMMENDED_ITEM}.

類似度計算の理由文字列をカスタマイズする手順は次のとおりです。

1. UIBundle.propertiesファイルを開きます。

2. カスタマイズする理由文字列を見つけて、必要に応じて編集します。

3. 新しい理由文字列を作成する場合は、次の形式を使用します。

reason-similarity-calculation=string

4. UIBundle.propertiesファイルを保存します。

12.6 アクティビティ・グラフ・スキーマのカスタマイズの管理

WebCenter Portalは、出荷時の状態ですぐに使用可能な、アクティビティ・グラフ・サービスとの統合を提供します。これには、分析からのWebCenter Portalサービス・イベント・データをマッピングするためのメタデータ定義が含まれます。このメタデータは、アクティビティ・グラフ・エンジン・アプリケーションの最初の起動時に自動的にロードされます。

XMLファイルを操作することによって、アクティビティ・グラフ・メタデータを拡張し、分析からのアクションの収集方法を変更できます。メタデータを使用するためには、まずデータをXMLファイルにエクスポートする必要があります。XMLファイルの編集後、メタデータをアクティビティ・グラフ・サービスに再びインポートできます。

この項の内容は次のとおりです。

- 第12.6.1項「アクティビティ・グラフ・メタデータのエクスポート」

- 第12.6.2項「プロバイダ構成のエクスポート」

- 第12.6.3項「アクティビティ・グラフ・メタデータのインポート」

- 第12.6.4項「アクティビティ・グラフ・メタデータの削除」

- 第12.6.5項「アクション名およびノード・クラス名の変更」

アクティビティ・グラフ・メタデータの拡張方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のアクティビティ・グラフ・サービスの拡張に関する項を参照してください。

12.6.1 アクティビティ・グラフ・メタデータのエクスポート

WLSTコマンドのexportAGMetadataを使用して、アクティビティ・グラフ・メタデータ定義をXMLファイルにエクスポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportAGMetadataに関する項を参照してください。

次に例を示します。

exportAGMetadata(appName='activitygraph-engines',
directoryPath='/scratch/monty', definitionFileName='activityGraphMetaData.xml',
includeProviderConfigurations=1)

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.6.2 プロバイダ構成のエクスポート

WLSTコマンドのexportAGProviderConfigurationを使用して、特定のプロバイダに関するプロバイダ構成メタデータをアクティビティ・グラフ・メタデータ定義ファイルにエクスポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportAGProviderConfigurationに関する項を参照してください。

次に例を示します。

exportAGProviderConfiguration(appName='activitygraph-engines',
directoryPath='/scratch/monty',
definitionFileName='activityGraph-analytics-mappings.xml',
urn='oracle.webcenter.activitygraph.analytics')

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.6.3 アクティビティ・グラフ・メタデータのインポート

WLSTコマンドのimportAGMetadataを使用して、アクティビティ・グラフ・メタデータ定義をXMLファイルからインポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportAGMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.6.4 アクティビティ・グラフ・メタデータの削除

WLSTコマンドのdeleteAllAGMetadataを使用して、WebCenter Portalアプリケーションで定義されているすべてのアクティビティ・グラフ・メタデータを削除します。アクティビティ・グラフ・メタデータを完全に再インストールするには、このコマンドをWLSTコマンドimportAGMetadataと組み合せて使用します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteAllAGMetadataに関する項を参照してください。

注意:

このコマンドは、新しいメタデータ・セットをインポートすることを予定している場合にのみ使用してください。

アクティビティ・グラフの個別オブジェクトのメタデータは、次のWLSTコマンドを使用して削除できます。

- ノード・クラス(deleteAGNodeClass)

- アクション(deleteAGAction)

- 類似度計算(deleteAGSimilarityCalculation)

- ランク計算(deleteAGRankCalculation)

- プロバイダ割当て(deleteAGProviderAssignment)

- QRPP (deleteAGQRPPRegistration)

注意:

これらのdeleteメソッドでは、メタデータがスキーマから削除されます。その結果、アクティビティ・グラフ・エンジンの次回の実行時に、アクティビティ・データベース内のあらゆる関連データが削除されます。

詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のアクティビティ・グラフに関する項を参照してください。

12.6.5 アクション名およびノード・クラス名の変更

WLSTコマンドのrenameAGNodeClassを使用して、アクティビティ・グラフに現在登録されているノード・クラスのURNを変更します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のrenameAGNodeClassに関する項を参照してください。

WLSTコマンドのrenameAGActionを使用して、アクティビティ・グラフに現在登録されているアクションのURNを変更します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のrenameAGActionに関する項を参照してください。

注意:

これらのコマンドでは、影響を受けるノード・クラスまたはアクションに関連付けられたメタデータについては削除されません。

12.7 Oracle Secure Enterprise Searchのアクティビティ・ランクの設定

WebCenter PortalアプリケーションとFusionアプリケーションを介して提供されるエンタープライズ・コンテンツは充実した構造をしています。この構造はマルコフ連鎖分析という数学的技法の使用に役立ちます。この技法がランク・エンジンで使用され、より関連性の強い結果セットが生成されることで、エンド・ユーザーの検索を改善するアクティビティ・ランクが各ノードに生成されます。これは、Oracle Secure Enterprise Search (Oracle SES)検索索引に様々なオブジェクトの重要度のメジャーを導入することによって実現されます。その後、他の標準の検索基準(条件頻度など)と組み合せて、この重要度が結果の順序付けで考慮されます。オブジェクトの重要度の決定は、そのオブジェクトとのユーザーの対話の履歴に基づいて予測されます。

アクティビティ・ランクでは、人の重要度は、その人物が作成および編集するアイテムの数、それらのアイテムの重要度、その人物とコネクションがある人の数、およびそれらの人々の重要度に依存します。アイテムの重要度は、その作成者の重要度、そのアイテムを表示、タグ付けおよび編集する人々の数、およびそれらの人々の重要度に依存します。

ランク・エンジン・プロセスは次の4つのフェーズに分けることができます。

- 収集: ランク・エンジンが分析ストアに対して、ユーザーとドキュメント間のコネクションに関するデータの問合せを実行します。

- 変形: データがマトリックスに変換されます。

- 乗算: マトリックスを使用してアクティビティ・ランクが計算されます。

- 結果の格納: 検索時に使用できるように、アクティビティ・ランクがOracle SES検索サーバーに格納されます。

アクティビティ・ランク候補は、WebCenter Portal: Spacesオブジェクトのうち、Oracle SESクローラ実装を持つオブジェクト、WebCenter Portal分析インストゥルメンテーションを持つオブジェクト、およびアクティビティ・グラフ・ランク計算への登録があるオブジェクトの共通部分に制限されます。

検索の動作に影響するアクティビティ・ランクをオブジェクトが受信するためには、イベント・データが分析から収集されること、ランク計算がアクティビティ・グラフによって生成されること、およびアクティビティ・グラフに登録されているいずれかのクラスに一致する値をwc_serviceId属性値として持つ索引付きエントリが検索に含まれることの条件をオブジェクトが満たすことが必要です。現在サポートされているオブジェクトは次のとおりです。

- ユーザー

- ドキュメント

- ブログ・エントリ

- Wikiページ

注意:

オブジェクトのクラス自体が検索可能でない場合でも、ランクは計算され、使用されます。

アクティビティ・ランクの計算で考慮されるアクションの範囲は、activityGraphMetaData.xmlファイルに指定されたrankCalculationによって定義されます。出荷時に構成されている宣言には次のユーザー・アクションが含まれています。

<component actionURN="connect" weight="10.0"/>
<component actionURN="edit" weight="20.0" inverse="true"/>
<component actionURN="view-count" weight="1.0"/>
<component actionURN="create" weight="100.0" inverse="true"/>
<component actionURN="create" weight="100.0"/>
<component actionURN="edit-count" weight="20.0"/>
<component actionURN="download" weight="5.0"/>
<component actionURN="tag" weight="10.0"/>
<component actionURN="comment" weight="10.0"/>

ここから、ドキュメントの表示という単一アクションの場合、そのドキュメントに対する重要度(weight="1.0")は、ドキュメントの作成アクション(weight="100.0")やタグ付けアクション(weight="10.0")に比べてきわめて低いことがわかります。

また、inverse属性がtrueに設定されている場合、オブジェクトとユーザー間のリレーションシップが示されます。このリレーションシップの効果は、ランクの高いオブジェクトによってユーザーが信頼性を高められることです。たとえば、他のユーザーがドキュメントに対して実行したアクション(タグ付け、表示、ダウンロード)によってそのランクが上昇するにつれ、そのドキュメントの作成者(createリレーションシップ)がそのドキュメントのランクを収集し、そのユーザーの将来のアクションの重みが増幅されます。

アクティビティ・グラフ・ランク・エンジンは、影響を受けるすべてのオブジェクトに関するランク計算を完了すると、1から10の範囲の正規化されたランクを持つ識別子の結果セットをプラグイン・クラスSesRankResultAcceptorに送信します。このクラスは、Oracle SES SOAP APIを使用して、検索索引にランクをそのままプッシュします。このランクは(Oracle SESではdocscoreと呼ばれています)、SOAP APIに受け入れられるとすぐに検索ランキングで考慮されます(DocScore機能が完全に有効化されている場合)。

したがって、結果セットの同じ階層内の複数のアイテムでは、docscoreがより高いアイテムが、より低いアイテムより高い検索スコアを取得するため、より高いアイテムはその階層内でより上位のランクに押し上げられる可能性があります。

開始前の作業

アクティビティ・ランクはOracle SESと連携して動作します。そのため、Oracle SESが適切にインストールおよび構成されていることを確認する必要があります。また、アクティビティ・ランクは検索可能アイテムにのみ作用するため、ランク・エンジンはSESクローラの実行後に実行してください。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の「検索サービスの管理」の章を参照してください。

Oracle SESのアクティビティ・ランクを構成する手順は次のとおりです。

1. ランク・エンジンでは、ACTIVITY-RANKに対して外部名DOC_SCORE_1を持つdocscore属性、およびLIKE-RANKに対して外部名DOC_SCORE_2を持つdocscore属性をそれぞれ使用することを期待しています。そのため、ストアド・プロシージャeq_sdata.create_sdata_attributeをコールすることによって、これらのフィールドを設定するための1回限りのマッピング・コールを実行する必要があります。

exec eq_sdata.create_sdata_attribute('ACTIVITY-RANK');
exec eq_sdata.create_sdata_attribute('LIKE-RANK');

注意:

これらのストアド・プロシージャは、Oracle SESインスタンスをホストするサーバーから呼び出す必要があります。

2. また、これらの属性の重みを決定するエントリをOracle SES ranking.xmlファイルに追加する必要があります。
Oracle SES 11.1.2.2の場合は、次のように追加します。

<ranking>
<docscore-factor>
<attribute-name>ACTIVITY-RANK</attribute-name>
<column-name>DOC_SCORE_1</column-name>
<weight>1.0</weight>
</docscore-factor>
<docscore-factor>
<attribute-name>LIKE-RANK</attribute-name>
<column-name>DOC_SCORE_2</column-name>
<weight>1.0</weight>
</docscore-factor>
</ranking>

他のすべてのバージョンのOracle SESでは、次のように追加します。

<ranking>
<docscore-factor>
<attribute-name>ACTIVITY-RANK</attribute-name>
<column-name>DOC_SCORE_1</column-name>
<weight>1.0</weight>
</docscore-factor>
<docscore-factor>
<attribute-name>LIKE-RANK</attribute-name>
<column-name>DOC_SCORE_2</column-name>
<weight>1.0</weight>
</docscore-factor>
<docscore-factor>
<attribute-name>Doc_Score</attribute-name>
<weight>1.0</weight>
</docscore-factor>
</ranking>

ヒント:

ranking.xmlファイルは次のディレクトリにあります。

$SES_HOME/search/webapp/config

3. Oracle SES中間層を再起動して、変更を有効にします。

4. WLSTコマンドのsetAGPropertyを使用して、次のアクティビティ・グラフ・プロパティを設定します。

oracle.webcenter.activitygraph.providers.datasources.ses.soap.admin.url
oracle.webcenter.activitygraph.providers.datasources.ses.soap.query.url

次に例を示します。

setAGProperty(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.admin.url',
propertyValue='http://seshostname:7777/search/api/admin/AdminService',
propertyType='String')

setAGProperty(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.query.url',
propertyValue='http://seshostname:7777/search/query/OracleSearch',
propertyType='String')

これらのプロパティを設定すると、Oracle SESサーバーに接続して索引にランクを記録するSESRankResultAcceptorが有効化されます。

5. WLSTコマンドのsetAGPasswordCredentialを使用して、2つのプロパティによって定義されたURLにアクセスするときに使用するユーザー名とパスワードを設定します。

注意:

検索可能なすべてのアイテムへのアクセス権を持つユーザーと一致する資格証明を指定してください。

次に例を示します。

setAGPasswordCredential(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.admin.credential',
userName='eqsys',
password='welcome1')

setAGPasswordCredential(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.query.credential',
userName='orcladmin',
password='welcome1')

6. アクティビティ・グラフ・エンジン・アプリケーションがデプロイされている管理対象サーバー(つまり、WC_Utilities管理対象サーバー)を再起動します。

12.8 推奨に関する問題のトラブルシューティング

この項では、アクティビティ・グラフ・サービスの使用中に発生する可能性がある問題のトラブルシューティングに役立つ情報を提供します。

注意:

次に示すトラブルシューティングの解決法では、アクティビティ・グラフ・エンジンが正しくデプロイされていること、WC_Utilities管理対象サーバーが稼働していること、およびopenusage enabledプロパティがtrueに設定されていることを前提としています。

また、第12.3項「アクティビティ・グラフ・サービスの前提条件」も必ず読んでおいてください。

12.8.1 アクティビティ・グラフ・エンジンの「スケジュールとステータス」ページのトラブルシューティング

問題

アクティビティ・グラフ・エンジンの実行中に、「アクティビティ・グラフのスケジュールとステータス」ページでエラーがスローされる

解決策

この場合の基本的な検証内容は、WebLogicコンソールからアクティビティ・グラフ・エンジンのデプロイ・ステータスを検証することです。

問題

「スケジュールとステータス」ページからアクティビティ・グラフ・エンジンを起動したときに、エンジンのステータスがUIに反映されない。

解決策

アクティビティ・グラフのログで、エンジンが実際に実行されているかどうか確認します。エンジンが実行されていることがログに示されている場合は、問題はUIのみに関連します。この場合、タスク・フローに表示される推奨には影響しません。収集/CFEエンジンのエントリがログに何も示されていない場合は、イベント・マッピング・ファイルに問題がある可能性があります。

ヒント:

アクティビティ・グラフ・エンジンのログは次の場所にあります。

domain/log/WC_Utilities.out
domain/servers/WC_Utilities/logs/WC_Utilities-diagnotics.log

問題

「アクティビティ・グラフのスケジュールとステータス」ページにログインできない。

解決策

「アクティビティ・グラフのスケジュールとステータス」ページでは、マルチバイトのユーザー名およびパスワードはサポートされていません。ASCII文字のみのユーザー名とパスワードを持つ管理者としてログインしてください。

13 分析サービスの管理

この章では、WebCenter Portalアプリケーションで使用される分析サービスを構成および管理する方法について説明します。分析サービスを使用することで、アプリケーションの使用状況とパフォーマンスのメトリックを表示できるようになります。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にWebCenter Portalアプリケーションに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。分析コレクタ構成に加えた変更は、分析データベースに格納されます。

注意:

Fusion Middleware ControlまたはWLSTを使用して分析サービスの構成に対して加えた変更は、動的ではありません。変更を有効にするには、分析コレクタまたはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第13.1項「WebCenter Portalでの分析に関する必要な知識」

- 第13.2項「分析サービスの構成ロードマップ」

- 第13.3項「分析の前提条件」

- 第13.4項「分析コレクタ設定の構成」

- 第13.5項「アプリケーション用の分析コレクタの登録」

- 第13.6項「ユーザー・プロファイル・イベントのタイミングの構成」

- 第13.7項「分析イベント収集の検証」

- 第13.8項「現在のWebCenter Portalの分析イベント・リストの表示」

- 第13.9項「分析データのパージ」

- 第13.10項「分析データのパーティション化」

- 第13.11項「分析に関する問題のトラブルシューティング」

対象読者

この章の内容は、WebCenter Portalでの分析の設定と、FrameworkアプリケーションおよびSpaces用の分析コレクタの詳細の構成を担当する管理者を対象としています。

13.1 WebCenter Portalでの分析に関する必要な知識

WebCenter Portal管理者およびビジネス・ユーザーは、分析を使用することによって、ポータルの使用状況を追跡および分析できます。分析では、次の基本機能が提供されます。

- 使用状況トラッキング・メトリック: 分析によって、コミュニティ、ページ、ポートレットおよびドキュメントへのアクセスなどの、ポータルの一般的な機能に関するメトリックが収集および報告されます。

- 動作トラッキング: ユーザーはポータル・メトリックを分析して、ポータル訪問期間や、一定期間の使用状況などの使用パターンを特定できます。

- ユーザー・プロファイルの相関: ユーザーは、メトリック情報をユーザー・プロファイル情報と関係付けることができます。国、会社、都道府県などのユーザー・プロファイル・データを基準に、使用状況トラッキング・レポートを表示およびフィルタ処理できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの問合せオプションに関する項を参照してください。

次の各項では、分析のコンポーネントと、すぐに使用可能なタスク・フローの概要を説明します。

- 第13.1.1項「分析のコンポーネント」

- 第13.1.2項「分析タスク・フロー」

13.1.1 分析のコンポーネント

図13-1は、WebCenter Portalにおける分析サービスのコンポーネントを示しています。

- WC_Spaces: Spacesアプリケーションがデプロイされている管理対象サーバー。
(Frameworkアプリケーションは異なる管理対象サーバーにデプロイされます。)

- WC_Utilities: 分析コレクタがデプロイされている管理対象サーバー。

- イベント・データ: 定義されたイベント・セットが分析によって追跡および収集されます。すぐに使用可能な最多発イベントの包括的なセットが付属しています。

- Open Usage API: OpenUsage APIによって、UDP (ユーザー・データグラム・プロトコル)を使用して分析コレクタにメトリックが送信されます。

- 分析コレクタ: 分析コレクタ・コンポーネントによって、イベント・データが収集されます。
分析コレクタをクラスタ化して、スケーラビリティと信頼性を高めることができます。

- 分析データベース: 分析データベース(ACTIVITIES)には、ポータル・イベントおよび非ポータル・イベントから収集されたメトリックが格納されます。

- 分析タスク・フロー: 分析によって、一般的なポータル機能のメトリックを報告する一連のタスク・フローが提供されます。

- MDS: タスク・フローのカスタマイズを格納するOracle Metadata Service (MDS)リポジトリ。

図13-1 分析のコンポーネント

13.1.2 分析タスク・フロー

表13-1は、WebCenter Portalで使用できる分析タスク・フローを示しています。各タスク・フローは、FrameworkアプリケーションでもSpacesでも同様に動作します。これらのタスク・フローの詳細および使用方法は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpacesでの分析タスク・フローの概要に関する項を参照してください。

表13-1 WebCenter Portalでの分析タスク・フロー

分析タスク・フロー

説明

WebCenterポータル・トラフィック

ポータル内の一般的なイベントのサマリー・ビュー。

ページ・トラフィック

ポータル内のページへのアクセス数と、いずれかのページにアクセスした一意のユーザー数が表示されます。

ログイン・メトリック

ポータルへのログインについて報告されます。

ポートレット・トラフィック

ポートレットの使用状況データが表示されます。

ポートレット・レスポンス時間

ポートレットのパフォーマンス・データが表示されます。

ポートレット・インスタンス・トラフィック

ポートレット・インスタンスの使用状況データが表示されます。

同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

ポートレット・インスタンス・レスポンス時間

ポートレット・インスタンスのパフォーマンス・データが表示されます。

検索メトリック

ポータルの検索が追跡されます。

ドキュメント・メトリック

ドキュメント・ビューが追跡されます。

Wikiメトリック

最も人気が高い/低いwikiが追跡されます。

ブログ・メトリック

最も人気が高い/低いブログが追跡されます。

ディスカッション・メトリック

最も人気が高い/低いディスカッションが追跡されます。

スペース・トラフィック*

(Spacesのみ)スペースの使用状況データが表示されます。

スペース・レスポンス時間*

(Spacesのみ)スペースのページ・パフォーマンス・データが表示されます。

*これらのタスク・フローはSpaces固有のものです。これらのタスク・フローは、Frameworkアプリケーションには使用できません。

13.2 分析サービスの構成ロードマップ

図13-2のフロー・チャートおよび表13-2は、Spacesアプリケーションで分析サービスを動作させるための前提条件と必要なタスクの概要を示しています。

図13-2 Spacesアプリケーションで使用するための分析サービスの構成

表13-2 Spacesで使用するための分析サービスの構成

担当者

タスク

サブタスク

管理者

1. Oracle WebCenter Portal: Spacesと、分析サービスのバックエンド・コンポーネントをインストールします

管理者

2. (オプション)次のツールのいずれかを使用して、分析コレクタを構成します

- システムMBeanブラウザ

- WLST

管理者

3. 次のツールのいずれかを使用して、Spacesアプリケーションと分析コレクタ間の接続を構成します

- Fusion Middleware Control

- WLST

Spaces管理者

4. 分析データがSpacesで使用可能なことをテストします

4.a 管理者権限でSpacesにログインします

4.b 分析ビジネス・ロールのメイン・ページを開いてライブ・データを表示します: http://host:port/webcenter/spaces/page/Analytics

13.3 分析の前提条件

この項の内容は次のとおりです。

- 第13.3.1項「分析: インストール」

- 第13.3.2項「分析: 構成」

- 第13.3.3項「分析: セキュリティに関する考慮事項」

- 第13.3.4項「分析: 制限事項」

13.3.1 分析: インストール

分析コレクタはOracle WebCenter Portalのオプションのインストール・オプションです。この製品をインストールするには、Fusion Middleware構成ウィザードで「Oracle WebCenter Portal Analytics Collector」を選択します。インストール手順の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドを参照してください。

分析スキーマ(ACTIVITIES)とWebCenter Portalスキーマ(WEBCENTER)は、同じデータベースにインストールすることも、別々のデータベースにインストールすることもできます。

13.3.2 分析: 構成

分析コレクタは、インストールのデフォルトを使用して、初期設定でイベントを受信するように構成されています。デフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTまたはMBeanブラウザを使用して別の値を構成できます。詳細は、第13.4項「分析コレクタ設定の構成」を参照してください。

Spacesは、初期設定では、分析コレクタにイベントを送信するように構成されていません。Spaces (またはFrameworkアプリケーション)の使用状況とパフォーマンスのメトリックを収集する場合は、分析コレクタを登録し、イベント収集を有効化する必要があります。詳細は、第13.5項「アプリケーション用の分析コレクタの登録」を参照してください。接続後は、追加構成を行わなくても、分析データが収集され、アプリケーションに(分析タスク・フローを介して)表示されるようになります。

13.3.3 分析: セキュリティに関する考慮事項

Spacesでは、適切な権限を持つユーザーに対してのみ、リソース・カタログに分析タスク・フローが表示されます。

- 管理者: Administratorロールを持つユーザーはすべての分析タスク・フローにアクセスできます。

- モデレータ: 特定のスペース内でModeratorロールを持つメンバーは、そのスペースの使用状況データを表示する分析タスク・フローにアクセスできます。

分析の使用状況データは、ポータル分析には有益ですが、ポータル・ユーザーの個人データまたは機密データとみなされる場合があります。Spacesの管理者および個別スペースのモデレータは、使用状況メトリックに関連するセキュリティとプライバシの権利を保護するために、ページのセキュリティを管理し、分析データを公開するページにアクセスできるユーザーを、指定された適切なユーザーのみに制限する必要があります。Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページとコンポーネントの保護に関する項も参照してください。

同様に、Frameworkアプリケーションを構築する開発者は、分析タスク・フローおよびデータ公開のための適切なセキュリティ・モデルを設定する必要があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の分析タスク・フローおよび使用状況データのセキュリティの設定に関する項を参照してください。

13.3.4 分析: 制限事項

分析タスク・フローにはカスタム・イベント情報は表示されません。

13.4 分析コレクタ設定の構成

分析コレクタは、インストール時に、次のデフォルト値を使用してイベントを受信するように構成されます。

- コレクタ・ホスト名: localhost

- デフォルト・ポート: 31314

- 最大ポート番号: 31314

- ブロードキャスト・タイプ: マルチキャスト

- クラスタリング: クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

これらのデフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTを使用するか、またはFusion Middleware ControlでMBeanブラウザを使用して、適切な値を構成できます。

- WLSTを使用した分析コレクタ・プロパティの設定

- Fusion Middleware Controlを使用した分析コレクタ・プロパティの設定

これらの分析コレクタ構成設定は分析データベース(ACTIVITIES)に格納されます。

13.4.1 WLSTを使用した分析コレクタ・プロパティの設定

WLSTコマンドのsetAnalyticsCollectorConfigを使用して、分析コレクタのイベント収集プロパティを設定します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetAnalyticsCollectorConfigに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

プロパティ値の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Utilities)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

13.4.2 Fusion Middleware Controlを使用した分析コレクタ・プロパティの設定

分析コレクタのイベント収集プロパティを設定するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。

分析コレクタ(デプロイ場所: 管理対象サーバーWC_Utilities)を構成する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. システムMBeanブラウザを開きます。

- Spacesアプリケーションでは、「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Frameworkアプリケーションでは、「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 次の場所に移動します。
「アプリケーション定義のMBean」→「oracle.webcenter.analytics」→「サーバー: WC_Utilities」→「アプリケーション: analytics-collector」→「CollectorConfiguration」→「構成」
または、CollectorConfigurationを検索するか、MBeanパターンoracle.webcenter.analytics:*を使用してシステムMBeanブラウザ・ツリーをフィルタ処理します。

図13-3 システムMBeanブラウザ: 分析コレクタ・プロパティ

4. 分析コレクタの構成プロパティを変更します。詳細は、表13-3を参照してください。

表13-3 分析コレクタ: 構成プロパティ

フィールド

説明

BroadcastType

分析コレクタがハートビートをブロードキャストして、その位置をイベント・プロデューサに通知するネットワーク・チャネルを指定します。有効な値はBroadcastおよびMulticastです。

Broadcast: 標準のネットワーク・ブロードキャスト・チャネルを使用します。

Multicast: 指定された固定マルチキャスト・アドレスを使用します。

CollectorHostName

分析コレクタを実行しているホスト名を入力します。

デフォルト設定はlocalhostです。

CollectorDefaultPort

分析コレクタがリスニングするデフォルト・ポート番号を入力します。デフォルト値は31314です。

CollectorMaximumPort

分析コレクタがリスナーの割当て時に使用できる最大ポート番号を入力します。

このプロパティは、ほとんどの場合、同じボックスで複数のコレクタが稼働するクラスタ環境で使用されます。各コレクタは指定されたポート範囲内の空きポートで受信UDPメッセージをリスニングします。この範囲はデフォルト・ポート番号から最大ポート番号までです。

ClusterEnabled

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

ClusterName

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

HeartbeatFrequency

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

5. 新しい設定の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Utilities)を再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.5 アプリケーション用の分析コレクタの登録

OpenUsage APIによってSpacesまたはFrameworkアプリケーションで生成されたイベントを、分析サービス、推奨サービスおよびアクティビティ・グラフ・エンジンで使用できるように、分析コレクタに送信できます。これらのサービスが提供するいずれかの機能またはタスク・フローを使用する場合は、SpacesまたはFrameworkアプリケーションを分析コレクタに接続する必要があります。

SpacesまたはFrameworkアプリケーション用に複数の分析コレクタ接続を登録できますが、使用される分析コレクタは、デフォルトの(またはアクティブな)接続1つのみです。

新しい構成の使用を開始するには、SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第13.5.1項「Fusion Middleware Controlを使用した分析コレクタの登録」

- 第13.5.2項「WLSTを使用した分析コレクタの登録」

- 第13.5.3項「WebCenterイベント収集の無効化」

13.5.1 Fusion Middleware Controlを使用した分析コレクタの登録

SpacesまたはFrameworkアプリケーション用に分析コレクタを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 「サービス構成」ページを開きます。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「Analyticsおよびアクティビティ・グラフ」を選択します。

4. 分析コレクタに接続するには、「追加」をクリックします(図13-4)。

図13-4 分析コレクタ接続の構成

5. この接続の一意の名前を入力します。
名前は、SpacesまたはFrameworkアプリケーションのすべての接続タイプにおいて一意である必要があります。

6. この接続を分析およびアクティビティ・グラフ・サービスに使用する場合は、「アクティブな接続」を選択します。
SpacesまたはFrameworkアプリケーション用に複数の分析コレクタ接続を登録できますが、使用される接続は、デフォルトの(またはアクティブな)接続1つのみです。

7. OpenUsage APIによって生成された分析イベントを分析コレクタに送信するには、「WebCenterポータル・イベント収集の有効化」を選択します。
分析データを収集しない場合は、このオプションの選択を解除します。

8. 分析コレクタの接続の詳細を入力します。詳細は、表13-4を参照してください。

表13-4 分析コレクタ接続: 接続の詳細

フィールド

説明

メッセージング・モード

このプロパティでは、イベントをクラスタ化された分析コレクタにマルチキャスト・モードで送信するか、または単一の分析コレクタにユニキャスト通信を使用して送信するかを指定します。現在のリリースでは分析コレクタのクラスタリングはサポートされていないため、このリリースの有効な値はUnicastのみです。

コレクタ・ホスト名

メッセージング・モードをUnicastに設定した場合は、分析コレクタを実行しているホスト名を入力します。

デフォルト設定はlocalhostです。

コレクタ・ポート

分析コレクタがイベントをリスニングするポートを入力します。デフォルト値は31314です。

クラスタ名

メッセージング・モードをMulticastに設定した場合は、クラスタ化された分析コレクタを実行しているクラスタ名を入力します。

タイムアウト(秒)

メッセージング・モードをMulticastに設定した場合は、分析コレクタからのレスポンスを待機する時間(秒)を入力します。

デフォルト値は30秒です。

9. 「OK」をクリックして保存します。

10. 新しい(アクティブな)接続の使用を開始するには、SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.5.2 WLSTを使用した分析コレクタの登録

WLSTコマンドのcreateAnalyticsCollectorConnectionを使用して、SpacesまたはFrameworkアプリケーション用に分析コレクタ接続を作成します。既存の接続を更新するには、setAnalyticsCollectorConnectionを使用します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateAnalyticsCollectorConnectionとsetAnalyticsCollectorConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい接続の使用を開始するには、isEnabled=1とdefault=1を確実に設定した後に、SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを再起動します。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

13.5.3 WebCenterイベント収集の無効化

OpenUsage APIによって生成されるイベントを収集しない場合は、イベント送信を一時的または永続的に停止できます。

この項の内容は次のとおりです。

- 第13.5.3.1項「Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化」

- 第13.5.3.2項「WLSTを使用したWebCenter Portalイベント収集の無効化」

13.5.3.1 Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化

SpacesまたはFrameworkアプリケーションのイベント収集を無効化する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 「サービス構成」ページを開きます。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「Analyticsおよびアクティビティ・グラフ」を選択します。

4. 表で接続を選択して「編集」をクリックします。

5. 「WebCenterポータル・イベント収集の有効化」の選択を解除します(図13-5)。

図13-5 分析イベント収集の無効化

6. この変更を有効にするには、SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.5.3.2 WLSTを使用したWebCenter Portalイベント収集の無効化

WLSTを使用してイベントの収集を無効化するには、isEnabled引数を0 (false)に設定したsetAnalyticsCollectorConnectionコマンドを実行します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetAnalyticsCollectorConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

13.6 ユーザー・プロファイル・イベントのタイミングの構成

ユーザー・プロファイル情報はキャッシュされます。つまり、ユーザー・プロファイルの変更は、キャッシュが更新されるまでレポートに表示されません。このキャッシュは、デフォルトでは1000オブジェクトに制限され、各オブジェクトは、デフォルトでは60分間キャッシュ内に残ります。これらの値は、WLSTを使用して変更できます。キャッシュの最大オブジェクト数を変更するには、setProfileCacheNumberOfObjectsコマンドを実行します。キャッシュ内でオブジェクトがアイドル状態を維持する時間を変更するには、setProfileCacheTimeToLiveコマンドを実行します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

13.7 分析イベント収集の検証

次の場所にあるトレース・ログを調べることによって、イベントが分析コレクタに到達するかどうかを確認できます。

<base_domain_name>/servers/WC_Utilities/logs/analytics-collector/collector.trc

イベント・メッセージは次のようなものです。

[2010-09-16T07:13:56.906-07:00] [WC_Utilities] [TRACE] []
[SRC_METHOD: OnMessageReceived] Event = [[
EVENT_TYPE: {http://www.myorg.com/videoapp}VIDEOVIEWS
VERSION: 3.0.XXXX
AS_DIMENSION_USER.USERID: testuser01
VIDEO.RESOURCEID: video8736
VIDEO.TITLE: Project Kick Off
VIDEO.LOOP: false
QUALITY: 720
PROPERTY_VERSION: 3.0.XXXX

分析コレクタの構成情報を表示するには、次のURLを入力します。

http://hostname:WC_Utilities_port/collector

このページに表示される内容は次のとおりです。

- コレクタのデフォルト・ポート

- コレクタの最大ポート

- コレクタのサーバー名

- ブロードキャスト・タイプ

- クラスタ有効

- クラスタ名

- パーティショニング有効

- 今年の時間ディメンション

- スペース・ディメンションが存在(Spacesアプリケーション・インストールの場合)

13.8 現在のWebCenter Portalの分析イベント・リストの表示

分析コレクタが収集を行うよう構成されているイベントを表示するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。

分析イベントの現在のリストを表示する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. システムMBeanブラウザを開きます。

- Spacesアプリケーションでは、「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Frameworkアプリケーションでは、「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 次の場所に移動します。
「アプリケーション定義のMBean」→「oracle.webcenter.analytics」→「サーバー: WC_Utilities」→「アプリケーション: analytics-collector」→「CollectorServices」→「サービス」
または、CollectorServicesを検索するか、MBeanパターンoracle.webcenter.analytics:*を使用してシステムMBeanブラウザ・ツリーをフィルタ処理します。

4. 「操作」タブを選択します。

図13-6 システムMBeanブラウザ: 分析イベントの登録

5. 「listRegisteredEventTypes」をクリックします。

6. 「起動」をクリックします。

または、WLSTコマンドlistAnalyticsEventTypesを使用します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistAnalyticsEventTypesに関する項を参照してください。

13.9 分析データのパージ

詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle WebCenter Portal分析データのパージに関する項を参照してください。

13.10 分析データのパーティション化

詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle WebCenter Portal分析データのパーティション化に関する項を参照してください。

13.11 分析に関する問題のトラブルシューティング

SpacesまたはFrameworkアプリケーションに分析が表示されない場合は、次のことを確認します。

- 分析コレクタの構成に誤りがないこと、特に「WebCenterイベント収集の有効化」と「アクティブな接続」の両方が設定されていることを確認します(図13-7)。「アプリケーション用の分析コレクタの登録」を参照してください。

図13-7 接続と分析収集の有効化

接続を変更する場合は、SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

- SpacesまたはFrameworkアプリケーションが最近アップグレードされた場合は、ドメイン起動スクリプトにレガシーの分析コレクタ設定が含まれていないことを確認してください。レガシー設定が含まれていると、その値によって、Fusion Middleware ControlまたはWLSTを使用して指定したあらゆる接続詳細が上書きされてしまいます。

1. SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを停止します。

2. 次にある、ドメイン起動スクリプトsetDomainEnvを編集します。
UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

3. 分析コレクタ設定を削除します。

4. 管理対象サーバーを再起動します。

14 お知らせおよびディスカッション・サービスの管理

この章では、アプリケーション用にお知らせサービスとディスカッション・サービスを構成および管理する方法について説明します。これらの2つのサービスでは、Oracle WebCenter Portalのディスカッション・サーバーへの同じ接続を使用します。

特に指定のないかぎり、Oracle WebCenter Portalのディスカッション・サーバー内では構成変更を行わないでください。WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。Oracle WebCenter Portalのディスカッション・サーバーに関するトラブルシューティングのヒントは、第14.12項「お知らせおよびディスカッションに関する問題のトラブルシューティング」を参照してください。

デプロイ後にアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったディスカッション・サービスとお知らせサービスの構成の変更は動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第14.1項「ディスカッション・サーバー接続に関する必要な知識」

- 第14.2項「ディスカッション・サーバーの前提条件」

- 第14.3項「ディスカッション・サーバーの登録」

- 第14.4項「ディスカッションおよびお知らせ用のアクティブな接続の選択」

- 第14.5項「ディスカッション・サーバー接続の詳細の変更」

- 第14.6項「ディスカッション・サーバー接続の削除」

- 第14.7項「ディスカッション・サービスのデフォルトの設定」

- 第14.8項「お知らせサービスのデフォルトの設定」

- 第14.9項「ディスカッション・サーバー接続のテスト」

- 第14.10項「ディスカッション・サーバーの管理者権限の付与」

- 第14.11項「ディスカッション・サーバーの管理者ロールの付与」

- 第14.12項「お知らせおよびディスカッションに関する問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

14.1 ディスカッション・サーバー接続に関する必要な知識

ディスカッション・サービスによって、アプリケーションでのユーザーによるディスカッションの開始、公開および格納が可能になります。お知らせサービスでは、アプリケーション・ページ上でのお知らせの作成と公開が可能になります。

ディスカッション・サービスとお知らせサービスは、Oracle WebCenter Portalのディスカッション・サーバーへの単一の接続を必要とします。両方のサービスが同じ接続を使用します。Oracle WebCenter Portalのディスカッション・サーバーは、Oracle Fusion Middlewareを使用してインストールできます。

Fusion Middleware ControlコンソールまたはWLSTを使用して追加のディスカッション・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

- 第14.3.1項「Fusion Middleware Controlを使用したディスカッション・サーバーの登録」

- 第14.3.2項「WLSTを使用したディスカッション・サーバーの登録」

WebCenter Portal: Spaces

Spacesアプリケーションでディスカッション・サービスとお知らせサービスを使用するには、いくつかの追加構成が必要になります。これには、Spacesのすべてのディスカッションとお知らせを格納する(ディスカッション・サーバー上の)カテゴリの選択などが含まれます。この構成はSpaces内で行います。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpacesのディスカッション・フォーラム・オプションの構成に関する項を参照してください。

14.2 ディスカッション・サーバーの前提条件

この項の内容は次のとおりです。

- 第14.2.1項「ディスカッション・サーバー: インストール」

- 第14.2.2項「ディスカッション・サーバー: 構成」

- 第14.2.3項「ディスカッション・サーバー: セキュリティに関する考慮事項」

- 第14.2.4項「ディスカッション・サーバー: 制限事項」

14.2.1 ディスカッション・サーバー: インストール

Oracle WebCenter Portalのインストール時に、Oracle WebCenter Portalのディスカッション・サーバーをインストールすることを選択します。リポジトリ作成ユーティリティ(RCU)を使用してDISCUSSIONSスキーマを作成します。

Oracle Fusion Middleware構成ウィザードによって、選択したWebCenter Portalコンポーネントをホストする管理対象サーバーがドメインに自動的に作成されます。

関連項目:

Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイド

14.2.1.1 ディスカッション・サーバー: 高可用性インストール

Oracle WebCenter Portalのディスカッション・サーバーを高可用性に対応するように設定する手順は次のとおりです。

1. クラスタ化された環境にWC_Collaborationドメインをインストールします。

2. 次のURL書式を使用して管理者としてディスカッション・サーバー管理コンソールにログオンします。http://host:port/owc_discussions/admin

3. キャッシュ機能ページに移動し、クラスタリングを有効化します(図14-1)。

図14-1 キャッシュ機能: クラスタリング

「図14-1 キャッシュ機能: クラスタリング」の説明

14.2.2 ディスカッション・サーバー: 構成

ディスカッション・サーバーを構成するための多数のWLSTコマンドがあります。

次のWLSTコマンドを使用して、Oracle WebCenter Portalのディスカッション・サーバーのシステム・プロパティを表示、設定および削除できます。

- getDiscussionsServerProperty

- setDiscussionsServerProperty

- removeDiscussionsServerProperty

addDiscussionsServerAdminコマンドは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与します。このコマンドは、現在の管理者を含まない新規のアイデンティティ・ストアにディスカッション・サーバーを接続するときに便利です。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のディスカッションとお知らせに関する項を参照してください。

スペース階層のディスカッションまたはお知らせ権限を更新した場合、ディスカッション・サーバーの対応する権限変更はサブスペースに自動的に継承されません。親に適用されたディスカッション・サーバーの権限変更をサブスペースに継承させるためには、syncDiscussionServerPermissionsコマンドを実行する必要があります(WebCenter Portal: Spacesのみ)。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsyncDiscussionsServerPermissionsに関する項を参照してください。

注意:

syncDiscussionServerPermissionsなどの、ディスカッション・サーバーWLSTコマンドを実行するには、管理サーバーへの接続に使用するユーザーがディスカッション・サーバーの管理権限も保有している必要があります。

14.2.3 ディスカッション・サーバー: セキュリティに関する考慮事項

- WS-Securityによって、WebアプリケーションとOracle WebCenter Portalのディスカッション・サーバーとの間に信頼関係が確立されます。そのため、ユーザーの資格証明がなくても、アプリケーションからディスカッション・サーバーにユーザー・アイデンティティ情報を渡すことができます。
Oracle WebCenter Portalのディスカッション・サーバーに対するOWSM WS-Securityの構成手順は、トポロジによって異なります。トポロジに応じて第34.1.3項「単純トポロジの場合のディスカッション・サーバーの構成」、第34.2.3項「標準トポロジの場合のディスカッション・サーバーの構成」または第34.3.3項「複合トポロジの場合のディスカッション・サーバーの構成」の手順に従ってください。

- WebCenter Portalアプリケーションからディスカッション・サーバーに送信される、Oracle WebCenter Portalのディスカッション・サーバー固有のWebサービス・メッセージは、暗号化されません。メッセージの機密保護のため、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスするか、またはOWSMポリシーによってWebサービスのエンド・ポイントを保護してください。詳細は、第33章「SSLの構成」と第34章「WS-Securityの構成」を参照してください。

- Oracle WebCenter Portalのディスカッション・サーバーはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。
本番環境では、第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、アイデンティティ・ストアを外部LDAPサーバーに再度関連付ける必要があります。さらに、Fusion Middleware管理者アカウントを外部LDAPに移動する(第29.5項「外部LDAPサーバーへの管理者アカウントの移行」を参照)か、管理者アカウントを移動しない場合は、ディスカッション・サーバーの新しい管理者アカウントを指定するために追加の手順が必要になります(第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」を参照)。

- Oracle Access Manager、Oracle Single Sign-OnまたはSAMLベースのシングル・サインオンを使用したシングル・サインオン・セキュリティを活用するように、Oracle WebCenter Portalのディスカッション・サーバーを構成できます。詳細は、第31章「シングル・サインオンの構成」を参照してください。また、Oracle Access Manager (OAM)に関する、ディスカッション固有の追加構成手順について、第31章の「SSO用のディスカッション・サーバーの構成」も参照してください。

注意:

WebCenter Portal: Spacesをソース・アプリケーションとし、Oracle WebCenter Portalのディスカッション・サーバーをターゲット・アプリケーションとして、SAMLシングル・サインオンを設定した場合は、SpacesからOracle WebCenter Portalのディスカッション・サーバーの管理ページに次のようにアクセスできます。

- 「スペース」→「設定」→「サービス」ページ

- 「管理」→「構成」→「サービス」ページ

ただし、Oracle WebCenter Portalのディスカッション・サーバーの管理ページはSSOに参加しないので、管理ページに直接アクセスすると、ディスカッション・サーバーに再度ログインすることを求められます。

- WebCenter Portalがシングル・サインオン・ソリューションに統合されていない場合は、owc_discussionユーザー(/owc_discussions)とowc_discussion管理ユーザー(/owc_discussions/admin)で異なるログイン・セッションが必要になります。

- ユーザー・アイデンティティ: ユーザー・アイデンティティ管理は、Oracle WebLogic ServerでカスタムのJPS認証ファクトリを使用して指定された認証プロバイダ設定によって処理されます。適切な認証ファクトリが実行されていることを確認するには、Oracle WebCenter Portalのディスカッション・サーバー管理コンソールの「システム・プロパティ」ページに移動し、次のプロパティ値を確認します。

- owc_discussions.setup.complete_11.1.1.2.0=true

- AuthFactory.className=oracle.jive.security.JpsAuthFactory
AuthFactory.classNameがこの値に設定されている場合は、owc_discussions.setup.complete_11.1.1.2.0プロパティをfalseに設定して、Oracle WebCenter Portalのディスカッション・サーバーを再起動します。それによって、適切な初期化がアプリケーションに対して実行されるようになります。

14.2.4 ディスカッション・サーバー: 制限事項

Oracle WebCenter Portalのディスカッション・サーバーURLでは、ラベルの表示にサポートされている言語は英語とスペイン語のみですが、UTF-8形式でのデータの入力が可能です。ディスカッション・サーバーでのユーザーの操作には、(サポートされているすべての言語の)Oracle WebCenter Portalアプリケーションを使用することをお薦めします。ディスカッション・トピックやお知らせなどのデータで、WebCenter Portalでサポートされているすべての言語がサポートされ、ディスカッション・サーバーでも表示されます。

WebCenter PortalインスタンスがMicrosoft Windows上でネイティブ・エンコーディングで実行されている場合、ディスカッション・サービスとお知らせサービスでは、ASCII以外のユーザー名はサポートされません。Linux環境の場合、ディスカッション・サービスとお知らせサービスでASCII以外のユーザー名をサポートするためには、WebCenter Portalがデプロイされているサーバーで環境変数LC_ALLがutf-8に設定されていることが必要です。

WebCenter Portal: Spaces

ディスカッション・サーバーでユーザー権限を変更すると、予期しない動作を引き起こす可能性があるため、この変更は行わないでください。ディスカッションとお知らせのユーザー権限は常にSpacesで管理してください。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・サーバーのロール・マッピングの概要に関する項を参照してください。

14.3 ディスカッション・サーバーの登録

WebCenter Portalアプリケーションには複数のディスカッション・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第14.3.1項「Fusion Middleware Controlを使用したディスカッション・サーバーの登録」

- 第14.3.2項「WLSTを使用したディスカッション・サーバーの登録」

14.3.1 Fusion Middleware Controlを使用したディスカッション・サーバーの登録

ディスカッション・サーバーを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ディスカッションおよびお知らせ」を選択します。

4. 新規のディスカッション・サーバーに接続するには、「追加」をクリックします(図14-2)。

図14-2 ディスカッションおよびお知らせ接続の構成

5. この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表14-1)。

表14-1 ディスカッションおよびお知らせ接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。

名前は、アプリケーションのすべての接続タイプにおいて一意である必要があります。

アクティブな接続

これを選択した場合、アプリケーションでディスカッション・サービスとお知らせサービスにこの接続が使用されます。

1つのアプリケーションに対して複数のディスカッション・サーバー接続を登録できますが、ディスカッション・サービスとお知らせサービスに使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. ディスカッション・サーバーの接続の詳細を入力します。詳細は、表14-2を参照してください。

表14-2 ディスカッションおよびお知らせ接続: 接続の詳細

フィールド

説明

サーバーURL

ディスカッション・フォーラムおよびお知らせをホストするディスカッション・サーバーのURLを入力します。

例: http://discuss-server.com:8890/owc_discussions

管理者ユーザー名

ディスカッション・サーバー管理者のユーザー名を入力します。

このアカウントは、ディスカッション・サービスとお知らせサービスがWebCenter Portalユーザーにかわって管理操作を実行するときに使用されます。

Spacesアプリケーションでは、このアカウントはほとんどの場合、スペース関連のディスカッションとお知らせの管理に使用されます。このユーザーがsuper adminである必要はありません。ただし、このユーザーは、WebCenter Portal: Spacesの現在のルート・カテゴリ、つまりスペース関連のすべてのディスカッションとお知らせを格納する(ディスカッション・サーバー上の)カテゴリの管理権限を保有している必要があります。

注意: アプリケーションにスペース関連の機能が含まれていない場合は、管理者のユーザー名は不要です。

認証されたユーザーのWebサービス・ポリシーURI

ディスカッション・サーバーWebサービスへの認証アクセス用にこの接続で使用するポリシーを選択します。

SAML (Security Assertion Markup Language)は、認証および認可の権限を定義するセキュリティ・トークンを渡すためのXMLベースの標準です。(レシーバとの信頼関係を持っている)証明エンティティは、送信者保証と呼ばれる方式によってサブジェクトの検証を保証します。

指定するクライアント・ポリシーは、ディスカッション・サーバーでOWCDiscussionsServiceAuthenticatedエンドポイントに対して構成されているサービス・ポリシーと互換性があることが必要です。出荷時に設定されているデフォルトのサービス・ポリシーは、WSS 1.0 SAMLトークン・サービス・ポリシー(oracle/wss10_saml_token_service_policy)です。

使用可能なオプションは次のとおりです。

- WSS 1.0 SAMLトークン・クライアント・ポリシー(oracle/wss10_saml_token_client_policy)

- WSS 1.1メッセージ保護付きSAMLトークン・クライアント・ポリシー(oracle/wss11_saml_token_with_message_protection_client_policy)

- グローバル・ポリシー・アタッチメント

使用している環境でグローバル・ポリシー・アタッチメントをサポートしている場合は、WLSTコマンドdetachWebServicePolicyまたはEnterprise Managerを使用して、ディスカッション・サーバーでOWCDiscussionsServiceAuthenticatedエンドポイントにアタッチするデフォルト・ポリシーをoracle/no_authentication_client_policyに設定する必要があります。

パブリック・ユーザーのWebサービス・ポリシーURI

ディスカッション・サーバーWebサービスへのパブリック・アクセスにメッセージのセキュリティおよび整合性を強制するためにこの接続で使用するクライアント・ポリシーを選択します。

指定するクライアント・ポリシーは、ディスカッション・サーバーでOWCDiscussionsServicePublicエンドポイントに対して構成されているサービス・ポリシーと互換性があることが必要です。出荷時の設定では、パブリック・アクセスに対するサービス・ポリシーは構成されていません(「なし」)。

使用可能なオプションは次のとおりです。

- なし: これはデフォルト設定です。

- WSS 1.1メッセージ保護クライアント・ポリシー(oracle/wss11_with_message_protection_client_policy)

- グローバル・ポリシー・アタッチメント

使用している環境でグローバル・ポリシー・アタッチメントをサポートしている場合は、WLSTコマンドdetachWebServicePolicyまたはEnterprise Managerを使用して、ディスカッション・サーバーでOWCDiscussionsServicePublicエンドポイントにアタッチするデフォルト・ポリシーをoracle/no_authentication_client_policyに設定する必要があります。

受信者キーの別名

メッセージ保護付きポリシーに使用する受信者キー別名(OWCDiscussionsServicePublicエンドポイントとOWCDiscussionsServiceAuthenticatedエンドポイントに適用)を入力します。これは、構成されているキーストア内のディスカッション・サーバーの公開鍵を含む証明書の別名です。

第34章「WS-Securityの構成」も参照してください。

7. ディスカッションおよびお知らせ接続の拡張オプションを構成します(表14-3)。

表 14-3 ディスカッションおよびお知らせ接続: 詳細構成

フィールド

説明

接続タイムアウト

接続の適切なタイムアウトを指定します。

これは、アプリケーションが接続タイムアウト・メッセージを発行するまでにディスカッション・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは、-1です。これは、サービスのデフォルトが使用されることを示します。サービスのデフォルトは10秒です。

8. ディスカッション・サーバーへの接続には、追加のパラメータ(表14-4に示すものなど)が必要になる場合があります。

表14-4 追加のディスカッション接続プロパティ

追加の
接続プロパティ

説明

application.root.category.id

(WebCenter Portal: Spacesのみ)すべてのディスカッション・フォーラムを格納する、ディスカッション・サーバー上のアプリケーション・ルート・カテゴリID。たとえば、3に設定すると、すべてのフォーラムがID 3のカテゴリに格納されます。

ディスカッション・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表14-5)。

表14-5 ディスカッションおよびお知らせ接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- 名前: 接続プロパティの名前を入力します。

- 値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: OKをクリックするまで、削除された行は無効として表示されます。

9. 「OK」をクリックして、この接続を保存します。

10. 新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

WebCenter Portal: Spaceの場合、ディスカッション・サービスに対していくつかの追加構成を行うことをお薦めします。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのWebCenter Portal: Spacesのディスカッション・フォーラム・オプションの構成に関する項を参照してください。

14.3.2 WLSTを使用したディスカッション・サーバーの登録

WLSTコマンドのcreateDiscussionForumConnectionを使用して、ディスカッション・サーバーの接続を作成します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateDiscussionForumConnectionに関する項を参照してください。

新規の接続をアクティブに使用するようにディスカッションおよびお知らせサービスを構成するには、default=trueを設定します。

WS-Security用の追加プロパティを必ず設定します。第14.5.2項「WLSTを使用したディスカッション・サーバー接続の詳細の変更」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

14.4 ディスカッションおよびお知らせ用のアクティブな接続の選択

WebCenter Portalアプリケーションには複数のディスカッション・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。アクティブな接続は、次のもののバックエンド・ディスカッション・サーバーになります。

- ディスカッション・タスク・フロー(ディスカッション・フォーラム・マネージャ、ディスカッション、ポピュラー・トピック、最近のトピック、監視フォーラム、監視トピック)

- お知らせタスク・フロー(お知らせマネージャ、お知らせ)

この項の内容は次のとおりです。

- 第14.4.1項「Fusion Middleware Controlを使用したディスカッションおよびお知らせ用のアクティブな接続の選択」

- 第14.4.2項「WLSTを使用したディスカッションおよびお知らせ用のアクティブなディスカッションの選択」

14.4.1 Fusion Middleware Controlを使用したディスカッションおよびお知らせ用のアクティブな接続の選択

アクティブな接続を変更する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ディスカッションおよびお知らせ」を選択します。
「ディスカッションおよびお知らせ接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

14.4.2 WLSTを使用したディスカッションおよびお知らせ用のアクティブなディスカッションの選択

WLSTコマンドのsetDiscussionForumConnectionをdefault=trueで使用して、既存の接続をアクティブ化します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumConnectionに関する項を参照してください。

ディスカッションおよびお知らせの接続を無効にするには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveDiscussionForumServicePropertyコマンドを使用します。

removeDiscussionForumServiceProperty('appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のremoveDiscussionForumServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンドライン・ツールを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

14.5 ディスカッション・サーバー接続の詳細の変更

ディスカッション・サーバー接続の詳細はいつでも変更できます。

変更後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第14.5.1項「Fusion Middleware Controlを使用したディスカッション・サーバー接続の詳細の変更」

- 第14.5.2項「WLSTを使用したディスカッション・サーバー接続の詳細の変更」

14.5.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の詳細の変更

ディスカッション・サーバー接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ディスカッションおよびお知らせ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表14-2と表14-4を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

14.5.2 WLSTを使用したディスカッション・サーバー接続の詳細の変更

WLSTコマンドのsetDiscussionForumConnectionを使用して、接続の詳細を編集します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumConnectionに関する項を参照してください。

追加パラメータを設定するには、setDiscussionForumConnectionPropertyコマンドを使用します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

14.6 ディスカッション・サーバー接続の削除

ディスカッション・サーバー接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。ディスカッション・タスク・フローとお知らせタスク・フローはいずれもバックエンド・ディスカッション・サーバーを必要とするため、アクティブな接続を削除すると機能しなくなります。

この項の内容は次のとおりです。

- 第14.6.1項「Fusion Middleware Controlを使用したディスカッション・サーバー接続の削除」

- 第14.6.2項「WLSTを使用したディスカッション・サーバー接続の削除」

14.6.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の削除

ディスカッション・サーバー接続を削除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ディスカッションおよびお知らせ」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:

管理対象サーバーを再起動する前に、他の接続をアクティブとしてマークしてください。そうしないとサービスが無効になります。

14.6.2 WLSTを使用したディスカッション・サーバー接続の削除

WLSTコマンドのdeleteConnectionを使用して、接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

別の接続がアクティブとしてマークされていることを確認します。アクティブな接続がないと、サービスが無効化されます。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

14.7 ディスカッション・サービスのデフォルトの設定

WLSTコマンドsetDiscussionForumServicePropertyを使用して、アプリケーションでディスカッション・サービスのデフォルトを設定します。

- topics.fetch.size: ディスカッション・サービスによってフェッチされ、トピックのビューに表示される最大トピック数。

- forums.fetch.size: ディスカッション・サービスによってフェッチされ、フォーラムのビューに表示される最大フォーラム数。

- recentTopics.fetch.size: ディスカッション・サービスによってフェッチされ、最近のトピックのビューに表示される最大トピック数。

- watchedTopics.fetch.size: ディスカッション・サービスによってフェッチされ、監視トピックのビューに表示される最大トピック数。

- watchedForums.fetch.size: ディスカッション・サービスによってフェッチされ、監視フォーラムのビューに表示される最大フォーラム数。

- application.root.category.id: すべてのディスカッション・フォーラムを格納する、ディスカッション・サーバー上のアプリケーション・ルート・カテゴリID。たとえば、3に設定すると、すべてのフォーラムがID 3のカテゴリに格納されます。

- ForumGatewayManager.AUTO_START: Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・フォーラムでのスペース・メールの公開に関する項で説明しているように、メール配信リストによる通信をディスカッション・フォーラム投稿としてディスカッション・サーバー上で公開できます。このパラメータはこの通信のゲートウェイを起動または停止します。
WebCenter Portal: Spacesアプリケーションの場合、デフォルト値は1 (true)です。これは、管理からメール・サーバー設定を構成するとすぐにゲートウェイが起動することを意味します。ゲートウェイを停止し、この機能を無効化するには、この値を0 (false)に設定し、管理対象サーバーを再起動します。

WebCenter Portal: Frameworkアプリケーションの場合、デフォルト値は0です。ゲートウェイを起動し、この機能を有効化するには、この値を1に設定し、管理対象サーバーを再起動します。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

14.8 お知らせサービスのデフォルトの設定

WLSTコマンドのsetAnnouncementServicePropertyを使用して、お知らせサービスのデフォルトを設定します。

- miniview.page_size: お知らせのクイック・ビューに表示する最大お知らせ数。

- mainview.page_size: お知らせのメイン・ビューに表示する最大お知らせ数。

- linksview.page_size: お知らせのリンク・ビューに表示する最大お知らせ数。

- announcements.expiration.days: お知らせを表示し、編集可能にする日数。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetAnnouncementServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

14.9 ディスカッション・サーバー接続のテスト

次のURLを使用してディスカッション・サーバーへのアクセスを試みます。

http://host:port/owc_discussions

すべての公開情報をリストするページが表示されるはずです。

14.10 ディスカッション・サーバーの管理者権限の付与

WLSTコマンドaddDiscussionsServerAdminは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与します。このコマンドは、現在の管理者を含まない新規のアイデンティティ・ストアにディスカッション・サーバーを接続するときに便利です。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

14.11 ディスカッション・サーバーの管理者ロールの付与

WebCenter Portalに対して作成されるデフォルト・ドメイン管理者は、Oracle WebCenter Portalのディスカッション・サーバーの管理者でもあります。デフォルト以外のユーザーをディスカッション・サーバーの管理者にすることも可能です。

ドメインの作成時に、他の任意のユーザーをドメイン管理者として指定すると、ドメインのすべての管理権限がそのユーザーに付与されます。ただし、ドメイン作成後に、Spacesアプリケーションとディスカッション・サーバーの両方で、そのデフォルト以外のユーザーに管理者ロールを手動で付与する必要があります。Spacesでデフォルト以外のユーザーに管理者権限を付与する方法の詳細は、第30.6.1項「Spaces管理者ロールの付与」を参照してください。

Oracle WebCenter Portalのディスカッション・サーバーの場合、デフォルト・ユーザーはスーパー管理者です。この項では、デフォルト以外のユーザーに管理者権限を付与する方法について説明します。

14.11.1 WLSTを使用したディスカッション・サーバー管理者ロールの付与

WLSTコマンドaddDiscussionsServerAdminでは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与できます。これは、ディスカッション・サーバーを新しいアイデンティティ・ストアに接続するときに役立ちます。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

14.11.2 管理コンソールを使用したディスカッション・サーバー管理者ロールの付与

Oracle WebCenter Portalのディスカッション・サーバーの管理者ロールをデフォルト以外のユーザーに付与する手順は次のとおりです。

1. 次のURL書式を使用して管理者としてディスカッション・サーバー管理コンソールにログオンします。http://host:port/owc_discussions/admin

2. ページの一番上にあるリンクのリストで「設定」リンクをクリックします。

3. 左側のナビゲーション・パネルで、「管理者/モデレータ」リンクが選択されていない場合は、これをクリックします。

4. 「管理者およびモデレータ」ページで、「新規権限の付与」タブをクリックします。

5. 「システム管理」チェック・ボックスを選択します。

6. 「特定のユーザー」チェック・ボックスを選択して、Oracle WebCenter Portalのディスカッション・サーバーの管理権限を付与するユーザーを指定します。

7. 「新規権限の付与」をクリックします。
これで、管理権限を割り当てたユーザーとして、Oracle WebCenter Portalのディスカッション・サーバーにログオンできるようになりました。

図14-3 Oracle WebCenter Portalのディスカッション・サーバーの管理者ロールの付与

「図14-3 Oracle WebCenter Portalのディスカッション・サーバーの管理者ロールの付与」の説明

14.11.3 ディスカッション・サーバー管理者ロールの取消し

デフォルト以外の必要なユーザーにディスカッション・サーバー管理者ロールを割り当てた後に、デフォルト・ユーザーの管理者ロールを取り消すことができます。

管理者ロールを取り消す手順は次のとおりです。

1. 管理者ロールが割り当てられたデフォルト以外のユーザーとして、ディスカッション・サーバー管理コンソールにログオンします。

2. ページの一番上にあるリンクのリストで「設定」リンクをクリックします。

3. 左側のナビゲーション・パネルで、「管理者/モデレータ」リンクが選択されていない場合は、これをクリックします。

4. 「管理者およびモデレータ」ページの「権限のサマリー」タブで、必要なユーザー(例: weblogic)の「システム管理」チェック・ボックスの選択を解除します。(図14-4)

図14-4 管理者ロールの取消し

「図14-4 管理者ロールの取消し」の説明

5. 「変更の保存」をクリックします。
これで、Oracle WebCenter Portalのディスカッション・サーバーの管理権限がデフォルトのユーザーから取り消されました。

14.12 お知らせおよびディスカッションに関する問題のトラブルシューティング

このトラブルシューティングの項の内容は次のとおりです。

- 第14.12.1項「認証に失敗した」

- 第14.12.2項「スペースでディスカッションを有効化できない」

- 第14.12.3項「ログインに失敗した」

- 第14.12.4項「Oracle Access Managerの構成後にログインが正しく機能しない」

- 第14.12.5項「カテゴリが見つからないという例外」

14.12.1 認証に失敗した

問題

WebCenter Portalとバックエンド・ディスカッション・サーバー間の接続に対してWS-Securityが正しく設定されていないようです。次のエラーが表示されることがあります。

failure to authenticate the user WebLogic, due to: Authentication Failed

解決策

このエラーは様々な理由で発生する可能性があります。次のことを確認します。

- ディスカッション接続とディスカッション・サーバー間でOWSM SAMLポリシー設定が正しく定義されていることを確認します。

- WebCenter Portalディスカッション・サービスについては、WC_Spaces-diagnostic.logでエラーおよび例外を確認します。エラーの修正に必要な十分な情報をログから得られない場合は、oracle.webcenter.collab.shareおよびoracle.webcenter.collab.forumパッケージに対してデバッグを有効にします。

- バックエンド・ディスカッション・サーバーについては、ドメインの$DOMAIN_HOME/config/fmwconfig/servers/SERVER_NAME/owc_discussions/logsディレクトリにあるWC_Collaboration-diagnostics.logおよびjive.error.logを確認します。エラーの修正に必要な十分な情報をログから得られない場合は、Oracle WebCenter Portalのディスカッション・サーバーに対してデバッグを有効にします。デバッグ・ログを有効にするには、Oracle WebCenter Portalのディスカッション・サーバー管理コンソールにログオンし、ページのログに移動して「デバッグ」タブを選択し、デバッグを有効化します。WC_Collaborationドメインを再起動すると、ロギング設定が変更されます。

- WebCenter Portalアプリケーションとバックエンド・ディスカッション・サーバーで時間が同期されていることを確認します。OWSM WS-Securityでは、これが重要です。

14.12.2 スペースでディスカッションを有効化できない

問題

新しいスペースも含めて、どのスペースでもディスカッションを有効化できません。

解決策

このエラーは様々な理由で発生する可能性があります。次のことを確認します。

- バックエンド・ディスカッション・サーバーが稼働しており、このサーバーにアクセス可能なこと。第14.9項「ディスカッション・サーバー接続のテスト」を参照してください。

- アクティブな接続の管理者ユーザー名(adminUser)プロパティが正しく構成され、このプロパティがアプリケーション・ルート・カテゴリ(WebCenter Portal: Spaces用に構成されたカテゴリ)に対する管理権限を保有していること。第14.3項「ディスカッション・サーバーの登録」を参照してください。
このユーザーがsuper adminである必要はありません。ただし、このユーザーは、Spaces用に構成されたアプリケーション・ルート・カテゴリ、つまりスペースのすべてのすべてのディスカッションとお知らせを格納する(ディスカッション・サーバー上の)カテゴリの管理権限を保有している必要があります。

- スペースのすべてのディスカッションとお知らせを格納するアプリケーション・ルート・カテゴリがバックエンド・ディスカッション・サーバー上に存在すること。
Spacesアプリケーション用に構成されたアプリケーション・ルート・カテゴリIDは、「WebCenter Portal管理」→「構成」→「サービス」→「ディスカッション」に移動することによって確認できます。Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッションおよびお知らせをディスカッション・サーバー上のどの場所に格納するかの指定に関する項を参照してください。

14.12.3 ログインに失敗した

問題

次のログイン例外が表示されることがあります。

caught exception running task oracle.webcenter.collab.share.LoginFailedException: failure to authenticate the user monty, due to: Failed to read user monty from database.
at oracle.webcenter.collab.forum.internal.jive.JiveAuthenticator.login(JiveAuthenticator.java:213)

これは、正しくない管理ユーザー名が指定されたときに発生します。

解決策

次の手順に従ってください。

1. ディスカッション・フォーラム接続の作成時に指定された管理ユーザーがディスカッション管理コンソール(http://host:port/owc_discussions/admin)にアクセスできることを確認します。
このユーザーが管理権限を保有していない場合は、WLSTコマンドaddDiscussionsServerAdminを使用してユーザーのプロビジョニングを行います。詳細は、第14.11.1項「WLSTを使用したディスカッション・サーバー管理者ロールの付与」を参照してください。

2. 適切なDISCUSSIONSスキーマとともにディスカッション・サーバーが構成されていることを確認します。このように構成されていない場合は、config.shまたはwas_config.shを使用してドメインを作成または拡張します。

14.12.4 Oracle Access Managerの構成後にログインが正しく機能しない

問題

Oracle Access Managerシングル・サインオンを構成した後にOracle WebCenter Portalのディスカッション・サーバーにログインすると、500 - Internal Server Errorが発生します。

解決策

1. スーパー管理者が存在しない場合は、WLSTコマンドaddDiscussionsServerAdminを使用して、Oracle WebCenter Portalのディスカッション・サーバーでユーザーをスーパー管理者として追加します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

2. スーパー管理者アカウントを使用してディスカッション管理コンソールにログオンし、「システム」→「システム・プロパティ」に移動します。

3. owc_discussions.sso.modeプロパティを作成または編集して、値をtrueに設定します。詳細は、第31.2.6.2項「SSO用のディスカッション・サーバーの構成」を参照してください。

4. Oracle WebCenter Portalのディスカッション・サーバーを再起動します。

14.12.5 カテゴリが見つからないという例外

問題

別のディスカッション・サーバーを使用するために接続を変更した場合や、「管理」→「構成」→「サービス」→「ディスカッション」からアプリケーション・ルート・カテゴリIDを変更した場合に、「カテゴリが見つかりません。」のような例外が表示されることがあります。

解決策

WebCenter Portalアプリケーションがデプロイされる管理対象サーバーを再起動します。

15 イベント・サービスの管理

この章では、Oracle WebCenter PortalアプリケーションでMicrosoft Exchangeの個人の予定表を公開するためのイベント・サービスの構成および管理方法について説明します。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にWebCenter Portalアプリケーションに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったイベント・サービスの構成変更は動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第15.1項「イベント接続に関する必要な知識」

- 第15.2項「イベント・サービスの個人イベントの構成ロードマップ」

- 第15.3項「イベント・サービスの個人イベントに関する前提条件」

- 第15.4項「イベント・サーバーの登録」

- 第15.5項「アクティブなイベント・サーバー接続の選択」

- 第15.6項「イベント・サーバー接続の詳細の変更」

- 第15.7項「イベント・サーバー接続の削除」

- 第15.8項「イベント・サーバー接続のテスト」

- 第15.9項「イベントに関する問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

15.1 イベント接続に関する必要な知識

WebCenter Portal: Spacesにおいて、イベント・サービスは、ミーティング、約束、およびその他のタイプのチーム、プロジェクトまたはグループの出来事をスケジュールするために使用できるスペース・カレンダを提供します。またイベント・サービスを通じて、Microsoft Exchangeの個人の予定表にアクセスし、特定のスペースに関連付けられていないイベントをここでスケジュールすることもできます。

WebCenter Portal: Frameworkを使用して構築したアプリケーションでは、イベント・サービスは、Microsoft Exchangeの個人の予定表へのアクセスのみ提供します。

個人の予定表はMicrosoft Exchange Serverから提供されるため、このサーバーへの接続が必要です。Fusion Middleware ControlコンソールまたはWLSTを使用して、Microsoft Exchange Server接続を登録できます。

サービスを機能させるには、接続をアクティブとしてマークする必要があります。追加のMicrosoft Exchange Server接続を登録できますが、一度にアクティブにできる接続は1つのみです。

ユーザーがWebCenter Portalアプリケーションで個人イベントを表示するには、Microsoft Exchange Server上にアカウントを保有している必要があります。

15.2 イベント・サービスの個人イベントの構成ロードマップ

個人イベントへのアクセスを提供するための構成プロセスの手順を示す管理者向けのガイドとして、この項のロードマップを使用してください。

- ロードマップ: WebCenter Portal: Spaces用の個人イベントの構成
この項のフロー・チャート(図15-1)と表(表15-1)は、WebCenter Portal: Spacesで個人イベントを動作させるための前提条件と必要なタスクの概要を示しています。

図15-1 WebCenter Portal: Spaces用の個人イベントの構成

「図15-1 WebCenter Portal: Spaces用の個人イベントの構成」の説明

表15-1 WebCenter Portal: Spaces用の個人イベントの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter Portal: SpacesとMicrosoft Exchange Serverをインストールします

MS Exchange Serverは個人の予定表のバックエンド・コンポーネントです

- MS Exchange Server 2007をインストールします

1.a MS Exchange Server 2007を構成します

1.b セキュリティ設定を編集します

1.c (オプション) SSLを有効化します

- MS Exchange Server 2003をインストールします

1.a WebCenter Portalの個人イベントWebサービス・プラグインをダウンロードし、インストールします

1.b MS Exchange Server 2003を構成します

1.c (オプション) SSLを有効化します

2. 次のツールのいずれかを使用して、Spacesアプリケーションとイベント・サーバー間の接続を構成します

- Fusion Middleware Control

- WLST

エンド・ユーザー

3. WebCenter Portal: Spacesで個人の予定表が動作していることをテストします

3.a WebCenter Portal: Spacesにログインし、ホーム・スペース内のページにイベント・タスク・フローを追加します

3.b イベント・タスク・フローで「個人カレンダにログイン」をクリックし、MS Exchange Serverのログイン資格証明を入力します

- ロードマップ: Frameworkアプリケーション用の個人イベントの構成
この項のフロー・チャート(図15-2)と表(表15-2)は、Frameworkアプリケーションで個人イベントを動作させるための前提条件と必要なタスクの概要を示しています。

図15-2 Frameworkアプリケーション用の個人イベントの構成

「図15-2 Frameworkアプリケーション用の個人イベントの構成」の説明

表15-2 Frameworkアプリケーション用の個人イベントの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter PortalとMicrosoft Exchange Serverをインストールします

MS Exchange Serverは個人の予定表のバックエンド・コンポーネントです

- MS Exchange Server 2007を使用します

1.a MS Exchange Server 2007を構成します

1.b セキュリティ設定を編集します

1.c (オプション) SSLを有効化します

- MS Exchange Server 2003を使用します

1.a WebCenter Portalの個人イベントWebサービス・プラグインをダウンロードし、インストールします

1.b MS Exchange Server 2003を構成します

1.c (オプション) SSLを有効化します

開発者

2. イベント・サービスをアプリケーションに統合します

2.a JDeveloperで、イベント・サーバーへの接続を構成します

2.b JDeveloperで、イベント・タスク・フローをページに追加します

開発者/

管理者

3. 次のツールのいずれかを使用してアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール (管理者)

開発者/

管理者

4. 次のいずれかのツールを使用して接続パラメータを追加または変更します

- JDeveloper。その後アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー

5. イベント・タスク・フローで「個人カレンダにログイン」のクリックし、MS Exchange Serverのログイン資格証明を入力します

15.3 イベント・サービスの個人イベントに関する前提条件

この項の内容は次のとおりです。

- 第15.3.1項「Microsoft Exchange Server 2007に関する前提条件」

- 第15.3.2項「Microsoft Exchange Server 2003に関する前提条件」

15.3.1 Microsoft Exchange Server 2007に関する前提条件

この項では、イベント・サービスの個人イベント用のサーバーとしてMicrosoft Exchange Server 2007を使用する場合の前提条件について説明します。

この項の内容は次のとおりです。

- 第15.3.1.1項「Microsoft Exchange Server 2007: インストール」

- 第15.3.1.2項「Microsoft Exchange Server 2007: 構成」

- 第15.3.1.3項「Microsoft Exchange Server 2007: セキュリティに関する考慮事項」

- 第15.3.1.4項「Microsoft Exchange Server 2007: 制限事項」

15.3.1.1 Microsoft Exchange Server 2007: インストール

インストールの詳細は、Microsoft Exchange Server 2007のドキュメントを参照してください。

15.3.1.2 Microsoft Exchange Server 2007: 構成

Microsoft Exchange Server 2007を個人イベント用のサーバーとして使用するには、Microsoft Exchange Server 2007 WebサービスのWSDLを編集してこのWebサービスの場所を指定する必要があります。

Microsoft Exchange Server 2007 Webサービスの場所を指定する手順は次のとおりです。

1. Microsoft Exchange Server WebサービスのWSDLファイルを開きます。次に例を示します。

C:\Program Files\Microsoft\Exchange Server\ClientAccess\exchweb\ews\Services.wsdl

2. Microsoft Exchange Server Webサービスを指すserviceセクションを追加します。次に例を示します。

<wsdl:definitions>
...
<wsdl:service name="ExchangeServices">
<wsdl:port name="ExchangeServicePort" binding="tns:ExchangeServiceBinding">
<soap:address location="https://server.example.com/EWS/Exchange.asmx"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

15.3.1.3 Microsoft Exchange Server 2007: セキュリティに関する考慮事項

イベント・サービスには、JAX-WSプロキシを介してMicrosoft Exchange Server 2007汎用Webサービスと通信するMicrosoft Exchange Server 2007アダプタが含まれています。アダプタとWebサービス間の通信を設定するには、Microsoft Exchange Serverのセキュリティ設定を編集する必要があります。

セキュリティ設定を編集する手順は次のとおりです。

1. Microsoft Exchange Serverで「インターネット インフォメーション サービス (IIS) マネージャー」を開きます。

2. 「computer_name」ノード→「Webサイト」→「既定のWebサイト」→「EWS」で、「プロパティ」をクリックします。

3. 「ディレクトリ セキュリティ」タブの「認証とアクセス制御」で「編集」をクリックします。

4. 「基本認証」を選択します。

5. 「OK」をクリックします。
Services.wsdl、Messages.vsdおよびTypes.vsdへの匿名アクセスを有効にして、JAX-WSがWebサービス・コールのコミット前にこれらにアクセスしてサービス・ポートを作成できるようにする必要があります。

6. Services.wsdlを右クリックして「編集」を選択します。

7. 「ファイル セキュリティ」タブの「認証とアクセス制御」で「編集」をクリックします。

8. 「匿名アクセスを有効にする」を選択します。

9. 「OK」をクリックします。

10. Messages.xsdとTypes.xsdに対して手順6から9を繰り返します。

イベント・サービスは、Basic認証を使用してMicrosoft Exchange Serverと通信します。通信を保護するには、SSLを有効にする必要があります。詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/56bdf977-14f8-4867-9c51-34c346d48b04.mspx?mfr=true

15.3.1.4 Microsoft Exchange Server 2007: 制限事項

現在、既知の制限事項はありません。

15.3.2 Microsoft Exchange Server 2003に関する前提条件

この項では、イベント・サービスの個人イベント用のサーバーとしてMicrosoft Exchange Server 2003を使用する場合の前提条件について説明します。

この項の内容は次のとおりです。

- 第15.3.2.1項「Microsoft Exchange Server 2003: インストール」

- 第15.3.2.2項「Microsoft Exchange Server 2003: 構成」

- 第15.3.2.3項「Microsoft Exchange Server 2003: セキュリティに関する考慮事項」

- 第15.3.2.4項「Microsoft Exchange Server 2003: 制限事項」

15.3.2.1 Microsoft Exchange Server 2003: インストール

インストールの詳細は、Microsoft Exchange Server 2003のドキュメントを参照してください。

15.3.2.2 Microsoft Exchange Server 2003: 構成

Microsoft Exchange Server 2003はWebサービスを備えていないため、Microsoft Exchange Server 2003をイベント・サービス用のサーバーとして使用するためには、IISコンピュータにWebCenter Portalの個人イベントWebサービス・プラグインをインストールする必要があります。このプラグインはOracle Fusion MiddlewareコンパニオンCDに収録されています。

個人イベントWebサービス・プラグインをインストールする手順は次のとおりです。

1. ExchangeWebService.zipの内容をインターネット・インフォメーション・サービス(IIS)サーバー内のフォルダに展開します。このZIPファイルは、Oracle Fusion MiddlewareコンパニオンCDの次のディレクトリにあります。

/Disk1/WebCenter/services/cal/NT/ExchangeWebService.zip

注意:

ファイルを抽出するフォルダに適切な読取り権限を必ず設定してください。必要に応じて、追加の変更権限および書込み権限を持つサーバー・オペレータと認証されたユーザーを追加します。

2. 「IIS マネージャー」を開きます。

3. 「server_name」→「Webサイト」→「既定のWebサイト」で、ExchangeWSという名前の新しい仮想ディレクトリを作成します(「エイリアス」にこの名前を指定)。

4. 新しい仮想ディレクトリがZIPファイルの抽出先フォルダを指すようにします。

5. このフォルダに読取り権限とスクリプトの実行権限を必ず設定します。

6. 新しい仮想ディレクトリを右クリックして「プロパティ」を選択します。

7. 「仮想ディレクトリ」タブの「アプリケーションの設定」で、「実行アクセス許可」ドロップダウン・リストから「スクリプトおよび実行可能ファイル」を選択します。

8. 「適用」をクリックします。

9. 「ASP.NET」タブで、「ASP.NET バージョン」が「2.0.XXXXX」になっていることを確認します。

注意:

ASP.NETがデフォルトで使用可能でない場合は、次の場所から.NET 2.0 Frameworkをインストールしてください。

http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en

10. 「構成の編集」をクリックします。

11. 「ASP .NET 構成の設定」ダイアログで、「ExchangeServerURL」の値が正しいことを確認します。次に例を示します。

http://localhost:port/Exchange/User/calendar

ヒント:

「ExchangeServerURL」では、大/小文字が区別されます。

必要に応じて、IISポート番号を反映するようにポートを変更します。デフォルトでは、これは80です。

12. 変更を適用して、ダイアログを閉じます。

13. C:\WSErrorLogsというフォルダを作成します。

14. ブラウザで次のURLにアクセスすることによって、IISサーバーとWebCenter PortalサーバーからWebサービスをテストします。

http://host:port/ExchangeWS/PersonalEventsWebService.asmx

15.3.2.3 Microsoft Exchange Server 2003: セキュリティに関する考慮事項

イベント・サービスは、Basic認証を使用してMicrosoft Exchange Serverと通信します。通信を保護するには、SSLを有効にする必要があります。詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/56bdf977-14f8-4867-9c51-34c346d48b04.mspx?mfr=true

15.3.2.4 Microsoft Exchange Server 2003: 制限事項

現在、既知の制限事項はありません。

15.4 イベント・サーバーの登録

WebCenter Portalアプリケーションには複数のイベント・サーバーを登録できますが、一度にアクティブにできるサーバーは1つのみです。

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第15.4.1項「Fusion Middleware Controlを使用したイベント・サーバーの登録」

- 第15.4.2項「WLSTを使用したイベント・サーバーの登録」

15.4.1 Fusion Middleware Controlを使用したイベント・サーバーの登録

イベント・サーバーを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「個人イベント」を選択します。

4. 新しいイベント・サーバー・インスタンスに接続するには、「追加」をクリックします(図15-3)。

図15-3 イベント接続の構成

5. この接続の一意の名前を入力し、Microsoft Exchange Serverのバージョンを指定して、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表15-2)。

表15-3 個人イベント接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

接続タイプ

接続先のMicrosoft Exchange Serverを選択します。

- Microsoft Exchange Server 2003

- Microsoft Exchange Server 2007

アクティブな接続

これを選択した場合、WebCenter Portalアプリケーションでイベント・サービスに対してこの接続が使用されます。

複数のイベント・サーバー接続を登録できますが、イベント・サービスで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. イベント・サーバーの接続の詳細を入力します(表15-4)。

表15-4 個人イベント: 接続の詳細

フィールド

説明

WebサービスURL

イベント・アプリケーションを公開するWebサービスのURLを入力します。

次の形式を使用します。

protocol://host:port/appWebServiceInterface/WSName

次に例を示します。

http://myexchange.com:80/ExchangeWS/PersonalEventsWebService.asmx
http://myexchange.com:80/EWS/Services.wsdl

関連付けられている外部アプリケーション

イベント・サービスを外部アプリケーションに関連付けます。外部アプリケーションの資格証明情報が、イベント・サービスをホストしているMicrosoft Exchange Serverに対してユーザーを認証するために使用されます。

7. 「OK」をクリックして、この接続を保存します。

8. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.4.2 WLSTを使用したイベント・サーバーの登録

WLSTコマンドのcreatePersonalEventConnectionを使用して、イベント・サーバー接続を作成します。既存の接続を変更するには、setPersonalEventConnectionを使用します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreatePersonalEventConnectionおよびsetPersonalEventConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンドライン・ツールを使用したWebLogic管理対象サーバーの起動と停止に関する項を参照してください。

15.5 アクティブなイベント・サーバー接続の選択

WebCenter Portalアプリケーションには複数のイベント・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

この項の内容は次のとおりです。

- 第15.5.1項「Fusion Middleware Controlを使用したアクティブなイベント・サーバーの選択」

- 第15.5.2項「WLSTを使用したアクティブなイベント・サーバー接続の選択」

15.5.1 Fusion Middleware Controlを使用したアクティブなイベント・サーバーの選択

アクティブな接続を変更する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「個人イベント」を選択します。
「個人イベント接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.5.2 WLSTを使用したアクティブなイベント・サーバー接続の選択

WLSTコマンドのsetPersonalEventConnectionをdefault=trueで使用して、既存のイベント・サーバー接続をアクティブ化します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetPersonalEventConnectionに関する項を参照してください。

その後、イベント接続を無効化するには、default=falseと指定して同じWLSTコマンドを実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

15.6 イベント・サーバー接続の詳細の変更

イベント・サーバー接続の詳細はいつでも変更できます。

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第15.6.1項「Fusion Middleware Controlを使用したイベント・サーバー接続の詳細の変更」

- 第15.6.2項「WLSTを使用したイベント・サーバー接続の詳細の変更」

15.6.1 Fusion Middleware Controlを使用したイベント・サーバー接続の詳細の変更

イベント・サーバー接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「個人イベント」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータ情報の詳細は、表15-4を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.6.2 WLSTを使用したイベント・サーバー接続の詳細の変更

WLSTコマンドのsetPersonalEventConnectionを使用すると、既存のイベント・サーバー接続を編集できます。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetPersonalEventConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

15.7 イベント・サーバー接続の削除

イベント・サーバー接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーが個人の予定表にイベントを作成できなくなります。

この項の内容は次のとおりです。

- 第15.7.1項「Fusion Middleware Controlを使用したイベント・サーバー接続の削除」

- 第15.7.2項「WLSTを使用したイベント・サーバー接続の削除」

15.7.1 Fusion Middleware Controlを使用したイベント・サーバー接続の削除

イベント・サーバー接続を削除する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「個人イベント」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.7.2 WLSTを使用したイベント・サーバー接続の削除

WLSTコマンドのdeleteConnectionを使用して、イベント・サーバーの接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

15.8 イベント・サーバー接続のテスト

イベント・サーバーへの接続を確認する手順は次のとおりです。

1. WebCenter Portalアプリケーションでページにイベント・タスク・フローを追加します。

ヒント:

WebCenter Portal: Spacesでは、ホーム・スペース内のページにタスク・フローを追加します。

2. Microsoft Exchange Serverアカウントにログインします。

3. Microsoft Exchange Serverからの個人イベントがタスク・フローに表示されるはずです。

15.9 イベントに関する問題のトラブルシューティング

ユーザーが個人イベントを表示できない場合は、次のことを確認します。

- WebCenter Portalアプリケーションがデプロイされている管理対象サーバーからMicrosoft Exchange Server/IISサーバーにアクセスできますか。これらは互いにping可能ですか。

- Microsoft Exchange Server上の構成に誤りはありませんか。詳細は、第15.3.1.2項「Microsoft Exchange Server 2007: 構成」または第15.3.2.2項「Microsoft Exchange Server 2003: 構成」を参照してください。

- 管理対象サーバーでのイベント・サーバー接続に誤りはありませんか。詳細は、第15.4項「イベント・サーバーの登録」を参照してください。

- ユーザーはMicrosoft Exchange Server上のアカウントのユーザー名とパスワードを正しく入力しましたか。ユーザー名は通常、電子メール・アドレスです。

16 インスタント・メッセージおよびプレゼンス・サービスの管理

この章では、WebCenter Portalアプリケーションで使用されるインスタント・メッセージおよびプレゼンス(IMP)サービスを構成および管理する方法について説明します。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったインスタント・メッセージおよびプレゼンス・サービスの構成の変更は動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第16.1項「インスタント・メッセージおよびプレゼンス接続に関する必要な知識」

- 第16.2項「インスタント・メッセージおよびプレゼンス・サーバーの前提条件」

- 第16.3項「インスタント・メッセージおよびプレゼンス・サーバーの登録」

- 第16.4項「インスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」

- 第16.5項「インスタント・メッセージおよびプレゼンス接続の詳細の変更」

- 第16.6項「インスタント・メッセージおよびプレゼンス接続の削除」

- 第16.7項「インスタント・メッセージおよびプレゼンス・サービスのデフォルトの設定」

- 第16.8項「インスタント・メッセージおよびプレゼンス接続のテスト」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

16.1 インスタント・メッセージおよびプレゼンス接続に関する必要な知識

IMPサービスを使用すると、認証された他のアプリケーション・ユーザーのプレゼンス・ステータス(オンライン、オフライン、ビジーまたは退席中)を確認し、インスタント・メッセージ(IM)やメールなどの連絡方法に即時にアクセスできます。

バックエンド・プレゼンス・サーバーへの単一の接続が必要です。WebCenter Portalは、Microsoft Office Live Communications Server (LCS) 2005、Microsoft Office Communications Server (OCS) 2007およびMicrosoft Lync 2010での動作が保証されています。

ノート:

Oracle Beehive Server接続は、このリリースではサポートされていません。

アプリケーションのプレゼンス・サーバー接続は、Fusion Middleware ControlまたはWLSTを使用して登録できます。サービスを機能させるには、接続をアクティブとしてマークする必要があります。追加のプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

16.2 インスタント・メッセージおよびプレゼンス・サーバーの前提条件

この項の内容は次のとおりです。

- 第16.2.1項「Microsoft Live Communications Server (LCS)の前提条件」

- 第16.2.2項「Microsoft Office Communications Server (OCS)の前提条件」

- 第16.2.3項「Microsoft Lyncの前提条件」

16.2.1 Microsoft Live Communications Server (LCS)の前提条件

この項では、Microsoft Live Communications Server 2005 (LCS)をインスタント・メッセージおよびプレゼンス・サービスのプレゼンス・サーバーとして使用するための前提条件を示します。

この項の内容は次のとおりです。

- 第16.2.1.1項「Microsoft LCS: インストール」

- 第16.2.1.2項「Microsoft LCS: 構成」

- 第16.2.1.3項「Microsoft LCS: セキュリティに関する考慮事項」

16.2.1.1 Microsoft LCS: インストール

インストールの詳細は、Microsoft Live Communications Server 2005のドキュメントを参照してください。

16.2.1.2 Microsoft LCS: 構成

Microsoft Live Communications Server 2005をインスタント・メッセージおよびプレゼンス・サービスのプレゼンス・サーバーとして使用するには、Microsoft RTC API v1.3をインストールして構成し、Microsoft LCS 2005用のOracle RTC Webサービスをインストールする必要があります。

1. Microsoft RTC API v1.3をインストールするには、Microsoft RTC Client API SDK 1.3からRTC SDKをダウンロードして、インストーラを実行します。インストーラにより必要なインストール・コンポーネントが用意されます。デフォルトのオプションを選択した場合、次の2つのインストーラがC:\Program Files\RTC Client API v1.3 SDK\INSTALLATIONに保存されています。

- RtcApiSetup.msi

- RtcSxSPolicies.msi

RtcApiSetup.msiインストーラ、並列ポリシー・スイッチャのインストーラ(RtcSxSPolicies.msi)の順に実行したら、システムを再起動します。

2. Microsoft Live Communications Server 2005用のOracle RTC Webサービスをインストールするには、Oracle Fusion MiddlewareのコンパニオンCDからowc_lcs.zipファイルを抽出します。このファイルはディレクトリ/Disk1/WebCenter/services/imp/NTに保存されています。このzipファイルの内容は次のとおりです。
/Bin

/images

ApplicationConfigurationService.asmx

BlafPlus.css

ExtAppLogin.aspx

ExtAppLogin.aspx.cs

Global.asax

Log4Net.config

RTCService.asmx

Web.Config

WebcenterTemplate.master

3. インターネット インフォメーション サービス（IIS）マネージャを開きます。

4. 「IIS マネージャー」ウィンドウでサーバー・ノードを開き、「Webサイト」を開きます。

5. 「既定のWebサイト」を右クリックして「新規」→「仮想ディレクトリ」を選択し、Oracle RTC Webサービス用のサイトを作成します(図16-1)。仮想ディレクトリの作成ウィザードが表示されます。

図16-1 仮想ディレクトリの作成

6. 「次へ」をクリックします。

7. 「エイリアス」フィールドに仮想ディレクトリの別名（たとえば、RTC）を入力します。

8. owc_lcs.zipファイルを抽出したディレクトリのパスを入力します。あるいは、「参照」ボタンを使用して、そのディレクトリに移動します。

9. 「次へ」をクリックします。

10. 仮想ディレクトリで、「読み取り」、「実行」、「参照」権限があることを確認します。(図16-2)

図16-2 仮想ディレクトリのプロパティ

11. 「次へ」をクリックします。

12. 「完了」をクリックします。「IIS マネージャー」ウィンドウの「既定のWebサイト」の下に、新しく作成した仮想ディレクトリが表示されます(図16-3)。

図16-3 仮想ディレクトリの追加

13. Oracle RTC Webサービス用に新しく作成した仮想ディレクトリを右クリックし、「プロパティ」を選択して「プロパティ」ダイアログを開きます。

14. 「仮想ディレクトリ」タブの「アプリケーションの設定」で、「作成」をクリックします。ボタンのラベルが「削除」に変わり、新しく作成した仮想ディレクトリが「アプリケーション名」フィールドに表示されています。

15. 「実行アクセス許可」ドロップダウン・リストから「スクリプトおよび実行可能ファイル」を選択します(図16-4)。

図16-4 仮想ディレクトリのプロパティ

16. 「ASP.NET」タブで、「ASP.NET バージョン」ドロップダウン・リストから2.0以上のASP.NETバージョンを選択します。IISはASP.NET 2.0アプリケーションを消費するように構成されます。

17. 「OK」をクリックします。

18. LCS接続内のLSCプール名が設定されていることを確認します。

19. 次のURL書式からWebサイトにアクセスすることにより、Webサービスをテストします。

http://localhost/default_website/ApplicationConfigurationService.asmx

default_websiteは、Oracle RTC Webサービス用に作成した仮想ディレクトリです。

次に例を示します。

http://localhost/RTC/ApplicationConfigurationService.asmx

16.2.1.3 Microsoft LCS: セキュリティに関する考慮事項

ユーザーが資格証明を提供してLCSサーバーに対して自身を認証できるように、Microsoft Live Communications Server接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。LCSでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にLCSが存在する必要があります。

LCSには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、第16.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

16.2.2 Microsoft Office Communications Server (OCS)の前提条件

この項では、Microsoft Office Communications Server 2007 (OCS)をインスタント・メッセージおよびプレゼンス・サービスのプレゼンス・サーバーとして使用するための前提条件を示します。

この項の内容は次のとおりです。

- 第16.2.2.1項「Microsoft OCS: インストール」

- 第16.2.2.2項「Microsoft OCS: 構成」

- 第16.2.2.3項「Microsoft OCS: セキュリティに関する考慮事項」

16.2.2.1 Microsoft OCS: インストール

インストールの詳細は、Microsoft Office Communications Server 2007のドキュメントを参照してください。

16.2.2.2 Microsoft OCS: 構成

Microsoft OCS 2007をIMPサービスのプレゼンス・サーバーとして使用するには、Microsoft OCS 2007用のWebCenter PortalのProxyアプリケーションを、次のいずれかのトポロジでデプロイする必要があります。

- シンプル・デプロイ: すべてのコンポーネントが同じボックスに存在します。

- リモート・デプロイ: プロキシ・アプリケーションとMicrosoft OCSが別々のボックスに存在します。

16.2.2.2.1 シンプル・デプロイ

このトポロジでは、OCSボックス上にホストされているInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。

1. Microsoft Unified Communications Managed API (UCMA) 2.0をOCSボックスにインストールします。
詳細は、第16.2.2.2.6項「UCMA v2.0のインストール」を参照してください。

2. WebCenter PortalのProxyアプリケーションのIISサーバー上でのデプロイこのプロキシ・アプリケーションは、OCSサーバーとのやり取りおよび情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。
詳細は、第16.2.2.2.7項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

16.2.2.2.2 リモート・デプロイ

このトポロジでは、OCSボックスに対してリモートであるInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。つまり、IISサーバーとOCSサーバーが別々のマシン上にホストされます。

このプロキシ・アプリケーションはリモート・ボックス上にホストされるため、アプリケーションとOCSの間に信頼関係を設定する必要があります。これは、アプリケーションのプロビジョニングと呼ばれます。プロビジョニングは、Microsoft UCMA v2.0に付属のApplication Provisionerユーティリティを使用して行います。詳細は、http://msdn.microsoft.com/en-us/library/dd253360%28office.13%29.aspxを参照してください。

図16-5に、様々なデプロイ・エンティティで実行される手順(UCMA v2.0のインストールを含む)の概要を示します。

図16-5 Microsoft OCSの構成: リモート・デプロイ

「図16-5 Microsoft OCSの構成: リモート・デプロイ」の説明

これらの手順の詳細は、次の項で説明します。

16.2.2.2.3 Application Provisionerの構築

この項では、OCSにアクセスする他のIISサーバーをプロビジョニングするための、Microsoft社による手順を示します。

1. Visual Studio 2008を任意の開発者ボックスにインストールします(必ずしもIIS/OCSである必要はありません)。

2. 第16.2.2.2.6項「UCMA v2.0のインストール」の手順に従って、UCMAバージョン2.0を同じボックスにインストールします。Application Provisionerアプリケーションは、UCMA SDKに付属しています。

3. UCMA Coreをインストールした場所(たとえば、C:\Program Files\Microsoft Office Communications Server 2007 R2\UCMA SDK 2.0\UCMACore\Sample Applications\Collaboration\ApplicationProvisionerなど)の下にあるディレクトリSample Applications\Collaboration\ApplicationProvisionerへ移動します。

4. このディレクトリにはApplication Provisionerアプリケーションが格納されています。Visual Studio 2008を使用してアプリケーションを構築します。これにより、ApplicationProvisioner.exeファイルが生成されます。

5. この実行可能ファイルをOCSボックスにコピーします。

16.2.2.2.4 OCSサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

1. UCMA v2.0のコア・ライブラリをOCSボックスにインストールします。第16.2.2.2.6項「UCMA v2.0のインストール」の手順に従ってください。ただし、Visual C++ 2008の再頒布可能ファイルのインストール後にOCSCore.msiを実行しないでください。これにより、アプリケーションのプロビジョニングに必要なWMIクラスがインストールされます。

2. 前の項で生成されたApplicationProvisioner.exeファイルを実行します。「Application Provisioner」ダイアログが開きます。

3. 「Application Provisioner」ダイアログで、「アプリケーション名」にアプリケーション名としてWebCenterProxyApplicationと入力し、「検索または作成」をクリックします。

4. 「アプリケーション プールを作成します。」ダイアログの「OCS Pool Fqdn」の一覧で、使用するアプリケーションのOffice Communications Serverプールを選択します。「リッスンするポート」にアプリケーションのリスニング・ポートを入力します(例: 6001)。「アプリケーション サーバー Fqdn」に、アプリケーションをデプロイするコンピュータの完全修飾ドメイン名(FQDN)を入力します。(これはIISボックスです。)
アプリケーションを複数のコンピュータにデプロイする場合、「負荷分散アプリケーション」チェック･ボックスを選択し、「ロード バランサー Fqdn」にロード・バランサのFQDNを入力します。

5. アプリケーション・プールは、「Application Provisioner」ダイアログに表示されます。サーバーのエントリをダブルクリックします。「サーバーの表示」ダイアログが表示されます。そこに表示される情報は、サーバーのFQDN、ポート、GRUUです。

6. OCSサーバーでOffice Communications Server Certificateウィザードを使用して、前の手順で書き留めておいたサーバーFQDNをサブジェクト名として証明書を作成します。この証明書は、IISサーバーからの要求の認可に使用されます。

7. 証明書が作成されたら、証明書を表示します。「詳細」タブで、「ファイルにコピー」をクリックします。これにより、証明書のエクスポート ウィザードが起動します。秘密鍵を使用して、証明書をファイルにエクスポートします。これにより、証明書の名前に.pfx (Personal Information Exchange)が付いたファイルが作成されます。

16.2.2.2.5 IISサーバーの構成

リモート・デプロイのシナリオでは、IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、前の項の情報を使用して、IISを信頼された認証局にしてください。

1. 秘密鍵を使用してOCSサーバーによって発行された証明書をインストールします。OCSサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニングの手順7で生成した.pfxファイルをIISボックスにコピーし、それをダブルクリックします。これにより、証明書のインポート ウィザードが起動します。LOCAL_MACHINEの下の個人用フォルダに証明書をインポートします。

2. 証明書を読み取るための権限をIIS_WPGユーザーに付与します。これは、証明書に対する適切な読取りアクセス権をIISサーバーに与えるために必要な作業です。この作業は、Microsoft社が提供するWindows HTTP Services Certificate Configuration Tool (http://www.microsoft.com/downloads/details.aspx?familyid=c42e27ac-3409-40e9-8667-c748e422833f&displaylang=en)というユーティリティを使用して行えます。このユーティリティをダウンロードしてインストールしてください。インストールすると、winhttpcertcfg.exeという実行可能ファイルが作成されます。インストールした場所に移動し、次のコマンドを実行して権限を付与します。

winhttpcertcfg.exe -g -c LOCAL_MACHINE\MY -s "<certificate-name>" -a "IIS_WPG"

3. C:/WINDOWS/system32/drivers/etc/hostsにOCSサーバーのプール名のエントリを次の形式で作成します。

<ip-address-of-ocs-box> <poolname-of-ocs-box>

次に例を示します。

10.177.252.146 pool01.example.com

4. IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、IISサーバーにMicrosoft UCMA v2.0をインストールします。
詳細は、第16.2.2.2.6項「UCMA v2.0のインストール」を参照してください。

5. UCMAをインストールしたら、プロキシ・アプリケーションをIISサーバー上にデプロイします。WebCenter PortalのProxyアプリケーションは、OCSサーバーとのやり取りおよび情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。
詳細は、第16.2.2.2.7項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

6. WebCenter PortalのProxyアプリケーションが抽出された場所に移動します。Web.configを開き、appSettings XMLノードを編集して、前の項の手順7で説明した値を追加します。RemoteDeploymentの値がtrueに設定されていることを確認してください。
たとえば、appsettings XMLノードは次のように表示されます。

<appSettings>
<add key="ApplicationName" value="WebCenterProxyApplication"/>
<add key="RemoteDeployment" value="true"/>
<add key="ApplicationFQDN" value="iis.server.com"/>
<add key="ApplicationGRUU" value="sip:iis.server.com@EXAMPLE.COM;gruu;opaque=srvr:WebCenterProxyApplication:7mhSo94PlUK-5Q2bKPLyMAAA"/>
<add key="ApplicationPort" value="6001"/>
</appSettings>

信頼関係が確立され、WebCenter PortalのProxyアプリケーションがOCSと対話できるようになりました。

16.2.2.2.6 UCMA v2.0のインストール

Microsoft Unified Communications Managed API v2.0 (UCMA)は、OCS環境と対話可能なサーバー・アプリケーションを上級開発者が構築できるエンドポイントAPIです。

シンプル・デプロイでは、UCMAがOCSと同じボックスにインストールされます。リモート・デプロイでは、OCSコア・ライブラリはOCSボックスにインストールされ、UCMAはIIS(プロキシ)ボックスにインストールされます。

1. UCMA v2.0を次の場所からダウンロードします。

- OCS2007 R1インストール用(32ビット): http://www.microsoft.com/downloads/details.aspx?FamilyID=768efa33-6606-4b2b-809a-6c69274621d3&displaylang=en
UcmaSDKWebDownload.msiファイルをダウンロードして実行します。セットアップ・ファイルがフォルダC:\Microsoft Unified Communications Managed API 2.0 SDK Installer package\i386に抽出されます。

- OCS2007 R2インストール用(64ビット): http://www.microsoft.com/downloads/details.aspx?FamilyID=b20967b1-6cf5-4a4b-b7ae-622653ac929f&displaylang=en
UcmaSDKWebDownload.msiファイルをダウンロードして実行します。セットアップ・ファイルがフォルダC:\Microsoft Unified Communications Managed API 2.0 SDK Installer package\amd64に抽出されます。

2. (前の手順でファイルが抽出された)ディレクトリに移動しvcredist_x86.exeを実行します。UCMA APIに必要な、Visual C++ライブラリのランタイム・コンポーネントがインストールされます。ディレクトリSetupに移動し、UcmaRedist.msiを実行します。UCMA 2.0アセンブリがGACにインストールされます。

16.2.2.2.7 WebCenter PortalのProxyアプリケーションのインストール

1. コンパニオンCDからowc_ocs2007.zipを抽出します。ディレクトリOCSWebServicesに移動します。

2. インターネット インフォメーション サービス（IIS）マネージャを開きます。

3. インターネット インフォメーション サービス (IIS) マネージャでサーバー・ノードを開き、「Webサイト」を開きます。

4. 「既定のWebサイト」を右クリックして「新規」→「仮想ディレクトリ」を選択し、Oracle RTC Webサービス用のサイトを作成します。仮想ディレクトリの作成ウィザードが表示されます。「次へ」をクリックします。

5. 「エイリアス」フィールドに仮想ディレクトリの別名（たとえば、RTC）を入力します。

6. owc_ocs2007.zipファイルから抽出されたディレクトリのパスを入力します。このzipファイルを「C:\」に抽出した場合、パスには「C:\OCSWebServices」を指定します。または、「参照」ボタンをクリックして、当該ディレクトリに移動します。「次へ」をクリックします。

7. 仮想ディレクトリで、「読み取り」、「実行」、「参照」権限があることを確認します。「次へ」をクリックします。

8. 「完了」をクリックします。「IIS マネージャー」ウィンドウの「既定のWebサイト」の下に、新しく作成した仮想ディレクトリが表示されます。

9. Oracle RTC Webサービス用に新しく作成した仮想ディレクトリを右クリックし、「プロパティ」を選択して「プロパティ」ダイアログを開きます。

10. 「仮想ディレクトリ」タブの「アプリケーションの設定」で、「作成」をクリックします。ボタンのラベルが「削除」に変わり、新しく作成した仮想ディレクトリの名前が「アプリケーション名」フィールドに表示されています。

11. 「実行アクセス許可」ドロップダウン・リストから「スクリプトおよび実行可能ファイル」を選択します。

12. 「ASP.NET」タブで、「ASP.NET バージョン」ドロップダウン・リストから2.0以上のASP.NETバージョンを選択します。IISはASP.NET 2.0アプリケーションを消費するように構成されます。「OK」をクリックします。

13. 次のURL書式からWebサイトにアクセスすることにより、Webサービスをテストします。http://localhost/default_website/OCSWebService.asmx
default_websiteは、Oracle RTC Webサービス用に作成した仮想ディレクトリです。

次に例を示します。

http://localhost/RTC/OCSWebService.asmx

16.2.2.3 Microsoft OCS: セキュリティに関する考慮事項

ユーザーが資格証明を提供してOCSサーバーに対して自身を認証できるように、Microsoft Office Communications Server接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。OCSでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にOCSが存在する必要があります。

OCSには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、第16.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

16.2.3 Microsoft Lyncの前提条件

この項では、Microsoft Lync 2010をインスタント・メッセージおよびプレゼンス・サービスのプレゼンス・サーバーとして使用するための前提条件を示します。

この項の内容は次のとおりです。

- 第16.2.3.1項「Microsoft Lync: インストール」

- 第16.2.3.2項「Microsoft Lync: 構成」

- 第16.2.3.3項「Microsoft Lync: セキュリティに関する考慮事項」

16.2.3.1 Microsoft Lync: インストール

インストールの詳細は、Microsoft Lync 2010のドキュメントを参照してください。

16.2.3.2 Microsoft Lync: 構成

Microsoft Lyncの構成はMicrosoft OCSの構成に似ています。

Microsoft Lync 2010をIMPサービスのプレゼンス・サーバーとして使用するには、Microsoft Lync 2010用のWebCenter PortalのProxyアプリケーションを、次のいずれかのトポロジでデプロイする必要があります。

- シンプル・デプロイ: すべてのコンポーネントが同じボックスに存在します。

- リモート・デプロイ: プロキシ・アプリケーションとMicrosoft Lyncが別々のボックスに存在します。

16.2.3.2.1 シンプル・デプロイ

このトポロジでは、Lyncボックス上にホストされているInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。

1. Microsoft Unified Communications Managed API (UCMA) 2.0をLyncボックスにインストールします。
詳細は、第16.2.3.2.8項「UCMA v2.0のインストール」を参照してください。

2. WebCenter PortalのProxyアプリケーションのIISサーバー上でのデプロイこのプロキシ・アプリケーションは、Lyncサーバーとのやり取りおよび情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。
詳細は、第16.2.3.2.9項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

16.2.3.2.2 リモート・デプロイ

このトポロジでは、Lyncボックスに対してリモートであるInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。つまり、IISサーバーとLyncサーバーが別々のマシン上にホストされます。

このプロキシ・アプリケーションはリモート・ボックス上にホストされるため、アプリケーションとLyncの間に信頼関係を設定する必要があります。これは、アプリケーションのプロビジョニングと呼ばれます。プロビジョニングは、Microsoft UCMA v2.0に付属のApplication Provisionerユーティリティを使用して行います。

関連項目:

http://msdn.microsoft.com/en-us/library/dd253360%28office.13%29.aspx

図16-6に、様々なデプロイ・エンティティで実行される手順(UCMA v2.0のインストールを含む)の概要を示します。

図16-6 Microsoft Lyncの構成: リモート・デプロイ

「図16-6 Microsoft Lyncの構成: リモート・デプロイ」の説明

これらの手順の詳細は、次の項で説明します。

16.2.3.2.3 Application Provisionerの構築

この項では、Lyncにアクセスする他のIISサーバーをプロビジョニングするための、Microsoft社による手順を示します。

1. Visual Studio 2008を任意の開発者ボックスにインストールします(必ずしもIIS/Lyncである必要はありません)。

2. 第16.2.3.2.8項「UCMA v2.0のインストール」の手順に従って、UCMAバージョン2.0を同じボックスにインストールします。Application Provisionerアプリケーションは、UCMA SDKに付属しています。

3. UCMA Coreをインストールした場所(たとえば、C:\Program Files\Microsoft Lync 2010 R2\UCMA SDK 2.0\UCMACore\Sample Applications\Collaboration\ApplicationProvisionerなど)の下にあるディレクトリSample Applications\Collaboration\ApplicationProvisionerへ移動します。

4. Visual Studio 2008でアプリケーションを開き、http://msdn.microsoft.com/en-us/library/gg448038.aspxに従ってApplication.csファイルを編集します。

5. Visual Studio 2008を使用してアプリケーションを構築します。これにより、ApplicationProvisioner.exeファイルが生成されます。

6. この実行可能ファイルをLyncボックスにコピーします。

16.2.3.2.4 LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

1. Lyncセットアップ・パッケージに付属のOCSWMIBC.msiファイルを実行します。

2. UCMA 2.0アプリケーションをLync Server 2010に対して直接デプロイする場合は、Merge-CsLegacyTopologyコマンドレットを実行する前に、Lync Server 2010環境で使用するSIPドメインをOffice Communications Server 2007 R2 SIPドメイン・リストに追加しておく必要があります。アプリケーションは、あたかもOCS 2007 R2に対してデプロイされているかのようにデプロイされた後、移行されてLync Server 2010に対して実行されます。ドメインを追加するには、第16.2.3.2.5項「WBemTestを使用したAllowedDomainsの追加」を参照してください。

3. 前の項で生成されたApplicationProvisioner.exeファイルを実行します。「Application Provisioner」ダイアログが開きます。

4. 「Application Provisioner」ダイアログで、「アプリケーション名」にアプリケーション名としてWebCenterProxyApplicationと入力し、「検索または作成」をクリックします。

5. 「アプリケーション プールを作成します。」ダイアログの「Lync Pool Fqdn」の一覧で、使用するアプリケーションのプールを選択します。「リッスンするポート」にアプリケーションのリスニング・ポートを入力します(例: 6001)。「アプリケーション サーバー Fqdn」に、アプリケーションをデプロイするコンピュータの完全修飾ドメイン名(FQDN)を入力します。(これはIISボックスです。)
アプリケーションを複数のコンピュータにデプロイする場合、「負荷分散アプリケーション」チェック･ボックスを選択し、「ロード バランサー Fqdn」にロード・バランサのFQDNを入力します。

6. アプリケーション・プールは、「Application Provisioner」ダイアログに表示されます。サーバーのエントリをダブルクリックします。「サーバーの表示」ダイアログが表示されます。そこに表示される情報は、サーバーのFQDN、ポート、GRUUです。

7. 新しく作成した信頼済エントリをLync Server 2010に移行する必要があります。第16.2.3.2.6項「Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス エントリの移行」を参照してください。

8. LyncサーバーでLync Certificateウィザードを使用して、前の手順で書き留めておいたサーバーFQDNをサブジェクト名として証明書を作成します。この証明書は、IISサーバーからの要求の認可に使用されます。

9. 証明書が作成されたら、証明書を表示します。「詳細」タブで、「ファイルにコピー」をクリックします。これにより、証明書のエクスポート ウィザードが起動します。秘密鍵を使用して、証明書をファイルにエクスポートします。これにより、証明書の名前に.pfx (Personal Information Exchange)が付いたファイルが作成されます。

16.2.3.2.5 WBemTestを使用したAllowedDomainsの追加

1. WBemTest.exeを起動し、コマンド・プロンプトでWBemTestと入力して[Enter]キーを押します。

2. 「Windows Management Instrumentation テスト」ダイアログ・ボックスで、「接続」をクリックします。

3. 「接続」ダイアログ・ボックスで「接続」をクリックします。

4. 「Windows Management Instrumentation テスト」ダイアログ・ボックスで、「クラスの列挙」をクリックします。

5. 「スーパークラス情報」ダイアログ・ボックスで「OK」をクリックします。

6. 「クエリ結果」ダイアログ・ボックスで「MSFT_SIPDomainData()」までスクロール・ダウンして、このエントリをダブルクリックします。

7. 「MSFT_SIPDomainData のオブジェクト エディタ」ダイアログ・ボックスで「インスタンス」をクリックします。「クエリ結果」ダイアログ・ボックスが開き、MSFT_SIPDomainData WMIクラスの各インスタンスのInstanceIDが表示されます。これらのエントリはAllowedDomainエントリです。

8. AllowedDomainエントリを追加するために、「追加」をクリックします。

9. 「MSFT_SIPDomainData のインスタンス」ダイアログ・ボックスの「プロパティ」リストボックスで、「アドレス」をダブルクリックします。

10. 「プロパティ エディタ」ダイアログ・ボックスで、「NULLでない」ラジオ・ボタンを選択します。

11. 「値」テキスト入力ペインにLyncサーバーのドメイン(例: contoso.com)を入力します。「プロパティの保存」をクリックします。

12. 「MSFT_SIPDomainData のインスタンス」ダイアログ・ボックスの「プロパティ」リストボックスで、「権限あり」をダブルクリックします。「権限あり」プロパティをNullではなく、Falseに設定してください。「プロパティの保存」をクリックします。

13. 「MSFT_SIPDomainData のインスタンス」ダイアログ・ボックスの「プロパティ」リストボックスで、「既定のドメイン」をダブルクリックします。「既定のドメイン」プロパティをNullではなく、Trueに設定してください。「プロパティの保存」をクリックします。

14. 「MSFT_SIPDomainData のインスタンス」ダイアログ・ボックスで、「オブジェクトの保存」をクリックします。

16.2.3.2.6 Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス エントリの移行

Microsoft Lync Server 2010 Topology Builderを使用して信頼済サービス エントリを移行する手順は次のとおりです。

1. Microsoft Lync Server 2010のトポロジ ビルダーを起動します。

2. 既存のトポロジが読み込まれたら、「アクション」で「2007 トポロジのマージ」または「2007 R2 トポロジのマージ」を選択します。ウィザードが起動します。

3. ウィザードで、デフォルトのオプションをそのまま使用して最後まで進みます。ウィザードが終了したら、正常に実行が完了したことを確認します。ユーザー・インタフェースにエラーが表示されていないことを確認してください。

4. 「トポロジの公開」を選択し、前の手順と同じようにウィザードを完了します。

Microsoft Lync Server 2010 PowerShellコマンドレットを使用して信頼済サービス エントリを移行する手順は次のとおりです。

1. 「スタート」メニューから「Microsoft Lync Server 2010」プログラム・グループにある「Lync Server管理シェル」を実行します。

2. 次のPowerShellコマンドレットを実行します。

Merge-CsLegacyTopology -TopologyXmlFileName D:\output.xml

3. 次のPowerShellコマンドレットを実行します。

Publish-CsTopology -FileName D:\output.xml

16.2.3.2.7 IISサーバーの構成

リモート・デプロイのシナリオでは、IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、前の項の情報を使用して、IISを信頼された認証局にしてください。

1. 秘密鍵を使用してLyncサーバーによって発行された証明書をインストールします。LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニングの手順7で生成した.pfxファイルをIISボックスにコピーし、それをダブルクリックします。これにより、証明書のインポート ウィザードが起動します。LOCAL_MACHINEの下の個人用フォルダに証明書をインポートします。

2. C:/WINDOWS/system32/drivers/etc/hostsにLyncサーバーのプール名のエントリを次の形式で作成します。

<ip-address-of-lync-box> <poolname-of-lync-box>

次に例を示します。

10.177.252.146 pool01.example.com

3. IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、IISサーバーにMicrosoft UCMA v2.0をインストールします。
詳細は、第16.2.3.2.8項「UCMA v2.0のインストール」を参照してください。

4. UCMAをインストールしたら、このプロキシ・アプリケーションをIISサーバー上にデプロイします。WebCenter PortalのProxyアプリケーションは、Lyncとのやり取りおよび情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。
詳細は、第16.2.3.2.9項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

5. WebCenter PortalのProxyアプリケーションが抽出された場所に移動します。Web.configを開き、appSettings XMLノードを編集して、前の項の手順7で説明した値を追加します。RemoteDeploymentの値がtrueに設定されていることを確認してください。
たとえば、appsettings XMLノードは次のように表示されます。

<appSettings>
<add key="ApplicationName" value="WebCenterProxyApplication"/>
<add key="RemoteDeployment" value="true"/>
<add key="ApplicationFQDN" value="iis.server.com"/>
<add key="ApplicationGRUU" value="sip:iis.server.com@EXAMPLE.COM;gruu;opaque=srvr:WebCenterProxyApplication:7mhSo94PlUK-5Q2bKPLyMAAA"/>
<add key="ApplicationPort" value="6001"/>
</appSettings>

注意:

ログ・ファイルに次のような例外が記録されている場合は、

ErrorCode = -2146893039
FailureReason = NoAuthenticatingAuthority
e.Message = "Unable to perform authentication of credentials."
base {Microsoft.Rtc.Signaling.FailureResponseException} = {"Unable to perform authentication of credentials."}
InnerException = {"NegotiateSecurityAssociation failed, error: \-2146893039"}

Web.configに次のエントリを追加してください。

<identity impersonate="true" userName="Administrator" password="Welcome0*"/>

usernameは管理者のユーザー名、passwordは管理者のパスワードです。

信頼関係が確立され、WebCenter PortalのProxyアプリケーションがLyncと対話できるようになりました。

16.2.3.2.8 UCMA v2.0のインストール

Microsoft Unified Communications Managed API v2.0 (UCMA)は、Lync環境と対話可能なサーバー・アプリケーションを上級開発者が構築できるエンドポイントAPIです。

シンプル・デプロイでは、UCMAがLyncと同じボックスにインストールされます。リモート・デプロイでは、Lyncコア・ライブラリはLyncボックスにインストールされ、UCMAはIIS(プロキシ)ボックスにインストールされます。

1. OCS 2010 R2インストール用のUCMA v2.0を次の場所からダウンロードします。http://www.microsoft.com/downloads/details.aspx?FamilyID=b20967b1-6cf5-4a4b-b7ae-622653ac929f&displaylang=en
UcmaSDKWebDownload.msiファイルをダウンロードして実行します。セットアップ・ファイルがフォルダC:\Microsoft Unified Communications Managed API 2.0 SDK Installer package\amd64に抽出されます。

2. (前の手順でファイルが抽出された)ディレクトリに移動しvcredist_x86.exeを実行します。UCMA APIに必要な、Visual C++ライブラリのランタイム・コンポーネントがインストールされます。ディレクトリSetupに移動し、UcmaRedist.msiを実行します。UCMA 2.0アセンブリがGACにインストールされます。

16.2.3.2.9 WebCenter PortalのProxyアプリケーションのインストール

1. コンパニオンCDからowc_ocs2007.zipを抽出します。ディレクトリOCSWebServicesに移動します。

2. インターネット インフォメーション サービス（IIS）マネージャを開きます。

3. IISマネージャでサーバー・ノードを開き、「サイト」を開きます。

4. 「既定のWebサイト」を右クリックして、「アプリケーションの追加」を選択します。アプリケーションの追加ウィザードが表示されます。

5. 「エイリアス」フィールドに仮想ディレクトリの別名（たとえば、RTC）を入力します。

6. owc_ocs2007.zipファイルから抽出されたディレクトリのパスを入力します。たとえば、このzipファイルを「C:\」に抽出した場合は、C:\OCSWebServicesを入力します。あるいは、「参照」ボタンを使用して、そのディレクトリにナビゲートします。「OK」をクリックします。

7. 新しく作成したアプリケーションを右クリックし、「アクセス許可の編集」を選択して「プロパティ」ダイアログを表示します。

8. 「セキュリティ」タブで、アクセス許可を編集してユーザー「すべてのユーザー」に読取りアクセス許可を付与します。

9. 次のURL書式からWebサイトにアクセスすることにより、Webサービスをテストします。http://localhost/default_website/OCSWebService.asmx
default_websiteは、Oracle RTC Webサービス用に作成した仮想ディレクトリです。

次に例を示します。

http://localhost/RTC/OCSWebService.asmx

16.2.3.3 Microsoft Lync: セキュリティに関する考慮事項

ユーザーが資格証明を提供してLyncサーバーに対して自身を認証できるように、Microsoft Lync接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。Lyncでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にLyncが存在する必要があります。

Lyncには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、第16.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

16.3 インスタント・メッセージおよびプレゼンス・サーバーの登録

WebCenter Portalアプリケーションには複数のプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。

新しい(アクティブな)プレゼンス・サーバーの使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第16.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」

- 第16.3.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」

16.3.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

プレゼンス・サーバー接続を登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 新しいプレゼンス・サーバーに接続するには、「追加」をクリックします(図16-7)。

図16-7 インスタント・メッセージおよびプレゼンス・サービスの構成

5. この接続の一意の名前を入力し、プレゼンス・サーバー・タイプを指定して、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表16-1)。

表16-1 インスタント・メッセージおよびプレゼンス接続: 名前

フィールド

説明

名前

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

接続タイプ

プレゼンス・サーバーのタイプを指定します。

- Microsoft Live Communications Server (LCS)

- Microsoft Office Communications Server 2007 (OCS)

初期設定のWebCenter Portalは、Microsoft LCS、OCSおよびLyncをサポートしています。

注意: Microsoft Lync接続は、Microsoft Office Communications Server 2010接続タイプを使用します。(Oracle Beehive Server接続は、このリリースではサポートされていません。)

アクティブな接続

これを選択した場合、WebCenter Portalアプリケーションでインスタント・メッセージおよびプレゼンス・サービスにこの接続が使用されます。

1つのアプリケーションに対して複数のプレゼンス・サーバー接続を登録できますが、IMPサービスで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. インスタント・メッセージおよびプレゼンス・サービスをホストするサーバーの接続の詳細を入力します(表16-2)。

表16-2 インスタント・メッセージおよびプレゼンス接続: 接続の詳細

フィールド

説明

サーバーURL

インスタント・メッセージおよびプレゼンス・サービスをホストするサーバーのURLを入力します。

例: http://myocshost.com:8888

ユーザー・ドメイン

(OCS/Lyncのみ)この接続に関連付けられている(Microsoft Office Communications Server上の)Active Directoryドメインの名前を入力します。OCS/Lync接続の場合はユーザー・ドメインが必須です。

ユーザー・ドメインの詳細は、Microsoft社のドキュメントを参照してください。

プール名

この接続に関連付けられているプールの名前を入力します。このプール名は必須です。

プール名の詳細は、Microsoft社のドキュメントを参照してください。

関連付けられている外部アプリケーション

インスタント・メッセージおよびプレゼンス・サーバーを外部アプリケーションと関連付けます。外部アプリケーションの資格証明情報が、ユーザーをインスタント・メッセージおよびプレゼンス・サーバーに対して認証するために使用されます。

外部アプリケーションは必須です。

リストから既存の外部アプリケーションを選択することも、「新規作成」をクリックして新規の外部アプリケーションを構成することもできます。

インスタント・メッセージおよびプレゼンス・サービス用に構成する外部アプリケーションでは、「POST」認証方式を使用する必要があります。また、「ユーザーに表示」するように構成(選択)された「アカウント」という追加のフィールド(「名前」プロパティ)も指定する必要があります。詳細は、第26章「外部アプリケーションの管理」を参照してください。

接続タイムアウト

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalアプリケーションが接続タイムアウト・メッセージを発行するまでにプレゼンス・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは-1で、サービスのデフォルトが使用されます。サービスのデフォルトは10秒です。

7. プレゼンス・サーバーに接続するためには追加のパラメータが必要になる場合があります。
プレゼンス・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表16-3)。

表16-3 インスタント・メッセージおよびプレゼンス接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- 名前: 接続プロパティの名前を入力します。

- 値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: OKをクリックするまで、削除された行は無効として表示されます。

8. 「OK」をクリックして、この接続を保存します。

9. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

16.3.2 WLSTを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

WLSTコマンドのcreateIMPConnectionを使用して、プレゼンス・サーバーの接続を作成します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateIMPConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

新規のIMP接続をアクティブに使用するようにインスタント・メッセージおよびプレゼンス・サービスを構成するには、default=trueを設定します。詳細は、第16.4.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

16.4 インスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

WebCenter Portalアプリケーションには複数のインスタント・メッセージおよびプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。アクティブな接続がアプリケーションのバックエンド・プレゼンス・サーバーになります。

この項の内容は次のとおりです。

- 第16.4.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」

- 第16.4.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」

16.4.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

アクティブな接続を変更する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「インスタント・メッセージおよびプレゼンス」を選択します。
「インスタント・メッセージおよびプレゼンス接続の管理」表に、現在のアクティブな接続（ある場合）が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

16.4.2 WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

WLSTコマンドのsetIMPConnectionをdefault=trueで使用して、既存のプレゼンス・サーバー接続をアクティブ化します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetIMPConnectionに関する項を参照してください。

プレゼンス・サーバー接続を無効化するには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveIMPServicePropertyコマンドを使用します。

removeIMPServiceProperty('appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のremoveIMPServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

このアクティブな接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

16.5 インスタント・メッセージおよびプレゼンス接続の詳細の変更

インスタント・メッセージおよびプレゼンス・サーバー接続の詳細はいつでも変更できます。

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第16.5.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更」

- 第16.5.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更」

16.5.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

インスタント・メッセージおよびプレゼンス・サーバーの接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表16-2「インスタント・メッセージおよびプレゼンス接続: 接続の詳細」を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

16.5.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

WLSTコマンドのsetIMPConnectionを使用して、プレゼンス・サーバー接続の詳細を編集します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetIMPConnectionに関する項を参照してください。

プレゼンス・サーバーへの接続に追加のパラメータが必要な場合は、setIMPConnectionPropertyコマンドを使用します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetIMPConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

16.6 インスタント・メッセージおよびプレゼンス接続の削除

インスタント・メッセージおよびプレゼンス接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。ユーザー・プレゼンス・オプションはバックエンド・インスタント・メッセージおよびプレゼンス・サーバーを必要とするため、アクティブな接続を削除すると、ユーザー・プレゼンス・オプションは使用できなくなります。

接続を削除するとき、インスタント・メッセージおよびプレゼンス・サービスに関連付けられている外部アプリケーションの目的がこのサービスをサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。詳細は、第26.5項「外部アプリケーション接続の削除」を参照してください。

この項の内容は次のとおりです。

- 第16.6.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の削除」

- 第16.6.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス接続の削除」

16.6.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の削除

インスタント・メッセージおよびプレゼンス・サーバー接続を削除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:

管理対象サーバーを再起動する前に、他の接続をアクティブとしてマークしてください。そうしないとサービスが無効になります。

16.6.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の削除

WLSTコマンドのdeleteConnectionを使用して、プレゼンス・サーバーの接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

16.7 インスタント・メッセージおよびプレゼンス・サービスのデフォルトの設定

WLSTコマンドのsetIMPServicePropertyを使用して、IMPサービスのデフォルトを設定します。

- selected.connection: インスタント・メッセージおよびプレゼンス・サービスで使用する接続。

- rtc.cache.time: インスタント・メッセージおよびプレゼンス・データのキャッシュ・タイムアウト。

- resolve.display.name.from.user.profile: ユーザー表示名がない場合に表示する内容を設定します。0に設定すると、表示名の情報がない場合には、ユーザー名のみがアプリケーションに表示されます。1に設定すると、表示名の情報がない場合には、ユーザー・プロファイル・データから表示名が読み込まれます。このオプションを1に設定すると、パフォーマンスに影響します。デフォルト設定は0です。
表示名は、プレゼンス・データでは必須でありません。WebCenter Portalアプリケーションがデフォルトでは表示名を提供しないことがあり、この表示名の情報が重要と思われる場合は、resolve.display.name.from.user.profileを1に設定することで、表示名を常に表示できます。

- im.address.resolver.class: ユーザー名からIMアドレスおよびIMアドレスからユーザー名へのマッピングに使用するリゾルバ実装。デフォルト設定はoracle.webcenter.collab.rtc.IMPAddressResolverImplです。この実装は、次の場所と順序でIMアドレスを検索します。

- ユーザー・プリファレンス

- ユーザー資格証明

- ユーザー・プロファイル

- im.address.profile.attribute: ユーザーのIMアドレスを特定するために使用するユーザー・プロファイル属性。デフォルト設定はBUSINESS_EMAILです。im.address.profile.attributeでこのデフォルトを変更できます。

コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetIMPServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

16.8 インスタント・メッセージおよびプレゼンス接続のテスト

Webサービスでは、呼び出して妥当性をテストできる一連のWebメソッドを公開しています。接続を検証するには、その接続上にデプロイされているWebCenter Portal RTC Webサービスのエンドポイントにアクセスしてみます。次に例を示します(アプリケーション・コンテキスト・パスは/RTCと仮定)。

- protocol://host/RTC/ApplicationConfigurationService.asmx

- protocol://host/RTC/RTCService.asmx

- protocol://host/RTC/OCSWebService.asmx

17 メール・サービスの管理

この章では、Oracle WebCenter Portalアプリケーションで使用されるメール・サービスを構成および管理する方法について説明します。また、アプリケーション・リソースから直接メールを送信できる「メール送信」機能の構成方法についても説明します。メール送信機能はメール・サービスを必要としません。つまり、アプリケーションでメール・サービスが構成されていなくても、ユーザーはローカルのメール・クライアントでメール通知を送信できます。メール通知の送信の使用に関する詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのメール送信機能の概要に関する項を参照してください。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にWebCenter Portalアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったメール・サービスの構成の変更は動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第17.1項「メール・サーバー接続に関する必要な知識」

- 第17.2項「メール・サービスの構成ロードマップ」

- 第17.3項「メール・サーバーの前提条件」

- 第17.4項「メール・サーバーの登録」

- 第17.5項「アクティブな(またはデフォルトの)メール・サーバー接続の選択」

- 第17.6項「メール・サーバー接続の詳細の変更」

- 第17.7項「メール・サーバー接続の削除」

- 第17.8項「メール・サービスのデフォルトの設定」

- 第17.9項「メール・サーバー接続のテスト」

- 第17.10項「メールに関する問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

17.1 メール・サーバー接続に関する必要な知識

WebCenter Portalでは、Microsoft Exchange Serverや、IMAP4およびSMTPをサポートするすべてのメール・サーバーをサポートしています。ユーザーがWebCenter Portalアプリケーション内でメールにアクセスし、読取り、返信、転送といった基本的な操作を実行できるようにするには、まず、適切なメール・サーバーをWebCenter Portalアプリケーションに登録する必要があります。メール・サービスは事前には構成されていません。

複数のメール・サーバー接続に登録できます。

- WebCenter Portal: Spacesアプリケーションは複数のメール接続をサポートしています。アクティブとしてマークされたメール接続が、Spacesでのメール・サービスのデフォルトの接続です。すべての追加の接続は代替として提供されます。Spacesユーザーは、使用する接続をユーザー・プリファレンスで選択できます。

- WebCenter Portal: Frameworkアプリケーションは、アクティブとしてマークされたメール接続1つのみを使用します。追加の接続は無視されます。

17.2 メール・サービスの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- ロードマップ: Frameworkアプリケーションのメール・サービスの構成
図17-1と表17-1に、Frameworkアプリケーションでメール・サービスを動作させるための前提条件と必要な作業の概要を示します。

図17-1 Frameworkアプリケーションのメール・サービスの構成

「図17-1 Frameworkアプリケーションのメール・サービスの構成」の説明

表17-1 Frameworkアプリケーションのメール・サービスの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portalと、メール・サービスのバックエンド・コンポーネントをインストールします

1.a Microsoft Exchange 2007および2010のみは、次の追加の構成手順に従ってください

開発者

2. メール・サービスをFrameworkアプリケーションに統合します

2.a JDeveloperでメール・サーバーとの接続を構成します(メール・サーバーを外部アプリケーションに関連付けます)

2.b JDeveloperでメール・タスク・フローをページに追加します

開発者または管理者

3. 次のいずれかのツールを使用して、Frameworkアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール (管理者)

開発者または管理者

4. (オプション)次のいずれかのツールを使用して接続パラメータを追加または変更します

- JDeveloper。その後、アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー

5. メール・タスク・フローで「メールにログイン」をクリックし、メール・サーバーのログイン資格証明を入力してメールにアクセスします

- ロードマップ: Spacesアプリケーションのメール・サービスの構成
図17-2と表17-1に、Spacesでメール・サービスを動作させるための前提条件と必要な作業の概要を示します。

図17-2 Spacesアプリケーションのメール・サービスの構成

「図17-2 Spacesアプリケーションのメール・サービスの構成」の説明

表17-2 Spacesアプリケーションのメール・サービスの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portalと、メール・サービスのバックエンド・コンポーネントをインストールします

1.a Microsoft Exchange 2007および2010のみは、次の追加の構成手順に従ってください

2. 次のいずれかのツールを使用してSpacesとメール・サーバー間の接続を構成します(メール・サーバーを外部アプリケーションに関連付けます)

- Fusion Middleware Control

- WLST

エンド・ユーザー

3. Spacesページでメール・タスク・フローを追加します

4. 次のいずれかの方法でメールにアクセスします

- メール・タスク・フローで「メールにログイン」をクリックし、メール・サーバーのログイン資格証明を入力します

- 「プリファレンス」→「メール」ページに移動してメール資格証明を指定します。

17.3 メール・サーバーの前提条件

この項の内容は次のとおりです。

- 第17.3.1項「メール・サーバー: インストール」

- 第17.3.2項「メール・サーバー: 構成」

- 第17.3.3項「メール・サーバー: セキュリティに関する考慮事項」

- 第17.3.4項「メール・サーバー: 制限事項」

17.3.1 メール・サーバー: インストール

インストールの詳細は、ご使用のメール・サーバーのドキュメントを参照してください。

17.3.2 メール・サーバー: 構成

WebCenter Portalでは、スペース配信リストをSpaces (またはWebCenter Portal: Spacesのスペース管理を利用するFrameworkアプリケーション)で作成および管理できます。この機能は、Microsoft Exchangeでのみサポートされます。

スペース配信リストは、スペースが作成されるたびに自動的に作成されます。LDAPベースDN (サポートされるLDAPベースDNは1つのみ)が変化せず、Microsoft Exchange Active Directory上に作成されたユーザーがWebCenter Portalアプリケーションで使用されるアイデンティティ・ストアに作成されたユーザーに対応している場合、スペースに追加されたユーザーは対応するスペース配信リストに自動的に追加され、スペースから削除されたユーザーは対応するスペース配信リストから自動的に削除されます。この機能を無効化するには、LDAP (Active Directory)サーバーの詳細をメール接続に入力しないでください。

詳細は、第17.4.1項「Fusion Middleware Controlを使用したメール・サーバーの登録」の手順7を参照してください。

メール・サーバーでのユーザーの追加の詳細は、メール・サーバーの製品ドキュメントを参照してください。WebCenter Portalアプリケーションのアイデンティティ・ストアへのユーザーの追加の詳細は、第29.4項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

構成の前提条件があるメール・サーバーは、Microsoft Exchange 2007およびMicrosoft Exchange 2010のみです。他のメール・サーバー(Microsoft Exchange 2003を含む)を使用している場合は、この項の以降の部分を飛ばしてかまいません。

17.3.2.1 WebCenter PortalのためのMicrosoft Exchange Server 2007または2010の構成

Microsoft Exchange Server 2007またはExchange Server 2010の証明書をWebCenter Portalキーストアに追加する必要があります。これには、次の手順が必要になります。

1. 第17.3.2.1.1項「Microsoft Exchange Serverからの証明書の取得」

2. 第17.3.2.1.2項「WebCenter Portalキーストアへの証明書の追加」

3. 証明書をインポートしたら、サーバーを再起動します。

17.3.2.1.1 Microsoft Exchange Serverからの証明書の取得

ご使用のメール・サーバーのインストール管理者から証明書を取得します。この項では、Microsoft Exchange Serverから証明書を取得する方法の1つを説明します。

Microsoft Exchange Server 2007または2010から証明書を取得する手順は次のとおりです。

1. ブラウザを開き、次のコマンドを使用してIMAPサーバーに接続します。

https://host_name/owa

host_nameはMicrosoft Exchange Serverのホスト名です。

2. ページにカーソルを置いて、右クリックし、「プロパティ」を選択します。次に、「証明書」をクリックします。

3. ポップアップ・ウィンドウで「詳細」タブをクリックし、「ファイルにコピー...」をクリックします。
必ずDER encoded binary (X.509)形式を使用して、ファイルにコピーしてください。

4. .DER形式の証明書を.PEM形式に変換します。

注意:

WebLogicは.PEM形式のみを認識します。

Firefox 3.0以降を使用すると、証明書を.PEM形式で直接ダウンロードできます。それ以外のブラウザの場合、WebLogic Serverのder2pemツールを使用して.PEM形式に変換してください。der2pemの詳細は、Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンスを参照してください。

17.3.2.1.2 WebCenter Portalキーストアへの証明書の追加

1. ダウンロードした証明書をキーストアにインポートします。通常、キーストアはJAVA_HOMEにあるcacertsという名前のファイルです。次に例を示します。

keytool -import -alias imap_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。標準インストールでは、JAVA_HOMEは次の場所にあります。

/scratch/wcinstall/ps2/1225/wlshome/jrockit_160_17_R28.0.0-616

キーストアへの証明書の追加の詳細は、第31.4.2.1.3項「証明書の構成とエクスポート」を参照してください。

2. サーバーを再起動します。

17.3.2.1.3 Microsoft Exchange Serverに関する考慮事項

- IMAPポートは993で、secured=trueです。SMTPポートは587で、secured=trueです。
(Microsoft Exchange Server 2005では465を使用していました。)

- 次のエラーが表示される場合は、ドメイン起動ファイルsetDomainEnv.sh内のトラスト・ストアのエントリを変更する必要があります。

Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect
at sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:771)
at sun.security.provider.JavaKeyStore$JKS.engineLoad(JavaKeyStore.java:38)
at java.security.KeyStore.load(KeyStore.java:1185)
at com.sun.net.ssl.internal.ssl.TrustManagerFactoryImpl.getCacertsKeyStore (TrustManagerFactoryImpl.java:202)
at com.sun.net.ssl.internal.ssl.DefaultSSLContextImpl.getDefaultTrustManager (DefaultSSLContextImpl.java:70)

このエントリを変更する手順は次のとおりです。

1. WebCenter Portalがデプロイされている管理対象サーバーをシャットダウンします。

2. 次にある、ドメイン起動スクリプトsetDomainEnvを編集します。
UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

3. 次のように、Javaプロパティを追加します。

-Djavax.net.ssl.trustStore=<path to truststore> -Djavax.net.ssl.trustStorePassword=<truststore password>

次に例を示します。

set JAVA_PROPERTIES=
-Dplatform.home=%WL_HOME% -Dwls.home=%WLS_HOME% -Dweblogic.home=%WLS_HOME%
-Djavax.net.ssl.trustStore=C:\jive\mailtool\jssecacerts
-Djavax.net.ssl.trustStorePassword=changeit

4. 管理対象サーバーを再起動します。

17.3.3 メール・サーバー: セキュリティに関する考慮事項

詳細は、第33.8項「SSLを使用したSpacesからIMAPおよびSMTPへの接続の保護」を参照してください。

注意:

LDAPがセキュア・モードで実行するように構成されている場合は、LDAP保護プロパティを追加(true/falseに設定)して、配信リストの作成時にLDAPを使用するようにしてください。詳細は、表17-5を参照してください。

17.3.4 メール・サーバー: 制限事項

WebCenter Portal: Spacesでは、メール・サービスでスペース配信リストの自動管理を実現するために、Microsoft Exchangeメール・サーバー接続が必要です。

17.4 メール・サーバーの登録

複数のメール・サーバー接続を登録できます。新しいメール接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第17.4.1項「Fusion Middleware Controlを使用したメール・サーバーの登録」

- 第17.4.2項「WLSTを使用したメール・サーバーの登録」

17.4.1 Fusion Middleware Controlを使用したメール・サーバーの登録

メール・サーバーをWebCenter Portalアプリケーションに登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「メール・サーバー」を選択します。

4. 新規のメール・サーバーに接続するには、「追加」をクリックします(図17-3)。

図17-3 メール・サーバーの構成

5. この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表17-3)。

表17-3 メール・サーバー接続: 名前

フィールド

説明

名前

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

アクティブな接続

この接続をメール・サービスのデフォルトの(またはアクティブな)接続にするかどうかを指定します。

複数のメール・サーバー接続に登録できます。

- WebCenter Portal: Spacesアプリケーションは複数のメール接続をサポートしています。アクティブとしてマークされたメール接続が、Spacesでのメール・サービスのデフォルトの接続です。すべての追加の接続は代替として提供されます。Spacesユーザーは、使用する接続をユーザー・プリファレンスで選択できます。

- WebCenter Portal: Frameworkアプリケーションは、アクティブとしてマークされたメール接続1つのみを使用します。追加の接続は無視されます。

6. メール・サーバーの接続の詳細を入力します(表17-4)。

表17-4 メール・サーバーの接続パラメータ

フィールド

説明

IMAPホスト

IMAP (Internet Message Access Protocol)サービスが実行されているコンピュータのホスト名を入力します。

IMAPポート

IMAPサービスがリスニングするポートを入力します。

IMAP保護

IMAPを介する受信メールに保護された接続（SSL）が必要かどうかを指定します。

SMTPホスト

SMTP (Simple Mail Transfer Protocol)サービスが実行されているコンピュータのホスト名を入力します。

SMTPポート

SMTPサービスがリスニングするポートを入力します。

SMTP保護

SMTPを介する送信メールに保護された接続（SSL）が必要かどうかを指定します。

関連付けられている外部アプリケーション

メール・サーバーを外部アプリケーションに関連付けます。ユーザーをIMAPおよびSMTPサーバーに対して認証するために、外部アプリケーションの資格証明情報が使用されます。メール・サービスでは、IMAPとSMTPの両方に対するユーザーの認証に同じ資格証明を使用します。

リストから既存の外部アプリケーションを選択することも、「新規作成」をクリックして新規の外部アプリケーションを構成することもできます。詳細は、第26章「外部アプリケーションの管理」を参照してください。

メール・サービスの外部アプリケーションでは、認証方式=POSTを使用する必要があります。また、一部のメール・ヘッダー・フィールドをカスタマイズできます(「ユーザーに表示」が有効の場合)。

- プロパティ: mail.user.emailAddress (メールの送信者)
プロパティ: mail.user.displayName (メールの表示名)

プロパティ: mail.user.replyToAddress (メールの返信先アドレス)

これらのプロパティは、特定のメール・アドレスが外部アプリケーションとメール・サーバーで同じであることを保証します。これらのプロパティはメール接続に追加され、メール・サービスで「送信元」、「表示名」および「返信先」の各フィールドに使用されます(図17-4)。

WebCenter Portalアプリケーションで、要求時にユーザーID情報をメール送信する機能を備えた自己登録ページを用意している場合、ここで選択した外部アプリケーションに対してパブリック資格証明が構成されていることを確認してください。パブリック資格証明が定義されていない場合、要求時にユーザーにメールが送信されません。たとえば、Spacesアプリケーションでは、デフォルトの自己登録ページでこの機能を提供しています。

図17-4 メール接続の追加プロパティ

「図17-4 メール接続の追加プロパティ」の説明

7. スペース配信リストを管理するActive DirectoryサーバーのLDAP接続の詳細を指定します(表17-5)。

この項は、Spaces (またはスペース管理機能を利用するFrameworkアプリケーション)に適用されます。WebCenter Portalアプリケーションは、配信リストをActive Directoryサーバーで管理するMicrosoft Exchangeをサポートしています。

注意:

配信リストをSpacesで動作させるには、Active Directoryサーバーの詳細をメール接続の一部として指定する必要があります。

表17-5 LDAPディレクトリ・サーバーの構成パラメータ

フィールド

説明

LDAPホスト

LDAP (Lightweight Directory Access Protocol)ディレクトリ・サーバーが実行されているコンピュータのホスト名を入力します。

LDAPポート

LDAPディレクトリ・サーバーがリスニングするポートを入力します。

LDAPベースDN

LDAPスキーマのベース識別名を入力します。例: CN=Users,DC=oracle,DC=com。

LDAPドメイン

配信リスト名の後ろに追加するドメインを入力します。

たとえば、このドメイン値をexample.comに設定した場合、Spacesでは、Finance ProjectというスペースはFinanceProject@example.comという配信リストを保持します。

LDAP管理ユーザー

LDAPディレクトリ・サーバー管理者のユーザー名を入力します。

LDAPスキーマにエントリを作成する権限のある有効なユーザーを指定してください。

LDAP管理パスワード

LDAPディレクトリ・サーバー管理者のパスワードを入力します。

このパスワードは保護されたストアに格納されます。

LDAPデフォルト・ユーザー

モデレーション機能を付与するユーザー名のカンマ区切りリストを入力します。これらのユーザーは、作成されるすべてのスペース配信リストのメンバーになります。ここで指定するユーザーは、(「LDAPベースDN」フィールドで指定した)ベースLDAPスキーマに存在する必要があります。

LDAP保護

WebCenter PortalアプリケーションとLDAPディレクトリ・サーバー間に保護された接続(SSL)が必要かどうかを指定します。

8. メール・サーバー接続の拡張オプションを入力します(表17-6)。

表17-6 メール・サーバー接続: 拡張構成

フィールド

説明

接続タイムアウト

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalアプリケーションが接続タイムアウト・メッセージを発行するまでにメール・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは-1で、サービスのデフォルトが使用されます。サービスのデフォルトは10秒です。

9. オプションとして、メール・サーバー接続にパラメータを追加できます(表17-7)。

表17-7 追加のメール接続プロパティ

追加の
接続プロパティ

説明

charset

接続で使用するキャラクタ・セット。

デフォルトのキャラクタ・セットはUTF-8です。ISO-8859-1などの別のキャラクタ・セットを使用する場合は、charset接続プロパティを設定します。

各種のIMAPプロパティ

任意の有効なIMAP接続プロパティ。例: mail.imap.connectionpoolsize。

有効なプロトコル・プロパティのリストは、メール・サーバーのドキュメントを参照してください。標準IMAPプロパティのリストは、Java Mail APIを参照してください。

http://java.sun.com/products/javamail/javadocs/com/sun/mail/imap/package-summary.html

各種のSMTPプロパティ

任意の有効なSMTP接続プロパティ。例: mail.smtp.timeout。

有効なプロトコル・プロパティのリストは、メール・サーバーのドキュメントを参照してください。標準SMTPプロパティのリストは、Java Mail APIを参照してください。

http://java.sun.com/products/javamail/javadocs/com/sun/mail/smtp/package-summary.html

メール・サーバーとの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表17-8「メール接続: 追加プロパティ」を参照)。

表17-8 メール接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- 名前: 接続プロパティの名前を入力します。

- 値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: OKをクリックするまで、削除された行は無効として表示されます。

10. 「OK」をクリックして、この接続を保存します。

11. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

17.4.2 WLSTを使用したメール・サーバーの登録

WLSTコマンドのcreateMailConnectionを使用すると、メール・サーバー接続を作成できます。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateMailConnectionに関する項を参照してください。

WLSTコマンドのsetMailConnectionPropertyを使用すると、外部アプリケーションを介して必要な追加コマンドを追加できます。メール・サービスの外部アプリケーションでは、認証方式=POSTを使用する必要があります。また、一部のメール・ヘッダー・フィールドをカスタマイズできます(「ユーザーに表示」が有効の場合)。次に例を示します。

setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.emailAddress', value='john.doe@example.com')

setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.displayName', value='John Doe')

setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.replyToAddress', value='feedback@example.com')

各要素の意味は次のとおりです。

- mail.user.emailAddress = 電子メール・アドレス(メールの送信元)

- mail.user.displayName = 自分の名前(メールの表示名)

- mail.user.replyToAddress = 返信先アドレス(メールに返信するときのアドレス)

これらのプロパティは、特定のメール・アドレスが外部アプリケーションとメール・サーバーで同じであることを保証します。これらのプロパティはメール接続に追加され、メール・サービスで「送信元」、「表示名」および「返信先」の各フィールドに使用されます。WebCenter Portalアプリケーションで、要求時にユーザーID情報をメール送信する機能を備えた自己登録ページを用意している場合、ここで選択した外部アプリケーションに対してパブリック資格証明が構成されていることを確認してください。パブリック資格証明が定義されていない場合、要求時にユーザーにメールが送信されません。たとえば、Spacesアプリケーションでは、デフォルトの自己登録ページでこの機能を提供しています。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionPropertyに関する項を参照してください。

新規のメール・サーバー接続をデフォルトの接続として使用するようにメール・サービスを構成するには、default=trueを設定します。詳細は、第17.5.2項「WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

17.5 アクティブな(またはデフォルトの)メール・サーバー接続の選択

WebCenterアプリケーションには複数のメール・サーバー接続を登録できますが、デフォルトの接続として指定できる接続は1つのみです。デフォルトの接続は、次の項目のバックエンド・メール・サーバーとなります。

- メール・タスク・フロー

- スペース配信リスト

- 「メールの送信」アイコンがあるすべての場所

この項の内容は次のとおりです。

- 第17.5.1項「Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」

- 第17.5.2項「WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」

17.5.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

デフォルトの接続を変更する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「メール・サーバー」を選択します。
「メール・サーバーの管理」表に、現在のアクティブな接続（ある場合）が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しいデフォルトの接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

17.5.2 WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

WLSTコマンドのsetMailConnectionをdefault=trueで使用して、既存のメール・サーバー接続をメール・サービス用のデフォルトの接続にします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionに関する項を参照してください。

デフォルト引数をtrueからfalseに変更しても、その接続がメール・サービス用のデフォルトの接続でなくなることはありません。

メール・サーバー接続を無効にするには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveMailServicePropertyコマンドを使用します。

removeMailServiceProperty(appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のremoveMailServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

17.6 メール・サーバー接続の詳細の変更

メール・サーバー接続の詳細はいつでも変更できます。

更新したメール接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項の内容は次のとおりです。

- 第17.6.1項「Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更」

- 第17.6.2項「WLSTを使用したメール・サーバー接続の詳細の変更」

17.6.1 Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更

メール・サーバー接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「メール・サーバー」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表17-4「メール・サーバーの接続パラメータ」を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新した接続の詳細の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

17.6.2 WLSTを使用したメール・サーバー接続の詳細の変更

WLSTコマンドのsetMailConnectionを使用して、既存のメール・サーバー接続の詳細を編集します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionに関する項を参照してください。

メール・サーバーとの接続に追加のパラメータが必要な場合は、setMailConnectionPropertyコマンドを使用します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新した接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

17.7 メール・サーバー接続の削除

メール・サーバー接続はいつでも削除できますが、アクティブな(またはデフォルトの)接続を削除する際は注意が必要です。メール・タスク・フローはバックエンド・メール・サーバーを必要とするため、アクティブな接続を削除すると機能しなくなります。

接続を削除するとき、メール・サーバー接続に関連付けられている外部アプリケーションの目的がこの接続をサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。詳細は、第26.5項「外部アプリケーション接続の削除」を参照してください。

この項の内容は次のとおりです。

- 第17.7.1項「Fusion Middleware Controlを使用したメール接続の削除」

- 第17.7.2項「WLSTを使用したメール接続の削除」

17.7.1 Fusion Middleware Controlを使用したメール接続の削除

メール・サーバー接続を削除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「メール・サーバー」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:

管理対象サーバーを再起動する前に、他の接続をアクティブとしてマークしてください。そうしないとサービスが無効になります。

17.7.2 WLSTを使用したメール接続の削除

WLSTコマンドのdeleteConnectionを使用して、メール・サーバー接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

17.8 メール・サービスのデフォルトの設定

WLSTコマンドのsetMailServicePropertyを使用して、メール・サービスのデフォルトを設定します。

- address.delimiter: 複数のメール・アドレスの区切りに使用するデリミタを定義します。デフォルトではカンマが使用されます。
メール・サーバーによっては、姓, 名という形式のメール・アドレスを必要とするものがあります。その場合、セミコロンが必要です。

- mail.emailgateway.polling.frequency: 新着メールがないかどうかスペース配信リストが確認される間隔(秒)。デフォルトは1800秒(30分)です。
スペース配信リストによるメール通信は、ディスカッション・フォーラム投稿としてディスカッション・サーバー上で公開できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・フォーラムでのスペース・メールの公開に関する項を参照してください。

- mail.messages.fetch.size: メール受信ボックスに表示する最大のメッセージ数。

- resolve.email.address.to.name: LDAPが構成されている場合に、ユーザー・メール・アドレスをWebCenter Portalのユーザー名に解決するかどうかを指定します。有効な値は、1 (true)および0 (false)です。デフォルト値は0です。
1に設定すると、電子メール・アドレスのかわりにWebCenter Portalのユーザー名がメール・タスク・フローに表示されます。

メール・サービスが電子メール・アドレスを提供したとき、プレゼンス情報を取得できないため、インスタント・メッセージおよびプレゼンス・サービスがユーザー名を使用してプレゼンス・ステータスを取得する必要がある場合は、このプロパティを1に設定します。この値を1に設定すると、アプリケーションのパフォーマンスに影響します。したがって、このプロパティを設定するときには、この点を考慮してください。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetMailServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

17.9 メール・サーバー接続のテスト

Thunderbird、Outlookなどの任意のクライアントを使用してメール・サーバーに接続することによって、メール・サーバーが稼働していることを確認します。

Microsoft Exchangeの場合、「Administrative Tools」→「Services」に移動して、次のサービスが実行中(「Status」が「Started」)であることを確認します。

- Microsoft Exchange IMAP4

- 簡易メール転送プロトコル(SMTP)

17.10 メールに関する問題のトラブルシューティング

この項の内容は次のとおりです。

- 第17.10.1項「セキュア・モードでメール・サービスにアクセスできない」

- 第17.10.2項「非セキュア・モードでメール・サービスにアクセスできない」

- 第17.10.3項「非セキュア・モードで配信リストを作成できない」

- 第17.10.4項「セキュア・モードで配信リストを作成できない」

- 第17.10.5項「ダウンロードするメールの件数を構成できない」

- 第17.10.6項「スペース・メールを公開およびアーカイブできない」

- 第17.10.7項「Microsoft Exchangeでのパスワードの変更」

- 第17.10.8項「メールの内容が添付ファイルとして送信される」

17.10.1 セキュア・モードでメール・サービスにアクセスできない

問題

セキュア・モードで動作するようにメール・サービスを構成したが、メール・サービスにアクセスできない。

解決策

次のことを確認します。

- IMAPおよびSMTPポートが正しく指定されている。第17.4項「メール・サーバーの登録」を参照してください。

- メール・サーバーで次のプロパティがtrueに設定されている。

- mail.imap.secured = true

- mail.smtp.secured = true

17.10.2 非セキュア・モードでメール・サービスにアクセスできない

問題

非セキュア・モードで動作するようにメール・サービスを構成したが、メール・サービスにアクセスできない。

解決策

次のことを確認します。

- IMAPおよびSMTPポートが正しく指定されている。第17.4項「メール・サーバーの登録」を参照してください。

- メール・サーバーで次のプロパティがfalseに設定されている。

- mail.imap.secured = false

- mail.smtp.secured = false

17.10.3 非セキュア・モードで配信リストを作成できない

問題

非セキュア・モードで、つまりLDAPサーバーでSSLが構成されていない状態でスペース配信リストを作成できない。

解決策

メール・サーバーが再インストールされていないか、またはユーザーが削除されていないか確認します。また、LDAPサーバーで、次のパラメータが非セキュア・モードで正しく構成されていることを確認してください。

- ldapHost

- defaultUser

- ldapAdminPassword

- ldapBaseDN

- ldapPort

第17.4項「メール・サーバーの登録」を参照してください。

17.10.4 セキュア・モードで配信リストを作成できない

問題

セキュア・モードで、つまりLDAPサーバーでSSLが構成された状態でスペース配信リストを作成できない。

解決策

メール・サーバーが再インストールされていないか、またはユーザーが削除されていないか確認します。また、LDAPサーバーで、次のパラメータがセキュア・モードで正しく構成されていることを確認してください。

- ldapHost

- defaultUser

- ldapAdminPassword

- ldapBaseDN

- ldapPort

- ldap.connection.secure, 'true'

関連項目:

第17.4項「メール・サーバーの登録」

17.10.5 ダウンロードするメールの件数を構成できない

問題

各ユーザーの受信ボックスにダウンロードするメールの件数を構成できない。

解決策

WLSTコマンドのsetMailServicePropertyを使用します。たとえば、メール・クライアントから100件のメールをダウンロードする場合は、次の例のようにmail.messages.fetch.sizeパラメータに100を指定します。

setMailServiceProperty(appName='webcenter',  property='mail.messages.fetch.size', value='100')

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetMailServicePropertyに関する項を参照してください。

17.10.6 スペース・メールを公開およびアーカイブできない

問題

スペース・メールをアーカイブできない。

解決策

アーカイブできない場合、次のことを確認してください。

- WebCenter Portal: Spacesで「管理」→「構成」→「サービス」→「ディスカッション」に移動します。必要な構成が正しいかどうかを確認します。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・フォーラムでスペース・メールの公開に関する項を参照してください。

- ここで構成されているユーザー・アカウントが配信リストのメンバーであるかどうかを確認します。

- 特定のスペースについて、構成されているフォーラムがディスカッション・サーバーで使用できるかどうかを確認します。Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・フォーラムでのスペース・メールの公開に関する項を参照してください。

- 配信リストにメールを送信するユーザーがディスカッション・サーバーで使用できるかどうか、またそのユーザーのメール・アドレスが同じかどうかを確認します。

17.10.7 Microsoft Exchangeでのパスワードの変更

問題

複数のユーザーがMicrosoft Exchangeに同じユーザー名とパスワードでログオンし、1人のユーザーがパスワードを変更した場合、すべてのユーザーがログオフするまで元のパスワードは引き続き有効です。

たとえば、ユーザーmontyの現在のパスワードがwelcome1とします。AとBの2人のユーザーが別々のクライアントからWebCenter PortalまたはMicrosoft Exchangeのいずれかを使用してログオンします。2人ともmonty/welcome1でログオンし、2人ともメールを閲覧できます。ここで、ユーザーAがMicrosoft Exchangeのパスワードをoracle1に変更します。この時点では、パスワードoracle1を使用するユーザーとパスワードwelcome1を使用するユーザーが存在するため、どちらのパスワードも有効です。したがって、別のユーザーがmonty/welcome1でログオンして引き続きメールを閲覧できます。

解決策

元のパスワードを使用する既存のユーザー全員がログオフすると、新しいパスワードが有効になります。それまでは、両方のパスワードを使用してログオンできます。

17.10.8 メールの内容が添付ファイルとして送信される

問題

Frameworkアプリケーションでメールを受信したとき、メッセージの内容がメッセージ本文内ではなく、添付ファイル(content.html)として表示される。この現象が発生する可能性があるのは、メール・サーバーでMicrosoft Exchange Server 2007が実行されており、「Exchange Server 2007の更新プログラムのロールアップ3」がまだインストールされていない場合です。

解決策

「Exchange Server 2007の更新プログラムのロールアップ3」をダウンロードしてインストールすると、この問題を解消できます。詳細は、http://support.microsoft.com/kb/930468を参照してください。

18 ピープル・コネクション・サービスの管理

この章では、ピープル・コネクション・サービスに必要なバックエンド構成の要件について説明します。WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にWebCenter Portalアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。

この章の内容は次のとおりです。

- 第18.1項「ピープル・コネクション・サービスに関する必要な知識」

- 第18.2項「ピープル・コネクションの前提条件」

- 第18.3項「アクティビティ・ストリームのプロキシ・サーバーの設定」

- 第18.4項「アクティビティ・ストリーム・スキーマのアーカイブ」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

18.1 ピープル・コネクション・サービスに関する必要な知識

ピープル・コネクション・サービスは、ユーザーのコネクションのアクティビティを作成、連携および追跡するためのソーシャル・ネットワーキング・ツールです。このサービスの各機能により、ユーザーは自分の個人プロファイルの管理、他のユーザーのプロファイルへのアクセス、非定型のフィードバックの提供、メッセージの投稿、アクティビティの追跡ができるほか、他のユーザーとつながることができます。

ピープル・コネクション・サービスでは、次の一連の機能によってこれを実現しています。

- アクティビティ・ストリーム: アプリケーションまたはソーシャル・ネットワーキング・アクションによって生成されたユーザー・アクティビティを表示します。

- コネクション: 他のアプリケーション・ユーザーとつながって、情報の共有、パフォーマンスに対するコメント、メッセージの交換およびアクティビティの追跡ができます。

- フィードバック: 非定型のパフォーマンス・フィードバックを他のユーザーに提供できます。

- メッセージ・ボード: 他のユーザーにメッセージを投稿できます。

- プロファイル: 自分の連絡先情報を入力したり、他のユーザーの連絡先情報を表示したりできます。

- パブリッシャ: ステータス・メッセージの公開やファイルおよびリンクの投稿ができます。

ピープル・コネクション・サービスの機能は、前述の5つのカテゴリに分類されます。それぞれのカテゴリには一連のタスク・フローが含まれており、それらのタスク・フローを通じてピープル・コネクションの各機能がエンド・ユーザーに提供されます。

ピープル・コネクション・サービスの実行時の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコラボレーションおよびソーシャル・ネットワーキング環境の編成に関する第VIII部を参照してください。

ピープル・コネクションの構成の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのWebCenter Spaces用のピープル・コネクションのデフォルトの構成に関する項を参照してください。

18.2 ピープル・コネクションの前提条件

ピープル・コネクション・サービスを使用するには、WEBCENTERスキーマがデータベースにインストールされている必要があります。

本番環境では、ピープル・コネクションにコネクション候補の母集団を提供する手段として、エンタープライズはバックエンド・アイデンティティ・ストアを利用できます。開発環境では、開発者がテスト・ユーザーをjazn-data.xmlファイルに追加できます。

たとえば、プロファイルでは、WebCenter Portalアプリケーションからそのユーザーに提供される大量の情報をバックエンド・アイデンティティ・ストアから取得します。また、プロファイルでは、この情報の一部を変更したり、アイデンティティ・ストアに格納されていない追加データを提供することも可能です。

本番バージョンのアプリケーションのバックエンド(LDAP)アイデンティティ・ストアへの接続の詳細は、第29章「アイデンティティ・ストアの構成」を参照してください。

18.3 アクティビティ・ストリームのプロキシ・サーバーの設定

外部のピープル・コネクションがWebCenter Portalアプリケーションでフィードできるようにするには、プロキシ・サーバーを設定する必要があります。

アクティビティ・ストリーム・タスク・フローで外部リンクを表示する場合は、プロキシ・サーバーも必要です。ピープル・コネクション・サービスとアクティビティ・ストリーム・サービスは、同じプロキシ・サーバー設定を共有します。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、プロキシ・サーバーを構成できます。詳細は、第9.7項「プロキシ・サーバーの設定」を参照してください。

18.4 アクティビティ・ストリーム・スキーマのアーカイブ

アプリケーション管理者は、WLSTコマンドを使用してアクティビティ・ストリーム・スキーマ内のデータをアーカイブおよびリストアできます。次のコマンドを使用できます。

- archiveASByDate: 指定した日付よりも古いアクティビティ・ストリーム・データをアーカイブします。

- archiveASByDeletedObjects: 削除されたオブジェクトに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByClosedSpaces: 現在クローズ中のSpacesに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByInactiveSpaces: 指定した日付から非アクティブであったSpacesに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- restoreASByDate: 指定した日付以降のアーカイブされたアクティビティ・ストリーム・データを本番の表にリストアします。

詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のアクティビティ・ストリームに関する項を参照してください。

18.5 プロファイル・サービスのキャッシュ・オプションの構成

プロファイル・サービスのJOCキャッシュを構成するには、たとえば、WLSTコマンドのsetProfileCacheTimeToLiveを使用して、オブジェクトがキャッシュ内に存在できるアイドル時間を設定します。この時間が経過してもアクセスがないオブジェクトは削除されます。同様に、WLSTコマンドのsetProfileCacheNumberOfObjectsを使用して、キャッシュ内に存在できる最大のオブジェクト数を設定できます。最大数に達すると、古いオブジェクトまたは未使用のオブジェクトが削除されます。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のXWLSTXに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

19 サブスクリプションおよび通知の管理

Spacesアプリケーションでは、サブスクリプションおよび通知を使用することで、特に興味のあるサービスやアプリケーション・オブジェクトのタイプをサブスクライブできます。したがってユーザーは、サブスクライブしたサービスやオブジェクトに影響する変更について、選択したメッセージング・チャネルから適時に通知を受信します。

関連項目:

詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのサブスクリプションおよび通知に関する必要な知識に関する項を参照してください。

通知管理は、アプリケーションレベルのサブスクリプションに対するアプリケーション全体のデフォルトを作成および(場合によって)強制する手段と、通知の配信を処理するサーバーを識別する接続タイプを指定する手段を提供します。

この章では、これらの管理作業の手順を示すとともに、WLSTコマンドを使用して通知メッセージの構成の詳細を設定および取得する方法について説明します。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にWebCenter Portalアプリケーションに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行うWebCenter Portalサービス構成の変更の多くは、動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第19.1項「デフォルトのサブスクリプション・プリファレンスの設定」

- 第19.2項「通知の設定」

- 第19.3項「カスタム通知テンプレートの作成および適用」

- 第19.4項「通知接続のテスト」

- 第19.5項「通知に関する問題のトラブルシューティング」

19.1 デフォルトのサブスクリプション・プリファレンスの設定

Spacesユーザーは、Spacesアプリケーションの「プリファレンス」ダイアログで各自のサブスクリプション・プリファレンスを設定します。その前に、WebCenter Portal管理者がデフォルト値を設定し、すべてのユーザーが使用できるアプリケーションレベルのサブスクリプション・オプションを指定して、それらが変更可能かどうかを決定できます。

この項では、サブスクリプションのデフォルトの概要を示し、そのデフォルト値の設定手順について説明します。

この項の内容は次のとおりです。

- 第19.1.1項「サブスクリプションのデフォルトに関する必要な知識」

- 第19.1.2項「サブスクリプションのデフォルトの設定」

- 第19.1.3項「Spacesでのサブスクリプション・プリファレンスの設定」

19.1.1 サブスクリプションのデフォルトに関する必要な知識

管理者レベルのサブスクリプション・プリファレンスは、カスタムXMLファイルで設定します。このファイルを作成して、あらかじめ用意されているファイル(notification-service-settings.xml)のかわりに使用します。カスタムXMLファイル内の設定は、ユーザーがSpacesアプリケーションの「サブスクリプション・プリファレンス」で行うアプリケーションレベルのサブスクリプション設定と同じです(詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのアプリケーションレベルのサブスクリプションの設定に関する項を参照)。

各設定には次の3つの属性があります。

- id: サービスIDを指定します。

- oracle.webcenter.peopleconnections.connections: ピープル・コネクション・サービスのコネクション機能

- oracle.webcenter.peopleconnections.wall: ピープル・コネクション・サービスのメッセージ・ボード機能

- oracle.webcenter.peopleconnections.kudos: ピープル・コネクション・サービスのフィードバック機能

- oracle.connections.community: スペース・メンバーシップ管理

- subscription-enabled: プリファレンス・オプションのデフォルト値を指定します(trueまたはfalse)。

ヒント:

subscription-enabled属性は、サブスクリプション機能全体を有効化または無効化するのではなく、単にプリファレンス・オプションの初期状態を設定します。たとえば、subscription-enabled="true"の場合は、Spacesアプリケーションの「プリファレンス」ダイアログの関連付けられたサブスクリプション・オプションがデフォルトで確認されます。subscription-enabled="false"の場合、ダイアログの関連付けられたサブスクリプション・オプションはデフォルトで確認されません。

- end-user-configurable: 設定されているデフォルトをユーザーが変更できるかどうかを指定します(trueまたはfalse)。

これらの属性が連動して、Spacesアプリケーションの「プリファレンス」ダイアログにある「サブスクリプション」パネルの「一般サブスクリプション」タブの初期状態が決まります(図19-1)。

図19-1 「サブスクリプション」パネルの「一般サブスクリプション」タブ

「図19-1 「サブスクリプション」パネルの「一般サブスクリプション」タブ」の説明

表19-1に、管理者レベルのカスタム・サブスクリプション設定が「一般サブスクリプション」タブの表示に及ぼす効果を示します。

表19-1 管理者のデフォルトがサブスクリプション・プリファレンスに及ぼす効果

subscription-enabled脚注1

end-user-configurable

プリファレンス内のオプション

True

True

通常表示。チェック・ボックスが選択された状態。

True

False

灰色表示。チェック・ボックスが選択された状態。

False

True

通常表示。チェック・ボックスの選択が解除された状態。

False

False

非表示。チェック・ボックスが非表示の状態。

脚注1 subscription-enabled属性は、サブスクリプション機能全体を有効化または無効化するのではなく、単にプリファレンス・オプションの初期状態を設定します。たとえば、subscription-enabled="true"の場合は、Spacesアプリケーションの「プリファレンス」ダイアログの関連付けられたサブスクリプション・オプションがデフォルトで確認されます。subscription-enabled="false"の場合、ダイアログの関連付けられたサブスクリプション・オプションはデフォルトで確認されません。

ヒント:

表19-1で、ほとんどの通知に最も一般的なシナリオは3行目です。

表19-2に、アプリケーションレベルの通知をトリガーできるアクションのタイプと、対応するサービスIDを示します。

表19-2 通知をトリガーできるアプリケーションレベルのアクティビティ

アクティビティ

対応するサービスID

他のユーザーがあなたにコネクションへの招待を送信した

oracle.webcenter.peopleconnections.connections

あなたのスペース・ロールが変更された(例: 参加者→モデレータ)

oracle.webcenter.community

あなたがスペースのメンバーとして追加された

oracle.webcenter.community

あなたのスペース・メンバーシップが削除された

oracle.webcenter.community

他のユーザーがあなたのメッセージ・ボードにメッセージを投稿した

oracle.webcenter.peopleconnections.wall

他のユーザーのメッセージ・ボード上にあるあなたの投稿を、別のユーザーがお気に入り登録した

oracle.webcenter.peopleconnections.wall

他のユーザーのメッセージ・ボード上にあるあなたの投稿に対して、別のユーザーがコメントした

oracle.webcenter.peopleconnections.wall

他のユーザーがあなたにフィードバックを投稿した

oracle.webcenter.peopleconnections.kudos

19.1.2 サブスクリプションのデフォルトの設定

アプリケーションレベルのサブスクリプション・プリファレンスのデフォルトを設定する手順は次のとおりです。

1. /oracle/webcenter/notificationというパスを含むディレクトリに移動し、フォルダcustomを作成します。

ヒント:

このディレクトリ構造は、パスに/oracle/webcenter/notification/customが含まれてさえいれば、任意のディレクトリで開始または終了できます。

2. customフォルダ、つまり/oracle/webcenter/notification/custom/の下の任意のサブディレクトリにファイルnotification-service-settings.xmlを作成します。

3. このXMLファイルに、アプリケーションレベルのすべてのサブスクリプション・オプションの値を入力します。
例19-1に、アプリケーション全体のサブスクリプション・プリファレンス設定ファイルの内容のサンプルと、必要な各オプションの例を示します。

例19-1 サブスクリプション設定XMLファイルの例

<notification-service_settings xmlns="http://xmlns.oracle.com/webcenter/notification">
<subscription-settings>
<service id="oracle.webcenter.peopleconnections.connections" subscription-enabled="true"
end-user-configurable="false"/>
<service id="oracle.webcenter.peopleconnections.wall" subscription-enabled="false"
end-user-configurable="true"/>
<service id="oracle.webcenter.peopleconnections.kudos" subscription-enabled="false"
end-user-configurable="true"/>
<service id="oracle.webcenter.community" subscription-enabled="true"
end-user-configurable="true"/>
</subscription-settings>
</notification-service_settings>

注意:

オプションを指定しないと、デフォルト値のfalse/falseがサービスに割り当てられます。

4. WLSTコマンドのimportMetadata()を実行して、ディレクトリの中身をメタデータ・ストアにインポートします。

関連項目:

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。importMetadata()コマンド(および他のWLSTコマンド)の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

次に例を示します。

wls: /wc_domain/serverConfig> importMetadata(application='webcenter',
server='serverName', fromLocation='directoryPath', docs='/**')

各要素の意味は次のとおりです。

- application: Spacesアプリケーションを識別する名前です。

- serverName: Spacesアプリケーションが実行されているサーバーの名前です。

- directoryPath: oracle/webcenter/notification/custom/<この後ろに任意のサブディレクトリ>/notification-service-settings.xmlの上位にあるディレクトリ・パスです。
たとえば、notification-service-settings.xmlへのディレクトリ・パスが/scratch/mydir/oracle/webcenter/notification/customの場合、/scratch/mydirをdirectoryPathに入力します。

- docs: インポートする対象を指定します。この例では、directoryPath以下のすべてのパスとファイルを指定しています。

表19-3に、サービスID oracle.webcenter.peopleconnections.connectionsに対する様々な設定の組合せの効果を示します。

表19-3 コネクションのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルトを変更できません。脚注1

false

true

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

脚注1 これは出荷時のデフォルトです。

表19-4 に、サービスID oracle.webcenter.peopleconnections.wallに対する様々な設定の組合せの効果を示します。

表19-4 メッセージ・ボードのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表19-5に、サービスID oracle.webcenter.peopleconnections.kudosに対する様々な設定の組合せの効果を示します。

表19-5 フィードバックのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表19-6に、サービスID oracle.webcenter.communityに対する様々な設定の組合せの効果を示します。

表19-6 スペース管理のサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- ユーザーのスペース・メンバーシップ・ロールが変更、ユーザーがスペースのメンバーとして追加、またはユーザーがスペースのメンバーから削除された場合に、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- ユーザーのスペース・メンバーシップ・ロールが変更、ユーザーがスペースのメンバーとして追加、またはユーザーがスペースのメンバーから削除された場合に、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- ユーザーのスペース・メンバーシップ・ロールが変更、ユーザーがスペースのメンバーとして追加、またはユーザーがスペースのメンバーから削除された場合に、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- ユーザーのスペース・メンバーシップ・ロールが変更、ユーザーがスペースのメンバーとして追加、またはユーザーがスペースのメンバーから削除された場合に、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

19.1.3 Spacesでのサブスクリプション・プリファレンスの設定

各ユーザーは、Spacesアプリケーションの「プリファレンス」ダイアログで各自のサブスクリプション・プリファレンスを設定します。この目的のために、次の2つの「プリファレンス」パネルが用意されています。

- サブスクリプション: 自分のスペース・メンバーシップやピープル・コネクション・サービス(コネクション、メッセージ・ボードおよびフィードバック)で発生するアクションについて通知を受けるためにサブスクライブしたり、スペースレベルやオブジェクトレベルの自分のサブスクリプションを表示および削除できます。

- メッセージング: 優先するメッセージング・チャネルおよびフィルタを構成するための各コントロールにアクセスできます(BPEL接続タイプのみ)。

関連項目:

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのメッセージング・チャネルおよびフィルタの設定と管理およびアプリケーションレベルのサブスクリプションの設定に関する項

19.2 通知の設定

この項では、メッセージング接続タイプの概要を示すとともに、通知チャネルを定義する前に満たしておく必要がある前提条件および通知で使用する通知チャネルを設定する手順を説明します。内容は次のとおりです。

- 第19.2.1項「接続チャネルに関する必要な知識」

- 第19.2.2項「通知の前提条件」

- 第19.2.3項「通知の構成ロードマップ」

- 第19.2.4項「Fusion Middleware Controlを使用した通知チャネルの指定」

- 第19.2.5項「WLSTを使用した通知チャネルの指定」

- 第19.2.6項「例: WLSTを使用したSpacesアプリケーションのメール通知の設定」

19.2.1 接続チャネルに関する必要な知識

通知の接続タイプによって、ユーザーがSpacesで各自の通知用のメッセージング・プリファレンスを構成するときに使用できるメッセージング・チャネルが決まります。

次の2つの接続タイプ候補のうち、いずれかを使用します。

- BPELサーバー: メール、ショート・メッセージ・サービス(SMS)およびワークリストの3つのメッセージング・チャネルを提供します。

- メール・サーバー: Spacesアプリケーション用に構成されたメール・サーバーのみを経由して通知メッセージを配信します。

BPELサーバー

BPELサーバーを選択する場合、ユーザー・メッセージング・サービス(UMS)が利用可能なBPELサーバーとの接続が確立されていることが前提となります。BPELサーバーとの接続の詳細は、第23章「ワークリスト・サービスの管理」を参照してください。

SpacesアプリケーションでsetSpacesWorkFlowConnectionNameが設定されている場合、Spacesアプリケーションの「プリファレンス」ダイアログの「メッセージング」パネルで「構成の管理」ボタンが使用可能になります。

ヒント:

通知にBPELサーバーを使用する場合、setSpacesWorkFlowConnectionNameで使用する接続と同じものを通知でも使用してください。

メール・サーバー

メール・サーバーを選択する場合、メール・サーバーとの接続が確立されていることが前提となります。さらに、メール・サーバー接続と関連付けられている外部アプリケーションが共有資格証明を含んでいる必要があります。メール・サーバーとの接続の詳細は、第17章「メール・サービスの管理」を参照してください。

選択した接続タイプがメール・サーバーの場合、Spacesアプリケーションの「プリファレンス」ダイアログの「メッセージング」パネルで「構成の管理」ボタンが灰色表示される場合とされない場合があります。これは、spacesWorkFlowConnectionを設定したかどうかによります。ただし、それとは無関係に、選択した接続タイプがメール・サーバーの場合は、メッセージング・プリファレンスの「構成の管理」ボタンをクリックしてユーザー・メッセージング・プリファレンスを開いても、そこで加えた変更はすべて無視されます。

関連項目:

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのメッセージング・チャネルおよびフィルタの設定と管理に関する項

19.2.2 通知の前提条件

通知の接続タイプを定義する前に、次の各項で説明する点を考慮し、指定の手順を実行する必要があります。

- 第19.2.2.1項「インストール」

- 第19.2.2.2項「構成」

- 第19.2.2.3項「セキュリティ」

- 第19.2.2.4項「制限事項」

19.2.2.1 インストール

通知に関するインストール要件は、通知メッセージングに選択する接続タイプによって異なります。

通知メッセージングにBPEL接続経由でユーザー・メッセージング・サービス(UMS)を使用する場合、デフォルトではメール・ドライバのみがインストールされていることに注意ください。SMSおよびワークリスト・メッセージング・チャネルを使用するには、これらに対応するドライバもインストールする必要があります。UMS用のSMSドライバおよびワークリスト・ドライバのインストールの詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドの「Oracle User Messaging Serviceの構成」の章を参照してください。

通知メッセージングにメール・サービスを使用する場合、通知に固有のインストールは必要ありませんが、第17章「メール・サービスの管理」の説明に従ってメール・サービスを構成する必要があります。

19.2.2.2 構成

通知の構成に関する前提条件も、通知メッセージングに選択する接続タイプによって異なります。

BPELサーバー

ユーザーにメッセージング・チャネルのオプション(メール、SMSおよびワークリスト)を用意する場合は、BPELサーバーとの接続が確立されている必要があります。通知では、ユーザー・メッセージング・サービス(UMS)によるマルチチャネル通知をサポートするためにSOAインストールが使用されます。UMSは、SOAドメインの一部としてインストールされます。初期設定では、メール・ドライバのみが構成されています。SMSドライバも使用可能ですが、デプロイする必要があります。ワークリスト・チャネルを使用するには、SOAドメインをワークリスト・ドライバ拡張テンプレートによって拡張する必要があります。

詳細は、第23章「ワークリスト・サービスの管理」とOracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドの「Oracle User Messaging Serviceの構成」の章を参照してください。

メール・サーバー

ユーザーが常にメールでのみ通知を受けるようにする場合、メール・サーバーとの接続が確立されている必要があります。さらに、メール・サーバー接続と関連付けられている外部アプリケーションが共有資格証明を含んでいる必要があります。詳細は、第17章「メール・サービスの管理」を参照してください。

メール通知は、各ユーザーのプロファイルで指定された優先言語で送信されます。ユーザーの優先言語が指定されていない場合は、サーバーのロケール設定がメール通知に使用されます。たとえば、サーバーが韓国ロケールで実行されており、ユーザーの優先言語が設定されていない場合、通知メールの言語は韓国語になります。

優先言語の設定の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の優先表示言語の設定に関する項を参照してください。

19.2.2.3 セキュリティ

特に通知に関連するセキュリティの考慮事項はありません。

19.2.2.4 制限事項

UMSは、音声やインスタント・メッセージなど、通知ではサポートされていない複数のメッセージング・チャネルをサポートしています。通知では、UMSからメール、SMSおよびワークリストのみを使用します。

19.2.3 通知の構成ロードマップ

図19-2と表19-7に、WebCenter Portalアプリケーションで通知サービスを動作させるための前提条件と必要な作業の概要を示します。

図19-2 通知サービスの構成

「図19-2 通知サービスの構成」の説明

表19-7 通知の構成

担当者

タスク

サブタスク

ノート

管理者

1. 通知のバックエンド・コンポーネントを設定します

- BPELサーバーの設定

- メール・サーバーの設定

管理者

2. (メール・サーバーの場合のみ)外部アプリケーションを構成します

- メール・サーバーへの外部アプリケーションの接続を作成します

- メール・サーバーの外部アプリケーションの共有資格証明を構成します

管理者

3. WebCenter Portalアプリケーションと選択したバックエンド・コンポーネント間の接続を作成または変更します

- BPELサーバーとの接続を作成します

- メール・サーバーとの接続を作成します

管理者

4. 次のいずれかのツールを使用して、通知に使用する接続のタイプ(BPELまたはメール)を選択します

- Fusion Middleware Control

- WLST

管理者

5. アプリケーションがデプロイされている管理対象サーバーを再起動します

Spacesアプリケーションの場合は、WC_Spacesを再起動します。Frameworkアプリケーションの場合は、アプリケーションがデプロイされているカスタム管理対象サーバーを再起動します。

管理者

6. すべてのユーザーに対するデフォルトのサブスクリプション・プリファレンスを設定します

開発者/エンド・ユーザー

7. アプリケーション内で通知を構成してテストします

- Spacesアプリケーション

- Frameworkアプリケーション

19.2.4 Fusion Middleware Controlを使用した通知チャネルの指定

Fusion Middleware Controlで通知メッセージの接続タイプを指定する手順は次のとおりです。

1. Oracle Fusion Middleware Controlにログインし、Spacesのホームページに移動します。
詳細は、第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「アプリケーション構成」ページで、下へスクロールしてページ下部の「通知」に移動し、アウトバウンド通知に使用する接続タイプとして「BPELサーバー」または「メール・サーバー」のいずれかを選択します。

4. 次の手順は、選択した接続タイプによって異なります。
「BPELサーバー」を選択した場合:

1. 「接続名」のリストから、その接続を設定するときに指定したBPELサーバーの名前を選択します。

2. 「送信者のメール・アドレス」フィールドに、すべての通知メッセージの送信元とするメール・アドレスを入力します。送信者のメール・アドレスは、対応するドメインからメッセージを送信するように構成されているドライバの少なくとも1つに一致する必要があります。

3. 「送信者のSMSアドレス」フィールドに、ユーザー・メッセージング・サービス(UMS)ですべての通信メッセージの送信元のドライバとして使用される4桁から6桁の数値を入力します。送信者のSMSアドレスは、対応するドメインからメッセージを送信するように構成されているドライバの少なくとも1つに一致する必要があります。

「メール・サーバー」を選択した場合は、「接続名」のリストからメール接続を選択します。

5. 変更を保存します。

6. 構成の変更を有効にするために、ポータル・アプリケーションがデプロイされている管理対象サーバーを再起動します。

19.2.5 WLSTを使用した通知チャネルの指定

WLSTコマンドのsetNotificationsConfigを使用して、通知で使用する接続タイプを構成します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetNoticationsConfigに関する項を参照してください。同ガイドのgetNotificationConfigに関する項も参照してください。

関連項目:

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この構成の更新は、MDSリポジトリに格納されます。構成の変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

19.2.6 例: WLSTを使用したSpacesアプリケーションのメール通知の設定

この項では、WLSTを使用してSpacesアプリケーションのメール通知を設定する例を示します。

この例では、外部アプリケーション接続を作成し、外部アプリケーションの共有資格証明を構成します。さらに、メール接続を作成し、メールをSpacesの通知チャネルとして設定します。その後、Spacesアプリケーションでサブスクリプション・プリファレンスを設定します。

1. WLSTコマンド・プロンプトで、Oracle WebCenter Portalの管理サーバーに接続します。

connect('admin_user','mypassword','<servername>:7001')

2. 外部アプリケーション接続を作成します。

createExtAppConnection(appName='webcenter', name='NotificationSharedApp', displayName= 'NotificationSharedApp')

このコマンドにより、NotificationSharedAppという名前の接続が作成されます。

3. 外部アプリケーションNotificationSharedAppの共有資格証明を構成します。

addExtAppCredential(appName='webcenter', name='NotificationSharedApp',
type='SHARED', username='john.doe@example.com', password='sharedpassword')

usernameは、電子メール通知の送信元とする電子メール・アカウントです。これは、<user>@<domain of the mail server>という形式で指定する必要があります。

オプションとして、メール通知の送信時に使用される次のフィールドを追加できます。

addExtAppField(appName='webcenter',name='NotificationSharedApp',fieldName='Email Address',fieldValue='sender's_email_address',displayToUser=false)
addExtAppField(appName='webcenter',name='NotificationSharedApp',fieldName='Your Name',fieldValue='sender's_display_name',displayToUser=false)

4. メール接続を作成します。

createMailConnection(appName='webcenter',name='NotificationSharedConn',
imapHost='<mailserver>',imapPort=143,
smtpHost='<mailserver>',smtpPort=25,
imapSecured=false,smtpSecured=false,
appId='NotificationSharedApp',default=1)

このコマンドにより、NotificationSharedConnという名前のメール接続が作成されます。

5. メールを通知チャネルとして設定します。

setNotificationsConfig(appName='webcenter', type='MAIL',
name='NotificationSharedConn')

これにより、NotificationSharedConnが通知の送信に使用されるメール接続として設定されます。

6. 変更を有効にするために、Spacesアプリケーションがデフォルトでデプロイされている管理対象サーバーWC_Spacesを再起動します。

7. ユーザーとしてSpacesにログインし、「プロファイル」ページの「情報」タブに移動して、自分の電子メール・アドレスが「電子メール」フィールドに設定されていることを確認します。これは、通知が目的の電子メール・アドレスに送信されるようにするためです。
電子メール・アドレスが設定されていない場合は、「編集」をクリックし、「電子メール」フィールドに自分の電子メール・アドレスを指定したら、保存をクリックします。

8. 通知を受けるアクティビティをサブスクライブします。たとえば、「プリファレンス」ダイアログに移動し、「サブスクリプション」をクリックし、「スペース管理」を選択すると、メンバーシップやロールの変更について通知を受信できます。

9. サブスクライブしたアクティビティを実行して構成をテストします。たとえば、自分のロールをモデレータから参加者に変更して通知をトリガーします。

19.3 カスタム通知テンプレートの作成および適用

ユーザーがワークリストまたはメールで受け取る通知には、コンテンツおよびコンテンツ表示用のデフォルトの書式があります。アプリケーション管理者は、デフォルトのかわりにカスタム・テンプレートを作成して適用することで、通知メッセージに独自の書式を設定できます。

この項では、通知メッセージのカスタム・テンプレートの作成について説明します。内容は次のとおりです。

- 第19.3.1項「デフォルト通知テンプレートの上書きに関する必要な知識」

- 第19.3.2項「デフォルト通知テンプレートの上書き」

19.3.1 デフォルト通知テンプレートの上書きに関する必要な知識

WLSTコマンドを使用してMDSにアクセスし、defaultTemplate.xmlファイル(および右から左に記述する言語の場合はdefaultTemplate_rtl.xmlファイル)を上書きすることで、サブスクリプション・ベースの通知メッセージのレイアウトとコンテンツをカスタマイズできます。

関連項目:

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

表のCSSスタイル(label、value、background)やフッターのCSSスタイル(note)を編集して、これらのxmlファイルの独自のバージョンを作成できます。また、<payload>や<group-space-footer>などのタグを移動してレイアウトを変更できます。これらのタグの内容を変更するには、<html-format>内のCDATAセクションを編集します。

<text-format/>タグは必須で、常に空であることが必要です。<custom>タグを使用すると、コンテンツを追加できます。<html-format>で囲まれたCDATA内に新しいHTMLコンテンツを追加し、<text-format/>は空のままにします。

例19-2と例19-3に、通知メッセージ・テンプレート・ファイルのデフォルトの内容を示します。これらを使用してカスタム・ファイルを作成できます。

注意:

これらのファイルのデフォルトの内容はよく似ています。違いは<style>タグ内にあり、そこで右揃えか左揃えかが指定されています。

例19-2 デフォルト・ファイルdefaultTemplate.xml

<?xml version="1.0"?>
<notification-template xmlns="http://xmlns.oracle.com/webcenter/notification">
<!-- The CSS Style of the Notification -->
<style>
<text-format/>
<html-format>
<![CDATA[
<style type="text/css">
.title  {font-size:1.2em; font-weight:bold;
white-space:nowrap;}
.label  {text-align:right; margin-left:30px;
padding-right:10px; white-space:nowrap;}
.value  {text-align:left; margin-right:20px;
padding-left:10px; white-space:nowrap;
width:100%;}
.note   {font-size:0.8em; color:#999999}
.background {background-color:#fcfcfc}
</style>
]]>
</html-format>
</style>

<!-- The Subject line of the Notification -->
<subject>
<message-key>NOTIFICATION_SUBJECT</message-key>
</subject>
<group-space-subject>
<message-key>GROUP_SPACE_SUBJECT_SUFFIX</message-key>
</group-space-subject>
<!-- Actual srvc-specific data. Provided/Overridden by srvc template -->
<payload>
<text-format/>
<html-format/>
</payload>

<!-- Any generic/common footer to appear after service-specific payload -->
<!-- Group Space footer - if applicable -->
<group-space-footer>
<text-format/>
<html-format>
<![CDATA[
<p>
<a href="<token>groupSpaceUrl</token>" target="_blank">
<message-key>GO_TO_SPACE</message-key>&nbsp;<token>
groupSpaceName</token>
</a>
</p>
]]>
</html-format>
</group-space-footer>

<!-- Unsubscribe footers -->
<unsubscribe-footer>
<text-format/>
<html-format>
<![CDATA[
<hr/>
<p class="note">
<token>unsubscribeMessage</token>
</p>
]]>
</html-format>
</unsubscribe-footer>
</notification-template>

例19-3 デフォルト・ファイルdefaultTemplate_rtl.xml

<?xml version="1.0"?>
<notification-template xmlns="http://xmlns.oracle.com/webcenter/notification">
<!-- The CSS Style of the Notification -->
<style>
<text-format/>
<html-format>
<![CDATA[
<style type="text/css">
.title  {font-size:1.2em; font-weight:bold;
white-space:nowrap;}
.label  {text-align:left; margin-right:30px;
padding-left:10px; white-space:nowrap;}
.value  {text-align:right; margin-left:20px;
padding-right:10px; white-space:nowrap;
width:100%;}
.note   {font-size:0.8em; color:#999999}
.background {background-color:#fcfcfc}
</style>
]]>
</html-format>
</style>

<!-- The Subject line of the Notification -->
<subject>
<message-key>NOTIFICATION_SUBJECT</message-key>
</subject>
<group-space-subject>
<message-key>GROUP_SPACE_SUBJECT_SUFFIX</message-key>
</group-space-subject>
<!-- Actual srvc-specific data. Provided/Overridden by srvc template -->
<payload>
<text-format/>
<html-format/>
</payload>

<!-- Any generic/common footer to appear after service-specific payload -->
<!-- Group Space footer - if applicable -->
<group-space-footer>
<text-format/>
<html-format>
<![CDATA[
<p>
<a href="<token>groupSpaceUrl</token>" target="_blank">
<message-key>GO_TO_SPACE</message-key>&nbsp;<token>
groupSpaceName</token>
</a>
</p>
]]>
</html-format>
</group-space-footer>

<!-- Unsubscribe footers -->
<unsubscribe-footer>
<text-format/>
<html-format>
<![CDATA[
<hr/>
<p class="note">
<token>unsubscribeMessage</token>
</p>
]]>
</html-format>
</unsubscribe-footer>
</notification-template>

19.3.2 デフォルト通知テンプレートの上書き

既存のXMLファイルを上書きして通知メッセージの書式をカスタマイズする手順は次のとおりです。

1. defaultTemplate.xml (または右から左へ記述する言語の場合はdefaultTemplate_rtl.xml)という名前のカスタムXMLファイルを作成します。

2. これらのデフォルト・ファイルの1つを編集したバージョンをカスタム・ファイルにコピーします。

関連項目:

例19-2と例19-3にデフォルト・ファイルの内容が示されています。

3. ネームスペースoracle/webcenter/notification/customを含む絶対パスにカスタム・ファイルを置いて元のファイルを上書きします。
次に例を示します。

/tmp/repository/oracle/webcenter/notification/custom/template/defaultTemplate.xml

4. WLSTコマンドのimportMetadata()を実行して、カスタム・ファイルをWebCenter PortalのMDSリポジトリにアップロードします。
次に例を示します。

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='template-file-location',
docs='/oracle/webcenter/notification/custom/template/defaultTemplate.xml')

template-file-locationは、完全修飾カスタム・ファイルが置かれているディレクトリを示します。完全修飾カスタム・ファイルは、通常、そのネームスペースに対応するディレクトリ構造に置かれています。たとえば、ファイルが次のネームスペースに作成されているとします。

/tmp/repository/oracle/webcenter/notification/custom/template/defaultTemplate.xml

この場合、fromLocationは/tmp/repositoryになります。残りのサブディレクトリは、XMLファイルのネームスペースで構成されています。ネームスペースには、/oracle/webcenter/notification/customというパスが少なくとも必要です。

関連項目:

importMetadata()コマンド(および他のWLSTコマンド)の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

5. ポータル・アプリケーションを再起動します。

19.4 通知接続のテスト

一般に、管理者が設定した時点で通知が有効かどうかは、基礎となるメール接続またはBPEL接続に依存します。これらの接続をテストして有効であれば、その延長として通知接続の要件も満たされます。

ヒント:

メール接続のテストの詳細は、第17.9項「メール・サーバー接続のテスト」を参照してください。

19.5 通知に関する問題のトラブルシューティング

問題

通知がまったく受信されない。

解決策

- 通知の送信者が構成されていないことをログが示している場合、使用する接続をサービスが検出できないことを意味します。

- 有効なBPEL接続またはメール接続を使用するように通知が構成されていることを確認してください。これは、WLSTコマンドのgetNotificationsConfig() (第19.2.5項「WLSTを使用した通知チャネルの指定」を参照)またはFusion Middleware Controlのユーザー・インタフェース(第19.2.4項「Fusion Middleware Controlを使用した通知チャネルの指定」を参照)を使用して検証できます。

問題

通知は正しく構成されているが(BPELまたはメール)、それでも通知が受信されない。

解決策

通知は、有効なBPEL接続またはメール接続に依存しています。第17章「メール・サービスの管理」または第23章「ワークリスト・サービスの管理」の説明に従って、それぞれの接続の検証とトラブルシューティング・シナリオを実行してください。

問題

メール接続またはBPEL接続は適切に設定されているが、それでも通知が受信されない。

解決策

通知は、ユーザーのサブスクリプションに基づいて生成されます。あらかじめ構成されている、コネクションへの招待の通知を除き、それ以外の通知はユーザーが明示的にサブスクライブした場合にのみ生成されます。ユーザーが個人のプリファレンスか、スペース・レベルまたはオブジェクト・レベルのサブスクリプションによってサブスクリプションを作成していることを確認してください。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのアプリケーション、スペースおよびオブジェクト・レベルのサブスクライブに関する項を参照してください。

問題

ユーザーはサブスクリプションを設定しているが、それでも通知が受信されない。

解決策

- 通知では、構成に基づいて、通知の配信がBPEL/UMSまたはメール・サービスに委任されます。メール・サービスの場合は、ユーザーの電子メール・アドレスが構成されていることを確認してください。UMSの場合は、Fusion Middleware Controlで「ユーザー・メッセージング・サービス」の「メッセージ・ステータス」セクションを参照してください。ここで、UMSから送信される各メッセージのステータスを確認できます。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドの「Oracle User Messaging Serviceの監視」の章を参照してください。

- UMSの場合、この問題は、WebCenter Portal側の送信者の設定がUMS側の対応するドライバと一致しないか、対応するドライバを検出できないことを意味する可能性もあります。送信者のアドレス(ドメイン)をUMSがアウトバウンド・メッセージのドライバの少なくとも1つと照合できるようにしてください。

- メール・サービスの場合、第19.2.1項「接続チャネルに関する必要な知識」の説明に従って、メール接続が共有接続をポイントしていることを確認してください。

問題

(UMS構成の場合)ユーザーが一部のチャネルからは通知を受信するが、他のチャネルからは受信しない。

解決策

これは、ユーザーのメッセージング・チャネルおよびフィルタの構成に起因する可能性が高いと考えられます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのメッセージング・チャネルおよびフィルタの設定と管理に関する項を参照してください。

問題

(UMS構成の場合)メール・チャネルの通知のみが配信され、ワークリスト・チャネルが機能しない。

解決策

Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドの「Oracle User Messaging Serviceの構成」の章の説明に従って、SOAドメインがワークリスト・ドライバ・テンプレートによって拡張されていることを確認してください。

20 WebCenter Portalのパーソナライズの管理

この章では、WebCenter Portalのパーソナライズ・サービスを構成および管理する方法について説明します。

この章の内容は次のとおりです。

- 第20.1項「WebCenter Portalのパーソナライズに関する必要な知識」

- 第20.2項「開始前の作業: 必要な構成の実行」

- 第20.3項「パーソナライズのその他の前提条件」

- 第20.4項「WebCenter OPSSトラスト・サービスの構成」

- 第20.5項「プロバイダの構成」

- 第20.6項「Coherenceの構成」

- 第20.7項「コンテンツ・プレゼンタの構成」

- 第20.8項「シングル・サインオンの構成」

- 第20.9項「デフォルトのセキュリティ設定のオーバーライド」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

20.1 WebCenter Portalのパーソナライズに関する必要な知識

WebCenter Portalのパーソナライズを使用すると、WebCenter Portalアプリケーションのユーザー・エクスペリエンスを動的に導出できます。パーソナライズは、定義された入力データ・ソースを評価し、その評価に基づいてデシジョンを生成し、この情報を宣言的に定義されたパーソナライズ・シナリオに適用します。パーソナライズでは、たとえば、人事管理データベース内のユーザーに関する情報に基づいてコンテンツを返したりアプリケーション・フローを変更することで、その特定のユーザー向けのアプリケーション・エクスペリエンスを提供できます。

パーソナライズは、WC_Utilitiesサーバーのwc_domainにアプリケーションとしてインストールされます。クライアント・アプリケーションは、リモートからHTTP経由でRESTfulサービスを使用してパーソナライズにアクセスします。簡単にアクセスできるように、Javaアプリケーションでは、用意されている一連のPOJOクライアント・ライブラリを使用できます。デザインタイムJDeveloperツールを使用してプロパティ・サービスおよびコンダクタのアーティファクトを作成し、それをリモートからRESTコールで実行できます。パーソナライズは、アプリケーションを最初に作成するときに、JDeveloper統合ドメインでパーソナライズ・テクノロジ・ライブラリを含むプロジェクトにも使用できます。評価目的および反復開発において、このドメインはパーソナライズを最もすばやく簡単に探索できる手段です。パーソナライズのアーキテクチャとサービスの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebCenter Portalアプリケーションのパーソナライズに関する項を参照してください。

20.2 開始前の作業: 必要な構成の実行

パーソナライズREST APIは、WebCenter Portal: Spacesを必要とします。この項では、パーソナライズREST APIを使用するために実行する必要がある構成について説明します。

- 第20.2.1項「概要」

- 第20.2.2項「アイデンティティ・アサータの構成」

- 第20.2.3項「WebLogic Server資格証明ストアの構成」

20.2.1 概要

WebCenter PortalのパーソナライズREST APIを使用するには、まず、この項で説明するサーバー側の構成を行う必要があります。2つの異なる構成を行う必要があります。アイデンティティ・アサータを構成し、必要なエントリを資格証明ストアにシードする必要があります。これにより、RESTセキュリティ・トークンが適切に機能するようになります。

これらの構成作業は、WebCenter Portal: Spacesの初回インストール時に行います。まだ行われていない場合は実行してください。

セキュリティ・トークンの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項を参照してください。

20.2.2 アイデンティティ・アサータの構成

REST APIを使用する前に、まずアイデンティティ・アサータを構成する必要があります。手順の詳細は、第29.10項「RESTサービス・アイデンティティ・アサータの構成」を参照してください。

20.2.3 WebLogic Server資格証明ストアの構成

構成の第2ステップとして、WLS資格証明ストアを構成します。資格証明ストアを構成するには、サーバーの実行中に次の各コマンドを実行します。コマンドの実行後にサーバーを再起動する必要はありません。

createCred(map="o.webcenter.jf.csf.map", key="keygen.algorithm",
user="keygen.algorithm", password="AES")
createCred(map="o.webcenter.jf.csf.map", key="cipher.transformation",
user="cipher.transformation", password="AES/CBC/PKCS5Padding")

20.3 パーソナライズのその他の前提条件

次の各項で、パーソナライズのシステム要件と依存性について説明します。

- 第20.3.1項「パーソナライズのインストール要件」

- 第20.3.2項「パーソナライズの構成要件」

- 第20.3.3項「パーソナライズのセキュリティ」

- 第20.3.4項「パーソナライズの制限事項」

- 第20.3.5項「パーソナライズの構成オプション」

20.3.1 パーソナライズのインストール要件

パーソナライズ・コンダクタ・シナリオでCMISデータ・プロバイダ、アクティビティ・グラフ・データ・プロバイダまたはピープル・コネクション・ロケータを使用している場合は、WebCenter Portal: Spacesをインストールする必要があります。高可用性環境にかぎり、Coherenceも必要です。

20.3.2 パーソナライズの構成要件

CMISプロバイダ、アクティビティ・グラフ・プロバイダ、ピープル・コネクション・ロケータまたはカスタム・プロバイダを使用する場合は、これらを第20.5項「プロバイダの構成」の説明に従って構成する必要があります。

SpacesアプリケーションまたはFrameworkアプリケーションでコンテンツ・プレゼンタを使用してコンテンツを表示する場合は、第20.7項「コンテンツ・プレゼンタの構成」の説明に従ってコンテンツ・プレゼンタを構成して、シナリオの結果が表示されるようにする必要もあります。

パーソナライズでは、WebCenter Portalドメイン内の様々な管理対象サーバー間のシングル・サインオン(SSO)を実現するためにトラスト・サービスが使用されます。user_projects/applications/wc_domainディレクトリにあるWLSTスクリプトのconfigureTrustWCPS.pyとconfigureConnectionsWCPS.pyを使用して、トラスト・サービスを構成する必要があります。JDeveloperの統合ドメインの場合は、DefaultDomain/scrpts-wcpsディレクトリにある単一のスクリプト(configureWCPS.py)のみを使用します。このスクリプトによるトラスト・サービスおよびシングル・サインオンの構成の詳細は、第20.8項「シングル・サインオンの構成」を参照してください。

20.3.3 パーソナライズのセキュリティ

パーソナライズは、WLSセキュリティ・レルム内で構成されているどのユーザー認証サービスのソースとも互換性があります。したがって、ドメインのデフォルトのアイデンティティ・ストアおよびポリシー・ストアと資格証明ストアを使用できます。

ピープル・コネクション・ロケータまたはアクティビティ・グラフ・データ・プロバイダを使用している場合、各ユーザーがWebCenter Portal: Spacesユーザーとしても構成されている必要があります。

パーソナライズRESTサービスには、事前構成されたパーソナライズWebアプリケーションを介してアクセスしますが、このアプリケーションはresourceIndexを除くすべてのリソース(すべてのURI)に対して認証アクセスを要求します。これらの制約を変更して、匿名アクセスが必要なシナリオを実行する際のセキュリティを下げたり、新しいシナリオを作成できないようにセキュリティを強化したりできます。デフォルトのセキュリティ設定の変更については、第20.9項「デフォルトのセキュリティ設定のオーバーライド」を参照してください。

WebCenter Portalでは、トラスト・サービスがパーソナライズRESTコールにシングル・サインオンを提供します。このため、WLS TrustServicesIdentityAsserterを構成する必要があります(事前構成されていません)。これは、WLSコンソールを使用するか、user_projects/applications/wc_domainディレクトリにあるWLSTスクリプトのconfigureTrustWCPS.pyとconfigureConnectionsWCPS.pyを使用して手動で実行できます。JDeveloperの統合ドメインの場合は、DefaultDomain/scrpts-wcpsディレクトリにある単一のスクリプト(configureWCPS.py)を使用します。

また、オプションとして、WebCenter Portalアプリケーションとパーソナライズ・サーバーおよびパーソナライズ・プロバイダとの接続をシングル・サインオンで保護することもできます。シングル・サインオンの構成の詳細は、第20.8項「シングル・サインオンの構成」を参照してください。プロパティ・データへのアクセスを事前認証するフィルタ(IPropertyPermission)の使用により、プロパティ・サービス・データへのアクセスをアプリケーションで制限することもできます。

各シナリオでは、基本ロール評価およびテストをサポートするデフォルトの関数ライブラリを使用して、シナリオへのアクセスを認証できます。

20.3.4 パーソナライズの制限事項

デフォルトでは、パーソナライズは管理対象サーバーが有効範囲のキャッシュを使用します。つまり、管理対象サーバー外にキャッシュされたデータに変更が加えられた場合、その変更はパーソナライズの追加インストールには認識されません。パーソナライズのクラスタ化された(複数の)デプロイでは、クラスタを認識するキャッシュに対してCoherenceが構成されます。

20.3.5 パーソナライズの構成オプション

この項では、WebCenter Portalのパーソナライズのデフォルトのプロバイダとその他のオプションの拡張について、およびそれらをパーソナライズ・プロジェクトに統合するために必要な構成について説明します。

デフォルトのパーソナライズ・データ・プロバイダを使用すると、既存のWebCenter Portalサービスに基づいてシナリオを記述したり、プロファイル・データにアクセスしたりできます。これらのWebCenter Portalサービスは、RESTful Webサービスを介してデータを公開します。パーソナライズ・データ・プロバイダは、これらのWebサービスのRESTクライアントとして機能するので、こうした外部データ・リソースに基づくシナリオをJDeveloper内で簡単に作成できます。独自のデータ・プロバイダおよびプロパティ・ロケータの実装を用意して、独自の外部データ・ソースを統合することもできます。

CMISプロバイダ

CMISプロバイダは、パーソナライズ・プロジェクトでオプションのデータ・ソースとして使用できるデフォルトのプロバイダです。WebCenter Portalコンテンツ・サービスは、CMIS (Content Management Interoperability Services)標準を使用して公開されます。CMIS RESTサービスはWC_Spacesサーバー上で稼働し、(別途の構成の選択に基づいて)Oracle WebCenter Content Serverへのアクセスを提供します。

パーソナライズ・ユーザーがSpacesユーザーでもある場合、Spacesアプリケーションによって格納されたユーザー・コンテンツにシナリオからアクセスできます。Content Serverの詳細は、第11章「コンテンツ・リポジトリの管理」を参照してください。CMISプロバイダの構成の詳細は、第20.5.2項「CMISプロバイダの構成」を参照してください。

アクティビティ・グラフ・データ・プロバイダ

アクティビティ・グラフ・データ・プロバイダは、パーソナライズ・プロジェクトでオプションのデータ・ソースとして使用できるデフォルトのプロバイダです。WebCenter Portalアプリケーションからのアクティビティ・ストリーム情報は、アクティビティ・グラフ・サービスを介して公開されます。アクティビティ・グラフRESTサービスはWC_Spacesサーバー上で稼働し、アクティビティ・グラフによって作成された、アクティビティ・ストリームに基づく推奨へのアクセスを提供します。

パーソナライズ・ユーザーがSpacesユーザーでもある場合、(Spacesコンテンツ・タイプの)アクティビティに関する推奨にシナリオからアクセスできます。アクティビティ・グラフ・サービスの詳細は、第12章「アクティビティ・グラフ・サービスの管理」を参照してください。アクティビティ・グラフ・プロバイダの構成の詳細は、第20.5.3項「アクティビティ・グラフ・プロバイダの構成」を参照してください。

Oracle People Connectionsロケータ

ピープル・コネクション・ロケータは、パーソナライズ・プロジェクトでオプションのデータ・ソースとして使用できるロケータです。ピープル・コネクション・サービスの情報は、ピープルWebサービスを介して公開されます。ピープル・コネクションRESTサービスはWC_Spacesサーバー上で稼働し、Spacesアプリケーションのコンテキストに作成されたソーシャル・プロファイル・データへのアクセスを提供します。パーソナライズ・ユーザーがSpacesユーザーでもある場合、ピープル・プロファイル・データにシナリオからアクセスできます。ピープル・コネクション・サービスの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の「ピープル・コネクション・サービスの統合」の章を参照してください。他のデフォルトのデータ・プロバイダと異なり、ピープル・コネクションWebサービスへのアクセスは、汎用のプロパティ・サービス・データ・プロバイダを介してIPropertyLocator拡張インタフェースを使用して行われます。ピープル・コネクション・プロバイダの構成の詳細は、第20.5.4項「Oracle People Connectionsロケータの構成」を参照してください。

20.4 WebCenter OPSSトラスト・サービスの構成

パーソナライズでは、OPSS (Oracle Platform Security Services)の新機能をシングル・サインオンに利用します。パーソナライズの最も単純なユースケースを除くすべてのユースケースで、この機能をここで説明する構成手順に従って有効化する必要があります。

次の場合は、OPSSトラスト・サービスを構成する必要がありません。

- RESTクライアントからコンダクタおよびプロパティ・サービスと直接対話する場合

- コンダクタおよびプロパティ・サービスをパーソナライズ・クライアント・ライブラリが、パーソナライズと同じドメインにデプロイされているカスタムJEE Webアプリケーションから使用している場合で、JSessionIdが両方のWebアプリケーションに対して構成されているとき(多数の例外がログに記録されるのでデバッグが困難になります)

次の場合は、OPSSトラスト・サービスを構成する必要があります。

- パーソナライズのすべての本番デプロイメント

- いずれかのパーソナライズ・シナリオが、デフォルトのデータ・プロバイダ(アクティビティ・グラフ、CMISおよびピープル・コネクション・ロケータ)を必要とする場合

- コンダクタおよびプロパティ・サービスをパーソナライズ・クライアント・ライブラリが、パーソナライズと同じドメインにデプロイされているカスタムJEE Webアプリケーションから使用している場合

- ドメイン間のトラスト(つまり、WC_domainのCMISプロバイダを使用するように構成された統合ドメイン接続)が必要な場合

この項の内容は次のとおりです。

- 第20.4.1項「WebCenter Portalドメインでのトラスト・サービスの構成」

- 第20.4.2項「統合WLSドメインでのトラスト・サービスの構成」

- 第20.4.3項「ドメイン間トラストの構成」

20.4.1 WebCenter Portalドメインでのトラスト・サービスの構成

デフォルトのWebCenter Portalインストールにはパーソナライズ・ドメイン拡張テンプレートが含まれており、このテンプレートは2つのWLST Pythonスクリプト(configureTrustWCPS.pyとconfigureConnectionsWCPS.py)を次のドメイン・ホームにインストールします。

oracle/user_projects/applications/wc_domain/scripts

これらのスクリプトおよび関連するconfigureWCPS.propertiesファイルには、使用方法の説明が記載されています。これらはサンプル・スクリプトであり、実行する前にプロパティ・ファイルを編集して、少なくともocs.server名(通常はContent Server)、spaces.server.host名およびfmwconfig.locationを指定する必要があります。これらの値はWebCenter Portalインストールごとに一意のものなので、編集する必要があります。それ以外の値もローカル環境に応じて変更が必要な場合があります(たとえば、マシン・ポート番号はそれぞれ異なる可能性があります)。

configureConnectionsWCPS.pyスクリプトは、デフォルトのパーソナライズ接続情報(つまり、アクティビティ・グラフ、CMISおよびピープル・コネクションの接続情報)を設定します。このスクリプトはWCPS.pyライブラリを使用しますが、このライブラリはWebCenter Portalドメインにのみインストールされています(統合WLSドメインにはインストールされていません)。ただし、WebCenter PortalドメインでconfigureConnectionsWCPS.pyを実行して、(t3 URLを使用して)統合WLSドメインを指すようにさせることができます。

注意:

configureTrustWCPS.pyによって設定されるトラスト・サービスの構成は、リモートから適用しないでください。このスクリプトは、WebCenter Portalドメイン(wc_domain)からのみ実行してください。

oracle/as11gr1wc/common/bin/wlst.shコマンド・ファイルを使用して、環境変数を正しく設定する必要があります(as11gr1wcスクリプトの場合)。

各スクリプトを実行したら、ドメイン内の全サーバーを再起動します。

構成のテスト

トラスト・サービスのシングル・サインオンの動作を確認するには、カスタムJEE Webアプリケーションから(パーソナライズ・クライアント・ライブラリを使用して)コンダクタまたはプロパティ・サービスを呼び出すか、パーソナライズ接続(アクティビティ・グラフまたはCMISデータ・プロバイダなど)を使用するシナリオを実行するか、ピープル・コネクション・ロケータを使用してピープル・コネクションのプロパティにアクセスする必要があります。

前述のいずれかを実行すると、次のようなデフォルトのログ・エントリがWC_Utilities-diagnostic.logに記録されます。

[2010-11-10T07:30:40.362-08:00] [WC_Utilities] [NOTIFICATION] [] [oracle.jps.trust] [tid: [ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default (self-tuning)']
[ecid: 0000IkqQG4NBh49LJeCCyf1CqfXw000008,0] [APP: wcps-services#11.1.1.4.0] Token issue operation

また、WC_Spaces-diagnostic.logにも次のようなデフォルトのログ・エントリが記録されます(そこでサービスにアクセスしている場合)。

[2010-11-10T07:30:40.236-08:00] [WC_Spaces] [NOTIFICATION] [] [oracle.jps.trust] [tid: [ACTIVE].ExecuteThread: '1' for queue: 'weblogic.kernel.Default (self-tuning)']
[ecid: d461d36d4a552b90:-1fe62a5d:12c365bb19b:-8000-000000000000002c,0] [APP: webcenter#11.1.1.4.0] Token validate operation.

20.4.2 統合WLSドメインでのトラスト・サービスの構成

JDeveloperインストーラには、次のディレクトリにある統合WLSドメインを構成するための別のPythonスクリプトも付属しています。

DefaultDomain\scrpts-wcps\

このスクリプトは、手動でもJDeveloperの外部スクリプトの実行機能を使用しても実行できます。

デフォルト以外のユーザーまたはパスワードを使用している場合は、プロパティ・ファイルを編集してください。統合WLSドメインを作成して起動したら、scrpts-wcpsディレクトリからスクリプトを実行します。

Oracle\MiddlewareRC8\oracle_common\common\bin\wlst.cmd configureWCPS.py configureWCPS.properties

統合WLSドメインを再起動します。

構成のテスト

トークン発行操作およびトークン検証操作を確認するには、デフォルトのロギング・レベルでは不十分です。JDeveloperの「Oracle Diagnostic Loggingの構成」機能を使用し、oracle.jps.trustログ出力に移動して、レベルを「最も詳細」に設定します。コンダクタまたはプロパティ・サービスを呼び出すカスタムJEE Webアプリケーションを含むシナリオを実行します。

20.4.3 ドメイン間トラストの構成

トラスト・サービスはドメイン間トラストをサポートしています。つまり、複数の異なるWLSドメインにキーストアが作成されている場合、クライアントはドメイン「A」でトークンを割り当て、そのトークンを使用したHTTPリクエストをドメイン「B」に対して発行し、シングル・サインオンによるドメイン「B」でのユーザー/リクエストの検証および認証をアイデンティティ・アサータに実行させることができます。ただし、重要な前提として、ドメイン「A」内のユーザーと同じユーザーがドメイン「B」に存在する必要があります。

デフォルトでは、統合WLSドメインでconfigureWCPS.pyスクリプトを実行すると、extDomain.cerという名前の証明書が生成されます。統合WLSドメインとWebCenter Portalドメインの間のドメイン間トラストを有効にする手順は次のとおりです。

extDomain.cerをWebCenter Portalドメイン(wc_domain)インストールにコピーして、そこでインポートします。extDomain.cerファイルをscriptsディレクトリにコピーします。

oracle/user_projects/applications/wc_domain/scripts

次のコマンドを入力して証明書をインポートします。

keytool -importcert -alias orakey1 -file extDomain.cer -keystore ../../../../wlserver_10.3/wc_domain/config/fmwconfig/default-keystore.jks -storepass weblogic

WebCenter Portalドメイン内の各サーバーを再起動します。

構成のテスト

ドメイン間トラストを検証する最も簡単な方法は、まず、WebCenter PortalドメインのWC_Spacesサーバーを指すピープル・コネクション・パーソナライズ接続を統合WLSドメインに作成します。次に、ピープル・コネクションのプロパティ値を取得する簡単なシナリオを作成して、統合WLSドメインにデプロイします。最後に、前述の「トークン検証操作」というメッセージがWC_Spacesサーバーのログに記録されていることを確認します。

20.5 プロバイダの構成

WebCenter Portalのパーソナライズには、アクティビティ・グラフ用およびContent Server用のデフォルトのプロバイダと、ピープル・コネクション用のロケータが用意されています。これらのプロバイダのいずれかを使用するシナリオでは、次の各項の説明に従って、WLSTスクリプトのconfigureWCPY.pyを使用してプロバイダを構成する必要があります。カスタムのプロバイダまたはロケータを使用している場合は、カスタム・プロバイダの構成に関する項の説明に従って、それらも構成する必要があります。シナリオでプロバイダやロケータを使用していない場合は、プロバイダやロケータを構成する必要はありません。

デフォルトのプロバイダを使用しないシナリオや、カスタムのプロバイダまたはOTNからダウンロードしたプロバイダのみを使用するシナリオも開発できます。また、JDeveloper統合ドメイン内のみで開発する場合は、通常、これらのWC_Spacesベースのサービスにはアクセスできません(WebCenter Portal: Spacesは統合ドメイン内では稼働しないため)。拡張構成(configureWCPS.pyでもサポートされています)を使用すれば、WC_Spacesドメイン内のWebCenter Portal: Spacesサービスに統合ドメインのパーソナライズ・サーバーからアクセスできます。これにはドメイン間トラストを使用するので、プロバイダ接続を構成する必要があります。WC_Spacesドメイン内にあるconfigureTrustWCPS.pyスクリプトとconfigureConnectionsWCPS.pyスクリプトを使用するか、DefaultDomain/scrpts-wcpsドメイン・ディレクトリにあるJDeveloperの統合WLSドメイン用のconfigureWCPS.pyスクリプトを使用して、適切なWLS管理サーバーをポイントすることにより、対応するドメインを構成します。

- 第20.5.1項「プロバイダ接続設定の作成または変更」

- 第20.5.2項「CMISプロバイダの構成」

- 第20.5.3項「アクティビティ・グラフ・プロバイダの構成」

- 第20.5.4項「Oracle People Connectionsロケータの構成」

- 第20.5.5項「カスタム・プロバイダの構成」

20.5.1 プロバイダ接続設定の作成または変更

この項では、WLST、JConsole、Fusion Middleware Controlを使用して、wcps-connections.xmlに格納されている接続情報を作成または変更する方法について説明します。また、カスタム構成クラスを記述してカスタム・プロバイダを構成する方法についても説明します。

この項の内容は次のとおりです。

- 第20.5.1.1項「パーソナライズ接続情報の概要」

- 第20.5.1.2項「接続構成の属性」

- 第20.5.1.3項「WLSTを使用した接続の構成」

- 第20.5.1.4項「JConsoleを使用した接続の構成」

- 第20.5.1.5項「Fusion Middleware Controlを使用した接続の構成」

- 第20.5.1.6項「カスタム構成クラスの記述」

20.5.1.1 パーソナライズ接続情報の概要

パーソナライズ接続情報は、ドメイン・ディレクトリ内の次の場所にあるwcps-connections.xmlに保持されています。

<domain directory>/config/fmwconfig/wcps-connections.xml

このファイルを直接編集することはお薦めできませんが、接続情報を変更するには、次のように複数の方法があります。

- WLST: WLSTコマンドを使用してスクリプトを作成することにより、接続構成を表すシステムMBeansにアクセスできます。WLSTコマンドを使用して接続設定を構成する方法の詳細は、第20.5.1.3項「WLSTを使用した接続の構成」を参照してください。

- JConsole: JConsoleを使用して接続JMX MBeansを作成または編集することにより、接続構成を表示または編集できます。JConsoleを使用して接続設定を構成する方法の詳細は、第20.5.1.4項「JConsoleを使用した接続の構成」を参照してください。

- Fusion Middleware Control: Fusion Middleware Controlを使用して、パーソナライズとともにデプロイされたJMX MBeansを表示または編集できます。Fusion Middleware Controlを使用して接続設定を構成する方法の詳細は、第20.5.1.5項「Fusion Middleware Controlを使用した接続の構成」を参照してください。

20.5.1.2 接続構成の属性

wcps-connections.xmlに保持されている接続プロパティおよび接続属性で、WLST、JConsoleまたはFusion Middleware Controlを使用して変更できるものを次に示します。各接続プロパティは、接続に使用されるプロバイダまたはロケータに固有のものです。たとえば、CMISプロバイダでは、アクティビティ・グラフ・プロバイダとは異なる接続プロパティが使用されます。

- <connection-name>: この接続の一意の名前。接続は名前によって取得できます。

- <connection-type>: この接続の一意のタイプ。接続はタイプによって取得できます。connection-typeを指定する必要があるのは、カスタム接続の場合のみです。デフォルトのデータ・プロバイダの場合、このフィールドは内部的に設定されています。

- <namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。WLSTスクリプト内で指定されない場合、namespaceのデフォルトは「*」になります。

- <name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数が定義されている場合)。複数の接続の「isDefault」フラグをtrueに設定できます。この場合、どのデフォルト接続を返すかは個々のプロバイダ次第です。

20.5.1.3 WLSTを使用した接続の構成

プロバイダ接続を簡単に構成できるように、一連のパーソナライズWLSTコマンドが用意されています。これらのコマンドを組み合せてスクリプトを作成できます。スクリプトの例が用意されおり、これをカスタマイズしたり、直接使用したりできます。このサンプル・スクリプトは、プロバイダ接続を設定し、さらにトラスト・サービスを初期化します。

パーソナライズWLSTコマンドはoracle/as11gr1wc/common/wlst/WCPS.pyにインストールされており、oracle/as11gr1wc/common/bin/wlst.sh(cmd)スクリプトを使用して呼び出します。

デフォルトの各データ・プロバイダは、次の各項で説明する特定のWLSTコマンドでサポートされています。カスタムのデータ・プロバイダについては、汎用のWLSTコマンドを使用して接続を構成します。次に例を示します。

createWCPSCustomConnection('customConnectionName', 'connectionType', properties={ 'name1': 'value1', 'name2': 'value2' })

パーソナライズWLST接続およびその他のコマンドの全リストは、Oracle Fusion Middleware WebLogicスクリプト・ツール・コマンド・リファレンスのパーソナライズに関する項を参照してください。

20.5.1.4 JConsoleを使用した接続の構成

$JAVA_HOME/jdk6/bin/jconsoleにあるJConsoleを使用して、WebCenter PortalのパーソナライズとともにデプロイされたJMX MBeans(アクティビティ・グラフ、CMISおよびピープル・コネクションの接続構成MBeans)を作成、表示または編集できます。これらの作業について、次の各項で説明します。

- 第20.5.1.4.1項「JConsoleを使用した新規接続の作成」

- 第20.5.1.4.2項「JConsoleを使用した接続設定の編集」

20.5.1.4.1 JConsoleを使用した新規接続の作成

接続を作成する手順は次のとおりです。

1. 次に示すようにJConsoleを起動します。

jconsole -J-Djava.class.path=$JAVA_HOME/lib/jconsole.jar:$JAVA_HOME/lib/tools.jar:$ORACLE_HOME/oracle/wlserver_10.3/server/lib/wljmxclient.jar  -J-Djmx.remote.protocol.provider.pkgs=weblogic.management.remote

2. JConsole Remote Connectionを開きます。

service:jmx:iiop://example.com:7001/jndi/weblogic.management.mbeanservers.domainruntime
Username: weblogic
Password: welcome1

3. oracle.wcps.connectionsの下のツリーで、「ConnectionConfiguration」に移動し、「操作」を選択します。

4. 「addConnection」をクリックし、「Namespace」、「タイプ」および「名前」を入力します。
これらの接続は、デフォルトのプロバイダについては、configureConnectionsWCPS.py scriptを使用して事前定義されています。

20.5.1.4.2 JConsoleを使用した接続設定の編集

接続設定を表示または編集する手順は次のとおりです。

1. 次に示すようにJConsoleを起動します。

jconsole -J-Djava.class.path=$JAVA_HOME/lib/jconsole.jar:$JAVA_HOME/lib/tools.jar:$ORACLE_HOME/oracle/wlserver_10.3/server/lib/wljmxclient.jar  -J-Djmx.remote.protocol.provider.pkgs=weblogic.management.remote

2. JConsole Remote Connectionを開きます。

service:jmx:iiop://example.com:7001/jndi/weblogic.management.mbeanservers.domainruntime
Username: weblogic
Password: welcome1

3. プロバイダの接続プロパティを変更します。たとえば、アクティビティ・グラフのホスト名を変更する手順は次のとおりです。

1. 次のツリーを開きます。

oracle.wcps.connections->ConnectionConfiguration.Namespace.Connection->default->activity.provider.connection->ConnectionConfiguration->wcps-services->ActivityGraphConfigConnection->Attributes

2. 「プロパティ」をクリックします。

3. 右側のパネルで、先頭行の値をダブルクリックします。
これで、コンポジット・ナビゲーションを使用して現在の値をスクロールできます。

4. ホストの値を変更するには、ナビゲーション・ツリーで「プロパティ」をクリックし、名前と新しい値を入力して、「setProperty」をクリックします。

20.5.1.5 Fusion Middleware Controlを使用した接続の構成

Fusion Middleware Controlを使用して、WebCenter PortalのパーソナライズとともにデプロイされたJMX MBeans(アクティビティ・グラフ、Content Serverおよびピープル・コネクションの接続構成MBeans)を表示または編集できます。

接続構成MBeansを表示または編集する手順は次のとおりです。

1. Fusion Middleware Controlを開き、「パーソナライズ・サービス(Personalization Services)」に移動します。

2. 「WCPS-Services」をクリックします。

3. 「アプリケーション開発」ドロップダウン・メニューから「システムMBeanブラウザ」を選択します。

4. 「アプリケーション定義のMBean」の下の「MBeanブラウザ」でoracle.wcps.connectionsを選択し、変更する接続情報までドリルダウンします。

5. 「属性」タブで、「プロパティ」を選択して接続属性の現在の値を表示します。

6. 「操作」タブで、「setProperty」を選択し、「起動」をクリックして名前/値ペアを変更します。

20.5.1.6 カスタム構成クラスの記述

カスタム構成クラス(@ConnectionConfigurationという注釈付きのクラス)を実装するには、独自のデータ・プロバイダを記述します。これにより、カスタム・データ・プロバイダがパーソナライズ接続フレームワークを使用して、パーソナライズWLSTスクリプトによって構成された接続情報を取得できるようになります。

データ・プロバイダのカスタム構成クラスの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のカスタム・データ・プロバイダに関する項を参照してください。

20.5.2 CMISプロバイダの構成

統合WLSドメイン以外(つまり、WC_Spacesドメイン内)で作業している場合、CMISプロバイダをシナリオで使用するには、まずその接続設定を構成する必要があります。

CMISプロバイダの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第20.5.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、CMISプロバイダの接続設定を構成してください。

接続要素およびプロパティの説明

<connection-name>: この接続の一意の名前。接続は名前によって取得できます。

<namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。

<name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数の接続が定義されている場合)。

<name>repositoryId</name>: 使用環境内のコンテンツ・リポジトリと一致するように、このプロパティを変更する必要があります。

<name>path</name>: 使用環境内のコンテンツ・リポジトリと一致するように、このプロパティを変更する必要があります。指定しない場合のデフォルトは/api/cmis/repository/repositoryIdです。

<name>scheme</name>: CMIS RESTサービスにアクセスするプロトコル(HTTPまたはSSL用のHTTPS)。明示的に指定しない場合、デフォルトはHTTPに設定されています。

<name>host</name>: CMIS RESTサービスをホストするマシンの名前。これは、WC_Spaces管理対象サーバーのマシン名です。

<name>port</name>: CMIS RESTサービスをホストするマシンのポート番号。これは、WC_Spaces管理対象サーバーのマシンのポート番号です。

<name>pathTrim</name>: 明示的に指定しない場合のデフォルトは切捨てなしです。

<name>rewriteUrls</name>: 「なし」、「コンシューマ」または「プロデューサ」に設定できます。詳細は、RESTプロキシのページを参照してください。ドキュメント・リンクのCMISサーバーからのダイレクトURLが必要な場合、これを「なし」に設定します。デフォルトはリライトなし(「なし」)です。

<name>username</name>: (オプション) CMIS RESTサービスとの接続時に使用するユーザー名。固定のユーザー名への接続を強制するために使用できます。

<name>password</name>: (オプション) CMIS RESTサービスとの接続時に使用するパスワード。usernameと組み合せて使用されます。固定のユーザー名/パスワードへの接続を強制するために使用できます。パスワード・アクセスが保護されていないため、開発環境外で使用することはお薦めしません。

<name>timeoutInMillisecs</name>: CMIS問合せ読取りレスポンスがタイムアウトになるまでの時間(ミリ秒)。

<name>propagateTimeoutExceptions</name>: trueの場合、タイムアウト例外を伝播します。それ以外の場合は、例外をログに記録し、CMIS問合せレスポンスに対してNULLを返します。

20.5.3 アクティビティ・グラフ・プロバイダの構成

統合WLSドメイン以外(つまり、WC_Spacesドメイン内)で作業している場合、アクティビティ・グラフ・プロバイダに基づくシナリオを使用するには、ローカル環境に応じた接続情報を構成する必要があります。

アクティビティ・グラフの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第20.5.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、アクティビティ・グラフ・プロバイダの接続設定を構成してください。

接続要素およびプロパティの説明

<connection-name>: この接続の一意の名前。接続は名前によって取得できます。

<namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。

<name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数の接続が定義されている場合)。

<name>scheme</name>: CMIS RESTサービスにアクセスするプロトコル(HTTPまたはSSL用のHTTPS)。明示的に指定しない場合、デフォルトはHTTPに設定されています。

<name>host</name>: アクティビティ・グラフRESTサービスをホストするマシンの名前。これは、WC_Spaces管理対象サーバーのマシン名です。

<name>port</name>: アクティビティ・グラフRESTサービスをホストするマシンのポート番号。これは、WC_Spaces管理対象サーバーのマシンのポート番号です。

<name>rewriteUrls</name>: 「なし」、「コンシューマ」または「プロデューサ」に設定できます。詳細は、RESTプロキシのページを参照してください。ドキュメント・リンクのCMISサーバーからのダイレクトURLが必要な場合、これを「なし」に設定します。デフォルトはリライトなし(「なし」)です。

<name>user</name>: (オプション)アクティビティ・グラフRESTサービスとの接続時に使用するユーザー名。

<name>password</name>: (オプション)アクティビティ・グラフRESTサービスとの接続時に使用するパスワード。usernameと組み合せて使用されます。固定のユーザー名/パスワードへの接続を強制するために使用できます。パスワード・アクセスが保護されていないため、開発環境外で使用することはお薦めしません。

<name>restResourceIndex</name>: RESTリソース索引のhost/portの後ろに追加するURI接尾辞(例: '/rest/api/resourceIndex')

20.5.4 Oracle People Connectionsロケータの構成

統合WLSドメイン以外(つまり、WC_Spacesドメイン内)で作業している場合、ピープル・コネクション・ロケータに基づくシナリオを使用するには、ローカル環境に応じた接続情報を構成する必要があります。

プロパティ・サービスでは、ピープル・コネクション・サービスとの接続にIPropertyLocator (ピープル・コネクションILocator)が使用されます。ピープル・コネクション・サービスと接続するプロパティ・プロバイダは、このILocatorを使用して特定のユーザー(または自身)に対するPC RESTコールを行い、そのRESTサービス・コールが表すPersonオブジェクトを返します。Personの各属性は、そのWebCenter Portalプロファイルの各値を表します。

ピープル・コネクションILocatorの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第20.5.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、ピープル・コネクションILocatorの接続設定を構成してください。

接続要素およびプロパティの説明

<connection-name>: この接続の一意の名前。接続は名前によって取得できます。

<namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。

<name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数が定義されている場合)。

<name>scheme</name>: CMIS RESTサービスにアクセスするプロトコル(HTTPまたはSSL用のHTTPS)。明示的に指定しない場合、デフォルトはHTTPに設定されています。

<name>host</name>: PC RESTサービスをホストするマシンの名前。これは、WC_Spaces管理対象サーバーのマシン名です。

<name>port</name>: PC RESTサービスをホストするマシンのポート番号。これは、WC_Spaces管理対象サーバーのマシンのポート番号です。

<name>user</name>: (オプション)ピープル・コネクションRESTサービスとの接続時に使用するユーザー名。固定のユーザー名への接続を強制するために使用できます。

<name>password</name>: (オプション)ピープル・コネクションRESTサービスとの接続時に使用するパスワード。usernameと組み合せて使用されます。固定のユーザー名/パスワードへの接続を強制するために使用できます。パスワード・アクセスが保護されていないため、開発環境外で使用することはお薦めしません。

<name>restResourceIndex</name>: PC RESTサービスのhost/portの後ろに追加され、resourceIndex (使用可能なRESTサービス)ページの位置を指します(例: '/rest/api/resourceIndex')。

プロパティ・プロバイダへのPersonクラスのブートストラップ

プロパティ・サービスがピープル・コネクションRESTコールの結果を認識して使用するためには、「Person」を認識する必要があります。つまり、「Person」をインスタンス化してそのプロパティを設定する前に、「Person」プロパティ・セット定義を作成するとともに、その個々の属性をプロパティ定義として設定する必要があります。

ピープル・コネクションILocatorのコードでは、このプロセスを、次の例のようにweb.xmlファイルで構成されているサーブレット・リスナーでブートストラップして実行してします。

<?xml version="1.0" encoding="UTF-8" ?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">

<!-- Allows connection config classes to be loaded from the connections.xml file -->
<listener>
<listener-class>oracle.wcps.connection.lifecycle.VersatileModuleLifecycleCallback</listener-class>
</listener>

<listener>
<listener-class>oracle.wcps.people.util.BootstrapPropertiesListener</listener-class>
</listener>

</web-app>

PC REST接続の構成情報へのアクセス

ピープル・コネクションILocatorは実際の「プロバイダ」ではないため、アクティビティ・グラフなどのように、プロバイダ・コード内のその接続情報にはアクセスできません。そのかわりに、内部コードではVersatileModuleLifecycleCallbackを使用して、その構成情報を使用できるようにしています。したがって、これはweb.xmlで必ず構成する必要があるリスナーとなります。このリスナーがアクティブ化されたら、コードで接続情報にアクセスするコールを行い、ILocatorコードをパラメータ化してPC RESTサーバーを指すことができます。

PC ILocatorとプロパティ・サービス・プロバイダの接続

プロパティ・サービス・プロバイダ(PSP)は、ピープル・コネクションILocatorをネームスペースによって認識します。前述のブートストラップ・プロセスでは、PropertySetDefinition (とその定義)に「people.connections.person」およびロケータ・クラス「oracle.wcps.people.property.PeoplePropertyLocator」というネームスペースが指定されています。PSPの使用時に、namespaceとPropertySetDefinitionがPSPに渡されます。PSPは、PropertySetDefinitionで定義されているロケータ・クラスを使用してインスタンス化し、プロパティ値(ピープル・コネクションRESTサービスからのPersonの値)に委譲します。

このプロセスではロケータとネームスペースが非常に重要です。これらは、内部クラスPropertyDefConstantsで定数として定義されています。これらを構成する必要はありません。

20.5.5 カスタム・プロバイダの構成

アクティビティ・グラフの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第20.5.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、カスタム・プロバイダの接続設定を構成してください。構成ファイルの要素とプロパティの詳細は、第20.5.1.2項「接続構成の属性」を参照してください。

20.6 Coherenceの構成

インストールでCoherenceを使用してキャッシュしている場合(「高可用性」環境の要件)、ネームスペース、プロパティ定義、プロパティ・セット定義およびプロパティ・セットに対して1つずつ、計4つのキャッシュを個別に設定する必要があります。

次のサンプルwcps-cache-config.xml構成ファイルは、単純なCoherenceローカル・キャッシュの構成方法を示しています。より高度なキャッシュ・タイプについては、Coherenceのドキュメントを参照してください。Coherenceの各クラスは、パーソナライズと同じクラス・ローダーによってアクセスできる必要があります。Coherenceのwcps-cache-config.xmlファイルも同じクラス・ローダーによってアクセスできる必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal Java APIリファレンスのWebCenter PortalのJavaDocでoracle.wcps.cache.CacheFactoryクラスを参照してください。

<?xml version="1.0" encoding="UTF-8" ?>
<cache-config>
<caching-scheme-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.namespaces</cache-name>
<scheme-name>ns-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.propertydefinitions_*</cache-name>
<scheme-name>pd-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.propertysetdefinitions_*</cache-name>
<scheme-name>psd-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.propertysets_*</cache-name>
<scheme-name>ps-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>*</cache-name>
<scheme-name>properties-default-local</scheme-name>
</cache-mapping>
</caching-scheme-mapping>

<caching-schemes>
<!--
The following schemes are all local.  For a clustered deployment,
a distributed, replcated, or other clustered scheme is recommended.
See Coherence documentation for more information.
-->

<local-scheme>
<scheme-name>ns-local-side</scheme-name>
<service-name>NamespaceCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>pd-local-side</scheme-name>
<service-name>PropertyDefinitionCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>psd-local-side</scheme-name>
<service-name>PropertySetDefinitionCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>ps-local-side</scheme-name>
<service-name>PropertySetCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>properties-default-local</scheme-name>
<service-name>DefaultCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

</caching-schemes>

</cache-config>

20.7 コンテンツ・プレゼンタの構成

コンテンツ・プレゼンタを使用してWebCenter Portalのパーソナライズ・シナリオを実行するには、まず接続ファイル(connections.xml)を構成して、コンテンツ・プレゼンタがコンダクタ・サーバーおよびタグ付きシナリオを認識できるようにする必要があります。コンテンツ・プレゼンタの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタによるコンテンツの公開に関する項を参照してください。

connections.xmlには、WebCenter Portal側で使用するアプリケーションの接続情報が格納されています。コンテンツ・プレゼンタは、このファイルに登録されているURL接続の全リストを取得し、「Conductor」で始まるURL接続を、コンダクタ・サーバーを指すURLとみなします。connections.xmlの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の付録A「WebCenter Portal: Frameworkアプリケーションのファイル」を参照してください。

コンテンツ・プレゼンタ・タスク・フローの構成は、実行時に行うか、コンテンツ・プレゼンタ・タスク・フローをページに追加するときにJDeveloperから行うことができます。コンテンツ・プレゼンタのこの2種類の構成方法と、コンダクタ側の構成要件について、次の各項で説明します。

- 第20.7.1項「WebCenter PortalアプリケーションのContent Server接続の構成」

- 第20.7.2項「コンテンツ・プレゼンタ・タスク・フローのパラメータの構成」

- 第20.7.3項「コンダクタのシナリオ・タグの構成」

20.7.1 WebCenter PortalアプリケーションのContent Server接続の構成

WebCenter Portalアプリケーションでは、JDeveloperを使用してURL接続を設定するか、第20.7.2項「コンテンツ・プレゼンタ・タスク・フローのパラメータの構成」の説明に従ってコンテンツ・プレゼンタ・タスク・フローのパラメータを設定します。WebCenter Portal: Spacesでは、WLSTコマンドまたはFusion Middleware Controlのいずれかを使用して接続を構成できます。

この項の内容は次のとおりです。

- 第20.7.1.1項「WLSTを使用したSpacesアプリケーションの接続の構成」

- 第20.7.1.2項「Fusion Middleware Controlを使用したSpacesアプリケーションの接続の構成」

20.7.1.1 WLSTを使用したSpacesアプリケーションの接続の構成

Spacesアプリケーションでは、WLSTコマンドのadf_createHttpURLConnectionを使用してURL接続を管理できます。次に例を示します。

adf_createHttpURLConnection('webcenter','Conductor','http://example.com:8891/wcps/api/conductor?namespace=CP_namespace&

adf_createHttpURLConnectionコマンドの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のadf_createHttpURLConnectionに関する項を参照してください。

20.7.1.2 Fusion Middleware Controlを使用したSpacesアプリケーションの接続の構成

Spacesアプリケーションでは、Fusion Middleware Controlを使用して接続を構成できます。

Fusion Middleware Controlを使用して接続を構成する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「ADF」→「ADF接続の構成」を選択します。
「ADF接続構成」ページが表示されます(図20-1を参照)。

図20-1 「ADF接続構成」ページ

「図20-1 「ADF接続構成」ページ」の説明

3. 「接続タイプ」を「URL」に設定し、「接続名」に「Conductor」と入力して、「接続の作成」をクリックします。
「URL接続」セクションが表示されます(図20-2を参照)。

図20-2 「ADF接続構成」ページ(URL接続)

「図20-2 「ADF接続構成」ページ(URL接続)」の説明

4. 「編集」(鉛筆)アイコンをクリックします。
「URL接続」ダイアログが表示されます(図20-3を参照)。

図20-3 「URL接続」ダイアログ

「図20-3 「URL接続」ダイアログ」の説明

5. URLを編集して、Spacesアプリケーションが使用するContent ServerインスタンスをURLが指すようにします。次に例を示します。

http://example.com:8891/wcps/api/conductor?namespace=CP_namespace&repoId=myhost-ucm11g

6. 必要に応じて、その他のフィールドをローカル接続に合わせて更新し、「OK」をクリックします。

20.7.2 コンテンツ・プレゼンタ・タスク・フローのパラメータの構成

コンテンツ・プレゼンタのインスタンスは、そのタスク・フロー・パラメータによって構成できます。これらのパラメータは、実行時に「コンテンツ・プレゼンタ構成」ダイアログで設定するか、コンテンツ・プレゼンタ・タスク・フローの追加時にJDeveloperから設定できます。これを手動で行うには、2つのパラメータを設定する必要があります。Data Source TypeパラメータをdsTypeScenarioResultsに設定し、Data Sourceパラメータを次のように設定してください。

conductor-connection-name=ConductorConnectionName,namespace=
ScenarioNamespace,scenario-name=ScenarioName,inputparam1=value1,inputparam2=value2

conductor-connection-nameの値は、有効なコンダクタ・サーバーを指すURL接続と一致する必要があります。また、使用するネームスペースには、指定のシナリオが属しているネームスペースの名前を指定してください。最後に、シナリオで要求される任意の入力パラメータを追加できます。それには、前述のように名前/値ペアをカンマで区切って指定します。

パーソナライズ用のコンテンツ・プレゼンタの構成の詳細は、次の項を参照してください。

- 実行時に構成する場合: Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタ・タスク・フローのプロパティ設定に関する項

- JDeveloperで構成する場合: 『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のコンテンツ・プレゼンタ・タスク・フロー・パラメータおよび初期設定の表示テンプレートに関する項

20.7.3 コンダクタのシナリオ・タグの構成

コンダクタ側では、シナリオをコンテンツ・プレゼンタに認識させるための適切なタグがシナリオに必要です。コンテンツ・プレゼンタでは、ContentPresenterScenarioというタグを使用します。したがって、コンテンツ・プレゼンタに認識させる必要があるシナリオはすべて、このタグの関連付けが必要です。

コンダクタ側とWebCenter Portalアプリケーション側の両方ですべての設定が完了したら、後は簡単です。「コンテンツ・プレゼンタ構成」ダイアログを開くと、「コンテンツ・ソース」選択リストに「シナリオ結果」が表示されます。これを選択すると、コンテンツ・プレゼンタを使用するようにタグ付けされているすべてのシナリオが表に表示されます。最初のシナリオが必ず選択されており、そのシナリオに入力パラメータが定義されている場合は、入力パラメータが表の下に入力フィールドとともに表示されます。

表で別のシナリオを選択すると、下の入力パラメータが更新されます。シナリオを選択して入力パラメータを指定したら、コンテンツ・プレゼンタをプレビューまたは保存して結果を取得できます。結果は、他の複数値コンテンツ・ソースと同様に表示されます。最終的には、表示用に選択したテンプレートに基づいて表示されます。

注意:

シナリオから返され、コンテンツ・プレゼンタ内で使用される結果は、有効なCMIS問合せであることが必要です。コンテンツ・プレゼンタは戻り値を取得し、それを(CMIS問合せとして)コンダクタURL内で指定されているリポジトリに対して実行するからです。

20.8 シングル・サインオンの構成

シングル・サインオンの構成は、configureTrustWCPS.pyスクリプトとconfigureConnectionsWCPS.pyスクリプトを実行してWebCenter Portalドメインを構成する一環として行われるか、またはconfigureWCPS.pyスクリプトを実行してJDeveloperの統合WLSドメインを構成する一環として行われます。これらのスクリプトを実行すると、トラスト・サービス・シングル・サインオンも設定されます。これにより、クライアントJEE Webアプリケーション、パーソナライズWebアプリケーション、およびデフォルトのデータ・プロバイダで使用されるWC_Spaces WebアプリケーションRESTサービスの間でREST HTTPリクエストのシングル・サインオンが可能になります。これらのWebCenter Portalアプリケーションはすべて、OAM/OSSOが提供するシングル・サインオン・トークンもサポートするように構成されます。追加のパーソナライズ固有の構成は必要ありません。詳細は、第20.4.3項「ドメイン間トラストの構成」を参照してください。

20.9 デフォルトのセキュリティ設定のオーバーライド

デフォルトでは、パーソナライズRESTリソース(resourceIndexを除く)へのすべてのアクセスには認証が要求されます。ほとんどの場合、開発用にはこれで十分です。ただし、本番環境では、このデフォルトのセキュリティ制約を変更する場合があります。次の各項では、匿名アクセスが必要なシナリオを実行する際のセキュリティを下げる方法や、新しいシナリオを作成できないようにセキュリティを強化する方法について説明します。

この項の内容は次のとおりです。

- 第20.9.1項「シナリオの匿名実行の許可」

- 第20.9.2項「匿名ユーザーによるシナリオの作成の禁止」

- 第20.9.3項「認証されたユーザーによるシナリオの作成の禁止」

20.9.1 シナリオの匿名実行の許可

次のセキュリティ制約をドメインのconductor-extensions-library\WEB-INF\web.xmlファイルに追加すると、デフォルトの記述子の(認証を要求する)セキュリティを遵守しながら、匿名のアプリケーションまたはネームスペースから作成またはデプロイされたシナリオに対する匿名GET/POSTが許可されます。

<security-constraint>
<web-resource-collection>
<web-resource-name>ConductorJerseyWebApplication</web-resource-name>
<url-pattern>/api/conductor/namespaces/anonymous/scenarios/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<!-- Allow anonymous user access&nbsp; in this namespace -->
<!--auth-constraint>
<role-name>Users</role-name>
</auth-constraint-->
</security-constraint>

20.9.2 匿名ユーザーによるシナリオの作成の禁止

簡単なフィルタをドメインのconductor-extensions-library\WEB-INF\web.xmlに追加することで、匿名ユーザーに対してシナリオの作成を禁止できます。フィルタの例(AnonymousScenarioFilter)を次に示します。

<filter>
<filter-name>AnonymousScenarioFilter</filter-name>
<filter-class>oracle.wcps.samples.AnonymousScenarioFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>AnonymousScenarioFilter</filter-name>
<url-pattern>/api/conductor/namespaces/PublicPersonalization/scenarios</url-pattern>
</filter-mapping>
<security-constraint>
<web-resource-collection>
<web-resource-name>ConductorJerseyWebApplication</web-resource-name>
<url-pattern>/api/conductor/namespaces/PublicPersonalization/scenarios/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<!--
Commented out to allow anonymous user access  in this namespace
<auth-constraint>
<role-name>Users</role-name>
</auth-constraint>
-->
</security-constraint>

このフィルタは、匿名ユーザーでないかどうか(httpRequest.getUserPrincipal() == null)、およびシナリオを作成するRESTリソースのURL (/api/conductor/namespaces/PublicPersonalization/scenarios)に対するHTTP POST操作でないかどうかを明示的にチェックします。

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException
{
if (request instanceof HttpServletRequest)
{
HttpServletRequest httpRequest = (HttpServletRequest)request;
String method = httpRequest.getMethod();
if ("POST".equalsIgnoreCase(method) && httpRequest.getUserPrincipal() == null)
{
throw new ServletException("Anonymous users cannot create scenarios.");
}
}
chain.doFilter(request, response);
}

20.9.3 認証されたユーザーによるシナリオの作成の禁止

第20.9.2項「匿名ユーザーによるシナリオの作成の禁止」で説明したフィルタに簡単な変更を加えると(httpRequest.getUserPrincipal() checkを削除)、すべてのユーザーに対してシナリオの作成を禁止できます。HTTP POST操作はシナリオの実行のリクエストにも使用されますが、その場合のURIは異なります(また、フィルタ<url-pattern>ではなく、<security-constraint>内で保護されています)。

21 RSSサービスの管理

この章では、SpacesアプリケーションおよびFrameworkアプリケーション用にRSSサービスを構成および管理する方法について説明します。

この章の内容は次のとおりです。

- 第21.1項「RSSサービスに関する必要な知識」

- 第21.2項「RSSの前提条件」

- 第21.3項「外部RSSニュース・フィードのためのプロキシ・サーバーの設定」

- 第21.4項「外部RSSニュース・フィード接続のテスト」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

21.1 RSSサービスに関する必要な知識

RSSサービスには、RSSビューアと、様々なWebCenter Portalサービスからのニュース・フィードを表示するサービスが含まれます。RSSビューアを使用すれば、複数の異なるWebサイトからの外部ニュース・フィードをWebCenter Portalアプリケーション内から表示できます。RSSサービスは、最近のアクティビティ、ディスカッション、リストおよびお知らせの各WebCenter Portalサービスからコンテンツ更新情報を配信します。

21.2 RSSの前提条件

RSSサービスはバックエンド・サーバーを必要としません。このサービスを使用するために接続を設定する必要はありません。ただし、ネットワーク構成によっては、WebCenter Portalアプリケーションが外部RSSニュース・フィードのコンテンツを表示できるように、プロキシ・サーバーの設定が必要になる場合があります。

21.3 外部RSSニュース・フィードのためのプロキシ・サーバーの設定

WebCenter Portalアプリケーションで外部RSSニュース・フィードを使用できるようにするには、プロキシ・サーバーを設定する必要があります。

アクティビティ・ストリーム・タスク・フローで外部リンクを表示する場合は、プロキシ・サーバーも必要です。RSSサービスとアクティビティ・ストリーム・サービスは、同じプロキシ・サーバー設定を共有します。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、プロキシ・サーバーを構成できます。詳細は、第9.7項「プロキシ・サーバーの設定」を参照してください。

21.4 外部RSSニュース・フィード接続のテスト

プロキシ・サーバーをRSSサービスのRSSビューア用に設定したら、接続をテストして、外部RSSフィードにアクセスできることを確認します。

プロキシ・サーバーがRSSビューア用に適切に設定されていることを確認する手順は次のとおりです。

1. WebCenter Portalアプリケーションで、RSSタスク・フローをページに追加します。

2. RSSタスク・フローを編集して、外部RSSフィードのURLを設定します。次に例を示します。
http://www.oracle.com/rss/rss_ocom_pr.xml

RSSフィードが正しく表示されれば、プロキシの構成は適切に設定されています。

RSSタスク・フローの追加およびURLの編集の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのRSSサービスの使用に関する章を参照してください。

22 WebCenter PortalでのOracle SES検索の管理

この章では、ほとんどのWebCenter Portalオブジェクトを索引付けおよび検索するようにOracle Secure Enterprise Search (SES)アダプタを構成する方法について説明します。Oracle SES検索には、次の利点があります。

- Oracle SES検索では、最も関連性の高いアイテムが最初に表示される、統合ランキング結果が提供されます。

- Oracle SES検索では、WebCenter Portalの外部にある他のリポジトリを検索できます。

- Oracle SES検索では、検索インタフェースをカスタマイズするための検索サービスREST APIとデータ・コントロールがサポートされます。

WebCenter Portal: Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。構成手順の詳細は、第22.5項「Frameworkアプリケーションを検索するためのOracle SESの構成」を参照してください。

WebCenter Portal: Spacesアプリケーションで、WebCenter Portalの内部検索サービス・アダプタは、デフォルトの検索プラットフォームとして設定されています。ただし、大規模な実装では最適なパフォーマンスのためにOracle SESを使用するよう構成する必要があります。構成手順の詳細は、第22.6項「Spacesアプリケーションを検索するためのOracle SESの構成」を参照してください。

WebCenter Portalの元の検索サービス・アダプタを使用するよう選択した場合は、この章の情報は必要ありません。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して実行する検索構成の変更の多くは、動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第22.1項「Oracle SESでのWebCenter Portalの検索に関する必要な知識」

- 第22.2項「WebCenter PortalでのOracle SESの構成ロードマップ」

- 第22.3項「Oracle SESを使用するための前提条件」

- 第22.4項「Oracle SES接続の設定」

- 第22.5項「Frameworkアプリケーションを検索するためのOracle SESの構成」

- 第22.6項「Spacesアプリケーションを検索するためのOracle SESの構成」

- 第22.7項「Oracle SES検索に関する問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

22.1 Oracle SESでのWebCenter Portalの検索に関する必要な知識

最適なパフォーマンスのためには、Oracle SES検索を使用することをお薦めします。WebCenter Portalアプリケーションで次のリソースを検索するようOracle SESを構成できます。

- ドキュメント(Wikiおよびブログを含む)

- お知らせおよびディスカッション

- WebCenter Portal: Spacesのスペース、リスト、ページ・コンテンツおよび人のリソース

注意:

WebCenter Portal: Spacesには、Spaces内のスペース、リスト、ページおよび人のリソースを索引付けする追加のOracle SESクローラが含まれています。このクローラは、Frameworkアプリケーションではサポートされていません。

すべてのソースの結果が合わせてリストされ、最も関連性の高いアイテムが最初に表示されます。たとえば、ユーザー名の検索を実行する場合、そのユーザーが作成したドキュメントではなく、そのユーザーの連絡先情報(つまり、ピープル・コネクション・サービス内の正確なユーザー名)を探している可能性が高いと考えられます。Oracle SESの統合ランキング結果を使用すると、検索プリファレンスを構成しなくても、すべての異なるタイプの検索間で最も関連性の高い結果を表示することができます。

Oracle SESがWebCenter Portalを検索するよう構成されている場合、その他のクロールされていないリソース(ノート、イベントなど)は検索結果に返されません。

WebCenter Portalリソースを索引付けするOracle SESクローラには、次の3つのタイプがあります。

- ドキュメント・クローラ: (FrameworkおよびSpacesアプリケーションの両方)Oracle SES Oracle Content Serverソース・タイプを使用して、Wikiおよびブログを含むドキュメントをクロールします。

- ディスカッション・クローラ: (FrameworkおよびSpacesアプリケーションの両方)Oracle SES Databaseソース・タイプを使用して、ディスカッションおよびお知らせをクロールします。

- スペース・クローラ: (Spacesアプリケーションのみ)Oracle SES Oracle WebCenterソース・タイプを使用して、リスト、ページ、スペース、ピープル・コネクション・プロファイルなどのSpaces内の特定のオブジェクトをクロールします。

注意:

Oracle SESでは、ソースとして収集された情報をクロールします。各ソースには、データベースやコンテンツ・リポジトリなど、情報が格納される場所を特定するタイプがあります。

Oracle SESでWebCenter Portalを検索するよう構成する場合は、すべての利用可能なOracle SESクローラを有効にする必要があります。これらのOracle SESクローラのいずれかを有効にし、その他は無効にすることはお薦めできません。たとえば、Oracle SESでFrameworkアプリケーションを検索するよう構成する場合、ドキュメントをクロールしてディスカッションはクロールしないようにすることはできません。

22.2 WebCenter PortalでのOracle SESの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- ロードマップ - FrameworkアプリケーションのためのOracle SESの構成
図22-1と表22-1に、FrameworkアプリケーションでOracle SESを動作させるための前提条件と必要な作業の概要を示します。

図22-1 FrameworkアプリケーションのためのOracle SESの構成

「図22-1 FrameworkアプリケーションのためのOracle SESの構成」の説明

表22-1 FrameworkアプリケーションのためのOracle SESの構成

担当者

タスク

サブタスク

管理者

1. WebCenter PortalとOracle SESをインストールします

2. アイデンティティ管理システムとともにOracle SESを構成します

3. Oracle SESにドキュメント・サービス・マネージャを設定します

4. 次のいずれかのツールを使用して、フェデレーション・トラステッド・エンティティを作成します

- Oracle SES管理ツール

- WLST

5. 次のツールのいずれかを使用して、ドキュメント・クローラおよびディスカッション・クローラの2つのクロール・ソースを作成します

- Oracle SES管理ツール

- WLST

6. 次のツールのいずれかを使用してクロール・ソースのソース・グループを作成します

- Oracle SES管理ツール

- WLST

開発者

7. 検索サービスをFrameworkアプリケーションに統合します

7.a JDeveloperでOracle SESへの接続を構成します

7.b JDeveloperで検索サービス・タスク・フローをページに追加します

開発者または管理者

8. 次のいずれかのツールを使用して、Frameworkアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール (管理者)

管理者

9. (オプション)Oracle SESへの接続をSSLで保護します

管理者

10. 次のツールのいずれかを使用して追加の検索パラメータを構成します

- Fusion Middleware Control

- WLST

- WLS管理コンソール

- ロードマップ - SpacesアプリケーションのためのOracle SESの構成
図22-2と表22-2に、SpacesでOracle SESを動作させるための前提条件と必要な作業の概要を示します。

図22-2 SpacesアプリケーションのためのOracle SESの構成

「図22-2 SpacesアプリケーションのためのOracle SESの構成」の説明

表22-2 SpacesアプリケーションのためのOracle SESの構成

担当者

タスク

管理者

1. WebCenter PortalとOracle SESをインストールします

2. アイデンティティ管理システムとともにOracle SESを構成します

3. Oracle SESにドキュメント・サービス・マネージャを設定します

4. 次のいずれかのツールを使用して、フェデレーション・トラステッド・エンティティを作成します

- Oracle SES管理ツール

- WLST

5. クロール・ユーザーを作成します

6. 次のツールのいずれかを使用して、ドキュメント・クローラ、ディスカッション・クローラおよびスペース・クローラの3つのクロール・ソースを作成します

- Oracle SES管理ツール

- WLST

7. 次のツールのいずれかを使用してクロール・ソースのソース・グループを作成します

- Oracle SES管理ツール

- WLST

8. 次のツールのいずれかを使用して、SpacesとOracle SES間の接続を構成します

- Oracle SES管理ツール

- WLST

9. (オプション)Oracle SESへの接続をSSLで保護します

10. 次のツールのいずれかを使用して追加の検索パラメータを構成します

- Fusion Middleware Control

- Oracle SES管理ツール

- WLST

エンド・ユーザー

11. (オプション)Spacesでスペースに検索サービス・タスク・フローを追加します

22.3 Oracle SESを使用するための前提条件

この項の内容は次のとおりです。

- 第22.3.1項「Oracle SES: インストール」

- 第22.3.2項「Oracle SES: 構成」

- 第22.3.3項「Oracle SES: セキュリティ」

22.3.1 Oracle SES: インストール

サポートされるOracle SESのバージョンは、10.1.8.4.x以降です。Oracle SESリリース11.1.2.2を使用することを強くお薦めします。Oracle SESのインストール手順の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項を参照してください。

関連項目:

Oracle SESに必要なすべてのパッチをインストール済であることを確認することは重要です。必要なパッチの最新情報は、リリース・ノートを確認してください。

この章では、サポートされている最新の製品であるOracle SES 11.1.2.2およびOracle WebCenter Content: Content Server 11.1.1.5を実行していることを前提としています。ただし、次のシナリオもサポートされます。

WebCenter Portal: Frameworkバージョン11.1.1.3および11.1.1.4は次のインストールでサポートされます。

- Oracle SES 11.1.2およびOracle Content Server 11.1.1.3+

- Oracle SES 10.1.8.4およびOracle Content Server 11.1.1.3+

- Oracle SES 10.1.8.4およびOracle Content Server 10.1.3.5.1 (11.1.1.1から11.1.1.3を含むバージョン)

WebCenter Portal: Spacesバージョン11.1.1.3および11.1.1.4は次のインストールでサポートされます。

- Oracle SES 11.1.2およびOracle Content Server 11.1.1.3+

- Oracle SES 10.1.8.4およびOracle Content Server 11.1.1.3

22.3.2 Oracle SES: 構成

1. Oracle SESは、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成する必要があります。これはセキュアな検索のために必要です。そうすることで、検索時に、アクセス権限に基づいてユーザーが表示することを許可される結果のみが返されるようになります。
WebCenter PortalはOracle SESとの通信時にアイデンティティ伝播を使用するため、WebCenter Portalのユーザー・ベースはOracle SESのユーザー・ベースと一致している必要があります。そうするための1つの方法は、WebCenter PortalとOracle SESを、Oracle Internet Directoryなどの同じアイデンティティ管理システムに対して構成することです。

注意:

サポートされているすべてのアイデンティティ管理システムについては、第28.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」を参照してください。

各Oracle SESインスタンスに対して、1つのアイデンティティ・プラグインのみを設定できます。すべてのリポジトリ(Oracle WebCenter Content: Content Server、Oracle WebCenter Portal Discussions Server、およびOracle WebCenter Portal: Spaces)は、Oracle SESと同じユーザー・ベースを共有する必要があります。

Oracle SESには、Oracle Internet Directory、Oracle Content Server、Microsoft Active Directoryなどのアイデンティティ管理システムのための多数のアイデンティティ・プラグインが含まれています。詳細は、製品に含まれるOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

次の例では、Oracle Internet Directory用のアイデンティティ・プラグインを設定します。

1. Oracle SES管理ツールで、「グローバル設定」→「アイデンティティ管理設定」ページに移動し、利用可能なアイデンティティ・プラグインから「Oracle Internet Directory」を選択し、「アクティブ化」をクリックします。

2. 次の値を入力します。
ホスト名: Oracle Internet Directoryが実行されているコンピュータのホスト名

ポート: Oracle Internet Directoryのポート番号

SSLの使用: プリファレンスに基づき、trueまたはfalse

レルム: dc=us,dc=oracle,dc=comなどのOracle Internet Directoryレルム

ユーザー名: cn=orcladminなどのOracle Internet Directory管理ユーザー名

パスワード: 管理ユーザーのパスワード

3. 「送信」をクリックします。

2. WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。(信頼できるエンティティにより、Oracle SES上で問合せを実行する際にWebCenter Portalアプリケーションが自身をOracle SESに対して認証し、ユーザーをアサートできるようになります。)この信頼できるエンティティは、Oracle SESの背後のアイデンティティ管理サーバーに存在するユーザーにすることも、Oracle SESで内部的に作成されるユーザーにすることもできます。
これはWLSTまたはOracle SESのどちらでも実行できます。

注意:

この信頼できるエンティティ名とパスワードは、後でWLSTコマンドcreateSESConnectionにおけるappUserおよびappPasswordプロパティとして必要になります。

これをWLSTで実行するには、createFederationTrustedEntityコマンド(例22-1)を使用します。

例22-1 createFederationTrustedEntityコマンド

createFederationTrustedEntity(
'webcenter', 'http://ses-host:ses-port/search/api/admin/AdminService',
'ses-admin-pw', 'webcenter-proxy-user', 'webcenter-proxy-user-pw',
'Trusted entity for WebCenter');

各要素の意味は次のとおりです。

- ses-host = Oracle SESホスト名

- ses-port = Oracle SESポート番号

- ses-admin-pw = Oracle SES管理ユーザー・パスワード

- webcenter-proxy-user = WebCenter Portalエンド・ユーザーをログオンするためのプロキシ・ユーザー

- webcenter-proxy-user-pw = WebCenter Portalエンド・ユーザーをログオンするためのプロキシ・ユーザーのパスワード

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateFederationTrustedEntityに関する項を参照してください。

これをOracle SESで実行するには、次の手順に従ってください。

1. Oracle SES管理ツールで、「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページに移動します。

2. 信頼できるエンティティの名前を入力します。これは、WebCenter Portalが検索時に(エンド・ユーザー・アイデンティティをOracle SESに伝播する前に)自身をOracle SESに対して認証するために使用する名前です。
エンティティがアクティブなアイデンティティ・プラグインによって認証されるようにするには:

- エンティティ名がアイデンティティ管理システム内に存在するユーザーの名前であることを確認します。

- パスワード・フィールドを空白のままにします。

- 「アイデンティティ・プラグインを認証に使用」チェック・ボックスを選択します。

- アクティブなアイデンティティ・プラグインの「認証属性」に対応する認証の属性値を入力します。

エンティティがOracle SESによって認証されるようにするには:

- 任意のユーザー名(例: wcsearch)とパスワード(例: welcome1)を入力します。

- 「アイデンティティ・プラグインを認証に使用」チェック・ボックスは選択しないでください。

詳細は、Oracle SESの「フェデレーション・トラステッド・エンティティ」ページのオンライン・ヘルプを参照してください。

注意:

参考までに、この章では次のサンプル・ユーザー名が使用されています。

- wcsearch: Oracle SESフェデレーション・トラステッド・エンティティのユーザー

- mycrawladmin: リスト、ページ、スペース、ピープル・コネクション・プロファイルなどの特定のSpacesオブジェクトをクロールするための、Spacesおよびアイデンティティ管理システム内のクロール管理ユーザー

- sescrawer (または管理ユーザー): sescrawlerrole (またはadmin)ロールを持つOracle WebCenter Content Serverのクロール管理ユーザー

22.3.3 Oracle SES: セキュリティ

ほとんどのエンタープライズ・デプロイメントでは、セキュアなHTTP接続が必要です。Secure Socket Layer (SSL)は、インターネット上で機密のコンテンツを安全に送信するための暗号化プロトコルです。パスワードやその他のセキュアなデータをネットワーク上で送信する際には、SSL保護されたチャネルを使用することを強くお薦めします。

手順の詳細は、第33.10項「SSLを使用したOracle SESへの接続の保護」を参照してください。

22.4 Oracle SES接続の設定

この項の内容は次のとおりです。

- 第22.4.1項「Oracle Secure Enterprise Searchサーバーの登録」

- 第22.4.2項「アクティブなOracle SES接続の選択」

- 第22.4.3項「Oracle SES接続の詳細の変更」

- 第22.4.4項「Oracle SES接続の削除」

- 第22.4.5項「Oracle SES接続のテスト」

22.4.1 Oracle Secure Enterprise Searchサーバーの登録

WebCenter Portalアプリケーションには複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。

Fusion Middleware ControlまたはWLSTを使用してOracle SES接続を登録できます。この項の内容は次のとおりです。

- 第22.4.1.1項「Fusion Middleware Controlを使用したOracle SES検索接続の登録」

- 第22.4.1.2項「WLSTを使用したOracle SES接続の登録」

22.4.1.1 Fusion Middleware Controlを使用したOracle SES検索接続の登録

WebCenter PortalアプリケーションにOracle SESインスタンスを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。

4. 新規のOracle SESインスタンスに接続するには、「追加」をクリックします(図22-3)。

図22-3 Oracle Secure Searchサービスの構成

「図22-3 Oracle Secure Searchサービスの構成」の説明

5. 「Secure Enterprise Search接続の追加」ページで、この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(図22-4)。

図22-4 Secure Enterprise Search接続の追加

表22-3に、接続パラメータを示します。

表22-3 検索接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

アクティブな接続

これを選択すると、この接続に定義されているOracle SESインスタンスを使用してWebCenter Portalアプリケーション外部のリポジトリが検索され、結果セットにOracle SES検索結果が含まれるようになります。

1つのアプリケーションに対して複数の検索接続を登録できますが、検索サービスで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. Oracle SESインスタンスの接続の詳細を入力します(表22-4)。

表22-4 Oracle Secure Enterprise Search: 接続の詳細

フィールド

説明

SOAP URL

Oracle SESが検索リクエストを有効化するために公開するWebサービスURLを入力します。

次の形式を使用します。

http://host:port/search/query/OracleSearch

次に例を示します。

http://myHost:7777/search/query/OracleSearch

フェデレーション・トラステッド・エンティティ名

第22.3.2項「Oracle SES: 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名を入力します。

ヒント: このユーザーは、Oracle SES管理ツールの「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページで構成されます。

WebCenter Portalアプリケーションは、WebCenter Portalユーザーにかわって検索を実行できるように、Oracle SESに対して信頼できるアプリケーションとして自身を認証する必要があります。

この章の例では、この値にwcsearchを使用しています。

フェデレーション・トラステッド・エンティティ・パスワード

フェデレーション・トラステッド・エンティティのパスワードを入力します。

7. 「OK」をクリックして、この接続を保存します。

注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

22.4.1.2 WLSTを使用したOracle SES接続の登録

1. WLSTコマンドのcreateSESConnectionを使用して、Oracle SESへの接続を作成します。次に例を示します。

createSESConnection(appName='webcenter',
name='MySesConnection',
url='http://myhost.com:7777/search/query/OracleSearch',
appUser='wcsearch',
appPassword='welcome1',
default=true)

ここで、appUserは第22.3.2項「Oracle SES: 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名です。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateSESConnectionに関する項を参照してください。

新規のOracle SES接続をアクティブに使用するように検索サービスを構成するには、default=trueを設定します。詳細は、第22.4.2.2項「WLSTを使用したアクティブなOracle SES接続の選択」を参照してください。

関連項目:

第22.4.3.2項「WLSTを使用したOracle SES接続の詳細の変更」

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続または設定の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.4.2 アクティブなOracle SES接続の選択

WebCenter Portalアプリケーションには複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。

注意:

第22.4.1項「Oracle Secure Enterprise Searchサーバーの登録」でアクティブな接続を選択している場合は、この項でそのための手順を実行する必要はありません。

この項の内容は次のとおりです。

- 第22.4.2.1項「Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択」

- 第22.4.2.2項「WLSTを使用したアクティブなOracle SES接続の選択」

22.4.2.1 Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

アクティブな接続を変更する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。
「セキュアなEnterprise Search接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」(図22-5)をクリックします。

図22-5「編集」アイコン

5. 「アクティブな接続」チェック・ボックス(図22-6)を選択します。

図22-6「アクティブな接続」チェック・ボックス

6. 「OK」をクリックして、接続を更新します。

注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

22.4.2.2 WLSTを使用したアクティブなOracle SES接続の選択

WLSTコマンドのsetSESConnectionをdefault=trueで使用して、既存のOracle SES接続をアクティブ化します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSESConnectionに関する項を参照してください。

後からOracle SES接続を無効化するには、同じWLSTコマンドをdefault=falseとともに実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.4.3 Oracle SES接続の詳細の変更

Oracle SES接続の詳細はいつでも変更できます。

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

注意:

この項の手順は、第22.4.1項「Oracle Secure Enterprise Searchサーバーの登録」で構成された詳細を変更する場合にのみ必要になります。

この項の内容は次のとおりです。

- 第22.4.3.1項「Fusion Middleware Controlを使用したOracle SES接続の詳細の変更」

- 第22.4.3.2項「WLSTを使用したOracle SES接続の詳細の変更」

22.4.3.1 Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

Oracle SESインスタンスの接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータ情報の詳細は、表22-4を参照してください。

6. 「OK」をクリックして、変更を保存します。

注意:

更新後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

22.4.3.2 WLSTを使用したOracle SES接続の詳細の変更

WLSTコマンドのsetSESConnectionを使用して、既存のOracle SES検索接続を変更します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSESConnectionに関する項を参照してください。

注意:

更新された(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.4.4 Oracle SES接続の削除

Oracle SES接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーは外部リポジトリのコンテンツを検索できなくなります。

この項の内容は次のとおりです。

- 第22.4.4.1項「Fusion Middleware Controlを使用した検索接続の削除」

- 第22.4.4.2項「WLSTを使用した検索接続の削除」

22.4.4.1 Fusion Middleware Controlを使用した検索接続の削除

Oracle SESサーバー接続を削除する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「サービス接続」ドロップダウンから、「検索」を選択します。

4. 接続名を選択し、「削除」をクリックします。

図22-7 接続削除アイコン

注意:

この変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

22.4.4.2 WLSTを使用した検索接続の削除

WLSTコマンドのdeleteConnectionを使用して、検索接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.4.5 Oracle SES接続のテスト

ブラウザに次のOracle SES Webサービス操作のURLを入力して、Oracle SES接続を確認します。

http://host:port/search/query/

このURLアドレスがブラウザで表示されない場合、Oracle SESサーバーのホストまたはポートのどちらかが間違っているか、またはOracle SESが起動されていません。

22.5 Frameworkアプリケーションを検索するためのOracle SESの構成

WebCenter Portal: Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。Frameworkアプリケーションを検索するようOracle SESを構成するには、Spacesアプリケーションを検索するようOracle SESを構成するのと同様の手順を実行する必要がありますが、Frameworkアプリケーションではスペース・クローラがサポートされません。

注意:

Oracle SESをFrameworkアプリケーションの検索エンジンとして有効化するために実行する必要のあるタスクの概要は、第22.2項「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。必要なタスクを実行するためにふさわしい方法や順序が多数ある場合もあります。

この項では、Frameworkアプリケーションを検索するようOracle SESを設定する手順について説明します。

- 第22.5.1項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」

- 第22.5.2項「Oracle SES検索のためのOracle WebCenter Portalのディスカッション・サーバーの設定」

- 第22.5.3項「WebCenter Portalを検索するためのOracle SESの設定」

- 第22.5.4項「Oracle SES検索のためのWebCenter Portal: Frameworkの設定」

- 第22.6.7項「ページ・コンテンツのクロールのヒント」

関連項目:

第22.1項「Oracle SESでのWebCenter Portalの検索に関する必要な知識」

22.5.1 Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content: Content Server(特に、WebCenter Portalがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

1. sescrawlerroleロールを作成します。

2. ユーザーsescrawlerを作成し、これにadminロールとsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

3. sceCrawlerRole=sescrawlerroleをconfig.cfgに追加します。

4. Content Serverを再起動します。

5. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図22-8)を選択します。

図22-8 Content Serverの管理

「図22-8 Content Serverの管理」の説明

3. インスタンス名のボタンをクリックします。

4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図22-9)。

図22-9 Content Serverの「コンポーネント・マネージャ」

「図22-9 Content Serverの「コンポーネント・マネージャ」」の説明

5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)
SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」をfalseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

さらに、クラスタ環境の場合のみ、feedLocパラメータで、コンテンツ・サーバーのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

7. Content Serverを再起動します。

6. Content Serverリポジトリのスナップショットを撮ります。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

3. 「すべてのソース」を選択し、「スナップショットの取得」 (図22-10)をクリックします。

図22-10 Content Serverのスナップショット

「図22-10 Content Serverのスナップショット」の説明

ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

7. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。
Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図22-11)をクリックします。

図22-11 Content Serverのスナップショット

「図22-11 Content Serverのスナップショット」の説明

2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図22-12)。

図22-12 Content Serverの「メタデータ・リスト」

「図22-12 Content Serverの「メタデータ・リスト」」の説明

空白のままにすると、Oracle SESにエクスポートされるメタデータの値のリストは、次(および「x」で始まる任意のカスタム・メタデータ・フィールド)で構成されます。

dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

ただし、dFormatをこのリストに追加する必要があります。

空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらは再度追加する必要があります。標準の属性にdFormatを含めるには、「メタデータ・リスト」に次の値を入力します。

dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount, dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

3. オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのリストに追加します。
たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

dFormat,dID,dDocName,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dDocAuthor,dDocCreator,dDocCreatedDate,dOutDate,xCollectionID,xWCTags,xComments,xRegionDefinition

関連項目:

- 検索結果におけるMIMEタイプの表示については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの属性および絞込み機能による検索結果のカスタマイズに関する項を参照してください。

- Content Server構成の詳細は、製品に付属のDeployment Guide.pdfを参照してください。

22.5.2 Oracle SES検索のためのOracle WebCenter Portalのディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。

注意:

WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。この手順は、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要となります。

該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。

1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

- Oracleデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

- Microsoft SQL Serverデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

- IBM DB2データベース:
MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

注意:

IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。

ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要があります。このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでのテーブルスペースの指定手順で、デフォルトのテーブルスペースとしてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

詳細は、第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」を参照してください。

2. 次のツールを実行して(まだ実行していない場合)、Oracle WebCenter Portalのディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

java -jar \
$MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
<command_line_parameters>

ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

-mds_jdbc_user user_id \
-mds_jdbc_password password \
-mds_jdbc_url url \
-discussions_jdbc_user user_id \
-discussions_jdbc_password password \
-discussions_jdbc_url url

ここでmds_jdbc_user、mds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_user、discussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

次に例を示します。

java -jar $MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
-mds_jdbc_user foo \
-mds_jdbc_password welcome1 \
-mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
-discussions_jdbc_user foo \
-discussions_jdbc_password welcome1 \
-discussions_jdbc_url jdbc:oracle:thin:@host:port:SID

22.5.3 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

1. 第22.5.3.1項「Oracle SES管理ツールへのログオン」

2. 第22.5.3.2項「ドキュメントを検索するためのOracle SESの設定」

3. 第22.5.3.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

4. 第22.5.3.4項「追加のOracle SES構成」

関連項目:

Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項およびリリース・ノードを参照してください。

Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

22.5.3.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

1. ブラウザを開き、インストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

2. Oracle SES管理ユーザー名eqsysとインストール時に指定されたパスワードでログオンします。

22.5.3.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定してから、Content Serverソースを作成する必要があります。

1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。

注意:

ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、アプリケーションで使用されるドキュメントに索引付け可能な属性をWebCenter Portalで追加できるようになります。

検索属性名は一意である必要があります。2つの属性に同じ名前を使用することはできません。たとえば、属性が文字列のデータ型で存在する場合に、名前が同じで異なるデータ型の別の属性がクローラにより検出されると、そのクローラは2番目の属性を無視します。新しい属性を作成する前に、Oracle SESドキュメント内のOracle SES属性名とタイプのリストを必ず確認してください。

1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。
マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

マネージャJARファイル名: search-crawl-ucm.jar

注意:

webcenter_search_ses_plugins.zipファイルによりOracle_Home/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。

「次へ」をクリックして、「終了」をクリックします(図22-13)。

図22-13 Oracle SESでのドキュメント・サービス・マネージャの作成

「図22-13 Oracle SESでのドキュメント・サービス・マネージャの作成」の説明

2. ドキュメント・サービス・インスタンスを作成します。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」で「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図22-14)。

図22-14 ドキュメント・サービスの作成

「図22-14 ドキュメント・サービスの作成」の説明

インスタンス名の入力に加えて、次のパラメータも入力します。

WebCenterアプリケーション名: これは空白のままにする必要があります。

接続名: WebCenter PortalアプリケーションのContent Server接続名です。

WebCenter URL接頭辞: WebCenter Portalアプリケーションがデプロイされるホストおよびポート、並びにコンテキスト・ルート。例: http://myhost:8888/DocumentServer。ここで、DocumentServerはアプリケーションのコンテキスト・ルートです。

3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします。

名前を入力して前の手順で作成したインスタンスを選択します。

2. ドキュメントのContent Serverソースを作成します。

1. 「ホーム」→「ソース」に移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle Content Server」を選択し、「作成」(図22-15)をクリックします。

図22-15 Oracle Content Serverソースの作成

「図22-15 Oracle Content Serverソースの作成」の説明

3. 次のパラメータを入力します。
ソース名: unique_name

構成URL: Content_Server_SES_Crawler_Export_endpoint (例: http://host:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default)

注意:

source=defaultパラメータは、SESクローラ・エクスポートの構成で作成されたソースの名前を示します。デフォルトのソースが作成され、自動的にdefaultと名付けられます。

認証タイプ:

Content ServerがSSOで保護されない場合、NATIVEと入力します。

Content ServerがOracle SSOで保護される場合、ORASSOと入力します。

ユーザーID: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。

特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

パスワード: このContent Serverユーザーのパスワード。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このパラメータは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

Oracle SSOログインURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/mysso/signon.jsp?site2pstoretoken=

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

Oracle SSOアクションURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/sso/auth

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

「次へ」をクリックします(図22-16)。

図22-16 Oracle Content Serverソースのパラメータ

「図22-16 Oracle Content Serverソースのパラメータ」の説明

4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(デフォルトで入力されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.stellent.StellentAuthManager

Jarファイル名: oracleapplications/StellentCrawler.jar

認可用HTTPエンドポイント: 例: http://host:port/cs/idcplg

表示URL接頭辞: 例: http://host:port/cs

認証タイプ: NATIVEまたはORASSO

管理者ユーザー: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

管理者のパスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このフィールドは空白のままにします。

5. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

6. 「有効化」をクリックして作成したパイプラインを選択します。

22.5.3.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalのディスカッションとお知らせを検索するには、まず、ディスカッション用とお知らせ用の2つのOracle SESデータベース・ソースを設定する必要があります。たとえば、ディスカッションのソースには、ソース名GS_DiscussionsおよびFORUMCRAWLER_VWのビューが設定され、お知らせのソースには、ソース名GS_AnnouncementsおよびANNOUNCEMENTS_VWのビューが設定されます。

注意:

Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。

1. JDBCドライバを構成します。

1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

注意:

- Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

- IMB DB2の場合: IBMドライバ・ファイル、db2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。

JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

- 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

- JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素に追加します。

- 中間層を再起動します。

2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarのMETA-INF/MANIFEST.MF内のクラスパスに追加します。
例: 変更前

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更後

Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更前

Class-Path: appsjdbc.jar

変更後

Class-Path: db2jcc.jar appsjdbc.jar

KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

たとえば、IDという名前のキー属性の場合、次のようになります。

oracle : oracle.jdbc.driver.OracleDriver, ID

クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDはKEYVALの別名です。

SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only

OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

- Oracle: oracle.jdbc.driver.OracleDriver

- SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

2. IBM DB2データベースの場合のみ、次の手順が必要となります。

1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。META-INF/MANIFEST.MFが正しく更新されたことを確認してください。正しく更新されない場合、クローラは失敗し、クローラのログ・ファイルに次のエラーが記録されます。

EQP-80406: Loading JDBC driver failed

3. Oracle_Home/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

db2: com.ibm.db2.jcc.DB2Driver

4. ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。次に例を示します。

#CLASS PATH
CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
stubs.jar :ORACLE_HOME /search/lib/plugins/oracleapplications/db2jcc.jar

5. $ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。次に例を示します。

JVM_OPTIONS= -Djava.awt.headless=true
-Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
-Doracle.home=ORACLE_HOME/search

6. $ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルを$ORACLE_HOME/search/libディレクトリにコピーします。

7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

3. ディスカッション・ソースまたはお知らせソースを作成します。

1. Oracle SESで、「ホーム」→「ソース」に進みます。

2. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図22-17)をクリックします。

図22-17 データベース・ソースの作成

「図22-17 データベース・ソースの作成」の説明

3. 次のパラメータを入力します。
ソース名: unique_name。たとえば、ディスカッションをクロールする場合、GS_Discussions(お知らせをクロールする場合は、GS_Announcements)。

データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- IBM DB2データベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DC(MyPrefixは5文字)

パスワード: このユーザーのパスワード。

問合せ: 次のいずれかの問合せを入力します。

SELECT * FROM FORUMCRAWLER_VW
SELECT * FROM ANNOUNCECRAWLER_VW

ソース・クロール・ディスカッション・フォーラムには、FORUMCRAWLER_VWを使用します。

ソース・クロールお知らせには、ANNOUNCECRAWLER_VWを使用します。

URL接頭辞: ホスト、ポートおよびアプリケーション名を含むWebCenter PortalアプリケーションのURL接頭辞。たとえば、http://host:port/webcenterのようになります。

「セキュリティ属性の付与」: WCSECATTR

注意:

以前のリリースのContent Serverでは、「セキュリティ属性の付与」にFORUMIDが使用されていました。

4. 「次へ」をクリックします。

5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.db.DBAuthManager

Jarファイル名: oracleapplications/DBCrawler.jar

認可データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- IBM DB2データベース: ユーザーMyPrefix_DC (MyPrefixは5文字)を入力します。

パスワード: このユーザーのパスワード

単一レコード問合せ: false

認可問合せ: (1行で)次を入力します。

SELECT DISTINCT forumID as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW
WHERE username = ? UNION SELECT DISTINCT -1 as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW

注意:

以前のリリースのContent Serverでは、次の認可問合せが使用されていました。

SELECT forumID
FROM AUTHCRAWLER_FORUM_VW
WHERE (username = ? or userID=-1)
UNION SELECT f.forumID
FROM jiveForum f, AUTHCRAWLER_CATEGORY_VW c
WHERE f.categoryID = c.categoryID AND (c.username =  ? or userID=-1)

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nickname、usernameなど)。

Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

6. 「作成」をクリックしてソースの作成を完了します。

22.5.3.4 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

1. Content Server、ディスカッション、お知らせおよびWebCenter Portalサービスの作成したソースの名前を含む、ソース・グループを作成します。

1. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

2. 第22.5.4項「Oracle SES検索のためのWebCenter Portal: Frameworkの設定」で入力したのと同じソース・グループ名を入力します。

3. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Oracle Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

4. 「完了」をクリックします。

2. 必要に応じてセキュリティ・フィルタ有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くすることをお薦めします。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用します。)
たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」に0を入力します。

セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。
この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。

「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。

注意:

Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、第22.5.1項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」を参照してください。

22.5.4 Oracle SES検索のためのWebCenter Portal: Frameworkの設定

この項では、Oracle SESと連動するようWebCenter Portal: Frameworkを構成する方法について説明します。

フェデレーション・トラステッド・エンティティを指定し、オプションとしてソース・グループを指定して、WebCenter PortalとOracle SES間の接続を作成および構成済であることを確認してください。

Oracle SESクローラは、Frameworkアプリケーションでデフォルトで有効にされています。

関連項目:

『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の検索サービスの接続の設定に関する項

22.5.4.1 デプロイ後のFrameworkアプリケーションの構成

FrameworkアプリケーションがOracle WebLogic管理対象サーバーにデプロイされたら、WLSTまたはFusion Middleware Controlを使用してそれを構成できます。この項の内容は次のとおりです。

- 第22.5.4.1.1項「WLSTを使用した検索パラメータの変更」

- 第22.5.4.1.2項「WLSTを使用した検索クローラの構成」

- 第22.5.4.1.3項「Fusion Middleware Controlを使用した検索パラメータとクローラの構成」

22.5.4.1.1 WLSTを使用した検索パラメータの変更

WLSTコマンドのsetSearchConfigを使用して、デプロイ後に検索パラメータを変更します。

例22-2は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例22-2 ソース・グループの設定

setSearchSESConfig(appName='webcenter',
dataGroup='MySources')

ここで、dataGroupは、第22.5.3.4項「追加のOracle SES構成」(Frameworkアプリケーション用)または第22.6.4.6項「追加のOracle SES構成」(Spacesアプリケーション用)で作成するソース・グループです。

例22-3は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例22-3 表示される検索結果数の増加

setSearchConfig(appName='webcenter',
numResultsMain=10)

例22-4は、サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整してください。

例22-4 WebCenterで検索結果を待機する最大時間の構成

setSearchConfig(appName='webcenter',
executionTimeout=10000)

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

22.5.4.1.2 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、デプロイ後にクローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

例22-5と例22-6は、これらのコマンドの一部を示しています。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の検索: Oracle SES検索クローラに関する項を参照してください。

例22-5 WLSTでのドキュメント・クローラの作成

createDocumentsCrawler(
'portal', 'portal_host', 'portal_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'http://ucm-host:ucm-port/cs/idcplg?IdcService=
SES_CRAWLER_DOWNLOAD_CONFIG&source=default', 'ucm-crawl-user',
'ucm-crawl-user-pw', '/tmp',
'http://ucm-host:ucm-port/cs/idcplg', 'http://ucm-host:ucm-port/cs',
'Idc Security /cs/idcplg', 'authentication-id-format', 'Document-pipeline',
'ACCEPT_ALL', 'PROCESS_CHANGED', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

- portal = この操作を実行するFrameworkアプリケーションの名前

- portal_host = Frameworkアプリケーションを実行するシステムのホスト名

- portal_port = Frameworkアプリケーションにアクセスするために使用されるポート番号

- ses-host = Oracle SESホスト名

- ses-port = Oracle SESポート番号

- ses-admin-pw = Oracle SES管理ユーザー・パスワード

- ucm-host = Content Serverホスト名

- ucm-port = Content Serverポート番号

- ucm-crawl-user = Content Serverクロール・ユーザー名

- ucm-crawl-user-pw = Content Serverクロール・ユーザー・パスワード

- authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

- Document-pipeline = このFrameworkインスタンスのために作成されたOracle SES上のドキュメント・パイプライン

例22-6 WLSTでのディスカッション・クローラの作成

createDiscussionsCrawler(
'webcenter','webcenter_host','webcenter_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'jdbc:oracle:thin:@database-host:database-port:database-sid',
'Jive-crawler-schema','Jive-crawler-schema-pw', 'authentication-id-format',
'ACCEPT_ALL', 'PROCESS_ALL', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

- webcenter_host = Frameworkアプリケーションのホスト名

- webcenter_port = Frameworkアプリケーションのポート番号

- ses-host = Oracle SESホスト名

- ses-port = Oracle SESポート番号

- ses-admin-pw = Oracle SES管理ユーザー・パスワード

- database-host = ディスカッション・サーバー・データベースのホスト名

- database-port = ディスカッション・サーバー・データベースのポート番号

- database-sid = ディスカッション・サーバー・データベース名またはSID

- Jive-crawler-schema = ディスカッション・サーバー・クローラのスキーマ名。RCUから接頭辞を決定し、rcu-prefix_DISCUSSION_CRAWLERを使用します。

- Jive-crawler-schema-pw = ディスカッション・サーバー・クローラのスキーマ・パスワード

- authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

注意:

WLSTの変更を反映させるには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.5.4.1.3 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SES検索を有効化または無効化したり、検索設定を構成できます。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、第6.2項「スペース・アプリケーションのホームページへの移動」または第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. Oracle SESアダプタまたはデフォルトのWebCenter Portalアダプタを有効にするよう選択し、「適用」をクリックします(図22-18)。
必要に応じて検索パラメータを構成できます。

- Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

- 実行タイムアウト: サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

- 実行者の準備タイムアウト: サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

- サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、サービス当たりの検索結果数を入力します。

- サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

- 検索ページの保存済の検索の数: 「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません。

図22-18 Oracle検索のアプリケーション設定

「図22-18 Oracle検索のアプリケーション設定」の説明

22.6 Spacesアプリケーションを検索するためのOracle SESの構成

Spacesアプリケーションで、WebCenter Portal内部のライブ検索アダプタは、デフォルトの検索プラットフォームとして設定されています。ただし、大規模な実装では最適なパフォーマンスのためにOracle SESを使用するよう構成する必要があります。

注意:

Oracle SESをSpacesアプリケーションの検索エンジンとして有効化するために実行する必要のあるタスクの概要は、第22.2項「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。必要なタスクを実行するためにふさわしい方法や順序が多数ある場合もあります。

この項では、Spacesを検索するようOracle SESを設定する手順について説明します。

- 第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」

- 第22.6.2項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」

- 第22.6.3項「Oracle SES検索のためのOracle WebCenter Portalディスカッション・サーバーの設定」

- 第22.6.4項「WebCenter Portalを検索するためのOracle SESの設定」

- 第22.6.5項「WLSTを使用した検索クローラの構成」

関連項目:

第22.1項「Oracle SESでのWebCenter Portalの検索に関する必要な知識」

22.6.1 Oracle SES検索のためのWebCenter Portal: Spacesの設定

この項では、Oracle SESと連動するようWebCenter Portal: Spacesを構成する方法について説明します。

1. SpacesとOracle SES間の接続を作成および構成し、オプションとしてソース・グループを指定します。

関連項目:

第22.4.1.2項「WLSTを使用したOracle SES接続の登録」および第22.4.3.2項「WLSTを使用したOracle SES接続の詳細の変更」

2. Oracle SESを使用してスペース、リストまたはページを検索するには、まずWebCenter Portal: Spacesおよびバックエンドのアイデンティティ管理サーバー(mycrawladminなど)で、クロール管理ユーザーを作成する必要があります。クロール管理ユーザーは一度だけ作成する必要があります。

注意:

ユーザーの作成方法の詳細は、ご使用のアイデンティティ管理システムのドキュメントを参照してください。

次の例では、Oracle Directory Services Managerを使用してmycrawladminユーザーを作成します。

1. 「データ・ブラウザ」タブで、ターゲットcnに移動し、「作成」をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」に移動します。「オブジェクト・クラスの追加」ダイアログで、該当するオブジェクト・クラスを選択し、「OK」をクリックします(図22-19)。

図22-19 Oracle Directory Services Manager - 「オブジェクト・クラスの追加」

「図22-19 Oracle Directory Services Manager - 「オブジェクト・クラスの追加」」の説明

2. 識別名(DN)パスを見つけて、「選択」(図22-20)をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」を選択します。

図22-20 Oracle Directory Services Manager - DNパスの選択

「図22-20 Oracle Directory Services Manager - DNパスの選択」の説明

3. 「新規エントリの作成」ダイアログで、プロパティを入力し、「次へ」をクリックします(図22-21)。

図22-21 Oracle Directory Services Manager - 「新規エントリの作成」

「図22-21 Oracle Directory Services Manager - 「新規エントリの作成」」の説明

4. 新規エントリが正常に作成されたことを確認したら、「終了」をクリックします(図22-22)。

図22-22 Oracle Directory Services Manager - 「ステータス」

「図22-22 Oracle Directory Services Manager - 「ステータス」」の説明

3. WebCenter Portal: Spacesのクロール・アプリケーション・ロールを作成します。

1. 次のコマンドを使用して、クロール・アプリケーション・ロールが存在するかどうかを確認します。

listAppRoles(appStripe='webcenter')

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistAppRolesに関する項を参照してください。

リストは非常に長くなる場合があります。結果内でプリンシパル名としてwebcenter#-#defaultcrawlを検索してください。次に例を示します。

[ [Principal Clz Name :
oracle.security.jps.internal.core.principals.JpsApplicationRoleImpl,
Principal Name :webcenter#-#defaultcrawl, Type : APP_ROLE], Display Name :
Crawl Role. This role never gets updated by webcenter UIs., Description :
null, Guid : DA91B6572AF911DFBF70237926348A3B]

webcenter#-#defaultcrawlが存在しない場合、次のWLSTコマンドを使用してクロール・アプリケーション・ロールを作成する必要があります。

createAppRole(appStripe='webcenter',
appRoleName='webcenter#-#defaultcrawl');

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateAppRoleに関する項を参照してください。

その後Spacesコンテンツにview権限を付与します。

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.community.model.security.CommunityPermission",
permTarget="*",
permActions="view")

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.relationship.model.security.RelationshipPermission",
permTarget="*",
permActions="view")

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.list.model.security.ListPermission",
permTarget="*",
permActions="view")

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.page.model.security.CustomPagePermission",
permTarget="*",
permActions="view")

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.page.model.security.PagePermission",
permTarget="*",
permActions="view")

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.note.model.security.NotePermission",
permTarget="*",
permActions="view")

grantPermission(appStripe="webcenter",
principalClass="oracle.security.jps.service.policystore.ApplicationRole",
principalName="webcenter#-#defaultcrawl",
permClass="oracle.webcenter.collab.calendar.model.security.EventPermission",
permTarget="*",
permActions="view")

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のgrantPermissionに関する項を参照してください。

2. 第22.3.2項「Oracle SES: 構成」で作成したクロール管理ユーザーにクロール・アプリケーション・ロールを付与します。次に例を示します。

grantAppRole(appStripe="webcenter",
appRoleName="webcenter#-#defaultcrawl",
principalClass="weblogic.security.principal.WLSUserImpl",
principalName="mycrawladmin");

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のgrantAppRoleに関する項を参照してください。

注意:

WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

4. WebCenter PortalでOracle SESクローラを有効にします。
同じWLSTコマンドを使用して、クローラ・プロパティを設定して(つまり、クローラを有効/無効にして)、Spacesクローラのフル・クロールの間隔を指定できます。デフォルトでは、Spacesクローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

次に例を示します。

setSpacesCrawlProperties(appName='webcenter',
fullCrawlIntervalInHours=168,
spacesCrawlEnabled = true,
documentCrawlEnabled=true,
discussionsCrawlEnabled=true)

ノート:

Oracle SES検索を有効にするには、spacesCrawlEnabled、documentCrawlEnabledおよびdiscussionsCrawlEnabledパラメータは、すべてtrueに設定する必要があります。

クラスタ化されたインスタンスでは、serverパラメータが追加で必要です。たとえば、server="WC_Spaces1"のようになります。

次の例は、Spacesが8日ごとにSpacesクローラによりフル・クロールを実行するように指定します。

setSpacesCrawlProperties(appName='webcenter',fullCrawlIntervalInHours=192)

またWLSTを使用して、フル・クロールの間隔(Spacesクローラ)など、WebCenter Portalの現在のクロール設定を返すようにすることもできます。たとえば、次のコマンドはSpacesの現在のクロール設定を返します。

getSpacesCrawlProperties(appName='webcenter')

WebCenter Spaces Crawl Properties:
-----------------
fullCrawlIntervalInHours: 124
spacesCrawlEnabled:       true
documentCrawlEnabled:     true
discussionsCrawlEnabled:  true

5. listDocumentsSpacesPropertiesコマンドを使用して、バックエンドContent ServerがこのWebCenter Portalアプリケーションを識別するために使用する一意の名前と、WebCenter Portalがドキュメントを保存するために使用するプライマリContent Serverの接続名を特定します。次に例を示します。

listDocumentsSpacesProperties(appName='webcenter')

レスポンスは次のようになります。

The Documents Spaces container is "/WebCenter1109"
The Documents repository administrator is "sysadmin"
The Documents application name is "WC1109"
The Documents primary connection is "stxxl18-ucm11g"

注意:

返されるアプリケーション名とプライマリ接続を記録してください。これらの値は、後で(第22.6.4.2項「ドキュメントを検索するためのOracle SESの設定」で)Oracle SESでドキュメントをクロールするよう設定する際に必要になります。

注意:

WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.6.1.1 WLSTを使用した検索パラメータの構成

WLSTコマンドのsetSearchConfigを使用して、検索パラメータを変更します。

例22-7は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例22-7 ソース・グループの設定

setSearchSESConfig(appName='webcenter',
dataGroup='MySources')

ここで、dataGroupは、第22.5.3.4項「追加のOracle SES構成」(Frameworkアプリケーション用)または第22.6.4.6項「追加のOracle SES構成」(Spacesアプリケーション用)で作成するソース・グループです。

例22-8は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例22-8 表示される検索結果数の増加

setSearchConfig(appName='webcenter',
numResultsMain=10)

例22-9は、サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整してください。

例22-9 WebCenter Portalで検索結果を待機する最大時間の構成

setSearchConfig(appName='webcenter',
executionTimeout=10000)

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

22.6.1.2 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SES検索を有効化または無効化したり、検索設定を構成できます。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、第6.2項「スペース・アプリケーションのホームページへの移動」または第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. Oracle SESアダプタまたはデフォルトのWebCenter Portalアダプタを有効にするよう選択し、「適用」をクリックします(図22-23)。
Spacesクローラのフル・クロール間の間隔を指定できます。デフォルトでは、Spacesクローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(3つのクローラすべてにおいて、増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

必要に応じて検索パラメータを構成できます。

- Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

- 実行タイムアウト: サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

- 実行者の準備タイムアウト: サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

- サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、サービス当たりの検索結果数を入力します。

- サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

- 検索ページの保存済の検索の数: 「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません。

図22-23 WebCenter Portal検索のアプリケーション設定

「図22-23 WebCenter Portal検索のアプリケーション設定」の説明

22.6.2 Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content: Content Server(特に、WebCenter Portalがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

1. sescrawlerroleロールを作成します。

2. ユーザーsescrawlerを作成し、これにadminロールとsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

3. sceCrawlerRole=sescrawlerroleをconfig.cfgに追加します。

4. Content Serverを再起動します。

5. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図22-24)を選択します。

図22-24 Content Serverの管理

「図22-24 Content Serverの管理」の説明

3. インスタンス名のボタンをクリックします。

4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図22-25)。

図22-25 Content Serverの「コンポーネント・マネージャ」

「図22-25 Content Serverの「コンポーネント・マネージャ」」の説明

5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)
SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」をfalseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

さらに、クラスタ環境の場合のみ、feedLocパラメータで、コンテンツ・サーバーのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

7. Content Serverを再起動します。

6. Content Serverリポジトリのスナップショットを撮ります。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs

2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

3. 「すべてのソース」を選択し、「スナップショットの取得」 (図22-26)をクリックします。

図22-26 Content Serverのスナップショット

「図22-26 Content Serverのスナップショット」の説明

ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

7. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。
Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図22-11)をクリックします。

図22-27 Content Serverのスナップショット

「図22-27 Content Serverのスナップショット」の説明

2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図22-28)。

図22-28 Content Serverの「メタデータ・リスト」

「図22-28 Content Serverの「メタデータ・リスト」」の説明

空白のままにすると、Oracle SESにエクスポートされるメタデータの値のリストは、次(および「x」で始まる任意のカスタム・メタデータ・フィールド)で構成されます。dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

ただし、dFormatをこのリストに追加する必要があります。

空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらは再度追加する必要があります。「メタデータ・リスト」の値を次のように入力します。dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount, dSecurityGroup,dOriginalName,dReleaseDate,dOutDate

3. オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのリストに追加します。
たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

dFormat,dID,dDocName,dDocType,dDocAccount,dSecurityGroup,dOriginalName,dReleaseDate,dDocAuthor,dDocCreator,dDocCreatedDate,dOutDate,xCollectionID,xWCTags,xComments,xRegionDefinition

関連項目:

- 検索結果におけるMIMEタイプの表示については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの属性および絞込み機能による検索結果のカスタマイズに関する項を参照してください。

- Content Server構成の詳細は、製品に付属のDeployment Guide.pdfを参照してください。

22.6.3 Oracle SES検索のためのOracle WebCenter Portalディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。

注意:

WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。この手順は、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要となります。

該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。

1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

- OracleデータベースおよびMicrosoft SQL Serverデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

- IBM DB2データベース:
MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に混成されていることを検証します。

注意:

IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。

ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要があります。このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでのテーブルスペースの指定手順で、デフォルトのテーブルスペースとしてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

詳細は、第7章「WebCenter Portal: Frameworkアプリケーションのデプロイ」を参照してください。

2. 次のツールを実行して(まだ実行していない場合)、ディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

java -jar \
$MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
<command_line_parameters>

ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

-mds_jdbc_user user_id \
-mds_jdbc_password password \
-mds_jdbc_url url \
-discussions_jdbc_user user_id \
-discussions_jdbc_password password \
-discussions_jdbc_url url

ここでmds_jdbc_user、mds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_user、discussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

次に例を示します。

java -jar $MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
-mds_jdbc_user foo \
-mds_jdbc_password welcome1 \
-mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
-discussions_jdbc_user foo \
-discussions_jdbc_password welcome1 \
-discussions_jdbc_url jdbc:oracle:thin:@host:port:SID

22.6.4 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

1. 第22.6.4.1項「Oracle SES管理ツールへのログオン」

2. 第22.6.4.2項「ドキュメントを検索するためのOracle SESの設定」

3. 第22.6.4.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

4. 第22.6.4.4項「スペース、リスト、ページおよび人を検索するためのOracle SESの設定」

5. 第22.6.4.6項「追加のOracle SES構成」

関連項目:

Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項およびリリース・ノードを参照してください。

Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

22.6.4.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

1. ブラウザを開き、インストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

2. Oracle SES管理ユーザー名eqsysとインストール時に指定されたパスワードでログオンします。

22.6.4.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定してから、Content Serverソースを作成する必要があります。

1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。

注意:

ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、WebCenter Portalアプリケーションで使用されるドキュメントに索引付け可能な属性をWebCenter Portalで追加できるようになります。

検索属性名は一意である必要があります。2つの属性に同じ名前を使用することはできません。たとえば、属性が文字列のデータ型で存在する場合に、名前が同じで異なるデータ型の別の属性がクローラにより検出されると、そのクローラは2番目の属性を無視します。新しい属性を作成する前に、Oracle SESドキュメント内のOracle SES属性名とタイプのリストを必ず確認してください。

1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。
マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

マネージャJARファイル名: search-crawl-ucm.jar

注意:

webcenter_search_ses_plugins.zipファイルによりOracle_Home/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。

「次へ」をクリックして、「終了」をクリックします(図22-29)。

図22-29 Oracle SESでのドキュメント・サービス・マネージャの作成

「図22-29 Oracle SESでのドキュメント・サービス・マネージャの作成」の説明

2. ドキュメント・サービス・インスタンスを作成します。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」で「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図22-30)。

図22-30 ドキュメント・サービスの作成

「図22-30 ドキュメント・サービスの作成」の説明

インスタンス名の入力に加えて、次のパラメータも入力します。

WebCenterアプリケーション名: バックエンドContent ServerでこのWebCenter Portalアプリケーションを識別するために使用される一意の名前。

接続名: WebCenter PortalがSpaceドキュメントの保存に使用するプライマリContent Server接続の名前です。

WebCenter URL接頭辞: WebCenter Portalアプリケーションがデプロイされるホストおよびポート。例: http://myhost:8888。

注意:

listDocumentsSpacesPropertiesコマンドを使用して、第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」の説明に従って、Spacesのアプリケーション名と接続名を特定してください。

3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします。
名前を入力して前の手順で作成したインスタンスを選択します。

2. ドキュメントのContent Serverソースを作成します。

関連項目:

Content Serverソースを作成する別の方法は、第22.6.5項「WLSTを使用した検索クローラの構成」を参照してください。

1. 「ホーム」→「ソース」に移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle Content Server」を選択し、「作成」(図22-31)をクリックします。

図22-31 Oracle Content Serverソースの作成

「図22-31 Oracle Content Serverソースの作成」の説明

3. 次のパラメータを入力します。
ソース名: unique_name

構成URL: Content_Server_SES_Crawler_Export_endpoint (例: http://host:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default)

注意:

source=defaultパラメータは、SESクローラ・エクスポートの構成で作成されたソースの名前を示します。デフォルトのソースが作成され、自動的にdefaultと名付けられます。

認証タイプ:

Content ServerがSSOで保護されない場合、NATIVEと入力します。

Content ServerがOracle SSOで保護される場合、ORASSOと入力します。

ユーザーID: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。

特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

パスワード: このContent Serverユーザーのパスワード。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このパラメータは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

Oracle SSOログインURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/mysso/signon.jsp?site2pstoretoken=

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

Oracle SSOアクションURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/sso/auth

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

「次へ」をクリックします(図22-32)。

図22-32 Oracle Content Serverソースのパラメータ

「図22-32 Oracle Content Serverソースのパラメータ」の説明

4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(デフォルトで入力されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.stellent.StellentAuthManager

Jarファイル名: oracleapplications/StellentCrawler.jar

認可用HTTPエンドポイント: 例: http://host:port/cs/idcplg

表示URL接頭辞: 例: http://host:port/cs

認証タイプ: NATIVEまたはORASSO

管理者ユーザー: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

管理者のパスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力します。ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このフィールドは空白のままにします。

5. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

6. 「有効化」をクリックして作成したパイプラインを選択します。

22.6.4.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalのディスカッションとお知らせを検索するには、まず、ディスカッション用とお知らせ用の2つのOracle SESデータベース・ソースを設定する必要があります。たとえば、ディスカッションのソースには、ソース名GS_DiscussionsおよびFORUMCRAWLER_VWのビューが設定され、お知らせのソースには、ソース名GS_AnnouncementsおよびANNOUNCEMENTS_VWのビューが設定されます。

注意:

Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。

1. JDBCドライバを構成します。

1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

注意:

- Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

- DB2: IBMドライバ・ファイルdb2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。

JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

- 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

- JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素に追加します。

- 中間層を再起動します。

2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarのMETA-INF/MANIFEST.MF内のクラスパスに追加します。
例: 変更前

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更後

Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更前

Class-Path: appsjdbc.jar

変更後

Class-Path: db2jcc.jar appsjdbc.jar

KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

たとえば、IDという名前のキー属性の場合、次のようになります。

oracle : oracle.jdbc.driver.OracleDriver, ID

クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDはKEYVALの別名です。

SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only

OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

- Oracle: oracle.jdbc.driver.OracleDriver

- SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

2. IBM DB2データベースの場合のみ、次の手順が必要となります。

1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。META-INF/MANIFEST.MFが正しく更新されたことを確認してください。正しく更新されない場合、クローラは失敗し、クローラのログ・ファイルに次のエラーが記録されます。

EQP-80406: Loading JDBC driver failed

3. Oracle_Home/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

db2: com.ibm.db2.jcc.DB2Driver

4. ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。次に例を示します。

#CLASS PATH
CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
stubs.jar :ORACLE_HOME /search/lib/plugins/oracleapplications/db2jcc.jar

5. $ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。次に例を示します。

JVM_OPTIONS= -Djava.awt.headless=true
-Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
-Doracle.home=ORACLE_HOME/search

6. $ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルを$ORACLE_HOME/search/libディレクトリにコピーします。

7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

3. ディスカッション・ソースまたはお知らせソースを作成します。

関連項目:

これらのソースを作成する別の方法は、第22.6.5項「WLSTを使用した検索クローラの構成」を参照してください。

1. Oracle SESで、「ホーム」→「ソース」に進みます。

2. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図22-33)をクリックします。

図22-33 データベース・ソースの作成

「図22-33 データベース・ソースの作成」の説明

3. 次のパラメータを入力します。
ソース名: unique_name。たとえば、ディスカッションをクロールする場合、GS_Discussions(お知らせをクロールする場合は、GS_Announcements)。

データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- IBM DB2データベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DC(MyPrefixは5文字)

パスワード: このユーザーのパスワード。

問合せ: 次のいずれかの問合せを入力します。

SELECT * FROM FORUMCRAWLER_VW
SELECT * FROM ANNOUNCECRAWLER_VW

ソース・クロール・ディスカッション・フォーラムには、FORUMCRAWLER_VWを使用します。

ソース・クロールお知らせには、ANNOUNCECRAWLER_VWを使用します。

URL接頭辞: ホスト、ポートおよびアプリケーション名を含むWebCenter PortalアプリケーションのURL接頭辞。たとえば、Webcenter Portal: Spacesの場合、http://host:port/webcenterのようになります。

「セキュリティ属性の付与」: WCSECATTR

注意:

以前のリリースのContent Serverでは、「セキュリティ属性の付与」にFORUMIDが使用されていました。

4. 「次へ」をクリックします。

5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.db.DBAuthManager

Jarファイル名: oracleapplications/DBCrawler.jar

認可データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- IBM DB2データベース: ユーザーMyPrefix_DC (MyPrefixは5文字)を入力します。

パスワード: このユーザーのパスワード

単一レコード問合せ: false

認可問合せ: (1行で)次を入力します。

SELECT DISTINCT forumID as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW
WHERE username = ? UNION SELECT DISTINCT -1 as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW

注意:

以前のリリースのContent Serverでは、次の認可問合せが使用されていました。

SELECT forumID
FROM AUTHCRAWLER_FORUM_VW
WHERE (username = ? or userID=-1)
UNION SELECT f.forumID
FROM jiveForum f, AUTHCRAWLER_CATEGORY_VW c
WHERE f.categoryID = c.categoryID AND (c.username =  ? or userID=-1)

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nickname、usernameなど)。

Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

6. 「作成」をクリックしてソースの作成を完了します。

22.6.4.4 スペース、リスト、ページおよび人を検索するためのOracle SESの設定

この項では、Oracle WebCenterソースを作成する方法について説明します。

関連項目:

Oracle WebCenterソースを作成する別の方法は、第22.6.5項「WLSTを使用した検索クローラの構成」を参照してください。

1. 「ホーム」→「ソース」ページに移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle WebCenter」を選択し、「作成」(図22-34)をクリックします。

図22-34 Oracle WebCenterソースの作成

「図22-34 Oracle WebCenterソースの作成」の説明

3. 次のソース・パラメータを入力します。

注意:

WebCenter Portalの前にOracle HTTPサーバーが配置されている場合は、この手順で使用される構成URLでmod_wl_ohs.confファイルに次が必要となります。

非クラスタ環境の場合:

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost host_name
WeblogicPort port
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost host_name
WeblogicPort port
</Location>

クラスタ環境の場合:

<Location /rsscrawl>
WebLogicCluster host_name1:port,host_name2:port
SetHandler weblogic-handler
</Location>

<Location /sesUserAuth>
WebLogicCluster host_name1:port,host_name2:port
SetHandler weblogic-handler
</Location>

ここで、host_name1およびhost_name2はクラスタ・ノードで、portはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーのリスニング・ポート番号です。

関連項目:

WebCenter PortalをOracle Access Managerとともに使用する方法の詳細は、第31.2.3.1項「OAM 11gのインストールと構成」を参照してください。

ソース名: unique_name

構成URL: host:port_of_WebCenterSpaces/rsscrawl。例: http://myhost:8888/rsscrawl

認証タイプ: BASIC

ユーザーID: 第22.3.2項「Oracle SES: 構成」で登録したクロール管理ユーザー。例: mycrawladmin

パスワード: クロール管理ユーザーのパスワード

レルム: jazn.com

Oracle SSOログインURL: このフィールドは空白のままにします。

Oracle SSOアクションURL: このフィールドは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

接続の試行数: データ・フィードにアクセスするためまたはステータス・フィードをアップロードするための接続試行の最大数

「次へ」をクリックします(図22-35)。

図22-35 Oracle WebCenterソースのパラメータ

「図22-35 Oracle WebCenterソースのパラメータ」の説明

4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページで、「プラグイン・クラス名」、「Jarファイル名」、「認可エンドポイント」は、事前に移入されています。
次のプラグイン・パラメータを入力します。

レルム: jazn.com

ユーザーID: 第22.3.2項「Oracle SES: 構成」で登録したクロール管理ユーザー。例: mycrawladmin

パスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を参照するには、Oracle SESの「グローバル設定」→「アイデンティティ管理設定」ページに進みます。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(例: nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

5. 「作成」をクリックしてソースの作成を完了します。

22.6.4.5 スペース・クローラからのサービスの除外

スペース・クローラは次のサービスを検索するためにデータを収集します。

- oracle.webcenter.peopleconnections.profile (ピープル・コネクション)

- oracle.webcenter.community (スペース)

- oracle.webcenter.page (ページ)

- oracle.webcenter.list (リスト)

これらのサービスのいずれかの検索を無効にするには、URLパラメータ?excludedServiceIdsを使用します。Oracle SESでOracle WebCenterソースを設定する際は、/rsscrawlの後に?excludedServiceIdsを追加します。Spacesをクローリングする場合は、このパラメータを、除外するサービスIDのカンマ区切りのリストと同一に設定します。

例22-10 ピープル・コネクションのクロールの無効化

/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile

例22-11 ページのクロールの無効化

/rsscrawl?excludedServiceIds=oracle.webcenter.page

例22-12 ピープル・コネクションおよびページのクロールの無効化

/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile,oracle.webcenter.page

22.6.4.6 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

1. Content Server、ディスカッション、お知らせおよびWebCenter Portalサービスの作成したソースの名前を含む、ソース・グループを作成します。

1. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

2. 第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」で入力したのと同じソース・グループ名を入力します。

3. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Oracle Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

4. 「完了」をクリックします。

2. 必要に応じてセキュリティ・フィルタ有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くすることをお薦めします。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用します。)
たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」に0を入力します。

セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。
この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。

注意:

WLSTでfullCrawlIntervalInHoursパラメータを使用して、またはFusion Middleware ControlでFull Crawl Intervalパラメータを使用してスペース・クローラのスケジュールを設定できます。

「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。

注意:

Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、第22.6.2項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」を参照してください。

22.6.5 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、クローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

次の例に、これらのコマンドの一部を示します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の検索: Oracle SES検索クローラに関する項を参照してください。

例22-13 WLSTでのスペース・クローラの作成

createSpacesCrawler(
'webcenter', 'webcenter_host', 'webcenter_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'webcenter-crawl-user', 'webcenter-crawl-user-pw', '/tmp', 'authentication-id-format', 'ACCEPT_ALL', 'PROCESS_ALL', 'MANUAL', 1, 1,
'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

- webcenter_host = WebCenter Portalのホスト名

- webcenter_port = WebCenter Portalのポート番号

- ses-host = Oracle SESホスト名

- ses-port = Oracle SESポート番号

- ses-admin-pw = Oracle SES管理ユーザー・パスワード

- webcenter-crawl-user = WebCenter Portalクロール・ユーザー名

- webcenter-crawl-user = WebCenter Portalクロール・ユーザー・パスワード

- authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

例22-14 WLSTでのドキュメント・クローラの作成

createDocumentsCrawler(
'portal', 'portal_host', 'portal_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'http://ucm-host:ucm-port/cs/idcplg?IdcService=
SES_CRAWLER_DOWNLOAD_CONFIG&source=default', 'ucm-crawl-user',
'ucm-crawl-user-pw', '/tmp',
'http://ucm-host:ucm-port/cs/idcplg', 'http://ucm-host:ucm-port/cs',
'Idc Security /cs/idcplg', 'authentication-id-format', 'Document-pipeline',
'ACCEPT_ALL', 'PROCESS_CHANGED', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

- portal = この操作を実行するWebCenter Portalアプリケーションの名前

- portal_host = アプリケーションを実行するシステムのホスト名

- portal_port = アプリケーションにアクセスするために使用されるポート番号

- ses-host = Oracle SESホスト名

- ses-port = Oracle SESポート番号

- ses-admin-pw = Oracle SES管理ユーザー・パスワード

- ucm-host = Content Serverホスト名

- ucm-port = Content Serverポート番号

- ucm-crawl-user = Content Serverクロール・ユーザー名

- ucm-crawl-user-pw = Content Serverクロール・ユーザー・パスワード

- authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

- Document-pipeline = このWebCenter Portalインスタンスのために作成されたOracle SES上のドキュメント・パイプライン

例22-15 WLSTでのディスカッション・クローラの作成

createDiscussionsCrawler(
'webcenter','webcenter_host','webcenter_port',
'http://ses-host:ses-port/search/api/admin/AdminService', 'ses-admin-pw',
'jdbc:oracle:thin:@database-host:database-port:database-sid',
'Jive-crawler-schema','Jive-crawler-schema-pw', 'authentication-id-format',
'ACCEPT_ALL', 'PROCESS_ALL', 'MANUAL', 1, 1, 'MONDAY', 1, 1, 1, 1)

各要素の意味は次のとおりです。

- webcenter_host = WebCenter Portalのホスト名

- webcenter_port = WebCenter Portalのポート番号

- ses-host = Oracle SESホスト名

- ses-port = Oracle SESポート番号

- ses-admin-pw = Oracle SES管理ユーザー・パスワード

- database-host = Oracle WebCenter Portalのディスカッション・サーバー・データベースのホスト名

- database-port = ディスカッション・サーバー・データベースのポート番号

- database-sid = ディスカッション・データベース名またはSID

- Jive-crawler-schema = ディスカッション・サーバー・クローラのスキーマ名。RCUから接頭辞を決定し、rcu-prefix_DISCUSSION_CRAWLERを使用します。

- Jive-crawler-schema-pw = Oracle WebCenter Portalのディスカッション・サーバー・クローラ・スキーマのパスワード

- authentication-id-format = Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合は、ニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

注意:

WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

22.6.6 Pythonスクリプトを使用したSpacesのためのOracle SES検索の構成

サンプルのPythonスクリプトは、第22.6項「Spacesアプリケーションを検索するためのOracle SESの構成」でWLSTコマンドを使用して行われる手順を実行します。サンプル・スクリプトは次のタスクを実行します。

- Oracle SES上でのフェデレーション・トラステッド・エンティティの作成

- WebCenter Portalでのクロール・ロールを持つクロール・ユーザーの作成

- WebCenter PortalでのOracle SESへの接続の作成

- Oracle SESでのWebCenter Portalクロール・ソースの作成

- Oracle SESでのContent Serverソースの作成

- Oracle SESでのディスカッション・ソースとお知らせソースの作成

注意:

このスクリプトはOracle SES 11.1.2以降でのみサポートされます。

このサンプル・スクリプトには次の前提条件があります。

- 第22.6.2項「Oracle SES検索のためのOracle WebCenter Portal: Content Serverの設定」

- 第22.6.3項「Oracle SES検索のためのOracle WebCenter Portalディスカッション・サーバーの設定」

- 第22.6.4項「WebCenter Portalを検索するためのOracle SESの設定」(クロール・ソースを作成するための手順を除く)

サンプルPythonスクリプト・ファイルとそのプロパティ・ファイルは、$WC_ORACLE_HOME/webcenter/scripts/ses_11.1.2/ディレクトリにあります。

サンプルPythonスクリプトを使用するには次の手順に従ってください。

1. ディレクトリを参照するように環境変数を設定します。次に例を示します。

setenv SESDIR Oracle_WC1/webcenter/scripts/ses_11.1.2/

2. 適切な値でConfigureSES.propertiesファイルを更新します。

3. デフォルト・ディレクトリをwlst.shスクリプトのディレクトリに設定します。次に例を示します。

cd Oracle_WC1/oracle/as11gr1wc/common/bin/

4. ConfigureSES.pyスクリプトをConfigureSES.propertiesで実行します。次に例を示します。

./wlst.sh $SESDIR/ConfigureSES.py $SESDIR/ConfigureSES.properties

5. Pythonスクリプトが正常に完了したら、WebCenter Portalを再起動します。

22.6.7 ページ・コンテンツのクロールのヒント

Frameworkアプリケーションでページ・コンテンツをクロールするには、次のガイドラインに従ってください。

- ページ・テンプレートで、コマンド・リンク(af:commandLink)のかわりに実行リンク(af:goLink)を使用してページをリンクとしてレンダリングします。

- クロール中はJDeveloperで反復開発を無効にします。反復開発を使用すると、アプリケーションの実行中に変更を加えて、ブラウザでページを更新することによりそれらの変更の結果をすぐに表示することが可能になります。反復開発機能は、特定の最適化機能を無効にすることにより動作します。
反復開発はデフォルトで有効にされています。この機能を無効にする手順は次のとおりです。

1. JDeveloperで、「アプリケーション」メニューから、「アプリケーション・プロパティ」を選択します。

2. 「アプリケーション・プロパティ」ダイアログの左側で、「実行」ノードを開きます。

3. 「WebCenter Portal」を選択します。

4. 「反復開発の有効化」の選択を解除します。

5. 「OK」をクリックします。

22.7 Oracle SES検索に関する問題のトラブルシューティング

この項では、Oracle SES検索を管理する際のトラブルシューティングのヒントを提供します。内容は次のとおりです。

- 第22.7.1項「検索結果が見つからない」

- 第22.7.2項「検索失敗のエラー」

- 第22.7.3項「WebCenter Portalに「表示」権限を付与できない」

- 第22.7.4項「ソース・グループまたはソース・タイプによるOracle SESの結果の制限」

- 第22.7.5項「検索結果に保護されたリソースが含まれない」

- 第22.7.6項「検索結果にドキュメントが含まれない」

- 第22.7.7項「検索結果にディスカッションとお知らせが含まれない」

- 第22.7.8項「検索結果に最近追加されたリソースが含まれない」

- 第22.7.9項「検索結果に認可の変更が反映されない」

- 第22.7.10項「検索結果に幅広いユーザーに利用可能なリソースが含まれない」

22.7.1 検索結果が見つからない

問題

検索結果が見つかりません。

解決策

次のことを確認します。

- Oracle SES接続

- ドキュメントとディスカッションの接続

- WebCenter Portalのクロール構成

- Oracle SES構成

- ユーザー認証

- Oracle SESのクロール

- Oracle SESの認可

22.7.1.1 Oracle SES接続

Oracle SES SOAP URLにアクセスできること、およびOracle SESへの接続のプロパティが正しいことを確認してください。

詳細は、第22.4.5項「Oracle SES接続のテスト」を参照してください。

22.7.1.2 ドキュメントとディスカッションの接続

WebCenter PortalにContent Serverとディスカッション・サーバーへの接続が存在することを確認してください。

Oracle SES検索ログには、WebCenter PortalサービスがOracle SES検索から除外されているかどうかが示されます。Oracle SESインスタンスで検索ログ・ファイルを探し、ログ・ファイルでtotalSearchTimeを確認してください。

サービスが除外されていない(つまり、Oracle SES検索がすべてのWebCenter Portalサービスに対して有効にされている)場合は、次のようになります。

req=Search userName=vicki totalSearchTime=1150ms userQuery=0712>

サービスが除外されている(つまり、Oracle SES検索がドキュメント、ディスカッション、およびお知らせで有効にされていない)場合は、次のようになります。

req=Search userName=vicki totalSearchTime=1133ms userQuery=0712
-wc_serviceId:oracle.webcenter.doclib
-wc_serviceId:oracle.webcenter.collab.forum
-wc_serviceId:oracle.webcenter.collab.announcement>

22.7.1.3 WebCenter Portalのクロール構成

第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」の説明に従って、Fusion Middleware ControlまたはWLSTを使用して、Oracle SES検索がWebCenter Portalで有効にされていることを確認します。

22.7.1.4 Oracle SES構成

1. Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの検索サービスのバックエンド要件に関する項およびリリース・ノードを参照してください。

2. Oracle SESが、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成されていることを確認します。また、WebCenter PortalとOracle SESが同じアイデンティティ管理システム(Oracle Internet Directoryなど)を使用していることを確認します。使用するすべてのリポジトリ(WebCenter Portal: Spaces、WebCenter Portal Content: Content Server、Oracle WebCenter Portalのディスカッション・サーバーなど)は、Oracle SESと同じユーザー・ベースを共有している必要があります。
さらに、WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。詳細は、第22.3.2項「Oracle SES: 構成」を参照してください。

Oracle SESがフェデレーション・トラステッド・エンティティ・ユーザーと接続されていることをテストするには、第22.4.5項「Oracle SES接続のテスト」を参照してください。

22.7.1.5 ユーザー認証

WebCenter Portalアイデンティティ・プラグイン、Oracle SESおよび構成されているすべてのデータ・リポジトリ(Content Serverやディスカッション・サーバーなど)にユーザーが存在すること(つまりそのユーザーがログオンできること)を確認します。

WebCenter Portal診断ログのOracle SESプロキシ・ログイン・エラーは、次のように表示されます。

Received status "failed" during proxy login with application entity "weblogic" to
Oracle SES at [http://host:port/search/query/OracleSearch], as search user
"vicki". Defaulting to public.

22.7.1.6 Oracle SESのクロール

Oracle SESがすべてのソースで正常にクロールを実行したことを確認します。

1. Oracle SES管理ツールで、「ホーム」→「スケジュール」タブに移動します。「ログ・ファイル」アイコンをクリックし、ソースのログ・ファイルを表示します。完全なログの場所を取得するには、「ステータス」リンクをクリックします。「クローラの進捗状況のサマリーおよびソース別ログ・ファイル」セクションに、ログ・ファイルのフル・パスが表示されます。

2. Oracle SESが認証エラーによりContent Serverのクロール・エンドポイントにログインできない場合、次のエラーがログに記録されます。

EQP-60303: Exiting saxthread due to errors

EQP-80330: Unrecognized QName <http://schemas.xmlsoap.org/soap/envelope/>:Envelope oracle.search.sdk.crawler.PluginException

3. Oracle WebCenterソースの場合、rsscrawlサーブレットが使用できないかどうかを確認します。次に例を示します。

FATAL      main            EQP-80309: Exception while opening a stream to the URI: https://example.com:port/rsscrawl?command=GetControl

4. Content Serverソースの場合、パスワードが無効であるかどうかを確認します。次に例を示します。

XML error

5. 次の組合せを使用して、Oracle SES管理ツール内のクロール・プロセスを監視します。

1. 「ホーム」→「スケジュール」ページでクローラの進捗状況とステータスを確認します(「ステータスのリフレッシュ」をクリック)。「ステータス」ページで、クロールの統計を表示できます。

2. 「ホーム」→「スケジュール」→「クローラの進行状況のサマリー」→「統計」ページでクローラの統計を監視します。

3. 「ホーム」→「一般」ページおよび「ホーム」→「統計」ページで検索の統計を監視します。

クロールのパフォーマンスを調整するためのヒントは、Oracle Secure Enterprise Search管理者ガイドを参照してください。

6. さらに、Content Serverインスタンス上のスナップショットとデータフィード、およびOracle WebCenter Portalのディスカッション・サーバー・データベースを調べてください。

22.7.1.7 Oracle SESの認可

1. Oracle SES管理ツールで、「ホーム」→「ソース」タブに移動します。

2. ソースの「編集」アイコンをクリックし、ソース構成のタブを確認します。

3. 「認可」タブをクリックして、認可接続文字列、ユーザー名、パスワードおよび認可ユーザーID形式を確認します。

4. Oracle SESログ・ファイル(前の手順で説明)を調べます。URL値を含むフレーズを探してください。次に例を示します。

ORA-01017: invalid username/password error

Oracle SES管理ツールの詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

22.7.2 検索失敗のエラー

問題

検索後に次の検索失敗のメッセージが断続的に表示される場合があります。

Search failure: time out error
Search failure: problem preparing search executor
Search failure: problem with execution

解決策

しばらく待ってから、検索を再試行してください。これらのメッセージはサービスがタイムアウトした場合に表示され、このタイムアウトは多くの場合システムの負荷に依存します。タイムアウト・エラーが続く場合は、setSearchConfigコマンドのexecutionTimeoutパラメータを調整してください。

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

22.7.3 WebCenter Portalに「表示」権限を付与できない

問題

第22.6.1項「Oracle SES検索のためのWebCenter Portal: Spacesの設定」の手順に従ってview権限を付与しようとすると次のエラーが表示されます。

Command FAILED, Reason: javax.naming.directory.AttributeInUseException: [LDAP: e
rror code 20 - uniquemember attribute has duplicate value.]; remaining name 'orc
lguid=F0CC506017B711DFBFFED9EA6A94EAEC,cn=Permissions,cn=JAAS Policy,cn=webcente
r,cn=wc_domain,cn=JPSContext,cn=jpsroot_webcenter_dadvmc0057'

解決策

このエラーは権限の付与時に表示されます。エラーを無視してください。

22.7.4 ソース・グループまたはソース・タイプによるOracle SESの結果の制限

問題

検索結果をソース・グループまたはソース・タイプで制限する必要があります。

解決策

Oracle SES管理ツールで、「ホーム」→「ソース」→「フェデレーテッド・ソースのカスタマイズ」→「検索制限」ページに移動し、検索の制限を設定します。またはフィルタを使用します(各フィルタは検索結果の制限として機能します)。

Oracle SESの使用方法の詳細は、Oracle Fusion Middlewareドキュメント・ライブラリ(WebCenter Portal製品領域内)でOracle SESドキュメントを参照してください。

22.7.5 検索結果に保護されたリソースが含まれない

問題

検索結果に保護されたリソースが含まれません。1つの原因は、WebCenter Portalユーザーのプロキシ・ログインがOracle SESで失敗したことです。WebCenter Portal診断ログのOracle SESプロキシ・ログイン・エラーは、次のように表示されます。

Received status "failed" during proxy login with application entity "weblogic" to Oracle SES at http://host:port/search/query/OracleSearch, as search user "vicki". Defaulting to public.

解決策

Oracle SESが、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成されていることを確認します。

また、WebCenter PortalとOracle SESが同じアイデンティティ管理システム(Oracle Internet Directoryなど)を使用していることを確認します。すべてのリポジトリ(WebCenter Portal: Spaces、WebCenter Portal Content: Content Server、Oracle WebCenter Portalのディスカッション・サーバーなど)は、Oracle SESと同じユーザー・ベースを共有している必要があります。

さらに、WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。

問題

検索結果に保護されたリソースが含まれません。もう一つの原因は、認可エンドポイントが正しく構成されていないことです。Oracle SESインスタンスで検索ログ・ファイルを探します。URL値を含むフレーズを探してください。次に例を示します。

EQP-80309: Exception while opening a stream to the URI:
http://<host>:<port>/sesUserAuth?userId=<end-user-name>

QueryFilterPlugin returned null or empty array value for security attribute
"WCSECATTR". Values required for all security attributes.

解決策

1. Oracle SES管理ツールで、「ホーム」→「ソース」タブに移動します。

2. ソースの「編集」アイコンをクリックし、ソース構成のタブを確認します。

3. 「認可」タブをクリックして、認可接続文字列、ユーザー名、パスワードおよび認可ユーザーID形式を確認します。

問題

検索結果に保護されたリソースが含まれません。さらにもう1つの原因は、認可エンドポイントが認可データを返していないことです。

Oracle SESインスタンスで検索ログ・ファイルを探します。URL値を含むフレーズを探してください。次に例を示します。

A security filter authorization timeout for dsid = # occurred after 10000 milliseconds.

解決策

クロール・ソースの数を減らします。

22.7.6 検索結果にドキュメントが含まれない

問題

検索結果にドキュメントが含まれません。Content Serverドキュメントのクロールが失敗します。

解決策

1. Oracle SES管理ツールで、「ホーム」→「スケジュール」タブに移動します。

2. 「ログ・ファイル」アイコンをクリックし、ソースのログ・ファイルを表示します。完全なログの場所を取得するには、「ステータス」リンクをクリックします。

3. 「クローラの進捗状況のサマリーおよびソース別ログ・ファイル」セクションに、ログ・ファイルのフル・パスが表示されます。Oracle SESが認証エラーによりContent Serverのクロール・エンドポイントにログインできない場合、次のエラーがログに記録されます。

EQP-60303: Exiting saxthread due to errors,
EQP-80330: Unrecognized QName
<http://schemas.xmlsoap.org/soap/envelope/>:Envelope
oracle.search.sdk.crawler.PluginException

4. Content Serverクロール・ソースの構成パラメータを更新します。

22.7.7 検索結果にディスカッションとお知らせが含まれない

問題

クロール・ソースで、「認可」タブで「単一レコード問合せ」パラメータがtrueに設定されています。

解決策

「単一レコード問合せ」パラメータをfalseに設定します。

問題

アイデンティティ管理システムでは大文字と小文字が混在したユーザー名を使用しますが、Oracle WebCenter Portalのディスカッション・サーバー(Jive)データベースでは、すべて小文字のユーザー名を使用します。クロール・ソースの認可問合せでは、ユーザー名のパラメータにLOWER()関数を適用する必要があります。

解決策

認可問合せが次の文のようであることを確認します。

SELECT forumID as WCSECATTR FROM AUTHCRAWLER_FORUM_VW WHERE LOWER(username) = LOWER(?) UNION SELECT DISTINCT -1 as WCSECATTR FROM AUTHCRAWLER_FORUM_VW

22.7.8 検索結果に最近追加されたリソースが含まれない

問題

新規リソースが最近作成されましたが、検索結果にその新規リソースが含まれません。

解決策

新規リソースが検索結果で返されるようにするには、まずそのリソースをクロールおよび索引付けする必要があります。新しいコンテンツを索引付けするために、クロール・スケジュールが定期的に実行されます。新規リソースが頻繁に作成される場合は、クロール・スケジュールの頻度を増やしてください。新規リソースをすぐにクロールする必要がある場合は、クロール・スケジュールを手動で開始してください。

22.7.9 検索結果に認可の変更が反映されない

問題

一部のリソースには、WebCenter Portalでの認可の変更により、より多くのユーザーがアクセス可能になります。たとえば、スペース内のリソースには、現在すべての認証ユーザーがアクセスできます。影響を受けるユーザーはこれらのリソースを検索できません。

解決策

認可データはOracle SESにキャッシュされます。キャッシュは、Oracle SESの「セキュリティ・フィルタ有効期間(分)」グローバル設定により無効にされます。デフォルト値は1日(1440分)です。認可データへの変更の標準的な頻度に応じて、値を調整してください。

22.7.10 検索結果に幅広いユーザーに利用可能なリソースが含まれない

問題

WebCenter Portalのスペースはパブリックにアクセス可能ですが、認証されていないユーザーは検索結果でスペース・リソースを表示できません。

解決策

デフォルトでは、スペースがパブリックに対してアクセス可能であるとしても、リソースへの「表示」アクセス権はスペースのメンバーにのみ付与されます。リソースの「表示」アクセス権を非メンバーに明示的に付与する必要があります。スペースの設定ページに移動し、「ロール」タブで対象のロールを選択し、リソースへの「表示」アクセス権を付与するよう選択します。

23 ワークリスト・サービスの管理

この章では、Oracle WebLogic ServerにデプロイされたWebCenter Portalアプリケーション(SpacesアプリケーションとFrameworkアプリケーション)のためのワークリストを構成および管理する方法を説明します。

WebCenter Portalアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してください。デプロイ後にSpacesアプリケーションやFrameworkアプリケーションに加えた変更は、MDSメタデータにカスタマイズとして格納されます。第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用してワークリスト・サービスの構成に対して加えた変更は、動的ではありません。変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- 第23.1項「ワークリスト・サービスの構成ロードマップ」

- 第23.2項「BPEL接続に関する必要な知識」

- 第23.3項「BPELサーバーの前提条件」

- 第23.4項「ワークリスト接続の設定」

- 第23.5項「ワークリストに関する問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

23.1 ワークリスト・サービスの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- 第23.1.1項「ロードマップ: WebCenter Portal: Spaces用のワークリスト・サービスの構成」

- 第23.1.2項「ロードマップ: Frameworkアプリケーション用のワークリスト・サービスの構成」

23.1.1 ロードマップ: WebCenter Portal: Spaces用のワークリスト・サービスの構成

この項の図23-1と表23-1に、Spacesアプリケーションでワークリスト・サービスを動作させるための前提条件と必要な作業の概要を示します。

図23-1 Spaces用のワークリスト・サービスの構成

「図23-1 Spaces用のワークリスト・サービスの構成」の説明

表23-1 Spaces用のワークリスト・サービスの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portal: SpacesとOracle SOA Suiteをインストールします

管理者

2. 次のいずれかのツールを使用してワークリスト接続を構成します脚注 1

- Fusion Middleware Controlを使用します

- WLST

Fusion Middleware Controlを使用する場合

- 2.a ワークリスト接続を作成します

- 2.b ワークリスト接続をアクティブにします

WLSTを使用する場合

- 2.a createBPELconnectionを実行します

- 2.b addWorklistConnectionを実行します

管理者

3. (オプション)WebCenter Portal: Spacesワークフローを構成します脚注参照 1

3.a 次のいずれかのツールを使用して、WebCenter Portal: Spacesワークフロー用のBPELサーバー接続を指定します

- Fusion Middleware Control

- WLST (setSpacesWorkflowConnectionName)

3.b WS-securityのキーストアを構成します

管理者

4. (オプション)追加のBPELワークフローをデプロイします

管理者

5. (オプション)Spacesと同じアイデンティティ・ストアを使用するようにBPELサーバーを構成します脚注参照 1

管理者

6. (オプション)BPELサーバーへの接続を保護します

6.a シングル・サインオンを構成します

6.b WS-Securityを構成します

6.c SSLを構成します

エンド・ユーザー

7. Spacesでワークリスト・サービスが動作していることをテストします

7.a Spacesにログインします

7.b ページにワークリスト・タスク・フローを追加します

7.c ワークリスト・イベントを生成します

7.d タスク・フローにイベント情報が表示されることを確認します

脚注 1 初期設定で自動構成済

23.1.2 ロードマップ: Frameworkアプリケーション用のワークリスト・サービスの構成

この項の図23-2と表23-2に、Frameworkアプリケーションでワークリスト・サービスを動作させるための前提条件と必要な作業の概要を示します。

図23-2 Frameworkアプリケーション用のワークリスト・サービスの構成

「図23-2 Frameworkアプリケーション用のワークリスト・サービスの構成」の説明

表23-2 Frameworkアプリケーション用のワークリスト・サービスの構成

担当者

タスク

サブタスク

管理者

1. WebCenter PortalとOracle SOA Suiteをインストールします

開発者

2. ワークリスト・サービスをFrameworkアプリケーションに統合します

2.a ワークリスト接続を作成します

2.b JDeveloperでワークリスト・タスク・フローをページに追加します

開発者/管理者

3. 次のいずれかのツールを使用してFrameworkアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール(管理者)

管理者

4. 追加のBPELワークフローをデプロイします

管理者

5. (オプション): アプリケーションと同じアイデンティティ・ストアを使用するようにBPELサーバーを構成します

管理者

6. (オプション): BPELサーバーへの接続を保護します

6.a シングル・サインオンを構成します

6.b WS-Securityを構成します

6.c SSLを構成します

開発者/管理者

7. (オプション): 次のいずれかのツールを使用して接続パラメータを追加または変更します

- JDeveloper。その後、アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー

8. ワークリスト・サービスが動作していることをテストします

8.a Frameworkアプリケーションにログインします

8.b ワークリスト・イベントを生成します

8.c タスク・フローにイベント情報が表示されることを確認します

23.2 BPEL接続に関する必要な知識

BPEL接続に関する操作を行うときには、次の点に留意してください。

- ワークリスト・サービスでは、WebCenter Portalユーザーが様々なBPELサーバーからの割当てや通知を監視および管理できるように、複数の接続を使用できます。詳細は、第23.4項「ワークリスト接続の設定」を参照してください。

- WebCenter Portal: Spacesワークフローには、Oracle SOA Suiteに含まれるBPELサーバーへの単一の接続が必要です。詳細は、第9.3項「SpacesワークフローをホスティングするBPELサーバーの指定」を参照してください。

- ワークリスト・サービスとWebCenter Portal: Spacesワークフローは、同じBPELサーバー接続を共有することも、それぞれ別々のBPELサーバーに接続することもできます。現在のWebCenter PortalユーザーのワークリストにSpacesワークフローによって作成されたワークリスト・アイテムを表示できるようにするために、WebCenter Portal: Spacesワークフローとワークリスト・サービスで接続を共有することをお薦めします。

- ワークリスト・サービスは、複数のBPELサーバーからのワークリスト・アイテムを集約できるように、複数のBPEL接続にワイヤリングできます。たとえば、人事サーバーや総勘定元帳サーバーなど、様々なタイプのワークフローを実行する複数のBPELサーバーがトポロジに含まれている場合などです。

- BPEL接続は一意のURLである必要があります。そうでない場合は、同じサーバーに対して重複する問合せが作成されます。

23.3 BPELサーバーの前提条件

ワークリスト・サービスのスムーズな動作を確実にするために、次の点に留意してください。

- ワークリスト・タスク・フローを含むページは、ADFセキュリティを使用して保護する必要があります。

- ワークリスト・サービスは、BPELワークリスト・アプリケーションを介してアクセスできるOracle SOA SuiteのBPELサーバーを使用するように構成する必要があります。そのURLの形式は次のとおりです。

http://host:port/integration/worklistapp

ワークリスト・サービスがOracle SOA SuiteのBPELサーバーと同じドメインで実行されていない場合、アイデンティティ・ストア(LDAP)を共有するか(推奨)、同じユーザー名をアイデンティティ・ストアに含める必要があります。

- ワークリスト・サービスの管理対象サーバーのクロックと、Oracle SOA Suite BPELの管理対象サーバーのクロックは、アサーションの新しさをチェックするSAML認証条件NotBeforeに違反しないように同期する必要があります。

- 構成に関連する例外の存在は許されません。WLSTコマンドlistWorklistConnectionsを使用して、構成した接続を表示して接続の詳細を検証してください。接続のリストを表示した後、/integration/worklistappで追加されたURLプロパティを使用してそれらの接続を検証します。http://host:port/integration/worklistappでBPELワークリスト・アプリケーションにアクセスできることを確認してください。

- Oracle SOA Suite BPELの管理対象サーバーがアイデンティティ・ストアを使用するように構成されていて、そのアイデンティティ・ストアにBPMWorkflowAdmin (デフォルトではweblogic)が含まれていない場合、第23.5.2.2項「共有ユーザー・ディレクトリにWeblogicユーザーが含まれていない」の説明に従って、BPMWorkflowAdminユーザーを構成する必要があります。

- ワークリスト・サービスの管理対象サーバーとOracle SOA SuiteのBPELサーバーの管理対象サーバーの両方で、wsm-pmアプリケーションが問題なく実行されている必要があります。これは、次のURLを使用して検証できます。

http://host:port/wsm-pm/validator

BPELサーバーの問題を解決する方法の詳細は、第23.5項「ワークリストに関する問題のトラブルシューティング」を参照してください。

この項の内容は次のとおりです。

- 第23.3.1項「BPELサーバー: インストールと構成」

- 第23.3.2項「BPELサーバー: セキュリティに関する考慮事項」

- 第23.3.3項「BPELサーバー: WebCenter Portalでの制限事項」

23.3.1 BPELサーバー: インストールと構成

ワークリスト・サービスは、Oracle SOA Suiteに含まれるOracle BPEL Process Manager (BPEL)サーバーに依存しています。

ワークリスト・サービスを使用するには、Oracle SOA Suiteをインストールする必要があります。Oracle SOA Suiteをインストールする方法の詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイドを参照してください。

Oracle SOA Suiteのインストール後、BPELサーバーへの接続を設定することにより、ワークリスト・サービスをWebCenter Portalアプリケーションに統合できます。

23.3.2 BPELサーバー: セキュリティに関する考慮事項

ワークリスト・サービスは、現在認証されているユーザーのタスクを表示するものです。WebCenter PortalユーザーがOracle SOA SuiteのBPELサーバー上でタスクを格納および取得するには、そのユーザー名が共有ユーザー・ディレクトリ(LDAP)に存在しているか、WebCenter PortalアプリケーションとBPELサーバーの両方で同様に設定されている必要があります。

たとえば、ユーザーrsmithがワークリスト・サービスを使用してBPELサーバー上でタスクを格納および取得する場合、BPELサーバーとアプリケーションの両方にユーザーrsmithが存在している必要があります。

追加のログイン・プロンプトが表示されないようにWebCenter Portalのワークリスト・コンポーネントからBPELタスクの詳細にアクセスするには、WebCenter PortalサーバーとOracle SOA SuiteサーバーでOracle Single Sign-Onサーバーを共有するように構成する必要があります。詳細は、第31.2項「Oracle Access Manager (OAM)の構成」と第31.3項「Oracle Single Sign-On(OSSO)の構成」を参照してください。

セキュアな接続にするために、オプションでSOAとSpacesの間でWS-Securityを構成できます。詳細は、第34章「WS-Securityの構成」を参照してください。

23.3.3 BPELサーバー: WebCenter Portalでの制限事項

ワークリスト・タスク・フローは、認証されたページ内でのみ機能します。ワークリスト・タスク・フローが非保護ページ(ユーザーがログインしたアプリケーションからの移動先ではないパブリック・ページ)にある場合、「ワークリスト・コンテンツを表示するにはログインする必要があります。」という警告メッセージが表示されます。これは、現在のユーザーのセッションで、どのユーザーのタスクが問合せの対象になるかを判断できるようにするためです。

23.4 ワークリスト接続の設定

この項の内容は次のとおりです。

- 第23.4.1項「ワークリスト接続に関する必要な知識」

- 第23.4.2項「ワークリスト接続の登録」

- 第23.4.3項「ワークリスト接続のアクティブ化」

- 第23.4.4項「ワークリスト接続の詳細の変更」

- 第23.4.5項「ワークリスト接続の削除」

23.4.1 ワークリスト接続に関する必要な知識

ワークリスト・サービスを使用すると、WebCenter Portalアプリケーションで、認証済ユーザーに対して、それらのユーザーに現在割り当てられているBPELワークリスト・アイテムのリストを表示できます。BPELワークリスト・アイテムは、1つ以上のBPELワークリスト・リポジトリからのオープンなBPELタスクです。

ワークリスト・アイテムを配信するBPELサーバーごとに1つずつ接続が必要です。WebCenter Portalユーザーが様々なBPELサーバーからの割当てや通知を監視および管理できるように、複数のワークリスト接続を使用できます。

BPELサーバーに接続できない場合、その接続が使用不可能であることがワークリスト・タスク・フローによって示され、そのエラーの原因がサーバーの診断ログに記録されます。このログは、ワークリスト・コンポーネントのログ・ディレクトリをホストするサーバーにあります。Spacesアプリケーションの場合: ./user_projects/domains/base_domain/servers/WC_Spaces/logs/WC_Spaces-diagnostic.log。Frameworkアプリケーションの場合: ./user_projects/domains/base_domain/servers/WC_Spaces/logs/WC_CustomPortal-diagnostic.log。

WebCenter Portal: Spaces

Spacesで内部ワークフロー(スペース・メンバーシップ通知およびスペース・サブスクリプション・リクエスト)をサポートするためには、BPELサーバー接続が必要です。この機能を提供するBPELサーバーは常に、Oracle SOA Suiteに含まれるBPELサーバーです。詳細は、第9.3項「SpacesワークフローをホスティングするBPELサーバーの指定」を参照してください。

ワークリスト・サービスは、SOAインスタンス接続を共有できます。また、SOAインスタンス接続を共有することにより、各ユーザーのワークリスト・タスク・フロー内のスペース・アクティビティに関連するワークリスト・アイテムを表示できます。

23.4.2 ワークリスト接続の登録

この項の内容は次のとおりです。

- 第23.4.2.1項「Fusion Middleware Controlを使用したワークリスト接続の登録」

- 第23.4.2.2項「WLSTを使用したワークリスト接続の登録」

23.4.2.1 Fusion Middleware Controlを使用したワークリスト接続の登録

ワークリスト接続を登録する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ワークリスト」を選択します。

4. 新規の接続を登録するには、「追加」をクリックします(図23-3)。

図23-3 ワークリスト接続の構成

5. ワークリスト接続の一意の名前を入力し、アクティブな接続として設定します(表23-3)。この接続は、管理対象サーバーの再起動後に適用されます。

表23-3 ワークリスト接続: 名前

フィールド

説明

名前

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

この名前は、アプリケーションでワークリスト機能を使用するユーザーに対して表示できます。ユーザーは、ソートおよびグループ化の様々なオプションを使用して、ワークリストの割当てを編成できます。「ワークリスト・サーバー別にグループ化」オプションを使用すると、ここで指定した名前が表示されます。このため、他のユーザーにわかりやすい意味のある名前(たとえばHuman Resources)を入力することが重要です。

アクティブな接続

選択すると、WebCenter Portalアプリケーションでこのワークリスト接続がアクティブになります。アクティブになった後は、関連付けられたBPELサーバーからのワークリスト・アイテムがユーザーのワークリストに表示されます。

WebCenter Portalユーザーが様々なBPELサーバーからの割当てや通知を監視および管理できるように、複数のワークリスト接続を一度にアクティブにできます。なんらかの理由で接続を無効化する必要がある場合は、このオプションの選択を解除します。

（「編集」モードのみ。）チェック・ボックスは、他のコンポーネントがこの接続を共有するかどうかを示します。

- ワークリスト
この接続に関連付けられたアイテムをワークリスト・サービスで表示するかどうかを指定します。

- WebCenter Portal: Spaces
Spacesの内部ワークフロー(スペース・メンバーシップ通知やスペース・サブスクリプション・リクエストなど)に同じBPELサーバー接続を使用するかどうかを指定します。この機能を提供するBPELサーバーは、Oracle SOA Suiteに含まれるBPELサーバーです。詳細は、第9.3項「SpacesワークフローをホスティングするBPELサーバーの指定」を参照してください。

ここには示されていませんが、通知サービスでBPELサーバー接続を使用するように設定することもできます。第19.2項「通知の設定」を参照してください。

接続プロパティを変更する前に、この接続を共有する他のコンポーネントへの影響を考慮してください。

6. BPELサーバーの接続の詳細を入力します(表23-4)。

表23-4 ワークリスト接続: 接続の詳細

フィールド

説明

BPEL SOAP URL

BPELサーバーへのアクセスに必要なURLを入力します。次の形式を使用します。

protocol://host:port

例: http://mybpelserver.com:8001

注意: Spacesは、Oracle SOA Suiteに含まれているBPELサーバーを使用して、WebCenter Portal: Spacesワークフローを実装します。ワークフロー接続を設定する場合、SOA SuiteのBPELサーバーのURLをここに入力してください。詳細は、第9.3項「SpacesワークフローをホスティングするBPELサーバーの指定」を参照してください。

SAMLトークン・ポリシーURI

この接続で認証に使用するSAML (Security Assertion Markup Language)トークン・ポリシーを選択します。

SAMLは、認証および認可の権限を定義するセキュリティ・トークンを渡すためのXMLベース標準です。(レシーバとの信頼関係を持っている)証明エンティティは、送信者保証と呼ばれる方式によってサブジェクトの検証を保証します。選択可能なオプションは次のとおりです。

- SAMLトークン・クライアント・ポリシー(oracle/wss10_saml_token_client_policy): これを選択した場合、追加のセキュリティなしの基本構成が検証されます。これはデフォルト設定です。

- メッセージ保護付きSAMLトークン・クライアント・ポリシー(oracle/wss10_saml_token_with_message_protection_client_policy): これを選択すると、SAMLベースのBPEL Webサービスを使用してセキュリティが強化されます。選択した場合、WebCenter PortalアプリケーションとBPELアプリケーションの両方でキーストアを構成する必要があります。詳細は、第34章「WS-Securityの構成」を参照してください。

受信者キーの別名

メッセージ保護付きSAMLポリシーの認証に使用される受信者キーの別名です。これが必要なのは、BPELサーバー接続で認証のためにSAMLトークン・ポリシーが使用されていて、アプリケーションのワークリスト・サービスで複数のBPELサーバー接続が使用されている場合のみです。

例: myKey

複合トポロジの受信者キーの別名を調べるには、第34.3項「複合トポロジの場合のWS-Securityの構成」を参照してください。

リンクURL

BPELサーバーへのリンクに使用されるURLを指定します。指定する必要があるのは、たとえばSSOまたはHTTPSが構成されるときなど、BPEL SOAP URLと異なる場合のみです。

protocol://host:portという形式を使用します。

例: http://mySSO.host.com:7777

パフォーマンス上の理由で、HTTPSまたはSSO環境においては、「リンクURL」ではHTTPSまたはSSO Webサーバーを介したBPELワークリスト・アイテムへのユーザー・アクセスを指定します。一方、「BPEL SOAP URL」では、HTTPSまたはSSO Webサーバーを介したリダイレクトを伴わないBPEL Webサービスへの直接アクセスを指定します。

7. 「OK」をクリックして、この接続を保存します。

8. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。正常な接続の場合、新しい(アクティブな)接続の使用を開始するにはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。
テストが失敗した場合、第23.5項「ワークリストに関する問題のトラブルシューティング」を参照してください。

ヒント:

新規に登録した接続をアクティブ化するには、第23.4.3項「ワークリスト接続のアクティブ化」に記載された手順を実行します。

23.4.2.2 WLSTを使用したワークリスト接続の登録

WLSTコマンドのcreateBPELConnectionを使用して、BPELサーバー接続を作成します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateBPELConnectionに関する項を参照してください。

新しいBPELサーバー接続をアクティブに使用するようにワークリスト・サービスを構成するには、いくつかの追加構成が必要です。詳細は、第23.4.3.2項「WLSTを使用したワークリスト接続のアクティブ化」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新規に登録した接続をアクティブ化するには、第23.4.3項「ワークリスト接続のアクティブ化」に記載された手順を実行します。

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

23.4.3 ワークリスト接続のアクティブ化

WebCenter Portalアプリケーションでは、一度に複数のワークリスト接続をアクティブにできます。複数の接続により、WebCenter Portalユーザーは複数のBPELサーバーからの割当てや通知を監視および管理できます。ワークリスト・サービスの問合せ先のSOAサーバーが現在メンテナンス中である場合、エラーや警告がログに記録されたりUIに表示されないように、アクティブな接続を一時的に無効化できます。

この項の内容は次のとおりです。

- 第23.4.3.1項「Fusion Middleware Controlを使用したワークリスト接続のアクティブ化」

- 第23.4.3.2項「WLSTを使用したワークリスト接続のアクティブ化」

23.4.3.1 Fusion Middleware Controlを使用したワークリスト接続のアクティブ化

ワークリスト接続をアクティブ化または無効化する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ワークリスト」を選択します。
「ワークリスト接続の管理」表に、現在のアクティブな接続（ある場合）が示されます。

4. アクティブ化（または無効化）するワークリスト接続を選択し、「編集」をクリックします。

5. 「ワークリスト」チェック・ボックスを選択して、WebCenter Portalアプリケーションでこのワークリスト接続をアクティブ化します。
アクティブになった後は、関連付けられたBPELサーバーからのワークリスト・アイテムがワークリスト・タスク・フロー内に表示されます。なんらかの理由で接続を無効化する必要がある場合は、このオプションの選択を解除します。

6. 「OK」をクリックして、接続を更新します。

7. 「テスト」をクリックして、アクティブ化した接続が機能するかどうかを検証します。接続が正常にアクティブ化されると、更新した接続の使用を開始するにはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

23.4.3.2 WLSTを使用したワークリスト接続のアクティブ化

WLSTコマンドのaddWorklistConnectionを使用して、ワークリスト・サービスの既存のBPEL接続をアクティブ化します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のaddWorklistConnectionに関する項を参照してください。

ワークリスト・サービスにより使用されているBPEL接続を後から無効化するには、WLSTコマンドのremoveWorklistConnectionを実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のremoveWorklistConnectionに関する項を参照してください。

現在どの接続がアクティブになっているかを調べるには、listWorklistConnectionsを使用します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

23.4.4 ワークリスト接続の詳細の変更

この項の内容は次のとおりです。

- 第23.4.4.1項「Fusion Middleware Controlを使用したワークリスト接続の詳細の変更」

- 第23.4.4.2項「WLSTを使用したワークリスト接続の詳細の変更」

23.4.4.1 Fusion Middleware Controlを使用したワークリスト接続の詳細の変更

ワークリスト接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ワークリスト」を選択します。

4. アクティブ化するワークリスト接続を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表23-4「ワークリスト接続: 接続の詳細」を参照してください。

6. 「OK」をクリックして、接続を更新します。

7. 「テスト」をクリックして、更新した接続が機能するかどうかを検証します。接続が正常に更新されると、更新した接続の使用を開始するにはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

23.4.4.2 WLSTを使用したワークリスト接続の詳細の変更

WLSTコマンドのsetBPELConnectionを使用して、既存のBPELサーバー接続の詳細を編集します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetBPELConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middleware管理者ガイド』のコマンド・ラインを使用したWebLogic管理対象サーバーの起動および停止に関する項を参照してください。

23.4.5 ワークリスト接続の削除

複数のWebCenter Portalコンポーネント(つまり、ワークリスト・サービス、通知サービスおよびSpacesワークフロー)が同じワークリスト接続を共有している場合があります。ワークリスト接続を削除する前に、Fusion Middleware Controlで「アプリケーション構成」ページへ移動して(「WebCenterポータル」→「設定」→「アプリケーション構成」)、その接続がSpacesワークフローや通知で使用されていないかどうか確認してください。

この項の内容は次のとおりです。

- 第23.4.5.1項「Fusion Middleware Controlを使用したワークリスト接続の削除」

- 第23.4.5.2項「WLSTを使用したワークリスト接続の削除」

23.4.5.1 Fusion Middleware Controlを使用したワークリスト接続の削除

ワークリスト接続を削除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ワークリスト」を選択します。

4. 削除するワークリスト接続を選択し、「削除」をクリックします。

5. 確認のため、「はい」をクリックします。

6. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第8.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

23.4.5.2 WLSTを使用したワークリスト接続の削除

WLSTコマンドのdeleteConnectionを使用して、以前にワークリスト・サービスに対して登録したBPEL接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドのremoveWorklistConnectionを使用して、adf-config.xmlで構成されているBPELサーバーを削除します。ワークリスト・サービスは指定された接続を使用しなくなりますが、BPELサーバー接続の詳細は将来利用できるようにconnections.xmlに保持されます。

connections.xmlからBPELサーバー接続を削除するには、WLSTコマンドのdeleteConnectionを使用します。

コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のremoveWorklistConnectionに関する項とdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

変更を適用するために、管理対象サーバーを再起動します。

23.5 ワークリストに関する問題のトラブルシューティング

ワークリスト・サービスでは、いくつかのミドルウェア・コンポーネントに依存して、ログインしているユーザーに対してワークリスト・アイテムを表示しているため、ワークリスト・サービスで障害が起きる原因となる要因がいくつかあります。この項で説明する問題と解決法は、発生する可能性がある一般的な問題の一部に関するものです。

この項の内容は次のとおりです。

- 第23.5.1項「アプリケーションの構成の問題が原因でワークリスト・サービスが使用できない」

- 第23.5.2項「サーバーの障害が原因でワークリスト・サービスが使用できない」

注意:

障害の原因を特定するには、構成したSOA BPELサーバーの管理対象サーバーとワークリスト・サービス・プロセスをホストしている管理対象サーバーのログ・ファイルを調べます。

23.5.1 アプリケーションの構成の問題が原因でワークリスト・サービスが使用できない

この項で説明する問題は、ワークリスト・サービスが使用不可能であることに関する問題です。ワークリスト・タスク・フローによる「ワークリスト・サービスは使用できません」というメッセージに続けて、次の警告が表示されます。

BPELワークリスト接続が設定されていないか、既存の接続構成に問題があるかのいずれかです。このアプリケーションに対してBPELワークリスト接続が少なくとも1つ設定されていることと、未解決の'ConfigurationExceptions'例外がログに記録されていないことを確認してください。

この項の内容は次のとおりです。

- 第23.5.1.1項「adf-config.xmlが存在しないBPEL接続を参照している」

- 第23.5.1.2項「adf-config.xmlにBPEL接続への参照が含まれていない」

- 第23.5.1.3項「「行がまだありません」というメッセージが表示される」

23.5.1.1 adf-config.xmlが存在しないBPEL接続を参照している

問題

adf-config.xmlファイルにリストされている接続が、アプリケーションのconnections.xmlファイルに存在していません。アプリケーションが実行されている管理対象サーバーの診断ログに次のようなエントリが存在します。

[2009-03-22T13:33:54.140+00:00] [DefaultServer] [WARNING] [WCS-32008] [oracle.webcenter.worklist.config][tid: [ACTIVE].ExecuteThread: '12' for queue: 'weblogic.kernel.Default (self-tuning)'] userId: user][ ecid: 0000I0iOmdTFk3FLN2o2ye19kTB0000V,0][APP: Worklist#V2.0 arg: Human Resources ''connection_name''という名前のBPEL接続がconnections.xmlファイルに存在しませんでした。このため、ワークリスト・サービスは必須のBPEL接続と対話できません。

解決策

ログに示されている名前のBPEL接続を作成するか、その接続を削除します。デプロイ後にワークリスト構成を更新する方法の詳細は、第23.4項「ワークリスト接続の設定」を参照してください。

開発中の場合は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の「ワークリスト・サービスの統合」を参照してください。

どの接続名が参照されているかを調べたり、ワークリスト・サービスの構成を検証するには、WLSTコマンドのlistWorklistConnections(appName='myApp', verbose=true)を実行します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistWorklistConnectionsに関する項を参照してください。

23.5.1.2 adf-config.xmlにBPEL接続への参照が含まれていない

アプリケーションのadf-config.xmlにはワークリスト・サービス接続への参照がありませんが、connections.xmlファイルにはその接続があります。

問題

アプリケーションが実行されている管理対象サーバーの診断ログに、たとえば次のようなエントリが記録されています。

[2009-03-23T10:23:56.943+00:00] [DefaultServer] [WARNING] [WCS-32009] [oracle.webcenter.worklist.config] [tid: [ACTIVE].ExecuteThread: '21' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: user] [ecid: 0000I0mqx8Fk3FLN2o2ye19lqBV000008,0] [APP: Worklist#V2.0] ワークリスト・サービスには、connections.xml内のBPELConnectionにマップされるadf-config.xml内のConnectionName構成エントリがないため、ワークリスト・サービスはこのアプリケーション用には設定されませんでした。

解決策

ワークリスト・サービスがワークリスト・アイテムの問合せを実行できるように、少なくとも1つのBPELサーバーへの接続を構成します。

デプロイ後の場合、WLSTまたはFusion Middleware Controlを使用してワークリスト接続を作成します。詳細は、第23.4.2項「ワークリスト接続の登録」を参照してください。開発中の場合、Oracle JDeveloperを使用してワークリスト接続を作成します。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の「ワークリスト・サービスの統合」を参照してください。adf-config.xmlファイルとconnections.xmlファイルは手動では変更しないでください。

23.5.1.3 「行がまだありません」というメッセージが表示される

問題

ワークリスト・タスク・フローで、「行がまだありません」というメッセージが表示され続けます。

解決策

この問題に対処するには、次のような解決法があります。

- ログインしているユーザーに対する「割当て済」のワークリスト・アイテムが存在しない場合
ログインしているユーザーにワークリスト・アイテムが割り当てられていて、それらのアイテムの状態が「割当て済」の場合、常にワークリスト・タスク・フローに表示されます。「行がまだありません」というメッセージは、ログインしているユーザーに対する割当て済ワークリスト・アイテムが存在しないことを示しています。これは問題ではなく、想定内の動作です。

このメッセージの情報が正しいことを確認するには、Oracle SOA SuiteのBPELワークリスト・アプリケーションを開いて、ワークリスト・アイテムが存在するかどうか調べます。BPELワークリスト・アプリケーションのURLは、http://host:port/integration/worklistappです。hostとportは、ワークリスト接続で使用されるものと同じです。

- ワークリスト・タスク・フローが存在しているADFページがADFで保護されていない場合
認証されたユーザーがOracle SOA SuiteのBPELサーバーへのアクセスをアプリケーション・セッションに関連付けられていないため、ワークリスト・タスク・フローがワークリスト・リポジトリに対する問合せを実行できません。そのページにADFセキュリティを適用してください。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のワークリスト・サービスのセキュリティの設定に関する項を参照してください。

23.5.2 サーバーの障害が原因でワークリスト・サービスが使用できない

ワークリスト・サービス接続が存在しているのにワークリスト・タスク・フローで「ワークリスト・サービスは使用できません」という警告が表示される場合、サーバーの障害が問題の原因となっている可能性があります。複数の接続がある場合、「これ以上のアイテムは現在はありません。」というメッセージが表示されます。これらの汎用警告メッセージは、ワークリスト・サービスとOracle SOA Suite BPELリポジトリとのやり取りに問題がある場合に表示されます。

問題の根本原因を特定するには、サービスの障害が発生した時点の管理対象サーバーの診断ログを調べます。場合によっては、Oracle SOA SuiteのBPELプロセスが実行されている管理対象サーバーのログ・ファイルも調べる必要があります。通常は、ワークリスト・アプリケーションの管理対象サーバーの診断ログに、次のようなエントリが記録されています。

[2009-03-23T11:35:21.735+00:00] [DefaultServer] [ERROR] [WCS-32100] [oracle.webcenter.worklist.model] [tid: [ACTIVE].ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: user] [ecid: 0000I0n7GBZFk3FLN2o2ye19lrBX00000L,0] [APP: Worklist#V2.0] [arg: WebCenter Worklist] WebCenterワークリストは''WebCenter Worklist''という名前のBPELワークリスト接続を問合せましたが、WebCenterエグゼキュータ・エラーが発生しました。詳細は関連する例外を参照してください。WebCenterワークリストがアプリケーション・サーバーで稼働している場合は、wsm-pmアプリケーションが稼働しているかどうかを確認してください。

このエントリには、WSセキュリティに使用されるwsm-pmアプリケーションに問題があると記されています。例外に関連する他の原因が存在する可能性もあります。これらの問題が起きた場合には、WebCenterの管理対象サーバーとOracle SOA Suiteの構成済管理対象サーバーの両方で、ログに記録された例外を調べてください。

この項の内容は次のとおりです。

- 第23.5.2.1項「アイデンティティ・ストア内のユーザーが一致しない」

- 第23.5.2.2項「共有ユーザー・ディレクトリにweblogicユーザーが含まれていない」

- 第23.5.2.3項「wsm-pmアプリケーションの問題」

- 第23.5.2.4項「クロックの同期のずれが5分を超えている」

- 第23.5.2.5項「ワークリスト・サービスがタイムアウトしたか無効になっている」

23.5.2.1 アイデンティティ・ストア内のユーザーが一致しない

ワークリスト・サービス・タスク・フローが実行されている管理対象サーバーで使用されているアイデンティティ・ストアとOracle SOA Suite BPELサーバーで使用されているアイデンティティ・ストアに不一致があります。

問題

ワークリストの管理対象サーバーのアイデンティティ・ストアに存在するユーザーがOracle SOA Suiteのアイデンティティ・ストアに存在しない場合、次のメッセージが表示されます。

ワークリスト・サービスの管理対象サーバーの診断ログの内容

[2009-03-23T11:35:21.407+00:00] [DefaultServer] [ERROR] []
[oracle.webcenter.worklist.config] [tid: pool-1-daemon-thread-12] [userId: Luke]
[ecid: 0000I0n7GBZFk3FLN2o2ye19lrBX00000L,0:1:3] [APP: Worklist#V2.0] Error in
workflow service Web service operation invocation.[[
Error in workflow service Web service operation invocation. The error is .
Verify that the SOAP connection information for the server is correct.
ORABPEL-30044
Error in workflow service Web service operation invocation.
Error in workflow service Web service operation invocation. The error is .
Verify that the SOAP connection information for the server is correct.
at
oracle.bpel.services.workflow.query.client.TaskQueryServiceSOAPClient.convertSOAPF
aultException(TaskQueryServiceSOAPClient.java:242)
at
oracle.bpel.services.workflow.query.client.TaskQueryServiceSOAPClient.invoke(TaskQ
ueryServiceSOAPClient.java:203)
at
oracle.bpel.services.workflow.query.client.TaskQueryServiceSOAPClient.authenticate
(TaskQueryServiceSOAPClient.java:253)
at
oracle.bpel.services.workflow.query.client.AbstractDOMTaskQueryServiceClient.authe
nticate(AbstractDOMTaskQueryServiceClient.java:164)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at oracle.webcenter.concurrent.MethodTask.call(MethodTask.java:34)
at oracle.webcenter.concurrent.Submission$2.run(Submission.java:492)
at java.security.AccessController.doPrivileged(Native Method)
at oracle.security.jps.util.JpsSubject.doAsPrivileged(JpsSubject.java:313)
at oracle.webcenter.concurrent.Submission.runAsPrivileged(Submission.java:499)
at oracle.webcenter.concurrent.Submission.run(Submission.java:433)
at
oracle.webcenter.concurrent.Submission$SubmissionFutureTask.run(Submission.java:779)
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:441)
at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:303)
at java.util.concurrent.FutureTask.run(FutureTask.java:138)
at
oracle.webcenter.concurrent.ModifiedThreadPoolExecutor$Worker.runTask(ModifiedThre
adPoolExecutor.java:657)
at
oracle.webcenter.concurrent.ModifiedThreadPoolExecutor$Worker.run(ModifiedThreadPo
olExecutor.java:682)
at java.lang.Thread.run(Thread.java:619)
]]
[2009-03-23T11:35:21.735+00:00] [DefaultServer] [NOTIFICATION] []
[oracle.webcenter.worklist.config] [tid: pool-1-daemon-thread-15] [userId: Luke]
[ecid: 0000I0n7GBZFk3FLN2o2ye19lrBX00000L,0:1:6] [APP: Worklist#V2.0]
TaskServiceSOAPClient: soapFault:[[
<env:Fault
xmlns:ns0="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-sece
xt-1.0.xsd"xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:FailedAuthentication</faultcode>
<faultstring>FailedAuthentication : The security token cannot be authenticated
or authorized.</faultstring>
<faultactor/>
</env:Fault>
]]

Oracle SOA Suiteの管理対象サーバーの診断ログの内容

[2009-03-23T04:52:07.909-07:00] [soa_server1] [ERROR] [WSM-00008] [oracle.wsm.resources.security] [tid: [ACTIVE].ExecuteThread: '2' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid: 0000I0nB64fFk3FLN2o2ye19lrBX00000O,0:1:3:1] [WEBSERVICE_PORT.name: TaskQueryServicePortSAML] [APP: soa-infra] [J2EE_MODULE.name: /integration/services/TaskQueryService] [WEBSERVICE.name: TaskQueryService] [J2EE_APP.name: soa-infra] Webサービス認証に失敗しました。

解決策

両方の管理対象サーバーのアイデンティティ・ストアに同じユーザーが存在している必要があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のワークリスト・サービスのセキュリティの設定に関する項を参照してください。

これは、共通のLDAPアイデンティティ・ストアによって簡単に実現できます。ワークリスト・サービスを利用できないユーザーIDを使ってOracle SOA SuiteのBPELワークリスト・アプリケーションにログインできるかどうかを調べると、問題を確認できます。つまり、http://host:port/integration/worklistappにある統合ワークリスト・アプリケーションへのアクセスを試みてください。hostとportは、タスク・フロー・アプリケーションのワークリスト接続で使用されるものと同じです。

23.5.2.2 共有ユーザー・ディレクトリにweblogicユーザーが含まれていない

問題

共有ユーザー・ディレクトリにweblogicユーザーが含まれていないため、ワークリスト・サービスから受信したリクエストをBPEL Webサービスが処理できません。

解決策

「アイデンティティ・ストア内のユーザーが一致しない」に記載されている解決法をまず試してください。それでも問題が解決しない場合、この項で説明する解決法を試してください。

Oracle SOA Suiteが共有ユーザー・ディレクトリ(LDAP)に接続されていて、ユーザーweblogicがアイデンティティ・ストアに存在しない場合、次の手順でアイデンティティ・ストアの有効なユーザーにBPMWorkflowAdminロールを割り当てます。WLSTを使用してSOAAdminからアプリケーション・ロールを呼び出し、それを外部アイデンティティ・ストアのメンバーに付与します。それには、SOA_ORACLE_HOMEから次のWLSTコマンドを実行します。次に例を示します。

cd SOA_ORACLE_HOME/common/bin/
wlst.sh
connect('weblogic','weblogic', '## soa host ##:## soa administration port ##')
revokeAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin",
principalClass="oracle.security.jps.service.policystore.ApplicationRole", principalName="SOAAdmin")
grantAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin",
principalClass="weblogic.security.principal.WLSUserImpl", principalName="user")

この例では、LDAPアイデンティティ・ストアにuserという名前のユーザーが存在します。BPMWorkflowAdminロールを付与する対象ユーザーがLDAPアイデンティティ・ストアに存在しない場合、この変更を有効にするためにOracle SOA Suiteの管理対象サーバーを再起動する必要があります。

23.5.2.3 wsm-pmアプリケーションの問題

問題

ワークリスト・サービスの管理対象サーバーまたはOracle SOA Suiteの管理対象サーバー(あるいはその両方)で、wsm-pmアプリケーションに問題があります。

解決策

wsm-pmアプリケーションは、ワークリスト・サービスでのSAML認証を制御するWebサービス・セキュリティ・ポリシーを管理します。wsm-pmアプリケーションを検証するには、管理権限を持つユーザーとしてwsm-pmアプリケーションの検証ページにログインします。検証に使用する書式は、http://host:port/wsm-pm/validatorです。このアプリケーションに問題がない場合、アクセス可能なポリシーが表示されます。ポリシーが表示されない場合、wsm-pmアプリケーションに障害が起きるサーバーでログに記録された関連情報を調べてください。

23.5.2.4 クロックの同期のずれが5分を超えている

セキュリティ上の理由により、ワークリスト・サービスの管理対象サーバーとOracle SOA Suite BPELの管理対象サーバーとの間でのWebサービス・セキュリティ相互作用は、5分未満の時間差で実行される必要があります。つまり、両方のホスト・マシンのクロックの時間差は5分未満である必要があり、時間差がそれ以上になると認証が失敗します。SAMLアサーションでは、これを検証するためにNotBefore条件が使用されます。

問題

ワークリスト・サービスの管理対象サーバーとOracle SOA Suite BPELの管理対象サーバーのクロック同期のずれが5分を超えています。

解決策

現在の時刻がSAMLアサーションのclockskew (デフォルトでは300秒)より早く設定されていないことを確認します。

クライアント・マシンとサービス・マシンの時刻を一致させるか、policy-accessor-config.xmlファイルでagent.clock.skewプロパティ(単位は秒)を構成します。このファイルは、DOMAIN_HOME/config/fmwconfigディレクトリにあります。

23.5.2.5 ワークリスト・サービスがタイムアウトしたか無効になっている

問題

定義された期間内にワークリスト・サービスがOracle SOA SuiteのBPELサーバーからの問合せ結果を取得できません。

ワークリスト・サービスは、同時スレッドを使用してOracle SOA SuiteのBPELサーバーに対して問合せを発行します。これらのスレッドには、応答期限として特定の時間が割り当てられています。これらのスレッドが割当て時間(たとえば15秒)内に応答しないと、ワークリスト・サービスではそのコールはタイムアウトとなり、タスク・フローに使用不能メッセージが表示されます。この場合、次のような関連する例外がログ・ファイルに記録されます。

[2009-03-03T12:09:34.769-08:00] [WLS_Spaces] [ERROR] [WCS-32103]
[oracle.webcenter.worklist.model] [tid: [ACTIVE].ExecuteThread: '3' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: user] [ecid:
0000HzDx68KC0zT6uBbAEH19fOWs00002q,0] [APP: webcenter] Unable to query BPEL repository.[[
oracle.webcenter.concurrent.TimeoutException: Execution timedout
queued :     1 ms
suspended :     0 ms
running : 15389 ms
timeout : 15000 ms
service : Worklist
resource : ir
source : oracle.webcenter.concurrent.CallableTask@bf3952
(oracle.webcenter.concurrent.CallableTask)
submission : 150
at
oracle.webcenter.concurrent.Submission.transitionTo(Submission.java:595)
at oracle.webcenter.concurrent.Submission.timeout(Submission.java:634)
at
oracle.webcenter.concurrent.InternalExecutorService.checkForTimeouts(InternalExecutorService.java:566)
at
oracle.webcenter.concurrent.InternalExecutorService.access$300(InternalExecutorService.java:18)
at
oracle.webcenter.concurrent.InternalExecutorService$1.run(InternalExecutorService.java:352)
at java.util.TimerThread.mainLoop(Timer.java:512)
at java.util.TimerThread.run(Timer.java:462)]]

解決策

このようなエラーが絶えず発生する場合、ワークリスト・サービスが実行されている管理対象サーバーとOracle SOA SuiteのBPELサーバーが使用できるリソースに基本的な問題がある可能性があります。

ユーザーの人数と提供されているリソースの量が、提供されているインフラストラクチャでのこれらのサーバーの実行に適切であるかどうかを検証してください。

注意:

TimeoutExceptionsが連続的に発生すると、ワークリスト・サービスが無効化される可能性もあります。そのため、このサービスはすばやく応答できないBPELインスタンスに接続できなくなります。その場合は、ログにoracle.webcenter.concurrent.DisabledException例外が記録されます。これらの例外は、ワークリスト・サービスの障害に関連しています。

24 ポートレット・プロデューサの管理

この章では、WSRPおよびOracle PDK-Javaポートレット・プロデューサの登録、編集、削除およびデプロイについて説明します。

注意:

ページレット・プロデューサの登録については、別の章で説明します。詳細は、第25.2項「ページレット・プロデューサの登録」を参照してください。

システム管理者はWebCenter Portalアプリケーションをデプロイするために、Fusion Middleware ControlまたはWLSTコマンドライン・ツールを使用してWSRPおよびOracle PDK-Javaポートレット・プロデューサを登録および管理できます。

アプリケーション管理者は、提供されている管理ページを使用するかポートレット・プロデューサのタスク・フローを使用して、実行時にポートレット・プロデューサを登録および管理することも可能です。

この章の内容は次のとおりです。

- 第24.1項「ポートレット・プロデューサに関する必要な知識」

- 第24.2項「WSRPプロデューサの登録」

- 第24.3項「WSRPプロデューサの接続テスト」

- 第24.4項「Oracle PDK-Javaプロデューサの登録」

- 第24.5項「Oracle PDK-Javaプロデューサの接続テスト」

- 第24.6項「プロデューサ登録情報の編集」

- 第24.7項「プロデューサの登録解除」

- 第24.8項「ポートレット・プロデューサ・アプリケーションのデプロイ」

- 第24.9項「WebCenterサービス・ポートレットの構成」

- 第24.10項「ポートレット・プロデューサ問題のトラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。

24.1 ポートレット・プロデューサに関する必要な知識

ポートレット・プロデューサを使用する際、次の点に留意してください。

- いくつかの組込みプロデューサはWebCenter Portal: OmniPortlet、Web ClippingおよびWSRPツールで提供されています。次のEARファイルはWebCenter Portalに同梱されています。

- portalTools.ear: OmniPortletおよびWeb Clipping

- wsrp-tools.ear: WSRPツール

portalTools.earファイルおよびwsrp-tools.earファイルは、registerOOTBProducers WLSTコマンドを使用してインストールできます。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterOOTBProducersに関する項を参照してください。

- JSR 286またはOracle PDK-Javaポートレットをページに追加する前に、所有されているWSRPおよびOracle PDK-Javaプロデューサを登録しておく必要があります。『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterSampleProducersに関する項も参照してください。

- Oracle Portlet Producer製品(サーバー)が本番環境にインストールされ、wsrp-toolsおよびportalToolsのURLにアクセスできる必要があります。Oracle Portlet Producerがインストールされていない場合、Oracle Fusion Middleware Oracle WebCenter Portalインストール・ガイドの既存ドメインの拡張に関する項を参照して、本番環境にインストールしてください。

- ポートレット・プロデューサへの接続を作成するとき、プロデューサはWebCenter Portalアプリケーションにより登録され、接続はconnections.xmlファイルに追加されます。WRSPプロデューサでは、ネーミング規則connectionname-wsconnに従いWebサービス接続も作成されます。Oracle PDK-Javaプロデューサでは、ネーミング規則connectionname-urlconnに従い、基礎となるURL接続が作成されます。登録中に、接続メタデータがOracle Metadata Services (MDS)リポジトリおよび登録中のプロデューサに作成されます。プロデューサが利用されると、ユーザー・カスタマイズがプロデューサに保存されます。登録解除中に、プロデューサの接続とカスタマイズは削除されます。

- デプロイ後に行った接続構成は、すべてMDSに保存されます。詳細は、第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。MDSの詳細は、『Oracle Fusion Middleware管理者ガイド』の「Oracle Metadata Repositoryの管理」を参照してください。

- ポートレット・プロデューサの登録は動的です。新規のポートレット・プロデューサや既存のプロデューサに対する更新は、WebCenter Portalアプリケーションで即座に使用可能になります。WebCenter Portalアプリケーションや管理サーバーを再起動する必要はありません。

- インスタンス間でプロデューサを移行するには、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の「ポートレット・プリファレンス・ストア移行ユーティリティ」を参照してください。

- ポートレット・プロデューサの保護の詳細は、第35.1項「WSRPプロデューサの保護」および第35.2項「PDK-Javaプロデューサの保護」を参照してください。

24.2 WSRPプロデューサの登録

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用して、デプロイされたアプリケーションに対してWSRPプロデューサを登録する方法について説明します。この項の内容は次のとおりです。

- 第24.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」

- 第24.2.2項「WLSTを使用したWSRPプロデューサの登録」

- 第24.2.3項「マップされたユーザーIDのための権限のポリシー・ストアへの追加」

- 第24.2.4項「WebCenter Portal: SpacesでのWSRPポートレット・プロデューサの登録」

- 第24.2.5項「WebCenter Portal: FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録」

JDeveloperを使用して設計時にWSRPプロデューサを登録する方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWSRPポートレット・プロデューサの登録方法に関する項を参照してください。

24.2.1 Fusion Middleware Controlを使用したWSRPプロデューサの登録

WSRPポートレット・プロデューサを登録する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「ポートレット・プロデューサ接続の追加」セクションで、WSRPプロデューサの接続情報を入力します。
パラメータの詳細は、表24-1を参照してください。

表24-1 WSRPプロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portalアプリケーション内でこのポートレット・プロデューサ登録を識別するための一意の名前を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。

ここで指定した名前は、Composer (「ポートレット」フォルダの下)に表示されます。

プロデューサ・タイプ

このプロデューサのタイプを指定します。「WSRPプロデューサ」を選択します。

WSDL URL

WSRPプロデューサの登録URL。

構文はWSRP実装によって異なります。たとえば、Oracle WSRPコンテナにデプロイされたポートレットのURL形式は次のとおりです。

http://host_name:port_number/context_root/portlets/wsrp2?WSDL

http://host_name:port_number/context_root/portlets/wsrp1?WSDL

http://host_name:port_number/context_root/portlets/?WSDL（WSRP 1.0: 下位互換性のため）

各要素の意味は次のとおりです。

- host_nameは、プロデューサがデプロイされているサーバーです。

- port_numberは、HTTPリスナーのポート番号です。

- context_rootは、Webアプリケーションのコンテキスト・ルートです。

- portlets wsrp(1|2)?WSDLは静的テキストです。Oracle WSRPコンテナにデプロイされたすべての製品は、WSRPバージョン1およびバージョン2のプロデューサとして公開されます。
WebCenter Portal: Spacesでは、バージョン2のWSDLのみがOracle WebLogic Portalプロデューサによってサポートされます。

次に例を示します。

http://myhost.com:7778/MyPortletApp/portlets/wsrp2?WSDL

WSRPプロデューサでは、次のプロデューサ・テスト・ページにアクセスすることによって、この登録URLを取得できます。

http://host_name:port_number/context_root/info

プロキシを使用しますか。

WebCenter Portalアプリケーションでこのプロデューサとの接続にHTTPプロキシを使用する場合、これを選択します。これを選択した場合は、「プロキシ・ホスト」および「プロキシ・ポート」の値を入力してください。

WebCenter Portalアプリケーションとリモートのポートレット・プロデューサがファイアウォールで分断されていて、プロデューサとの通信にHTTPプロキシが必要な場合、プロキシが必要となります。

プロキシ・ホスト

プロキシ・サーバーのホスト名またはIPアドレスを入力します。

プロキシ・サーバー名の先頭にhttp://を付けないでください。

プロキシ・ポート

プロキシ・サーバーがリスニングするポート番号を入力します。デフォルト・ポートは80です。

デフォルトの実行タイムアウト（秒）

プロデューサとの通信で適切なタイムアウト時間(秒単位)を入力します。たとえば、プロデューサがWebCenter Portalアプリケーションのページでポートレットを登録、登録解除または表示するのに許される最長所要時間を入力します。デフォルトは30秒です。

個々のポートレットに固有のタイムアウト時間を定義できますが、その場合ここで指定した値よりも優先されます。

4. 「セキュリティ」セクションを使用して、アイデンティティ伝播またはアサーションに使用するセキュリティ・トークンのタイプを指定します。
伝播またはアサートされたユーザー情報が含まれるセキュリティ・トークンは、SOAPヘッダー内のXML要素として表されます。セキュリティ・トークンおよびSOAPメッセージ本文はデジタル署名されて、WebCenter PortalアプリケーションからのSOAPメッセージ送信元の真正性が証明されます。WebCenter Portalアプリケーションがサポートするセキュリティ・トークンは、WSS 1.0ユーザー名トークン(パスワードなし)、WSS 1.0ユーザー名トークン(パスワードあり)、WSS 1.0 SAMLトークン、メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークンおよびメッセージ保護付きWSS 1.1 SAMLトークンの6種類です。

SAMLは、Security Assertion Markup Languageの省略形です。

注意:

PeopleSoft WSRPプロデューサは、ユーザー名トークン(パスワードあり)およびメッセージ整合性付きSAMLトークンの2種類のプロファイルをサポートします。Oracle Portal (コンシューマとして)は、ユーザー名トークン(パスワードなし)、ユーザー名トークン(パスワードあり)、メッセージ整合性付きSAMLトークンの3種類のプロファイルをサポートします。その他のOracle WSRPプロデューサでは、6種類のプロファイルすべてがサポートされています。その他のWSRPコンテナについては、サポートされているトークン形式を各ベンダーに確認してください。

パラメータの詳細は、表24-2を参照してください。

表24-2 WSRPプロデューサのセキュリティの接続パラメータ

フィールド

説明

トークン・プロファイル

このWSRPプロデューサでの認証に使用するトークン・プロファイルのタイプを選択します。次から選択します。

- メッセージ整合性付きWSS 1.0 SAMLトークン
(wss10_saml_token_with_message_integrity_client_policy): このポリシーは、WS-Security 1.0標準に従い、アウトバウンドSOAPリクエストに対してメッセージ・レベルの整合性保護およびSAMLベースの認証を適用します。SAMLトークンはSOAPメッセージに含まれ、送信者保証確認によるSAMLベース認証で使用されます。このポリシーは、WS-Securityの非対称鍵テクノロジBasic 128スイートおよびSHA-1ハッシュ・アルゴリズムを使用してメッセージの整合性を保護します。

- メッセージ保護付きWSS 1.0 SAMLトークン
(oracle/wss10_saml_token_with_message_protection_client_policy): このポリシーは、WS-Security 1.0標準に従い、アウトバウンドSOAPリクエストに対してメッセージ・レベルの保護(整合性と機密性)およびSAMLベースの認証を適用します。Webサービス・コンシューマは、SOAPヘッダーにSAMLトークンを含み、確認タイプは送信者保証です。このポリシーでは、WS-Securityの非対称鍵テクノロジのBasic 128スイートを使用します。特に、メッセージ機密性用のRSA鍵メカニズム、メッセージ整合性用のSHA-1ハッシュ・アルゴリズムおよびAES-128ビット暗号化が使用されます。

- WSS 1.0ユーザー名トークン(パスワードなし)
(oracle/wss10_username_id_propagation_with_msg_protection_client_policy): このポリシーはWS-Security 1.0標準に従い、アウトバウンドSOAPリクエストに対して、証明書ベースのメッセージ保護を使用してパスワード付きのユーザー名トークン・プロファイル・ベースのアイデンティティ伝播を提供します。資格証明(ユーザー名のみ)は、WS-Security UsernameTokenヘッダーによりアウトバウンドSOAPリクエスト・メッセージに含められます。パスワードは含められません。メッセージの保護は、WS-Security 1.0の非対称鍵テクノロジのBasic 128スイートを使用して提供されます。特に、メッセージ機密性用のRSA鍵メカニズム、メッセージ整合性用のSHA-1ハッシュ・アルゴリズムおよびAES-128ビット暗号化が使用されます。

トークン・プロファイル(続き)

- WSS 1.0ユーザー名トークン(パスワードあり)
(oracle/wss10_username_token_with_message_protection_client_policy): このポリシーはWS-Security 1.0標準に従い、アウトバウンドSOAPリクエストに対して、証明書ベースのメッセージ保護を使用してパスワード付きのユーザー名トークン・プロファイル・ベースのアイデンティティ伝播を提供します。プレーン・テキストとダイジェストの両方のメカニズムがサポートされています。このポリシーでは、WS-Securityの非対称鍵テクノロジのBasic 128スイートを使用します。特に、メッセージの機密性のためのRSA鍵メカニズム、メッセージ整合性のためのSHA-1ハッシュ・アルゴリズムおよびAES-128ビット暗号化が使用されます。
WSRPプロデューサが別のアイデンティティ・ストアを持つ場合は、このトークン・プロファイルを使用してください。プロデューサに関連する外部アプリケーションを定義し、外部アプリケーションをこのプロデューサに関連付ける必要があります。

- WSS 1.0 SAMLトークン
(oracle/wss10_saml_token_client_policy): このポリシーはWS-Security 1.0標準に従い、アウトバウンドSOAPリクエストに対して、SAMLベースの認証を提供します。このポリシーはユーザーIDを伝播するため、通常はメッセージ保護および整合性チェックを必要としない部署内デプロイに使用されます。
このポリシーではキーストアの構成は必要ありません。

- メッセージ保護付きWSS 1.1 SAMLトークン
(oracle/wss11_saml_token_with_message_protection_client_policy): このポリシーは、WS-Security 1.0標準に従い、アウトバウンドSOAPリクエストに対してメッセージ・レベルの保護(整合性と機密性)およびSAMLトークンの移入を適用します。SAMLトークンはSOAPメッセージに含まれ、送信者保証確認によるSAMLベース認証で使用されます。このポリシーでは、署名および暗号化に対称鍵テクノロジ、署名の承認にWS-Securityの非対称鍵テクノロジのBasic 128スイートが使用されます。

- なし: トークンなし。「なし」を選択した場合、WS-SecurityヘッダーはSOAPメッセージに添付されません。

構成

次を選択します。

- デフォルト: デフォルトのトークン・プロファイル構成が使用されます。

- カスタム: カスタムのOracle Webサービス・マネージャの構成が使用されます。
「カスタム」を選択すると追加のセキュリティ・オプション(すべてのキーストア・プロパティを含む)が表示されます。

発行者名

SAMLトークンの発行者の名前を入力します。

例: www.example.com

発行者名は、サブジェクトの検証を保証する証明エンティティです。これはプロデューサ側で信頼されたSAML発行者である必要があります。

有効なトークン: メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークン。WSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークン

デフォルト・ユーザー

ユーザーがWebCenter Portalアプリケーションで認証されていない場合、リモート・プロデューサに対してアサートするユーザー名を入力します。

認証されていない場合、anonymousというアイデンティティがアプリケーション・ユーザーに関連付けられます。anonymousの値がリモート・プロデューサに適していない場合、ここに別のアイデンティティを指定する必要がある場合があります。ただし、この場合、WebCenter Portalアプリケーションがユーザーを認証していないため、指定したデフォルト・ユーザーはリモート・プロデューサで権限の低いユーザーになることに注意してください。ユーザーがアプリケーションで認証されている場合、デフォルト・ユーザーではなくそのユーザーのアイデンティティがアサートされます。

WSRPリモート・プロデューサはこの情報を受け入れるように設定する必要があります。第24.2.3項「マップされたユーザーIDのための権限のポリシー・ストアへの追加」の説明に従ってポリシー・ストアに権限を追加する必要もあります。

有効なトークン: メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークン、WSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークン、WSS 1.0ユーザー名トークン(パスワードなし)。

関連付けられている外部アプリケーション

（ユーザー名（パスワードあり））

このプロデューサが認証に外部アプリケーションを使用する場合、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用してアプリケーションを指定します。目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

「WSS 1.0ユーザー名(パスワードあり)」セキュリティ・オプションを使用してプロデューサをサポートするには、外部アプリケーションが必要です。外部アプリケーションが、ユーザー資格証明を格納および提供します。第26.2項「外部アプリケーションの登録」も参照してください。

有効なオプション: 「WSS 1.0ユーザー名(パスワードあり)」のみ。

5. 「キー・ストア」セクションを使用して、SOAPメッセージの一部分(セキュリティ・トークンとSOAPメッセージ本文)の署名に使用する証明書および秘密鍵が含まれるキーストアの場所を指定します。
これらのプロパティは、ドメインに指定された構成を無効にする場合にのみ構成してください。

パラメータの詳細は、表24-3を参照してください。

表24-3 WSRPプロデューサのキーストアの接続パラメータ

フィールド

説明

受信者の別名

プロデューサの証明書に関連付けられたキーストア別名を指定します。

この証明書は、プロデューサに対してメッセージを暗号化するために使用されます。

ストア・パス

SOAPメッセージ(セキュリティ・トークンとメッセージ本文)の署名または暗号化に使用する証明書および秘密鍵が含まれるキーストアの絶対パスを入力します。この表に示されている署名、暗号化および受信者キーはこのキーストアで使用できる必要があります。

指定されたキーストア・ファイルは、JDKのキーツール・ユーティリティを使用して作成されている必要があります。

パスワード

キーストアの作成時に設定されたキーストアへのパスワードを指定します。パスワードが使用できない場合や正しくない場合、プロデューサを使用できません。

署名キーの別名

署名キーの別名を入力します。

「署名キーの別名」は、署名に使用される秘密鍵に関連付けられた証明書の識別子です。

署名キーのパスワード

「署名鍵の別名」に指定された別名によって識別されるキーにアクセスするためのパスワードを指定します。

暗号化キーの別名

返されるメッセージを暗号化するには、プロデューサによって使用されるキーの別名を入力します。有効な値は、指定されたキーストアにあるキーの別名の1つです。

このプロパティはオプションです。指定しないと、プロデューサは返されるメッセージを暗号化するための署名キーを使用します。

暗号化キーのパスワード

暗号化キーにアクセスするためのパスワードを入力します。

6. 「OK」をクリックします。
新しいプロデューサが接続表に表示されます。

24.2.2 WLSTを使用したWSRPプロデューサの登録

WLSTコマンドregisterWSRPProducerを使用してWSRPポートレット・プロデューサとの接続を作成し、WebCenter Portalアプリケーションでプロデューサを登録します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterWSRPProducerに関する項を参照してください。

関連項目:

deregisterWSRPProducer、listWSRPProducers、refreshProducer、registerOOTBProducers、registerSampleProducers

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

24.2.3 マップされたユーザーIDのための権限のポリシー・ストアへの追加

Default Userフィールドを使用して別のユーザーIDにマップする場合、次のいずれかを実行してポリシー・ストアに権限を追加する必要もあります。

- 次の権限を直接ポリシー・ストアに追加します。

<grant>
<grantee>
<codesource>

<url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent.jar</url>
</codesource>
</grantee>
<permissions>
<permission>
<class>oracle.wsm.security.WSIdentityPermission</class>
<name>resource=MyAppID</name>
<actions>assert</actions>
</permission>
<permissions>
<grant>

前述の行でバージョン番号(ある場合)を含むクライアント・アプリケーション名にMyAppIDを置き換えます。

- 次のWLSTコマンドを実行して権限を付与します。

grantPermission(codeBaseURL='file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent.jar',
permClass='oracle.wsm.security.WSIdentityPermission',
permTarget='resource=MyAppID', permActions='assert')

バージョン番号(ある場合)を含むクライアント・アプリケーション名にMyAppIDを置き換えます。

24.2.4 WebCenter Portal: SpacesでのWSRPポートレット・プロデューサの登録

WebCenter Portal: SpacesでのWSRPポートレット・プロデューサの登録の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理によるポートレット・プロデューサの登録に関する項を参照してください。

24.2.5 WebCenter Portal: FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録

FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWSRPポートレット・プロデューサの登録方法に関する項を参照してください。

24.3 WSRPプロデューサの接続テスト

WSRPプロデューサ接続を検証するには、まず次でプロデューサのURLを取得します。

http://host_name:port_number/context_root/info

次に、ブラウザ・ウィンドウでプロデューサのURLを実行します。

WSRP v1プロデューサ接続の場合、URL形式は次のとおりです。

http://host_name:port_number/context_root/portlets/wsrp1?WSDL

次に例を示します。

http://myhost.com:7778/MyPortletApp/portlets/wsrp1?WSDL

WSRP v2プロデューサ接続の場合、URL形式は次のとおりです。

http://host_name:port_number/context_root/portlets/wsrp2?WSDL

次に例を示します。

http://myhost.com:7778/MyPortletApp/portlets/wsrp2?WSDL

24.4 Oracle PDK-Javaプロデューサの登録

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用して、デプロイされたWebCenter PortalアプリケーションにPDK-Javaプロデューサを登録する方法について説明します。この項の内容は次のとおりです。

- 第24.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」

- 第24.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」

- 第24.4.3項「WebCenter Portal: SpacesでのOracle PDK-Javaポートレット・プロデューサの登録」

- 第24.4.4項「WebCenter Portal: FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録」

JDeveloperを使用して設計時にPDK-Javaプロデューサを登録する方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle PDK-Javaポートレット・プロデューサの登録方法に関する項を参照してください。

24.4.1 Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録

Oracle PDK-Javaポートレット・プロデューサを登録する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「ポートレット・プロデューサ接続の追加」セクションで、Oracle PDK-Javaプロデューサの接続情報を入力します。
パラメータの詳細は、表24-4「Oracle PDK-Javaプロデューサの接続パラメータ」を参照してください。

表24-4 Oracle PDK-Javaプロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portalアプリケーション内でこのポートレット・プロデューサ登録を識別する一意の名前を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。

ここで指定した名前は、Composer (「ポートレット」フォルダの下)に表示されます。

プロデューサ・タイプ

このプロデューサのタイプを指定します。「Oracle PDK-Javaプロデューサ」を選択します。

URLエンドポイント

次の構文を使用して、Oracle PDK-JavaプロデューサのURLを入力します。

http://host_name:port_number/context_root/providers

各要素の意味は次のとおりです。

- host_nameは、プロデューサがデプロイされているサーバーです。

- port_numberは、HTTPリスナーのポート番号です。

- context_rootは、Webアプリケーションのコンテキスト・ルートです。

- providersは、静的テキストです。

次に例を示します。

http://myHost.com:7778/myEnterprisePortlets/providers

サービスID

このプロデューサの一意の識別子を入力します。

PDK-Javaを使用すると、単一のアダプタ・サーブレットの下に複数のプロデューサをデプロイできます。各プロデューサは、一意のサービスIDで識別されます。サービスIDは、URLエンドポイントにサービスIDが追加されていない場合のみ必要となります。

たとえば、次のURLエンドポイントには、サービスIDとしてsampleが必要です。

http://domain.example.com:7778/axyz/providers

しかし、次のURLエンドポイントにはサービスIDは不要です。

http://domain.example.com:7778/axyz/providers/sample

サービスIDは、プロデューサの特性（プロデューサのテスト・ページを表示するかどうかなど）を定義する<service_id>.propertiesというファイルを参照するために使用されます。任意の値を使用して、サービスIDを作成します。サービスIDを指定しないと、_default.propertiesが使用されます。

プロキシを使用しますか。

WebCenter Portalアプリケーションでこのプロデューサとの接続にHTTPプロキシを使用する場合、このチェック・ボックスを選択します。これを選択した場合は、「プロキシ・ホスト」および「プロキシ・ポート」の値を入力してください。

WebCenter Portalアプリケーションとリモートのポートレット・プロデューサがファイアウォールで分断されていて、プロデューサとの通信にHTTPプロキシが必要な場合、プロキシが必要となります。

プロキシ・ホスト

プロキシ・サーバーのホスト名またはIPアドレスを入力します。

プロキシ・サーバー名の先頭にhttp://を付けないでください。

プロキシ・ポート

プロキシ・サーバーがリスニングするポート番号を入力します。デフォルト・ポートは80です。

関連付けられている外部アプリケーション

このプロデューサのポートレットの1つが認証する必要がある場合、「関連付けられている外部アプリケーション」ドロップダウンを使用して正しい外部アプリケーションを指定します。

目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

第26.2項「外部アプリケーションの登録」も参照してください。

セッションを確立しますか。

これを選択した場合、このプロデューサからポートレットを実行するときにユーザー・セッションが有効化されます。セッションが有効な場合、それらはプロデューサのサーバーに保持されます。これによりポートレット・コードはセッションに情報を保持できます。

メッセージ認証はセッションを使用します。このため、共有鍵を指定するには、このオプションを選択する必要があります。

プロデューサとサーバーの間でセッションレス通信を行う場合は、このオプションを選択しないでください。

デフォルトの実行タイムアウト（秒）

プロデューサとの通信で適切なタイムアウト時間(秒単位)を入力します。たとえば、プロデューサがWebCenter Portalアプリケーションのページでポートレットを登録、登録解除または表示するのに許される最長所要時間を入力します。これはデフォルトで30秒に設定されます。

個々のポートレットに固有のタイムアウト時間を定義できますが、その場合ここで指定した値よりも優先されます。

サブスクライバID

登録するプロデューサのコンシューマを識別する文字列を入力します。

プロデューサがアプリケーションに登録されると、プロデューサのコールが送信されます。コール中、コンシューマ(このインスタンスのWebCenter Portalアプリケーション)は、「サブスクライバID」の値をプロデューサに渡します。「サブスクライバID」がプロデューサの予測した値でない場合、プロデューサは登録コールを拒否することがあります。

共有鍵

暗号化を処理するように設定されているプロデューサに使用する共有鍵を入力します。

共有鍵は、メッセージ認証用のメッセージ署名を生成するための暗号化アルゴリズムで使用されます。共有鍵を使用してプロデューサが設定されている場合、ここに間違っ共有鍵を入力すると、プロデューサ登録は失敗するので注意してください。共有鍵には、英数字10〜20文字を含めることができます。

このキーは、フェデレーテッド・ポータル・アダプタ(FPA)を使用してプロデューサを登録するときにも使用されます。共有鍵はHMACキーとも呼ばれます。

4. 「OK」をクリックします。
新しいプロデューサが接続表に表示されます。

24.4.2 WLSTを使用したOracle PDK-Javaプロデューサの登録

WLSTコマンドregisterPDKJavaProducerを使用してPDK-Javaポートレット・プロデューサとの接続を作成し、WebCenter Portalアプリケーションでプロデューサを登録します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterPDKJavaProducerに関する項を参照してください。

関連項目:

deregisterPDKJavaProducer、listPDKJavaProducers、refreshProducer

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

24.4.3 WebCenter Portal: SpacesでのOracle PDK-Javaポートレット・プロデューサの登録

WebCenter Portal: SpacesでのOracle PDK-Javaポートレット・プロデューサの登録の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理によるポートレット・プロデューサの登録に関する項を参照してください。

24.4.4 WebCenter Portal: FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録

FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle PDK-Javaポートレット・プロデューサの登録方法に関する項を参照してください。

24.5 Oracle PDK-Javaプロデューサの接続テスト

Oracle PDK-Javaプロデューサ接続を検証するには、ブラウザ・ウィンドウで次の形式のプロデューサURLを実行します。

http://host_name:port_number/context-root/providers/producer_name

次に例を示します。

http://domain.example.com:7778/axyz/providers/sample

24.6 プロデューサ登録情報の編集

プロデューサ登録の詳細はいつでも更新できます。

プロデューサが別の場所に移動する場合、そのプロデューサに定義した接続を再構成する必要があります。Fusion Middleware ControlまたはWLSTを使用してURLプロパティを編集できます。

- WSRPプロデューサのWDSL URL

- Oracle PDK-JavaプロデューサのURLエンド・ポイント

ユーザーがWebCenter Portalアプリケーションで作業している間に行ったポートレットのカスタマイズとパーソナライズをすべて保持するには、プロデューサのカスタマイズとパーソナライズもプロデューサの新しい場所に移行する必要があります。ポートレット・クライアントのメタデータを別の場所に移行するには、WLSTコマンドexportPortletClientMetadataおよびimportPortletClientMetadataを使用します。詳細は、第39.2.3項「ポートレット・クライアント・メタデータのエクスポート(Frameworkアプリケーション)」および第39.2.4項「ポートレット・クライアント・メタデータのインポート(Frameworkアプリケーション)」を参照してください。

注意:

特定のプロデューサのすべてのメタデータ(ポートレットのカスタマイズとパーソナライズのみでなく)を移行する場合、プロデューサ移行ツールを使用します。詳細は、第39.1.3.13項「ポートレット・プロデューサのエクスポート」および第39.1.3.14項「ポートレット・プロデューサのインポート」を参照してください。

この項の内容は次のとおりです。

- 第24.6.1項「Fusion Middleware Controlを使用したプロデューサ登録情報の編集」

- 第24.6.2項「WLSTを使用したプロデューサ登録情報の編集」

- 第24.6.3項「WSRPプロデューサ・メタデータの新しいWSDL URLへの移行」

24.6.1 Fusion Middleware Controlを使用したプロデューサ登録情報の編集

ポートレット・プロデューサの接続情報を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 「ポートレット・プロデューサ接続の管理」セクションで、変更するプロデューサを選択して「編集」をクリックします。

5. 「ポートレット・プロデューサ接続の編集」セクションで、必要に応じて接続情報を変更します。詳細は、次を参照してください。

- 表24-1「WSRPプロデューサの接続パラメータ」

- 表24-4「Oracle PDK-Javaプロデューサの接続パラメータ」

6. 「OK」をクリックします。

24.6.2 WLSTを使用したプロデューサ登録情報の編集

次のWLSTコマンドを使用して、ポートレット・プロデューサ接続を編集します。

- WSRPプロデューサ: setWSRPProducer

- PDK-Javaプロデューサ: setPDKJavaProducer

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

24.6.3 WSRPプロデューサ・メタデータの新しいWSDL URLへの移行

WSRPプロデューサを新しいWSDL URLに移動する場合、WLSTコマンドのexportPortletClientMetadata、setWSRPProducerおよびimportPortletClientMetadataを使用して、既存のプロデューサのメタデータを新しい場所に移行できます。

WSRPプロデューサのメタデータを新しいURLエンドポイントに移行する手順は、次のとおりです。

1. WLSTコマンドexportPortletClientMetadataを使用して、プロデューサのメタデータをエクスポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。

2. WLSTコマンドsetWSRPProducerを使用して、プロデューサのWSDL URLを変更します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetWSRPProducerに関する項を参照してください。

3. WLSTコマンドimportPortletClientMetadataを使用して、プロデューサのメタデータをインポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportPortletClientMetadataに関する項を参照してください。

24.7 プロデューサの登録解除

プロデューサの登録はいつでも解除できますが、登録解除されたプロデューサと関連付けられたポートレットは機能しなくなるため、WebCenter Portalアプリケーションへの影響を考慮してください。ポートレット・プロデューサ呼出しのメトリックをチェックして、プロデューサの使用頻度を確認します。詳細は、第38.2項「パフォーマンス情報の表示」を参照してください。

プロデューサの登録を解除すると、登録データはWebCenter Portalアプリケーションとリモート・プロデューサの両方から削除されます。

- WebCenter Portalアプリケーション: プロデューサ接続は削除され、プロデューサのメタデータも削除されます。

- リモート・プロデューサ: （ポートレット自体ではなく）ポートレット・インスタンスが削除されます。

ポートレット・インスタンスはWebCenter Portalアプリケーション・ページから削除されません。ユーザーには、ポートレットのかわりに「ポートレットがありません」というメッセージが表示されます。

注意:

このポートレット・プロデューサに関連付けられている外部アプリケーションの目的がこのプロデューサをサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。第26.5項「外部アプリケーション接続の削除」を参照してください。

この項の内容は次のとおりです。

- 第24.7.1項「Fusion Middleware Controlを使用したプロデューサの登録解除」

- 第24.7.2項「WLSTを使用したプロデューサの登録解除」

- 第24.7.3項「WebCenter Portal: Spacesでのプロデューサの登録解除」

- 第24.7.4項「WebCenter Portal: Frameworkアプリケーションでのプロデューサの登録解除」

24.7.1 Fusion Middleware Controlを使用したプロデューサの登録解除

ポートレット・プロデューサを登録解除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 削除するプロデューサの名前を選択し、「削除」をクリックします。

接続の詳細が削除されます。このプロデューサに関連付けられたポートレットに、WebCenter Portalアプリケーションからアクセスできなくなります。

24.7.2 WLSTを使用したプロデューサの登録解除

次のWLSTコマンドを使用して、ポートレット・プロデューサ接続を登録解除します。

- WSRPプロデューサ: deregisterWSRPProducer

- PDK-Javaプロデューサ: deregisterPDKJavaProducer

次のWLSTコマンドを使用して、Oracle WebCenter Portalに用意されている組込みプロデューサまたはサンプルのプロデューサの登録を解除します。

- 組込みプロデューサ: deregisterOOTBProducers

- サンプルのプロデューサ: deregisterSampleProducers

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

24.7.3 WebCenter Portal: Spacesでのプロデューサの登録解除

WebCenter Portal: Spacesでのポートレット・プロデューサの登録解除の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのポートレット・プロデューサの登録解除に関する項を参照してください。

24.7.4 WebCenter Portal: Frameworkアプリケーションでのプロデューサの登録解除

Frameworkアプリケーションでのポートレット・プロデューサの登録解除の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のポートレット・プロデューサの削除方法に関する項を参照してください。

24.8 ポートレット・プロデューサ・アプリケーションのデプロイ

Oracle WebLogic管理対象サーバー・インスタンスにポートレット・プロデューサをデプロイするために、Fusion Middleware Control、Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。Oracle JDeveloperで設計時にポートレット・プロデューサをデプロイする方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の「ポートレットのテストとデプロイ」を参照してください。

この項の内容は次のとおりです。

- 第24.8.1項「ポートレット・プロデューサ・アプリケーションのデプロイの理解」

- 第24.8.2項「JSR 286ポートレット・プロデューサEARファイルのWSRP EARファイルへの変換」

- 第24.8.3項「Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

- 第24.8.4項「Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

- 第24.8.5項「Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

- 第24.8.6項「WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

アプリケーションのデプロイの詳細は、『Oracle Fusion Middleware管理者ガイド』の「アプリケーションのデプロイ」を参照してください。

24.8.1 ポートレット・プロデューサ・アプリケーションのデプロイの理解

ポートレット・プロデューサ・アプリケーションは、WebCenter Portalポートレット・プロデューサをサポートするように構成されたOracle WebLogic管理対象サーバーにデプロイできます。アプリケーションを管理対象サーバーにデプロイするには、Oracle Enterprise Manager Fusion Middleware Control、Oracle WebLogic管理コンソールまたはWLSTを使用できます。これらの管理ツールの詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。

24.8.2 JSR 286ポートレット・プロデューサEARファイルのWSRP EARファイルへの変換

JSR 286ポートレットをWSRP Oracleポートレット・コンテナにデプロイするには、ポートレット・アプリケーションのEARファイルを、必要なWSDLドキュメントを含むWSRPアプリケーションに変換する必要があります。JSR 286ポートレット・プロデューサのEARファイルをWSRP EARファイルに変換するには、次のようにMiddlewareディレクトリWC_ORACLE_HOME/webcenter/modules/oracle.portlet.server_11.1.1にあるWSRPプロデューサ事前デプロイ・ツールを実行します。

java -jar wsrp-predeploy.jar source EAR  target EAR

サーブレットv2.3でデプロイされたJSR 286ポートレットの場合、次のコマンドを使用してWebプロキシを指定する必要があります。

java -Dhttp.proxyHost=proxy host -Dhttp.proxyPort=proxy port -jar
wsrp-predeploy.jar source EAR target EAR

各要素の意味は次のとおりです。

- proxy hostは、プロデューサがデプロイされているサーバーです。

- proxy portは、HTTPリスナーのポートです。

- wsrp-predeploy.jarは、WC_ORACLE_HOME/webcenter/modules/oracle.portlet.server_11.1.1ディレクトリにあります。

- source EARは、JSR 286 EARファイルの名前です。

- target EARファイルは、新規に作成されるEARファイルの名前です。ターゲットのEARファイルに名前が指定されていない場合、WSRP-source EARという名前の新しいEARファイルが作成されます。

次の例ではWebプロキシが指定されます。

java -Dhttp.proxyHost=myhttpproxy.com -Dhttp.proxyPort=80 -jar wsrp-predeploy.jar wsrp-samples.ear

この例ではWSRP-wsrp-samples.earが作成されます。

wsrp-predeploy.jar事前デプロイ・ツールは、Oracleポートレット・コンテナへのデプロイを可能にするために必要なすべての変更をJSR 286ポートレットに実施し、それをWSRPプロデューサとして公開します。事前デプロイ・ツールが実行する処理の例を次に示します。

- java.io.tmpdirフォルダにwsdldeployディレクトリを作成します。

- UNIXでは、このプロパティのデフォルト値は/tmpまたは/var/tmpです。

- Microsoft Windowsでは、このプロパティのデフォルト値はc:\tempです。

- EARファイルをwsdldeploy/EARに解凍します。

- WARファイルをwsdldeploy/[warfilename.war]/に解凍します。

- 解凍したアプリケーションにWEB-INF/WSDLsを挿入します。

- 解凍したWARファイルのWEB-INF/web.xmlを修正します。

- WARファイルにWEB-INF/webservices.xmlを挿入するか修正します。

- WARファイルにWEB-INF/oracle-webservices.xmlを挿入するか修正します。

- WARファイルを再度パッケージ化し、新しいEARファイルを作成します。

24.8.3 Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WebLogicサーバーにアクセスするために必要な資格証明がある場合、Oracle JDeveloperを使用してポートレット・アプリケーションを開発環境からOracle WebLogic管理対象サーバー・インスタンスに直接デプロイできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のポートレット・アプリケーションのOracle WebLogic管理対象サーバー・インスタンスへのデプロイに関する項を参照してください。

24.8.4 Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ

Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイの詳細は、第7.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」を参照してください。

24.8.5 Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ

Oracle WebLogicサーバー管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイの詳細は、第7.1.6.6項「WLS管理コンソールを使用したアプリケーションのデプロイ」を参照してください。

24.8.6 WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WLSTコマンドを使用したポートレット・アプリケーションのデプロイの詳細は、第7.1.6.5項「WLSTを使用したアプリケーションのデプロイ」を参照してください。

24.9 WebCenterサービス・ポートレットの構成

WebCenter Portalはサービスによりソーシャル・ネットワークおよび個人生産性の機能を提供しながら、タスク・フローによりその機能のサブセットを公開します。これらのサービスおよびタスク・フローは、Spacesアプリケーションやその他のWebCenter Portalアプリケーションで使用できます。ただし、その他の製品(たとえば、Oracle Portal、Oracle WebLogic PortalおよびOracle WebCenter Interaction)を使用するアプリケーション開発者は、これらの同じ機能をアプリケーション内で公開することもあります。

WebCenterサービス・ポートレットは、製品に用意された事前構成済プロデューサです。これによりWebCenter Portalサービスのタスク・フローをWSRPポートレットまたはページレットとして他のアプリケーションに公開できます。

次のタスク・フローは、WebCenterサービス・ポートレットによりポートレットとして提供されます。

- ドキュメント・マネージャ: WebCenterコンテンツ・リポジトリからフォルダ、ファイルおよびWikiを表示します。

- ブログ: WebCenterコンテンツ・リポジトリで選択位置からブログ・ポストを表示します。

- ディスカッション・フォーラム: すべてのディスカッションとそれぞれの応答を表示し、ユーザーにそれぞれの権限に応じた多様な操作を可能にします。

- お知らせ: 現在のすべてのお知らせを表示し、ユーザーにそれぞれの権限に応じた多様な操作を可能にします。

- リスト: ユーザーによって作成されたリストを表示し、リストの作成やリスト・データの追加のためのコントロールを提供します。

- 投票マネージャ: ユーザーは投票に関する管理操作を実行できます。

- 投票の実施: 最近公開された投票、または投票されたパラメータによって識別された特定の投票を表示します。

- ワークリスト: ユーザーは1つ以上のOracle BPELサーバーからのすべてのタスクおよび通知を表示し、アクションを実行できます。

- メール: 受信ボックスを表示します。

- アクティビティ・ストリーム: ユーザーの接続によって実行された最近のアクティビティの概要を示します。

- タグ・クラウド: ページで使用されるすべてのタグの視覚表現であるタグ・クラウドを表示します。

WebCenterサービス・ポートレットはFrameworkアプリケーションとして開始されます。このアプリケーションは複数のページで構成され、それぞれのページが公開されたタスク・フローに対応しています。次にアプリケーションは、Oracle JSF Portlet Bridgeを使用してポートレット化され、WC_Portlet管理対象サーバーにデプロイされます。

WebCenter Portalのインストール後、WebCenterサービス・ポートレットが自動的に使用可能になります。ただし、ポートレットやページレットが正しく動作するには、実行が必要な構成手順があります。

この項の内容は次のとおりです。

- 第24.9.1項「サービス・バックエンド接続の構成」

- 第24.9.2項「WebCenterサービス・ポートレットのセキュリティの構成」

- 第24.9.3項「WebCenterサービス・ポートレットのトラブルシューティング」

24.9.1 サービス・バックエンド接続の構成

WebCenterサービス・ポートレットに含まれる大半のサービスが完全に機能するには、バックエンド・サーバーとの接続が必要です。たとえば、ドキュメント・サービスにはOracle WebCenterコンテンツ・リポジトリとの接続、ディスカッション・サービスおよびお知らせサービスにはOracle WebCenter Portalのディスカッション・サーバーとの接続が必要です。アプリケーション開発者がプロデューサによって提供されるポートレットやページレットの利用を開始する前に、これらの接続を構成する必要があります。

この項の内容は次のとおりです。

- 第24.9.1.1項「ドキュメント・サービスのコンテンツ・リポジトリ接続の構成」

- 第24.9.1.2項「ワークリスト・サービスとの接続の構成」

- 第24.9.1.3項「ディスカッション・サービスおよびお知らせサービスとの接続の構成」

- 第24.9.1.4項「メール・サービスとの接続の構成」

24.9.1.1 ドキュメント・サービスのコンテンツ・リポジトリ接続の構成

WebCenterサービス・ポートレットには、ドキュメント、ブログおよびWikiサービスによって提供されるタスク・フローのポートレットが含まれます。これらのポートレットには、バックエンドのWebCenterコンテンツ・リポジトリとの接続が必要です。

WebCenterコンテンツの構成の詳細は、第11章「コンテンツ・リポジトリの管理」を参照してください。

WebCenterコンテンツ・リポジトリとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第11.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」を参照してください。

- WLSTコマンドライン・ツールを使用します。詳細は、第11.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」を参照してください。

注意:

WebCenterサービス・ポートレットは、アクティブまたはデフォルトの接続として識別されたWebCenterコンテンツ・リポジトリを使用します。このため、デフォルトとして適切な接続が設定されている必要があります。詳細は、第11.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

24.9.1.2 ワークリスト・サービスとの接続の構成

WebCenterサービス・ポートレットには、ワークリスト・サービスによって提供されるワークリスト・タスク・フロー用のポートレットが含まれます。ワークリスト・サービスでは、ワークリスト・アイテムを監視するすべてのOracle BPELサーバーとの接続が必要です。

Oracle BPELサーバーおよびワークリスト・サービスの構成の詳細は、第23章「ワークリスト・サービスの管理」を参照してください。

Oracle BPELサーバーとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第23.4.2.1項「Fusion Middleware Controlを使用したワークリスト接続の登録」を参照してください。

- WLSTコマンドライン・ツールを使用します。詳細は、第23.4.2.2項「WLSTを使用したワークリスト接続の登録」を参照してください。

24.9.1.3 ディスカッション・サービスおよびお知らせサービスとの接続の構成

WebCenterサービス・ポートレットには、ディスカッションおよびお知らせサービスによって提供されるタスク・フローのポートレットが含まれます。これらのサービスには、Oracle WebCenter Portalのバックエンド・ディスカッション・サーバーとの接続が必要です。両方のサービスが同じ接続を使用します。Oracle WebCenter Portalのディスカッション・サーバーは、Oracle Fusion Middlewareとともに自動的にインストールされますが、サーバーとの接続は作成する必要があります。

ディスカッションおよびお知らせサービスの構成方法の概要は、第14章「お知らせおよびディスカッション・サービスの管理」を参照してください。

Oracle WebCenter Portalディスカッション・サーバーとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第14.3.1項「Fusion Middleware Controlを使用したディスカッション・サーバーの登録」を参照してください。

- WLSTコマンドライン・ツールを使用します。詳細は、第14.3.2項「WLSTを使用したディスカッション・サーバーの登録」を参照してください。

注意:

WebCenterサービス・ポートレットは、アクティブまたはデフォルトの接続として識別されたディスカッション・サーバーを使用します。このため、デフォルトとして適切な接続が設定されている必要があります。詳細は、第14.4項「ディスカッションおよびお知らせ用のアクティブな接続の選択」を参照してください。

24.9.1.4 メール・サービスとの接続の構成

WebCenterサービス・ポートレットには、メール・サービスによって提供されるメール・タスク・フロー用のポートレットが含まれます。このサービスにはバックエンド・メール・サーバーとの接続が必要です。このサーバーでは、Microsoft Exchange Serverや、IMAP4およびSMTPをサポートするメール・サーバーをサポートしています。

メール・サービスの構成の詳細は、第17章「メール・サービスの管理」を参照してください。

メール・サーバーとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第17.4.1項「Fusion Middleware Controlを使用したメール・サーバーの登録」を参照してください。

- WLSTコマンドライン・ツールを使用します。詳細は、第17.4.2項「WLSTを使用したメール・サーバーの登録」を参照してください。

注意:

WebCenterサービス・ポートレットは、アクティブまたはデフォルトの接続として識別されたメール・サーバーを使用します。このため、デフォルトとして適切な接続が設定されている必要があります。詳細は、第17.5項「アクティブな(またはデフォルトの)メール・サーバー接続の選択」を参照してください。

24.9.2 WebCenterサービス・ポートレットのセキュリティの構成

WebCenterサービス・ポートレットは、ユーザーがアクセス権限を持たない情報にアクセスできないように保証します。WSRPプロデューサとして、WebCenterサービス・ポートレットはWS-Securityを使用してアイデンティティ伝播を保証します。

WSRPポートレット・プロデューサにWS-Securityを構成する方法の詳細は、第35.1項「WSRPプロデューサの保護」を参照してください。

注意:

必要なセキュリティ・ポリシーを添付した後で、WC_Portlet管理対象サーバーを再起動する必要があります。

24.9.3 WebCenterサービス・ポートレットのトラブルシューティング

この項の内容は次のとおりです。

- 第24.9.3.1項「ドキュメント・マネージャおよびブログ・ポートレットでリッチ・テキスト・エディタが機能しない」

- 第24.9.3.2項「リスト・ポートレットのリストを管理できない」

- 第24.9.3.3項「ポートレットのタイム・ゾーンまたは日付および時間形式が正しくない」

- 第24.9.3.4項「ポートレットにリモート・ポートレット通信エラーが表示される」

24.9.3.1 ドキュメント・マネージャおよびブログ・ポートレットでリッチ・テキスト・エディタが機能しない

ブログとWikiは、実行時に多様なリソースにアクセスする必要があるリッチ・テキスト・エディタ(CKEditor)を使用します。

WebCenterサービス・ポートレット・プロデューサがファイアウォールの背後にあり、エンドユーザーがそれを超えることができないと、CKEditorが必要とするリソースのURLにアクセスできないため、エディタはWikiを表示するドキュメント・マネージャ・ポートレットやブログ・ポートレットで表示できません。

この問題を解決する手順は次のとおりです。

1. CKEditorリソースを含むアプリケーションを作成します。たとえば、WebCenter PortalのFrameworkアプリケーション・テンプレートを使用して行います。

2. WebCenterサービス・ポートレットを利用するアプリケーションによって使用される同じサーバーにアプリケーションをデプロイします。

3. WebCenterサービス・ポートレット・プロデューサ・アプリケーションを実行します。

4. WebCenter Portal管理コンソールで、「ベース・リソースURL」を編集し、新しいアプリケーションをポイントするようにします。
この方法の詳細は、第36.3.5項「デフォルト・ベース・リソースURLの選択」を参照してください。

5. コンシューマ・アプリケーションを表示するブラウザをリフレッシュします。CKEditorリソースがコンシューマ・アプリケーションと同じ側のファイアウォールで利用できるため、リッチ・テキスト・エディタが正しく表示されます。

24.9.3.2 リスト・ポートレットのリストを管理できない

Administratorロールのメンバーであるユーザーのみが、リストの作成、編集および削除、およびリスト・データの編集が可能です。Administratorロールのメンバー以外のユーザーは、リストの表示のみが可能です。

Administratorロールのメンバー以外のユーザーにリストの管理を可能にするには、Fusion Middleware Controlを使用してユーザーにListPermissionロールに対するmanage権限を割り当てます。

<permission>
<class>oracle.webcenter.list.model.security.ListPermission</class>
<name>/oracle/webcenter/list/templates/lists/.*</name>
<actions>manage</actions>
</permission>

1. Fusion Middleware Controlの「アプリケーション・デプロイメント」の下で「services-producer」アプリケーションを右クリックしてコンテキスト・メニューから「セキュリティ」、次に「アプリケーション・ポリシー」を選択します。

2. 「作成」をクリックします。

3. 「権限受領者」セクションで「追加」をクリックします。

4. 「プリンシパルの追加」ダイアログでリスト権限を付与するユーザーまたはロールを見つけます。

5. 「OK」をクリックします。

6. 「権限」セクションで「追加」をクリックします。

7. 「権限の追加」ダイアログの「権限クラス」ドロップダウン・リストで、「oracle.webcenter.list.model.security.ListPermission」を選択します。

8. 「システム・セキュリティ権限の検索」アイコンをクリックします。

9. 「検索結果」セクションでmanage権限アクションを持つ「リソース名」を選択します。

10. 「続行」をクリックします。

11. 確認ダイアログで、「選択」をクリックして、ターゲット・ユーザーまたはロールの権限を確認します。

12. 「OK」をクリックします。

24.9.3.3 ポートレットのタイム・ゾーンまたは日付および時間形式が正しくない

現在、ユーザー・プリファレンスはポートレット・コンシューマからWebCenterサービス・ポートレット・プロデューサに伝播されていません。つまり、コンシューマ・アプリケーションでのユーザー設定に関する指定とは無関係に、WebCenterサービス・ポートレットは常に、プロデューサがデプロイされているサーバーで設定されたタイム・ゾーンおよび日付時間形式を使用します。

24.9.3.4 ポートレットにリモート・ポートレット通信エラーが表示される

WebCenterサービス・ポートレットによって提供されるポートレットにリモート・ポートレット通信エラーが表示されるのは通常、プロデューサにWS-Securityが構成されていないことが原因です。

この問題を解決する方法の詳細は、第24.9.2項「WebCenterサービス・ポートレットのセキュリティの構成」を参照してください。

24.10 ポートレット・プロデューサ問題のトラブルシューティング

この項の内容は次のとおりです。

- 第24.10.1項「WebCenter Portal: Frameworkアプリケーションにプロデューサを登録できない」

- 第24.10.2項「ポートレットを使用できない: 例外WSM-00101」

24.10.1 WebCenter Portal: Frameworkアプリケーションにプロデューサを登録できない

この項では、プロデューサの登録とポートレットが使用できない問題について説明します。

問題

WSRPプロデューサを登録できません。

解決策

次のことを確認します。

- バックエンド・プロデューサが起動され実行されている。プロデューサをテストするには、ブラウザ・ウィンドウでプロデューサのWSDL URLにアクセスします。第24.3項「WSRPプロデューサの接続テスト」を参照してください。

- プロデューサ・アプリケーションが正しくパッケージされている。そうでない場合、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の「ポートレットの消費」のFrameworkアプリケーションを使用したポートレット・プロデューサの登録に関する項の記載に従ってJDeveloperで設計時にプロデューサを登録し、第7.1項「Frameworkアプリケーションのデプロイ」の記載に従ってアプリケーションを再度デプロイしてください。再度デプロイした後、パッケージ・アプリケーションにMBean ProducerManagerが含まれていることを確認します。

1. Fusion Middleware Controlで、「アプリケーション・デプロイメント」メニューから、「システムMBeanブラウザ」を選択します。

2. ナビゲータで「アプリケーション定義のMBean」→「oracle.webcenter.portlet」→「アプリケーション: application_name」→「プロデューサ・マネージャ」→「プロデューサ・マネージャ」の順に開きます。

- PortletServletContextListenerがweb.xmlファイルに追加されます。
デプロイ後登録のプロデューサをサポートするアプリケーションに対して、プロデューサを設計時に1回以上登録する必要があります。これによりPortletServletContextListenerがweb.xmlファイルに追加され、適切なランタイムMBeansを登録し、デプロイ後登録のプロデューサが可能になります。たとえば、次のweb.xmlスニペットで太字になっているテキストを参照してください。

<listener>
<description>
WebCenter Portlet Context Listener
</description>
<display-name>
WebCenterPortletContextListener
</display-name>
<listener-class>
oracle.webcenter.portlet.listener.PortletServletContextListener
</listener-class>
</listener>

24.10.2 ポートレットを使用できない: 例外WSM-00101

WSRPポートレット・プロデューサのユーザー名(パスワードあり)トークン・プロファイルを設定すると、例外WSM-00101が発生します。

問題

Fusion Middleware Control (またはWLST)を使用してWSRPプロデューサのユーザー名(パスワード・トークンあり)プロファイルを設定するとき、そのプロデューサと関連付けられたポートレットが使用中の場合、WebCenter Portalアプリケーションに次の例外が表示されます。

oracle.wsm.common.sdk.WSMException: WSM-00101:
The specified Keystore file
/keys/user_projects/domains/pv_0309/config/fmwconfig/default-keystore.jks
cannot be found; it either does not exist or its path is not included in the application classpath.

解決策

ポートレット・プロデューサにデフォルトのキーストアが構成されていることを確認します。詳細は、第35.1.3項「キーストアの設定」を参照してください。

25 Oracle WebCenter Portalのページレット・プロデューサの管理

Oracle WebCenter Portalのページレット・プロデューサは(以前はOracle WebCenter Ensembleと呼ばれていました)、ページレットの動的な開発とデプロイに役立つ有用なツールのセットを提供します。ページレット・プロデューサのプロキシは、内部のアプリケーションや保護されたコンテンツを含む内部リソースへの外部アクセスをユーザーに提供します。ページレット・プロデューサを使用すれば、WSRPおよびOracle JPDKポートレットとOpenSocialガジェットを、Webページまたはアプリケーションで使用できるようにページレットとして公開できます。

この章では、ページレット・プロデューサの管理コンソールを使用してページレットを登録、編集およびデプロイする方法について説明します。

この章の内容は次のとおりです。

- 第25.1項「ページレット・プロデューサについて」

- 第25.2項「ページレット・プロデューサの登録」

- 第25.3項「ページレット・プロデューサの設定の構成」

- 第25.4項「リソースの作成」

- 第25.5項「ページレットの作成」

- 第25.6項「Webインジェクタの作成」

- 第25.7項「カスタム・パーサーの作成」

- 第25.8項「ホストされたファイルの作成」

- 第25.9項「WSRPおよびOracle JPDKポートレット・プロデューサの登録」

- 第25.10項「トラブルシューティング」

対象読者

この章の内容は、Fusion Middleware管理者を対象としています。詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。

25.1 ページレット・プロデューサについて

この項では、ページレット・プロデューサの概念と機能について概説します。この項の内容は次のとおりです。

- 第25.1.1項「主要な概念」

- 第25.1.2項「WSRPおよびOracle JPDKポートレットのサポート」

- 第25.1.3項「OpenSocialガジェットのサポート」

- 第25.1.4項「Oracle WebCenter Interactionポートレットのサポート」

25.1.1 主要な概念

次に示す主要な概念を理解しておくと、ページレット・プロデューサを使用するときに役立ちます。

- ページレット・プロデューサ・コンソールは、ページレット・プロデューサのデプロイで様々なオブジェクトの作成と管理に使用されるブラウザ・ベース管理ツールです。このコンソールから、Webアプリケーションをリソースとして登録する、ページレットを作成する、プロキシと変換の設定を管理するなどの操作を実行できます。
ページレット・プロデューサ・コンソールには、WebブラウザでURLとしてhttp://<host_name>:<port_number>/pagelets/adminを指定するとアクセスできます。

ページレット・プロデューサ・コンソールには、ホスト・アプリケーション・サーバーで管理者ロールを割り当てられたユーザーなら誰でもアクセスできます。アプリケーション・サーバーへの管理アクセス権を持たないユーザーにページレット・プロデューサ・コンソールへの管理アクセス権を付与するには、EnsembleAdminロールを使用します。

ページレット・プロデューサ・コンソールは、http://<host_name>:<port_number>/pagelets/accessibleでアクセス可能モードで起動することもできます。

- リソースは、ページレット・プロデューサ内でアプリケーションを登録するために使用される中核的オブジェクトであり、スタンドアロンWebアプリケーション、ポートレット・プロデューサおよびOpenSocialコンテナが含まれます。リソースを作成すると、外部URLへの内部アプリケーションのマッピング、認証の管理およびアプリケーションの変換をプロキシでできます。Webアプリケーションをページレット・プロデューサのリソースとして登録すると、次の操作ができます。

- 外部アドレスへの内部Webアプリケーションのプロキシ。

- プロキシ・レベルとリソース・レベル両方での認証の管理。

- プロキシされたWebアプリケーションの変換(URLのリライトを含む)。

- ページレットは、ページレット・プロデューサを介してアクセスされるWebページのサブコンポーネントであり、プロキシされたアプリケーションに挿入できます。ページレット・プロデューサ・リソースにあるマークアップを返すアプリケーションならどれでもページレットとして登録でき、Oracle WebCenter Portal、Spacesまたは任意のWebアプリケーションで表示できます。
ページレットは、ポートレットに似た再利用可能なユーザー・インタフェース・コンポーネントです。ポートレットはポータル用に設計されたものですが、ページレットは任意のWebページで実行できるように設計されています。どのようなHTMLフラグメントでもページレットにできます。ページレット開発者は、他のページレットと動的に相互作用し、Asynchronous Javascript and XML (AJAX)を使用してユーザー入力に対応する、パラメータ化され構成可能なページレットを作成できます。

ページレット・プロデューサの登録は動的です。既存のプロデューサに対する追加と更新は即時使用可能になります。ほとんどの場合、WebCenter Portalアプリケーションや管理サーバーを再起動する必要はありません。

注意:

現在のリリースでは、ページレット・プロデューサの管理設定を変更できるのは一度に1人の管理者のみです。同時に複数の編集が行われた場合、1つの編集のみが成功します。ただし、データの整合性は常に保持されます。

25.1.2 WSRPおよびOracle JPDKポートレットのサポート

ページレット・プロデューサを使用すれば、WSRPおよびOracle JPDKポートレットを、Webページまたはアプリケーションで使用できるようにページレットとして公開できます。

第25.2項「ページレット・プロデューサの登録」の説明に従ってページレット・プロデューサを設定した後、次の手順に従ってWSRPまたはOracle JPDKポートレットをインポートします。

1. 第25.9項「WSRPおよびOracle JPDKポートレット・プロデューサの登録」の説明に従って、ポートレット・プロデューサをページレット・プロデューサに登録します。

2. これにより、プロデューサのポートレット定義に基づいて、ページレット・プロデューサ・コンソールにリソースとページレットが自動的に作成されます。リソース設定の詳細は、第25.4項「リソースの作成」を参照してください。

3. インポートしたリソースや関連付けられたページレットに変更を加えるには、インポートしたリソースをコピーする必要があります。詳細は、第25.9.3項「WSRPおよびOracle JPDKポートレットの使用」を参照してください。

25.1.3 OpenSocialガジェットのサポート

ページレット・プロデューサを使用すれば、OpenSocialガジェットをWebページまたはアプリケーションで使用できるようにページレットとして公開できます。

第25.2項「ページレット・プロデューサの登録」の説明に従ってページレット・プロデューサを設定した後、次の手順に従ってOpenSocialガジェットをインポートしてください。

1. 第25.3.6「OpenSocial設定」の説明に従って、OpenSocialコンテナを定義します。

2. 第25.4項「リソースの作成」と第25.4.3項「OpenSocialリソース用の構成ページ(OpenSocialガジェット・プロデューサ)」の説明に従って、ページレット・プロデューサ・コンソールにOpenSocialリソースを作成します。

3. 第25.5項「ページレットの作成」の説明に従って、OpenSocialガジェット用のページレットを作成します。ページレット・プロデューサ・コンソールで、OpenSocialからガジェットのメタデータをインポートして、ページレットの設定を移入できます。

25.1.4 Oracle WebCenter Interactionポートレットのサポート

ページレット・プロデューサを、Oracle WebCenter Interaction用のポートレット・プロバイダとして使用できます。いくつかの構成ページで、Oracle WebCenter Interactionと連携するためのCSP設定を定義できます。

1. Oracle WebCenter Interactionの資格証明マッパー、SOAP APIサービスおよびイメージ・サービスとともに使用するために、ページレット・プロデューサの設定を構成します。第25.3項「ページレット・プロデューサの設定の構成」の「CSP設定」を参照してください。

2. 第25.4項「リソースの作成」の説明に従ってCSPリソースを作成して、ポートレット・コードをホストするサーバーへのページレット・プロデューサ接続を設定します。

3. 第25.5項「ページレットの作成」の説明に従って、Oracle WebCenter Interactionポートレット用のページレットを作成します。

25.2 ページレット・プロデューサの登録

この項では、Fusion Middleware ControlとWLSTコマンドを使用してページレット・プロデューサを登録および構成する方法について説明します。この項の内容は次のとおりです。

- 第25.2.1項「Fusion Middleware Controlを使用したページレット・プロデューサのWebCenter Portalアプリケーション用の登録」

- 第25.2.2項「WLSTを使用したページレット・プロデューサのWebCenter Portalアプリケーション用の登録」

- 第25.2.3項「ページレット・プロデューサ・サービスの構成」

- 第25.2.4項「WebCenter Portal: Spacesを使用したページレット・プロデューサの登録」

25.2.1 Fusion Middleware Controlを使用したページレット・プロデューサのWebCenter Portalアプリケーション用の登録

ページレット・プロデューサを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

- 第6.2項「Spacesアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「プロデューサの登録」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「プロデューサの登録」を選択します。

3. ページレット・プロデューサの接続詳細を入力します(表25-1)。

表25-1 ページレット・プロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portalアプリケーション内でこのページレット・プロデューサ・インスタンスを識別するための一意の名前を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。ここで指定した名前は、「マッシュアップ」→「ページレット・プロデューサ」フォルダにあるComposerに表示されます(デフォルト)。

プロデューサ・タイプ

「ページレット・プロデューサ」を選択します。

サーバーURL

ページレット・プロデューサのURLを入力します。このURLは完全修飾ドメイン名を含んでいる必要があります。次の構文を使用します。

<protocol>://<host_name>:<port_number>/pagelets/

次に例を示します。

http://myhost.com:7778/pagelets/

ページレットにセキュアなデータが含まれている場合、登録するURLでhttpsプロトコルを使用する必要があります。次に例を示します。

https://myhost.com:7779/pagelets/

コンテキスト・ルートは、必要に応じて/pagelets/から変更できます。詳細は、第25.3項「ページレット・プロデューサの設定の構成」を参照してください。

注意: Spacesでは、ページレット・プロデューサのURLがOAMによって保護されている場合、ページレット・カタログへのURLを除外する(アクセス制御なしで直接マップする)必要があります。そうしないと、RESTを使用した場合にカタログが空白になります。ページレット・カタログのURLは、http://<host_name>:<port_number>/ pagelets/api/v2/ensemble/pageletsです。

4. 「OK」をクリックします。新しいプロデューサが接続表に表示されます。

25.2.2 WLSTを使用したページレット・プロデューサのWebCenter Portalアプリケーション用の登録

registerPageletProducerコマンドを使用して、ページレット・プロデューサをWebCenter Portalアプリケーション用に登録します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterPageletProducerに関する項を参照してください。

WLSTを使用して、現在の接続詳細を表示または編集することもできます。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

25.2.3 ページレット・プロデューサ・サービスの構成

この項では、Oracle構成ウィザードを使用して、ページレット・プロデューサをOracle WebCenter Portalでサービスとして使用できるように設定する方法について説明します。

ページレットの開発とデプロイの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle WebCenter Portalのページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

ページレット・プロデューサをWebCenter Portalのサービスとして設定する手順は、次のとおりです。

1. 構成ウィザードを起動します(「Oracle Fusion Middleware」→「Oracle WebLogicサーバー」→「ツール」→「構成ウィザード」)。

2. 「新しいWebLogicドメインの作成」を選択します。「次へ」をクリックします。

3. 「既存のテンプレートを、このドメインのベースにする」を選択し、ページレット・プロデューサ・ドメイン・テンプレートを選択します。そのテンプレートの場所が正しいことを確認し、「次へ」をクリックします。

4. ドメイン構成ウィザードを完了します。詳細は、オンライン・ヘルプを参照してください。

デプロイ後に行った接続構成はすべて、Oracle Metadata Services (MDS)リポジトリに保存されます。詳細は、第1.3.5項「WebCenter Portalの構成に関する考慮事項」を参照してください。MDSの詳細は、『Oracle Fusion Middleware管理者ガイド』の「Oracle Metadata Repositoryの管理」を参照してください。

ページレット・プロデューサでは、すべての構成データがRCUのMDSスキーマの個別パーティションに保存されます。通常、このスキーマはOracle WebCenter Portalインストールの一環としてインストールされます。この構成データは、他のサービスに属するデータとは競合しません。ページレット・プロデューサ・ドメイン・テンプレートがデプロイされると、そのスキーマが作成されたデータベースへの接続に関する情報をウィザードで入力するよう求められます。ページレット・プロデューサで想定されている名前は次のとおりです。

- データ・ソース名: mds-PageletProducerDS

- JNDI名: jdbc/mds/PageletProducerDS

- MDSパーティション名: pageletproducer

OpenSocialガジェットをWebCenter Portalのプロファイルおよびアクティビティ機能とともに使用するには、WC_PortletサーバーをターゲットにするようにWebCenterDSデータ・ソースを手動で構成する必要があります。

1. Oracle WebLogic Serverコンソールで、「サービス」→「データ・ソース」へ移動します。

2. 「WebCenterDS」データ・ソースをクリックします。

3. 「ターゲット」タブへ移動します。

4. 「WC_Portlet」サーバーを選択して「保存」をクリックします。

25.2.4 WebCenter Portal: Spacesを使用したページレット・プロデューサの登録

この項では、WebCenter Portal: Spacesでページレット・プロデューサを登録する方法について説明します。

1. Spacesにログインして「管理」をクリックします。

2. 「構成」タブに移動して「サービス」をクリックします。

3. 「サービスとプロバイダ」ページで、「ポートレット・プロデューサ」をクリックします。

4. 「登録」をクリックし、「ページレット・プロデューサ」を選択します。

5. 次の情報を入力します。

- プロデューサ名: Spacesでページレット・プロデューサ登録を識別するために使用されます。

- サーバーURL: http://host:port/pageletsという形式のページレット・プロデューサへのURL (hostとportは、ページレット・プロデューサが構成されているWC_Portlet管理対象サーバーに対応)。

25.3 ページレット・プロデューサの設定の構成

ページレット・プロデューサ・コンソールの「設定」セクションから、すべてのページレット・プロデューサ・リソースに影響する重要な構成設定にアクセスできます。ページレット・プロデューサ・コンソールの概要は、第25.1項「ページレット・プロデューサについて」を参照してください。

「設定」セクションには次のページが含まれています。

- 第25.3.1項「ロギング設定」

- 第25.3.2項「プロキシ設定」

- 第25.3.3項「変換設定」

- 第25.3.4項「CSP設定」

- 第25.3.5項「Kerberos設定」

- 第25.3.6項「OpenSocial設定」

25.3.1 ロギング設定

「ロギング」ページでは、ページレット・プロデューサの各コンポーネントのロギング・レベルを設定できます。

図25-1 ページレット・プロデューサ・コンソール: 「設定」 - 「ロギング」

「図25-1 ページレット・プロデューサ・コンソール: 「設定」 - 「ロギング」」の説明

コンポーネントのロギングを有効にするには、次のいずれかのロギング・レベルを選択します。

- 重大

- 警告

- 情報

- 構成

- 詳細

- より詳細

- 最も詳細

ロギング・メッセージは、管理対象サーバーのログ・ファイルで確認できます。Oracle WebLogic Serverの場合、これはdomain_home/servers/managed server name/managed server name.logとmanaged server name-diagnostic.logです。

25.3.2 プロキシ設定

「プロキシ」ページでは、プロキシされないURLのセミコロン区切りリストを定義でき(ワイルドカード使用可能)、必要に応じてHTTPプロキシ構成(URL、ユーザー名およびパスワード)を設定できます。

プロキシ設定を変更した後、ページレット・プロデューサを再起動する必要があります。

注意:

デプロイ環境で外部接続にHTTPプロキシが必要な場合、最初にサーバーを起動したときに接続エラーが報告されます。これらのエラーは、環境に問題があることを示しているのではなく、リモートからロードできない外部OpenSocialライブラリがあることを示します。これらのエラーは、前述のようにプロキシ設定を構成してサーバーを再起動することで解決できます。

Oracle WebLogic Serverデプロイの場合の注意:

「プロキシ」ページで入力されたHTTPプロキシ・サーバーURLは、ページレット・プロデューサをホストしているサーバーで実行されるすべてのアプリケーションに適用されます(Oracle WebLogic Serverの場合、この設定はWC_Portlet管理対象サーバーで実行されるすべてのアプリケーションに適用)。Oracle WebLogic Serverユーザーは、この設定に特に注意して、WLS管理サーバー・ホストとすべてのクラスタ化された管理対象サーバーを「プロキシしないホスト」リストに含める必要があります。

図25-2 ページレット・プロデューサ・コンソール: 「設定」 - 「プロキシ」

「図25-2 ページレット・プロデューサ・コンソール: 「設定」 - 「プロキシ」」の説明

25.3.3 変換設定

「変換」ページでは、資格証明ボールト・プロバイダへのパスを入力したり、ページレット・プロデューサ用のセキュアなポートとセキュアでないポートを構成できます。このページでは、Ajaxリクエストのインターセプトと変換を行うかどうかと、変換の前後のコンテンツをログに記録するかどうか(このオプションはデバッグに役立ちますが、本番環境では有効にしないでください)も選択できます。

注意:

「非セキュア・ポート」のデフォルトは8889です。ページレット・プロデューサが別のポートにデプロイされている場合、このエントリを変更してサーバーを再起動してください。

図25-3 ページレット・プロデューサ・コンソール: 「設定」 - 「変換」

「図25-3 ページレット・プロデューサ・コンソール: 「設定」 - 「変換」」の説明

25.3.4 CSP設定

CSPは、オープン標準HTTP 1.1に基づいてプラットフォームに依存しないプロトコルです。CSPは、ページレット・プロデューサと外部リソースの間での通信の構文を定義します。また、カスタム・ヘッダーを定義し、サービスで通信と設定変更にHTTPがどのように使用されるかも定義します。

このページでは、Oracle WebCenter Interactionの資格証明マッパー、SOAP APIサービスおよびイメージ・サービスを構成できます。

注意:

デプロイにOracle WebCenter Interactionが存在しない場合、このページは無視されます。これらの設定は、Oracle WebCenter Interaction用に作成されたCSPポートレットとの下位互換性を保つために使用されます。

25.3.5 Kerberos設定

このページは、Kerberos構成ファイル(java.security.krb5.confとjava.security.auth.login.conf)へのパスを定義するために使用されます。これらの2つの構成ファイルは、Kerberosサービス・チケットをどこで取得するかをHTTPClientに指示するようにKerberosレルムとKDCを構成するために必要です。

25.3.6 OpenSocial設定

このページでは、ページレット・プロデューサをOpenSocialガジェットと連携するように構成できます。

図25-4 ページレット・プロデューサ・コンソール: 「設定」 - 「OpenSocial」

「図25-4 ページレット・プロデューサ・コンソール: 「設定」 - 「OpenSocial」」の説明

このページには次の設定が含まれます。

- 「コンテキスト」フィールドでは、ページレット・プロデューサがデプロイされているコンテキストを定義します。OpenSocialコンテナで変更が必要な場合以外、この値はデフォルト設定(pagelets)のままにしてください。

- 「ホスト」フィールドには、ページレット・プロデューサ・ホストの完全修飾ドメイン名が表示されます。この値は環境から自動的に取得されます。取得されない場合、正しい構成設定が適用されるようにサーバーを再起動してください。「コンテキスト」設定と同様に、OpenSocialコンテナで変更が必要な場合以外、この値はデフォルト設定のままにしてください。

- 「キャッシュ」オプションでは、OpenSocialガジェット用にページレット・プロデューサの内部キャッシュを有効にできます。

- 「デバッグ」オプションでは、OpenSocialガジェットのデバッグを有効にできます(Javascriptの不明瞭化が無効になります)。

- 「SSL」オプションでは、OpenSocialガジェット用にSSLを有効にできます。

注意:

OpenSocialガジェットをインポートする前に、セキュアな(HTTPS)ポートとセキュアでない(HTTP)ポートも構成する必要があります。これらの設定の詳細は、第25.3.3項「変換設定」を参照してください。

25.4 リソースの作成

第25.1項「ページレット・プロデューサについて」で述べたように、リソースとはページレット・プロデューサに登録されたアプリケーションです。アプリケーションをリソースとして登録すると、外部URLへの内部アプリケーションのマッピング、認証の管理およびアプリケーションの機能の変換を、プロキシでできます。

新規のリソースを作成する手順は次のとおりです。

1. ページレット・プロデューサ・コンソールのナビゲータで、ドロップダウン・リストから「リソース」を選択します。

2. 既存リソースをクリックし、ナビゲータ・ツールバーの「作成」アイコンをクリックします。(このボタンは、作成可能なオブジェクト・タイプが選択されている場合にのみ使用可能です。)

図25-5 ページレット・プロデューサ・コンソール - リソースの作成

「図25-5 ページレット・プロデューサ・コンソール - リソースの作成」の説明

3. 「プロデューサ・タイプの選択」ダイアログ・ボックスで、プロキシするリソースを構成するプロデューサのタイプをドロップダウン・リストから選択します。

- Web: 任意の標準Webアプリケーション

- CSP: CSPポートレット・プロバイダ・アプリケーション(Oracle WebCenter Interactionとともに使用するため)

- WSRP/JPDK: WSRPまたはOracle JPDKポートレット・プロデューサ(このタイプのリソースを作成する前に、第25.9項「WSRPおよびOracle JPDKポートレット・プロデューサの登録」の説明に従って関連するプロデューサを登録してください)

- OpenSocial: OpenSocialコンテナ

図25-6 「プロデューサ・タイプの選択」ダイアログ

「図25-6 「プロデューサ・タイプの選択」ダイアログ」の説明

4. 「OK」をクリックします。リソースのリストに「<新規>」というエントリが追加されます。この新しいリソースには、選択したプロデューサ・タイプに必要な構成ページが含まれます。

5. ページレット・プロデューサ・コンソールでリソースを構成します。必要な構成ページは、プロデューサのタイプによって異なります。変更を任意の時点で保存するには、ナビゲータ・ツールバーの「保存」アイコンをクリックします。

- 第25.4.1項「構成ページ: WebおよびCSPリソース」

- 第25.4.2項「WSRP/JPDKリソース用の構成ページ(WSRPおよびOracle JPDKポートレット・プロデューサ)」

- 第25.4.3項「OpenSocialリソース用の構成ページ(OpenSocialガジェット・プロデューサ)」

リソースを定義したら、ページレットと他のオブジェクトをリソース内に作成します。

- 第25.5項「ページレットの作成」

- 第25.6項「Webインジェクタの作成」

- 第25.7項「カスタム・パーサーの作成」

- 第25.8項「ホストされたファイルの作成」

25.4.1 構成ページ: WebおよびCSPリソース

WebリソースおよびCSPリソース用には、次の構成ページが使用されます。

- 第25.4.1.1項「全般」

- 第25.4.1.2項「CSP」

- 第25.4.1.3項「ポリシー」

- 第25.4.1.4項「自動ログイン」

- 第25.4.1.5項「ヘッダー」

この項では、ページレット・プロデューサのインストール時に作成されるwelcome_resourceを例として使用します。

25.4.1.1 全般

「全般」ページで、リソースの基本情報を入力します。

図25-7 ページレット・プロデューサ・コンソール: 「リソース」 - 「全般」ページ

「図25-7 ページレット・プロデューサ・コンソール: 「リソース」 - 「全般」ページ」の説明

- リソースの名前を入力します。

- リソースの説明を入力します(オプション)。

- 「ソースURL」フィールドに、プロキシされるWebアプリケーション・リソースの場所のURLを入力します。例: http://internalServer/foo/

注意:

ADF Webアプリケーションをリソースとして構成する場合、「ソースURL」をhttp://hostname:portnumber/context-root/より詳しく指定できません。

- デフォルトでは、ページレット・プロデューサはリソースとの接続を30秒間試行してからエラー・メッセージを返します。この値を変更するには、「ソースのタイムアウト」に新しい時間を秒数で入力します。

- 「宛先URL」フィールドに、リソースのアクセスに使用する相対パスを入力します。このパスは、ページレット・プロデューサをホストするサーバー上のリソースへのURLを作成するために使用されます。

- ページレット・プロデューサでは、デフォルトで「URLリライト」が有効になっています。URLリライトを有効にすると、プロキシされたアプリケーションにおいてソースURL接頭辞で始まるURLが、宛先URL接頭辞を指すようにページレット・プロデューサでリライトされます。他のプロキシされたCSPまたはWebアプリケーション(ページレット・プロデューサにも登録されている)を指しているURLがある場合、そのURLもプロキシを使用するようにリライトされます。
次の2つのケースでは、URLリライトを無効にする必要があります。

- 内部URL接頭辞と外部URL接頭辞が同じ場合。この場合、ユーザーのDNSがページレット・プロデューサのプロキシ・サーバーへのURLを解決し、ページレット・プロデューサのプロキシ・サーバーのDNSが内部リソースへのURLを解決する必要があります。DNSが解決するのはIPのみで、ポートは解決しないため、両方のサーバーが同じポートをリスニングする必要があります。この方法を強くお薦めします。

- アプリケーションのすべてのリンクが相対URLである場合。この場合、内部URL接頭辞のパスと外部URL接頭辞のパスが同じである必要があります。たとえば、内部URL接頭辞がhttp://internal_server/bar/の場合、外部URL接頭辞のパスは/bar/またはhttp://proxy_server/bar/である必要があります。

変換を無効にするには、「URLリライト」の選択を解除します。

- 動的HTMLを有効にするには、「DHTMLリライト」を選択します。このオプションは、サーバーから返された元のHTMLにはなくDHTMLによって追加されたURLをサポートします。ほとんどの場合、このオプションは有効にする必要があります。

25.4.1.2 CSP

「CSP」ページで指定されたプリファレンス・ヘッダーは、ページレット・プロデューサとリモートCSPコンテンツ・プロデューサとの間で受け渡されます。基本的なプリファレンス・タイプはネイティブでサポートされており、その他のプリファレンス・タイプは基本タイプの1つにマップされます。

注意:

Web標準(JavaScriptやHTMLなど)を使用して作成されたコンテンツにアクセスする場合、これらの設定は、すべて無視することも、CSPプロトコルのドキュメントに記載された方法でCSP-Set-PreferenceヘッダーとCSP-Get-Preferenceヘッダーを送信することで部分的に利用することもできます。

図25-8 ページレット・プロデューサ・コンソール: 「リソース」 - 「CSP」ページ

「図25-8 ページレット・プロデューサ・コンソール: 「リソース」 - 「CSP」ページ」の説明

ユーザーおよびセッション・スコープのプリファレンスは、複数のページレットで共有できます。CSPメタデータを使用すると、どのセッション・プリファレンスを設定または取得(アプリケーションから)できるかと、どのユーザー情報プリファレンスをアプリケーションに送信するかを指定できます。たとえば、従業員IDなどの個人情報をユーザー・プリファレンスとして保存する場合、どのページレットがその情報にアクセスできるかを制御できます。

デフォルトでは、CSPログイン・トークンは、プロキシされたリソースには渡されません。この機能を有効にするには、「CSPログイン・トークンの送信」を選択します。ページレット・プロデューサから取得する必要がある各設定の名前とタイプを入力することもできます。

注意:

リソースに関連付けられたページレットはこのメタデータを継承します。

25.4.1.3 ポリシー

「ポリシー」ページにより、Oracle WebCenter Portal内で特定ロールへのリソースのアクセスを制限できます。

図25-9 ページレット・プロデューサ・コンソール: 「リソース」 - 「ポリシー」ページ

「図25-9 ページレット・プロデューサ・コンソール: 「リソース」 - 「ポリシー」ページ」の説明

ページレット・プロデューサ(Oracle WebLogic Serverなど)をホストするJ2EEコンテナは、現在のユーザーに関連付けられたロール・メンバーシップを確立する処理を行います。リソースにより複数のロールを「ポリシー」ページで指定でき、ユーザーがいずれかの指定ロールのメンバーの場合、アクセスが許可されます。それ以外の場合、適切なJ2EEコンテナで委任された認証ページに転送され、必要な資格証明を確立します。ロールがリストに入力されていない場合、匿名アクセスが許可され、リソースは匿名リソースと呼ばれます。

注意:

このページで入力したロール名は、J2EEコンテナで作成したものと一致する必要があります(Oracle WebLogic Serverなど)。

25.4.1.4 自動ログイン

自動ログイン機能を利用すれば、アプリケーションに対する資格証明がページレット・プロデューサで自動的に入力できます。「自動ログイン」ページでは、リソースにアクセスするすべてのユーザーがそのリソースを使用できるように、認証情報を構成できます。

図25-10 ページレット・プロデューサ・コンソール: 「リソース」 - 「自動ログイン」ページ

「図25-10 ページレット・プロデューサ・コンソール: 「リソース」 - 「自動ログイン」ページ」の説明

次の各項では、認証用の資格証明マッピングを構成する方法について説明します。

- 第25.4.1.4.1項「フォーム・ログイン」では、HTMLフォームを使用して認証の入力を求めるリソースの自動ログインを構成する方法について説明します。

- 第25.4.1.4.2項「「基本ログイン」と「NTLMログイン」」では、Basic認証またはNTLM認証を使用して認証の入力を求めるリソースの自動ログインを構成する方法について説明します。

- 第25.4.1.4.3項「Kerberosログイン」では、Kerberosを使用して認証の入力を求めるリソースの自動ログインを構成する方法について説明します。

- 第25.4.1.4.4項「認証のソース」では、静的、ユーザー・プロファイルおよび資格証明ボールト認証フィールドのソースについて説明します。

25.4.1.4.1 フォーム・ログイン

この項では、HTMLフォームを使用して認証の入力を求めるリソースの自動ログインを構成する方法について説明します。

1. リソースの「自動ログイン」ページで、「フォーム・ログイン」セクションを開きます。

2. ログイン・ページは、URLか正規表現によって指定できます。「ログイン・フォームの識別」セクションで、次のいずれかのオプションを選択します。

- ログイン・フォームの場所が静的URLの場合、「URL」を選択してボックスにそのURLを入力します。「フォーム・フィールドの自動検出」をページで選択することも、後述の手順5で説明しているように手動で入力することもできます。

- ログイン・フォームが動的な場合、「RegEx」を選択し、正規表現パターンをボックスに入力します。

3. ログイン・フォームのアクションを設定します。「フォームの送信場所」セクションで、次のいずれかのオプションを選択します。

- ログイン・フォームのアクションが静的URLの場合、「URL」を選択してボックスにそのURLを入力します。フォーム送信のアクションとして、「POST」または「GET」を選択します。

- ログイン・フォームが動的な場合、「RegEx」を選択し、正規表現パターンをボックスに入力します。

4. フォームの各フィールドを認証フィールド・ソースにマップするには、「ログイン・フォームの識別」セクションで「フォーム・フィールドの自動検出」をクリックするか、次の手順を使用して手動で入力します。

1. 「作成」をクリックし、「フォーム・フィールド」リストに新しい行を追加します。

2. HTMLフォームへの入力の名前を「フィールド名」ボックスに入力します。

3. 「ソース」プロパティと「値」プロパティを構成する方法の詳細は、第25.4.1.4.4項「認証のソース」を参照してください。

注意:

機密フィールドは、資格証明ボールト(ユーザー・ボールトまたは共有ボールト)を使用して安全に保存する必要があります。

4. フィールドのマッピングを削除するには、「削除」をクリックします。

5. ログアウト・ページとログイン・エラー・ページも、URLか正規表現によって指定できます。「ログアウト・ページID」セクションと「ログイン・エラー・ページの識別」セクションで、次のいずれかのオプションを選択します。

- ページの場所が静的URLの場合、「URL」を選択し、入力用のフィールドにそのURLを入力します。

- ページが動的な場合、「RegEx」を選択し、入力用のフィールドに正規表現パターンを入力します。

25.4.1.4.2 「基本ログイン」と「NTLMログイン」

この項では、Basic認証またはNTLM認証を使用して認証の入力を求めるリソースの自動ログインを構成する方法について説明します。

1. リソースの「自動ログイン」ページで、「基本ログイン」セクションまたは「NTLMログイン」セクションを開きます。

注意:

Basic認証ではパスワードがプレーン・テキストとして送信されるため、本番システムではBasic認証を使用しないでください。また、基礎となるトランスポートとしてHTTPSを使用することを強くお薦めします。

2. 「ユーザー名」と「パスワード」のセクションで、適切な認証ソースを選択し、必要に応じて値を入力します。これらのプロパティを構成する方法の詳細は、第25.4.1.4.4項「認証のソース」を参照してください。

25.4.1.4.3 Kerberosログイン

この項では、Kerberosを使用して認証の入力を求めるリソースの自動ログインを構成する方法について説明します。基本的なKerberos設定の定義の詳細は、第25.3項「ページレット・プロデューサの設定の構成」を参照してください。

1. リソースの「自動ログイン」ページで、「Kerberosログイン」セクションを開きます。

2. 「ユーザー名」と「パスワード」のセクションで、適切な認証ソースを選択し、必要に応じて値を入力します。これらのプロパティを構成する方法の詳細は、次の第25.4.1.4.4項「認証のソース」を参照してください。

3. 「SPN」フィールドに、Kerberosアカウントのサービス・プリンシパル名(SPN)をhttp://hostname_with_kerberosという形式で入力します。(Kerberos認証サービスがSPNを使用してサービスを認証する前に、そのサービス・インスタンスがログオンに使用するアカウント・オブジェクトにそのSPNが登録されている必要があります。)

25.4.1.4.4 認証のソース

認証のソースは、各ログイン・フィールドのソースを定義します。次の表で、各認証フィールドのソース値について説明します。

表25-2 ページレット・プロデューサの認証のソース

フィールド

説明

静的

リソースにアクセスするすべてのユーザーについて、提供された認証情報を使用します。入力用のフィールドに静的値を入力します。

プロファイル

ユーザーのOracle WebCenter Portalプロファイルからのプロパティを使用して、認証の資格証明データを指定します。

「ユーザー・ボールト」または
「共有ボールト」

リソースが初めてアクセスされると、ユーザーに資格情報の入力を求めます。指定された資格証明は暗号化されて資格証明ボールトに保存され、その後、そのリソースに対するアクセスは保存された資格証明を使用して認証されます。ボールト・ストレージを使用する場合、キー名としては、実際のパスワードなどの機密情報を反映しない汎用プレースホルダを選択してください。2番目のフィールドには、使用する資格証明ボールトの名前を入力するか、エントリをデフォルトのままにしてサーバー・ボールトを使用します。

ユーザー・ボールトには各ユーザーの各キーごとに1つの値が保存され、共有ボールトには全ユーザー用の各キーごとに1つの値が保存されます。

25.4.1.5 ヘッダー

「ヘッダー」ページでは、ページレット・プロデューサが提供するHTTPから削除する必要があるリクエスト・ヘッダーとレスポンス・ヘッダーを選択できます。

図25-11 ページレット・プロデューサ・コンソール: 「リソース」 - 「ヘッダー」ページ

「図25-11 ページレット・プロデューサ・コンソール: 「リソース」 - 「ヘッダー」ページ」の説明

一部のヘッダー要素は、バックエンド・アプリケーションに渡されないようにブロックする必要があります。たとえば、委任(サード・パーティSSO)認証を使用する場合、SSOシステムがバックエンド・アプリケーションに渡す必要のないヘッダーを挿入することがあります。渡されるとこれらのヘッダーは、バックエンド・アプリケーションの機能を阻害する可能性があります。

このページでヘッダーを指定すると、指定したヘッダーのみが削除されます。ヘッダーを明示的に指定しなかった場合、デフォルトで次のヘッダーが削除されます。

リクエスト・ヘッダー

レスポンス・ヘッダー

- Cache-Control

- Connection

- Cookie

- Host

- Max-Forwards

- Pragma

- Proxy-Connection

- Proxy-Authorization

- TE

- Trailer

- Transfer-Encoding

- Upgrade

- Max-Forwards

- Proxy-Authenticate

- Proxy-Connection

- Set-Cookie

- Trailer

- Transfer-Encoding

- Upgrade

ヘッダーをリストに追加するには、「作成」をクリックし、入力用のフィールドにヘッダー名を入力します。Content-Lengthヘッダーは、常に暗黙的に削除されます。プロキシ操作中にコンテンツを操作すると、ほとんどのケースでコンテンツ長が無効になるためです。

リソースを定義したら、ページレットと他のオブジェクトをそのリソース内に作成できます。

- 第25.5項「ページレットの作成」

- 第25.6項「Webインジェクタの作成」

- 第25.7項「カスタム・パーサーの作成」

- 第25.8項「ホストされたファイルの作成」

25.4.2 WSRP/JPDKリソース用の構成ページ(WSRPおよびOracle JPDKポートレット・プロデューサ)

次の構成ページは、WSRPまたはOracle JPDKポートレット・プロデューサに基づいたWSRP/JPDKリソースで使用されます。

注意:

WSRPまたはOracle JPDKポートレット・プロデューサに基づいたリソースを作成する前に、第25.9項「WSRPおよびOracle JPDKポートレット・プロデューサの登録」の説明に従って、プロデューサを登録する必要があります。

- 第25.4.2.1項「全般」

- 第25.4.2.2項「ポリシー」

25.4.2.1 全般

「全般」ページで、リソースの基本情報を入力します。

- 「ポートレット・プロデューサ」ドロップダウン・リストから、ポートレット・プロデューサ・タイプを選択します。このリストには、第25.9項「WSRPおよびOracle JPDKポートレット・プロデューサの登録」の手順を実行して登録されたプロデューサが表示されます。

- リソースの名前を入力します。

- リソースの説明を入力します(オプション)。

25.4.2.2 ポリシー

「ポリシー」ページにより、Oracle WebCenter Portal内で特定ロールへのリソースのアクセスを制限できます。

ページレット・プロデューサ(Oracle WebLogic Serverなど)をホストするJ2EEコンテナは、現在のユーザーに関連付けられたロール・メンバーシップを確立する処理を行います。リソースにより複数のロールを「ポリシー」ページで指定でき、ユーザーがいずれかの指定ロールのメンバーの場合、アクセスが許可されます。それ以外の場合、適切なJ2EEコンテナで委任された認証ページに転送され、必要な資格証明を確立します。ロールがリストに入力されていない場合、匿名アクセスが許可され、リソースは匿名リソースと呼ばれます。

注意:

このページで入力したロール名は、J2EEコンテナで作成したものと一致する必要があります(Oracle WebLogic Serverなど)。

リソースを定義したら、ページレットとWebインジェクタをそのリソース内に作成できます。

- 第25.5項「ページレットの作成」

- 第25.6項「Webインジェクタの作成」

25.4.3 OpenSocialリソース用の構成ページ(OpenSocialガジェット・プロデューサ)

次の構成ページは、OpenSocialガジェット・プロデューサに基づいたOpenSocialリソースで使用されます。

- 第25.4.3.1項「全般」

- 第25.4.3.2項「ポリシー」

注意:

OpenSocialリソースを作成する前に、ページレット・プロデューサをOpenSocialと連携するように構成します。詳細は、第25.3.6項「OpenSocial設定」を参照してください。

25.4.3.1 全般

「全般」ページで、リソースの基本情報を入力します。

- リソースの名前を入力します。

- リソースの説明を入力します(オプション)。

- 「ソースURL」フィールドには、内部のOpenSocialコンテナの相対URL (/os/)が事前に移入されます。外部のOpenSocialコンテナの登録はサポートされていません。

- 「宛先URL」フィールドに、リソースのアクセスに使用する相対パスを入力します。このパスは、ページレット・プロデューサをホストするサーバー上のOpenSocialコンテナへのURLを作成するために使用されます。

25.4.3.2 ポリシー

「ポリシー」ページにより、Oracle WebCenter Portal内で特定ロールへのリソースのアクセスを制限できます。

ページレット・プロデューサ(Oracle WebLogic Serverなど)をホストするJ2EEコンテナは、現在のユーザーに関連付けられたロール・メンバーシップを確立する処理を行います。リソースにより複数のロールを「ポリシー」ページで指定でき、ユーザーがいずれかの指定ロールのメンバーの場合、アクセスが許可されます。それ以外の場合、適切なJ2EEコンテナで委任された認証ページに転送され、必要な資格証明を確立します。ロールがリストに入力されていない場合、匿名アクセスが許可され、リソースは匿名リソースと呼ばれます。

注意:

このページで入力したロール名は、J2EEコンテナで作成したものと一致する必要があります(Oracle WebLogic Serverなど)。

リソースを定義したら、ページレットとファイルをそのリソース内に作成できます。

- 第25.5項「ページレットの作成」

- 第25.8項「ホストされたファイルの作成」

25.5 ページレットの作成

ページレット・コレクションには、リソースに関連付けられたページレットがリストされます。新規ページレットを作成するには、ページレット・プロデューサ・コンソールで、使用するリソースの下にある「ページレット」セクションを選択し、ツールバーの「作成」アイコンをクリックします。リストに「<新規>」というページレットが追加されます。既存のページレットを変更するには、そのページレットの名前をクリックします。各ページレットには、次の構成ページがあります。

- 第25.5.1項「全般」

- 第25.5.2項「プリファレンス」

- 第25.5.3項「パラメータ」

- 第25.5.4項「クリップ」

- 第25.5.5項「ドキュメント」

25.5.1 全般

ページレットの名前を入力し、そのページに関連付けるライブラリの名前を入力します。(ページレット・ライブラリは、関連のあるページレットをグループ化するユーザー定義手段です。)ページレットの説明を入力します(オプション)。

「インラインのリフレッシュ」オプションは、IFrameを使用せずにページレットをページ本体に挿入する場合にのみ使用してください。ページレットのクリックスルーでページの部分リフレッシュを実装するためのデフォルト推奨手段はIFrame挿入です。このオプションは、非常に希な状況でのみ有効にしてください。

- WebページレットとCSPページレットの場合、ページレットの相対パスを「URL接尾辞」フィールドに入力します(そのリソースについて入力したソースURL接頭辞は含めないでください)。「URL接尾辞」を空白にすると、リソース全体がページレットと見なされます。

- WSRPまたはOracle JPDKポートレットに基づいたページレットの場合、ページレットのベースにするポートレットを「ポートレット」ドロップダウン・リストから選択します。このリストには、親リソースに関連付けられたWSRPまたはOracle JPDKポートレット・プロデューサ上のポートレットが表示されます。ポートレットにパブリック・パラメータが関連付けられている場合、自動的にページレット・パラメータとしてインポートされます。WSRPおよびOracle JPDKポートレットの操作の詳細は、第25.9項「WSRPおよびOracle JPDKポートレット・プロデューサの登録」と第25.4.2項「WSRP/JPDKリソース用の構成ページ(WSRPおよびOracle JPDKポートレット・プロデューサ)」を参照してください。

- OpenSocialガジェットに基づいたページレットの場合、ガジェットのXMLスキーマの場所を「ガジェットURL」フィールドに入力します。「ガジェット・メタデータのインポート」ボタンをクリックして、XMLスキーマから次の情報をインポートします。

- ガジェット名: この値は、「全般」ページの「説明」フィールドにインポートされます。

- ガジェットのユーザー・プリファレンス: 「パラメータ」ページのページレット・パラメータに、ガジェットのユーザー・プリファレンスが移入されます。

- プリファレンス・エディタ: 編集可能なユーザー・プリファレンスがある場合、「プリファレンス」ページの「パーソナライズ・エディタ」フィールドに移入され、「パラメータ」ページのプリファレンスを使用してプリファレンス・ページが作成されます。

25.5.2 プリファレンス

「プリファレンス」ページでは、ページレットに必要なプリファレンス・ページ(「グローバル」、「カスタマイズ」または「パーソナライズ」)の相対URLを入力します。リソースについて入力したソースURL接頭辞は含めないでください。(前述のように、ユーザー・プリファレンスを持つOpenSocialガジェットの場合、デフォルトのエントリが作成されますが、このエントリは変更しないでください。)

「プリファレンス」ページは、WSRPまたはOracle JPDKに基づいたページレットでは使用されません。

図25-12 ページレット・プロデューサ・コンソール: 「ページレット」 - 「プリファレンス」ページ

「図25-12 ページレット・プロデューサ・コンソール: 「ページレット」 - 「プリファレンス」ページ」の説明

25.5.3 パラメータ

ページレット・パラメータまたはページレット・ペイロードを使用して、データをページレットに渡すことができます。パラメータでは名前と値のペアをページレット・アプリケーションに渡し、ペイロードは任意のテキストです(XMLを含む)。特定のページレットに必要なXMLを記述するXMLスキーマを作成し、URIとXSDファイルまたはネームスペース:名前修飾子をこのページに入力してそれをドキュメント化できます。この値は利便性専用であり、実行時に使用も強制もされません。

「パラメータ」ページで、ページレットに渡すペイロード・スキーマまたはパラメータを入力します。

パラメータを追加するには、「作成」をクリックします。

- パラメータの名前を入力します。

- トランスポートのタイプとして、リクエスト・パラメータ、管理のプリファレンス、コミュニティのプリファレンスまたはページレットのプリファレンスを選択します。

注意:

ほとんどの場合、トランスポート・タイプとしてリクエスト・パラメータを使用してください。リクエスト・パラメータは、URLに関する問合せ文字列引数としてページレットのホスト・サーバーに送信されます。プリファレンス・トランスポート・タイプは、CSPページレットに対してのみ使用してください。

- ページレットにパラメータが必要な場合、「必須」チェック・ボックスを選択します。

- 「タイプ」で、適切なデータ・タイプ(文字列または数値)を選択します。

図25-13 ページレット・プロデューサ・コンソール: 「ページレット」 - 「パラメータ」ページ

「図25-13 ページレット・プロデューサ・コンソール: 「ページレット」 - 「パラメータ」ページ」の説明

25.5.4 クリップ

プロキシされたアプリケーションで大きめのWebページの一部をクリッピングして、ページレットを作成できます。たとえば、ニュースのWebページに最新の見出しがリストされたボックスがあるとします。そのボックスを含んでいるHTMLを特定すれば、見出しのみをクリップして、そのニュースWebページのサブセットをページレットとして使用できます。

クリッパを作成するには、ページレットの下にある「クリップ」セクションを選択し、ツールバーの「作成」アイコンをクリックします。次の2つの構成ページを持つ新しいクリッパが作成されます。

- 「全般」ページで、クリッパの名前を入力します。

- 「コンテンツ」ページで、クリッパのコンテンツを定義します。
Webページ本体の一部をクリップする以外に、「headを含める」を選択してページレットの<head>要素を含めることもできます。これにより、<head>要素で出現するCSS、JavaScriptまたは他の宣言を、クリップした部分に含めることができます。

- グラフィカル・ツールを使用してページのコンテンツを選択するには、「クリッパの起動」をクリックします。

- クリップするセクションを示すHTMLタグ属性を指定するには、「クリッパの詳細設定」セクションを開いて、タグ名とそれに関連付けられた属性を入力します。

図25-14 ページレット・プロデューサ・コンソール: 「クリップ」 - 「コンテンツ」ページ

「図25-14 ページレット・プロデューサ・コンソール: 「クリップ」 - 「コンテンツ」ページ」の説明

クリッパを使用するときには次の点に留意してください。

- バックエンド・リソースへのアクセスにHTTPSを使用する場合、ページレット・プロデューサ・コンソールへのアクセスにもセキュアなポートを使用してください。

- クリップのソースがログイン・フォームや他の形の認証によって保護されている場合、第25.4.1.4項「自動ログイン」の説明に従って親リソースの自動ログインを構成してください。ボールトを使用して資格証明の値を保存している場合、クリッパを使用する前に資格証明を取得してください。

- クリッパに問題が生じた場合、構成したページレットURLをリダイレクトなしでブラウザでロードできることを確認してください。必要であれば、ブラウザがすべてのリダイレクトの後でロードした最後のURLを反映するように、ページレット接尾辞を変更します。

- ホストされたファイルを使用して上書きされるイメージとコードはクリップできません。(ホストされたファイルの詳細は、第25.8項「ホストされたファイルの作成」を参照してください。)

25.5.5 ドキュメント

「ドキュメント」ページには、ページレットとプリファレンス・エディタにアクセスするためのサンプル・コードがJavaScriptまたはREST APIを使用して表示されます。

図25-15 ページレット・プロデューサ・コンソール: 「ページレット」 - 「ドキュメント」ページ

「図25-15 ページレット・プロデューサ・コンソール: 「ページレット」 - 「ドキュメント」ページ」の説明

25.6 Webインジェクタの作成

Webインジェクタは、プロキシされたリソース・ページの指定場所にコンテンツを挿入します。コンテンツは、HTML、CSS、JavaScript、ページレット宣言を含む任意のテキストにできます。空のインジェクタを使用して、不要なコンテンツをページから削除することもできます。OpenSocialリソース用のインジェクタは作成できません。

Webインジェクタを作成するには、使用するリソースの下にある「インジェクタ」セクションを選択し、ツールバーの「作成」アイコンをクリックします。リストに「<新規>」という新しいインジェクタが追加されます。インジェクタには次の構成ページがあります。

- 第25.6.1項「全般」

- 第25.6.2項「コンテンツ」

25.6.1 全般

Webインジェクタの名前を入力します。

「URLフィルタ」ボックスにURLパターンを入力すれば、インジェクタをリソースのサブセットに適用できます。リソース内の「URLフィルタ」ボックスで指定されたテキストで始まるURLにのみ、インジェクタが適用されます。このボックスが空の場合や「/」のみが含まれている場合、リソース全体にインジェクタが適用されます。

インジェクタの対象を特定の種類のコンテンツにのみ制限するには、「MIMEフィルタ」ボックスにMIMEタイプのカンマ区切りリストを入力します。たとえば、text/htmlを指定するとインジェクタがHTMLコンテンツに制限され、text/cssを指定するとインジェクタがCSSコンテンツのみに制限されます。

リソースの出力の挿入場所を定義します。

- 「先頭」を選択すると、ページの先頭にコンテンツが挿入されます。ページレット宣言を挿入する場合、このオプションを使用しないでください。

- 「最後」を選択すると、ページの最後にコンテンツが挿入されます。

- 「次より前」、「次より後」、「置換」の各オプションでは、入力用のフィールドに指定された一意の文字列に相対的なページにコンテンツが挿入されます。「大文字/小文字を区別しない」を選択すれば、文字列の大文字と小文字が区別されなくなります。
「囲みタグ」オプションを使用すると、一意の文字列を見つけてそのテキストと囲みタグの両方を、次のページで指定したコンテンツと置換できます。

図25-16 ページレット・プロデューサ・コンソール: 「インジェクタ」 - 「全般」ページ

「図25-16 ページレット・プロデューサ・コンソール: 「インジェクタ」 - 「全般」ページ」の説明

25.6.2 コンテンツ

挿入できるコンテンツは、HTML、CSS、JavaScript、ページレット宣言などを含む任意のテキストです。コンテンツは、テキスト・エディタまたはHTMLエディタを使用して入力できます。

図25-17 ページレット・プロデューサ・コンソール: 「インジェクタ」 - 「コンテンツ」ページ

「図25-17 ページレット・プロデューサ・コンソール: 「インジェクタ」 - 「コンテンツ」ページ」の説明

25.7 カスタム・パーサーの作成

カスタム・パーサーを使用すると、コンテンツを解析してURLを見つけるための組込みロジックを補足または変更できます。組込みパーサーがURLを識別できない場合や、URLとしてリライトしてはいけないセクションを識別する場合、カスタム・パーサーを使用してデフォルトの動作を変更できます。WSRPまたはOracle JPDKポートレット・プロデューサやOpenSocialガジェット・プロデューサのパーサーは作成できません。

カスタム・パーサーを作成するには、使用するリソースの下にある「パーサー」セクションを選択し、ツールバーの「作成」アイコンをクリックします。

- パーサーの名前を入力します。

- 「URLフィルタ」ボックスにURLパターンを入力すれば、パーサーをリソースのサブセットに適用できます。リソース内の「URLフィルタ」ボックスで指定されたテキストで始まるURLにのみ、パーサーが適用されます。このボックスが空の場合や「/」のみが含まれている場合には、リソース全体にパーサーが適用されます。

- 新しい解析ルールを追加するには、「作成」をクリックして「フラグメントの場所」セクションに新しい行を追加します。

- 「正規表現」列に、変換対象のURLフラグメントを識別するための正規表現を入力します。カッコで囲まれた最初のグループ表現はフラグメントを識別し、表現の残りの部分ではフラグメントを検索するためのコンテキストを表します。

- 選択された場所をどのように解析するかを定義するには、「フラグメント・タイプ」を選択します。

- 静的URLはサーバー上で変換されます。

- 動的URLはJavaScriptを使用してクライアント上で変換されます。

- HTMLフラグメント・タイプとJavaScriptフラグメント・タイプは、XMLなどの他のコンテンツ・タイプに埋め込まれたコンテンツに使用されます。

- 「リライトなし」は、URL検索の対象にしない場所を指定します。このオプションは、誤ってURLと識別されたマークアップのリライトを防ぐために使用します。

- ナビゲータ・ツールバーの「保存」アイコンをクリックします。

図25-18 ページレット・プロデューサ・コンソール: 「パーサー」 - 「全般」ページ

「図25-18 ページレット・プロデューサ・コンソール: 「パーサー」 - 「全般」ページ」の説明

25.8 ホストされたファイルの作成

ページレット・プロデューサは、あらゆる種類のコンテンツ(HTML、JavaScript、CSSなど)をホストでき、仮想URLの場所にファイルを提示できます。ホストされたファイルは、次のように様々な目的に使用できます。

- ファイルをアップロードして元のファイルと同じURLを使用するように構成することで、プロキシされたアプリケーションのコンテンツと機能を上書きします。

- ホストされたファイルをインジェクタで使用して、プロキシされたアプリケーションにイメージやコンテンツを挿入します。

- ページレット・プロデューサ・サーバーでページレット・ファイルをホストします。

ファイルをアップロードするには、使用するリソースの下にある「ファイル」セクションを選択し、ツールバーの「作成」アイコンをクリックします。

- 「全般」ページで、ファイルの相対パスを「名前」フィールドに入力します。先頭にスラッシュ(/)を付けないでください。ファイルのパスに一致するように、ナビゲータのファイル・コレクションのディレクトリ構造が更新されます。
ファイルの「MIMEタイプ」を入力します。

図25-19 ページレット・プロデューサ・コンソール: 「ファイル」 - 「全般」ページ

「図25-19 ページレット・プロデューサ・コンソール: 「ファイル」 - 「全般」ページ」の説明

- 「コンテンツ」ページで、ファイルのパスを入力するか、「参照」ボタンをクリックしてファイルまで移動します。
「アップロード」ボタンをクリックして、ファイルをページレット・プロデューサ・サーバーにアップロードします。テキストまたはHTMLを「MIMEタイプ」として入力した場合、「コンテンツ」ページでエディタを使用して、ファイルのコンテンツを入力または編集できます。(エディタはテキスト・ファイルとHTMLファイルでのみ使用できます。)イメージ・タイプを「MIMEタイプ」として入力した場合、アップロードされたイメージは「コンテンツ」ページに表示されます。

注意:

ページレット・プロデューサにアップロードしたテキスト・ファイル(text/plain)は、UTF-8として保存する必要があります。

- ナビゲータ・ツールバーの「保存」アイコンをクリックします。

アップロードしたファイルは、http://<host_name>:<port_number>/pagelets/<resourcename>/<filepath>というURLで、インジェクタやページレットで使用できます。

たとえば、ファイル名をimages/myimage.jpgと入力してwelcome_resourceリソースの下にアップロードした場合、ページレット・プロデューサ・サーバーでのホスト・ファイルのパスは、http://<host_name>:<port_number>/pagelets/welcome_resource/images/myimage.jpgになります。

ホストされたファイルを使用するときには次の点に留意してください。

- ファイルをホストする機能は、巨大なファイルには使用しないでください。

- OpenSocialガジェットのXMLファイルをホストする場合、ファイルを匿名リソース(セキュリティ・ポリシーなし)の下に配置する必要があります。そうしないと、ガジェットの機能が正しく働きません。

- WSRPまたはOracle JPDKポートレット・プロデューサについては、ホストされたファイルは作成できません。

25.9 WSRPおよびOracle JPDKポートレット・プロデューサの登録

ページレット・プロデューサでは、WSRPおよびOracle JPDKポートレットを、Frameworkアプリケーション、Spacesおよびサード・パーティのポータルで使用できるようにページレットとして公開できます。登録後、ポートレット・プロデューサに関連付けられたポートレットを表示するページレットが、ページレット・プロデューサの関連付けられたリソースに自動的に移入されます。

この項では、WSRPおよびOracle JPDKポートレット・プロデューサを登録して関連ポートレットをインポートするための詳しい手順を説明します。

- 第25.9.1項「WSRPポートレット・プロデューサの登録」

- 第25.9.2項「Oracle JPDKポートレット・プロデューサの登録」

- 第25.9.3項「WSRPおよびOracle JPDKポートレットの使用」

注意:

デフォルトで、プロデューサ登録へのアクセスは、Oracle WebLogic Server管理者のみに制限されます。

あるユーザーがこのアクセス権を必要とし、そのユーザーを管理者グループに追加できない場合、次に示すようにWLSTコマンドgrantAppRoleを使用します。

grantAppRole(appStripe="pagelet-producer",
> appRoleName="AppConnectionManager",
> principalClass="weblogic.security.principal.WLSUserImpl",
> principalName="monty")

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

25.9.1 WSRPポートレット・プロデューサの登録

Enterprise Manager、WLSTまたはページレット・プロデューサ・コンソールを使用して、WSRPエンドポイントをポートレット・プロデューサとして登録できます。登録すると、新しいページレット・プロデューサ・リソースが作成され、WSRPエンドポイントに関連付けられたポートレットを表示するページレットが自動的にそのリソースに移入されます。

1. Enterprise Managerまたはページレット・プロデューサ・コンソールを使用して、WSRPエンドポイントを登録します。

- Enterprise Managerで、ポートレット・プロデューサのアプリケーションに移動します。「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「プロデューサの登録」を選択します。

- ページレット・プロデューサ・コンソールで、ナビゲータ・ツールバーのドロップダウン・メニューから「プロデューサ」を選択します。「ポートレット・プロデューサ」ページで、「登録」をクリックします。

2. プロデューサの名前を入力します。「プロデューサ・タイプ」として、「WSRPプロデューサ」を選択します。

3. WSRPエンドポイントとして、「WSDL URL」を入力します(例: http://www.oasis-open.org/committees/wsrp/specifications/version1/wsrp_v1_interfaces.wsdl)。

図25-20 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - 「WSRPプロデューサ」

「図25-20 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - 「WSRPプロデューサ」」の説明

4. プロデューサとの通信時にHTTPプロキシが必要な場合、「プロキシを使用しますか。」オプションを選択し、プロキシ・サーバーのホスト名とポート番号を入力します。(ページレット・プロデューサとポートレット・プロデューサがファイアウォールで隔てられている場合、プロキシが必要です。)

5. プロデューサとの通信用に、適切な「デフォルトの実行タイムアウト」を入力します。デフォルトは30秒です。個々のポートレットに固有のタイムアウト時間を定義できますが、その場合ここで定義した値よりも優先されます。

6. 認証が必要なプロデューサの場合、「セキュリティ」セクションのドロップダウン・リストから適切な「トークン・プロファイル」を選択して必要な構成情報を入力します。選択したトークン・プロファイルでキーストアが使用される場合、このページで入力するキーストアへのパスは絶対パスである必要があります。

図25-21 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - 「WSRPプロデューサ」: 「トークン・プロファイル」

「図25-21 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - 「WSRPプロデューサ」: 「トークン・プロファイル」」の説明

7. ナビゲータ・ツールバーの「保存」アイコンをクリックします。

8. 構成が正しいことを確認するには、「テスト」ボタンをクリックします。

図25-22 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - テストの成功を知らせるポップアップ

「図25-22 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - テストの成功を知らせるポップアップ」の説明

テストが成功した場合、「OK」をクリックしてポップアップを閉じます。テストが成功しなかった場合、「OK」をクリックしてポップアップを閉じ、必要に応じて構成を変更します。

9. テストの実行が成功した後で、「OK」をクリックして構成設定を保存し、「ポートレット・プロデューサ」リストに戻ります。

10. プロデューサをEnterprise Managerで登録すると、外部登録をページレット・プロデューサでロードする必要があります。ページレット・プロデューサのサーバーを再起動するか、次の手順を実行します。

1. ページレット・プロデューサ・コンソールを開き、ナビゲータ・ツールバーのドロップダウン・リストから「プロデューサ」を選択します。

2. 「ポートレット・プロデューサ」ページで、新しいWSRPプロデューサを選択して「リフレッシュ」をクリックします。

登録が完了すると、WSRPプロデューサがページレット・プロデューサ・コンソールにリソースとして表示され、WSRPエンドポイントに関連付けられたポートレットがリソースのページレット・コレクションにリストされます。

新しいページレットの設定とパラメータは、WSRPプロデューサのWSDLのポートレット定義に基づいています。WSRPポートレットの追加や変更を行った場合、変更をインポートするために、前述の手順10に従ってプロデューサの登録をリフレッシュします。WSRPベースのページレットは、他のページレットと同様に使用できます。

注意:

自動生成されたリソースとページレットは変更できません。WSRPベースのページレットに変更を加えるには、次の第25.9.3項「WSRPおよびOracle JPDKポートレットの使用」の手順に従ってください。

25.9.2 Oracle JPDKポートレット・プロデューサの登録

Oracle WebCenter Portalのページレット・プロデューサでは、Oracle JPDKポートレットを、Frameworkアプリケーション、Spacesおよびサード・パーティのポータルで使用できるようにページレットとして公開できます。

Enterprise Manager、WLSTまたはページレット・プロデューサ・コンソールを使用して、Oracle JPDKエンドポイントをポートレット・プロデューサとして登録できます。登録すると、新しいページレット・プロデューサ・リソースが作成され、Oracle JPDKプロデューサに関連付けられたポートレットを表示するページレットが自動的にそのリソースに移入されます。

1. Enterprise Managerまたはページレット・プロデューサ・コンソールを使用して、Oracle JPDKエンドポイントを登録します。

- Enterprise Managerで、ポートレット・プロデューサのアプリケーションに移動します。「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「プロデューサの登録」を選択します。

- ページレット・プロデューサ・コンソールで、ナビゲータ・ツールバーのドロップダウン・メニューから「プロデューサ」を選択します。「ポートレット・プロデューサ」ページで、「登録」をクリックします。

2. 名前を入力します。「プロデューサ・タイプ」として、「Oracle PDK-Javaプロデューサ」を選択します。

3. 次の構文を使用して、Oracle JPDKプロデューサの「URLエンドポイント」を入力します。
http://host_name:port_number/context_root/providers
host_nameはプロデューサがデプロイされているサーバー、port_numberはHTTPリスナーのポート番号、context_rootはアプリケーションのコンテキスト・ルートです(providersは静的テキストです)。例: http://myHost.com:7778/myEnterprisePortlets/providers

図25-23 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」ページ - 「Oracle PDK-Javaプロデューサ」

「図25-23 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」ページ - 「Oracle PDK-Javaプロデューサ」」の説明

4. プロデューサとの通信時にHTTPプロキシが必要な場合、「プロキシを使用しますか。」オプションを選択し、プロキシ・サーバーのホスト名とポート番号を入力します。(ページレット・プロデューサとポートレット・プロデューサがファイアウォールで隔てられている場合、プロキシが必要です。)

5. Oracle JPDKプロデューサ上のいずれかのポートレットに認証が必要な場合、「関連付けられている外部アプリケーション」ドロップダウン・リストから適切な外部アプリケーションを選択します。

6. Oracle JPDKプロデューサからポートレットを実行するときにユーザー・セッションを有効にする場合、「セッションを確立しますか。」オプションを選択します。セッションがプロデューサ・サーバーに保持され、ポートレットのコードが情報をセッションに保持できます。メッセージ認証ではセッションが使用されるため、「詳細構成」セクションで共有鍵を指定した場合、このオプションも選択する必要があります。プロデューサとサーバーの間でセッションレス通信を行う場合は、このオプションを選択しないでください。

7. プロデューサとの通信用に、適切な「デフォルトの実行タイムアウト」(プロデューサでポートレットの登録、登録解除または表示の最大所要時間)を入力します。デフォルトは30秒です。個々のポートレットに固有のタイムアウト時間を定義できますが、その場合ここで定義した値よりも優先されます。

8. 「サブスクライバID」フィールドに、登録するプロデューサのコンシューマを識別する文字列を入力します。プロデューサがアプリケーションに登録されると、プロデューサのコールが送信されます。コールの際、「サブスクライバID」の値がコンシューマからプロデューサに渡されます。「サブスクライバID」がプロデューサの予測した値でない場合、プロデューサは登録コールを拒否することがあります。

9. プロデューサが暗号化を処理するように設定されている場合、「共有鍵」(HMACキーとも呼ばれます)を入力します。共有鍵は、メッセージ認証用のメッセージ署名を生成するための暗号化アルゴリズムで使用されます。共有鍵を使用してプロデューサが設定されている場合、ここに間違った値を入力すると、プロデューサの登録が失敗するので注意してください。共有鍵には、英数字10〜20文字を含めることができます。

10. ナビゲータ・ツールバーの「保存」アイコンをクリックします。

11. 構成が正しいことを確認するには、「テスト」ボタンをクリックします。

図25-24 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - テストの成功を知らせるポップアップ

「図25-24 ページレット・プロデューサ・コンソール: 「ポートレット・プロデューサの登録」 - テストの成功を知らせるポップアップ」の説明

テストが成功した場合、「OK」をクリックしてポップアップを閉じます。テストが失敗した場合、必要に応じて構成を変更し、テストを再び実行します。

12. テストの実行が成功した後で、「OK」をクリックして構成設定を保存し、「ポートレット・プロデューサ」リストに戻ります。

13. プロデューサをEnterprise Managerで登録すると、外部登録をページレット・プロデューサでロードする必要があります。ページレット・プロデューサのサーバーを再起動するか、次の手順を実行します。

1. ページレット・プロデューサ・コンソールを開き、ナビゲータ・ツールバーのドロップダウン・リストから「プロデューサ」を選択します。

2. 「ポートレット・プロデューサ」ページで、新しいOracle JPDKプロデューサを選択して「リフレッシュ」をクリックします。

登録が完了すると、Oracle JPDKプロデューサがページレット・プロデューサ・コンソールにリソースとして表示され、プロデューサに関連付けられたポートレットがリソースのページレット・コレクションにリストされます。

新しいページレットの設定とパラメータは、プロデューサURLのポートレット定義に基づいています。ポートレットの追加や変更を行った場合、前述の手順13に従ってプロデューサの登録をリフレッシュします。

注意:

自動生成されたリソースとページレットは変更できません。Oracle JPDKベースのページレットに変更を加えるには、次の第25.9.3項「WSRPおよびOracle JPDKポートレットの使用」を参照してください。

25.9.3 WSRPおよびOracle JPDKポートレットの使用

自動生成されたWSRPおよびOracle JPDKリソースとページレットは変更できません。主に初期テストを目的とするこれらは仮想エントリであり、ページレット・プロデューサのメタデータ定義には存在しません。

プロデューサに変更を加えて永続的な参照を作成するには、自動生成されたリソースをクローニングする必要があります。変更可能なバージョンを作成するには、ページレット・プロデューサ・コンソールのナビゲータでリソースを選択し、「クローン」をクリックします。クローニングされたバージョンのリソースは編集可能であり、インジェクタなどの様々な要素を追加してページレットの機能をカスタマイズできます。クローニングされたリソースは安定的であり、メタデータのエクスポートに含められます。

既存のポートレット・プロデューサに基づいて新規リソースを作成してから個々のページレットを作成する方法で、ポートレット・ベースのページレットを白紙の状態から定義することもできます。詳細は、第25.4項「リソースの作成」を参照してください。

25.10 トラブルシューティング

リソースやページレットをトラブルシューティングするとき、次の一般的な構成エラーに留意してください。ページレット・プロデューサ設定の構成の詳細は、第25.3項「ページレット・プロデューサの設定の構成」を参照してください。

- SSLを使用している場合、ページレット・プロデューサ設定の「変換」ページでHTTP (セキュアでない)ポートとHTTPS (セキュアな)ポートが両方とも適切に構成されていることを確認してください。

- ネットワークでHTTPプロキシを必要とする外部サイトをプロキシする場合、ページレット・プロデューサ設定の「プロキシ」ページでプロキシURLを構成する必要があります。

- デフォルトで作成されるlogin_resourceリソースとpagelet_apiリソースが存在し、正しく構成されていることを確認してください。

- KDブラウザや他のCSPページレットをプロキシする場合、ページレット・プロデューサ設定の「CSP」ページで、イメージ・サービスのURLが絶対URLであることと、CSP SOAP APIのURLが正しく設定されていることを確認してください。

- ページレットは、SunのJava Virtual Machine (JVM)の制限により、基礎となる証明書でMD2署名アルゴリズムが使用されているHTTPSコンテンツは使用できません。

トラブルシューティングの詳細情報は、ログを使用してください。ページレット・プロデューサでは、メッセージが標準のOracle Diagnostic Logging機能のログに記録されます。Oracle WebLogic Serverでは、その場所はuser-projects/domains/<domain>/servers/ <server>/logs/<server>-diagnostic.logです。ロギングの構成方法の詳細は、第25.3.1項「ロギング設定」を参照してください。ページレットのデバッグの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle WebCenter Portalのページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

26 外部アプリケーションの管理

外部アプリケーションとは、自身の認証プロセスを実装するアプリケーションです。つまり、WebCenter Portalアプリケーションのシングル・サインオン・プロセスに参加しないアプリケーションのことです。

システム管理者は、Fusion Middleware ControlまたはWLSTコマンドライン・ツールを使用して、WebCenter Portalアプリケーション・デプロイメント用の外部アプリケーションを登録および管理できます。また、アプリケーション管理者は、初期設定の管理ページまたは外部アプリケーション・タスク・フローを使用して、外部プリケーションを実行時に登録および管理できます。

デプロイ後にWebCenter Portalアプリケーションに対して行った外部アプリケーションの変更はすべて、MDSリポジトリにカスタマイズとして格納されます。

注意:

外部アプリケーションの構成は動的です。WebCenter Portalアプリケーションの構成変更は即時反映されます。アプリケーションおよび管理対象サーバーを再起動する必要はありません。

この章の内容は次のとおりです。

- 第26.1項「外部アプリケーションに関する必要な知識」

- 第26.2項「外部アプリケーションの登録」

- 第26.3項「外部アプリケーション接続の詳細の変更」

- 第26.4項「外部アプリケーション接続のテスト」

- 第26.5項「外部アプリケーション接続の削除」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

26.1 外部アプリケーションに関する必要な知識

WebCenter Portalアプリケーション(FrameworkアプリケーションまたはSpacesアプリケーション)と、独自認証を使用するアプリケーションを連携するには、資格証明プロビジョニングができるようにそのアプリケーションを外部アプリケーション定義と関連付けます。そのためには、外部アプリケーション定義を使用して、それらの個別に認証されたアプリケーションからコンテンツにアクセスする手段を指定します。

外部アプリケーション・サービスは、エンド・ユーザー側からのシングル・サインオン操作を再現するために、ユーザー名とパスワードおよび外部アプリケーション用のその他の資格証明をすべて取得し、これらの情報を資格証明が必要なWebCenter Portalサービスやアプリケーションに渡します。WebCenter Portalサービスや他のアプリケーションは、エンド・ユーザーのかわりにこの情報を使用してログインします。このユーザー名とパスワードの組合せは、アプリケーションがデプロイされているWebLogicドメイン用に構成された資格証明ストアにセキュアに格納されます。

ユーザーがログイン資格証明を尋ねられ、入力すると、それらの資格証明はWebCenter Portalアプリケーション・ユーザーにマップされ、そのドメイン用に構成された資格証明ストアに格納されます。資格証明ストアは、その情報を認証時に外部アプリケーションに渡します。外部アプリケーションの資格証明が変更されないかぎり、以降のリクエストではマップされた情報が資格証明ストアから読み取られるので、ユーザーが資格証明を指定するのは1回のみです。

注意:

外部アプリケーションへのログイン時に、「ログイン情報を保存する」チェック・ボックスを選択しない場合、高可用性(HA)環境でフェイルオーバーが発生すると、そのユーザー・セッションのプロビジョニング済の資格証明は失われます。同一ユーザー・セッション内で外部アプリケーション・コンテンツにアクセスしようとすると、資格証明を再度指定するように要求されます。

Frameworkアプリケーションで使用する外部アプリケーションを指定するには、デプロイ前であればOracle JDeveloperのウィザード、デプロイ後であればFusion Middleware Control Console (図26-1)かWLSTコマンドを使用します。設計時にJDeveloperで指定した外部アプリケーションは、デプロイ後、自動的に表示されます。ただし、デプロイ後にFusion Middleware ControlまたはWLSTコマンドを使用して、設計時の共有資格証明およびパブリック資格証明を再プロビジョニングする必要があります。詳細は、第29章「アイデンティティ・ストアの構成」および第30章「ポリシーおよび資格証明ストアの構成」を参照してください。

注意:

Spacesでは、デフォルトで使用可能な外部アプリケーション・タスク・フローを使用して、外部アプリケーションを登録できます。またはタスク・フローを追加して、アプリケーションを登録および管理できます。Spacesで外部アプリケーション・タスク・フローを使用して外部アプリケーションを登録する方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペース管理を使用した外部アプリケーションの登録に関する項および外部アプリケーション・タスク・フローの操作に関する項を参照してください。

図26-1 外部アプリケーションの編集

「図26-1 外部アプリケーションの編集」の説明

26.2 外部アプリケーションの登録

WebCenter Portalアプリケーションの外部アプリケーションは、Fusion Middleware ControlまたはWLSTコマンドを使用して登録できます。

外部アプリケーションを登録する前に、アプリケーションのログイン・ページにアクセスし、アプリケーションのログイン・フォームのHTMLソースを調べます。必要な登録詳細はすべて、<form tag>の中にあります。

たとえば、Yahoo! Mailのログイン・フォームの基礎となるコードは次のようになっています。

<form method=post action="https://login.yahoo.com/config/login?" autocomplete="off" name="login_form">
...
<td><input name="login" size="17"</td>
...
<td><input name="passwd" size="17"</td>
...

この例の場合、WebCenter PortalユーザーにYahoo! Mailアプリケーションへの直接リンクを提供するには、次のサンプルの登録情報が必要です。

登録情報

サンプル値

HTMLソース

ログインURL

https://login.yahoo.com/config/login?

action

「ユーザー名」/「ユーザーID」フィールド

login

name="login"

パスワード・フィールド名:

passwd

name="passwd"

認証方式

post

method

注意:

外部アプリケーションの構成は動的です。新規の外部アプリケーションおよび既存アプリケーションの更新は即時使用可能になります。WebCenter Portalアプリケーションを再起動する必要はありません。

外部アプリケーションを使用するサービスの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のセキュアなサービス接続に関する項を参照してください。

この項では、次の手順を説明します。

- 第26.2.1項「Fusion Middleware Controlを使用した外部アプリケーションの登録」

- 第26.2.2項「WLSTを使用した外部アプリケーションの登録」

- 第26.2.3項「Spacesアプリケーションでの外部アプリケーションの登録」

- 第26.2.4項「Frameworkアプリケーションでの外部アプリケーションの登録」

26.2.1 Fusion Middleware Controlを使用した外部アプリケーションの登録

外部アプリケーションを登録する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーション(FrameworkアプリケーションまたはSpacesアプリケーション)のホームページにナビゲートします。

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

- 第6.2項「Spacesアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 新規の外部アプリケーションを登録するには、「追加」をクリックします(図26-2)。

図26-2 外部アプリケーション接続の構成

5. 外部アプリケーションの一意の名前と、この外部アプリケーションを操作するWebCenter Portalユーザーに表示される表示名を入力します。
表26-1も参照してください。

表26-1 外部アプリケーション接続: 名前

フィールド

説明

アプリケーション名

アプリケーションの名前を入力します。名前は、WebCenter Portalアプリケーションのすべての接続タイプにおいて一意である必要があります。

例: yahoo

注意: 登録後に「アプリケーション名」を編集することはできません。

表示名

WebCenter Portalユーザーにわかりやすいアプリケーション名を入力します。ここで指定した表示名が、この外部アプリケーションを操作するWebCenter Portalエンド・ユーザーに表示されます。

例: My Yahoo

このフィールドを空白のままにした場合、「アプリケーション名」が使用されます。

6. 外部アプリケーションのログインの詳細を入力します。
詳細は、表26-2を参照してください。

表26-2 外部アプリケーション接続: ログインの詳細

フィールド

説明

自動ログインの有効化

これを選択した場合、ユーザーはこのアプリケーションに自動的にログインできます。このオプションを選択した場合、Login URL、HTML User ID Field NameおよびHTML User Password Field Nameフィールドへの入力が必要になります。

自動シングル・サインオンが設定されている場合は、ユーザーの資格証明が資格証明ストアから取得されるため、ユーザーはアプリケーションに直接リンクされて自動的に認証されます。このオプションを選択すると、エンド・ユーザーはシームレスなシングル・サインオンを行うことができます。

注意: 次の場合には、自動ログインはサポートされません。

- 基本認証を使用した外部アプリケーション。

- SSO用に構成された外部アプリケーション。

- (ADF Facesを使用して構築された)カスタマイズ済ログイン・フォームを含む外部アプリケーション。このログイン・フォームでは、認証用のJ2EEセキュリティ・コンテナ・ログイン・メソッドj_security_checkを実装できません。

- UTF8エンコーディングをサポートしていない外部サイト。

- ログイン成功時に、ランダムに生成される非表示フィールド値またはCookieを受け入れる外部アプリケーション。

ログインURL

外部アプリケーションのログインURLを入力します。

URLを調べるには、アプリケーションのログイン・ページにナビゲートし、URLを書き留めます。

例: http://login.yahoo.com/config/login

注意: この外部アプリケーションの目的が他のサービスのかわりにユーザー資格証明を格納および提供することのみの場合、「ログインURL」は必要ありません。

HTMLユーザーIDのフィールド名

ログイン・フォームのユーザー名フィールドまたはユーザーIDフィールドを識別する名前を入力します。

ヒント: この名前を調べるには、ログイン・ページのHTMLソースを参照してください。

このプロパティに指定するのはユーザー資格証明ではありません。

「認証方式」がGETまたはPOSTである場合は必須です。アプリケーションでBASIC認証を使用する場合(「認証方式」を参照)は、このフィールドを空白のままにしておきます。

HTMLユーザー・パスワードのフィールド名

ログイン・フォームのパスワード・フィールドを識別する名前を入力します。

ヒント: この名前を調べるには、ログイン・ページのHTMLソースを参照してください。

「認証方式」がGETまたはPOSTである場合は必須です。アプリケーションでBASIC認証を使用する場合(「認証方式」を参照)は、このフィールドを空白のままにしておきます。

7. 外部アプリケーションで使用される認証方式を選択します。
詳細は、表26-3を参照してください。

表26-3 外部アプリケーション接続: 認証の詳細

フィールド

説明

認証方式

外部アプリケーションで使用されるフォーム送信方式を選択します。次のいずれかを選択します。

- GET: ページ・リクエストをサーバーに送信し、ログイン資格証明をログインURLの一部として送信します。この認証方式を使用すると、ユーザー名とパスワードがURL内に公開されるため、セキュリティ・リスクが発生する可能性があります。

- POST: ログイン資格証明をフォームの本文内で送信します。これはデフォルト値です。

- 基本: ログイン資格証明をリクエスト内の認証ヘッダーとしてサーバーに送信します。この認証方式を使用すると、資格証明が傍受されやすいうえ、このスキームではサーバーから返される情報が保護されないため、セキュリティ・リスクが発生する可能性があります。クライアントとサーバーのコンピュータの間の接続が安全であり、信頼できることが前提となります。

「認証方式」は、ブラウザからメッセージが送信される方法を指定します。この値は、外部アプリケーションのログイン・フォームのHTMLソース(たとえば、<form method="POST" action="https://login.yahoo.com/config/login?" AutoComplete="off">)を表示すると調べることができます。

8. 必要な場合、追加のログイン・フィールドおよび詳細を指定します。
詳細は、表26-4「外部アプリケーション接続: 追加ログイン・フィールド」を参照してください。

表26-4 外部アプリケーション接続: 追加ログイン・フィールド

フィールド

説明

追加ログイン・フィールド

アプリケーションに追加のログイン基準が必要な場合は、「追加ログイン・フィールド」を開きます。

たとえば、Lotus Notesアプリケーションでは、user nameとpasswordの他に2つのフィールド(HostとMailFilename)が必要です。

「追加」をクリックして、ログイン・フォームの追加フィールドを指定します。それぞれの新しいフィールドで次を実行します。

- 名前: ログインにユーザー入力が必要なHTMLログイン・フォームのフィールドを識別する名前を入力します。アプリケーションで基本認証が使用される場合、このフィールドは適用されません。

- 値: フィールドのデフォルト値を入力するか、ユーザーが指定できるように空白のままにしておきます。アプリケーションで基本認証が使用される場合、このフィールドは適用されません。

- ユーザーに表示: これを選択した場合、外部アプリケーションのログイン画面にこのフィールドが表示されます。このフィールドを表示しない(チェック・ボックスを選択しない)場合は、デフォルトの「値」を指定する必要があります。

ログイン・フィールドを削除するには、「削除」をクリックします。

9. 必要な場合、共有ユーザー資格証明およびパブリック・ユーザー資格証明を指定します。
詳細は、表26-5を参照してください。

表26-5 外部アプリケーション接続: 共有ユーザー資格証明とパブリック・ユーザー資格証明

フィールド

説明

共有資格証明の有効化

この外部アプリケーションで共有ユーザー資格証明を有効にするかどうかを指定します。有効にする場合は資格証明を指定します。「共有資格証明の有効化」を選択してから、共有ユーザーの「ユーザー名」および「パスワード」資格証明を入力します。

共有資格証明を指定した場合、WebCenter Portalアプリケーションを介してこの外部アプリケーションにアクセスするユーザーはいずれも、ここで定義したユーザー名とパスワードを使用して認証されます。WebCenter Portalユーザーにログイン・フォームは表示されません。

WebCenter Portalユーザーが自分自身の資格証明を定義する必要はないため、共有資格証明を持つ外部アプリケーションは外部アプリケーションのパスワード変更タスク・フロー(「マイ・アカウント」など)では表示されません。

詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの外部アプリケーション用のログイン情報の指定に関する項を参照してください。

パブリック資格証明の有効化

認証されていないユーザー(パブリック・ユーザー)がこの外部アプリケーションにアクセスできるかどうかを指定します。「パブリック資格証明の有効化」を選択してから、パブリック・ユーザーの「ユーザー名」および「パスワード」資格証明を入力します。

パブリック資格証明を指定した場合、WebCenter Portalアプリケーションのパブリック・ページを介してこの外部アプリケーションにアクセスするパブリック・ユーザーは、ここで定義したユーザー名とパスワードを使用してログインします。パブリック資格証明を指定しない場合、パブリック・ユーザーには、この外部アプリケーションにパブリック・ユーザーがアクセスできないことを示す認可エラーが表示されます。

10. 「OK」をクリックして、アプリケーションを登録します。

26.2.2 WLSTを使用した外部アプリケーションの登録

WLSTコマンドのcreateExtAppConnectionを使用して、外部アプリケーション接続を作成します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateExtAppConnectionに関する項を参照してください。

WLSTコマンドのaddExtAppCredentialを使用して、外部アプリケーション接続の共有資格証明またはパブリック資格証明を追加します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のaddExtAppCredentialに関する項を参照してください。

WLSTコマンドのaddExtAppFieldを使用して、既存の外部アプリケーション接続に追加のログイン基準を定義します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のaddExtAppFieldに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

26.2.3 Spacesアプリケーションでの外部アプリケーションの登録

Spacesアプリケーションでの外部アプリケーションの登録の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペース管理を使用した外部アプリケーションの登録に関する項を参照してください。

26.2.4 Frameworkアプリケーションでの外部アプリケーションの登録

外部アプリケーションを使用するサービスの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の外部アプリケーションの管理に関する項を参照してください。

26.3 外部アプリケーション接続の詳細の変更

この項では、外部アプリケーション接続の詳細を変更する方法を説明します。この項の内容は次のとおりです。

- 第26.3.1項「Fusion Middleware Controlを使用した外部アプリケーション接続の変更」

- 第26.3.2項「WLSTを使用した外部アプリケーション接続の変更」

26.3.1 Fusion Middleware Controlを使用した外部アプリケーション接続の変更

外部アプリケーション接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、Frameworkアプリケーション(またはSpacesアプリケーション)のホームページにナビゲートします。

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

- 第6.2項「Spacesアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 変更する外部アプリケーションの名前を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータ情報の詳細は、表26-2を参照してください。
外部アプリケーションの名前は編集できないので注意してください。

6. 「OK」をクリックして、変更を保存します。

26.3.2 WLSTを使用した外部アプリケーション接続の変更

WLSTコマンドのsetExtAppConnectionを使用して、既存の外部アプリケーション接続の詳細を編集します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のsetExtAppConnectionに関する項を参照してください。

注意:

追加のログイン・フィールドに関連する詳細を編集するには、setExtAppFieldを使用します。既存の共有資格証明またはパブリック資格証明を編集するには、setExtAppCredentialを使用します。

追加のログイン・フィールドを削除するには、removeExtAppFieldを使用します。共有資格証明またはパブリック資格証明を削除するには、removeExtAppCredentialを使用します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

Spacesでの外部アプリケーションの変更の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの外部アプリケーション接続の詳細の編集に関する項を参照してください。

26.4 外部アプリケーション接続のテスト

ログインURLを使用して外部アプリケーションを作成する場合は、そのログインURLにアクセス可能であることを確認します。ダイレクトURLの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の自動シングル・サインオンに関する項を参照してください。

26.5 外部アプリケーション接続の削除

外部アプリケーション接続を削除すると、WebCenter Portalアプリケーション・ユーザーはそのアプリケーションにアクセスできなくなり、外部アプリケーションに依存するサービスが正常に機能しなくなる可能性があるため、削除する際は注意してください。

Spacesでは、外部アプリケーションを削除しても、外部アプリケーションへのリンクはアプリケーション・ナビゲータ・タスク・フローから自動的に削除されません。無駄なアクセス試行が行われないように、管理者が使用不可能なアプリケーションへのリンクを削除することをお薦めします。

この項の内容は次のとおりです。

- 第26.5.1項「Fusion Middleware Controlを使用した外部アプリケーション接続の削除」

- 第26.5.2項「WLSTを使用した外部アプリケーション接続の削除」

- 第26.5.3項「WebCenter Portal: Spacesでの外部アプリケーション接続の削除」

26.5.1 Fusion Middleware Controlを使用した外部アプリケーション接続の削除

外部アプリケーション接続を削除する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、Frameworkアプリケーション(またはSpacesアプリケーション)のホームページにナビゲートします。

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

- 第6.2項「Spacesアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- Spacesアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 削除する外部アプリケーションの名前を選択し、「削除」をクリックします。

26.5.2 WLSTを使用した外部アプリケーション接続の削除

WLSTコマンドのdeleteConnectionを使用して、外部アプリケーション接続を削除します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

注意:

追加のログイン・フィールドを削除するには、removeExtAppFieldを使用します。共有資格証明またはパブリック資格証明を削除するには、removeExtAppCredentialを使用します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

26.5.3 WebCenter Portal: Spacesでの外部アプリケーション接続の削除

Spacesでの外部アプリケーションの削除の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの外部アプリケーションの削除に関する項を参照してください。

26.5.4 WebCenter Portal: Frameworkアプリケーションでの外部アプリケーション接続の削除

Frameworkアプリケーションでの外部アプリケーションの削除の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle JDeveloperでの外部アプリケーション登録の詳細の削除に関する項を参照してください。

27 RESTサービスの管理

この章では、WebCenter PortalアプリケーションにおけるOracle WebCenter PortalのRESTサービス管理の概要について説明します。

この章の内容は次のとおりです。

- 第27.1項「RESTサービスに関する必要な知識」

- 第27.2項「RESTの有効化に必要な手動構成の実行」

- 第27.3項「セキュリティ・トークンの概要」

- 第27.4項「プロキシ・サーバーの構成」

- 第27.5項「RESTのルート名の変更」

- 第27.6項「圧縮の使用」

- 第27.7項「認証の処理」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminまたはOperatorロールを付与されたユーザー)を対象としています。詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

27.1 RESTサービスに関する必要な知識

REST (REpresentational State Transfer)は、分散されたリソースを共通のインタフェースを介して利用できるようにするためのアーキテクチャ・スタイルです。この共通のインタフェースには、Uniform Resource Identifier (URI)、明確に定義された操作、ハイパーメディア・リンクおよび一連の制約付きメディア・タイプなどがあります。通常、これらの操作には、読取り、書込み、編集、削除が含まれます。メディア・タイプには、JSONおよびXML/ATOMなどがあります。

REST APIは一般的に、クライアント側のスクリプト言語で記述されたリッチ・インターネット・アプリケーションで使用されます。たとえば、Javascriptで記述されたブラウザ・ベースのアプリケーションでは、サーバーとのアプリケーション・データの送受信にAjaxの手法とREST APIを併用することにより、クライアント・ビューを更新できます。

WebCenter Portalには、ディスカッション、リスト、ピープル・コネクションおよび検索など、WebCenter Portalの様々なサービスに対するRESTfulなインタフェースが用意されています。RESTをサポートするサービスの全リストは、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle WebCenter Portal REST APIの使用に関する項を参照してください。

RESTおよびWebCenter Portal REST APIの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOracle WebCenter REST APIの使用に関する項を参照してください。

27.2 RESTの有効化に必要な手動構成の実行

WebCenter Portal REST APIはデフォルトでは有効化されていません。REST APIを有効化するには、手動による構成手順を実行する必要があります。この手順を実行すると、暗号化されたセキュリティ・トークンを資格証明ストアで処理できるようになります。

必要な構成手順の詳細は、第20.2項「開始前の作業: 必要な構成の実行」を参照してください。

27.3 セキュリティ・トークンの概要

ユーザーが範囲指定したセキュリティ・トークンは、各RESTサービスURIのhref属性とtemplate属性に埋め込まれます。トークンの生成および検証はいずれもサーバーで行われます。セキュリティ・トークンの目的は、クロスサイト・リクエスト・フォージェリ(CSRF)攻撃を防止することです。

次に例を示します。

<link
template="opaque-template-uri/@me?startIndex={startIndex}
&itemsPerPage={itemsPerPage}&token=generated-token"
resourceType="urn:oracle:webcenter:messageBoard"
href="opaque-uri/@me?token=generated-token"
capabilities="urn:oracle:webcenter:read"/>

注意:

セキュリティ・トークンは認証にもアイデンティティ伝播にも使用されません。

セキュリティ・トークンは認証済ユーザーの名前に基づきます。セキュリティ・トークンは期限切れにならないため、URIのキャッシュやブックマークが可能になります。

セキュリティ・トークンにはソルト処理も行われます。ソルト処理は、文字列を暗号化する前にその文字列に文字を追加する暗号化手法です。セキュリティ・トークンが漏えいした場合でも、ソルト処理がされているので、問題を解決するためにそのユーザーのユーザー名をシステム全体で変更する必要はありません。

この手法を使用すると、ユーザー名が漏えいした際に、問題解決のためにシステム規模でユーザー名を変更する必要がなくなります。

セキュリティ・トークンの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項を参照してください。

27.4 プロキシ・サーバーの構成

この項では、レスポンス書き換え処理を行う単純なHTTPリバース・プロキシをApacheサーバーに設定する方法について説明します。通常、プロキシ・サーバーは、ブラウザ・クライアントがXMLHttpRequest (XHR)コールを実行する際に伴う、クロス・ドメイン・リクエストの問題を回避するために導入されます。一般的にこのようなコールは、Ajax開発手法によってリッチでインタラクティブなクライアント・サイド・インタフェースを作成する場合に付随します。REST APIは、通常このようなクライアント・サイド開発シナリオで使用されます。

注意:

この項では、Apache上にプロキシ・サーバーを設定するための簡単な例を示します。詳細は、Apache Serverのドキュメント(http://httpd.apache.org/docs)を参照してください。Oracle HTTP Server (OHS)をプロキシ・サーバーとして使用することもできます。詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』を参照してください。

Apache上にプロキシ・サーバーを設定するための基本的な手順は次のとおりです。

1. Apacheサーバーにアクセスできるようにします。Apache 2.2.7以降のバージョンの使用をお薦めします。

2. サーバーにmod_substituteモジュールがインストールされていることを確認します。Apacheバージョン2.2.7以降にはデフォルトでmod_substituteが含まれています。mod_sedまたはmod_line_editを使用することも可能ですが、これらの構成はOracleではサポートされていません。

3. httpd.confまたは仮想ホストの構成ファイルを開いて、次の行を追加します(サーバー名などの情報は適宜置き換えてください)。

ProxyRequests           Off
LoadModule              substitute_module       modules/mod_substitute.so
SetOutputFilter         SUBSTITUTE

ProxyPass               /rest/api/              http://myhost:8888/rest/api/
ProxyPassReverse        /rest/api/              http://myhost:8888/rest/api/
Substitute              s|myhost|yourhost|n

ProxyPass               /pathname/rest/api/        http://myhost:8888/rest/api/
ProxyPassReverse        /pathname/rest/api/        http://myhost:8888/rest/api/
Substitute              s|myhost:8888/rest/api|yourhost/pathname/rest/api|n

注意:

このサンプル・シナリオでは、2つのサーバーがプロキシされます。次の2つのコールは実際にこの2つのサーバーと通信していますが、クライアントでは同じサーバー・ホストと通信しているように見えます。

http://myhost/rest/api/resourceIndex

http://myhost/pathname/rest/api/resourceIndex

4. Apacheサーバーを再起動します。たとえば、Linuxの場合は次のように実行します。

sudo /etc/init.d/httpd restart

この方法でApacheのプロキシ設定を行う場合、Linuxの一部の構成では、selinuxに対してhttpdからのアウトバウンド接続を許可するように指定する必要があります。これを行うには、selinuxのGUIまたはコマンドラインを使用してhttpd_can_network_connect flagを有効化します。

開発者向けのヒント:

httpd.confのUserDirのパーミッションを設定して、ユーザーがそれぞれのpublic_htmlディレクトリにファイルを配置できるようにします。たとえば、http://host/~yourname/sample.htmlと入力してサンプル・アプリケーションにアクセスすると、サンプル・アプリケーションでhttp://host/rest/api/resourceIndexへのXHRコールが実行されます。

27.5 RESTのルート名の変更

REST APIのルート名の変更は必須ではありませんが、場合によっては必要になることがあります。RESTのルート名を変更する場合は、プロキシ・サーバーを構成して変更する方法をお薦めします。たとえば、次の2つのURIは、プロキシ・サーバー構成(第27.4項「プロキシ・サーバーの構成」を参照)によって同じサーバーを参照しています。

http://myhost:8888/rest/api/resourceIndex

http://myhost:8888/pathname/rest/api/resourceIndex

27.6 圧縮の使用

この項では、WebCenter Portal REST APIによってクライアントに戻されるXMLレスポンスまたはJSONレスポンスで圧縮を有効化する手法について説明します。

Apacheを使用している場合は、mod_deflateまたはmod_gzipサーバー・モジュールをサーバー構成に追加できます。詳細は、Apacheのドキュメントを参照してください。

Oracle HTTP Server (OHS)を使用している場合は、Oracle Web Cacheを使用してこれを行うことをお薦めします。詳細は、『Oracle Fusion Middleware Oracle Web Cache管理者ガイド』を参照してください。

OHSを使用している場合は、mod_deflateまたはmod_gzipサーバー・モジュールを追加して圧縮を有効化することもできます。この手法の詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』のOracle HTTP Serverモジュールの理解に関する項を参照してください。

Oracle Web Cacheの詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』の圧縮に関する項および同ガイドの「コンテンツのキャッシュと圧縮」の章を参照してください。

27.7 認証の処理

デフォルトでは、RESTサービスは、アイデンティティ・アサーション・プロバイダからの認証を受け入れるように構成されています。アイデンティティ・アサーション・プロバイダが構成されていない場合は、基本認証が使用されます。

アイデンティティ・アサーション・プロバイダの詳細は、第29.10項「RESTサービス・アイデンティティ・アサータの構成」を参照してください。

詳細は、Oracle Fusion Middleware Oracle WebLogic Serverの保護の認証プロバイダの構成に関する項を参照してください。

注意:

ユーザーはCMISのルートに匿名でアクセスできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のCMIS REST APIのセキュリティに関する考慮事項に関する項を参照してください。

第V部

Oracle WebCenter Portalの詳細なシステム管理

第V部の内容は次のとおりです。

- 第28章「WebCenter Portalアプリケーションのセキュリティ管理」

- 第29章「アイデンティティ・ストアの構成」

- 第30章「ポリシーおよび資格証明ストアの構成」

- 第31章「シングル・サインオンの構成」

- 第32章「Frameworkアプリケーションのシングル・サインオンの構成」

- 第33章「SSLの構成」

- 第34章「WS-Securityの構成」

- 第35章「ポートレット・プロデューサのセキュリティの構成」

- 第36章「WebCenter Portal管理コンソールの使用」

- 第37章「複数言語ポータルの管理」

- 第38章「Oracle WebCenter Portalパフォーマンスの監視」

- 第39章「WebCenter Portalのエクスポート、インポート、バックアップおよびリカバリの管理」

28 WebCenter Portalアプリケーションのセキュリティ管理

この章では、WebCenter Portal: Frameworkアプリケーションの保護の概要を説明し、さらにFrameworkアプリケーションおよびSpacesアプリケーションの初期デプロイ時に設定されているセキュリティ構成について説明します。また、トラブルシューティングの項では、セキュリティ関連の構成でよく見られる問題のソリューションを示します。

この章の内容は次のとおりです。

- 第28.1項「WebCenter Portalアプリケーションのセキュリティの概要」

- 第28.2項「デフォルトのセキュリティ構成」

- 第28.3項「セキュリティ構成に関する問題のトラブルシューティング」

WebCenter Portalアプリケーション(FrameworkアプリケーションおよびSpacesアプリケーションを含む)のセキュリティ構成の特定の局面に関する詳細は、次を参照してください。

- 第29章「アイデンティティ・ストアの構成」

- 第30章「ポリシーおよび資格証明ストアの構成」

- 第31章「シングル・サインオンの構成」

- 第32章「Frameworkアプリケーションのシングル・サインオンの構成」

- 第33章「SSLの構成」

- 第34章「WS-Securityの構成」

- 第35章「ポートレット・プロデューサのセキュリティの構成」

- 第36章「WebCenter Portal管理コンソールの使用」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

28.1 WebCenter Portalアプリケーションのセキュリティの概要

WebCenter Portalアプリケーションの推奨セキュリティ・モデルは、Java Authentication and Authorization Service (JAAS)モデルを実装するOracle ADF Securityに基づいています。Oracle ADF Securityの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

図28-1は、WebCenter Portalアプリケーション・デプロイメントとそのサービス、サーバー、ポートレット、ポートレット・プロデューサ、アイデンティティ・ストア、資格証明ストア、ポリシー・ストア、およびOracle Enterprise Managerの関係を示しています。

図28-1 WebCenter Portalアプリケーションの基本的なアーキテクチャ

「図28-1 WebCenter Portalアプリケーションの基本的なアーキテクチャ」の説明

図28-2は、バックエンド・サーバーが接続されたデプロイ後の基本的なWebCenter Portalアプリケーションを示しています。

図28-2 バックエンド・サーバーが接続されたWebCenter Portalアプリケーションのアーキテクチャ

「図28-2 バックエンド・サーバーが接続されたWebCenter Portalアプリケーションのアーキテクチャ」の説明

図28-3は、WebCenter Portalアプリケーションのセキュリティ・レイヤーを示しています。

図28-3 WebCenter Portalのセキュリティ・レイヤー

「図28-3 WebCenter Portalのセキュリティ・レイヤー」の説明

FrameworkアプリケーションとSpacesは4つの同一下部セキュリティ・レイヤー(WebCenterセキュリティ・フレームワーク、ADFセキュリティ、OPSSおよびWebLogicサーバー・セキュリティ)を共有します。当然ながら、アプリケーション・レイヤーは実装に依存します。

WebCenter Portalアプリケーション・セキュリティ

WebCenter Portalでは、次のものがサポートされています。

- アプリケーション・ロール管理および権限マッピング

- 自己登録

- スペースレベルのセキュリティ管理

- アカウント管理

- 外部アプリケーションの資格証明管理

WebCenter Portalセキュリティ・フレームワーク

WebCenter Portalセキュリティ・フレームワークでは、次のものがサポートされています。

- サービス・セキュリティ拡張フレームワーク(サービスのセキュリティ・モデルを指定する際に一般的に使用される、権限ベースおよびロール・マッピングベースのモデル)

- 権限ベースの認可

- ロール・マッピングベースの認可

- 外部アプリケーションと資格証明とのマッピング

ADFセキュリティ

ADFセキュリティでは、次のものがサポートされています。

- ページ認可

- タスク・フロー認可

- セキュアな接続管理

- 資格証明マッピングAPI

- ログアウトの呼出し(Oracle Access ManagerおよびOracle SSOを使用したSSO対応構成からのログアウトなど)

- ADFセキュリティベースのアプリケーション(adfAuthenticationサーブレット)用に保護されたログインURL

Oracle Platform Security Services (OPSS)

OPSSでは、次のものがサポートされています。

- Anonymous-roleのサポート

- Authenticated-roleのサポート

- アイデンティティ・ストア、ポリシー・ストアおよび資格証明ストア

- アイデンティティ管理サービス

- Oracle Web Service Manager Security

WebLogic Serverセキュリティ

WebLogic Serverセキュリティでは、次のものがサポートされています。

- WebLogicオーセンティケータ

- アイデンティティ・アサータ

- J2EEコンテナ・セキュリティ

- SSL

28.2 デフォルトのセキュリティ構成

この項では、WebCenter Portal: FrameworkアプリケーションとWebCenter Portal: Spacesのデプロイ時に設定されているセキュリティ構成と、デプロイ後に実行する必要のあるタスクについて説明します。

- 第28.2.1項「管理者アカウント」

- 第28.2.2項「アプリケーション・ロールとエンタープライズ・ロール」

- 第28.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」

- 第28.2.4項「デフォルトのポリシー・ストアの権限および付与」

- 第28.2.5項「デプロイ後のセキュリティ構成タスク」

28.2.1 管理者アカウント

Frameworkアプリケーションでは、事前に用意されているアカウントがないため、Fusion Middlewareのインストール時に設定されるFusion Middleware管理者アカウント(デフォルトではweblogic)が使用されます。この管理者アカウントを使用して、Fusion Middleware Controlにログインし、新規アカウントを設定します。

Spacesアプリケーションでは、事前に用意されているアカウントはありませんが、SpacesアプリケーションのデフォルトのFusion Middleware管理者アカウント(weblogic)には特定の権限が事前に付与されています。インストール環境でFusion Middleware管理者ロールのアカウント名にweblogicを使用しない場合は、第30.6項「ユーザーおよびアプリケーション・ロールの管理」の手順に従って、このロールにその他のユーザーを1つ以上構成する必要があります。

注意:

weblogicアカウントはシステム管理者アカウントです。そのため、ユーザーレベルのアーティファクトを作成する際には使用しないでください。weblogicアカウントは、Fusion Middleware Controlで新規ユーザー・アカウントを作成する場合にのみ使用してください。

28.2.2 アプリケーション・ロールとエンタープライズ・ロール

アプリケーション・ロールは、組込みLDAPサーバーのアイデンティティ・ストア部分に存在するロールや、エンタープライズLDAPプロバイダにより定義されたロールとは異なります。アプリケーション・ロールはアプリケーションに固有であり、ポリシー・ストアのアプリケーション固有のストライプで定義されます。

エンタープライズ・アイデンティティ・ストアに格納されているエンタープライズ・ロールは、エンタープライズ・レベルでのみ適用されます。つまり、ユーザーやシステム管理者がエンタープライズ・アイデンティティ・ストア内部に定義したロールおよび権限は、アプリケーション内の権限とは異なります。

SpacesまたはFrameworkアプリケーション内では、アプリケーション・ロールおよび権限を企業アイデンティティ・ストア内のユーザーに割り当てることができます。また、エンタープライズ・アイデンティティ・ストア内に定義されたエンタープライズ・ロールに対してアプリケーション・ロールおよび権限を割り当てることもできます。

28.2.3 デフォルトのアイデンティティ・ストアおよびポリシー・ストア

WebCenter Portalアプリケーションはデフォルトで、ファイルベースの組込みLDAPアイデンティティ・ストアを使用してアプリケーションレベルのユーザーIDを格納し、ファイルベースのLDAPポリシー・ストアを使用してポリシー権限を格納するように構成されています。

組込みLDAPアイデンティティ・ストアはセキュアではありますが、本番クラスのストアではないため、エンタープライズ本番環境向けの外部LDAPベース・アイデンティティ・ストア(Oracle Internet Directoryなど)と置き換える必要があります。サポートされているアイデンティティ・ストアLDAPサーバーのリストは、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドのサポートされているLDAPアイデンティティ・ストアのタイプに関する項を参照してください。

デフォルトのファイルベースのポリシー・ストアは、デプロイ用および単一ノードのSpaces構成用のみに使用してください。エンタープライズ・デプロイメントでは、ポリシー・ストアおよび資格証明ストアをデータベースまたは外部LDAPベースのストア(第30章「ポリシーおよび資格証明ストアの構成」を参照)に再度関連付ける必要があります。

ポリシー・ストアおよび資格証明ストアでは、Oracle Internet Directory 11gR1または10.1.4.3、またはOracle RDBMS (リリース10.2.0.4以降、リリース11.1.0.7以降およびリリース11.2.0.1以降)のいずれかを使用できます。外部LDAPベースのストアを使用する場合は、ポリシー・ストアと資格証明ストアで同じLDAPサーバーを使用するように構成する必要がある点に注意してください。同様に、データベースを使用する場合は、ポリシー・ストアと資格証明ストアで同じデータベースを使用する必要があります。

サポートされているアイデンティティ・ストア、ポリシー・ストアおよび資格証明ストアの構成の詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドのサポートされているLDAPベース、DBベース、およびファイルベースのサービスに関する項を参照してください。アイデンティティ・ストア、ポリシー・ストアおよび資格証明ストアの再構成の詳細は、第29章「アイデンティティ・ストアの構成」および第30章「ポリシーおよび資格証明ストアの構成」を参照してください。

注意:

WebCenter Portalのディスカッション・サービスはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。

外部LDAPサーバーとアイデンティティ・ストアを再度関連付けた場合、Fusion Middleware管理者アカウントを外部LDAPに移動する(第29.5項「外部LDAPサーバーへの管理者アカウントの移行」を参照)か、管理者アカウントを移動しない場合は、ディスカッション・サーバーの新しい管理者アカウントを指定するために追加の手順が必要になります(第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」を参照)。

Spacesに関しては、SpacesおよびContent Serverは同じLDAPサーバーを共有する必要があります。詳細は、第29.6項「Oracle Content ServerとSpacesでアイデンティティ・ストアLDAPサーバーを共有するための構成」を参照してください。

28.2.3.1 ファイルベースの資格証明ストア

初期設定の資格証明ストアはウォレットベース(ファイルベース)であり、ファイルcwallet.ssoに含まれています。このファイルの場所は、Oracle Platform Security構成ファイルjps-config.xmlで指定されています。ポリシー・ストアをLDAPディレクトリに再度関連付けると、アプリケーションの資格証明がポリシー・ストアと同じLDAPディレクトリに自動的に移行されます。

28.2.4 デフォルトのポリシー・ストアの権限および付与

ADFセキュリティの権限モデルでは、権限ベースの認可およびロールベースの認可の両方がサポートされています。次の項では、この2つの認可タイプ、デフォルトのポリシー・ストア権限およびコードベース権限について説明します。

- 第28.2.4.1項「権限ベースの認可」

- 第28.2.4.2項「ロール・マッピングベースの認可」

- 第28.2.4.3項「Spacesのデフォルトのポリシー・ストア権限」

- 第28.2.4.4項「デフォルトのコードベース権限」

28.2.4.1 権限ベースの認可

権限ベースの認可は、リストなど、Oracle Platform Security Services (OPSS)を使用してWebCenter Portalアプリケーション内にアクセス制御が実装されているサービスで使用されます。Spacesには、ユーザーおよびロール管理ツールが豊富に用意されています。これらのツールによってアプリケーション・ロールを作成し、そのロールに付与する必要がある権限を定義できます。Spacesでのユーザーおよびロールの管理の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのアプリケーション・ロールおよび権限の管理に関する項を参照してください。

28.2.4.2 ロール・マッピングベースの認可

リモート(バックエンド)リソースへのアクセスが必要なサービスでは、ロール・マッピングベースの認可が必須になります。たとえば、ディスカッション・サービスで、WebCenter Portalアプリケーションの(1つ以上のアプリケーション・ロールにマップされている)ユーザーをディスカッション・サーバーの別のロール・セットにマップする必要がある場合は、ロール・マッピングが必須です。

たとえば、Spacesアプリケーションでは次のようになります。

- Spacesのロールは、バックエンドのディスカッション・サーバーの対応するロールにマップされます。

- ユーザーに新しいSpacesスペース・ロールが付与されると、バックエンドのディスカッション・サーバーで同様の権限が付与されます。たとえば、ユーザーPatがSpacesでDiscussions-Create/Edit/Delete権限を付与された場合、バックエンドのディスカッション・サーバーで、対応する権限がPatに付与されます。

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのディスカッション・サーバーのロールおよび権限マッピングの概要に関する項も参照してください。

28.2.4.3 Spacesのデフォルトのポリシー・ストア権限

Spacesには、初期設定で次のデフォルト・ロールが用意されています。

デフォルトのアプリケーション・ロール:

- Administrator

- Authenticated-User

- Public-User

デフォルトのアプリケーション・ロールの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのアプリケーション・ロールのデフォルトの権限に関する項を参照してください。

スペース内のデフォルトのロール

- Moderator

- Participant

- Viewer

スペース内のデフォルトのロールの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペース内のロールに対するデフォルトの権限に関する項を参照してください。

28.2.4.4 デフォルトのコードベース権限

WebCenter Portalアプリケーションは、権限チェックを使用して保護されたセキュリティ・プラットフォームでAPIを内部的にコールします。したがって、OPSSのAPIを呼び出すには、WebCenter Portalアプリケーションに適切な権限を付与する必要があります(たとえば、ポリシー・ストアにアクセスして権限を付与または取り消す(PolicyStoreAccessPermission)ための権限や、アプリケーション・ロールに基本的な権限を付与するための権限など)。Spacesでは、アプリケーション・ロールの基本的な権限はデフォルトで付与されています(Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのアプリケーション・ロールのデフォルトの権限に関する項を参照してください)。

同様に、WebCenter Portalアプリケーションでは、WebCenter Portalの権限を使用して公開する各種操作に対して事前にアクセスを認可しておき、OPSS APIを権限付きアクションとして呼び出す必要があります。

28.2.5 デプロイ後のセキュリティ構成タスク

FrameworkアプリケーションまたはSpacesをデプロイした後で、次のセキュリティ関連の構成タスクをサイトに対して実行することを考慮します。

- 外部LDAPを使用するためのアイデンティティ・ストアの再関連付け
WebCenter Portalアプリケーションではデフォルトで、アイデンティティ・ストアに組込みLDAPが使用されます。事前に構成されている組込みLDAPは、セキュアではありますが、大規模なエンタープライズ本番環境には適さない場合があります。Oracle Internet Directory (OID)などの外部LDAPを使用するようにアイデンティティ・ストアを構成する方法の詳細は、第29章「アイデンティティ・ストアの構成」を参照してください。

注意:

Oracle WebCenter Portalのディスカッション・サーバーはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。

外部LDAPサーバーとアイデンティティ・ストアを再度関連付けた場合、Fusion Middleware管理者アカウントを外部LDAPに移動する(第29.5項「外部LDAPサーバーへの管理者アカウントの移行」を参照)か、管理者アカウントを移動しない場合は、ディスカッション・サーバーの新しい管理者アカウントを指定するために追加の手順が必要になります(第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」を参照)。

Spacesに関しては、SpacesおよびContent Serverは同じLDAPサーバーを共有する必要があります。詳細は、第29.6項「Oracle Content ServerとSpacesでアイデンティティ・ストアLDAPサーバーを共有するための構成」を参照してください。

- 外部LDAPまたはデータベースを使用するためのポリシー・ストアの再関連付け
Frameworkアプリケーションではデフォルトで、ポリシー権限を格納するためにファイルベースのsystem-jazn-data.xmlポリシー・ストアが使用されます。LDAPベースまたはデータベースのポリシー・ストアを使用することを考慮する必要があります。LDAPサーバーまたはデータベースを使用するようにポリシー・ストアを構成する方法の詳細は、第30章「ポリシーおよび資格証明ストアの構成」を参照してください。

- WS-Securityの構成
WS-Securityを使用すると、Frameworkアプリケーションおよびそれを使用する一連のプロデューサの構成や管理が複雑になりますが、Frameworkアプリケーションで公開される情報のセキュリティを確保する上で役立ちます。WS-Securityを追加すると、コンシューマの認証およびメッセージレベルのセキュリティを使用できるようになります。

Frameworkアプリケーションおよびコンポーネントに対してWS-Securityを構成する方法の詳細は、第34章「WS-Securityの構成」を参照してください。

- SSOの構成
シングル・サインオン(SSO)を使用すると、ユーザーはサブアプリケーションごとにログインするのではなく(Spaces内のwikiページにアクセスする場合など)、WebCenter Portalアプリケーションおよびコンポーネント全体で1回ログインするだけで済みます。ユーザーは、アクセスするアプリケーションまたはコンポーネントごとに別個のユーザーIDおよびパスワードを保持する必要がありません。ただし、より厳密な方式を使用して機密性の高いアプリケーションを保護できるように、多様な認証方式を構成することもできます。WebCenter Portalでは、4つのシングル・サインオン・ソリューション(Oracle Access Manager (OAM)、Oracle Single Sign-on (OSSO)、Oracle WebCenter Portalアプリケーション専用のSAMLベースのシングル・サインオン・ソリューション、およびSimple and Protected Negotiate (SPNEGO)メカニズムとKerberosプロトコルに基づいたWindows認証による、Microsoftクライアント用SSOソリューション)がサポートされています。これらのソリューションの説明およびシングル・サインオンの概要については、第31章「シングル・サインオンの構成」を参照してください。

- SSLの構成
Secure Sockets Layer (SSL)は、WebCenter Portalアプリケーションまたはコンポーネントの間の接続に対して追加の認証レイヤーを提供し、交換されるデータを暗号化することにより、接続セキュリティを強化するものです。データ交換が機密的なアプリケーションまたはコンポーネント間の接続では、SSLを使用して接続を保護することを考慮してください。本番環境でSSLを使用して保護できる、または保護する必要のある接続のリストは、第33章「SSLの構成」を参照してください。

注意:

SSLを使用すると、計算が集中的に行われ、接続のオーバーヘッドが増加します。このため、SSLは必要でないかぎりは使用しないでください。SSLは本番環境まで保留しておくことをお薦めします。

28.3 セキュリティ構成に関する問題のトラブルシューティング

この項の内容は次のとおりです。

- 第28.3.1項「SpacesアプリケーションでLDAPプロバイダのユーザーが見つからない」

- 第28.3.2項「OIDユーザーとしてログインしている場合にスペースを作成するとエラーが発生する」

- 第28.3.3項「Active Directoryを使用してSpacesを構成するとユーザーが自己登録できない」

- 第28.3.4項「管理者に設定されたユーザーが管理者権限を使用できない」

- 第28.3.5項「SSO環境のOmniPortletプロデューサで認可例外が発生する」

- 第28.3.6項「SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する」

- 第28.3.7項「SAMLシングル・サインオンを構成すると403エラーが発生する」

28.3.1 SpacesアプリケーションでLDAPプロバイダのユーザーが見つからない

問題

外部LDAPプロバイダを使用してWeblogic Serverを構成しました。外部LDAPのユーザーはSpacesにログインできますが、Spacesで外部LDAPのユーザーに管理者ロールを割り当てようとすると、ユーザーが一人も見つかりません。

解決策

第29章「アイデンティティ・ストアの構成」の手順に従って、DefaultAuthenticator認証プロバイダの制御フラグをSufficientに変更します。ドメインの管理サーバーと管理対象サーバーを再起動します。

28.3.2 OIDユーザーとしてログインしている場合にスペースを作成するとエラーが発生する

問題

OIDユーザー(orcladminなど)としてSpacesにログインしている場合にスペースを作成しようとすると、スペースは作成されますがエラーが発生します。エラー・メッセージには「No matching users were found with search string <login user>」のように表示されます。

解決策

jps-config.xmlファイルに次のプロパティが設定されていません。

<property name="jps.user.principal.class.name" value="weblogic.security.principal.WLSUserImpl"/>

この問題を解決する手順は次のとおりです。

1. DOMAIN_HOME/config/fmwconfig/jps-config.xmlを編集します。

2. 一般プロパティに次の行を追加します。
<property name="jps.user.principal.class.name" value="weblogic.security.principal.WLSUserImpl"/>

3. WC_Spacesサーバーを再起動します。

28.3.3 Active Directoryを使用してSpacesを構成するとユーザーが自己登録できない

問題

SpacesでADオーセンティケータを使用するように構成すると、ユーザーがActive Directoryに自己登録できません。ユーザーが自己登録しようとすると、次のエラー・メッセージが表示されます。

"User not created.Either the user name or the password does not adhere to the registration policy or the identity store is unavailable.Specify the required user credentials or contact your administrator for assistance"

解決策

この問題を解決する手順は次のとおりです。

1. WebLogic管理コンソールでActive Directoryを構成する際に、ユーザー名属性をsAMAccountNameに設定します。

2. WebLogic管理コンソールでActive Directoryを構成する際に、LDAPのHTTPSポートを使用し、SSLのチェック・ボックスを選択します。

28.3.4 管理者に設定されたユーザーが管理者権限を使用できない

問題

orcladminとしてログインし、ユーザーを管理者に設定した後でログアウトし、そのユーザーで再度ログインしても、管理者リンクが使用可能になりません。

解決策

この問題は、アイデンティティ・ストア内でcnエントリが重複しているために起こります。cnはユーザー名属性にマップされており、一意である必要があります。アイデンティティ・ストアから重複を削除し、そのユーザーに適切なprivileges.cnを設定してください。

28.3.5 SSO環境のOmniPortletプロデューサで認可例外が発生する

問題

SSOを使用してWebCenter Portalが構成されている場合に、OmniPortletプロデューサでCredential Store Framework (CSF)ウォレットに接続情報を格納しようとすると認可例外が発生します。

解決策

WLST(詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照)を使用してOracle WebCenter Portal Administration Serverに接続し、次の付与コマンドを実行して、ssofilter.jarに必要な権限を付与します。

grantPermission(codeBaseURL="file:${oracle.home}/modules/oracle.ssofilter_11.1.1/ssofilter.jar",
permClass="oracle.security.jps.service.credstore.CredentialAccessPermission",
permTarget="context=SYSTEM,mapName=omniportlet_user,keyName=*",
permActions="*")

grantPermission(codeBaseURL="file:${oracle.home}/modules/oracle.ssofilter_11.1.1/ssofilter.jar",
permClass="oracle.security.jps.service.credstore.CredentialAccessPermission",
permTarget="context=SYSTEM,mapName=omniportlet_default,keyName=*",
permActions="*")
grantPermission(codeBaseURL="file:${oracle.home}/modules/oracle.ssofilter_11.1
.1/ssofilter.jar",
permClass="oracle.security.jps.service.credstore.CredentialAccessPermission",
permTarget="context=SYSTEM,mapName=omniportlet_user,keyName=*",
permActions="*")

28.3.6 SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する

問題

ディスカッションEARファイルをアンデプロイしてから、SAML SSO固有のディスカッションEARファイルをデプロイし、WLS管理コンソールでアプリケーションを起動すると、管理コンソールで次の例外が発生します。

java.lang.ClassCastException:
org.apache.xerces.parsers.XIncludeAwareParserConfiguration

解決策

WC_Collaborationサーバーを再起動します。これにより問題が解決され、ディスカッション・アプリケーションがアクティブな状態になるはずです。

28.3.7 SAMLシングル・サインオンを構成すると403エラーが発生する

問題

SAML SSO構成のテスト中に403エラーが発生したため、デバッグ・ロギングを有効化(第31.4.2.4項「構成のチェック」を参照)したところ、宛先サーバーで次のようなエラー・ログが表示されました。

####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLLib> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831335> <BEA-000000> <SAMLSignedObject.verify(): validating
signature>
####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLService> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831336> <BEA-000000> <SAMLDestinationSiteHelper: Signature
verification failed with exception: org.opensaml.InvalidCryptoException:
SAMLSignedObject.verify() failed to validate signature value>
####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLService> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831336> <BEA-000000> <SAMLDestinationSiteHelper: Unable to validate
response -- returning SC_FORBIDDEN>
####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLService> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831336> <BEA-000000> <SAMLSingleSignOnService.doACSGet: Failed to get
SAML credentials -- returning>

解決策

SAMLアサーションが検証されていないため、証明書の設定が正しく行われていないことが考えられます。この場合、SAMLアイデンティティ・アサータに適切な証明書が登録されていない可能性があります。SpacesドメインにSAML SSOを設定したときにcertAliasおよびcertPasswordで指定した証明書をエクスポートして、宛先ドメインでアクセス可能な場所にコピーします。

1. Spacesドメインのwcsamlsso.propertiesファイルで関連する構成セクションを更新します(たとえば、SOA構成で証明書が無効の場合は、soa_configセクションのcertPathを更新します)。

2. WebLogic Server管理コンソールを開いて、WC_Spacesドメインから「セキュリティ・レルム」→「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」に移動し、ドメインに関連するリライイング・パーティ(たとえば、SOAの場合は、ワークリスト統合、ワークリスト詳細およびワークリストSDPになります)を削除します。

3. 「宛先ドメイン」→「セキュリティ・レルム」→「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」に移動し、対応するアサーティング・パーティを削除します。

4. 「証明書」タブを開き、証明書も削除します。

5. Spacesドメインに戻り、アサーティング・パーティとリライイング・パーティの組合せを作成するためスクリプトを再実行します。たとえば、SOAの場合は、次のように再実行する必要があります。

$WC_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistIntegration.py
$WC_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistDetail.py
$WC_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistSDP.py

6. 構成を再度テストします。すべて問題なく機能すれば、SAMLロギングを無効化できます。

29 アイデンティティ・ストアの構成

この章では、アイデンティティ・ストアを、デフォルトの組込みLDAPアイデンティティ・ストアではなく、外部LDAPに再度関連付ける方法について説明します。また、LDAPサーバーをOracle WebCenter Content Server用に構成する方法についても説明します。この章の内容は次のとおりです。

- 第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」

- 第29.2項「アイデンティティ・ストアのパフォーマンス・チューニング」

- 第29.3項「外部LDAPアイデンティティ・ストア用のGUID属性の構成」

- 第29.4項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」

- 第29.5項「外部LDAPサーバーへの管理者アカウントの移行」

- 第29.6項「Oracle Content ServerとSpacesでアイデンティティ・ストアLDAPサーバーを共有するための構成」

- 第29.7項「libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約」

- 第29.8項「Spacesアプリケーション用の動的ロールの構成」

- 第29.9項「Spacesアプリケーション用の動的グループの構成」

- 第29.10項「RESTサービス・アイデンティティ・アサータの構成」

注意:

アイデンティティ・ストアを再度関連付ける前に、次の関連する構成ファイルを必ずバックアップしてください。

- config.xml

- jps-config.xml

念のため、ドメインの管理サーバーのboot.propertiesファイルもバックアップしてください。

Frameworkアプリケーションでは、外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行の手順は不要です。アイデンティティ・ストアの詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

29.1 外部LDAPサーバーへのアイデンティティ・ストアの再関連付け

ほとんどの場合、アイデンティティ・ストアでは、デフォルトの組込みLDAPは使用せずに、外部LDAPサーバーに再度関連付けます。様々なタイプのLDAPサーバーを使用できますが(サポートされているLDAPのリストは第28.2項「デフォルトのセキュリティ構成」を参照してください)、この項では、Oracle Internet Directory (OID)を使用するようにアイデンティティ・ストアを構成する方法を説明します。サポートされている他のLDAPサーバーの構成設定を使用する場合、そのLDAPに固有のユーザー属性マッピングについては、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のLDAPディレクトリへのユーザー属性のマッピングに関する項を参照してください。

注意:

本番環境の外部LDAPアイデンティティ・ストア(OIDなど)を別の外部LDAPストアに再度関連付けすることはサポートされていません。ビジネス要件によりそのような再関連付けを行う場合は、プロセス中にユーザー情報やアーティファクトが失われる可能性があるため、実施前にOracleサポートにご連絡ください。

アイデンティティ・ストアをOIDに再度関連付ける手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペイン(図29-1を参照)で、「セキュリティ・レルム」をクリックします。

図29-1 「ドメイン構造」ペイン

「図29-1 「ドメイン構造」ペイン」の説明

「セキュリティ・レルムのサマリー」ペインが表示されます(図29-10を参照)。

図29-2 「セキュリティ・レルムのサマリー」ペイン

「図29-2 「セキュリティ・レルムのサマリー」ペイン」の説明

3. 「名前」列で、アイデンティティ・ストアを再度関連付けるレルムをクリックします。
レルムの設定ペインが表示されます(図29-3を参照)。

図29-3 レルムの設定ペイン

「図29-3 レルムの設定ペイン」の説明

4. 「プロバイダ」タブを開きます。
プロバイダの設定ペインが表示されます(図29-4を参照)。

図29-4 設定ペイン - プロバイダ

「図29-4 設定ペイン - プロバイダ」の説明

5. 「新規」をクリックして、新しいプロバイダを追加します。
「新しい認証プロバイダの作成」ペインが表示されます(図29-5を参照)。

図29-5 「新しい認証プロバイダの作成」ペイン

「図29-5 「新しい認証プロバイダの作成」ペイン」の説明

6. プロバイダの名前を入力します(OIDAuthenticatorなど、Oracle Internet Directoryに対してユーザーを認証するプロバイダの名前)を入力します。

7. LDAPディレクトリに適したオーセンティケータをオーセンティケータのリストから選択します。
一般的なDefaultAuthenticatorを選択するのではなく、構成するLDAPに関連付けられたオーセンティケータを選択してください。たとえば、OIDの場合はOracleInternetDirectoryAuthenticator、iPlanetの場合はIPlanetAuthenticatorを選択します。

8. 「OK」をクリックして、設定を保存します。
設定ペインに新規の認証プロバイダが表示されます(図29-6を参照)。

図29-6 設定ペイン - 認証プロバイダ

「図29-6 設定ペイン - 認証プロバイダ」の説明

9. 「認証プロバイダ」のリストで、新しく作成したプロバイダをクリックします。
新規の新しい認証プロバイダの設定ペインが表示されます(図29-7を参照)。

図29-7 オーセンティケータの設定ペイン

「図29-7 オーセンティケータの設定ペイン」の説明

10. 「制御フラグ」をSUFFICIENTに設定します。
「制御フラグ」をSUFFICIENTに設定すると、このオーセンティケータがユーザーを正常に認証できる場合はその認証を受け入れ、それ以上のオーセンティケータを起動しません。

注意:

認証に失敗した場合、その認証は連鎖内の次のオーセンティケータに渡されます。そのため、後続のすべてのオーセンティケータについても、制御フラグがSUFFICIENTに設定されていることを確認します。

11. 「保存」をクリックして、設定を保存します。

12. 「プロバイダ固有」タブを選択して、LDAPサーバーの詳細を入力します。
「プロバイダ固有」ペインが表示されます(図29-8を参照)。

図29-8 「プロバイダ固有」ペイン

「図29-8 「プロバイダ固有」ペイン」の説明

13. 使用するLDAPサーバーに固有の詳細を入力します。

注意:

OIDの場合の適切な値を次の表に示します。Active Directoryなど、他のLDAPの許容値については、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の付録「OPSSのシステム・プロパティおよび構成プロパティ」を参照してください。

パラメータ

値

説明

ホスト:

LDAPサーバーのサーバーID(例: <ldap_host>example.com)

ポート:

LDAPサーバーのポート番号(例: 3060)

プリンシパル:

LDAPサーバーへの接続に使用されるLDAPユーザーDN(例: cn=orcladmin)

資格証明:

LDAPサーバーへの接続に使用されるパスワード

ユーザー・ベースDN:

ユーザーの基点となるDNを指定します(例: cn=users,dc=example,dc=com)

グループ・ベースDN:

グループ・ノードを示すDNを指定します(例: cn=groups,dc=example,dc=com)

取得したユーザー名をプリンシパルとして使用する

選択

有効にしておく必要があります。

すべてのユーザーのフィルタ:

(&(uid=*)(objectclass=person))

「ユーザー・ベースDN」内のすべてのユーザーを検索するための検索フィルタ

名前指定によるユーザー・フィルタ:

(&(uid=%u)(objectclass=person))

ユーザー名属性:

uid

14. 「保存」をクリックします。

15. 「プロバイダ」タブに戻り、リストの先頭に新しい認証プロバイダ、その次に他のオーセンティケータ、最後にDefaultAuthenticatorが表示されるようにプロバイダを並べ替えます。
すべてのオーセンティケータの制御フラグをSUFFICIENTに設定し、新しいプロバイダからDefaultAuthenticator(デフォルトのファイルベースの組込みLDAPのみで使用)に至るまで、後続のオーセンティケータで渡されたアイデンティティを認証できるようにする必要があります。たとえば、デフォルトの管理者アカウントなどのログインは通常、LDAPディレクトリ内に作成されませんが、サーバーを起動するためには認証が必要です。DefaultAuthenticatorにアイデンティティが渡されない場合、デフォルトの管理者アカウントは認証されません。DefaultAuthenticatorおよびデフォルトの管理者アカウントの詳細は、第29.5項「外部LDAPサーバーへの管理者アカウントの移行」を参照してください。

注意:

複数のオーセンティケータを使用する場合は、REQUIRED制御フラグを使用しないでください。オーセンティケータのリストでREQUIRED制御フラグが見つかった場合、その位置に関係なく、後続のオーセンティケータは調査されません。

16. 変更が有効になるように、管理サーバーと管理対象サーバーを再起動します。

29.2 アイデンティティ・ストアのパフォーマンス・チューニング

次の項では、特定の環境で必要になる場合があるパフォーマンス関連の構成について説明します。WebCenter Portalのチューニングおよびパフォーマンスに関する一般な情報は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

この項の内容は次のとおりです。

- 第29.2.1項「SSLを使用する場合のアイデンティティ・ストアのチューニング」

- 第29.2.2項「OVDを使用する場合のパフォーマンス・チューニング」

- 第29.2.3項「Active Directoryを使用する場合のパフォーマンス・チューニング」

29.2.1 SSLを使用する場合のアイデンティティ・ストアのチューニング

WebLogic Serverプロバイダを使用してWebCenter Portalでアイデンティティ・ストアを構成する場合、SSLポートまたは非SSLポートのいずれかを構成するように選択できます。SSLポートを選択すると、デフォルトではJNDI接続がプールされないため、ユーザー、グループなどのアイデンティティ・ストアのエントリを検索する場合に、レスポンス時間が長くなり、パフォーマンスが低下します。これを解決するには、次の手順を実行します。

1. domain_home/config/fmwconfig/jps-config.xmlにあるjps-config.xmlファイルを開き、idstore.ldapサービス・インスタンスを見つけて、次のハイライト行を追加します。

<!-- JPS WLS LDAP Identity Store Service Instance -->
<serviceInstance name="idstore.ldap" provider="idstore.ldap.provider">
<property name="idstore.config.provider"   value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"/>
<property name="CONNECTION_POOL_CLASS"    value="oracle.security.idm.providers.stdldap.JNDIPool"/>
<property name="java.naming.ldap.factory.socket"
value="javax.net.ssl.SSLSocketFactory"/>
</serviceInstance>

2. SSLポートのアイデンティティ・ストアに接続されている、ドメイン内のすべてのサーバーを、次のJVMパラメータを指定して再起動します。

-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl

これを指定するには、setDomainEnv.shを変更するか、またはコンソールで直接指定します。

3. サーバーがこのJVMパラメータで実行されていることを確認し、(*nixシステムの場合は)次のgrepコマンドを実行します。

ps -aef | grep WC_Spaces

プロセスの状態にcom.sun.jndi.ldap.connect.pool.protocol=sslと表示されることを確認します。

29.2.2 OVDを使用する場合のパフォーマンス・チューニング

OVDの場合、属性が検索されるオブジェクト・クラスはinetOrgPerson(およびその親オブジェクト・クラス)のみです。プロファイル・ギャラリには、inetOrgPersonで定義されていない属性が表示されるため、inetOrgPersonが対応していない追加の属性はすべて、アイデンティティ・ストアへの追加のラウンドトリップが必要になります。OVDを本番環境で使用する場合に最適なパフォーマンスを得るには、次の構成エントリ(太字)をドメインレベルのjps-config.xmlファイルに追加することをお薦めします

<!-- JPS WLS LDAP Identity Store Service Instance -->
<serviceInstance name="idstore.ldap"
provider="idstore.ldap.provider">
<property name="idstore.config.provider"
value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"/>
<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>

<extendedProperty>
<name>user.object.classes</name>
<values>
<value>top</value>
<value>person</value>
<value>inetorgperson</value>
<value>organizationalperson</value>
<value>orcluser</value>
<value>orcluserv2</value>
<value>ctCalUser</value>
</values>
</extendedProperty>
</serviceInstance>

29.2.3 Active Directoryを使用する場合のパフォーマンス・チューニング

Active Directoryを本番環境で使用する場合に最適なパフォーマンスを得るには、次の構成エントリ(太字)をドメインレベルのjps-config.xmlファイルに追加することをお薦めします。

<serviceInstance provider="idstore.ldap.provider"
name="idstore.ldap">
<property value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"
name="idstore.config.provider"/>
<property value="oracle.security.idm.providers.stdldap.JNDIPool"
name="CONNECTION_POOL_CLASS"/>
<property name="PROPERTY_ATTRIBUTE_MAPPING" value="WIRELESS_ACCT_NUMBER=mobile:MIDDLE_NAME=middlename:MAIDEN_NAME=sn:DATE_OF_HIRE=pwdLastSet:NAME_SUFFIX=generationqualifier:DATE_OF_BIRTH=pwdLastSet:DEFAULT_GROUP=primaryGroupID" />
<property value="sAMAccountName" name="username.attr"/>
<property value="sAMAccountName" name="user.login.attr"/>
</serviceInstance>

ピープル・プロファイル・サービスは、これらのすべての属性に対して問合せを実行します。Active Directoryプロバイダでは、これらの属性に対するデフォルトのマッピングはありません。カスタマイズされていないActive Directoryインストールには、DATE_OF_HIRE、DATE_OF_BIRTHに対応するマッピングはありません。

この2つの属性は、不要なLDAPサーバー・コールを減らすために、正しいデータ・タイプの特定の属性にマッピングされているだけにすぎません。これは、Active Directoryには実際に同じ意味論上の意味に対応する属性がないためです。

29.3 外部LDAPアイデンティティ・ストア用のGUID属性の構成

この項では、次に示すOracle LDAP以外の実装で使用される様々なGUID属性について説明します。

IBM Tivoli® Directory Server:

ibm-entryUUID

Microsoft® Active Directory:

objectGUID

Active Directoryを使用する場合、samAccountName属性は20文字に制限されます。また、Lotus Connectionsで使用される他のIDは256文字に制限されます。

Microsoft Active Directory Application Mode (ADAM):

objectGUID

objectSIDをADAMのデフォルトとして使用するには、次の行をwimconfig.xmlファイルの<config:attributeConfiguration>セクションに追加します。

<config:externalIdAttributes name="objectSID" syntax="octetString"/>

IBM Domino® Enterprise Server:

dominoUNID

Domino LDAPのバインドIDにDominoディレクトリへの十分なマネージャ・アクセスがない場合、Virtual Member Manager (VMM)はDominoスキーマ問合せに対して正しい属性タイプを返しません。DNがVMM IDとして返されます。VMMのデフォルトのID設定を上書きするには、次の行をwimconfig.xmlファイルの<config:attributeConfiguration>セクションに追加します。

<config:externalIdAttributes name="dominoUNID"/>

Sun Java™ System Directory Server:

nsuniqueid

eNovell Directory Server:

GUID

orclGuid属性を使用しないLDAPアイデンティティ・ストア(IBM Tivoliなど)を使用する場合は、GUID属性がアイデンティティ・ストアと一致するように手動でマップする必要があります。たとえば、IBM Tivoliの場合、jps-config.xmlファイルのGUID=ibm-entryUUIDを次のように設定します。

1. MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config.xmlファイルをテキスト・エディタで開きます。

2. GUIDプロパティを次のように設定します。

<serviceInstance provider="idstore.ldap.provider" name="idstore.ldap.0">
<!-- existing props ... ->
<property name="PROPERTY_ATTRIBUTE_MAPPING"
value="GUID=ibm-entryUUID"/>
<extendedProperty>
... ...
</extendedProperty>
</serviceInstance>

3. すべてのサーバーを再起動します。

29.4 組込みLDAPアイデンティティ・ストアへのユーザーの追加

ユーザーを組込みLDAPに追加するには、WebLogic Server管理コンソールを使用するか、またはLDIFファイルとLDAPコマンドを使用します。LDIFファイルを使用すると、WebLogic Server管理コンソールからでは使用できない属性を追加できます。

注意:

組込みLDAPサーバーは、テストや概念実証の目的のみに使用してください。本番用には、Oracle Internet DirectoryやMicrosoft Active Directoryなど、OPSSユーザーおよびロールAPIでサポートされている外部アイデンティティ・ストアを使用することをお薦めします。

Oracle Internet Directoryでは通常、ユーザーはODSMを使用して管理されます(Oracle Fusion Middleware Oracle Internet Directory管理者ガイドのディレクトリ・エントリの管理に関する項を参照してください)。

注意:

アイデンティティ・ストアを外部LDAPに再度関連付けする予定がある場合は、再関連付けの手順(第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照)を先に実行してください。組込みLDAPをOIDや他の外部LDAP実装に再度関連付けする場合、ユーザーやユーザーのアーティファクトは移行できません。したがって、本番環境にユーザーを移行する場合を除き、組込みLDAPにはユーザーを追加しないでください。組込みLDAPは、テスト環境のみで使用することを目的としており、本番環境への移行が可能なステージング環境で使用することは意図していません。

Spacesでは自己登録がサポートされます。Spacesに自己登録した新規ユーザーは、アイデンティティ・ストアに直接追加されます。自己登録の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの自己登録の許可に関する項を参照してください。

注意:

アイデンティティ・ストアへのユーザーの追加は、一般にシステム管理者のタスクであり、アプリケーションレベルの管理者は必要な権限を持っていてもこのタスクを実行できない場合があります。

この項の内容は次のとおりです。

- 第29.4.1項「WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加」

- 第29.4.2項「LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加」

29.4.1 WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加

WebLogic Server管理コンソールから組込みLDAPアイデンティティ・ストアにユーザーを追加する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペイン(図29-9を参照)で、「セキュリティ・レルム」をクリックします。

図29-9 「ドメイン構造」ペイン

「図29-9 「ドメイン構造」ペイン」の説明

「セキュリティ・レルムのサマリー」ペインが表示されます(図29-10を参照)。

図29-10 「セキュリティ・レルムのサマリー」ペイン

「図29-10 「セキュリティ・レルムのサマリー」ペイン」の説明

3. 「名前」列で、ユーザーを追加するレルムをクリックします。
レルムの設定ペインが表示されます(図29-11を参照)。

図29-11 レルムの設定ペイン

「図29-11 レルムの設定ペイン」の説明

4. 「ユーザーとグループ」タブをクリックし、現行ユーザーのリストを表示します。

5. 「新規」をクリックして、新しいユーザーを追加します。

図29-12 「新しいユーザーの作成」ページ

「図29-12 「新しいユーザーの作成」ページ」の説明

6. 「新しいユーザーの作成」ページで、「名前」フィールドに新しいユーザーのログイン名を入力します。
ユーザー名では大/小文字が区別されます。また、ユーザー名は一意である必要があります。カンマ、タブ、および次のカンマ区切りリスト内のその他の文字は使用しないでください。

< >, #, |, &, ?, ( ), { }

7. 「説明」フィールドに、ユーザーの説明(たとえば、ユーザーのフル・ネーム)を入力します。

8. 「プロバイダ」ドロップダウン・メニューからDefaultAuthenticatorを選択します。

9. 「パスワード」フィールドに、ユーザーのパスワードを入力します。
WebLogic認証プロバイダで定義されたユーザーのパスワードは8文字以上です(他のLDAPプロバイダではパスワード長の要件が異なる場合があります)。本番のWebLogicでは、weblogic/weblogicなどのユーザー名とパスワードの組合せは使用しないでください。

10. 「パスワードの確認」フィールドにパスワードを再入力します。

11. 「OK」をクリックして変更を保存し、ユーザーを追加します。
追加したユーザーがユーザー・リストに表示されます。

29.4.2 LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加

LDIFファイルを使用して組込みLDAPアイデンティティ・ストアにユーザーを直接追加する手順は次のとおりです。LDIFファイルを使用すると、WebLogic Server管理コンソールからは使用できない追加のユーザー属性を指定できます。組込みLDAPサーバーはLDAPに準拠したサーバーであるため、LDAPコマンドを使用してユーザーの追加や変更ができます。また、ディレクトリを検索することもできます。これは、ユーザー・アカウントをエクスポートおよびインポートする場合に役立ちます。

LDIFファイルを使用して組込みLDAPにユーザーを追加するには、次のタスクを実行する必要があります。

- 外部LDAPアクセスの有効化

- LDIFファイルの作成

- ユーザーの追加

外部LDAPアクセスの有効化

LDAPアクセス資格証明は、WebLogic Serverのインストール時にランダム値として設定され、config.xmlファイルに暗号化されます。外部LDAPアクセスを有効にするには、組込みLDAPのアクセス資格証明をリセットする必要があります。

組込みLDAPのアクセス資格証明をリセットする手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペイン(図29-13を参照)で、wc_domainをクリックします。

図29-13 「ドメイン構造」ペイン(wc_domain)

「図29-13 「ドメイン構造」ペイン(wc_domain)」の説明

3. wc_domainの「設定」ペインで「セキュリティ」タブをクリックし、「組込みLDAP」タブをクリックします。
wc_domainの「設定」ペインに組込みLDAPが表示されます(図29-14を参照)。

図29-14 「組込みLDAP」設定が表示された「設定」ペイン

「図29-14 「組込みLDAP」設定が表示された「設定」ペイン」の説明

4. 「資格証明」フィールドに新しいパスワードを入力し、「資格証明の確認」フィールドに再度入力します。

5. 「保存」をクリックして、設定を保存します。

6. WebLogicサーバーを再起動します。
これを行った後は、次の値を使用してLDAPサーバーにアクセスできるようになります。

- 管理アクセスのDN値は"cn=Admin"です。

- パスワードは「資格証明」フィールドに入力した値です。

- ポートは管理ポートと同じポート(デフォルトは7001)です。

LDIFファイルの作成

LDIFファイルは任意のテキスト・エディタで作成できます。また、LDIFファイルには、組込みLDAPディレクトリに該当する任意の属性を含めることができます。WebLogic Serverの組込みLDAPサーバーのデフォルトでサポートされているobjectclassesは次のとおりです。

- person

- inetOrgPerson

- organizationalPerson

- wlsUser

組込みLDAPサーバーと正常に対話するには、ディレクトリ情報ツリー(DIT)のデフォルト・レイアウトを理解しておく必要があります。組込みLDAPディレクトリのデフォルト・レイアウトを図29-15に示します。

図29-15 組込みLDAPのディレクトリ情報ツリー

「図29-15 組込みLDAPのディレクトリ情報ツリー」の説明

注意:

組込みLDAPのディレクトリ・ツリーでは、ユーザー・エントリのネーミング属性は「uid」です。これは、Oracle Internet Directory (OID)のデフォルトの構成(ネーミング属性は「cn」)とは異なります。また、このツリーにおけるユーザーの場所は「ou=people,ou=myrealm,dc=wc_domain」です。

次の例は、Spacesユーザーのプロフィール画面に表示される属性が指定されたLDIFファイルを示しています。

dn: uid=john.doe,ou=people,ou=myrealm,dc=wc_domain
description: John Doe
cn: john.doe
uid: john.doe
sn: Doe
objectclass: wlsUser
objectclass: organizationalperson
objectclass: inetOrgPerson
objectclass: person
objectclass: top
userpassword: welcome1
displayName: John Doe
employeeNumber: 12345
employeeType: Regular
givenName: John
homePhone: 650-555-1212
mail: john.doe@example.com
title: Manager
manager: uid=mary.jones,ou=people,ou=myrealm,dc=wc_domain
preferredLanguage: en
departmentNumber: tools
facsimiletelephonenumber: 650-555-1200
mobile: 650-500-1200
pager: 650-400-1200
telephoneNumber: 650-506-1212
postaladdress: 200 Oracle Parkway
l: Redwood Shores
homepostaladdress: 123 Main St., Anytown 12345

複数のユーザー・エントリを含むファイルを作成するには、前述の行を必要な回数だけレプリケートし、エントリ間に空白行を入れます。

注意:

Spacesのユーザー・プロファイルには、Oracle Internet Directoryのみで使用可能な属性が含まれます。これには、orclUserV2オブジェクト・クラスの次の属性があります。

- orclTimeZone

- orclDateOfBirth

- maidenName

これらの属性は、組込みLDAPアイデンティティ・ストアには追加できません。

ユーザーの追加

次の例では、ldappaddコマンドを使用しています。このコマンドは、Oracle Internet Directoryサーバーに付属のLDAPコマンドライン・ユーティリティに含まれます。ldappaddコマンドの使用方法の詳細は、Oracle Identity Managementユーザー・リファレンスのOracle Internet Directoryデータ管理ツールに関する項を参照してください。

ldapadd -h weblogichost.example.com -p 7001 -D cn=Admin -w password -v -f newuser.ldif

add description:
John Doe
add cn:
john.doe
add uid:
john.doe
add sn:
Doe
add objectclass:
wlsUser
organizationalperson
inetOrgPerson
person
top
add userpassword:
password
add displayname:
John Doe
add employeenumber:
12345
add employeetype:
Regular
add givenname:
John
add homephone:
650-555-1212
add mail:
john.doe@example.com
add title:
Manager
add manager:
uid=mary.jones,ou=people,ou=myrealm,dc=wc_domain
add preferredlanguage:
en
add departmentnumber:
tools
add facsimiletelephonenumber:
650-555-1200
add mobile:
650-500-1200
add pager:
650-400-1200
add telephonenumber:
650-506-1212
add postaladdress:
200 Oracle Parkway
add l:
Redwood Shores
add homepostaladdress:
123 Main St., Anytown 12345
adding new entry uid=john.doe,ou=people,ou=myrealm,dc=wc_domain
modify complete

29.5 外部LDAPサーバーへの管理者アカウントの移行

外部LDAPサーバーを使用するようにドメインを構成する場合、必要に応じてFusion Middleware管理者アカウント(デフォルトではweblogic)をLDAPサーバーに移行することもできます。

Fusion Middleware管理者アカウントまたはLDAP内の他の適切なユーザーが「管理者」というLDAPグループに属する場合、このアカウントは、サーバーを管理するための権限を満たしています。また、DefaultAuthenticatorプロバイダを認証プロバイダのリストから削除できます。この場合、すべてのユーザー(管理者アカウントを含む)は外部LDAPに対して認証されます。

weblogic(デフォルト)ユーザーを外部LDAPディレクトリに作成できない場合は、2つのオプションがあります。次を実行できます。

- DefaultAuthenticatorプロバイダを維持したまま、weblogicアカウントとローカルの組込みLDAPサーバーをWebLogic Serverで使用し、WebLogic Server管理コンソールからサーバーの起動と停止および他の管理者用操作を行います。DefaultAuthenticatorを維持する場合は、DefaultAuthenticationプロバイダの制御フラグがSUFFICIENTに設定されていることを確認してください。このオプションを選択する場合は、第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」の手順に従って、追加の手順を実行する必要があります。

注意:

DefaultAuthenticatorからweblogicユーザー・アカウントを使用する場合は、Spacesアプリケーションにアクセスする際にこのアカウントを使用しないでください。アプリケーション・コードから外部LDAPストアのユーザーを検索できなくなります。

- DefaultAuthenticatorを削除し、管理者用操作(サーバーの起動や停止など)で使用する有効なユーザー・アカウントを「管理者」グループに含めます。その他の名前のグループに含める場合は、そのグループにOIDまたは他の外部LDAPでドメインの管理を許可されたユーザーのリストが含まれている必要があります。「管理者」以外の名前を使用する場合は、WebLogic Serverグローバル管理者ロールの定義でグループ名を更新する必要があります。デフォルトでは、これは「管理者」というエンタープライズ・グループのメンバーシップとして定義されています。管理者グループ名の変更の詳細は、第29.5.2項「管理者グループ名の変更」を参照してください。

29.5.1 外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行

Oracle WebCenter Portalのディスカッション・サーバーをインストールしており、管理者アカウントを外部LDAPに移行しない場合(第29.5項「外部LDAPサーバーへの管理者アカウントの移行」を参照)、WebLogic Serverでオーセンティケータの順序を変更する前に、ディスカッション・サーバーで新しい管理者アカウントを識別するために追加の手順を実行する必要があります。

1. ディスカッション・サーバーの管理者にするユーザー・アカウントを外部LDAPから選択します。

2. 外部LDAPから選択したユーザー・アカウントに一致する管理者アカウントをDefaultAuthenticator(組込みLDAP)に作成します。組込みLDAPと外部LDAPサーバーのアカウント名は一致する必要があります。
組込みDAPへのユーザーの追加の詳細は、第29.4項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

3. Oracle WebCenter Portalのディスカッション・サーバー管理コンソールに起動アイデンティティ・アカウント(weblogic)でログインし、次にアクセスします。

http://host:port/owc_discussions/admin

hostとportはWLS_Services管理対象サーバーのホストIDとポート番号です。

4. 「設定」→「管理者/モデレータ」をクリックします。
「管理者およびモデレータ」ページが表示されます(図29-16を参照)。

図29-16 「管理者およびモデレータ」ページ

「図29-16 「管理者およびモデレータ」ページ」の説明

5. 「新規権限の付与」をクリックします。
「新規権限の付与」ペインが表示されます(図29-17を参照)。

図29-17 「新規権限の付与」ペイン

「図29-17 「新規権限の付与」ペイン」の説明

6. 作成したユーザーにシステム管理者権限を付与します(図29-18を参照)。

図29-18 「新規権限の付与」ペインでの新規ユーザーの入力

「図29-18 「新規権限の付与」ペインでの新規ユーザーの入力」の説明

7. 「System」→「システム・プロパティ」をクリックします。
「Jiveプロパティ」ページが表示されます(図29-19を参照)。

図29-19 「Jiveプロパティ」ページ

「図29-19 「Jiveプロパティ」ページ」の説明

8. 赤でマークされたプロパティが追加され、図29-19のように設定されていることを確認します。

9. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

10. 「ドメイン構造」ペイン(図29-20を参照)で、「セキュリティ・レルム」をクリックします。

図29-20 「ドメイン構造」ペイン

「図29-20 「ドメイン構造」ペイン」の説明

「セキュリティ・レルムのサマリー」ペインが表示されます(図29-21を参照)。

図29-21 「セキュリティ・レルムのサマリー」ペイン

「図29-21 「セキュリティ・レルムのサマリー」ペイン」の説明

11. 「名前」列で、管理者グループ名を変更するレルムをクリックします。
レルムの設定ペインが表示されます(図29-22を参照)。

図29-22 レルムの設定ペイン

「図29-22 レルムの設定ペイン」の説明

12. 「プロバイダ」タブを選択し、「認証」サブタブを選択したら、外部LDAPのオーセンティケータがリストの先頭に表示されるように認証プロバイダの順序を変更します(図29-23の例を参照)。

図29-23 認証プロバイダの順序変更後の「プロバイダ」タブ

「図29-23 認証プロバイダの順序変更後の「プロバイダ」タブ」の説明

13. ドメインの管理サーバーとディスカッション・サーバーを再起動します。

29.5.2 管理者グループ名の変更

LDAPサーバーにドメインの管理権限を持つユーザーが含まれる場合、そのサーバーで有効な他のエンタープライズ・ロールにグループ名を変更できます。これにより、エンタープライズ内で特定のドメインの管理を委任できます。様々な管理グループをディレクトリに作成し、対応するドメインで管理者を定義する際に適切なグループが使用されるよう構成できます。

次の例のLDIFファイルでは、Oracle Internet Directoryに管理グループを作成します。

dn: cn=wc_domain_Admin,cn=groups,dc=example,dc=com
cn: wc_domain_Admin
uniquemember: cn=joe.admin,cn=users,dc=example,dc=com
owner: cn=orcladmin
displayname: WebLogic Administrators Group
description: WebLogic Administrators Group
objectclass: orclgroup
objectclass: groupofuniquenames

このグループの作成後に、WebLogic Server管理コンソールを使用してWebLogic Serverグローバル管理ロールのロール定義を更新する必要があります。

WebLogic Serverグローバル管理ロールのロール定義を更新する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペイン(図29-24を参照)で、「セキュリティ・レルム」をクリックします。

図29-24 「ドメイン構造」ペイン

「図29-24 「ドメイン構造」ペイン」の説明

「セキュリティ・レルムのサマリー」ペインが表示されます(図29-25を参照)。

図29-25 「セキュリティ・レルムのサマリー」ペイン

「図29-25 「セキュリティ・レルムのサマリー」ペイン」の説明

3. 「名前」列で、管理者グループ名を変更するレルムをクリックします。
レルムの設定ペインが表示されます(図29-26を参照)。

図29-26 レルムの設定ペイン

「図29-26 レルムの設定ペイン」の説明

4. 「ロールとポリシー」タブを開き、「レルム・ロール」サブタブを開きます。
「レルム・ロール」設定ペインが表示されます(図29-27を参照)。

図29-27 「レルム・ロール」設定ペイン

「図29-27 「レルム・ロール」設定ペイン」の説明

5. 「グローバル・ロール」ノードを開き、「ロール」ノードを開きます。

6. Adminロールの「ロール条件の表示」をクリックします。
「グローバル・ロールの編集」ページが表示されます(図29-28を参照)。

図29-28 「グローバル・ロールの編集」ページ

「図29-28 「グローバル・ロールの編集」ページ」の説明

デフォルトでは、Oracle Internet Directory (または他の構成済アイデンティティ・ストア)のAdministratorsグループにはWebLogic Serverで管理者ロールを持つユーザーが定義されています。

7. 「条件の追加」をクリックして、別のグループ名を追加します。
「グローバル・ロールの編集」ページに「述部リスト」が表示されます(図29-29を参照)。

図29-29 「グローバル・ロールの編集」ページの「述部リスト」

「図29-29 「グローバル・ロールの編集」ページの「述部リスト」」の説明

8. 「述部リスト」からGroupを選択し、「次へ」をクリックします。
「グローバル・ロールの編集」ページに「引数」が表示されます(図29-30を参照)。

図29-30 「グローバル・ロールの編集」ページの「引数」

「図29-30 「グローバル・ロールの編集」ページの「引数」」の説明

9. 新規管理者グループの名前を入力して、「追加」をクリックします。

10. 選択した新規管理者グループを残したまま既存の管理者グループを削除するには、そのグループを選択して「削除」をクリックします。

11. 「終了」をクリックして、変更を保存します。
この変更を行うと、指定した新規グループのすべてのメンバーにWebLogic Serverの管理権限が付与されます。

29.6 Oracle Content ServerとSpacesでアイデンティティ・ストアLDAPサーバーを共有するための構成

Oracle Content Server (OCS)は、Oracle Spacesと同じアイデンティティ・ストアLDAPサーバーを使用するように構成する必要があります。OCSの構成の詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の第11章「コンテンツ・リポジトリの管理」およびLDAPアイデンティティ・ストア・サービスの構成に関する項を参照してください。

29.7 libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約

複数のアイデンティティ・ストアを使用するサイトでは、libOVDを使用することによりユーザー・プロファイル情報を集約できます。次の2つのシナリオの構成手順を説明します。

- それぞれに完全なユーザー・プロファイル情報が存在する個別のアイデンティティ・ストアでユーザーを有効にする場合。

- それぞれに部分的な属性が存在する2つのアイデンティティ・ストアで同一ユーザーを有効にする場合。

注意:

Active Directoryによる自己登録をサポートする場合は、第28.3.3項「Active Directoryを使用してSpacesを構成するとユーザーが自己登録できない」に記載されているトラブルシューティングを必ず参照してください。

この項の内容は次のとおりです。

- 第29.7.1項「アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成」

- 第29.7.2項「アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成」

- 第29.7.3項「単一オーセンティケータの復元」

29.7.1 アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成

各アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合にlibOVDを構成する手順は次のとおりです。

1. 構成するアイデンティティ・ストアのWLS管理コンソールで必要なオーセンティケータを作成し、ドメインのWeblogic管理サーバーおよび管理対象サーバーを再起動します。または、jps-config.xmlでアイデンティティ・ストア情報を手動で構成することもできます。

2. アイデンティティ・ストア・サービス・インスタンスをjps-config.xmlで更新し、値がtrueであるvirtualizeプロパティを追加します。これは手動でjps-config.xmlファイルを編集するか、Fusion Middleware Controlを使用して実行できます。

3. WebCenter Portalを使用すると、ユーザーは自己登録が可能です。これにより、新しいユーザーまたはグループがアイデンティティ・ストアに作成されます。複数のアイデンティティ・ストアが使用されるため、ユーザー作成ベースおよびグループ作成ベースをjps-config.xmlで明示的に指定する必要があります。この手順は、jps-config.xmlを直接編集して行う必要があります。
構成後のjps-config.xmlファイルは、次の例のようになります。

<serviceInstance provider="idstore.ldap.provider" name="idstore.ldap">
<property value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"
name="idstore.config.provider"/>
<property value="oracle.security.idm.providers.stdldap.JNDIPool"
name="CONNECTION_POOL_CLASS"/>
<property value="true" name="virtualize"/>
<extendedProperty>
<name>user.create.bases</name>
<values>
<value>ou=people,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.create.bases</name>
<values>
<value>ou=groups,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
</serviceInstance>

ユーザー作成ベース「ou=people,ou=myrealm,dc=wc_domain」およびグループ作成ベース「ou=groups,ou=myrealm,dc=wc_domain」は実際の値に置き換えてください。

29.7.2 アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成

各アイデンティティ・ストアに部分的なユーザー・プロファイルのみが存在する場合にlibOVDを構成する手順は次のとおりです。

1. 構成するアイデンティティ・ストアのWLS管理コンソールで必要なオーセンティケータを作成し、ドメインのWeblogic管理サーバーおよび管理対象サーバーを再起動します。または、jps-config.xmlでアイデンティティ・ストア情報を手動で構成することもできます。

2. アイデンティティ・ストア・サービス・インスタンスをjps-config.xmlで更新し、値がtrueであるvirtualizeプロパティを追加します。これは手動でjps-config.xmlファイルを編集するか、Fusion Middleware Controlを使用して実行できます。

3. WebCenter Portalを使用すると、ユーザーは自己登録が可能です。これにより、新しいユーザーまたはグループがアイデンティティ・ストアに作成されます。複数のアイデンティティ・ストアが使用されるため、ユーザー作成ベースおよびグループ作成ベースをjps-config.xmlで明示的に指定する必要があります。この手順は、jps-config.xmlを直接編集して行う必要があります。
構成後のjps-config.xmlファイルは、次の例のようになります。

<serviceInstance provider="idstore.ldap.provider" name="idstore.ldap">
<property value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"
name="idstore.config.provider"/>
<property value="oracle.security.idm.providers.stdldap.JNDIPool"
name="CONNECTION_POOL_CLASS"/>
<property value="true" name="virtualize"/>

<extendedProperty>
<name>user.create.bases</name>
<values>
<value>ou=people,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.create.bases</name>
<values>
<value>ou=groups,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
</serviceInstance>

前述の例の「ou=people,ou=myrealm,dc=wc_domain」および「ou=groups,ou=myrealm,dc=wc_domain」はそれぞれ、ユーザー作成ベースとグループ作成ベースです。構成時には実際の値に置き換えてください。

4. 次のOVD WLSTコマンドを実行して、アイデンティティ・ストアの結合アダプタを構成します。$MWHOME/oracle_common/common/binに移動してwlst.sh (Windowsの場合はwlst.cmd)を起動すると、WLSTプロンプトが表示されます。Weblogic管理サーバーに接続して、次のWLSTコマンドを実行します。

createJoinAdapter(adapterName="<Join Adapter Name>",  root="<Namespace>", primaryAdapter="<Primary adapter Name>")

addJoinRule(adapterName="<Join Adapter Name>", secondary="<Secondary Adapter Name>", condition="<Join Condition>")

他にもセカンダリ・アイデンティティ・ストアがある場合は、それぞれのセカンダリ・アイデンティティ・ストアに対してaddJoinRuleコマンドを実行します。

modifyLDAPAdapter(adapterName="<AuthenticatorName>", attribute="Visible", value="Internal")

構成した各アイデンティティ・ストアに対して前述のmodifyLDAPAdapterコマンドを実行します。

例

オーセンティケータ1:

この例では、それぞれに部分的な属性が存在する2つのアイデンティティ・ストアで、同じユーザーが有効になります。たとえば、ADがプライマリ・ストアで、OIDがセカンダリ・ストアです。

オーセンティケータ名: AD

ユーザー・ベース: cn=users,dc=acme,dc=com

オーセンティケータ2:

オーセンティケータ名: OID

ユーザー・ベース: cn=users,dc=oid,dc=com

プライマリ・アダプタのネームスペースに対応するuser.create.basesとgroup.create.basesを指定して、前述の手順1から3を実行します。

次のWLSTコマンドを実行します。

createJoinAdapter(adapterName="JoinAdapter1", root="dc=acme,dc=com", primaryAdapter="AD")
addJoinRule(adapterName="JoinAdapter1", secondary="OID", condition="uid=cn")

「uid=cn」は前述の例の結合条件です。これは、セカンダリ・アイデンティティ・ストア(OID)のユーザーのuid値とプライマリ・アイデンティティ・ストア(AD)のユーザーのcn値が一致した場合に、属性が結合されることを示します。

modifyLDAPAdapter(adapterName="OID", attribute="Visible", value="Internal")
modifyLDAPAdapter(adapterName="AD", attribute="Visible", value="Internal")

WebLogic管理サーバーと管理対象サーバーを再起動します。

29.7.3 単一オーセンティケータの復元

単一オーセンティケータを復元するには結合アダプタ・ルールを削除します。これにより、第29.7.2項「アイデンティティ・ストアに部分的なユーザー・プロファイルが含まれる場合のlibOVDの構成」で実行した構成が取り消されます。

結合アダプタ・ルールを削除するには、Weblogic管理サーバーに接続して、次のWLSTコマンドを実行します。

deleteAdapter(adapterName="JoinAdapter1")
modifyLDAPAdapter(adapterName="oid auth", attribute="Visible", value="Yes")
modifyLDAPAdapter(adapterName="AD", attribute="Visible", value="Yes")

WebLogic管理サーバーと管理対象サーバーを再起動し、両方のアイデンティティ・ストアのユーザーがログインできることを確認します。

29.8 Spacesアプリケーション用の動的ロールの構成

この項では、動的ロールをSpaces向けに構成する方法を説明します。

この項の内容は次のとおりです。

- 第29.8.1項「動的ロールの構成の概要」

- 第29.8.2項「動的ロールの構成の前提条件」

- 第29.8.3項「OVDプラグインのインストール」

- 第29.8.4項「動的ロールの構成」

29.8.1 動的ロールの構成の概要

静的ロールの場合、メンバーシップ・リレーションシップに対するロールは静的です。このリレーションシップはプロビジョニング時に確立され、確立後にユーザーがログインすると、そのユーザーが直接的なメンバーであるロール、またはエンタープライズ・グループに基づいた間接的なメンバーであるロールがすべてサブジェクトに移入されます。

動的ロールはルールベースのロール・メンバーシップを提供します。アプリケーション・ロールへのメンバーシップは動的グループを介して提供されます。動的グループの定義にはユーザー・プロファイル属性の制約と日時を含めることができます。これによりアプリケーションへの柔軟なアクセスが可能になります。たとえば、移行時やメンテナンス期間中のみに、アプリケーションに対してユーザーがアクセスできるようにすることができます。その際、ユーザーに対して明示的にアクセス権を付与する必要はありません。セッション属性またはリクエスト属性に基づくルールは、このリリースではサポートされていません。

Oracle Entitlement Server (OES) 10gでは、動的ロールを制約付きのロールとして定義できます。OESで定義されるロールは、OVDプラグインを介してユーザーのエンタープライズ・グループ・プリンシパルに追加されます。ユーザーがログインすると、ユーザーのサブジェクトに動的グループ・プリンシパルを格納するかどうかを判断するためにポリシー・ルールが評価されます。図29-31に、OESとOVDプラグインで構成されたトポロジのログイン・プロセスを示します。

図29-31 ログイン・プロセス

「図29-31 ログイン・プロセス」の説明

図29-32に、OESとOVDプラグインで構成されたトポロジの動的グループ問合せで行われる処理を示します。

図29-32 グループ問合せ

「図29-32 グループ問合せ」の説明

29.8.2 動的ロールの構成の前提条件

OVDプラグインをインストールして構成する前に、Oracle Internet Directory (OID)、Oracle Virtual Directory (OVD) 11gおよびOracle Entitlement Server (OES) 10gをインストールして構成しておく必要があります。現時点で、OVDプラグインはOES 11gでは動作保証されていません。

OIDおよびOVDはOracle Identity Management 11gスイートの一部です。それらをまだインストールしていない場合はインストールします(Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのInstalling and Configuring Oracle Identity Management (11.1.1.6.0)のインストールと構成に関する項を参照してください)。config.shを実行してOVDを構成します(Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOracle Virtual Directory (OVD)の構成に関する項を参照してください)。

RMI-SSMと最新の累積パッチを使用してOESをインストールします(SSMのインストールおよび構成ガイドのリモートSSMとプロキシの構成に関する項を参照してください)。

また、WebCenter Portalのパーソナライズに基づいて制約を組み込む予定がある場合は、第20章「WebCenter Portalのパーソナライズの管理」の説明に従って、パーソナライズ・サーバーのインストールと構成も行う必要があります。

29.8.3 OVDプラグインのインストール

Oracle Virtual Directory (OVD)はOracle Identity Management製品スイートの一部です。OVDを使用すると、複数の異機種間データ・ソースは、WebCenter PortalのLDAPクライアントから使用可能な1つの統合ビューとして提供されるため、これらのデータ・ソースの統合に関する問題を簡単に解決できます。OVDを経由することにより、Spacesが使用できる方法でOVDカスタム・アダプタを使用して、OESのデータを公開できます。このアダプタは、LDAP以外のデータをLDAPのようなツリー構造で表現できます。カスタム・アダプタの機能は、アダプタにアタッチ可能なプラグインに含まれています。

OVDプラグインをインストールする手順は次のとおりです。

1. 次の場所からoes-ovd-plugin.zipファイルをダウンロードします。

http://download.oracle.com/otndocs/tech/webcenter/files/oes-ovd-plugin.zip

2. oes-ovd-plugin.zipファイルのコピーを作成します。

3. OVDをインストールしたplugins/libディレクトリ(例: asinst_1/OVD/ovd1/plugins/lib)に移動します。

4. oes-ovd-plugin.zipファイルを解凍します。

5. webcenterNames.xmlをインスタンス・ホーム(例: <ORACLE_HOME>/asinst_1)にコピーします。

6. 次のディレクトリを作成します。

mkdir pdpproxy
mkdir keys

7. OESの次のjarをOES/rmi-ssmインストール・ディレクトリからlibディレクトリにコピーします。

EccpressoCore.jar
antlr.jar
api.jar
asi_classes.jar
asitools.jar
commons-pool-1.3.jar
connector.jar
framework.jar
jsafeFIPS.jar
jsafeJCEFIPS.jar
kodo-runtime.jar
log4j.jar
managementapi.jar
orawsdl14.jar
rmi-ssm.jar
rmi-stubs.jar
rmi-types.jar
ssladapter.jar
sslplus.jar
webservice.jar
webserviceclient.jar
webservices.jar
xbean.jar

8. 作成したkeysディレクトリに移動し、このディレクトリにOESインストール(ales32-shared/keysディレクトリ)のすべてのキーをコピーします。

9. 作成したpdpproxyディレクトリに移動し、PDP構成プロパティ・ファイルをOES (rmi-ssm/pdpproxy/PDPProxyConfiguration.properties)からコピーします。

10. 次のコマンドを使用してOVDプロセスを再起動します。

./opmnctl stopall startall

11. 制約を定義する際にパーソナライズを使用する場合は、次のようにp13nattributeRetrieverをインストールします。

1. <WebCenter Home>/webcenter/modules/oracle.webcenter.framework_11.1.1/attribute-retriever.jarファイルを見つけます。

2. OESインストールのrmi-ssm/lib/providersディレクトリを見つけて、そのディレクトリにattribute-retriever.jarファイルをコピーします。

3. rmi-ssmを再起動します。

29.8.4 動的ロールの構成

この項では、OESおよびOVDプラグインを使用して動的ロールをサポートするようにSpaces環境を構成する方法について説明します。この項の構成手順を実行する前に、前提条件のアプリケーション(第29.8.2項「動的ロールの構成の前提条件」を参照)とOVDプラグイン(第29.8.3項「OVDプラグインのインストール」を参照)をインストールしておく必要があります。

この項の内容は次のとおりです。

- 第29.8.4.1項「OESの構成」

- 第29.8.4.2項「OVDプラグインの構成」

- 第29.8.4.3項「パーソナライズ属性の構成」

- 第29.8.4.4項「Spacesアプリケーションで動的ロールを使用するための構成」

29.8.4.1 OESの構成

Spacesで使用する動的ロールはすべて、単一のアンブレラ・リソースとアクションに定義する必要があります。次の手順では、WebCenterApp/WebCenterResourceをアンブレラ・リソース、browseをアクションとして使用します。動的ロールを作成すると、そのロールにはロール・マッピング・ポリシーによってリソースへの参照権限が付与されます。ロール・マッピング・ポリシーには、アイデンティティ・ストアまたはパーソナライズ属性に基づいて制約を追加することもできます。

動的グループにOESを構成する手順は次のとおりです。

1. ブラウザを開いて、管理者としてOESコンソールにログオンします。

https://<host>:<port>/asi

2. 「Administration Console」ノードで 「Resources」をクリックすると、現在定義されているリソースのリストが「Resources」ページに表示されます(図29-33を参照)。

図29-33 「Resources」ページ

「図29-33 「Resources」ページ」の説明

3. リソース・ルートを作成するには、javaapi_appノードを右クリックして「Add Resource」を選択し、「Create Resource」ダイアログを表示します。リソースの名前にWebCenterAppと入力し、「Type」でBindingを選択します(図29-34を参照)。

図29-34 ルート・リソースの作成

「図29-34 ルート・リソースの作成」の説明

4. WebCenterAppを右クリックして、その下にWebCenterResourceという名前の新しいリソースを作成し、「Type」でResourceを選択します(図29-35を参照)。

図29-35 リソースの作成

「図29-35 リソースの作成」の説明

5. 「Resources」ノードの下で「Privileges」をクリックし、「Privileges」ページを表示します。

6. 「New」をクリックしてbrowseという名前のアクションを作成します(図29-36を参照)。

図29-36 アクションの作成

「図29-36 アクションの作成」の説明

7. 「Identity」ノードを開き、「Roles」をクリックして「Roles」ページを表示します。

8. 「New」をクリックし、「Create Role」ダイアログを使用して動的ロールを作成します(図29-37を参照)。

図29-37 動的ロールの作成

「図29-37 動的ロールの作成」の説明

9. 「Resources」ノードを開き、「Attributes」をクリックして「Resource Attributes」ページを表示します。

10. 「New」をクリックし、「Create Resource Attribute」ダイアログで、制約で使用されるアイデンティティ・ストア属性と同じ名前のリソース属性(例: business_email、timezone)を作成します(図29-38を参照)。制約でパーソナライズ属性を使用する場合は、それらの属性も作成する必要があります。

図29-38 リソース属性の作成

「図29-38 リソース属性の作成」の説明

11. 「Policy」ノードを開き、「Role Mapping Policies」をクリックして「Role Mapping Policies」ページを表示します。

12. 「New」をクリックして「Create Role Mapping Policy」ダイアログを表示し、アイデンティティ・ストア属性または組込みシステム属性(hour、dayなど)を使用してロール・マッピング・ポリシーと制約を作成します(図29-39を参照)。

図29-39 ロール・マッピング・ポリシーの作成

「図29-39 ロール・マッピング・ポリシーの作成」の説明

13. 「Policy」ノードの下で、「Authorization Policies」をクリックして「Authorization Policies」ページを表示します。

14. 「New」をクリックし、「Create Authorization Policies」ダイアログを使用して新しい認可ポリシーを作成するか、認可ポリシーのサマリーからポリシーを選択して「Edit」 をクリックし、ポリシーのリソースやポリシー・サブジェクトなどの詳細を編集および入力します(図29-40を参照)。

図29-40 認可ポリシーの作成

「図29-40 認可ポリシーの作成」の説明

15. 「Service Control Managers」の下で「Authorization」ノードを開き、「ASIAuthorizationProvider」をクリックしてから 「Attribute Retrievers」タブを開きます(図29-41を参照)。

図29-41 「Attribute Retrievers」タブ

「図29-41 「Attribute Retrievers」タブ」の説明

16. 「Configure a new Custom Attribute Retriever」をクリックし、WebCenterP13nAttributeRetriever (oracle.webcenter.security.internal.plugins.oes.attributeretriever.WebCenterP13nAttributeRetriever)という名前のカスタム属性リトリバを作成して、図29-42のようにクラスの詳細を追加します。

図29-42 カスタム属性リトリバの作成

「図29-42 カスタム属性リトリバの作成」の説明

17. 「Service Control Managers」の下で「Role Mapping」ノードを開き、「ASIRoleMapperProvider」をクリックして「Bindings」タブを開きます。WebCenterAppリソースを認可プロバイダにバインドします(図29-43を参照)。

図29-43 認可プロバイダへのリソースのバインド

「図29-43 認可プロバイダへのリソースのバインド」の説明

18. 「Deployment」をクリックし、「Configuration」タブを開いて構成の変更を配布します(図29-44を参照)。

図29-44 構成の変更の配布

「図29-44 構成の変更の配布」の説明

19. 「Policy」タブを開いて、ポリシーの変更を配布します(図29-45を参照)。

図29-45 ポリシーの変更の配布

「図29-45 ポリシーの変更の配布」の説明

29.8.4.2 OVDプラグインの構成

この項では、OVDプラグインの構成方法について説明します。

OVDプラグインを構成する手順は次のとおりです。

1. plugins/lib/pdpproxyディレクトリに移動し、ファイルPDPProxyConfiguration.propertiesを編集して、SSM構成ID、OESホスト名、RMISポートおよびトラスト・ストアの場所を指定します。値の例を次に示します。

SSMConfigID=JK_SM1
PDPTransport=RMI
PDPAddress=rmis://example.com:9300 (the use of SSL port is always recommended)
TrustStore=<OID_HOME>/asinst_1/OVD/ovd1/plugins/lib/keys/DemoTrust.jks

2. ファイル./config/OPMN/opmn/opmn.xmlを開いて、次のサンプルに示すように、正しいOVDホームパスを指定してOVDプロセスのjava-optionsとjava-classpathを変更します。

<data id="java-options" value="-server -Xms256m -Xmx256m  -Dvde.soTimeoutBackend=0 -Didm.oracle.home=$ORACLE_HOME -Dcommon.components.home=$ORACLE_HOME/../oracle_common -Doracle.security.jps.config=$ORACLE_INSTANCE/config/JPS/jps-config-jse.xml -Djavax.net.ssl.trustStore=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/DemoTrust.jks -Dpdp.configuration.properties.location=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/pdpproxy/PDPProxyConfiguration.properties -Dwles.ssl.identityKeyAlias=wles-admin -Dwles.ssl.identityKeyPasswordAlias=wles-admin -Dwles.ssl.identityKeyStore=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/identity.jceks -Dwles.ssl.trustedCAKeyStore=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/trust.jks -Dwles.ssl.passwordFile=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/password.xml -Dwles.ssl.passwordKeyFile=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/password.key"/>

<data id="java-classpath" value="$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/jsafeFIPS.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/jsafeJCEFIPS.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/scmapi.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/sslplus.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/ssladapter.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/asitools.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/webserviceclient.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/EccpressoCore.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/webservice.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/kodo-runtime.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/kodo-runtime.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/commons-pool-1.3.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/oes-ovd-plugin.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/xbean.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/antlr.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/log4j.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/api.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/asi_classes.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/framework.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/rmi-types.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/rmi-ssm.jar:
$ORACLE_HOME/ovd/jlib/vde.jar$:$ORACLE_HOME/jdbc/lib/ojdbc6.jar"/>

3. ブラウザでOracle Directory Service Manager (ODSM)を開きます。

http://host:port/odsm

ODSMポートを確認するには、OIDインストールのopmnctl statusコマンドを使用します。デフォルト・ポートは7005です。

4. LDAP Adapterタイプのアダプタを作成して、LDAPホストおよびポートの詳細を指定します(図29-46のサンプルを参照)。

図29-46 LDAPアダプタの例

「図29-46 LDAPアダプタの例」の説明

5. DNを選択し、DNのマッピング名を指定します。

6. デフォルト以外の属性にマップする必要がある場合は、アダプタの「Plug-ins」タブを開いてUserManagementアダプタを追加します。たとえば、Active DirectoryをOVDのバックエンド・ディレクトリ・サーバーとして使用する場合は、UserManagementアダプタを追加して、次のパラメータ・マッピングを指定します。

<param name="directoryType" value="ActiveDirectory"/>
<param name="mapAttribute" value="orclguid=objectguid"/>
<param name="mapAttribute" value="cn=sAMAccountName"/>
<param name="mapAttribute" value="uniquemember=member"/>
<param name="mapAttribute" value="OESRole=OESRole"/>
<param name="mapObjectclass" value="orclGroup=group"/>
<param name="mapObjectclass" value="groupofurls=group"/>
<param name="mapObjectclass" value="groupofuniquenames=group"/>
<param name="mapObjectclass" value="person=user"/>
<param name="mapRDNAttribute" value="uniquemember=member"/>

UserManagementアダプタの構成の詳細は、Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドのUserManagementプラグインに関する項を参照してください。

7. OES10gUserEntitlementsPluginを追加し、次の例に示すように、すべてのプラグイン・パラメータを追加して、ホストおよびポートの詳細をローカル環境のBLMおよびパーソナライズ(p13n)用に置き換えます。

<param name="ldap_group_basedn" value="cn=Groups,dc=us,dc=oracle,dc=com"/>
<param name="ldap_user_basedn" value="cn=Users,dc=us,dc=oracle,dc=com"/>
<param name="ldap_admin_user" value="cn=Administrator"/>
<param name="oes_admin_user" value="admin"/>
<param name="OrclOVDEncrypted_oes_admin_pass" value="<password>"/>
<param name="oes_config_name" value="JK_SM1"/>
<param name="oes_policy_domain" value="JK_SM1"/>
<param name="oes_resource_action" value="browse"/>
<param name="oes_resource_name" value="WebCenterApp/WebCenterResource"/>
<param name="oes_resource_namespace" value="webcenterResource”/>
<param name="oes_roles_cache_interval" value="180000"/>
<param name="oes_action_namespace" value="webcenterAction"/>
<param name="p13n_admin_user" value="weblogic"/>
<param name="OrclOVDEncrypted_p13n_admin_pass" value="<password>"/>
<param name="oes_blm_host" value="example.com"/>
<param name="oes_blm_port" value="7011"/>
<param name="oes_p13n_index_url" value="example.com/>
<param name="oes_p13n_prop_url" value="example.com"/>
<param name="ldap_eqmatch" value="equalityMatch"/>
<param name="ldap_loginattr" value="sAMAccountName"/>
<param name="ldap_loginattr" value="mail"/>
<param name="ldap_loginattr" value="cn"/>

プラグイン・パラメータとして入力されたパスワードは、暗号化されてサーバーに格納されます。

8. 次のコマンドを使用してOVDプロセスを再起動します。

./opmnctl stopall startall

処理を続ける前に、OVDプロセスの再起動時にエラーが発生していないことを確認します。 エラーが発生している場合は、次のエントリを追加すると、プラグインでロギングをオンにできます。

<INSTANCE_HOME>/config/OVD/ovd1/ovd-logging.xmlovd-logging.xml

<logger name='oracle.webcenter.security.internal.plugins.ovd' level='TRACE:1' useParentHandlers='false'>
<handler name='OVDHandler'/>
</logger>

9. SSL対応のパーソナライズ属性が必要な場合は、パーソナライズ・サーバーの公開鍵を含む証明書をOVDのトラスト・ストアにインポートします。通常、この証明書はJDKのcacertsファイルです。

29.8.4.3 パーソナライズ属性の構成

パーソナライズ属性を制約の一部として使用する場合は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のプロパティ・サービスを使用したネームスペース内のプロパティ・セットの表示の手順に従って属性を構成してください。WebCenter Portalのパーソナライズの詳細は、第20章「WebCenter Portalのパーソナライズの管理」を参照してください。

29.8.4.4 Spacesアプリケーションで動的ロールを使用するための構成

この項では、OES 10gで定義されている動的ロールをSpacesで使用できるようにするための方法を説明します。

デフォルトでは、アイデンティティ・ストアで定義されている静的エンタープライズ・ロールのみがSpacesに適用されます。OES (Oracle Entitlements Server)内で定義されている動的ロールを使用するには、OVDプラグインをオーセンティケータとして追加する必要があります。その後OVDプラグインによって、アイデンティティ・ストアの静的ロールとOESの動的ロールが統合されます。

Spacesで動的ロールを使用するための構成手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「タイプ」がOracle Virtual Directoryのオーセンティケータを追加して、OVD接続の詳細およびグループ・ベースdnとユーザー・ベースdnを指定します。
残りの設定はデフォルト値のままにします。ディレクトリ固有のマッピングを行うには、そのアダプタでUserManagementプラグインを使用する必要があります。UserManagementアダプタの構成の詳細は、Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドのUserManagementプラグインに関する項を参照してください。

3. すべてのサーバーを再起動します。

4. OIDのユーザーとしてSpacesにログオンし、グループ・スペースを作成します。

5. 「メンバーの追加」→「グループ」→「検索」に移動し、メンバーとして使用するエンタープライズ・ロールをグループ・スペースに追加します(図29-47を参照)。
OVDをオーセンティケータとして使用する場合は、動的グループ(OES)と静的グループの両方が表示されるはずです。図29-47では、ESTUsers、DayUsersおよびISTUsersが動的グループで、その他はOIDの静的グループです。

図29-47 スペースへの静的グループおよび動的グループの追加

「図29-47 スペースへの静的グループおよび動的グループの追加」の説明

29.9 Spacesアプリケーション用の動的グループの構成

動的グループとは、動的に移入される静的グループです。動的グループは、ロールに割り当てて、Spaces内で静的グループと同様に使用できます。

Spacesアプリケーション内では、静的グループと動的グループは区別されません。動的グループはすべて、アイデンティティ・ストアに構成され(構成内容は使用するLDAP実装に固有のものになります)、静的グループと同様に公開されます(事実上、動的グループは、静的なメンバー・リストと、動的に決定されるメンバーシップで構成されています)。

グループの動的メンバーシップを定義するには、グループのlabeledURI属性に適切なLDAP問合せフィルタを設定します。問合せフィルタには、グループのメンバーシップを定義するユーザー・セットが定義されています。

Oracle Internet Directoryで動的グループを作成するには、LDIFファイルとldapaddコマンドを使用するか、またはOracle Directory Services Manager (ODSM)を使用します。これら2つのオプションについて、次の各項で説明します。

- 第29.9.1項「LDIFファイルを使用した動的グループの作成」

- 第29.9.2項「Oracle Directory Services Managerを使用した動的グループの作成」

29.9.1 LDIFファイルを使用した動的グループの作成

LDIFファイルを使用して動的グループを作成する手順は次のとおりです。

1. テキスト・エディタでLDIFファイルを作成します。次の例では、デフォルトのユーザー検索ベース内で役職が「Manager」のユーザーをすべて表す動的グループを定義する方法を示します。

例29-1 LDIFファイルを使用した動的グループの定義

dn: cn=managers,cn=portal.070720.104824.056918000,cn=groups,dc=us,dc=oracle,dc=comlabeleduri: ldap://myserver.example.com:12061/cn=users,dc=us,dc=mybiz,dc=com??sub?(title=Manager)description: Dynamic Group of Managerscn: Managersorclisvisible: trueobjectclass: orclDynamicGroupobjectclass: orclGroupobjectclass: topobjectclass: groupOfUniqueNamesdisplayname: Managersowner: cn=fmwadmin,cn=users,dc=us,dc=mybiz,dc=com

注意:

LDAP URLのlabledURI構文はRFC 2255 (http://www.faqs.org/rfcs/rfc2255.html)に定義されています。前述の例は、DN cn=users,dc=us,dc=mybiz,dc=com内で属性title=Managerが設定されているすべてのエントリの検索を表しています。これは、サーバーmyserver.example.comのLDAPポート12061でサブツリー("sub")検索を使用して実行されます。

動的グループは、属性または条件に対して定義できますが、LDAP URLとして表現可能かつlabeledURI属性で定義可能なものに限られます。また、動的グループは、ConnectByアサーションを使用して定義することもできます。このアサーションは、orclDynamicGroupオブジェクト・クラスに含まれます。この代替手段の詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドを参照してください。

2. ファイルを保存してから、ldapaddコマンドを発行してOIDサーバーを更新します。次に例を示します。

例29-2 ldapaddコマンドを使用したOIDの更新

ldapadd -h myserver -p 12061 -D cn=fmwadmin -w mybiz1 –f managers.ldif –v
add labeleduri: ldap://myserver.example.com:12061/cn=users,dc=us,dc=mybiz,dc=com??sub?(title=Manager)
add description:
Dynamic Group of Managers
add cn:
Managers
add orclisvisible:
true
add objectclass:
orclDynamicGroup
orclGroup
top
groupOfUniqueNames
add displayname:
Managers
add owner:
cn=fmwadmin,cn=users,dc=us,dc=mybiz,dc=com
adding new entry cn=managers,cn=portal.070720.104824.056918000,cn=groups,dc=us,dc=mybiz,dc=com
modify complete

29.9.2 Oracle Directory Services Managerを使用した動的グループの作成

ODSMを使用して動的グループを作成する手順は次のとおりです。

1. Oracle Directory Services Manager (ODSM)を起動してOracle Internet Directoryサーバーに接続します。
Oracle Directory Services Managerの起動および使用の詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドのOracle Directory Services Managerの使用に関する項を参照してください。

2. 「移動先」リストで「データ・ブラウザ」を選択します。

3. データ・ブラウザで「新規エントリ」アイコンをクリックします。

4. DNを指定して、オブジェクト・クラスorclDynamicGroupおよびgroupOfUniqueNamesを追加します。

5. 「必須プロパティ」タブで、CN属性を指定します。

6. 「オプション・プロパティ」タブで、labeleduriの属性を指定します。

7. 「OK」をクリックして、動的グループの定義を完了します。

ツリー・ビューをリフレッシュすると、作成した新しいグループが表示されるはずです。ODSMにはグループ・メンバーは表示されません。

29.10 RESTサービス・アイデンティティ・アサータの構成

この項では、RESTサービス用のアイデンティティ・アサータを構成する方法について説明します。WebCenter PortalアプリケーションでRESTサービス(RESTサービスAPIを含む)を使用する場合は、WebCenterドメインのアイデンティティ・ストアにRESTサービス用のアイデンティティ・アサータを構成する必要があります。次の項では、Oracle WebLogic ServerでOPSSトラスト・サービス・インスタンスとアイデンティティ・アサータを構成する方法について説明します。

この項の内容は次のとおりです。

- 第29.10.1項「RESTサービス・インスタンスおよびアイデンティティ・アサータの概要」

- 第29.10.2項「クライアント・アプリケーションの設定」

- 第29.10.3項「WLSトラスト・サービス・アサータの構成」

29.10.1 RESTサービス・インスタンスおよびアイデンティティ・アサータの概要

WebCenter Portalアプリケーションや他のOracle WebLogicアプリケーションでは、それらのアプリケーションで必要な方法でREST APIを使用して情報を表示できますが、そのようなコールは中間層から発信されるため、ユーザーはログイン資格証明を再度入力するよう求められます。これに対処するには、ユーザー・アイデンティティがHTTPヘッダーに伝播され、OPSSトラスト・サービス・アサータによってアサートされるときに境界認証を使用します。

ユーザー・アイデンティティをアプリケーション間で正常に伝幡するには、それらのアプリケーションでトラスト・サービス・インスタンスを正しく構成して使用する必要があります。図29-48に、アイデンティティ伝幡とアサーションに関連する各種コンポーネントを示します。

図29-48 RESTのアイデンティティ伝幡とアサーション

「図29-48 RESTのアイデンティティ伝幡とアサーション」の説明

次に、RESTのアイデンティティ伝幡とアサーションに関連した一連のイベントを示します。

1. エンド・クライアント(ブラウザ、スマートフォン・アプリケーション)は、WebCenter Portalアプリケーションに接続します。

2. アプリケーション・ページは、REST APIからデータを問い合せ、それをもとに独自のUIを構築するため、RESTエンド・ポイントをコールする必要があります。

3. WebCenter Portalアプリケーションは、WebCenter Security API (WCSecurityUtility.issueTrustServiceSecurityToken)をコールして、ユーザー・アイデンティティを安全に伝幡するために使用するトークンを発行します。このトークンはトラスト・サービスの組込みプロバイダを使用して生成されます。生成されたトークンは、トークン・サイズを最適化するために圧縮され、トークンが安全に転送されるようにHTTPヘッダーを使用してBASE64にエンコードされます。

4. WebCenter Portalアプリケーションは、発行されたトークンを受け取り、「Authorization」セキュリティ・ヘッダーに追加します。クライアントは、そのトークンをREST URIに対するコールの一部としてディスパッチします。

5. WebLogic Serverは、特定のトークン・タイプのアイデンティティ・アサータが存在するかどうかを確認します。

6. アイデンティティ・アサータは、トークンを解析して、OPSSトラスト・サービスAPIが使用されていることを確認します。

7. アサータがユーザー名をWLSユーザー名にマップすると、ユーザーのサブジェクトが確立され、RESTアプリケーションにコールが到達します。

8. RESTアプリケーションは、そのユーザーがすでに認証済のユーザーであることを認識し、レスポンスを送信します。WebCenter Portalアプリケーションはレスポンスを使用して、エンド・ユーザーにページを表示します。

29.10.2 クライアント・アプリケーションの設定

この項では、RESTサービス・アイデンティティ・アサータ用にクライアントを構成する方法について説明します。

RESTサービス・アイデンティティ・アサータ用にクライアントを構成する手順は次のとおりです。

1. JDeveloperを使用して、クライアント・アプリケーションを作成します。
クライアント・アプリケーションとしてJSEまたはサーブレット・アプリケーションを作成できます。次の例では、サンプル・クライアント・アプリケーションのスケルトンを示します。

// The authenticated username
// String user = "weblogic";
// URL of the target application
URL url = "http://host:port/destinationApp";
//-----------------------------------------

String b64EncodedToken = WCSecurityUtility.issueTrustServiceSecurityToken()

HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setDoOutput(true);
connection.setReadTimeout(10000);
connection.setRequestProperty("Authorization", AUTH_TYPE_NAME + " " + b64tok);
connection.connect();
BufferedReader rd = new BufferedReader(new InputStreamReader(
connection.getInputStream()));
StringBuilder sb = new StringBuilder();

String line = null;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
connection.disconnect();
System.out.println(sb.toString());

2. キーストアを作成して構成します。
ドメインのキーストアを作成して、アイデンティティ・アサータ用にWebLogic Serverを構成します。クライアント証明書および秘密鍵用のキーストアがまずプロビジョニングされます。このクライアント証明書はエクスポートされ、トラスト・キーストアにインポートされます。

1. キーストアを作成します(第34.1.2.1項「WebCenter Portalドメイン・キーストアの作成」を参照)。

2. キーストアを構成します(第34.1.2.2項「WLSTを使用したキーストアの構成」または第34.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」を参照)。

3. jps-config.xml構成ファイルを編集します。

1. domain_home/config/fmwconfigディレクトリに移動します。

2. テキスト・エディタでjps-config.xmlファイルを開きます。

3. trust.provider.embedded propertySetノードを次のように変更します。

<propertySets>
<propertySet name="trust.provider.embedded">
... existing entries
<property value="orakey" name="trust.aliasName"/>
<property value="orakey" name="trust.issuerName"/>
</propertySet>
</propertySets>

各要素の意味は次のとおりです。

trust.aliasNameは、アイデンティティ・アサータが構成済キーストアで検索する証明書の別名です。アサータはこの証明書を使用して、発行されたトラスト・トークンを検証します。

trust.issuerNameは、トラスト・トークンの発行および署名に使用した秘密鍵をトークン発行者が検索する際に検索される別名です。

4. クライアントとRESTアプリケーションのドメインが異なる場合は、両方のドメインで前述の手順を実行します。

5. すべてのサーバーを再起動します。

29.10.3 WLSトラスト・サービス・アサータの構成

この項では、WebLogic Serverトラスト・サービス・アサータを構成する方法について説明します。

WebLogic Serverトラスト・サービス・アサータを構成する手順は次のとおりです。

1. WebLogic管理コンソールに管理者としてログインします。

2. 「セキュリティ・レルム」→「myrealm」に移動します。

3. 「プロバイダ」タブを開き、「認証」サブタブを開きます。
「新しい認証プロバイダの作成」ページが表示されます。

4. 新しいアサータの「名前」を入力します(例: TrustServiceIdAsserter)。

5. アサータの「タイプ」にTrustServiceIdentityAsserterを選択します。
このアサータは、受信リクエストのトークンをデコードおよび検証するためにトラスト・サービスAPIをコールし、アサートされたサブジェクトを確立する際にユーザー名をWebLogicに渡します。

6. 「OK」をクリックして、変更を保存します。

30 ポリシーおよび資格証明ストアの構成

本番環境のために、ポリシー・ストアを外部LDAP(Oracle Internet Directory 11gR1または10.1.4.3)あるいはデータベースと再度関連付ける必要があります。外部LDAPベースのストアを使用する際は、同じLDAPサーバーを使用するように資格証明ストアとポリシー・ストアを構成する必要があることに注意してください。ただし、アイデンティティ・ストアは、サポートされている他の任意のLDAPサーバーを使用することができ、ポリシー・ストアや資格証明ストアと同じLDAPサーバーを使用する必要はありません。

ポリシーおよび資格証明ストアをOIDと再度関連付けるには、LDAPディレクトリにルート・ノードを作成し、Fusion Middleware Controlを使用して、またはWLSTを使用してコマンドラインから、ポリシーおよび資格証明ストアをOIDサーバーと再度関連付けます。ポリシーおよび資格証明ストアをデータベースと再度関連付けるには、RCUにスキーマとデータベース接続を設定し、WLSTを使用してコマンドラインからポリシーおよび資格証明ストアをデータベースに移行します。

注意:

ポリシー・ストアを再度関連付ける前に、次の関連する構成ファイルを必ずバックアップしてください。

- jps-config.xml

- system-jazn-data.xml

念のため、ドメインの管理サーバーのboot.propertiesファイルもバックアップしてください。

この章の内容は次のとおりです。

- 第30.1項「ルート・ノードの作成」

- 第30.2項「Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け」

- 第30.3項「WLSTを使用した資格証明およびポリシー・ストアの再関連付け」

- 第30.4項「ポリシーおよび資格証明ストアのデータベースとの再関連付け」

- 第30.5項「資格証明の管理」

- 第30.6項「ユーザーおよびアプリケーション・ロールの管理」

- 第30.7項「Spacesアプリケーションにおける招待による自己登録の構成」

- 第30.8項「ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

30.1 ルート・ノードの作成

ポリシーおよび資格証明ストアをOIDと再度関連付ける際の最初のステップでは、LDAPディレクトリでLDIFファイルを作成し、すべてのデータを追加するルート・ノードを追加します。ファイルを作成してノードを追加したら、Fusion Middleware ControlまたはWLSTを使用してストアを再度関連付けます。

ルート・ノードを作成する手順は次のとおりです。

1. LDAPディレクトリでLDIFファイル(例: root.ldif)に次を追加することでルート・ノードを作成します。

dn: cn=root_webcenter_xxxx
cn: root_webcenter_xxxx
objectclass: top
objectclass: orclcontainer

ここでxxxxは、ノードを一意に識別する文字列(サーバー名など)です。

2. LDAPインストール・ディレクトリから次のLDAPコマンドを実行して、このノードをディレクトリに追加します。

OID_ORACLE_HOME/as_1/bin/ldapadd -h ldap_host_name -p ldap_port -D cn=orcladmin -w password -v -f root.ldif

各要素の意味は次のとおりです。

- OID_ORACLE_HOMEはLDAPのインストール先ディレクトリ

- ldap_host_nameはOIDサーバーのホスト名

- ldap_portはOIDサーバーのポート番号

- passwordはOIDサーバーにアクセスするためのパスワード

各ルート・コンテナは一意の名前を持つ必要があることに注意してください。

30.2 Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け

ポリシーおよび資格証明ストアをOracle Internet Directoryに再度関連付ける前に、第30.1項「ルート・ノードの作成」の説明に従って、まずルート・ノードを作成する必要があります。

ポリシーおよび資格証明ストアをOIDサーバーに再度関連付ける手順は次のとおりです。

1. Fusion Middleware Controlを開き、ターゲット・インスタンスにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、該当するドメインをクリックします。
最初にインストールされたときに、SpacesおよびEnterprise Managerはすでに関連付けられており、同じドメイン内にデプロイされています。

3. 「WebLogicドメイン」メニューから「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます(図30-1を参照)。

図30-1 「セキュリティ・プロバイダ構成」ページ

「図30-1 「セキュリティ・プロバイダ構成」ページ」の説明

4. 「セキュリティ・プロバイダ構成」ページで、「ストア・タイプの変更」をクリックして新しいOracle Internet Directoryプロバイダを追加します(または、既存のストアのパラメータを変更したい場合は、ストアを選択して「編集」をクリックします)。
「セキュリティ・ストアの構成」ページが表示されます(図30-2を参照)。

図30-2 「セキュリティ・ストアの構成」ページ

「図30-2 「セキュリティ・ストアの構成」ページ」の説明

5. 「ストア・タイプ」として「Oracle Internet Directory」を選択します。

6. 「LDAPサーバーの詳細」で、Oracle Internet Directoryの「ホスト」の名前とLDAPの「ポート」を入力します。

7. 「接続DN」フィールドをcn=orcladminに設定し、関連付けられたパスワードを「パスワード」フィールドに入力します。

8. 「ルート・ノードの詳細」で、「ルートDN」フィールドを、root.ldifファイルに追加したもの(例: cn=root_webcenter_abcd99)に設定します。必ず、cn=を含めてください。

9. 「OK」をクリックして、再関連付けを開始します。移行後、要求されたらWebLogicサーバーを再起動します。

30.3 WLSTを使用した資格証明およびポリシー・ストアの再関連付け

ポリシーおよび資格証明ストアをOracle Internet Directoryに再度関連付ける前に、第30.1項「ルート・ノードの作成」の説明に従って、まずルート・ノードを作成する必要があります。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

2. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('username>,'password', 'host_id:port')

各要素の意味は次のとおりです。

- usernameは、管理サーバーへのアクセスに使用される管理者のアカウント名です(例: weblogic)。

- passwordは、管理サーバーへのアクセスに使用される管理者のパスワードです(例: weblogic)。

- host_idは、管理サーバーのサーバーIDです(例: example.com)。

- portは、管理サーバーのポート番号です(例: 7001)。

3. reassociateSecurityStoreコマンドを使用して、ポリシーおよび資格証明ストアを再度関連付けます。

reassociateSecurityStore(domain="domain_name", admin="admin_name", password="password",
ldapurl="ldap_uri", servertype="ldap_srvr_type", jpsroot="root_webcenter_xxxx")

各要素の意味は次のとおりです。

- domain_nameには、再関連付けを行うドメイン名を指定します。

- admin_nameには、LDAPサーバー上の管理者のユーザー名を指定します。書式はcn=usrNameです。

- passwordには、引数adminに指定されたユーザーに関連付けられたパスワードを指定します。

- ldap_uriには、LDAPサーバーのURIを指定します。書式は、デフォルト・ポートを使用する場合はldap://host:port、セキュアLDAPポートを使用する場合はldaps://host:portになります。セキュア・ポートは、匿名SSL接続を処理するように構成されていることが必要で、デフォルトの(非セキュアな)ポートとは異なります。

- ldap_srvr_typeには、ターゲットLDAPサーバーの種類を指定します。Oracle Internet DirectoryのOIDを指定します。

- root_webcenter_xxxxには、全データを移行するターゲットLDAPリポジトリのルート・ノードを指定します。必ず、cn=を含めてください。書式はcn=nodeNameです。

すべての引数が必要です。次に例を示します。

reassociateSecurityStore(domain="myDomain", admin="cn=adminName", password="myPass", ldapurl="ldaps://myhost.example.com:3060", servertype="OID", jpsroot="cn=testNode")

30.4 ポリシーおよび資格証明ストアのデータベースとの再関連付け

ポリシーおよび資格証明ストアにはOIDなどのLDAPサーバーを使用できるほか、ポリシーおよび資格証明ストアをOracleデータベースと再度関連付けることもできます。ポリシーおよび資格証明ストアをデータベースと再度関連付ける前に、次を完了していることが必要です。

- RCUおよびOPSSスキーマのインストール

- Oracleデータベース(Oracle RDBMSバージョン10.2.0.4+、11.1.0.7+または11.2.0.1+)のインストール

- WebLogic Serverのインストール

- ドメインの作成
新しいドメインの作成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドの新しいドメインの作成に関する項を参照してください。

- データ・ソースの作成
データ・ソースの作成方法については、Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理のJDBCデータ・ソースの作成に関する項を参照してください。

- <DOMAIN>/config/fmwconfig/jps-config.xmlファイルのバックアップ

次の手順に従って、データベースをポリシーおよび資格証明ストアとして構成します。

1. スキーマとデータベース接続を関連付けます。スキーマとデータベース接続を関連付ける方法については、第7.1.5項「メタデータ・サービス・リポジトリの作成および登録」を参照してください。

2. jps-config.xmlファイルとbootstrap/cwallet.ssoファイルをバックアップします(両方ともdomain_home/config/fmwconfigフォルダ内にあります)。

3. 次のWLSTコマンドを使用して、ポリシーおよび資格証明ストアをデータベースに移行します。

reassociateSecurityStore(domain="your_domain", datasourcename="your_data_source", servertype="DB_ORACLE", jpsroot="cn=jpsTestNode")

datasourcenameは、直前に作成したOPSSデータ・ソースのJNDI名です。また、jpsrootは、ポリシー・ストアのストライプ化に使用するパラメータであることにも注意してください。このパラメータの値は、ポリシー・ストアで一意であることが必要です。reassociateSecurityStoreコマンドの使用の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のreassociateSecurityStoreに関する項を参照してください。

30.5 資格証明の管理

管理者は、Fusion Middleware ControlおよびWLSTコマンドを使用して、WebCenter Portalドメイン資格証明ストアの資格証明を管理できます。詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの資格証明の管理に関する項を参照してください。

30.6 ユーザーおよびアプリケーション・ロールの管理

この項では、Fusion Middleware Control、WLST、およびSpacesアプリケーションとFrameworkアプリケーションの実行時管理ページを使用して、ユーザー・ロールとアプリケーション・ロールを管理する方法を説明します。

この項の内容は次のとおりです。

- 第30.6.1項「Spaces管理者ロールの付与」

- 第30.6.2項「アプリケーション・ロールの付与」

- 第30.6.3項「実行時管理ページの使用」

30.6.1 Spaces管理者ロールの付与

Spacesは、最初のオーセンティケータによってマップされたアイデンティティ・ストア内のユーザーのみを認識します。Spaces管理者アカウントは当初は組込みのLDAPサーバーにのみ作成されるため、Oracle Internet Directoryなどの外部LDAPをSpacesのプライマリ・オーセンティケータとして構成する場合は、そのLDAP内にユーザーを作成し、そのユーザーにSpaces管理者ロールを付与することも必要です。

次の項の説明に従って、Fusion Middleware ControlまたはWLSTを使用してSpaces管理者ロールをユーザーに付与できます。

- 第30.6.1.1項「Fusion Middleware Controlを使用したSpaces管理者ロールの付与」

- 第30.6.1.2項「WLSTを使用したSpaces管理者ロールの付与」

詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドの非デフォルト・ユーザーへの管理者ロールの付与に関する項を参照してください。

30.6.1.1 Fusion Middleware Controlを使用したSpaces管理者ロールの付与

この項では、Spaces管理者ロールをデフォルトのweblogicアカウント以外のユーザー・アカウントに付与する方法について説明します。

Fusion Middleware Controlを使用してSpaces管理者ロールを付与する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、Spacesホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. WebCenter Portalメニューから、「セキュリティ」→「アプリケーション・ロール」を選択します。
「アプリケーション・ロール」ページが表示されます(図30-3を参照)。

図30-3 「アプリケーション・ロール」ページ

「図30-3 「アプリケーション・ロール」ページ」の説明

3. Spaces管理者ロールを検索します。

1. 「検索するアプリケーション・ストライプの選択」を選択します。

2. webcenterを選択します。

3. 「ロール名」フィールドに、管理者ロールの次の内部識別子を入力して、「検索」(矢印)アイコンをクリックします。

s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator

検索の結果として、管理者ロールの識別子であるs8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administratorが返されます。

4. 「ロール名」列で管理者ロールの識別子をクリックします。
「アプリケーション・ロールの編集」ページが表示されます(図30-4を参照)。

図30-4 「アプリケーション・ロールの編集」ページ

「図30-4 「アプリケーション・ロールの編集」ページ」の説明

5. 「ユーザーの追加」をクリックします。
「ユーザーの追加」ポップアップが表示されます(図30-5を参照)。

図30-5 「ユーザーの追加」ポップアップ

「図30-5 「ユーザーの追加」ポップアップ」の説明

6. 検索機能を使用して、管理者ロールを割り当てるユーザーを検索します。

7. 矢印キーを使用して「使用可能なユーザー」列から「選択したユーザー」列にユーザーを移動し、「OK」をクリックします。

8. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。

9. weblogicロールを削除するには、「アプリケーション・ロールの編集」ページで、「ユーザー」のweblogicをクリックし、「削除」をクリックします。

10. WC_Spaces管理対象サーバーを再起動します。
Spacesにログインすると、「管理」リンクが表示され、管理者の操作をすべて実行できます。

30.6.1.2 WLSTを使用したSpaces管理者ロールの付与

WLSTを使用して別のユーザーにSpaces管理者ロールを付与する手順は次のとおりです。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

2. 次のコマンドを使用して、ターゲット・ドメインのSpaces管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

各要素の意味は次のとおりです。

- user_nameは、管理サーバーにアクセスするユーザー・アカウントの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

3. 次に示されているように、grantAppRoleコマンドを使用して、Oracle Internet DirectoryのユーザーにSpaces管理者アプリケーション・ロールを付与します。

grantAppRole(appStripe="webcenter", appRoleName="s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator",
principalClass="weblogic.security.principal.WLSUserImpl", principalName="wc_admin")

wc_adminは、作成する管理者アカウントの名前です。

4. 新しいアカウントをテストするには、新しいアカウント名を使用してSpacesにログインします。
「管理」リンクが表示され、管理者の操作をすべて実行できます。

5. 新しいアカウントにSpaces管理者ロールを付与したら、WLST revokeAppRoleコマンドを使用して、このロールが不要になったアカウントからこれを削除します。たとえば、weblogic以外の管理者ユーザー名を使用してSpacesがインストールされている場合は、管理者ロールはそのユーザーに付与し、デフォルトのweblogicからは削除する必要があります。

revokeAppRole(appStripe="webcenter", appRoleName="s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator",
principalClass="weblogic.security.principal.WLSUserImpl", principalName="weblogic")

30.6.2 アプリケーション・ロールの付与

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用してアプリケーション・ロールにユーザーを追加する方法について説明します。

この項の内容は次のとおりです。

- 第30.6.2.1項「Fusion Middleware Controlを使用したアプリケーション・ロールの付与」

- 第30.6.2.2項「WLSTを使用したアプリケーション・ロールの付与」

30.6.2.1 Fusion Middleware Controlを使用したアプリケーション・ロールの付与

この項では、Fusion Middleware Controlを使用してユーザーにアプリケーション・ロールを付与する方法を説明します。

1. Fusion Middleware Controlにログインし、SpacesアプリケーションまたはFrameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「Spacesアプリケーションのホームページへの移動」

- 第6.3項「Frameworkアプリケーションのホームページへの移動」

2. WebCenter Portalメニューから、「セキュリティ」→「アプリケーション・ロール」を選択します。
「アプリケーション・ロール」ページが表示されます(図30-6を参照)。

図30-6 「アプリケーション・ロール」ページ

「図30-6 「アプリケーション・ロール」ページ」の説明

3. SpacesまたはFrameworkアプリケーション・ロールを検索します。

1. 「検索するアプリケーション・ストライプの選択」を選択します。

2. アプリケーション・ストライプ(Spacesの場合はwebcenter)を選択します。

3. 「ロール名」フィールドに、検索するロールの名前を入力し(例: appConnectionManager)、「検索」(矢印)アイコンをクリックします。
名前がはっきりわからない場合は、部分検索文字列を入力するか、フィールドを空白のままにして、すべてのアプリケーション・ロールを表示します。

4. 「ロール名」列でロール識別子をクリックします。
「アプリケーション・ロールの編集」ページが表示されます(図30-7を参照)。

図30-7 「アプリケーション・ロールの編集」ページ

「図30-7 「アプリケーション・ロールの編集」ページ」の説明

5. 「ユーザーの追加」をクリックします。
「ユーザーの追加」ポップアップが表示されます(図30-8を参照)。

図30-8 「ユーザーの追加」ポップアップ

「図30-8 「ユーザーの追加」ポップアップ」の説明

6. 検索機能を使用して、アプリケーション・ロールを割り当てるユーザーを検索します。

7. 矢印キーを使用して「使用可能なユーザー」列から「選択したユーザー」列にユーザーを移動し、「OK」をクリックします。

8. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。

9. SpacesまたはFrameworkアプリケーションがデプロイされている管理対象サーバーを再起動します(Spacesの場合、これは常にWC_Spacesになります)。

30.6.2.2 WLSTを使用したアプリケーション・ロールの付与

grantAppRoleコマンドを使用して、ユーザーにアプリケーション・ロールを付与します。構文と使用方法については、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のgrantAppRoleに関する項を参照してください。

30.6.3 実行時管理ページの使用

管理者はSpacesの「セキュリティ」タブを使用して、アプリケーション・ロールを定義し、アイデンティティ・ストアで定義されたユーザーにアプリケーション・ロールを付与できます。Spacesでのユーザーとアプリケーション・ロールの管理については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのWebCenter Portal: Spacesのユーザーとロールの管理に関する項を参照してください。

注意:

「パスワード変更の許可」プロパティは、ユーザーがSpaces内で各自のパスワードを変更できるかどうかを指定しますが、これは企業のアイデンティティ・ストアで慎重に管理することが必要です。Spaces管理者はSpacesのプロファイル管理設定のページからこのプロパティを設定できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのプロファイルの構成に関する項を参照してください。

Frameworkアプリケーションも、アプリケーション管理者のための同様の「セキュリティ」タブを提供します。詳細は、第36.4項「アプリケーション・メンバーおよびロールの管理」を参照してください。ADFセキュリティベースのFrameworkアプリケーションのロールマッピングの詳細は、Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのアプリケーション・ロールとエンタープライズ・ロールの必須知識に関する項を参照してください。

30.7 Spacesアプリケーションにおける招待による自己登録の構成

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの招待のみによる自己登録の有効化に関する項に説明されているように、Spacesは招待による自己登録をサポートします。招待による自己登録機能では、WebCenter Portalドメイン資格証明ストアに次のパスワード資格証明が含まれていることが必要です。

- map name = o.webcenter.security.selfreg

- key= o.webcenter.security.selfreg.hmackey

- user name = o.webcenter.security.selfreg.hmackey

Spacesで招待による自己登録を有効にするには、Fusion Middleware ControlまたはWLSTコマンドcreateCredを使用して、前述のパスワード資格証明を作成します。次に例を示します。

createCred(map="o.webcenter.security.selfreg", key="o.webcenter.security.selfreg.hmackey", type="PC",
user="o.webcenter.security.selfreg.hmackey", password="<password>", url="<url>", port="<port>", [desc="<description>"])

詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの資格証明の管理に関する項を参照してください。

30.8 ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定

この項では、インストール後に構成する必要がある推奨キャッシュ設定を示します。キャッシュ・サイズと最大グループ階層の設定は特定の環境に基づく必要がありますが、次の項では開始点として使用できる推奨事項を示します。WebCenter Portalのチューニング・パラメータと推奨値の全リストは、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のOracle WebCenter Portalパフォーマンスのチューニングに関する項を参照してください。

この項の内容は次のとおりです。

- 第30.8.1項「ポリシー・ストアのリフレッシュ間隔の設定」

- 第30.8.2項「接続プール・キャッシュの設定」

- 第30.8.3項「ユーザー・キャッシュ設定の設定」

- 第30.8.4項「グループ・キャッシュ設定の設定」

30.8.1 ポリシー・ストアのリフレッシュ間隔の設定

WebCenter Portalが使用する認可ポリシーでは、デフォルトのポリシー・リフレッシュ時間が10分間のメモリー内キャッシュを使用します。マルチノードの高可用性環境でグループ・スペースを作成する場合、ノード障害の際にポリシー・データをより迅速にレプリケートする必要があるときは、ドメインレベルのjps-config.xmlファイルを変更して次のエントリを追加することでポリシー・ストアのリフレッシュ間隔を短くすることができます。

oracle.security.jps.ldap.policystore.refresh.interval=<time_in_milli_seconds>

これはPDPサービス・ノードに追加する必要があります。

<serviceInstance provider="pdp.service.provider" name="pdp.service">

サーバーのキャッシュされたポリシーのリフレッシュ頻度はパフォーマンスに影響を与える可能性があるため、ポリシーのリフレッシュ間隔は過度に短く設定しないでください。

jps-config.xmlファイルを変更したら、ドメイン内の全サーバーを再起動します。詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドのキャッシングとキャッシュのリフレッシュに関する項を参照してください。

30.8.2 接続プール・キャッシュの設定

この項では、接続プール・キャッシュの推奨設定を説明します。

接続プール・キャッシュを設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「構成」→「プロバイダ固有」を選択します。

3. 接続プール・キャッシュのパラメータを次の推奨値に設定します。

- 接続プール・サイズ = 最大接続ユーザー数

- 接続タイムアウト = 30

- 接続再試行制限 = 1

- 結果タイム・リミット = 1000

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

30.8.3 ユーザー・キャッシュ設定の設定

この項では、ユーザー・キャッシュ設定の推奨設定を説明します。

ユーザー・キャッシュ設定を設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「構成」→「プロバイダ固有」を選択します。

3. ユーザー・キャッシュのパラメータを次の推奨値に設定します。

- キャッシュの有効化 = true

- キャッシュ・サイズ = 3200

- キャッシュTTL = session timeout

- 結果タイム・リミット = 1000

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

30.8.4 グループ・キャッシュ設定の設定

この項では、グループ・キャッシュ設定の推奨設定を説明します。

グループ・キャッシュ設定を設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「パフォーマンス」を選択します。

3. グループ・キャッシュのパラメータを次の推奨値に設定します。

- グループ・メンバーシップ・ルックアップの階層キャッシュを有効化 = true

- キャッシュ・サイズ = 3200

- キャッシュ内の最大グループ階層数 = 1024

- グループ階層キャッシュTTL = session timeout

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

31 シングル・サインオンの構成

この章では、WebCenter Portalアプリケーションで利用できるシングル・サインオン(SSO)ソリューションと各ソリューションの構成方法について説明します。

この章の内容は次のとおりです。

- 第31.1項「シングル・サインオンの概要」

- 第31.2項「Oracle Access Manager(OAM)の構成」

- 第31.3項「Oracle Single Sign-On(OSSO)の構成」

- 第31.4項「SAMLベースのシングル・サインオンの構成」

- 第31.5項「Microsoftクライアント用のSSOの構成」

- 第31.6項「仮想ホストを使用したSSOの構成」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

31.1 シングル・サインオンの概要

いくつかのソリューションを使用して、WebCenter Portalアプリケーション(SpacesおよびFrameworkアプリケーション)向けにシングル・サインオンを実装できます。この項では、その利点と推奨アプリケーションを説明します。

オラクル社のエンタープライズ・クラスのアイデンティティ管理およびセキュリティ製品スイートの一部であるOracle Access Manager(OAM)は、SpacesおよびFrameworkアプリケーション用のいくつかのシングル・サインオン・オプションを含む広範なアイデンティティ管理およびセキュリティ機能を提供します。OAM(特にOAM 11g)は、Oracle WebCenter Portal 11gのインストールに推奨されるシングル・サインオン・ソリューションです。

Oracle 10gインフラストラクチャに投資済のデプロイメント環境で、Oracle Application Server Single Sign-On(OSSO)サーバーがプライマリSSOソリューションとして使用されている場合は、OSSOを使用してシングル・サインオンを提供するようにWebCenter Portal 11gを構成することもできます。

Oracle Access ManagerやOracle SSOのようなエンタープライズ・クラスのシングル・サインオン・インフラストラクチャを装備していない本番以外の開発環境で、Spaces、ディスカッションのような関連するWebアプリケーションおよびワークリスト内でのみシングル・サインオン機能を提供する必要がある場合は、SAMLベースのSSOソリューションを構成できます。他のエンタープライズ・アプリケーションにもシングル・サインオンを提供する必要がある場合は、このソリューションはお薦めできません。

Active Directoryのユーザー・アカウントによってMicrosoftドメイン・コントローラを使用して認証を行うMicrosoftデスクトップ・ログインを使用している場合は、Microsoftのクライアントに対するSSOの構成も検討できます。

31.2 Oracle Access Manager(OAM)の構成

Oracle Access Manager(OAM)は、柔軟で拡張可能な認証と認可のほか、監査サービスを提供します。この項では、WebLogicサーバー側およびSSOに参加するパートナ・アプリケーションとしてのWebCenter Portalアプリケーションの構成方法を含め、OAMシングル・サインオン認証のためにSpacesおよびFrameworkアプリケーションを構成する方法を説明します。第32.4項「OAMに対するFrameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成」で説明されているように、Frameworkアプリケーションの場合は、追加の構成がいくつか必要になることに注意してください。

次の項で、OAM 11gおよび10gのインストールおよび構成手順を示します。

- 第31.2.1項「OAMのコンポーネントとトポロジ」

- 第31.2.2項「OAM構成のロードマップ」

- 第31.2.3項「OAMのインストールと構成」

- 第31.2.4項「OAM用のWebLogicドメインの構成」

- 第31.2.5項「Oracle HTTP Serverのインストールと構成」

- 第31.2.6項「追加のシングル・サインオン構成」

- 第31.2.7項「OAMインストールのテスト」

31.2.1 OAMのコンポーネントとトポロジ

図31-1は、WebCenter Portalアプリケーション用にOracle Access Managerを使用してシングル・サインオンをセットアップするために必要なコンポーネントとトポロジを示しています。

図31-1 OAMシングル・サインオンのコンポーネントとトポロジ

「図31-1 OAMシングル・サインオンのコンポーネントとトポロジ」の説明

OAMは次のコンポーネントから構成されます。

- アクセス・サーバー - 認証、認可およびアクセス・ゲートの監査サービスを提供するスタンドアロン・サーバー。OAMには1台のアクセス・サーバーがセットアップされます。これはOAMのインストール自体の一環として行われます。

- WebGate - Webリソース(HTTP)リクエストをインターセプトして認証と認可のためにアクセス・サーバーに転送する、すぐに利用可能なプラグイン。

- IDアサーション・プロバイダ(IAP) - 境界認証によって設定されるヘッダー情報に基づいてユーザーのアイデンティティをアサートするセキュリティ・プロバイダの種類。OAMの統合により、OAM IAPとして構成できるOAM IDアサータが提供されます。OAM IDアサータは、認証またはアイデンティティ・アサーションに使用できます。OAM SSOの統合では、プロバイダの「共通」設定の「アクティブなタイプ」でobSSOCookieを選択して、アイデンティティ・アサーション・プロバイダ(IAP)としてOAM IDアサータを構成することが必要です。

OAMシングル・サインオン・プロセスのフロー

図31-2は、OAMのシングル・サインオン・プロセスのフローを示しています。

図31-2 OAMシングル・サインオン・プロセスのフロー

「図31-2 OAMシングル・サインオン・プロセスのフロー」の説明

OAMエージェントによるSSOログイン処理

1. ユーザーがリソースをリクエストします。

2. ポリシー評価のためにWebGateがOAMにリクエストを転送します。

3. OAMが次を行います。

- SSO Cookieの有無をチェックします。

- ポリシーをチェックして、リソースが保護されているかどうか、保護されている場合はどのような方法で保護されているかを判断します。

4. OAMサーバーが判定をログして返します。

5. WebGateは、次のように応答します。

- 無保護リソース: リソースはユーザーに提供されます。

- 保護リソース:

- リクエストは資格証明コレクタにリダイレクトされます。

- 認証ポリシーに基づいてログイン・フォームが提供されます。

- 認証処理が開始します。

6. ユーザーが資格証明を送信します。

7. OAMが資格証明を検証します。

8. OAMがセッションを開始して、次のホストベースのCookieを作成します。

- パートナ当たり1つ: 認証に成功した後でOAMサーバーから受信される認証トークンを使用して、11g WebGateがOAMAuthnCookieを設定します(10g WebGateの場合はObSSOCookie)。
注意: セッションには有効なCookieが必要です。

- OAMサーバーに1つ: OAM_ID

9. OAMが成功または失敗をログします。

10. OAM資格証明コレクタがWebGateにリダイレクトし、認可処理が開始します。

11. ポリシーをルックアップして、それらをユーザーのアイデンティティと比較し、ユーザーの認可レベルを判定するようにWebGateがOAMに指示します。

12. OAMがポリシーに関する判定をログして、セッションCookieをチェックします。

13. OAMサーバーが認可ポリシーを評価して、結果をキャッシュします。

14. OAMサーバーが判定をログして返します。

15. WebGateは、次のように応答します。

- 認可ポリシーでアクセスが許可されている場合は、次に示すように、リクエストはmod_wlにリダイレクトされ、さらにSpacesアプリケーションを実行中のWLSサーバーにリダイレクトされて、そこから希望のコンテンツやアプリケーションがユーザーに提供されます。
WebGate→mod_wl→Spaces(ディスカッションなど)→コンテンツが認証されたユーザーに提供されます

- 認可ポリシーでアクセスが拒否されている場合は、管理者が決定した別のURLにユーザーはリダイレクトされます。

31.2.2 OAM構成のロードマップ

この項のフロー・チャート(図31-3)と表(表31-1)は、OAMを使用してWebCenter Portalのシングル・サインオンを構成する際の前提条件と必要なタスクの概要を示しています。

図31-3 OAMを使用したWebCenter Portalのシングル・サインオンの構成

「図31-3 OAMを使用したWebCenter Portalのシングル・サインオンの構成」の説明

表31-1は、OAMを使用してWebCenter Portalのシングル・サインオンを構成するためのタスクとサブタスクを示しています。

表31-1 OAMを使用したWebCenter Portalのシングル・サインオンの構成

担当者

タスク

サブタスク

ノート

管理者

1. OAMのインストールと構成

OAM 10gまたは11gのインストールと構成

2. OAM用のWebLogicドメインの構成

2.a OIDオーセンティケータの構成

2.b OAMアイデンティティ・アサータの構成

2.c デフォルト・オーセンティケータとプロバイダの順序の構成

2.d OAM SSOプロバイダの追加

3. OHSのインストールと構成

4. 必要に応じた追加構成の実行

4.a SSO用のSpacesの構成

4.b SSO用のディスカッション・サーバーの構成

4.c SSO用のワークリスト・サービスの構成

4.d 外部リーダーを使用したRSSフィード用のOAMの構成

4.e WLS管理コンソールとEnterprise Managerの構成(OAM 11gまたはOAM 10g用)

4.f OAM用のContent Serverの構成

4.g 接続フィルタを使用したアクセスの制限

5. OAMインストールのテスト

31.2.3 OAMのインストールと構成

この項では、OAM 11gまたはOAM 10gのインストールおよび構成方法と、WebCenter Portalのインストールに推奨されるシングル・サインオン・ソリューションを説明します。

注意:

OAMのインストールは、Oracle WebCenter Portalのインストール後(Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドを参照)および環境に必要な他のすべてのコンポーネントのインストール後に実行してください。また、必要な接続も、すべて事前に構成およびテストしてください。

この項の内容は次のとおりです。

- 第31.2.3.1項「OAM 11gのインストールと構成」

- 第31.2.3.2項「OAM 10gのインストールと構成」

31.2.3.1 OAM 11gのインストールと構成

この項ではOAM 11gのインストールおよび構成方法について説明し、次の内容を含みます。

- 第31.2.3.1.1項「OAM 11gのインストールと構成」

- 第31.2.3.1.2項「Oracle HTTP Serverのインストールと構成」

- 第31.2.3.1.3項「Web層でのWebGateのインストール」

- 第31.2.3.1.4項「WebGateエージェントの登録」

31.2.3.1.1 OAM 11gのインストールと構成

Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOracle Identity Management 11gソフトウェアのインストールに関する項の説明に従って、Oracle Access Manager(OAM)をインストールします。理想的なシナリオは、OAMとシングル・サインオンに参加するすべてのアプリケーションが同じアイデンティティ・ストアを共有することです。デフォルトでは、OAMは組込みのLDAPアイデンティティ・ストアを使用します。

OIDのような外部アイデンティティ・ストアを使用するようにOAMを構成するには、Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドの新規アイデンティティ・ストアの登録に関する項を参照してください。この項には、デフォルトまたはシステム・ストアとして構成された外部アイデンティティ・ストアを設定し、このストアをポイントするように1つ以上の認証モジュールを構成するためのポインタが示されています。デフォルトでは、OAMに構成されたWebCenterポリシーは、OAMに指定されたデフォルト認証スキーム(通常はフォームベースの認証スキームLDAPScheme)を使用します。デフォルト・スキームを使用する場合は、スキームが使用する認証モジュールは、WebCenterのインストールと同じアイデンティティ・ストアをポイントする必要があります。オプションとして、デフォルト以外の認証スキームを構成することができます。この場合も、WebCenterが使用するアイデンティティ・ストアをこれが確実にポイントするようにしてください。それから、Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOracle Access Manager(OAM)の構成に関する項の説明に従って、WebLogic管理ドメインでOracle Access Managerを構成します。

31.2.3.1.2 Oracle HTTP Serverのインストールと構成

Oracle HTTP Server (OHS)がインストールされていない場合、第31.2.5項「Oracle HTTP Serverのインストールと構成」の説明に従ってOHS (11.1.1.4.0)をインストールします。

既存のインストールがある場合は、Oracle Fusion Middlewareパッチ適用ガイドの最新のOracle Fusion Middlewareパッチ・セットの適用に関する項の説明に従ってパッチを適用して、OHS (11.1.1.4.0)にする必要があります。

OHSのインストールまたはパッチ適用が終了したら、第31.2.3.1.3項「Web層でのWebGateのインストール」の説明に従ってWebGateをインストールします。

31.2.3.1.3 Web層でのWebGateのインストール

この項では、OHS WebGateのインストールおよび構成方法について説明します。

注意:

OHS WebGateのインストール中は必ずOracle HTTP Serverを停止し、第31.2.3.1.4項「WebGateエージェントの登録」の説明に従ってWebGateエージェントを登録した後でのみ再起動してください。

1. LinuxおよびSolarisオペレーティング・システムの場合は、Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのサードパーティ製GCCライブラリのインストール(LinuxおよびSolarisオペレーティング・システムのみ)に関する項の説明に従って、サードパーティ製のGCCライブラリをダウンロードして、OHSのインストール先と同じ場所にインストールします。

2. Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOracle Access Manager用のOracle HTTP Server 11g WebGateのインストールに関する項の説明に従って、WebGateをインストールします。OHSのインストール時に指定したものと同じミドルウェア・ホームを使用します。インストール時に、前の手順でダウンロードしたGCCライブラリを含むディレクトリをポイントする必要があることに注意してください。

3. Oracle Access Manager用のOracle HTTP Server 11g WebGateをインストールしたら、WebGate用のOracleホームの下にある次のディレクトリに移動します。
UNIXオペレーティング・システムの場合:

<Webgate_Home>/webgate/ohs/tools/deployWebGate

Windowsオペレーティング・システムの場合:

<Webgate_Home>\webgate\ohs\tools\deployWebGate

4. コマンド・ラインで次のコマンドを実行して、必要なエージェントの部分をWebgate_HomeディレクトリからWebGateインスタンスの場所にコピーします。
UNIXオペレーティング・システムの場合:

./deployWebGateInstance.sh -w <Webgate_Instance_Directory> -oh <Webgate_Oracle_Home>

Windowsオペレーティング・システムの場合:

deployWebGateInstance.bat -w <Webgate_Instance_Directory> -oh <Webgate_Oracle_Home>

<Webgate_Oracle_Home>には、次の例のように、Oracle HTTP Server WebGateがインストールされており、かつWebGateのOracleホームとして定義されているディレクトリを指定します。

<MW_HOME>/Oracle_OAMWebGate1

<Webgate_Instance_Directory>には、次の例のように、WebGateインスタンス・ホームの場所を指定します(これはOracle HTTP Serverのインスタンス・ホームと同じであることが必要です)。

<MW_HOME>/Oracle_WT1/instances/instance1/config/OHS/ohs1

Oracle HTTP Serverのインスタンス・ホームは、Oracle HTTP Serverの構成後に作成されることに注意してください。この構成は、Oracle HTTP Server 11.1.1.4.0のインストールまたはパッチ適用後に実行する必要があります。

5. 次のコマンドを実行して、LD_LIBRARY_PATH変数に<Oracle_Home_for_Oracle_HTTP_Server>/libが含まれていることを確認します。
UNIXオペレーティング・システムの場合(シェルにより異なる):

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<Oracle_Home_for_Oracle_HTTP_Server>/lib

Windowsオペレーティング・システムの場合:

<Webgate_Installation_Directory>\webgate\ohs\libおよび<Oracle_Home_for_Oracle_HTTP_Server>\binの場所をPATH環境変数に追加します。PATH環境変数のエントリの末尾に、セミコロン(;)に続けてこのパスを追加します。

6. 現在の作業ディレクトリから1つ上位に移動します。
UNIXオペレーティング・システムの場合は、次に移動します。

<Webgate_Home>/webgate/ohs/tools/setup/InstallTools

Windowsオペレーティング・システムの場合は、次に移動します。

<Webgate_Home>\webgate\ohs\tools\EditHttpConf

7. コマンド・ラインで次のコマンドを実行して、apache_webgate.templateをWebgate_HomeディレクトリからWebGateインスタンスの場所にコピーします(webgate.confにその名前を変更します)。さらに、httpd.confファイルを更新し、1行を追加してwebgate.confファイルの名前を含めます。
UNIXオペレーティング・システムの場合:

./EditHttpConf -w <Webgate_Instance_Directory> [-oh <Webgate_Oracle_Home>] [-o <output_file>]

Windowsオペレーティング・システムの場合:

EditHttpConf.exe -w <Webgate_Instance_Directory> [-oh <Webgate_Oracle_Home>] [-o <output_file>]

注意:

-oh <WebGate_Oracle_Home>および-o <output_file>パラメータはオプションです。

<Webgate_Oracle_Home>には、次の例のように、Oracle HTTP Server WebGateがインストールされており、かつWebGateのOracleホームとして定義されているディレクトリを指定します。

<MW_HOME>/Oracle_OAMWebGate1

<Webgate_Instance_Directory>には、次の例のように、WebGateインスタンス・ホームの場所を指定します(これはOHSのインスタンス・ホームと同じであることが必要です)。

<MW_HOME>/Oracle_WT1/instances/instance1/config/OHS/ohs1

31.2.3.1.4 WebGateエージェントの登録

Web層にWebGateをインストールしたら、WebGateエージェントの登録も行う必要があります。次の手順では、OAMのインストールで構成されたデフォルト認証スキーム(通常はフォームベースの認証スキームLDAPScheme)を使用する保護されたポリシーを自動的に作成します。WebCenter Portalのシングル・サインオンのログイン・ページをカスタマイズしたい場合、または他の認証スキームでWebCenter Portalリソースを保護したい場合は、OAMコンソールを使用してそれを変更してください(詳細は、Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドの認証スキームの管理に関する項を参照)。

注意:

環境でWebCenter Portalとともに他のアプリケーションを使用しており、これらのアプリケーションにシングル・サインオンが必要な場合は、これらのアプリケーションで使用される認証スキームが同じであるか、少なくとも同じレベルで、同じアイデンティティ・ストアをポイントしていることが必要です。

WebGateエージェントの登録に関する詳細は、Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOracle Access Manager用の新しいOracle HTTP Server 11g WebGateエージェント・スタート・ガイドに関する項も参照してください。

次の手順に従って、インバンド・モードでoamregツールを使用して、OAMがインストールされているマシン上でWebGateエージェントを登録します。

1. ディレクトリを<RREG_Home>/inputに変更します。

2. このWebCenter Portalのインストールから$WEBCENTER_HOME/webcenter/scripts/webcenter.oam.confを上書きします。

3. SOAとContent Serverのインストールから、$SOA_HOME/soa/prov/soa.oam.confおよび$WC_CONTENT_ORACLE_HOME/common/security/oam.confをそれぞれ上書きします。

4. oamregツールのパラメータ・ファイルとして機能するWebCenterOAM11gRequest.xmlという名前の新しいファイルを作成します。
次の例で、$$webtier..$$内の内容は該当するWeb層ホストとポートIDで置き換え、$$oam...$$はOAMホストと管理サーバー・ポートで置き換えます。

<?xml version="1.0" encoding="UTF-8"?>

<!--
Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.

NAME: OAM11GRequest_short.xml - Template for OAM 11G Agent Registration Request file
(Shorter version - Only mandatory values - Default values will be used for all other fields)
DESCRIPTION: Modify with specific values and pass file as input to the tool.
-->
<OAM11GRegRequest>
<serverAddress>http://$$oamhost$$:$$oamadminserverport$$</serverAddress>
<hostIdentifier>$$webtierhost$$_webcenter</hostIdentifier>
<agentName>$$webtierhost$$_webcenter</agentName>
<logOutUrls>
<url>/oamsso/logout.html</url>
</logOutUrls>
</OAM11GRegRequest>

5. ディレクトリを<RREG_Home>に変更します。

6. 次のコマンドを実行します。

<RREG_Home>/bin/oamreg.sh inband input/WebCenterOAM11gRequest.xml

- エージェントの資格証明を入力するように求められたら、OAM管理者の資格証明を入力します。

- WebGateのパスワードを入力します。

- URIファイルをインポートするかどうか尋ねられたら、yesと入力します。以前コピーした<RREG_HOME>/input/webcenter.oam.confファイルのフルパスを指定します。
登録が成功したことを示す次のような出力が表示されます。

----------------------------------------
Request summary:
OAM11G Agent Name:example_webcenter
URL String:example_webcenter
Registering in Mode:inband
Your registration request is being been sent to the Admin server at: http://example.com:7001
----------------------------------------
Inband registration process completed successfully! Output artifacts are created in the output folder.

7. 生成されたファイルとアーティファクト(ObAccessClient.xmlとcwallet.sso)を<RREG_Home>/output/$$webtierhost$$_webcenterからWebGateインスタンスの構成ディレクトリ(<Webgate_Instance_Directory>/webgate/config)にコピーします。次の例のように、<Webgate_Instance_Directory>は、OHSのインスタンス・ホームと一致する必要があることに注意してください。

<MW_HOME>/Oracle_WT1/instances/instance1/config/OHS/ohs1/webgate/config

8. ディレクトリを<RREG_Home>/inputに変更します。

9. SOAまたはWebCenter Content Serverがインストールされている場合は、次の手順に従います。

1. 次の例に示されているように、WebCenterOAM11gPolicyUpdate.xmlというポリシー更新ファイルを作成します。以前に行ったように、$$webtier..$$内の内容はWeb層ホストとポートIDに、$$oam...$$はOAMホストと管理サーバー・ポートに置き換えます。

<?xml version="1.0" encoding="UTF-8"?>

<!--
Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.

NAME: UpdatePolicyRequest.xml - Template for updating application domain and/or policies without changes to any agent profile
DESCRIPTION: Modify with specific values and pass file as input to the tool
-->
<PolicyRegRequest>

<serverAddress>http://$$oamhost$$:$$oamadminserverport$$</serverAddress>
<hostIdentifier>$$webtierhost$$_webcenter</hostIdentifier>
<applicationDomainName>$$webtierhost$$_webcenter</applicationDomainName>

</PolicyRegRequest>

2. 次のコマンドを実行します。

<RREG_Home>/bin/oamreg.sh policyUpdate input/WebCenterOAM11gPolicyUpdate.xml

入力を要求されたら、OAMの資格証明を入力します。URIファイルをインポートするかどうか尋ねられたら、yesと入力して、<RREG_HOME>/input/soa.oam.confを指定します。

ポリシーはSOAリソースを使用して更新されます。

3. 再度policyUpdateコマンドを実行します。今回は<RREG_HOME>/input/oam.confを指定して、Content Serverのリソースを使用してポリシーを更新します。これでポリシーに、WebCenter Portal、SOAおよびContent Serverのアーティファクトが含まれます。

10. OAMコンソールから、次のアーティファクトを表示できるはずです。

- $$webtierhost$$_webcenterという名前の11g WebGateエージェント

- 同じ名前の11gホスト識別子

- 認証ポリシーと認可ポリシー(保護されたポリシーとパブリック・ポリシーを含む)を含む同じ名前のアプリケーション・ドメイン

11. 「アプリケーション・ドメイン」→$$webtierhost$$_webcenter→「認証ポリシー」に移動します。次のポリシーを表示できるはずです。

- 除外スキーム

- 保護されたリソース・ポリシー

- パブリック・リソース・ポリシー

- WebCenter RESTポリシー

12. WebCenter RESTポリシーを開いて、認証スキームがBasicSessionlessSchemeまたはBasicSchemeに設定されていることを確認します。

13. 「リソース」タブを開いて、認証ポリシーがExclusion Schemeに設定されているリソースを検索します。次のリソースが表示されるはずです。

- /rsscrawl*

- /rsscrawl/.../*

- /sesUserAuth*

- /sesUserAuth/.../*

- /services-producer/portlets*

- /services-producer/portlets/.../*

- /wsrp-tools/portlets

- /wsrp-tools/portlets/.../*

14. 検索結果の/rsscrawl*リソースを選択して、「編集」をクリックします。

15. 保護レベルをProtectedからExcludedに変更して、「適用」をクリックします。リソースの認証ポリシーと認可ポリシーが削除されることに注意してください。

16. 「リソース」タブを閉じて、残りのExclusion Schemeリソースについてこの手順を繰り返します。
この時点で認証ポリシーがExclusion Schemeに設定されているリソースを検索すると、結果はゼロになります。

17. OHSを再起動します。

18. Web層と関連するコンポーネントをインストールおよび構成したら、第31.2.4項「OAM用のWebLogicドメインの構成」の説明に従ってポリシー・マネージャを構成し、第31.2.6項「追加のシングル・サインオン構成」の説明に従って適用される追加のサービスとコンポーネントの構成を実行します。

31.2.3.2 OAM 10gのインストールと構成

この項では、OAM 10gのインストールおよび構成方法について説明し、次の内容を含みます。

- 第31.2.3.2.1項「OAM 10gのインストールと構成」

- 第31.2.3.2.2項「Oracle HTTP Serverのインストールと構成」

- 第31.2.3.2.3項「WebCenter Portalポリシー・ドメインの構成」

- 第31.2.3.2.4項「Web層でのWebGate 10gのインストール」

31.2.3.2.1 OAM 10gのインストールと構成

まだOracle Access Manager (OAM) 10gをインストールしていない場合は、Oracle Access Managerインストレーション・ガイドの説明に従ってOAM 10gをインストールします。

31.2.3.2.2 Oracle HTTP Serverのインストールと構成

Oracle HTTP Server (OHS)がインストールされていない場合、第31.2.5項「Oracle HTTP Serverのインストールと構成」の説明に従ってOHS (11.1.1.4.0)をインストールします。

既存のインストールがある場合は、Oracle Fusion Middlewareパッチ適用ガイドの最新のOracle Fusion Middlewareパッチ・セットの適用に関する項の説明に従ってパッチを適用して、OHS (11.1.1.4.0)にする必要があります。

OHSのインストールまたはパッチ適用を行ったら、第31.2.3.2.3項「WebCenter Portalポリシー・ドメインの構成」の説明に従ってWebGateをインストールします。

31.2.3.2.3 WebCenter Portalポリシー・ドメインの構成

この手順では、Oracle WebCenterをインストール済であることを前提としています(WebCenter Portalを参照)。デフォルトでは、Oracle WebCenter Portalのインストールによって、1台の管理サーバーと4台の管理対象サーバー(WC_Spaces、WC_Collaboration、WC_UtilitiesおよびWC_Portlet)を含むWebLogic Serverドメインが作成されます。

1. 使用するアクセス・サーバーを決定します。

1. Access Managerにログオンします。

2. 「アクセス・システム・コンソール」をクリックします。

3. 「アクセス・システム構成」タブを開きます。

4. 「アクセス・サーバー構成」をクリックして、すべてのアクセス・サーバーのリストを表示します。

5. リスト内のアクセス・サーバーをクリックして、サーバーの詳細を表示します。
ホストの名前とポートは、それぞれ、スクリプトのoam_aaa_hostおよびoam_aaa_portパラメータに必要な値です。

2. OAM 10gのインストールにOraDefaultExclusionAuthNSchemeがあることをチェックします。ない場合は、次のようにOraDefaultExclusionAuthNSchemeを作成します。

1. OAMアクセス・システム・コンソールを開きます。

2. 「認証管理」をクリックします。

3. 「追加」をクリックします。

4. 「名前」フィールドにOraDefaultExclusionAuthNSchemeと指定します。

5. 「説明」フィールドにTo exclude resources from being protected by OAMと入力します。

6. 「レベル」フィールドに0と入力します。

7. 「チャレンジ・メソッド」フィールドにNoneと指定します。

8. 「チャレンジ・パラメータ」フィールドにunprotected:trueを追加します。

9. 「保存」をクリックします。

10. この認証スキームの「プラグイン」タブを開いて「変更」をクリックします。

11. ドロップダウン・リストからcredential_mappingを選択します。

12. 次のように値を指定します。
obMappingBase="dc=us,dc=oracle,dc=com",obMappingFilter="(uid=OblixAnonymous)"

この値がOraDefaultAnonAuthNSchemeの対応するフィールドと一致することを確認してください。

13. 「保存」をクリックします。

14. 再度「一般」タブを開いて、「変更」をクリックします。

15. 「有効」についてYesをチェックします。

16. 「保存」をクリックします。

3. 次のコマンドを実行します。
oamcfgtool.jarは、WebCenter PortalインストールのORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jarにあります。太字の値は、WebCenter PortalおよびOAMインスタンスの設定に基づいて指定する必要があります。

java -jar ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar
mode=CREATE app_domain=<your_domain_name>
uris_file=WEBCENTER_HOME/webcenter/scripts/webcenter.oam.conf"
app_agent_password=<Password to be provisioned for App Agent>
ldap_host=<Hostname of LDAP server> ldap_port=<Port of LDAP server>
ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server> oam_aaa_port=<Port of OAM server>

ドメイン(<your_domain_name>)はwebtier.example.comのように登録することをお薦めします。OAM内の各種ポリシーを容易に区別できるように、webtier.example.comにはWeb層を指定します。

コマンドが正常に実行されると、使用した値に応じて次のような出力が表示されます。

Processed input parameters
Initialized Global Configuration
Successfully completed the Create operation.
Operation Summary:
Policy Domain : webtier.example.com
Host Identifier: webtier.example.com
Access Gate ID : webtier.example.com_AG

また、Validateコマンドを実行して、構成を検証できます。

java -jar WC_ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar mode=VALIDATE app_domain=<your_domain_name>
ldap_host=<Hostname of LDAP server> ldap_port=<Port of LDAP server>
*ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">*
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server>
oam_aaa_port=<Port of OAM server>
test_username=<Username to be used for policy validation> test_userpassword=<Userpassword to be used for policy validation>

コマンドが正常に実行されると、前述と同じ出力が表示されます。

4. インスタンスにSOAインストールも含まれている場合は、再度oamcfgtoolを実行して、前の手順で作成したポリシー・ドメインのSOA URIを保護します。既存のポリシー・ドメインがsoa.oam.confファイルのURIで更新されるように、前の手順で使用したものと同じパラメータを使用してください。

java -jar ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar
mode=CREATE app_domain=<your_domain_name>
uris_file="SOA_HOME/soa/prov/soa.oam.conf"
app_agent_password=<Password to be provisioned for App Agent>
ldap_host=<Hostname of LDAP server>
ldap_port=<Port of LDAP server>
ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server>
oam_aaa_port=<Port of OAM server>

5. インストールにContent Serverが含まれている場合は、これらのURIも保護する必要があります。既存のポリシー・ドメインがContent Serverのoam.confファイルのURIで更新されるように、前の手順で使用したものと同じパラメータを使用してください。

java -jar ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar
mode=CREATE app_domain=<your_domain_name>
uris_file="WC_CONTENT_ORACLE_HOME/common/security/oam.conf"
app_agent_password=<Password to be provisioned for App Agent>
ldap_host=<Hostname of LDAP server>
ldap_port=<Port of LDAP server>
ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server>
oam_aaa_port=<Port of OAM server>

6. ポリシー・ドメインの設定をチェックします。

1. Oracle Access Managerにログオンします。

2. 「ポリシー・マネージャ」をクリックします。

3. 「ポリシー・ドメイン」をクリックします。
ポリシー・ドメインのリストに、今作成したドメインが表示されているはずです。また、URL接頭辞列に、webcenter.oam.confスクリプト・ファイルの一部として指定されたURIも表示されます。SOAおよびContent Serverドメインからoamcfgtoolを実行すると、SOAおよびContent Server OAM構成ファイルからURIを表示できます。

4. 今作成したドメインをクリックして、「リソース」タブを開きます。
指定したURIが表示されます。また、他のタブを開いて他の設定を表示および確認したり、後で必要に応じて他のリソースを手動で追加したりすることもできます。

7. アクセス・ゲートの構成をチェックします。

1. 「アクセス・システム・コンソール」をクリックします。

2. 「アクセス・システム構成」タブを開きます。

3. 「アクセス・ゲート構成」をクリックします。

4. 検索条件を入力して「実行」をクリックします。

5. 作成したドメインのアクセス・ゲートが表示されたら(これは_AGという接尾辞を持ちます)、これをクリックして設定の詳細を表示します。

8. 前の手順で作成および確認したポリシー・ドメインを見つけて、「ポリシー」タブを開きます。
作成済の4つのポリシーが表示されます。

- WebCenter REST Policy

- Exclusion Scheme

- Protected_JSessionId_Policy

- Default Public Policy

9. WebCenter REST Policyを選択し、「認証ルール」を選択して「変更」をクリックします。

10. AuthenticationSchemeを(OraDefaultFormAuthNSchemeから)OraDefaultBasicAuthNSchemeに変更します。

11. 「除外スキーム・ポリシー」→「認証ルール」に移動して、それがAuthenticationSchemeとしてOraDefaultExclusionAuthNScheme(前の手順で作成)を使用していることを確認します。

12. 「保存」をクリックします。

13. 「ポリシー」タブを開き、ポリシーが次の順序になっていることを確認します。

Protected_JSessionId_Policy
WebCenter REST Policy
Exclusion Scheme
Default Public Policy

14. 第31.2.3.2.4項「Web層でのWebGate 10gのインストール」の説明に従って、WebGateのインストール手順を続行します。

31.2.3.2.4 Web層でのWebGate 10gのインストール

この項では、WebGateのインストール方法を説明します。

WebGateをインストールする手順は次のとおりです。

1. インストールに必要な2つのgccライブラリ(libgcc_s.so.1とlibstdc++.so.5)を含むZIPファイル(Oracle_Access_Manager10_1_4_3_0_linux_GCClib.zip)を/tmpディレクトリにコピーします。詳細は、Oracle Access Managerインストレーション・ガイドの「WebGateのインストール」に関する章を参照してください。

2. rootとしてインストールを実行します。たとえば、/tmpディレクトリから次を実行します。

sudo -u root ./Oracle_Access_Manager10_1_4_3_0_linux_OHS11g_WebGate

3. インストール実行時の指示に従って、インストール・ディレクトリ、以前に作成したアクセス・ゲートの情報およびWebサーバーのhttpd.confファイルの絶対パスを指定します。次に例を示します。

WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/httpd.conf

アクセス・ゲートの情報は、アクセス・システム・コンソールにあります。

4. インストール後、httpd.confファイルの次のエントリの間に新しいセクションが挿入されます。

#** BEGIN WEBGATE SPECIFIC ***
#** END Oblix NetPoint Specific ***

この内容が環境と一致していることをチェックしてください。

5. WebGate 10gをインストールおよび構成したら、第31.2.4項「OAM用のWebLogicドメインの構成」の説明に従ってWeblogicドメインを構成し、第31.2.6項「追加のシングル・サインオン構成」の説明に従って適用される追加のサービスとコンポーネントの構成を行います。

31.2.4 OAM用のWebLogicドメインの構成

環境が複数のドメインにまたがっている場合(例: Spacesのドメイン、別個のSOAのドメインおよび別個のContent Serverのドメイン)、それぞれのドメインについてこの項の手順を繰り返してください。

この項の内容は次のとおりです。

- 第31.2.4.1項「Oracle Internet Directoryオーセンティケータの構成」

- 第31.2.4.2項「OAMアイデンティティ・アサータの構成」

- 第31.2.4.3項「デフォルト・オーセンティケータとプロバイダの順序の構成」

- 第31.2.4.4項「OAMシングル・サインオン・プロバイダの追加」

31.2.4.1 Oracle Internet Directoryオーセンティケータの構成

Oracle Internet DirectoryがOAMアイデンティティ・ストアをバッキングしている場合、Oracle Internet Directoryオーセンティケータ(OracleInternetDirectoryAuthenticator)はOAMのアイデンティティ・ストアとして使用されているLDAPサーバー用に構成し、プロバイダはSUFFICIENTに設定する必要があります。

Oracle Internet Directoryオーセンティケータを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます(図31-4を参照)。

図31-4 「セキュリティ・レルムのサマリー」ペイン

「図31-4 「セキュリティ・レルムのサマリー」ペイン」の説明

3. OIDオーセンティケータを構成するレルム・エントリをクリックします。
レルムの設定ペインが表示されます(図31-5を参照)。

図31-5 設定ペイン

「図31-5 設定ペイン」の説明

4. 「プロバイダ」タブを開きます。
プロバイダの設定が表示されます(図31-6を参照)。

図31-6 設定ペイン - プロバイダ

「図31-6 設定ペイン - プロバイダ」の説明

5. 「新規」をクリックして、プロバイダを作成します。
「新しい認証プロバイダの作成」ペインが表示されます(図31-7を参照)。

図31-7 「新しい認証プロバイダの作成」ペイン

「図31-7 「新しい認証プロバイダの作成」ペイン」の説明

6. 新しいプロバイダの名前(例: OID Authenticator)を入力し、そのタイプとしてOracleInternetDirectoryAuthenticatorを選択して、「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。
オーセンティケータの共通設定ペインが表示されます(図31-8を参照)。

図31-8 共通設定ペイン

「図31-8 共通設定ペイン」の説明

8. 制御フラグをSUFFICIENTに設定し、「保存」をクリックします。

9. 「プロバイダ固有」タブを開きます。
オーセンティケータのプロバイダ固有の設定ペインが表示されます(図31-9を参照)。

図31-9 OIDオーセンティケータのプロバイダ固有の設定

「図31-9 OIDオーセンティケータのプロバイダ固有の設定」の説明

10. 次の表に示されているように、各フィールドに値を入力します。これら以外のフィールドは、デフォルト値のままにします。

フィールド

値

コメント

ホスト:

LDAPサーバーのホストID

ポート:

LDAPサーバーのポート番号

プリンシパル:

LDAP管理者プリンシパル(例: cn=orcladmin)

資格証明:

<password>

管理者プリンシパルのパスワード

資格証明の確認:

<password>

ユーザー・ベースDN:

ユーザー検索ベース - この値はOAM Access Managerのセットアップの値と同じであることが必要

すべてのユーザーのフィルタ:

"(&(uid=*)(objectclass=person))"

ユーザー名属性:

"uid"

グループ・ベースDN:

グループ検索ベース - ユーザー・ベースDNと同じ

取得したユーザー名をプリンシパルとして使用する

選択

通常はユーザー・ログインIDでは大/小文字は区別されません。このフラグは、設定されたサブジェクトに、OIDに格納されたユーザー名が含まれるようにするために必要とされます。

11. 「保存」をクリックします。

31.2.4.2 OAMアイデンティティ・アサータの構成

OAMアイデンティティ・アサータは、プロバイダの制御フラグをREQUIREDに設定して構成する必要があります。

OAMアイデンティティ・アサータを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます(図31-10を参照)。

図31-10 「セキュリティ・レルムのサマリー」ペイン

「図31-10 「セキュリティ・レルムのサマリー」ペイン」の説明

3. OAMアイデンティティ・アサータを構成するレルム・エントリをクリックします。
レルムの設定ペインが表示されます(図31-11を参照)。

図31-11 設定ペイン

「図31-11 設定ペイン」の説明

4. 「プロバイダ」タブを開きます。
プロバイダの設定が表示されます(図31-12を参照)。

図31-12 設定ペイン - プロバイダ

「図31-12 設定ペイン - プロバイダ」の説明

5. 「新規」をクリックして、プロバイダを作成します。
「新しい認証プロバイダの作成」ペインが表示されます(図31-13を参照)。

図31-13 「新しい認証プロバイダの作成」ペイン

「図31-13 「新しい認証プロバイダの作成」ペイン」の説明

6. 新しいプロバイダの名前(例: OAM ID Asserter)を入力し、そのタイプとしてOAMIdentityAsserterを選択して、「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。
オーセンティケータの共通設定ペインが表示されます(図31-14を参照)。

図31-14 共通設定ペイン

「図31-14 共通設定ペイン」の説明

8. 制御フラグをREQUIREDに設定し、OAM_REMOTE_USERとObSSOCookieが「アクティブなタイプ」に設定されていることをチェックします。

9. 「保存」をクリックして、設定を保存します。

31.2.4.3 デフォルト・オーセンティケータとプロバイダの順序の構成

OAMアイデンティティ・アサータを構成したら、デフォルト・オーセンティケータの制御フラグがSUFFICIENTに設定されていることを確認して、次のようにプロバイダを並べ替えます。

1. プロバイダの設定ペインに移動します(図31-12を参照)。

2. デフォルト・オーセンティケータを開き、制御フラグがSUFFICIENTに設定されていることを確認します。

3. 先ほど作成した2つのプロバイダ以外の全プロバイダについて、同じことを行います。

4. 設定ペインで、プロバイダを次のように並べ替えます。

- OAMIdentityAsserter (REQUIRED)

- OracleInternetDirectoryAuthenticator (SUFFICIENT)

- DefaultAuthenticator (SUFFICIENT)

- DefaultIdentityAsserter

5. 第31.2.6.1項「SSO用のWebCenter Portal: Spacesの構成」の説明に従って、シングル・サインオン・モード用にSpacesを構成します。また、第31.2.6項「追加のシングル・サインオン構成」の説明に従って、環境に適用される他のサービスおよびコンポーネントの構成を行ってください。

31.2.4.4 OAMシングル・サインオン・プロバイダの追加

デフォルト・オーセンティケータの制御フラグが適切に設定されていることとプロバイダの順序が正しいことをチェックしたら、次で説明されているように、OAM SSOプロバイダを追加して、すべてのサーバーを再起動します。

注意:

これはOAM 11gの場合は必要ですが、OAM 10gの場合はログアウトURIが明示的に構成されている場合のみ必要です。

1. WLSTを使用してWebLogicドメインに接続し、次のコマンドを実行します。

addOAMSSOProvider(loginuri="/${app.context}/adfAuthentication", logouturi="/oamsso/logout.html")

2. すべてのサーバーを再起動します。

31.2.5 Oracle HTTP Serverのインストールと構成

この手順はOAM 10gとOAM 11gの両方に共通で、OAMのインストールおよび構成後、WebLogicドメインの構成前に実行する必要があります。

Oracle HTTP Server(OHS)をインストールおよび構成する手順は次のとおりです。

1. 使用したいOHSのインストールがまだない場合は、Oracle Fusion Middleware Oracle Web層インストレーション・ガイドのOracle Web層のインストールに関する項の指示に従ってOracle HTTP Server(11.1.1.4.0)をインストールします。既存のインストールがある場合は、Oracle Fusion Middlewareパッチ適用ガイドの最新のOracle Fusion Middlewareパッチ・セットの適用に関する項の説明に従ってパッチを適用して、OHS (11.1.1.4.0)にする必要があります。

2. mod_wl_ohs.confの次の例を使用して、WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHSを構成します。WebLogicポート番号が構成と一致するようにしてください。詳細は、Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOAM用のOracle HTTP Server 11g WebGateのインストールと構成に関する項を参照してください。

注意:

この例では、WebCenter Portalが非クラスタベースのインストールであることを前提としています。クラスタ環境の場合は、WebLogicHostとWebLogicPortを環境の必要に応じてWeblogicClusterに変更してください。詳細は、Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイドのOAM用のOracle HTTP Server 11g WebGateのインストールと構成に関する項を参照してください。

# NOTE : This is a template to configure mod_weblogic.

LoadModule weblogic_module   "${ORACLE_HOME}/ohs/modules/mod_wl_ohs.so"

# This empty block is needed to save mod_wl related configuration from EM to this file when changes are made at the Base Virtual Host Level
<IfModule weblogic_module>
#      WebLogicHost <WEBLOGIC_HOST>
#      WebLogicPort <WEBLOGIC_PORT>
#      Debug ON
#      WLLogFile /tmp/weblogic.log
#      MatchExpression *.jsp

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /webcenterhelp>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rss>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rest>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /owc_discussions>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /activitygraph-engines>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /wcps>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /workflow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/worklistapp>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/services>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /soa-infra>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /sdpmessaging/userprefs-ui>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /DefaultToDoTaskFlow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /cs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /pagelets>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /services-producer>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /wsrp-tools>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

</IfModule>

# <Location /weblogic>
#      SetHandler weblogic-handler
#      PathTrim /weblogic
#      ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
#  </Location>

注意:

前述のLocationリストのエントリは、着信パスを、対応するアプリケーションが常駐する適切なWebLogic Server管理対象サーバーにマップします。

31.2.6 追加のシングル・サインオン構成

次の項で説明する構成は、サイトのセキュリティを強化するために必要であるか、または役に立ちます。これらの構成が完了したら、第31.2.7項「OAMインストールのテスト」の説明に従ってOAMインストールのテストを行ってください。

- 第31.2.6.1項「SSO用のWebCenter Portal: Spacesの構成」

- 第31.2.6.2項「SSO用のディスカッション・サーバーの構成」

- 第31.2.6.3項「SSO用のワークリスト・サービスの構成」

- 第31.2.6.4項「外部リーダーを使用したRSSフィード用のOAMの構成」

- 第31.2.6.5項「OAM 10g用のWebLogic Server管理コンソールとEnterprise Managerの構成」

- 第31.2.6.6項「OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成」

- 第31.2.6.7項「SSO用のSecure Enterprise Searchの構成」

- 第31.2.6.8項「SSO用のContent Serverの構成」

- 第31.2.6.9項「接続フィルタを使用したアクセスの制限」

- 第31.2.6.10項「ポートレット・プロデューサと追加コンポーネントの構成」

31.2.6.1 SSO用のWebCenter Portal: Spacesの構成

SpacesアプリケーションをSSO用に構成するには、EXTRA_JAVA_PROPERTIESに設定を追加します。

アプリケーションがSSOモードに構成されており、特別な処理が必要であることをWebCenter PortalとADFに伝えるシステム・プロパティがあります。このモードでは、次のシステム・プロパティが必要とされます。

フィールド

値

コメント

oracle.webcenter.spaces.osso

true

このフラグはSSOが使用されていることをWebCenter Portalに告げるため、デフォルトのランディング・ページにログイン・フォームは表示されなくなります。そのかわりにログイン・リンクが表示され、ユーザーはこれをクリックしてSSO認証を呼び出すことができます。

このプロパティを設定するには、<domain>/binディレクトリにあるsetDomainEnv.shスクリプトを編集し、次のようなエントリを追加します。

EXTRA_JAVA_PROPERTIES="-Doracle.webcenter.spaces.osso=true ${EXTRA_JAVA_PROPERTIES}"
export EXTRA_JAVA_PROPERTIES

この変更を行ったら、WC_Spacesサーバーを再起動します。

31.2.6.2 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のOracle WebCenter Portalのディスカッション・サーバーを構成する方法について説明します。SSO用のディスカッション・サーバーを構成する前に、第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、Spacesと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。デフォルトの管理者アカウントを外部LDAPに移動しない場合は、第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」の手順にも従ってください。

SSO用のディスカッション・サーバーを設定する手順は次のとおりです。

1. Oracle WebCenter Portalのディスカッション・サーバー管理コンソールにログインします。

http://host:port/owc_discussions/admin

hostおよびportは、WC_Collaboration管理対象サーバーのホストIDとポート番号です。

2. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを編集(存在している場合)または追加します(値をtrueに設定します)。

3. Web層のベースURLをポイントするようにjiveURLプロパティを編集または追加します。次に例を示します。

jiveURL = webtier.example.com:7777/owc_discussions

jiveURLプロパティは、電子メールのフォーラムへのリンクを構築する際に使用されます。

31.2.6.2.1 Spaces用のディスカッション・サーバー接続の作成

この項では、Web層のホストおよびポートの値を使用するようにSpaces用のディスカッション・サーバー接続を更新する方法を説明します。次の手順では、ディスカッション・サービスがWebCenter Portalドメインにすでにインストールおよび構成されていることを前提としています。

1. Fusion Middleware ControlまたはWLSTを使用して、ディスカッション・サーバーのURLホストおよびポート設定をWC_Spaces管理対象サーバーの設定からWeb層のホストおよびポート設定に変更します。これらの設定の変更方法については、第14.5項「ディスカッション・サーバー接続の詳細の変更」を参照してください。

2. WC_Spaces管理対象サーバーを再起動します。
Spacesにログインすると、ディスカッション・サーバーにも自動的にサインオンします。

31.2.6.3 SSO用のワークリスト・サービスの構成

すでにワークリスト接続をセットアップしてある場合は、SOAサーバーのホストとポートのかわりにWeb層のホストとポートを使用するようにURLを変更します。これは第23.4項「ワークリスト接続の設定」の説明に従って、Fusion Middleware ControlまたはWLSTコマンドを使用して行うことができます。

URLを変更してOAM SSOに必要なセットアップを完了したら、WebCenter Portal管理サーバー上で次のコマンドを実行してワークリスト・サービスの変更を有効にします。

setBPELConnection('webcenter','WebCenter-Worklist', 'http://webtier.example.com:7777')

31.2.6.4 外部リーダーを使用したRSSフィード用のOAMの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護された状態では、外部リーダーでRSSフィードがうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースをOAMポリシーから除外することをお薦めします。

この項の内容は次のとおりです。

- 第31.2.6.4.1項「OAM 11gのRSSフィードの非保護」

- 第31.2.6.4.2項「OAM 10gのRSSフィードの非保護」

31.2.6.4.1 OAM 11gのRSSフィードの非保護

OAM 11gのRSSフィードを非保護にする手順は次のとおりです。

1. OAM管理コンソールを開きます。

2. 「ポリシー構成」タブを開いて、「アプリケーション・ドメイン」→<該当するアプリケーション・ドメイン>を選択します。

3. 「リソース」タブを開いて、/rss*を検索します。
結果の中に、次のような項目が表示されるはずです。

/rss*

/rss/.../*

/rss/rssservlet*

/rss/rssservlet/.../*

4. それぞれのリソースについて、そのリソースを選択して「編集」をクリックします。

5. 各リソースの保護レベルをProtectedからExcludedに変更して、「適用」をクリックします。
リソースの認証ポリシーと認可ポリシーが削除されることに注意してください。

6. タブを閉じてOHSを再起動します。

31.2.6.4.2 OAM 10gのRSSフィードの非保護

OAM 10gのRSSフィードを非保護にする手順は次のとおりです。

1. OAM管理コンソールを開きます。

2. 「アクセス・システム・コンソール」→「ポリシー・マネージャ」を選択し、適切なポリシー・ドメインを開きます。

3. 「ポリシー」タブを開き、Exclusion Schemeポリシーを選択して、「変更」をクリックします。

4. 除外するために次のリソースを選択します。
/rss

/rss/rssservlet

5. 「保存」をクリックします。

6. Default Public Policyを選択して、「変更」をクリックします。

7. /rss resourceを選択解除して、「保存」をクリックします。

8. OHSを再起動します。

31.2.6.5 OAM 10g用のWebLogic Server管理コンソールとEnterprise Managerの構成

この項では、WebLogic Server管理コンソールとEnterprise ManagerのためにオプションでOAMシングル・サインオンをセットアップする方法を説明します。

注意:

Enterprise ManagerとWebLogic Server管理コンソールに対してOAM SSOをセットアップすると、OAM SSOアクセスが構成されている同じユーザー・セットでシングル・サインオン・アクセスが可能になります。OAMを通じて外部ユーザーがWeb層にアクセスできるようにし、一方、管理者はEnterprise ManagerとWebLogic Server管理コンソールに直接ログインするようにしたいときは、この追加の構成手順を実行する必要がない場合もあります。

WebLogic Server管理コンソールとEnterprise ManagerのOAM SSOをセットアップする手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。

http://host:port/access/oblix

hostはAccess ManagerをホストするサーバーのホストID(例: oam.example.com)、portはHTTPポート番号(例: 8888)になります。

2. 「ポリシー・マネージャ」をクリックします。
「ポリシー・マネージャ」ペインが表示されます(図31-15を参照)。

図31-15 「ポリシー・マネージャ」ペイン

「図31-15 「ポリシー・マネージャ」ペイン」の説明

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。
「リソース」ページが表示されます(図31-16を参照)。

図31-16 ポリシー・ドメインの「リソース」ページ

「図31-16 ポリシー・ドメインの「リソース」ページ」の説明

5. 保護する必要のあるリソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてhttpを選択します。

2. WebCenter Portal Web層のホストIDを選択します。

3. 「URL接頭辞」に、WebLogic Server管理コンソールのURL接頭辞(/console)またはEnterprise ManagerのURL接頭辞(/em)を入力します。

4. リソースの説明を入力します。

5. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

6. Web層で、mod_wl_ohs.confファイル(WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/にあります)を、WebLogic Server管理コンソールとEnterprise Managerが含まれるように変更します。それには、WebLogicHostに、WebCenter Portal管理サーバーの実際のホストIDを使用して、場所のエントリを2つ追加します。

<Location /console>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

<Location /em>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

7. 変更を有効にするために、Oracle HTTP Serverを再起動します。
これで、次のリンクでWebLogic Server管理コンソールとEnterprise Managerにアクセスできるようになります。

http://host:OHS port/console
http://host:OHS port/em

OAM SSOログイン・フォームが表示されます。

31.2.6.6 OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成

この項では、WebLogic Server管理コンソールとEnterprise ManagerのためにオプションでOAM 11gシングル・サインオンをセットアップする方法を説明します。

注意:

Enterprise ManagerとWebLogic Server管理コンソールに対してOAM SSOをセットアップすると、OAM SSOアクセスが構成されている同じユーザー・セットでシングル・サインオン・アクセスが可能になります。OAMを通じて外部ユーザーがWeb層にアクセスできるようにし、一方、管理者はEnterprise ManagerとWebLogic Server管理コンソールに直接ログインするようにしたいときは、この追加の構成手順を実行する必要がない場合もあります。

WebLogic Server管理コンソールとEnterprise Managerに対してOAM 11g SSOをセットアップする手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインします。

http://host:port/oamconsole

2. 「ポリシー構成」→「アプリケーション・ドメイン」に移動します。
「ポリシー・マネージャ」ペインが表示されます。

3. WebGateエージェントの登録時の名前を使用して、作成したアプリケーション・ドメインを見つけます。

4. リソース・ノードを展開して「作成」をクリックします。
「リソース」ページが表示されます。

5. 保護する必要のあるリソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてhttpを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. 「リソースURL」に、WebLogic Server管理コンソールのリソースURL(/console)またはEnterprise ManagerのリソースURL(/em)を入力します。

4. リソースの「説明」を入力して、「適用」をクリックします。

6. 「認証ポリシー」→「保護されたリソース・ポリシー」に移動して、新しく作成されたリソースを追加します。

7. 「認可ポリシー」→「保護されたリソース・ポリシー」についても同じことを行います。

8. Web層で、mod_wl_ohs.confファイル(WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/にあります)を、WebLogic Server管理コンソールとEnterprise Managerが含まれるように変更します。それには、WebLogicHostに、WebCenter Portal管理サーバーの実際のホストIDを使用して、場所のエントリを2つ追加します。

<Location /console>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

<Location /em>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

9. 変更を有効にするために、Oracle HTTP Serverを再起動します。
これで、次のリンクでWebLogic Server管理コンソールとEnterprise Managerにアクセスできるようになります。

http://host:OHS port/console
http://host:OHS port/em

OAM SSOログイン・フォームが表示されます。

31.2.6.7 SSO用のSecure Enterprise Searchの構成

WebCenter PortalとSESに定義された対応する認証エンド・ポイントが使用するWebCenter Portalデータとリポジトリをクロールするために定義されるクロール・ソースは、適切に認証されるようにWeb層OHSポートを通してルーティングする必要があります(認証方式は引き続きBASICおよびレルムjazn.comになります)。SES接続の構成に関する詳細は、第22.4項「Oracle SES接続の設定」を参照してください。

31.2.6.8 SSO用のContent Serverの構成

SSOのセットアップが完了し、Content Serverの接続をセットアップしたら、Fusion Middleware Controlを使用して、または次のWLSTの例のように、JCRContentServerConnectionにWebコンテキスト・ルートを指定します。

setJCRContentServerConnection(appName, name, webContextRoot='/cs')

Webコンテキスト・ルートを設定することで、SSOがセットアップされていることをドキュメント・ライブラリのコードに伝えます。この設定は、SSOを完全にセットアップするまでは設定しないでください。

31.2.6.9 接続フィルタを使用したアクセスの制限

ユーザーが適切に認証されるように、Web層OHSポートを通してのみWebCenter Portalと他のサービスへのアクセスを許可するには、次の手順に従います。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. ドメイン構造ペインで、構成するドメインを選択します(例: webcenter)。

3. 「セキュリティ」タブを開き、「フィルタ」サブタブを開きます。
セキュリティ・フィルタの設定ペインが表示されます(図31-17を参照)。

図31-17 セキュリティ・フィルタの設定ページ

「図31-17 セキュリティ・フィルタの設定ページ」の説明

4. 「接続ログの有効化」を選択して、受け入れられたメッセージのログを有効にします。
接続ログは、成功した接続と接続データをサーバーにログします。この情報を使用して、サーバー接続に関する問題をデバッグできます。

5. 「接続フィルタ」フィールドに、ドメインで使用する接続フィルタ・クラスを指定します。

- デフォルトの接続フィルタを構成するには、weblogic.security.net.ConnectionFilterImplと指定します。

- カスタム接続フィルタを構成するには、ネットワーク接続フィルタを実装するクラスを指定します。このクラスはWebLogic ServerのCLASSPATHにも指定されていることが必要です。

6. 「接続フィルタ・ルール」フィールドに、接続フィルタ・ルールの構文を入力します。
次に例を示します。

<webtier IP>/0 * * allow
0.0.0.0/0  *  *  deny

これは、ローカル・ホストからの全トラフィックを許可し、他のIPアドレスからの全トラフィックを拒否するように指定しています。もちろん、環境に適切なネットワーク・フィルタを作成する必要があります。接続フィルタの作成に関する詳細は、Oracle Fusion Middleware Oracle WebLogic Serverプログラミング・セキュリティのカスタム接続フィルタの開発に関する項を参照してください。

7. 「保存」をクリックして、変更を有効にします。

8. すべての管理対象サーバーと管理サーバーを再起動します。

9. WebLogic Serverへのすべての直接トラフィックが、次へのナビゲートを試行することでブロックされることを検証します。

http://host:WLS_port/webcenter

これによって次のエラーが生成されます。

"The Server is not able to service this request: [Socket:000445]Connection rejected, filter blocked Socket, weblogic.security.net.FilterException: [Security:090220]rule 3"

ただし、OHSポートを通してWebCenter Portalにアクセスすることは今でも可能です。

http://host:OHS_port/webcenter

31.2.6.10 ポートレット・プロデューサと追加コンポーネントの構成

OHSを通してルーティングされるようにポートレット・プロデューサ・アプリケーションをセットアップした場合は、登録用のプロデューサURLを指定する際に必ずOHSホストおよびポートを使用してください。これは、wsrp-toolsのようなデフォルトのプロデューサ、サービス・プロデューサ、ページレット・プロデューサおよび明示的に構成した他のプロデューサに適用されます。

31.2.7 OAMインストールのテスト

OAM 10gまたは11gをインストールおよび構成したら、構成された次のすべての(環境に適用される)アプリケーションにアクセスできることと、グローバル・ログインおよびログアウトによって再度サインインを要求されることなく構成されたすべてのアプリケーションにアクセスできることをチェックします。また、利用できる状況でグローバル・ログアウトもテストして、関連する他のすべてのアプリケーションからログアウトすることを確認してください。

- Spaces: 保護されたすべてのSpaces URL(例: 保護されたスペース)にアクセスして、SSOログイン・チャレンジが表示されることを確認します。同じSSOを使用する別の関連アプリケーションにすでにログインしている場合は、コンテンツが自動的に表示されます。

- REST: http://ohshost:ohsport/rest/api/resourceIndexにアクセスします。BASIC認証チャレンジが表示されるはずです。同じSSOを使用する別の関連アプリケーションにすでにログインしている場合は、コンテンツが自動的に表示されます。

- REST: http://ohshost:ohsport/rest/api/cmis/....にアクセスします (これは前の手順のresourceIndexアクセス出力から取得します)。ログイン・チャレンジは表示されず、パブリック・コンテンツを表示できるはずです。ログイン後にこれにアクセスすると、アクセス権を持つすべてのコンテンツが表示されるはずです。

- アクティビティ・グラフ・エンジン: http://host:port/activitygraph-enginesにアクセスします。SSOログイン・チャレンジが表示されるはずです。ログインすると、コンテンツを表示できるはずです。

- Content Server: プロファイルのUIに移動して、ログインへのチャレンジなしでiFramesに埋め込まれたContent Server画面を表示できることをチェックします。また、すでにSpacesアプリケーションにログインしているので、ログインしないでコンテンツ・プレゼンタ・テンプレートでSite Studioのコンテンツにアクセスできるはずです。

- SOA: ワークフロー・タスク・フローのリンクにアクセスして、ログインをチャレンジされないことを確認します。

- ディスカッション・フォーラム: http://host:port/owc_discussionsのディスカッション・アプリケーションにアクセスし、ログインします。ログインがSSOログインのチャレンジであることをチェックします。同様に、http://host:port/owc_discussions/adminのディスカッション・サーバーへの管理ログインも、SSOログイン・チャレンジを通したものになるはずです。

31.3 Oracle Single Sign-On(OSSO)の構成

デフォルトのインストールでは、WebCenter PortalはWebCenter Portal用に作成された管理対象サーバーのHTTPポートを使用します。Oracle Single Sign-Onを使用してWebCenter Portalアプリケーションを構成するためには、WebCenter PortalはOracle Single Sign-On(OSSO)と統合するために、Oracle HTTP Serverおよび関連付けられたモジュールmod_ossoを必要とします。第32.5項「OSSOに対するFrameworkアプリケーションの構成」で説明されているように、Frameworkアプリケーションの場合は、追加の構成がいくつか必要になることに注意してください。

注意:

BPELコンソールはSSOの統合をサポートしません。WebCenter PortalがSSO用に構成されている場合も、BPELへのログインはBPELコンソール上で標準ログイン・ページを通して行う必要があります。

この項の内容は次のとおりです。

- 第31.3.1項「OSSO構成のロードマップ」

- 第31.3.2項「OSSOのコンポーネントとトポロジ」

- 第31.3.3項「Oracle HTTP Serverと関連モジュールの構成」

- 第31.3.4項「OSSOIdentityAsserterの構成」

- 第31.3.5項「Oracle SSOへのOHSの登録」

- 第31.3.6項「追加構成」

31.3.1 OSSO構成のロードマップ

この項のフロー・チャート(図31-18)と表(表31-2)は、OSSOを使用してWebCenter Portalのシングル・サインオンを構成する際の前提条件と必要なタスクの概要を示しています。

図31-18 OSSOを使用したWebCenter Portalのシングル・サインオンの構成

「図31-18 OSSOを使用したWebCenter Portalのシングル・サインオンの構成」の説明

表31-2は、OSSOを使用してWebCenter Portalのシングル・サインオンを構成するためのタスクとサブタスクを示しています。

表31-2 OSSOを使用したWebCenter Portalのシングル・サインオンの構成

担当者

タスク

サブタスク

ノート

Administrator

1. Oracle HTTP Serverと関連モジュールの構成

1.a Web層のインストール

1.b Web層OHS内のmod_wlモジュールの構成

2. OSSOIdentityAsserterの構成

3. Oracle SSOへのOHSの登録

4. 必要に応じた追加構成の実行

4.a SSO用のSpacesの構成

4.b Web層OHSポートを通したWebCenterとサービスへのアクセスの制限

4.c SSO用のディスカッション・サーバーの構成

31.3.2 OSSOのコンポーネントとトポロジ

デフォルトのインストールでは、WebCenter PortalはWebCenter Portal用に作成された管理対象サーバーのHTTPポートを使用します。Oracle Single Sign-Onを使用してWebCenter Portalを構成するためには、WebCenter PortalはOracle SSOと統合するために、Oracle HTTP Serverおよび関連付けられたモジュールmod_ossoを必要とします。次の図(図31-19)は、この統合の全体的なアーキテクチャを示しています。

図31-19 OSSOのコンポーネントとトポロジ

「図31-19 OSSOのコンポーネントとトポロジ」の説明

31.3.3 Oracle HTTP Serverと関連モジュールの構成

この項では、Oracle HTTP Serverと関連付けられたモジュールのロードおよび構成方法を説明します。

Oracle HTTP Serverおよび関連付けられたモジュールをロードおよび構成する手順は次のとおりです。

1. Oracle HTTP Server(OHS)および関連付けられたモジュール(mod_ossoおよびmod_wl)を含むOracle Web層ソフトウェアをインストールします。

2. WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHS内のmod_wlモジュールを構成します。ホストとポートの値には、ローカル環境の値を指定してください。
${ORACLE_HOME}/ohs/modules/mod_wl_ohs.soの行を非コメント化します。このファイルは次のような内容で、httpd.confファイルによりインクルードされます。

# NOTE : This is a template to configure mod_weblogic.

LoadModule weblogic_module   "${ORACLE_HOME}/ohs/modules/mod_wl_ohs.so"

# This empty block is needed to save mod_wl related configuration from EM to this file when changes are made at the Base Virtual Host Level
<IfModule weblogic_module>
#      WebLogicHost <WEBLOGIC_HOST>
#      WebLogicPort <WEBLOGIC_PORT>
#      Debug ON
#      WLLogFile /tmp/weblogic.log
#      MatchExpression *.jsp

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /webcenterhelp>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rss>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rest>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /services-producer>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /wsrp-tools>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /owc_discussions>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /activitygraph-engines>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /wcps>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /workflow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/worklistapp>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/services>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /soa-infra>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /sdpmessaging/userprefs-ui>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /DefaultToDoTaskFlow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /cs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

</IfModule>

# <Location /weblogic>
#      SetHandler weblogic-handler
#      PathTrim /weblogic
#      ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
#  </Location>

31.3.4 OSSOIdentityAsserterの構成

WebCenter Portal用のOracle WebLogicドメインにOSSO Identity Assertion Provider(IAP)プロバイダを追加します。次の手順に従って、WebLogic Server管理コンソールを使用してOSSO IAPをドメインに追加します。環境が複数のドメインにまたがっている場合(例: Spacesのドメイン、別個のSOAのドメインおよび別個のContent Serverのドメイン)、それぞれのドメインについてこの項の手順を繰り返してください。

OSSOIdentityAsserterを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます(図31-20を参照)。

図31-20 「セキュリティ・レルムのサマリー」ペイン

「図31-20 「セキュリティ・レルムのサマリー」ペイン」の説明

3. プロバイダを追加するレルム・エントリをクリックします。
レルムの設定ペインが表示されます(図31-21を参照)。

図31-21 設定ペイン

「図31-21 設定ペイン」の説明

4. 「プロバイダ」タブをクリックします。
プロバイダの設定が表示されます(図31-22を参照)。

図31-22 設定ペイン - プロバイダ

「図31-22 設定ペイン - プロバイダ」の説明

5. 「新規」をクリックして、プロバイダを作成します。
「新しい認証プロバイダの作成」ペインが表示されます(図31-23を参照)。

図31-23 「新しい認証プロバイダの作成」ペイン

「図31-23 「新しい認証プロバイダの作成」ペイン」の説明

6. 新規のプロバイダの名前を入力し、タイプとして「OSSOIdentityAsserter」を選択して「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。

8. 制御フラグをOPTIONALに設定します。

9. 関連付けられたOracle Internet Directoryサーバーからユーザー・プロファイルを取得できるように、OracleInternetDirectoryAuthenticator(または外部LDAPを使用するようにアイデンティティ・ストアを構成した際に選択したプライマリ・オーセンティケータ)がドメインのプライマリ・オーセンティケータとして設定されていることを確認します。外部LDAPを使用するようにアイデンティティ・ストアを構成する方法については、第29章「アイデンティティ・ストアの構成」を参照してください。
OIDについて、次のようにプロバイダ・リストが表示されます。

- OSSOIdentityAsserter (OPTIONAL)

- OracleInternetDirectoryAuthenticator (SUFFICIENT)

- DefaultAuthenticator (SUFFICIENT)

- DefaultIdentityAsserter (OPTIONAL)

31.3.5 Oracle SSOへのOHSの登録

次の手順に従って、Web層OHS内のモジュールmod_ossoをパートナ・アプリケーションとしてSSOサーバーに登録します。

Oracle SSOにOHSを登録する手順は次のとおりです。

1. SSOサーバーからssoregを実行してosso.confファイルを生成し、バイナリ・モードでFTPを使用してWeb層ホスト(WT_ORACLE_HOME)にこれを転送します。
次の例に、SSOサーバーでリモート・パートナ・アプリケーションを登録する方法を示します。ssoreg.shを実行する前に、ORACLE_HOME環境変数が設定されていることをチェックします(ここでのORACLE_HOMEは、SSOサーバー上のOSSOインストールのORACLE_HOMEです)。

bash-3.00$ ORACLE_HOME/sso/bin/ssoreg.sh -site_name
webtier.example.com:80 -config_mod_osso TRUE -mod_osso_url
http://webtier.example.com:80 -remote_midtier  -config_file
webtier.example.com.osso.conf

このコマンドを実行すると、webtier.example.com.osso.confファイルが作成されます。

2. WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/disabled/mod_osso.confファイルをWT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/moduleconfにコピーします。moduleconfディレクトリ内のすべてのファイルがhttpd.confファイルにインクルードされます。

3. 手順1でssoregによって生成されたwebtier.example.com.osso.confファイルを、Web層のmoduleconfディレクトリ以外のアクセス可能な場所(例: WT_ORACLE_HOME)にコピーします。

注意:

FTPを使用する場合は、必ずバイナリ・モードを使用してファイルを転送してください。

4. /webcenterと関連するアプリケーション・リソースのURLをOracle SSOを使用して保護するためのルールをmod_osso.confファイルに追加します。
mod_osso.confファイルは次のようになります。

LoadModule osso_module "${ORACLE_HOME}/ohs/modules/mod_osso.so"

<IfModule osso_module>
OssoIpCheck off
OssoIdleTimeout off
OssoSecureCookies Off

#Point to proper osso.conf file.
OssoConfigFile /scratch/pyarashi/ohs/dadvmi0003.osso.conf
#
# Insert Protected Resources: (see Notes below for
# how to protect resources)
#
#______-
#
# Notes
#
#______-
#
# 1. Here's what you need to add to protect a resource,
#    e.g. <ApacheServerRoot>/htdocs/private:
#
#      <Location /private>
#      require valid-user
#      AuthType Osso
#      </Location>

<Location /webcenter/adfAuthentication*>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /services-producer/adfAuthentication*>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rss/rssservlet>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/login!withRedirect.jspa>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/login!default.jspa>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/login.jspa>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/admin>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /integration/worklistapp>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /sdpmessaging/userprefs-ui>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /workflow/WebCenterWorklistDetail>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /workflow/sdpmessagingsca-ui-worklist>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/resourceIndex>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/spaces>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/discussions>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/tags>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/taggeditems>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/activities>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/activitygraph>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/feedback>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/people>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/messageBoards>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/searchresults>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /pagelets/admin>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /pagelets/authenticateWithApplicationServer*>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /activitygraph-engines>
OssoSendCacheHeaders off
require activity-graph-admins
AuthType Osso
</Location>
<Location /wcps/api>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /cs/groups>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /cs/idcplg>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /adfAuthentication>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
</IfModule>

#
# To have short hostnames redirected to fully qualified
# hostnames for clients that need authentication via
# mod_osso to be able to enter short hostnames into their
# browsers use a mod_rewrite configuration such as the following.
#
# e.g
#RewriteEngine On
#RewriteCond %{HTTP_HOST} !www.example.com
#RewriteRule ^.*$
http://%{SERVER_NAME}%{REQUEST_URI}
[R]
#where www.example.com is the fully qualified domain name.

OssoConfigFileパラメータは、前の手順でosso.confファイルをコピーした場所(および変更した場合はファイル名)をポイントするように必ず変更してください。環境が非SSLの場合は、OSSOセキュアCookie(デフォルトでオン)を必ずオフにしてください(OssoSecureCookies Off)。

5. mod_ossoおよびmod_wlの構成変更が有効になるように、Web層を再起動します。

31.3.6 追加構成

次の項で説明する構成は、サイトのセキュリティを強化するために必要であるか、または役に立ちます。Frameworkアプリケーションの場合は、第32.5項「OSSOに対するFrameworkアプリケーションの構成」で説明されている追加の構成も必要になります。

- 第31.3.6.1項「SSO用のWebCenter Portal: Spacesの構成」

- 第31.3.6.2項「Web層OHSポートを使用したアクセスの制限」

- 第31.3.6.3項「SSO用のディスカッション・サーバーの構成」

- 第31.3.6.4項「SSO用のワークリスト・サービスの構成」

- 第31.3.6.5項「SSO用のOracle Content Serverの構成」

- 第31.3.6.6項「外部リーダーを使用したRSSフィード用のOSSOの構成」

- 第31.3.6.7項「SSO用のSESクロールの構成」

31.3.6.1 SSO用のWebCenter Portal: Spacesの構成

第31.2.6.1項「SSO用のWebCenter Portal: Spacesの構成」の説明に従ってEXTRA_JAVA_PROPERTIESに設定を追加してリブートすることで、Spaces用のOracle Single Sign-on(OSSO)の構成を行ってください。

31.3.6.2 Web層OHSポートを使用したアクセスの制限

ユーザーが適切に認証されるように、Web層OHSポートを通してのみWebCenter Portalと他のサービスへのアクセスを許可するには、第31.2.6.9項「接続フィルタを使用したアクセスの制限」の手順に従います。

31.3.6.3 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のOracle WebCenter Portalのディスカッション・サーバーを構成する方法について説明します。SSO用のディスカッション・サーバーを構成する前に、第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」の説明に従って、Spacesと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。

SSO用のディスカッション・サーバーを設定する手順は次のとおりです。

1. Oracle WebCenter Portalのディスカッション・サーバー管理コンソールにログインします。

http://host:port/owc_discussions/admin

hostおよびportは、WC_Collaboration管理対象サーバーのホストIDとポート番号です。

2. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを編集(存在している場合)または追加します(値をtrueに設定します)。

3. Web層のベースURLをポイントするようにjiveURLプロパティを更新します。

31.3.6.4 SSO用のワークリスト・サービスの構成

第31.3.5項「Oracle SSOへのOHSの登録」の説明に従ってOracle SSOにOHSを登録したら、WebCenter Portal管理サーバーで次のコマンドを実行して、ワークリスト・サービスの変更を有効にします。

setBPELConnection('webcenter','WebCenter-Worklist', 'http://webtier.example.com:7777')

31.3.6.5 SSO用のOracle Content Serverの構成

Content ServerリポジトリにはSpacesから直接アクセスできるので、これもシングル・サインオン構成に含めることが可能です。Content Serverの接続をセットアップしたら、Fusion Middleware Controlを使用して、または次の例のようにWLSTを使用して、JCRContentServerConnectionにWebコンテキスト・ルートを指定します。

setJCRContentServerConnection(appName, name, webContextRoot='/cs')

Content Serverの構成方法の詳細は、Oracle WebCenter Content Content Serverシステム管理者ガイドのシングル・サインオンを使用するためのContent Serverの構成に関する項を参照してください。

31.3.6.6 外部リーダーを使用したRSSフィード用のOSSOの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護された状態では、外部リーダーでRSSフィードがうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースを非保護にすることをお薦めします。

次の手順に従って、RSSフィードを非保護にします。

1. mod_osso.confから次のエントリを削除します。

<Location /rss/rssservlet>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>

2. OHSを再起動します。

31.3.6.7 SSO用のSESクロールの構成

インスタンスにSESを構成してある場合は、オプションとしてWeb層URLを使用するようにWebCenter Portalのクロールおよび認証エンド・ポイントを更新できます。詳細は第22章「WebCenter PortalでのOracle SES検索の管理」を参照してください。

31.4 SAMLベースのシングル・サインオンの構成

Security Assertion Markup Language(SAML)によって、WebLogic ServerドメインおよびWebブラウザまたは他のHTTPクライアントで実行されているWebアプリケーションやWebサービス間でクロスプラットフォームの認証が可能になります。WebLogic Serverは、ページレット・プロデューサ・アプリケーションを除くすべてのWebCenter Portalアプリケーションに対して、SAMLに基づくシングル・サインオン(SSO)をサポートします。シングル・サインオン(SSO)構成に参加する1つのサイトでユーザーが認証されると、SSO構成の他のサイトでも自動的に認証され、別途ログインする必要はありません。ページレット・プロデューサ・アプリケーションはSAML SSOに参加しないので、ページレット・プロデューサ・アプリケーションにアクセスするユーザーは明示的にログインする必要があることに注意してください。また、第32.6項「SAML SSOに対するFrameworkアプリケーションの構成」で説明されているように、Frameworkアプリケーションの場合は、追加の構成がいくつか必要になることにも注意してください。

注意:

SAMLベースのシングル・サインオンは、初回サインオン後の後続のアプリケーションへのユーザーのログオンはサポートしますが、グローバル・ログアウトはサポートしません。このため、ユーザーは、開いた各アプリケーションを個々にログアウトする必要があります。

また、Spacesをソース・アプリケーション、ディスカッションを宛先アプリケーションとして使用して、SAMLベースのシングル・サインオンをセットアップすると、管理者はSpaces管理(「構成」→「サービス」)とSpace設定(「サービス」ページ)からディスカッション管理ページにアクセスできることにも注意してください。ただし、ディスカッション管理ページはSSOに参加しないので、管理ページに直接アクセスすると、ディスカッション・サーバーに再度ログインすることが必要となります。

さらに、SAMLベースのシングル・サインオンは、sdpmessaging userprefs-uiアプリケーションでは使用できません。アプリケーション管理者がSpacesの「プリファレンス」→「メッセージング」ダイアログで「構成の管理」をクリックと、再度ログインすることが必要になります。

このSSOメカニズムは、Oracle SSOまたはOracle Access Managerシングル・サインオン・インフラストラクチャがまだ存在しておらず、Spacesとそのサービス間のみのシングル・サインオンが必要とされる部門別のWebCenter Portalのインストールに使用できます。大規模エンタープライズの高可用性展開では、Oracle Access Manager SSO構成をお薦めします。

この項では、同じドメイン内の異なる管理対象サーバー上で実行されるWebCenter Portal: Spacesおよびワークリスト・サービスに対してSAML 1.1ベースのシングル・サインオンをセットアップする方法を説明します。

この項の内容は次のとおりです。

- 第31.4.1項「SAMLのコンポーネントとトポロジ」

- 第31.4.2項「SAMLベースのシングル・サインオンの構成」

31.4.1 SAMLのコンポーネントとトポロジ

図31-25は、Spacesとディスカッション・サービスを含むSAMLベースのシングル・サインオン構成のコンポーネントとその対話を示しています。

SAMLベースのシングル・サインオン・ソリューションは、次のコンポーネントから構成されます。

- SAML資格証明マッパー - SAML資格証明マッピング・プロバイダは、SAMLセキュリティ・アサーションのプロデューサとして動作して、シングル・サインオンにSAMLを使用するためのソース・サイトとしてWebLogic Serverが動作することを可能にします。SAML資格証明マッピング・プロバイダは、ターゲット・サイトまたはリソースの構成に基づいて、認証されたサブジェクトのために有効なSAML 1.1アサーションを生成します。

- サイト間転送サービス(ITS) - アイデンティティ・アサーションを生成してユーザーを宛先サイトに転送するアドレス可能なコンポーネント。

- アサーション取得サービス(ARS) - アーティファクトに対応するSAMLアサーションを返すアドレス可能なコンポーネント。アサーションIDは、アサーションの生成時に割り当てられたものです。

- SAMLアイデンティティ・アサータ - SAMLアイデンティティ・アサーション・プロバイダは、SAMLセキュリティ・アサーションのコンシューマとして動作して、シングル・サインオンにSAMLを使用するための宛先サイトとしてWebLogic Serverが動作することを可能にします。SAMLアイデンティティ・アサーション・プロバイダは、ソース・サイトまたはリソースから取得された認証済サブジェクトのために、有効なSAML 1.1アサーションを処理します。

- アサーション・コンシューマ・サービス(ACS) - ITSが生成したアサーションまたはアーティファクト(あるいはその両方)を受信して、宛先サイトでユーザーを認証するためにそれらを使用するアドレス可能なコンポーネント。

- SAMLリライイング・パーティ - SAMLリライイング・パーティは、SAMLソース・サイトが生成したSAMLアサーションの情報に依存するエンティティです。WebLogic Serverが各リライイング・パーティ用にSAMLアサーションを別個に生成する方法を構成することも、アサーションの生成用にフェデレーション・サービスのソース・サイト構成で設定されたデフォルトを使用することもできます。

- SAMLアサーティング・パーティ - SAMLアサーティング・パーティは、信頼できるSAML認証局(SAMLアサーションの形式でセキュリティ情報をアサートする権限を持つエンティティ)です。

図31-24は、WebCenter PortalとSOAドメインの両方を含む、POSTが構成されたSAML SSO構成のコンポーネントとフローを示しています。このフローは、ワークリスト・アプリケーションやディスカッションのようなシングル・サインオンに参加する他の宛先アプリケーションの場合と似ています。

図31-24 詳細なSAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)

「図31-24 詳細なSAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)」の説明

図31-25は、Spacesとディスカッション・アプリケーションの間のSAML SSOフローを含む、POSTが構成されたSAML SSO構成の簡略化されたバージョンのコンポーネントとフローを示しています。

図31-25 SAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)

「図31-25 SAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)」の説明

フローの手順は次のとおりです。

1. ユーザーのブラウザが、ユーザーの資格証明を入力して、WebCenter Portalドメイン(wc_domain)のWebLogic管理対象サーバー(WC_Spaces)上にホストされているSpaces(ソース・サイト)にアクセスします。

2. Spacesが、認証サービス・プロバイダにユーザーの資格証明を渡します。

3. 認証に成功すると、認証されたセッションが確立されて、Spacesのようこそページが表示されます。

4. ユーザーがようこそページで、同じドメインの異なるWebLogic Server(WC_Collaboration)上にホストされているディスカッション・サービス(宛先サイト)のセキュアなWebページにアクセスするためのリンクをクリックします。これによって、構成されているサイト間転送サービス(ITS)サーブレットへのコールがトリガーされます。この場合は、ITSサーブレットが、Spacesと同じJSESSIONID Cookieを共有するソース・サイト内(つまり、WC_Spaces管理対象サーバー上のSpacesアプリケーション上)にホストされます。

5. ITSサーブレットが、コール元アサーションをリクエストするために、WebCenter Portalドメイン(wc_domain)に構成されたSAML資格証明マッパーをコールします。SAML資格証明マッパーがアサーションを返します。また、宛先サイト・アプリケーションWebページ(ディスカッション・サービスのセキュアなWebページ)のURLと適切なPOSTフォームのパス(POSTプロファイルを使用するようにソース・サイトが構成されている場合)も返します。

6. SAML ITSサーブレットが、生成されたアサーションを含むSAMLレスポンスを生成し、それに署名して、BASE64にエンコードし、HTMLフォームに埋め込んで、そのフォームをユーザーのブラウザに返します。

7. ユーザーのブラウザがそのフォームを宛先サイトのアサーション・コンシューマ・サービス(ACS)にPOSTします。この場合は、ACSサーブレットが宛先サイト(ディスカッション・サービス)にホストされ、そのログインCookieを共有します。

8. アサーションが検証されます。

9. アサーションに成功すると、ユーザーがターゲット(ディスカッション・サービスのセキュアなWebページ)にリダイレクトされます。

10. ユーザーは再認証の必要なしで宛先サイトのディスカッション・サービスにログインします。

31.4.2 SAMLベースのシングル・サインオンの構成

この項では、一連の自動化されたスクリプトを使用して、SAMLベースのシングル・サインオンのためにSpacesとサービスを構成する方法を説明します。

この項の内容は次のとおりです。

- 第31.4.2.1項「SAMLシングル・サインオンの前提条件」

- 第31.4.2.2項「SAMLベースのSSOの構成」

- 第31.4.2.3項「外部リーダーを使用したRSS用のSAML SSOの構成」

- 第31.4.2.4項「構成のチェック」

- 第31.4.2.5項「SAML SSO構成の無効化」

- 第31.4.2.6項「SAML SSO構成の削除」

31.4.2.1 SAMLシングル・サインオンの前提条件

この項では、SAMLベースのシングル・サインオンを構成する前に実行する必要がある一連の手順を説明します。これらの手順では、Spacesと関連付けられたコンポーネントがインストール済で、関連する接続が構成およびテスト済であることを前提としています。

SAMLベースのSSOの前提条件について、次の項で説明します。

- 第31.4.2.1.1項「SAML SSO用のOracle Content Serverの構成」

- 第31.4.2.1.2項「SAML SSO用のディスカッション・サーバーの構成」

- 第31.4.2.1.3項「証明書の構成とエクスポート」

- 第31.4.2.1.4項「SSLのセットアップ」

31.4.2.1.1 SAML SSO用のOracle Content Serverの構成

WebCenter PortalでContent Serverユーザー・インタフェースを表示するためにOHSを使用する必要があるドキュメント接続をインスタンスが使用する場合は、WebCenter Portalと関連アプリケーションをWeb層を使用して構成する必要があります。

Content Serverを含む構成用にSAML SSOを構成する際は、すべてのHTTP URLはWeb層ホストおよびポートをポイントすることが必要です。さらに、Content ServerのフロントエンドとしてOHSを使用する場合は、WebCenter Portalの通常の構成とは別に、次のエントリをmod_wl_ohs.confに指定する必要があります。

<Location /cs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /samlacs/acs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

OHSのインストールとmod_wl_ohs.confの編集に関する詳細は、第31.2.5項「Oracle HTTP Serverのインストールと構成」を参照してください。

さらに、Spacesにカスタム・ログイン・ページを使用する場合、Site Studio Designerを動作させるためには、Content Server用に生成されるHTMLページのheadセクションに次のHTMLコメントを追加する必要があります。

<!--IdcClientLoginForm=1-->

このHTMLコメントは、Spacesのデフォルト・ログイン・ページに表示されますが、SAML SSOのセットアップでログイン・ページとして新しいページを構成する場合は、手作業でコメントを追加することが必要になります。つまり、JSFページの次の例に示されているように、生成されたHTMLに追加します。

<af:document id="d1">
<f:facet name="metaContainer">
<f:verbatim>
${cb.commentText}
</f:verbatim>
</f:facet>
.........

cbは、次のメソッドを含むマネージドBeanです。

public String getCommentText(){
return "<!--IdcClientLoginForm=1-->";
}

af:documentのmetaContainer facetのverbatimにcomment textが追加されたことをチェックしたら、View Sourceを使用して生成されたHTMLページをチェックして、<!--IdcClientLoginForm=1-->がHTMLページの<head>セクションにあることを確認します。

31.4.2.1.2 SAML SSO用のディスカッション・サーバーの構成

デフォルトでは、Oracle WebCenter Portalのディスカッション・サーバー用にデプロイされる.EARファイルは、フォームベースのOracle SSOまたはOracle Access Manager SSOをサポートします。したがって、Oracle WebCenter Portalのディスカッション・サーバーをSAMLベースのシングル・サインオン用に構成する前に、SAML SSOバージョンのディスカッション・サーバーの.EARファイルをデプロイすることが必要になります。

注意:

SSO用のディスカッション・サーバーを構成する前に、第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、Spacesと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。デフォルトの管理者アカウントを外部LDAPに移動しない場合は、第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」の手順にも従ってください。

SAML SSOバージョンのOracle WebCenter Portalのディスカッション・サーバーをデプロイおよび構成する手順は次のとおりです。

1. WebLogic Serve管理コンソールに管理者としてログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「デプロイメント」をクリックします。
デプロイメントのサマリー・ペインが表示されます(図31-26を参照)。

図31-26 デプロイメントのサマリー・ペイン

「図31-26 デプロイメントのサマリー・ペイン」の説明

3. デプロイメントのサマリー・ページで、owc_discussions stop and deleteを選択して「インストール」をクリックします。

4. アプリケーション・インストール・アシスタントの「パス」フィールドを使用して、SSO対応のowc_discussions .EARファイル(owc_discussions_samlsso.ear、通常は$WC_ORACLE_HOME/discussionserverにあります)を見つけます。

5. owc_discussions_samlsso.earファイルを選択して「次へ」をクリックします。

6. 「このデプロイメントをアプリケーションとしてインストールする」を選択して「次へ」をクリックします。

7. 「名前」をowc_discussionsに設定します。

8. .EARファイルをデプロイします。

9. ディスカッション・サーバー管理コンソールに管理者としてログインします(ディスカッション・サーバー管理コンソールへのログインに関する詳細は、第31.2.6.2項「SSO用のディスカッション・サーバーの構成」を参照してください)。

10. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを追加または編集(すでに存在している場合)して、その値をtrueに設定します。

11. (ディスカッション・サーバーがデプロイされた)WC_Collaboration管理対象サーバーを再起動します。

31.4.2.1.3 証明書の構成とエクスポート

SAMLのソース・サイトと宛先サイト間の通信を保護するために、通信を暗号化する必要があります。さらに、証明書を使用して、SAMLの対話時に他のパーティのアイデンティティを検証することが必要です。次の手順に従ってkeytoolユーティリティ(JDK 6.0の一部として利用可能)を使用してキーを生成し、WebLogic Server管理コンソールを使用してそれを登録してください。

keytoolを使用して証明書を作成する手順は次のとおりです。

1. WebCenter PortalドメインのWC_Spacesと管理サーバーのための必要なキーストアを構成します。このキーストアには、SAMLアサーションを保護するために使用する証明書が含まれることが必要です。
構成のテストのみを行いたい場合は、デフォルトで構成されるDemoIdentityキーストアにパッケージされるdemoidentity証明書を作成するか、keytoolを使用してDemoIdentityキーストアに新しい証明書を生成することができます。カスタムIDキーストアの構成に関する詳細は、第33.1.2項「カスタムIDキーストアおよびJava信頼キーストアの構成」を参照してください。

2. keytoolを使用して、SAMLアサーションの暗号化に使用するために選択した証明書をエクスポートします。必ずSpacesドメインの管理サーバーとWC_Spacesに対して構成されたキーストア上でexportコマンドを実行するようにしてください。

keytool -export -keystore <keystore_name> -storepass <keystore_password> -alias <certificate_alias> -keypass <certificate_password> -file <certificate.der>

各要素の意味は次のとおりです。

- keystore_nameは、Spacesドメインの管理サーバーとWC_Spacesに対して構成されたキーストアの名前

- keystore_passwordは、Spacesドメインの管理サーバーとWC_Spacesに対して構成されたキーストアのパスワード

- certificate_aliasは別名(例: demoidentity)

- certificate_passwordは証明書のパスワード

- certificate.derは証明書ファイルの名前

keytool -exportコマンドはSpacesマシンから実行する必要があることと、Spacesサーバーに構成されたキーストアに常駐するSAML SSOのセットアップで使用されている証明書をエクスポートする必要があることに注意してください。

3. (SOA、Content Serverおよびコラボレーションなどの)宛先ドメインにファイルをコピーまたは転送し、第31.4.2.2.1項「シングル・サインオンのスクリプト」で説明されているSAML SSOスクリプトを実行する準備が整ったら、wcsamlsso.propertiesファイルのcertPath値を構成します。

31.4.2.1.4 SSLのセットアップ

トランスポートレベルのセキュリティを提供するためにWebCenter PortalのインストールでSSLを必要とする場合は、第33章「SSLの構成」で説明されているようにシングル・サインオンを構成する前にSSLを構成する必要があります。SSLのセットアップはSSOの有効化とは無関係であることに注意してください。

31.4.2.2 SAMLベースのSSOの構成

Spacesと環境に必要なサービスをインストールしたら、この項で説明されているスクリプトを使用してSAMLベースのシングル・サインオンを構成します。

このスクリプトでは、次を構成することで、WebLogic環境にSAMLベースのシングル・サインオンをセットアップします。

- SAML資格証明マッピング・プロバイダ

- 必要なリライイング・パーティ

- ソース・サイトのフェデレーション・サービス

- SAMLアイデンティティ・アサータ

- 必要なアサーティング・パーティ

- 宛先サイトのフェデレーション・サービス

この項の内容は次のとおりです。

- 第31.4.2.2.1項「シングル・サインオンのスクリプト」

- 第31.4.2.2.2項「スクリプトの使用」

31.4.2.2.1 シングル・サインオンのスクリプト

Spacesおよび関連するアプリケーション用にSAML 1.1 SSOを構成するためのシングル・サインオン・スクリプトは、$WC_ORACLE_HOME/webcenter/scripts/samlssoフォルダに格納されています。SAMLの構成に関係するのは、次のファイルです。

- wcsamlsso.properties

- wcsamlsso.py

- configureSpaces.py

- configureCollab.py

- configureUtilities.py

- configureSOA.py

- configureUCM.py

- configureREST.py

- configureForum.py

- configureActivityGraphEngine.py

- configureWorklistIntegration.py

- configureWorklistDetail.py

- configureWorklistSDP.py

- configureCS.py

wcsamlsso.properties

このプロパティ・ファイル($WC_ORACLE_HOME/common/bin/wcsamlsso.properties)は、SAML SSOのセットアップに必要な構成情報をカプセル化します。プロパティ・ファイルには次のセクションがあります。

spaces_config

このセクションでは、資格証明マッパーおよびソース・サイト・フェデレーション・サービスの構成に必要なWebCenter Portalドメインのログイン情報、WebLogic管理URL、SpacesサーバーおよびURLなどをキャプチャします。このセクションのすべてのプロパティを指定する必要があります。

- configFile - WebCenter Portalドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - WebCenter Portalドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにSpacesが構成されているかどうかを示します。

- url - WebCenter Portal URL。usesSSLがtrueの場合は、httpをhttpsに変更してください。SpacesのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

- serverName - Spacesがデプロイされているサーバー(通常はWC_Collaboration)

- certAlias - SAMLアサーションに署名する証明書の別名

- certPassword - SAMLアサーションに署名する証明書の暗号化されたパスワード

collab_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なコラボレーション・ドメインのログイン情報、管理URL、証明書ファイル・パスなどをキャプチャします。セットアップでディスカッションが構成されている場合のみ、このセクションを指定してください。

- configFile - サービス・ドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - サービス・ドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにディスカッション・サービスが構成されているかどうかを示します。

- serverName - ディスカッションがデプロイされているサーバー(通常はWC_Collaboration管理対象サーバー)

- certAlias - SAMLアサーションを確認するための証明書の別名

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

utilities_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なユーティリティ・ドメインのログイン情報、管理URLおよび証明書ファイル・パスをキャプチャします。このセクションは、セットアップでアクティビティ・グラフ・アプリケーションが構成されている場合のみ指定してください。

- configFile - ユーティリティ・ドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - ユーティリティ・ドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにユーティリティ・アプリケーションが構成されているかどうかを示します。

- serverName - ユーティリティ・アプリケーションがデプロイされているサーバー(通常はWC_Utilities管理対象サーバー)

- certAlias - SAMLアサーションを確認するための証明書の別名

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

soa_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なSOAドメインのログイン情報、管理URL、証明書ファイル・パスなどをキャプチャします。セットアップでSOAが構成されている場合のみ、このセクションを指定してください。

- configFile - SOAドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - SOAドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにSOAアプリケーションが構成されているかどうかを示します。

- serverName - SOAアプリケーションがデプロイされているサーバー(通常はsoa_server1)

- certAlias - SAMLアサーションを確認するための証明書の別名

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

ucm_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なContent Serverドメインのログイン情報、管理URL、証明書ファイル・パスなどをキャプチャします。インストールでドキュメント・サービスが構成されている場合のみ、このセクションを指定してください。

- configFile - Content Server(UCM)ドメイン用のweblogicユーザー名とパスワードを含む構成ファイル

- usesSSL - SSLを使用するようにContent Serverアプリケーションが構成されているかどうかを示します。

- keyFile - Content Server(UCM)ドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- serverName - Content Serverアプリケーションがデプロイされているサーバー(通常はUCM_server1)

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

rss_config

これは必須です。

- url - RSS URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。RSSのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

rest_config

このセクションは指定する必要があります。

- url - REST URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。RESTのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

forum_config

構成にディスカッションがインストールされている場合は、このセクションを指定してください。

- url - OWCディスカッションURL。collab_configのusesSSLがtrueの場合は、httpをhttpsに変更してください。ディスカッションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

worklist_config

Spaces用にSOAがインストールされ、ワークリストが構成されている場合は、このセクションを指定してください。

- worklist_detail - ワークリスト詳細アプリケーションURL。soa_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。ワークリスト詳細アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

- worklist_sdp - ワークリストSDPアプリケーションURL。soa_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。ワークリスト詳細アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

- worklist_integration - ワークリスト統合アプリケーションURL。soa_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。ワークリスト詳細アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

activitygraph_config

構成にユーティリティ・サーバーがインストールされている場合は、このセクションを指定してください。

- url - ActivityGraphEngines URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。アクティビティ・グラフ・アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

cs_config

構成にContent Serverがインストールされており、Spacesアプリケーション用にドキュメント・サービス接続が構成されている場合は、このセクションを指定してください。

- url - Content Server URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。Content ServerのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。環境にSpacesとContent Serverの両方が構成されている場合は、同じWeb層を使用して両方にアクセスする必要があります。

wcsamlsso.py

残りの構成スクリプトによって呼び出されるユーティリティ関数を含むスクリプト・ファイル($WC_ORACLE_HOME/common/wlst/wcsamlsso.py)

configureSpaces.py

SAML 1.1資格証明マッパー、SAML 1.1アイデンティティ・アサータおよびソースならびに宛先サイト・フェデレーション・サービスをWebCenter Portalドメインに構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureSpaces.py)

configureCollab.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをコラボレーション・ドメインに構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureCollab.py)

configureUtilities.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをユーティリティ・ドメインに構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureUtilities.py)

configureSOA.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをSOAドメインに構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureSOA.py)

configureUCM.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをContent Serverドメインに構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureUCM.py)

configureREST.py

RESTアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureREST.py)

configureRSS.py

RSSアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureRSS.py)

configureForum.py

ディスカッション・アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureForum.py)

configureActivityGraphEngine.py

アクティブ・グラフ・エンジン・アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureActivityGraphEngine.py)

configureWorklistIntegration.py

ワークリスト統合アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistIntegration.py)

configureWorklistDetail.py

ワークリスト・コミュニティ詳細アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistDetail.py)

configureWorklistSDP.py

ワークリストSDPアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistSDP.py)

configureCS.py

Content Serverアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト($WC_ORACLE_HOME/webcenter/scripts/samlsso/configureCS.py)

31.4.2.2.2 スクリプトの使用

SAMLベースのシングル・サインオンを構成するスクリプトを使用する手順は次のとおりです。

注意:

スクリプトの実行中に構成ミスによるエラーが発生した場合、SAML SSO構成は未完了の状態で終了する可能性があります。提供された構成スクリプトを再実行できない場合は、第31.4.2.6項「SAML SSO構成の削除」の説明に従って、構成を再試行する前にSAML SSOアーティファクトをクリーンアップする必要があります。

1. この構成で使用されるすべてのドメインの管理サーバーが稼働中であることを確認してください。

2. プロパティ・ファイルが選択されるように、$WC_ORACLE_HOME/common/binからstoreUserConfig WLSTコマンドを使用して、様々なドメインの接続情報を含む構成ファイルとキー・ファイルを生成します。使用方法と構文の詳細は、コマンド・ラインのヘルプ(help('storeUserConfig'))を使用してください。

1. WLSTを使用し、管理ユーザー名とパスワードを使用してWebCenter Portalドメインに接続し、次のコマンドを実行します。
storeUserConfig('spacesconfig.secure', 'spaceskey.secure')

これによってユーザー構成ファイルと関連するキー・ファイルが作成されます。ユーザー構成ファイルには、暗号化されたユーザー名とパスワードが含まれます。キー・ファイルには、ユーザー名とパスワードの暗号化と復号化に使用される秘密鍵が含まれます。前述のコマンドは、構成ファイルとキー・ファイルを、WLSTが呼び出されたディレクトリに格納します。または、オプションでより安全なパスを指定することもできます。

2. 管理ユーザー名とパスワードを使用してコラボレーション・ドメインに接続した後で、手順2aを繰り返します。ユーティリティ・サーバーがSpacesと同じドメイン(wc_domain)内にある場合でも、WebCenter Portalドメインに接続し、このコマンドを実行する必要があります。
storeUserConfig('collabconfig.secure', 'collabkeykey.secure')

3. 管理ユーザー名とパスワードを使用してユーティリティ・ドメインに接続した後で、手順2aを繰り返します。ユーティリティ・サーバーがSpacesと同じドメイン(wc_domain)内にある場合でも、WebCenter Portalドメインに接続し、このコマンドを実行する必要があります。
storeUserConfig('utilitiesconfig.secure', 'utilitieskey.secure')

4. 管理ユーザー名とパスワードを使用してSOAドメインに接続した後で、手順2aを繰り返します。Spacesと同じドメインにSOAがインストールされていても、WebCenter Portalドメインに接続してこのコマンドを実行する必要があります。
storeUserConfig('soaconfig.secure', 'soakey.secure')

5. 管理ユーザー名とパスワードを使用してContent Serverドメインに接続した後で、手順2aを繰り返します。
storeUserConfig('ucmconfig.secure', 'ucmkey.secure')

3. WLSTを起動してWLST encryptコマンドを実行し、証明書パスワードを暗号化します。使用方法と構文の詳細は、コマンド・ラインのヘルプ(help('encrypt'))を使用してください。
print encrypt(obj='<certificatePassword>', domainDir='<full path to the Spaces domain directory>')

これによって、暗号化された証明書パスワードが表示されます。暗号化コマンドは、指定されたWebLogic Serverドメイン・ルート・ディレクトリに暗号化を使用します。暗号化された出力は、次の手順に出てくるwcsamlsso.propertiesでcertPassword値として設定する必要があります。このパスワードはWebCenter Portalドメインの資格証明マッパーとソース・サイト・フェデレーション・サービスに設定され、確実にWebCenter Portalドメインから暗号化ユーティリティが実行されるようになります。

4. $WC_ORACLE_HOME/common/bin/wcsamlsso.propertiesを編集して、セットアップに適用されるセクションを指定します。プロパティ・ファイルのセクションの詳細な説明は、第31.4.2.2.1項「シングル・サインオンのスクリプト」を参照してください。

5. $WC_ORACLE_HOME/common/binからWLSTを起動して、次に示された順番でスクリプトを実行します。

注意:

スクリプトには明示的な接続コマンドが含まれているので、スクリプトはWLSTオフライン・モードで実行してください。

1. execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureSpaces.py')
WebCenter Portalドメインの管理サーバーを含むすべてのサーバーを再起動します。

2. ディスカッション・サーバーをセットアップしてある場合は、configureCollab.pyスクリプトを実行します。
execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureCollab.py')

ディスカッションがSpacesと同じドメインに属している場合は、WC_Collaboration管理対象サーバーのみを再起動します。そうでない場合は、コラボレーション・ドメインの管理サーバーを含むすべてのサーバーを再起動します。

3. ユーティリティ・サーバーをセットアップしてある場合は、configureUtilities.pyスクリプトを実行します。
execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureUtilities.py')

ユーティリティ・サーバーがSpacesと同じドメインに属している場合は、WC_Utilitiesサーバーのみを再起動します。そうでない場合は、ユーティリティ・ドメインの管理サーバーを含むすべてのサーバーを再起動します。

4. Spacesのワークリストを構成してある場合は、configureSOA.pyスクリプトを実行します。
execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureSOA.py')

SOAドメインの管理サーバーを含むすべてのサーバーを再起動します。

5. Spacesにドキュメント・サービスを構成してある場合は、次のようにconfigureUCM.pyスクリプトを実行します。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureUCM.py')

Content Serverドメインの管理サーバーを含むすべてのサーバーを再起動します。

6. 環境の必要に応じて次の個々のコマンドを実行します。
execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureREST.py') - 再起動は不要です。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureRSS.py') - 再起動は不要です。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureForum.py') - セットアップにディスカッションがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureActivityGraphEngine.py') - セットアップにユーティリティがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureWorklistIntegration.py') - セットアップにワークリストがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('wc_oracle_home>/webcenter/scripts/samlsso/configureWorklistDetail.py') - セットアップにワークリストがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureWorklistSDP.py') - セットアップにワークリストがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<wc_oracle_home>/webcenter/scripts/samlsso/configureCS.py') - セットアップにContent Serverがインストールされている場合はこれを行ってください。再起動は必要ありません。

7. 第31.4.2.4項「構成のチェック」の手順を使用して、インストールをチェックします。

重要:

プロパティ・ファイルには機密情報が含まれているので、SAML SSOセットアップの構成および検証後に$WC_ORACLE_HOME/common/binからこれを削除してください。また、前述の手順2で生成した構成ファイルとキー・ファイルも削除してください。

注意:

スクリプトの実行中にエラーが発生した場合は、第31.4.2.6項「SAML SSO構成の削除」の説明に従ってスクリプトを再度実行する前にスクリプトによってセットアップされたアサーティングおよびリライイング・パーティを削除する必要があります。

古いSAML SSO構成を削除したら、スクリプトを再実行してください。

31.4.2.3 外部リーダーを使用したRSS用のSAML SSOの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護された状態では、外部リーダーでRSSフィードがうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースを非保護にすることをお薦めします。

次の手順に従って、RSSフィードを非保護にします。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. セキュリティ・レルムを開き、「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択します。

3. RSSのリライイング・パーティを無効化または削除します。

4. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択します。

5. RSSのアサーティング・パーティを無効化または削除します。

31.4.2.4 構成のチェック

次の手順に従って、シングル・サインオン構成が正しく動作することをチェックします。

シングル・サインオン構成をテストする手順は次のとおりです。

1. 新しいブラウザを使用して、Spacesにログインし、「スペース設定」→「サービス」→「ディスカッション」の「フォーラム管理」をクリックしても、資格証明についてチャレンジされないことをチェックします(このサービスがスペース用にプロビジョニングされていると仮定します)。

2. ディスカッションまたはワークリスト・タスク・フローからRSSリンクにアクセスして、ログインのためにチャレンジされないことをチェックします。

3. Content Serverについては、プロファイル・ユーザー・インタフェースに移動して、ログインへのチャレンジなしでiFramesに埋め込まれたContent Server画面を表示できることを確認します。また、すでにSpacesにログインしているので、ログインへのチャレンジなしでコンテンツ・プレゼンタ・テンプレートでSite Studioのコンテンツにアクセスできるはずです。

4. http://host:port/rest/api/resourceIndexにアクセスし、BASIC認証チャレンジが表示されることを確認します。同じSSOを使用する別の関連アプリケーションにすでにログインしている場合は、ログインへのチャレンジなしでコンテンツを表示できるはずです。

5. SOAをテストするには、ワークフロー・タスク・フローのリンクにアクセスして、ログインをチャレンジされないことを確認します。

SAML SSOのテスト中に404または403エラーが発生した場合は、SAML構成をチェックして、AdminServer上でSAMLのデバッグ・ロギングをオンにしてください。また、WC_Spacesサーバーと宛先サイトをホストするサーバーのロギングもオンにしてください。ログは、$domain.home/servers/<server>/logs/<server>.logに格納されます。WC_Spacesおよび他のアプリケーション・サーバーのロギングをオンにする方法は、第38.3項「ログ情報の表示および構成」を参照してください。スクリプトを再実行する前に、第31.4.2.6項「SAML SSO構成の削除」の説明に従ってSAML SSO構成を削除してください。

31.4.2.5 SAML SSO構成の無効化

この項では、テストなどのためにSAML SSO構成を一時的に無効にする方法を説明します。

SAML SSO構成を無効にする手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. セキュリティ・レルムを開き、「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択し、そこに示されたリライイング・パーティをすべて無効にします。

3. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて無効にします。

4. SOAやContent Serverなど、SAML SSOで構成されている他のWLSドメインがある場合は、それらのドメインからもSAML SSO構成を削除します。

1. WLSドメインのWLS管理コンソールにログインします。

2. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて無効にします。

5. アプリケーションを開き、サインインを要求されないことをチェックして、SAML SSO構成が無効になっていることを確認します。

31.4.2.6 SAML SSO構成の削除

SAML SSO構成スクリプトにはクリーンアップ機能は含まれていないので、wcsamlsso.propertiesファイルの更新中やスクリプトの実行中にミスをすると、構成は無効な状態になる可能性があります。この場合は、ここですべてのSAML SSO構成をクリーンアップして、もう一度やりなおすことをお薦めします。この項では、SAML SSO構成を削除する手順を説明します。

SAML SSOを完全にセットアップした場合(つまり、スクリプトが完全に実行された場合)は、次のすべての指示が有効になることに注意してください。ただし、スクリプトの実行中にエラーが発生すると、構成は不完全なものになる可能性があります。その場合は次のアーティファクトの一部のみが存在し、削除することが必要になります。

SAML SSO構成を削除する手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. セキュリティ・レルムを開き、「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択し、そこに示されたリライイング・パーティをすべて削除します。

3. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて削除します。

4. 「プロバイダ」→「認証」→「wcsamlia」→「管理」→「証明書」に移動し、そこで証明書をすべて削除します。

5. 「プロバイダ」→「資格証明マッピング」→「wcsamlcm」に移動して、SAML資格証明マッパーを削除します。

6. 「プロバイダ」→「認証」→「wcsamlia」に移動し、SAMLアイデンティティ・アサータを削除します。

7. Spaces WLSドメイン全体を再起動します。

8. SOAやContent Serverなど、SAML SSOで構成されている他のWLSドメインがある場合は、それらのドメインからもSAML SSO構成を削除します。

1. WLSドメインのWLS管理コンソールにログインします。

2. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて削除します。

3. 「プロバイダ」→「認証」→「wcsamlia」→「管理」→「証明書」に移動し、そこで証明書をすべて削除します。

4. 「プロバイダ」→「認証」→「wcsamlia」に移動し、SAMLアイデンティティ・アサータを削除します。

5. WLSドメイン全体を再起動します。

9. アプリケーションを開き、サインインを要求されないことをチェックして、SAML SSO構成が削除されていることを確認します。これで、スクリプトを再度安全に使用して、SAML SSOを再構成できます。

31.5 Microsoftクライアント用のSSOの構成

この項では、SPNEGO(Simple and Protected Negotiate)メカニズムとKerberosプロトコルに基づくWindows認証とSpacesアプリケーション用のWebLogicネゴシエート・アイデンティティ・アサーション・プロバイダを使用して、Microsoftクライアントでのシングル・サインオン(SSO)をセットアップする方法について説明します。このSSOアプローチによって、Kerberosを使用してWindowsドメイン内で認証されたMicrosoftクライアント(ブラウザなど)は、パスワードを再入力する必要なしで、同じ資格証明に基づいて、WebLogicドメイン内のWebアプリケーション(Spacesなど)に対して透過的に認証されることが可能になります。

クロスプラットフォーム認証は、Kerberosプロトコルを使用したネイティブのWindows間認証サービスのネゴシエート動作をエミュレートすることで達成されます。クロスプラットフォーム認証を有効にするためには、非Windowsサーバー(この場合はWebLogic Server)は、認証に使用されるKerberosトークンを抽出するためにSPNEGOトークンを解析する必要があります。

この項の内容は次のとおりです。

- 第31.5.1項「MicrosoftクライアントSSOの概念」

- 第31.5.2項「システム要件」

- 第31.5.3項「Microsoftクライアントの構成」

31.5.1 MicrosoftクライアントSSOの概念

Kerberosの概要

Kerberosは、ネットワークのサービスに対するリクエストを認証するための安全な方法です。Kerberosプロトコルは、クライアント、サーバーおよびそれらを仲介するKDC(Key Distribution Center)という信頼できるサード・パーティの3つのパーティから構成されます。Kerberosでは、ユーザーがそのアイデンティティを証明するKerberosチケットをサーバーに提供できる場合は、サーバーはユーザーがそのサービスにアクセスすることを許可します。ユーザーとサービスの両方が、KDCに登録された鍵を持つ必要があります。

次の図は、クライアントがサーバーに接続する前に行われる必要がある基本的なやり取りを示しています。

図31-27 Key Distribution Centerを通したサーバーへの接続

「図31-27 Key Distribution Centerを通したサーバーへの接続」の説明

SPNEGOの概要

SPNEGO(Simple and Protected GSSAPI Negotiation Mechanism)は、いくつかの可能な現実のメカニズムの1つをネゴシエートするために使用されるGSSAPI疑似メカニズムです。SPNEGOは、クライアント・アプリケーションがリモート・サーバーに対して認証したい場合に、どちらのエンドも他方がサポートする認証プロトコルがわからない場合に使用されます。この疑似メカニズムでは、あるプロトコルを使用して利用可能な共通のGSSAPIメカニズムを判断して選択し、強化されたセキュリティ操作をすべてそれにディスパッチします。このため、組織は新しいセキュリティ・メカニズムを段階的にデプロイできます。

SPNEGOは、MicrosoftのHTTP Negotiate認証拡張での使用が最も目立っています。ネゴシエート可能なサブメカニズムにはNTLMとKerberosがあり、両方ともActive Directoryで使用されています。

この機能によってクライアント・ブラウザは、WebLogic Server上の保護されたリソースにアクセスし、SPNEGOチケットを使用してKerberosデータベースの認証情報をWebLogic Serverに透過的に提供することができます。WebLogic Serverはチケットを認識して、そこから情報を抽出できます。そしてWebLogic Serverは、その情報を使用して認証を行い、認証されたユーザーがリソースへのアクセスを認可されている場合はリソースへのアクセスを付与します。(Kerberosは認証のみを担当し、認可はWebLogic Serverが処理します。)

図31-28 SPNEGOベースの認証

「図31-28 SPNEGOベースの認証」の説明

31.5.2 システム要件

MicrosoftクライアントでSSOを使用するには、次が必要です。

次を装備したホスト・コンピュータ:

- Windows 2000以降がインストールされていること

- 完全に構成されたActive Directory認証サービス。具体的なActive Directory要件は次のとおりです。

- Kerberosサービスをマッピングするためのユーザー・アカウント

- これらのアカウントのサービス・プリンシパル名(SPN)

- 作成されてWebLogic Serverドメインの起動ディレクトリにコピーされたキー・タブ・ファイル

- この項で説明されているように、Kerberosを通して認証するように適切にインストールおよび構成されたWebLogic Server

次を装備したクライアント・システム:

- Windows 2000 Professional SP2以降がインストールされていること

- 次のいずれかのタイプのクライアント:

- 適切に構成されたInternet Explorerブラウザ。Internet Explorer 6.01以降がサポートされます。

- .NET Framework 1.1および適切に構成されたWebサービス・クライアント。

注意:

クライアントはWindows 2000ドメインにログオンする必要があり、そのドメインのActive Directoryサーバーから取得されたKerberos資格証明を持つ必要があります。ローカル・ログオンは機能しません。

31.5.3 Microsoftクライアントの構成

MicrosoftクライアントでSSOを構成するには、図31-29に示されているMicrosoft Active Directory、MicrosoftクライアントおよびWebLogic Serverドメインを構成する必要があります。詳細な構成手順とトラブルシューティングについては、Oracle Fusion Middleware Oracle WebLogic Serverの保護のMicrosoftクライアントでのシングル・サインオンの構成に関する項を参照してください。

図31-29 MicrosoftクライアントでのSSOの構成

「図31-29 MicrosoftクライアントでのSSOの構成」の説明

SSO用にMicrosoftクライアントを構成する手順は次のとおりです。

1. Kerberosを使用するようにネットワーク・ドメインを構成します。

2. WebLogic Server用のKerberos識別情報を作成します。

1. WebLogic Serverを実行中のホストのActive Directoryにユーザー・アカウントを作成します。

2. このアカウントのサービス・プリンシパル名を作成します。

3. このアカウントのユーザー・マッピングとキータブ・ファイルを作成します(Oracle Fusion Middleware Oracle WebLogic Serverの保護のMicrosoftクライアントでのシングル・サインオンの構成に関する項を参照)。

3. ブラウザ・クライアント(Internet ExplorerまたはMozilla Firefox)を選択し、Windows統合認証を使用するようにそれを構成します(Oracle Fusion Middleware Oracle WebLogic Serverの保護のWindows統合認証を使用するためのMicrosoftクライアントの構成に関する項を参照。)

4. Kerberos認証を使用するようにWebLogic Serverドメイン(この場合はwc_domain)をセットアップします。

1. MicrosoftドメインのActive Directoryサーバーと手順2で作成したキータブ・ファイルをポイントするJAASログイン・ファイルを作成します(Oracle Fusion Middleware Oracle WebLogic Serverの保護のJAASログイン・ファイルの作成に関する項を参照)。

2. WebLogic Serverセキュリティ・レルムでネゴシエート・アイデンティティ・アサーション・プロバイダを構成します(第31.5.3.1項「ネゴシエート・アイデンティティ・アサーション・プロバイダの構成」を参照)。

3. Active Directoryオーセンティケータを使用するようにWebLogic Serverドメインを構成して、WebLogicドメインがアイデンティティ・ストアと同じActive Directoryドメインを使用するようにします。または、別のアイデンティティ・ストアを使用して、このストアのユーザーをドメインのActive Directoryユーザーと照合することもできますが、2つの異なるアイデンティティ・ストアを使用すると同期が失われる危険性があるため、Active Directoryオーセンティケータを使用することをお薦めします(第31.5.3.2項「Active Directory認証プロバイダの構成」を参照)。

注意:

アイデンティティ・ストアのみをActive Directory用に構成してください。ポリシーおよび資格証明ストアはActive Directoryに対して認証されません。

5. 次のシステム・プロパティを各WebCenter PortalマシンのsetDomainEnv.shのJAVA_OPTIONSに追加します。それぞれの値は、特定のホストの値に変更してください(1行に指定)。

-Dnon_sso_protocol=http
-Dnon_sso_host=example.com
-Dnon_sso_port=8888
-Dsso_base_url=http://example.com:7777

non_sso値は、プロトコル、ホストおよびポートについてのマシン上の値です。sso値は、OHSを通してルーティングされた際にユーザーに表示される値です。

6. WebCenter Portal: Spacesに対しては、第31.6項「仮想ホストを使用したSSOの構成」の説明に従って、WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHSを構成します。

7. 手順5で指定した起動引数を使用して、WebLogic Server(管理サーバーと管理対象サーバー)を再起動します。SOAドメインについて手順4、5および6を繰り返して、SOAアプリケーションのシングル・サインオンを有効にします。

8. OHSを再起動して変更を有効にします。

9. ディスカッション・サーバーを構成します(第31.5.3.4項「SSO用のディスカッション・サーバーの構成」を参照)。

31.5.3.1 ネゴシエート・アイデンティティ・アサーション・プロバイダの構成

この項では、ネゴシエート・アイデンティティ・アサーション・プロバイダの作成および構成手順を説明します。ネゴシエート・アイデンティティ・アサーション・プロバイダによって、Microsoftクライアントのシングル・サインオン(SSO)が可能になります。アイデンティティ・アサーション・プロバイダは、SPNEGO(Simple and Protected Negotiate)トークンをデコードして、Kerberosトークンを取得し、それらのKerberosトークンを検証して、それらをWebLogicユーザーにマップします。ネゴシエート・アイデンティティ・アサーション・プロバイダはJava GSS(Generic Security Service) API(Application Programming Interface)を使用して、Kerberosを通してGSSセキュリティ・コンテキストを受け付けます。

ネゴシエート・アイデンティティ・アサーション・プロバイダを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます(図31-30を参照)。

図31-30 「セキュリティ・レルムのサマリー」ペイン

「図31-30 「セキュリティ・レルムのサマリー」ペイン」の説明

3. セキュリティ・レルムをクリックします。
セキュリティ・レルムの設定ページが表示されます(図31-31を参照)。

図31-31 セキュリティ・レルムの設定ページ

「図31-31 セキュリティ・レルムの設定ページ」の説明

4. 「プロバイダ」タブを開き、「認証」サブタブを選択します。
認証設定ペインが表示されます(図31-32を参照)。

図31-32 認証設定ペイン

「図31-32 認証設定ペイン」の説明

5. 「新規」をクリックします。
「新しい認証プロバイダの作成」ペインが表示されます(図31-33を参照)。

図31-33 「新しい認証プロバイダの作成」ペイン

「図31-33 「新しい認証プロバイダの作成」ペイン」の説明

6. アイデンティティ・アサータの「名前」を入力し、「タイプ」としてNegotiateIdentityAsserterを選択します。

7. 「OK」をクリックします。

31.5.3.2 Active Directory認証プロバイダの構成

次の手順に従って、WebLogic管理コンソールを使用してActive Directory認証プロバイダを構成します。

Active Directory認証プロバイダを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます(図31-34を参照)。

図31-34 「セキュリティ・レルムのサマリー」ペイン

「図31-34 「セキュリティ・レルムのサマリー」ペイン」の説明

3. セキュリティ・レルムをクリックします。
セキュリティ・レルムの設定ページが表示されます(図31-35を参照)。

図31-35 セキュリティ・レルムの設定ページ

「図31-35 セキュリティ・レルムの設定ページ」の説明

4. 「プロバイダ」タブを開き、「認証」サブタブを選択します。
認証設定ペインが表示されます(図31-36を参照)。

図31-36 認証設定ペイン

「図31-36 認証設定ペイン」の説明

5. 「新規」をクリックします。
「新しい認証プロバイダの作成」ペインが表示されます(図31-37を参照)。

図31-37 「新しい認証プロバイダの作成」ペイン

「図31-37 「新しい認証プロバイダの作成」ペイン」の説明

6. 認証プロバイダの「名前」を入力し、「タイプ」としてActiveDirectoryAuthenticatorを選択します。

7. 「OK」をクリックします。

8. プロバイダのリストで、今作成した認証プロバイダをクリックします。
プロバイダの設定ページが表示されます(図31-38を参照)。

図31-38 プロバイダの設定ページ

「図31-38 プロバイダの設定ページ」の説明

9. 「構成」タブを開き、「共通」サブタブを開きます。

10. 制御フラグをSUFFICIENTに設定し、「保存」をクリックします。

注意:

他のすべてのオーセンティケータの制御フラグの設定も、SUFFICIENTに変更する必要があります。制御フラグがREQUIREDに設定された既存のデフォルト・オーセンティケータがある場合は、これをSUFFICIENTに変更する必要があります。

11. 「プロバイダ固有」サブタブを開きます。
プロバイダ固有の設定ペインが表示されます(図31-39を参照)。

図31-39 プロバイダ固有の設定ペイン

「図31-39 プロバイダ固有の設定ペイン」の説明

12. 次の表に示されているように、各フィールドに値を入力します。これら以外のフィールドは、デフォルト値のままにします。

表31-3 Active Directoryオーセンティケータの設定

パラメータ

値

説明

ホスト:

LDAPサーバーのホストID

ポート:

LDAPサーバーのポート番号

プリンシパル:

LDAP管理者プリンシパル

資格証明:

ユーザー・ベースDN:

ユーザー検索ベース(例: OU=spnego unit,DC=admin,DC=oracle,DC=com)

名前指定によるユーザー・フィルタ:

(&(cn=%u)(objectclass=user))

ユーザー検索スコープ:

subtree

ユーザー名属性:

cn

ユーザー検索スコープ:

user

グループ・ベースDN:

グループ検索ベース(ユーザー・ベースDNと同じ)

名前指定によるグループ・フィルタ:

(&(cn=%g)(objectclass=group))

グループ検索スコープ:

subtree

静的グループ名属性:

cn

静的グループ・オブジェクト・クラス:

group

静的メンバーDN属性:

member

メンバーDN指定による静的グループDNフィルタ:

(&(member=%M)(objectclass=group))

13. 「保存」をクリックします。

14. プロバイダのサマリー・ページで、次の順序にプロバイダを並べ替え、それらの制御フラグが適宜SUFFICIENTに設定されていることを確認します。

1. ネゴシエート・アイデンティティ・アサータ

2. ActiveDirectoryAuthenticator (SUFFICIENT)

3. DefaultAuthenticator (SUFFICIENT)

4. 他のオーセンティケータ

31.5.3.3 WebCenter Portal: Spacesの構成

ネゴシエート・アイデンティティ・アサーション・プロバイダとActive Directoryオーセンティケータの構成手順を完了し、WebLogicドメインの全アプリケーションと必要なドメインのMicrosoftクライアントをシングル・サインオン用に構成したら、ユーザーがSpacesにアクセスしたときにシームレスなシングル・サインオン・エクスペリエンスを提供するための最終ステップを実行する必要があります。これは次の2通りの方法で実行できます。

- 管理者としてSpacesにログインし、Public-UserロールからViewアクセスを削除することで、パブリック・アクセスをオフにします。パブリック・アクセスをオフにすると、URL http://host:port/webcenterにアクセスしたユーザーには、ログイン・セクションを持つデフォルト・パブリック・ページではなく、認証されたビューが直接表示されます。これは、ユーザーがInternet Explorerのみを使用してSpacesにアクセスし、WNAがセットアップされたドメインに限定されている場合にお薦めします。

- Spacesへのパブリック・アクセスを維持する必要がある場合は、WC_Spacesサーバーを起動する際にoracle.webcenter.spaces.osso=trueフラグを使用することをお薦めします。このフラグはSSOが使用されていることをSpacesに告げるため、デフォルトのランディング・ページにログイン・フォームは表示されなくなります。そのかわりにログイン・リンクが表示され、これをユーザーがクリックするとSSO認証が呼び出されて、ユーザーは自動的にログインできます。Firefoxを使用してWNAに構成されたWindowsネットワーク内でSpacesにアクセスする場合、または任意のブラウザを使用してWindowsネットワーク・ドメイン外からSpacesにアクセスする場合は、ユーザーがログイン・リンクをクリックするとログイン・ページが表示されます。

31.5.3.4 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のOracle WebCenter Portalのディスカッション・サーバーを構成する方法について説明します。SSO用のディスカッション・サーバーを構成する前に、第29.5.1項「外部LDAPを使用するためのWebCenter Portalのディスカッション・サーバーの移行」の説明に従って、Spacesと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。

SSO用のディスカッション・サーバーを設定する手順は次のとおりです。

1. Oracle WebCenter Portalのディスカッション・サーバー管理コンソールにログインします。

http://host:port/owc_discussions/admin

hostおよびportは、WC_Collaboration管理対象サーバーのホストIDとポート番号です。

2. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを編集(存在している場合)または追加します(値をtrueに設定します)。

31.6 仮想ホストを使用したSSOの構成

この項では、コンテキスト・ルートとして/を使用するアプリケーションを含む環境に必要なOHS構成と、シングル・サインオンが呼び出される際にOHSで必要な追加構成について説明します。

この項の内容は次のとおりです。

- 第31.6.1項「仮想ホストの必要性の概要」

- 第31.6.2項「OSSO用の仮想ホストの構成」

- 第31.6.3項「OAM 10g用の仮想ホストの構成」

- 第31.6.4項「OAM 11g用の仮想ホストの構成」

- 第31.6.5項「仮想ホスト用のWebCenter Portalの構成」

- 第31.6.6項「構成のテスト」

31.6.1 仮想ホストの必要性の概要

WebCenter Portal Suiteには、コンテキスト・ルートとして/を使用するデスクトップ統合アプリケーションが含まれています。シングル・サインオン環境でこのアプリケーションを使用する場合は、OHSを通してこれをルーティングする必要があります。仮想ホストを使用しないでこれを行うために、次のエントリをmod_wl_ohs.confに追加することもできます。

<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

ただし、これを行うと、明示的に定義されていないすべてのコンテキスト・ルートが影響を受けます。そのため、仮想ホストが必要になります。

仮想ホストという用語は、1台のマシン上で複数のWebサイト(www.company1.comとwww.company2.comなど)を実行することを示します。仮想ホストはIPベース(それぞれのWebホストごとに異なるIPアドレスを持つこと)にすることも、名前ベース(各IPアドレスに複数の名前を持つこと)にすることもできます。それらが同じ物理サーバー上で動作しているという事実は、エンド・ユーザーにはわかりません。仮想ホストの詳細は、Apacheのドキュメントを参照してください。

31.6.2 OSSO用の仮想ホストの構成

この項では、シングル・サインオン・ソリューションとしてOSSOが構成されている場合に仮想ホストを構成する手順を説明します。これらの手順を行う前に、第31.3項「Oracle Single Sign-On(OSSO)の構成」の手順を完了していることが必要です。

OSSOで仮想ホストを使用するには、パートナ・アプリケーションを仮想ホスト・オプションに登録する必要があります。また、webtier-spaces.example.comではシングル・サインオンをバイパスする必要があります。この理由は、BASIC認証のみをサポートするアプリケーションや、シングル・サインオンを必要としないアプリケーションがあるからです。これらの構成について、次の手順で説明します。

1. mod_osso.confファイルをmoduleconfからhttpd.confと同じ場所に移動します。(moduleconf内のすべてのファイルはデフォルトで自動的にロードされますが、仮想ホストに対してOSSOを無効にする必要があります。)

2. 次の例に示されているように、httpd.confの仮想ホストのセットアップを更新します。

NameVirtualHost *:7777

<VirtualHost *:7777>
ServerName webtier.example.com
include mod_osso.conf
</VirtualHost>

<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

mod_osso.confをデフォルト仮想ホストにインクルードすることで、デフォルト仮想ホスト(webtier.example.com)にシングル・サインオン・エクスペリエンスを提供します。ただし、一部のアプリケーションはこれをサポートしないため、Spaces仮想ホスト(webtier-spaces.example.com)にはシングル・サインオン・エクスペリエンスを提供しません。

3. OHSを再起動します。また、必ずwebtier-spaces.example.comのエントリを使用してDNSを更新してください。

注意:

シングル・サインオンをバイパスするwebtier-spaces.example.com仮想ホストでは、シングル・サインオンをバイパスする必要があるのは、一部のアプリケーションのみです。Spacesなどの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

31.6.3 OAM 10g用の仮想ホストの構成

仮想ホストにOAM 10gを構成するには、BASIC認証のみをサポートするアプリケーションやシングル・サインオンを必要としないアプリケーションについてシングル・サインオンをバイパスする必要があります。詳細は、10g用のOracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドのWebGateと特定仮想ホスト、ディレクトリまたはファイルの関連付けに関する項を参照してください。

これらの手順を完了する前に、第31.2項「Oracle Access Manager(OAM)の構成」に示されているOAM 10gの構成手順を完了していることが必要です。

1. httpd.confの次の構成を見つけてコメント・アウトします。

#Comment out this and move to VirtualHost configuration
#<LocationMatch "/*">
#AuthType Oblix
#require valid-user
#</LocationMatch>

このエントリがあると、WebGateはすべてのリクエストをインターセプトして処理します。

2. 次の例に示されているように、シングル・サインオンが必要とされる仮想ホスト構成にこのエントリを移動します。

NameVirtualHost *:7777

<VirtualHost *:7777>
ServerName webtier.example.com
<LocationMatch "/*">
AuthType Oblix
require valid-user
</LocationMatch>
</VirtualHost>

<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

デフォルト仮想ホスト(webtier.example.com)にはシングル・サインオン・エクスペリエンスを提供しますが、一部のアプリケーションはこれをサポートしないため、Spaces仮想ホスト(webtier-spaces.example.com)にはシングル・サインオン・エクスペリエンスを提供しないという考え方です。

3. OHSを再起動します。さらに、webtier-spaces.example.comのエントリによるDNSの更新も行ってください。

注意:

シングル・サインオンをバイパスするwebtier-spaces.example.com仮想ホストでは、シングル・サインオンをバイパスする必要があるのは、一部のアプリケーションのみです。Spacesなどの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

31.6.4 OAM 11g用の仮想ホストの構成

仮想ホストにOAM 11gを構成するには、BASIC認証のみをサポートするアプリケーションやシングル・サインオンを必要としないアプリケーションについてシングル・サインオンをバイパスする必要があります。

これらの手順を完了する前に、第31.2項「Oracle Access Manager(OAM)の構成」に示されているOAM 11gの構成手順を完了していることが必要です。

OAM 11gの仮想ホストを構成する手順は次のとおりです。

1. webgate.confの次の構成を見つけてコメント・アウトします。

#Comment out this and move to VirtualHost configuration
#<LocationMatch "/*">
#AuthType Oblix
#require valid-user
#</LocationMatch>

このエントリがあると、WebGateはすべてのリクエストをインターセプトして処理します。

2. 次の例に示されているように、シングル・サインオンが必要とされるhttpd.confの仮想ホスト構成にこのエントリを移動します。

NameVirtualHost *:7777

<VirtualHost *:7777>
ServerName webtier.example.com
<LocationMatch "/*">
AuthType Oblix
require valid-user
</LocationMatch>
</VirtualHost>

<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

デフォルト仮想ホスト(webtier.example.com)にはシングル・サインオン・エクスペリエンスを提供しますが、一部のアプリケーションはこれをサポートしないため、Spaces仮想ホスト(webtier-spaces.example.com)にはシングル・サインオン・エクスペリエンスを提供しないという考え方です。

3. OHSを再起動します。さらに、webtier-spaces.example.comのエントリによるDNSの更新も行ってください。

注意:

シングル・サインオンをバイパスするwebtier-spaces.example.com仮想ホストでは、シングル・サインオンをバイパスする必要があるのは、一部のアプリケーションのみです。Spacesなどの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

31.6.5 仮想ホスト用のWebCenter Portalの構成

この項では、仮想ホストを通してルーティングされるアプリケーションに必要な追加構成について説明します。

Sharepoint

MS Office製品の単語の編集機能または類似機能を使用すると、通常はWebCenter Portal Sharepointアプリケーションが現在のリクエストからホスト名とポート名を取得します。ただし、この場合、Sharepointアプリケーションは仮想ホストを通してルーティングする必要があり、この仮想ホストでは一部のシステム・プロパティをWebLogicドメインのsetDomainEnvに設定することが必要とされます。クラスタ・セットアップの場合は、マシンごとに必ずこれらのプロパティを変更してください。

-Dnon_sso_host=webtier-spaces.example.com
-Dsso_base_url=http://webtier.example.com:7777

31.6.6 構成のテスト

この項では、仮想ホストおよびシングル・サインオン構成のテスト方法を説明します。

Sharepoint

1. http://webtier.example.com:7777/webcenterにアクセスして、SSOによってチャレンジされることをチェックします。

2. ログインしてMS Wordドキュメントを選択し、「単語の編集」をクリックします。確認のダイアログが表示されたら、「OK」をクリックします。WordによってBASIC認証のチャレンジが実行されます。資格証明を入力すると、ドキュメントを表示できます。

3. Officeアイコン→「サーバー」→「ドキュメント管理情報」に移動して、「サイトをブラウザーで開く」をクリックします。これによって、デフォルト・ブラウザで、ドキュメントが属するスペースが開きます。
MS Officeの統合には、ドキュメントのURLと同じURLに移動する必要があるという制限があるため、BASIC認証チャレンジによって入力が要求されることに注意してください。webtier.example.comを通してスペースにリダイレクトされて、まだログインしていない場合はログインするように要求されます。

32 シングル・サインオン向けのFrameworkアプリケーションの構成

この章では、WebCenter Portal: Frameworkアプリケーションをシングル・サインオン(SSO)向けに構成する方法を説明します。この章で説明する構成ではすべて、第31項「シングル・サインオンの構成」の説明に従ってSSOがすでに構成されていることが前提となっています。

この章の内容は次のとおりです。

- 第32.1項「構成の概要」

- 第32.2項「シングル・サインオンの前提条件」

- 第32.3項「Web層の構成」

- 第32.4項「OAMに対するFrameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成」

- 第32.5項「OSSOに対するFrameworkアプリケーションの構成」

- 第32.6項「SAML SSOに対するFrameworkアプリケーションの構成」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

32.1 構成の概要

Oracle WebCenter Portalでは、WebCenter Portal: Frameworkアプリケーションに対して、次のSSOソリューションのシングル・サインオン(SSO)がサポートされます。

- OAM 10g

- OAM 11g

- OSSO

- SAML SSO (宛先アプリケーションとしてのFrameworkアプリケーション)

- SAML SSO (ソース・アプリケーションとしてのFrameworkアプリケーション)

Frameworkアプリケーションをシングル・サインオンに含めることができるようにするには、第31章「シングル・サインオンの構成」で説明しているSSOの構成に加えて、選択したSSOソリューションに対してFrameworkアプリケーション自体を構成することも必要です。これを実行するには、第32章「シングル・サインオンの前提条件」に示された手順を実行した後、特定のソリューションの手順を続行してください。この場合、唯一の例外がSAML SSOで、Frameworkアプリケーションがソース・アプリケーションとして機能します。すべての手順については、前提条件を含めて、第32.6.2項「ソースとしてのFrameworkアプリケーションに対するSAML SSOの構成」で説明しています。

32.2 シングル・サインオンの前提条件

SSOに含めるすべてのFrameworkアプリケーションでは、そのアプリケーションの保護に使用されるシングル・サインオン・ソリューションに関係なく、一定の構成を適切に行うことが必要です。この場合、唯一の例外がSAML SSOで、Frameworkアプリケーションがソース・アプリケーションとして機能します(詳細は、第32.6.2項「ソースとしてのFrameworkアプリケーションに対するSAML SSOの構成」を参照してください)。

シングル・サインオンの一般的な前提条件は、次の各項で説明しています。

- 第32.2.1項「web.xmlへのCLIENT-CERTの追加」

- 第32.2.2項「JSESSIONIDのCookieパスの設定」

- 第32.2.3項「アプリケーションの公開URIおよび保護対象URIの指定」

- 第32.2.4項「埋込みログインの意味」

- 第32.2.5項「ログアウトの処理」

32.2.1 web.xmlへのCLIENT-CERTの追加

すべてのSSOソリューションで、WLSドメインに構成されたアイデンティティ・アサータが使用されます。これは、SSO構成で提供されるアサーション・タイプをアサートします。たとえば、OAMの場合、アイデンティティ・アサータは、ObSSOCookieまたはOAM_REMOTE_USERヘッダーに基づいてアサートし、SAML SSOの場合はSAMLアサーションをアサートします。

アサータでアイデンティティをアサートするには、アプリケーションのログイン構成に認証方式としてCLIENT-CERTを指定する必要があります。つまり、次の例で示しているように、アプリケーションのweb.xmlファイルに、auth-methodとしてCLIENT-CERTを指定する必要があります。

<login-config>
<auth-method>CLIENT-CERT,FORM</auth-method>

WebLogicでは、カンマ区切りの認証方式を指定できます。この例では、SSOアサーション(CLIENT-CERT)を使用できない場合、アプリケーションではFORMベースの認証が使用されます。

32.2.2 JSESSIONIDのCookieパスの設定

SSOの設定では、アプリケーションのCookieパスを設定するようお薦めします。WLSでこれを行うには、weblogic.xmlファイルを編集し、次のエントリを追加します。

<session-descriptor>
<cookie-path>/customportal</cookie-path>
</session-descriptor>

customportalは、アプリケーションのコンテキスト・ルートです。

32.2.3 アプリケーションの公開URIおよび保護対象URIの指定

SSO構成では、アプリケーションの公開URIおよび保護対象URIを指定します。SSOソリューションによっては、OSSOやSAML SSOのように、保護対象URIの指定のみが必要です。次のリストは、Frameworkアプリケーションに使用される一般的な保護対象URIおよび公開URIを示しています。

公開URI

/<app-context-root>

保護対象URI

/<app-context-root>/adfAuthentication

使用しているアプリケーションの保護対象URIは、次の例に示しているように、web.xmlファイルのsecurity-constraintノードを確認することによって決定できます。

<security-constraint>
<web-resource-collection>
<web-resource-name>adfAuthentication</web-resource-name>
<url-pattern>/adfAuthentication</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>valid-users</role-name>
</auth-constraint>
</security-constraint>

security-constraintノード内のエントリは常に、アプリケーションのコンテキスト・ルートに相対的です。この例では、このセキュリティ制約は/app-context-root/adfAuthenticationであると解釈できます。別のセキュリティ制約が指定されている場合、たとえば/adminが指定されているとすると、/app-context-root/adminであると解釈できます。

32.2.4 埋込みログインの意味

Frameworkアプリケーションでは通常、ログイン・ページがweb.xml構成ファイルのlogin-configセクションで構成されるformベースのログイン・メカニズムが使用されます(個別のログイン構成ファイルはありません)。アプリケーションで、ページ・テンプレートにログイン領域を埋め込むことや、ランディング・ページを作成することもできます。この場合は通常、ユーザーの資格証明が、認証のためにj_security_checkに送信されます。ただし、SSOの場合、認証はSSOログイン・チャレンジを通して実行する必要があります。

32.2.5 ログアウトの処理

すべてのSSOソリューションに対して、ログアウトを処理するためのADF認証サーブレットが用意されています。使用しているアプリケーションのログアウトで、ADF認証サーブレットがログアウト用に呼び出されるようにする必要があります。これを実行するには、次の例で示しているように、使用しているアプリケーションのfaces-config.xmlファイルで、正常なログアウトのナビゲーション・ルールを変更する必要があります。

<navigation-case>
<from-outcome>logout_success</from-outcome>
<to-view-id>/adfAuthentication?logout=true&amp;end_url=/</to-view-id>
<redirect/>
</navigation-case>

/adfAuthenticationのend_urlパラメータは、正常なログアウト後にユーザーをダイレクトする宛先の任意のURLに指定できます。たとえば、/を指定すると、ユーザーはアプリケーションのデフォルトのページにダイレクトされます。

32.3 Web層の構成

エンタープライズ・アプリケーションのフロントエンド処理を行うWeb層が環境に含まれる場合、SSO向けにそのWeb層を構成する必要があります。Web層は、OAMソリューションおよびOSSOソリューションに必要で、Content Serverが関連する場合にはSAML SSOソリューションで使用されます。

1. 次の例で示しているように、mod_wl_ohs.confにアプリケーションのマッピングを追加します。

<Location /customportal>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

customportalは、アプリケーションのコンテキスト・ルートです。

2. Oracle HTTP Serverを再起動します。

32.4 OAMに対するFrameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成

この項では、OAM 10gおよび11gに対して、WebCenter Portal: FrameworkアプリケーションまたはWebCenter Portal:ポートレット・プロデューサ・アプリケーションを構成する方法を説明します。この項の手順を実行する前に、第31.2項「Oracle Access Manager (OAM)の構成」の手順をすでに実行して、Spacesおよび関連アプリケーションに対してSSOを設定しておく必要があります。また、第32.2項「シングル・サインオンの前提条件」の構成も完了しておく必要があります。

注意:

開始する前に、Frameworkアプリケーションのデプロイ先のドメイン内でOAMによって使用されているアイデンティティ・ストアのLDAPをポイントするように、必須のOAMアサータおよびオーセンティケータを構成しておく必要があります。これをまだ実行していない場合は、開始する前に、第31.2項「Oracle Access Manager (OAM)の構成」の手順を実行してください。

この項の内容は次のとおりです。

- 第32.4.1項「OAM 10gに対するFrameworkアプリケーションの構成」

- 第32.4.2項「OAM 10gに対するポートレット・プロデューサ・アプリケーションの構成」

- 第32.4.3項「OAM 11gに対するFrameworkアプリケーションの構成」

- 第32.4.3項「OAM 11gに対するFrameworkアプリケーションの構成」

32.4.1 OAM 10gに対するFrameworkアプリケーションの構成

この項では、OAM 10gを使用したシングル・サインオン向けにFrameworkアプリケーションを構成する方法を説明します。アプリケーションを構成する前に、第31.2項「Configuring Oracle Access Manager (OAM)」の説明に従って、OAMのインストールと構成を完了しておく必要があります。

OAM 10gに対してFrameworkアプリケーションを構成する手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/access/oblix

2. 「ポリシー・マネージャ」をクリックします。

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。

5. リソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebCenter Portal Web層のホストIDを選択します。

3. アプリケーションのURL接頭辞(/<app-context-root>)を入力します。

4. リソースの説明を入力します。

5. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

6. 手順5を繰り返して、リソースとして/<app-context-root>/adfAuthenticationを追加します。

7. 「ポリシー」タブに移動して、パブリック・ポリシーを見つけます。

8. パブリック・ポリシーを開いて、手順5で作成したリソース(/<app-context-root>)を選択します。

9. 変更を保存します。

10. Web層を再起動し、変更をテストします。

32.4.2 OAM 10gに対するポートレット・プロデューサ・アプリケーションの構成

この項では、OAM 10gを使用したシングル・サインオン向けにポートレット・プロデューサ・アプリケーションを構成する方法を説明します。ポートレット・プロデューサ・アプリケーションを構成する前に、第32.4.1項「OAM 10gに対するFrameworkアプリケーションの構成」の手順を実行してから、次の手順を実行してください。

OAM 10gに対してポートレット・プロデューサ・アプリケーションを構成する手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/access/oblix

2. 「ポリシー・マネージャ」をクリックします。

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。

5. 「リソース・タイプ」としてHTTPを選択します。

6. WebCenter Portal Web層のホストIDを選択します。

7. アプリケーションのURL接頭辞(/<app-context-root/portlets>)を入力します。

8. リソースの説明を入力します。

9. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

10. 「ポリシー」タブに移動して、除外スキーム・ポリシーを見つけ、このポリシーに対して、新規作成したポートレット・プロデューサ・リソースを選択します。

11. このポリシーを開いて、手順5で作成したリソース(/<app-context-root>/portlets)を選択します。

12. 変更を保存します。

13. Web層を再起動し、変更をテストします。

32.4.3 OAM 11gに対するFrameworkアプリケーションの構成

この項では、OAM 11gを使用したシングル・サインオン向けにFrameworkアプリケーションを構成する方法を説明します。アプリケーションを構成する前に、第31.2項「Configuring Oracle Access Manager (OAM)」の説明に従って、OAMのインストールと構成を完了しておく必要があります。

OAM 11gに対してFrameworkアプリケーションを構成する手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/oamconsole

2. 「ポリシー構成」→「アプリケーション・ドメイン」に移動します。
「ポリシー・マネージャ」ペインが表示されます。

3. WebGateエージェントの登録で使用した名前を使用して作成したアプリケーション・ドメインを見つけます。

4. 「リソース」タブを開き、「新規リソース」をクリックします。

5. Frameworkアプリケーションのリソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. アプリケーションのリソースURL(/<app-context-root>*)を入力します。

4. リソースの説明を入力します。

5. 「保護レベル」をUnprotectedに設定します。

6. 「認証ポリシー」をPublic Resource Policyに設定します。

7. 「認可ポリシー」をProtected Resource Policyに設定します。

8. 「適用」をクリックします。

6. 手順5を繰り返して、リソースとして/<app-context-root>/.../*を追加します。

7. リソースとして/<app-context-root>/adfAuthentication*を追加します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. アプリケーションのリソースURL(/<app-context-root>/adfAuthentication*)を入力します。

4. リソースの説明を入力します。

5. 「保護レベル」をProtectedに設定します。

6. 「認証ポリシー」をProtected Resource Policyに設定します。

7. 「認可ポリシー」をProtected Resource Policyに設定します。

8. 「適用」をクリックします。

8. Web層を再起動し、変更をテストします。

32.4.4 OAM 11gに対するポートレット・プロデューサ・アプリケーションの構成

この項では、OAM 11gを使用したシングル・サインオン向けにポートレット・プロデューサ・アプリケーションを構成する方法を説明します。ポートレット・プロデューサ・アプリケーションを構成する前に、第32.4.3項「OAM 11gに対するFrameworkアプリケーションの構成」の手順を実行してから、次の手順を実行してください。

OAM 11gに対してポートレット・プロデューサ・アプリケーションを構成する手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/access/oblix

2. 「ポリシー・マネージャ」をクリックします。

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。

5. 「リソース・タイプ」としてHTTPを選択します。

6. WebGateエージェントの登録時に作成されたホストIDを選択します。

7. アプリケーションのURL接頭辞(/<app-contextroot>/portlets/.../*)を入力します。

8. リソースの説明を入力します。

9. 「保護レベル」をExcludedに設定して、「保存」をクリックします。

10. Web層を再起動し、変更をテストします。

32.5 OSSOに対するFrameworkアプリケーションの構成

この項では、WebCenter Portal: FrameworkアプリケーションをOSSO向けに構成する方法を説明します。この項の手順を実行する前に、第31.3項「Oracle Single Sign-On (OSSO)の構成」の手順をすでに実行して、Spacesおよび関連アプリケーションに対してSSOを設定しておく必要があります。また、第32.2項「シングル・サインオンの前提条件」の構成も完了しておく必要があります。

注意:

開始する前に、Frameworkアプリケーションのデプロイ先のドメイン内でOSSOによって使用されているアイデンティティ・ストア(OID)をポイントするように、必須のOSSOアサータおよびオーセンティケータを構成しておく必要があります。これをまだ実行していない場合は、開始する前に、第31.3項「Oracle Single Sign-On (OSSO)の構成」の手順を実行してください。

OSSOに対してFrameworkアプリケーションを構成する手順は次のとおりです。

1. OHS内でmod_osso.confファイルを見つけ、これを開きます。

2. Frameworkアプリケーションの次のエントリを他の同様のエントリに追加します。

<Location /<app-context-root>/adfAuthentication>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>

3. OHSを再起動します。

32.6 SAML SSOに対するFrameworkアプリケーションの構成

この項では、FrameworkアプリケーションにSAML SSOを設定する方法を説明します。SAMLシングル・サインオンは、エンタープライズSSOソリューションを使用できない小規模の環境(たとえば、部門)に対してのみ推奨されます。

手順は次の2つのシナリオに分かれます。

- シナリオ1: 宛先アプリケーションとしてのFrameworkアプリケーション
これは、WebCenter Portal SAML SSOスクリプトで指定されるデフォルトのSAML SSO動作で、ここではSpacesアプリケーションがソース・アプリケーションで、その他すべてのアプリケーションが宛先アプリケーションです(つまり、シングル・サインオンで他の宛先アプリケーションを動作させるには、Spacesにログインする必要があります)。

- シナリオ2: ソース・アプリケーションとしてのFrameworkアプリケーション
この動作は、WebCenter Portal SAML SSOスクリプトではサポートされていないため、手動の構成が必要です。このシナリオでは、FrameworkアプリケーションをSAMLソースとして動作させ、その他のアプリケーション(Spacesを含む)を宛先アプリケーションとして動作させます(つまり、Frameworkアプリケーションが最初のアクセス・ポイントであり、シングル・サインオンでその他の宛先アプリケーションを動作させるためにそのFrameworkアプリケーションにログインする必要があります)。

SAMLをFrameworkアプリケーションに構成するこれら2つの方法については、次の各項で説明しています。

- 第32.6.1項「宛先のFrameworkアプリケーションへのSAML SSOの構成」

- 第32.6.2項「ソースのFrameworkアプリケーションへのSAML SSOの構成」

32.6.1 宛先のFrameworkアプリケーションへのSAML SSOの構成

この項の手順を実行する前に、Spacesおよび関連アプリケーションに対してSSOを設定する方法を説明している第31.4項「SAMLベースのシングル・サインオンの構成」の前提条件と手順をすでに完了しておく必要があります。この項で示す手順によって、その設定にFrameworkアプリケーションの構成手順が追加されます。

このシナリオでは、Spacesアプリケーションはソース・アプリケーションとして動作を続け、シングル・サインオンに宛先アプリケーションとして含まれる新規Frameworkアプリケーションと連動します(つまり、Spacesにログインした場合にFrameworkアプリケーションのいずれかの保護対象URIにアクセスすると、自動的にログインされます)。Spacesにまだログインしていないときに保護対象URIにアクセスすると、Spacesのログイン・ページにダイレクトされた後に、アプリケーションのセキュアなページにリダイレクトされて戻ります。

次の手順では、次のことが前提となっています。

- Frameworkアプリケーションが、configureSpaces.pyスクリプトが実行されたSpacesドメインにデプロイされている。Frameworkアプリケーションがこれとは別のドメインにある場合は、WLS管理コンソール(「セキュリティ・レルム」→「プロバイダ」→「オーセンティケータ」)でSAMLIdentityAsserterV2 IDアサータを作成し、WLSを再起動します。その上で、SAML SSOの設定で使用した証明書をエクスポートし、作成したSAMLアイデンティティ・アサータの下にその証明書を登録する必要があります。

- 後述の手順および例のパラメータ値では、demoidentity証明書を使用していることが前提となっている。これとは別の証明書を使用している場合は、必要に応じて証明書の名前を変更します。

- Web層が構成に含まれる場合は、ホストIDおよびポートIDは、Web層のホストIDとポートIDである。

この項の内容は次のとおりです。

- 第32.6.1.1項「宛先サイトの有効化」

- 第32.6.1.2項「リライイング・パーティの構成」

- 第32.6.1.3項「アサーティング・パーティの構成」

32.6.1.1 宛先サイトの有効化

Frameworkアプリケーションの宛先サイトを有効にする手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. 「サーバー」→[ポータル・アプリケーションをホストしているサーバー]→「構成」→「フェデレーション・サービス」→「SAML 1.1宛先サイト」を選択します。

3. 表32-1に示したように宛先サイトのパラメータを入力します。

表32-1 宛先サイトのパラメータ

パラメータ

値

説明

宛先サイトの有効化

選択

宛先サイトを有効にするかどうかを指定します。

ACSでSSLが必要

選択解除

アサーション・コンシューマ・サービスでSSLを必要とするかどうかを指定します。選択した場合は、資格証明マッパーのリライイング・パーティに指定されたACS URLで、HTTPSおよびターゲット・サーバーのSSLポートが必ず使用されるようにします。

アサーション・コンシューマのURI

/<app-context-root>/samlacs/acs

(新しく追加し、他の部分はそのまま)

アサーション・コンシューマのURI。ここでは、同じログインCookieが使用されるように、ターゲット・アプリケーション内に存在するACSを選択しています。

POST受信者チェックの有効化

選択

POST受信者のチェックが有効化されるかどうかを指定します。trueに設定されている場合、SAMLレスポンスの受信者は、HTTPリクエストのURLと一致している必要があります。

POST使用済みチェックの有効化

選択

POSTの使用を1回にするチェックが有効化されるかどうかを指定します。

4. 変更を保存し、他の部分はデフォルト値のままにします。

5. Frameworkアプリケーションをホストしているサーバーを再起動します。

32.6.1.2 リライイング・パーティの構成

Frameworkアプリケーションにリライイング・パーティを構成する手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. 「セキュリティ・レルム」→「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択します。

3. 表32-2のパラメータを使用して、新規リライイング・パーティを作成します。

表32-2 リライイング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このSAMLリライイング・パーティが使用するSAMLプロファイル。

有効

選択

このSAMLリライイング・パーティの状態。

説明

Frameworkアプリケーション

このリライイング・パーティの簡単な説明。

ターゲットURL

http://host:port/<app-context-root>

認証がリクエストされた宛先サイトのURL。

アサーション・コンシューマのURL

http://host:port/<app-context-root>/samlacs/acs

このSAMLリライイング・パーティのアサーション・コンシューマ・サービスに接続するURL。アサーションまたはアーティファクトのPOST実行先またはリダイレクト先のURLを示します。宛先サイトのフェデレーション・サービスの構成時にACSにSSLが必要であることを選択した場合は、HTTPSプロトコルおよび管理対象サーバーのSSLポートを使用します。

アサーション・コンシューマのプロパティ

APID=ap_0000X

Xは、次の手順で作成するアサーティング・パーティのIDを示します。

アサーションの署名

選択

このSAMLリライイング・パーティで生成されるアサーションに署名するかどうかを指定します。

Keyinfoを含める

選択

アサーションの署名時に、署名用証明書を含む<ds:keyinfo>要素を含めるかどうかを示します。デフォルト値はtrueです。「アサーションの署名」がfalseの場合、この値は無視されます。

4. 変更を保存し、他の部分はデフォルト値のままにします。

32.6.1.3 アサーティング・パーティの構成

Frameworkアプリケーションにアサーティング・パーティを構成する手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. 「セキュリティ・レルム」→「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択します。

3. 表32-3のパラメータを使用して、新規アサーティング・パーティを作成します。

表32-3 アサーティング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このパートナとともに使用されるSAMLプロファイル。

有効

選択

SAMLアサーションの取得にこのアサーティング・パーティを使用できるかどうかを指定します。

説明

Spaces

このアサーティング・パーティの簡単な説明。

ターゲットURL

http://host:port/webcenter

このSAMLアサーティング・パーティのターゲットURL。

POST署名用証明書別名

demoidentity

このアサーティング・パーティからのSAMLプロトコル要素の署名を検証する、信頼性のある証明書の別名。Browser/POSTプロファイルに設定する必要があります。

ソース・サイトのリダイレクトURI

/<app-context-root>/adfAuthentication

未認証ユーザーを構成済のITS URLにリダイレクトするためのオプションのURIセット。これを設定した場合、サイト間転送URLも設定する必要があります。

注意: この設定により、宛先サイトに先にアクセスすると、構成されているITS URL(この場合はソース・アプリケーション内)にリダイレクトされ、セッションがソース・アプリケーションに対して確立されてから、宛先サイトにリダイレクトされます。

ソース・サイトITS URL

http://host:port/webcenter/samlits/its

このアサーティング・パーティのSAMLソース・サイトのサイト間転送サービス(ITS)URL。宛先サイトが最初のアクセス・ポイントになるシナリオをサポートするために、このURLはSSOプロファイルとともにのみ使用するようにしてください。そうすることで、認証前に宛先サイトのURLにアクセスしようとするユーザーは、認証を受けてSAMLアサーションを取得するためにソース・サイトにリダイレクトされます。ソースサイトのリダイレクトが機能するためには、「リダイレクトURI」属性も構成する必要があります。

注意: ソース・サイト・フェデレーション・サービスで「ITSでSSLが必要」を選択した場合、ソース・サイトITS URLを、HTTPSとサーバーのSSLポートを使用するように変更する必要があります。

ソース・サイトのITSパラメータ

RPID=rp_0000X

Xを、前もって作成したリライイング・パーティのIDに置き換えます。

発行者URI

http://www.oracle.com/webcenter

このSAMLアサーティング・パーティのアサーションを発行するSAMLオーソリティの発行者URI。

署名が必要

選択

trueの場合、アサーションは署名される必要があります。falseの場合、署名要素は必須ではありません。ただし、署名要素を指定した場合は検証されます。

アサーション署名用証明書別名

demoidentity

4. 変更を保存し、他の部分はデフォルト値のままにします。

5. シングル・サインオンが予期したとおりに動作することをテストして続行します。

32.6.2 ソースのFrameworkアプリケーションへのSAML SSOの構成

このシナリオでは、Frameworkアプリケーションは、ソース・アプリケーションとして機能して、その他のアプリケーション(Spacesなど)は宛先として機能します。Content Serverを組み込む構成を行うには、この項で説明する構成を実行する前に、第31.4.2.1.1「SAML SSO用のOracle Content Serverの構成」の関連手順を実行しておく必要があります。

次の手順では、次の前提が基になっています。

- WebCenter Portal SAML SSOスクリプトは実行されていない。このスクリプトによって、Spacesがソース・アプリケーションとして機能するよう構成されるため、次の手順を手動で実行しなければならなくなります。

- デフォルトのdemoidentity証明書を使用しており、Frameworkアプリケーションをホストしているドメインからこの証明書をすでにdemoidentity.derにエクスポートした。

- Frameworkアプリケーションは、/customportalである。

- Content Serverを組み込む構成であり、Web層が構成に含まれる場合は、ホストIDおよびポートIDは、Web層のホストIDとポートIDである。

この項の内容は次のとおりです。

- 第32.6.2.1項「SAML ITSの保護」

- 第32.6.2.2項「JSESSIONIDのCookieパスの設定」

- 第32.6.2.3項「SSOプロパティのTrueとしての設定」

- 第32.6.2.4項「SAML資格証明マッピング・プロバイダの構成」

- 第32.6.2.5項「リライイング・パーティの構成」

- 第32.6.2.6項「ソース・サイトのフェデレーション・サービスの構成」

- 第32.6.2.7項「SAMLアイデンティティ・アサーション・プロバイダの構成」

- 第32.6.2.8項「宛先サイトのフェデレーション・サービスの構成」

- 第32.6.2.9項「その他の宛先アプリケーションの構成」

32.6.2.1 SAML ITSの保護

Frameworkアプリケーションのweb.xmlファイルで、/adfAuthenticationを保護するためのエントリの後に次のエントリを追加します。

<security-constraint>
<web-resource-collection>
<web-resource-name>samlits</web-resource-name>
<url-pattern>/samlits/its</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>valid-users</role-name>
</auth-constraint>
</security-constraint>

32.6.2.2 JSESSIONIDのCookieパスの設定

SSOの設定では、アプリケーションのコンテキスト・ルートへのCookieパスを設定するようお薦めします。WLSでこれを行うには、weblogic.xmlファイルを編集し、次のエントリを追加します。

<session-descriptor>
<cookie-path>/customportal</cookie-path>
</session-descriptor>

customportalは、アプリケーションのコンテキスト・ルートです。

32.6.2.3 SSOプロパティのTrueとしての設定

ここではSpacesアプリケーションは宛先アプリケーションとして機能するため、Spacesのランディング・ページ上のログイン領域を非表示にする必要があります。これを実行するには、setDomainEnvファイルに次のプロパティを設定し、変更が適用されるようにWC_Spacesサーバーを再起動します。

EXTRA_JAVA_PROPERTIES="-Doracle.webcenter.spaces.osso=true ${EXTRA_JAVA_PROPERTIES}"
export EXTRA_JAVA_PROPERTIES

32.6.2.4 SAML資格証明マッピング・プロバイダの構成

Frameworkアプリケーションをホストしているドメインのセキュリティ・レルムで、SAML資格証明プロバイダV2 (SAMLCredentialMapperV2)インスタンスを作成します。SAML資格証明マッピング・プロバイダは、デフォルトのセキュリティ・レルムには含まれません。表32-4で示している「発行者URI」、「名前修飾子」およびその他の属性を使用して、SAML資格証明マッピング・プロバイダをSAML認証局として構成します。

表32-4 SAML資格証明マッピング・プロバイダのパラメータ

パラメータ

値

説明

発行者URI

http://www.oracle.com/webcenter

対象のSAML認証局の発行者URI(名前)。この一意のURIは、宛先サイト(owc_wiki)にSAMLメッセージの発信元を示し、キーと照合できるようにします。通常、一意性を保証するためにURLが使用されます。

名前修飾子

oracle.com

名前マッパーで使用される名前修飾子の値。名前修飾子の値は、サブジェクトの名前を修飾するセキュリティ・ドメインまたは管理ドメインです。これによって、サブジェクト名の衝突を回避しながら、異種のユーザー・ストアから名前のフェデレーションを実行できるようになります。

署名鍵別名

demoidentity

キーストアから、アサーションの署名に使用するキーを取得するときに使用される別名。

署名鍵パスフレーズ

DemoIdentityPassPhrase

キーストアから、アサーションの署名に使用するキーを取得するときに使用される資格証明(パスワード)。

変更を保存し、その他のパラメータについてはデフォルト値を受け入れて、WLSのすべてを再起動します。

32.6.2.5 リライイング・パーティの構成

宛先アプリケーションごとにリライイング・パーティの構成が必要になります。次の手順は、Spacesを例として使用して、この構成を行う方法を示しています。その他のアプリケーションについては、第32.6.2.9項「その他の宛先アプリケーションの構成」の表32-10を参照し、次の手順を参照として使用して、強調表示されている値を適宜変更してください。

Spacesにリライイング・パーティを構成する手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. 「セキュリティ・レルム」→レルム名→「プロバイダ」→「資格証明マッピング」→SAML資格証明マッパー名→「管理」→「リライイング・パーティ」を選択します。

3. 表32-5のパラメータを使用して、新規リライイング・パーティを作成します。

表32-5 Spacesの場合のリライイング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このSAMLリライイング・パーティが使用するSAMLプロファイル。

有効

選択

このSAMLリライイング・パーティの状態。

説明

Spaces

このリライイング・パーティの簡単な説明。

ターゲットURL

http://host:port/webcenter

認証がリクエストされた宛先サイトのURL。

アサーション・コンシューマのURL

http://host:port/webcenter/samlacs/acs

このSAMLリライイング・パーティのアサーション・コンシューマ・サービスに接続するURL。アサーションまたはアーティファクトのPOST実行先またはリダイレクト先のURLを示します。

注意: 宛先サイトのフェデレーション・サービスの構成時にACSにSSLが必要であることを選択した場合は、HTTPSプロトコルおよび管理対象サーバーのSSLポートを使用します。

アサーション・コンシューマのプロパティ

APID=ap_00001

1つ以上のオプションの問合せパラメータ(name=valueの形式)であり、宛先サイトへのリダイレクト時にACS URLに追加されます。

POSTプロファイルの場合、これらのパラメータはデフォルトのPOSTフォームの使用時にフォーム変数として追加されます。ここで、ap_00001はFrameworkアプリケーション(customportal)のアサーティング・パーティのIDを示しています。これは後で、FrameworkアプリケーションをホストしているドメインのSAMLアイデンティティ・アサータで構成します。これによってソース・サイトおよびITS詳細が指定されます。

アサーションの署名

選択

このSAMLリライイング・パーティで生成されるアサーションに署名するかどうかを指定します。

Keyinfoを含める

選択

アサーションの署名時に、署名用証明書を含む<ds:keyinfo>要素を含めるかどうかを示します。デフォルト値はtrueです。「アサーションの署名」がfalseの場合、この値は無視されます。

4. 変更を保存し、他の部分はデフォルト値のままにします。

32.6.2.6 ソース・サイトのフェデレーション・サービスの構成

ソース・サイトのフェデレーションを構成する手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. 「環境」→「サーバー」→カスタム・ポータルをホストしているサーバー→「構成」→「フェデレーション・サービス」→「SAML 1.1ソースサイト」を選択します。

3. 表32-6に示したようにSAMLソース・サイトの属性を構成します。

表32-6 ソース・サイトのフェデレーション・サービスのパラメータ

パラメータ

値

説明

ソース・サイトの有効化

選択

「ソース・サイトの有効化」をtrueに設定すると、WebLogicサーバー・インスタンスがSAMLソース・サイトとして機能できるようになります。

ソース・サイトURL

http://host:port/customportal

SAMLソース・サイトのURLを設定します。これは、サイト間転送サービスおよびアサーション取得サービスをホストするURLです。ソース・サイトのURLは、ソースIDとして16進数およびBase64でエンコードされます。

署名鍵別名

demoidentity

SAMLソース・サイトは、アサーションに署名する信頼できる証明書を要求します。この証明書をキーストアに追加し、証明書へのアクセスに使用する資格証明(別名とパスフレーズ)を入力します。署名別名およびパスフレーズが指定されない場合、サーバーのSSL IDキー/証明書がデフォルトで使用されます。

署名鍵パスフレーズ

DemoIdentityPassPhrase

SAMLソース・サイトは、アサーションに署名する信頼できる証明書を要求します。この証明書をキーストアに追加し、証明書へのアクセスに使用する資格証明(別名とパスフレーズ)を入力します。署名別名およびパスフレーズが指定されない場合、サーバーのSSL IDキー/証明書がデフォルトで使用されます。

サイト間転送URI

/customportal/samlits/its

(新しく追加し、他の部分はそのまま。)

サイト間転送サービスおよび(Browser/Artifactプロファイルをサポートするための)アサーション取得サービスのURIを指定します。これらのURIは、アサーティング・パーティの構成でも指定されます。

アサーション取得用URI

/customportal/samars/ars

(新しく追加し、他の部分はそのまま。)

ArtifactプロファイルがRESTに使用されている場合にのみ適用されます。

ITSでSSLが必要

選択解除

これを選択すると、SAMLアイデンティティ・プロバイダのSAMLアサーティング・パーティの構成でHTTPSおよびサーバーのSSLポートとして指定されているソース・サイトのITS URLの変更が必要になります。

ARSでSSLが必要

選択解除

Artifactプロファイルが使用されている場合にのみ適用されます。

4. 変更を保存し、他の部分はデフォルト値のままにします。

5. Frameworkアプリケーションをホストしているサーバーを再起動します。

32.6.2.7 SAMLアイデンティティ・アサーション・プロバイダの構成

SAMLアイデンティティ・アサーション・プロバイダを構成する手順は次のとおりです。

1. SpacesドメインのWLS管理コンソールにログオンします。

2. 第32.6.1.3項「アサーティング・パーティの構成」で説明されているとおりに、SAMLアイデンティティ・アサーション・プロバイダV2インスタンスを作成します。このとき、変更の保存後にWLSのすべてを再起動します。

3. WLS管理コンソールにログインして戻り、「セキュリティ・レルム」→レルム名→「プロバイダ」→「認証」→SAMLIdentityAsserterName→「管理」→「証明書」に移動します。

4. SAMLアイデンティティ・アサータに証明書を構成します。

5. 表32-7に示した値を使用して、SAMLアイデンティティ・アサータに証明書を構成します。

表32-7 アイデンティティ・アサータの証明書のパラメータ

パラメータ

値

説明

別名

demoidentity

新規証明書に割り当てる名前。

パス

WEBLOGIC_HOME/server/lib/demoidentity.der

インポートするX509証明書が含まれる.pemファイルまたは.derファイルのパス名を指定します。

6. 「セキュリティ・レルム」→レルム名→「プロバイダ」→「認証」→SAMLIdentityAsserterName→「管理」→「アサーティング・パーティ」に移動します。

7. 表32-8のパラメータを使用して、新規アサーティング・パーティを作成します。第32.6.2.5項「リライイング・パーティの構成」で、対応するリライイング・パーティに選択したものと同じプロファイルを使用します。

表32-8 アサーティング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このパートナとともに使用されるSAMLプロファイル。

有効

選択

SAMLアサーションの取得にこのアサーティング・パーティを使用できるかどうかを指定します。

説明

Spaces用のFrameworkアプリケーション

このアサーティング・パーティの簡単な説明。

ターゲットURL

http://host:port/customportal

このSAMLアサーティング・パーティのターゲットURL。

POST署名用証明書別名

demoidentity

このアサーティング・パーティからのSAMLプロトコル要素の署名を検証する、信頼性のある証明書の別名。Browser/POSTプロファイルに設定する必要があります。

ソース・サイトのリダイレクトURI

/webcenter/adfAuthentication

未認証ユーザーを構成済のITS URLにリダイレクトするためのオプションのURIセット。これを設定した場合、サイト間転送URLも設定する必要があります。

注意: この設定により、宛先サイトに先にアクセスすると、構成されているITS URL(この場合はソース・アプリケーション内)にリダイレクトされ、セッションがソース・アプリケーションに対して確立されてから、宛先サイトにリダイレクトされます。

ソース・サイトITS URL

http://host:port/customportal/samlits/its T

このアサーティング・パーティのSAMLソース・サイトのサイト間転送サービス(ITS)URL。宛先サイトが最初のアクセス・ポイントになるシナリオをサポートするために、このURLはSSOプロファイルとともにのみ使用するようにしてください。そうすることで、認証前に宛先サイトのURLにアクセスしようとするユーザーは、認証を受けてSAMLアサーションを取得するためにソース・サイトにリダイレクトされます。ソースサイトのリダイレクトが機能するためには、「リダイレクトURI」属性も構成する必要があります。

注意: ソース・サイト・フェデレーション・サービスで「ITSでSSLが必要」を選択した場合、ソース・サイトITS URLを、HTTPSとサーバーのSSLポートを使用するように変更する必要があります。

ソース・サイトのITSパラメータ

RPID=rp_00001

オプションの、0個以上の問合せパラメータ(name=valueの形式)であり、ソース・サイトへのリダイレクト時にITS URLに追加されます。ここでは、rp_00001は、宛先サイトの詳細を指定する、FrameworkアプリケーションのWLSドメインのSAML資格証明マッピング・プロバイダに指定されている、Spacesのリライイング・パーティIDです。

発行者URI

http://www.oracle.com/webcenter

このSAMLアサーティング・パーティのアサーションを発行するSAMLオーソリティの発行者URI。

署名が必要

選択

trueの場合、アサーションは署名される必要があります。falseの場合、署名要素は必須ではありません。ただし、署名要素を指定した場合は検証されます。

アサーション署名用証明書別名

demoidentity

対象のアサーティング・パーティからのアサーションの署名を確認するための信頼できる証明書の別名です。これは、「署名が必要」がtrueの場合に設定する必要があります。この証明書を、SAMLアイデンティティ・アサータの証明書レジストリに登録することも必要です。

8. 変更を保存し、他の部分はデフォルト値のままにします。

32.6.2.8 宛先サイトのフェデレーション・サービスの構成

宛先サイトのフェデレーション・サービスを構成する手順は次のとおりです。

1. WLS管理コンソールから、「WCドメイン」→「WC_Spaces」→「構成」→「フェデレーション・サービス」→「SAML 1.1宛先サイト」に移動します。[Spaces]

2. 表32-9の値を使用して、SAML宛先サイトの属性を構成します。

表32-9 宛先サイトのパラメータ

パラメータ

値

説明

宛先サイトの有効化

選択

宛先サイトを有効にするかどうかを指定します。

ACSでSSLが必要

選択解除

アサーション・コンシューマ・サービスでSSLを必要とするかどうかを指定します。選択した場合は、資格証明マッパーのリライイング・パーティに指定されたACS URLで、HTTPSおよびターゲット・サーバーのSSLポートが必ず使用されるようにします。

アサーション・コンシューマのURI

/webcenter/samlacs/acs

/rss/samlacs/acs

/rest/samlacs/acs

(新しく追加し、他の部分はそのまま)

アサーション・コンシューマのURI。ここでは、同じログインCookieが使用されるように、ターゲット・アプリケーション内に存在するACSを選択しています。

POST受信者チェックの有効化

選択

POST受信者のチェックが有効化されるかどうかを指定します。trueに設定されている場合、SAMLレスポンスの受信者は、HTTPリクエストのURLと一致している必要があります。

POST使用済みチェックの有効化

選択

POSTの使用を1回にするチェックが有効化されるかどうかを指定します。

3. 変更を保存し、他の部分はデフォルト値のままにします。

4. Spacesサーバーを再起動します。

32.6.2.9 その他の宛先アプリケーションの構成

Spaces以外のアプリケーションをFrameworkアプリケーションの宛先アプリケーションとして機能させる場合は、次の手順を実行します。

1. 宛先アプリケーションをホストする各ドメインに、SAML IDアサータおよび証明書を登録しておきます(第32.6.2.7項「SAMLアイデンティティ・アサーション・プロバイダの構成」の手順1から5を参照してください)。

2. 第32.6.2.5項「リライイング・パーティの構成」でSpacesに対して実行したように、FrameworkアプリケーションをホストしているWLSドメインで宛先アプリケーションのリライイング・パーティを作成します。各アプリケーションで該当する値については、表32-10を参照してください。

3. 宛先アプリケーションのWLSドメインで、Spacesに対して作成したものと同様の、対応するアサーティング・パーティを作成します。第32.6.2.7項「SAMLアイデンティティ・アサーション・プロバイダの構成」でアサーティング・パーティを作成した手順を使用します。ソース・リダイレクトURIを、宛先アプリケーションのセキュアなURIに適切に設定します。各アプリケーションで該当する値については、表32-10を参照してください。

4. アサーティング・パーティおよびリライイング・パーティが有効になっており、互いを適切にポイントしていることを確認します。つまり、アサーティング・パーティの「ソース・サイトのITSパラメータ」およびリライイング・パーティの「アサーション・コンシューマのプロパティ」が、互いに適切にポイントしている必要があります。

5. 宛先アプリケーションをホストしているサーバーの宛先サイト・フェデレーション・サービスを有効にして、第32.6.2.8項「宛先サイトのフェデレーション・サービスの構成」でWC_Spacesサーバーに対して実行したことと同じように、/yourdestinationapp/samlacs/acsのエントリを追加しておきます。各アプリケーションで該当する値については、表32-10を参照してください。

表32-10 Spaces以外の宛先アプリケーションの設定

宛先アプリケーション

ターゲットURL(リライイング・パーティ)

ACS URL(リライイング・パーティ)

ACS URI(宛先サイトのフェデレーション・サービス)

ソース・リダイレクトURI(アサーティング・パーティ)

RSS

http://host:port/rss

http://host:port/rss/samlacs/acs

/rss/samlacs/acs

/rss/rssservlet

REST

http://host:port/rest

http://host:port/rest/samlacs/acs

/rest/samlacs/acs

/rest/api/resourceIndex

ディスカッション

http://host:port/owc_discussions

http://host:port/owc_discussions/samlacs/acs

/owc_discussions/samlacs/acs

/owc_discussions/admin/forum-main.jsp

/owc_discussions/admin/content-main.jsp

/owc_discussions/login!withRedirect.jspa

/owc_discussions/login!default.jspa

/owc_discussions/login.jspa

アクティビティ・グラフ・エンジン

http://host:port/activitygraph-engines

http://host:port/activitygraph-engines/samlacs/acs

/activitygraph-engines/samlacs/acs

/activitygraph-engines/index.jsp

Content Server

http://host:port

http://host:port/samlacs/acs

/samlacs/acs

/adfAuthentication

ワークリストの詳細

http://host:port/workflow/WebCenterWorklistDetail

http://host:port/workflow/WebCenterWorklistDetail/samlacs/acs

/WebCenterWorklistDetail/samlacs/acs

/workflow/WebCenterWorklistDetail/faces/adf.task-flow

ワークリストのSDP

http://host:port/workflow/sdpmessagingsca-ui-worklist

http://host:port/workflow/sdpmessagingsca-ui-worklist/samlacs/acs

/sdpmessagingsca-ui-worklist/samlacs/acs

/workflow/sdpmessagingsca-ui-worklist/faces/adf.task-flow

ワークリストの統合

http://host:port/integration/worklistapp

http://host:port/integration/worklistapp/samlacs/acs

/worklistapp/samlacs/acs

/integration/worklistapp/ssologin

/integration/worklistapp/faces/home.jspx

33 SSLの構成

この章では、WebCenter Portalアプリケーション(FrameworkアプリケーションおよびSpacesを含む)およびコンポーネントをSSLで保護する方法を説明します。

この章の内容は次のとおりです。

- 第33.1項「SSLを使用したブラウザからSpacesへの接続の保護」

- 第33.2項「SSLを使用したブラウザからFrameworkアプリケーションへの接続の保護」

- 第33.3項「SSLを使用したOracle HTTP ServerからSpacesへの接続の保護」

- 第33.4項「SSLを使用したブラウザからディスカッション・サービスへの接続の保護」

- 第33.5項「SSLを使用したSpacesからポートレット・プロデューサへの接続の保護」

- 第33.6項「SpacesからLDAPアイデンティティ・ストアへの接続の保護」

- 第33.7項「SSLを使用したSpacesからContent Serverへの接続の保護」

- 第33.8項「SSLを使用したSpacesからIMAPおよびSMTPへの接続の保護」

- 第33.9項「SSLを使用したFrameworkアプリケーションからIMAPおよびSMTPへの接続の保護」

- 第33.10項「SSLを使用したOracle SESへの接続の保護」

- 第33.11項「SSLを使用したSpacesからMicrosoft Live Communication ServerおよびOffice Communication Serverへの接続の保護」

- 第33.12項「SSLを使用したSpacesから外部BPELサーバーへの接続の保護」

注意:

次のサービスやアプリケーションでは、メッセージ保護付きのWS-Securityを使用できるため、SSLのためのハード要件はありません。

- BPELサーバー: ワークリスト・サービス

- WSRPプロデューサ

- Microsoft Live Communication Server (LCS): IMPサービス

- Oracle WebCenter Portalのディスカッション・サーバー: ディスカッションおよびお知らせ

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

33.1 SSLを使用したブラウザからSpacesへの接続の保護

SSLを使用したブラウザからSpacesへの接続の保護は、次の手順で構成されます。

- 第33.1.1項「カスタム・キーストアの作成」

- 第33.1.2項「カスタムIDキーストアおよびJava信頼キーストアの構成」

- 第33.1.3項「SSL接続の構成」

33.1.1 カスタム・キーストアの作成

最初の手順では、Spacesにカスタム・キーストアを生成します。

カスタム・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/bin/に移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "dname" -alias alias -keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- dnameは、使用するDN(識別名)です(例: cn=customidentity,dc=example,dc=com)。

- aliasは、使用する別名です(例: webcenter_wls)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストア名です(例: webcenter_wls.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 360)。

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートして、Spacesクライアントが各自の信頼ストアに証明書をインポートできるようにします。

keytool -exportcert -v -alias alias -keystore keystore
-storepass keystore_password -rfc -file certificate_file

各要素の意味は次のとおりです。

- aliasは、Spacesの別名です(例: webcenter_wls)。

- keystoreは、キーストア名です(例: webcenter_wls.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- certificate_fileは、キーのエクスポート先の証明書のファイル名です(例: webcenter_wls.cer)。

4. 使用する信頼ストアを決定します。
自己署名証明書を使用しているため、それをサーバーの信頼ストア内の信頼できる証明書として更新する必要があります。これを実行するには、サーバーに移動して信頼ストアを決定する必要があります。

1. WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。

3. サーバーのリストで、WC_Spacesをクリックします。

4. 「構成」タブ→「キーストア」サブタブを開きます。
キーストア設定ペインが表示されます(図33-1を参照)。

図33-1 キーストア設定ペイン

「図33-1 キーストア設定ペイン」の説明

5. 「Java標準信頼キーストア」フィールド内のサーバーの場所を書き留めます(図33-1を参照)。
cacertsファイルは読取り専用である場合があります。その場合は、書込み可能になるようにその権限を変更する必要があります。

5. この信頼ストアに、前述の手順で生成された自己署名証明書をインポートします。

keytool -importcert -trustcacerts -alias alias -file certificate_file
-keystore cacerts -storepass changeit

各要素の意味は次のとおりです。

- aliasは、Spacesの別名です(例: webcenter_wls)。

- certificate_fileは、キーのエクスポート先の証明書のファイル名です(例: webcenter_wls.cer)。

自己署名証明書を信頼するかどうかを尋ねられたら、yesと答えます。

33.1.2 カスタムIDキーストアおよびJava信頼キーストアの構成

次の手順では、Spacesサーバーに、カスタムIDキーストアとJava信頼キーストアを構成します。

IDキーストアおよび信頼キーストアを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます(図33-2を参照)。

図33-2 「サーバーのサマリー」ペイン

「図33-2 「サーバーのサマリー」ペイン」の説明

3. IDキーストアおよび信頼キーストアを構成するSpacesサーバー(WC_Spaces)をクリックします。
対象のSpacesサーバーの「設定」ペインが表示されます(図33-3を参照)。

図33-3 Spacesサーバーの「設定」ペイン

「図33-3 Spacesサーバーの「設定」ペイン」の説明

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストア」ペインが表示されます(図33-4を参照)。

図33-4 「キーストア」ペイン

「図33-4 「キーストア」ペイン」の説明

5. 「キーストア」として、Custom Identity and Java Standard Trustを選択し、「保存」をクリックします。

6. 「アイデンティティ」の下で、第33.1.1項「カスタム・キーストアの作成」で作成したカスタムIDキーストアのパスとファイル名を入力します。

7. 「カスタムIDキーストアのタイプ」として、JKSと入力します。

8. カスタムIDキーストアのパスワードを入力し、確認のためにもう一度入力します。

9. 「信頼」の下で、Java標準信頼キーストアのパスワード(通常はchangeitに設定)を入力し、確認のためにもう一度入力します。

10. 「保存」をクリックして、エントリを保存します。

11. 「SSL」タブを開きます。

12. 「秘密鍵の別名」に値を入力します(例: webcenter_wls)。

13. 「秘密鍵のパスフレーズ」に値を入力します(例: welcome1)。

14. 「保存」をクリックして、エントリを保存します。

33.1.3 SSL接続の構成

SSL接続を構成する手順:

1. Spacesサーバーの設定ペインで、「構成」タブ→「全般」サブタブを開きます。
全般構成ペインが表示されます(図33-5を参照)。

図33-5 全般構成ペイン

「図33-5 全般構成ペイン」の説明

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。
SSLの詳細オプションが表示されます(図33-6を参照)。

図33-6 SSL構成の詳細設定

「図33-6 SSL構成の詳細設定」の説明

5. 「相互クライアント証明書の動作」オプションが、「クライアント証明書をリクエストしない」に設定されていることを確認し、「保存」をクリックします。

6. 「制御」タブを開きます。
制御設定ペインが表示されます(図33-7を参照)。

図33-7 制御設定ペイン

「図33-7 制御設定ペイン」の説明

7. 「SSLの再起動」をクリックします。

8. WebLogic Serverを再起動し、SSL Spaces URLを開きます。
開発環境またはテスト環境の場合のみ(つまり、本番環境ではない場合)、証明書内のホスト名が実際のホスト名に一致しないときは、サーバーを次のコマンドで起動する必要があります。

-Dweblogic.security.SSL.ignoreHostnameVerification=true

9. セッションの証明書を受け入れ、ログインします。

33.2 SSLを使用したブラウザからFrameworkアプリケーションへの接続の保護

ブラウザからFrameworkアプリケーションへの接続の保護では、ブラウザからSpacesへの接続の保護と同じ構成手順を使用します。唯一異なる点は、構成が、WC_Spacesサーバーではなく、Frameworkアプリケーションのデプロイをホストしている管理対象サーバーに対して実行されることです。詳細は、第33.1項「SSLを使用したブラウザからSpacesへの接続の保護」を参照してください。

33.3 SSLを使用したOracle HTTP ServerからSpacesへの接続の保護

Oracle HTTP Server (OHS)とSpacesとの間の接続の保護については、次の各項で説明しています。

- 第33.3.1項「IDキーストアおよび信頼キーストアの構成」

- 第33.3.2項「SSL接続の構成」

- 第33.3.3項「Oracle HTTP Serverのインストール」

- 第33.3.4項「SpacesポートからHTTP Serverへのワイヤリング」

- 第33.3.5項「SSL証明書の構成」

33.3.1 IDキーストアおよび信頼キーストアの構成

IDキーストアおよび信頼キーストアを構成する手順は、第33.1項「SSLを使用したブラウザからSpacesへの接続の保護」を参照してください。

33.3.2 SSL接続の構成

SSL接続を構成する手順は次のとおりです。

1. Spacesサーバーの設定ペインで、「構成」タブ→「全般」サブタブを開きます。
全般構成ペインが表示されます(図33-8を参照)。

図33-8 全般構成ペイン

「図33-8 全般構成ペイン」の説明

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「構成」タブで、「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。
SSLの詳細オプションが表示されます(図33-9を参照)。

図33-9 SSL構成の詳細設定

「図33-9 SSL構成の詳細設定」の説明

5. 「相互クライアント証明書の動作」オプションを「クライアント証明書をリクエストしない」に設定し、「保存」をクリックします。

6. 「設定」ペインの「制御」タブを開き、「起動と停止」サブタブを選択します。

7. 「SSLの再起動」をクリックします。

8. SSL Spaces URLを開きます。

9. セッションの証明書を受け入れ、ログインします。

10. WSL管理コンソールで、「チェンジ・センター」ペインの「変更と再起動の表示」をクリックして、影響を受けたサーバーまたはコンポーネントをすべて再起動します。

33.3.3 Oracle HTTP Serverのインストール

Oracle HTTP Serverをインストールする手順は次のとおりです。

1. Web層をインストールします。

- Webキャッシュは選択しないでください。HTTP Serverのみを選択します。

- インストール時にWebLogicサーバーを関連付けるチェック・ボックスを選択解除します。

2. WT_ORACLE_HOME/instances/<your_instance>/binディレクトリにナビゲートし、次のコマンドを使用してOHSを起動します。

./opmnctl startall

3. 次のコマンドを使用して、OHSのステータスを確認します。

./opmnctl status -l

33.3.4 SpacesポートからHTTP Serverへのワイヤリング

SpacesポートからHTTP Serverにワイヤリングする手順は次のとおりです。

1. ファイルWT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/mod_wl_ohs.confを開きます。

2. 次のエントリをmod_wl_ohs.confに追加して、SpacesがOHSと連動するようにします。

<IfModule mod_weblogic.c>
WebLogicHost host_id
WebLogicPort port
Debug OFF
WLLogFile /tmp/ohs.log
MatchExpression *.jsp
</IfModule>

<Location />
SetHandler weblogic-handler
</Location>

host_idおよびportをSpacesサーバーIDおよびポート番号に置換します。

3. ファイルWT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/ssl.confを開きます。

4. 次のエントリをssl.confに追加して、SpacesがOHS SSLポートで実行されるようにします。

<Location />
WebLogicHost host_id
WebLogicPort port
SetHandler weblogic-handler
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /webcenterhelp>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /rss>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

host_idおよびportをWebCenter Portal SSLサーバーIDおよびポート番号(通常は8788)に置換し、SSL_walletをWebLogic SSLウォレット(たとえば、WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/keystores/default)に置換します。

注意:

SSLは、Location/ディレクトリ・セクション内ではなく、サーバー・レベルで構成する必要があります。このため、たとえば、次のように構成するのではなく、

<Location /mylocation>
WLSSLWallet <walletfile>
SecureProxy ON
</Location>

次のように構成します。

SecureProxy ON
WlSSLWallet <walletfile>

つまり、サーバー・レベル(Location/ディレクトリ・セクション外)での構成です。

5. WT_ORACLE_HOME/instances/<your_instance>/binに移動し、次のコマンドを使用してOHSを起動し、そのステータスを確認します。

./opmnctl stopall

./opmnctl startall
./opmnctl status -l

33.3.5 SSL証明書の構成

SSL証明書を構成する手順は次のとおりです。

1. WebCenter Portalの証明書を信頼するようにOHSを構成するには、WC_Spaces証明書をOHS信頼ストアにインポートする必要があります。WC_SpacesIDキーストアからこの証明書をエクスポートします。

keytool -exportcert -v -alias webcenter_wls -keystore webcenter_wls.jks
-storepass <password> -rfc -file webcenter_wls.cer

2. orapkiを使用して、OHSサイドのウォレットに証明書をインポートします。

orapki wallet add -wallet . -trusted_cert -cert webcenter_wls.cer -auto_login_only

3. OHS証明書を信頼するようにWebCenter Portalを構成するには、OHSウォレットからユーザー証明書をエクスポートして、それをWebLogic信頼ストアに信頼できる証明書としてインポートします。

orapki wallet export -wallet . -cert cert.txt  -dn 'CN=\"Self-signed Certificate for ohs1 \",OU=EXAMPLEORGUNIT,O=EXAMPLEORG,L=EXAMPLELOCATION,ST=CA,C=US'

4. 前述の証明書をWC_Spaces管理対象サーバーの信頼ストアにインポートします。この信頼ストアは、/scratch/wcwlsinstall/0408/wlshome/jrockit_160_05_R27.6.2-20/jre/lib/security/cacertsにあります。

keytool -file cert.txt -importcert -trustcacerts -alias ohs_cert
-keystore cacerts -storepass changeit

5. OHSおよびWC_Spacesサーバーを再起動します。
これで、SSL OHSおよび非SSL OHSにアクセスできるようになりました。

33.4 SSLを使用したブラウザからディスカッション・サービスへの接続の保護

SSLを使用したブラウザからディスカッション・サービスへの接続の保護については、次の各項で説明しています。

- 第33.4.1項「カスタム・キーストアの作成」

- 第33.4.2項「IDキーストアおよび信頼キーストアの構成」

- 第33.4.3項「SSL接続の構成」

33.4.1 カスタム・キーストアの作成

次に示しているように、最初の手順ではカスタム・キーストアを生成します。

1. JDK_HOME/bin/に移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "dname" -alias owc_discussions
-keypass key_password -keystore owc_discussions.jks -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- dnameは、使用するDN(識別名)です(例: cn=customidentity,dc=owc_discussions,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 360)。

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias owc_discussions -keystore owc_discussions.jks
-storepass keystore_password -rfc -file owc_discussions.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

4. 使用する信頼ストアを決定します。
自己署名証明書を使用しているため、それをサーバーの信頼ストア内の信頼できる証明書として更新する必要があります。これを実行するには、サーバーに移動して信頼ストアを決定する必要があります。

1. WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。

3. サーバーのリストで、WC_Collaborationをクリックします。

4. 「構成」タブ→「キーストア」サブタブを開きます。
キーストア設定ペインが表示されます(図33-10を参照)。

図33-10 WC_Collaborationの「キーストア」サブタブ

「図33-10 WC_Collaborationの「キーストア」サブタブ」の説明

5. 「Java標準信頼キーストア」フィールド内のサーバーの場所を書き留めます(図33-1を参照)。
cacertsファイルは読取り専用である場合があります。その場合は、書込み可能になるようにその権限を変更する必要があります。

5. この信頼ストアに、前述の手順で生成された自己署名証明書をインポートします。

keytool -importcert -trustcacerts -alias owc_discussions
-file owc_discussions.cer -keystore cacerts -storepass changeit

自己署名証明書を信頼するかを尋ねられたら、yesと答えます。

33.4.2 IDキーストアおよび信頼キーストアの構成

IDキーストアおよび信頼キーストアを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます(図33-11を参照)。

図33-11 「サーバーのサマリー」ペイン

「図33-11 「サーバーのサマリー」ペイン」の説明

3. IDキーストアおよび信頼キーストアを構成するコラボレーション・サーバー(WC_Collaboration)をクリックします。
このサービス・サーバーの「設定」ペインが表示されます(図33-12を参照)。

図33-12 サービス・サーバーの「設定」ペイン

「図33-12 サービス・サーバーの「設定」ペイン」の説明

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストア」ペインが表示されます(図33-13を参照)。

図33-13 「キーストア」ペイン

「図33-13 「キーストア」ペイン」の説明

5. 「キーストア」として、「カスタム・アイデンティティとJava標準信頼」を選択します。

6. 「アイデンティティ」の下で、キーストアをowc_discussions.jksとして指定します。

7. キーストア・タイプをJKSに設定します。

8. キーストアのパスフレーズ(例: welcome1)を入力し、確認のためにもう一度入力します。

9. 「信頼」の下で、「Java標準信頼キーストアのパスフレーズ」をchangeit(これは固定値)に設定し、「保存」をクリックします。

10. WLS管理コンソールで、「サーバー」→「WC_Collaboration」に移動し、「構成」タブを開き、「全般」サブタブを開きます。

11. 「SSLポートの有効化」を選択して、目的のポートを指定し、設定を保存します。

12. WLS管理コンソールで、「サーバー」→「WC_Collaboration」に移動し、「構成」タブを開き、「SSL」サブタブを開きます。

13. 秘密鍵の別名をowc_discussionsに指定し、パスワードをwelcome1に設定します。

14. 「制御」タブを開きます。
制御設定ペインが表示されます(図33-14を参照)。

図33-14 制御設定ペイン

「図33-14 制御設定ペイン」の説明

15. 「SSLの再起動」をクリックします。

33.4.3 SSL接続の構成

SSL接続を構成する手順:

1. サービス・サーバーの「設定」ペインで、「構成」タブを開き、「全般」サブタブを開きます。
全般構成ペインが表示されます(図33-15を参照)。

図33-15 全般構成ペイン

「図33-15 全般構成ペイン」の説明

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「構成」タブで、「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。
SSLの詳細オプションが表示されます(図33-16を参照)。

図33-16 SSL構成の詳細設定

「図33-16 SSL構成の詳細設定」の説明

5. 「相互クライアント証明書の動作」オプションを「クライアント証明書をリクエストしない」に設定し、「保存」をクリックします。

6. WC_Collaborationサーバーを再起動して、SSLディスカッションURLをhttps://host:port/owc_discussionsで開きます。

7. セッションの証明書を受け入れ、ログインします。

33.5 SSLを使用したSpacesからポートレット・プロデューサへの接続の保護

SSLを使用したWSRPおよびPDK-Javaポートレット・プロデューサへの接続の保護については、次の各項で説明しています。

- 第33.5.1項「IDキーストアおよび信頼キーストアの構成」

- 第33.5.2項「SSL接続の構成」

- 第33.5.3項「SSL対応WSRPプロデューサの登録およびポートレットの実行」

- 第33.5.4項「SSL対応PDK-Javaプロデューサの登録およびポートレットの実行」

33.5.1 IDキーストアおよび信頼キーストアの構成

IDキーストアおよび信頼キーストアを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます(図33-17を参照)。

図33-17 「サーバーのサマリー」ペイン

「図33-17 「サーバーのサマリー」ペイン」の説明

3. IDキーストアおよび信頼キーストアを構成するポートレット・サーバー(たとえば、WC_Portlet)をクリックします。
このポートレット・サーバーの「設定」ペインが表示されます(図33-18を参照)。

図33-18 ポートレット・サーバーの「設定」ペイン

「図33-18 ポートレット・サーバーの「設定」ペイン」の説明

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストア」ペインが表示されます(図33-19を参照)。

図33-19 「キーストア」ペイン

「図33-19 「キーストア」ペイン」の説明

5. 「キーストア」として、Custom Identity and Java Standard Trustを選択し、「保存」をクリックします。

6. 「制御」タブを開きます。
制御設定ペインが表示されます(図33-20を参照)。

図33-20 制御設定ペイン

「図33-20 制御設定ペイン」の説明

7. 「SSLの再起動」をクリックします。

33.5.2 SSL接続の構成

SSL接続を構成する手順:

1. 「ドメイン構造」ペインで「環境」を開き、「サーバー」を選択します。

2. SSLを構成するポートレット・サーバー(たとえば、WC_Utilities)をクリックします。

3. 「構成」を選択します。

4. 「SSLリスニング・ポートの有効化」を選択します。

5. リスニング・ポート番号を入力します。

6. 「構成」→「SSL」を選択し、ページの一番下にある「拡張オプション」を開きます。

7. 「相互クライアント証明書の動作」属性を選択し、Client Certs Not Requestedオプションを選択します。

8. 「保存」をクリックします。

9. WebLogic Serverを再起動し、SSL URLを開きます。

10. セッションの証明書を受け入れ、ログインします。

33.5.3 SSL対応WSRPプロデューサの登録およびポートレットの実行

SSL対応WSRPプロデューサを登録し、ポートレットを実行する手順は次のとおりです。

1. カスタム・アイデンティティおよびJava標準信頼ストアを使用するようにSpaces管理対象サーバーを構成します。これは、JDK_HOME/jre/lib/security/cacerts内の証明書も使用します。

2. HTTPSプロデューサURLの証明書をダウンロードし、.PEM形式で保存します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンスのder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

3. 次のkeytoolコマンドを使用して、JDK_HOME/jre/lib/security内のcacertsファイルに証明書をインポートします。

keytool -importcert -alias portlet_cert -file HOME/portlet_pem -keystore ./cacerts -storepass password

各要素の意味は次のとおりです。

- portlet_certは、ポートレット証明書の別名です。

- portlet_pemは、ポートレット証明書ファイルです(例: portlet_cert.pem)。

- passwordは、キーストアのパスワードです。

4. WC_Spacesを再起動します。

5. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

6. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

各要素の意味は次のとおりです。

- user_nameは、WC_Spacesサーバーにアクセスするユーザー・アカウントの名前です(例: weblogic)。

- passwordは、WC_Spacesサーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

7. registerWSRPProducer WLSTコマンドを実行して、プロデューサを登録します。

registerWSRPProducer('webcenter', 'sslwsrpprod','producer_wsdl)

各要素の意味は次のとおりです。

- sslwsrpprodは、SSL対応WSRPプロデューサの名前です。

- producer_wsdlは、SSL対応WSRPプロデューサのWSDL URLです。

次に例を示します。

registerWSRPProducer('webcenter', 'sslwsrpprod','https://example.oracle.com:7004/richtextportlet/portlets/wsrp2?WSDL')

8. HTTPまたはHTTPSのWebCenter Portal URLにナビゲートします。

9. ページを作成し、ポートレット・リンクに移動します。

10. 登録済のWSRPプロデューサに移動します。

11. ポートレットをページに追加します。

12. ページの表示モードに変更して、WSRPポートレットが適切にレンダリングすることを確認します。

33.5.4 SSL対応PDK-Javaプロデューサの登録およびポートレットの実行

SSL対応PDK-Javaプロデューサを登録し、ポートレットを実行する手順は次のとおりです。

1. デモのアイデンティティおよび信頼ストアを使用するようにSpaces管理対象サーバーを構成します。これは、JDK_HOME/jre/lib/security/cacerts内の証明書も使用します。

2. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

3. 「ドメイン構造」ペインで「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます(図33-21を参照)。

図33-21 「サーバーのサマリー」ペイン

「図33-21 「サーバーのサマリー」ペイン」の説明

4. サーバーのリストで、WC_Spacesをクリックします。
「設定」ペインが表示されます(図33-22を参照)。

図33-22 「設定」ペイン(WC_Spacesサーバー)

「図33-22 「設定」ペイン(WC_Spacesサーバー)」の説明

5. 「構成」タブを開き、「キーストア」タブを選択します。

6. 「デモIDとデモ信頼」の値がjksまたは空白のままになっていることを確認します。

7. 「保存」をクリックします。

8. HTTPSプロデューサURLの証明書をダウンロードし、.PEM形式で保存します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンスのder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

9. 次のkeytoolコマンドを使用して、JDK_HOME/jre/lib/security内のcacertsファイルに証明書をインポートします。

keytool -importcert HOME/portlet_cert.pem -keystore ./cacerts -storepass changeit

10. WC_Spacesを再起動します。

11. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

12. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

各要素の意味は次のとおりです。

- user_nameは、WC_Spacesサーバーにアクセスするユーザー・アカウントの名前です(例: weblogic)。

- passwordは、WC_Spacesサーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

13. registerPDKJavaProducerコマンドを実行します。

registerPDKJavaProducer('webcenter', 'ssljpdkprod', 'producer_wsdl')

各要素の意味は次のとおりです。

- ssljpdkprodは、SSL対応PDK-Javaプロデューサの名前です。

- producer_wsdlは、SSL対応PDK-JavaプロデューサのWSDL URLです。

これによって、Webプロデューサに対して一方向SSLが有効になります。つまり、サーバー・サイド(Webプロデューサ)でのみ証明書が使用されるようになります。Webプロデューサ・コードでは、クライアント認証に共有鍵機能(後述します)も使用されます。

14. HTTPまたはHTTPSのWebCenter Portal URLに移動します。

15. ページを作成し、ポートレット・リンクに移動します。

16. 登録済のPDK-Javaプロデューサに移動します。

17. ポートレットをページに追加します。

18. ページの表示モードに変更して、PDK-Javaポートレットが適切にレンダリングすることを確認します。

33.6 SpacesからLDAPアイデンティティ・ストアへの接続の保護

SSL用にLDAPサーバー・ポートを構成するには、LDAPサーバーの適切な管理ドキュメントを参照してください。Oracle Internet Directory (OID)ではデフォルトで、SSLポートがインストールされます。WebCenter PortalからLDAP通信にこのポートを使用するには、適切な認証者により認証できるようにアイデンティティ・ストアを構成する必要があります。アイデンティティ・ストアに対してこの作業を行うための手順は、第29章「アイデンティティ・ストアの構成」を参照してください。

注意:

プロバイダ固有の情報を入力する場合は、SSLポートを指定して、「SSLの有効化」チェック・ボックスを選択してください。

Oracle WebLogicサーバーにとってCAが不明である場合は、次の各項で説明している2つの追加手順を完了します。

- 第33.6.1項「OID認証局(CA)のエクスポート」

- 第33.6.2項「WebLogicサーバーの設定」

33.6.1 OID認証局(CA)のエクスポート

Oracle WebLogicサーバーにとってCAが不明である場合(ユーザーがコマンドからキーストアのパスワードの入力を求められた場合)、orapkiを使用して証明書を作成する必要があります。次の例は、このコマンドを使用して、証明書serverTrust.certを作成する方法を示しています。

orapki wallet export -wallet CA -dn "CN=myCA" -cert oid_server_trust.cert

33.6.2 WebLogicサーバーの設定

Oracle WebLogicサーバーにとってCAが不明である場合、ユーティリティkeytoolを使用して、Oracle Internet DirectoryのCAをWebLogic信頼ストアにインポートする必要があります。次の例は、keytoolを使用して、ファイルoid_server_trust.certをサーバーの信頼ストアcacertsにインポートする方法を示しています。

keytool -importcert -v -trustcacerts -alias oid_server_trust -file
oid_server_trust.cer -keystore cacerts -storepass changeit

33.7 SSLを使用したSpacesからContent Serverへの接続の保護

リポジトリへの接続を作成するContent ServerおよびSpacesアプリケーションが、同じシステム上または信頼できる同じプライベート・ネットワーク上にない場合、アイデンティティ伝播はセキュアではありません。アイデンティティ伝播のセキュリティを確保するには、Content ServerにSSLを構成する必要もあります。

SSLを使用したContent Serverの保護には、次のタスクが含まれます。

- 第33.7.1項「クライアント・サイドでのキーストアおよびキーの構成」

- 第33.7.2項「サーバー・サイドでのキーストアおよびキーの構成」

- 第33.7.3項「信頼できるクライアントのシグネチャの検証」

- 第33.7.4項「アイデンティティ伝搬の保護」

Content Integration Suite管理ガイド(http://download.oracle.com/docs/cd/E10316_01/ouc.htmで入手可能)のSSLのプロパティに関する項も参照してください。自己署名証明書を使用する場合は、これらの手順を実行してください。

本番環境では、実際の証明書を使用することをお薦めします。実際の証明書を使用するときにキーストアを構成する方法の詳細は、Security Providersコンポーネント管理ガイド(http://download.oracle.com/docs/cd/E10316_01/ouc.htmで入手可能)の「Security Providersの使用」を参照してください。

33.7.1 クライアント・サイドでのキーストアおよびキーの構成

WebCenter Portalアプリケーション(クライアント)サイドでキーストアを構成する手順は次のとおりです。

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 次のkeytoolコマンドを実行して、クライアント・キーストアを生成します。

keytool -genkey -keyalg RSA -validity 5000 -alias Client private key alias -keystore client-keystore.jks
-dname "cn=client" -keypass Private key password -storepass KeyStore password

3. キーが正常に作成されたことを確認するために、オプションで次のkeytoolコマンドを実行できます。

keytool -list -keystore client-keystore.jks -storepass KeyStore password

4. キーを使用するには、次のkeytoolコマンドを実行してキーに署名します。

keytool -selfcert -validity 5000 -alias Client private key alias -keystore client-keystore.jks
-keypass Private key password -storepass KeyStore password

5. 次のkeytoolコマンドを実行して、クライアントの公開鍵をエクスポートします。

keytool -export -alias Client private key alias -keystore client-keystore.jks
-file client.pubkey -keypass Private key password -storepass KeyStore password

33.7.2 サーバー・サイドでのキーストアおよびキーの構成

Content Serverサイドでキーストアを構成する手順は次のとおりです。

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 次のkeytoolコマンドを実行して、サーバー・キーストアを生成します。

keytool -genkey -keyalg RSA -validity 5000 -alias Server public key alias
-keystore server-keystore.jks -dname "cn=server" -keypass Private server key password -storepass KeyStore password

3. キーが正常に作成されたことを確認するには、次のkeytoolコマンドを実行します。

keytool -list -keystore server-keystore.jks -keypass Server private key password -storepass KeyStore password

4. キーを使用するには、次のkeytoolコマンドを実行してキーに署名します。

keytool -selfcert -validity 5000 -alias Server public key alias -keystore server-keystore.jks
-keypass Private server key password -storepass KeyStore password

5. 次のkeytoolコマンドを実行して、サーバーの公開鍵をサーバー・キーストアにエクスポートします。

keytool -export -alias Server public key alias -keystore server-keystore.jks
-file server.pubkey -keypass Server private key password -storepass KeyStore password

33.7.3 信頼できるクライアントのシグネチャの検証

信頼できるクライアントのシグネチャを検証するには、クライアントの公開鍵をサーバー・キーストアにインポートします。

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 信頼できるクライアントのシグネチャを検証するには、次のkeytoolコマンドを実行して、クライアントの公開鍵をサーバー・キーストアにインポートします。

keytool -import -alias Client public key alias -file client.pubkey -keystore
server-keystore.jks -keypass Private server key password -storepass KeyStore password

3. 次のkeytoolコマンドを実行して、サーバーの公開鍵をクライアント・キーストアにインポートします。

keytool -import -alias Server public key alias -file server.pubkey -keystore
client-keystore.jks -keypass Private key password -storepass KeyStore password

キーを自己認証するかどうかを尋ねられたら、Yesと入力します。例33-1に、この手順が正常に完了すると生成されるサンプル出力を示します。

例33-1 keytoolにより生成されるサンプル出力

[user@server]$ keytool -import -alias client -file client.pubkey
-keystore server-keystore.jks -keypass Server private key password -storepass Keystore password
Owner: CN=client
Issuer: CN=client
Serial number: serial number, for example, 123a19cb
Valid from: Date, Year, and Time until: Date, Year, and Time
Certificate fingerprints:
...
Trust this certificate? [no]:  yes
Certificate was added to keystore.

33.7.4 アイデンティティ伝搬の保護

アイデンティティ伝播を保護するには、Content ServerにSSLを構成する必要があります。

1. 管理者としてContent Serverにログオンします。

2. 「管理」から、「プロバイダ」を選択します。

3. 「新規プロバイダの作成」ページで、sslincomingの「追加」をクリックします。

4. 「受信プロバイダの追加」ページの「プロバイダ名」に、プロバイダの名前(たとえば、sslincomingprovider)を入力します。
新規プロバイダが設定されたら、そのプロバイダ名を持つディレクトリが、CONTENT_SERVER_HOME/data/providersディレクトリのサブディレクトリとして作成されます。

5. 「プロバイダの説明」に、プロバイダの短い説明(たとえば、SSL Incoming Provider for securing the Content Server)を入力します。

6. 「プロバイダ・クラス」に、sslincomingプロバイダのクラス(たとえば、idc.provider.ssl.SSLSocketIncomingProvider)を入力します。

注意:

新規のSSLキープアライブ受信ソケット・プロバイダまたは新規のSSL受信ソケット・プロバイダを追加できます。キープアライブ・ソケットを使用すると、セッションのパフォーマンスが向上するため、ほとんどの実装で推奨されます。

7. 「接続クラス」に、接続のクラス(たとえば、idc.provider.KeepaliveSocketIncomingConnection)を入力します。

8. 「サーバー・スレッド・クラス」に、サーバー・スレッドのクラス(たとえば、idc.server.KeepaliveIdcServerThread)を入力します。

9. 「サーバー・ポート」に、オープン・サーバー・ポート(たとえば、5555)を入力します。

10. クライアントの認証が必要チェック・ボックスを選択します。

11. 「キーストア・パスワード」に、キーストアにアクセスするためのパスワードを入力します。

12. 「別名」に、キーストアの別名を入力します。

13. 「別名パスワード」に、別名のパスワードを入力します。

14. 「トラストストア・パスワード」に、トラスト・ストアのパスワードを入力します。

15. 「追加」をクリックします。
新規の受信プロバイダが追加されました。

16. 手順4で作成した新規のプロバイダ・ディレクトリに移動します。

17. 信頼ストアおよびキーストアを指定するには、sslconfig.hdaという名前のファイルを作成します。

18. サーバー・キーストアをサーバーにコピーします。

19. sslconfig.hdaファイルを構成します。例33-2は、信頼ストアおよびキーストアの情報が指定された.hdaファイルの内容を示しています。

例33-2 サンプルのsslconfig.hdaファイル

@Properties LocalData
TruststoreFile=/tmp/ssl/server_keystore
KeystoreFile=/tmp/ssl/server_keystore
@end

33.8 SSLを使用したSpacesからIMAPおよびSMTPへの接続の保護

メール・サーバーへの接続を再構成する前に、まず、証明書を信頼ストアにインポートする必要があります。次の手順に従って、信頼ストアに証明書を格納し、信頼ストアを使用するようにSpacesを構成します。

SSLを使用して、SpacesからIMAPおよびSMTPへの接続を保護する手順は次のとおりです。

1. ブラウザを開き、次のコマンドを使用してIMAPサーバーに接続します。

https://imapserver:ssl_port

次に例を示します。

https:mailserver.example:993

2. ページにカーソルを置いて右クリックし、「プロパティ」を選択します。

3. 「証明書」をクリックします。

4. ポップアップ・ウィンドウで、詳細タブをクリックし、「ファイルにコピー...」をクリックします。
必ずDER encoded binary(X.509)形式を使用してファイルにコピーします。

5. .DER形式の証明書を.PEM形式に変換します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンスのder2pemに関する項を参照してください。WebLogicは、.PEM以外の形式を認識しないことに注意してください。

6. 次のコマンドを使用して、JDK_HOME内のcacertsに証明書をインポートします。

keytool -import -alias imap_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

7. 第17.4項「メール・サーバーの登録」で説明しているとおりに、メール・サーバーへの接続を登録します。

8. Spacesを再起動します。

9. Spacesにログインし、メール資格証明を提供します。

33.9 SSLを使用したFrameworkアプリケーションからIMAPおよびSMTPへの接続の保護

SSLを使用して、FrameworkアプリケーションからIMAPおよびSMTPへの接続を保護する手順は次のとおりです。

1. 第33.8項「SSLを使用したSpacesからIMAPおよびSMTPへの接続の保護」の手順7までを実行します。

2. 次のプロパティを信頼ストアに追加します。

-Djavax.net.ssl.trustStore=C:\jive\mailtool\jssecacerts
-Djavax.net.ssl.trustStorePassword=changeit

次に例を示します。

set JAVA_PROPERTIES=-Dplatform.home=%WL_HOME% -Dwls.home=%WLS_HOME%
-Dweblogic.home=%WLS_HOME%
-Djavax.net.ssl.trustStore=C:\jive\mailtool\jssecacerts
-Djavax.net.ssl.trustStorePassword=changeit

3. Frameworkアプリケーションを再起動します。

4. アプリケーションにログインし、メール資格証明を提供します。

33.10 SSLを使用したOracle SESへの接続の保護

SESへの接続を登録する前に、まず、証明書を信頼ストアにインポートする必要があります。次の手順に従って、信頼ストアに証明書を格納し、Oracle Secure Enterprise Search (SES)への接続を登録します。

HTTPS URLの証明書をダウンロードして保存する手順は次のとおりです。

1. ブラウザを使用して、Oracle Secure Enterprise Searchが検索リクエストを有効化するために公開するWebサービスURLにナビゲートします。

http://host:port/search/query/OracleSearch

次に例を示します。

https://example.com:7777/search/query/OracleSearch

2. ページにカーソルを置いて、マウスで右クリックし、「プロパティ」を選択します。

3. 「証明書」をクリックします。

4. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。
DER encoded binary(X.509)形式を使用して、証明書をファイルにコピーします。

5. .DER形式の証明書を.PEM形式に変換します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンスのder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

6. 次のコマンドを使用して、DemoTrustKeyStore.jksまたはJDK_HOME内のcacertsに証明書をインポートします。

keytool -import -alias ses_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

7. 第22.4.1「Oracle Secure Enterprise Search Serverの登録」で説明しているとおりに、SESへの接続を登録します。

8. SpacesまたはFrameworkアプリケーションを再起動します。

33.11 SSLを使用したSpacesからMicrosoft Live Communication ServerおよびOffice Communication Serverへの接続の保護

SSLを使用して、SpacesからMicrosoft Live Communication Server (LCS)またはOffice Communication Server 2007 (OCS)への接続を保護するには、次の手順に従って証明書を信頼ストアにインポートし、その信頼ストアを使用するようにSpacesを指定します。SSLを使用したSpacesからMicrosoft Live Communication ServerまたはOffice Communication Serverへの接続の保護は、WS-Securityを使用して機密保護で構成できるため、オプションとなっています。

LCSまたはOCSへの接続を登録する前に、まず、証明書を信頼ストアにインポートする必要があります。次の手順に従って、証明書を信頼ストアに格納します。

1. ブラウザを開き、通信サーバー(たとえば、https://example.com/RTC)に移動します。

2. ページにカーソルを置いて右クリックし、「プロパティ」を選択します。

3. 「証明書」をクリックします。

4. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンスのder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

5. 次のkeytoolコマンドを使用して、証明書をcacertsにインポートします。

keytool -import -alias lcs_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

6. インストール環境で通信サーバーが使用しているcacertsファイルを見つけ、通信サーバーが参照するこのcacertsファイルをこの証明書で更新します。

keytool -import -alias lcs_cer -file cert_file.cer -keystore cacerts -storepass changeit

7. 第16.3項「インスタント・メッセージおよびプレゼンス・サーバーの登録」で説明しているとおりに、通信サーバーへの接続を登録します。

8. Spacesサーバーを再起動します。

33.12 SSLを使用したSpacesから外部BPELサーバーへの接続の保護

この項では、BPELサーバーが外部SOAドメインにある場合に、SpacesからBPELサーバーへの接続を保護する方法を説明します。

注意:

SOAが外部ドメインにインストールされているときは、アイデンティティ・アサータおよびオーセンティケータをWebCenter Portalの場合とまったく同じように構成する必要があります。外部LDAPアイデンティティ・ストアにアイデンティティ・アサータおよびオーセンティケータを構成する手順の詳細は、第29.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照してください。

SSLを使用して、Spacesから外部BPELサーバーへの接続を保護する手順は次のとおりです。

1. WebCenter PortalからSOAドメインに公開証明書(webcenter_wls.cer)をコピーします。

2. JDK_HOME/bin/に移動し、コマンド・プロンプトを開きます。

3. 次のkeytoolコマンドを使用して、SOAドメインにカスタム・キーストアを生成し、そのキーストアに名前soa_server1.jksと別名soa_server1を付けます。

keytool -genkeypair -keyalg RSA -dname dname -alias soa_soa_server1 -keypass
key_pass -keystore soa_server1.jks -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- dnameは、使用するDN(識別名)です(例: cn=customidentity,dc=example,dc=com)。

- key_passは、新規公開鍵のパスワードです(例: welcome1)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 360)。

4. 次のコマンドを使用して、soa_wls.jksから証明書をエクスポートします。

keytool -exportcert -v -alias soa_server1 -keystore soa_server1.jks
-storepass keystore_password -rfc -file soa_server1.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

5. SOAドメインでWebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

6. ナビゲーション・ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます(図33-23を参照)。

図33-23 「サーバーのサマリー」ペイン

「図33-23 「サーバーのサマリー」ペイン」の説明

7. 「構成」タブで、サーバーのリストからsoa_server1をクリックします。
soa_server1の「設定」ページが表示されます(図33-24を参照)。

図33-24 soa_server1の「設定」ページ

「図33-24 soa_server1の「設定」ページ」の説明

8. 「キーストア」タブを開きます。
soa_server1のキーストアの設定が表示されます(図33-25を参照)。

図33-25 soa_server1のキーストアの設定

「図33-25 soa_server1のキーストアの設定」の説明

9. 「キーストア」として、Custom Identity and Java Standard Trustを選択します。

10. 前述の手順で作成したキーストア(soa_server1.jks)のパスとファイル名を指定します。

11. 「Java標準信頼キーストア」フィールドに指定したJava標準信頼(cacertsファイル)が含まれるディレクトリに移動して、SOAおよびWebCenter Portal公開証明書をこのファイルにインポートし、サーバーによってこれらの証明書が信頼されるようにします。

keytool -importcert -trustcacerts -alias webcenter_wls -file webcenter_wls.cer
-keystore cacerts -storepass keystore_password

keytool -importcert -trustcacerts -alias soa_server1 -file soa_server1.cer
-keystore cacerts -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

証明書を信頼するかを尋ねられたら、yesと答えます。

12. SOAドメインでWLS管理コンソールから「SSL」タブを開きます。
soa_server1のSSLの設定が表示されます(図33-26を参照)。

図33-26 soa_server1のSSLの設定

「図33-26 soa_server1のSSLの設定」の説明

13. 「秘密鍵の別名」としてsoa_server1を指定します。

14. 秘密鍵のパスワード(例: welcome1)を入力し、確認のためにもう一度入力して、「保存」をクリックします。

15. 「全般」タブを開きます。
soa_server1の全般設定が表示されます(図33-27を参照)。

図33-27 soa_server1の全般設定

「図33-27 soa_server1の全般設定」の説明

16. 「リスニング・ポートの有効化」が選択されていないことを確認します。

17. 「SSLリスニング・ポートの有効化」を選択し、「SSLリスニング・ポート」を指定して、「保存」をクリックします。

18. 「制御」タブ→「起動と停止」サブタブを開きます。
soa_server1の開始/停止の設定が表示されます(図33-28を参照)。

図33-28 soa_server1の開始/停止の設定

「図33-28 soa_server1の開始/停止の設定」の説明

19. サーバーのリストからsoa_server1を選択し、「SSLの再起動」をクリックします。

20. SOAドメインでsoa_server1管理対象サーバーを再起動します。

21. 次のkeytoolコマンドを使用して、WebCenter Portalドメインからsoa_server1.cer証明書を信頼できる証明書としてサーバーの信頼ストア(cacerts)にインポートします。

keytool -importcert -trustcacerts -alias soa_server1 -file soa_server1.cer
-keystore cacerts -storepass changeit

証明書を信頼するかを尋ねられたら、yesと答えます。

22. BPEL URLを定義するときに、soa_server1にhost:ssl_port設定を指定して、第23.4.2項「ワークリスト接続の登録」で説明しているとおりにWebCenter Portalドメインにワークリスト接続を追加します。

23. WC_Spaces管理対象サーバーを再起動します。

34 WS-Securityの構成

この章では、WebCenter Portalアプリケーション(SpacesアプリケーションおよびFrameworkアプリケーションを含む)および関連するサービスとコンポーネントに、使用するトポロジに基づいてWS-Securityを設定する方法を説明します。ここでは、次の構成を扱います。

- 単純トポロジ。WebCenter Portalアプリケーションとすべてのコンポーネントが同一ドメインを共有しています。

- 標準トポロジ。WebCenter Portalアプリケーションとコンポーネントが2つのドメインに分かれています。

- 複合トポロジ。WebCenter Portalアプリケーションとコンポーネントが複数のドメインに分かれています。

これら3つのトポロジにおける、WebCenter Portalアプリケーション(Spacesなど)、Oracle WebCenter Portalのディスカッション・サーバー、ワークリスト・サービスおよびWSRPプロデューサに対する構成について説明します。これらの構成およびSpaces APIを使用するアプリケーションの保護手順は、次の各項で説明しています。

- 第34.1項「単純トポロジの場合のWS-Securityの構成」

- 第34.2項「標準トポロジの場合のWS-Securityの構成」

- 第34.3項「複合トポロジの場合のWS-Securityの構成」

- 第34.4項「Spaces Client APIを使用するアプリケーションに対するWS-Securityを使用したSpacesの保護」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

34.1 単純トポロジの場合のWS-Securityの構成

この項では、WebCenter Portalアプリケーション、BPELサーバーおよびWSRPプロデューサが同一ドメインを共有するトポロジの場合にWS-Securityを構成する方法を説明します(図34-1)。

図34-1 単純構成の場合のWS-Security

「図34-1 単純構成の場合のWS-Security」の説明

単一ドメインの単純WebCenter Portalトポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- 第34.1.1項「単純トポロジの場合のWS-Securityの構成のロードマップ」

- 第34.1.2項「WebCenter Portalドメイン・キーストアの設定」

- 第34.1.3項「単純トポロジの場合のディスカッション・サーバーの構成」

- 第34.1.4項「単純トポロジの場合のコマンド・サマリー」

34.1.1 単純トポロジの場合のWS-Securityの構成のロードマップ

この項のフロー・チャート(図34-1)と表(表34-1)は、単一ドメインの単純WebCenter PortalトポロジでWS-Securityを構成するために必要な前提条件とタスクの概要を示しています。

図34-2 単純トポロジの場合のWS-Securityの構成

「図34-2 単純トポロジの場合のWS-Securityの構成」の説明

表34-1は、単純WebCenter Portalトポロジの場合にWS-Securityを構成するためのタスクとサブタスクを示しています。

表34-1 単純トポロジの場合のWS-Securityの構成

担当者

タスク

サブタスク

ノート

Administrator

1. WebCenter Portalドメイン・キーストアの設定

1.a WebCenter Portalドメイン・キーストアの作成

1.b キーストアの構成

2. ディスカッション・サーバーの構成

2.a ディスカッション・サービス・エンド・ポイントの保護

2.b ディスカッション・サーバーの接続設定の構成

34.1.2 WebCenter Portalドメイン・キーストアの設定

Javaキーストア(JKS)を使用して、WebCenter Portalアプリケーション、ディスカッション・サーバー、BPELサーバーおよびWSRPプロデューサのセキュリティ資格証明を取得および管理できます。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、ウォレットまたはキーストアにセキュアに格納されます。JKSの詳細は、Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイドを参照してください。

この項の内容は次のとおりです。

- 第34.1.2.1項「WebCenter Portalドメイン・キーストアの作成」

- 第34.1.2.2項「WLSTを使用したキーストアの構成」

- 第34.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.1.2.1 WebCenter Portalドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してキーストアおよびキーを作成する方法について説明します。JKSは、Sun Microsystemsにより定義された独自仕様のキーストア形式です。JKSでキーおよび証明書を作成して管理するには、Java JDK 6とともに配布されるkeytoolユーティリティを使用します。

WebCenter Portalドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias orakey
-keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です。これには適切な形式であるかぎり、任意の文字列を指定できます(例: cn=spaces,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストア名です(例: default-keystore.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-1 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias orakey
-keypass welcome1 -keystore default-keystore.jks -storepass welcome1 -validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias orakey -keystore keystore -storepass keystore_password -rfc -file orakey.cer

各要素の意味は次のとおりです。

- keystoreは、キーストア名です(例: default-keystore.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-2 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias orakey -keystore default-keystore.jks -storepass welcome1 -rfc -file orakey.cer

4. 証明書を別名webcenter_spaces_wsでインポートします(別名がorakeyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias webcenter_spaces_ws -file orakey.cer
-keystore default-keystore.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです。

例34-3 証明書のインポート

keytool -importcert -alias webcenter_spaces_ws -file orakey.cer -keystore default-keystore.jks -storepass welcome1

5. 第34.1.2.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表34-2は、キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表34-2 単純トポロジの場合のPortalドメイン・キーストアのコンテンツ

キーの別名

説明

orakey

Spacesからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM(ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

webcenter_spaces_ws

WebCenter Portalドメインで使用されるorakey秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter Portalドメイン内のBPEL Server1にあるワークフロー・アプリケーションから、WebCenter PortalドメインのWebサービスAPIへのアウトバウンドWebサービス・メッセージの暗号化に使用されます。

34.1.2.2 WLSTを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

資格証明ストアを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">
<description>Default JPS Keystore Service</description>

3. default-keystore.jksキーストア・ファイルが、<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされており、locationとして./default-keystore.jksが指定されていることを確認します。

<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">
<description>Default JPS Keystore Service</description>

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password=keystore_password, desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="orakey", password=private_key_password, desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="orakey", password=private_key_password, desc="Signing key")

各要素の意味は次のとおりです。

- keystore_passwordは、第34.1.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定したキーストア・パスワードです(例: welcome1)。

- private_key_passwordは、第34.1.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定した秘密鍵パスワードです(例: welcome1)。

例34-4 資格証明ストアの更新

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="orakey", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="orakey", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.1.2.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.1.2.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. default-keystore.jksキーストア・ファイルが、<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./default-keystore.jksを指定します。

2. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

3. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

4. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます(図34-3を参照)。

図34-3 「セキュリティ・プロバイダ構成」ページ

「図34-3 「セキュリティ・プロバイダ構成」ページ」の説明

5. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

6. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-4を参照)。

図34-4 「キーストアの構成」ページ

「図34-4 「キーストアの構成」ページ」の説明

7. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./default-keystore.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: orakey

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: orakey

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

8. 「OK」をクリックして、設定を保存します。

9. ドメインの管理サーバーを再起動します。

34.1.3 単純トポロジの場合のディスカッション・サーバーの構成

単純トポロジでは、ディスカッション・サーバーはSpacesと同じドメインにあるため、追加のキーストア構成は必要ありません。これは、WebCenter Portalドメインに構成されているキーストアがディスカッション・サービスでも使用されるからです。ただし、本番環境では、ディスカッション・サービスのWebサービス・エンド・ポイントをOWSMポリシーで保護し、ディスカッション・サーバー接続設定を構成する必要があります。それらの設定手順は、次の各項で説明します。

- 第34.1.3.1項「ディスカッション・サービス・エンド・ポイントの保護」

- 第34.1.3.2項「ディスカッション・サーバーの接続設定の構成」

注意:

WebCenter PortalアプリケーションからOracle WebCenter Portalのディスカッション・サーバーに送信されるディスカッション固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のため、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスする必要があります。詳細は、第33章「SSLの構成」を参照してください。

34.1.3.1 ディスカッション・サービス・エンド・ポイントの保護

WebCenter Portalのディスカッション・サービスのWebサービス・エンド・ポイントでは、Spacesから発信されるコールに対してユーザー・アイデンティティを伝搬する必要があります。出荷時に、ディスカッション・サービスのWebサービス・エンド・ポイントには、完全にセキュリティを実装する必要なくテスト環境で起動して実行できるように、非保護のSAMLトークンを使用するポリシーが構成されています。ただし、本番環境では、転送中に他者がメッセージを改ざんしたり、表示したりできないように、Webサービス・エンド・ポイントをOWSMポリシーで保護する必要があります。これを実行するには、パブリック・アクセス用のWebサービス・エンド・ポイントと認証済ユーザー・アクセス用のエンド・ポイントの両方を、Fusion Middleware ControlまたはWLSTを使用して適切なOWSMポリシーで保護する必要があります。

この項の内容は次のとおりです。

- 第34.1.3.1.1項「Fusion Middleware Controlを使用したディスカッション・サーバー・エンド・ポイントの保護」

- 第34.1.3.1.2項「WLSTを使用したディスカッション・サーバー・エンド・ポイントの保護」

34.1.3.1.1 Fusion Middleware Controlを使用したディスカッション・サーバー・エンド・ポイントの保護

Fusion Middleware Controlを使用してディスカッション・サービス・エンド・ポイントを保護する手順は次のとおりです。

1. Fusion Middleware Controlにログインして、ナビゲーション・ペインから、「WebCenter」→「ポータル」→「ディスカッション」を開いて、Discussions(WC_Collaboration)をクリックします。
「ディスカッション」ホームページが表示されます(図34-5を参照)。

図34-5 「ディスカッション」ホームページ

「図34-5 「ディスカッション」ホームページ」の説明

2. owc_discussionsターゲットをクリックします。
owc_discussionsアプリケーションのホームページが表示されます(図34-6を参照)。

図34-6 owc_discussionsのホームページ

「図34-6 owc_discussionsのホームページ」の説明

3. 「アプリケーションのデプロイ」メニューから、「Webサービス」を選択します。
owc_discussionsアプリケーションの「Webサービス」ページが表示されます(図34-7を参照)。

図34-7 owc_discussionsの「Webサービス」ページ

「図34-7 owc_discussionsの「Webサービス」ページ」の説明

4. 「Webサービス」タブを開き、OWCDiscussionsServiceAuthenticated Webサービス・エンド・ポイントをクリックします。
owc_discussionsの「Webサービス・エンドポイント」ページが表示されます(図34-8を参照)。

図34-8 「Webサービス・エンドポイント」ページ

「図34-8 「Webサービス・エンドポイント」ページ」の説明

5. 「アタッチ/デタッチ」をクリックします。
「ポリシーの添付」ページが表示されます(図34-9を参照)。

図34-9 「ポリシーの添付」ページ

「図34-9 「ポリシーの添付」ページ」の説明

6. Use the 「アタッチ」ボタンと「デタッチ」ボタンを使用して、oracle/wss11_saml_token_with_message_protection_service_policyを添付し、oracle/wss10_saml_token_service_policyを削除します。

7. 「OK」をクリックします。

8. 「Webサービス」ページに戻り、OWCDiscussionsServicePublicエンド・ポイントをクリックします。

9. oracle/wss11_message_protection_service_policyを添付して、パブリック・ユーザーのWebサービス・エンド・ポイントも保護されるようにします。

10. 「OK」をクリックします。

34.1.3.1.2 WLSTを使用したディスカッション・サーバー・エンド・ポイントの保護

WLSTを使用してディスカッション・サーバー・エンド・ポイントを保護するには、次のWLSTコマンドを使用して、wss10_saml_token_service_policyを削除し、wss11_saml_token_with_message_protection_service_policyを添付します。

detachWebServicePolicy('owc_discussions', 'owc_discussions', 'web', 'OWCDiscussionsServiceAuthenticated', 'OWCDiscussionsServiceAuthenticated', 'oracle/wss10_saml_token_service_policy')
attachWebServicePolicy('owc_discussions', 'owc_discussions', 'web', 'OWCDiscussionsServiceAuthenticated', 'OWCDiscussionsServiceAuthenticated', 'oracle/wss11_saml_token_with_message_protection_service_policy')

34.1.3.2 ディスカッション・サーバーの接続設定の構成

第14.3項「ディスカッション・サーバーの登録」で説明しているように、Spacesまたは使用しているWebCenter Portalアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定する必要があります。図34-10は、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細設定の例を示しています。

図34-10 「ディスカッションおよびお知らせ接続の編集」ページ

「図34-10 「ディスカッションおよびお知らせ接続の編集」ページ」の説明

34.1.4 単純トポロジの場合のコマンド・サマリー

単純トポロジの場合にキーストアを迅速に構成するには、次のコマンド・サマリーを使用します。

キーストアの生成

次のkeytoolコマンドを使用して、キーストアを生成し、太字で示した値をローカル環境の値に置き換えます。

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias orakey
-keypass welcome1 -keystore default-keystore.jks -storepass welcome1 -validity 1064

keytool -exportcert -v -alias orakey -keystore default-keystore.jks -storepass welcome1 -rfc -file orakey.cer

keytool -importcert -alias webcenter_spaces_ws -file orakey.cer
-keystore default-keystore.jks -storepass welcome1

証明書がすでに存在することを伝えるプロンプトが表示されたら、yesと答えます。

keytool -importcert -alias df_orakey_public -file orakey.cer
-keystore owc_discussions.jks -storepass welcome1

default-keystore.jksファイルをdomain_home/config/fmwconfigディレクトリにコピーします。

キーストアの構成

WLSTを使用して、Spacesドメインに管理者として接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="orakey", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="orakey", password="welcome1", desc="Signing key")

34.2 標準トポロジの場合のWS-Securityの構成

この項では、WebCenter PortalアプリケーションとWSRPプロデューサは同一ドメインを共有しているが、BPELサーバーは外部ドメイン(SOAドメイン)に配置されているトポロジの場合にWS-Securityを構成する方法を説明します(図34-11を参照)。

図34-11 標準構成の場合のWS-Security

「図34-11 標準構成の場合のWS-Security」の説明

標準の2つのドメインのWebCenter Portalトポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- 第34.2.1項「標準トポロジの場合のWS-Securityの構成のロードマップ」

- 第34.2.2項「WebCenter Portalドメイン・キーストアの設定」

- 第34.2.3項「標準トポロジの場合のディスカッション・サーバーの構成」

- 第34.2.4項「SOAドメインの設定」

- 第34.2.5項「標準トポロジの場合のコマンド・サマリー」

34.2.1 標準トポロジの場合のWS-Securityの構成のロードマップ

この項のフロー・チャート(図34-12)と表(表34-3)は、標準WebCenter PortalトポロジでWS-Securityを構成するために必要な前提条件とタスクの概要を示しています。

図34-12 標準トポロジの場合のWS-Securityの構成

「図34-12 標準トポロジの場合のWS-Securityの構成」の説明

表34-3は、標準WebCenter Portalトポロジの場合にWS-Securityを構成するためのタスクとサブタスクを示しています。

表34-3 標準トポロジの場合のWS-Securityの構成

担当者

タスク

サブタスク

ノート

Administrator

1. WebCenter Portalドメイン・キーストアの設定

1.a WebCenter Portalドメイン・キーストアの作成

1.b キーストアの構成

2. ディスカッション・サーバーの構成

2.a ディスカッション・サービス・エンド・ポイントの保護

2.b ディスカッション・サーバーの接続設定の構成

34.2.2 WebCenter Portalドメイン・キーストアの設定

Javaキーストア(JKS)を使用して、WebCenter Portalアプリケーション、ディスカッション・サーバー、BPELサーバー(別のドメイン内)およびWSRPプロデューサのセキュリティ資格証明を取得および管理できます。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、ウォレットまたはキーストアにセキュアに格納されます。JKSの詳細は、Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイドを参照してください。

この項の内容は次のとおりです。

- 第34.2.2.1項「WebCenter Portalドメイン・キーストアの作成」

- 第34.2.2.2項「WLSTを使用したキーストアの構成」

- 第34.2.2.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.2.2.1 WebCenter Portalドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してキーストアおよびキーを作成する方法について説明します。JKSは、Sun Microsystemsにより定義された独自仕様のキーストア形式です。JKSでキーおよび証明書を作成して管理するには、Java JDK 6とともに配布されるkeytoolユーティリティを使用します。

WebCenter Portalドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias webcenter -keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=spaces,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-5 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias
webcenter -keypass welcome1 -keystore webcenter.jks -storepass welcome1
-validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias webcenter -keystore keystore
-storepass keystore_password -rfc -file webcenter_public.cer

各要素の意味は次のとおりです。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-6 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias webcenter -keystore webcenter.jks
-storepass welcome1 -rfc -file webcenter_public.cer

4. 第34.2.2.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.2.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表34-4は、キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表34-4 標準トポロジの場合のWebCenter Portalドメイン・キーストアのコンテンツ

キーの別名

説明

webcenter

Spacesからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM(ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

orakey

SOAドメインで使用されるBPEL秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter Portalドメイン内のBPEL Server1にあるワークフロー・アプリケーションから、SOAドメインのSOAサーバーに対するワークリスト・サービスへのアウトバウンドWebサービス・メッセージの暗号化に使用されます。

34.2.2.2 WLSTを使用したキーストアの構成

WebCenter Portalドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.2.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./webcenter.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password=keystore_password, desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password=private_key_password, desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password=private_key_password, desc="Signing key")

各要素の意味は次のとおりです。

- keystore_passwordは、第34.2.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定したキーストア・パスワードです(例: welcome1)。

- private_key_passwordは、第34.2.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定した秘密鍵パスワードです(例: welcome1)。

例34-7 資格証明ストアの更新

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.2.2.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.2.2.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます(図34-13を参照)。

図34-13 「セキュリティ・プロバイダ構成」ページ

「図34-13 「セキュリティ・プロバイダ構成」ページ」の説明

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-14を参照)。

図34-14 「キーストアの構成」ページ

「図34-14 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./webcenter.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: webcenter

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: webcenter

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.2.3 標準トポロジの場合のディスカッション・サーバーの構成

標準トポロジの場合のディスカッション・サーバーの構成は、単純トポロジの場合とまったく同じです。詳細は、第34.1.3項「単純トポロジの場合のディスカッション・サーバーの構成」を参照してください。

34.2.4 SOAドメインの設定

この項では、SOAドメイン・キーストアの設定方法について説明します。この項の内容は次のとおりです。

- 第34.2.4.1項「SOAドメイン・キーストアの作成」

- 第34.2.4.2項「WLSTを使用したキーストアの構成」

- 第34.2.4.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.2.4.1 SOAドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してSOAドメイン・キーストアおよびキーを作成する方法について説明します。

SOAドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. WebCenter Portalドメインから公開証明書(webcenter_public.cer)をインポートして、キーストアを作成します。

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- 例34-8 公開証明書のインポート

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer -keystore bpel.jks -storepass welcome1

3. keytoolを使用して、メッセージの署名と暗号化のためにSOAドメインで使用するキーペアを作成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias bpel
-keypass key_password -keystore keystore -storepass keystore_password
-validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=bpel,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストアの名前です(例: bpel.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-9 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass welcome1 -keystore bpel.jks -storepass welcome1 -validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. 別名orakeyを使用してWebCenter Portalドメインにインポートできるように証明書をエクスポートします。

keytool -exportcert -v -alias bpel -keystore keystore -storepass keystore_password -rfc -file orakey.cer

各要素の意味は次のとおりです。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-10 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass welcome1 -rfc -file orakay.cer

5. 異なる別名で証明書をインポートします(別名がorakeyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです。

例34-11 証明書のインポート

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks -storepass welcome1

34.2.4.2 WLSTを使用したキーストアの構成

SOAドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.2.4.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. bpel.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./bpel.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを構成します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.2.4.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.2.4.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、SOAドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、SOAドメインをクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ペインが表示されます(図34-15を参照)。

図34-15 「キーストアの構成」ページ

「図34-15 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./bpel.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: bpel

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: bpel

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.2.5 標準トポロジの場合のコマンド・サマリー

標準トポロジの場合にキーストアを迅速に構成するには、次のコマンド・サマリーを使用します。

キーストアの生成

次のkeytoolコマンドを使用して、キーストアを生成し、太字で示した値をローカル環境の値に置き換えます。

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias
webcenter -keypass welcome1 -keystore webcenter.jks -storepass welcome1 -validity
1064

keytool -exportcert -v -alias webcenter -keystore webcenter.jks
-storepass welcome1 -rfc -file webcenter_public.cer

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass welcome1

証明書がすでに存在することを伝えるプロンプトが表示されたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass welcome1 -keystore bpel.jks -storepass welcome1 -validity 1024

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass welcome1
-rfc -file orakay.cer

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks
-storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias df_webcenter_public -file webcenter_public.cer
-keystore owc_discussions.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

webcenter.jksファイルをdomain_home/config/fmwconfigディレクトリにコピーし、bpel.jksファイルをsoa_domain_home/config/fmwconfigディレクトリにコピーします。

WebCenter Portalドメイン・キーストアの構成

次の手順に従って、WebCenter Portalドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、webcenter.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./webcenter.jksを指定します。

6. WLSTを使用して、Spacesドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="welcome1", desc="Signing key")

SOAドメイン・キーストアの構成

次の手順に従って、SOAドメインのサービス・インスタンス参照を構成します。

1. <SOA_DOMAIN_HOME>/config/fmwconfigディレクトリにナビゲートします。

2. まだ実行していない場合は、bpel.jksを<SOA_DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./bpel.jksを指定します。

6. WLSTを使用して、SOAドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="welcome1", desc="Signing key")

34.3 複合トポロジの場合のWS-Securityの構成

この項では、WebCenter Portalアプリケーション、ディスカッション・サーバー(Jive)およびWSRPプロデューサが同一ドメインにあり、2つのBPELサーバーが別々のSOAドメインにあり、1つのWSRPプロデューサが外部ポートレット・ドメインにある複合トポロジの場合にWS-Securityを構成する方法を説明します(図34-16を参照)。

図34-16 複合構成の場合のWS-Security

「図34-16 複合構成の場合のWS-Security」の説明

複数のドメインが含まれる複合WebCenter Portalトポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- 第34.3.1項「複合トポロジの場合のWS-Securityの構成のロードマップ」

- 第34.3.2項「WebCenter Portalドメイン・キーストアの設定」

- 第34.3.3項「複合トポロジの場合のディスカッション・サーバーの構成」

- 第34.3.4項「1つ目のSOAドメインの設定」

- 第34.3.5項「2つ目のSOAドメインの設定」

- 第34.3.6項「外部ポートレット・ドメイン・キーストアの設定」

- 第34.3.7項「外部WebCenter Portalドメイン・キーストアの設定」

- 第34.3.8項「複合トポロジの場合のコマンド・サマリー」

34.3.1 複合トポロジの場合のWS-Securityの構成のロードマップ

この項のフロー・チャート(図34-17)と表(表34-5)は、複数ドメインの複合WebCenter PortalトポロジでWS-Securityを構成するために必要な前提条件とタスクの概要を示しています。

図34-17 複合トポロジの場合のWS-Securityの構成

「図34-17 複合トポロジの場合のWS-Securityの構成」の説明

表34-5は、複合WebCenter Portalトポロジの場合にWS-Securityを構成するためのタスクとサブタスクを示しています。

表34-5 複合トポロジの場合のWS-Securityの構成

担当者

タスク

サブタスク

ノート

Administrator

1. WebCenter Portalドメイン・キーストアの設定

1.a WebCenter Portalドメイン・キーストアの作成

1.b キーストアの構成

.

2. ディスカッション・サーバーの構成

2.a ディスカッション・サービス・エンド・ポイントの保護

2.b ディスカッション・サーバー・キーストアの作成

2.c 資格証明ストアの更新

2.d ディスカッション・サーバー接続の構成

.

3. 1つ目のSOAドメインの設定

3.a 1つ目のSOAドメイン・キーストアの作成

3.b 1つ目のSOAドメイン・キーストアの構成

4. 2つ目のSOAドメインの設定

4.a 2つ目のSOAドメイン・キーストアの作成

4.b 2つ目のSOAドメイン・キーストアの構成

4.c Spacesワークリスト接続の構成

5. 外部ポートレット・ドメイン・キーストアの設定

5.a 外部ポートレット・ドメイン・キーストアの作成

5.b 外部ポートレット・ドメイン・キーストアの構成

6. 外部WebCenter Portalドメイン・キーストアの設定

6.a 外部WebCenter Portalドメイン・キーストアの作成

6.b 外部WebCenter Portalドメイン・キーストアの構成

34.3.2 WebCenter Portalドメイン・キーストアの設定

Javaキーストア(JKS)を使用して、Spaces、ディスカッション・サーバー、BPELサーバー(別のドメイン内)およびWSRPプロデューサ(これも別のドメイン内)のセキュリティ資格証明を取得および管理できます。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、ウォレットまたはキーストアにセキュアに格納されます。JKSの詳細は、Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイドを参照してください。

この項の内容は次のとおりです。

- 第34.3.2.1項「WebCenter Portalドメイン・キーストアの作成」

- 第34.3.2.2項「WLSTを使用したキーストアの構成」

- 第34.3.2.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.3.2.1 WebCenter Portalドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してキーストアおよびキーを作成する方法について説明します。JKSは、Sun Microsystemsにより定義された独自仕様のキーストア形式です。JKSでキーおよび証明書を作成して管理するには、Java JDK 6とともに配布されるkeytoolユーティリティを使用します。

WebCenter Portalドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、webcenterキーストアにキー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias webcenter -keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=spaces,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-12 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias webcenter -keypass welcome1 -keystore webcenter.jks -storepass welcome1 -validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias webcenter -keystore wecenter.jks -storepass keystore_password -rfc -file webcenter_public.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-13 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias webcenter -keystore webcenter.jks -storepass welcome1 -rfc -file webcenter_public.cer

4. orakey証明書をインポートします。

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-14 orakey証明書のインポート

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks -storepass welcome1

5. 第34.3.2.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.3.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表34-6は、キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表34-6 複合トポロジの場合のWebCenter Portalドメイン・キーストアのコンテンツ

キーの別名

説明

webcenter

Spacesからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM(ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

orakey

SOA 1ドメインで使用されるBPEL秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・サービスからSOA 1ドメイン内のSOA_Server3へのアウトバウンド・メッセージの暗号化に使用されます。

soa_server3_public_key

SOA 2ドメインで使用されるsoa_server3秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・サービスからSOA 2ドメイン内のBPEL Server2へのアウトバウンド・メッセージの暗号化に使用されます。

producer_public_key

WSRPプロデューサ1アプリケーションをホストする外部ポートレット・ドメインで使用されるプロデューサ秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、SpacesからSpacesアプリケーションに登録されているWSRPプロデューサ1へのアウトバウンド・メッセージの暗号化に使用されます。

external_webcenter_custom_public_key

Spaces Webサービスに対してWebサービス・コールを行うWebCenter Portalアプリケーションをホストする外部WebCenter Portalドメインで使用されるexternal_webcenter_custom秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、Spacesから外部WebCenter Portalドメイン内のWebCenter Portalアプリケーションへのアウトバウンド・メッセージの暗号化に使用されます。

owc_discussions_public

ディスカッション・アプリケーションをホストする外部ディスカッション・ドメインで使用される外部owc_discussions秘密鍵に対応する公開鍵が含まれる証明書です。この証明書はディスカッションWebサービスに対してWebサービス・コールを行うSpacesおよびWebCenter Portalアプリケーションによって使用されます。

34.3.2.2 WLSTを使用したキーストアの構成

WebCenter Portalドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./webcenter.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.3.2.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます(図34-18を参照)。

図34-18 「セキュリティ・プロバイダ構成」ページ

「図34-18 「セキュリティ・プロバイダ構成」ページ」の説明

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-19を参照)。

図34-19 「キーストアの構成」ページ

「図34-19 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./webcenter.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: webcenter

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: webcenter

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.3.3 複合トポロジの場合のディスカッション・サーバーの構成

複合トポロジでは、ディスカッション・サーバーはSpacesとは異なるドメインにあるため、ディスカッション・サーバーにキーストアを作成して構成し、公開鍵が含まれる証明書をエクスポートして、それをWebCenter Portalドメインにインポートすることが必要になります。本番環境では、ディスカッション・サービスのWebサービス・エンド・ポイントをOWSMポリシーで保護し、ディスカッション・サーバー接続設定を構成することも必要になります。それらの設定手順は、次の各項で説明します。

- 第34.3.3.1項「ディスカッション・サービスのエンド・ポイントの保護」

- 第34.3.3.2項「ディスカッション・サーバー・キーストアの作成」

- 第34.3.3.3項「資格証明ストアの更新」

- 第34.3.3.4項「ディスカッション・サーバーの接続設定の構成」

注意:

FrameworkアプリケーションからWebCenter Portalのディスカッション・サーバーに送信されるディスカッション固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のため、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスする必要があります。詳細は、第33章「SSLの構成」を参照してください。

34.3.3.1 ディスカッション・サービスのエンド・ポイントの保護

WebCenter Portalのディスカッション・サービスのWebサービス・エンド・ポイントでは、Spacesから発信されるコールに対してユーザー・アイデンティティを伝搬する必要があります。第34.1.3.1項「ディスカッション・サービスのエンド・ポイントの保護」の手順に従い、Fusion Middleware ControlまたはWLSTを使用してこれらのエンド・ポイントを保護します。

34.3.3.2 ディスカッション・サーバー・キーストアの作成

この項では、OWSMで使用されるキー・ペアが含まれるキーストアをディスカッション・サーバーに作成し、公開鍵が含まれる証明書をエクスポートして、それをWebCenter Portalドメインにインポートできるようにする方法を説明します。

owc_discussionsキーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、owc_discussionsキーストアにキー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias owc_discussions -keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=owc_discussions,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストア名です(例: owc_discussions.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-15 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=owc_discussions,dc=example,dc=com" -alias owc_discussions -keypass welcome1 -keystore owc_discussions.jks -storepass welcome1 -validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias owc_discussions -keystore owc_discussions.jks -storepass keystore_password -rfc -file owc_discussions_public.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-16 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias owc_discussions -keystore owc_discussions.jks -storepass welcome1 -rfc -file owc_discussions_public.cer

4. webcenter_public証明書をインポートします。

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore owc_discussions.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-17 webcenter_public証明書のインポート

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore owc_discussions.jks -storepass welcome1

5. owc_discussions_public証明書をインポートします。

keytool -importcert -alias owc_discussions_public -file owc_discussions_public.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-18 owc_discussions_public証明書のインポート

keytool -importcert -alias owc_discussions_public -file owc_discussions_public.cer -keystore webcenter.jks -storepass welcome1

6. 第34.3.3.3項「資格証明ストアの更新」で説明しているように、WLSTを使用して資格証明ストアを更新し、続行します。

34.3.3.3 資格証明ストアの更新

WebCenter Portalドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

<!-- KeyStore Service Instance -->
<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">
<description>Default JPS Keystore Service</description>

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./webcenter.jksを指定します。

<serviceInstance name="keystore" provider="keystore.provider" location="./webcenter.jks">
<description>Default JPS Keystore Service</description>

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="owc_discussions", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="owc_discussions", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.3.3.4 ディスカッション・サーバーの接続設定の構成

第14.3項「ディスカッション・サーバーの登録」で説明しているように、Spacesまたは使用しているFrameworkアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定する必要があります。図34-20は、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細設定の例を示しています。

図34-20 「ディスカッションおよびお知らせ接続の編集」ページ

「図34-20 「ディスカッションおよびお知らせ接続の編集」ページ」の説明

34.3.4 1つ目のSOAドメインの設定

この項では、SOAドメイン・キーストアの設定方法について説明します。この項の内容は次のとおりです。

- 第34.3.4.1項「SOAドメイン・キーストアの作成」

- 第34.3.4.2項「WLSTを使用したキーストアの構成」

- 第34.3.4.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.3.4.1 SOAドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してSOAドメイン・キーストアおよびキーを作成する方法について説明します。

SOAドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. WebCenter Portalドメインから公開証明書(webcenter_public.cer)をインポートして、キーストアを作成します。

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- 例34-19 公開証明書のインポート

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer -keystore bpel.jks -storepass welcome1

3. keytoolを使用して、メッセージの署名と暗号化のためにSOAドメインで使用するキーペアを作成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias bpel -keypass key_password -keystore bpel.jks -storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=bpel,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-20 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass welcome1 -keystore bpel.jks -storepass welcome1 -validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. 別名orakeyを使用してWebCenter Portalドメインにインポートできるように証明書をエクスポートします。

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass keystore_password -rfc -file orakey.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-21 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass welcome1 -rfc -file orakay.cer

5. 再度WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がorakeyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-22 証明書のインポート

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks -storepass welcome1

6. 証明書をSOAドメインにインポートします。

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-23 証明書のインポート

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer -keystore webcenter.jks -storepass welcome1

7. 第34.3.4.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.3.4.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表34-7は、SOA 1ドメイン・キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表34-7 複合トポロジの場合のSOA 1ドメイン・キーストアのコンテンツ

キーの別名

説明

bpel

SOA 1ドメインのサーバーからのアウトバウンド・メッセージの署名に使用される秘密鍵です。この鍵は、SOA 1ドメインのSOAサーバーにデプロイされているワークリスト・アプリケーションによって使用されます。

webcenter_spaces_ws

WebCenter Portalドメインで使用されるwebcenter秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、SOA 1ドメイン内のBPEL Server1からSpacesドメインのWebサービスAPIへのアウトバウンド・ワークフロー・メッセージの暗号化に使用されます。

34.3.4.2 WLSTを使用したキーストアの構成

SOAドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.3.4.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. bpel.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./bpel.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.3.4.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.3.4.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、SOAドメインをクリックします。

3. 「SOAドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-21を参照)。

図34-21 「キーストアの構成」ページ

「図34-21 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./bpel.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: bpel

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: bpel

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.3.5 2つ目のSOAドメインの設定

この項では、2つ目のSOAドメイン・キーストアを設定する方法について説明します。内容は次のとおりです。

- 第34.3.5.1項「SOAドメイン・キーストアの作成」

- 第34.3.5.2項「WLSTを使用したキーストアの構成」

- 第34.3.5.3項「Fusion Middleware Controlを使用したキーストアの構成」

- 第34.3.5.4項「2つ目のSOAサーバーのSpacesワークリスト接続の構成」

34.3.5.1 SOAドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してSOAドメイン・キーストアおよびキーを作成する方法について説明します。

SOAドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、メッセージの署名と暗号化のためにSOAドメインで使用するキーペアを作成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias soa_server3
-keypass key_password -keystore soa_server3.jks -storepass keystore_password
-validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=soa_server3,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-24 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=soa_server3,dc=example,dc=com" -alias
soa_server3 -keypass welcome1 -keystore soa_server3.jks -storepass welcome1
-validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 別名orakeyを使用してWebCenter Portalドメインにインポートできるように証明書をエクスポートします。

keytool -exportcert -v -alias soa_server3 -keystore soa_server3.jks
-storepass keystore_password -rfc -file soa_server3_public_key.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-25 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias soa_server3 -keystore soa_server3.jks
-storepass welcome1 -rfc -file soa_server3_public_key.cer

4. WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がsoa_server3_public_keyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_
key.cer  -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-26 証明書のインポート

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer
-keystore webcenter.jks -storepass welcome1

5. soa_server3_public_key証明書をインポートします。

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-27 soa_server3_public_key証明書のインポート

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer -keystore webcenter.jks -storepass welcome1

6. producer_public_key証明書をインポートします。

keytool -importcert -alias producer_public_key -file producer_public_key.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-28 producer_public_key証明書のインポート

keytool -importcert -alias producer_public_key -file producer_public_key.cer -keystore webcenter.jks -storepass welcome1

7. external_webcenter_custom_public_key証明書をインポートします。

keytool -importcert -alias external_webcenter_custom_public_key -file external_webcenter_custom_public_key.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-29 external_webcenter_custom_public_key証明書のインポート

keytool -importcert -alias external_webcenter_custom_public_key -file external_webcenter_custom_public_key.cer -keystore webcenter.jks -storepass welcome1

8. 第34.3.5.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.3.5.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表34-8は、SOA 2ドメイン・キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表34-8 複合トポロジの場合のSOA 2ドメイン・キーストアのコンテンツ

キーの別名

説明

webcenter

Spacesからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM(ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

orakey

SOA 1ドメインで使用されるBPEL秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・サービスからSOA 1ドメイン内のSOA_Server3へのアウトバウンド・メッセージの暗号化に使用されます。

soa_server3_public_key

SOA 2ドメインで使用されるsoa_server3秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・サービスからSOA 2ドメイン内のBPEL Server2へのアウトバウンド・メッセージの暗号化に使用されます。

producer_public_key

WSRPプロデューサ1アプリケーションをホストする外部ポートレット・ドメインで使用されるプロデューサ秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、SpacesからSpacesアプリケーションに登録されているWSRPプロデューサ1へのアウトバウンド・メッセージの暗号化に使用されます。

external_webcenter_custom_public_key

Spaces Webサービスに対してWebサービス・コールを行うFrameworkアプリケーションをホストする外部WebCenter Portalドメインで使用されるexternal_webcenter_custom秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、Spacesから外部WebCenter Portalドメイン内のFrameworkアプリケーションへのアウトバウンド・メッセージの暗号化に使用されます。

34.3.5.2 WLSTを使用したキーストアの構成

2つ目のSOAドメイン・キーストアの作成後に、キーストア・サービスを構成して、資格証明ストアを更新し、OWSMでキーストアおよびキーを正常に読み取れるようにします。これは、第34.3.5.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. soa_server3.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./soa_server3.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="soa_server3", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="soa_server3", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.3.5.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.3.5.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、SOAドメインをクリックします。

3. 「SOAドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-22を参照)。

図34-22 「キーストアの構成」ページ

「図34-22 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./soa_server3.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: soa_server3

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: soa_server3

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.3.5.4 2つ目のSOAサーバーのSpacesワークリスト接続の構成

通常、Spacesワークリスト接続では、oracle/wss10_saml_token_with_message_protection_client_policyポリシーを使用して、SOAサーバーへのアウトバウンドSOAPメッセージが保護されます。ただし、WebCenter Portalドメインで複数のワークリスト接続が同時に使用される複合デプロイメントの場合は、追加のOWSMポリシーを作成して、受信者キーの別名が、Spacesサイドの目的のSOAサーバーの証明書の別名と一致するように、そのポリシーを構成する必要があります。

複数のワークリスト接続を同時に使用するには、次の手順を実行します。

1. 外部SOAドメインから証明書をエクスポートし、それを新規別名(次の例ではsoa_server3_key)でWebCenter Portalドメインにインポートします。

2. Fusion Middleware Controlを使用して新規OWSMポリシーを作成し、前の手順と同じ別名を使用するように受信者キーの別名を上書きします。

1. Fusion Middleware Controlで、「WebLogicドメイン」メニューから、「Webサービス」→「ポリシー」を選択します。
「Webサービス・ポリシー」ページが表示されます(図34-23を参照)。

図34-23 「Webサービス・ポリシー」ページ

「図34-23 「Webサービス・ポリシー」ページ」の説明

2. 新規ポリシー作成のベースとして使用するクライアント・ポリシーを選択して、「類似作成」をクリックします。
「ポリシーの作成」ページが表示されます(図34-24を参照)。

図34-24 「ポリシーの作成」ページ

「図34-24 「ポリシーの作成」ページ」の説明

3. 新規ポリシーの名前(たとえば、oracle_wss10_saml_token_with_message_protection_client_policy_soa_server3)を入力して、「保存」をクリックします。
「Webサービス・ポリシー」ページに、新規ポリシーが表示されます。

4. 「Webサービス・ポリシー」ページで、新規ポリシーを選択して、「編集」をクリックします。

5. 「ポリシーの編集」ページで、「構成」タブを開き、「編集」をクリックします。

6. 受信者キーの別名を値soa_server3_keyで上書きして、「保存」をクリックします。

3. BPEL接続を作成し、次のWLSTコマンドを使用して、前の手順で作成したポリシーにセキュリティ・ポリシーを設定します。

setBPELConnection(appName='webcenter', name='WebCenter-Worklist-SOAServer3',url='<your_url>', policy='oracle/wss10_saml_token_with_message_protection_client_policy_soa_server3')

34.3.6 外部ポートレット・ドメイン・キーストアの設定

この項では、この複合トポロジのWSRPプロデューサの1つで使用されている外部ポートレット・ドメインにキーストアを設定する方法を説明します。

この項の内容は次のとおりです。

- 第34.3.6.1項「外部ポートレット・ドメイン・キーストアの作成」

- 第34.3.6.2項「WLSTを使用したキーストアの構成」

- 第34.3.6.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.3.6.1 外部ポートレット・ドメイン・キーストアの作成

外部ポートレット・ドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、WebCenter Portalドメインの公開証明書をインポートすることでキーストアを生成します。

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore producer.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです。

例34-30 証明書のインポート

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore producer.jks -storepass welcome1

3. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias producer
-keypass key_password -keystore producer.jks -storepass keystore_password
-validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=producer,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-31 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=producer,dc=example,dc=com" -alias
producer -keypass welcome1 -keystore producer.jks -storepass welcome1 -validity
1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. Spacesドメインのキーストアにインポートできるように、公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias producer -keystore producer.jks -storepass keystore_password -rfc -file producer_public_key.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-32 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias producer -keystore producer.jks -storepass welcome1
-rfc -file producer_public_key.cer

5. WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がproducer_public_keyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-33 証明書のインポート

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass welcome1

6. 第34.3.6.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.3.6.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。

34.3.6.2 WLSTを使用したキーストアの構成

外部ポートレット・ドメイン・キーストアの作成後に、キーストア・サービスを構成して、資格証明ストアを更新し、OWSMでキーストアおよびキーを正常に読み取れるようにします。これは、第34.3.6.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. producer.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./producer.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="producer", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="producer", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.3.6.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.3.6.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-25を参照)。

図34-25 「キーストアの構成」ページ

「図34-25 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./producer.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: producer

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: producer

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.3.7 外部WebCenter Portalドメイン・キーストアの設定

この項では、Spaces Webサービス・コールを行うFrameworkアプリケーションで使用される外部WebCenter Portalドメインを設定する方法を説明します。

この項の内容は次のとおりです。

- 第34.3.7.1項「外部WebCenter Portalドメイン・キーストアの作成」

- 第34.3.7.2項「WLSTを使用したキーストアの構成」

- 第34.3.7.3項「Fusion Middleware Controlを使用したキーストアの構成」

34.3.7.1 外部WebCenter Portalドメイン・キーストアの作成

外部WebCenter Portalドメイン・キーストアを作成する手順は次のとおりです。

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、WebCenter Portalドメインの公開証明書をインポートすることでキーストアを生成します。

keytool -importcert -alias webcenter_public -file webcenter_public.cer
-keystore external_webcenter_custom.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです。

例34-34 証明書のインポート

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore
external_webcenter_custom.jks -storepass welcome1

3. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias external_webcenter_custom -keypass key_password -keystore external_webcenter_custom.jks
-storepass keystore_password -validity days_valid

各要素の意味は次のとおりです。

- consumer_dnameは、コンシューマの名前です(例: cn=external_webcenter_custom,dc=example,dc=com)。

- key_passwordは、新しい公開鍵のパスワードです(例: welcome1)。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例34-35 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=external_webcenter_custom, dc=example,dc=com" -alias external_webcenter_custom -keypass welcome1
-keystore external_webcenter_custom.jks -storepass welcome1 -validity 1064

注意:

キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. Spacesドメインのキーストアにインポートできるように、公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias external_webcenter_custom -keystore external_
webcenter_custom.jks -storepass keystore_password -rfc -file external_
webcenter_custom_public_key.cer

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-36 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias external_webcenter_custom -keystore external_
webcenter_custom.jks -storepass welcome1 -rfc -file external_webcenter_custom_
public_key.cer

5. WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がexternal_webcenter_custom_public_keyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias external_webcenter_custom_public_key -file external_
webcenter_custom_public_key.cer -keystore webcenter.jks -storepass keystore_password

各要素の意味は次のとおりです。

- keystore_passwordは、キーストアのパスワードです(例: welcome1)。

例34-37 証明書のインポート

keytool -importcert -alias external_webcenter_custom_public_key -file external_
webcenter_custom_public_key.cer -keystore webcenter.jks -storepass welcome1

6. 第34.3.7.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第34.3.7.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。

34.3.7.2 WLSTを使用したキーストアの構成

外部WebCenter Portalドメイン・キーストアの作成後に、キーストア・サービスを構成して、資格証明ストアを更新し、OWSMでキーストアおよびキーを正常に読み取れるようにします。これは、第34.3.7.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成する手順は次のとおりです。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./webcenter.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="external_webcenter_custom", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="external_webcenter_custom", password="welcome1", desc="Signing key")

5. すべてのサーバーを再起動します。

34.3.7.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第34.3.7.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成する手順は次のとおりです。

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図34-26を参照)。

図34-26 「キーストアの構成」ページ

「図34-26 「キーストアの構成」ページ」の説明

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./external_webcenter_custom.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: external_webcenter_custom

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: external_webcenter_custom

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

34.3.8 複合トポロジの場合のコマンド・サマリー

複合トポロジの場合にキーストアおよびDFプロパティを迅速に構成するには、次のコマンド・サマリーを使用します。

キーストアの生成

次のkeytoolコマンドを使用して、キーストアを生成し、太字で示した値をローカル環境の値に置き換えます。

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias
webcenter  -keypass welcome1 -keystore webcenter.jks -storepass welcome1 -validity 1064

keytool -exportcert -v -alias webcenter -keystore webcenter.jks -storepass
welcome1 -rfc -file webcenter_public.cer

keytool -importcert -alias df_webcenter_public -file webcenter_public.cer
-keystore owc_discussions.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass welcome1 -keystore bpel.jks

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass welcome1 -rfc -file orakay.cer

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=soa_server3,dc=example,dc=com" -alias
soa_server3 -keypass welcome1 -keystore soa_server3.jks -storepass welcome1
-validity 1024

keytool -exportcert -v -alias soa_server3 -keystore soa_server3.jks -storepass
welcome1 -rfc -file soa_server3_public_key.cer

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer
-keystore webcenter.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore
producer.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=producer,dc=example,dc=com" -alias
producer -keypass welcome1 -keystore producer.jks -storepass welcome1 -validity 1024

keytool -exportcert -v -alias producer -keystore producer.jks -storepass welcome1
-rfc -file producer_public_key.cer

keytool -importcert -alias webcenter_public -file webcenter_public.cer
-keystore external_webcenter_custom.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=external_webcenter_custom,dc=example,dc=com" -alias external_webcenter_custom -keypass welcome1 -keystore external_webcenter_custom.jks
-storepass welcome1 -validity 1024

keytool -exportcert -v -alias external_webcenter_custom -keystore
external_webcenter_custom.jks -storepass welcome1 -rfc -file
external_webcenter_custom_public_key.cer

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias external_webcenter_custom_public_key -file external_
webcenter_custom_public_key.cer -keystore webcenter.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

webcenter.jksをdomain_home/config/fmwconfigディレクトリに、bpel.jksをSOA1_domain_home/config/fmwconfigディレクトリに、soa_server3.jksをSOA_2_domain_home/config/fmwconfigディレクトリに、producer.jksをExternal_Portlet_domain_home/config/fmwconfigディレクトリに、およびexternal_webcenter_custom.jksをExternal_WebCenter_domain_home/config/fmwconfigディレクトリにコピーします。

WebCenter Portalドメイン・キーストアの構成

次の手順に従って、WebCenter Portalドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、webcenter.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./webcenter.jksを指定します。

6. WLSTを使用して、管理者としてWebCenter Portalドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="welcome1", desc="Signing key")

外部ディスカッション・サーバー・ドメイン・キーストアの構成

次の手順に従って、ディスカッション・サーバーのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、webcenter.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./owc_discussions.jksを指定します。

6. WLSTを使用して、管理者としてWebCenter Portalドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="owc_discussions", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="owc_discussions", password="welcome1", desc="Signing key")

SOA1ドメイン・キーストアの構成

次の手順に従って、SOA1ドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、bpel.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./bpel.jksを指定します。

6. WLSTを使用して、SOA1ドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="welcome1", desc="Signing key")

SOA2ドメイン・キーストアの構成

次の手順に従って、SOA2ドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、soa_server3.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./soa_server3.jksを指定します。

6. WLSTを使用して、SOA2ドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="soa_server3", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="soa_server3", password="welcome1", desc="Signing key")

外部ポートレット・プロデューサ・ドメイン・キーストアの構成

次の手順に従って、外部ポートレット・プロデューサ・ドメイン・キーストアおよび外部WebCenter Portalドメイン・キーストアのサービス・インスタンス参照を構成します。

1. 外部ポートレット・プロデューサ・ドメインの<DOMAIN_HOME>/config/fmwconfigディレクトリにナビゲートします。

2. まだ実行していない場合は、producer.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./producer.jksを指定します。

6. WLSTを使用して、管理者として外部ポートレット・プロデューサ・ドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="producer", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="producer", password="welcome1", desc="Signing key")

7. 外部WebCenter Portalドメインの<DOMAIN_HOME>/config/fmwconfigディレクトリにナビゲートします。

8. まだ実行していない場合は、producer.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

9. エディタでjps-config.xmlを開きます。

10. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

11. locationとして./external_webcenter_custom.jksを指定します。

12. WLSTを使用して、管理者として外部ポートレット・プロデューサ・ドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="welcome1", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="external_webcenter_custom", password="welcome1", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="external_webcenter_custom", password="welcome1", desc="Signing key")

ディスカッション・サーバー接続の構成

第14.3項「ディスカッション・サーバーの登録」で説明しているように、Spacesまたは使用しているFrameworkアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定します。また、第34.3.3.4項「ディスカッション・サーバーの接続設定の構成」で、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細設定の例を参照してください。

34.4 Spaces Client APIを使用するアプリケーションに対するWS-Securityを使用したSpacesの保護

この項では、Spaces APIを公開するアプリケーション(コンシューマ)とSpaces(プロデューサ)の間の通信のセキュリティが確保され、それらのAPIを呼び出すユーザーのアイデンティティが保護されるように、SpacesにWS-Securityを構成する場合に必要な管理者タスクについて説明します。

SpacesクライアントAPIを使用するアプリケーション開発のための開発者タスクの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWebCenter Spaces APIを使用するようにFrameworkアプリケーションを設定する方法に関する項を参照してください。

この項の内容は次のとおりです。

- 第34.4.1項「SpacesクライアントAPIを使用するアプリケーションの単純トポロジの構成」

- 第34.4.2項「SpacesクライアントAPIを使用するアプリケーションの標準トポロジの構成」

- 第34.4.3項「SpacesクライアントAPIを使用するアプリケーションの複合トポロジの構成」

34.4.1 SpacesクライアントAPIを使用するアプリケーションの単純トポロジの構成

クライアント・アプリケーションがSpacesと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("orakey");

クライアント・アプリケーションがJDeveloperであり、Spacesサーバーの構成済キーストアにアクセスできる場合は、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーし、このキーストアを使用するようにJDeveloperドメインを構成します。ここで必要な手順は、第34.1.2.2項「WLSTを使用したキーストアの構成」のものとまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("orakey");

34.4.2 SpacesクライアントAPIを使用するアプリケーションの標準トポロジの構成

クライアント・アプリケーションがSpacesと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

クライアント・アプリケーションがJDeveloperであり、Spacesサーバーの構成済キーストアにアクセスできる場合は、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーし、このキーストアを使用するようにJDeveloperドメインを構成します。ここで必要な手順は、第34.2.2.2項「WLSTを使用したキーストアの構成」のものとまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

34.4.3 SpacesクライアントAPIを使用するアプリケーションの複合トポロジの構成

クライアント・アプリケーションがSpacesと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

クライアント・アプリケーションがJDeveloperの場合、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーして、このキーストアを使用するようにJDeveloperドメインを構成します。ここで必要な手順は、第34.3.2.2項「WLSTを使用したキーストアの構成」のものとまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

35 ポートレット・プロデューサのセキュリティの構成

この章では、WSRPおよびJPDKポートレット・プロデューサのセキュリティを処理するようWebCenter Portalアプリケーションを構成する方法を説明します。

この章の内容は次のとおりです。

- 第35.1項「WSRPプロデューサの保護」

- 第35.2項「PDK-Javaプロデューサの保護」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

35.1 WSRPプロデューサの保護

次の各項で、WebCenter PortalアプリケーションからJSR-168標準ベースのWSRPポートレットにセキュアにアクセスする方法を説明します。

- 第35.1.1項「プロデューサのデプロイ」

- 第35.1.2項「プロデューサ・エンドポイントへのポリシーの添付」

- 第35.1.3項「キーストアの設定」

WSRPプロデューサの保護の概要は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のWS-Securityを使用したWSRPプロデューサを介するアイデンティティ伝播の保護に関する項を参照してください。

35.1.1 プロデューサのデプロイ

WS-Security用にプロデューサを構成する前に、第24.8項「ポートレット・プロデューサ・アプリケーションのデプロイ」で説明されている手順を実行して、標準準拠のポートレット・プロデューサをOracle WebLogic管理対象サーバーにデプロイする必要があります。

35.1.2 プロデューサ・エンドポイントへのポリシーの添付

この項では、セキュリティ・ポリシーをWSRPプロデューサ・エンドポイントに添付する方法について説明します。WSRPプロデューサでサポートされるポリシーは次のとおりです。

- ユーザー名トークン(パスワードあり)
wss10_username_token_with_message_protection_service_policy

このポリシーでは、WS-Security 1.0標準に従って、メッセージレベルの保護(メッセージの整合性および機密保護)およびインバウンドSOAPリクエストの認証が実施されます。このポリシーでは、非対称型キー・テクノロジであるWS-SecurityのBasic128スイート(具体的には、メッセージの機密保護に使用するRSAキー・メカニズム、メッセージの整合性に使用するSHA-1ハッシング・アルゴリズム、およびAES-128ビット暗号化)が使用されます。キーストアの構成は、セキュリティ構成を通じて行われます。認証は、WS-Security UsernameToken SOAPヘッダーで資格証明を使用することによって実施されます。ユーザーのサブジェクトは、現在構成されているアイデンティティ・ストアに対して確立されます。

- ユーザー名トークン(パスワードなし)
wss10_username_id_propagation_with_msg_protection_service_policy

このポリシーでは、WS-Security 1.0標準で示されたメカニズムを使用して、メッセージレベルの保護(メッセージの整合性および機密保護)およびインバウンドSOAPリクエストのアイデンティティ伝搬を実施します。メッセージの保護は、非対称型キー・テクノロジであるWS-SecurityのBasic128スイート(具体的には、機密保護に使用するRSAキー・メカニズム、整合性に使用するSHA-1ハッシング・アルゴリズム、およびAES-128ビット暗号化)を使用して提供されます。アイデンティティは、UsernameToken WS-Security SOAPヘッダーに指定されたユーザー名を使用して設定されます。サブジェクトは、現在構成されているアイデンティティ・ストアに対して確立されます。

- SAMLトークン
次の4つの「SAMLトークン」ポリシーがあります。

- WSS 1.0 SAMLトークン
wss10_saml_token_service_policy

このポリシーでは、WS-Security SOAPヘッダーのSAMLトークンに指定された資格証明を使用することによってユーザーが認証されます。SAMLトークンに指定された資格証明は、SAMLログイン・モジュールに対して認証されます。このポリシーは、SOAPベースのあらゆるエンドポイントに適用できます。

- メッセージ整合性付きWSS 1.0 SAMLトークン
wss10_saml_token_with_message_integrity_service_policy

このポリシーでは、WS-Security 1.0標準に従って、メッセージレベルの整合性保護およびインバウンドSOAPリクエストのSAMLベースの認証が実施されます。このポリシーでは、非対称型キー・テクノロジであるWS-SecurityのBasic128スイート、具体的には、メッセージの整合性に対してSHA-1ハッシング・アルゴリズムが使用されます。

- メッセージ保護付きWSS 1.0 SAMLトークン
wss10_saml_token_with_message_protection_service_policy

このポリシーでは、WS-Security 1.0標準に従って、メッセージレベルの保護およびインバウンドSOAPリクエストのSAMLベースの認証が実施されます。このポリシーでは、非対称型キー・テクノロジであるWS-SecurityのBasic128スイート、具体的には、メッセージの機密保護に対してRSAキー・メカニズム、メッセージの整合性に対してSHA-1ハッシング・アルゴリズム、およびAES-128ビット暗号化が使用されます。

- メッセージ保護付きWSS 1.1 SAMLトークン
wss11_saml_token_with_message_protection_service_policy

このポリシーでは、WS-Security 1.1標準に従って、メッセージレベルの保護(つまり、メッセージの整合性および機密保護)およびインバウンドSOAPリクエストのSAMLベースの認証が実施されます。メッセージは、非対称型キー・テクノロジであるWS-SecurityのBasic128スイート、具体的には、メッセージの機密保護に対してRSAキー・メカニズム、メッセージの整合性に対してSHA-1ハッシング・アルゴリズム、およびAES-128ビット暗号化を使用して保護されます。キーストアの構成は、セキュリティ構成を通じて行われます。それにより、WS-Securityバイナリ・セキュリティ・トークンからSAMLトークンが抽出され、それらの資格証明を使用して、構成済のアイデンティティ・ストアに照らしてユーザーが検証されます。このポリシーは、SOAPベースのあらゆるエンドポイントに添付できます。

キーストアの構成は、セキュリティ構成を通じて行われます。それにより、WS-Securityバイナリ・セキュリティ・トークンからSAMLトークンが抽出され、それらの資格証明を使用して、構成済のアイデンティティ・ストアに照らしてユーザーが検証されます。

ポリシーをプロデューサ・エンドポイントに添付する手順は次のとおりです。

1. Fusion Middleware Controlを開き、ターゲット・ドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「アプリケーションのデプロイ」ノードを開き、ポリシーの添付先のプロデューサをクリックします。

3. 「アプリケーションのデプロイ」メニューから、「Webサービス」を選択します。
このプロデューサの「Webサービスのサマリー」ページが表示されます(図35-1を参照)。

図35-1 「Webサービスのサマリー」ページ

「図35-1 「Webサービスのサマリー」ページ」の説明

4. 「Webサービス・エンドポイント」タブを開き、ポリシーの添付先のエンドポイントをクリックします。

注意:

マークアップ・サービス・ポートのみを保護する必要があります(WSRP_V2_Markup_ServiceおよびWSRP_V1_Markup_Service)。

このプロデューサの「Webサービス・エンドポイント」ページが表示されます(図35-2を参照)。

図35-2 「Webサービス・エンドポイント」ページ

「図35-2 「Webサービス・エンドポイント」ページ」の説明

5. 「ポリシー」タブを開いて、プロデューサに現在添付されているポリシーを表示します(図35-3を参照)。

図35-3 「Webサービス・エンドポイント」の「ポリシー」ページ

「図35-3 「Webサービス・エンドポイント」の「ポリシー」ページ」の説明

6. 「アタッチ/デタッチ」をクリックして、ポリシーを追加または削除します。
使用可能なポリシーとその説明が示された「ポリシーの添付/解除」ページが表示されます(図35-4を参照)。

図35-4 「ポリシーの添付/解除」ページ

「図35-4 「ポリシーの添付/解除」ページ」の説明

7. 「使用可能なポリシー」で、検索するポリシー・カテゴリとしてCategoryおよびSecurityを選択し、「検索」アイコンをクリックすると、セキュリティ・ポリシーが表示されます。

8. 添付するポリシーを選択し、「添付」をクリックします。複数のポリシーを選択するには、[Ctrl]キーを使用します。
「添付されたポリシー」の下のリストにポリシーが表示されます(図35-5を参照)。

図35-5 添付されたポリシーが表示された「ポリシーの添付/解除」ページ

「図35-5 添付されたポリシーが表示された「ポリシーの添付/解除」ページ」の説明

9. プロデューサ・エンドポイントに添付するポリシーの追加が終了したら、「OK」をクリックします。

35.1.3 キーストアの設定

WSRPプロデューサにキーストアを作成および構成する手順は、使用しているWebCenter Portal環境のトポロジによって異なります。これらの手順については、次の各項で説明しています。

- 第34.1項「単純トポロジの場合のWS-Securityの構成」

- 第34.2項「標準トポロジの場合のWS-Securityの構成」

- 第34.3項「複合トポロジの場合のWS-Securityの構成」

キーストアを設定するための詳細な手順およびWSRPプロデューサを構成する際のWS-Securityのその他の側面については、これらの項を参照してください。

35.2 PDK-Javaプロデューサの保護

共有鍵をメッセージの整合性保護のために定義できますが、これはSSLとともに使用する必要があります。共有鍵をパスワード資格証明として格納する手順は次のとおりです。

- 管理サーバー・インスタンスの資格証明ストアに、パスワード資格証明として共有鍵を定義します。これは、Fusion Middleware ControlまたはWLSTを使用して実行できます。

- Webプロデューサを再起動して、テスト・ページにアクセスします。アプリケーション・ログをチェックして、共有鍵が適切に適用されていることを確認します。

注意:

共有鍵の使用では、メッセージの整合性保護のみを実施できます。完全なメッセージ保護には、SSLが必要です。SSLを使用したPDK-Javaポートレット保護の詳細は、第33.5項「SSLを使用したSpacesからポートレット・プロデューサへの接続の保護」を参照してください。

35.2.1 パスワード資格証明としての共有鍵の定義

管理サーバー・インスタンスの資格証明ストアに、Fusion Middleware ControlコマンドまたはWLSTコマンドを使用して、パスワード資格証明として共有鍵を定義できます。

35.2.1.1 Fusion Middleware Controlを使用した共有鍵の定義

Fusion Middleware Controlを使用して共有鍵を定義する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、ターゲット・ドメイン(wc_domainなど)をクリックします。

3. 「WebLogicドメイン」メニューの「セキュリティ」→「資格証明」を選択します。
「資格証明」ペインが表示されます(図35-6を参照)。

図35-6 「資格証明」ペイン

「図35-6 「資格証明」ペイン」の説明

4. 「マップの作成」をクリックし、「マップ名」としてPDKと入力して、「OK」をクリックします。

5. 「キーの作成」をクリックして、作成したマップ(PDK)を選択します。

6. 「ユーザー名」(この値は使用されないため、どのような値でも指定できます)、「キー」(pdk.<service_id>.sharedKeyの形式。<service_id>はプロデューサの名前)および「パスワード」(10から20桁の16進数)に値を入力して、「OK」をクリックします。
「資格証明」ペインに新規共有鍵が表示されます(図35-7を参照)。

図35-7 新規共有鍵が表示された「資格証明」ペイン

「図35-7 新規共有鍵が表示された「資格証明」ペイン」の説明

35.2.1.2 WLSTを使用した共有鍵の定義

WLSTを使用して共有鍵を定義することもできます。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」で説明されているとおりにWLSTを起動し、ターゲット・ドメインの管理サーバー・インスタンスに接続します。

2. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

各要素の意味は次のとおりです。

- user_nameは、管理サーバーへのアクセスに使用されるユーザー・アカウントの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

3. WLST createCredコマンドを使用して、プロデューサの共有鍵資格証明を資格証明ストアに追加します。

createCred(map='PDK', key='pdk.service_id.sharedKey.user_name', user='user_name', password='password')

各要素の意味は次のとおりです。

- service_idは、共有鍵の作成対象のプロデューサの名前です(例: omniPortlet)。

- user_nameは、ユーザーの名前です。この値は使用されないため、どのような値でも指定できます。

- passwordは、10から20桁の16進数値です。

次に例を示します。

createCred(map='PDK', key='pdk.omniPortlet.sharedKey', user='sharedKey', password='1234567890abc')

注意:

資格証明の作成後は、前述のものと同じパラメータを指定したWLST updateCredコマンドを使用して、資格証明を更新できます。

4. プロデューサを再起動します。
Webプロデューサでは、初めてリクエストを処理する際(ブラウザ・テスト・ページ・リクエストやプロデューサの初回登録時など)にプロパティが適用されるため、共有鍵資格証明の設定後にプロデューサを再起動する必要があります。

36 WebCenter Portal管理コンソールの使用

この章では、Frameworkアプリケーションで使用できる実行時管理コンソールについて説明します。Frameworkアプリケーションは、JDeveloperでWebCenter Portal: Frameworkを使用して構築されたポータル・アプリケーションです。

この章の内容は次のとおりです。

- 第36.1項「WebCenter Portal管理コンソールの概要」

- 第36.2項「WebCenter Portal管理コンソールへのアクセス」

- 第36.3項「アプリケーションのデフォルト設定の構成」

- 第36.4項「アプリケーション・メンバーおよびロールの管理」

- 第36.5項「アプリケーション・リソースの管理」

- 第36.6項「サービス、ポートレット・プロデューサおよび外部アプリケーションの管理」

対象読者

この章の内容は、ユーザー、ロールおよびリソースの管理と、Frameworkアプリケーションのデフォルト設定の構成を担当している、Administratorロールを持つユーザーを対象としています。

36.1 WebCenter Portal管理コンソールの概要

Frameworkアプリケーションでは、デフォルトでいくつかの管理ページ(図36-1)が提供されます。認証された管理者は、これらのページを使用して、次のような一般的な管理作業を実行できます。

- アプリケーションレベルのプリファレンスの設定

- ユーザーの管理とアプリケーション・ロールの付与

- アプリケーション・リソースの管理と構成

- コンテンツの管理

- ポートレット・プロデューサの管理と構成

- 外部アプリケーションの管理と構成

- 投票の作成と管理

- アプリケーションの更新の伝播

図36-1 WebCenter Portal管理コンソール

「図36-1 WebCenter Portal管理コンソール」の説明

36.2 WebCenter Portal管理コンソールへのアクセス

Frameworkアプリケーションの管理コンソールにアクセスする手順は、次のとおりです。

1. 管理者としてアプリケーションにログインします。
最初は、システム管理者のみがWebCenter Portal管理コンソールを使用できます。他のユーザーにAdministratorロールを付与する方法の詳細は、第36.4.3.3項「ユーザーへの管理権限の付与」を参照してください。

2. 次のいずれかを実行します。

- 「管理」リンクをクリックします(図36-2)。

図36-2 WebCenter Portal管理コンソール: 「管理」リンク

「図36-2 WebCenter Portal管理コンソール: 「管理」リンク」の説明

- ダイレクトURLを使用して、WebCenter Portal管理コンソールにアクセスします。
デフォルトのダイレクトURLは、次のとおりです。

http://www.server:port/context_root/admin

例: http://mycompany.com:8888/myapp/admin

ただし、アプリケーション開発者は、次のようにweb.xmlエントリを使用してダイレクトURLをカスタマイズできます。

<servlet-mapping>
<servlet-name>PortalAdminServlet</servlet-name>
<url-pattern>/admin</url-pattern>
</servlet-mapping>

WebCenter Portal管理コンソールが表示されます(図36-1を参照)。

36.3 アプリケーションのデフォルト設定の構成

Frameworkアプリケーションは、デプロイ時に様々なデフォルト設定によって事前構成されますが、管理者はWebCenter Portal管理コンソールから、それらの設定をユーザーに合わせてカスタマイズできます。「構成」タブ(図36-3)では、デフォルトのページ・テンプレート、スキン、リソース・カタログおよびナビゲーション・モデルを指定できます。

図36-3 WebCenter Portal管理コンソール: 「構成」タブ

「図36-3 WebCenter Portal管理コンソール: 「構成」タブ」の説明

この項の内容は次のとおりです。

- 第36.3.1項「デフォルト・ページ・テンプレートの選択」

- 第36.3.2項「デフォルト・リソース・カタログの選択」

- 第36.3.3項「デフォルト・ナビゲーションの選択」

- 第36.3.4項「デフォルト・スキンの選択」

- 第36.3.5項「デフォルト・ベース・リソースURLの選択」

36.3.1 デフォルト・ページ・テンプレートの選択

Frameworkアプリケーションでは、ページ・テンプレートによって、どのように個々のページとページ・グループがユーザーの画面に表示されるかが定義されます。どのページも、ページ・テンプレート内に表示されます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のページ・テンプレートの使用に関する項を参照してください。

管理者は、ページの表示に使用するデフォルト・ページ・テンプレートを定義できます。

アプリケーションのデフォルト・ページ・テンプレートを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 表示されたリストから「デフォルト・ページ・テンプレート」を選択します。
選択したテンプレートは、既存のページと新しく作成したすべてのページに適用されます。

注意:

ユーザーがページを作成し、リンクをページ・テンプレートにハードコードした場合、「デフォルト・ページ・テンプレート」の効果はなくなります。

3. 「適用」をクリックします。

36.3.2 デフォルト・リソース・カタログの選択

Frameworkアプリケーションでは、リソース・カタログによって、レイアウト・コンポーネント、タスク・フロー、ポートレット、ドキュメントなど、認可されたユーザーが実行時にアプリケーションに追加できる要素の集合が指定されます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のリソース・カタログの作成と管理に関する項を参照してください。

アプリケーションのデフォルト・リソース・カタログを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 表示されたリストから「デフォルト・リソース・カタログ」を選択します。
選択したカタログは、ユーザーがコンテンツをページやページ・テンプレートなどに追加するときに提供されます。

3. 「適用」をクリックします。

36.3.3 デフォルト・ナビゲーションの選択

ナビゲーションを使用すると、ユーザーはFrameworkアプリケーション内を移動し、必要な情報にすばやくアクセスできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のポータル用ナビゲーション・モデルの構築に関する項を参照してください。

管理者は、${navigationContext.defaultNavigation}へのEL参照が存在するときに使用されるナビゲーションを定義できます。これにより、管理者が一度デフォルト・ナビゲーション・モデルを指定した後、それをシステム全体で変更できるようになります。

アプリケーションのデフォルト・ナビゲーションを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 表示されたリストから「デフォルト・ナビゲーション」を選択します。
選択したナビゲーションは、${navigationContext.defaultNavigation}へのEL参照が存在するときに適用されます。

注意:

ユーザーがナビゲーション・モデルの参照をハードコードした場合(タスク・フローのパラメータ内など)、「デフォルト・ナビゲーション」の効果はなくなります。

3. 「適用」をクリックします。

36.3.4 デフォルト・スキンの選択

アプリケーション管理者は、Frameworkアプリケーションのスキンを変更することによって、そのデフォルトの外観をカスタマイズできます。スキンによって、ユーザー・インタフェースの表示が変更されますが、アプリケーションの動作は変更されません。

デフォルト・スキンを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 表示されたリストから「デフォルト・スキン」を選択します。
選択したスキンが、アプリケーション内のすべてのページに適用されます。

注意:

WebCenter Portal管理コンソールによって使用される内部スキンは変化しないため、管理ページが「デフォルト・スキン」の影響を受けることはありません。

3. 「適用」をクリックします。

36.3.5 デフォルト・ベース・リソースURLの選択

開発者は、EL式を使用して、静的リソースのターゲットURLを動的に生成できます。これを実行する方法の1つは、ベースURLプリファレンスを定義して、リソースを目的のサーバーにリダイレクトすることです。この方法を使用する場合、EL式の形式は次のようになります。

<af:image source="#{preferenceBean.baseResourceURL}/images/globe.png"/>

管理者は、実行時に管理コンソール内でベースURLを構成できます。

デフォルト・ベース・リソースURLを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「ベース・リソースURL」フィールドに、静的リソースに使用するサーバーの詳細を、次の形式に従って入力します。

protocol://serverName:serverPortcontextPath

次に例を示します。

http://myserver.com:7101/myFolder

ヒント:

有効なサーバーに解決されるEL式を使用することもできます。たとえば、デフォルトの設定は次のとおりです。

#{request.scheme}://#{request.serverName}:#{request.serverPort}#{request.contextPath}

36.4 アプリケーション・メンバーおよびロールの管理

Administratorロールを付与されたユーザーは、WebCenter Portal管理コンソールを通じて、アプリケーション・メンバーおよびロールを管理できます。「セキュリティ」タブ(図36-4)では、メンバーの追加、ロールの定義、権限とロールの付与と取消し、およびメンバーの削除を実行できます。

図36-4 WebCenter Portal管理コンソール: 「セキュリティ」タブ

「図36-4 WebCenter Portal管理コンソール: 「セキュリティ」タブ」の説明

この項の内容は次のとおりです。

- 第36.4.1項「ユーザーの概要」

- 第36.4.2項「アプリケーション・ロールおよび権限の概要」

- 第36.4.3項「ユーザーの管理」

- 第36.4.4項「アプリケーション・ロールおよび権限の管理」

注意:

「セキュリティ」タブには、「ロール・マネージャ」タスク・フローが表示されます。このタスク・フローは、任意のFrameworkアプリケーションに個別に追加できます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のロール・マネージャ・タスク・フローの使用に関する項を参照してください。

36.4.1 ユーザーの概要

Frameworkアプリケーションの各ユーザーには、既存のアイデンティティ・ストアから直接プロビジョニングされたログイン・アカウントが必要です。最初は、Fusion Middleware管理者(デフォルトではweblogic)のみがログインでき、このデフォルト・ユーザーにAdministratorロールを通じて(表36-1を参照)すべての管理権限が付与されます。

Fusion Middleware管理者は、アイデンティティ・ストア内の個々のユーザーとユーザー・グループをWebCenter Portalのメンバーにし、各メンバーに適切なアプリケーション・ロールを割り当てる必要があります。デフォルトおよびカスタム・アプリケーション・ロールについては、第36.4.2.1項「アプリケーション・ロールの概要」を参照してください。

Fusion Middleware管理者は、1人以上の別のユーザーにアプリケーションのAdministratorロールを割り当て、それらのユーザーにこの職責を委任することもできます。

表36-1 Frameworkアプリケーションのデフォルト管理者

ユーザー

説明

Fusion Middleware管理者(weblogic)

WebCenterドメイン全体の管理者です。このユーザーは、ドメイン内の任意のアプリケーションを管理できます。

36.4.2 アプリケーション・ロールおよび権限の概要

アプリケーション・ロールは、Frameworkアプリケーション内のリソースとサービスへのユーザーのアクセス・レベルを制御します。この項では、アプリケーション・ロールおよび権限について説明します。この項の内容は次のとおりです。

- 第36.4.2.1項「アプリケーション・ロールの概要」

- 第36.4.2.2項「アプリケーション権限の概要」

36.4.2.1 アプリケーション・ロールの概要

アプリケーション・ロールの割当ては、アプリケーション管理者の職責です。管理者は、メンバーにデフォルトのアプリケーション・ロールを割り当てるか、アプリケーションに固有のカスタム・ロールを追加で作成できます。詳細は、次を参照してください。

- 第36.4.2.1.1項「デフォルトのアプリケーション・ロール」

- 第36.4.2.1.2項「カスタム・アプリケーション・ロール」

- 第36.4.2.2.1項「アプリケーション権限」

- 第36.4.2.2.2項「ディスカッション・サーバーのロール・マッピング」

- 第36.4.2.2.3項「エンタープライズ・グループのロール・マッピングの概要」

Frameworkアプリケーション内で定義されたアプリケーション・ロールおよび権限は、そのアプリケーションのポリシー・ストアに格納されるため、適用範囲はそのアプリケーションに限定され、WebCenter Portalドメインまたはその他のドメイン内の権限には関与しません。エンタープライズ・ロールはこれとは異なり、アプリケーションのアイデンティティ・ストアに格納されるため、そのアプリケーション内の権限には関与しません。

36.4.2.1.1 デフォルトのアプリケーション・ロール

Frameworkアプリケーションには、削除できないデフォルトのアプリケーション・ロールがあります(表36-2)。

表36-2 Frameworkアプリケーションのデフォルトのロール

アプリケーション・ロール

説明

Administrator

Administratorロールを持つユーザーは、アプリケーション全体のプリファレンスの設定、リソースの管理、コンテンツ・リポジトリの構成、投票の作成、およびプロデューサと外部アプリケーションの登録を実行できます。

また、管理者はアプリケーションのユーザーとロールの管理、および他のユーザーへの権限の委任または権限の取消しを実行することもできます。

最初は、Administratorsエンタープライズ・グループが、Administratorロールを通じてすべての管理権限を割り当てられる唯一のメンバーになります。つまり、Administratorsグループのユーザーに、Frameworkアプリケーションのすべての管理権限が割り当てられます。

AppConnectionManager

このロールを持つユーザーは、対応するタスク・フローを通じて、ポートレット・プロデューサと外部アプリケーションを管理(作成、更新および削除)できます。

最初は、Administratorロールを持つユーザーのみが、AppConnectionManagerロールのメンバーになります。

AppConnectionViewer

このロールを持つユーザーは、対応するタスク・フローを通じて、ポートレット・プロデューサと外部アプリケーションを表示できます。

最初は、ログインした(authenticated-roleを持つ)すべてのユーザーがAppConnectionViewerロールのメンバーになります。

AppConnectionViewerロールには権限が直接付与されないため、authenticated-roleに付与されるすべての権限がこのロールのメンバーにも付与されます。

authenticated-role

認証されたユーザーには、標準OPSS (Oracle Platform Security Services)ロールのauthenticated-roleが付与されます。

anonymous-role

アプリケーションにアクセスできるが、ログインしていないユーザーには、標準OPSS (Oracle Platform Security Services)アプリケーション・ロールのanonymous-roleが付与されます。これらは匿名の識別できないユーザーであり、パブリック・コンテンツのみを参照できます。

36.4.2.1.2 カスタム・アプリケーション・ロール

カスタム・アプリケーション・ロール(ユーザー定義ロールとも呼ばれます)は、使用するFrameworkアプリケーションに固有のロールです。必須のアプリケーション・ロールの識別、適切なロール名の選択および各ロールの職責の定義は、アプリケーションを設定する際に管理者が行う仕事です。

たとえば、教育環境では、先生、生徒、来賓などのロールが必要になります。一方、企業環境では、経理、営業、人事、サポートなどが適切なロールとなります。

ユーザーのアプリケーション・ロールの設定方法は、第36.4.4.1項「アプリケーション・ロールの定義」を参照してください。

36.4.2.2 アプリケーション権限の概要

すべてのアプリケーション・ロールには、権限と呼ばれる特定の定義済の権利があります。これらの権限により、各ユーザーは、アプリケーション内で特定のアクションを実行できます。他の権限からその内容を継承する権限はありません。

この項の内容は次のとおりです。

- 第36.4.2.2.1項「アプリケーション権限」

- 第36.4.2.2.2項「ディスカッション・サーバーのロール・マッピング」

- 第36.4.2.2.3項「エンタープライズ・グループのロール・マッピングの概要」

36.4.2.2.1 アプリケーション権限

権限には、次のようなカテゴリがあります。表36-3に、各カテゴリのリストがあります。

- アプリケーション

- マッシュアップ・スタイル

- コンテンツ・プレゼンタ・テンプレート

- スキン

- タスク・フロー

- リソース・カタログ

- ページ・スタイル

- データ・コントロール

- ナビゲーション

- ページ・テンプレート

- ページ

- リンク

- リスト

- ピープル・コネクション

「管理」を除くすべての権限は、他の権限からその内容を継承しません。

表36-3 Frameworkアプリケーションのアプリケーション権限

カテゴリ

アプリケーション権限

アプリケーション

管理: すべての「WebCenter Spaces管理」ページ(「リソース」、「サービス」、「セキュリティ」、「構成」および「伝播」)へのアクセス。ユーザーはこれらのページを通じて、アプリケーション・セキュリティ(ユーザーやロール)の管理、アプリケーション全体のプロパティとサービスの構成、アプリケーション・リソースの管理、ページの作成と管理、およびアプリケーションの変更の伝播を実行できます。

構成: ユーザーによる、「構成」タブへの操作の表示とそれらの実行。

伝播: ユーザーによる、「伝播」タブへの操作の表示とそれらの実行。

マッシュアップ・スタイル

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、アプリケーションのマッシュアップ・スタイルの作成、編集および削除。

作成: アプリケーションのマッシュアップ・スタイルの作成。

編集: マッシュアップ・スタイルの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

コンテンツ・プレゼンタ・テンプレート

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、アプリケーションのコンテンツ表示テンプレートの作成、編集および削除。

作成: アプリケーションのコンテンツ表示テンプレートの作成。

編集: アプリケーションレベルのコンテンツ表示テンプレートの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

スキン

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、スキンの作成、編集および削除。

作成: アプリケーションのスキンの作成。

編集: スキンの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

タスク・フロー

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、マッシュアップ・スタイルに基づくタスク・フローの作成、編集および削除。

作成: アプリケーションのタスク・フローの作成。

編集: タスク・フローの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

リソース・カタログ

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、アプリケーションのリソース・カタログの作成、編集および削除。

作成: アプリケーションのリソース・カタログの作成。

編集: リソース・カタログの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

ページ・スタイル

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、ページ・スタイルの作成、編集および削除。

作成: アプリケーションのページ・スタイルの作成。

編集: ページ・スタイルの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

データ・コントロール

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、アプリケーションのデータ・コントロールの作成、編集および削除。

作成: アプリケーションのデータ・コントロールの作成。

編集: データ・コントロールの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

ナビゲーション

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、アプリケーションのナビゲーションの作成、編集および削除。

作成: アプリケーションのナビゲーションの作成。

編集: ナビゲーションの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

ページ・テンプレート

作成、編集および削除: WebCenter Portal管理コンソール(「リソース」タブ)を使用した、ページ・テンプレートの作成、編集および削除。

作成: アプリケーションのページ・テンプレートの作成。

編集: ページ・テンプレートの編集。

第36章「アプリケーション・リソースの管理」も参照してください。

ページ・サービス

ページ・アクセス権の付与: ページのセキュリティの管理。

編集: ページ・コンテンツの追加または編集、コンテンツの再配置、およびページ・パラメータとページ・プロパティの設定。

カスタマイズ: すべてのユーザーを対象としたページのカスタマイズ。

パーソナライズ: コンテンツの追加、編集または削除による、ページの表示のパーソナライズ。

表示: ページの表示。

リンク

作成および削除: オブジェクト間のリンクの作成と削除、およびリンク権限の管理。

削除: 2つのオブジェクト間のリンクの削除。

作成: オブジェクト間のリンクの作成。

リスト

作成、編集および削除: リストとリスト・データの作成、編集および削除。

リストの作成: リストの作成。

リストの編集: リスト列定義の編集。

リストの削除: 任意のリストの削除。

リスト・データの編集: リスト・データの追加、編集および削除。

リストの表示: リストとリスト・データの表示。

ピープル・コネクション

ピープル・コネクションの管理: ピープル・コネクション・サービスを対象としたアプリケーション全体の設定の管理。

ピープル・コネクション・データの更新: ピープル・コネクション・サービスに関連付けられたコンテンツの編集。

人とのコネクション: ピープル・コネクション・サービスに関連付けられたコンテンツの他のユーザーとの共有。

36.4.2.2.2 ディスカッション・サーバーのロール・マッピング

リモート(バックエンド)・リソースへのアクセスが必要なWebCenter Portalサービスでも、ロール・マッピング・ベースの認可が必要になります。つまり、Frameworkアプリケーション内でディスカッション・サービスを使用できるロールは、WebCenter Portalディスカッション・サーバー上の対応するロールにマップされている必要があります。

Frameworkアプリケーションは、アプリケーション・ロールを使用して、アプリケーション内のユーザー権限を管理します。ディスカッション・サーバーでは、異なるロールと権限のセットが適用されます。

Frameworkアプリケーション内でDiscussions-Create Edit Delete権限を割り当てられたユーザーは、自動的にディスカッション・サーバーに追加され、Category Admin権限を持つAdministratorロールを(ディスカッション・サーバー上で)割り当てられます。Frameworkアプリケーションでは、AdministratorロールにデフォルトでDiscussions-Create Edit Delete権限が割り当てられます(表36-4)。

表36-4 ディスカッション・サーバーのロールと権限

ディスカッション・サーバーのロール

ディスカッション・サーバーの権限

Frameworkアプリケーション
同等のアプリケーション権限

Administrator

Category Admin

Discussions-Create, Edit, and Delete

権限が付与されたカテゴリ内のサブ・カテゴリ、フォーラムおよびトピックの作成、読取り、更新および削除。

36.4.2.2.3 エンタープライズ・グループのロール・マッピングの概要

同じエンタープライズ・グループに属する個々のユーザーまたは複数のユーザーに、Frameworkアプリケーション・ロールを割り当てることができます。バックエンドのアイデンティティ・ストアにおける、その後のエンタープライズ・グループの更新内容は、自動的にFrameworkアプリケーションに反映されます。まず、エンタープライズ・グループにFrameworkアプリケーション・ロールを割り当てると、そのエンタープライズ・グループに属するすべてのユーザーに同じロールが割り当てられます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

Frameworkアプリケーションで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーおよびコンテント・サーバーなどのバックエンド・サーバーもエンタープライズ・グループをサポートする必要があります。このリリースで提供されるWebCenter Portalディスカッション・サーバーとWebCenter Contentコンテンツ・サーバーのバージョンでは、エンタープライズ・グループがサポートされますが、以前のバージョンではサポートされない場合があります。

36.4.3 ユーザーの管理

管理者は、すべてのアプリケーション・ユーザーに適切な権限を割り当てる必要があります。ユーザーが権限を得るには、適切なアプリケーション・ロールを通じて、そのユーザーにアプリケーションのメンバーシップを付与する必要があります。

この項では、メンバーを追加してロールを割り当てる方法を説明します。内容は次のとおりです。

- 第36.4.3.1項「アプリケーション・ロールへのメンバーの追加」

- 第36.4.3.2項「ユーザーへの異なるロールの割当て」

- 第36.4.3.3項「ユーザーへの管理権限の付与」

- 第36.4.3.4項「アプリケーション・ロールの取消し」

- 第36.4.3.5項「ユーザーの追加または削除」

36.4.3.1 アプリケーション・ロールへのメンバーの追加

同じエンタープライズ・グループに属する個々のユーザーまたは複数のユーザーにメンバーシップを付与するには、「セキュリティ」タブを使用します。メンバーシップの対象となるのは、アイデンティティ・ストア内で定義された任意のユーザーまたはグループです。第29.4項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」も参照してください。

新規ユーザーやエンタープライズ・グループから除外されたユーザーなど、バックエンド・アイデンティティ・ストアの更新内容は、自動的にFrameworkアプリケーションに反映されます。まず、エンタープライズ・グループにアプリケーション・ロールを割り当てると、そのグループに属するすべてのユーザーに同じロールが割り当てられます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

注意:

Frameworkアプリケーションで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーおよびコンテント・サーバーなどのバックエンド・サーバーもエンタープライズ・グループをサポートする必要があります。WebCenter Portal 11.1.1.2.0以降で提供されるWebCenter Portalのディスカッション・サーバーとOracle WebCenter Contentではエンタープライズ・グループがサポートされますが、それ以前のバージョンではサポートされない場合があります。

適切なアプリケーション・ロールを通じてユーザーにメンバーシップを付与する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「ロール名」ペインで、ユーザーに割り当てるロールを選択します。
選択したロールをすでに割り当てられているメンバーのリストが右側(「メンバー」ペイン内)に表示されます。

アプリケーションのすべての管理権限を割り当てる場合にのみ、「管理者」を選択します。必要なロールがリストにない場合は、要件を満たす新規ロールを作成します(第36.4.4.1項「アプリケーション・ロールの定義」を参照)。

3. 「ユーザーの追加」、「グループの追加」または「ロールの追加」をクリックします(図36-5)。
ユーザーの追加: 個々のユーザーへのメンバーシップの付与

グループの追加: ユーザー・グループに属するすべてのユーザーへのメンバーシップの付与

ロールの追加: 特定のアプリケーション・ロールを割り当てられたすべてのユーザーへのメンバーシップの付与

図36-5 WebCenter Portal管理コンソール: メンバーの追加

「図36-5 WebCenter Portal管理コンソール: メンバーの追加」の説明

4. ユーザー、グループまたはアプリケーション・ロールの正確な名前がわかっている場合は、検索ボックス(「ユーザーの追加」、「グループの追加」または「ロールの追加」)にその名前を入力し、矢印アイコンをクリックします。正確な名前がわからない場合は、次のように名前の一部を使用して、アイデンティティ・ストア内を検索できます(図36-6を参照)。

図36-6 「ユーザーの追加」ペイン: ユーザーの検索

5. 選択したロールを割り当てるユーザー、グループまたはロールを選択し、「{0}に追加」をクリックします。複数の名前を選択するには、[Ctrl]キーを使用します。

注意:

直接、間接を問わず、ユーザー、グループまたはロールがすでにロールを保持している場合、ロールを割り当てることはできません。周期的なロールの割当ては許可されません。

新規メンバーが「メンバー」ペインに表示されます(図36-7を参照)。

図36-7 WebCenter Portal管理コンソール: 「メンバー」ペイン

「図36-7 WebCenter Portal管理コンソール: 「メンバー」ペイン」の説明

6. 完了したら、「完了」をクリックします。

36.4.3.2 ユーザーへの異なるロールの割当て

Frameworkアプリケーションのユーザー・ロールは、変更されることがあります。たとえば、ユーザーが営業から経理部門に異動になった場合、ユーザーのロール割当ては「営業」から「経理」に変更されます。ユーザーのロールを変更するには、まずユーザーの以前のロールのメンバーシップを取り消した後、そのユーザーを新しいロールに追加します。詳細は、第36.4.3.4項「アプリケーション・ロールの取消し」と第36.4.3.1項「アプリケーション・ロールへのメンバーの追加」を参照してください。

注意:

自分のロールまたはFusion Middleware管理者のロールは、変更できません。第36.4.2.1項「アプリケーション・ロールの概要」を参照してください。

36.4.3.3 ユーザーへの管理権限の付与

Administratorロールを使用すると、Frameworkアプリケーションのすべての管理権限を簡単にユーザーに付与できます。管理者は最高レベルの権限を持ち、アプリケーションのすべてを表示および変更できるため、Administratorロールの割当ては慎重に行います。

ユーザーとロールの管理など、ほとんどの管理タスクはAdministratorロールにのみ許可されています。第36.4.2.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

36.4.3.4 アプリケーション・ロールの取消し

該当しないアプリケーション・ロール割当てを取り消すのは簡単です。ただし、ユーザーのアプリケーション・ロールをすべて取り消しても、そのユーザーはアイデンティティ・ストアから削除されません。

注意:

自分のロール割当てまたはFusion Middleware管理者のロールを取り消すことはできません。第36.4.2項「アプリケーション・ロールおよび権限の概要」を参照してください。

アプリケーション・ロールを取り消す手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「ロール名」ペインからロールを選択します。

3. 「メンバー」リストからユーザー、グループまたはアプリケーション・ロールを選択します。

4. 「メンバーの削除」をクリックします。

5. プロンプトが表示されたら、「削除」をクリックしてユーザーのロールを取り消します。

36.4.3.5 ユーザーの追加または削除

管理者は、Frameworkアプリケーションのアイデンティティ・ストアで直接新しいユーザー・データの追加またはユーザー資格証明の削除を実行できません。アイデンティティ・ストアの管理はシステム管理者の職責であり、WLS管理コンソールを通じて実行するか、組込みLDAPアイデンティティ・ストアに対し、LDAPコマンドを使用して直接実行します。第29.4項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」も参照してください。

36.4.4 アプリケーション・ロールおよび権限の管理

Frameworkアプリケーションは、アプリケーション・ロールを使用して、アプリケーション内のユーザーの権限を管理します。この項では、「セキュリティ」管理ページ(図36-8)からアプリケーション・ロールとその権限を管理する方法を説明します。

図36-8 WebCenter Portal管理コンソール: 「セキュリティ」タブ

Frameworkアプリケーションでは、デフォルトのアプリケーション・ロールがいくつか提供されます。デフォルトのアプリケーション・ロールは削除できませんが、各ロールのデフォルトの権限割当てを変更できます。詳細は、第36.4.2項「アプリケーション・ロールおよび権限の概要」を参照してください。

この項の内容は次のとおりです。

- 第36.4.4.1項「アプリケーション・ロールの定義」

- 第36.4.4.2項「アプリケーション・ロールの権限の変更」

- 第36.4.4.3項「認証されていないユーザーへのロールの付与または削除」

- 第36.4.4.4項「認証されているすべてのユーザーへのロールの付与」

- 第36.4.4.5項「アプリケーション・ロールの削除」

36.4.4.1 アプリケーション・ロールの定義

ロールを使用してアプリケーション・ユーザーのグループの特性を示し、Frameworkアプリケーションでユーザーが何を表示でき、どのような操作を実行できるかを決定します。

アプリケーション・ロールを定義する際には、自己記述的なロール名を使用し、ロール・ポリシーは可能なかぎり簡単なものにします。最小限のロールを選択し、効果的なポリシーを維持します。

新規のロールに対する権限の割当ては、適切なアクセス権を割り当てるように注意します。ロールに必要のない追加のアクションをユーザーが実行できないようにすると同時に、必要なアクティビティの実行までも不注意に制限しないようにします。場合によっては、ユーザーが複数のロールに該当することもあります。

新規のアプリケーション・ロールを定義する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「ロール名」ペインの上にある追加アイコン(プラス記号)をクリックします。
「ロールの作成」ダイアログが表示されます(図36-9)。

図36-9 WebCenter Portal管理コンソール: 「ロールの作成」ダイアログ

「図36-9 WebCenter Portal管理コンソール: 「ロールの作成」ダイアログ」の説明

3. 新規ロールの名前と説明を入力し、「ロールの作成」をクリックします。
自己記述的なロール名を付けます。どのユーザーがどのロールに所属するかを可能なかぎり明白にします。ロール名には、英数字、空白、@およびアンダースコアを使用できます。

新規ロールが「ロール」ペインにリストされます(図36-10)。

図36-10 WebCenter Portal管理コンソール: 「ロール」ペイン

「図36-10 WebCenter Portal管理コンソール: 「ロール」ペイン」の説明

4. 第36.4.4.2項「アプリケーション・ロールの権限の変更」の説明に従って、ロールのユーザー権限を定義します。

36.4.4.2 アプリケーション・ロールの権限の変更

新規ロールの作成後に権限を設定する必要がありますが、管理者はアプリケーション・ロールに関連付けられた権限をいつでも変更できます。

アプリケーション・ロールの権限により、各ユーザーは、アプリケーション内で特定のアクションを実行できます。アプリケーション権限については、第36.4.2項「アプリケーション・ロールおよび権限の概要」を参照してください。

ロールに関連付けられた権限を変更する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 権限を表示または変更するロールを選択し、編集アイコン(鉛筆)をクリックします。
「ロールの編集」ダイアログに、ロールの現在の権限が表示されます(図36-11)。

図36-11 WebCenter Portal管理コンソール: 「ロールの編集」ダイアログ

「図36-11 WebCenter Portal管理コンソール: 「ロールの編集」ダイアログ」の説明

3. 権限のチェック・ボックスを選択または選択解除して、ロールの権限を有効または無効にします。

4. 「適用」をクリックして保存するか、「OK」をクリックして保存および終了します。

新しい権限は即時有効になります。

36.4.4.3 認証されていないユーザーへのロールの付与または削除

Frameworkアプリケーションにログインしていないユーザーには、anonymous-roleが割り当てられます。最初は、anonymous-roleを持つユーザーに権限は付与されず、それらのユーザーは、ログイン・ページやランディング・ページなどのパブリック・アプリケーション・ページ、および個々のユーザーがパブリックにすることを選択したコンテンツのみを表示できます。

注意:

anonymous-roleに権限を付与する際は、注意が必要です。管理権限や、不要と思われる権限は付与しないようにしてください。セキュリティ上の理由から、ユーザーがアプリケーション内で表示できる内容と実行できる操作を制限することをお薦めします。アプリケーションへのパブリックまたは匿名アクセスを提供していない場合は、現在anonymous-roleに付与されている権限をすべて削除するか、それらをauthenticated-roleに移行する必要があります。

アプリケーション・ロールをパブリック・ユーザーに付与する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 認証されていないユーザーに適した権限を付与するロールをまだ定義していない場合は、その作業を実行します。
第36.4.4.1項「アプリケーション・ロールの定義」も参照してください。

3. 認証されていないユーザーに適した権限を定義するロールを選択します。

4. 「パブリック・アクセス用の匿名ロールの追加」をクリックします(図36-12)。(anonymous-roleがすでに追加されており、そのロールを削除する必要がある場合は、「削除」をクリックします。)

図36-12 WebCenter Portal管理コンソール: パブリック・アクセスの追加

anonymous-roleが「メンバー」リストに追加されます(図36-13)。

図36-13 WebCenter Portal管理コンソール: パブリック・アクセスの追加

36.4.4.4 認証されているすべてのユーザーへのロールの付与

Frameworkアプリケーションにログインしたユーザーには、authenticated-roleが割り当てられます。

その他の重要な注意事項:

- authenticated-roleは、常に権限をanonymous-roleから継承します。

- すべてのカスタム・アプリケーション・ロールは、権限をauthenticated-roleから継承します。

36.4.4.5 アプリケーション・ロールの削除

アプリケーション・ロールは、不要になった時点でアプリケーションから削除する必要があります。これにより、有効なロール・リストを維持し、不適切なロール割当てを防止できます。ただし、直接、間接を問わず、自分に割り当てられたロールは削除できません。

アプリケーション・ロールは、それらがまだユーザーに割り当てられている場合でも削除されます。

注意:

デフォルトのロールAdministrator、AppConnectionManager、AppConnectionViewer、authenticated-roleおよびanonymous-roleは削除できません。第36.4.2.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

デフォルトのロールは削除できないため、アプリケーション・ユーザーは、他のアプリケーション・ロールがすべて取り消された場合でも、authenticated-roleを通じてログインできます。

アプリケーション・ロールを削除する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. ロールのリストから削除するロールを選択し、削除アイコン(x)をクリックします。

3. 図36-14 アプリケーション・ロールの削除

4. プロンプトが表示されたら、「削除」をクリックしてロールの削除を確認します。
ロールが表から削除されます。このロールのみを割り当てられたユーザーは、引き続きauthenticated-userロールを通じてログインできます。

36.5 アプリケーション・リソースの管理

WebCenter Portal管理コンソールの「リソース」ページを使用すると、アプリケーション・リソースを管理できます(図36-15)。アプリケーション・リソースには、ページ、ページ・テンプレート、ナビゲーション、リソース・カタログ、スキン、ページ・スタイル、コンテンツ・プレゼンタ・テンプレート、マッシュアップ・スタイル、データ・コントロールおよびタスク・フローがあります。実行できるタスクには、アプリケーション・リソースの作成、編集、コピー、公開、アップロード、ダウンロードなどがあります。各リソースの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリソースの概要に関する項を参照してください。

図36-15 WebCenter Portal管理コンソール: 「リソース」ページ

「図36-15 WebCenter Portal管理コンソール: 「リソース」ページ」の説明

この項の内容は次のとおりです。

- 第36.5.1項「ページの使用」

- 第36.5.2項「リソースの作成」

- 第36.5.3項「リソースのコピー」

- 第36.5.4項「リソースの編集」

- 第36.5.5項「リソースのプロパティの設定」

- 第36.5.6項「リソースの表示と非表示」

- 第36.5.7項「リソース・セキュリティの設定」

- 第36.5.8項「リソースのダウンロードとアップロード」

- 第36.5.9項「リソースのプレビュー」

- 第36.5.10項「リソースの削除」

36.5.1 ページの使用

実行時には、アプリケーション・ページを作成および管理できます。

この項の内容は次のとおりです。

- 第36.5.1.1項「ページの作成」

- 第36.5.1.2項「サブページの作成」

- 第36.5.1.3項「ページのアクセス権限の設定」

- 第36.5.1.4項「ページの並替え」

- 第36.5.1.5項「ページ階層内のページの移動」

- 第36.5.1.6項「ページ名の変更」

ページの編集、コピーまたは削除については、この章の後半に記載されている、リソースに関する一般的な手順を参照してください。

36.5.1.1 ページの作成

実行時にアプリケーション・ページを作成する手順は、次のとおりです。

1. WebCenter Portal管理コンソールの「リソース」タブを開きます。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. メニュー・バーの「ページの作成」をクリックします。

4. 「ページの作成」ダイアログの「ページ名」フィールドに、ページの名前を入力します。

5. 「ページ・テンプレート」リストから、ページのベースにするページ・テンプレートを選択します。

注意:

ページ・テンプレートを指定しなかった場合、デフォルトのテンプレートが使用されます。デフォルトのテンプレートを上書きしない場合は、「ページ・テンプレート」リストを空白にしておくことをお薦めします。

6. 「ページ・スタイル」リストから、ページに使用するスタイルを選択します。
ページ・スタイルの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページ・スタイルに関する必要な知識に関する項を参照してください。

図36-16 ページの作成

「図36-16 ページの作成」の説明

7. 「作成」をクリックします。
新しく作成したページが「リソース」ページにリストされます。このページは、ページの「アクション」メニューで提供されるオプションを使用して管理できます(図36-17)。

図36-17 ページの「アクション」メニュー

「図36-17 ページの「アクション」メニュー」の説明

36.5.1.2 サブページの作成

サブページの作成手順は、第36.5.1.1項「ページの作成」で説明したメイン・ページの作成手順に似ています。「リソース」ページで、サブページを作成するページの隣にある「作成」をクリックする必要があります(図36-18)。デフォルトでは、サブページはその親ページのセキュリティを継承します。

図36-18 サブページの作成

「図36-18 サブページの作成」の説明

36.5.1.3 ページのアクセス権限の設定

すべてのアプリケーション・ページはルート・ノードの下にあり、デフォルトでそのルート・ノード用に定義された権限を継承します。ルート・ノード用のカスタム権限を定義することもできます。また、ルート・ノードのデフォルトの権限を上書きし、個々のページ用のカスタム権限を指定することもできます。デフォルトでは、サブページはその親ページのセキュリティを継承します。

ページのアクセス権限の設定時に、アクセス方法を「セキュリティの委譲」または「親のセキュリティの継承」から選択できます(図36-19)。

図36-19 ページのアクセス権限の設定

「図36-19 ページのアクセス権限の設定」の説明

次のいずれかを選択します。

- セキュリティの委譲: ページを管理および更新できるユーザーを定義する場合に選択します。このオプションを選択すると、ページが現在その親から継承しているすべての権限がダイアログに表示されます。これは実質的には、ページに適用される現在のセキュリティ・ポリシーを示しています。新しい権限付与の追加や既存の権限付与の削除によって、権限付与を調整することもできます。

- 親のセキュリティの継承: ページの親ノード用に定義された権限を継承する場合に選択します。このオプションを設定すると、ページ上で定義されたセキュリティ権限はすべて削除され、親ノードのセキュリティ設定が有効になります。

ページの次の権限アクションを定義できます。

- 管理: 他のすべてのページ権限を付与します。通常は、スーパー管理者のアクセス・タイプを指定するために使用します。この権限アクションは、ルート・ノードでアクセスを定義するときにのみ使用できます。

- 付与: 自分と同様のアクセス権を他のユーザー、グループまたはロールに付与することをユーザーに許可します。たとえば、ユーザーが「付与」および「編集」権限を保持している場合、そのユーザーはこれら2つのアクションの実行権限のみを付与でき、「削除」や「パーソナライズ」など、他の権限を付与することはできません。

- 作成: 現在のページの下にサブページを作成することをユーザーに許可します。

- 削除: ページをそのすべてのサブページとともに削除することをユーザーに許可します。

- 編集: ページの編集をユーザーに許可します。

- パーソナライズ: ページのパーソナライズをユーザーに許可します。

- 表示: ページの表示をユーザーに許可します。

すべての権限は、委任または包含という2つの権限モデルのいずれかに従います。委任モデルが適用されるのは、エンティティに特定の権限アクションが許可されているかどうかを評価する唯一の基準が、そのエンティティにページの特定の権限が付与されたかどうかである場合です。「表示」以外の権限アクションは、すべてこのカテゴリに分類されます。権限が包含タイプになるのは、エンティティに付与されたページの権限が、セキュリティを定義する、上の階層のすべてのノードにも付与されている場合です。「表示」権限アクションのみが、このカテゴリに分類されます。

このため、ページを表示するには、その特定のページと、ルート・ノードまで続くその上の階層に含まれるすべてのノードで「表示」権限アクションが許可されている必要があります。ページ階層の中間ノードで「表示」権限が付与されていない場合、その特定のページは表示できません。他の権限アクション(削除や編集など)は、そのページの該当する権限が付与されていれば実行できます。

この項の内容は次のとおりです。

- 第36.5.1.3.1項「個々のページの権限の設定」

- 第36.5.1.3.2項「ルート・ノードの権限の設定」

36.5.1.3.1 個々のページの権限の設定

特定のページの権限を設定するには:

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. ページのリストから、必要なページの「アクション」メニューを開き、「アクセスの設定」を選択します。

図36-20 ページのアクセス権限の設定

「図36-20 ページのアクセス権限の設定」の説明

4. 「ページのアクセス権限の設定」ダイアログで、アクセス方法を選択します(図36-21)。

- セキュリティの委譲: 階層内のこのページ・ノード、およびその子の中でセキュリティが上書きされていないノードを管理および更新できるユーザーを定義する場合、この方法を選択します。この方法を選択すると、使用可能なデフォルトの権限が表示されます。新しい権限の追加や既存の権限の削除によって、権限を調整することもできます。
このオプションを選択した場合、手順5に進みます。

- 親のセキュリティの継承: ページの親ノード用に定義された権限を継承する場合、この方法を選択します。この方法を選択した場合、「OK」をクリックして変更を保存し、ダイアログを終了します。

図36-21 ページのアクセス権限の設定

「図36-21 ページのアクセス権限の設定」の説明

5. 「セキュリティの委譲」を選択した場合、ページへのアクセス権限を付与するユーザー、グループまたはロールを指定します。

- アイデンティティ・ストアに含まれる個々のユーザーを検索および選択するには、「ユーザーの追加」をクリックします。必要なユーザーを選択し、「OK」をクリックします。

- アイデンティティ・ストアに含まれるユーザーのグループを検索および選択するには、「グループの追加」をクリックします。必要なグループを選択し、「OK」をクリックします。

- ページへのアクセス権限を付与するアプリケーション・ロールを検索および選択するには、「ロールの追加」をクリックします。必要なロールを選択し、「OK」をクリックします。

6. 「ロールまたはユーザー」列にリストされているユーザー、グループまたはロールごとに、付与するアクセス・レベルを指定します。付与できる権限は、「付与」、「作成」、「削除」、「編集」、「パーソナライズ」および「表示」です。

7. オプションで、「ログイン・ユーザー・アクセス用の認証ロールの追加」アイコンをクリックしてauthenticated-roleを追加し、認証されたすべてのユーザーのアクセス権限を定義できます。anonymous-roleを追加し、必要な権限をすべてのユーザーに付与するには、「パブリック・アクセス用の匿名ロールの追加」アイコンをクリックします。

8. 任意のユーザー、グループまたはロールの権限を取り消す場合は、そのエンティティを選択し、「アクセス権限の削除」をクリックします。

9. 「OK」をクリックして、ページのセキュリティ設定を保存します。
ページの「アクセス」列に表示される鍵アイコンは、そのページのアクセス方法として「セキュリティの委譲」が設定されていることを示し、矢印アイコンは、そのページのアクセス方法として「親のセキュリティの継承」が設定されていることを示しています(図36-22)。

図36-22 ページに指定されたアクセス方法

「図36-22 ページに指定されたアクセス方法」の説明

36.5.1.3.2 ルート・ノードの権限の設定

セキュリティが上書きされていないページ・ノードとサブページ・ノードのアクセス設定は、ルート・ノードから導出されます。ルート・ノードの権限を定義するには、「リソース」タブの「ページ」ページにある「デフォルト・アクセスの設定」オプションを使用します(図36-23)。残りの手順は、特定のページの権限を設定する手順と同じです。詳細は、第36.5.1.3.1項「個々のページの権限の設定」を参照してください。

ルート・ノードの設定時には、他の権限に加えて、「管理」権限も設定できます。この権限を持つユーザーは、個々のページの設定にかかわらず、ページ階層全体にアクセスできます。

図36-23 ルート・ノードのアクセス権限の設定

「図36-23 ルート・ノードのアクセス権限の設定」の説明

36.5.1.4 ページの並替え

ページは並べ替えることができます。この順序は、ページ問合せを通じてページをナビゲーション・モデルに含めるときに使用されます。

ページの順序を変更する手順は、次のとおりです。

1. WebCenter Portal管理コンソールの「リソース」ページに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. ページ階層内の必要な場所にページをドラッグします。
ページの順序を変更するために、「並替え」列に表示されたアイコンを使用することもできます(図36-24)。これらのアイコンを使用すると、ページをリストの先頭、リストの末尾、直前のページの前、またはリストの次に表示されているページの後に移動できます。

図36-24 ページの並替え

「図36-24 ページの並替え」の説明

36.5.1.5 ページ階層内のページの移動

ページ階層でのページの表示レベルを変更できます。ページを移動して、サブページ、ルート・レベルのページ、または親ページとして表示できます。

ページ階層内でページを移動する手順は、次のとおりです。

1. WebCenter Portal管理コンソールの「リソース」ページに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. 移動するページの「アクション」メニューを開き、「ページの移動」を選択します(図36-25)。

図36-25 ページの「アクション」メニュー

「図36-25 ページの「アクション」メニュー」の説明

4. 「ページの移動」ダイアログで、ページの移動先となるページ階層内のレベルを選択します。
たとえば、ページをMyPageのサブページとして表示する場合は、「MyPage」をクリックします(図36-26)。

図36-26 ページの移動

「図36-26 ページの移動」の説明

5. 「OK」をクリックします。
図36-27で、「サブページ」列に表示されているサブページ・アイコンは、MyPageにサブページが含まれていることを示しています。

図36-27 ページ階層内の更新されたページ

「図36-27 ページ階層内の更新されたページ」の説明

36.5.1.6 ページ名の変更

ページ名を変更する手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. 名前を変更するページの「アクション」メニューを開き、「ページ名の変更」を選択します。

4. 「ページ名の変更」ダイアログで、任意の名前を入力します。

5. 「OK」をクリックします。

36.5.2 リソースの作成

アプリケーションのデプロイ後も、管理者は組織の要件に合わせて、そのアプリケーションを定期的に更新する必要があります。Frameworkアプリケーションを使用すると、アプリケーションを再デプロイする必要なく、リソースを実行時に作成および編集できます。

リソースを作成する手順は、次のとおりです。

注意:

データ・コントロールとページの作成手順は、他のリソースの場合と異なります。データ・コントロールを作成する方法については、WebCenter Portal管理コンソールの「リソース」ページに移動し、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのデータ・コントロールの作成と管理に関する章の手順に従ってください。ページの作成については、第36.5.1.1項「ページの作成」を参照してください。

1. WebCenter Portal管理コンソールの「リソース」ページに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルで、作成するリソースのカテゴリを選択します。

3. メニュー・バーの「作成」をクリックします。

4. 「作成」ダイアログの「名前」フィールドに、リソースの名前を入力します。

5. 「説明」フィールドに、リソースの説明を入力します。

6. 「コピー元」リストから、新規リソースを作成するために拡張する既存のリソースを選択します。

注意:

「コピー元」リストは、ページ・テンプレート、ナビゲーション、リソース・カタログおよびスキン・リソースに対して提供されます。タスク・フロー・リソースに対しては提供されません。

タスク・フロー・リソースの場合、マッシュアップ・スタイルを選択する必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのタスク・フローの作成に関する項を参照してください。

7. 「作成」をクリックします。
新しく作成したリソースが「リソース」ページにリストされます。リソースの隣にある灰色のアイコンは、そのリソースがまだ公開されておらず、ユーザーが使用できないことを示しています。リソースの公開については、第36.5.6項「リソースの表示と非表示」を参照してください。

36.5.3 リソースのコピー

リソースのコピーを作成できます。この機能は、リソースのバックアップを作成する場合や、元のリソースの使用中にリソースを更新する場合に役立ちます。リソースのコピーを作成すると、そのコピーは非表示としてマークされます。

リソースのコピーを作成する手順は、次のとおりです。

1. WebCenter Portal管理コンソールの「リソース」ページに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. リソースのリストから、コピーするリソースを選択します。

4. 「編集」メニューの「コピー」を選択します。

注意:

ページのコピーを作成するには、ページの「アクション」メニューから「ページのコピー」を選択します。「ページのコピー」ダイアログで、ページ名を指定し、「OK」をクリックします。

5. 「コピー」ダイアログで、「表示名」フィールドにリソース・コピーの名前を入力します(図36-28)。

図36-28 リソースのコピー

「図36-28 リソースのコピー」の説明

6. 「説明」フィールドに、リソース・コピーの説明を入力します。

7. 「OK」をクリックします。

36.5.4 リソースの編集

実行時には、次の2つのタイプのリソースの編集が可能です。

- 単純な編集: リソースの基本設定を編集するための単純な方法が提供されます。単純な編集を実行するには、「編集」ダイアログを使用します。

- ソースの編集: リソースのソース・コードを編集できます。ソースの編集を実行するには、「ソースの編集」ダイアログを使用します。

36.5.4.1 リソースのソース・コードの編集

実行時のリソースの編集をよりきめ細かく制御するには、データ・コントロールとページを除く任意のカスタム・リソースの基礎となるソース・コードを編集します。

リソースのソース・コードを編集する手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルから、目的のリソース・タイプを選択します。

3. 右側に表示されているリソースのリストから、コードを編集するリソースを選択します。

4. 「編集」メニューの「ソースの編集」を選択します。
「ソースの編集」ダイアログに、リソース定義が表示されます。

5. 必要に応じてコードを編集します(図36-29)。
コード内のXML構文は検証され、タグが欠けていたり誤って追加された場合は、エラー・メッセージが表示されます。検証は、CSSファイルなど、XML以外のファイルに対しては実行されません。

図36-29 リソースのソースの編集

「図36-29 リソースのソースの編集」の説明

6. 「OK」をクリックします。

36.5.4.2 「編集」ダイアログを使用したリソースの編集

実行時にリソースを編集する手順は、次のとおりです。

1. WebCenter Portal管理コンソールの「リソース」ページに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. リソースのリストから、編集するリソースを選択します。

4. 「編集」メニューの「編集」を選択します。

注意:

ページを編集するには、ページの「アクション」メニューから「ページの編集」オプションを選択します。

5. 必要に応じてリソースを編集します。

編集できるプロパティは、リソースによって異なります。編集できるリソースのプロパティについては、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpacesで使用可能なリソースに関する表にリストされている、関連リソースの章を参照してください。Frameworkアプリケーション内のリソースを編集する手順は、Spacesアプリケーション内のリソースの場合に似ています。

36.5.5 リソースのプロパティの設定

各リソースには、その表示プロパティおよび属性を定義する、特定の関連プロパティがあります。認可されたユーザーは、「プロパティの編集」ダイアログを使用して、これらのプロパティを編集できます。「プロパティの編集」ダイアログに表示されるプロパティの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリソースのプロパティに関する必要な知識に関する項を参照してください。

この項では、「プロパティの編集」ダイアログにアクセスし、リソースのプロパティを設定する方法を説明します。内容は次のとおりです。

注意:

この項で説明するプロパティは、ページ・リソースには当てはまりません。

- 第36.5.5.1項「リソースの「プロパティの編集」ダイアログへのアクセス」

- 第36.5.5.2項「リソースの名前変更、説明および分類」

- 第36.5.5.3項「アイコンとリソースの関連付け」

- 第36.5.5.4項「リソースの属性の使用」

36.5.5.1 リソースの「プロパティの編集」ダイアログへのアクセス

リソースの「プロパティの編集」ダイアログにアクセスする手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルから、編集するリソースのタイプを選択します。

3. 関連リソースをハイライトし、「編集」メニューの「プロパティの編集」を選択します。
「プロパティの編集」ダイアログが開きます(図36-30)。

図36-30 リソースの「プロパティの編集」ダイアログ

「図36-30 リソースの「プロパティの編集」ダイアログ」の説明

関連項目:

次に実行する手順は、目的によって異なります。詳細は、次を参照してください。

- 第36.5.5.2項「リソースの名前変更、説明および分類」

- 第36.5.5.3項「アイコンとリソースの関連付け」

- 第36.5.5.4項「リソースの属性の使用」

36.5.5.2 リソースの名前変更、説明および分類

リソースは、その表示名に従って、「リソース」ページ上でソートされます。リソース・セットが整理された状態を維持するには、基準となる名前付けスキームと説明方法を決定することを検討します。これは必須手順ではありませんが、特定のリソースの用途を明確に識別するのに役立つ場合があります。

リソースは、関連グループに分類できます。たとえば、営業に関連付けられたすべてのページ・スタイルは、salesカテゴリに分類されます。この値は、「プロパティの編集」ダイアログでのみ公開され、使用できます。

リソースの名前、説明およびカテゴリを提供する手順は、次のとおりです。

1. 第36.5.5.1項「リソースの「プロパティの編集」ダイアログへのアクセス」の手順に従います。

2. 「表示名」フィールドで、必要に応じてリソースの表示名を編集します。

3. オプションで、「説明」フィールドにリソースの説明を入力します。

4. オプションで、「カテゴリ」フィールドにカテゴリ名を入力します。

5. 「OK」をクリックして変更を保存し、ダイアログを終了します。

36.5.5.3 アイコンとリソースの関連付け

アイコンとリソースを関連付けることができます。Oracle WebCenter Portalの現在のバージョンでは、「ページの作成」ダイアログを使用してページを作成するときに、ページ・スタイルに対してのみ、それに関連付けられたアイコンが表示されます。

アイコンとリソースを関連付ける手順は、次のとおりです。

1. 第36.5.5.1項「リソースの「プロパティの編集」ダイアログへのアクセス」の手順に従って、「プロパティの編集」ダイアログを開きます。

2. 「アイコンURI」フィールドに、目的のアイコンへの標準URIパスを入力します。
たとえば、次のように入力します。

/mycompany/webcenter/page/images/myimage.png

指定できるのは、絶対URL(ブラウザのアドレス・フィールドに入力した場合でも機能するURL)か、アプリケーションの/oracle/webcenter/siteresources/scopedMD/sharedフォルダに格納されているイメージを指す相対URLです。

3. 「OK」をクリックして変更を保存し、ダイアログを終了します。

36.5.5.4 リソースの属性の使用

「プロパティの編集」ダイアログを通じて公開されるデフォルトの属性(「表示名」、「説明」など)に加えて、リソースのカスタム属性を公開することもできます。「プロパティの編集」ダイアログでは、属性の名前と値のペアを入力するための「属性」セクションが提供されます(図36-31)。

図36-31 リソースの「属性」セクション

「図36-31 リソースの「属性」セクション」の説明

たとえば、editPageAfterCreation属性をページ・スタイル・リソースと関連付けて、新しく作成したページを編集モードと表示モードのどちらで開くかを制御できます。この属性の値は、trueまたはfalseです。この属性を特定のページ・スタイルと関連付けると、選択したスタイルに基づいてユーザーがページを作成するたびに属性値が考慮され、それに従ってページが機能します。

この項では、カスタム属性をリソースと関連付ける方法、およびカスタム属性を削除する方法を説明します。内容は次のとおりです。

- 第36.5.5.4.1項「属性とリソースの関連付け」

- 第36.5.5.4.2項「リソースの属性の削除」

36.5.5.4.1 属性とリソースの関連付け

属性とリソースを関連付ける手順は、次のとおりです。

1. 第36.5.5.1項「リソースの「プロパティの編集」ダイアログへのアクセス」の手順に従って、「プロパティの編集」ダイアログを開きます。

2. 「属性」セクションの「名前」フィールドに、属性名を入力します。

3. 「値」フィールドに、属性の値を入力します。

4. さらに属性を追加する場合は、「さらに追加」をクリックします。
これにより、新しい行が追加されます。その後、「名前」および「値」フィールドに、必要な詳細を入力できます。

5. 「OK」をクリックして変更を保存し、ダイアログを終了します。

36.5.5.4.2 リソースの属性の削除

リソースに関連付けられた属性を削除する手順は、次のとおりです。

1. 第36.5.5.1項「リソースの「プロパティの編集」ダイアログへのアクセス」の手順に従って、「プロパティの編集」ダイアログを開きます。

2. 「属性」セクションで、削除する属性に対応した「削除」アイコンをクリックします。

3. 「OK」をクリックして変更を保存し、ダイアログを終了します。

36.5.6 リソースの表示と非表示

リソースを作成すると、そのリソースはデフォルトで非表示としてマークされます。非表示のリソースは、リソース・ピッカー内で使用できません。リソースを使用可能にするには、そのリソースを公開する必要があります。

「リソース」ページでは、使用可能なすべてのリソース名の隣に、緑色のチェックマークと「使用可能」という言葉が表示されます。リソース名の隣に、灰色のアイコンと「非表示」という言葉が表示されている場合、そのリソースは非表示としてマークされています(図36-32)。

図36-32 リソースの表示と非表示

「図36-32 リソースの表示と非表示」の説明

リソースを表示または非表示にする手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. リソースのリストから、表示または非表示にするリソースを選択します。

4. 「編集」メニューから、表示されたオプションに応じて「表示」または「非表示」を選択します。
リソースが非表示になっている場合、「編集」メニューには「表示」オプションが表示されます。「表示」をクリックすると、リソース名の隣に緑色のチェックマークと「使用可能」という言葉が表示され、リソースが使用可能になります。

リソースがすでに公開されている場合、「編集」メニューには「非表示」オプションがリストされます。「非表示」をクリックすると、リソース名の隣に灰色のアイコンと「非表示」という言葉が表示され、リソースは非表示になり、ユーザーはそのリソースを使用できなくなります。

注意:

ページを使用可能としてマークするには、「リソース」ページで、ページ名の隣にある「ページを表示」チェック・ボックスを選択します。このチェック・ボックスが選択解除されている場合、ページは非表示としてマークされます。

36.5.7 リソース・セキュリティの設定

アプリケーション内で作成したリソースに、すべてのユーザーがアクセスできるか、特定のユーザーまたはグループのみがアクセスできるかを制御できます。デフォルトでは、アプリケーションレベルの権限によって、リソースのアクセス権限が制御されます。「セキュリティ設定」ダイアログでは、アプリケーションレベルの権限とは別に、選択したリソースに対する特定の権限を定義できます。

ページのアクセス権限の設定については、第36.5.1.3項「ページのアクセス権限の設定」を参照してください。

ページ以外のリソースにアクセス権限を設定する手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. リソースのリストから、アクセス権限を設定するリソースを選択します。

4. 「編集」メニューの「セキュリティ設定」を選択します。

5. 「セキュリティ設定」ダイアログで、次のいずれかのオプションを選択して、アクセス方法を指定します(図36-33)。

- カスタム権限の使用: 選択したリソースを管理および更新できるユーザーを定義する場合、このオプションを選択します。このオプションを選択した場合、ダイアログ内の他のコントロールは使用可能になります。手順6に進んでください。

注意:

「カスタム権限の使用」を選択した場合、1人以上のユーザーまたは1つ以上のグループに「管理」アクセス権限が付与されていることを確認してください。

- アプリケーション権限の使用: 選択したリソースのアクセス設定を、アプリケーション用に定義した設定から継承する場合、このオプションを選択します。このオプションを選択した場合、「OK」をクリックして変更を保存し、ダイアログを終了します。

注意:

「アプリケーション権限の使用」を選択すると、すでに設定されているカスタム権限は削除されます。

図36-33 リソースのセキュリティの設定

「図36-33 リソースのセキュリティの設定」の説明

6. 「カスタム権限の使用」を選択した場合、リソースのアクセス権限を付与するユーザーまたはグループを指定します。「セキュリティ設定」ダイアログで、次の操作を実行します。

- アイデンティティ・ストアに含まれる個々のユーザーを検索および選択できるダイアログを開くには、「ユーザーの追加」をクリックします。必要なユーザーを選択し、「OK」をクリックしてダイアログを閉じます。

- アイデンティティ・ストアに含まれる個々のユーザーのグループを検索および選択できるダイアログを開くには、「グループの追加」をクリックします。必要なグループを選択し、「OK」をクリックしてダイアログを閉じます。

7. 「ロールまたはユーザー」列にリストされているユーザーまたはグループごとに、付与するアクセス・レベルを次のように指定します。

- リソースへの完全なアクセス権限を付与するには、「管理」チェック・ボックスを選択します。これらのユーザーは、リソース・プロパティの編集とリソースの削除を実行できます。

- リソースを編集する権限を付与するには、「更新」チェック・ボックスを選択します。これらのユーザーは、リソースを編集できますが、削除できません。

8. 任意のユーザーまたはグループの権限を取り消す場合は、そのエンティティを選択し、「アクセス権限の削除」をクリックします。

9. 「OK」をクリックします。

36.5.8 リソースのダウンロードとアップロード

デプロイ済のアプリケーションでは、実行時にリソースを編集できます。ただし、よりきめ細やかな制御を行う目的で、設計時にリソースを編集することもできます。この場合、実行時に作成したリソースをダウンロードし、設計時にJDeveloperで編集した後、更新されたリソースを再度アプリケーションにアップロードできるため、アプリケーションを再デプロイする必要はありません。

注意:

データ・コントロールとページは、リソース・レベルでダウンロードまたはアップロードできません。

「ダウンロード」および「アップロード」オプションを使用すると、デプロイ後のラウンドトリップ・アプリケーション開発が可能になります。これらのアクションによって、より簡単に、新しいリソースや更新されたリソースをJDeveloperからアプリケーションに移動し、必要に応じて、それらのリソースをアプリケーションからJDeveloperでの開発に戻すことができます。

リソースをダウンロードすると、リソース構成が単一のエクスポート・アーカイブ(.earファイル)内に保存されます。エクスポート・アーカイブは、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存できます。

リソースをダウンロードする手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. リソースのリストから、EARファイルとしてダウンロードするリソースを選択します。

4. 「ダウンロード」をクリックします。

5. 「ダウンロード」ダイアログの「アーカイブ・ファイル名」フィールドに、エクスポート・アーカイブ・ファイルの名前を入力します。

6. 「ダウンロード」ダイアログで、エクスポート・アーカイブ・ファイルの保存先を指定します。次のいずれかのオプションを使用します。

- 自分のコンピュータに保存: エクスポート・アーカイブ・ファイルをローカル・ファイル・システムに保存する場合にクリックします。その後、ファイルの保存先となるパスを指定します。

- WebCenter Portalサーバーに保存: エクスポート・アーカイブ・ファイルをリモート・サーバー・ファイル・システムに保存する場合にクリックします。「パス」フィールドに、サーバーのパスを入力します。

7. 「ダウンロード」をクリックして、リソースをダウンロードします。

JDeveloperでリソースを編集したら、それらを実行時にアプリケーションにアップロードできます。アップロードするリソースは、エクスポート・アーカイブ(.earファイル)形式になっている必要があります。

実行時にリソースをアップロードする手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. 「アップロード」をクリックします。

4. 「アップロード」ダイアログで、リソース・アーカイブ・ファイルの場所を指定します。EARファイルの場所に応じて、次のいずれかを選択します。

- 自分のコンピュータで表示: アーカイブがローカル・ファイル・システム上にある場合に選択します。EARファイルへのパスを入力するか、「参照」ボタンを使用します。

- WebCenter Portalサーバーで表示: アーカイブがリモート・サーバー上にある場合に選択します。「パス」フィールドに、EARファイルへのパスを入力します。

5. 「アップロード」をクリックします。

36.5.9 リソースのプレビュー

実行時にリソースを編集し、変更をプレビューした後、必要に応じてさらに調整を行うことができます。

リソースをプレビューする手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルで、目的のリソース・カテゴリを選択します。

3. プレビューするリソースを選択します。

4. 「プレビュー」をクリックします。

注意:

データ・コントロールとページのプレビューはサポートされていません。「プレビュー」オプションへのアクセス方法は、一部のリソースでは異なります。特定のリソースについては、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpacesで使用可能なリソースに関する表にリストされている、リソースごとの章を参照してください。

36.5.10 リソースの削除

リソースが不要になったら、そのリソースをアプリケーションから削除できます。

リソースを削除する手順は、次のとおりです。

1. 第36.2項「WebCenter Portal管理コンソールへのアクセス」の説明に従って、WebCenter Portal管理コンソールの「リソース」ページに移動します。

2. 左側にあるナビゲーション・パネルで、任意のリソース・タイプを選択します。

3. リソースのリストから、削除するリソースを選択します。

4. 「編集」メニューの「削除」を選択します。

注意:

ページを削除するには、ページの「アクション」メニューから「ページの削除」オプションを選択します。ページを削除すると、そのサブページも削除されます。

5. 「削除」確認ダイアログで、「OK」をクリックしてリソースを削除します。

36.6 サービス、ポートレット・プロデューサおよび外部アプリケーションの管理

WebCenter Portal管理コンソールを通じて、いくつかのWebCenter Portalサービスを管理および構成できます。「サービス」タブ(図36-34)からは、コンテンツ・リポジトリ、投票、ポートレット・プロデューサおよび外部アプリケーションを管理および構成できます。

図36-34 WebCenter Portal管理コンソール: 「サービス」タブ

「図36-34 WebCenter Portal管理コンソール: 「サービス」タブ」の説明

分析など、一部のサービスはデフォルトで使用できるため、管理者レベルでの構成は不要です。投票など、その他のサービスを稼働させるには、管理権限を持つユーザーによる追加の構成が必要です。

この章の内容は次のとおりです。

- 第36.6.1項「コンテンツの管理」

- 第36.6.2章「ポートレット・プロデューサの管理」

- 第36.6.3項「外部アプリケーションの管理」

- 第36.6.4項「投票の作成と構成」

36.6.1 コンテンツの管理

アプリケーション管理者は、WebCenter Portal管理コンソールを通じて、アプリケーションのプライマリ・コンテンツ・リポジトリに格納されたコンテンツを管理できます(図36-35)。管理者は、ここからコンテンツの追加、編集、更新、ドキュメント・バージョン履歴の管理、および役立つ情報(ファイルとフォルダのダイレクトURLやダウンロードURLなど)へのアクセスを実行できます。

Frameworkアプリケーションのコンテンツ・リポジトリを登録し、プライマリ(またはデフォルト)・コンテンツ・リポジトリを決定するのは、システム管理者の職責です。この管理ページに、異なるコンテンツ・リポジトリのコンテンツを表示する必要がある場合は、プライマリ(またはデフォルト)・コンテンツ・リポジトリ接続の再構成をシステム管理者に依頼します。第11.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」も参照してください。

図36-35 ドキュメント・サービスのプライマリ・リポジトリのコンテンツ

「図36-35 ドキュメント・サービスのプライマリ・リポジトリのコンテンツ」の説明

この項の内容は次のとおりです。

- 第36.6.1.1項「新規フォルダの作成」

- 第36.6.1.2項「Wikiページの作成」

- 第36.6.1.3項「ファイルの編集」

- 第36.6.1.4項「ドキュメントのアップロード」

- 第36.6.1.5項「ドキュメントのチェックアウト」

- 第36.6.1.6項「ドキュメントの新規バージョンのアップロード」

- 第36.6.1.7項「コンテンツ・アイテムのバージョン履歴の表示」

- 第36.6.1.8項「ドキュメントのダイレクトURLとダウンロードURLの取得」

- 第36.6.1.9項「表示コンテンツの列の整理」

- 第36.6.1.10項「フォルダとドキュメントのセキュリティの設定」

36.6.1.1 新規フォルダの作成

新規フォルダを作成する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. 新規フォルダの作成先となるディレクトリを選択します。

4. 「ファイル」メニューの「新規フォルダ」を選択します。

5. 「フォルダの作成」ダイアログで、「フォルダ名」フィールドにわかりやすい名前を入力し、「作成」をクリックして、選択したディレクトリにフォルダを作成します。

ヒント:

フォルダの名前を変更したり、フォルダを削除するには、「ファイル」メニューから適切なオプションを選択します。このメニューでは、フォルダに格納されたコンテンツの切取り、コピーおよび貼り付けを実行するためのオプションも提供されます。

ディレクトリ内のフォルダを非表示にするには、「表示」メニューの「フォルダの非表示」を選択します。非表示のフォルダを表示するには、「フォルダの非表示」オプションを選択解除します。

36.6.1.2 Wikiページの作成

Wikiドキュメントを作成する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. Wikiページの作成先となるディレクトリを選択します。

4. 「新規Wikiドキュメント」をクリックします。リッチ・テキスト・エディタが表示されます。

5. 「タイトル」フィールドにわかりやすいタイトルを入力し、「作成」をクリックして、選択したディレクトリにWikiページを作成します。

36.6.1.3 ファイルの編集

Wikiドキュメントなどのコンテンツを編集する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. 編集するアイテムを選択します。

4. 「ファイル」メニューの「編集」を選択します。ファイルがリッチ・テキスト・エディタ内で開きます(図36-36)。

図36-36 編集用に開いたWikiページ

「図36-36 編集用に開いたWikiページ」の説明

5. 「保存して閉じる」をクリックし、ドキュメントを保存して閉じます。

36.6.1.4 ドキュメントのアップロード

ドキュメントをアップロードする手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントのアップロード先となるディレクトリを選択します。

4. 「ドキュメントのアップロード」をクリックします。「<フォルダ名>へのドキュメントのアップロード」ダイアログが表示されます。

5. 「ドキュメントのアップロード」セクションで、「参照」をクリックし、必要なドキュメントを選択します。必要に応じて「説明」セクションに説明を入力し、「アップロード」をクリックします。選択したディレクトリにドキュメントがアップロードされます。

ヒント:

一度に複数のドキュメントをアップロードできます。「追加」をクリックしてフィールドを追加することによって、任意の数のドキュメントをアップロードできます。

ドキュメントをダウンロードするには、そのドキュメントを選択し、「ダウンロード」をクリックします。

36.6.1.5 ドキュメントのチェックアウト

ドキュメントをチェックアウトする手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. チェックアウトするドキュメントを選択します。

4. 「ファイル」メニューの「チェックアウト」を選択します。ドキュメントがチェックアウトされ、チェックアウト済のステータスを示す鍵アイコンが表示されます(図36-37)。

図36-37 チェックアウトされたドキュメント

「図36-37 チェックアウトされたドキュメント」の説明

ヒント:

チェックアウトを取り消すには、ディレクトリ内でそのドキュメントを選択し、「ファイル」メニューの「チェックアウトの取消」を選択します。

36.6.1.6 ドキュメントの新規バージョンのアップロード

ドキュメントの新規バージョンをアップロードする手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. チェックアウトするドキュメントを選択します。

4. 「ファイル」メニューの「新規バージョンのアップロード」を選択します。

5. 「新規バージョンのアップロード」ダイアログで、「参照」をクリックし、ドキュメントの別のバージョンを選択します(図36-38)。必要に応じて説明を入力し、「アップロード」をクリックします。

図36-38 ドキュメントの新規バージョンのアップロード

「図36-38 ドキュメントの新規バージョンのアップロード」の説明

36.6.1.7 コンテンツ・アイテムのバージョン履歴の表示

イメージやWikiページなどのドキュメントのバージョン履歴を表示する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるディレクトリに移動します。

4. バージョン履歴を表示するドキュメントを選択します。

5. 「表示」メニューの「バージョン履歴」を選択します。バージョン履歴が表示されます(図36-39)。

図36-39 ドキュメントのバージョン履歴

「図36-39 ドキュメントのバージョン履歴」の説明

ヒント:

アイテムのプロパティを表示するには、ディレクトリ内でそのアイテムを選択し、「表示」メニューの「プロパティ」を選択します。

36.6.1.8 ドキュメントのダイレクトURLとダウンロードURLの取得

ダイレクトURLを使用するとドキュメントを表示でき、ダウンロードURLを使用するとそのドキュメントをダウンロードできます。これらのURLを取得する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるディレクトリに移動します。

4. URLを取得するドキュメントを選択します。

5. 「表示」メニューの「リンクの取得」を選択します。

6. 「リンクの取得」ダイアログで、このドキュメントを表示する場合は、「ダイレクトURL」をクリックします。このドキュメントをダウンロードする場合は、「ダウンロードURL」をクリックします。

図36-40 ダイレクトURLとダウンロードURL

「図36-40 ダイレクトURLとダウンロードURL」の説明

36.6.1.9 表示コンテンツの列の整理

プライマリ・リポジトリ内のアイテムごとに、コンテンツ・アイテムの名前、最終変更日、チェックアウト・ステータスなど、表示する関連情報を選択できます。また、選択した列を並べ替えて、任意の情報を特定の順序で表示することもできます。

36.6.1.9.1 列の表示

コンテンツ・アイテムに関して表示する情報の列を選択する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるディレクトリに移動します。

4. 「表示」メニューの「列」を選択し、コンテンツ・アイテムに関して表示する情報のタイトルを選択します(図36-9)。

図36-41 列: 表示

「図36-41 列: 表示」の説明

36.6.1.9.2 列の並替え

列を並べ替える手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるディレクトリに移動します。

4. 「表示」メニューの「列の並替え」を選択します。「列の並替え」ダイアログが表示されます(図36-42)。

図36-42 列: 並替え

「図36-42 列: 並替え」の説明

36.6.1.10 フォルダとドキュメントのセキュリティの設定

次の条件を満たすと、「ファイル」メニューの「コンテンツ」タブに「セキュリティ」メニュー・アイテムが表示されます。

- 第11.2.3.10項「WebCenter Portalアプリケーションでのアイテム・レベルのセキュリティの構成」の説明に従って、Oracle WebCenter Content Serverでアイテム・レベルのセキュリティを有効化した。

- 第11.2.3.10項「WebCenter Portalアプリケーションでのアイテム・レベルのセキュリティの構成」の説明に従って、Oracle WebCenter Content Serverでアイテム・レベルのセキュリティを有効化したときに、該当するドキュメントに割り当てられたセキュリティ・グループが、SpecialAuthGroups設定にリストされた。

- ユーザーがOracle WebCenter Content Serverのドキュメントまたはフォルダの管理権限を持っている。

セキュリティ機能の使用については、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのファイルのセキュリティ・オプションの設定に関する項を参照してください。

36.6.2 ポートレット・プロデューサの管理

Frameworkアプリケーション内でポートレット・プロデューサを登録して管理するには、ユーザーにAppConnectionManagerロールが割り当てられている必要があります。デフォルトでは、Administratorロールを持つユーザーにAppConnectionManagerロールが割り当てられるため、アプリケーション管理者は、WebCenter Portal管理コンソールを通じてポートレット・プロデューサを構成できます。第36.4.4項「アプリケーション・ロールおよび権限の管理」も参照してください。

ポートレット・プロデューサを登録すると、そのプロデューサによって所有されているすべてのポートレットが、アプリケーションのリソース・カタログを通じて自動的に使用可能になります。一度登録されると、編集ページの適切な権限を持つユーザーは、そのプロデューサのポートレットを自分のページに追加できるようになります。アクセスする必要がある特定のポートレットがリソース・カタログ内に見つからない場合は、それに関連付けられたプロデューサの登録を管理者に依頼します。

この項の内容は次のとおりです。

- 第36.6.2.1項「ポートレット・プロデューサの登録」

- 第36.6.2.2項「ポートレット・プロデューサの編集と削除」

注意:

Fusion Middleware管理者は、Fusion Middleware ControlとWLSTコマンドを使用して、Frameworkアプリケーションのポートレット・プロデューサを登録することもできます。詳細は、第24章「ポートレット・プロデューサの管理」を参照してください。

36.6.2.1 ポートレット・プロデューサの登録

Frameworkアプリケーションのポートレット・プロデューサを実行時に登録する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「ポートレット・プロデューサ」を選択します(図36-43)。

図36-43 WebCenter Portal管理コンソール: ポートレット・プロデューサ

3. 「登録」をクリックします。

4. ポートレット・プロデューサの接続の詳細を入力します。
1つ以上のフィールドの詳細は、次の表を参照してください。

WSRPプロデューサ

- 表24-1「WSRPプロデューサの接続パラメータ」

- 表24-2「WSRPプロデューサのセキュリティの接続パラメータ」

- 表24-3「WSRPプロデューサのキー・ストアの接続パラメータ」

Oracle PDK Javaプロデューサ

- 表24-4「Oracle PDK-Javaプロデューサの接続パラメータ」

ページレット・プロデューサ

- 表25-1「ページレット・プロデューサの接続パラメータ」

5. 「テスト」をクリックして、接続の詳細を検証します。

6. 「OK」をクリックして、ポートレット・プロデューサを登録します。

36.6.2.2 ポートレット・プロデューサの編集と削除

Frameworkアプリケーションのポートレット・プロデューサを実行時に変更または削除する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「ポートレット・プロデューサ」を選択します(図36-43)。

3. 必要なポートレット・プロデューサを選択し、次のいずれかをクリックします。

- ポートレット・プロデューサの接続の詳細を更新するには、「編集」をクリックします。

- プロデューサを登録解除するには、「登録解除」をクリックします。これにより、登録データがFrameworkアプリケーションとリモート・プロデューサの両方から削除されます。
登録を解除しても、Frameworkアプリケーション・ページからポートレット・インスタンスは削除されません。ユーザーには、ポートレットのかわりに「ポートレットがありません」というメッセージが表示されます。

このポートレット・プロデューサに関連付けられている外部アプリケーションの目的がこのプロデューサをサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。第36.6.3.2項「外部アプリケーションの編集と削除」を参照してください。

36.6.3 外部アプリケーションの管理

Frameworkアプリケーション内で外部アプリケーションを登録して管理するには、ユーザーにAppConnectionManagerロールが割り当てられている必要があります。デフォルトでは、Administratorロールを持つユーザーにAppConnectionManagerロールが割り当てられるため、アプリケーション管理者は、WebCenter Portal管理コンソールを通じて外部アプリケーションを構成できます。第36.4.4項「アプリケーション・ロールおよび権限の管理」も参照してください。

外部アプリケーションとは、自身の認証プロセスを実装するアプリケーションです。つまり、Frameworkアプリケーションのシングル・サインオン・プロセスに参加しないアプリケーションのことです。Frameworkアプリケーションが、自身の認証を行うアプリケーションと対話する場合、資格証明プロビジョニングを可能にする外部アプリケーションを登録できます。

アプリケーション管理者は、WebCenter Portal管理コンソールを通じて、実行時にFrameworkアプリケーションの外部アプリケーションを登録、編集および削除できます。

この項の内容は次のとおりです。

- 第36.6.3.1項「外部アプリケーションの登録」

- 第36.6.3.2項「外部アプリケーションの編集と削除」

注意:

Fusion Middleware管理者は、Fusion Middleware ControlとWLSTコマンドを使用して、Frameworkアプリケーションの外部アプリケーションを登録することもできます。詳細は、第24章「ポートレット・プロデューサの管理」を参照してください。

36.6.3.1 外部アプリケーションの登録

Frameworkアプリケーションの外部アプリケーションを実行時に登録する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「外部アプリケーション」を選択します(図36-44)。

図36-44 WebCenter Portal管理コンソール: 外部アプリケーション

「図36-44 WebCenter Portal管理コンソール: 外部アプリケーション」の説明

3. 「登録」をクリックします。

4. 外部アプリケーションの接続の詳細を入力します。
1つ以上のフィールドの詳細は、次の表を参照してください。

- 表26-1「外部アプリケーション接続: 名前」

- 表26-2「外部アプリケーション接続: ログインの詳細」

- 表26-3「外部アプリケーション接続: 認証の詳細」

- 表26-4「外部アプリケーション接続: 追加ログイン・フィールド」

- 表26-5「外部アプリケーション接続: 共有ユーザー資格証明とパブリック・ユーザー資格証明」

5. 「テスト」をクリックして、接続の詳細を検証します。

6. 「OK」をクリックして、アプリケーションを登録します。

36.6.3.2 外部アプリケーションの編集と削除

Frameworkアプリケーションの外部アプリケーションを実行時に変更または削除する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「外部アプリケーション」を選択します(図36-44)。

3. 必要な外部アプリケーションを選択し、次のいずれかをクリックします。

- 外部アプリケーションの接続の詳細を更新するには、「編集」をクリックします。

- 外部アプリケーションを削除するには、「登録解除」をクリックします。
外部アプリケーション接続を削除すると、Frameworkアプリケーション・ユーザーはそのアプリケーションにアクセスできなくなり、外部アプリケーションに依存するサービスが正常に機能しなくなる可能性があるため、削除する際は注意してください。

36.6.4 投票の作成と構成

アプリケーション管理者は、WebCenter Portal管理コンソールを通じて、実行時にFrameworkアプリケーションのオンライン投票を作成および構成できます。投票を使用すると、関係者への調査(意見および経験レベルなど)、重要な情報を再表示できるかどうかの確認、およびプレゼンテーションの効果に対するフィードバックの収集が可能です。

この項の内容は次のとおりです。

- 第36.6.4.1項「投票サービスに関する必要な知識」

- 第36.6.4.2項「投票の作成、構成および分析」

36.6.4.1 投票サービスに関する必要な知識

投票サービスを使用すると、投票を実施するだけでなく、次のことを実行できます。

- 「投票の作成」アイコンをクリックし、セクション・ヘッダーと質問を追加することによって、投票を作成します。

- 投票の配信スケジュールを設定します。

- 投票を、新規投票で使用できるテンプレートとして保存します。

- 投票の結果を分析します。

投票サービスは、RSS、検索(投票テキストの検索)、インスタント・メッセージおよびプレゼンス、最近のアクティビティなど、多くのWebCenter Portalサービスと統合されています。

図36-45は、投票の例を示しています。

図36-45 投票の例

ユーザーが投票を完了するには、その投票が公開され、オープンしている必要があります。未公開またはクローズした投票は完了できません。

36.6.4.2 投票の作成、構成および分析

「投票」ページ(図36-46)では、投票を作成した後、現在の投票のステータスを表示し、それらに対して、編集、保存(投票または投票テンプレートとして)、公開、クローズ、分析、削除などの操作を実行できます。「投票」ページ上の投票データは、いつでも「リフレッシュ」アイコンをクリックして更新できます。

新規投票を追加する手順は、次のとおりです。

1. 「サービス」管理タブに移動します。
第36.2項「WebCenter Portal管理コンソールへのアクセス」も参照してください。

2. 「投票」を選択します(図36-46)。

図36-46 WebCenter Portal管理コンソール: 投票

3. 「投票の作成」をクリックします。
「投票の作成」ダイアログが表示されます(図36-47)。

図36-47 「投票の作成」ダイアログ

「図36-47 「投票の作成」ダイアログ」の説明

4. 投票の名前と説明を入力し、「作成」をクリックします。
「デザイン」タブが表示されます(図36-48)。

図36-48 投票の作成: 「デザイン」タブ

5. 「追加」をクリックして、既存のテンプレートから投票を作成したり、質問や周囲のテキストを投票に移入します。

6. 「セクションの追加」をクリックして、リッチ・テキスト・エディタに説明テキストを入力し(図36-49)、完了したら「OK」をクリックします。

図36-49 投票: 「セクションの作成」および「セクションの編集」ダイアログ

7. 「質問の追加」をクリックして、投票の質問をそれぞれ追加します(図36-50)

図36-50 投票: 「質問の作成」および「質問の編集」ダイアログ: 質問のタイプ

8. 質問のタイプをドロップダウン・リストから選択します。
質問のタイプには、次の4つがあります。

- 複数選択肢(1回答のみ)

- 複数選択肢(複数回答)

- マトリックス選択肢(1行当たり1回答のみ)

- マトリックス選択肢(1行当たり複数回答)

9. 質問のテキストと選択肢を入力し(異なる選択肢は、別の行に入力する必要があります)、完了したら「OK」をクリックします。

図36-51 投票: 「質問の作成」および「質問の編集」ダイアログ

この例の場合、現在のデザインは図36-52のようになります。

図36-52 投票の作成: 「デザイン」タブ

10. 「スケジュール」タブを開き、投票の公開およびクローズ・オプションを選択します(図36-53を参照)。投票を実施するには、その投票が公開され、オープンしている必要があります。未公開またはクローズした投票は実施できません。
「公開オプション」では、投票を編集用に下書きモードのままにするか、すぐに公開するか、指定日に公開するかを選択します。カレンダーから公開時間を入力するには、「日付および時間の選択」アイコンをクリックします。投票の始めに表示されるテキストをリッチ・テキスト・エディタでカスタマイズするには、「導入メッセージの編集」をクリックします。

「クローズ・オプション」では、公開済の投票を、特定のレスポンス数に達した時点でクローズするか、特定の日にクローズするかを選択できます。両方のオプションを選択した場合、投票はいずれかの条件が満たされたときにクローズします。カレンダーからクローズ時間を入力するには、「日付および時間の選択」アイコンをクリックします。投票の終わりに表示されるテキストをリッチ・テキスト・エディタでカスタマイズするには、「結びのメッセージの編集」をクリックします。

図36-53 投票の作成: 「スケジュール」タブ

11. 「設定」タブを開き、投票を実施した後に何を表示するか、ユーザーが入力後にレスポンスを編集できるかどうか、および必須質問をアスタリスクでマークするかどうかを選択します(図36-54を参照)。

図36-54 投票の作成: 「設定」タブ

12. 投票の実施後、「分析」タブを開いて投票データを表示します。別の質問に切り替えるには、右側の「質問」ボックスを使用します(図36-55)。

図36-55 投票の作成: 「分析」タブ

37 複数言語ポータルの管理

ポータルで異なる言語をサポートする必要がある場合、ローカライズされたコンテンツをユーザーが選択した言語とロケールに基づいて表示するように、ポータルを構成できます。たとえば、イタリア語を話すユーザーがページを表示する場合、イタリア語が(ブラウザ、ユーザー・プリファレンス、スペースまたはアプリケーション設定で)選択されたときにページ内のテキスト文字列をイタリア語で表示するように、ページをローカライズできます。

また、ロケールを選択する際は、選択したロケールに適用される、特殊な書式について考慮する必要があります。たとえば、通常の情報の表示方向が左から右、右から左のどちらであるか、数字をどのように表記するか(通貨情報など)などがあります。

この章の内容は次のとおりです。

- 第37.1項「Spacesアプリケーションの言語に関する必要な知識」

- 第37.2項「特定の文字列またはスペースへの編集の制限」

- 第37.3項「文字列の変更」

- 第37.4項「Spacesへの新規言語のサポートの追加」

- 第37.5項「コンテンツ・プレゼンタ・テンプレートによる翻訳済コンテンツの表示」

Spacesで提供される言語構成オプションについては、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドを参照してください。

37.1 Spacesアプリケーションの言語に関する必要な知識

Spacesアプリケーション内に表示される主な情報のタイプは、次の3つです。

- ユーザー・インタフェース(UI)要素。フィールドとボタンのラベル、シードされたボイラープレート・テキストなどがあります。

- ユーザー入力メタデータ。ページ名、スペース名、スペースの説明などがあります。

- ユーザーが追加したコンテンツ。お知らせ、ドキュメント、ディスカッション・フォーラム・コンテンツなどがあります。

変更に関する処理は、情報のタイプごとに異なります。

- UI要素:

注意:

UI要素には、27の言語と100の異なるロケールに対応した、デフォルトの翻訳が含まれています。デフォルトのUIが会社の要件に合っていない場合や、会社で追加の言語をサポートする必要がある場合は、この言語を変更するだけで済みます。

- (1つのスペースだけでなく)サイト全体のテキストを変更するには、オーバーライド・バンドルの文字列を編集します。

- 特定のスペースのUIテキストを変更するには、スペース固有のリソース・バンドルに含まれる文字列を編集します。

- ユーザー入力メタデータ(ページ名、スペース名、スペースの説明など)は、文字列としてスペースのリソース・バンドルに保存されます。スペースごとに、独自のリソース・バンドルがあります。ユーザー入力メタデータを変更するには、スペース固有のリソース・バンドルに含まれる文字列を編集します。

注意:

一般的に、複数の言語で表示する必要があるユーザー入力メタデータは、会社全体向けのコンテンツまたはカスタマに表示されるコンテンツであり、多くの場合、なんらかの形式で翻訳が提供されます。より特殊なコンテンツ(特定の部門や地域に固有のコンテンツなど)に必要な言語は1つのみである可能性が高く、したがって翻訳を必要としません。

- 通常、ユーザーが追加したコンテンツは、そのユーザーが使用する言語で表示されますが、コンテンツ・プレゼンタを使用すると、翻訳されたコンテンツを表示できます。

37.1.1 Spacesによってデフォルトでサポートされる言語

Spacesでは、27の言語と100の異なるロケールに対応した翻訳が実行時に提供されます。

表37-1 Spacesで提供される言語

AからFi

FrからNo

PからT

アラビア語

フランス語

ポーランド語

ポルトガル語(ブラジル)

ドイツ語

ポルトガル語

中国語(簡体字)

ギリシャ語

ルーマニア語

中国語(繁体字)

ヘブライ語

ロシア語

チェコ語

ハンガリー語

スロバキア語

デンマーク語

イタリア語

スペイン語

オランダ語

日本語

スウェーデン語

英語

韓国語

タイ語

フィンランド語

ノルウェー語

トルコ語

表37-1のリストには、デフォルトでSpacesに提供されるすべての言語が含まれています。ユーザーは、特定の言語に関連付けられたロケールを選択することもできます。たとえば、ユーザーは言語をアラビア語に変更し、その言語グループの中で、アルジェリア、バーレーン、ジブチなど、20の異なるロケールを選択できます。

注意:

Oracle Enterprise Managerをはじめとするツールなど、Spacesにサービスを提供する管理層では、Spacesで使用可能な言語のサブセットが提供されます。それらを次に示します。

- 英語

- ポルトガル語(ブラジル)

- 中国語(簡体字)

- 中国語(繁体字)

- フランス語

- ドイツ語

- イタリア語

- 日本語

- 韓国語

- スペイン語

ディスカッション・サービスでは、WebCenter Portalのディスカッション・サーバーが使用されます。デフォルトのディスカッション・サーバー・アプリケーションでは、英語とスペイン語がサポートされます。表37-1にリストされているその他の言語はサポートされません。ただし、アプリケーションでは独自の翻訳ファイルを使用できます。詳細は、http://www.jivesoftware.com/builds/docs/latest/documentation/developer-guide.html#i18nを参照してください。この情報は、ディスカッション・サーバー・アプリケーションのユーザー・インタフェースを対象としています。

37.2 特定の文字列またはスペースへの編集の制限

特定の文字列や特定のスペースの文字列のみを編集することが必要になる場合があります。その場合、該当する文字列やスペースに関連付けられた値を確認する必要があります。

- 第37.2.1項「文字列のリソース・キーの確認」

- 第37.2.2項「スペースのGUIDの確認」

37.2.1 文字列のリソース・キーの確認

特定の文字列を編集する場合、その文字列を文字列ファイル内で見つけるために、文字列のリソース・キーが必要になります。

文字列のリソース・キーを確認する手順は、次のとおりです。

1. Composerでページまたはリソースを開きます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのComposerでのページ・テンプレートの編集に関する項、スペース内のページの編集に関する項またはタスク・フローの編集に関する項を参照してください。

2. 編集する文字列を含むコンポーネントの編集アイコン(レンチ)をクリックします。

3. 「コンポーネント・プロパティ」ダイアログ・ボックスで、「表示オプション」タブをクリックします。

4. リソース・キーは、「テキスト」ボックス内のテキストの最後の部分です。
たとえば、図37-1は、Announcementsコンポーネントのリソース・キーを示しています。Announcementsという文字列を編集する場合は、リソース・キーANNOUNCEMENTS.TITLEを記録します。

図37-1 Announcementsコンポーネントの表示オプション: リソース・キー

「図37-1 Announcementsコンポーネントの表示オプション: リソース・キー」の説明

37.2.2 スペースのGUIDの確認

特定のスペースのUIテキストやユーザー入力メタデータを編集する場合、スペースのGUIDを確認する必要があります。

スペースのGUIDを確認する手順は、次のとおりです。

1. 編集する文字列を含むスペースに移動します。

2. 「アクション」メニューをクリックし、「情報」を選択して、「このスペース」を選択します。

3. 「このスペース」ダイアログ・ボックスの「内部ID」の値を記録します。

図37-2 スペースのGUID

「図37-2 スペースのGUID」の説明

37.3 文字列の変更

変更対象が、サイト全体のUIテキスト、特定のスペースのUIテキスト、またはスペース内のユーザー入力メタデータのいずれであっても、その変更プロセスは基本的に同じで、該当するファイルをそれぞれ変更するだけです。サイト全体のUIテキストを変更するには、オーバーライド・バンドル(SpacesSeedDataOverrideBundle.xlf)を編集します。特定のスペースのUIテキストやユーザー入力メタデータを変更するには、スペース固有のリソース・バンドル(scope-resource-bundle.xlf)を編集します。

文字列を変更する手順は、次のとおりです。

1. WLSTコマンドのexportMetadataを使用して、文字列ファイルをエクスポートします。

- すべての文字列をエクスポートする場合は、docs属性を含めません。次に例を示します。

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata')

この例では、WC_Spacesサーバー上のwebcenterアプリケーションから、すべての文字列ファイルを/tmp/metadataフォルダにエクスポートしています。アプリケーション名には、常にwebcenterを使用してください。Spacesのインストールをホストするサーバーと一致するようにサーバー名を変更します。toLocationを、文字列ファイルのエクスポート先となる場所に変更します。

- 特定の文字列ファイルのみをエクスポートする場合は、docs属性を含めます。次に例を示します。

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata',docs='/xliffBundles/SpacesSeedDataOverrideBundle.xlf,/oracle/webcenter/translations/scopedMD/SPACE_GUID/scope-resource-bundle.xlf')

この例の結果は1つ目の例と似ていますが、サイト全体のオーバーライド・バンドルとスペース固有のリソース・バンドルのみがエクスポートされます。

- サイト全体のUI文字列を編集するには、SpacesSeedDataOverrideBundle.xlfを指す、1つ目のdocsの値を使用します。

- スペース固有のUI文字列とユーザー入力メタデータを編集するには、scope-resource-bundle.xlfを指す、2つ目のdocsの値を使用し、SPACE_GUIDを文字列の変更対象となるスペースのGUIDに置換します。

注意:

複数のファイルをエクスポートするには、ファイルの場所をカンマで区切ります。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項も参照してください。

2. エクスポートした文字列ファイルが格納されているフォルダに移動し、文字列ファイルをテキスト・エディタで開きます。

注意:

編集したファイルを正しくエンコードしないと、翻訳をインポートする際にエラーが発生する場合があります。Oracle JDeveloperは特殊文字を自動的に正しくエンコードするため、Oracle JDeveloperを使用することをお薦めします。

- サイト全体のUIテキストを編集するには、/xliffBundles/SpacesSeedDataOverrideBundle.xlfを開きます。

- スペース固有のUIテキストまたはユーザー入力メタデータを編集するには、/oracle/webcenter/translations/scopedMD/SPACE_ GUID/scope-resource-bundle.xlfを開き、SPACE_GUIDを文字列の変更対象となるスペースのGUIDに置換します。

3. 変更する<trans-unit>ブロックを見つけます。
ID属性(SpacesSeedDataOverrideBundle.xlf)とOBJECTGUID属性(scope-resource-bundle.xlf)は、Composerのコンポーネントを確認した際に記録したリソース・キーと一致します。

たとえば、サイト全体のSpacesSeedDataOverrideBundle.xlfファイルに含まれるAnnouncementsタイトルの<trans-unit>ブロックは、次のとおりです。

<trans-unit id="ANNOUNCEMENTS_TITLE">
<source>Announcements</source>
</trans-unit>

スペース固有のscope-resource-bundle.xlfファイルに含まれるAnnouncementsタイトルの<trans-unit>ブロックは、次のとおりです。

<trans-unit id="SCOPEGUID:s1a448c10_c9b8_429f_bf83_a481d5f9e4bc:SERVICEID:oracle.webcenter.peopleconn:OBJECTTYPE:profile:OBJECTGUID:ANNOUNCEMENTS_TITLE">
<source>Announcements</source>
</trans-unit>

4. <source>ブロック内のテキストをビジネス要件に合わせて編集し、ファイルを保存します。

5. WLSTコマンドのimportMetadataを使用して、更新された文字列ファイルをSpacesにインポートします。次に例を示します。

- すべての文字列をインポートする場合は、docs属性を含めません。次に例を示します。

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata')

この例では、/tmp/metadataフォルダから、すべての文字列ファイルをWC_Spacesサーバー上のwebcenterアプリケーションにインポートしています。fromLocationを、文字列ファイルのインポート元となる場所に変更します。アプリケーション名には、常にwebcenterを使用してください。Spacesのインストールをホストするサーバーと一致するようにサーバー名を変更します。

- 特定の文字列ファイルのみをインポートする場合は、docs属性を含めます。

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata',docs='/xliffBundles/SpacesSeedDataOverrideBundle.xlf,/oracle/webcenter/translations/scopedMD/SPACE_GUID/scope-resource-bundle.xlf')

この例の結果は1つ目の例と似ていますが、サイト全体のオーバーライド・バンドルとスペース固有のリソース・バンドルのみがインポートされます。

- サイト全体のUI文字列をインポートするには、SpacesSeedDataOverrideBundle.xlfを指す、1つ目のdocsの値を使用します。

- スペース固有のUI文字列とユーザー入力メタデータをインポートするには、scope-resource-bundle.xlfを指す、2つ目のdocsの値を使用し、SPACE_GUIDを文字列の変更対象となるスペースのGUIDに置換します。

注意:

複数のファイルをインポートするには、ファイルの場所をカンマで区切ります。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項も参照してください。

6. WC_Spaces管理対象サーバーを再起動し、変更がUIの表示に反映されていることを確認します。

37.4 Spacesへの新規言語のサポートの追加

デフォルトでサポートされていない言語をSpacesでサポートする必要がある場合、新規言語の文字列ファイルを提供し、supported-languages.xml構成ファイル内で、新規言語に対応する<language>タグを追加します。

新規言語のサポートを追加する手順は、次のとおりです。

1. WLSTコマンドのexportMetadataを使用して、文字列ファイルをエクスポートします。次に例を示します。

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata')

この例では、WC_SpacesサーバーにデプロイされたSpacesアプリケーション(webcenter)のすべての文字列ファイルを/tmp/metadataフォルダにエクスポートしています。必要に応じて、Spacesのインストールに一致するようにサーバー名を変更します。toLocationを、文字列ファイルのエクスポート先となる場所に変更する必要があります。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項も参照してください。

2. 翻訳する各文字列ファイルの言語またはロケール固有のバージョンを作成します。たとえば、サイト全体のUIテキストをカタロニア語に翻訳するには、SpacesSeedDataOverrideBundle_ca.xlfを作成します。

- サイト全体のUIテキストを翻訳するには、/xliffBundles/SpacesSeedDataOverrideBundle.xlfをコピーします。

- スペース固有のUIテキストまたはユーザー入力メタデータを翻訳するには、/oracle/webcenter/translations/scopedMD/SPACE_ GUID/scope-resource-bundle.xlfをコピーし、SPACE_GUIDをスペースのGUIDに置換します。

注意:

新規言語のサポートが必要なスペースは、おそらくごく少数です。ただし、スペースを新しくサポートされた言語に翻訳することが必要になる場合もあります(会社全体のスペースなど)。

3. 言語またはロケールに固有の各文字列ファイルを、次のように翻訳します。

1. コピーしたいずれかの文字列ファイルを、テキスト・エディタで開きます。

注意:

編集したファイルを正しくエンコードしないと、翻訳をインポートする際にエラーが発生する場合があります。Oracle JDeveloperは特殊文字を自動的に正しくエンコードするため、Oracle JDeveloperを使用することをお薦めします。

2. 各<trans-unit>ブロックの<source>に含まれるテキストを翻訳します。
サイト全体のSpacesSeedDataOverrideBundle.xlfファイルに含まれる<trans-unit>ブロックの例を次に示します。

<trans-unit id="ANNOUNCEMENTS_TITLE">
<source>Announcements</source>
</trans-unit>

スペース固有のscope-resource-bundle.xlfファイルに含まれる<trans-unit>ブロックの例を次に示します。

<trans-unit id="SCOPEGUID:s1a448c10_c9b8_429f_bf83_a481d5f9e4bc:SERVICEID:oracle.webcenter.peopleconn:OBJECTTYPE:profile:OBJECTGUID:ANNOUNCEMENTS_TITLE">
<source>Announcements</source>
</trans-unit>

3. ファイルを保存します。

4. 翻訳する文字列ファイルごとに、上記の手順を繰り返します。

4. WLSTコマンドのimportMetadataを使用して、更新された文字列ファイルをSpacesにインポートします。次に例を示します。

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata')

この例では、/tmp/metadataフォルダから、すべての文字列ファイルをWC_SpacesサーバーにデプロイされたSpacesアプリケーション(webcenter)にインポートしています。必要に応じて、Spacesのインストールに一致するようにサーバー名を変更します。fromLocationを、文字列ファイルのインポート元となる場所に変更します。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項も参照してください。

5. 新規言語をsupported-languages.xmlファイルに追加します。

1. Oracle JDeveloperで、supported-languages.xmlを開きます。

2. 新規言語の<language>タグを追加します。たとえば、カタロニア語をサポートするには、次のコードを追加します。

<language name="Catilina" id="ca" used="true" translated="true"/>

name属性の値には、UIに表示する言語名を指定します。

id属性の値には、翻訳された文字列ファイルの接尾辞として追加した言語IDを指定します。

6. 更新された言語リストを、次のようにデプロイします。

1. デプロイメント・プロファイルで、CustomLanguageAdditionsプロジェクトが選択されていることを確認します。

2. カスタマイズされたSpaces .WARをビルドしてデプロイします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のJDeveloperを使用したスペースの拡張に関する項を参照してください。

7. WC_Spaces管理対象サーバーを再起動し、変更がユーザー・インタフェースに反映されたことを確認します。

37.5 コンテンツ・プレゼンタ・テンプレートによる翻訳済コンテンツの表示

翻訳されたコンテンツを表示するには、表示言語を参照するコンテンツ・プレゼンタ・テンプレートを作成した後、コンテンツを言語固有のフォルダから表示する必要があります。コンテンツ・プレゼンタ・テンプレートの作成の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のコンテンツ・プレゼンタ表示テンプレートの作成に関する項を参照してください。

38 Oracle WebCenter Portalのパフォーマンスの監視

Fusion Middleware Controlコンソールには、WebCenter Portalアプリケーションで使用されるプロデューサやポートレットを含むWebCenter Portalアプリケーション(FrameworkアプリケーションおよびSpacesアプリケーション)のリアルタイム・パフォーマンスを監視するためのWebベース・ユーザー・インタフェースが備わっています。

パフォーマンス監視は、管理者が環境内の問題やパフォーマンスのボトルネックを特定する際に役立ちます。この章では、WebCenter Portalアプリケーションで使用できる様々なパフォーマンス・メトリックと、Fusion Middleware ControlからWebCenter Portalアプリケーションを監視する方法について説明します。また、WebCenter Portal診断ログ・ファイルに記録された情報を分析して問題のトラブルシューティングを行う方法についても説明します。

WebCenter Portalアプリケーションを定期的に監視する管理者は、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。

この章の内容は次のとおりです。

- 第38.1項「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」

- 第38.2項「パフォーマンス情報の表示」

- 第38.3項「ログ情報の表示および構成」

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdmin、Operator、Monitorロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

38.1「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」

管理者は、Fusion Middleware Controlを使用して、WebCenter Portalアプリケーションを構成するすべてのコンポーネントとサービス、およびWebCenter Portalアプリケーション全体のパフォーマンスと可用性を監視できます。

表示される情報を最大限に活用するには、パフォーマンス・メトリックの計算方法とその意味を理解することが重要です。ここでは、参照用にWebCenter Portalのすべてのパフォーマンス・メトリックを一覧表示して説明します。示されているソーシャル・ネットワーキング、個人の生産性、およびコラボレーションに関するサービスのメトリックをすべて使用できるアプリケーション(Spacesアプリケーションなど)もあれば、ここに示されているサービスのうち1つまたは2つしか使用できないアプリケーションもあります。

この項の内容は次のとおりです。

- 第38.1.1項「WebCenter Portalのメトリック収集: 最近の履歴および起動時以降」

- 第38.1.2項「共通のWebCenter Portalのメトリック」

- 第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」

- 第38.1.4項「WebCenter Portalサービス固有のメトリック」

- 第38.1.5項「WebCenter Portalサービス固有のパフォーマンスの問題およびアクション」

- 第38.1.6項「スペースのメトリック」

- 第38.1.7項「ページのメトリック」

38.1.1 WebCenter Portalのメトリック収集: 最近の履歴および起動時以降

Oracle WebCenter Portalでは、パフォーマンス・メトリックが自動的に有効になります。つまり、パフォーマンス・メトリックを収集するために、オプションの設定や追加構成の実行は必要ありません。アプリケーションの実行が遅い場合やハングアップした場合など、問題が発生したときは、Fusion Middleware Controlがリアルタイム・データを提供するので、問題に関する詳細を調べるために特定のメトリックを参照できます。

Oracle WebCenter Portalについて、次のメトリックが収集されます。

- 起動時以降: WebCenter PortalアプリケーションをホスティングするWebLogic Serverが稼働中である場合に常に、リアルタイム・メトリックは使用可能です。コンテナの起動以後に収集または集計されるリアルタイム・メトリックは、WebCenter Portalについて「起動時以降」として表示されます。こうしたメトリックは、WebLogic Serverの存続期間にわたり集計されたデータを提供します。ここで集計されるデータによって、システム全体のパフォーマンスを把握し、「最近の履歴」に示された最近のリクエストのパフォーマンスと比較できます。

注意:

メトリック収集は、コンテナの再起動後にあらためて開始します。再起動前に収集されたデータは使用できなくなります。

- 最近の履歴: 起動時以降のメトリックに加えてOracle WebCenter Portalのメトリックでは、5分ごとにパフォーマンス・データを取得するように構成できます。このメトリック・データは、起動時以降のメトリックとともに使用され、最近の履歴のメトリックとして使用可能です。

- 「最近の履歴」に表示されるすべてのメトリックは、最近のメトリックを使用して計算されます。たとえば、サービスが短時間使用される場合で、過去15分についてはまったくアクセスされないときは、そのサービスの起動時以降のメトリックでは0より大きい値が表示されるのに対して、そのサービスの最近の履歴のメトリックはすべて0になります。最近の履歴のメトリックによって、ごく最近のランタイム・アクセスから収集されたデータに基づいて、ライブ・サイトのリアルタイムのパフォーマンスを評価できます。
通常、「最近の履歴」では最も新しい10-15分のデータが表示されます。ただし、過去10-15分のデータが反映されない場合があります。

- WebLogic Serverが起動してすぐの場合で、実行期間が10-15分未満のときは、「最近の履歴」にはサーバーが稼働中の期間のデータが表示されます。

- メトリック・リクエストが長期間検出されない場合、メトリック収集は一時的に中止されます。クライアントが次にメトリックをリクエストすると、収集が再開します。メトリック収集が停止した場合、「最近の履歴」では当初、メトリック収集の停止以降の期間についてデータが表示されます。メトリック収集が再開するとすぐに、最新の10-15分のメトリックのデータが表示され始めます。

ライブ・サイトの診断時に、WebCenter Portalのメトリックのページに移動し、「サービス・サマリー」セクションでアクティブに使用されているサービスや予想よりも遅いサービスを特定できます。タイムスタンプの横にある「リフレッシュ」アイコンをクリックすると、メトリックがライブ・データによりリフレッシュされます。次に、特定のサービスをクリックし、それを繰り返すことで長い時間がかかっているサービス内の操作を特定します。必要であれば、そのサービスを使用するアプリケーションのページに移動し、より詳細なデータを取得するためにランタイム・メトリックをトリガーするようにアプリケーションを設定します。

38.1.2 共通のWebCenter Portalのメトリック

Fusion Middleware Controlでは、WebCenter Portalのサービスのパフォーマンスを次の方法で監視する機能が用意されています。

- サービス・サマリー: WebCenter Portalアプリケーションで使用されている各サービスのパフォーマンス・メトリックのサマリーです。表38-1に、共通のパフォーマンス・メトリックを使用するサービスを示します。表38-2では、サービスのメトリックについて説明しています。

- 最もポピュラーな操作および個別のサービス操作のレスポンス時間。表38-3で、これらのメトリックについて説明します。

- 操作別メトリック: 個別のサービス操作のパフォーマンス・メトリック。表38-1に、個別の操作のパフォーマンスを監視するために使用される共通のパフォーマンス・メトリックを示します。表38-3で、これらのメトリックについて説明します。

表38-1 共通のパフォーマンス・メトリック

サービス

サービス・サマリー(起動時以降および最近の履歴)

操作別メトリック(起動時以降および最近の履歴)

お知らせ

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

BPELワークリスト

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

該当なし

ディスカッション・フォーラム

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

外部アプリケーション

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

イベント

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

インポート/エクスポート

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

インスタント・メッセージおよびプレゼンス(IMP)

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

リスト

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

メール

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ノート

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ページ

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ピープル・コネクション

パフォーマンス・メトリックには、次のものが含まれます。

- 平均処理時間(ミリ秒)

- 呼出し数

- 成功した呼出し(%)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

投票

パフォーマンス・メトリックには、次のものが含まれます。

- 平均処理時間(ミリ秒)

- 呼出し数

- 成功した呼出し(%)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

最近のアクティビティ

パフォーマンス・メトリックには、次のものが含まれます。

- 平均時間(ミリ秒)

- 成功した呼出し(%)

- 呼出し数

なし

RSS

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

なし

検索

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し数

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

表38-2では、すべての操作のパフォーマンスを監視するために使用されるメトリックについて説明します。

表38-2 共通メトリックの説明: サマリー(すべての操作)

メトリック

説明

ステータス

サービスの現在のステータス:

- 稼働中(緑色の上矢印): サービスが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): サービスが現在使用できないことを示します。最後の操作が予期しないエラーまたは例外により失敗しました。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。

- 不明(時計): サービスがなんらかの理由でWebCenter Portalアプリケーションのステータスを問い合せることができないことを示します。

成功した呼出し(%)

成功したサービス呼出しの割合。成功した呼出し(%)は、成功した呼出し数を呼出し数で除算した値に一致します。

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

このメトリックは、1分当たりのサービス呼出し数を示します。

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたWebCenter Portalサービスを特定できます。

平均時間(ミリ秒)

サービスに関連付けられた操作の処理にかかった平均時間。このメトリックは、サービス操作の処理に費やされた総時間を評価するために呼出し数のメトリックとともに使用できます。

- 起動時以降

- 最近の履歴

表38-3では、サービスまたはコンポーネントによって実行される各操作のパフォーマンスを監視するために使用されるメトリックについて説明します。

表38-3 共通メトリックの説明: 操作別

メトリック

説明

最もポピュラーな操作

各操作の起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されている操作を示します。

最小値は、最も使用されていない操作を示します。

レスポンス時間

WebCenterアプリケーションが起動されてから、サービスに関連付けられた操作の処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低い操作を示します。

最小値は、パフォーマンスが最も高い操作を示します。

操作

監視対象の操作。第38.1.4項「WebCenter Portalサービス固有のメトリック」も参照してください。

呼出し数

各操作の起動回数:

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたWebCenter Portalサービスを特定できます。

平均時間(ミリ秒)

各操作の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

最大時間(ミリ秒)

各操作の処理にかかった最大時間。

38.1.3 共通のWebCenter Portalのパフォーマンスの問題およびアクション

この項では、一般的なパフォーマンスに関連する問題を特定する場合に役立つ情報を示します。

メトリックが範囲外である場合は、次のことを行います。

- メモリー、CPU、ネットワーク、外部プロセスなどの要素を含めて、システム・リソースをチェックします。

- 問題がシステム全体のものか、特定のサービスに関するものかを判断するために他のメトリックをチェックします。

- 問題が特定のサービスに関連する場合は、バックエンド・サーバーが停止していないかどうか、また過負荷ではないかどうかをチェックします。

- WebLogic Serverを長期間実行している場合は、起動時以降のメトリックと最近の履歴のメトリックを比較し、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断します。

- サービスに関連する接続の構成情報を確認し、間違っていないかどうか、またはすでに無効ではないかどうかを調べます。付録A「WebCenter Portalの構成」も参照してください。

- サービスのステータスが「停止中」であるか、機能しない操作がある場合、ダイレクトURLによりバックエンド・サーバーの検証、テストおよびpingを行います。詳細は、該当する章の接続のテストに関する項を参照してください。各章のリストは、第IV部「サービス、ポートレット・プロデューサおよび外部アプリケーションの管理」を参照してください。
サービスが再構成されている場合で、コンテナが変更の適用のために再起動されていないときは、サービスは使用できなくなります。

38.1.4 WebCenter Portalサービス固有のメトリック

この項では、すべてのサービスおよびコンポーネントの操作別メトリックについて説明します。この項の内容は次のとおりです。

- 第38.1.4.1項「お知らせのメトリック」

- 第38.1.4.2項「BPELワークリストのメトリック」

- 第38.1.4.3項「コンテンツ・リポジトリのメトリック」

- 第38.1.4.4項「ディスカッションのメトリック」

- 第38.1.4.6項「外部アプリケーションのメトリック」

- 第38.1.4.5項「イベントのメトリック」

- 第38.1.4.7項「インスタント・メッセージおよびプレゼンス(IMP)のメトリック」

- 第38.1.4.8項「インポートおよびエクスポートのメトリック」

- 第38.1.4.9項「リストのメトリック」

- 第38.1.4.10項「メールのメトリック」

- 第38.1.4.11項「ノートのメトリック」

- 第38.1.4.12項「ページのメトリック」

- 第38.1.4.13項「ポートレット・プロデューサのメトリック」

- 第38.1.4.14項「ポートレットのメトリック」

- 第38.1.4.15項「ピープル・コネクションのメトリック」

- 第38.1.4.16項「投票のメトリック」

- 第38.1.4.17項「RSSニュース・フィードのメトリック」

- 第38.1.4.18項「最近のアクティビティのメトリック」

- 第38.1.4.19項「検索のメトリック」

WebCenter Portalアプリケーションの現在のパフォーマンスを確認するには、第38.2項「パフォーマンス情報の表示」を参照してください。

38.1.4.1 お知らせのメトリック

お知らせサービスに関連するパフォーマンス・メトリック(図38-1)については、表38-4および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-1 お知らせのメトリック

「図38-1 お知らせのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-4 お知らせサービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

(お知らせサービスにアクセスしている)WebCenter Portalユーザーが、お知らせをホストしているディスカッション・サーバーにログインします。

サービス固有の原因については、第38.1.5.1項「お知らせサービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ログアウト

WebCenter Portalユーザーが、お知らせをホストしているディスカッション・サーバーからログアウトします。

サービス固有の原因については、第38.1.5.1項「お知らせサービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

お知らせテキスト内の文字列を検索します。

お知らせの検索に失敗する場合は、お知らせのテキストに検索文字列が含まれていることを確認します。

その他の原因については、第38.1.5.1項「お知らせサービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

作成

お知らせを作成します。

サービス固有の原因については、第38.1.5.1項「お知らせサービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

リスト

お知らせのリストを取得します。

サービス固有の原因については、第38.1.5.1項「お知らせサービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.2 BPELワークリストのメトリック

BPELワークリスト・サービスに関連するパフォーマンス・メトリック(図38-2)については、第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-2 BPELワークリストのメトリック

「図38-2 BPELワークリストのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

38.1.4.3 コンテンツ・リポジトリのメトリック

次の表では、ドキュメント・サービスおよびコンテンツ・プレゼンタに関連するパフォーマンス・メトリック(図38-3および図38-4)について説明します。

- 表38-5「コンテンツ・リポジトリ: 監視対象の操作」

- 表38-6「コンテンツ・リポジトリのメトリック: サマリー(すべてのリポジトリ)」

- 表38-7「コンテンツ・リポジトリのメトリック: 各リポジトリの操作サマリー」

- 表38-8「コンテンツ・リポジトリのメトリック: 各リポジトリの操作詳細」

図38-3 コンテンツ・リポジトリのメトリック

「図38-3 コンテンツ・リポジトリのメトリック」の説明

図38-4 コンテンツ・リポジトリのメトリック: 操作別

「図38-4 コンテンツ・リポジトリのメトリック: 操作別」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-5「コンテンツ・リポジトリ: 監視対象の操作」

操作

説明

パフォーマンス問題: ユーザー処理

ダウンロード

1つ以上のドキュメントをコンテンツ・リポジトリからダウンロードします。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

アップロード

1つ以上のドキュメントをコンテンツ・リポジトリにアップロードします。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

コンテンツ・リポジトリに格納されているドキュメントを検索します。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ログイン

コンテンツ・リポジトリへの接続を確立し、ユーザーを認証します。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

削除

コンテンツ・リポジトリに格納されている1つ以上のドキュメントを削除します。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

フォルダのリスト

コンテンツ・リポジトリに格納されているフォルダのリストを表示します。この操作は、コンテンツ・プレゼンタに固有のものです。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

項目の取得

コンテンツ・リポジトリに保存されたドキュメントやイメージなどの項目を表示します。この操作は、コンテンツ・プレゼンタに固有のものです。

サービス固有の原因については、第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

表38-6「コンテンツ・リポジトリのメトリック: サマリー(すべてのリポジトリ)」

メトリック

説明

ステータス

ドキュメント・サービスの現在のステータス:

- 稼働中(緑色の上矢印): ドキュメント・サービスが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): ドキュメント・サービスが現在使用できないか、サービス・リクエストが失敗していることを示します。これはまた、最後の操作が予期しないエラーまたは例外により失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。
ドキュメント・サービスに問題がある場合は、診断ログを調べて、このサービスが停止した原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

よくある失敗原因は次のとおりです。

- コンテンツ・リポジトリが停止しているか、応答していません。

- アプリケーションと1つ以上のコンテンツ・リポジトリの間にネットワーク接続の問題があります。

- 1つ以上のコンテンツ・リポジトリに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 時計: なんらかの理由でサービスのステータスを問い合せることができません。

成功した呼出し(%)

成功したドキュメント・サービス起動(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

1分当たりのドキュメント・サービスの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたWebCenter Portalサービスを特定できます。

平均時間(ミリ秒)

ドキュメント・サービスに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

最もポピュラーな操作

各操作の起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されている操作を示します。

最小値は、最も使用されていない操作を示します。

レスポンス時間

WebCenter Portalアプリケーションが起動されてから、ドキュメント・サービスに関連付けられた操作の処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低い操作を示します。

最小値は、パフォーマンスが最も高い操作を示します。

ダウンロード・スループット(バイト数/秒)

ドキュメント・サービスによりドキュメントがダウンロードされる速度。

アップロード・スループット(バイト数/秒)

ドキュメント・サービスによりドキュメントがアップロードされる速度。

表38-7 コンテンツ・リポジトリのメトリック: 各リポジトリの操作サマリー

メトリック

説明

ステータス

コンテンツ・リポジトリの現在のステータス:

- 稼働中(緑色の上矢印): コンテンツ・リポジトリが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): コンテンツ・リポジトリが現在使用できないか、サービス・リクエストが失敗していることを示します。これはまた、最後の操作が予期しないエラーまたは例外により失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。
コンテンツ・リポジトリに問題がある場合は、診断ログを調べて、このサービスが停止した原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

よくある失敗原因は次のとおりです。

- コンテンツ・リポジトリが停止しているか、応答していません。

- アプリケーションと1つ以上のコンテンツ・リポジトリの間にネットワーク接続の問題があります。

- 1つ以上のコンテンツ・リポジトリに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 時計: なんらかの理由でサービスのステータスを問い合せることができません。

成功した呼出し(%)

このコンテンツ・リポジトリに対して成功したドキュメント・サービス起動(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

このコンテンツ・リポジトリに対する1分当たりのドキュメント・サービスの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたWebCenter Portalサービスを特定できます。

平均時間(ミリ秒)

このコンテンツ・リポジトリに対してドキュメント・サービスに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

ダウンロードされたバイト数

ドキュメント・サービスによりこのコンテンツ・リポジトリからダウンロードされたデータ量。

ダウンロード・スループット(バイト数/秒)

ドキュメント・サービスによりこのコンテンツ・リポジトリからドキュメントがダウンロードされる速度。

アップロードされたバイト数

ドキュメント・サービスによりこのコンテンツ・リポジトリからアップロードされたデータ量。

アップロード・スループット(バイト数/秒)

ドキュメント・サービスによりこのコンテンツ・リポジトリからドキュメントがアップロードされる速度。

最大時間(ミリ秒)

このコンテンツ・リポジトリに対してドキュメント・サービスに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった最大時間:

表38-8 コンテンツ・リポジトリのメトリック: 各リポジトリの操作詳細

メトリック

説明

呼出し数

操作別のドキュメント・サービスの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたWebCenter Portalサービスを特定できます。

平均処理時間(ミリ秒)

ドキュメント・サービスに関連付けられた各操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

38.1.4.4 ディスカッションのメトリック

ディスカッション・サービスに関連するパフォーマンス・メトリック(図38-5)については、表38-9および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-5 ディスカッションのメトリック

「図38-5 ディスカッションのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-9 ディスカッション・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

(ディスカッション・サービスにアクセスしている)WebCenter Portalユーザーが、ディスカッション・フォーラムをホストしているディスカッション・サーバーにログインします。

サービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ログアウト

WebCenter Portalユーザーが、ディスカッション・フォーラムをホストしているディスカッション・サーバーからログアウトします。

サービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

フォーラムの作成

ディスカッション・サーバー内に、特定のカテゴリに含まれるディスカッション・フォーラムを作成します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- ディスカッション・フォーラムを作成する必要があるカテゴリが削除されました。

- ユーザーにディスカッション・フォーラムを作成する権限がありません。

他のサービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

トピックの作成

ディスカッション・サーバー内に、特定のフォーラムに含まれるトピックを作成します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- トピックを作成する必要があるディスカッション・フォーラムが削除されました。

- ユーザーにトピックを作成する権限がありません。

他のサービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

フォーラムのリスト

ディスカッション・サーバーから、特定のカテゴリ内のフォーラムのリストを取得します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- ユーザーにカテゴリのフォーラムを表示する権限がありません。

- フォーラムをフェッチするカテゴリが削除されました。

他のサービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

トピックのリスト

ディスカッション・サーバーから、特定のフォーラム内のトピックのリストを取得します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- ユーザーにフォーラムのトピックを表示する権限がありません。

- トピックをフェッチするフォーラムが削除されました。

他のサービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

ディスカッション・サーバーでディスカッション・フォーラム内の文字列を検索します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- 指定の検索文字列を含むトピック/メッセージが存在しません。

- 検索文字列オブジェクトが存在するカテゴリまたはフォーラムが削除されました。

他のサービス固有の原因については、第38.1.5.4項「ディスカッション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.5 イベントのメトリック

イベント・サービスに関連するパフォーマンス・メトリックについては、表38-10および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-6 イベントのメトリック

「図38-6 イベントのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-10 イベント・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

イベントの作成

WebCenter Portalのリポジトリでスペースまたは個人イベントを作成します。

サービス固有の原因については、第38.1.5.6項「イベント・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

イベントの更新

WebCenter Portalのリポジトリに保存されたスペースまたは個人イベントを更新します。

サービス固有の原因については、第38.1.5.6項「イベント・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

イベントの削除

WebCenter Portalのリポジトリでスペースまたは個人イベントを削除します。

サービス固有の原因については、第38.1.5.6項「イベント・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

イベントのリスト

WebCenter Portalのリポジトリからイベントのリストを取得します。

サービス固有の原因については、第38.1.5.6項「イベント・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

イベントの検索

イベント・テキスト内の文字列を検索します。

サービス固有の原因については、第38.1.5.6項「イベント・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.6 外部アプリケーションのメトリック

外部アプリケーション・サービスに関連するパフォーマンス・メトリックについては、表38-11および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-7 外部アプリケーションのメトリック

「図38-7 外部アプリケーションのメトリック」の説明

図38-8 外部アプリケーションのメトリック: 操作別

「図38-8 外部アプリケーションのメトリック: 操作別」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-11 外部アプリケーション: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

資格証明のフェッチ

外部アプリケーションの資格証明を取得します。

サービス固有の原因については、第38.1.5.5項「外部アプリケーション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

資格証明の格納

外部アプリケーションのユーザー資格証明を格納します。

サービス固有の原因については、第38.1.5.5項「外部アプリケーション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

外部アプリケーションのフェッチ

外部アプリケーションを取得します。

サービス固有の原因については、第38.1.5.5項「外部アプリケーション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

自動ログイン

WebCenter Portalユーザーが(自動ログイン機能を使用して)外部アプリケーションにログインします。

サービス固有の原因については、第38.1.5.5項「外部アプリケーション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.7 インスタント・メッセージおよびプレゼンス(IMP)のメトリック

インスタント・メッセージおよびプレゼンス(IMP)サービスに関連するパフォーマンス・メトリック(図38-9)については、表38-12および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-9 IMPのメトリック

「図38-9 IMPのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-12 インスタント・メッセージおよびプレゼンス・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

プレゼンスの取得

IMPサーバーからユーザー・プレゼンス情報を取得します。

サービス固有の原因については、第38.1.5.7項「インスタント・メッセージおよびプレゼンス(IMP)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ログイン

(IMPサービスにアクセスしている)WebCenter PortalユーザーがIMPサーバーにログインします。

サービス固有の原因については、第38.1.5.7項「インスタント・メッセージおよびプレゼンス(IMP)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ログアウト

(IMPサービスにアクセスしている)WebCenter PortalユーザーがIMPサーバーからログアウトします。

サービス固有の原因については、第38.1.5.7項「インスタント・メッセージおよびプレゼンス(IMP)サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.8 インポートおよびエクスポートのメトリック

インポートおよびエクスポート・サービスに関連するパフォーマンス・メトリック(図38-10)については、表38-13および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。これらのメトリックは、スペースにのみ適用されます。

図38-10 インポート/エクスポートのメトリック

「図38-10 インポート/エクスポートのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-13 インポート/エクスポート: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

エクスポート

WebCenter Portalアプリケーション全体をエクスポートします。

サービス固有の原因については、第38.1.5.8項「インポートおよびエクスポート」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

インポート

WebCenter Portalアプリケーション全体をインポートします。

サービス固有の原因については、第38.1.5.8項「インポートおよびエクスポート」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.9 リストのメトリック

(WebCenter Portal: Spacesのみ)リスト・サービスに関連するパフォーマンス・メトリック(図38-11)については、表38-14および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-11 リストのメトリック

「図38-11 リストのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-14 リスト・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

リストの作成

ユーザー・セッション内でリストを作成します。

「データの保存」操作を実行すると、新しいリストがMDSリポジトリに対してコミットされます。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

リストのコピー

ユーザー・セッション内でリストおよびそのデータをコピーします。

「データの保存」操作を実行すると、コピーしたリストおよびリスト・データがMDSリポジトリとWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

リストの削除

ユーザー・セッション内でリストおよびそのデータを削除します。

「データの保存」操作を実行すると、リストの変更がMDSリポジトリとWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

行の作成

ユーザー・セッション内でリスト・データの行を作成します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

行の更新

ユーザー・セッション内でリスト・データの行を更新します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

行の削除

ユーザー・セッション内でリスト・データの行を削除します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

メタデータ・リポジトリからIDによりリストを取得します。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

データの保存

(ユーザー・セッション内の)リストおよびリスト・データのすべての変更をメタデータ・サービス・リポジトリとWebCenter Portalのリポジトリ(リスト情報の格納先のデータベース)に保存します。

サービス固有の原因については、第38.1.5.9項「リスト・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.10 メールのメトリック

メール・サービスに関連するパフォーマンス・メトリック(図38-12)については、表38-15および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-12 メールのメトリック

「図38-12 メールのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-15 メール・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

WebCenter Portalユーザーが、メール・サービスをホストしているメール・サーバーにログインします。

サービス固有の原因については、第38.1.5.10項「メール・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ログアウト

WebCenter Portalユーザーが、メール・サービスをホストしているメール・サーバーからログアウトします。

サービス固有の原因については、第38.1.5.10項「メール・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

受信

メールを受信します。

サービス固有の原因については、第38.1.5.10項「メール・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

送信

メールを送信します。

サービス固有の原因については、第38.1.5.10項「メール・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

特定の文字列を含むメールを検索します。

サービス固有の原因については、第38.1.5.10項「メール・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.11 ノートのメトリック

ノート・サービスに関連するパフォーマンス・メトリック(図38-13)については、表38-16および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-13 ノートのメトリック

「図38-13 ノートのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-16 ノート・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

作成

個人用ノートを作成します。

「変更の保存」操作を実行すると、新しいノートがMDSリポジトリに対してコミットされます。

サービス固有の原因については、第38.1.5.11項「ノート・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

更新

個人用ノートを更新します。

「変更の保存」操作を実行すると、ノートの更新がMDSリポジトリに対してコミットされます。

サービス固有の原因については、第38.1.5.11項「ノート・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

MDSリポジトリからノートを取得します。

サービス固有の原因については、第38.1.5.11項「ノート・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

削除

MDSリポジトリからノートを削除します。

サービス固有の原因については、第38.1.5.11項「ノート・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.12 ページのメトリック

ページ・サービスに関連するパフォーマンス・メトリック(図38-14)については、表38-17および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-14 ページのメトリック

「図38-14 ページのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-17 ページ・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

作成

WebCenter Portalアプリケーション内にページを作成します。

サービス固有の原因については、第38.1.5.12項「ページ・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

コピー

ページをコピーします。

サービス固有の原因については、第38.1.5.12項「ページ・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

削除

ページを削除します。

サービス固有の原因については、第38.1.5.12項「ページ・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

検索

特定の文字列を含むページを検索します。

サービス固有の原因については、第38.1.5.12項「ページ・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.13 ポートレット・プロデューサのメトリック

次の各表に、ポートレット・プロデューサに関連するパフォーマンス・メトリック(図38-15)を示します。

- 表38-18「ポートレット・プロデューサ: サマリー」

- 表38-19「ポートレット・プロデューサ: 詳細」

図38-15 ポートレット・プロデューサのメトリック

「図38-15 ポートレット・プロデューサのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-18 ポートレット・プロデューサ: サマリー

メトリック

説明

ステータス

WebCenter Portalアプリケーションで使用されているポートレット・プロデューサの現在のステータス

- 稼働中(緑色の上矢印): すべてのポートレット・プロデューサが稼働中であることを示します。

- 停止中(赤色の下矢印): 1つ以上のポートレット・プロデューサが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

- 時計: なんらかの理由でポートレット・プロデューサのステータスを問い合せることができません。

成功した呼出し(%)

成功したポートレット・プロデューサ起動の割合:

- 起動時以降

- 最近の履歴

リクエストが失敗すると、可用性に影響します。これには、WebCenter Portalアプリケーションに関連する失敗(タイムアウトや内部エラーなど)やクライアント/サーバーの失敗(レスポンス・コードHTTP4xxまたはHTTP5xxで返されたリクエスト、不正なコンテンツ・タイプが含まれるレスポンス、SOAP障害(該当する場合)など)があります。

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

1分当たりのポートレット・プロデューサの呼出し数:

- 起動時以降

- 最近の履歴

このメトリックでは、WebCenter Portalアプリケーションに関連する各ポートレット・リクエストが測定されます。このため、アプリケーションのキャッシュ・ヒット、エラーまたはタイムアウトにより、この合計はプロデューサ・サーバーに対して送信された実際のHTTPリクエスト数よりも多くなることがあります。

平均時間(ミリ秒)

ポートレット・リクエストにかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

表38-19 ポートレット・プロデューサ: 詳細

メトリック

説明

最もポピュラーなプロデューサ

各プロデューサの起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されているポートレット・プロデューサを示します。

最小値は、最も使用されていないポートレット・プロデューサを示します。

レスポンス時間

WebCenter Portalアプリケーションが起動されてから、各ポートレット・プロデューサでプロデューサ・リクエストの処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低いポートレット・プロデューサを示します。

最小値は、パフォーマンスが最も高いポートレット・プロデューサを示します。

プロデューサ名

監視対象のポートレット・プロデューサの名前。

ポートレット・プロデューサの名前をクリックすると、アプリケーションで使用される各ポートレットの詳細情報が表示されます。表38-21「ポートレット: 詳細」も参照してください。

ステータス

各ポートレット・プロデューサの現在のステータス:

- 稼働中(緑色の上矢印): ポートレット・プロデューサが稼働中であることを示します。

- 停止中(赤色の下矢印): ポートレット・プロデューサが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

- 時計: なんらかの理由でポートレット・プロデューサのステータスを問い合せることができません。

プロデューサ・タイプ

ポートレット・プロデューサ・タイプ: WebまたはWSRP

- Webポートレット・プロデューサ: J2EEアプリケーション・サーバーにデプロイされます。これは多くの場合リモートであり、Simple Object Access Protocol (SOAP)を使用しHTTPを介して通信します。

- WSRPポートレット・プロデューサ: Web Services for Remote Portlets (WSRP)は、標準対応のコンテナと任意のWSRPアプリケーションの間の相互運用を可能にするWebサービス標準です。

成功した呼出し(%)

成功したプロデューサ起動の割合:

- 起動時以降

- 最近の履歴

呼出し数

各プロデューサの起動回数:

- 起動時以降

- 最近の履歴

この列に基づいて表をソートすると、WebCenter Portalアプリケーションで最も頻繁にアクセスされているポートレット・プロデューサがわかります。

平均時間(ミリ秒)

ポートレット・リクエストにかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

このメトリックは、機能していないポートレット・プロデューサを検出する場合に使用します。このメトリックを「呼出し数」メトリックと組み合せて使用すると、優先的に取り組む必要のあるプロデューサがわかります。

最大時間(ミリ秒)

プロデューサ・リクエストの処理にかかった最大時間。

- 成功 - HTTP200xxレスポンス・コード

- リダイレクト - HTTP300xxレスポンス・コード

- クライアント・エラー数 - HTTP400xxレスポンス・コード

- サーバー・エラー - HTTP500xxレスポンス・コード

38.1.4.14 ポートレットのメトリック

次の各表に、ポートレットに関連するパフォーマンス・メトリック(図38-16)を示します。

- 表38-20「ポートレット: サマリー」

- 表38-21「ポートレット: 詳細」

- 表38-22「ポートレット: HTTPレスポンス・コードの統計」

- 表38-23「HTTPレスポンス・コード」

図38-16 ポートレットのメトリック

「図38-16 ポートレットのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-20 ポートレット: サマリー

メトリック

説明

ステータス

WebCenter Portalアプリケーションで使用されているポートレットの現在のステータス

- 稼働中(緑色の上矢印): すべてのポートレットが稼働中であることを示します。

- 停止中(赤色の下矢印): 1つ以上のポートレットが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。その他の原因については、第38.1.5.13項「ポートレットおよびプロデューサ」を参照してください。

- 時計: なんらかの理由でポートレットのステータスを問い合せることができません。

成功した呼出し(%)

成功したポートレット起動の割合:

- 起動時以降

- 最近の履歴

リクエストが失敗すると、可用性に影響します。これには、タイムアウトや内部エラーなどのWebCenter Portalアプリケーションに関連する失敗、そしてクライアント/サーバー・エラーが含まれます。

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

1分当たりのポートレットの呼出し数:

- 起動時以降

- 最近の履歴

このメトリックでは、WebCenter Portalアプリケーションに関連する各ポートレット・リクエストが測定されます。このため、アプリケーションのキャッシュ・ヒット、エラーまたはタイムアウトにより、この合計はポートレット・プロデューサに対して送信された実際のHTTPリクエスト数よりも多くなることがあります。

平均時間(ミリ秒)

ポートレットに関連付けられた操作の処理にかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

表38-21 ポートレット: 詳細

メトリック

説明

最もポピュラーなポートレット

各ポートレットの起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されているポートレットを示します。

最小値は、最も使用されていないポートレットを示します。

レスポンス時間

WebCenter Portalアプリケーションが起動されてから、各ポートレットでリクエストの処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低いポートレットを示します。

最小値は、パフォーマンスが最も高いポートレットを示します。

ポートレット名

監視対象のポートレットの名前。

ステータス

各ポートレットの現在のステータス:

- 稼働中(緑色の上矢印): ポートレットが稼働中であることを示します。

- 停止中(赤色の下矢印): ポートレットが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

プロデューサ名

ポートレットのアクセスに使用されるポートレット・プロデューサの名前。

プロデューサ・タイプ

ポートレット・プロデューサ・タイプ: WebまたはWSRP

- Webポートレット・プロデューサ: J2EEアプリケーション・サーバーにデプロイされます。これは多くの場合リモートであり、Simple Object Access Protocol (SOAP)を使用しHTTPを介して通信します。

- WSRPポートレット・プロデューサ: Web Services for Remote Portlets (WSRP)は、標準対応のコンテナと任意のWSRPアプリケーションの間の相互運用を可能にするWebサービス標準です。

成功した呼出し(%)

成功したポートレット起動の割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

各ポートレットの起動回数:

- 起動時以降

- 最近の履歴

この列に基づいて表をソートすると、WebCenter Portalアプリケーションで最も頻繁にアクセスされているポートレットがわかります。

平均時間(ミリ秒)

各ポートレットでリクエストの処理にかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

このメトリックは、パフォーマンスの低いポートレットを検出する場合に使用します。このメトリックを「呼出し数」メトリックと組み合せて使用すると、優先的に取り組む必要のあるポートレットがわかります。

最大時間(ミリ秒)

ポートレット・リクエストの処理にかかった最大時間。

- 成功 - HTTP200xx

- リダイレクト - HTTP300xx

- クライアント・エラー数 - HTTP400xx

- サーバー・エラー - HTTP500xx

パフォーマンス統計のHTTPレスポンス・コード別の内訳を調べると、全体の平均レスポンス時間を増加させている要因を特定できます。たとえば、ポートレット・プロデューサ・タイムアウトによる失敗が、全体の平均レスポンス時間を増加させている場合などがあります。

表38-22 ポートレット: HTTPレスポンス・コードの統計

メトリック

説明

ポートレット名

監視対象のポートレットの名前。

呼出し数

- 成功

- リダイレクト

- クライアント・エラー数

- サーバー・エラー

タイプ(HTTPレスポンス・コード)別の呼出し回数:

- 起動時以降

- 最近の履歴

表38-23「HTTPレスポンス・コード」も参照してください。

平均時間(ミリ秒)

- 成功

- リダイレクト

- クライアント・エラー数

- サーバー・エラー

各ポートレットでリクエストの処理にかかった平均時間:

- 起動時以降

- 最近の履歴

このメトリックは、機能していないポートレットを検出する場合に使用します。このメトリックを「呼出し数」メトリックと組み合せて使用すると、優先的に取り組む必要のあるポートレットがわかります。

表38-23 HTTPレスポンス・コード

HTTPレスポンスおよびエラー・コード

説明

200 - リクエスト成功

HTTP2xxレスポンス・コードを返すポートレット・リクエスト、またはリモート・プロデューサにHTTPリクエストを送信しなくても成功したポートレット・リクエスト(たとえば、キャッシュ・ヒットなど)。

300 - 解決できなかったリダイレクト

HTTP3xxレスポンス・コードを返すポートレット・リクエスト。

400 - リクエストを完了できずに失敗

HTTP4xxレスポンス・コードを返すポートレット・リクエスト。

500 - サーバー・エラーのために失敗

なんらかの原因で失敗したポートレット・リクエスト(HTTP5xxレスポンス・コードを返すリクエストや、WebCenter Portalアプリケーションに関連するエラー、タイムアウト、不正なコンテンツ・タイプ・レスポンス、またはSOAP障害が原因で失敗したリクエストを含む)。

38.1.4.15 ピープル・コネクションのメトリック

ピープル・コネクション・サービスに関連するパフォーマンス・メトリックについては、表38-24および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-17 ピープル・コネクションのメトリック

「図38-17 ピープル・コネクションのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-24 ピープル・コネクション・サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

プロファイルの取得

ユーザーのプロファイルを取得します。

サービス固有の原因については、第38.1.5.14項「ピープル・コネクション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

アクティビティの取得

ユーザーのフィルタ・オプションに基づいてアクティビティを取得します。

サービス固有の原因については、第38.1.5.14項「ピープル・コネクション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

アクティビティの公開

ユーザー・セッションのアクティビティを公開し、それをWebCenter Portalアプリケーションに保存します。

サービス固有の原因については、第38.1.5.14項「ピープル・コネクション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

メッセージの取得

ユーザーのメッセージを取得します。

サービス固有の原因については、第38.1.5.14項「ピープル・コネクション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

フィードバックの取得

ユーザーのフィードバックを取得します。

サービス固有の原因については、第38.1.5.14項「ピープル・コネクション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

コネクションの取得

ユーザーの接続を取得します。

サービス固有の原因については、第38.1.5.14項「ピープル・コネクション・サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.16 投票のメトリック

投票サービスに関連するパフォーマンス・メトリック(図38-18)については、表38-25および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-18 投票のメトリック

「図38-18 投票のメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-25 投票サービス: 監視対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

投票の作成

WebCenter Portalアプリケーション内に投票を作成します。

サービス固有の原因については、第38.1.5.15項「投票サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

投票の編集

WebCenter Portalアプリケーション内の投票を編集します。

サービス固有の原因については、第38.1.5.15項「投票サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

投票の削除

進行中の投票を削除します。

サービス固有の原因については、第38.1.5.15項「投票サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

ID別投票の取得

進行中の投票を表示します。

サービス固有の原因については、第38.1.5.15項「投票サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

投票の送信

進行中の投票を送信します。

サービス固有の原因については、第38.1.5.15項「投票サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

結果の分析

投票の結果を分析します。

サービス固有の原因については、第38.1.5.15項「投票サービス」を参照してください。

一般的な原因については、第38.1.3項「共通のWebCenter Portalのパフォーマンスの問題およびアクション」を参照してください。

38.1.4.17 RSSニュース・フィードのメトリック

RSSサービスに関連するパフォーマンス・メトリック(図38-19)については、第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-19 RSSニュース・フィードのメトリック

「図38-19 RSSニュース・フィードのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

38.1.4.18 最近のアクティビティのメトリック

最近のアクティビティ・サービスに関連するパフォーマンス・メトリック(図38-20)については、第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-20 最近のアクティビティのメトリック

「図38-20 最近のアクティビティのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

38.1.4.19 検索のメトリック

検索サービスに関連するパフォーマンス・メトリック(図38-21)については、表38-26および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-21 検索のメトリック

「図38-21 検索のメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

表38-26 検索サービス: 検索ソース

操作

説明

お知らせ

お知らせのテキストが検索されます。

ドキュメント

ファイルおよびフォルダ内のコンテンツが検索されます。

ディスカッション・フォーラム

フォーラムおよびトピックが検索されます。

Spaces

リンク、リスト、ノート、タグ、イベントなど、スペースに保存されたコンテンツが検索されます。

スペース・イベント

スペース・イベントが検索されます。

リンク

リンクが作成された対象のオブジェクトが検索されます(たとえば、お知らせ、ディスカッション・フォーラムのトピック、ドキュメント、イベントなど)。

リスト

リストで保存された情報が検索されます。

ノート

アラームなどのノート・テキストが検索されます。

Oracle Secure Enterprise Search

ドキュメント・ライブラリ・タスク・フロー、ディスカッション、タグ・クラウド、ノート、その他のWebCenter Portalサービスのコンテンツが検索されます。

ページ

アプリケーション・ページ、個人ページ、パブリック・ページ、wikiページおよびブログ・ページに追加されたコンテンツが検索されます。

38.1.5 WebCenter Portalサービス固有のパフォーマンスの問題およびアクション

この項では、サービス固有のパフォーマンスの問題およびそうした問題に対処するのに必要なユーザー・アクションについて説明します。この項の内容は次のとおりです。

注意:

WebCenter Portalサービスのパフォーマンスのチューニングについては、付録A「WebCenter Portalの構成」を参照してください。

- 第38.1.5.1項「お知らせサービス」

- 第38.1.5.2項「BPELワークリスト・サービス」

- 第38.1.5.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス」

- 第38.1.5.4項「ディスカッション・サービス」

- 第38.1.5.5項「外部アプリケーション・サービス」

- 第38.1.5.6項「イベント・サービス」

- 第38.1.5.7項「インスタント・メッセージおよびプレゼンス(IMP)サービス」

- 第38.1.5.8項「インポートおよびエクスポート」

- 第38.1.5.9項「リスト・サービス」

- 第38.1.5.10項「メール・サービス」

- 第38.1.5.11項「ノート・サービス」

- 第38.1.5.12項「ページ・サービス」

- 第38.1.5.13項「ポートレットおよびプロデューサ」

- 第38.1.5.14項「ピープル・コネクション・サービス」

- 第38.1.5.15項「投票サービス」

- 第38.1.5.16項「RSSサービス」

- 第38.1.5.17項「最近のアクティビティ・サービス」

- 第38.1.5.18項「検索サービス」

38.1.5.1 お知らせサービス

お知らせサービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ディスカッション・サーバーが停止しているか、応答していません。

- アプリケーションとディスカッション・サーバーの間にネットワーク接続の問題があります。

- お知らせサービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.2 BPELワークリスト・サービス

BPELワークリスト・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 問合せ対象のBPELサーバーが使用可能ではありません。

- アプリケーションとBPELサーバーの間にネットワーク接続の問題があります。

- ワークリスト・サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.3 コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ)サービス

ドキュメント・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。また、次のいずれかを実行します。

- Oracle WebCenter Content: Content Server(Content Server)およびOracle Portalの場合は、バックエンド・サーバーが稼働していることを確認します。

- Content Serverの場合は、サービスが適切に機能していないクライアントのソケット接続が開いていることを確認します。

- Oracle Portalの場合は、Oracle WebLogic管理コンソールを使用してJDBC接続のステータスを確認します。

- (機能チェック)バックエンド・サーバーのログをチェックします。Content Serverの場合、「Content Server」→「管理」→「ログ・ファイル」→「Content Serverログ」に移動します。Oracle Portalの場合、Fusion Middleware Controlを使用します。

- (機能チェック)モジュール名の先頭がoracle.vcr、oracle.webcenter.content、oracle.webcenter.doclibおよびoracle.stellentであるログ・エントリを検索します。

38.1.5.4 ディスカッション・サービス

ディスカッション・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ディスカッション・サーバーが停止しているか、応答していません。

- アプリケーションとディスカッション・サーバーの間にネットワーク接続の問題があります。

- ディスカッション・サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.5 外部アプリケーション・サービス

外部アプリケーション・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- アプリケーションに対して資格証明ストアが構成されていません。

- 構成されている資格証明ストア(たとえばOracle Internet Directoryなど)が停止しているか、応答していません。

38.1.5.6 イベント・サービス

イベント(スペース・イベントまたは個人イベント)サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- WebCenter Portalのリポジトリ(イベント情報が保存されるデータベース)が使用可能ではありません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

- イベント・サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.7 インスタント・メッセージおよびプレゼンス(IMP)サービス

IMPサービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- インスタント・メッセージおよびプレゼンス・サーバーが使用可能ではありません。

- アプリケーションと、インスタント・メッセージおよびプレゼンス・サーバーの間にネットワーク接続の問題があります。

- IMPサービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.8 インポートおよびエクスポート

インポートおよびエクスポートに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。

38.1.5.9 リスト・サービス

リスト・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- リスト・サービスのデータが格納されているMDSリポジトリまたはWebCenter Portalのリポジトリが使用可能ではありません。

- アプリケーションとリポジトリの間にネットワーク接続の問題があります。

- リスト・サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.10 メール・サービス

メール・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- メール・サーバーが使用可能ではありません。

- アプリケーションとメール・サーバーの間にネットワーク接続の問題があります。

- メール・サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

38.1.5.11 ノート・サービス

ノート・サービスで問題が発生した場合は、MDSリポジトリ(ノート情報が保存されるリポジトリ)が使用不可ではないか、または応答が低速になっていないかをチェックします。

38.1.5.12 ページ・サービス

ページ・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- WebCenter Portalのリポジトリ(ページ情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

38.1.5.13 ポートレットおよびプロデューサ

ポートレット・プロデューサに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ポートレット・プロデューサ・サーバーが停止しているか、応答していません。

- ポートレット・プロデューサに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- プロデューサ・リクエストがタイムアウトしました。

- 特定のプロデューサに関する問題またはそのプロデューサの特定のポートレットに起因するパフォーマンスの問題が存在します。

38.1.5.14 ピープル・コネクション・サービス

ピープル・コネクション・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- サービスが停止しているか、応答していません。

- サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- WebCenter Portalのリポジトリ(ページ情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

38.1.5.15 投票サービス

投票サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- サービスが停止しているか、応答していません。

- サービスに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- WebCenter Portalのリポジトリ(ページ情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

38.1.5.16 RSSサービス

RSSサービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 検索サービスが使用可能ではありません。

- 最近のアクティビティを検索中のサービスが失敗しました。

ディスカッション・データを取得できません。

パフォーマンスの問題が発生する場合は、ディスカッション・サービスのパフォーマンスをチェックします。

リスト・データを取得できません。

パフォーマンスの問題が発生する場合は、リスト・サービスのパフォーマンスをチェックします。

最近のアクティビティのデータを取得できません。

パフォーマンスの問題が発生する場合は、最近のアクティビティ・サービスのパフォーマンスをチェックします。

38.1.5.17 最近のアクティビティ・サービス

最近のアクティビティ・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 検索サービスが使用可能ではありません。

- 最近のアクティビティを検索中のサービスが失敗しました。

38.1.5.18 検索サービス

検索サービス(サービス実行元)に関する問題が発生した場合で、ステータスが「停止中」であるときは、この実行元が使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 実行元のリポジトリが使用可能ではありません。

- アプリケーションと実行元のリポジトリの間にネットワーク接続の問題があります。

- 実行元に関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 検索中のコンテンツ・リポジトリが現在使用できません。

38.1.6 スペースのメトリック

(WebCenter Portal: Spacesのみ)スペース・アクティビティに関連するパフォーマンス・メトリック(図38-22)については、表38-27および第38.1.2項「共通のWebCenter Portalのメトリック」で説明しています。

図38-22 スペースのメトリック

「図38-22 スペースのメトリック」の説明

Fusion Middleware Controlを使用してこれらのメトリックを監視するには、第38.2項「パフォーマンス情報の表示」を参照してください。

データは、次の方法でフィルタ処理できます。

- 「スペース名フィルタ」フィールドを使用して、特定のスペースを検索します。(ホーム・スペースのメトリックは表示されません。)

- 「最大行数」フィールドを使用して、特定の行数を表示します。

- 「表示」ドロップダウン・リストを使用して、最もアクセスされたページ、パフォーマンスが最も低いページ、またはエラー数が最も多いページを表示します。

表38-27 スペースのメトリック

メトリック

説明

Oracle WebCenter Portal: Spaces URL

管理対象のSpacesアプリケーション。

WebLogicサーバー

SpacesアプリケーションがデプロイされているWebLogicサーバー・インスタンス。

J2EEアプリケーション

Spacesアプリケーションの名前。

ページ・レスポンス

スペース・ページの現在の平均レスポンス時間(ミリ秒)。

最もアクティブなスペース

最もアクティブなスペース(つまり、最も多くの呼出しが記録されているスペース)を示すグラフ。

別のスペース・セットを比較するには、表の1つ以上のスペースを選択し、「チャートで表示」をクリックします。

ページ・スループット

各スペースについて1分間に処理された平均ページ数を示すグラフ。

別のスペース・セットを比較するには、表の1つ以上のスペースを選択し、「チャートで表示」をクリックします。

平均処理時間

各スペースの平均ページ処理時間(ミリ秒)を示すグラフ。

別のスペース・セットを比較するには、表の1つ以上のスペースを選択し、「チャートで表示」をクリックします。

ステータス

各スペースの現在のステータス:

- 稼働中(緑色の上矢印): 最後のスペース操作が成功したことを示します。スペースは稼働中です。

- 停止中(赤色の下矢印): スペースが現在使用できないか、予期しないエラーまたは例外のために最後のスペース操作が失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。

成功した呼出し(%)

成功したスペース呼出しの割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

呼出し数

1分当たりのスペースの呼出し数:

- 起動時以降

- 最近の履歴

エラー

スペースで発生した1分当たりのエラー数。

ページ・スループット

各スペースについて1分間に処理された平均ページ数:

- 起動時以降

- 最近の履歴

平均時間(ミリ秒)

スペース・ページを表示するための平均時間(ミリ秒):

- 起動時以降

- 最近の履歴

最大時間(ミリ秒)

スペース・ページの表示にかかった最大時間。

最小時間(ミリ秒)

スペース・ページの表示にかかった最小時間。

38.1.7 ページのメトリック

ページ・アクティビティに関連するパフォーマンス・メトリック(図38-24)については、表38-28で説明しています。SpacesアプリケーションおよびFrameworkアプリケーションに関連するフル・ページおよび部分ページの両方について、ページ・メトリックを表示できます。

フル・ページおよび部分ページのメトリック

フル・ページのメトリックには部分ページのメトリックは含まれません。ページ上のコンポーネントの部分的なページ・レンダリングでは、部分ページのメトリックのみが増加し、フル・ページのメトリックは変化しません。たとえば、ページ上のカレンダのリフレッシュでは、部分ページの呼出しが1増加しますが、フル・ページの呼出しは変化しません。

部分ページ・リクエストでは、ページの部分のみがレンダリングされます。したがって、ページ内のページのパフォーマンスを監視できます。部分ページのリフレッシュ動作は、部分ページ・レンダリング(PPR: partial page rendering)と呼ばれています。PPRにより、ページ全体をリフレッシュする必要なく、ページ上の特定のコンポーネントのみを再レンダリングできます。一般的なシナリオでは、入力コンポーネントでユーザーが選択または入力したものが出力コンポーネントに表示されます。同様に、コマンド・リンクまたはボタンにより、ページ全体がリフレッシュされることなく、ページ上の別のコンポーネントが再レンダリングされる場合があります。たとえば、ユーザーがクイック投票を行い、投票ボタンをクリックすると、クイック投票コンポーネントのみが更新およびレンダリングされます。したがって、フル・ページ呼出しは変化せず、部分ページ呼出しは2増加します。PPRの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』の章「部分ページ・コンテンツの再レンダリング」を参照してください。

注意:

この項で説明するページのメトリックは、第38.1.4.12項「ページのメトリック」で説明したページ・サービスのメトリックとは異なります。サービス・メトリックとして表示されるページ・サービス・メトリックでは、ページの作成など個別の操作が監視されます。この項で説明したスペースのページ・メトリックでは、アクセス時の個別のページ・パフォーマンスが監視されます。 ページ・メトリックでは、ビュー/表示操作のみが取得されます(ページ編集操作は含まれません)。

ページのメトリックの表示

データは、次の方法でフィルタ処理できます。

- 「ページ名フィルタ」フィールドで特定のページを検索します。

- 「スペース名フィルタ」フィールドを使用して、特定のスペースを検索します。(Spacesアプリケーションにのみ該当します)

- 「最大行数」フィールドを使用して、特定の行数を表示します。

- 「表示」ドロップダウン・リストを使用して、最もアクセスされたページ、パフォーマンスが最も低いページ、またはエラー数が最も多いページを表示します。

デフォルトでは、フル・ページのメトリックの「ページ数/分」は非表示です。このメトリックを表示するには、「表示」メニュー→「列」→「起動時以降」/「最近の履歴」→「フル・ページ」→「ページ数/分」(図38-23)に移動します。同様に、必要でない列を非表示にするには、列名を選択解除します。

図38-23 「表示」メニューの「ページ数/分」オプション

「図38-23 「表示」メニューの「ページ数/分」オプション」の説明

メトリックは、カスタム・ページでのみ表示されます。次に示すタイプのページのメトリックは表示されません。

- ホーム・スペースという名前のスペースからの全ページ

- スペースのようこそページ

- ドキュメントやイベントなどのサービス・ページ

図38-24 スペース内のページ・メトリック

「図38-24 スペース内のページ・メトリック」の説明

表38-28 ページのメトリック: フル・ページおよび部分ページ

メトリック

説明

呼出し数

1分当たりのページの呼出し数:

- 起動時以降

- 最近の履歴

平均時間(ミリ秒)

ページを表示するための平均時間(ミリ秒):

- 起動時以降

- 最近の履歴

最大時間(ミリ秒)

ページの表示にかかった最大時間。

エラー(フル・ページのみ)

ページで発生した1分当たりのエラー数。

成功した呼出し(フル・ページのみ)

成功したページ呼出しの割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第38.3項「ログ情報の表示および構成」を参照してください。

38.2 パフォーマンス情報の表示

Fusion Middleware Controlでは、WebCenter Portalアプリケーションの様々なパフォーマンス・メトリックを監視できます。WebCenter Portalアプリケーションで使用される依存サービス、外部アプリケーションおよびポートレット・プロデューサすべてに関するパフォーマンス・データを表示できます。

この項の内容は次のとおりです。

- 第38.2.1項「Spacesアプリケーションの監視」

- 第38.2.2項「Frameworkアプリケーションの監視」

38.2.1 Spacesアプリケーションの監視

管理者は、Spacesアプリケーション全体およびそれを構成するすべてのコンポーネントとサービスのパフォーマンスおよび可用性を監視できます。これらの詳細なメトリックは、パフォーマンス問題の診断に役立ちます。また、定期的に監視すれば、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。

スペースのホームページには、いくつかの主要メトリックが表示されます。最もポピュラーなスペースが一目でわかり、パフォーマンスが最高および最低のスペースなどを特定することができます。詳細は、第38.1.6項「スペースのメトリック」を参照してください。

また、スペースのホームページには、個々のサービス、外部アプリケーション、アプリケーションで使用されるポートレット・プロデューサのステータスとパフォーマンスのサマリーも表示されます。サービスが停止している場合や、実行速度が遅い場合は、より詳細なメトリックにドリルダウンして問題のトラブルシューティングを行い、適切な処理を行うことができます。メトリックの詳細は、第38.1項「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」を参照してください。

この項の内容は次のとおりです。

- 第38.2.1.1項「サービスのメトリックの監視」

- 第38.2.1.2項「スペースのメトリックの監視」

- 第38.2.1.3項「Spacesアプリケーションのページのメトリックの監視」

- 第38.2.1.4項「メトリック・パレットを通じたすべてのメトリックの監視」

38.2.1.1 サービスのメトリックの監視

Spacesアプリケーションのサービスのメトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「監視中」→「サービス・メトリック」を選択します。
「WebCenterポータル・サービス・メトリック」ページの一番上にある「サービス・サマリー」を使用すると、どのサービスが稼働中かがすぐにわかり、Spacesアプリケーションにより使用されているこれらのサービスの個別的および相対的なパフォーマンスを確認できます。

統計は、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスや、一度も使用されていないサービスは、「サマリー」表に表示されません。

3. サービスの名前をクリックして、より詳細なメトリックにドリルダウンします。

個々のメトリックの詳細は、第38.1項「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」を参照してください。

38.2.1.2 スペースのメトリックの監視

Spacesアプリケーション内で作成されたスペースのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「監視中」→「スペース・メトリック」を選択します。

3. 「スペース名フィルタ」フィールドで、スペースの名前を入力し、[Enter]キーを押します。スペース・フィルタ処理オプションの詳細は、第38.1.6項「スペースのメトリック」を参照してください。
または

「名前」列で、パフォーマンス・メトリックを表示するスペースの名前(リンク)をクリックします。図38-25に示すように、選択したスペースのメトリックが表示されます。

図38-25 スペースのメトリック

「図38-25 スペースのメトリック」の説明

38.2.1.3 Spacesアプリケーションのページのメトリックの監視

ページのメトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「監視中」→「ページ・メトリック」を選択します。
使用可能なページ・フィルタ処理オプションについては、第38.1.7項「ページのメトリック」を参照してください。

3. スペース内のすべてのページのメトリックを表示するには、「スペース名フィルタ」フィールドでスペースの名前を入力し、[Enter]キーを押します。図38-26を参照してください。

図38-26 ページのメトリック

「図38-26 ページのメトリック」の説明

4. スペースの特定のページのメトリックを表示するには、「ページ名フィルタ」フィールドでページの名前、「スペース名フィルタ」フィールドでこのページが属するスペースの名前を入力し、[Enter]キーを押します。図38-27を参照してください。

図38-27 スペースのメトリック

「図38-27 スペースのメトリック」の説明

38.2.1.4 メトリック・パレットを通じたすべてのメトリックの監視

Spacesアプリケーション内のスペースおよび関連するページのパフォーマンス・サマリーを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「監視中」→「パフォーマンス・サマリー」を選択します。
「パフォーマンス・サマリー」ページの上部にある 「メトリック・パレットの表示」ボタンを使用して、「メトリック・パレット」を表示します。このパレットでは、稼働中のサービスのメトリックを選択し、個々のサービスのライブ・パフォーマンスをグラフ形式および表形式で確認できます。

統計は、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスや、一度も使用されていないサービスは、パフォーマンス・サマリーのグラフおよび表に表示されません。

3. 「メトリック・パレット」で、サービス・フォルダを開き、メトリックのチェック・ボックスを選択して、グラフ形式または表形式でサービスのパフォーマンスを表示します。
図38-28に、「パフォーマンス・サマリー」ページとメトリック・パレットを示します。「メトリック・パレット」には、WebCenter Portalのパフォーマンス・メトリックに加えて、任意のJ2EEアプリケーションに関連付けられている一般的なパフォーマンス・メトリック(ADFアプリケーション・プールのメトリックなど)も表示されます。メトリックのヘルプ・コンテンツを表示するには、必要なディレクトリ、またはディレクトリ内のメトリックを右クリックし、「ヘルプ」を選択します。

図38-28 WebCenter Portal: Spaces - パフォーマンス・サマリーおよびメトリック・パレット

「図38-28 WebCenter Portal: Spaces - パフォーマンス・サマリーおよびメトリック・パレット」の説明

38.2.2 Frameworkアプリケーションの監視

管理者は、Frameworkアプリケーション全体およびそれを構成するすべてのコンポーネントとサービスのパフォーマンスおよび可用性を監視できます。これらの詳細なメトリックは、パフォーマンス問題の診断に役立ちます。また、定期的に監視すれば、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。

この項の内容は次のとおりです。

- 第38.2.2.1項「サービスのメトリックの監視」

- 第38.2.2.2項「Frameworkアプリケーションのページのメトリックの監視」

- 第38.2.2.3項「メトリック・パレットを通じたすべてのメトリックの監視」

38.2.2.1 サービスのメトリックの監視

Frameworkアプリケーションに関連するサービスのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス・メトリック」を選択します。
「WebCenterサービス・メトリック」ページの一番上にある「サービス・サマリー」を使用すると、どのサービスが稼働中かがすぐにわかり、Frameworkアプリケーションにより使用されているすべてのサービスの個別的および相対的なパフォーマンスを確認できます。

統計は、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスや、一度も使用されていないサービスは、「サービス・サマリー」表に表示されません。

3. サービスの名前をクリックして、より詳細なメトリックにドリルダウンします(図38-28)。メトリックのヘルプ・コンテンツを表示するには、必要なディレクトリ、またはディレクトリ内のメトリックを右クリックし、「ヘルプ」を選択します。

各サービスの個々のメトリックの詳細は、第38.1項「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」を参照してください。

38.2.2.2 Frameworkアプリケーションのページのメトリックの監視

Frameworkアプリケーションに関連するページのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「ページ・メトリック」を選択します。
使用可能なページ・フィルタ処理オプションについては、第38.1.7項「ページのメトリック」を参照してください。

3. ページのメトリックを表示するには、「ページ名フィルタ」フィールドでページの名前を入力し、[Enter]キーを押します。

38.2.2.3 メトリック・パレットを通じたすべてのメトリックの監視

Frameworkアプリケーションのサービスおよびページのパフォーマンス・サマリーを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーション・デプロイメント」メニューから、「パフォーマンス・サマリー」を選択します。
「パフォーマンス・サマリー」ページの上部にある 「メトリック・パレットの表示」ボタンを使用して、「メトリック・パレット」を表示します。このパレットでは、稼働中のサービスのメトリックを選択し、個々のサービスのライブ・パフォーマンスをグラフ形式および表形式で確認できます。

統計は、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスや、一度も使用されていないサービスは、パフォーマンス・サマリーのグラフおよび表に表示されません。

3. 「メトリック・パレット」で、サービス・フォルダを開き、メトリックのチェック・ボックスを選択して、グラフ形式または表形式でサービスのパフォーマンスを表示します。
図38-29に、「パフォーマンス・サマリー」ページとメトリック・パレットを示します。「メトリック・パレット」には、WebCenter Portalのパフォーマンス・メトリックに加えて、任意のJ2EEアプリケーションに関連付けられている一般的なパフォーマンス・メトリック(ADFアプリケーション・プールのメトリックなど)も表示されます。メトリックのヘルプ・コンテンツを表示するには、必要なディレクトリ、またはディレクトリ内のメトリックを右クリックし、「ヘルプ」を選択します。

図38-29 WebCenter Portal: Frameworkアプリケーション: パフォーマンス・サマリーおよびメトリック・パレット

「図38-29 WebCenter Portal: Frameworkアプリケーション: パフォーマンス・サマリーおよびメトリック・パレット」の説明

38.3 ログ情報の表示および構成

起動と停止に関連するすべての診断情報、エラー、警告メッセージ、HTTPリクエストに関するアクセス情報、その他の情報がログ・ファイルに保存されます。エラーの原因とその適切な処理に関する情報を検索する方法については、『Oracle Fusion Middleware管理者ガイド』の章「ログ・ファイルと診断データの管理」を参照してください。問題を特定するために診断ロギングを有効にする方法については、『Oracle Fusion Middleware管理者ガイド』のログ・ファイルの設定の構成に関する項を参照してください。

Spacesアプリケーションの場合、ログ・ファイルWC_Spaces-diagnostic.logがDOMAIN_HOME/servers/WC_Spaces/logs ディレクトリに保存されます。

Frameworkアプリケーションの場合、このログ・ファイルがDOMAIN_HOME/servers/ServerName/logsディレクトリで参照可能です。ログ・ファイルは、ServerName-diagnostic.logのネーミング規則に従います。

たとえば、管理対象サーバーWC_Customでは、ログはDOMAIN_HOME/servers/WC_Custom/logsに保存され、ログ・ファイルの名前はWC_Custom-diagnostic.logになります。

この項の内容は次のとおりです。

- 第38.3.1項「Spacesアプリケーションのログ」

- 第38.3.2項「Frameworkアプリケーションのログ」

38.3.1 Spacesアプリケーションのログ

Spacesアプリケーションのログ・メッセージを表示する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「ログ」→「ログ・メッセージの表示」を選択します。

3. 「ログ・メッセージ」ページで、警告、エラー、通知などを検索します。

スペースのログ・ファイルを構成する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Spacesアプリケーションのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「ログ」→「ログ構成」を選択します。

3. 「ログ構成」ページの「ログ・ファイル」タブで、ログ設定を構成します。

詳細は、『Oracle Fusion Middleware管理者ガイド』のログ・ファイルの検索と表示に関する項を参照してください。

38.3.2 Frameworkアプリケーションのログ

Frameworkアプリケーションのログ・メッセージを表示する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーション・デプロイメント」メニューから、「ログ」→「ログ・メッセージの表示」を選択します。

3. 「ログ・メッセージ」ページで、警告、エラー、通知などを検索します。

Frameworkアプリケーションのログ・ファイルを構成する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Frameworkアプリケーションのホームページに移動します。
第6.3項「Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーション・デプロイメント」メニューから、「ログ」→「ログ構成」を選択します。

3. 「ログ構成」ページの「ログ・ファイル」タブで、ログ設定を構成します。

詳細は、『Oracle Fusion Middleware管理者ガイド』のログ・ファイルの検索と表示に関する項を参照してください。

39 WebCenter Portalのエクスポート、インポート、バックアップおよびリカバリの管理

Oracle WebCenter Portalでは、様々な機能領域についての構成および内容に関連するデータが複数の場所に格納されています。WebCenter Portalには、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にするための一連のユーティリティが用意されており、それによりこのデータをバックアップし、ステージング環境と本番環境のWebCenter Portalアプリケーションの間でデータを移動できます。この章では、バックアップ、インポートおよびエクスポートのための使用可能な機能とツールについて説明します。内容は次のとおりです。

- 第39.1項「データ移行のためのSpacesアプリケーションのエクスポートおよびインポート」

- 第39.2項「データ移行のためのFrameworkアプリケーションのエクスポートおよびインポート」

- 第39.3項「他のWikiアプリケーションからのWikiドキュメントの移行」

- 第39.4項「WebCenter Portalアプリケーションのバックアップおよびリカバリ」

- 第39.5項「Spacesのインポートおよびエクスポート問題のトラブルシューティング」

これらのツールの適切な使用を計画するには、WebCenter Portalアプリケーションで使用しているWebCenter Portal機能(Spaces、Framework、ディスカッション・サーバー、Oracle WebCenter Content Serverなど)を記録します。

注意:

テスト・インスタンスを本番インスタンスに移行する場合は、『Oracle Fusion Middleware管理者ガイド』のOracle WebCenter Portalのテスト環境から本番環境への移行に関する項を参照してください。この項では、この章で説明される手順への別のアプローチ(自動化される手順の一部)について説明します。

対象読者

この章の内容は、Fusion Middleware管理者(Oracle WebLogic Server管理コンソールを使用してAdminロールを付与されたユーザー)を対象としています。第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

39.1 データ移行のためのSpacesアプリケーションのエクスポートおよびインポート

Spacesには、Spacesアプリケーション間、およびステージング環境や本番環境間でコンテンツをバックアップまたは移動するための一連のエクスポートおよびインポート・ユーティリティが用意されています。この項では、Spacesアプリケーション全体、および個々のスペースおよびスペース・テンプレートをエクスポートおよびインポートする方法について説明します。内容は次のとおりです。

- 第39.1.1項「Spacesのエクスポートおよびインポートの理解」

- 第39.1.2項「Spacesアプリケーションのエクスポートおよびインポートの前提条件」

Spacesアプリケーション全体の移行:

- 第39.1.3項「Spacesアプリケーション全体のバックエンド・コンポーネントの移行」

- 第39.1.4項「Spacesアプリケーション全体のエクスポート」

- 第39.1.5項「Spacesアプリケーション全体のインポート」

個々のスペースの移行:

- 第39.1.6項「個々のスペースのエクスポートおよびインポートの前提条件」

- 第39.1.7項「個々のスペースのバックエンド・コンポーネントの移行」

- 第39.1.8項「個々のスペースのエクスポート」

- 第39.1.9項「個々のスペースのインポート」

スペース・テンプレートの移行:

- 第39.1.10項「スペース・テンプレートのバックエンド・コンポーネントの移行」

- 第39.1.11項「スペース・テンプレートのエクスポート」

- 第39.1.12項「スペース・テンプレートのインポート」

Spacesリソースの移行:

- 第39.1.13項「Spacesリソースのエクスポート」

- 第39.1.14項「Spacesリソースのインポート」

39.1.1 Spacesのエクスポートおよびインポートの理解

エクスポートおよびインポートを使用して、Fusion Middleware管理者はステージング環境と本番環境の間でSpacesアプリケーション全体を移行できます。これには、あらゆるスペース、スペース・テンプレート、ユーザー定義リソース、(アプリケーション、ページおよびタスク・フローに適用された)カスタマイズ、アプリケーションおよびサービス・メタデータ(オブジェクト定義)および他のデータが含まれます(図39-1)。

図39-1 Spacesアプリケーションでエクスポートされる情報

この移行は、Fusion Middleware ControlまたはWLSTコマンドを使用して実行できます。詳細は、次を参照してください。

- 第39.1.4.1項「Fusion Middleware Controlを使用したSpacesアプリケーションのエクスポート」

- 第39.1.4.2項「WLSTを使用したSpacesアプリケーションのエクスポート」

- 第39.1.5.1項「Fusion Middleware Controlを使用したSpacesアプリケーションのインポート」

- 第39.1.5.2項「WLSTを使用したSpacesアプリケーションのインポート」

スペースおよびスペース・テンプレートのエクスポートおよびインポート

Spaces管理者は、Spaces管理から、個々のスペースおよびスペース・テンプレート、および関連オブジェクトをエクスポートおよびインポートすることもできます。個々のスペースおよびスペース・テンプレートを移行するためのいくつかのWLSTコマンドも利用できます。

これらのエクスポートおよびインポート機能の主要な目的は、データのクローニングおよび移行を可能にすることです。エクスポートおよびインポートを組み合せて使用すると、Spaces管理者は次のことを行えます。

- ステージング環境や本番環境間でContent Serverに保存されたスペース、スペース・テンプレートおよび関連オブジェクトを移動します。

- Content Serverに保存されたスペース、スペース・テンプレートおよび関連オブジェクトをリモート・インスタンスに移動します。

詳細は、次を参照してください。

- 第39.1.8項「個々のスペースのエクスポート」

- 第39.1.9項「個々のスペースのインポート」

- 第39.1.11項「スペース・テンプレートのエクスポート」

- 第39.1.12項「スペース・テンプレートのインポート」

アプリケーションのカスタマイズとユーザー・カスタマイズ

図39-1で示すように、一部のSpacesアプリケーションのカスタマイズは、エクスポート時にはオプションです。アプリケーションレベルのカスタマイズを移行する場合は、エクスポート・オプション「カスタマイズを含む」を設定する必要があります。詳細は、この章の最後の表39-4「Spacesサービス: アプリケーションのカスタマイズ」および表39-5「Spaces: アプリケーションのカスタマイズ」を参照してください。

ユーザーレベルのカスタマイズはエクスポートおよびインポート時に移行されません。アプリケーションのカスタマイズとユーザー・カスタマイズおよびそれらの相違の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページ・コンポーネントのカスタマイズに関する必要な知識に関する項を参照してください。

39.1.2 Spacesアプリケーションのエクスポートおよびインポートの前提条件

アプリケーション・メタデータまたはスキーマが格納されるデータベースは、エクスポートおよびインポート操作が機能するように稼働中である必要があります。使用するアプリケーションにWeb Serviceデータ制御が含まれる場合、すべての関連するWeb Servicesもエクスポートおよびインポートが成功するように稼働中でアクセス可能である必要があります。

また、Spacesアプリケーションをエクスポートまたはインポートする前に、すべてのバックエンド・コンポーネントを移行することをお薦めします。詳細は、第39.1.3項「Spacesアプリケーション全体のバックエンド・コンポーネントの移行」を参照してください。

Spacesは、データ競合を回避するために、インポートおよびエクスポート操作中に一時的に使用できなくなります。Spacesページにログインまたはアクセスするユーザーには、「アプリケーションが使用できません」ページが表示されます。

39.1.3 Spacesアプリケーション全体のバックエンド・コンポーネントの移行

Spacesアプリケーションを移行する前に、アプリケーションによって使用されるすべてのバックエンド・コンポーネントを移行する必要があります。この項では、アイデンティティ・ストア、資格証明ストア、ポリシー・ストア、ディスカッション・サーバー、Content Server、Oracle WebLogic Communications Serverおよびポートレット・プロデューサの移行方法について説明します。

ターゲット・インスタンスの構成されたサービスは、ソース・インスタンスで構成されるサービスのスーパーセットである必要があります。つまり、ターゲットは、ソースが構成されるサービスの少なくとも同じサービスのセットで構成される必要があります。そうでない場合は、インポート操作が失敗します。

この項の内容は次のとおりです。

- 第39.1.3.1項「LDAPアイデンティティ・ストアのエクスポート」

- 第39.1.3.2項「LDAPアイデンティティ・ストアのインポート」

- 第39.1.3.3項「LDAP資格証明ストアのエクスポートおよびインポート」

- 第39.1.3.4項「LDAPポリシー・ストアのエクスポートおよびインポート」

- 第39.1.3.5項「ファイルベースの資格証明ストアのエクスポートおよびインポート」

- 第39.1.3.6項「ファイルベースのポリシー・ストアのエクスポートおよびインポート」

- 第39.1.3.7項「ディスカッション・サーバー・データのエクスポート」

- 第39.1.3.8項「ディスカッション・サーバー・データのインポート」

- 第39.1.3.9項「Oracle Content Serverデータのエクスポート」

- 第39.1.3.10項「Oracle Content Serverデータのインポート」

- 第39.1.3.11項「Oracle WebLogic Communications Serverのエクスポート」

- 第39.1.3.12項「Oracle WebLogic Communications Serverのインポート」

- 第39.1.3.13項「ポートレット・プロデューサのエクスポート」

- 第39.1.3.14項「ポートレット・プロデューサのインポート」

39.1.3.1 LDAPアイデンティティ・ストアのエクスポート

外部アイデンティティ・ストアからユーザー、グループおよびパスワードをエクスポートするには、ldapsearchコマンドを使用します。このコマンドは、ldapaddコマンドがインポート操作中に使用する、ldifファイルを作成します。ldapsearchユーティリティは、OID/IdM IDM_ORACLE_HOME/binディレクトリにあります。

例39-1に、LDAPアイデンティティ・ストアをエクスポートするためのldapsearchコマンドを示します。LDAP_OH/binは、OID/IdM IDM_ORACLE_HOME/binディレクトリです。

例39-1 LDAP資格証明ストアをエクスポートするldapsearchコマンド

LDAP_OH/bin/ldapsearch -h ldap_hostname -p ldap_port -D  "cn=ldap_user" -w password -b "cn=users,dc=example,dc=com"
-s subtree "objectclass=*" "*" orclguid -L > my_users.ldif

ユーザーをエクスポートする場合は、コマンドにorclguid属性が含まれていることを確認してください(例39-1)。

グループを移行するには、適切なグループ・ベースDNを使用してコマンドを繰り返します。例: -b "cn=groups,dc=example,dc=com"

構文の詳細と例は、Oracle Identity Managementユーザー・リファレンスのldapsearchおよびldapaddmtに関する項を参照してください。

外部LDAPアイデンティティ・ストアの移行の詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドのディレクトリ・エントリの管理およびバルク操作の実行に関する項を参照してください。

注意:

2つの組込みLDAPサーバー間でユーザー、グループおよびパスワードを移行するには、Oracle Fusion Middleware Oracle WebLogic Serverの保護の組込みLDAPサーバーの情報のエクスポートおよびインポートに関する項を参照してください。コマンドには、orclguid属性が含まれていることを確認してください。

ソースおよびターゲットLDAPサーバーは両方とも同じタイプ(組込みLDAPサーバーまたは外部LDAPサーバー)である必要があります。たとえば、組込みLDAPサーバーに格納されているユーザー、グループおよびパスワードを外部LDAPサーバーに移行することはできません。

39.1.3.2 LDAPアイデンティティ・ストアのインポート

別の外部アイデンティティ・ストアからユーザーおよびグループをインポートするには、ldapaddmtユーティリティを使用します。ldapaddmtユーティリティは、OID/IdM IDM_ORACLE_HOME/binディレクトリにあります。

例39-2は、ldapaddmtユーティリティを実行して、ldifファイルをインポートする方法を示しています。LDAP_OH/binは、OID/IdM IDM_ORACLE_HOME/binディレクトリです。

例39-2 ldifファイルをインポートするためのldapaddmtユーティリティ

LDAP_OH/bin/ldapaddmt -h ldap_hostname -p ldap_port -D "cn=ldap_user" -w password -c -r -f my_users.ldif

構文の詳細と例は、Oracle Identity Managementユーザー・リファレンスのldapaddmtに関する項を参照してください。

LDAPアイデンティティ・ストアの移行の詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドのディレクトリ・エントリの管理およびバルク操作の実行に関する項を参照してください。

注意:

別の組込みLDAPサーバーからユーザー、グループおよびパスワードをインポートするには、Oracle Fusion Middleware Oracle WebLogic Serverの保護の組込みLDAPサーバーの情報のエクスポートおよびインポートに関する項を参照してください。

ソースおよびターゲットLDAPサーバーは両方とも同じタイプ(組込みLDAPサーバーまたは外部LDAPサーバー)である必要があります。たとえば、組込みLDAPサーバーに格納されているユーザー、グループおよびパスワードを外部LDAPサーバーに移行することはできません。

39.1.3.3 LDAP資格証明ストアのエクスポートおよびインポート

資格証明ストアを別のターゲットに移行するには、WLSTコマンドmigrateSecurityStoreを使用します。このコマンドを実行する前にjps-config.xmlファイルのソース資格証明ストアに関連する詳細を指定する必要があります。

1. 独自のjps-config.xml (この例では、jps-config-cred.xmlと名付ける)を作成し、ソース資格証明ストアのドメイン名、JPSルートおよびLDAP URLを指定します。

1. 次のように、DOMAIN_HOME/config/fmwconfig/jps-config.xmlにあるターゲットのjps-config.xmlファイルのコピーを作成し、そのコピーをjps-config-cred.xmlと名付けます。

cp MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config.xml
MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config-cred.xml

2. jps-config-cred.xmlファイルで、次のセクションを複製します。

<serviceInstance provider="ldap.credentialstore.provider" name="credstore.ldap">
...
</serviceInstance>

次のいくつかの手順では、この新しいセクションを編集して、ソース資格証明ストアをポイントする方法について説明します。完了したら、jps-config-cred.xmlファイルには移行プロセスのソースおよびターゲット情報の両方が含まれます。

3. まず、新しい要素がソース情報を含むことを示すように要素名を変更します。たとえば、次のように変更します。

変更前: name="credstore.ldap."

変更後: name="credstore.ldap.s"

4. ドメイン名、JPSルートおよびLDAP URL値を必要に応じて変更します。次に例を示します。

<serviceInstance provider="ldap.credentialstore.provider" name="credstore.ldap.s">
<property value="bootstrap" name="bootstrap.security.principal.key"/>
<property value="cn=my_domain" name="oracle.security.jps.farm.name"/>
<property value="cn=jpsroot_webcenter_mytest_to_prod" name="oracle.security.jps.ldap.root.name"/>
<property value="ldap:myhost:myport" name="ldap.url"/>
</serviceInstance>

5. 資格証明ストアにのみ関心があるため、<jpsContext name="default">要素を変更して、アイデンティティ・ストアおよびポリシー・ストアへの参照を削除します。次に例を示します。

<jpsContext name="default">
<serviceInstanceRef ref="keystore"/>
<serviceInstanceRef ref="audit"/>
<serviceInstanceRef ref="credstore.ldap"/>
</jpsContext>

6. <jpsContext>要素を複製し、新しい<jpsContext>要素の名前をsourceに変更します。たとえば、次のように変更します。
変更前: <jpsContext name="default">

変更後：To: <jpsContext name="source">

7. 手順cで指定した値をポイントするように資格証明ストアの参照を変更します。例:

<jpsContext name="source">
<serviceInstanceRef ref="keystore"/>
<serviceInstanceRef ref="audit"/>
<serviceInstanceRef ref="credstore.ldap.s"/>
</jpsContext>

2. ldapsearchユーティリティを使用して、ソース・フォルダの名前を検索します。
たとえば、次のように入力します。

LDAP_OH/bin/ldapsearch -h srcldap_hostname -p ldap_port -D  "cn=ldap_user" -w password -b "" -s sub "cn=<application_name>-*"

<application_name>は、ソース・アプリケーションの名前です。

返されたフォルダは、<application_name>-xxxxと名付けられています。

Spacesでは、<application_name>は常にwebcenterです。たとえば、ソース・フォルダの名前がwebcenter-1646である場合は、次の情報が返される可能性があります。

cn=webcenter-1646,cn=CredentialStore,cn=my_domain, cn=JPSContext,  cn=jpsroot_webcenter_t2ptest
objectclass=top
objectclass=orclContainercn=webcenter-1646

3. ldapsearchユーティリティを使用して、宛先フォルダの名前を検索します。
たとえば、次のように入力します。

LDAP_OH/bin/ldapsearch -h dstldap_hostname -p ldap_port -D  "cn=ldap_user" -w password -b "" -s sub "cn=<application_name>-*"

<application_name>は、ターゲット・アプリケーションの名前です。

返されたフォルダは、<application_name>-xxxxと名付けられています。

Spacesでは、<application_name>は常にwebcenterです。

4. 資格証明ストアをインポートするには、WLSTコマンドmigrateSecurityStoreを実行します。
例(例39-3):

例39-3 migrateSecurityStore: 資格証明ストア

migrateSecurityStore(type="credStore", configFile="/MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config-cred.xml",
src="source", dst="default", overWrite="true", srcFolder="<source folder>", dstFolder="<destination folder>")

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のmigrateSecurityStoreに関する項を参照してください。

39.1.3.4 LDAPポリシー・ストアのエクスポートおよびインポート

Spacesでは、手動のポリシー・ストアの移行は必要ありません。これは、Spacesのエクスポート/インポート・コマンドがユーザーに代わってセキュリティ・ポリシーを移行するためです。詳細は、第39.1.4項「Spacesアプリケーション全体のエクスポート」を参照してください。

Spacesに代わってポリシー・ストアの移行を手動で実行することはお薦めしませんが、手動での移行が必要な状況になる場合があります。そのような場合は、WLSTコマンドのmigrateSecurityStoreを使用して、後述の説明に従って移行を実行してください。

注意:

その他のWebCenter Portalアプリケーションでは、セキュリティ・ポリシーの移行には常にmigrateSecurityStoreコマンドを使用してください。

migrateSecurityStoreコマンドを実行する前に、jps-config.xmlファイルのソース・ポリシー・ストアに関連した詳細を指定する必要があります。

1. 独自のjps-config.xml (この例では、jps-config-policy.xmlと名付ける)を作成し、ソース・ポリシー・ストアのドメイン名、JPSルートおよびLDAP URLを指定します。

1. 次のように、DOMAIN_HOME/config/fmwconfig/jps-config.xmlにあるターゲットのjps-config.xmlファイルのコピーを作成し、そのコピーをjps-config-policy.xmlと名付けます。

cp MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config.xml
MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config-policy.xml

2. jps-config-policy.xmlファイルで、次のセクションを複製します。

<serviceInstance provider="ldap.policystore.provider" name="policystore.ldap">
...
</serviceInstance>

次のいくつかの手順で、この新しいセクションを編集して、ソース・ポリシー・ストアをポイントする方法について説明します。完了したら、jps-config-policy.xmlファイルには移行プロセスのソースおよびターゲット情報の両方が含まれます。

3. まず、新しい要素がソース情報を含むことを示すように要素名を変更します。たとえば、次のように変更します。

変更前: name="policystore.ldap."

変更後: name="policystore.ldap.s"

4. ドメイン名、JPSルートおよびLDAP URL値を必要に応じて変更します。次に例を示します。

<serviceInstance provider="ldap.policytore.provider" name="policystore.ldap.s">
<property value="bootstrap" name="bootstrap.security.principal.key"/>
<property value="cn=my_domain" name="oracle.security.jps.farm.name"/>
<property value="cn=jpsroot_webcenter_mytest_to_prod" name="oracle.security.jps.ldap.root.name"/>
<property value="ldap:myhost:myport" name="ldap.url"/>
</serviceInstance>

5. <jpsContext>要素を複製し、新しい<jpsContext>要素の名前をsourceに変更します。たとえば、次のように変更します。
変更前: <jpsContext name="default">

変更後：To: <jpsContext name="source">

6. 手順cで指定した値をポイントするようにポリシー・ストアの参照を変更し、アイデンティティ・ストアおよび資格証明ストアへの参照を削除します。次に例を示します。

<jpsContext name="source">
<serviceInstanceRef ref="keystore"/>
<serviceInstanceRef ref="audit"/>
<serviceInstanceRef ref="policystore.ldap.s"/>
</jpsContext>

7. <jpsContext name="default">要素を変更し、アイデンティティ・ストアおよび資格証明ストアへの参照を削除します。次に例を示します。

<jpsContext name="default">
<serviceInstanceRef ref="keystore"/>
<serviceInstanceRef ref="audit"/>
<serviceInstanceRef ref="policystore.ldap"/>
</jpsContext>

2. ldapsearchユーティリティを使用して、ソース・アプリケーションのフル・ネームを検索します。
たとえば、次のように入力します。

LDAP_OH/bin/ldapsearch -h srcldap_hostname -p srcldap_port -D  "cn=ldap_user" -w password -b "" -s sub "orclapplicationcommonname=<application_name>*"

<application_name>は、ソース・アプリケーションの名前です。

返されたアプリケーションは、<application_name>-xxxxと名付けられています。

Spacesでは、<application_name>は常にwebcenterです。たとえば、ソース・アプリケーションのフル・ネームがwebcenter#V2.0である場合、次の情報が返される可能性があります。

cn=webcenter\#V2.0,cn=my_domain,cn=JPSContext,cn=jpsroot_webcenter_t2ptest
objectclass=top
objectclass=orclJavaApplicationEntity
orclapplicationcommonname=webcenter#V2.0cn=webcenter#V2.0

3. ldapsearchユーティリティを使用して、ターゲット・アプリケーションのフル・ネームを検索します。
たとえば、次のように入力します。

LDAP_OH/bin/ldapsearch -h dstldap_hostname -p dstldap_port -D  "cn=ldap_user" -w password -b "" -s sub "orclapplicationcommonname=<application_name>*"

<application_name>は、ターゲット・アプリケーションの名前です。

返されたアプリケーションは、<application_name>-xxxxと名付けられています。

Spacesでは、<application_name>は常にwebcenterです。

4. ポリシー・ストアをインポートするには、WLSTコマンドmigrateSecurityStoreを実行します。
例(例39-4):

例39-4 migrateSecurityStore: ポリシー・ストア

migrateSecurityStore(type="appPolicies", configFile="/MW_HOME/user_projects/domains/my_domain/config/fmwconfig/jps-config-policy.xml",
src="source",dst="default",overWrite="true", srcApp="<full application name>", dstApp="<full application name>")

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のmigrateSecurityStoreに関する項を参照してください。

39.1.3.5 ファイルベースの資格証明ストアのエクスポートおよびインポート

ファイルベースの資格証明ストアを別のターゲットに移行するには、WLSTコマンドmigrateSecurityStoreを使用します。このコマンドを実行する前にターゲットのjps-config.xmlファイルのソース資格証明ストアに関連する詳細を指定する必要があります。

1. DOMAIN_HOME/config/fmwconfig/jps-config.xmlにあるターゲットのjps-config.xmlファイルをバックアップします。

2. ターゲットのjps-config.xmlにソースおよびターゲットの情報を追加します。

1. ソース資格証明ストアをポイントするように次のセクション(</serviceInstances>終了タグの上)を追加します。

<serviceInstance name="sourcecredstore" provider="credstoressp" location="/MW_HOME/user_projects/domains/base-domain/config/fmwconfig/.">
<description>File Based Credential Store Service Instance</description>
</serviceInstance>

/MW_HOME/user_projects/domains/base-domainをソース・ドメインへのパスに置換します。

2. 手順aで指定された値をポイントするように資格情報ストアの参照を更新します。</jpsContexts>終了タグの上に次のエントリを追加します。

<jpsContext name="targetcredstore">
<serviceInstanceRef ref="credstore"/>
</jpsContext>
<jpsContext name="sourcecredstore">
<serviceInstanceRef ref="sourcecredstore"/>
</jpsContext>

3. WLSTコマンドのmigrateSecurityStoreを使用して、ファイルベースの資格情報ストアをインポートします。
例(例39-5):

例39-5 migrateSecurityStore: 資格証明ストア

migrateSecurityStore(type="credStore", configFile="/MW_HOME/user_projects/domains/base-domain/config/fmwconfig/jps-config.xml", src="sourcecredstore", dst="targetcredstore")

configFileパラメータは、ターゲット・ドメインのjps-config.xmlファイルにマップされ、srcおよびdstパラメータは新たに作成されたjpsContext要素にマップされます。

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のmigrateSecurityStoreに関する項を参照してください。

次のようなものが出力されます。これには、無視してよい警告が含まれます。

{srcFolder=null, preserveAppRoleGuids=null, dst=targetcredstore, type=credStore,
dstFolder=null, resourceTypeFile=null, dstLdifFile=null, srcApp=null,
configFile=/scratch/product/target/user_projects/domains/domain4/config/fmwconfig/jps-config.xml,
dstApp=null, srcConfigFile=null, src=sourcecredstore, overWrite=null,
migrateIdStoreMapping=null, processPrivRole=null}
Oct 26, 2009 11:23:42 AM oracle.security.jps.internal.tools.utility.destination.apibased.JpsDstCredential setCredential
WARNING: Cannot migrate credential folder/key
webcenter-1111/anonymous#oracle.portlet.client.adapter.adf.ADFPortletContainerExternalConfig.Reason
oracle.security.jps.service.credstore.CredentialAlreadyExistsException:
The credential with map webcenter-1111 and key
anonymous#oracle.portlet.client.adapter.adf.ADFPortletContainerExternalConfig already exists.

39.1.3.6 ファイルベースのポリシー・ストアのエクスポートおよびインポート

Spacesでは、手動のポリシー・ストアの移行は必要ありません。これは、Spacesのエクスポート/インポート・コマンドがユーザーに代わってセキュリティ・ポリシー・データを移行するためです。詳細は、第39.1.4項「Spacesアプリケーション全体のエクスポート」を参照してください。

Spacesに代わってポリシー・ストアの移行を手動で実行することはお薦めしませんが、手動での移行が必要な状況になる場合があります。そのような場合は、WLSTコマンドのmigrateSecurityStoreを使用して、後述の説明に従って移行を実行してください。

注意:

その他のWebCenter Portalアプリケーションでは、セキュリティ・ポリシーの移行には常にmigrateSecurityStoreコマンドを使用してください。

migrateSecurityStoreコマンドを実行する前に、ターゲットのjps-config.xmlファイルのソース・ポリシー・ストアに関連した詳細を指定する必要があります。

1. DOMAIN_HOME/config/fmwconfig/jps-config.xmlにあるターゲットのjps-config.xmlファイルをバックアップします。

2. ターゲットのjps-config.xmlにソースおよびターゲットの情報を追加します。

1. ソース・ポリシー・ストアをポイントするように、次のセクション(</serviceInstances>終了タグの前)を追加します。

<serviceInstance name="srcpolicystore.xml"
provider="policystore.xml.provider"
location="/MW_HOME/user_projects/domains/base_domain/config/fmwconfig/system-jazn-data.xml">
<description>File Based Policy Store Service Instance</description></serviceInstance>

/MW_HOME/user_projects/domains/base-domainをソース・ドメインへのパスに置換します。

2. 手順aで指定された値をポイントするようにポリシー・ストアの参照を更新します。</jpsContexts>終了タグの上に次のエントリを追加します。

<jpsContext name="targetFileStore">
<serviceInstanceRef ref="policystore.xml"/>
</jpsContext>
<jpsContext name="sourceFileStore">
<serviceInstanceRef ref="srcpolicystore.xml"/>
</jpsContext>

3. WLSTコマンドのmigrateSecurityStoreを使用して、ファイルベースの資格情報ストアをインポートします。
例(例39-6):

例39-6 migrateSecurityStore: 資格証明ストア

migrateSecurityStore(type="appPolicies", srcApp="webcenter",
configFile="/MW_HOME/user_projects/domains/base_domain/config/fmwconfig/jps-config.xml",
src="sourceFileStore", dst="targetFileStore", overWrite="true")

configFileパラメータは、ターゲット・ドメインのjps-config.xmlファイルにマップされ、srcおよびdstパラメータは新たに作成されたjpsContext要素にマップされます。

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のmigrateSecurityStoreに関する項を参照してください。

次のようなものが出力されます。これには、無視してよい警告が含まれます。

{srcFolder=null, dst=targetFileStore,
type=appPolicies, dstFolder=null, resourceTypeFile=null,
dstLdifFile=null, srcApp=webcenter,
configFile=/scratch/product/target/user_projects/domains/base_domain/config/fmwconfig/jps-config.xml,
dstApp=null, srcConfigFile=null, src=sourceFileStore, overWrite=true,
migrateIdStoreMapping=null, processPrivRole=null}Oct 26, 2009 4:14:42 AM
oracle.security.jps.internal.tools.utility.destination.apibased.JpsDstPolicy <init>
WARNING: No identity store associate with policy store found.
wls:/offline>

39.1.3.7 ディスカッション・サーバー・データのエクスポート

WebCenter Portalのディスカッション・サーバー・データをエクスポートするには、適切なデータベースのエクスポート・ユーティリティを使用します。

- Oracleデータベースの場合、ご使用のデータベースのORACLE_HOME/binに移動して、例39-7で説明されるコマンドを実行します。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

注意:

Oracle Data Pumpユーティリティは、DISCUSSIONSスキーマに存在するLONG列タイプをサポートしていません。このため、Oracle Databaseユーティリティを使用することをお薦めします。『Oracle Databaseユーティリティ』も参照してください。

例39-7 エクスポート・データベース・ユーティリティ

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\" OWNER=srcrcuprefix_DISCUSSIONS DUMPFILE=/tmp/df.dmp STATISTICS=none

各要素の意味は次のとおりです。

- DB_ORACLE_HOMEは、WebCenter Portalのディスカッション・サーバー・スキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- OWNERは、エクスポートされるスキーマです。これは、インストール時に使用されたRCU接尾辞の_DISCUSSIONSを、ユーザーが指定した接頭辞とともに指定します。例: DEV_DISCUSSIONS。

- DUMPFILEはエクスポートされたデータを含みます。

39.1.3.8 ディスカッション・サーバー・データのインポート

ディスカッション・サーバー・データをインポートするには、適切なデータベースのインポート・ユーティリティを使用します。

- Oracleデータベースの場合、次の手順を実行します。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

注意:

Oracle Data Pumpユーティリティは、DISCUSSIONSスキーマに存在するLONG列タイプをサポートしていません。このため、Oracle Databaseユーティリティを使用することをお薦めします。『Oracle Databaseユーティリティ』も参照してください。

1. ターゲットのディスカッション・サーバーをシャットダウンします。

2. WebCenter Portalのディスカッション・サーバー・スキーマがインストールされるデータベースのDB_ORACLE_HOME/binに移動し、sysdbaとしてsqlplusを使用してそのデータベースに接続します。

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"

3. ターゲット・ユーザーをドロップします。

drop user tgtrcuprefix_DISCUSSIONS cascade;

4. ターゲット・ユーザーを作成します。

create user tgtrcuprefix_DISCUSSIONS identified by password default tablespace tgtrcuprefix_IAS_DISCUSSIONS temporary tablespace name_IAS_TEMP;

各要素の意味は次のとおりです。

- tgtrcuprefix_DISCUSSIONSはユーザー名です。これは、インストール時に使用されたRCU接尾辞_DISCUSSIONSを、ユーザーが指定した接頭辞とともに指定します。例: DEV_DISCUSSIONS。

- passwordは、ターゲット・ユーザーのパスワードです。

- tgtrcuprefix_IAS_DISCUSSIONSはデフォルトのテーブルスペースを識別します。たとえば、インストール時に使用されたRCU接尾辞IAS_DISCUSSIONSを、ユーザーが指定した接頭辞とともに指定します。例: DEV_IAS_DISCUSSIONS。

- name_IAS_TEMPは一時テーブルスペースを識別します。例: DEV_IAS_TEMP。

5. 接続およびリソース権限をユーザーに付与します。

grant connect,resource to tgtrcuprefix_DISCUSSIONS;

6. sqlplusを終了します。

7. 例39-8の説明に従って、インポート・ツールを実行します。

例39-8 データベース・インポート・ユーティリティ

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\" remap_schema=srcrcuprefix_DISCUSSIONS:tgtrcuprefix_DISCUSSIONS remap_tablespace=source_tablespace:target_tablespace  DUMPFILE=/tmp/df.dmp STATISTICS=none

各要素の意味は次のとおりです。

- DB_ORACLE_HOMEは、WebCenter Portalのディスカッション・サーバー・スキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- REMAP_SCHEMAは、ソースおよびターゲット・スキーマを識別します。たとえば、スキーマ名には、インストール時に使用されたRCU接尾辞_DISCUSSIONSが、ユーザーが指定した接頭辞とともに含まれます。例: DEV_DISCUSSIONS。

- REMAP_TABLESPACEは、ソースおよびターゲット・テーブルスペースを識別します。ソース・テーブルスペース内の永続データのインポートで選択されたすべてのオブジェクトが、ターゲット・テーブルスペースで作成されるように再マップします。例: source_tablespace:target_tablespace。

- DUMPFILEはインポートされるデータを含みます。

39.1.3.9 Oracle Content Serverデータのエクスポート

最初にOracle Data Pumpを使用してOracle WebCenter Content Serverスキーマをエクスポートし、ネイティブ(vault)ファイルおよびWeb表示可能(weblayout)ファイルをエクスポートします。

注意:

Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

1. Oracle Data Pumpエクスポート・ユーティリティを使用してContent Serverデータをエクスポートします。
たとえば、ご使用のデータベースのORACLE_HOME/binに移動して、例39-9で説明されるコマンドを実行します。

注意:

Oracle Data Pumpユーティリティは、OCSERVERスキーマに存在するLONG列タイプをサポートしていません。このため、Oracle Databaseユーティリティを使用することをお薦めします。『Oracle Databaseユーティリティ』も参照してください。

例39-9 Data Pumpユーティリティ(エクスポート)

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\" OWNER=srcrcuprefix_OCSERVER DUMPFILE=/tmp/ucm.dmp STATISTICS=none

各要素の意味は次のとおりです。

- DB_ORACLE_HOMEは、Oracle WebCenter Content Serverスキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- OWNERは、エクスポートされるスキーマです。これは、インストール時に使用されたRCU接尾辞の_OCSERVERを、ユーザーが指定した接頭辞とともに指定します。例: DEV_OCSERVER。

- DUMPFILEはエクスポートされたデータを含みます。

2. ネイティブ(vault)ファイルおよびWeb表示可能(weblayout)ファイルをエクスポートします。

- Vaultファイル: ソース・システム上の<WC_ORACLE_HOME>/ucm/vaultフォルダをtarで固めます。次に例を示します。

tar cvf ucm_vault.tar WC_ORACLE_HOME/ucm/vault

- Weblayoutファイル: ソース・システム上の<WC_ORACLE_HOME>/ucm/weblayoutフォルダをtarで固めます。次に例を示します。

tar cvf ucm_weblayout.tar WC_ORACLE_HOME/ucm/weblayout

3. 次のように、ソースvaultおよびweblayoutフォルダのアーカイブをターゲット・システムにインポートします。

- Vaultファイル: vaultフォルダをリストアします。次に例を示します。

cd WC_ORACLE_HOME/ucm;
tar xvf ucm_vault.tar

- Weblayoutファイル: weblayoutフォルダをリストアします。次に例を示します。

cd WC_ORACLE_HOME/ucm;
tar xvf ucm_weblayout.tar

39.1.3.10 Oracle Content Serverデータのインポート

最初にOracle Data Pumpを使用してソースOracle WebCenter Content Serverスキーマをインポートし、ソースvaultおよびweblayoutフォルダのアーカイブをインポートします。

注意:

Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

1. ターゲットのContent Serverをシャットダウンします。

2. Oracle WebCenter Content ServerスキーマがインストールされるデータベースのDB_ORACLE_HOME/binに移動し、sysdbaとしてsqlplusを使用してそのデータベースに接続します。

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"

3. ターゲット・ユーザーをドロップします。

drop user tgtrcuprefix_OCSERVER cascade;

4. ターゲット・ユーザーを作成します。

create user tgtrcuprefix_OCSERVER identified by password default tablespace tgtrcuprefix_OCSERVER temporary tablespace name_IAS_TEMP;

各要素の意味は次のとおりです。

- tgtrcuprefix_OCSERVERはユーザー名です。これは、インストール時に使用されたRCU接尾辞_OCSERVERを、ユーザーが指定した接頭辞とともに指定します。例: DEV_OCSERVER。

- passwordは、ターゲット・ユーザーのパスワードです。

- tgtrcuprefix_IAS_OCSERVERはデフォルトのテーブルスペースを識別します。たとえば、インストール時に使用されたRCU接尾辞IAS_OCSERVERを、ユーザーが指定した接頭辞とともに指定します。例: DEV_IAS_OCSERVER。

- name_IAS_TEMPは一時テーブルスペースを識別します。例: DEV_IAS_TEMP。

5. 接続およびリソース権限をユーザーに付与します。

grant connect,resource to tgtrcuprefix_OCSERVER;

6. Oracle Data Pumpインポート・ユーティリティを使用してContent Serverデータをインポートします。
たとえば、ご使用のデータベースのDB_ORACLE_HOME/binに移動して、例39-10で説明されるコマンドを実行します。

注意:

Oracle Data Pumpユーティリティは、OCSERVERスキーマに存在するLONG列タイプをサポートしていません。このため、Oracle Databaseユーティリティを使用することをお薦めします。『Oracle Databaseユーティリティ』も参照してください。

例39-10 Data Pumpユーティリティ(インポート)

DB_ORACLE_HOME/bin/impdp  \"sys/password@serviceid as sysdba\" remap_schema=srcrcuprefix_OCSERVER:tgtrcuprefix_OCSERVER remap_tablespace=source_tablespace:target_tablespace DUMPFILE=/tmp/UCM.dmp STATISTICS=none TRANSFORM=oid:n

各要素の意味は次のとおりです。

- DB_ORACLE_HOMEは、Oracle WebCenter Content Serverスキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- REMAP_SCHEMAは、ソースおよびターゲット・スキーマを識別します。たとえば、スキーマ名には、インストール時に使用されたRCU接尾辞__OCSERVERが、ユーザーが指定した接頭辞とともに含まれます。例: DEV_OCSERVER。

- REMAP_TABLESPACEは、ソースおよびターゲット・テーブルスペースを識別します。ソース・テーブルスペース内の永続データのインポートで選択されたすべてのオブジェクトが、ターゲット・テーブルスペースで作成されるように再マップします。例: source_tablespace:target_tablespace。

- DUMPFILEはインポートされるデータを含みます。

7. 次のように、ソースvaultおよびweblayoutフォルダのアーカイブをターゲット・システムにインポートします。

- Vaultファイル: vaultフォルダをリストアします。次に例を示します。

cd WC_ORACLE_HOME/ucm;
tar xvf ucm_vault.tar

- Weblayoutファイル: weblayoutフォルダをリストアします。次に例を示します。

cd WC_ORACLE_HOME/ucm;
tar xvf ucm_weblayout.tar

Oracle WebCenter Content Serverデータをインポートした後で、Spacesアプリケーションにログインして、インポートされたスペースを開きます。ドキュメント・サービスがそのスペースで有効になっていて、インポートされたフォルダが予期したとおりに使用可能であることを確認します。

39.1.3.11 Oracle WebLogic Communications Serverのエクスポート

Oracle WebLogic Communications Serverのエクスポートの詳細は、Oracle WebLogic Communication Services管理者ガイドを参照してください。

39.1.3.12 Oracle WebLogic Communications Serverのインポート

Oracle WebLogic Communications Serverのインポートの詳細は、Oracle WebLogic Communication Services管理者ガイドを参照してください。

39.1.3.13 ポートレット・プロデューサのエクスポート

この手順は、Spacesアプリケーションに関連付けられているプロデューサ・メタデータだけではなく、プロデューサ・メタデータ全体を移行するためにのみ必要です。プロデューサ・メタデータ全体をエクスポートする方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の付録ポートレット・プリファレンス・ストア移行ユーティリティに関する項を参照してください。

39.1.3.14 ポートレット・プロデューサのインポート

この手順は、Spacesアプリケーションに関連付けられているプロデューサ・メタデータだけではなく、プロデューサ・メタデータ全体を移行するためにのみ必要です。プロデューサ・メタデータ全体をインポートする方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』の付録ポートレット・プリファレンス・ストア移行ユーティリティに関する項を参照してください。

39.1.4 Spacesアプリケーション全体のエクスポート

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用してSpacesアプリケーション全体をエクスポートする方法について説明します。

Spacesアプリケーションは、単一のエクスポート・アーカイブ(.earファイル)にエクスポートされます。EARファイルには次のものが含まれます。

- メタデータ・アーカイブ(.mar)ファイル

- セキュリティ・ポリシー情報を含むXMLファイル(policy-store.xml):

- アプリケーション・ロール(および各ロールに割り当てられた権限)

- ホーム・スペースのユーザー詳細およびそのアプリケーション・ロールの割当て

- 個々のスペース・メンバー(および各スペースのロールの割当て)

エクスポート・アーカイブは、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存できます。エクスポートされる内容の詳細は、第39.1.1項「Spacesのエクスポートおよびインポートの理解」を参照してください。

Spacesアプリケーションは、データ競合を回避するために、インポートおよびエクスポート操作中に一時的に使用できなくなります。Spacesページにログインまたはアクセスするユーザーには、「アプリケーションが使用できません」ページが表示されます。

エクスポート・プロセスには、メール、ディスカッション、お知らせ、ワークリスト、個人イベント、インスタント・メッセージおよびプレゼンス(IMP)、およびドキュメントなど、外部サービスに関連するデータは含まれません。これらのサービスに関連するデータを移行する方法については、第39.1.3項、「Spacesアプリケーション全体のバックエンド・コンポーネントの移行」を参照してください。

エクスポート環境とインポート環境両方のユーザーは同一である必要があります。共有アイデンティティ・ストアが使用されない場合、これらのユーザーも移行される必要があります。第39.1.3項「Spacesアプリケーション全体のバックエンド・コンポーネントの移行」を参照してください。

注意:

コンテンツ・ディレクトリにあるアプリケーション・アーティファクトのみがエクスポートされます。たとえば、ページ・テンプレートに関連したアイコンやイメージなどは、エクスポートされるページ・テンプレートのコンテンツ・ディレクトリに配置される必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリソースのプロパティに関する必要な知識に関する項を参照してください。

初期設定のテンプレートおよびユーザー・カスタマイズはエクスポートされません。ユーザー・カスタマイズの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページ・コンポーネントのカスタマイズに関する必要な知識に関する項を参照してください。

この項の内容は次のとおりです。

- 第39.1.4.1項「Fusion Middleware Controlを使用したSpacesアプリケーションのエクスポート」

- 第39.1.4.2項「WLSTを使用したSpacesアプリケーションのエクスポート」

39.1.4.1 Fusion Middleware Controlを使用したSpacesアプリケーションのエクスポート

Fusion Middleware管理者は、Fusion Middleware Controlを使用してSpacesアプリケーション全体をエクスポートできます。

Spacesをエクスポートする手順は、次のとおりです。

1. Fusion Middleware Controlで、Spacesのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「アプリケーションのエクスポート」を選択します(図39-2)。

図39-2「WebCenter Portal」メニュー: 「アプリケーションのエクスポート」オプション

「図39-2「WebCenter Portal」メニュー: 「アプリケーションのエクスポート」オプション」の説明

3. エクスポート・アーカイブの「ファイル名」を変更するか、デフォルトの名前をそのまま使用します。
一意であることを保証するため、デフォルトの.earファイル名にはwebcenter_wholeapp_ts_timestamp.earのようにタイムスタンプが含まれます(図39-3)。

図39-3 エクスポート・アーカイブの名前の変更方法

「図39-3 エクスポート・アーカイブの名前の変更方法」の説明

4. 必要に応じて、エクスポートのオプションを設定します。詳細は、表39-1を参照してください。

表39-1 Spacesアプリケーション・エクスポートのオプション

フィールド

説明

サービス・データを含む

これを選択すると、次のサービス(アクティビティ・ストリーム、イベント、フィードバック、リスト、リンク、メッセージ・ボード、コネクションおよびプロファイル)に関するWebCenter Portalリポジトリに保存されたデータがエクスポートされます。MDSリポジトリに保存されたデータもエクスポートされることに注意してください。

ソースおよびターゲット・リスト定義が一致しない場合はリスト・データを常に再エクスポートします。リスト定義がターゲット上に存在し、その後ソースで変更される場合にのみ不一致が発生します。

エクスポートすることを選択したアプリケーションに大量のデータが含まれる場合は、このフィールドではなく、WebCenter Portalスキーマ・データをエクスポート(およびインポート)するためのデータベース・エクスポート・ユーティリティを使用することを考慮してください。次に例を示します。

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as
sysdba\" OWNER=srcrcuprefix_WEBCENTER
DUMPFILE=/tmp/WCS.dmp STATISTICS=none

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as
sysdba\"
remap_schema=srcrcuprefix_WEBCENTER:tgtrcuprefix_WEBCENTER
remap_tablespace=source_tablespace:target_tablespace
DUMPFILE=/tmp/WCS.dmp
STATISTICS=none TRANSFORM=oid:n

詳細は、『Oracle Databaseユーティリティ』を参照してください。

リスト、イベント、タグ、リンク、コネクション、プロファイル、メッセージ・ボード、アクティビティ・ストリームおよびフィードバックに関連するデータをエクスポートしない場合は、このオプションの選択を解除します。たとえば、テスト環境からステージング環境や本番環境にアプリケーションを移動する場合は、テスト・データは不要になる場合があります。

注意: エクスポート・プロセスでは、メール、ディスカッション、お知らせ、ワークリスト、インスタント・メッセージおよびプレゼンス(IMP)、個人イベントおよびドキュメントなど、他の外部サービスに関連するデータはエクスポートされません。これらのサービスに関連するデータの移動方法の詳細は、その製品のドキュメントを参照してください。第39.1.3項「Spacesアプリケーション全体のバックエンド・コンポーネントの移行」も参照してください。

カスタマイズを含む

これを選択すると、アプリケーションのカスタマイズがエクスポートされます。エクスポート時にオプションであるアプリケーション・カスタマイズの詳細は、表39-4および表39-5を参照してください。

このオプションの選択を解除する場合、WebCenter Portal: Spacesは、これらのアプリケーション・カスタマイズなしでエクスポートされます。

ポートレットおよびページのカスタマイズは常にエクスポートされます。図39-1「Spacesアプリケーションでエクスポートされる情報」も参照してください。

5. 「エクスポート」をクリックします。

6. 「ダウンロード」ダイアログで(図39-4)、「エクスポート」をクリックして続行するかどうかを確認します。

図39-4 エクスポート・アーカイブのダウンロード

「図39-4 エクスポート・アーカイブのダウンロード」の説明

エクスポート・プロセス中に進捗情報が表示されます。エクスポート処理中はエクスポートされているアプリケーションにアクセスできません。

7. エクスポート・プロセスが完了したら、エクスポート・アーカイブ(.ear)の保存場所を指定します。

図39-5 エクスポート・アーカイブの保存

「図39-5 エクスポート・アーカイブの保存」の説明

次のいずれかを選択します。

- ダウンロード: エクスポートのEARファイルはローカル・ファイル・システムに保存されます。
ブラウザでダウンロードされ、アーカイブはローカルに保存されます。実際のダウンロード場所は、ブラウザの設定ごとに異なります。

- サーバーに保存: エクスポートのEARファイルはサーバー位置に保存されます。
「アーカイブの場所」ダイアログ・ボックスが表示されたら(図39-6)、「サーバーの場所」に適切なパスを入力し(例: /tmp)、「保存」をクリックします。EARの名前はここでは必要ありません。

指定したサーバー・ディレクトリにwrite権限があることを確認します。

図39-6 アーカイブの場所

「図39-6 アーカイブの場所」の説明

8. 「閉じる」をクリックして「エクスポート」ウィンドウを閉じます。

エクスポート・アーカイブ(.EAR)は、指定された場所に保存されます。

診断ログ・ファイルWC_Spaces-diagnostic.logを調べて、エクスポート・プロセス時にレポートされた警告またはエラーを確認してください。ログ・ファイルを表示するには、メニュー・オプション「WebCenter」→「ログ」→「ログ・メッセージの表示」を選択します。詳細は、第34.3項「ログ情報の表示および構成」を参照してください。第39.5項「Spacesのインポートおよびエクスポート問題のトラブルシューティング」も参照してください。

39.1.4.2 WLSTを使用したSpacesアプリケーションのエクスポート

WLSTコマンドのexportWebCenterApplicationを使用して、Spacesアプリケーションをエクスポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterApplicationに関する項を参照してください。

Spacesアプリケーションは、データ競合を回避するために、エクスポート操作中に一時的に使用できなくなります。Spacesページにログインまたはアクセスするユーザーには、「アプリケーションが使用できません」ページが表示されます。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.1.5 Spacesアプリケーション全体のインポート

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用してSpacesアプリケーション全体をインポートする方法について説明します。

Spacesアプリケーションをインポートする前に必要な作業は次のとおりです。

- LDAPアイデンティティ・ストア、資格証明ストア、ポリシー・ストア、ディスカッション・サーバー、Content Server、Oracle WebLogic Communications Server、ポートレット・プロデューサなど、アプリケーションのバックエンド・コンポーネントを移行します。第39.1.3項「Spacesアプリケーション全体のバックエンド・コンポーネントの移行」を参照してください。
ページ・ユーザーがホーム・スペースで作成する個人用ページは、ターゲットおよびソース・アプリケーションの両方が同じLDAPアイデンティティ・ストアを使用する場合にのみ移行されます。これは個人用ページ割当てがユーザーGUIDごとであるからです。

- データベース・スキーマ、WebCenter Portalリポジトリ、MDSおよびポリシー・ストアをバックアップすることもお薦めします。第39.4項「WebCenter Portalアプリケーションのバックアップおよびリカバリ」を参照してください。

- Administratorロールに割り当てられたすべてのユーザーがターゲット・アイデンティティ・ストアに存在することを確認します。インポート時に、Spacesセキュリティ・ポリシーにリストされているユーザーは、ドメインに対して構成されているアイデンティティ・ストアでチェックされます。ユーザーが見つからない場合、そのユーザーに関連付けられているポリシーは削除されます。第29.5項「外部LDAPサーバーへの管理者アカウントの移行」も参照してください。

- インポートするSpacesアーカイブ(.ear)がWebCenter Spaces 11.1.1.4.0以降からエクスポートされたことを確認します。旧バージョン(11.1.1.2.0または11.1.1.3.0)から直接WebCenter Spaces 11.1.1.4.0にアーカイブをインポートできません。エクスポート・アーカイブを作成する前に、必要に応じて11.1.1.4.0にアップグレードする必要があります。詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』のOracle WebCenterのパッチ適用に関する項を参照してください。

Spacesアプリケーションは、データ競合を回避するために、インポートおよびエクスポート操作中に一時的に使用できなくなります。Spacesページにログインまたはアクセスするユーザーには、「アプリケーションが使用できません」ページが表示されます。

この項の内容は次のとおりです。

- 第39.1.5.1項「Fusion Middleware Controlを使用したSpacesアプリケーションのインポート」

- 第39.1.5.2項「WLSTを使用したSpacesアプリケーションのインポート」

- 第39.1.5.3項「インポートされたSpacesアプリケーションの確認」

39.1.5.1 Fusion Middleware Controlを使用したSpacesアプリケーションのインポート

Fusion Middleware管理者は、Fusion Middleware Controlを使用してWebCenterアプリケーション全体をインポートできます。

Fusion Middleware Controlを使用してSpacesアプリケーションをインポートする手順は、次のとおりです。

1. Fusion Middleware Controlで、Spacesのホームページに移動します。
第6.2項「Spacesアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「アプリケーションのインポート」を選択します。

3. 「スペース・アプリケーション・インポート」ページ(図39-7)で、Spacesアプリケーション・アーカイブ(.ear)の場所を指定します。次のうちから選択します。

- ローカル・ファイル・システムにあるアーカイブ: 「アーカイブの場所」を入力します。あるいは、「参照」をクリックして、.earファイルが格納されているローカル・ファイル・システム上のディレクトリを見つけます。

- サーバー・ファイル・システムにあるアーカイブ: 「アーカイブの場所」を入力します。このSpacesアプリケーションからアクセス可能な任意の共有場所です。

選択するアーカイブには、Spacesアプリケーション全体のエクスポートが含まれる必要があります。ここから個々のスペースをインポートすることはできません。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペースおよびスペース・テンプレートのエクスポートおよびインポートに関する項を参照してください。

図39-7「スペース・アプリケーション・インポート」ページ

「図39-7「スペース・アプリケーション・インポート」ページ」の説明

4. 「インポート」をクリックします。

5. 「スペース・アプリケーション・インポート」ダイアログ(図39-8)で、「インポート」をクリックします。

図39-8「スペース・アプリケーション・インポート」ダイアログ

「図39-8「スペース・アプリケーション・インポート」ダイアログ」の説明

インポートが完了すると、成功メッセージが表示されます。

Spacesアプリケーション全体をインポートした後、ログインしてアプリケーションを確認します。詳細は、第39.1.5.3項「インポートされたSpacesアプリケーションの確認」を参照してください。

39.1.5.2 WLSTを使用したSpacesアプリケーションのインポート

WLSTコマンドのimportWebCenterApplicationを使用して、Spacesアプリケーションをインポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

Spacesアプリケーション全体をインポートした後、ログインしてアプリケーションを確認します。詳細は、第39.1.5.3項「インポートされたSpacesアプリケーションの確認」を参照してください。

39.1.5.3 インポートされたSpacesアプリケーションの確認

Spacesアプリケーション全体をインポートした後で必要な作業は次のとおりです。

1. 新たにインポートされたSpacesアプリケーションがデプロイされる管理対象サーバーを再起動します。
クラスタ環境で、クラスタの各管理対象サーバーを再起動します。第8.2項「WebCenter Portalアプリケーションをデプロイするための管理対象サーバーの起動および停止」も参照してください。

2. Spacesアプリケーションにログインし、すべてのスペースおよびスペース・テンプレートが予期したとおりに使用可能であることを確認します。
使用可能でない場合は、第39.5.2項「スペースおよびスペース・テンプレートがインポート後に使用できない」を参照してください。

3. Oracle Secure Enterprise Searchクローラを開始し、新たにインポートされたデータを索引付けします。
Oracle Secure Enterprise Search管理者ガイドも参照してください。

39.1.6 個々のスペースのエクスポートおよびインポートの前提条件

1つ以上のスペースをエクスポートするには、スペースを含むSpacesアプリケーションが稼働中であり、エクスポートするすべてのスペースがデータの競合を回避するためにオフラインである必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペースのオフライン化に関する項を参照してください。スペースにWeb Serviceデータ制御またはポートレットが含まれる場合、すべての関連するWeb Servicesまたはプロデューサもエクスポートおよびインポートが成功するように稼働中でアクセス可能である必要があります。

バックエンド・コンポーネント、特にディスカッション・サーバーに関連付けられたスペース関連のデータは、スペースをエクスポートまたはインポートした後で移行する必要があります。次の第39.1.7項「個々のスペースのバックエンド・コンポーネントの移行」を参照してください。

注意:

多数のスペースの同時エクスポートまたはインポートは、サーバー構成によってはシステム・パフォーマンスに影響を及ぼす可能性があるためお薦めしません。パフォーマンスの重大な低下が生じる場合は、エクスポートまたはインポートをより小さないくつかのグループに分けてください。

39.1.7 個々のスペースのバックエンド・コンポーネントの移行

1つ以上のスペースを移行する場合、スペースによって使用されるバックエンド・コンポーネントも移行する必要があります。この項では、この方法について説明します。

この項の内容は次のとおりです。

- 第39.1.7.1項「スペースのディスカッションのエクスポート」

- 第39.1.7.2項「スペースのディスカッションのインポート」

- 第39.1.7.3項「スペースのドキュメントのエクスポート」

- 第39.1.7.4項「スペースのドキュメントのインポート」

- 第39.1.7.5項「ドキュメント移行ユーティリティを使用したスペース・ドキュメントのエクスポート/インポート」

これらのバックエンド・コンポーネントをインポートする前に、ターゲットにスペースをインポートする必要があります。

39.1.7.1 スペースのディスカッションのエクスポート

ディスカッション・サーバー管理コンソールを使用して、特定のスペースに関連付けられているディスカッションをエクスポートします。

スペース・ディスカッションが.xmlファイルにエクスポートされ、DOMAIN_HOME/config/fmwconfig/servers/<target_server_name>/owc_discussions/data/ディレクトリの.zipファイルに保存されます。

DOMAIN_HOMEは、Oracle WebLogic Serverドメインのパスです。例: MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data/。

スペースのディスカッションをエクスポートする手順は、次のとおりです。

1. ディスカッション・サーバー管理コンソールにログインします。
コンソールのURLが分かっている場合は、直接ログインできます。例: http://example.com:8890/owc_discussions/admin

または、次のようにSpacesからログインします。

1. Spacesに管理権限でログインし、Spaces管理ページを開きます。
Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理ページへのアクセスに関する項を参照してください。

2. 「スペース」をクリックします。

3. エクスポートするスペースを選択し、「編集」メニューから「スペースの編集」を選択します。

4. 「サービス」をクリックし、「ディスカッション」をクリックします。

5. このスペースに関連付けられている「フォーラム名/ID」または「カテゴリ名/ID」を書き留めます。
WebCenter Portalのディスカッション・サーバーはディスカッション・カテゴリとフォーラムIDを順に生成します。このIDがターゲット・システムに存在する場合、インポートされたフォーラム(またはカテゴリ)が新しい、一意のIDを割り当てられるため、新しいIDをポイントするようにインポートされたスペースを再構成する必要があります。詳細は、第39.1.9.1項「Spacesアプリケーションを使用した個々のスペースのインポート」の手順11を参照してください。

6. 「フォーラム管理」をクリックして、管理コンソールにログインします。

2. 管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLエクスポートおよびインポート」を選択します。

3. 「データのエクスポート」を選択します。

4. 次のオプションを設定します(図39-9):

1. エクスポート・オプション: 「カスタム・オプション」を選択し、すべてのチェック・ボックスを選択します。

2. コンテンツのエクスポート: 「特定のコンテンツのエクスポート」を選択して、必要なフォーラムまたはカテゴリの名前を選択します。
注意: 複数のフォーラムをサポートするスペースは、カテゴリを使用してディスカッションを格納します。他のスペースは単一フォーラムを使用します。

3. エクスポート場所、エクスポート・ファイル名、エクスポート・ファイルのエンコーディング: デフォルト値を保持します。

図39-9 個々のスペースのディスカッションのエクスポート

5. 「エクスポートの開始」をクリックします。

6. 完了したら、MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/<server_name>/owc_discussions/dataディレクトリからターゲット・ディスカッション・サーバーの同じ場所に.zipファイル(エクスポート.xmlファイルを含む)をコピーします。
例: MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data。

ターゲット・システムにスペース・ディスカッションをインポートする前に、移行するスペースがターゲット上に存在している必要があります。第39.1.9.1項「Spacesアプリケーションを使用した個々のスペースのインポート」を参照してください。

39.1.7.2 スペースのディスカッションのインポート

ディスカッション・サーバー管理コンソールを使用して、別のWebCenter Spacesアプリケーションからエクスポートされたディスカッションをインポートします。

ディスカッション・データをインポートする前に、関連するスペースがターゲット上に存在することを確認します。第39.1.9.1項「Spacesアプリケーションを使用した個々のスペースのインポート」を参照してください。

注意:

WebCenter Portalのディスカッション・サーバーはディスカッション・カテゴリとフォーラムIDを順に生成します。そのため、2つのターゲット(またはソースからターゲット)間でディスカッション・データをインポートする場合は、両方のシステムに同じIDが存在している場合があります。IDクラッシュが発生する場合は、インポートされたフォーラム(またはカテゴリ)は新しい、一意のIDを割り当てられるため、新しいIDをポイントするようにスペースを再構成する必要があります。詳細は下記の手順11を参照してください。

特定のスペースのディスカッションをインポートする手順は、次のとおりです。

1. ディスカッション・サーバー管理コンソールにログインします。
コンソールのURLが分かっている場合は、直接ログインできます。例: http://example.com:8890/owc_discussions/admin

または、次のようにSpacesからログインします。

1. Spacesに管理権限でログインし、Spaces管理ページを開きます。
Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理ページへのアクセスに関する項を参照してください。

2. 「Spaces」をクリックします。

3. データをインポートするスペースを選択し、「編集」メニューから「スペースの編集」を選択します。

4. 「サービス」をクリックし、「ディスカッション」をクリックします。

5. 「フォーラム管理」(右端)をクリックし、管理コンソールにログインします。

2. 管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLエクスポートおよびインポート」を選択します。

3. 「データのインポート」を選択します。

4. 利用可能なリストから適切なスペース・エクスポート・ファイルを選択します(図39-10)。
必要なファイルがリスト表示されていない場合は、ソース・ディレクトリDOMAIN_HOME/config/fmwconfig/servers/<target_server_name>/owc_discussions/data/からこのターゲット上の同じ場所にエクスポート.zipファイルをコピーします。第39.1.7.1項「スペースのディスカッションのエクスポート」も参照してください。

DOMAIN_HOMEは、Oracle WebLogic Serverドメインのパスです。例: MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data/。

図39-10 スペースのディスカッションのインポート

5. 「インポートの開始」をクリックします。
インポート時に、ディスカッション・データはディスカッション・サーバーにコピーされます。次の手順で、以前に移行したスペースをこの新たにインポートされたデータと再度関連付けます。

6. 「コンテンツ」メニューを選択し、サイドバーで「コンテンツ・サマリー」を選択します。
システムのすべてのカテゴリおよびフォーラムがここにリスト表示されます。

7. 「WebCenter」を選択し、新たにインポートされたフォーラムまたはカテゴリの「移動」ボタンをクリックします。

8. ターゲットSpacesアプリケーションのルート・カテゴリを選択し、「カテゴリの移動」をクリックします。
カテゴリのサマリー・ページに新しい場所が表示されます。

9. サイドバーの「権限」をクリックします。

10. ユーザー・タイプ: 「すべてのユーザー」および「登録済のユーザー」のすべての権限を解除し、「変更の保存」をクリックします(図39-11)。

図39-11 フォーラム権限の編集

11. Spacesアプリケーションで、スペースのディスカッション・フォーラムの設定タブに移動して、インポートしたディスカッション・データにスペースを再度関連付けます。

1. Spacesに管理権限でログインします。
Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理ページへのアクセスに関する項を参照してください。

2. Spaces管理を開きます。

3. 「スペース」をクリックします。

4. データをインポートするスペースを選択し、「編集」メニューから「スペースの編集」を選択します。

5. 「サービス」をクリックし、「ディスカッション」をクリックします。

6. カテゴリIDまたはフォーラムIDの横の「検索」アイコンをクリックし、リストからインポート済カテゴリ(またはフォーラム)を選択します。

7. 「適用」をクリックします。

39.1.7.3 スペースのドキュメントのエクスポート

ドキュメントはソース・コンテンツ・リポジトリに維持されるため、スペースをエクスポートする前にスペース関連のドキュメントをエクスポートする必要はありません。スペースを別のSpacesアプリケーションに移行した後で、WebCenter Portalのドキュメント移行ユーティリティを使用して、ソース・スペースからドキュメントをエクスポートし、それらを新しいターゲット・スペースにインポートできます。詳細な手順は、第39.1.7.5項「ドキュメント移行ユーティリティを使用したスペース・ドキュメントのエクスポート/インポート」を参照してください。

39.1.7.4 スペースのドキュメントのインポート

スペースにドキュメントをインポートするいくつかの方法があります。

- Spacesアプリケーションで、スペースを開いて、「ドキュメント」ページ、またはドキュメント・マネージャ、ドキュメント・エクスプローラまたはフォルダ・ビューア・タスク・フローで、「アップロード」アクションを使用して、一度に1つまたは複数のファイルをインポートします。Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドの新規ファイルのアップロードに関する項を参照してください。

- コンテンツ・リポジトリがOracle WebCenter Content Serverの場合の操作は、次のとおりです。

- 第39.1.7.5項「ドキュメント移行ユーティリティを使用したスペース・ドキュメントのエクスポート/インポート」の説明に従って、WebCenter Portalのドキュメント移行ユーティリティを使用します。
このユーティリティを使用して、Oracle WebCenter Content Server上の1つ以上のスペースに対して格納されているすべてのファイル/フォルダを移行します。このユーティリティを使用してドキュメントを移行する場合は、ファイルがwikiであっても、ブログであっても、これらを含むほとんどのドキュメント・メタデータが保存されます。

- Oracle WebCenter Content Serverシステム管理者ガイドのコンテンツの一括ロードに関する項に従ってバッチ・ローダー・ユーティリティを使用します。
ドキュメント・メタデータを保持するか、またはインポート後の作業にコンテンツ・プレゼンタ・タスク・フローのドキュメント・リンクが必要な場合は、バッチ・ローダーを使用して、スペース関連のドキュメントを移行します。

- 出荷時のOracle WebCenter Content ServerとともにインストールされているWebDAVを使用して、Content Serverリポジトリの元のスペースに属しているフォルダからターゲット・スペースに割り当てられている空のフォルダまでコンテンツをドラッグ・アンド・ドロップします。ターゲット・システムにコンテンツをドラッグ・アンド・ドロップする場合は、元のスペースのソース・フォルダをターゲットにドラッグしないでください。スペースのフォルダの下に格納されているコンテンツのみドラッグ・アンド・ドロップしてください。
ドキュメントの格納に使用されるContent ServerのWebDAV URLが不明な場合は、Fusion Middleware管理者に連絡してください。そのContent ServerのベースURLがhttp://host:port/relative_web_rootである場合は、WebDAVルートURLは、http://host:port/relative_web_root/idcplg/webdavです。

注意:

使用するWebDAVクライアントによって、すべてのプロパティがコピーされない場合があります(たとえば、ドキュメントの説明、チェックインとチェックアウト・ステータスおよびバージョンは実行されない場合があります)。

特に、スペースにwiki/ブログが含まれる場合は、WebDAVを使用しないでください。WebDavはカスタム・メタデータを維持しないため、wiki/ブログはHTMLドキュメントとしてインポートされ、ターゲットで破損しているように見えます。

39.1.7.5 ドキュメント移行ユーティリティを使用したスペース・ドキュメントのエクスポート/インポート

WebCenter Portalのドキュメント移行ユーティリティを使用して特定のスペース(またはスペースのセット)に対して格納されているすべてのファイルおよびフォルダを移行できます。同じユーティリティを使用して、スペース・テンプレートに対して格納されているドキュメントを移行できます。ドキュメントの移行には次の3つの固有のフェーズがあります。

- 第1フェーズ: 新しいターゲットへのスペースの移行
インポート時に、ドキュメント・サービスはソースに一致するように、ターゲットで有効または無効になっています。ドキュメント・サービスがソースで有効になっている場合、ターゲットOracle WebCenter Content Server上でスペース(またはスペース・テンプレート)に対してフォルダが作成され、適切なContent Server権限により、ユーザーおよびグループにスペース/スペース・テンプレートへのアクセス権が付与されます。

- 第2フェーズ: ドキュメントのエクスポート
スペース(またはスペース・テンプレート)に対してドキュメント・コンテンツをエクスポートする場合、Oracle WebCenter Content Server上のスペースに対して格納されているすべてのファイル/フォルダの現在のバージョンがエクスポート・アーカイブに含まれます。

- 第3フェーズ: 新しいターゲットへのドキュメントのインポート
インポート時に、ファイル/フォルダの正確な階層構造が維持されます。ファイル/フォルダのメタデータも可能な場合は維持されます。特に、これはwikiおよびブログがターゲット上のwiki/ブログとして表示されることを意味します。

この項では、第2および第3フェーズについて説明します。第1フェーズ(スペース/スペース・テンプレートの移行)の詳細は、 第39.1項「データ移行のためのSpacesアプリケーションのエクスポートおよびインポート」を参照してください。ドキュメント移行ユーティリティは、スペース/スペース・テンプレート・ドキュメントを、ユーティリティが後でアーカイブ済ドキュメントをターゲットにインポートするために使用可能なアーカイブにエクスポートします。

次の情報は、エクスポート・アーカイブには含まれていません。

- ホーム・スペース・コンテンツ

- バージョン履歴: 現在の改訂のみが移行されます

- レンディション: レンディションはターゲット上の設定ごとに、インポート時に再作成されます。

- 元の作成日: すべてのドキュメント/フォルダの日付をドキュメントがインポートされる日時にリセットする日付を作成します

- 不明なドキュメント・タイプ: ターゲットに存在しないドキュメント・タイプがターゲットのデフォルトのドキュメント・タイプに設定されています。

- ドキュメント上のコメント: ユーザーがSpacesアプリケーションの使用時にドキュメントに関して入力するコメントは、ドキュメント・メタデータとしてではなく、アクティビティ・ストリーム・データとともに格納されます。

- ドキュメントへのリンク: ユーザーがドキュメントに対して作成するリンクは、ドキュメント・メタデータとしてではなく、リンク・データとともに格納されます。

39.1.7.5.1 ドキュメント移行ユーティリティの実行に必要なプロパティ

表39-2にドキュメント移行ユーティリティの実行に必要なプロパティを示します。ユーティリティの実行方法の詳細は、第39.1.7.5.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。

表39-2 ドキュメント移行プロパティ

プロパティ

説明

要件

Usage

コンテンツをファイルにインポートまたはエクスポートするかどうかを指定します。オプションはimportおよびexportです

エクスポートおよびインポート

MDSConn

MDS JDBC接続を次の形式で指定します。

jdbc:oracle:thin:@host:port:SIDまたは

jdbc:oracle:thin:@host:port/ServiceName

エクスポート

MDSUser

Spacesアプリケーションで使用されるMDSユーザー名を指定します

エクスポート

MDSPwd

MDSユーザーのパスワードを指定します。パスワードのプロンプトを表示させないためにのみこれを含めます。

エクスポート

ExportScopes

各スペース/スペース・テンプレートの内部名をエクスポートするコンテンツとともに指定します。複数のスペース/テンプレート名をカンマで区切ります。スペース・テンプレート名の先頭にspacetemplate/<template_internal_name>を付けます。カンマ区切りリストにスペースがないことを確認します。

「スペースについて」および「スペース・テンプレートについて」ダイアログから内部名を取得できます。ここに表示名は入力しないでください。

エクスポート

UCMConn

Content Server URLを次の形式で指定します: idc://host:intradocPort

usage=exportの場合、コンテンツのエクスポート元からContent ServerインスタンスのURLを指定します。

usage=importの場合、コンテンツのインポート先へContent ServerインスタンスのURLを指定します。

エクスポートおよびインポート

UCMUser

RIDCからの接続に使用されるContent Serverユーザー名を指定します。

エクスポートおよびインポート

UCMPwd

Content Serverユーザーのパスワードを指定します。パスワードのプロンプトを表示させないためにのみこれを含めます。

エクスポートおよびインポート

TmpDirPath

オプション。データ抽出の一時的な場所。指定されない場合、デフォルトはシステムの一時ディレクトリです。

エクスポートおよびインポート

ArchivePath

ドキュメント・アーカイブの場所。

エクスポートおよびインポート

ArchiveName

オプション。ドキュメント・アーカイブの名前(.zip)。デフォルトはdocsexport.zipです。

エクスポートおよびインポート

39.1.7.5.2 ドキュメント移行ユーティリティを使用したコンテンツの移行

1つ以上のスペース(またはスペース・テンプレート)に対してドキュメントを移行するには、次の方法のいずれかを使用できます。

- プロパティ・ファイルでのドキュメント移行プロパティの指定

- コマンド・ラインでのドキュメント移行プロパティの指定

- 求められた場合のコマンド・ラインでのドキュメント移行プロパティの指定

コンテンツを移行する前に実行する/知る必要のある内容:

1. 必要なスペース/スペース・テンプレートをターゲット・アプリケーションに移行します。
詳細は、第39.1.9項「個々のスペースのインポート」または第39.1.12項「スペース・テンプレートのインポート」を参照してください。

2. 移行先: WEBCENTER_ORACLE_HOME/webcenter/archives
このディレクトリには、ドキュメント移行ユーティリティcontent-migration-tool.jarが含まれます。

ドキュメントのエクスポート時に、ドキュメント・アーカイブ(.zip)がarchivePathプロパティで指定する場所に作成されます。

また、ドキュメントのインポート時に、エクスポート・アーカイブ(archivePathプロパティとして指定される)のドキュメント・コンテンツがターゲットContent Serverにアップロードされます。これを確認するには、Spacesアプリケーションにログインして、スペース(またはスペース・テンプレート)に移動し、インポートされたコンテンツが期待どおりに使用可能であることを確認します。

プロパティ・ファイルでのドキュメント移行プロパティの指定

1. エクスポート/インポートに必要なすべてのプロパティを含むプロパティ・ファイルを作成します。すべてのプロパティの説明は、表39-2を参照してください。

1. 次のプロパティ・ファイルをメモ帳または別の適切なテキスト・エディタにコピーして貼り付け、環境に応じて編集します。

# Document migration properties for one or more spaces.

# Specify whether you want to export content to a file or
# import content from an archive to another content repository
# valid values: export | import
Usage=export

# Specify connection details for Oracle WebCenter Content repository:
#   UCMConn - Content Server URL. Format: idc://host:intradocPort
#   UCMUser - Content Server user name used to connect through RIDC
#   UCMPwd  - Password for UCMUser. Only include to avoid password prompt
# Required for: Export and Import

UCMConn=idc://mycontentserver.mycompany.com:9444
UCMUser=weblogic
#UCMPwd=welcome1

# Specify a temp directory and name/location for the export archive
#   TmpDirPath  -Optional. Temporary location for data extraction.
#                If not specified, defaults to the system temporary directory.
#   ArchiveName -Optional. Name for the document archive (.zip).
#                Default is docsexport.zip.
#   ArchivePath -Document archive location
# Required for: Export and Import

TmpDirPath=/scratch/user1/migrateMySpaceDocs/tmpdir
ArchivePath=/scratch/user1/migrateMySpaceDocs/output
ArchiveName=myspacedocs.zip

# Specify MDS details (export only)
#   MDSConn - MDS JDBC connection. Format:
#                jdbc:oracle:thin:@host:port:SID   or
#                jdbc:oracle:thin:@host:port/ServiceName
#   MDSUser - MDS schema user name used by the Spaces application
#   MDSPwd = Password for MDSUser. Only include to avoid password prompt
# Required for: Export

MDSConn=jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
MDSUser=user1_mds
#MDSPwd=welcome1

# Specify the internal name of each space/space template with content to export.
# Seperate multiple space/template names with a comma.
# Use internal names only. Do not enter display names.
# Obtain internal names from "About Space" and "About Space Template" dialogs.
# Prefix space template names with 'spacetemplate/<template_internal_name>'
# as indicated in the example.
# Required for: Export

ExportScopes=MySpace1,MySpace2,spacetemplate/MySpaceTemplate

2. ファイルを保存します。たとえば、myMigrationProperties.propertiesとして保存します。

2. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWEBCENTER_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

3. 絶対パスをコマンド・ライン上のドキュメント移行プロパティ・ファイルに指定することにより、ドキュメント移行ユーティリティを実行します(例39-11)。

java -jar content-migration-tool.jar <absolute_path_to_migrationPropertiesFilename>

オプションで、第39.1.7.5.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

例39-11 プロパティ・ファイルでのドキュメント移行プロパティの指定

java -jar content-migration-tool.jar /home/user1/myMigrationProperties.properties

Running the Document Migration Utility with the following settings:
Usage            = export
UCM Connection   = idc://mycontentserver.mycompany.com:9444
UCM User         = weblogic
Archive fullname = /scratch/user1/migrateMySpaceDocs/output/myspacedocs.zip
Scopes to Export = [mySalesSpace,spacetemplate/SalesTemplate]
MDS Connection   = jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
MDS User         = user1_mds
Setting up MDS connection
Connection to MDS created successfully

コマンド・ラインでのドキュメント移行プロパティの指定

1. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWEBCENTER_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

2. コマンド・ライン上で個々のプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。
コンテンツをエクスポートするには:

java -jar content-migration.jar Usage UCMConn UCMUser TmpDirPath ArchivePath ArchiveName MDSConn MDSUser ExportScopes [UCMPwd MDSPwd]

コンテンツをインポートするには:

java -jar content-migration.jar Usage UCMConn UCMUser TmpDirPath ArchvePath ArchiveName [UCMPwd]

注意: オプションで、コマンド・ライン上で、UCMPwdおよびMDSPwdパラメータを指定できます。指定しない場合は、これらを指定するよう求められます。

オプションで、第39.1.7.5.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

例39-12は、MySalesSpaceというスペースおよびSalesTemplateというスペース・テンプレートをエクスポートします。

例39-12 エクスポートのためのコマンド・ライン上のドキュメント移行プロパティの指定

java -jar content-migration-tool.jar export idc://mycontentserver.mycompany.com:9444
weblogic /scratch/user1/migrateMySpaceDocs/tmpdir
/scratch/user1/migrateMySpaceDocs/output/myspacedocs.zip
jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01 user1_mds
[mySalesSpace, spacetemplate/SalesTemplate] mypassword mypassword

Running the Document Migration Utility with the following settings:
Usage            = export
UCM Connection   = idc://mycontentserver.mycompany.com:9444
UCM User         = weblogic
Archive fullname = /scratch/user1/migrateMySpaceDocs/output/myspacedocs.zip
Scopes to Export = [mySalesSpace,spacetemplate/SalesTemplate]
MDS Connection   = jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
MDS User         = user1_mds
Setting up MDS connection
INFO: Export completed successfully. Export archive located at /scratch/user1/migrateMySpaceDocs/output/myspacedocs.zip

求められた場合のコマンド・ラインでのドキュメント移行プロパティの指定

1. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWEBCENTER_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

2. 求められた場合はコマンド・ライン上でプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。

java -jar content-migration.jar

オプションで、第39.1.7.5.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

例39-13は、MySalesSpaceというスペースおよびSalesTemplateというスペース・テンプレートをエクスポートします。

例39-13 求められた場合のコマンド・ライン上でのドキュメント移行プロパティの指定

java -jar content-migration-tool.jar

Enter the usage ('export' or 'import'): export
Enter UCM Connection (idc://<host name>:<socket port>):
idc://mycontentserver.mycompany.com:9444
Enter UCM User: weblogic
Enter UCM Password: mypassword
Enter the full path to the temporary directory:
/scratch/user1/migrateMySpaceDocs/tmpdir
Enter path to the directory where the export archive is to be created:
/scratch/user1/migrateMySpaceDocs/output/
Enter the name of the export archive to create (default = docsexport.zip):
myspacedocs.zip
Enter MDS Spaces Data Source Connection (jdbc:oracle:thin:@<host name>:<jdbc port>:<SID>): jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
Enter MDS Spaces Data Source User: user1_mds
Enter MDS Spaces Data Source Password: welcome1
Enter a comma separated list of scopes to export:
[mySalesSpace, spacetemplate/SalesTemplate]
Running Document Migration Utility with the following settings:
Usage            = export
UCM Connection   = idc://mycontentserver.mycompany.com:9444
UCM User         = weblogic
Archive fullname = /scratch/user1/migrateMySpaceDocs/output/myspacedocs.zip
Scopes to Export = [mySalesSpace,spacetemplate/SalesTemplate]
MDS Connection   = jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
MDS User         = user1_mds
Setting up MDS connection
INFO: Export completed successfully. Export archive located at
/scratch/user1/migrateMySpaceDocs/output/myspacedocs.zip

39.1.7.5.3 追加のログを指定したドキュメント移行ユーティリティの実行

次のようにオプションでjava.util.logging.config.fileパラメータを使用し、追加のログを指定してドキュメント移行ユーティリティを実行できます。

java -Djava.util.logging.config.file=<absolute_path_to_logging_properties_file> -jar content-migration-tool.jar <migrationProperties>

注意: java.util.logging.config.fileパラメータは、javaコマンドの直後、-jarの前に指定する必要があります。

logging_properties_fileに次のような設定が含まれます。

handlers=java.util.logging.ConsoleHandler.level=INFO
java.util.logging.ConsoleHandler.level=FINER
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
oracle.webcenter.doclib.level=INFO

39.1.8 個々のスペースのエクスポート

管理者は、Spaces管理ページから、またはWLSTコマンドを使用して、1つ以上のスペースをエクスポートできます。

スペース情報は、単一のエクスポート・アーカイブ(.earファイル)にエクスポートされます。このEARファイルには、メタデータ・アーカイブ(.marファイル)とセキュリティ・ポリシー情報を含む単一のXMLファイルが含まれます。エクスポート・スペース・アーカイブは、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存できます。

エクスポートされる内容の詳細は、第39.1.1項「Spacesのエクスポートおよびインポートの理解」を参照してください。

エクスポート・プロセスには、ディスカッション、お知らせおよびドキュメントなど、外部サービスに関連するデータは含まれません。これらのサービスに関連するデータを移動する方法については、第39.1.7項、「個々のスペースのバックエンド・コンポーネントの移行」を参照してください。

個々のスペースは、同じスペースの同時インポート/エクスポートを回避するために、エクスポート操作中にロックされます。他のユーザーが特定のスペースをエクスポートする場合、同じスペースをエクスポート(またはインポート)しようとするすべての後続の試みはブロックされます。スペースにWeb Serviceデータ制御が含まれる場合、すべての関連するWeb Servicesはエクスポートが成功するように稼働中でアクセス可能である必要があります。

注意:

スペース・アーティファクトは、エクスポートされる共有のコンテンツ・ディレクトリでロックされる必要があります。たとえば、ページ・テンプレートに関連付けられているアイコンおよびイメージは、エクスポートされるページ・テンプレートのコンテンツ・ディレクトリに配置される必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリソースのプロパティに関する必要な知識に関する項を参照してください。

初期設定のテンプレートおよびユーザー・カスタマイズはエクスポートされません。ユーザー・カスタマイズの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページ・コンポーネントのカスタマイズに関する必要な知識に関する項を参照してください。

この項の内容は次のとおりです。

- 第39.1.8.1項「Spacesアプリケーションを使用した個々のスペースのエクスポート」

- 第39.1.8.2項「WLSTを使用した個々のスペースのエクスポート」

Spacesアプリケーション全体をエクスポートする場合は、第39.1.4項「Spacesアプリケーション全体のエクスポート」を参照してください。

39.1.8.1 Spacesアプリケーションを使用した個々のスペースのエクスポート

管理者は、Spaces管理ページから1つ以上のスペースをエクスポートできます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペースのエクスポートに関する項を参照してください。

39.1.8.2 WLSTを使用した個々のスペースのエクスポート

WLSTコマンドexportGroupSpacesを使用して、1つ以上のスペースをエクスポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportGroupSpacesに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.1.9 個々のスペースのインポート

管理者はSpacesアプリケーションから、またはWLSTコマンドを使用して、スペース・アーカイブ(.EAR)をインポートできます。

インポートの際、アーカイブに含まれるすべてのスペースは、ターゲット・アプリケーションで作成または再作成されます。既存のスペースは、削除されてから置換され、新しいスペースが作成されます。

ターゲット・アプリケーションで使用可能な名前と同一の名前が付けられたスペースをインポートする場合は、これらのスペースがターゲット・アプリケーションでオフラインであることを確認してください。インポート時に、オンラインの場合、スペースを上書きすることはできません。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペースのオフライン化に関する項を参照してください。

スペースは、同じスペースの同時インポート/エクスポートを回避するために、インポート操作中にロックされます。他のユーザーが特定のスペースをインポートする場合、同じスペースをインポート(またはエクスポート)しようとするすべての後続の試みはブロックされます。スペースにWeb Serviceデータ制御が含まれる場合、すべての関連するWeb Servicesはインポートが成功するように稼働中でアクセス可能である必要があります。

すべてのスペースにはセキュリティ・ポリシーが必要です。したがって、新しいスペースをインポートする場合は、スペースのセキュリティ・ポリシーもインポートすることを確認してください。既存のスペースは、セキュリティ・ポリシーに準拠しており、この場合、セキュリティ情報を上書きするか、または既存のセキュリティ・ポリシーを維持しているかどうかを調べます。

セキュリティ付きのスペースをインポートする場合、セキュリティ・ポリシーの更新がただちに適用されません。Spacesアプリケーションにログインするユーザーは、新しいスペース・セキュリティ・ポリシーを採用するために、ログアウトしてから、再度ログインする必要があります。

データ移行が重要である場合、個々のスペースに対してドキュメントおよびディスカッションを移行することができます。詳細は、第39.1.7項「個々のスペースのバックエンド・コンポーネントの移行」を参照してください。

この項の内容は次のとおりです。

- 第39.1.9.1項「Spacesアプリケーションを使用した個々のスペースのインポート」

- 第39.1.9.2項「WLSTを使用した個々のスペースのインポート」

1つ以上のスペースをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。

39.1.9.1 Spacesアプリケーションを使用した個々のスペースのインポート

管理者は1つ以上のスペース(.EAR)を含むアーカイブを別のSpacesアプリケーションにインポートできます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペースのインポートに関する項を参照してください。

39.1.9.2 WLSTを使用した個々のスペースのインポート

WLSTコマンドimportGroupSpacesを使用して、1つ以上のスペースをインポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportGroupSpacesに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.1.10 スペース・テンプレートのバックエンド・コンポーネントの移行

スペース・テンプレートには、ページ、ポータル・リソース、ドキュメント、ディスカッション、リストおよびメンバー詳細を含めることができます。多くのテンプレート・データはテンプレートとともにエクスポートされるため、スペース・テンプレートをエクスポートおよびインポートする際にはテンプレート・データを個別に移行する必要はありません。

ただし、(Oracle WebCenter Content Server上で)スペース・テンプレートのフォルダおよびコンテンツを、次で説明されているようにターゲット・インスタンスに移行する必要があります。移行しない場合、ドキュメント・サービスは、このテンプレートを使用して作成するスペースで有効になりません。

スペース・テンプレートのバックエンド・フォルダおよびドキュメントのインポート

WebCenter Portalのドキュメント移行ユーティリティを使用して、スペース・テンプレートのドキュメント・コンテンツを移行します。詳細は、第39.1.7.5項「ドキュメント移行ユーティリティを使用したスペース・ドキュメントのエクスポート/インポート」を参照してください。

39.1.11 スペース・テンプレートのエクスポート

管理者はスペース・テンプレートをエクスポートし、他のSpacesアプリケーションにそれらをインポートすることができます。初期設定のテンプレートはエクスポートできません。

スペース・テンプレートには、カスタム・ロールや現在のメンバーなどのページ、リソース、ドキュメント、ディスカッション、リスト、サービス情報およびセキュリティ情報を含むことができます。

エクスポートおよびインポート・ユーティリティは主に、Spacesアプリケーション間での情報の移動に使用されますが、スペース・テンプレートのエクスポート機能は、バックアップ・サービスとしても役立ち、他のユーザーとのテンプレートの共有と交換にも便利です。

スペース・テンプレート情報は、1つのエクスポート・アーカイブ(.EARファイル)にエクスポートされます。EARファイルには、メタデータ・アーカイブ(.MARファイル)と、スペースのセキュリティ・ポリシー情報が記述された1つのXMLファイルが含まれます。

エクスポート・アーカイブは、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存できます。

この項の内容は次のとおりです。

- 第39.1.11.1項「Spacesアプリケーションを使用したスペース・テンプレートのエクスポート」

- 第39.1.11.2項「WLSTを使用したスペース・テンプレートのエクスポート」

第39.1.10項「スペース・テンプレートのバックエンド・コンポーネントの移行」および第39.1.8項「個々のスペースのエクスポート」も参照してください。

39.1.11.1 Spacesアプリケーションを使用したスペース・テンプレートのエクスポート

Spaces管理者は、Spaces管理ページから1つ以上のスペース・テンプレートをエクスポートできます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペース・テンプレートのエクスポートに関する項を参照してください。

39.1.11.2 WLSTを使用したスペース・テンプレートのエクスポート

WLSTコマンドexportGroupSpaceTemplatesを使用して、1つ以上のスペース・テンプレートをエクスポートします。コマンドの構文と例は、Oracle Fusion Middleware WebLogicスクリプト・ツール・コマンド・リファレンスのexportGroupSpaceTemplatesに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.1.12 スペース・テンプレートのインポート

管理者はスペース・テンプレート・アーカイブ(.EAR)を別のSpacesアプリケーションにインポートできます。

インポートの際、アーカイブに含まれるすべてのスペース・テンプレートは、ターゲット・アプリケーションで再作成されます。ターゲットにスペース・テンプレートが存在する場合は、削除および置換されます。スペース・テンプレートが存在しない場合は、作成されます。

新たにインポートされたスペース・テンプレートは、すぐには使用できません。すべてのユーザーに使用できるようにするには、インポートされたテンプレートを公開する必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペース・テンプレートの公開と非表示に関する項を参照してください。

この項の内容は次のとおりです。

- 第39.1.12.1項「Spacesアプリケーションを使用したスペース・テンプレートのインポート」

- 第39.1.12.2項「WLSTを使用したスペース・テンプレートのインポート」

第39.1.9項「個々のスペースのインポート」も参照してください。

39.1.12.1 Spacesアプリケーションを使用したスペース・テンプレートのインポート

Spaces管理者は、Spaces管理ページから1つ以上のスペース・テンプレートをインポートできます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのスペース・テンプレートのインポートに関する項を参照してください。

39.1.12.2 WLSTを使用したスペース・テンプレートのインポート

WLSTコマンドimportGroupSpacesを使用して、1つ以上のスペース・テンプレートをインポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportGroupSpacesに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.1.13 Spacesリソースのエクスポート

認可されたユーザーは、アプリケーションの実行時に、スキンおよびページ・テンプレートなどのSpacesリソースをダウンロードし、Oracle JDeveloperなどのツールでそれらのリソースを編集および展開し、Spacesアプリケーションにアップロードすることができます。リソースを他のSpacesアプリケーションと共有、または他のSpacesアプリケーションに移行するユーザーもダウンロード機能を使用できます。

Spacesのリソース管理ページから、次のアプリケーションレベルおよびスペースレベルのリソースをダウンロードできます。

- スキン

- ページ・スタイル

- ページ・テンプレート

- コンテンツ表示テンプレート

- ナビゲーション

- リソース・カタログ

- タスク・フロー

- マッシュアップ・スタイル

または、管理者はWLSTコマンドを使用して同じタスクを実行できます。

WebCenter Portalリソースをダウンロード(またはエクスポート)すると、リソースの詳細がWebCenter Portalエクスポート・アーカイブ(.EAR)に保存されます。希望のファイル名を使用して、エクスポート・アーカイブをローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存することができます。

この項の内容は次のとおりです。

- 第39.1.13.1項「Spacesアプリケーションを使用したWebCenterリソースのエクスポート」

- 第39.1.13.2項「WLSTを使用したWebCenterリソースのエクスポート」

39.1.13.1 Spacesアプリケーションを使用したWebCenterリソースのエクスポート

Spaces管理者および個々のスペース・モデレータはWebCenter Portalリソース管理ページからリソースをエクスポートできます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリソースのダウンロードに関する項を参照してください。

39.1.13.2 WLSTを使用したWebCenterリソースのエクスポート

WLSTコマンドexportWebCenterResourceを使用して、単一のWebCenter Portalリソースをエクスポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.1.14 Spacesリソースのインポート

認可されたユーザーは、アプリケーションの実行時に、スキンおよびページ・テンプレートなどのポータル・リソースをインポート(WLST使用時にアップロード)できます。リソース管理ページから、またはWLSTコマンドを使用して、次のアプリケーションレベルおよびスペースレベルのリソースをインポートできます。

- スキン

- ページ・スタイル

- ページ・テンプレート

- コンテンツ表示テンプレート

- ナビゲーション

- リソース・カタログ

- タスク・フロー

- マッシュアップ・スタイル

以前保存したリソースをWebCenter Portalエクスポート・アーカイブ・ファイル(.EAR)にのみインポートできます。詳細は、第39.1.13項「Spacesリソースのエクスポート」を参照してください。

インポート時:

- 既存のポータル・リソース、つまり、同じ内部IDを持つリソースが上書きされます。

- スペースレベルのポータル・リソースは、常に同じスペースにインポートされます。リソースを別のスペースにインポートできません。

この項の内容は次のとおりです。

- 第39.1.14.1項「Spacesアプリケーションを使用したWebCenterリソースのインポート」

- 第39.1.14.2項「WLSTを使用したWebCenterリソースのインポート」

39.1.14.1 Spacesアプリケーションを使用したWebCenterリソースのインポート

Spaces管理者および個々のスペース・モデレータはWebCenter Portalリソース管理ページからリソースをインポートできます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリソースのアップロードに関する項を参照してください。

39.1.14.2 WLSTを使用したWebCenterリソースのインポート

WLSTコマンドimportWebCenterResourceを使用して、単一のWebCenter Portalリソースをインポートします。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.2 データ移行のためのFrameworkアプリケーションのエクスポートおよびインポート

この項では、Oracle WebCenter Portal: Framework(Frameworkアプリケーションと呼ばれる)を使用して開発したポータル・アプリケーションのメタデータおよびアプリケーションのカスタマイズをエクスポートおよびインポートする方法について説明します。

内容は次のとおりです。

- 第39.2.1項「Frameworkアプリケーションのエクスポートおよびインポートの理解」

- 第39.2.2項「Frameworkアプリケーションのエクスポートおよびインポートの前提条件」

- 第39.2.3項「ポートレット・クライアント・メタデータのエクスポート(Frameworkアプリケーション)」

- 第39.2.4項「ポートレット・クライアント・メタデータのインポート(Frameworkアプリケーション)」

- 第39.2.5項「WebCenter Portalリソースのエクスポート(Frameworkアプリケーション)」

- 第39.2.6項「WebCenter Portalリソースのインポート(Frameworkアプリケーション)」

- 第39.2.7項「WebCenter Portalサービス・メタデータおよびデータのエクスポート(Frameworkアプリケーション)」

- 第39.2.8項「WebCenter Portalサービス・メタデータおよびデータのインポート(Frameworkアプリケーション)」

- 第39.2.9項「WebCenter Portalアプリケーションのセキュリティの移行」

- 第39.2.10項「データの移行(WebCenter Portalアプリケーション)」

39.2.1 Frameworkアプリケーションのエクスポートおよびインポートの理解

ステージング環境と本番環境間で、Frameworkアプリケーション、アプリケーション間の接続およびカスタマイズ(つまり、アプリケーション、ページおよびポートレットに適用されたカスタマイズ)をエクスポートおよびインポートするには、いくつかの移行ツールを使用できます(図39-12)。

図39-12 WebCenter Portalアプリケーションのエクスポートおよびインポート

表39-3に、使用可能な移行ツールとその機能を示します。表39-3にリストされているすべてのカスタマイズは、Frameworkアプリケーションを使用して移行されます。

表39-3 WebCenter Portal: Frameworkアプリケーション移行ツール

移行ツール

機能

ポートレット・クライアントWLSTコマンド

ポートレット・クライアント・メタデータ、プロデューサ・カスタマイズおよびパーソナライズをエクスポートおよびインポートできます。

WebCenter PortalリソースWLSTコマンド

スキン、ページ・テンプレートなどのWebCenter Portalリソースをエクスポートおよびインポートできます。

MDS WLSTコマンド

次のデータをエクスポートおよびインポートできます。

- ページおよびWebCenter Portalサービスに対して行われたカスタマイズを含むFrameworkアプリケーション・メタデータ

- connections.xmlおよびadf-config.xmlドキュメントで格納されたデータ

移行WLSTコマンド

ロールおよびユーザーとロールのマッピングが含まれるセキュリティ・ポリシーをエクスポートおよびインポートできます。

Oracle Databaseユーティリティ

Frameworkアプリケーション・データをエクスポートおよびインポートできます。詳細は、『Oracle Databaseユーティリティ』のOracle Data Pumpに関する項を参照してください。

Oracle以外のデータベース・ユーティリティ

データ移行ツールの詳細は、データベース・メーカーのドキュメントを参照してください。

39.2.2 Frameworkアプリケーションのエクスポートおよびインポートの前提条件

Frameworkアプリケーションのメタデータおよびカスタマイズをエクスポートまたはインポートする前に、次のことを確認してください。

- アプリケーション・メタデータおよびスキーマが格納されているデータベースが稼働中であること。

- ターゲット・インスタンスが、ソース・インスタンスと同じサービス・セットで構成されていること。必要に応じて、ターゲットで追加のサービスを構成できますが、ソースおよびターゲットのサービス構成は一致している必要があります。

- ポリシーがインポート時に移行されるように、jps.policystore.removalパラメータがアプリケーションのweblogic-application.xmlでOFFに設定されていること。

<application-param>
<param-name>jps.policystore.removal</param-name>
<param-value>OFF</param-value>
</application-param>

このオプションが設定されていない場合、ポリシー情報がインポートされません。一部のインスタンスでは、ポリシー・データを移行しない場合があります。これは、テスト環境から、テスト・データが必要とされない本番環境に移行する場合です。ただし、実行時にソース・インスタンスで作成されたページはターゲット・インスタンス上に表示されません。これは、ページ許可がターゲット上に存在しないためです。

39.2.3 ポートレット・クライアント・メタデータのエクスポート(Frameworkアプリケーション)

Frameworkアプリケーションに対して、ポートレット・クライアント・メタデータ、プロデューサ・カスタマイズおよびパーソナライズをエクスポートするには、WLSTコマンドexportPortletClientMetadataを使用します。このコマンドはアプリケーション全体で実行されるため、アプリケーションで格納されるすべてのプロデューサのメタデータをエクスポートします。特定のプロデューサのメタデータをエクスポートすることはできません。

注意:

ポートレット・プロデューサおよび個別ポートレットの両方に、trueに設定されている<allow-export>タグが含まれている必要があります。このタグが設定されていない場合、ポートレット・プロデューサ(およびポートレット)はエクスポート・プロセスから除外されます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のカスタマイズのエクスポート/インポートの実装方法(WSRP 2.0)に関する項を参照してください。

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

すべてのアプリケーションに関連したポートレット・クライアント・メタデータのインポート方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のポートレット・プリファレンス・ストア移行ユーティリティに関する項を参照してください。

39.2.4 ポートレット・クライアント・メタデータのインポート(Frameworkアプリケーション)

この項では、WLSTコマンドimportPortletClientMetadataを使用して、Frameworkアプリケーションに対して、ポートレット・クライアント・メタデータ、プロデューサ・カスタマイズおよびパーソナライズをインポートする方法について説明します。

前提条件:

- アプリケーション・メタデータまたはスキーマが格納されているデータベースおよびポートレット・プロデューサが稼働している必要があります。

- ポートレット・プロデューサおよび個別ポートレットの両方に、trueに設定されている<allow-import>タグが含まれている必要があります。このタグが設定されていない場合、ポートレット・プロデューサ(およびポートレット)はインポート・プロセスから除外されます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のカスタマイズのエクスポート/インポートの実装方法(WSRP 2.0)に関する項を参照してください。

ポートレット・クライアント・メタデータをインポートするには、WLSTコマンドimportPortletClientMetadataを実行します。

importPortletClientMetadata(appName, fileName, [server, applicationVersion)]

各要素の意味は次のとおりです。

- appName: Frameworkアプリケーションの名前(例: myWebCenterApp)。

- fileName: ポートレット・クライアント・メタデータが含まれるエクスポート済EARファイルの名前(例: myportletmetadata.ear)。

- server: Frameworkアプリケーションがデプロイされる管理対象サーバーの名前(例: WC_CustomPortal)。

- applicationVersion: アプリケーションの複数のバージョンがデプロイされる場合は、デプロイされたアプリケーションのバージョン番号。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

構文の詳細と例は、Oracle Fusion Middleware WebLogicスクリプト・ツール・コマンド・リファレンスのimportPortletClientMetadataに関する項を参照してください。メタデータ・サービス(MDS)カスタムWLSTコマンドも参照してください。

39.2.5 WebCenter Portalリソースのエクスポート(Frameworkアプリケーション)

認可されたユーザーは、Frameworkアプリケーションの実行時に、スキンおよびページ・テンプレートなどのアプリケーション・リソースをダウンロードし、Oracle JDeveloperなどのツールでそれらのリソースを編集および展開し、Frameworkアプリケーションにアップロードすることができます。リソースを他のFrameworkアプリケーションと共有、または他のFrameworkアプリケーションに移行するユーザーもダウンロード機能を使用できます。

WebCenter Portal管理コンソールから実行時に次のポータル・リソースをダウンロードできます。

- スキン

- ページ・スタイル

- ページ・テンプレート

- コンテンツ表示テンプレート

- ナビゲーション

- リソース・カタログ

- タスク・フロー

- マッシュアップ・スタイル

WebCenter Portalリソースをダウンロード(またはエクスポート)すると、リソースの詳細がWebCenter Portalエクスポート・アーカイブ(.EAR)に保存されます。希望のファイル名を使用して、エクスポート・アーカイブをローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存することができます。

詳細は、第36.5.8項「リソースのダウンロードとアップロード」を参照してください。

または、システム管理者はWLSTコマンドexportWebCenterResourceを使用して同じタスクを実行できます。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。

39.2.6 WebCenter Portalリソースのインポート(Frameworkアプリケーション)

認可されたユーザーは、Frameworkアプリケーションの実行時に、スキンおよびページ・テンプレートなどのアプリケーション・リソースをインポートできます。WebCenter Portal管理コンソールから実行時に次のリソースをインポートできます。

- スキン

- ページ・スタイル

- ページ・テンプレート

- コンテンツ表示テンプレート

- ナビゲーション

- リソース・カタログ

- タスク・フロー

- マッシュアップ・スタイル

ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システム上のWebCenter Portalエクスポート・アーカイブ・ファイル(.ear)に以前に保存されたリソースをインポートできます。既存のリソース、つまり同じ内部IDを持つリソースがインポート時に上書きされます。

詳細は、第36.5.8項「リソースのダウンロードとアップロード」を参照してください。

または、管理者はWLSTコマンドimportWebCenterResourceを使用して同じタスクを実行できます。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.2.7 WebCenter Portalサービス・メタデータおよびデータのエクスポート(Frameworkアプリケーション)

WebCenter Portalサービスで作成されたメタデータは、Oracleメタデータ・ストア(MDS)に格納されます。MDSの詳細は、『Oracle Fusion Middleware管理者ガイド』の「Oracle Metadata Repositoryの管理」を参照してください。

WebCenter Portalサービスのベース・ドキュメントをそのカスタマイズとともにエクスポートするには、WLSTコマンドexportMetadataを使用します。

次に例を示します。

exportMetadata(application='myWebCenterApp', server='WC_CustomPortal', toLocation='/tmp/myrepos', docs='/oracle/webcenter/**')

各要素の意味は次のとおりです。

- application: メタデータをエクスポートするFrameworkアプリケーション名(例: myWebCenterApp)。

- server: Frameworkアプリケーションをデプロイするサーバー(例: WC_CustomPortal)。

- toLocation: ソース・パーティションから選択したドキュメントをエクスポートする先のターゲット・ディレクトリ。toLocationパラメータは、異なるサーバー間でメタデータを移行するための一時ファイル・システムとして使用できます。

- docs: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りリスト。
この例では、"docs='/oracle/webcenter/**"はMDSでメタデータを格納しているすべてのWebCenter Portalサービスに対して必要なドキュメントをエクスポートします。

注意:

"docs='/oracle/webcenter/**"コマンドは、ポートレットのカスタマイズやパーソナライズ、またはconnections.xmlやadf-config.xmlなどの構成ファイルへの変更はエクスポートしません。

- ポートレット・メタデータをエクスポートするには、WLSTコマンドexportPortletClientMetadataを実行します。第39.2.3項「ポートレット・クライアント・メタデータのエクスポート(Frameworkアプリケーション)」も参照してください。

- MDSで格納されている構成ファイルの更新をエクスポートするには、WLSTコマンドexportMetadataを"docs='/META-INF/mdssys/cust/adfshare/adfshare/**"とともに実行します。付録A「adf-config.xmlおよびconnections.xml」も参照してください。

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

ステージング環境と本番環境の間でFrameworkアプリケーションが移行されると、表39-4に示されたカスタマイズもエクスポートされます。

ベース・ドキュメントとカスタマイズ・ドキュメントからなるWebCenter Portalサービスのメタデータは、次のパスに格納されます。

- 分析: /oracle/webcenter/analytics/**

- お知らせ: /oracle/webcenter/collab/announcement/**

- ブログ: /oracle/webcenter/blog/**

- ドキュメント: /oracle/webcenter/doclib/**および/oracle/webcenter/doclib/view/jsf/fragments/**

- ディスカッション: /oracle/webcenter/collab/forum/**

- 一般設定: /oracle/webcenter/generalsettings/**

- イベント: /oracle/webcenter/collab/events/**

- 外部アプリケーション: /oracle/webcenter/admin/**およびoracle/adfinternal/extapp/**

- インスタント・メッセージおよびプレゼンス: /oracle/webcenter/collab/rtc/**

- リンク: /oracle/webcenter/relationship/**

- 言語: /oracle/webcenter/webcenterapp/**

- リスト: /oracle/webcenter/list/**および/oracle/webcenter/list/view/jsf/regions/**

- メール: /oracle/webcenter/collab/mail/**

- ナビゲーション: /oracle/webcenter/navigationtaskflows/**

- 注意: /oracle/webcenter/note/**

- ページ: /oracle/webcenter/page/** and /pageDefs/**

- 投票: /oracle/webcenter/collab/survey/**

- ピープル・コネクション(コネクション): /oracle/webcenter/peopleconnections/connection/**

- ピープル・コネクション(フィードバック): /oracle/webcenter/peopleconnections/kudos/**

- ピープル・コネクション(プロファイル・ギャラリー): /oracle/webcenter/peopleconnections/personalweb/**

- ピープル・コネクション (プロファイル): /oracle/webcenter/peopleconnections/profile/**

- ピープル・コネクション (メッセージ・ボード): /oracle/webcenter/peopleconnections/wall/**

- 投票: /oracle/webcenter/collab/survey/**

- 最近のアクティビティ: /oracle/webcenter/recentactivity/**

- リソース・アクション・ハンドラ: /oracle/webcenter/framework/service/**

- RSSニュース・フィード: oracle/webcenter/rssviewer/**

- スコープ: /oracle/webcenter/framework/scope/**

- 検索: /oracle/webcenter/search/**

- セキュリティ: /oracle/webcenter/security/**

- スマート・タグ: /oracle/webcenter/collab/smarttag/**

- スペース・ブラウザ: /oracle/webcenter/community/**

- スペース連絡先: /oracle/webcenter/people/**

- サブスクリプション: /oracle/webcenter/notification/**

- タグ: /oracle/webcenter/tagging/**

- adf-config.xml、connections.xml: /META-INF/mdssys/cust/adfshare/adfshare/**
構成ファイルの更新は、WebCenter Portalサービスの横の/oracle/webcenter/ディレクトリの下に格納されません。これらのファイルに関連付けられたカスタマイズをエクスポートするには、exportMetadata"docs='META-INF/mdssys/cust/adfshare/adfshare/**"とともに実行します。付録A「adf-config.xmlおよびconnections.xml」も参照してください。

39.2.8 WebCenter Portalサービス・メタデータおよびデータのインポート(Frameworkアプリケーション)

FrameworkアプリケーションのWebCenter Portalサービス・メタデータおよびカスタマイズをインポートするには、WLSTコマンドimportMetadataを使用します。次に例を示します。

importMetadata(application='myWebCenterApp', server='WC_CustomPortal', fromLocation='/tmp/myrepos', docs='/**')

各要素の意味は次のとおりです。

- application: メタデータをインポートするFrameworkアプリケーションの名前(例: myWebCenterApp)。

- server: アプリケーションがデプロイされるターゲット・サーバーの名前(例: WC_CustomPortal)。

- fromLocation: ドキュメントがインポートされる元のソース・ディレクトリ。fromLocationパラメータは、異なるサーバー間でメタデータを移行するための一時ファイル・システムの場所とすることができます。

- docs: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りリスト。

構文の詳細と例は、Oracle Fusion Middleware WebLogicスクリプト・ツール・コマンド・リファレンスのimportMetadataに関する項を参照してください。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

39.2.9 WebCenter Portalアプリケーションのセキュリティの移行

セキュリティの移行には、アイデンティティ・ストア、資格証明ストアおよびポリシー・ストアのWebCenter Portalアプリケーションから別のWebCenter Portalアプリケーションへの移動が含まれます。すべてのWebCenter Portalアプリケーションに対してプロセスが同じであるため、Spacesアプリケーションに提供されている同じ手順に従うことができます。

- 第39.1.3.1項「LDAPアイデンティティ・ストアのエクスポート」

- 第39.1.3.2項「LDAPアイデンティティ・ストアのインポート」

- 第39.1.3.3項「LDAP資格証明ストアのエクスポートおよびインポート」

- 第39.1.3.4項「LDAPポリシー・ストアのエクスポートおよびインポート」

39.2.10 データの移行(WebCenter Portalアプリケーション)

WebCenter Portalアプリケーションをエクスポートするには、エクスポートおよびインポート・データベース・ユーティリティを使用します。この項の内容は次のとおりです。

- 第39.2.10.1項「データのエクスポート(WebCenter Portalアプリケーション)」

- 第39.2.10.2項「データのインポート(WebCenter Portalアプリケーション)」

39.2.10.1 データのエクスポート(WebCenter Portalアプリケーション)

WebCenter Portalアプリケーション・データをエクスポートするには、適切なデータベース・ユーティリティを使用します。

- Oracleデータベースの場合、データベースのORACLE_HOME/binに移動して、例39-14で説明されるコマンドを実行します。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

例39-14 Data Pumpユーティリティ(エクスポート)

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\" OWNER=srcrcuprefix_WEBCENTER FILE=/tmp/wc.dmp STATISTICS=none

各要素の意味は次のとおりです。

- DB_ORACLE_HOMEは、Oracle WebCenter Portalスキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- OWNERは、エクスポートされるスキーマです。これは、インストール時に使用されたRCU接尾辞を、接尾辞_WEBCENTERとともに指定します。例: DEV_WEBCENTER。

- FILEには、エクスポートされたデータが含まれます。

詳細は、『Oracle Databaseユーティリティ』のOracle Data Pumpに関する項を参照してください。

39.2.10.2 データのインポート(WebCenter Portalアプリケーション)

WebCenter Portalアプリケーション・データをインポートするには、適切なデータベース・ユーティリティを使用します。

- Oracleデータベースの場合、データベースのORACLE_HOME/binに移動して、例39-15で説明されるコマンドを実行します。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

例39-15 Data Pumpユーティリティ(インポート)

DB_ORACLE_HOME/bin/impdp  \"sys/password@serviceid as sysdba\" remap_schema=srcrcuprefix_WEBCENTER:tgtrcuprefix_WEBCENTER remap_tablespace=source_tablespace:target_tablespace DUMPFILE=/tmp/wc.dmp STATISTICS=none TRANSFORM=oid:n

各要素の意味は次のとおりです。

- DB_ORACLE_HOMEは、Oracle WebCenter Portalスキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- REMAP_SCHEMAは、ソースおよびターゲット・スキーマを識別します。たとえば、スキーマ名には、インストール時に使用されたRCU接尾辞_WEBCENTERが、ユーザーが指定した接頭辞とともに含まれます。例: DEV_WEBCENTER。

- REMAP_TABLESPACEは、ソースおよびターゲット・テーブルスペースを識別します。ソース・テーブルスペース内の永続データのインポートで選択されたすべてのオブジェクトが、ターゲット・テーブルスペースで作成されるように再マップします。例: source_tablespace:target_tablespace。

- DUMPFILEはインポートされるデータを含みます。

詳細は、『Oracle Databaseユーティリティ』のOracle Data Pumpに関する項を参照してください。

39.3 他のWikiアプリケーションからのWikiドキュメントの移行

カスタム・アプリケーションをドキュメント移行ユーティリティと組み合せて使用して、wikiコンテンツをConfluenceなどの外部wikiアプリケーションからWebCenter Portal: Spacesに移行できます。カスタムwiki抽出ツールは、ドキュメント移行ユーティリティを使用して、wikiコンテンツをSpacesコンテンツ・リポジトリにインポート可能なアーカイブ形式に抽出します。

カスタムwiki抽出ツールを記述するには、スペース、スペース・テンプレート、wikiドキュメントおよびwikiページに対してContent Serverで作成したコンテンツの詳細な理解とともにドキュメント移行ユーティリティおよびそのアーカイブの形式についての詳細な理解が必要です。この項で説明するこれらの形式と処理は次のとおりです。

- 第39.3.1項「スペースおよびスペース・テンプレートのドキュメント・コンテンツの理解」

- 第39.3.2項「WikiドキュメントおよびWikiページの理解」

- 第39.3.3項「ドキュメント移行ユーティリティの理解」

- 第39.3.4項「ソースWikiアプリケーションからSpacesへのデータの移行」

39.3.1 スペースおよびスペース・テンプレートのドキュメント・コンテンツの理解

ドキュメント・サービスがスペースまたはスペース・テンプレートで有効になっている場合、データがContent Serverで作成されます。

この項の内容は次のとおりです。

- 第39.3.1.1項「スペースの理解」

- 第39.3.1.2項「スペース・テンプレートの理解」

- 第39.3.1.3項「フォルダおよびフォルダのファイル制限の理解」

- 第39.3.1.4項「スペースおよびスペース・テンプレートのエクスポート/インポートの理解」

39.3.1.1 スペースの理解

スペースのドキュメント・サービスが有効になっている場合(作成時または作成後のいずれかに)、すべてのスペース・フォルダを含むルート・フォルダの下にフォルダが作成されます。ルート・フォルダはプライマリ・コンテンツ・リポジトリ接続の設定で指定されます。接続プロパティの詳細は、第11.2.3.13.2項「Spaces用のContent Server接続の構成」を参照してください。

スペースに対して作成されたフォルダのGUIDはSpacesでスペースの内部識別子から取得されます。たとえば、ルート・フォルダがWebCenterで、スペースMarketingが作成されている場合、次のデータがContent Serverで作成されます。

Folder Name = Marketing
Folder Path = /WebCenter/Marketing
Folder GUID = 13828FE1-75D8-4A0B-A53B-A76AE78C1AE6

ドキュメント・コンテンツ(ファイル/フォルダ/wikiなど)がスペースに追加される場合、アーティファクトがContent Serverのスペース・フォルダ内で作成されます。

39.3.1.2 スペース・テンプレートの理解

スペース・テンプレートについて、フォルダはルート・フォルダの下にあるspacetemplatesフォルダに作成されます。スペースに対して作成されたフォルダのGUIDはSpacesでスペース・テンプレートの内部識別子に一致します。

たとえば、ルート・フォルダがWebCenterで、スペース・テンプレートTemplate1が作成される場合、次のデータがContent Serverで作成されます。

/WebCenter/spacetemplates/Template1

ドキュメント・コンテンツは、テンプレートが作成されるときにのみテンプレートに追加できます。テンプレートが作成された後で追加することはできません。スペースからテンプレートを作成する際に、「テンプレートの作成」ダイアログの「コンテンツ」タブで「ドキュメント」が選択されている場合、スペースのドキュメント・コンテンツがテンプレートにコピーされます。

39.3.1.3 フォルダおよびフォルダのファイル制限の理解

Content Serverでは、フォルダ数およびフォルダ内で作成することを許可しているファイル数に制限があります。各設定の制限に達した場合、そのタイプの追加のコンテンツをそのフォルダに追加することはできません。

これらの設定を大きくして、ユーザーが多数のコンテンツを作成できるようにする必要がありますが、そのコンテンツをレンダリングするときにユーザー・インタフェースに障害が発生するほど大きくしないでください。これらの設定に対する変更は、追加される新しいコンテンツにのみ影響を及ぼします。既存のフォルダのコンテンツがこれらの設定より大きい場合は、影響されません。

フォルダおよびファイル数の設定を編集する操作は次のとおりです。

1. Content Serverにログインします。

2. 「管理」→「フォルダ構成」に移動します。

3. 「仮想フォルダの管理構成」セクションで、環境に応じて、「仮想フォルダ当たりの最大フォルダ数」および「仮想フォルダ当たりの最大コンテンツ数」の設定を調整します。
これらの設定の詳細は、Oracle WebCenter Content Serverアプリケーション管理者ガイドの「仮想フォルダの管理構成」画面に関する項を参照してください。

注意:

WebCenter Portal: Spacesインスタンスのスペース・フォルダすべてを含むルート・フォルダはこれらの設定をバイパスし、作成されるスペース・フォルダ数を制限より多くすることができます。

39.3.1.4 スペースおよびスペース・テンプレートのエクスポート/インポートの理解

WebCenter Portal: Spacesでは、スペースおよびスペース・テンプレートをエクスポートおよびインポートするためのツールを提供します。インポート時に、ドキュメント・サービスは、ソースと一致するように、ターゲットで有効または無効になっています。ドキュメント・サービスがソースで有効になっている場合、フォルダがスペースまたはスペース・テンプレートのターゲットContent Serverで作成され、適切なContent Server権限により、ユーザーおよびグループにスペースまたはスペース・テンプレートへのアクセス権が付与されます。スペースまたはスペース・テンプレートのContent ServerのフォルダのGUIDは、ソースおよびターゲットのContent Serverで同じです。スペースおよびスペース・テンプレートに対してSpacesで作成されるフォルダの詳細は、第39.3.1項「スペースおよびスペース・テンプレートのドキュメント・コンテンツの理解」を参照してください。

ドキュメント移行ユーティリティを使用してソースからターゲットのインスタンスにドキュメント・コンテンツを移行するには、その前に、Spacesの移行が正常に完了し、Content Serverに、ドキュメントが有効になっているスペースおよびスペース・テンプレートに対して作成されたフォルダがある必要があります。Spacesの移行の詳細は、第39.1項「データ移行のためのSpacesアプリケーションのエクスポートおよびインポート」を参照してください。

39.3.2 WikiドキュメントおよびWikiページの理解

この項では、Spacesでのwikiドキュメントおよびwikiページの形式とその動作方法について説明します。Spacesでのwikiドキュメントおよびwikiページの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのWikiドキュメントの使用に関する項を参照してください。

この項の内容は次のとおりです。

- 第39.3.2.1項「Wikiドキュメントの理解」

- 第39.3.2.2項「Wikiページの理解」

39.3.2.1 Wikiドキュメントの理解

WebCenter Portal: Spacesでは、ドキュメント・サービスを使用してwikiドキュメントを作成できます。これらのドキュメントは、スペース内に作成されたフォルダ階層の任意の場所に置くことができます。Wikiドキュメントは他のタイプのドキュメントとともに存在するか、または単一フォルダ内にすべてのwikiドキュメントを配置することを選択できます。

wikiドキュメントがSpacesで作成される場合、HTMLドキュメントが作成され、Content Serverにチェックインされます。このwikiドキュメントには、ドキュメントが通常のHTMLドキュメントではなく、wikiドキュメントであることをSpacesに伝える特別なメタデータ値が含まれます。これらのメタデータ値は次のとおりです。

dDocType = Application
dDocFunction = wiki
dOriginalName (document filename) = <wikiName>.htm

上記のメタデータを含むSpacesのドキュメントを開く場合、Spacesはそれをwikiドキュメントとして表示します。

39.3.2.2 Wikiページの理解

WebCenter Portal: Spacesで、Wikiページ・テンプレートに基づいてページを作成することによりwikiページを作成できます。wikiページに移動すると、wikiドキュメントが表示されます。スペースの表示テンプレートに従って、クリックして、スペースにすべてのwikiページをリストすることができる「Wiki」メニューを表示することができます。Wikiページの作成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのWikiページ・スタイルを使用したWikiドキュメントの作成に関する項を参照してください。

wikiページがSpacesで作成される場合、次のアーティファクトがContent Serverで作成されます。

- フォルダが、wikiページが作成されているスペースのフォルダに作成され、wikiフォルダの名前はwikiページ名と同じですが、特定の文字が削除されています。

- ドキュメントは、次のメタデータとともにwikiフォルダ内に作成されます。

- dDocTitle = ドキュメント・タイトル(wikiページ名と同じ名前で、拡張子.htmを持つ)

- dOriginalName = ドキュメント・ファイル名(dDocTitleと同じ)

- dDocFunction = wiki

- dDocType = Application

- xWCPageID = wikiページのJSPXページの名前

これは例を使用して適切に示されます。ルート・フォルダがWebCenterで、wikiページが作成されているスペースがMarketingであり、作成されているwikiページがWiki1の場合、次のアーティファクトがContent Serverで作成されます。

- フォルダ: /WebCenter/Marketing/Wiki1

- ドキュメント: /WebCenter/Marketing/Wiki1/Wiki1.htm

- dDocTitle= Wiki1.htm

- dOriginalName = Wiki1.htm

- dDocFunction = 'wiki'

- dDocType = 'Application'

- xWCPageID = Wiki1.jspx

wikiページに移動すると、次の処理が実行されます。

- WebCenter Contentが次の場所のドキュメントを問い合わせます。
/<RootFolder>/<GroupSpaceFolder>/<wikiPageName>/<wikiPageName>.htm

例: /WebCenter/Marketing/Wiki1/Wiki1.htm

- ドキュメントが見つかった場合は、wikiドキュメントとして表示されます。

- ドキュメントでwikiページが見つからない場合は、wikiフォルダのコンテンツが表示されます。

39.3.3 ドキュメント移行ユーティリティの理解

この項では、ユーティリティの内部作業の詳細な説明および結果として生成されるドキュメント移行アーカイブの形式(カスタムwiki抽出ツールの記述が必要)を示します。ドキュメント移行ユーティリティは、スペースおよびスペース・テンプレート・ドキュメントを、ユーティリティが後でアーカイブ済ドキュメントをターゲットにインポートするために使用可能なアーカイブにエクスポートします。ドキュメント移行ユーティリティの使用方法の詳細は、第39.1.7.5.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。

この項の内容は次のとおりです。

- 第39.3.3.1項「ドキュメント移行ユーティリティのエクスポート機能の理解」

- 第39.3.3.2項「ドキュメント移行ユーティリティのインポート機能の理解」

39.3.3.1 ドキュメント移行ユーティリティのエクスポート機能の理解

エクスポート時に、指定されたスペースおよびスペース・テンプレートのContent Serverに格納されたドキュメント・コンテンツは、ドキュメント移行アーカイブに抽出されます。ドキュメント移行アーカイブは、スペースまたはスペース・テンプレートのすべてのコンテンツをアーカイブのその独自のトップレベル・フォルダに抽出します。このフォルダの名前は、Content Serverのスペースまたはスペース・テンプレート・フォルダの内部GUIDに基づいています。

ドキュメント移行アーカイブには、エクスポートでは各スペースまたはスペース・テンプレートのルート・フォルダが含まれます。つまり、4つのスペースからコンテンツをエクスポートする場合、アーカイブには4つのルート・フォルダがあります。これらのルート・フォルダの名前は、Content Serverの対応するスペースまたはスペース・テンプレート・フォルダの内部GUIDに基づいています。

スペースまたはスペース・テンプレートごとに1つのアーカイブを持つために、ドキュメント移行ユーティリティは一度に1つのスペース/スペース・テンプレートおよび固有のアーカイブ名を指定して、コールされる必要があります。

アーカイブの各トップ・レベル・フォルダ内には、そのルート・フォルダのデータを詳細に記述するXMLドキュメント(ExportImportData.xml)があり、そのスペースまたはスペース・テンプレートに対してエクスポートされたデータについて記述されています。これには、インポート時に維持される、ソースContent Serverのフォルダおよびファイルのすべてのメタデータが含まれます。アーカイブの形式の詳細は、第39.3.3項「ドキュメント移行ユーティリティの理解」を参照してください。ソースおよびターゲット間で維持されるメタデータの詳細は、第39.3.3.2.1項「ドキュメント移行ユーティリティのメタデータの処理方法の理解」を参照してください。

コンテンツがエクスポートされるスペースまたはスペース・テンプレートがある場合、エクスポート中に次が発生します。

- 一時ディレクトリが作成されます。

- 各スペースまたはスペース・テンプレートに対して

- ディレクトリが、その名前がContent Serverの対応するフォルダのGUIDである一時ディレクトリに作成されます

- ExportImportData.xmlドキュメントがその新しいディレクトリ内に作成されます

- Content Serverは、スペース/スペース・テンプレートのコンテンツを問い合わせます

- コンテンツがある場合、コンテンツが読み込まれ、フォルダ/ドキュメントに関する情報がExportImportData.xmlドキュメントに記述され、ファイルは一時ディレクトリにダウンロードされます

- コンテンツがある場合、コンテンツが読み込まれ、フォルダおよびドキュメントに関する情報がExportImportData.xmlドキュメントに記述されます。実際のファイルは、Content Serverとしてフォルダ階層を維持するディレクトリにダウンロードされます。たとえば、Content Serverで、ドキュメントdoc1.docがフォルダFolder1内にある場合、次に示すように、ドキュメントはFolder1の下のルート・フォルダに追加されます。

/<tmpDir>/<spaceFolder>/Folder1/doc1.doc

- すべてのコンテンツが抽出された後で、一時ディレクトリのコンテンツ全体がドキュメント移行アーカイブに圧縮されます。

39.3.3.2 ドキュメント移行ユーティリティのインポート機能の理解

ドキュメント移行ユーティリティが実行される前に、Spacesの移行が正常に完了し、スペースおよび/またはスペース・テンプレートがターゲットContent Serverで正しく作成されている必要があります。これらのフォルダがContent Serverに存在しない場合、ドキュメント・コンテンツのインポートは失敗します。Spacesの移行の詳細は、第39.1項「データ移行のためのSpacesアプリケーションのエクスポートおよびインポート」を参照してください。

注意:

ソースと同じ名前を持つスペースまたはスペース・テンプレートをターゲットで作成し、それを動作させることはできません。これを行う場合、Content Serverのフォルダはソースと同じ名前を持ちますが、GUIDは異なります。エクスポート・アーカイブのデータをターゲットContent Serverのターゲット・フォルダと同期化するのに使用されるものと同様に、SpacesのスペースをContent Serverのフォルダと関連付けるために使用されるのは、このフォルダGUIDです。

インポート時に、ドキュメント移行アーカイブが読み込まれ、各スペースまたはスペース・テンプレートのデータごとに、ターゲットContent Serverの対応するスペースまたはスペース・テンプレートのフォルダにコンテンツが再作成されます。アーカイブのトップ・レベル・フォルダの名前は、ターゲットContent Serverインスタンスのスペースまたはスペース・テンプレート・フォルダと同期化するために使用されます。ターゲットContent Serverのスペースまたはスペース・テンプレート・フォルダにコンテンツがすでに含まれている場合、デフォルトで、そのコンテンツはインポート処理が開始される前に削除されます。

注意:

ファイル内のすべてのプロパティを指定して、ドキュメント移行ユーティリティを実行する場合、デフォルトの動作は、プロパティ・ファイルのCheckExistingContentsプロパティ(値はtrueまたはfalse)を指定することにより上書きできます。falseに設定される場合、ターゲット・フォルダが既存のコンテンツに対してチェックされないようにデフォルトの動作が上書きされ、既存のコンテンツは削除されません。この設定がfalseの場合は注意する必要があります。ターゲットのコンテンツが同じコンテンツIDを持つか、同じフォルダのコンテンツが同じファイル名を持つ場合、インポートは失敗します。

各トップ・レベル・フォルダ内にあるXMLドキュメント(ExportImportData.xml)はインポートを実行するために使用されます。このドキュメントは、ターゲットContent Serverで再作成するようにファイルおよびフォルダの階層を記述します。また、このドキュメントにはアーティファクトの作成時に使用されるメタデータも含まれ、ドキュメントに対して、アップロードで使用するための、アーカイブのネイティブ・ファイルへのパスが含まれます。アーカイブの形式の詳細は、第39.3.3項「ドキュメント移行ユーティリティの理解」を参照してください。

インポート時に、次の操作が実行されます。

- ドキュメント移行アーカイブが一時ディレクトリに解凍されます。

- アーカイブのルートにある各フォルダに対して(スペースまたはスペース・テンプレートを表す)

- 対応するフォルダは、ターゲットContent Serverインスタンスから取得されます(Content ServerのフォルダのGUIDであるフォルダ名を使用)。

- ExportImportData.xmlドキュメントが読み込まれます

- ExportImportData.xmlで記述される各フォルダまたはファイルに対して、コンテンツがターゲット・インスタンスで再作成されます。
フォルダおよびファイルのExportImportData.xmlドキュメントの属性は、作成されるコンテンツのメタデータとして使用され、ファイルはアーカイブの対応する場所からアップロードされます。

- インポートが成功した場合は、その最後に、この一時ディレクトリは削除されます。完了する前にインポートが失敗する場合は、この一時ディレクトリはそのまま残ります。

39.3.3.2.1 ドキュメント移行ユーティリティのメタデータの処理方法の理解

ドキュメント移行ユーティリティは、ソースとターゲット間でできるだけ多くのメタデータを維持します。ただし、多くの内部メタデータ(IDなど)は維持されません。次のメタデータは、エクスポート・セットには含まれません。

- 作成日(dCreateDate、dReleaseDate、dDocLastModifiedDate)などの日付メタデータ

- ドキュメントに対して

- ドキュメントの改訂またはレンディションの内部識別子(たとえば、dID、dDoc)がありません。コンテンツID、dDocNameが含まれることに注意してください。

- ドキュメントが存在するフォルダのID(たとえば、xCollectionID)

- Web表示可能レンディションがありません。これらはドキュメントがターゲットにチェックインされるときに再作成されるためです

- 実際のファイルに関する情報がありません(たとえば、そのファイル・タイプやMIMEタイプ)。これらはドキュメントがターゲットにチェックインされるときに設定されるためです

- ターゲットでドキュメントを作成するときには関連がないため、チェックアウト済、リリース済状態などのステータス情報(たとえば、dIsCheckedOut、dReleaseState)がありません

- フォルダに対して:

- 親フォルダIDなどの内部識別子またはパス、または独自のパス(たとえば、hasCollectionID、dCollectionID、dCollectionGUID、hasCollectionPath、dCollectionPath)がありません

- ストレージ・ルール。これはターゲットContent Serverの構成に依存しているためです

- セキュリティ・グループまたは他のセキュリティ権限。これらはコンテンツがターゲットで作成されるときに設定されるためです(たとえば、dSecurityGroup、dRead、canReadCollection)

維持されるメタデータ:

- フォルダ名やドキュメント・タイトルなどのアーティファクトの名前(たとえば、dCollectionName、dDocTitle)

- コンテンツを作成し、それを変更したユーザーの名前(たとえば、dCollectionOwner、dDocOwner)

- dDocFunction、dDocType、xWCPageIDなどのWikiメタ―データ

- ドキュメントに対して

- ドキュメントに対してアップロードするファイルの名前(dOriginalName)

- コンテンツID (dDocName)
インポート時に、同じコンテンツIDを持つコンテンツ・アイテムがターゲットContent Serverにすでに存在する場合、インポートは失敗します。プロパティCheckExistingContents=falseを設定して、インポートを再実行する場合、コンテンツIDエラーを回避するために、ターゲット・フォルダに、インポートされるアーカイブから取得されたコンテンツが含まれていないことを確認します。

- カスタム・メタデータ(たとえば、myCustomInteger)。

39.3.3.2.2 ドキュメント移行アーカイブ

ドキュメント移行ユーティリティは、ソースContent Serverからコンテンツをエクスポートするときに、単一のアーカイブを作成します。このアーカイブは、ドキュメント移行ユーティリティを実行して、ターゲット環境にデータをインポートする際に使用されます。ドキュメント移行アーカイブには、特定のレイアウトがあり、アーカイブがこのレイアウトに一致しない場合、ドキュメント移行ユーティリティのインポートは失敗します。

アーカイブ形式

次にドキュメント移行アーカイブのレイアウトについて説明します。

アーカイブのトップ・レベルには、データがエクスポートされた、各スペース/スペース・テンプレートのフォルダがあります。

- 単一のスペース/スペース・テンプレートがエクスポートされている場合、ルート・フォルダは1つしかありません。複数のスペース/スペース・テンプレートがエクスポートされている場合は、複数のルート・フォルダがあります。

- ルート・フォルダ名は、Content Serverの対応するフォルダの内部GUIDと同じです(たとえば、13828FE1-75D8-4A0B-A53B-A76AE78C1AE6)

各トップ・レベル・フォルダには、そのスペースまたはスペース・テンプレートに対してターゲットContent Serverで再作成するためにファイルおよびフォルダの階層を記述するExportImportData.xmlドキュメントがあります。このドキュメントには、アーティファクトの作成時に使用されるメタデータが含まれています(xCollectionID、isreadonly、xStorageRuleなどの内部メタデータは含まれません)。ドキュメントに対して、アップロードで使用するためのアーカイブのネイティブ・ファイルへのパスが含まれています。

各トップレベル・スペースおよびスペース・テンプレート・フォルダにはエクスポート済ドキュメントがあります。トップレベル・フォルダ内のドキュメントのレイアウトは、ソースContent Serverのソース・スペースおよびスペース・テンプレートのレイアウトに似ています。たとえば、ドキュメントdoc1.docがfolder1にある場合、アーカイブのトップレベル・フォルダには、doc1.docが存在するフォルダfolder1が含まれています。トップレベル・フォルダのドキュメント・ファイル/フォルダ構造は、ExportImportData.xmlに記載されている階層に一致する必要があります。これは、インポート・コードがターゲットにドキュメントをアップロードしながら、そのドキュメントに記載されているドキュメントのネイティブ・ファイルを検出できるからです。ソースのスペースまたはスペース・テンプレート・フォルダの空のフォルダは、アーカイブにはありません。ただし、これらのフォルダは、ターゲットで再作成されるように、ExportImportData.xmlドキュメントで依然として記載されています。

簡略化された概要では、これは次のように表示されます。

- Space1トップ・レベル・フォルダ:

- ExportImportData.xml

- <ソースと同じフォルダ階層に配列されるSpace1のドキュメント>

- Space2トップ・レベル・フォルダ:

- ExportImportData.xml

- <ソースと同じフォルダ階層に配列されるSpace2のドキュメント>

ExportImportData.xmlドキュメントの理解

ExportImportData.xmlドキュメントのXSDを次に示します。

ExportImportData.xmlのXSD:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="groupspace-folder" type="FolderType" />

<!-- 'folders' must contain 1 or more 'folder' child elements -->
<xs:complexType name="FoldersType">
<xs:sequence>
<xs:element name="folder" type="FolderType"
minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>

<!-- 'documents' must contain 1 or more 'document' elements -->
<xs:complexType name="DocumentsType">
<xs:sequence>
<xs:element name="document" type="DocumentType"
minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>

<!-- 'attributes' must have 1 or more 'attribute' child elements -->
<xs:complexType name="AttributesType">
<xs:sequence>
<xs:element name="attribute" type="AttributeType"
minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<!-- 'folder' has to have 1 and only 1 'attributes' child element
0 or 1 'folders' child element, 0 or 1 'documents' child element -->
<xs:complexType name="FolderType">
<xs:sequence>
<xs:element name="attributes" type="AttributesType"
minOccurs="1" maxOccurs="1" />
<xs:element name="folders"    type="FoldersType"
minOccurs="0" maxOccurs="1" />
<xs:element name="documents"  type="DocumentsType"
minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>

<!-- 'document' has to have : 1 and only 1 'attributes' child element
and nothing else -->
<xs:complexType name="DocumentType">
<xs:sequence>
<xs:element name="attributes" type="AttributesType"
minOccurs="1" maxOccurs="1" />
</xs:sequence>
</xs:complexType>

<!-- 'attribute' element has to have a 'name' and 'value' attributes -->
<xs:complexType name="AttributeType">
<xs:attribute name="name"  type="xs:string" use="required" />
<xs:attribute name="value" type="xs:string" use="required" />
</xs:complexType>

</xs:schema>

各要素の意味は次のとおりです。

- <groupspace-folder>は、スペースまたはスペース・テンプレート・フォルダを表すルート・タグです。
このタグには<attributes>タグが含まれ、ルート・フォルダおよびエクスポート・データに関する属性数が含まれます。これらの属性は情報のみを目的としているため、インポートでは使用されません。

- <attributes>は、ドキュメントまたはフォルダのすべての属性をグループ化するために使用されます。
このタグには、1つ以上の<attribute>タグが含まれる必要があります。他の子タグは許可されません。

- <attribute>には、フォルダまたはドキュメントのメタデータが含まれます。
このタグには次の2つの属性があります。

- name: Content Serverメタデータ名

- value: メタデータの値

子タグは許可されません。

- <folders>は、現在のフォルダのすべてのフォルダをグループ化するために使用されます。
このタグには、1つ以上の<folder>タグが含まれる必要があります。他の子タグは許可されません。

- <folder>は、子フォルダを示すために使用されます。
このタグには、<attributes>タグが必要です。フォルダに子フォルダがある場合は、<folders>タグがあります。フォルダに子ドキュメントがある場合は、<documents>タグがあります。

- <documents>は、現在のフォルダのすべてのドキュメントをグループ化するために使用されます。
このタグには、1つ以上の<document>タグが含まれる必要があります。他の子タグは許可されません。

- <document>は、現在のフォルダのすべてのドキュメントを示すために使用されます。
このタグには、<attributes>タグが必要です。他の子タグは許可されません。

注釈付きの例:

次の注釈付きの例は、部分的に完了したExportImportData.xmlドキュメントを示します。例には、実際のExportImportData.xmlドキュメントでは存在しない空行とXMLコメントが含まれていることに注意してください。

<?xml version="1.0"encoding="UTF-8"standalone="yes"?>
<groupspace-folder>

<attributes>
<!-- Contains a set of attributes of the main space folder -->
<attribute name="export-date" value="2011-07-22 13:02:29"/>
</attributes>

<folders> <!-- only present if the space contains any child folders -->
<folder> <!-- a 'folder' tag exists for each child folder -->
<attributes>
<!-- contains the set of folder attributes, examples below -->
<attribute value="F1" name="dCollectionName"/>
</attributes>
<!-- a 'folder' tag will contain the 'folders' tag if this folder
contains child folders, i.e. if 'F1' has child folders -->
<folders>
<folder>
<!-- attribute tags, child folders, child documents etc -->
</folder>
</folders> <!-- closing tag for all the folders in the
current folder à
<!-- a 'folder' tag will contain the 'documents' tag if this folder
contains documents, i.e. if 'F1' has documents at its root -->
<documents>
<document>
<!-- attributes tags, see below -->
</document>
</documents> <!-- closing tag for all the documents in the
current folder -->
</folder> <!-- closing tag for folder 'F1' -->
</folders> <!-- closing tag for all the folders in the space root -->

<documents> <!- only present if the folder contains any documents
in the root folder -->
<document> <!-- a 'document' tag exists for each document in the
folder -->
<attributes>
<!- contains the set of document attributes, examples below -->
<attribute name="dDocTitle" value="Doc1"/>
<attribute name="xForceFolderSecurity" value="TRUE"/>
<attribute name="xSecurityClearanceLevel" value="public"/>
</attributes>
<document> <!-- closing tag for document 'Doc1' -->
</documents><!-- closing tag for all the documents in the space root -->

</groupspace-folder>

ExportImportData.xmlドキュメントの構築

次にXMLドキュメントの構築方法に関する疑似コードを示します。

- query Content Server for the space's folder information
- create a 'group-space-folder' node
- create an 'attributes' node
- for each of the three attributes we want to maintain (folder name, path
and GUID)
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add that 'attributes' node to the 'group-space-folder' node

- query Content Server for the contents of the space root folder
- * If there are child folders
- Create a 'folders' node
- For each child folder
- create a 'folder' node
- create an 'attributes' node
- for each folder metadata we want to maintain
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add the 'attributes' node to the 'folder' node
- query Content Server for the contents of this current folder
- go to * and repeat traversing folders which reside in this
current folder
- go to # and repeat for documents which reside in this current
folder
- add the 'folder' node to the 'folders' node
- add the 'folders' node to the parent node (which will either be a
'folder' node or the 'group-space-folder' node)

- # If there are documents in this current folder
- create a 'documents' node
- for each document
- create a 'document' node
- create an 'attributes' node
- for each metadata we want to maintain
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add the 'attributes' node to the 'document' node
- add that 'document' node to the 'documents' node
- add the 'documents' node to the 'folder' node

- use jaxb to write the whole data to an xml file

ドキュメント移行アーカイブの例

1セットのサンプル・データおよび例のスペースの1つに対するサンプルExportImportData.xmlドキュメントのアーカイブ形式の例を次に示します。

WebCenterデータ

次の例では、2つのスペース(MarketingおよびSales)がSpacesで作成されています。Marketingスペースでは、2つのwikiページが作成されています: MarketingWikiおよびTradeshows。Marketingスペースには、2つのフォルダ(「ブランド」および「プレゼンテーション」)が作成されていて、後者にはPowerPointドキュメントおよびwikiドキュメントを持つサブフォルダが含まれています。Salesスペースにはwikiページがありませんが、いくつかのコンテンツを持つ3つのフォルダが含まれています。

- Marketing
Marketingスペースには、Content ServerフォルダGUID= 29A4E019-7AE7-46A1-823B-AF16A313BBEFが含まれています。

- MarketingWiki

- 次のメタデータを持つMarketingWiki.htm:
dOriginalName="MarketingWiki.htm"
dDocTitle="MarketingWiki.htm"
dDocFunction="wiki"
dDocType="Application"
xWCPageID="Page2.jspx"

- プレゼンテーション

- ブランド
ProductBranding.pptx

- 次のメタデータを持つPresentation Dates.htm:
(ここでwikiページが上記のMarketingWiki.htmに関して作成されるときに作成されるのではなく、wikiドキュメントがスペースのフォルダ内で作成されることに注意してください)
dOriginalName=" Presentation Dates.htm"
dDocTitle="Presentation Dates"
dDocFunction="wiki"
dDocType="Application"
xWCPageID = not set (as the wiki was not created when creating a wiki page)

- ProjectedDesigns.pptx

- 製品

- TradeShows

- 次のメタデータを持つTradeShows.htm:
dOriginalName="TradeShows.htm"
dDocTitle="TradeShows.htm"
dDocFunction="wiki"
dDocType="Application"
xWCPageID="Page2.jspx"

- Sales
「WebCenter Content」フォルダ GUID = 629BFEBD-4E83-4DCA-895A-C72E5192FBFD

- DecConference

- GuestSpeakers.doc

- SalesConference

- Attendees.doc

- TalkSchedules.doc

- BudgetForcasts.doc

アーカイブ・コンテンツ

- 29A4E019-7AE7-46A1-823B-AF16A313BBEF (Marketingスペース・コンテンツを含む)

- MarketingWiki

- MarketingWiki.htm

- プレゼンテーション

- ブランド(ProductBranding.pptx)

- ProjectedDesigns.pptx

- Presentation Dates.htm

- Tradeshows

- TradeShows.htm

- ExportImportData.xml

- 2001Plans.doc

- 629BFEBD-4E83-4DCA-895A-C72E5192FBFD (Salesスペース・コンテンツを含む)

- DecConference

- GuestSpeakers.doc

- SalesConference

- Attendees.doc

- TalkSchedules.doc

- ExportImportData.xml

- BudgetForcasts.doc

注意:

このフォルダにはドキュメントが含まれないため、Marketingスペースのルート・フォルダの下にProductsフォルダはありません。

MarketingスペースのExportImportData.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<groupspace-folder>
<attributes>
<attribute value="2011-10-27 15:50:18" name="export-date" />
<attribute value="/WebCenter0711/Marketing/" name="group-space-path" />
<attribute value="Marketing" name="group-space-name" />
<attribute value="29A4E019-7AE7-46A1-823B-AF16A313BBEF"
name="group-space-guid" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="weblogic" name="dCollectionCreator" />
<attribute value="MarketingWiki" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="weblogic" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="weblogic" name="dDocOwner" />
<attribute value="MarketingWiki.htm" name="dOriginalName" />
<attribute value="MarketingWiki.htm" name="dDocTitle" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="weblogic" name="dDocCreator" />
<attribute value="weblogic" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012754" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="weblogic" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="weblogic" name="dCollectionCreator" />
<attribute value="Presentations" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="weblogic" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="weblogic" name="dCollectionCreator" />
<attribute value="Branding" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="weblogic" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="weblogic" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="ProductBranding.pptx" name="dDocTitle" />
<attribute value="ProductBranding.pptx"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="weblogic" name="dDocCreator" />
<attribute value="weblogic" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012748" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="weblogic" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="weblogic" name="dDocOwner" />
<attribute value="Presentation Dates" name="dDocTitle" />
<attribute value="Presentation Dates.htm"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="weblogic" name="dDocCreator" />
<attribute value="weblogic" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012758" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="weblogic" name="dDocLastModifier" />
</attributes>
</document>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="weblogic" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="ProjectedDesigns.pptx" name="dDocTitle" />
<attribute value="ProjectedDesigns.pptx"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="weblogic" name="dDocCreator" />
<attribute value="weblogic" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012747" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="weblogic" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="weblogic" name="dCollectionCreator" />
<attribute value="Products" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="weblogic" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="weblogic" name="dCollectionCreator" />
<attribute value="TradeShows" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="weblogic" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="weblogic" name="dDocOwner" />
<attribute value="TradeShows.htm" name="dOriginalName" />
<attribute value="TradeShows.htm" name="dDocTitle" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="weblogic" name="dDocCreator" />
<attribute value="weblogic" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012756" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="weblogic" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="weblogic" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="2011Plans.doc" name="dDocTitle" />
<attribute value="2011Plans.doc" name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="weblogic" name="dDocCreator" />
<attribute value="weblogic" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012746" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="weblogic" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</groupspace-folder>

39.3.4 ソースWikiアプリケーションからSpacesへのデータの移行

既存のwikiアプリケーションからWebCenter Portal: Spacesにコンテンツを移行するには、次の手順を実行します。

1. wikiコンテンツのインポート用にSpacesを準備します。

2. カスタムwiki抽出ツールを記述して実行し、Wikiアプリケーションからドキュメント移行ユーティリティを使用するための正確な形式に一致するアーカイブにコンテンツを抽出します。

3. ドキュメント移行ユーティリティを使用して、Content Serverにアーカイブをインポートします。

4. Spacesでwikiページを作成し、Content Serverのコンテンツを関連付けます。

これら手順は、以下の項で詳細に説明します。

- 第39.3.4.1項「WikiコンテンツのインポートのためのWebCenter Portal: Spacesの準備」

- 第39.3.4.2項「Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行」

- 第39.3.4.3項「ドキュメント移行ユーティリティを使用したターゲット・スペースへのアーカイブのインポート」

- 第39.3.4.4項「Content Serverのコンテンツに対するSpacesのWikiページの作成」

39.3.4.1 WikiコンテンツのインポートのためのWebCenter Portal: Spacesの準備

スペースまたはスペース・テンプレートでドキュメント・サービスをプロビジョニングする際に、フォルダがそのスペースまたはスペース・テンプレートに対してContent Serverで作成されます。これらのフォルダのGUIDは、ドキュメント移行ユーティリティとともに使用するアーカイブを構築するために決定される必要があります。フォルダGUIDは次の手順で決定されます。

1. すべてのwikiコンテンツを単一スペースまたは複数のスペースにインポートするかどうかを決定します。

2. Spacesアプリケーションにログインし、スペースを作成して、グループ・スペースの内部名をメモします。
ドキュメント・サービスのあるテンプレートを使用していることを確認します。そうでない場合、ドキュメント・サービスをプロビジョニングして、スペース作成後にロール権限を設定する必要があります。

3. Content Serverにログインします。

4. ユーザーのレイアウトが「トップ・メニュー」であることを確認します。

1. ユーザー名をクリックして、ユーザーのプロファイル・ページを表示します。

2. 「ユーザーのパーソナライズの設定」の下で、「レイアウト」をTop Menuに設定していることを確認します。

5. wikiコンテンツがインポートされる各スペースに対して、フォルダGUIDを決定します。

1. 「コンテンツの参照」をクリックします。

2. Spacesインスタンスのルート・フォルダをクリックします。
これは、Content Server接続のRoot Folder設定と同じです。

3. スペースのフォルダをクリックします。
フォルダ名は、スペースの内部名と同じです。

4. フォルダ情報を表示するには、ツールバーの「情報」をクリックします。

5. URLにIsSoap=1を追加します。

6. 文字列dCollectionGUIDを検索します。次に例を示します。
<idc:field name="dCollectionGUID">05573322-E895-EDA3-8A83-07CF39CBDE05</idc:field>

6. 次の手順でアーカイブを構築する際にGUIDが必要となるため、スペース・フォルダ名とそのGUIDをメモします。

39.3.4.2 Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

ソースwikiアプリケーションから、ドキュメント移行ユーティリティとともに使用するのに適したアーカイブにコンテンツを抽出するには、カスタム・アプリケーションを記述する必要があります。アーカイブの形式の詳細は、第39.3.3項「ドキュメント移行ユーティリティの理解」を参照してください。

カスタムwiki抽出ツールは、次の手順を実行する必要があります。

1. wikiコンテンツを抽出して配置します。
一時ディレクトリを作成し、ソースwikiアプリケーションからその一時ディレクトリにwikiコンテンツを抽出して、Spacesに表示されるとおりにファイル・システムに配置します。

2. wikiドキュメントのソースHTMLをクリーンアップします。
各wikiドキュメントに対して、HTMLを編集して、アプリケーション固有のHTMLタグを削除します。

3. URLをリライトします。
各wikiドキュメントに対して、ソースwikiアプリケーションのコンテンツへの既存のURLを、Spacesにインポートされる同じアーティファクトのURLに置き換えます。

4. ExportImportData.xmlドキュメントを構築します。
各ルート・フォルダに対して、エクスポート・セットのデータを記述し、インポートの実行に使用されるExportImportData.xmlドキュメントを構築します。

5. アーカイブ・ファイルを構築します。
wikiコンテンツをSpacesにインポートするために使用可能な操作済wikiコンテンツのアーカイブを作成します。

これらの各手順については、次の項で詳細に説明します。

- 第39.3.4.2.1項「Wikiコンテンツの抽出と配置」

- 第39.3.4.2.2項「WikiドキュメントのソースHTMLのクリーンアップ」

- 第39.3.4.2.3項「URLのリライト」

- 第39.3.4.2.4項「ExportImportData.xmlドキュメントの構築」

- 第39.3.4.2.5項「アーカイブ・ファイルの構築」

39.3.4.2.1 Wikiコンテンツの抽出と配置

ソース・アプリケーションのwikiドキュメントはファイル・システムの一時ディレクトリに抽出され、コンテンツがターゲットSpacesインスタンスにレイアウトされる方法をファイル・システムが模倣するように配置される必要があります。すべてのwikiドキュメントが単一スペースにインポートされる場合、Content Serverの対応するスペース・フォルダのGUIDを使用して名付けられている単一のルート・フォルダの下にコンテンツのすべてが配置される必要があります。wikiドキュメントが複数のスペースにインポートされる場合、コンテンツが複数のルート・フォルダの下に配置される必要があります。Content Serverにおけるスペース・フォルダのGUIDの決定の詳細は、第39.3.4.1項「WikiコンテンツのインポートのためのWebCenter Portal: Spacesの準備」を参照してください。

ファイル・システムにwikiコンテンツを配置する場合は、コンテンツがSpacesで使用される方法を考慮する必要があることに注意してください。次に例を示します。

- wikiページが作成される場合は、wikiページのwikiドキュメントが同じ名前のフォルダの下にある必要があります。wikiページの詳細は、第39.3.2項「WikiドキュメントおよびWikiページの理解」を参照してください。

- フォルダに多数のコンテンツが含まれている場合は、そのフォルダのコンテンツのレンダリングに障害が発生する可能性があります。

- Content Serverには、フォルダ数とフォルダ内に格納可能なファイル数を制限する2つの設定があります。wikiコンテンツを配置する場合は、フォルダ制限設定より多くのフォルダおよびドキュメント制限設定より多くのドキュメントがフォルダにないことを確認してください。スペース内のフォルダおよびファイル制限の詳細は、第39.3.1.3項「フォルダおよびフォルダのファイル制限の理解」を参照してください。

抽出したwikiコンテンツを作成するには、次のタスクを実行します。

1. wikiドキュメントをインポートする先の各スペースのルート・フォルダを作成し、Content Serverの対応するスペース・フォルダのGUIDに基づいてフォルダに名前を付けます。

2. インポート後に、wikiページがWebCenter Portal: Spacesで作成されるwikiドキュメントに対して行う操作は次のとおりです。

1. wikiドキュメントと同じ名前を持つwikiフォルダを作成します。

2. このフォルダにwikiドキュメントを配置します。

3. 必要に応じて、このフォルダに他のドキュメントを配置します。

4. 関連するイメージおよび/またはドキュメントがある場合は、同様にそれらのドキュメントをこのwikiフォルダに追加します。

3. 他のwikiドキュメントについて、ドキュメントを含めるフォルダ階層を作成します。

例:

Content ServerのSpace S1のフォルダには、21SD15F13B8_141D_421B_AD0e_BC54B6F16893のGUIDがあります。インポート後に、MarketingWikiおよびTradeshows wikiページが作成され、これらのwikiページにMarketingWiki.htmおよびTradeshows.htm wikiドキュメントが表示される必要があります。

抽出されたwikiドキュメントおよびアーティファクトの整理された構造を次に示します。

21SD15F13B8_141D_421B_AD0e_BC54B6F16893 (Root space folder)
Home.htm (Wiki document)
MarketingWiki (Folder)
MarketingWiki.htm (Wiki document)
Branding (Folder)
Presentation Dates.htm (Wiki document)
Presentations (Folder)
ProductBranding.pptx (File)
ProjectedDesigns.pptx (File)
Tradeshows (Folder)
TradeShows.htm (Wiki document)
Images (Folder)
Image.jpg (Image)

39.3.4.2.2 WikiドキュメントのソースHTMLのクリーンアップ

WebCenter Portal: Spacesで、wikiページが編集されるときにwikiエディタでHTMLタグが削除されます。したがって、インポート後にwikiドキュメントを編集する場合に削除されるタグの混乱を回避するために、WebCenter Portal: Spacesにインポートする前に、wikiドキュメントでHTMLタグを削除することをお薦めします。次のタグは安全に削除することができます。

<html>, </html>
<head>, </head>
<meta>, </meta>
<title>, </title>
<body>, </body>
<tbody>, </tbody>
<thead>, </thead>
<tfoot>, </tfoot>
<script>, </script>
<link>, </link>

39.3.4.2.3 URLのリライト

ソースwikiアプリケーションのWikiページには、組込みイメージまたは他のwikiページやドキュメントへのリンクなど、ソースwikiアプリケーション内のアーティファクトを参照するURLが含まれる場合があります。これらのアーティファクトは、ターゲットSpacesインスタンスに移行され、これらのリンクは、ターゲットSpacesインスタンスの新しいアーティファクトの場所を参照するために更新される必要があります。

抽出されたwikiページの次のタイプのURLは、Spacesの同じアーティファクトのURLを参照するために変更される必要があります。

- 他のWikiページへのリンク

- 組込みイメージへのリンク

- ドキュメントへのリンク

次の手順に従って、wikiドキュメントのURLをリライトします。

1. 手順3のURLの置換で使用されるターゲットSpacesインスタンスの属性を定義します。

- WC_BASE_URL: WebCenterインスタンス・ベースURL
例: WC_BASE_URL=https://webcenter.example.com

- UCM_ID: Content ServerへのSpacesの接続の名前
例: UCM_ID=dev_ucm

- SPACE_GUID: コンテンツが存在するSpacesのスペースのGUID
例: SPACE_GUID=s21sd15f13b8_141d_421b_ad0e_bc54b6f16893

GUIDの決定の詳細は、第39.3.4.1項「WikiコンテンツのインポートのためのWebCenter Portal: Spacesの準備」を参照してください。

2. 各コンテンツ・アイテムについて、手順3のURLの置換で使用されるアイテムの属性を定義します。

- FILE_NAME: コンテンツ・アイテムのファイル名
例: FILE_NAME=Home.htm

- FILE_ID: 一意のContent ServerのコンテンツID
例: MARKETINGSPACE1001

FILE_IDは、Content Serverインスタンス全体にわたって、一意である必要があることに注意してください。推奨値は、一意の番号が後に付加された(名前にスペースのない)wikiドキュメントがインポートされるスペースの名前です(上記の例では、スペース名はMarketing Space)。

3. 次のように、定義された属性を使用してURLをリライトします。
組込みイメージ

- 新しいURLの形式:
IMG_REPLACE=img alt="FILE_NAME" resourceid="UCM_ID#dDocName:FILE_ID" src="WC_BASE_URL/webcenter/content/conn/UCM_ID/uuid/dDocName%3aFILE_ID"

- 例:

- ソースURL:
<img alt="image.jpg" src="images/image.jpg">

- WebCenterのURL:
<img alt="image.jpg" resourceid="dev-ucm#dDocName:WSIMPORT4" src="http://webcenter.example.com/webcenter/content/conn/dev-ucm/uuid/dDocName%3aWSIMPORT4">

Wikiページ

- 新しいURLの形式:
URL_REPLACE=WC_BASE_URL/webcenter/faces/owResource.jspx?z=oracle.webcenter.doclib%21SPACE_GUID%21UCM_ID%2523dDocName%253AFILE_ID%21%21FILE_NAME

- 例:

- ソースURL:
<a href="Home.htm">Home</a>

- WebCenterのURL:
<a href="http://webcenter.example.com/webcenter/faces/owResource.jspx?z=oracle.webcenter.doclib%21sd15f13b8_141d_421b_ad0e_bc54b6f16893%21dev-ucm%2523dDocName%253AWSIMPORT25%21%21Home.htm>Home</a>

ドキュメントへのリンク

- 新しいURLの形式:
DOCUMENT_REPLACE=WC_BASE_URL/webcenter/content/conn/UCM_ID/uuid/dDocName%3aFILE_ID

- 例:

- ソースURL:
<a href="MarketingWiki/Presentations/ProductBranding.pptx"> Download Product Branding Presentation</a>

- WebCenterのURL:
<a href="http://webcenter.example.com/webcenter/content/dev-ucm/uuid/dDocName%3aWSIMPORT7"> Download Product Branding Presentation</a>

39.3.4.2.4 ExportImportData.xmlドキュメントの構築

インポートされるコンテンツを含む各ルート・フォルダで、ExportImportData.xmlドキュメントを作成する必要があります。ExportImportData.xmlドキュメントは、ルート・フォルダのコンテンツを記述し、ドキュメント移行ユーティリティを使用してSpacesにコンテンツをインポートする際にインポートを実行するために使用されます。ドキュメント移行ユーティリティおよびExportImportData.xmlドキュメントの詳細は、第39.3.3項「ドキュメント移行ユーティリティの理解」を参照してください。

インポート時にドキュメントとともに作成されるメタデータは、ExportImportData.xmlドキュメントで指定する必要があります。Spacesでは、wikiドキュメントはHTMLドキュメントとして格納されますが、通常のHTMLドキュメントではなくwikiドキュメントとして識別するための追加のメタデータを持ちます。ExportImportData.xmlドキュメントが、抽出されたコンテンツのすべてのwikiドキュメントに対してこのメタデータを指定していることを確認してください。wikiドキュメントに必要なメタデータの詳細は、第39.3.2項「WikiドキュメントおよびWikiページの理解」を参照してください。

注意:

コンテンツID (dDocName)は、ドキュメントが指定されずにチェックインされるときに、Content Serverによって自動的に生成されます。ドキュメントのコンテンツIDを固定する場合は、ExportImportData.xmlドキュメントにドキュメント・メタデータとともにdDocNameメタデータを含めてください。dDocNameは、Content Server全体で一意である必要があります。そうでない場合、ドキュメントのチェックインは失敗します。コンテンツIDに独自の接頭辞を選択し、末尾に番号を順次追加することをお薦めします。

ExportImportData.xmlドキュメントは、ルート・フォルダごとに手動で生成できます。または、カスタム・スクリプトを記述して、ルート・フォルダのコンテンツを通過し、ドキュメントを生成することができます。

ファイル・システムのコンテンツの構造が、ExportImportData.xmlドキュメントで正しく詳述されている必要があります。ExportImportData.xmlドキュメントとファイル・システムで記述されるコンテンツの階層間で不一致がある場合、ターゲットContent Serverのスペース・フォルダへのインポートは失敗します。

例:

この例では、convert_programという名前のカスタム・スクリプトが、21SD15F13B8_141D_421B_AD0e_BC54B6F16893というルート・フォルダを通過して、フォルダのコンテンツを詳述している現在作業中のディレクトリにExportImportData.xmlドキュメントを作成します。

cd 21SD15F13B8_141D_421B_AD0e_BC54B6F16893
run convert_program

39.3.4.2.5 アーカイブ・ファイルの構築

ルート・スペース・フォルダを圧縮することにより、抽出され、操作されたwikiドキュメントのアーカイブを作成します。圧縮されたアーカイブは、ルート・フォルダのコンテンツだけではなく、アーカイブ内にルート・フォルダを持っている必要があります。1つの圧縮ファイルには、様々なスペース用に複数のルート・フォルダを含むことができます。またはルート・フォルダごとに1つの圧縮ファイルを作成できます。

例:

次の例で、wikiドキュメントは、フォルダ/scratch/wikiexportsの21SD15F13B8_141D_421B_AD0e_BC54B6F16893というフォルダで抽出および操作されており、作成するアーカイブは、wsimport.zipです。

cd /scratch/wikiexports
zip –r wcimport.zip 21SD15F13B8_141D_421B_AD0e_BC54B6F16893/

注意:

一部の圧縮ツールがアーカイブを上書きするのではなく、すでに存在している場合、指定されたアーカイブにコンテンツを追加するため、フォルダ・コンテンツを圧縮する前に、アーカイブが存在していないことを確認してください。

39.3.4.3 ドキュメント移行ユーティリティを使用したターゲット・スペースへのアーカイブのインポート

ターゲットContent Serverにコンテンツをインポートするには、前の手順で生成されたアーカイブを指定して、ドキュメント移行ユーティリティを実行します。ドキュメント移行ユーティリティの使用方法の詳細は、第39.1.7.5.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。

Spacesアプリケーションにログインして、コンテンツがインポートされたスペースに移動して、コンテンツが存在することを確認します。

39.3.4.4 Content Serverのコンテンツに対するSpacesのWikiページの作成

WebCenter wikiページを使用して、インポートされたwikiを表示するには、次の手順を実行します。wikiページの詳細は、第39.3.2項「WikiドキュメントおよびWikiページの理解」を参照してください。

1. Spacesにログインします。

2. コンテンツがアップロードされているスペースを検索します。

3. 「アクション」をクリックし、「作成」→「ページ」の順に選択します。

4. wikiページに「名前」を指定し、Wikiページ・レイアウトを選択します。
wikiページの名前がSpacesのスペース・フォルダのフォルダ名と一致している必要があることに注意してください。このフォルダには同じ名前のwikiページが含まれています。

たとえば、スペース・フォルダで、MarketingWikiフォルダとMarketingWiki.htmドキュメントを持つ場合、wikiページの名前は、MarketingWikiである必要があります。

39.4 WebCenter Portalアプリケーションのバックアップおよびリカバリ

データベース・ハードウェアを消失した場合や、ファイルやデータベースから誤ってデータを削除した場合などの障害からデータをリカバリするには、WebCenter Portalアプリケーションを頻繁にバックアップすることが重要です。バックアップの頻度は、WebCenter Portalにより格納されている基礎となる情報が特定の顧客アプリケーションでどのくらいの頻度で変更されるか、およびどのくらいの時間と情報量を消失しても許容されるかによって決まります。データが業務にとって非常に重要であり、障害発生時にはデータのリストアが必須である場合は、増分バックアップまたは部分バックアップを適用できます。

WebCenter Portalコンポーネントのバックアップとリカバリは、データベースのエクスポートおよびインポート・ユーティリティ、および様々な他のツールから管理できます。詳細は、『Oracle Fusion Middleware管理者ガイド』の第IV部「詳細管理: バックアップおよびリカバリ」を参照してください。

39.5 Spacesのインポートおよびエクスポート問題のトラブルシューティング

この項の内容は次のとおりです。

- 第39.5.1項「ResourceLimitExceptionの問題」

- 第39.5.2項「スペースおよびスペース・テンプレートがインポート後に使用できない」

- 第39.5.3項「マルチバイト言語でのスペースのエクスポートおよびインポート」

- 第39.5.4項「インポート後にページまたはスペースでメッセージが見つからない」

- 第39.5.5項「スペース・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている」

- 第39.5.6項「リストが適切にインポートされない」

- 第39.5.7項「Spacesカスタマイズのインポート」

- 第39.5.8項「サービスが構成されているスペースのエクスポートおよびインポート」

39.5.1 ResourceLimitExceptionの問題

問題

すべてのスペースまたはSpacesアプリケーション全体をエクスポートしようとすると、ResourceLimitExceptionエラーが表示されます。

Weblogic.common.resourcepool.ResourceLimitException

解決策

JDBC接続プールで最大容量を増加します。接続プールを再構成するには、WLS管理コンソールにログインします。「サービス」から、「データ・ソース」、「JDBC」、「接続プール」タブを選択します。

39.5.2 スペースおよびスペース・テンプレートがインポート後に使用できない

問題

インポート操作後にSpacesアプリケーションに最初にログインすると、移行したスペースおよびスペース・テンプレートが予期したとおりに使用できません。これは、スペース/スペース・テンプレート・キャッシュが適切にリフレッシュできない場合に発生することがあります。

解決策

refreshGroupSpaceCacheおよびrefreshSpaceTemplateCache WLSTコマンドを使用して、スペース/スペース・テンプレート・キャッシュを手動でリフレッシュします。

キャッシュ(すべてのスペース)を完全にクリアするには:

refreshGroupSpaceCache(appName='webcenter', spaceNames='', syncMode=1,updateType='all', cleanCache=1)

キャッシュ(すべてのスペース・テンプレート)を完全にクリアするには:

refreshSpaceTemplateCache(appName='webcenter', spaceTemplateNames='',syncMode=1, updateType='all', cleanCache=1)

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のrefreshGroupSpaceCacheおよびrefreshSpaceTemplateCacheに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

39.5.3 マルチバイト言語でのスペースのエクスポートおよびインポート

問題

Linuxでは、名前付け制限により、マルチバイト言語で作成された1つ以上のスペースに対して、個々のスペースのエクスポートまたはインポートが失敗します。スペース名は、英数字および空白文字("a" - "z"、"A" - "Z"、"0" - "9"、およびSpacesが"_"(アンダースコア)で置き換えるシングルバイト・スペース文字)に制限されます。他の文字がスペース名で使用される場合、エクスポートまたはインポートは失敗します。

解決策

Oracle WebCenter Portalがデプロイされるサーバー上で名前付け制限を強制します。これを行うには、環境変数LC_ALLをutf-8に設定します。

39.5.4 インポート後にページまたはスペースでメッセージが見つからない

問題

インポート操作後に初めてSpacesにログインするときに、最後にアクセスしたページまたはスペースが存在しない場合、「ページが見つかりません」または「スペースが見つかりません」というメッセージが表示される場合があります。このようなメッセージは、最終アクセスページ情報がインポート操作中に制限されるために表示されます。

解決策

処置は必要ありません。次回ログイン時にはメッセージは表示されません。

39.5.5 スペース・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

問題

Spacesにコンテンツをアップロードするには、ファイル・サイズ制限があります。エクスポートのアーカイブが最大アップロード・サイズを超える場合、Spaces管理からのインポート操作が失敗します。

解決策

WLSTを使用してスペース・アーカイブをインポートします。詳細は、第39.1.9.2項「WLSTを使用した個々のスペースのインポート」を参照してください。

または、web.xmlでコンテンツ・リポジトリ・アップロード・パラメータを変更します。デフォルトの最大アップロード・サイズは2GBです。付録A「WebCenterポータルの構成」の第A.1.2項「web.xml」も参照してください。

39.5.6 リストが適切にインポートされない

問題

リストが、ソースおよびターゲット・システムのリスト定義の相違により、適切にインポートされていません。

解決策

リスト・データをエクスポートおよびインポートすることを検討してください。これにより、リスト・データがインポートされるリスト定義と一貫性を持つようになります。

データなしにインポートする場合は、ターゲット・システムのリスト・データはインポートされたリスト定義と一貫性を持つように変更されます。リスト列データ・タイプが変更される場合、可能な場合は、列の値はターゲット・データ・タイプからインポートされたデータ・タイプに変換されます。リスト列がインポート時に削除される場合、列の値は削除されます。

39.5.7 Spacesカスタマイズのインポート

Spacesアプリケーションを移行する場合は、特定のアプリケーションのカスタマイズを「カスタマイズを含む」オプションを使用してインポートするかどうかを選択できます。表39-4は、アプリケーションのカスタマイズを格納し、移行時にオプションであるこれらのサービスとタスク・フローについて説明します。表39-5は、オプションであるアプリケーションレベルおよびスペースレベルの設定をリスト表示します。

注意:

ユーザーのカスタマイズはエクスポートおよびインポート中に移行されません。アプリケーション・カスタマイズとユーザー・カスタマイズおよびそれらの相違の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのページ・コンポーネントのカスタマイズに関する必要な知識に関する項を参照してください。

表39-4 Spacesサービス: アプリケーションのカスタマイズ

Spacesのサービス

アプリケーションのカスタマイズ

オプション/常時

分析サービス

なし

分析ページおよびタスク・フロー

ページ編集モードのレポート・プリファレンス(チャート、データ選択、フィルタリング、グループ化)

オプション

お知らせサービス

なし

「お知らせ」タブ

なし

お知らせタスク・フロー

なし

ディスカッション・サービス

サイドバー

なし

「ディスカッション」タブ

なし

ディスカッション・フォーラム・マネージャ・タスク・フロー

なし

フォーラム・タスク・フロー

なし

ディスカッション・タスク・フロー

なし

ドキュメント・サービス

「ドキュメント」タブ

なし

ドキュメント・マネージャ・タスク・フロー

- 「ドキュメント・マネージャ」には、説明、サイズ、ステータス、変更者、最終更新日、リンクなどのプリファレンスが表示されます。

- 表示列、列のサイズ、および順番などの表の列設定

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのドキュメント・マネージャ・タスク・フローの理解に関する項も参照してください。

オプション

ドキュメント・リスト・ビューア・タスク・フロー

表示列、列のサイズ、および順番などの表の列設定

ページ編集モードで、ドキュメントの検索結果を表示するデフォルトのフィールドは、カスタマイズされ、追加のフィールドを追加できます。

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのドキュメント・リスト・ビューア・タスク・フローの理解に関する項も参照してください。

オプション

コンテンツ・プレゼンタ・タスク・フロー

ページ編集モードでの、コンテンツおよび表示テンプレートの設定。

詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタ・タスク・フローの理解に関する項も参照してください。

オプション

最近のドキュメント・タスク・フロー

なし

イベント・サービス

「イベント」タブ

なし

イベント・タスク・フロー

ページ編集モード:

- タスク・フロー・カスタマイズ: 表示モード、グリッド開始時間、第2タイムゾーン。- カレンダ・オーバーレイのプロパティ: 名前、順序、色および可視性

オプション

リスト・サービス

「リスト」タブ

なし

リスト・ビューア・タスク・フロー

ページ編集モード:

- バンディング・タイプと間隔および列フィルタ設定

- 列の設定: ソート列およびソート方向(昇順、降順)、列サイズおよび列順序

Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリスト・サービスの使用に関する項も参照してください。

オプション

リスト・マネージャ・タスク・フロー

なし

メール・サービス

サイドバー

なし

メール・タスク・フロー

なし

ノート・サービス

なし

ページ

ページ編集モード: 最大化、移動、垂直の高さなど、コンポーザを使用したタスク・フローおよびポートレット・カスタマイズ

常時

ページのプロパティ: ページ名、説明、キーワード、スキーム、スキームの背景色、ページ・セキュリティ、ページ・パラメータ、ページ変更日など。

常時

コンポーネントのプロパティ: タイトル、背景色など

常時

ピープル・コネクション・サービス

アクティビティ・ストリーム・タスク・フロー

アクティビティ・ストリーム・タスク・フローのオプションを表示します。

オプション

ポートレット

プロデューサに格納されるデフォルトの編集またはカスタマイズ(ある場合)

常時

最近のアクティビティ・サービス

なし

リソース・カタログ

なし

RSSニュース・フィード・サービス

なし

検索サービス

なし

保存済の検索

保存済の検索の共有またはプライベートのオプション

保存済みの検索のカスタマイズ

オプション

タグ・サービス

タグ

なし

タグ中央

なし

「タグ」サイドバー

なし

ワークリスト・サービス

なし

表39-5 Spaces: アプリケーションのカスタマイズ

Spaces

カスタマイズ

エクスポート

アプリケーション設定

オプション

構成: 「一般」タブ

すべてのプロパティ

構成: 「一般」タブ

言語

構成: 「サービス」タブ

ディスカッション、メールおよびピープル・コネクション(プロファイル、メッセージ・ボード、フィードバック、コネクション、アクティビティ・ストリーム)のデフォルト設定

ページ: 「ビジネス・ロール・ページ」タブ

ページ・デフォルトの設定や表示順序などの設定

ページ: システム・ページ

ページのカスタマイズ

スペース設定

オプション

スペース設定: 「一般」タブ

すべてのプロパティ

スペース設定: 「ページ」タブ

ページ・デフォルトの設定、順序、ページの表示などの設定

ページおよびシステム・ページのカスタマイズ

スペース設定: 「リソース」タブ

スペースで使用するために編集されるアプリケーション・レベルのリソース

スペース設定: 他のタブ

すべてのプロパティ

39.5.8 サービスが構成されているスペースのエクスポートおよびインポート

問題

サービスが構成されているスペースをエクスポートし、これらのサービスの一部またはすべてが構成されていないインスタンスから同じスペースをインポートしようとすると、次のエラー・メッセージが表示されます。

No handlers could be found for services with IDs: <list of service IDs that are not present in the target instance but prsent in the archive>

次に例を示します。

No handlers could be found for services with IDs:  oracle.webcenter.collab.forum oracle.webcenter.collab.rtc

解決策

サービスをターゲットに追加するか、または次に示すアーカイブのdata.xmlファイルからサービス関連の情報を削除して、この問題を解決することができます。

サービス関連の情報を削除する操作は、次のとおりです。

1. アーカイブを抽出します。
アーカイブには、2つのファイル(policy-store.xmlおよびtransport.mar)が含まれます。

2. ディレクトリにtransport.marを展開します。
data.xmlファイルは、oracle\webcenter\lifecycle\importexportディレクトリにあります。

3. エラー・メッセージでリストされるターゲットに存在しないすべてのサービスのサービス・タグを削除します。
上記のエラー・メッセージ例では、次を削除する必要があります。

<service id="oracle.webcenter.collab.forum" version="11.1.1.0">
<metadataUsages>
<metadataUsage includeBaseDocuments="YES" includeSystemCustomizations="YES">
<paths>
<include path="/oracle/webcenter/collab/forum/scopedMD/s516227ec_dde1_4991_9e18_28d487cb3bce/**"/>
</paths>
</metadataUsage>
</metadataUsages>
</service>

<service id="oracle.webcenter.collab.rtc" version="11.1.1.0"/>

4. トップレベルのディレクトリOracleおよびpagedefsをtransport.marという名前のファイルに圧縮することにより、transport.marをリパックします。

5. 新しく作成したtransport.marおよびpolicy-store.xmlファイルをアーカイブに圧縮することにより、exportアーカイブをリパックします。

6. 新しいアーカイブをインポートします。

上記のエラー・メッセージ例では、次を削除する必要があります。

第VI部

付録

第VI部の内容は次のとおりです。

- 付録A「WebCenter Portalの構成」

- 付録B「WebCenter PortalのOracle HTTP Server構成」

A WebCenter Portalの構成

WebCenter Portalアプリケーションのための主な構成ファイルは、adf-config.xmlおよびconnections.xmlです。この付録では、これらの両方のファイルとその検索方法について説明します。また、これらのファイルをいつ構成し、どのツールを使用するかについても説明します。web.xml、webcenter-config.xmlなどの他の構成ファイルについてもここで説明します。第1.3.5項「WebCenter Portalの構成に関する考慮事項」も参照してください。

また、この付録では、WebCenter Portalアプリケーションをインストールするオペレーティング・システムの構成プロパティ、およびWebCenter Portalアプリケーションとそのバックエンド・コンポーネントを調整する方法についての概要も示します。

この付録の内容は次のとおりです。

- 第A.1項「構成ファイル」

- 第A.1.1項「adf-config.xmlおよびconnections.xml」

- 第A.1.2項「web.xml」

- 第A.1.3項「webcenter-config.xml」

- 第A.2項「クラスタ構成」

- 第A.3項「構成ツール」

- 第A.4項「Oracle WebCenter Portalのパフォーマンスのチューニング」

- 第A.5項「WebCenter Portalアプリケーションの構成に関する問題のトラブルシューティング」

- 第A.6項「WLSTコマンドの問題のトラブルシューティング」

A.1 構成ファイル

adf-config.xml、connections.xmlおよびweb.xmlは、すべてのWebCenter Portalアプリケーション(Spacesを含む)およびそのバックエンド・サービスの構成に使用します。また、Spacesアプリケーションに固有のwebcenter-config.xml構成ファイルは、アプリケーション全体の設定の構成に使用します。

この項では、WebCenter Portalアプリケーションでの各ファイルの使用方法およびこれらのファイルのデプロイ後の場所について説明します。この項の内容は次のとおりです。

- adf-config.xmlおよびconnections.xml

- web.xml

- webcenter-config.xml

A.1.1 adf-config.xmlおよびconnections.xml

adf-config.xmlおよびconnections.xmlは両方とも、開発環境でWebCenter Portalアプリケーションにより使用されるディスカッション・サーバー、メール・サーバーまたはコンテンツ・サーバーなどの設計時構成情報を格納します。

- adf-config.xml: アプリケーションレベルの設定(WebCenter Portalアプリケーションが現在使用しているディスカッション・サーバーやメール・サーバーなど)が格納されます。
『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』も参照してください。

- connections.xml: WebCenter Portalサービスの接続の詳細が格納されます。
『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』も参照してください。

WebCenter Portalアプリケーションを本番環境にデプロイした後で、Fusion Middleware ControlまたはWebLogic Scripting Tool (WLST)コマンドを使用して、これらのファイルのプロパティを再構成することをお薦めします。たとえば、本番サーバー・インスタンスをポイントするように接続の詳細を変更する必要がある場合があります。付録A「構成ツール」も参照してください。

Fusion Middleware ControlおよびWLSTコマンドを使用する主な利点は、デプロイ後に加えた構成の変更が、WebCenter PortalアプリケーションのOracle Metadata Services (MDS)リポジトリにカスタマイズとして格納されることです。MDSは、デプロイされた元のバージョンのadf-config.xmlおよびconnections.xmlをベース・ドキュメントとして使用し、単一のカスタマイズ・レイヤーを使用して後続のすべてのカスタマイズを別個にMDSに格納します。将来、アプリケーションが再デプロイされる場合、以前の構成の変更がすべて保持されます。

WebCenter Portalアプリケーションが起動すると、MDSに格納されたアプリケーション・カスタマイズが適切なベース・ドキュメントに適用され、WebCenter Portalアプリケーションは、マージされたドキュメント(カスタマイズされているベース・ドキュメント)を構成プロパティの最終セットとして使用します。

MDSカスタマイズの詳細は、『Oracle Fusion Middleware管理者ガイド』のMDSリポジトリの概要に関する項を参照してください。

MDSのデプロイ後のカスタマイズの確認

デプロイ後、常にFusion Middleware ControlまたはWLSTコマンドを使用して、最新の構成を確認するか、または構成を変更します。Fusion Middleware Controlでは、多くの場合、WebCenter Portalアプリケーション構成画面を使用しますが、役立つシステムMBeanブラウザは、構成設定の確認にも使用できます。これらのツールは常に現在の構成を示すため、通常、ベース・ドキュメントのコンテンツや、adf-config.xmlおよびconnections.xmlなどのファイルのMDSカスタマイズ・データを調べたり変更したりする必要はありません。

MDSの情報を参照することは役立つ場合があります。なんらかの理由で、MDSに格納される構成ファイルのカスタマイズを抽出するか調べる必要がある場合は、WLSTコマンドexportMetadataを使用してください。

関連項目:

構文の詳細と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

たとえば、常にアプリケーション名がwebcenterで、WC_Spaces管理対象サーバーにデプロイされるSpacesアプリケーションのconnections.xmlのMDSカスタマイズを決定するには、ファイル名および場所は常に/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xmlであり、次のように指定できます。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

同様に、adf-config.xmlのMDSカスタマイズを決定するには、次のように指定できます。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

toLocationを指定することにより、ファイル・カスタマイズの保存先を選択します。たとえば、toLocationは/tmp/mydataに設定され、要求されたファイルは/tmp/mydata/META-INF/mdssys/cust/adfshare/adfshareに保存されます。

要求されたファイルに対してカスタマイズが存在しない場合、指定された場所には何も保存されず、同じ場所に以前に抽出されたカスタマイズは上書きされません。

構成の競合の処理

MDSカスタマイズは、挿入/削除/置換えが必要な要素およびその場所をコールするために、ベース・ドキュメントの要素への参照を使用します。要素が誤って今後の再デプロイから削除され、MDSにその要素への参照が含まれる場合、WebCenter Portalアプリケーションの構成は破損している可能性があります。

たとえば、myconnectionという設計時に作成された接続で、MyPortalAppというJDeveloperを使用して構築されたWebCenter Portalアプリケーションについて考えてみます。アプリケーションは、管理対象サーバーにデプロイされ、myconnectionのURLは変更されました。この変更は、新しいURLを使用するためにmyconnectionを更新する目的で、カスタマイズ手順としてMDSに格納されます。将来、myconnectionが設計時に、および同じMDS詳細を使用して再デプロイされたアプリケーションで削除される場合は、構成の競合が発生します。つまり、MDSのカスタマイズ手順がmyconnectionを検出しようとしますが、このような構成は存在しません。

この問題に直面しない可能性がありますが、adf-config.xmlまたはconnections.xmlに変更を行った後で、以前にデプロイされたアプリケーションが破損している可能性がある場合は、次のオプションを使用します。

- 競合の原因となっているMDSカスタマイズを手動で削除します。

1. adf-config.xmlまたはconnections.xmlのMDSカスタマイズ情報を抽出します。
exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

2. ドキュメントから競合の原因となっているカスタマイズ手順を削除します。

3. 変更されたドキュメントをMDSにインポートします。
次に例を示します。

importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

4. 管理対象サーバーを再起動します。

- adf-config.xmlまたはconnections.xmlのMDSカスタマイズを削除し、新しいEARファイルをデプロイして、Fusion Middleware ControlまたはWLSTを使用して最初からアプリケーションを再構成します。
詳細な手順は下の「adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除」を参照してください。

- 新しいパーティションまたはより古いカスタマイズが削除されるパーティションでEARファイルを再デプロイします。どちらの場合でも、adf-config.xmlまたはconnections.xmlのアプリケーション・カスタマイズ、およびすべてのユーザー・カスタマイズを含む、アプリケーションに対してMDSに以前に格納されたすべてのデータが失われます。Fusion Middleware ControlまたはWLSTを使用して、最初からアプリケーションを再構成する必要もあります。
『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のdeleteMetadataに関する項も参照してください。

adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除

この項では、connections.xmlまたはadf-config.xmlのすべてのデプロイ後の構成を削除する方法について説明します。この操作は元に戻せません。カスタマイズは永久に削除されます。

MDSカスタマイズを削除する場合、次に示す手順を実行する前に、exportMetadataコマンドを使用して、既存のファイルのコピーを保存することをお薦めします。

1. exportMetadataコマンドを使用して、connections.xmlおよびadf-config.xmlをバックアップします。
次に例を示します。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

2. WLSTを使用して、connections.xmlのカスタマイズを削除します。次に例を示します。

deleteMetadata(application='webcenter', server='WC_Spaces', docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

3. WLSTを使用して、adf-config.xmlのカスタマイズを削除します。次に例を示します。

deleteMetadata (application='webcenter', server='WC_Spaces', docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

4. WebCenter Portalアプリケーションを再起動します。

5. Fusion Middleware ControlまたはWLSTを使用して、最初からアプリケーションを再構成します。

A.1.2 web.xml

web.xmlは、標準のJ2EEアプリケーション・デプロイメント記述子ファイルで、アプリケーションの/META-INFディレクトリにあります。通常、web.xmlの実行時設定には、初期化パラメータ、カスタム・タグ・ライブラリの場所およびセキュリティ設定が含まれます。

多くのweb.xmlプロパティは静的であるため、設計時にアプリケーションに対して指定されます。デプロイされた環境で一部のプロパティを変更する必要がある場合は、「デプロイメント設定」ページの「Webモジュールの構成」画面からほとんどのプロパティを編集できます。第7.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」の図7-12も参照してください。

たとえば、次を変更する必要がある場合に、web.xmlを変更する必要があるインスタンスはほとんどありません。

- コンテンツ・リポジトリ・アップロード・パラメータ: UPLOAD_MAX_MEMORY、UPLOAD_MAX_DISK_SPACEおよびUPLOAD_TEMP_DIR。詳細は、第11.12項「最大ファイル・アップロード・サイズの変更」を参照してください。
注意: Spacesアプリケーションでは、webcenter-config.xmlのuploadedFileMaxDiskSpaceパラメータを使用して、ファイルの最大アップロード・サイズを構成します。詳細は、付録A「webcenter-config.xml」を参照してください。

- HTTPセッションの失効後の経過時間。詳細は、付録A「Oracle WebCenter Portalのパフォーマンスの調整」を参照してください。

- JSPページ・タイムアウト値。詳細は、付録A「Oracle WebCenter Portalのパフォーマンスの調整」を参照してください。

connections.xmlおよびadf-config.xmlとは異なり、web.xmlはMDSにデプロイ後のカスタマイズを格納しません。また、Fusion Middleware ControlまたはWLSTを使用して、既存のWebCenter Portalアプリケーションのデプロイでweb.xmlを変更することはできません。

web.xmlの設定を変更する必要がある場合は、ご使用のアプリケーションの適切な手順に従ってください。

- Spacesのweb.xmlプロパティの編集

- WebCenter Portalアプリケーションのweb.xmlプロパティの編集

A.1.2.1 Spacesのweb.xmlプロパティの編集

特定のweb.xmlプロパティを更新する必要がある場合は、次のようにSpaces EARファイルを開いて、web.xmlを編集し、EARを再パッケージします。

1. WebCenter Portal Oracleホーム・ディレクトリに移動します。

2. Spaces EARファイルを開きます。

mkdir -p /tmp/my_ear
cd /tmp/my_ear
jar -xvf $WEBCENTER_HOME/archives/applications/webcenter.ear

mkdir war
cd war
jar -xvf ../spaces.war

3. WEB-INF/web.xmlを編集して、変更内容を保存します。

4. 必要なweb.xmlプロパティを持つ変更された.EARファイルを作成します。

cd /tmp/my_ear/war
jar -cvf ../spaces.war *
cd ..
rm -rf war

jar -cvf ../webcenter.ear *

5. /tmp/webcenter.earを$WEBCENTER_HOME/archives/applications/webcenter.earにコピーします。

6. WC_Spaces管理対象サーバーを再起動します。
起動時に、これにより、変更されたweb.xmlを使用してより新しいアプリケーションが自動的にデプロイされます。

注意:

今後は、Spacesパッチによってこの構成の変更が上書きされるため、パッチを適用後にこのような構成の変更を繰り返し行ってください。すなわち、最新のwebcenter.earファイルを取得して、これらの手順を繰り返す必要があります。

A.1.2.2 WebCenter Portalアプリケーションのweb.xmlプロパティの編集

通常、特定のweb.xmlプロパティを変更する必要がある場合、開発者は設計時にweb.xmlを編集し、新しい値を含むようにアプリケーションのEARファイルを再生成します。

これが実行可能なオプションではない場合、現在のアプリケーションのEARファイルを開いて、web.xmlを編集し、Spacesアプリケーションに対して上記のようにEARを再パッケージ/再デプロイすることができます。第A.1.2.1項「Spacesのweb.xmlプロパティの編集」を参照してください。

A.1.3 webcenter-config.xml

webcenter-config.xmlは、Spaces構成ファイルで、アプリケーション名やロゴなどのアプリケーションレベルの設定を含みます。このファイルのプロパティのほとんどは、Spaces管理画面から管理されるため、webcenter-config.xmlを直接編集する必要はありません。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのSpaces管理ページへのアクセスおよびグローバル・デフォルトの構成に関する項を参照してください。

たとえば、次の変更を行う場合は、webcenter-config.xmlで設定を手動で変更する必要があるインスタンスはほとんどありません。

- 最大ファイル・アップロード・サイズ(uploadedFileMaxDiskSpace): デフォルト設定は2MBです。

- セッション・タイムアウト(wcSessionTimeoutPeriod): web.xmlで設定されているデフォルトのHTTPセッション・タイムアウト(45分)を上書きできます。第9.9項「Spacesアプリケーションのセッション・タイムアウトの設定」も参照してください。

これらの設定を変更する場合は、次のように、MDSからwebcenter-config.xmlの最新バージョンをエクスポートし、uploadedFileMaxDiskSpaceおよびwcSessionTimeoutPeriodの値を変更する必要があります。

1. 最新のwebcenter-config.xmlをMDSからエクスポートします。
次に例を示します。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcenter-config.xml.xml')

注意:

webcenter-config.xmlファイルは、Spaces管理で「一般」設定を初めて構成したときに作成されます。ファイルがMDSに存在しない場合、webcenter-config.xmlを直接編集できます。ファイルは、/oracle/webcenter/webcenterapp/metadata/webcenter-config.xmlにあります。

2. MDSからエクスポートされたwebcenter-config.xml.xmlをテキスト・エディタで開き、必要に応じて、次のスニペットを追加します。
最大ファイル・アップロード・サイズを変更するには:

<mds:replace node="webcenter(xmlns(webcenter=http://xmlns.oracle.com/webcenter/webcenterapp))/webcenter:uploadedFileMaxDiskSpace"/>
<mds:insert after="webcenter(xmlns(webcenter=http://xmlns.oracle.com/webcenter/webcenterapp))/webcenter:custom-attributes" parent="webcenter">
<uploadedFileMaxDiskSpace xmlns="http://xmlns.oracle.com/webcenter/webcenterapp">214748364800</uploadedFileMaxDiskSpace>
</mds:insert>

セッション・タイムアウトを変更するには:

<mds:replace node="wcSessionTimeoutPeriod(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/webcenterapp))/mds_ns1:value"/>
<mds:insert after="wcSessionTimeoutPeriod(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/webcenterapp))/mds_ns1:type" parent="wcSessionTimeoutPeriod">
<value xmlns="http://xmlns.oracle.com/webcenter/webcenterapp">15</value>
</mds:insert>

3. webcenter-config.xml.xmlを保存して閉じます。

4. 更新したwebcenter-config.xml.xmlファイルをMDSにインポートします。
次に例を示します。

importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcenter-config.xml.xml')

A.2 クラスタ構成

Fusion Middleware Control、WLSTまたはシステムMBeanブラウザを介したすべてのデプロイ後の構成は、MDSリポジトリにカスタマイズとして格納されます。クラスタ環境では、MDSリポジトリはすべてのノード間で共有されるため、あるノードで行われたすべてのWebCenter Portal構成の変更は、クラスタ内のすべてのノードに表示されます。動的ではない構成の変更を反映させるには、クラスタ内のすべてのノードを再起動する必要があります。第8.2項「WebCenter Portalアプリケーションをデプロイするための管理対象サーバーの起動および停止」も参照してください。

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portalアプリケーションのほとんどの構成の変更は、動的ではありません。たとえば、WebCenter Portalのサービス(分析、アクティビティ・グラフ、お知らせ、ディスカッション、ドキュメント、イベント、メール、インスタント・メッセージおよびプレゼンス、検索、ワークリスト)の接続詳細を追加または変更する場合は、アプリケーションの対象管理サーバーを再起動する必要があります。ただし、2つの例外があり、ポートレット・プロデューサおよび外部アプリケーションの登録は動的です。登録した新規ポートレット・プロデューサや外部アプリケーションは、WebCenter Portalアプリケーションで即座に使用可能になります。既存の接続に対して行った変更も即座に有効になります。

クラスタ環境で構成ファイルを編集する場合、クラスタ構成全体で同期を維持できるように、各クラスタ・メンバーで同一の変更が行われていることを確認する必要があります。

A.3 構成ツール

Spacesおよび他のWebCenter Portalアプリケーション・デプロイメントを構成するための様々なツールがあります。この項では、利用可能なツールについて概説します。

注意:

WebCenter Portal構成パラメータのほとんどは不変であり、特に指定されないかぎり、実行時に変更できません。

デプロイ後、常にFusion Middleware ControlまたはWebLogic Scripting Tool (WLST)コマンドを使用して、最新の構成を確認するか、または構成を変更します。Fusion Middleware Controlでは、多くの場合、WebCenter Portalアプリケーション構成画面を使用しますが、役立つシステムMBeanブラウザは、構成設定の確認および変更にも使用できます。

これらのツールの詳細は、下記を参照してください。

- Oracle Enterprise Manager Fusion Middleware Controlコンソール

- Oracle WebLogic Scripting Tool (WLST)

- OracleシステムMBeanブラウザ

これらのツールは常に現在の構成を示すため、通常、構成ファイルのコンテンツやadf-config.xmlまたはconnections.xmlなどのファイルのMDSカスタマイズ・データを調べたり、手動で変更する必要はありません。アプリケーションを再デプロイする場合に同じMDS詳細を使用する場合は、これらのツールを使用して実行されるすべての構成が保持されます。

使用する構成ツール

デプロイ後の構成のための任意のツールを使用できます。ただし、より新しいインスタンスをプロビジョニングしたり、オートメーション用に構成手順を複数回繰り返す場合は、Fusion Middleware Controlなどのツールを使用したスクリーンベースの構成は効率的ではありません。このような場合は、WLSTスクリプトを記述して、必要な構成を実行することを強くお薦めします。

Fusion Middleware Controlを使用して行うことが可能なすべてのWebCenter Portal構成操作は、WebCenter PortalのWLSTコマンドを使用できます。WLSTスクリプトを使用して、たとえば、アプリケーションのデプロイ、管理対象サーバーの作成、アプリケーションのMDSプロパティの設定、データ・ソースの構成などの他のコンポーネントを構成することもできます。ドメイン構成を自動化する場合は、一連のWLSTコマンドとしてWLS管理コンソールで構成アクションを記録し、WLSTを使用してコマンドをリプレイすることができます。このトピックの詳細は、Oracle Fusion Middleware Oracle WebLogic Serverの概要のWLSTスクリプトの記録に関する項を参照してください。

ヒント:

OracleドキュメントでWLS管理コンソールの手順を記載している場合は、「レコード」オプションを使用して処理を自動化することを検討してください。

デプロイメント固有のプロパティを構成するための別の方法は、WebCenter Portalアプリケーションのデプロイ・プランを使用することです。デプロイメントで変更される一般的なプロパティには次のものがあります。

- 接続用のホスト/ポートのプロパティ

- web.xmlの標準J2EEアーティファクト

第7.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」も参照してください。

注意:

このように再構成が可能な場合は、行ったメタデータ・リポジトリおよびADF接続構成の変更は、デプロイ・プランの一部として保存されません。すなわち、デプロイされるアーカイブで保存されます。したがって、構成の変更を後続の再デプロイで繰り返す必要があります。

アプリケーションを複数回、再デプロイする場合は、Fusion Middleware ControlまたはWLSTコマンドを使用して、デプロイ後の構成を実行することをお薦めします。こうすれば、構成の変更はMDSで保存され、再デプロイ時にそのまま維持されます。

A.4 Oracle WebCenter Portalのパフォーマンスのチューニング

表A-1に記載されているパラメータのチューニングの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のOracle WebCenter Portalのパフォーマンスのチューニングに関する章を参照してください。

表A-1 WebCenter Portalのパフォーマンスのチューニング

パフォーマンス・チューニング

パラメータ

ファイル

環境

システム制限

JDBCデータ・ソース(MDSDSおよびWebCenterDSの設定)

JRockit Virtual Machine (JVM)引数

setDomainEnv.sh

WebCenter Portalアプリケーション

HTTPセッション・タイムアウト

web.xml

JSPページ・タイムアウト

web.xml

ADFクライアントのStateトークン

web.xml

MDSキャッシュ・サイズおよびパージ・レート

adf-config.xml

同時実行性管理

adf-config.xml

CRUD API (作成、読取り、更新および削除)

adf-config.xml

Spacesアプリケーション

Spacesセッション・タイムアウト

webcenter-config.xml

バックエンド・コンポーネント脚注 1

お知らせサービス

接続タイムアウト

connections.xml

ディスカッション・サービス

接続タイムアウト

connections.xml

インスタント・メッセージおよびプレゼンス(IMP)サービス

接続タイムアウト

connections.xml

メール・サービス

接続タイムアウト

connections.xml

RSSニュース・フィード・サービス

リフレッシュ間隔

adf-config.xml

検索サービス

表示される保存済検索の数、表示される結果数、各種タイムアウト

adf-config.xml

WSRPプロデューサ

接続タイムアウト

connections.xml

Oracle PDK-Javaプロデューサ

接続タイムアウト

connections.xml

OmniPortlet

接続タイムアウト

connections.xml

ポートレット・サービス

ロケール・サポート、ポートレット・タイムアウト、ポートレット・キャッシュ・サイズ

adf-config.xml

脚注 1 ワークリスト、Oracle WebCenter Content Serverなどのバックエンド・サーバーのパフォーマンスは、これらのバックエンド用ガイドラインの説明に従ってチューニングする必要があります。

A.5 WebCenter Portalアプリケーションの構成に関する問題のトラブルシューティング

この項の内容は次のとおりです。

- 第A.5.1項「WebCenter PortalがFusion Middleware Controlの「アプリケーションのデプロイ」メニューに表示されない」

- 第A.5.2項「使用不可の構成オプション」

- 第A.5.3項「あるアプリケーションで実行された構成が別のアプリケーションに反映される」

- 第A.5.4項「Spacesアプリケーションのログはオープン・ファイルが多すぎることを示している」

A.5.1 WebCenter PortalがFusion Middleware Controlの「アプリケーションのデプロイ」メニューに表示されない

問題

Fusion Middleware Controlにログインした後で、「アプリケーションのデプロイ」メニューの「WebCenter Portal」オプションを検索できません。

解決策

次のことを確認します。

- デプロイ済アプリケーションがADFアプリケーションであること。
「WebCenter Portal」オプションは、ADFを使用して開発されていないアプリケーションには表示されません。

- デプロイ済アプリケーションが稼働中であること。

- デプロイ済アプリケーションには、MDSリポジトリおよびパーティションに関する正確な情報が含まれ、MDSリポジトリがそのアプリケーションにアクセスできること。この情報を確認するには、adf-config.xmlファイルのmetadata-store-usagesセクションをチェックします。MDSの詳細は、『Oracle Fusion Middleware管理者ガイド』のMDSリポジトリの概要に関する項を参照してください。

- アプリケーションが次の構成をサポートするように、必要なアーティファクトと一緒にパッケージ化されていること。

- adf-jndi-configネーム・スペースは、アプリケーションのadf-config.xmlファイルで構成されます。これは、設計時にプロビジョニングされます。次はadf-jndi-configネーム・スペースの例(太字のテキスト)です。

<adf-config xmlns="http://xmlns.oracle.com/adf/config"
xmlns:jndiC="http://xmlns.oracle.com/adf/jndi/config"
xmlns:ns2="http://xmlns.oracle.com/mds/config"
xmlns:ns3="http://xmlns.oracle.com/adf/mds/config">
...
...
</adf-config>

- MBeansを登録するために、適切なリスナーがweb.xmlファイルに存在します。これは、設計時にプロビジョニングされます。たとえば、web.xmlファイルの次のスニペットで太字のテキストを表示します。

<listener>
<description>ADF Config MBeans</description>
<display-name>ADF Config MBeans</display-name>
<listener-class>oracle.adf.mbean.share.config.ADFConfigLifeCycleCallBack</listener-class>
</listener>
<listener>
<description>ADF Connection MBeans</description>
<display-name>ADF Connection MBeans</display-name>
<listener-class>oracle.adf.mbean.share.connection.ADFConnectionLifeCycleCallBack</listener-class>
</listener>

- MBeansがWebCenter Portalアプリケーションに対して登録されていること。これを確認する手順は次のとおりです。

1. Fusion Middleware Controlで、「アプリケーション・デプロイメント」メニューから、「システムMBeanブラウザ」を選択します。

2. 「アプリケーション定義のMBean」→「oracle.adf.mbean.share.connection」の下で、アプリケーションの接続MBeansを見つけます。

3. 同様に、「アプリケーション定義のMBean」→「oracle.adf.mbean.share.config」の下で、アプリケーションのadf-config MBeansを見つけます。図A-1は、Fusion Middleware Controlでの「アプリケーション定義のMBean」セクションの外観を示しています。
アプリケーションがプロデューサを使用する場合は、プロデューサ・マネージャMbeanを検索してください。

図A-1 アプリケーション定義のMBean

「図A-1 アプリケーション定義のMBean」の説明

- アプリケーションの診断ログを確認して、oracle.adf.mbean.share.connectionおよびoracle.adf.mbean.share.configを分析し、実行するために必要な作業を判断します。

A.5.2 使用不可の構成オプション

問題

Fusion Middleware ControlからWebCenter Portalアプリケーションを構成する場合は、次のメッセージが表示されます。

Configuration options currently unavailable. The application application_name might be down, did not start-up properly, or is incorrectly packaged.
Check the log files for further details.

解決策

この問題の解決方法の詳細は、第A.5.1項「WebCenter PortalがFusion Middleware Controlの「アプリケーションのデプロイ」メニューに表示されない」を参照してください。

A.5.3 あるアプリケーションで実行された構成が別のアプリケーションに反映される

問題

WebCenter Portalアプリケーションを構成しましたが、これらの構成が別のアプリケーションでも表示されます。

解決策

これは複数のアプリケーションがMDSパーティションを同じスキーマで共有する場合に発生します。この問題を解決するには、これらのアプリケーションを再度デプロイして、各アプリケーションが独自のMDSスキーマとパーティションの組合せを使用していることを確認します。異なるMDSリポジトリまたはパーティションを使用するために、MDSリポジトリを作成するか、既存のWebCenter Portalアプリケーションを構成する方法の詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle Metadataリポジトリの管理に関する項を参照してください。

A.5.4 Spacesアプリケーションのログはオープン・ファイルが多すぎることを示している

問題

Spacesにアクセスできないか、またはSpacesにエラー・メッセージが表示されていて、オープン・ファイルが多すぎるという問題があることを診断ログ・ファイルが示しています。

解決策

次の操作を実行します。

- 各バックエンド・サーバー(主にデータベース)で構成されるファイル・ハンドル数を確認し、必要に応じて数を増やします。

- ファイル・ハンドル数を増加した後でも問題が解決されない場合は、/etc/sysctl.confファイルのfs.file-maxの値を確認し、必要に応じて値を増やします。

A.6 WLSTコマンドの問題のトラブルシューティング

この項の内容は次のとおりです。

- 第A.6.1項「WebCenter Portal WLSTコマンドがいずれも機能しない」

- 第A.6.2項「WLSTコマンドが特定のサービスに対して機能しない」

- 第A.6.3項「Connection_Nameという名前の接続がすでに存在している」

- 第A.6.4項「WLSTシェルがOracle WebLogic管理対象サーバー・インスタンスに接続されない」

- 第A.6.5項「同じ名前のアプリケーションがドメインにすでに存在している」

- 第A.6.6項「同じ名前のアプリケーションが管理対象サーバーにすでに存在している」

- 第A.6.7項「ドメイン・ランタイム・ツリーにすでにメッセージが表示される」

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

A.6.1 WebCenter Portal WLSTコマンドがいずれも機能しない

問題

WLSTコマンドをいずれも実行できません。

解決策

次のことを確認します。

- WebCenter Portal WLSTコマンドは常に、WebCenter Portal Oracleホーム・ディレクトリ(WC_ORACLE_HOME/common/bin)から実行してください。
間違ったディレクトリからWebCenter Portal WLSTコマンドを起動しようとすると、NameErrorが表示されます。

- Python以外のファイルは、WLSTソース・ディレクトリ: WC_ORACLE_HOME/common/bin/wlstには格納されません。このディレクトリには、.py拡張子のみを持つファイルが含まれる必要があります。
この場所のファイルのデフォルト・セットには、Oracleからの適切なPythonファイルが含まれます。ユーザーは、このディレクトリに一部のPython以外のスクリプト、たとえばバックアップ・ファイルや構文エラーのあるテスト用Pythonファイルをコピーしておくことが可能です。

- webcenter-wlst.jarは、WC_ORACLE_HOME/common/bin/wlst/libにあります。

A.6.2 WLSTコマンドが特定のサービスに対して機能しない

問題

WLSTコマンドが特定のサービスに対して実行できないため、そのサービスを構成できません。

解決策

最初に、listApplications()およびdisplayMetricTableNames()などの一般的なWebCenter Portal以外のコマンドを実行して、これらのコマンドが機能するかどうか確認します。一般的なコマンドが機能しない場合は、第A.6.1項「WebCenter Portal WLSTコマンドがいずれも機能しない」で説明される解決策を適用してください。

一般的なコマンドが機能する場合は、テスト・コマンドを実行して、WebCenter Portal固有のコマンドに構文エラーがないか確認します。適切なWSLTチェック・コマンドを実行してください(表A-2を参照)。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

表A-2 WebCenter Portalサービスのファイル名とWLSTコマンド

サービス名

ファイル名

WLSTコマンド

アクティビティ・グラフ

ActivityGraph.py

metadataAdminCheck()

アクティビティ・ストリーム

ActivityStream.py

asCheck()

分析

Analytics.py

OpenUsage.py

analyticsCheck()

openusageCheck()

ディスカッションおよびお知らせ

Forum.py
JiveAdmin.py

fcpCheck()

ドキュメント

Doclib.py

doclibCheck()

外部アプリケーション

ExtApp.py

extCheck()

スペース・イベント

CommunityWLST.py

ceCheck()

インスタント・メッセージおよびプレゼンス

Imp.py

rtcCheck()

メール

Mail.py

mailCheck()

通知

Notification.py

notificationCheck()

個人イベント

Personal.py

peCheck()

プロデューサ

PDK-Javaプロデューサ

Pdk.py

pdkCheck()

WSRPプロデューサ

Wsrp.py

wsrpCheck()

ページレット・プロデューサ

Ensemble.py

ensembleCheck()

プロデューサ・ヘルパー

Producer.py

producerHelperCheck()

RSSニュース・フィード

RSS.py

rssCheck()

検索

Ses.py

sesCheck()

ワークリスト

Bpel.py

bpelCheck()

エクスポート/インポート: WebCenter Portalアプリケーション

Lifecycle.py

lifecycleCheck()

エクスポート/インポート: スペースおよびテンプレート

ExtImp.py

expimpCheck()

WebCenter Portal: 一般

サービス・フレームワーク

WcServiceFwk.py

serviceFwkCheck()

一般設定

WebCenterGeneralSettings.py

generalSettingsCheck()

SpacesおよびSOA

WebCenterSpacesSOA.py

spaceCheck()

A.6.3 Connection_Nameという名前の接続がすでに存在している

問題

connection_nameという名前の接続を作成できません。次のメッセージが表示されます。

A connection with name Connection_Name already exists.

解決策

接続名はWebCenter Portalアプリケーション間で一意です。使用中の名前で接続を作成しようとするとエラーが発生します。接続に一意の名前を使用していることを確認してください。

A.6.4 WLSTシェルがOracle WebLogic管理対象サーバー・インスタンスに接続されない

問題

WLSTシェルはWLSTコマンドを実行する管理対象サーバーに接続されません。

解決策

WLSTシェルを管理対象サーバーに接続するには、次のコマンドを実行してください。

connect(username, password , serverhost:serverport)

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

A.6.5 同じ名前のアプリケーションがドメインにすでに存在している

問題

プロデューサ・アプリケーションを登録できません。次のメッセージが表示されます。

Another application named "YourApplicationName" exists. Specify the Server on which your application is deployed. Use: server="YourServerName".

解決策

アプリケーションを登録しようとしているドメインに同じ名前を持つ複数のアプリケーションがあります。これは通常、同じアプリケーションが複数の管理対象サーバーにデプロイされる、クラスタ環境で発生します。この場合、このアプリケーションを登録しようとしているサーバーの名前を指定します。たとえば、server引数を持つregisterWSRPProducer WLSTコマンドを実行してください。

registerWSRPProducer(appName='myApp', name='MyWSRPSamples',url='http://host:port/application_name/portlets/wsrp2?WSDL', server=server_name)

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterWSRPProducerに関する項を参照してください。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

A.6.6 同じ名前のアプリケーションが管理対象サーバーにすでに存在している

問題

プロデューサ・アプリケーションを登録できません。次のメッセージが表示されます。

Another application named "application_name" exists on the server managedServerName.

解決策

アプリケーションを登録しようとしている管理対象サーバーに同じ名前を持つ複数のアプリケーションがあります。これは通常、アプリケーションが別のバージョンを割り当てられている場合に発生します。この場合、登録するアプリケーションのバージョンを指定します。たとえば、serverおよびapplicationVersion引数を持つregisterWSRPProducer WLSTコマンドを実行してください。

registerWSRPProducer(appName='myApp', name='MyWSRPSamples',url='http://host:port/application_name/portlets/wsrp2?WSDL',
server=server_name applicationVersion=version of the application)

コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のregisterWSRPProducerに関する項を参照してください。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

A.6.7 ドメイン・ランタイム・ツリーにすでにメッセージが表示される

問題

WLSTコマンドの実行中に、次のメッセージが表示されます。

Already in Domain Runtime Tree

解決策

何も実行する必要がありません。これは情報のみを目的としています。

B WebCenter PortalのOracle HTTP Server構成

Oracle WebLogic Server上で実行するOracle WebCenter Portalコンポーネントに対して、Oracle WebLogic ServerへのフロントエンドとしてOracle HTTP Server (OHS)を設定できます。フロントエンドとしてOHSが必要なシナリオの一部は、次のとおりです。

- Site StudioとOracle Content Server間でOSSOが正しく機能するため。これはOHSのmod_ossoを介して実現されます。

- Oracle WebLogic Serverクラスタ・ノード間で適切な負荷の分散を行うため。これはOHSのmod_wlを介して実現されます。

- OHSはOAMのWebGateコンポーネントにも必要です。

- OHSはリバース・プロキシとして使用されます。

これらの場合、mod_wl_ohsモジュールを構成して、リクエストをOHSからOracle WebLogic Serverへプロキシ可能にする必要があります。詳細は、Oracle Fusion Middleware Oracle HTTP Server管理者ガイドのOracle HTTP Serverでのmod_wl_ohsモジュールの構成に関する項を参照してください。

サンプルのmod_wl_ohs.conf

Fusion Middleware Controlを使用してmod_wl_ohsモジュールを構成した後で、mod_wl_ohs.confファイルは例B-1のようになります。このファイルのデフォルトの場所は、OHS_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1/mod_wl_ohs.confです。

例B-1 Spaces: サンプルのmod_wl_ohs.confファイル

# Spaces Application
<Location /webcenter>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /webcenterhelp>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /rss>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /rest>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
# Discussions
<Location /owc_discussions>
SetHandler weblogic-handler
WeblogicHost discuss.example.com
WeblogicPort 8890
</Location>
# SES Search
<Location /rsscrawl>
SetHandler weblogic-handler
WeblogicHost ses.examplet.com
WeblogicPort 7777
</Location>
<Location /sesUserAuth>
SetHandler weblogic-handler
WeblogicHost ses.example.com
WeblogicPort 7777
</Location>
# Portlets
<Location /portalTools>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8889
</Location>
<Location /wsrp-tools>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8889
</Location>
<Location /pagelets>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8889
</Location>
# Personalization
<Location /wcps>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8891
</Location>
# Activity Graph
<Location /activitygraph-engines>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8891
</Location>
# UCM
#  Web server context root for Oracle WebCenter Content Server
<Location /cs>
SetHandler weblogic-handler
WeblogicHost ucm.example.com
WeblogicPort 16200
</Location>
#  Enables Oracle WebCenter Content Server authentication
<Location /adfAuthentication>
SetHandler weblogic-handler
WeblogicHost ucm.example.com  # Same as /cs entry
WeblogicPort 16200            # Same as /css entry
</Location>
#  SAML SSO
<Location /samlacs/acs>>
SetHandler weblogic-handler
WeblogicHost ucm.example.com
WeblogicPort 16200
</Location>
# BPEL Server
<Location /workflow>
SetHandler weblogic-handler
WeblogicHost soa.example.com
WeblogicPort 8001
</Location>
# Virtual Hosts - Sharepoint
<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location />
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

SSLディレクティブ

SSLを構成している場合、次の追加のディレクティブが必要です。

- WLProxySSL ON

- WLProxySSLPassThrough ON

たとえば、mod_wl_ohs.confエントリは例B-2のようになります。

例B-2 Spaces: SSLディレクティブを使用したmod_wl_ohs.confファイル

# Spaces Application
<Location /webcenter>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
WLProxySSL ON
WLProxySSLPassThrough ON
</Location>
<Location /webcenterhelp>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
WLProxySSL ON
WLProxySSLPassThrough ON
</Location>
...

フロントエンド・リスニング・ホストおよびフロントエンド・リスニング・ポート

Oracle HTTP Server (OHS)フロントエンドがサイト・エントリ・ポイントでもある場合、Oracle WebLogic Server管理コンソールを使用して、OHSフロントエンドを使用する各サーバーに対してFrontEnd HostおよびFrontEnd HTTP Portを設定します。

用語集

バージョン情報モード

著作権、バージョン、ポートレットの作成者などの情報が一般的に表示されるポートレット・モード。

アクティビティ・ストリーム

ピープル・コネクション・サービスにおいて、自分や他のユーザーのために追跡されているアプリケーション・アクティビティを表示する機能。

アクティビティ・グラフ

ユーザーが関心を寄せている可能性のある人、アイテムおよびスペースを提案するWebCenter Portalサービス。

アクティビティ・グラフ・サービスで使用されるエンジンで、エンタープライズ・アプリケーションによって収集されたアクション用の集中リポジトリが用意されています。アクティビティ・グラフに格納されているデータは、ノードのランクの計算、新しいアクションの予測および推奨を行うために分析されます。

アクティビティ・ランク

検索結果の関連性を決めます。

管理者

Spacesアプリケーションには2種類の管理者があります。

- Fusion Middleware管理者: システム管理者とも呼ばれます。すべての管理能力を持つユーザーです。この管理者は、セキュリティ上重要な管理作業の全範囲、およびすべてのインストール、構成および監査作業を実行できます。

- Spaces管理者: Spacesの即時カスタマイズ、アプリケーション・ロールの管理と付与、および使用時のアプリケーションの保守を担当するユーザー。

Ajax

非同期のJavaScript、ダイナミックHTML(DHTML)、XMLおよびXmlHttpRequest通信チャネルを組み合せたもの。ページ全体を完全に再レンダリングすることなく、サーバーにリクエストを送信できます。Ajaxによってリッチ・クライアントのようなアプリケーションで標準インターネット・テクノロジを使用できます。

分析サービス

ポータルのリアルタイム使用状況およびアクティビティのレポートを提供するWebCenter Portalサービス。Spacesアプリケーションでは、ユーザーは、Spacesのトラフィックおよび使用状況を追跡し分析できます。

お知らせサービス

即時または特定の時刻にメッセージを作成して広く配布するために迅速で便利な方法を提供するWebCenter Portalサービス。

API

Application Programming Interface。公開されたデータ構造および関数のセット。これによって、アプリケーションがポートレットなどのアプリケーション・オブジェクトでサービスを起動するために使用できます。

アプリケーションのカスタマイズ

管理者によって行われ、すべてのユーザーに変更が表示されます。これらはサイトに影響を与えるアプリケーションに対する静的な変更であり、アプリケーションのコードまたはスキーマに対する変更を伴いません。

「ユーザー・カスタマイズ」と「パーソナライズ」も参照してください。

Application Development Framework

「Oracle ADF」を参照してください。

Application Programming Interface

「API」を参照してください。

アプリケーション・ロール

特定のアプリケーションに固有のロール。ポリシー・ストアのアプリケーション固有ストライプに格納されます。

アプリケーション・スキン

アプリケーションの背景色、画面フォント、および一部のスキンの場合においてアプリケーションのボタンとアイコンに使用する図形やイメージを指定します。Spacesアプリケーションでは、管理者がデフォルトのアプリケーション・スキンを選択し、Spacesユーザーは「プリファレンス」ダイアログの「一般」タブでアプリケーション・スキンを変更できます。

アプリケーション・テンプレート

WebCenter Portalでは、Frameworkアプリケーションとポートレット・プロデューサ・アプリケーションの2種類のアプリケーションを作成するためのテンプレートを用意しています。テンプレートにより、適切なテクノロジ・スコープを設定し、タグ・ライブラリを追加して、必要なJavaクラスをクラス・パスに追加します。このようにすると、関連するコンポーネントがコンポーネント・パレットに取り込まれ、関連するポップアップ・メニューがJDeveloperで使用できます。

「Frameworkアプリケーション・テンプレート」と「ポートレット・プロデューサ・アプリケーション・テンプレート」も参照してください。

認証されたユーザー

WebCenter Portalアプリケーションにログインしているユーザー。このユーザーの資格証明はアイデンティティ・ストアに対して検証されます。デフォルトでは、認証されたユーザーはパブリック情報にアクセスできます。ページやポートレットなど、セキュアな情報にアクセスするには、ポリシー・ストアと資格証明ストアを介してこのユーザーを認証する必要があります。

ログインしていなくてパブリック・コンテンツにのみアクセスできるパブリック・ユーザーと対比してください。

認証

アイデンティティ管理システムによるユーザーの識別。ADF認証が必要になるのは、ユーザーに対して、Frameworkアプリケーションにのみアクセスできる資格証明を適用する場合であり(アプリケーションですべてのADFリソースにそのままアクセス可能)、認証および認可が必要になるのは、ユーザーに対して、アプリケーションで保護されているADFリソースおよびFrameworkアプリケーションにアクセスできる資格証明を適用する場合です。

認可

セキュアなリソースに対して個人やグループのアクセス権を定義するポリシー。このリソースは、ページ内のコンポーネントやページの場合があります。

認可ユーザー

セキュアなリソースへのアクセス権を持つ個人。パブリックでないリソースの場合、この個人は認証されたユーザーでもあります。

AviTrust Portal Demonstration for WebCenter Portal

Oracle Fusion Middlewareを使用して構築されたエンタープライズ銀行取引アプリケーション。Oracle WebCenter Portal: FrameworkおよびWebCenter Portal: Spacesが含まれ、WebCenter Portal機能の例を提供するために使用されます。

ブログ・ページ

個々のユーザーの経験や意見の個人的な記録を示すページ。2種類のブログ(個人が記述する個人的なブログと複数のユーザーが記述するグループ・ブログ)があります。

ボックス・レイアウト・コンポーネント

Oracle WebCenter PortalのComposerで利用可能なレイアウト・コンポーネント。Spacesアプリケーションで作成されたページにコンテンツを配置できるコンテナ。Composerでは、ボックスは、破線で構成される矩形としてレンダリングされます。Frameworkアプリケーションでは、これは、Panel Customizableコンポーネントと同等のランタイムです。

BPEL

Business Process Execution Language。エンド・ツー・エンドのプロセス・フローに対して一連の個別Webサービスを作成するためのXMLベース型マークアップ言語。

ビジネス・ロール・ページ

Spacesアプリケーションで管理者によって作成されるページ。特に組織で特定ロールに対して提供されます。ビジネス・ロール・ページにより、タイムリーで関係のある情報を、他のビジネス分野から無関係な情報のノイズなしに個々のロールに配信することで、特定ロールのユーザーにターゲット環境を提供します。ビジネス・ロール・ページは、指定されたロールの下で分類されたユーザーのホーム・スペースに表示されます。

キャッシュ

頻繁にアクセスされる情報(通常はWebページ)を迅速にアクセスできる場所に格納し、コンテンツが頻繁に生成されるのを回避するための操作。

「有効期限ベースのキャッシュ」と「有効化ベースのキャッシュ」も参照してください。

カレンダ・オーバーレイ

単一のイベント・タスク・フローに複数のカレンダを表示する機能。

Change Mode Buttonコンポーネント

コンポーザ・タグ・ライブラリでは、ユーザーはページの表示モードからページの編集モードに変更できます。

Change Mode Linkコンポーネント

ユーザーがページの表示モードからページの編集モードに変更できるコンポーザ・タグ・ライブラリで用意されているコンポーネント。

チェックアウト/チェックイン

ユーザーが、情報をチェックアウトによりロックし、他のユーザーが同じ情報を変更できないようにすることができるメカニズム。これにより、複数のユーザーは互いに変更を上書きできません。変更を行った後、ユーザーがチェックインで戻してリリースすると、再び他のユーザーが編集できます。

子コンポーネント

親コンポーネント内にあるコンポーネント。たとえば、ボックス・レイアウト・コンポーネント内に含まれるタスク・フローは、ボックスの子コンポーネントです。

「ボックス・レイアウト・コンポーネント」と「親コンポーネント」も参照してください。

クロム

処理のアクセス・ポイントを提供するポートレットやタスク・フローを囲む視覚的要素。たとえば、「処理」メニュー上のものや、クロム自体内に埋め込まれたもの(最小化アイコンやサイズ変更ハンドルなど)があります。

CMIS

Content Management Interoperability Services(CMIS)標準により、アプリケーションが1つ以上のコンテンツ管理リポジトリまたはシステムと連携するために使用できるRestful AtomPubバインディング、ドメイン・モデルおよびWebサービスを定義します。

コンポーネント

アプリケーションの個々の部品。たとえば、タスク・フロー、ポートレット、ページまたはレイアウト要素(ボックスやイメージなど)。

コンポーネント・カタログ

Composerからアクセスするダイアログ。WebCenter Portalアプリケーション・ページに追加できるすべてのコンテンツへのアクセスを提供します。

コンポーネント開発者

コンポーネント(ポートレット、JavaServer Facesコンポーネント、Webサービスなど)を構築する開発者。

コンポーネント・プロパティ

Composerからアクセスするダイアログ。コンポーネントのパラメータ、表示オプション、子コンポーネント、スタイル設定および関連イベントへのアクセスを提供します。

コネクション

ピープル・コネクション・サービスにおいて、他のアプリケーション・ユーザーとのソーシャル・ネットワークを確立する機能。

Composer

ポータル・ページの移入、改訂および構成を行うためにシームレスに統合された環境。ユーザーはページ・レイアウトやコンテンツを簡単に構築または改訂できます。また、タスク・フロー、ポートレット、コンテンツおよびその他のオブジェクトなどの様々なコンポーネントをページに追加し、これらのコンポーネントをリンクして、より関連性のある情報ビューやパーソナライズされた情報ビューを実現する手段が提供されます。

コンテナ

コンポーネントとして知られるプログラム構成要素が実行されるアプリケーション・プログラムまたはサブシステム。

コンテナ・ランタイム・オプション

ポートレット・コンテナの動作をカスタマイズすることによりランタイム環境をカスタマイズできるJSR 286機能。

コンテンツ統合サービス

データ・コントロールを作成するなどにより、開発者がコンテンツ・リポジトリからコンテンツを表示できるようにするために、Oracle WebCenter Portalで提供されるサービス。

コンテンツ・プレゼンタ

ドキュメント・サービスの機能。これによって、エンド・ユーザーがコンテンツ・アイテムを検索および選択し、利用可能な表示テンプレートを使用してこれらのアイテムを表示できます。Oracle WebCenter Portalでは、ページに単一および複数のコンテンツ・アイテムを表示するために即時利用可能なテンプレートが用意されています。Frameworkアプリケーションに表示するコンテンツのためのカスタム・テンプレートや、実行時にエンド・ユーザーが選択するためのカスタム・テンプレートも定義できます。

コンテンツ・リポジトリ

作成者ベースのバージョニング、全文検索、コンテンツのカテゴリ化および属性などの機能を実現する専用ストレージと管理メカニズム。コンテンツ・リポジトリは構造化されていない情報の格納用に最適化されており、データ・リポジトリと区別されます。

コンテンツ・リポジトリのデータ・コントロール

コンテンツ・リポジトリを介して供給されるデータ・コントロール。Frameworkアプリケーションでは、Oracle Portal、Oracle WebCenter Content、Javaコンテンツ・リポジトリ(JCR)標準をサポートするサードパーティ製リポジトリ、およびローカル・ファイル・システムのコンテンツ・リポジトリ用に、コンテンツ・リポジトリのデータ・コントロールを作成できます。

資格証明プロビジョニング・ページ

外部アプリケーションに対する認証に使用されるJSF(*.jspx)ページ。実行時に、資格証明プロビジョニング・ページには、外部アプリケーション登録で指定されたデータ・フィールドからなるログイン・データ・フィールドが表示されます。ログイン情報はプロデューサに渡されてから、ログイン値を外部アプリケーションに渡します。アプリケーションは、リクエストされたポートレットをプロデューサに渡します。

認証後、ユーザーのログイン資格証明は資格証明ストアに保存され、それ以降のセッションではその情報が提供されます。情報が変更されないかぎり、ユーザーは資格証明を一度のみ渡します。

資格証明ストア

その関連付けられたドメイン用にログイン資格証明を格納する場所を用意します。また、ユーザーが外部アプリケーションに対する認証のために提供するログイン資格証明を保存します。資格証明ストアは通常、単一の論理ストアとしてポリシー・ストアと結合されます。

資格証明ストアに格納された資格証明は、後続のログイン時に認証のために使用されますが、このストアの主要な機能は、これらのアカウントの認可を提供することです。

CSS

Cascading Style Sheet。一貫したルック・アンド・フィールを保証したり、フォント、色および間隔調整などのスタイルをWebドキュメントに追加するための簡単なメカニズム。

カスタム・アクション

タスク・フローを囲むShow Detail Frameコンポーネントの「処理」メニュー上またはヘッダー上でレンダリングされるアイコンまたはメニュー・アイテム。カスタム・アクションでは、作成時にタスク・フローで定義されたアクションを表すことができます。たとえば、設計時に、開発者はカスタム・パーソナライズ設定でタスク・フローを作成できます。実行時に、ユーザーは、タスク・フローの周りのクロム(またはShow Detail Frame)に表示される「処理」メニュー・アイテムまたはアイコンを介してこれらの設定にアクセスできます。

カスタム属性

Spacesアプリケーションのカスタム属性では、組込み属性によって提供される情報に加えて、情報が指定されます。カスタム属性を使用すると、渡されるパラメータに基づいて、スペースでコンポーネントのコンテンツを決定できます。たとえば、顧客IDを渡すことで、特定の顧客のデータをコンポーネントで表示できます。カスタム属性は単純に名前と値のペアであり、たとえば、customerId=400、orderId=11、userName=Smithなどです。カスタム属性はスペース・テンプレート内に格納されます。

カスタム・ページ

出荷時に標準装備しているものではなく、ユーザーが作成したページ。

コンテンツ表示テンプレート

コンテンツ・プレゼンタ表示テンプレートは、コンテンツ・プレゼンタがFrameworkアプリケーション・ページでコンテンツ・アイテムをレンダリングする方法を定義するJSFFファイル(JSFページ・フラグメント)です。WebCenter Portalにはデフォルトの表示テンプレートがいくつか装備されており、これらを使用してすぐに作業を開始したり、独自のテンプレートを作成できます。

カスタム・リソース・カタログ

特定のユーザーに表示できるコンポーネントを制御するためにカスタマイズされたリソース・カタログ。

デフォルト・リソース・カタログと対比してください。

カスタム・ロール

特定のホーム・スペースまたはスペース要件を満たすために管理者またはスペース進行役が作成したユーザー・ロール。

カスタマイズ・モード

すべてのユーザーのポートレット・プリファレンス用にデフォルト値をユーザーが設定できるポートレット・モード。

カスタマイズ可能コンポーネント

実行時にページに追加できるWebCenter Portalコンポーネント。これにより、エンド・ユーザーは、これらのコンポーネント内のコンテンツに対して、移動、最小化、リストアまたは削除などのパーソナライズを実行できます。カスタマイズ可能コンポーネントは、Panel CustomizableコンポーネントとShow Detail Frameコンポーネントです。

データ・コントロール

ビジネス・サービスのデータ・モデルの抽象化を提供するメカニズム。クライアントおよびWebアプリケーション・コントローラがデータ・オブジェクト、コレクション、メソッドおよび操作にアクセスする一貫したメカニズムをADFデータ・コントロールは提供します。

デフォルト言語(アプリケーションレベル)

Spaces管理者が指定する表示言語。ユーザーがSpacesアプリケーションにログインするときに使用されます。Spaces管理者は、「管理」ページの「一般」タブでアプリケーションレベルのデフォルト言語を設定します。個々のユーザーは、「プリファレンス」ダイアログの「一般」タブで独自のユーザーレベルのデフォルト言語を設定できます。

デフォルト言語(ユーザー・プリファレンス)

ユーザー指定の表示言語。ユーザーがSpacesアプリケーションにログインするときにレンダリングされます。ユーザーが別のデフォルト言語を指定するまで、この言語の選択が持続します。セッション言語によって上書きできますが、セッションCookieが消去されるか期限切れになるとデフォルト値に戻ります。この値は「プリファレンス」ダイアログの「一般」タブで設定されます。

デフォルト・リソース・カタログ

アプリケーションに対してデフォルトで提供されるリソース・カタログ。これには、アプリケーションに使用可能なOracle ADFコンポーネントおよびポートレットがすべて含まれます。

カスタム・リソース・カタログと対比してください。

デフォルト・サーバー

「統合WLS」を参照してください。

委任管理

ユーザー・ロールに基づいてポータル・リソースを保護するメカニズムを提供します。委任管理をページ階層に適用すると、特定のセキュリティ割当てがページとサブページの階層に自動的に伝播されます。

デプロイメント・プロファイル

アプリケーション・デプロイメントで使用されるファイル。次のタイプの情報を指定します。

- パッケージ化されるソース・ファイル、デプロイメント・ディスクリプタ、その他の補助ファイル

- 作成するアーカイブ・ファイルのタイプおよび名前

- 依存性情報

- プラットフォーム固有の指示

- その他の情報

Oracle WebCenter Portalサービスには、特別なデプロイメント・プロファイル、FrameworkアプリケーションのWARデプロイメント・プロファイルが用意されており、これにはプロジェクト・メタデータをエクスポートするオプションが含まれます。

デザイン・ビュー(JDeveloper)

Oracle JDeveloperにおけるビュー。ファイルのWYSIWYG表現を提供します。

「ソース・ビュー(JDeveloper)」も参照してください。

デザイン・ビュー(Spaces)

Composerにおけるビュー。ページとそのコンポーネントのWYSIWYG表現を提供します。

「ソース・ビュー(Spaces)」も参照してください。

検出可能なスペース

検索などを介して、Spacesアプリケーションにログインしたユーザーが検出できるスペース。パブリックやプライベートのスペースはすべて検出可能です。「表示」リストから「すべてのスペース」を選択した場合、検出可能なスペースが「スペース」ページにリストされます。スペース参加を望むユーザーは、セルフサービス(有効になっている場合)を使用するかスペース進行役に連絡して、メンバーシップをリクエストできます。

ディスカッション・サービス

ディスカッション・フォーラムの作成と参加の手段を提供するWebCenter Portalサービス。

表示言語

ボタン、フィールド・ラベルおよび画面テキストなどのアプリケーション・ユーザー・インタフェース要素をブラウザでレンダリングする際に言語を制御します。Frameworkアプリケーション表示言語設定の優先順位は、弱いものから強いものの順に、ブラウザ設定、アプリケーション設定、ユーザー・プリファレンス設定、セッション設定、スペース設定です。

ドキュメント・ページ

コンテンツを管理するためのドキュメント・マネージャのタスク・フローを含む、すべてのSpacesグループおよびホーム・スペースに提供される事前定義済ページ。

ドキュメント・サービス

ページでフォルダとファイルを表示するために様々なフォーマットを備えた複数のタスク・フローを提供するWebCenter Portalサービス。アプリケーションに適したタスク・フローを選択すると、フォルダとファイルへのアクセス、追加および管理を行う機能を提供できます。それらは、ファイルとフォルダのプロパティを構成および表示する機能、および接続されたコンテンツ・リポジトリでファイルとフォルダのコンテンツを検索する機能です。

ドメイン

ドメイン・ネーム・システム(DNS)ネームスペース内のツリーまたはサブツリー。ドメインは通常、共通の接尾辞(ドメイン名)をホスト名が共有するコンピュータのグループを指します。

動的生成ページ

検索やタグのクリックなどのユーザー・アクションの結果として表示されるページ。その名称が示すように、動的生成ページは保存されず、必要なときに作成されます。

EAR

Enterprise Archiveファイル。Java EEアプリケーション・サーバーでアプリケーションのデプロイに使用されるJava EEアーカイブ・ファイル。Frameworkアプリケーションは、アプリケーションと個々のランタイム・カスタマイズを含む汎用EARファイルと、アプリケーション・サーバーへのデプロイ用アプリケーションのみを含むターゲットEARファイルの両方を使用してデプロイされます。開発からテスト、テストから本番へアプリケーションを移行する際に発生する可能性のあるエラーを減らすことで、EARファイルはアプリケーションのデプロイメントを簡略化します。

「WAR」も参照してください。

ECMA-262仕様

ECMAScriptやJavaScriptなど、スクリプト・プログラミング言語の標準化。

ECMAScript

ECMA-262仕様に従いEcma Internationalによって標準化されたスクリプト・プログラミング言語。しばしばJavaScriptやJScriptと呼ばれ、どちらもECMA-262仕様を拡張したものです。

デフォルト編集モード

(JSR 286ポートレットのみ)。JSR 286ポートレットのパーソナライズを可能にするポートレット・モード。デフォルト編集モードは、JSR 286ポートレットのプロパティ用の表示モードです。Frameworkアプリケーションでは、デフォルト編集モードがポートレットの「処理」メニューに「カスタマイズ」コマンドとして表示されます。

「「編集」モード」も参照してください。

「編集」モード

ユーザーごと、インスタンスごとにポートレットのパーソナライズを可能にするポートレット・モード。

「デフォルト編集モード」も参照してください。

編集モード

ユーザーがコンテンツ、スタイルおよびページのレイアウトを変更できる表示モード。編集モードにアクセスするには、「ページ・アクション」メニューから「ページの編集」を選択します。

EL

式言語。Java EE Webコンテナにあるアプリケーション・データを取得および操作するための演算子を提供することにより、Webアプリケーション・データを処理する簡単な表記法。Frameworkアプリケーションでは、EL式は#{と}の文字で囲まれ、通常は#{object.data}の形式になり、objectは、Java EE Webコンテナのページ、リクエスト、セッションまたはアプリケーションの有効範囲にあるJavaオブジェクトまたはOracle ADFコンポーネントを表します。

Enterprise Archiveファイル

「EAR」を参照してください。

エンタープライズ・マッシュアップ

ユーザーがすべての種類のコンテンツとサービスを1つの場所にまとめることができるアプリケーション。

イベント・サービス

会議、予定などをスケジュールするためのカレンダを提供するWebCenter Portalサービス。Spacesアプリケーションでは、特定のスペースに関連するイベントを記録するカレンダを提供します。イベント・サービスをMicrosoft Exchange Serverと統合して、個々のユーザーがホーム・スペースの個人カレンダにアクセスすることもできます。個人カレンダは、Frameworkアプリケーションでも使用可能です。

有効期限ベースのキャッシュ

保持期間を使用してアイテムがキャッシュで有効である期間を指定するキャッシュ方法。この期間が経過すると、更新が必要になります。保持期間を経過してからアイテムに対するリクエストが発生したとき、キャッシュで更新されます。

「有効化ベースのキャッシュ」も参照してください。

式言語

「EL」を参照してください。

外部アプリケーション

シングル・サインオン・サーバーに認証を委任しないアプリケーション。かわりに、アプリケーション・ユーザーの名前とパスワードを要求するHTMLログイン・フォームが表示されます。最初のログイン時に、ユーザーは、これらの資格証明をシングル・サインオン・サーバーで取得するように選択できます。その後、これらのアプリケーションに透過的にログインされます。

ファーム

Fusion Middleware Controlによって管理されるコンポーネントの集合。ファームには、管理対象サーバー・ドメイン、およびそのドメインでインストール、構成および実行されるその他のOracle Fusion Middlewareシステム・コンポーネントを含めることができます。

お気に入り

Spacesアプリケーションおよび外部Webサイトのお気に入りページへのリンクの個人用リスト。

フェデレーテッド・ポータル・アダプタ

「FPA」を参照してください。

フィードバック

ピープル・コネクション・サービスにおいて、他のアプリケーション・ユーザーに関して非公式な評価を投稿したり取得する機能。

FPA

フェデレーテッド・ポータル・アダプタ。Oracle Portalのコンポーネント。Oracle PortalインスタンスがWebポートレット・インタフェースによりデータベース・ポートレットを共有できます。FPAを使用すると、PL/SQLポートレット、Portlet Builderポートレットおよびページ・ポートレットなどのOracle Portalデータベース・ポートレットを、Frameworkアプリケーションで使用できます。

Frameworkアプリケーション

Frameworkアプリケーションは、Oracle JDeveloperのWebCenter Portal拡張機能を使用してADFの上部に構築されます。このアプリケーションにより、Webコンテンツ、ポートレット、コンテンツ統合および共同サービスが、エンド・ユーザー向けに結合されます。開発者および管理者は、組織での役割やスキルのレベルに応じて、Frameworkアプリケーションを作成できます。

ポータルには、ページ階層、ナビゲーション・モデルおよび委任管理も含まれます。

Frameworkアプリケーション管理者

Frameworkアプリケーションの保守を担当する管理者。たとえば、Spacesの場合、管理者はFrameworkアプリケーションのブランド設定の実装、新規コンテンツの使用可能化、ページの変更、権限の付与および取消しなどの作業を実行します。

Fusion Middleware機能全体の管理権限を持つシステム管理者と対比してください。Fusion Middleware管理者は、Frameworkアプリケーションのデプロイ、設定および構成や、Fusion Middleware ControlによるFrameworkアプリケーションおよびその他のWebCenter Portalコンポーネントに対する進行中の管理タスクの実行も担当します。

Frameworkアプリケーション開発者

Oracle Application Development Framework、Oracle JDeveloperおよびOracle WebCenter Portalを使用して、Frameworkアプリケーションを計画、構築および保守する開発者。

Frameworkアプリケーション・エンド・ユーザー

Frameworkアプリケーションのランタイム・ユーザー。ページ、ポートレットおよびコンテンツにアクセスし、(適切な権限を持っている場合)ポートレットをパーソナライズします。

Frameworkアプリケーション・ライフ・サイクル

設計時環境でのFrameworkアプリケーションの作成とテスト、本番システムへのデプロイ、および定期的なメンテナンス(パフォーマンスの監視やカスタマイズ・データの移行など)のプロセス。アプリケーションのライフ・サイクルには、機能強化の実行、再ステージングおよび本番システムへのアプリケーションの再デプロイも含まれます。

Frameworkアプリケーション・テンプレート

サイト・ナビゲーション、ページ階層、委任管理、ページ・テンプレートなどのOracle WebCenter Portal: Framework機能が含まれているJDeveloperテンプレート。

「アプリケーション・テンプレート」と「ポートレット・プロデューサ・アプリケーション・テンプレート」も参照してください。

全画面モード(Spaces)

画面全体を占めるスペースを開いて、表示スペースを最大化する表示モード。サイドバーは全画面モードで表示されません。

全画面モード(ポートレット)

(PDK-Javaポートレットのみ)。他のポートレットとページを共有しているときに、ポートレットに表示できるコンテンツをより多く提供するポートレット・モード。

Fusion Middleware Control

Oracle WebCenterポータルをインストールする際にデプロイされるブラウザ・ベース型管理アプリケーション。Fusion Middleware Controlから、ファーム(Oracle WebCenter Portalなど)を監視および管理できます。

Fusion Order Demo(FOD)

「AviTrust Portal Demonstration for WebCenter Portal」を参照してください。

HA

高可用性。シングル・ポイント障害を排除してサービスの停止をゼロまたは最小限にすることにより、ビジネスの目的を達成するために必要な可用性をアプリケーションで満たすためのソリューションの集合。

ヘルプ・モード

ポートレットの機能に関する使用情報が表示されるポートレット・モード。

高可用性

「HA」を参照してください。

ホーム・スペース

個人用コンテンツの格納、ノートの記録、割当ての表示と対応、オンライン友人のリストの保守、および一意の作業日に関連する多数のその他のタスクの実行のために、各ユーザーにプライベート領域を提供するSpaces内の作業領域。ユーザーは、追加の個人用ページおよびカスタム・コンテンツを作成することで、この環境を拡張することもできます。

HTMLマークアップ・レイアウト・コンポーネント

Composerで利用可能なレイアウト・コンポーネント。ページでRaw HTMLとJavaScriptマークアップをインラインでレンダリングする単純なHTMLコンポーネント。

ハイパーリンク・レイアウト・コンポーネント

Composerで利用可能なレイアウト・コンポーネント。内外のWebページへのリンク。Frameworkアプリケーションの設計者にとって、これは実行リンク・コンポーネントと同等のランタイムです。

IDE

統合開発環境。エディタ、デバッガ、スクリーン・ペインタ、オブジェクト・ブラウザなどを含むビジュアル・アプリケーション開発ツール。Oracle JDeveloperはIDEの例です。

アイデンティティ伝播

Frameworkアプリケーションおよび関連するコンテンツ・リポジトリに対して、このオプションを選択すると、アプリケーションとプロセス全体において現在のユーザーのアイデンティティを伝播できます。伝播されたアイデンティティは受信者の側で検証され、ロール・ベースのアクセス制御の割当てなどの意思決定を下すために使用されます。

イメージ・レイアウト・コンポーネント

Composerで利用可能なレイアウト・コンポーネント。ハイパーリンクを含めることができる画像。Frameworkアプリケーションの設計者にとって、これはイメージ・リンク・コンポーネントと同等のランタイムです。

IMPサービス

「インスタント・メッセージおよびプレゼンス・サービス」を参照してください。

初期化パラメータ

標準JSR 286ポートレットの起動時に初期化されるパラメータ。初期化パラメータは、JNDI(Java Naming and Directory Interface)変数の代用です。JNDIのかわりに初期化パラメータを使用して、ポートレットの様々なコンポーネント(たとえば、サーブレットや他のポートレット)のすべての動作を互換性のある方法で構成します。Oracle WebCenter Portalでは、初期化パラメータはportlet.xmlファイルに入力されます。

インスタント・メッセージおよびプレゼンス・サービス

ユーザーが他の認証ユーザーのプレゼンス・ステータスを確認できたり、インスタント・メッセージやメールなどの対話オプションに簡単にアクセスできるWebCenter Portalサービス。

統合開発環境

「IDE」を参照してください。

統合WLS

統合WebLogicサーバー。Frameworkアプリケーションのデプロイをローカル・コンピュータで事前テストするためのプラットフォームとして使用されるWLSインスタンス。統合WLSには、事前構成のポートレット・プロデューサといくつかの有用な事前構築済ポートレットも含まれます。

反復開発

反復開発では、統合WebLogicサーバーでFrameworkアプリケーションを実行しながら、このアプリケーションに変更を加え、ブラウザの現在のページをリフレッシュするだけで、その変更の効果を確認できます。反復開発機能は、特定の最適化機能を無効にすることにより動作します。反復開発により、Frameworkアプリケーションの構築時に開発者がより迅速かつ効率的に作業できます。

JAAS

Java Authentication and Authorization Service(JAAS)は、アプリケーションによる認証およびユーザーに対するアクセス制御の実行を可能にするJavaパッケージです。JAASは、Java 2セキュリティを補完するために設計され、標準プラッガブル認証モジュール(PAM)フレームワークのJavaバージョンを実装します。これにより、アプリケーションは、認証サービスから独立した状態を維持でき、カスタム認証モジュールの使用をサポートします。

JAASは、Java 2セキュリティ・モデルのアクセス制御アーキテクチャを拡張し、サブジェクトベースの認証をサポートします。デプロイメント・ディスクリプタで、コードベースのセキュリティ設定に制限されるかわりに、宣言型セキュリティの設定もサポートします。

Java Authentication and Authorization Service

「JAAS」を参照してください。

Javaコンテンツ・リポジトリ

「JCR 1.0」を参照してください。

Java EE

Java EE 5としても知られています。Java Enterprise Edition 5プラットフォーム。複数層からなりサーバー中心の企業レベル・アプリケーションをアプリケーション開発者が開発、デプロイおよび管理できるプラットフォーム。Java EEプラットフォームは、複数層からなる分散アプリケーション・モデル、統合されたXMLベースのデータ交換、統合セキュリティ・モデルおよび柔軟なトランザクション制御を提供します。独自のJava EEポートレットを構築し、Webプロデューサを介して公開できます。

Java Enterprise Edition 5プラットフォーム

「Java EE」を参照してください。

Javaポートレット仕様

ポータル・サーバー用コンポーネントの開発方法の標準化。この仕様は、一般的なポートレットAPIと、パーソナライズ、プレゼンテーションおよびセキュリティの機能を提供するインフラストラクチャを定義します。このAPIを使用し仕様に準拠するポートレットは、製品にとらわれず、仕様に準拠するどのポータル製品にもデプロイできます。「JSR 286」も参照してください。

Java Specification Request

「JSR 286」を参照してください。

JavaServer Faces

「JSF」を参照してください。

JavaServer Page

「JSP」を参照してください。

JCR 1.0

Java Content Repository 1.0。JSR 170としても知られています。データベースに対するJDBCと同様に、コンテンツ・リポジトリの標準アクセスおよび対話APIが提案されています。

JDeveloper

「Oracle JDeveloper」を参照してください。

JSF

JavaServer Faces。Webアプリケーションを作成するための標準Javaフレームワーク。コンポーネント中心の手法を提供することで、Java Webユーザー・インタフェースの開発が簡略化されます。JSFは、プログラミングの柔軟性をもたらし豊富で堅牢なAPIを提供し、Model-View-Controller(MVC)設計パターンをアーキテクチャに統合することで、高い保守性でアプリケーションが適切に設計されます。JSFはJavaコミュニティ・プロセスで開発されたJava標準なので、Oracle JDeveloperのような開発ツールが十分に強化され、操作が容易で、ビジュアルで生産的なJSF開発環境を実現します。

JSF JSP

JavaServer Faces JavaServer Page。JSF JSPは、ユーザー・インタフェースにOracle ADF Facesコンポーネントをサポートし、ページ・ナビゲーションにはJSFテクノロジをサポートする点で、プレーンJSPとは異なります。JSF JSPページにより、ページのコンポーネントのADFモデル・バインディング機能を使用することで、Oracle Application Development Framework(Oracle ADF)の利点が活用されます。

JSP

JavaServer Page。簡単なプログラムによるインタフェースをWebページに提供するサーブレット拡張機能。JSPは、Webやアプリケーション・サーバーで実行される埋込みJavaコードと特殊なタグが含まれたHTMLページです。JSPによりHTMLページに動的機能が付与されます。最初にリクエストされたときに実際にサーブレットにコンパイルされ、サーブレット・コンテナで稼働します。

「JSPタグ」も参照してください。

JSPタグ

JSPに埋め込んでJavaコードを囲むことができるタグ。これらのタグでは<jsp:構文が使用され、JSPのアクション要素はXML要素と同様にbeginタグとendタグで囲まれます。

JSR 286

Java Specification Request (JSR) 286。Javaを使用して標準ベースのポートレットを構築するために一連のAPIが定義されています。この仕様に準拠して構築されたポートレットは、ポータルにローカルにレンダリングしたりWSRPコンテナにデプロイして、ポートレットをリモートでレンダリングできます。詳細は、http://jcp.org/en/jsr/detail?id=286を参照してください。

JSR 170

「JCR 1.0」を参照してください。

JSR 329

「Oracle JSF Portlet Bridge」を参照してください。

キーストア

使用可能な公開鍵および秘密鍵の情報を提供するファイル。それらの鍵は、認証とデータ整合性のために使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、キーストアにセキュアに格納されます。

レイアウト・ボックス

Spacesアプリケーションで作成されたページにコンテンツを配置できるコンテナ。

レイアウト・コンポーネント

指定ページの有用性と外観を強化するためのオブジェクト。レイアウト・コンポーネントには、レイアウト・ボックス、リッチ・テキスト・エディタ、イメージ、ハイパーリンクなどが含まれます。

Layout Customizableコンポーネント

コンポーザ・タグ・ライブラリに用意されているコンポーネント。これによって、ユーザーは一連の事前定義済レイアウト(2列、3列、2行など)から選択しページに適用できます。ユーザーはこのレイアウトをページの特定領域にもページ全体にも適用できます。

LDAP

Lightweight Directory Access Protocol。標準的で拡張可能なディレクトリ・アクセス・プロトコル。LDAPクライアントとサーバーが通信で使用する共通言語です。業界標準のディレクトリ製品(Oracle Internet Directoryなど)をサポートする設計規則のフレームワーク。

ライフ・サイクル

「Frameworkアプリケーション・ライフ・サイクル」を参照してください。

Lightweight Directory Access Protocol(LDAP)

「LDAP」を参照してください。

リンク・サービス

2つのオブジェクト間で双方向の関連付けを作成することで、これらのオブジェクト間で簡単なアクセスを設定する手段を提供するWebCenter Portalサービス。

リスト・サービス

実行時にリストを作成してから公開してアプリケーション・ページに配置する手段を提供するWebCenter Portalサービス。実行時にリソース・カタログで使用可能なリスト・タスク・フローは設計時に作成できます。実行時、ユーザーはタスク・フローをカタログからページに追加し、そのタスク・フローを使用してリストを作成できます。

リスト・ページ

スペースの現在のリストを表示する事前定義済ページ。

ルック・アンド・フィール

ルック・アンド・フィールにより、ポータル・ページで要素の配置や動作からポートレット・タイトル・バーで使用される色に至るまで、アプリケーションの外観が決定されます。ルック・アンド・フィールは、スキン、ナビゲーション、ページ・テンプレート、レイアウト、コンテンツ表示テンプレートおよびその他の同様のコンポーネントによって決定されます。

メール・サービス

アプリケーションで使い慣れたメール機能を公開するためのWebCenter Portalサービス。

管理対象サーバー

本番環境では、管理対象サーバーによりアプリケーションおよびこれらのアプリケーションに必要なリソースがホストされます。ドメインは、Oracle WebLogic Serverリソースの論理的に関連付けられたグループであり、任意の数の管理対象サーバーが属することができます。管理サーバーではこれらのサーバーを管理します。

マッシュアップ

エンド・ユーザーが、様々なソースから情報を引き出して、個々の要件を正確に満たすパーソナライズ済アプリケーションを作成できるWebアプリケーション。

「エンタープライズ・マッシュアップ」も参照してください。

MBeanブラウザ

Fusion Middleware Controlでは、MBeanブラウザにより、管理者が、特定の監視タスクおよび構成タスクを実行し、Oracle WebLogic Serverまたは選択アプリケーションについてMBeansを参照できます。

MDS

Oracle Metadata Services。Application Development Frameworkのコア・テクノロジ。MDSは、メタデータを拡張可能でカスタマイズ可能な形で定義および使用するための統一アーキテクチャを提供します。

MDSリポジトリ

アプリケーション・サーバーであるとともに、メタデータが領域に保存されているOracleリレーショナル・データベース。これらの領域は、ファイルベースのリポジトリ、ディクショナリ表(組込み関数からアクセス)およびメタデータ・レジストリです。MDSの主な用途の1つは、Oracleアプリケーションのカスタマイズおよび永続的なパーソナライズを格納することです。

メッセージ・ボード

ピープル・コネクション・サービスにおいて、他のアプリケーション・ユーザーにメッセージを投稿したりメッセージを受信する機能。

メタデータ

タイトル、作成者、セキュリティ・グループなど、コンテンツ・アイテムに関する情報。メタデータは、コンテンツ・アイテムを記述、検索およびグループ化するために使用されます。コンテンツ情報とも呼ばれます。

Model-View-Controller

「MVC」を参照してください。

進行役

特定のスペースを管理する責任を持つSpacesユーザー。スペース進行役は、メンバーの追加と削除、新しいメンバーの招待、自己登録の有効化、スペース・メタデータの提供と更新、およびスペースで利用できるサービスの管理を実行できます。

Movable Boxレイアウト・コンポーネント

Composerで利用可能なレイアウト・コンポーネント。Spacesアプリケーションで作成されたページにコンテンツを配置できるコンテナ。Movable Boxは、そのコンテンツとともに、ページで移動できます。Frameworkアプリケーションの設計者にとって、これはShow Detail Frameコンポーネントと同等のランタイムです。

MVC

Model-View-Controller。多くの場合、同じデータの複数のビューを保持する機能を必要とするアプリケーションによって使用される標準的な設計パターン。MVCパターンを使用するには、データを保持するモデル、データのすべてまたは一部を表示するビュー、モデルまたはビューに影響するイベントを処理するコントローラという3つのカテゴリのいずれかにオブジェクトを整然と分類することが重要です。この分類により、複数のビューおよびコントローラが同じモデルとインタフェースをとることができます。ポートレットなど、以前は存在しなかった新しいタイプのビューおよびコントローラでも、モデルの設計を変更せずにモデルとインタフェースをとることができます。

マイ・スペース・ページ

現在ログインしているユーザーが使用できるすべてのスペースのリストを表示する事前定義済ページ。ユーザーは、「表示」メニューから選択して、「すべてのスペース」、ユーザーがメンバーであるスペースのみ(「本人による参加」)またはユーザーが進行役であるスペースのみ(「本人によるモデレート」)を表示できます。

ナビゲーション

WebCenter Portalには、ポータル・ナビゲーションを作成する3つのナビゲーション・コンポーネントが用意されています。これらのコンポーネントは、ブレッドクラム・ナビゲーション、メニュー・ナビゲーションおよびツリー・ナビゲーションです。

ナビゲーション・モデル

ナビゲーション・モデルは、ナビゲーション・ユーザー・インタフェースにデータを提供し、アプリケーションのリソース(ページ、ページ階層、タスク・フロー、外部サイト、ポートレットおよびその他のエンティティ)へのナビゲーションを可能にします。設計時と実行時の両方でナビゲーション・モデルを構成できます。

ノート・サービス

個人的なノートやアラームを書き込む際に役立つ機能を提供するWebCenter Portalサービス。このサービスは、Spacesでのみ使用でき、Frameworkアプリケーションでは使用できません。

通知サービス

電話、メール、ワークリストなどの異なるメッセージ・チャネルにより通知をトリガーする自動的な手段を提供するWebCenter Portalサービス。サブスクライブしているスペースおよびアプリケーション・オブジェクトが変更されると、メッセージがトリガーされます。

Oracle ADF

Oracle Application Development Framework。Java EEアプリケーション開発を迅速にして容易にするための一連のテクノロジ。同時に、検証済のソフトウェア・パターンを利用して、開発されたアプリケーションがスケーラブルで、パフォーマンスが高いことなどを確認します。

OAM

「Oracle Access Manager(OAM)」を参照してください。

OHS

「Oracle HTTP Server(OHS)」を参照してください。

OmniPortlet

Oracle WebCenter Portalのコンポーネント。ポートレット、コンテンツ統合、カスタマイズなどのポータル類似機能をOracle ADF Facesアプリケーションに挿入できます。

Oracle Access Manager(OAM)

アイデンティティ管理とセキュリティにおいてオラクル社のエンタープライズ・クラス製品スイートの一部であるOracle Access Managerは、SpacesおよびFrameworkアプリケーションでいくつかのシングル・サインオン・オプションを含めて、広範なアイデンティティ管理とセキュリティ機能を提供します。OAMは、Oracle WebCenter Portal 11gインストールの推奨シングル・サインオン・ソリューションです。

Oracle ADF Faces

オラクル社のOracle ADF Facesは、新しいJavaServer Faces JSR (JSR 127)に基づいたユーザー・インタフェース・コンポーネントを豊富に揃えたセットです。Oracle ADF Facesには、データ表、階層型の表、カラー・ピッカーおよび日付ピッカーなどの組込み機能を持つ各種ユーザー・インタフェース・コンポーネントが用意されており、これらはアプリケーションでカスタマイズや再利用ができます。

Oracle WebCenter Content: Content Server

チェックインとチェックアウト、リビジョン管理、およびWeb対応フォーマットでの自動公開で、セキュアなビジネス・ライブラリを構築するためのコンテンツ・リポジトリ。権限のあるユーザーは、現在の情報をいつでも、どこでも使用できます。

Oracle WebCenter: Content ServerはOracle WebCenter Contentのコンポーネントです。

Oracle WebCenter Portalのディスカッション・サーバー

ディスカッションおよびお知らせサービスのバックエンド・ディスカッション・サーバー。

Oracle Enterprise Manager

管理者がOracle Fusion Middlewareのサービスを単一の環境で管理できるコンポーネント。Fusion Middleware管理者はEnterprise Managerを使用して、Frameworkアプリケーションを構成、管理および監視します。

Oracle HTTP Server(OHS)

Hypertext Transfer Protocol(HTTP)を使用するWebトランザクションを処理するソフトウェア。OracleではApache Groupが開発したHTTPソフトウェアを使用します。

Oracle Internet Directory

OracleのLDAP V3準拠LDAPサーバー。ユーザーおよびグループをプロビジョニングするためのリポジトリとして使用されます。デフォルトでは、分散しているユーザーおよびネットワーク・リソースに関するOracle Internet Directory情報に対して、Oracle Single Sign-On(OSSO)がユーザー資格証明を認証します。Oracle Internet Directoryによって、LDAPバージョン3に、Oracleデータベースの高度なパフォーマンス、スケーラビリティ、堅牢性および可用性が取り込まれます。

Oracle JDeveloper

Oracle JDeveloperは、Java、XMLおよびSQLの最新の業界標準を使用してアプリケーションやWebサービスを作成するための統合開発環境(IDE)です。開発者はOracle JDeveloperを使用して、Javaポートレットを作成できます。

Oracle JSF Portlet Bridge

Oracle JSF Portlet Bridgeでは、JSR 329に基づきかつ準拠して、アプリケーション開発者がJSFアプリケーションまたはタスク・フローをJSR 286ポートレットとして公開し、別のアプリケーションで利用できます。

Oracle Metadata Services

「MDS」を参照してください。

Oracle Portal

企業クラスのポータルを開発、デプロイ、管理および構成するために使用するコンポーネント。Oracle Portalにはポータル構築用のフレームワークとセルフサービスの公開機能が組み込まれており、ポータル内でアクセスされる情報の作成と管理ができます。

「Oracle WebLogic Portal」も参照してください。

Oracle Secure Enterprise Search(SES)

統合されたランキング結果を含む、パブリックでセキュアなデータに対して操作が容易な検索を提供します。Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。

Spacesアプリケーションで、WebCenter Portalの内部検索サービス・アダプタは、デフォルトの検索プラットフォームとして設定されています。ただし、大規模な実装では最適なパフォーマンスのためにOracle SESを使用するよう構成する必要があります。

Oracle Single Sign-On(OSSO)

ユーザーが単一のユーザー名とパスワードを使用して、Oracle Fusion Middleware製品群のすべての機能、および他のWebアプリケーションにログインできるコンポーネント。

Oracle WebCenter ContentのSite Studio

企業規模のWebサイトを設計、構築およびメンテナンスするために包括的なアプローチを実現する強力で柔軟なWeb開発アプリケーション・スイート。Site Studioでは、Oracle WebCenter Content: Content ServerをWebサイトのメイン・リポジトリとして使用します。

WebCenterでは、コンテンツ・プレゼンタとSite Studioを統合することで、Site Studioリージョン・テンプレートまたはカスタム・コンテンツ・プレゼンタ表示テンプレートで、Site Studioコントリビュータ・データ・ファイルの作成、アクセス、編集および表示ができます。

Oracle SOA Suite

Oracle Fusion Middlewareのミドルウェア・コンポーネント。Oracle SOA Suiteでは、サービスの作成、管理、およびSOAコンポジット・アプリケーションへのオーケストレーションができます。コンポジットにより、複数のテクノロジ・コンポーネントを1つのSOAコンポジット・アプリケーションに容易にアセンブルできます。Oracle SOA Suiteは異機種間インフラストラクチャに組み込まれ、企業は段階的にSOAを採用できます。

Oracle Technology Network

「OTN」を参照してください。

Oracle WebCenter Content

柔軟かつセキュアで一元化されたWebベース型リポジトリを提供します。これによって、コンテンツ・ライフサイクルのすべてのフェーズ(作成と承認から公開、検索、失効およびアーカイブや配置に至るまで)を管理します。コントリビュータが、ネイティブ・デスクトップ・アプリケーションからコンテンツを簡単に渡し、リッチ・ライブラリ・サービスによりビジネス・コンテンツを効率的に管理し、Webブラウザを使用してどこからでもそのコンテンツにセキュアにアクセスできます。コンテンツ・タイプに関係なく、すべてのコンテンツが、管理、再利用およびアクセスのためにWebリポジトリまたはデータベースに保存されます。

Oracle WebCenter Portal

Oracle WebCenter Portalアプリケーションの構築を可能にする一連のサービス。Oracle WebCenter Portalではサービス指向アーキテクチャ(SOA)の概念を利用することで、必要なビジネス・コンポーネントをユーザーに提供するためにこれまで必要だった初期段階の労力が軽減されます。ユーザーが必要とするアプリケーションの構築を容易にする様々なプラグアンドプレイ製品、ツールおよびサービスが含まれています。Oracle WebCenter Portalには、次が含まれています。

- Oracle WebCenter Portalサービス

- Oracle WebCenter Portal: Framework

- コンテンツ統合サービス

- Oracle ADF

- Oracle Secure Enterprise Search(SES)

- Oracle WebCenter Portalのディスカッション・サーバー

- モバイル・サービス

- ポートレット・パック

Oracle WebCenter Portal: Framework

Oracle WebCenter Portalにより提供される機能のセット。追加の統合およびランタイム・カスタマイズのオプションを提供することで、Java Server Faces(JSF)環境が強化されます。これまでポータル製品に組み込まれていた機能(サイト・ナビゲーション、ページ階層、ポートレット、カスタマイズ機能、パーソナライズ機能および統合機能など)をJSF環境のファブリックに直接統合します。これによって、ユーザーの人為的な障壁が取り除かれ、コンテキスト・リッチなアプリケーションを開発するための基礎が提供されます。必要なOracle WebCenter Portalコンポーネントやサービスのみを選択してFrameworkアプリケーションに追加できます。

Oracle WebCenter Portalのページレット・プロデューサ

動的ページレットの開発を容易にする有用なツールと機能の集まりを提供します。

Oracle WebCenter Portalサービス

サービスを通じてソーシャル・ネットワーキング機能と個人の生産性機能を公開するWeb 2.0サービスの集まり。

- アクティビティ・グラフ

- お知らせサービス

- 分析サービス

- ディスカッション・サービス

- ドキュメント・サービス

- イベント・サービス

- インスタント・メッセージおよびプレゼンス・サービス

- リンク・サービス

- リスト・サービス

- メール・サービス

- ノート・サービス

- 通知サービス

- ピープル・コネクション・サービス

- WebCenter Portalのパーソナライズ

- 投票サービス

- 最近のアクティビティ・サービス

- RSSサービス

- 検索サービス

- タグ・サービス

- ワークリスト・サービス

Oracle WebCenter Portal: Spaces

JSF、Oracle ADF、WebCenter Portal: Framework、WebCenter Portal: ServicesおよびComposerを使用して構築されるWebCenter Portalアプリケーション。本番ドキュメントでは通常、Spacesアプリケーション(Spaces)とも呼ばれます。

Oracle WebLogic Server管理コンソール

WebLogic Serverドメインを管理するためのブラウザ・ベース型グラフィカル・ユーザー・インタフェース。次を行うために使用します。

- WebLogic Serverインスタンスの構成、起動および停止を行います。

- WebLogic Serverクラスタを構成します。

- WebLogic Serverサービス(データベース接続(JDBC)およびメッセージング(JMS)など)を構成します。

- セキュリティ・パラメータを構成します(ユーザー、グループおよびロールの作成および管理を含む)。

- アプリケーションを構成してデプロイします。

- サーバーとアプリケーションのパフォーマンスを監視します。

- サーバーとドメイン・ログ・ファイルを表示します。

- アプリケーション・デプロイメント・ディスクリプタを表示します。

- 選択したランタイム・アプリケーション・デプロイメント・ディスクリプタ要素を編集します。

OTN

Oracle Technology Network。オンラインのOracleテクニカル・コミュニティ。Oracleに基づくアプリケーションを構築するための多様な技術リソースが提供されています。OTNはhttp://www.oracle.com/technetworkでアクセスできます。

Oracle WebLogic Portal

WebLogic Portalでは、アプリケーションを統合するためのユーザー・インタフェースを用意できます。WebLogic Portalにより、異機種環境から収集したアプリケーション・データと機能を、統合され動的でカスタマイズ可能なWebベース型ポータル・ユーザー・インタフェースに表示すると同時に、複数のデバイスをサポートできます。強力なポータル・フレームワークとJ2EEセキュリティ基盤に加え、WebLogic Portalには、コンテンツ管理、コミュニティ、パーソナライズ、検索、ユーザー管理など、様々なビジネス・サービスが用意されています。WebLogic Portalは、外部コンテンツ管理システムを単一の管理インタフェースに結合できる仮想コンテンツ・リポジトリを提供します。これらの外部リソースのコンテンツを使用してポータルを構築できます。WebLogic Portalは、コンテンツを作成し管理するためのWLPコンテンツ・リポジトリも提供します。

Page Customizableコンポーネント

コンポーザ・タグ・ライブラリに用意されているコンポーネント。ページの編集可能な領域が実行時に定義されます。この領域内では、コンポーネントのプロパティの編集、ページへのコンテンツの追加、コンテンツの配置などができます。

ページ階層

ページを親子関係で関連付けるモデル。ここではどのページでも1ページ以上のサブページを含むことができます。この親子モデルはポータルの構造全体の定義に役立つだけでなく、セキュリティ・ポリシーをその親から子ページで継承することもできます。

ページ・パラメータ

ページに関連付けられているパラメータ。これを使用して値を保存し、ページ上のコンポーネントに渡すことができます。また、ページでそのURLを介して値を取ることもできます。ページ・パラメータは、PageDef.xmlの上部にある<parameter>タグを使用して定義されます。ページ・パラメータはページ変数にバインドできます。

ページ・プロパティ

Composerからアクセスするダイアログ。ページの表示オプション、セキュリティ設定およびパラメータへのアクセスを提供します。

ページ・スキーム

ページで使用する背景イメージを決めます。Spacesアプリケーションには、複数のデフォルト・ページ・スキームとカスタム・ページ・スキーム指定用オプションが用意されています。

ページ・スタイル

1列や2列など、初期ページ構造を決定します。一部のデフォルト・ページ・スタイルには、特定の目的に役立つタスク・フロー、コンポーネントおよびページ・プロパティも含まれています。たとえば、テキスト・ページ・スタイルを使用して作成されたページには、テキスト・レイアウト・コンポーネントが含まれています。

ページ・テンプレート

全ページにわたって共通にするビュー要素を指定できます。ページ・テンプレートのファイルとは、ADFレイアウト・コンポーネントやその他の要素を含むJSPXファイルです。一般に、ページ・テンプレートは、ヘッダー、フッターおよびコンテンツ領域によりページ・レイアウトを定義します。また、ページ・テンプレートでは通常、ページのナビゲーションUIの配置とスタイルを指定します。

ページ変数

パブリック・ポートレット・パラメータをページにバインドする変数。ページ変数は、PageDef.xmlの<variableIterator>内で定義されます。1つのページ変数を、複数のパブリック・ポートレット・パラメータにバインドできます。

Panel Customizableコンポーネント

コンポーザ・タグ・ライブラリで用意されているコンポーネント。実行時にカスタマイズできるOracle ADFコンポーネントおよびポートレットのグループに対し、コンテナ・リージョンが提供されます。Panel Customizableコンポーネントの子コンポーネントとして追加されたShow Detail Frameコンポーネントおよびポートレットは、Panel Customizableコンポーネントで移動や最大化ができます。

パラメータ

タスク・フロー・コンテンツのデフォルト動作を制御し、ページ・パラメータおよびページ定義変数へのタスク・フローの関連付けを容易にする変数。

親コンポーネント

他のコンポーネントを含むコンポーネント。タスク・フローを含むボックス・レイアウト・コンポーネントなどがあります。ボックスはタスク・フローの親コンポーネントです。対照的に、タスク・フローはボックスの子コンポーネントです。

「子コンポーネント」も参照してください。

参加者

スペースのコンテンツを操作できるSpacesユーザー。参加者は、ドキュメントのアップロードと共有、他のメンバーとのチャットの開始とチャットの参加、ディスカッション・トピックの作成、リストの新規作成や既存リストの表示ができます。

PDK-Java

Javaポータル開発キット。Oracle WebCenter PortalでWebコンテンツとアプリケーションを構築および統合するための開発用フレームワーク。ポータルの開発を簡略化する際に役立つツールキット、サンプルおよび技術記事が含まれています。既存のJavaサーブレット、JSP、URLでアクセス可能なコンテンツおよびWebサービスを使用して、それらをポートレットにできます。一般的に、外部の開発者とベンダーが、ポートレットとサービスを作成するために使用します。

ピープル・コネクション・サービス

ユーザーのエンタープライズ・コネクションのアクティビティを作成、連携および追跡するためのソーシャル・ネットワーキング・ツールを実現するWebCenter Portalサービス。

「アクティビティ・ストリーム」、「コネクション」、「フィードバック」、「メッセージ・ボード」および「プロファイル」も参照してください。

パーソナライズ

ユーザー・コンテキストに基づくアプリケーションの動作に対する動的な変更。WebCenter Portalのパーソナライズによって容易になります。

「アプリケーションのカスタマイズ」と「ユーザー・カスタマイズ」も参照してください。

WebCenter Portalのパーソナライズ

選択した条件に基づいて、アプリケーション内のコンテンツをターゲットのアプリケーション・ユーザーに配信できるWebCenter Portalサービス。WebCenter Portalのパーソナライズによって、動的なアプリケーション・フローを指定するための宣言手段も提供されます。

個人用ページ

ユーザーが自分のホーム・スペースに作成するページ。他のユーザーが個人用ページを参照できるのは、ページを作成したユーザーから明確にアクセス権を付与された場合のみです。

個人プロファイル

電子メール・アドレス、電話番号、勤務場所、部門、上司、直属の部下などユーザーの個人情報を表示するページ。

「プロファイル」も参照してください。

投票サービス

アプリケーションのページにオンライン投票を作成、編集および実施できるWebCenter Portalサービス。投票によって、関係者にアンケート(意見や経験レベルなど)を実施したり、重要な情報を覚えているかどうかを確認したり、プレゼンテーションの効果についてのフィードバックを収集できます。

ポータル

Webベース・アプリケーションとの対話および個々のユーザーまたはユーザーのクラスに関連する情報のパーソナライズされた単一ポイントを提供する共通インタフェース(つまり、Webページ)。

ポータル・アプリケーション・テンプレート

「アプリケーション・テンプレート」を参照してください。

ポータル開発キット

「PDK-Java」を参照してください。

ポートレット

多数の各種ソースからコンテンツを描画できる再利用可能なWebコンテンツ。ポートレットでは、他のWebサイトからの抜粋の表示、主要情報のサマリーの生成、検索の実行および多様なデータソースの情報を収集したコレクションへのアクセスなどを実行できます。様々なポートレットを共通のページに配置できるため、コンテンツが複数のソースから導出されている場合でも、ユーザーは単一のソースとして利用できます。ポートレット・リソースには、多数の利用できる構築済ポートレットや、WebCenterのJSR 286、PDK-Javaポートレット・ウィザード、その他のポートレット構築ツールで構築されたプログラム的なポートレットが含まれます。

ポートレット・イベント

ポートレットとユーザーの相互作用に直接関連しないアクションや状態の変更にポートレットが対応できるJSR 286機能。

ポートレット・フィルタ

ポートレットへのリクエストおよびポートレットからのレスポンスの両方で情報のオンザフライ変換ができるJSR 286機能。ポートレット・フィルタは、ポートレット・リクエストおよびポートレット・レスポンスのコンテンツを変換できる再利用可能なコード部分です。

ポートレット・モード

ポートレットをコールして情報を表示できる方法。これらの方法を次に示します。

- 共有画面モードまたは表示モード

- 「編集」モードまたはデフォルト編集モード

- カスタマイズ・モード

- ヘルプ・モード

- バージョン情報モード

- 全画面モード(ポートレット)または詳細ページ表示モード

ポートレット・プロデューサ・アプリケーション・テンプレート

ポートレット開発に必要な推奨プロジェクトおよびテクノロジ・スコープでアプリケーションを作成するために、JDeveloperに用意されているアプリケーション・テンプレート。ポートレット・プロデューサ・アプリケーション・テンプレートは、ポートレット作成用にスコープ設定された単一プロジェクト(ポートレット)で構成されます。

「Frameworkアプリケーション・テンプレート」と「プロデューサ」も参照してください。

事前定義済ページ

特定の機能を実行するためにSpacesアプリケーションで作成したページ。事前定義済ページの例として、「ようこそ」ページ、「検索」ページおよび「ドキュメント」ページなどがあります。

事前デプロイ・ツール

Frameworkアプリケーション用のユーティリティ。Oracle JDeveloperでアプリケーションに追加した新規プロデューサ登録により、ターゲット・システムの構成を支援します。このユーティリティは、アプリケーションをデプロイする前に実行する必要があります。デプロイ後に、たとえばカスタマイズをエクスポートおよびインポートする場合、メタデータをステージング環境から本番環境に移行するためにこのユーティリティを使用することもできます。また、このツールによりMDSリポジトリの場所を定義して、ランタイム・カスタマイズを移行できます。

pretty URL

ページのURLの短縮バージョン。実際のWebアドレスの複雑さが隠されます。

プライベート・パラメータ

ポートレット自身にのみ認識されていてポートレットが存在するページへの接続がないポートレット・パラメータ。

パブリック・パラメータと対比してください。

プロデューサ

ポートレット・コンシューマ(Frameworkアプリケーションやポータルなど)間の通信リンク。コンシューマ・アプリケーションでポートレットをレンダリングする際、そのポートレットのプロデューサをコールし、次にそのポートレットを実行して、その結果をポートレット・コンテンツの形で返します。1つのプロデューサには、1つ以上のポートレットを含むことができます。1つのポートレットは、1つのプロデューサにのみ含めることができます。

Oracle WebCenter Portalでは2つのタイプのプロデューサをサポートします。

- Oracle PDK-Javaプロデューサ: Java EEアプリケーション・サーバーにデプロイされます。これは多くの場合リモートであり、Simple Object Access Protocol(SOAP)によりHTTPを介して通信します。

- Web Services for Remote Portlets(WSRP): ユーザーを対象とした視覚的なWebサービスを、ポータルまたは他の中間WebアプリケーションにプラグアンドプレイできるようにするWebサービス標準。標準性により、WSRPで特定の言語(JSR 286、.NET、Perlなど)をベースとする標準対応コンテナと任意のWSRPポータル間の相互運用が可能です。WSRP対応のコンテナにデプロイされたポートレットは、その言語に関係なく、この標準をサポートするあらゆるアプリケーションでレンダリングできます。

プロファイル

ピープル・コネクション・サービスにおいて、自分自身に関する情報(連絡先、上司、直属の部下など)を表示および管理したり、他のアプリケーション・ユーザーに関してこの情報を表示する機能。

プログラム・ポートレット

APIを使用して非宣言型の形で構築されたポートレット。ハンド・コードまたは手動コードのポートレットとも呼ばれます。

パブリック・レンダラ・パラメータ

ポートレットがパラメータ値を共有することでポートレット通信を可能にするJSR 286機能。

パブリック・スペース

Spacesアプリケーションにログインしていないユーザーも含めてすべてのユーザーが利用可能なスペース。

パブリック・ページ

Spacesアプリケーション内のページ。Spacesアプリケーションにログインしていないユーザーも含めてすべてのユーザーが利用可能です。

パブリック・パラメータ

ページに認識されていてページ変数を介してバインドされるポートレット・パラメータ。

プライベート・パラメータと対比してください。

パブリック・ユーザー

WebCenter Portalアプリケーションにアクセスできるがログインできないユーザー。パブリック・ユーザーは、パブリックとして指定されたページを表示できますが、そのコンテンツをパーソナライズしたり編集することや、なんらかのアクセス制御があるページを表示できません。

認証されたユーザーと対比してください。

最近のアクティビティ・サービス

Frameworkアプリケーションの最近のアクティビティを追跡する手段を提供するWebCenter Portalサービス。

レシピ

類似度計算の重み付けリスト。それぞれの計算の重み付けによって、推奨の総合スコアに与える影響が変化します。推奨は、推奨スコアの合計によって順序付けされます。

サイズ変更ハンドル

タスク・フローの高さを増減させるタスク・フロー・クロムのユーザー・インタフェース要素。

リソース

ページ・テンプレート、スキン、タスク・フロー、ナビゲーションなど、ユーザーがリソース・マネージャで管理できるアイテム。Spacesでは、構造、外観とレイアウトおよびマッシュアップというカテゴリでリソースを分類します。

リソース・アクション処理フレームワーク

表示、検索、およびタグ付けの対象になるカスタム・リソースをサービスで公開できます。

リソース・カタログ

統合された検索および参照のユーザー・インタフェースに、本来であれば関連しない1つ以上のリポジトリの結合ビューが提供されるカタログ。リソースはソース・リポジトリで作成および公開され、JDeveloperのリソース・パレットの開発者とリソース・カタログ・ビューアのユーザーに公開されます。リソース・カタログには、レイアウト・コンポーネント、Oracle ADFコンポーネント、ポートレット、サービス・タスク・フロー、ドキュメントなどを含めることができます。

リソース索引

WebCenter Portal REST APIにアクセスするための開始点。GETリクエストをリソース索引URIに送信すると、使用可能なすべてのサービスに対するエントリ・ポイントへのリンクのリストが返されます。

リソース・マネージャ

適切な権限のあるユーザーは、アプリケーションのデプロイ後もポータルの開発を続行できます。リソース・マネージャを使用すると、ユーザーはランタイム・ポータル・リソースを(FrameworkアプリケーションまたはSpacesから)ダウンロードして、さらに開発するためにOracle JDeveloperにインポートすることもできます。さらにこれらのリソースをJDeveloperからエクスポートして、デプロイ済アプリケーションにアップロードして戻すこともできます。

リソース・タイプ

WebCenter Portal REST APIリンクが識別するリソースのタイプを定義します。リソース・タイプを使用して、GETリクエストのレスポンス本文およびPOSTとPUTの受入可能なリクエスト本文を決定します。また、resourceType属性をエンティティで使用して、これらのタイプを一意に識別します。

REST API

Oracle WebCenter Portalは、クライアントから動的にサーバー・データを取得および変更するために、一連のWebベース型REST(REpresentational State Transfer)APIを備えています。REST APIは、ディスカッション・サービス、ピープル・コネクション・サービスおよびSpacesアプリケーション(Spaces)で使用できます。

リバース・プロキシ・サーバー

サーバーを単一のパブリック・サイトとして公開することで、内部サーバーの物理的な場所を非表示にするサーバー・プロセス。パブリック・サイトへのリクエストは、該当する内部サーバーにルーティングされます。

ラウンドトリップ開発

ラウンドトリップ開発とは、メンテナンスや機能強化のために、デプロイされた実行時ポータルからJDeveloperにリソースを戻すことができる機能および技法です。リソースをJDeveloperで変更したら、リソース・マネージャを使用して、デプロイされたポータルにリソースをアップロードできます。WebCenter Portalのラウンドトリップ開発機能は、アプリケーション全体を再度デプロイすることなくポータル・リソースを変更する簡単で便利な方法を提供します。

RSSリーダー

Spacesアプリケーションに用意されているRSSリーダー。パブリック・ニュース・フィードが外部ソースからアプリケーション・ページに組み込まれます。このRSSリーダーは、Spacesでのみ使用でき、Frameworkアプリケーションでは使用できません。

RSSサービス

他のサービスからのコンテンツをニュース・フィードとして公開する手段を提供するWebCenter Portalサービス。RSSサービスでは、RSS 2.0とAtom 1.0の形式の両方をサポートしています。

検索サービス

アプリケーションで情報や人の検出ができユーザーが表示権限を付与されている結果のみを返すWebCenter Portalサービス。

Secure Enterprise Search

「Oracle Secure Enterprise Search(SES)」を参照してください。

セキュアなアプリケーション・ページ

ユーザーが作成したページで、パブリック・ユーザーが利用できないもの。

自己登録ページ

ユーザーがSpacesアプリケーションに登録し、アイデンティティ・ストア・ログイン・アカウントをユーザー自身で作成できる事前定義済ページ。管理者はこのページで特定の側面をカスタマイズできます。

自己サブスクリプション・ページ

ユーザーがスペースのメンバーになるように登録できる事前定義済ページ。進行役はこのページで特定の側面をカスタマイズできます。

サービスID

式言語において、特定のサービスを識別する文字列。たとえば、文字列のoracle.webcenter.collab.announcementはお知らせサービス用サービスIDです。

PDK-Javaプロデューサの一意な識別子。PDK-Javaを使用すると、単一のアダプタ・サーブレットの下に複数のプロデューサをデプロイできます。異なるプロデューサは固有の一意なサービスIDで識別されます。サービスIDが必要になるのは、URLエンドポイントにサービスIDまたはプロデューサ名が追加されていない場合のみです。

サービス指向アーキテクチャ

「SOA」を参照してください。

サーブレット

通常はWebサーバー上で実行されるJavaプログラム。Webサーバーの機能を拡張します。HTTPサーブレットは、クライアントのHTTPリクエストを受け取り、(データベースの問合せなどによって)動的コンテンツを生成し、HTTPレスポンスを返します。

セッション言語

ユーザーが指定する表示言語。セッションCookieの有効期間(ログオンからログオフまで)の間有効です。ユーザーがブラウザCookieをクリアすると、表示言語がユーザーレベルのデフォルト言語に戻ります。指定した場合、Spaces管理者が設定したアプリケーションレベルのデフォルト言語に戻ります。「ようこそ」ページからアクセス可能な「言語の変更」ポップアップでセッション言語を設定します。

共有画面モード

ポートレットの本体をレンダリングするポートレット・モード。他のポートレットを含むことができるページにポートレットを表示できます。各ポートレットには、少なくとも共有画面モードが必要です。

「表示モード」も参照してください。

Show Detail Frameコンポーネント

コンポーザ・タグ・ライブラリに用意されているコンポーネント。子コンポーネントの周りに境界線またはクロムがレンダリングされます。アクション・メニューを含むヘッダーを備えているため、子コンポーネントの表示をカスタマイズするユーザー・インタフェース(UI)コントロールとなります。ただし、子コンポーネントの表示をカスタマイズするには、Show Detail FrameコンポーネントをPanel Customizableコンポーネント内に含める必要があります。

詳細ページ表示モード

ポートレットをフル・ブラウザで表示するポートレット・モード。たとえば、ページ表示モードのポートレットでは、最近送信した経費報告書10件のみを表示するように制限できるのに対し、詳細ページ表示モードの同じポートレットでは、すべての送信を表示できます。

ページ表示モードと対比してください。

表示モード

ページ表示モードと詳細ページ表示モードを含むポートレット・モードのタイプ。

ページ表示モード

ブラウザ・ウィンドウで追加のポートレットやその他のオブジェクトにスペースを割けるように、小さいポートレット表示を行うポートレット・モード。たとえば、ページ表示モードのポートレットでは、最近送信した経費報告書10件のみを表示するように制限できるのに対し、詳細ページ表示モードの同じポートレットでは、すべての送信を表示できます。

詳細ページ表示モードと対比してください。

類似度計算

特定の基準に基づいて2つのオブジェクトの類似度を示す類似度スコア(ゼロから1までの数値)を提供するために、アクティビティ・グラフ・サービスによって使用されます。それぞれの計算の重み付けによって、推奨の総合スコアに与える影響が変化します。推奨は、推奨スコアの合計によって順序付けされます。

スキン

アプリケーション全体に対して1箇所に指定されるCSS 3.0構文に基づいたスタイルシート。各コンポーネントに対してスタイルシートを用意したり、各ページにスタイルシートを挿入するのではなく、アプリケーション全体に対して1つのスキンを作成できます。

SOA

サービス指向アーキテクチャ。アプリケーション・サービスの再利用の最大化を目的とした設計手法。

ソース・ビュー(JDeveloper)

Oracle JDeveloperにおけるビュー。ファイルのソース・コードを直接編集する方法を提供します。

ソース・ビュー(Spaces)

Oracle WebCenter PortalのComposerにおけるビュー。ページとそのコンポーネントの選択可能な構造的表現を実現します。

「デザイン・ビュー(Spaces)」も参照してください。

スペース

Spaces内の作業領域。対象分野または共通の目標を中心に編成し任意の人数の人々で構成されるグループをサポートします。

Spacesアプリケーション(Spaces)

ソーシャル・ネットワーキング、コミュニケーション、コラボレーションおよび個人の生産性のために最新テクノロジを提供するWebベース型アプリケーション。Spacesではサービスやアプリケーションを使用して、他のユーザーとの意見交換、個人的作業や仕事関連作業の記録、重要なアプリケーションとの対話、およびプロジェクトと関心事に集中するために必要なものがすべて結合され、すべてを単一の統合環境内で実現します。

スペース・アイコン

他のユーザーが識別と場所の確認をするのに役立つために、マイ・スペースの「スペース」ページでスペース名の横に表示されるイメージ

スペース・ロゴ

スペースの視覚的なアイデンティティを実現するために「ホーム・スペース」ページ上に表示されるイメージ。全画面モードでは、ページ上部のスペース名の横にもホーム・スペースのロゴが表示されます。

スペース・メンバー

スペースに参加しているユーザー。メンバーはスペースに追加したり招待できます。また、自己登録が有効な場合、メンバー自身がスペースにサブスクライブできます。

スペース所有者

最初にスペースを作成したユーザー。スペース所有者は自動的にスペースの進行役にもなります。

スペース・テンプレート

新規スペース作成の開始点。Spacesにはデフォルトのテンプレートがいくつか装備されており、これらですぐに作業を開始したり、既存のスペースをベースとして使用してカスタム・スペース・テンプレートを作成できます。

スペースの使用不可ページ

スペース・メンバーが一時的にオフラインになっているスペースを開こうとしたときに表示される事前定義済ページ。進行役はこのページをカスタマイズできます。

Spacesアプリケーション管理者

「管理者」を参照してください。

スペース・スイッチャ

3つの領域を表示するメニュー。「最近のスペース」は、最近アクセスしたスペースを最大10個リストし、その後に、現在のユーザーが直前にアクセスしたスペースを表示します。「マイ・スペース」は、現在のユーザーがアクセス権を持つすべてのスペースをアルファベット順にリストします。リンクのリストにより、メニューからホーム・スペース、Spacesブラウザ・ページおよび「スペースの作成」ダイアログに直接アクセスできます。

struts

MVCの設計パターンに基づくJavaサーブレット・アプリケーション用の開発フレームワーク。

スタイルのプロパティ

スキンCSSからのスタイル情報を上書きしてコンポーネント表示の特定インスタンスを設定するために使用されます。

タグ・サービス

ユーザーがアプリケーションのオブジェクトに独自の条件を適用して、個人的に意味のある条件を使用してこれらのオブジェクトを検索できるWebCenter Portalサービス。

タスク・フロー

ADF Controllerアクティビティ、制御フロー・ルール、およびユーザーがタスクを完了できるように作用するマネージドBeanのセットです。タスク・フローにより、モジュール単位でアプリケーションに制御フローが定義されます。アプリケーションを単一のJSFページ・フローとして表すかわりに、再利用可能なタスク・フローのコレクションに分割できます。

タスク・フロー・ヘッダー

タスク・フロー上部の領域。タスク・フローとやり取りするための様々なツールとタスク・フロー名が表示されます。

テンプレート

「スペース・テンプレート」、「アプリケーション・テンプレート」および「コンテンツ表示テンプレート」も参照してください。

テキスト・レイアウト・コンポーネント

Composerで利用可能なレイアウト・コンポーネント。静的ページ・テキストを提供するリッチ・テキスト・エディタ。Frameworkアプリケーションの設計者にとって、これはRich Text Editorコンポーネントと同等のランタイムです。

アクセス未許可ページ

アクセス権限のないユーザーがページを開こうとしたときに表示される事前定義済ページ。

URLパラメータ

「プライベート・パラメータ」を参照してください。

ユーザー・カスタマイズ

ユーザーの独自ワークスペースにのみ影響する変更。

「アプリケーションのカスタマイズ」と「パーソナライズ」も参照してください。

有効化ベースのキャッシュ

妥当性チェックを使用してキャッシュ・アイテムがまだ有効であるかどうかを確認するキャッシュ方法。

有効期限ベースのキャッシュと対比してください。

仮想コンテンツ・リポジトリ

仮想コンテンツ・リポジトリ(VCR)により、複数の異機種間コンテンツ・リポジトリを組み込むことができます。

参照者

スペースの情報を参照できるが、独自の情報を提供できないSpacesユーザー。

表示モード

(JSR 286ポートレットのみ)。他のポートレットを含むことができるページにJSR 286ポートレットを表示できるポートレット・モード。JSR 286ポートレットに必要なモードはこれのみです。

「共有画面モード」も参照してください。

WAR

Webアプリケーション・アーカイブ・ファイル。このファイルは、Java EEアプリケーション・サーバーへのアプリケーションのデプロイに使用されます。WARファイルは、アプリケーションの実行に必要なコンポーネントをすべて単一モジュールにカプセル化したものです。WARファイルには通常、アプリケーションのサーブレット、JSPおよびJSF JSPコンポーネントが含まれます。

「EAR」も参照してください。

Web 2.0

高度にインタラクティブなWebアプリケーションの構成ができるテクノロジ(Wiki、RSS、ブログなど)。

「Oracle WebCenter Portalサービス」も参照してください。

Webアプリケーション・アーカイブ・ファイル

「WAR」を参照してください。

Webクリッピング・ポートレット

WebアプリケーションをFrameworkアプリケーションと統合できるブラウザ・ベース宣言型ツール。Webアプリケーションの既存ユーザー・インタフェースを利用して迅速に統合できるように設計されています。Webクリッピング・ポートレットを*.jspxページにドラッグ・アンド・ドロップできます。

Webページ・レイアウト・コンポーネント

Composerで利用可能なレイアウト・コンポーネント。Spacesアプリケーションで作成された別のWebサイト、Wikiまたはブログをページのコンテキスト内に埋め込む手段。Frameworkアプリケーションの設計者にとって、これはInline Frameコンポーネントと同等のランタイムです。

Webサーバー

Webページを配信するプログラム。

Web Services for Remote Portlets

「WSRP」を参照してください。

WebCenter Portalアプリケーション

Oracle WebCenter Portal: FrameworkまたはOracle WebCenter Portal: Spacesに基づくWebCenter Portalアプリケーション。

Oracle JDeveloperのWebCenter Portal拡張機能

Oracle JDeveloperの更新ウィザードで使用可能な拡張機能。FrameworkアプリケーションをOracle JDeveloperで構築およびデプロイするために必要なライブラリ、テンプレート、ウィザードおよびダイアログがインストールされます。

WebCenter Portal: Framework

「Oracle WebCenter Portal: Framework」を参照してください。

WebCenter Portalシステム管理者

「管理者」を参照してください。

WebLogicサーバー

「WLS」を参照してください。

ようこそページ

2種類のようこそページがあります。

- パブリックのようこそページ: Spacesアプリケーションにログインする前にユーザーに表示される事前定義済ページ。

- 個人用のようこそページ: ユーザーを自分のホーム・スペースに案内する事前定義済ページ。

Wikiページ

HTMLまたは単純なマークアップ言語を使用してインプレース編集を提供するページ。十分な権限を持つユーザーは、Wikiコンテンツを追加、改訂および削除できます。

WLS

WebLogicサーバー。スケーラブルな企業向けJava Platform, Enterprise Edition(Java EE)アプリケーション・サーバー。WebLogic Serverインフラストラクチャは、様々なタイプの分散アプリケーションのデプロイをサポートしており、サービス指向アーキテクチャ(SOA)に基づいてアプリケーションを構築するための理想的な基盤となります。

「統合WLS」も参照してください。

WLST

WebLogicスクリプト・ツール。Oracle WebCenter PortalなどのOracle Fusion Middlewareコンポーネントを管理するためのコマンド・ライン・ツール。

ワークリスト・サービス

通知、アラート、および現在のユーザーに割り当てられているBPELタスクへのアクセスを提供するWebCenter Portalサービス。

WSRP

Web Services for Remote Portlets(WSRP)は、ユーザーを対象とした視覚的なWebサービスを、ポータルまたは他の中間WebアプリケーションにプラグアンドプレイできるようにするWebサービス標準です。標準性により、WSRPで特定の言語(JSR 286、.NET、Perlなど)をベースとする標準対応コンテナと任意のWSRPポータル間の相互運用が可能です。WSRP対応のコンテナにデプロイされたポートレットは、その言語に関係なく、この標準をサポートするあらゆるポータルでレンダリングできます。

XSL

eXtensible Stylesheet Language(XSL)は、スタイルシート内でXML文書の変換やレンダリングに使用される言語です。

索引

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W

A

アクセス・プロトコル, 1.3.4

アクティビティ・グラフ・エンジン

概要, 12.1

共同フィルタ・エンジン, 12.4

収集エンジン, 12.4

ランク・エンジン, 12.4

実行

スケジュール, 12.4.1

オンデマンド, 12.4.2

アクティビティ・グラフ・プロバイダ, 20.3.5

構成, 20.5.3

アクティビティ・グラフ・サービス

概要, 12.1

アクティビティ・グラフ・エンジン, 12.1, 12.4

アクティビティ・ランク, 12.7

構成, 12.3

理由文字列のカスタマイズ, 12.5

メタデータの削除, 12.6.4

メタデータのエクスポート, 12.6.1

プロバイダ構成のエクスポート, 12.6.2

メタデータのインポート, 12.6.3

Oracle SES, 12.7

データの準備, 12.4

前提条件, 12.3, 13.3

QRPP, 12.1

レシピ, 12.1

分析コレクタの登録, 13.5

スキーマのカスタマイズ, 12.6

類似度計算, 12.1

アクティビティ・ランク, 12.7 アクティビティ・ストリーム

アーカイブ, 18.4

addWorklistConnection(WLSTコマンド), 23.4.3.2 ADF(Application Development Framework), 1.2.2 ADFクライアントのStateトークン, A.4 ADFライブラリ, 1.3.2, 1.3.3 ADFセキュリティ

概要, 28.1

権限ベースの認可, 28.2.4

ロールマッピング・ベースの認可, 28.2.4

adf-config.xml, 1.3.5, A.4 Adminロール(WebLogic Server), 1.8 管理サーバー

「WebLogic Server管理コンソール」を参照

管理ツール

「Fusion Middleware Control」を参照

「Spaces管理ページ」を参照

「システムMBeanブラウザ」を参照

「WebLogic Scripting Tool(WLST)」を参照

「WebLogic Server管理コンソール」を参照

管理者ロール

Oracle WebCenterのディスカッションの権限付与, 14.11

ユーザーへの権限付与(Frameworkアプリケーション), 36.4.3.3

デフォルト以外のユーザーへの権限付与, 14.11

デフォルト・ユーザーからの取消し, 14.11.3

分析コレクタ

概要, 13.1.1

構成, 13.4

Frameworkアプリケーション用の登録, 13.5

分析サービス

概要, 13.1.1

接続の管理, 13

データのパーティション化, 13.10

前提条件, 13.3

データのパージ, 13.9

分析コレクタの登録, 13.5

タスク・フロー, 13.1.2

トラブルシューティング, 13.11

お知らせサービス

WebCenterサービス・ポートレット用の構成, 24.9.1.3

接続

アクティブ化, 14.4

作成, 14.3

削除, 14.6

管理, 14

変更, 14.5

パフォーマンスの問題およびアクション, 38.1.5.1 パフォーマンス・メトリック, 38.1.4.1 パフォーマンス・チューニング, A.4 トラブルシューティング, 14.12 anonymous-role(Frameworkアプリケーション), 36.4.4.3 アプリケーション・ロール(Frameworkアプリケーション)

エンタープライズ・グループへの割当て, 36.4.3.1

ユーザーへの割当て, 36.4.3.1

ロール割当ての変更, 36.4.3.2

作成, 36.4.4.1

カスタム・ロール, 36.4.2.1.2

削除, 36.4.4.5

権限の割当て, 36.4.4.2

権限, 36.4.2.2

ユーザーからの取消し, 36.4.3.4

authenticated-role(Frameworkアプリケーション), 36.4.4.4 認証方式(外部アプリケーション), 26.2.1 認証、RESTサービス, 27.7 自動ログイン(外部アプリケーション), 26.2.1

B

バックアップおよびリカバリ

概要, 39.4

WebCenterバックエンド・コンポーネント, 39.4

Basic認証

外部アプリケーション, 25.4.1.4.2

ページレット・プロデューサ・リソース, 25.4.1.4.2

基本認証方式, 26.2.1 ブログ・メトリック(分析タスク・フロー), 13.1.2 BPELサーバー

通知の構成, 19.2.1

Spacesワークフローの構成, 9.3

Spacesワークフローのホスト, 9.3

LDAPアイデンティティ・ストア, 23.3.2

接続の管理, 23.2

パフォーマンスの問題およびアクション, 38.1.5.2

パフォーマンス・メトリック, 38.1.4.2

前提条件, 23.3

シングル・サインオン, 23.3.2

ワークリスト・サービスの要件, 23.3.1

WS-Security, 23.3.2

C

CFE(共同フィルタ・エンジン), 12.4

チェンジ・センター, 1.13.2

チェックリスト

Spacesアプリケーションの管理, 3

WebCenter Portalアプリケーションの管理, 5

Frameworkアプリケーションの起動および実行, 4

Spacesアプリケーションの起動および実行, 2

CKEditor

WebCenterサービス・ポートレット, 24.9.3.1

CLIENT_STATE_MAX_TOKENS設定, A.4 クラスタ

分析コレクタの構成, 13.4

クラスタ構成, A.2

ディスカッション・サーバーの構成, 14.2.1.1

WebCenter Portalアプリケーションのデプロイ, 1.3.5

CMISプロバイダ, 20.3.5, 20.5.2 共同フィルタ・エンジン, 12.4 コマンドライン構成(WLST), 1.13.3 Composer, 1.2.3 コンポジット・アプリケーション, 1.2.11 圧縮、REST API, 27.6 同時実行性管理, A.4 構成ファイル

adf-config.xml, 1.3.5, A

connections.xml, 1.3.5, A

競合の処理, A.1.1

webcenter-config.xml, A, A.1.3, A.1.3

web.xml, A

接続

MDSリポジトリの構成, 10.1, 10.1.1

デプロイ後の管理

Frameworkアプリケーション, 6.3

Spacesアプリケーション, 6.2

分析の設定, 13 コンテンツ・リポジトリの設定, 11 ディスカッションおよびお知らせの設定, 14 イベントの設定, 15 インスタント・メッセージおよびプレゼンスの設定, 16 メールの設定, 17 ページレット・プロデューサの設定, 25 ポートレット・プロデューサの設定, 24 検索の設定, 22 ワークリストの設定, 23.2 connections.xml, 1.3.5, A.4 コンテンツ・プレゼンタ

パーソナライズの構成, 20.7

コンテンツ・リポジトリ

接続の概要, 11.1

アクティブな接続, 11.7

アクティブな接続の変更

Fusion Middleware Controlの使用, 11.7.1

WLSTの使用, 11.7.2

接続情報ファイル, 11.1 デフォルトの接続, 11.7 接続の削除

Fusion Middleware Controlの使用, 11.9.1

WLSTの使用, 11.9.2

ファイル・システム, 11.5 管理, 11 接続プロパティの管理(WebCenter Spaces)

Fusion Middleware Controlの使用, 11.10.1

WLSTの使用, 11.10.2

接続の変更

Fusion Middleware Controlの使用, 11.8.1

WLSTの使用, 11.8.2

Oracle Content Server, 11.2 Oracle Portal, 11.4 パフォーマンス・メトリック, 38.1.4.3 登録

Fusion Middleware Controlの使用, 11.6.2

WLSTの使用, 11.6.3

Content Server

アプリケーション・コンテンツのエクスポート, 39.1.3.9

スペース・ドキュメントのエクスポート, 39.1.7.3

アプリケーション・コンテンツのインポート, 39.1.3.10

スペース・ドキュメントのインポート, 39.1.7.4

createBPELConnection(WLSTコマンド), 23.4.2.2 createDiscussionForumConnection(WLSTコマンド), 14.3.2 createExtAppConnection(WLSTコマンド), 26.2.2 createIMPConnection(WLSTコマンド), 16.3.2 createJCRContentServerConnection(WLSTコマンド), 11.6.3 createJCRFileSystemConnection(WLSTコマンド), 11.6.3 createJCRPortalConnection(WLSTコマンド), 11.6.3 createJCRSharePointConnection(WLSTコマンド), 11.3.5 createMailConnection(WLSTコマンド), 17.4.2 createPersonalEventConnection(WLSTコマンド), 15.4.2 createSESConnection(WLSTコマンド), 22.4.1.2 資格証明マッピング(ページレット・プロデューサ), 25.4.1.4.2 資格証明プロビジョニング(外部アプリケーション)

概要, 26.1

パブリック資格証明, 26.2.1

共有資格証明, 26.2.1

CRUD API, A.4 カスタム管理対象サーバー, 1.3.1 カスタマイズ

移行, 7.1.7

MDSに格納, A.1.1

D

データ・ソース

選択, 7.1.6.2

グローバル, 7.1.6.2

ローカル, 7.1.6.2

データベース接続

概要, 10.1

作成, 10.1

データベース接続、変更(WebCenterリポジトリ), 10.1.2 deleteAGAction(WLSTコマンド), 12.6.4 deleteAGNodeClass(WLSTコマンド), 12.6.4 deleteAGProviderAssignment(WLSTコマンド), 12.6.4 deleteAGQRPPRegistration(WLSTコマンド), 12.6.4 deleteAGRankCalculation(WLSTコマンド), 12.6.4 deleteAGSimilarityCalculation(WLSTコマンド), 12.6.4 deleteAllAGMetadata(WLSTコマンド), 12.6.4 deleteConnection(WLSTコマンド), 11.9.2, 14.6.2, 15.7.2, 16.6.2, 17.7.2, 22.4.4.2, 23.4.5.2, 26.5.2 deleteDocumentsSpacesProperties(WLSTコマンド), 11.10.2 デプロイ

概要, 7.1.2

アプリケーション接続の確認, 7.4.2

データ・ソース接続の確認, 7.4.3

データ・ソースの選択, 7.1.6.2

EARファイル, 7.1.3

グローバル・データ・ソース, 7.1.6.2

ローカル・データ・ソース, 7.1.6.2

カスタマイズの移行, 7.1.7

デプロイ後の構成, 7.4

デプロイ後のセキュリティ構成, 7.4.1

Spaces, 1.11

WebCenter Portalアプリケーションのアンデプロイ, 7.2

Fusion Middleware Controlの使用, 7.1.6.4

JDeveloperの使用, 7.1.6.3

WLS管理コンソールの使用, 7.1.6.6

WLSTの使用, 7.1.6.5

WebCenter Portalアプリケーション, 7, 7.1, 7.1.6

WebLogic管理対象サーバー、作成, 7.1.4

WebLogic管理対象サーバー、プロビジョニング, 7.1.4

deregisterOOTBProducers(WLSTコマンド), 24.7.2 deregisterPDKJavaProducer(WLSTコマンド), 24.7.2 deregisterSampleProducers(WLSTコマンド), 24.7.2 deregisterWSRPProducer(WLSTコマンド), 24.7.2 デスクトップ統合

仮想ホスト, 31.6

診断ログ・ファイル, 1.3.7 ディスカッション・メトリック(分析タスク・フロー), 13.1.2 ディスカッション・サーバー

構成ファイル

データのエクスポート, 39.1.3.7

スペースのディスカッションのエクスポート, 39.1.7.1

デフォルト以外のユーザーへの管理者ロールの付与, 14.11

データのインポート, 39.1.3.8

スペースのディスカッションのインポート, 39.1.7.2

接続の管理, 14

パフォーマンス・メトリック, 38.1.4.1, 38.1.4.4

前提条件, 14.2

登録, 14.3

管理者ロールの取消し, 14.11.3

WS-Security, 14.2.3

ディスカッション・サービス

WebCenterサービス・ポートレット用の構成, 24.9.1.3

接続

アクティブ化, 14.4

作成, 14.3

削除, 14.6

管理, 14

変更, 14.5

パフォーマンスの問題およびアクション, 38.1.5.4 パフォーマンス・メトリック, 38.1.4.4 パフォーマンス・チューニング, A.4 権限(Frameworkアプリケーション), 36.4.2.2 トラブルシューティング, 14.12 使用状況レポート(分析), 13.1.2 配信リスト(WebCenter Spaces), 17.10.4 ドキュメント・メトリック(分析タスク・フロー), 13.1.2 ドキュメント・サービス

WebCenterサービス・ポートレット用の構成, 24.9.1.1

コンテンツ・リポジトリ, 11.1

スペース・コンテンツのエクスポート, 39.1.7.3

スペース・ドキュメントのインポート, 39.1.7.4

パフォーマンスの問題およびアクション, 38.1.5.3

パフォーマンス・メトリック, 38.1.4.3

使用状況レポート(分析), 13.1.2

動的グループ, 29.9

E

EARファイル, 7.1.3

エンタープライズ・グループ、ロールへの割当て, 36.4.3.1

Enterprise Manager

「Fusion Middleware Control」を参照

イベント・サーバー

接続の管理, 15

前提条件, 15.3

登録, 15.4

SSL, 15.3.1.3

イベント・サービス

接続

アクティブ化, 15.5

作成, 15.4

削除, 15.7

管理, 15

変更, 15.6

テスト, 15.8

パフォーマンスの問題およびアクション, 38.1.5.6 パフォーマンス・メトリック, 38.1.4.5 前提条件, 15.3 トラブルシューティング, 15.9 Microsoft Exchange Server 2003の使用, 15.3.2 Microsoft Exchange Server 2007の使用, 15.3.1 エクスポートおよびインポート

概要, 39

スペースのエクスポート, 39.1.8

スペース・テンプレートのエクスポート, 39.1.11

リソースのエクスポート

Frameworkアプリケーション, 39.2.5

WebCenter Portal: Spaces, 39.1.13

Frameworkアプリケーション

概要, 39.2.1

ポートレット・クライアント・メタデータのエクスポート, 39.2.3

WebCenter Portalサービス・メタデータおよびデータのエクスポート, 39.2.7

ポートレット・クライアント・メタデータのインポート, 39.2.4

WebCenter Portalサービス・メタデータおよびデータのインポート, 39.2.8

アプリケーション・セキュリティ・ポリシーの移行, 39.2.9

前提条件, 39.2.2

スペースのインポート, 39.1.9 スペース・テンプレートのインポート, 39.1.10, 39.1.12 リソースのインポート

Frameworkアプリケーション, 39.2.6

WebCenter Portal: Spaces, 39.1.14

移行ツール, 39.2.1 Spaces

カスタマイズおよびパーソナライズ, 39.5.7

ディスカッションのエクスポート, 39.1.7.1

ドキュメントのエクスポート, 39.1.7.3

WLSTを使用したエクスポート, 39.5.2

ディスカッションのインポート, 39.1.7.2

ドキュメントのインポート, 39.1.7.4

バックエンド・コンポーネントの移行, 39.1.7

トラブルシューティング, 39.5

Spacesアプリケーション

概要, 39.1, 39.1.1

カスタマイズ, 39.1.1

前提条件, 39.1.2

WebCenter Portalアプリケーション

データのエクスポート, 39.2.10.1

データのインポート, 39.2.10.2

データの移行, 39.2.10

WebCenter Portal: Spaces

バックエンド・コンポーネント, 39.1.3

資格証明ストア, 39.1.3.3, 39.1.3.5

Content Serverデータのエクスポート, 39.1.3.9

ディスカッションのエクスポート, 39.1.3.7

プロデューサ・メタデータ全体のエクスポート, 39.1.3.13

LDAPアイデンティティ・ストアのエクスポート, 39.1.3.1

Oracle WebLogic Communications Serverのエクスポート, 39.1.3.11

Fusion Middleware Controlを使用したエクスポート, 39.1.4.1

WLSTを使用したエクスポート, 39.1.4.2

Content Serverのインポート, 39.1.3.10

ディスカッションのインポート, 39.1.3.8

プロデューサ・メタデータ全体のインポート, 39.1.3.14

LDAPアイデンティティ・ストアのインポート, 39.1.3.2

Oracle WebLogic Communications Serverのインポート, 39.1.3.12

Fusion Middleware Controlを使用したインポート, 39.1.5.1

WLSTを使用したインポート, 39.1.5.2

ポリシー・ストア, 39.1.3.4, 39.1.3.6

exportAGMetadata(WLSTコマンド), 12.6.1 exportAGProviderConfiguration(WLSTコマンド), 12.6.2 exportGroupSpaces(WLSTコマンド), 39.1.8.2 exportGroupSpaceTemplates(WLSTコマンド), 39.1.11.2 exportMetadata(WLSTコマンド), 39.2.7, A.1.1 exportPortletClientMetadata(WLSTコマンド), 24.6.3, 39.2.3 exportWebCenterApplication(WLSTコマンド), 39.1.4.2 exportWebCenterResource(WLSTコマンド), 39.1.13.2 外部アプリケーション

概要, 26.1

ログイン・フィールドの追加, 26.2.1

削除

Fusion Middleware Controlの使用, 26.5.1

WLSTの使用, 26.5.2

デプロイ後の管理

Frameworkアプリケーション, 6.3

Spacesアプリケーション, 6.2

変更

Fusion Middleware Controlの使用, 26.3.1

WLSTの使用, 26.3.2

パフォーマンスの問題およびアクション, 38.1.5.5 パフォーマンス・メトリック, 38.1.4.6 登録

Fusion Middleware Controlの使用, 26.2.1

WLSTの使用, 26.2.2

F

ファイル・システム

接続パラメータ, 11.6.2

WebCenterでの制限事項, 11.5.2

セキュリティに関する考慮事項, 11.5.1

ファイルベースのアイデンティティ・ストア

資格証明ストアのエクスポートおよびインポート, 39.1.3.5

ポリシー・ストアのエクスポートおよびインポート, 39.1.3.6

ファイル、最大アップロード・サイズ, 11.12, A.1.3, A.1.3 Frameworkアプリケーション

OAMの構成, 32.4

SAML SSOの構成, 32.6

エクスポートおよびインポート, 39.2.1

アプリケーションの起動および実行(チェックリスト), 4

Fusion Middleware Control内のホームページ, 6.3

パフォーマンスの監視, 38.2.2

権限, 36.4.2.2

シングル・サインオン, 32

起動および再起動

Fusion Middleware Controlの使用, 8.4.1

WLSTの使用, 8.4.2

停止

Fusion Middleware Controlの使用, 8.4.3

WLSTの使用, 8.4.4

ログの表示および構成, 38.3 Fusion Middleware管理者(3.1)

Adminロール(WebLogic Server), 1.8

Monitorロール(WebLogic Server), 1.8

Operatorロール(WebLogic Server), 1.8

ロールおよび職責(Frameworkアプリケーション), 4

ロールおよび職責(Oracle WebCenter Portal: Spaces), 2.1

ロールおよび職責(WebCenter Portalアプリケーション), 5

Fusion Middleware Control

概要, 1.13.1

アクティブなコンテンツ・リポジトリ接続の変更, 11.7.1

ポートレット・プロデューサ・アプリケーションのデプロイ, 24.8.4

WebCenter Portalアプリケーションのデプロイ, 7.1.6.4

Spacesアプリケーションのエクスポート, 39.1.4.1

WebCenter Portalのインポート

Spaces, 39.1.5.1

管理

分析サービスの接続, 13

お知らせサービスの接続, 14

コンテンツ・リポジトリの接続, 11

ディスカッション・サービスの接続, 14

イベント・サービスの接続, 15

インスタント・メッセージおよびプレゼンス・サービスの接続, 16

メール・サービスの接続, 17

ポートレット・プロデューサの接続, 24.6.1

検索サービスの接続, 22

ワークリスト・サービスの接続, 23.2

Frameworkアプリケーションの監視, 38 移動

Frameworkアプリケーションのホームページ, 6.3

Spacesアプリケーションのホームページ, 6.2

操作のサマリー, 1.8 WebCenter Portalアプリケーションの再デプロイ, 7.3.2 登録

PDK-Javaプロデューサ, 24.4.1

WSRPプロデューサ, 24.2.1

MDSスキーマの登録, 7.1.5.2 起動, 6.1 WebCenter Portalアプリケーションのアンデプロイ, 7.2.1

G

ガベージ・コレクタ, A.4

収集エンジン, 12.4

GET認証方式, 26.2.1

getRssProxyConfig(WLSTコマンド), 9.7.2

H

ヒープ・サイズ, A.4

HTTPサーバー

「Oracle HTTP Server」を参照

HTTPセッション・タイムアウト, A.4, A.4

I

アイデンティティ・ストア

複数のアイデンティティ・ストアの集約, 29.7

「LDAPアイデンティティ・ストア」を参照

IMAP

接続構成, 17.4.1

メール・サービスの接続, 17.1

SSLセキュリティ構成, 17.3.3

IMP(インスタント・メッセージおよびプレゼンス)サービス

接続

アクティブ化, 16.4

作成, 16.3.2

削除, 16.6

管理, 16

変更, 16.5

パフォーマンスの問題およびアクション, 38.1.5.7 パフォーマンス・メトリック, 38.1.4.7 パフォーマンス・チューニング, A.4 インポートおよびエクスポート, 39

パフォーマンスの問題およびアクション, 38.1.5.8

パフォーマンス・メトリック, 38.1.4.8

importAGMetadata(WLSTコマンド), 12.6.3 importGroupSpaces(WLSTコマンド), 39.1.9.2, 39.1.12.2 importMetadata(WLSTコマンド), 39.2.8 importPortletClientMetadata(WLSTコマンド), 24.6.3, 39.2.4 importWebCenterApplication(WLSTコマンド), 39.1.5.2 importWebCenterResource(WLSTコマンド), 39.1.14.2, 39.2.6 インストール

分析コレクタ, 13.3.1

BPELサーバー, 23.3.1

ディスカッション・サーバー, 14.2.1

イベント・サーバー, 15.3

メール・サーバー, 17.3.1

Oracle SES, 22.3.1

プレゼンス・サーバー, 16.2

WebCenter Portal, 1.7

インスタント・メッセージおよびプレゼンス(IMP)

「IMP」を参照

J

J2EEのアプリケーション・デプロイメント, 6.3

Javaキーストア

複合トポロジ, 34.3.2

単純トポロジ

標準トポロジ, 34.2.2

JDBCデータ・ソース, A.4 JKS

「Javaキーストア」を参照

JNDI Name, 10.1.2 JRFライブラリ, 1.3.3 JRockit, A.4 JSPページ・タイムアウト・パラメータ, A.4 JVM引数, A.4 JVM_ARGS引数, 1.13.3.1

K

キーストア

「Javaキーストア」を参照

L

言語サポート

概要, 37.1.1

新規言語の追加, 37.4

LCS

「Microsoft Live Communications Server」を参照, 16

LDAPアイデンティティ・ストア

概要, 28.2.3

ユーザーの追加, 29.4

libOVDを使用した集約, 29.7

BPELサーバーの要件, 23.3.2

エクスポート, 39.1.3.1

資格証明ストアのエクスポートおよびインポート, 39.1.3.3

ポリシー・ストアのエクスポートおよびインポート, 39.1.3.4

外部LDAP, 28.2.5

管理者アカウントの移動, 29.5

インポート, 39.1.3.2 Microsoft Lyncの要件, 16.2.3.3 Microsoft Office Communications Server(OCS)の要件, 16.2.2.3 Microsoft Office Live Communications Server(LCS)の要件, 16.2.1.3 チューニング, 29.2.2 LDIFファイル

LDAPへのユーザーの追加, 29.4.2

作成, 29.4.2

ルート・ノード, 30.1

libOVD, 29.7 リンク・サービス、権限(Frameworkアプリケーション), 36.4.2.2 listAnalyticsEventTypes(WLSTコマンド), 13.8 listDocumentsSpacesProperties(WLSTコマンド), 11.10.2 listJCRSharePointConnection(WLSTコマンド), 11.3.5 リスト・サービス

パフォーマンスの問題およびアクション, 38.1.5.9

パフォーマンス・メトリック, 38.1.4.9

権限(Frameworkアプリケーション), 36.4.2.2

WebCenterサービス・ポートレットの権限, 24.9.3.2

ロックおよび編集(WebLogic管理コンソール), 1.13.2 ログイン・メトリック(分析タスク・フロー), 13.1.2 ログ

構成, 38.3

Frameworkアプリケーション, 38.3, 38.3.2

ログ・ファイルの場所, 1.3.7

Spaces, 38.3

表示, 38.3

WebCenter Portal

Spaces, 38.3.1

M

メール・サーバー

通知の構成, 19.2.1

接続の管理, 17

パフォーマンス・メトリック, 38.1.4.10

前提条件, 17.3

登録, 17.4

メール・サービス

WebCenterサービス・ポートレット用の構成, 24.9.1.4

接続

アクティブ化, 17.5

作成, 17.4

削除, 17.7

管理, 17

変更, 17.6

パフォーマンスの問題およびアクション, 38.1.5.10 パフォーマンス・メトリック, 38.1.4.10 パフォーマンス・チューニング, A.4 接続の設定, 17 トラブルシューティング, 17.10 管理対象サーバー

概要, 1.3.1

作成, 7.1.4

プロビジョニング, 7.1.4

SOA, 9.3

起動および停止, 8.2

起動順序, 1.3.3

WC_Collaboration, 1.3.1

WC_Portlet, 1.3.1

WC_Spaces, 1.3.1

WC_Utilities, 1.3.1

MDS(Metadata Service)リポジトリ

作成, 7.1.5

登録, 17.1.5

MDSキャッシュ・サイズ・パラメータ, A.4 MDSパージ・レート・パラメータ, A.4 MDSリポジトリ

アプリケーションの起動の失敗

ベース・ファイルの場所, A.1.1

構成ファイル, 1.3.5

構成, 10.1, 10.1.1

カスタマイズ, 1.3.5, A.1.1

MDSキャッシュ・サイズの設定, A.4

MDSパージ・レートの設定, A.4

MDSスキーマ

作成, 7.1.5.1

登録, 7.1.5.1

Fusion Middleware Controlを使用した登録, 7.1.5.2

WLSTを使用した登録, 7.1.5.3

メモリー・サイズ, A.4 Metadata Service(MDS)リポジトリ

作成, 7.1.5

登録, 7.1.5

Microsoft Exchange Server

登録, 17.4

イベント接続の設定, 15.3

Microsoft Exchange Server 2003の使用, 15.3.2

Microsoft Exchange Server 2007の使用, 15.3.1

メール接続の設定, 17 Microsoft Live Communications Server

概要, 16.2.1

LDAPアイデンティティ・ストア, 16.2.1.3

パフォーマンス・メトリック, 38.1.4.7

前提条件, 16.2

登録, 16.3.1

接続の設定, 16

SSLセキュリティ, 33.11

Microsoft Lync

概要, 16.2.3

LDAPアイデンティティ・ストア, 16.2.3.3

前提条件, 16.2

登録, 16.3.1

接続の設定, 16

Microsoft Office Communication Server

SSLセキュリティ, 33.11

Microsoft Office Communications Server

LDAPアイデンティティ・ストア, 16.2.2.3

パフォーマンス・メトリック, 38.1.4.7

前提条件, 16.2

登録, 16.3.1

IMP接続の設定, 16.3

migrateSecurityStore(WLSTコマンド), 39.1.3.3 カスタマイズの移行, 7.1.7 mod_ossoモジュール, B mod_wl_ohsモジュール, B プロバイダ接続設定の変更, 20.5.1 Monitorロール(WebLogic Server), 1.8 パフォーマンスの監視

一般的なパフォーマンスの問題およびアクション, 38.1.3

Frameworkアプリケーション, 38.2.2

メトリック収集, 38.1.1

WebCenter Portal

Spaces, 38.2.1

WebCenter Portalサービス, 38.1.2

N

ノード・マネージャ, 8.1

ノート・サービス

パフォーマンスの問題およびアクション, 38.1.5.11

パフォーマンス・メトリック, 38.1.4.11

通知, 19

メッセージをトリガーするアクティビティ, 19.1.1

接続タイプ

概要, 19.2.1

Fusion Middleware Controlでの設定, 19.2.4

WLSTコマンドを使用した設定, 19.2.5

カスタム通知テンプレートの作成, 19.3 デフォルト・テンプレートの上書き, 19.3.1, 19.3.2 Spacesでのプリファレンス, 19.1.3 前提条件, 19.2.2

構成, 19.2.2.2

インストール, 19.2.2.1

制限事項, 19.2.2.4

デフォルトのプリファレンスの設定, 19.1 サブスクリプションのデフォルトの設定

コネクションに対する効果, 19.1.2

フィードバックに対する効果, 19.1.2

メッセージ・ボードに対する効果, 19.1.2

スペース管理に対する効果, 19.1.2

接続のテスト, 19.4 トラブルシューティング, 19.5

O

OAM

Frameworkアプリケーションの構成, 32.4

「Oracle Access Manager」を参照

OAM-SSO, 14.12.4 OBJECTGUID属性, 37.3, 37.4 OCS(Office Communications Server)

「Microsoft Office Communications Server」を参照

OmniPortlet

概要, 1.3.2, 8.2, 24.1

パフォーマンス・チューニング, A.4

open-files-limit, A.4 Operatorロール(WebLogic Server), 1.8 OPSSトラスト・サービス, 20.4

構成, 20.4.1, 29.10

ドメイン間トラストの構成, 20.4.3

Oracle Access Manager

アクセス・サーバー, 31.2.1

構成, 31.2

スクリプトの使用の構成, 31.2.3.2.3

アイデンティティ・アサーション・プロバイダ, 31.2.1

11g Web層のインストール, 31.2.3

SSOアプリケーションからのログアウト, 28.1

シングル・サインオン, 28.2.5

トポロジおよびコンポーネント, 31.2.1

WebGate, 31.2.1

Oracle Application Development Framework, 1.2.2 Oracle Content Server

構成, 11.2.3

アイテム・レベルのセキュリティ, 11.2.2

OracleTextSearch, 11.2.2

SESクローラ, 11.2.2

アイデンティティ・ストアの構成, 29.6 接続パラメータ, 11.6.2 前提条件, 11.2 セキュリティに関する考慮事項, 11.2.1 シグネチャの検証, 33.7.3 Oracle DMS, 1.3.3 Oracle Enterprise Manager

「Fusion Middleware Control」を参照

Oracle HTTP Server, B Oracle Internet Directory, 28.2.5, 29.1, 29.4.2, 30.3, 33.6 Oracle Metadata Repository

「MDSリポジトリ」を参照

Oracle Platform Security Services, 28.1, 28.2.4.1

API, 28.2.4.4

Oracle Portal

構成, 11.4.2

接続パラメータ, 11.6.2

インストール, 11.4.1

WebCenterでの制限事項, 11.4.4

前提条件, 11.4

Oracle Secure Enterprise Search (SES), 22

構成

WebCenter Portalアプリケーション, 22.5

WebCenter Spaces, 22.6

接続の管理, 22 概要, 22.1 パフォーマンス・メトリック, 38.1.4.19 前提条件, 22.3 登録, 22.4.1 SSLセキュリティ, 22.3.3 Oracle SES

「Oracle Secure Enterprise Search (SES)」を参照

Oracle Single Sign-On(OSSO), 31.3

コンポーネント, 31.3.2

構成, 31.3

Oracle SOA Suite, 9.3 Oracle Web Services Manager(wsm-pm), 1.3.3 Oracle WebCenter

デフォルトのセキュリティ, 28, 28.2

Oracle WebCenter Portal

概要, 1.1

管理ツール, 1.13

管理ロール, 1.8

アーキテクチャ, 1.2

構成ファイル, A

構成の概要, 1.3.5

構成ツール, A.3

外部依存性, 1.3.4

インストール, 1.7

ログ・ファイルの場所, 1.3.7

管理対象サーバー, 1.3.2

パフォーマンスの監視, 1.9

トポロジ, 1.3.1

Oracle WebCenter Portal: Framework, 1.2.1 Oracle WebCenter Portal: Spaces

使用開始, 2

Oracle WebLogic Communications Server

エクスポート, 39.1.3.11

インポート, 39.1.3.12

パフォーマンス・メトリック, 38.1.4.7

Oracle WebLogic Scripting Tool

「WLST」を参照

言語のバンドルのオーバーライド, 37.3 owc_discussionsアプリケーション, 1.3.2, 8.2

P

ページ権限(Frameworkアプリケーション), 36.4.2.2

ページ・サービス

ページ・トラフィック分析タスク・フロー, 13.1.2

パフォーマンスの問題およびアクション, 38.1.5.12

パフォーマンス・メトリック, 38.1.4.12

ページ・トラフィック(分析タスク・フロー), 13.1.2 ページ・トラフィック分析タスク・フロー, 13.1.2 PDK-Javaプロデューサ

パフォーマンス・チューニング, A.4

登録

Frameworkアプリケーション, 24.4.4

WebCenter Portal: Spaces, 24.4.3

Fusion Middleware Controlの使用, 24.4.1

WLSTの使用, 24.4.2

保護, 35.2 接続のテスト, 24.5 ピープル・コネクション・ロケータ, 20.3.5, 20.5.4 ピープル・コネクション・サービス

アクティビティ・ストリーム, 18.4

パフォーマンスの問題およびアクション, 38.1.5.14

パフォーマンス・メトリック, 38.1.4.15

パフォーマンスの問題およびアクション

お知らせサービス, 38.1.5.1

ディスカッション・サービス, 38.1.5.4

ドキュメント・サービス, 38.1.5.3

イベント・サービス, 38.1.5.6

外部アプリケーション, 38.1.5.5

IMPサービス, 38.1.5.7

インポートおよびエクスポート, 38.1.5.8

リスト・サービス, 38.1.5.9

メール・サービス, 38.1.5.10

ノート・サービス, 38.1.5.11

ページ・サービス, 38.1.5.12

ピープル・コネクション・サービス, 38.1.5.14

ポートレット・プロデューサ, 38.1.5.13

RSSサービス, 38.1.5.16

検索サービス, 38.1.5.18

ワークリスト・サービス, 38.1.5.2

パフォーマンス・メトリック

お知らせサービス, 38.1.4.1

ディスカッション・サービス, 38.1.4.4

ドキュメント・サービス, 38.1.4.3

イベント・サービス, 38.1.4.5

外部アプリケーション, 38.1.4.6

インポートおよびエクスポート・サービス, 38.1.4.8

インスタント・メッセージおよびプレゼンス・サービス, 38.1.4.7

リスト・サービス, 38.1.4.9

メール・サービス, 38.1.4.10

メトリック収集, 38.1.1

ノート・サービス, 38.1.4.11

ページ・サービス, 38.1.4.12

ピープル・コネクション・サービス, 38.1.4.15

投票サービス, 38.1.4.16

ポートレット・プロデューサ, 38.1.4.13

ポートレット, 38.1.4.14

最近のアクティビティ・サービス, 38.1.4.18

RSSサービス, 38.1.4.17

検索サービス, 38.1.4.19

Spaces, 38.1.6

パフォーマンス情報の表示, 38.2

WebCenter Portalサービス, 38.1.2

ワークリスト・サービス, 38.1.4.2

権限

Frameworkアプリケーションの使用, 36.4.2.2

Fusion Middleware Controlの使用, 1.8

WLS管理サーバーの使用, 1.8

WLSTの使用, 1.8

パーソナライズ

概要, 20.1

アクティビティ・グラフ・プロバイダ, 20.3.5

CMISプロバイダ, 20.3.5

構成オプション, 20.3.5

構成要件, 20.3.2

コンテンツ・プレゼンタの構成, 20.7

カスタム・プロバイダの構成, 20.5.5

プロバイダの構成, 20.5

シングル・サインオンの構成, 20.8

アクティビティ・グラフ・プロバイダの構成, 20.5.3

CMISプロバイダの構成, 20.5.2

インストール要件, 20.3.1

制限事項, 20.3.4

管理, 20

プロバイダ接続設定の変更, 20.5.1

OPSSトラスト・サービス, 20.4

デフォルトの構成, 20.3.5

デフォルトのセキュリティ設定のオーバーライド, 20.9

ピープル・コネクション・ロケータ, 20.3.5, 20.5.4

前提条件, 20.3

セキュリティ, 20.3.3

ポリシーおよび資格証明ストア, 30 ポリシー・ストア

OID用の構成, 30

エクスポートおよびインポート, 39.1.3.6

投票サービス、パフォーマンス・メトリック 38.1.4.16 portalToolsアプリケーション, 1.3.2, 8.2 ポートレット・インスタンス・レスポンス時間(分析タスク・フロー), 13.1.2 ポートレット・インスタンス・トラフィック(分析タスク・フロー), 13.1.2 ポートレット・プロデューサ

概要, 24

考慮事項, 24.1

EARファイルの変換, 24.8.2

接続の削除

Frameworkアプリケーション, 24.7.4

WebCenter Portal: Spaces, 24.7.3

Fusion Middleware Controlの使用, 24.7.1

WLSTの使用, 24.7.2

アプリケーションのデプロイ, 24.8 接続の編集

Fusion Middleware Controlの使用, 24.6.1

WLSTの使用, 24.6.2

デプロイ後の管理

Frameworkアプリケーション, 6.3

Spacesアプリケーション, 6.2

セキュリティの管理, 35 パフォーマンスの問題およびアクション, 38.1.5.13 パフォーマンス・メトリック, 38.1.4.13 ページレット・プロデューサの登録

Fusion Middleware Controlの使用, 25.2.1

WLSTの使用, 25.2.2

PDK-Javaプロデューサの登録

Frameworkアプリケーション, 24.4.4

WebCenter Portal: Spaces, 24.4.3

Fusion Middleware Controlの使用, 24.4.1

WLSTの使用, 24.4.2

WSRPプロデューサの登録

Frameworkアプリケーション, 24.2.5

WebCenter Portal: Spaces, 24.2.4

Fusion Middleware Controlの使用, 24.2.1

WLSTの使用, 24.2.2

トラブルシューティング, 24.10 ポートレット・レスポンス時間(分析タスク・フロー), 13.1.2 ポートレット・トラフィック(分析タスク・フロー), 13.1.2 ポートレット

キャッシュ・サイズ, A.4

ロケール・サポート, A.4

パフォーマンス・メトリック, 38.1.4.14

タイムアウト, A.4

パフォーマンスのチューニング, A.4

POST認証方式, 26.2.1 プロファイル・サービス, 18.4 プロバイダ

構成, 20.5

カスタム・プロバイダの構成, 20.5.5

プロバイダ接続設定の変更, 20.5.1

プロキシ・サーバー, 27.4 パブリック資格証明(外部アプリケーション), 26.2.1

Q

QRPP(問合せ結果ポスト・プロセッサ), 12.1

R

ランク・エンジン, 12.4

RCU(リポジトリ作成ユーティリティ), 7.1.5, 7.1.5.1

理由文字列、カスタマイズ, 12.5

ポリシーおよび資格証明ストアの再度関連付け, 30

最近のアクティビティ・サービス、パフォーマンス・メトリック, 38.1.4.18

最近の履歴のメトリック, 38.1.1

レシピ, 12.1

再デプロイ

概要, 7.3.1

Fusion Middleware Controlの使用, 7.3.2

WLSTの使用, 7.3.3

WebCenter Portalアプリケーション, 7, 7.3

refreshGroupSpaceCache(WLSTコマンド), 39.5.2 refreshSpaceTemplateCache(WLSTコマンド), 39.5.2 registerPDKJavaProducer(WLSTコマンド), 24.4.2 registerWSRPProducer(WLSTコマンド), 24.2.2 リモート・ポートレット通信エラー、WebCenterサービス・ポートレット, 24.9.3.4 removeExtAppCredential(WLSTコマンド), 26.3.2 removeExtAppField(WLSTコマンド), 26.3.2 removeWorklistConnection(WLSTコマンド), 23.4.5.2 renameAGAction(WLSTコマンド), 12.6.5 renameAGNodeClass(WLSTコマンド), 12.6.5 リポジトリ作成ユーティリティ(RCU), 7.1.5, 7.1.5.1 ResourceLimitExceptionの問題, 39.5.1 リソース

概要, 36.5

コピー, 36.5.3

作成, 36.5.2

削除, 36.5.10

ダウンロード, 36.5.8

編集

「編集」ダイアログを使用した単純な編集, 36.5.4.2

ソース・コードの編集, 36.5.4.1

リソースのエクスポート

Frameworkアプリケーション, 39.2.5

WebCenter Portal: Spaces, 39.1.13

リソースのインポート

Frameworkアプリケーション, 39.2.6

WebCenter Portal: Spaces, 39.1.14

ページ

アクセス方法, 36.5.1.3

ページの作成, 36.5.1.1

サブ・ページの作成, 36.5.1.2

ページ階層内のページの移動, 36.5.1.5

権限アクション, 36.5.1.3

並替え, 36.5.1.4

ページのアクセス権限の設定, 36.5.1.3.1

ルート・ノードのアクセス権限の設定, 36.5.1.3.2

プレビュー, 36.5.9 保護, 36.5.7 プロパティの設定

アイコンの関連付け, 36.5.5.3

属性の関連付け, 36.5.5.4.1

属性の削除, 36.5.5.4.2

名前の変更, 36.5.5.2

表示と非表示, 36.5.6 アップロード, 36.5.8 REST API, 27.1 RESTサービス・アイデンティティ・アサータ, 29.10 RESTサービス

概要, 27.1

認証, 27.7

圧縮, 27.6

アイデンティティ・アサータの構成, 29.10

管理, 27

手動構成, 27.2

プロキシ・サーバー構成, 27.4

ルート名、変更, 27.5

セキュリティ・トークン, 27.3

リバース・プロキシ リッチ・テキスト・エディタ

WebCenterサービス・ポートレット, 24.9.3.1

ロール

Frameworkアプリケーション・ロール, 36.4.2.1

WebLogic Server管理ロール, 1.8

ロールおよび職責, 2.1, 2.2, 3.1, 3.2, 4, 5 RSSサービス

概要, 21.1

パフォーマンスの問題およびアクション, 38.1.5.16

パフォーマンス・メトリック, 38.1.4.17

前提条件, 21.2

プロキシ・サーバーの設定

Fusion Middleware Controlの使用, 9.7.1

WLSTの使用, 9.7.2

接続のテスト, 21.4 パフォーマンスのチューニング, A.4 RTC Webサービス, 16.2.1.2

S

SAML SSO

Frameworkアプリケーションの構成, 32.6

SAMLベースのシングル・サインオン, 31.4 検索メトリック(分析タスク・フロー), 13.1.2 検索サービス

接続

アクティブ化, 22.4.2

作成, 22.4.1

削除, 22.4.4

管理, 22

変更, 22.4.3

パフォーマンスの問題およびアクション, 38.1.5.18 パフォーマンス・メトリック, 38.1.4.19 パフォーマンス・チューニング, A.4 トラブルシューティング, 22.7 使用状況レポート(分析), 13.1.2 セキュリティ

ADFセキュリティ, 28.1

デフォルトの構成, 28, 28.2

外部LDAP, 28.2.5

アイデンティティ・ストア, 28.2.3

アイテム・レベルのセキュリティ, 11.2.2

Oracle Platform Security Services, 28.1

ポリシー・ストア, 28.2.3, 30

ポートレット・プロデューサ, 35

PDK-Javaプロデューサの保護, 35.2

シングル・サインオン, 28.2.5

SSL, 28.2.5

WebCenter Portalアプリケーション, 28.1

WebCenterセキュリティ・フレームワーク, 28.1

WebCenter Spaces, 28.1

WebLogic Serverセキュリティ, 28.1

WS-Security, 28.2.5

Security Assertion Markup Language, 31.4, 31.4.1 セキュリティ・トークン, 27.3 招待による自己登録, 30.7 セッション・タイムアウト, A.4, A.4 setAnalyticsCollectorConfig(WLSTコマンド), 13.4.1 setAnalyticsCollectorConnection(WLSTコマンド), 13.5.3.2 setBPELConnection(WLSTコマンド), 23.4.4.2 setDiscussionForumConnection(WLSTコマンド), 14.4.2, 14.5.2 setDocumentsSpacesProperties(WLSTコマンド), 11.10.2 setDomainEnv.sh, A.4 setExtAppConnection(WLSTコマンド), 26.3.2 setExtAppCredential(WLSTコマンド), 26.3.2 setExtAppField(WLSTコマンド), 26.3.2 setIMailConnection(WLSTコマンド), 17.6.2 setIMailConnectionProperty(WLSTコマンド), 17.6.2 setIMPConnection(WLSTコマンド), 16.4.2, 16.5.2 setIMPConnectionProperty(WLSTコマンド), 16.5.2 setJCRContentServerConnection(WLSTコマンド), 11.7.2, 11.8.2 setJCRFileSystemConnection(WLSTコマンド), 11.7.2, 11.8.2 setJCRPortalConnection(WLSTコマンド), 11.7.2, 11.8.2 setJCRSharePointConnection(WLSTコマンド), 11.3.5 setMailConnection(WLSTコマンド), 17.4.2, 17.5.2 setPDKJavaProducer(WLSTコマンド), 24.6.2 setPersonalEventConnection(WLSTコマンド), 15.5.2, 15.6.2 setProfileCacheNumberOfObjects(WLSTコマンド), 13.6 setProfileCacheTimeToLive(WLSTコマンド), 13.6 setRssProxyConfig(WLSTコマンド), 9.7.2 setSearchSESConfig(WLSTコマンド), 22.4.3.2 setSESConnection(WLSTコマンド), 22.4.2.2, 22.4.3.2 setWSRPProducer(WLSTコマンド), 24.6.2 共有資格証明(外部アプリケーション), 26.2.1 類似度計算

概要, 12.1

理由文字列のカスタマイズ, 12.5

シングル・サインオン

Frameworkアプリケーション, 32

シングル・サインオン

概要, 28.2.5

BPELサーバーの要件, 23.3.2

仮想ホストでの構成, 31.6

外部アプリケーション, 26.2.1

Microsoftクライアント, 31.5

FrameworkアプリケーションのOAM, 32.4

Oracle Access Manager, 31.2

Oracle Single Sign-On(OSSO), 31.3

FrameworkアプリケーションのSAML SSO, 32.6

SAMLベース, 31.4

SMTP

概要, 17

SSLセキュリティ, 17.3.3

SOA Suite, 9.3 スペース・レスポンス時間(分析タスク・フロー), 13.1.2 スペース・テンプレート

エクスポートおよびインポート, 39.1.12

スペース・テンプレート

エクスポートおよびインポートの概要, 39.1.1

エクスポートおよびインポート, 39.1.11

スペース・トラフィック(分析タスク・フロー), 13.1.2 Spaces

概要

管理ページ, 1.8

エクスポートおよびインポート, 39.1.8, 39.1.9

バックエンド・コンポーネント, 39.1.7

ディスカッションのエクスポート, 39.1.7.1

ディスカッションのインポート, 39.1.7.2

前提条件, 39.1.6

パフォーマンス・メトリック, 38.1.6 使用状況レポート(分析), 13.1.2 ログの表示および構成, 38.3 ワークフロー, 9.3 Spaces管理者, 2.2, 3.2 Spaces API, 34.4 Spacesアプリケーション

インポートおよびエクスポートの概要, 39.1.1

エクスポートおよびインポート, 39.1

Fusion Middleware Control内のホームページ, 6.2

Spacesアプリケーション

パフォーマンスの監視, 38

パフォーマンスのチューニング, A.4

Spacesリソース

「リソース」を参照

SSLセキュリティ

概要, 28.2.5

ブラウザからディスカッション・サービスへの接続, 33.4

ブラウザからWebCenter Spacesへの接続, 33.1

IMAP接続, 17.3.3

Oracle HTTP ServerとWebCenter Spacesとの間, 33.3

SES接続, 22.3.3

SMTP接続, 17.3.3

WebCenter SpacesからIMAP/SMTPへの接続, 33.8

WebCenter SpacesからLCSへの接続, 33.11

WebCenter SpacesからLDAPへの接続, 33.6

WebCenter SpacesからOCSへの接続, 33.11

WebCenter Spacesからポートレット・プロデューサへの接続, 33.5

WebCenter SpacesからSESへの接続, 33.10

起動スクリプト, 8.1 startApplication(WLSTコマンド), 8.3.2, 8.4.2 startNodeManager.sh, 8.1 stopApplication(WLSTコマンド), 8.3.4, 8.4.4 文字列の変更, 37.3 サブスクリプション・ワークフロー(WebCenter Portal: Spaces), 9.3 サブスクリプションおよび通知, 19

メッセージをトリガーするアクティビティ, 19.1.1

接続タイプ

概要, 19.2.1

Fusion Middleware Controlでの設定, 19.2.4

WLSTコマンドを使用した設定, 19.2.5

カスタム通知テンプレートの作成, 19.3 デフォルト通知テンプレートの上書き, 19.3.1, 19.3.2 Spacesでのプリファレンス, 19.1.3 前提条件, 19.2.2

構成, 19.2.2.2

インストール, 19.2.2.1

制限事項, 19.2.2.4

デフォルトのプリファレンスの設定, 19.1 サブスクリプションのデフォルトの設定

コネクションに対する効果, 19.1.2

フィードバックに対する効果, 19.1.2

メッセージ・ボードに対する効果, 19.1.2

スペース管理に対する効果, 19.1.2

接続のテスト, 19.4 トラブルシューティング, 19.5 システム・ライブラリ, 1.3.2, 1.3.3 システム制限, A.4 システムMBeanブラウザ, 1.13.4, A.3

T

タイムアウト

同時実行性管理, A.4

HTTPセッション, A.4, A.4

JSPページ, A.4

ポートレット, A.4

サービスおよびポートレット, A.4

変更

デフォルトの文字列, 37.3

新規言語, 37.4

trans-unitブロック, 37.3, 37.4 トラブルシューティング

アクティビティ・グラフ・サービス, 12.8

分析サービス, 13.11

ディスカッションおよびお知らせ, 14.12

イベント・サービス, 15.9

メール・サービス, 17.10

Oracle SES検索, 22.7

ページレット, 25.10

ポートレット・プロデューサ, 24.10

Spacesのエクスポートおよびインポート, 39.1

サブスクリプションおよび通知, 19.5

WebCenter Portalアプリケーションの構成, A.5

WebCenterサービス・ポートレット, 24.9.3

WLSTコマンド, A.6

ワークリスト・サービス, 23.5

トラスト・サービス, 20.4

構成, 20.4.1, 29.10

ドメイン間トラストの構成, 20.4.3

パフォーマンスのチューニング

お知らせサービス, A.4

ディスカッション・サービス, A.4

IMPサービス, A.4

メール・サービス, A.4

Omniportletプロデューサ, A.4

PDK-Javaプロデューサ, A.4

ポートレット, A.4

RSSサービス, A.4

検索サービス, A.4

WSRPプロデューサ, A.4

U

WebCenter Portalアプリケーションのアンデプロイ, 7.2

アンデプロイ

Fusion Middleware Controlの使用, 7.2.1

WLSTの使用, 7.2.2

WebCenter Portalアプリケーション, 7, 7.2

unsetRssProxyConfig(WLSTコマンド), 9.7.2 UPLOAD_MAX_DISK_SPACEパラメータ, A.1.2 UPLOAD_MAX_MEMORYパラメータ, A.1.2 UPLOAD_TEMP_DIRパラメータ, A.1.2 uploadedFileMaxDiskSpaceプロパティ(Spacesアプリケーション), A.1.3, A.1.3 ユーザー・インタフェースの文字列の変更, 37.3 ユーザー・プリファレンス

WebCenterサービス・ポートレット, 24.9.3.3

ユーザー定義ロール(Frameworkアプリケーション), 36.4.2.1.2 ユーザー(Frameworkアプリケーション)

追加および削除, 36.4.3.5

ロールへの割当て, 36.4.3.1

ロール割当ての変更, 36.4.3.2

管理者ロールの付与, 36.4.3.3

管理, 36.4.3

ロールの取消し, 36.4.3.4

ユーザー(WebCenter Spaces)

管理, 30.6.3

V

仮想ホスト, 31.6

W

WC_Collaboration(管理対象サーバー), 1.3.1

WC_Custom-diagnostic.log, 38.3

WC_Portlet(管理対象サーバー), 1.3.1

WC_Spaces(管理対象サーバー), 1.3.1

WC_Spaces-diagnostic.log, 38.3

WC_Utilities(管理対象サーバー), 1.3.1

wcSessionTimeoutPeriod, A.1.3, A.1.3

Web Clipping, 1.3.2, 8.2, 24.1

webcenter(J2EEアプリケーション), 1.3.2, 8.2

WebCenter Portal

Spaces

ログ, 38.3.1

パフォーマンスの監視, 38.2.1

WebCenter Portalアプリケーション

概要, 1.5

管理アプリケーション(チェックリスト), 5

構成の変更, A.2

構成ツール, A.3

デフォルトのセキュリティ, 28, 28.2

デプロイ, 7.1, 7.1.6

アイデンティティ・ストア, 28.2.3

ポリシー・ストア, 28.2.3

セキュリティ, 28.1, 28.1

「WebCenter Portalアプリケーション」も参照

シングル・サインオン, 31.2

パフォーマンスのチューニング, A.4

アンデプロイ, 7.2, 7.2

WebCenter Portalサービス

バックエンド・コンポーネントの要件

ワークリスト・サービス, 23.3.1

ピープル・コネクション・サービス

アクティビティ・ストリーム, 18.4

接続の設定, 13, 23 WebCenterポータル・トラフィック(分析タスク・フロー), 13.1.2 WebCenter Portalのディスカッション・サーバー

「ディスカッション・サーバー」を参照

WebCenter Portal: Framework

「Oracle WebCenter Portal: Framework」を参照

WebCenter Portal: Services, 1.2.5 WebCenter Portal: Spaces

概要, 1.2.4

管理アプリケーション(チェックリスト), 3

エクスポートおよびインポート

スペースのエクスポート, 39.1.8

スペース・テンプレートのエクスポート, 39.1.11

ドキュメントのエクスポート, 39.1.7.3

スペースのインポート, 39.1.9

スペース・テンプレートのインポート, 39.1.12

ドキュメントのインポート, 39.1.7.4

「Spaces」を参照 起動および再起動

Fusion Middleware Controlの使用, 8.3.1

WLSTの使用, 8.3.2

停止

Fusion Middleware Controlの使用, 8.3.3

WLSTの使用, 8.3.4

WebCenterサービス

データベース接続, 10.1

管理, 10

接続の設定, 14, 15, 21

WebCenterサービス・ポートレット, 24.9

構成

お知らせサービス, 24.9.1.3

ディスカッション・サービス, 24.9.1.3

ドキュメント・サービス, 24.9.1.1

メール・サービス, 24.9.1.4

セキュリティ, 24.9.2

ワークリスト・サービス, 24.9.1.2

リスト・サービスの権限, 24.9.3.2 ポートレット, 24.9 リモート・ポートレット通信エラー, 24.9.3.4 リッチ・テキスト・エディタ, 24.9.3.1 トラブルシューティング, 24.9.3 ユーザー・プリファレンス, 24.9.3.3 WebCenter Spaces

WS-Securityの構成, 34

管理者ロールの付与, 30.6.1

セキュリティ, 28.1, 28.1

webcenter-config.xml, A.1.3, A.1.3, A.4 webcenter-helpアプリケーション, 1.3.2, 8.2 WebLogic管理コンソール

「WebLogic Server管理コンソール」を参照

WebLogic管理対象サーバー

作成, 7.1.4

プロビジョニング, 7.1.4

WebLogic Scripting Tool

「WLST」を参照

WebLogic Server管理コンソール

概要, 1.13.2

ポートレット・プロデューサ・アプリケーションのデプロイ, 24.8.5

操作のサマリー, 1.8

トポロジ, 1.3.1

WebLogic Serverセキュリティ, 28.1 web.xml, A, A.1.2, A.4 Wikiメトリック(分析タスク・フロー), 13.1.2 WLS管理コンソール

WebCenter Portalアプリケーションのデプロイ, 7.1.6.6

「WebLogic Server管理コンソール」を参照

WLST

概要, 1.13.2

addWorklistConnection, 23.4.3.2

アクティブなコンテンツ・リポジトリ接続の変更, 11.7.2

createBPELConnection, 23.4.2.2

createIMPConnection, 16.3.2

createJCRContentServerConnection, 11.6.3

createJCRFileSystemConnection, 11.6.3

createJCRPortalConnection, 11.6.3

createMailConnection, 17.4.2

createPersonalEventConnection, 15.4.2

createSESConnection, 22.4.1.2

createSharePointConnection, 11.3.5

deleteAGAction, 12.6.4

deleteAGNodeClass, 12.6.4

deleteAGProviderAssignment, 12.6.4

deleteAGQRPPRegistration, 12.6.4

deleteAGRankCalculation, 12.6.4

deleteAGSimilarityCalculation, 12.6.4

deleteAllAGMetadata, 12.6.4

deleteConnection, 11.9.2, 14.6.2, 15.7.2, 16.6.2, 17.7.2, 22.4.4.2, 23.4.5.2, 26.5.2

deleteDocumentsSpacesProperties, 11.10.2

コンテンツ・リポジトリの接続の削除, 11.9.2

ポートレット・プロデューサの接続の削除, 24.7.2

ポートレット・プロデューサ・アプリケーションのデプロイ, 24.8.6

WebCenter Portalアプリケーションのデプロイ, 7.1.6.5

ポートレット・プロデューサの接続情報の編集, 24.6.2

exportAGMetadata, 12.6.1

exportAGProviderConfiguration, 12.6.2

スペースのエクスポート, 39.1.8.2

スペース・テンプレートのエクスポート, 39.1.11.2

ポートレット・クライアント・メタデータのエクスポート, 39.2.3

リソースのエクスポート, 39.1.13, 39.2.5

Spacesのエクスポート, 39.5.2

WebCenter Portalのエクスポート

Spaces, 39.1.4.2

WebCenter Portalサービス・メタデータおよびデータのエクスポート, 39.2.7 exportMetadataコマンド, A.1.1 exportPortletClientMetadata, 24.6.3 getRssProxyConfig, 9.7.2 importAGMetadata, 12.6.3 スペースのインポート, 39.1.9.2 スペース・テンプレートのインポート, 39.1.12.2 ポートレット・クライアント・メタデータのインポート, 39.2.4 リソースのインポート, 39.1.13.2, 39.1.14.2 WebCenter Portalのインポート

Spaces, 39.1.5.2

WebCenter Portalサービス・メタデータおよびデータのインポート, 39.2.8 importPortletClientMetadata, 24.6.3 listDocumentsSpacesProperties, 11.10.2 listSharePointConnection, 11.3.5 コンテンツ・リポジトリの接続プロパティの管理(WebCenter Spaces), 11.10.2 Frameworkアプリケーション・セキュリティ・ポリシーの移行, 39.2.9 コンテンツ・リポジトリの接続情報の変更, 11.8.2 操作のサマリー, 1.8 WebCenter Portalアプリケーションの再デプロイ, 7.3.3 MDSスキーマの登録, 7.1.5.3 コンテンツ・リポジトリの登録, 11.6.3 ページレット・プロデューサの登録, 25.2.2 PDK-Javaプロデューサの登録, 24.4.2 WSRPプロデューサの登録, 24.2.2 registerPDKJavaProducer, 24.4.2 registerWSRPProducer, 24.2.2 removeExtAppCredential, 26.3.2 removeExtAppField, 26.3.2 removeWorklistConnection, 23.4.3.2, 23.4.5.2 renameAGAction, 12.6.5 renameAGNodeClass, 12.6.5 実行, 1.13.3.1 setAnalyticsCollectorConnection, 13.5.3.2 setBPELConnection, 23.4.4.2 setDiscussionForumConnection, 14.4.2, 14.5.2 setDocumentsSpacesProperties, 11.10.2 setExtAppConnection, 26.3.2 setExtAppCredential, 26.3.2 setExtAppField, 26.3.2 setIMPConnection, 16.4.2, 16.5.2 setIMPConnectionProperty, 16.5.2 setJCRContentServerConnection, 11.7.2, 11.8.2 setJCRFileSystemConnection, 11.7.2, 11.8.2 setJCRPortalConnection, 11.7.2, 11.8.2 setMailConnection, 17.4.2, 17.5.2, 17.6.2 setMailConnectionProperty, 17.6.2 setPDKJavaProducer, 24.6.2 setPersonalEventConnection, 15.5.2, 15.6.2 setProfileCacheNumberOfObjects, 13.6 setProfileCacheTimeToLive, 13.6 setRssProxyConfig, 9.7.2 setSearchSESConfig, 22.4.3.2 setSESConnection, 22.4.2.2, 22.4.3.2 setSharePointConnection, 11.3.5 setWSRPProducer, 24.6.2 startApplication, 8.3.2 stopApplication, 8.3.4 WebCenter Portalアプリケーションのアンデプロイ, 7.2.2 unsetRssProxyConfig, 9.7.2 wlst.shスクリプト, 1.13.3.1 ワークフロー(WebCenter Portal: Spaces), 9.3 ワークリスト・サービス

バックエンド要件, 23.3.1

WebCenterサービス・ポートレット用の構成, 24.9.1.2

接続

アクティブ化, 23.4.3

管理, 23.2

変更, 23.4.4

パフォーマンス・メトリック, 38.1.4.2 Spacesワークフロー, 9.3 トラブルシューティング, 23.5 wsm-pmアプリケーション, 1.3.3 WSRPプロデューサ

パフォーマンス・チューニング, A.4

登録

Frameworkアプリケーション, 24.2.5

WebCenter Portal: Spaces, 24.2.4

Fusion Middleware Controlの使用, 24.2.1

WLSTの使用, 24.2.2

接続のテスト, 24.3 WS-Security, 35.1 wsrp-toolsアプリケーション, 1.3.2, 8.2 WS-Security

概要, 28.2.5

BPELサーバー, 23.3.2

構成, 34

複合トポロジ用の構成, 34.3

単純トポロジ用の構成, 34.1

標準トポロジ用の構成, 34.2

ディスカッション・サーバー, 14.2.3

Spaces API, 34.4

WSRPプロデューサ, 35.1

Copyright © 2007, 2012, Oracle and/or its affiliates. All rights reserved.