Oracle® Fusion Middleware

Oracle User Messaging Serviceの管理

12c (12.2.1.2.0)

E82669-01(原本部品番号:E79115-01)

2016年10月

Oracle User Messaging Service (Oracle UMS)の管理方法について説明する管理者向けのドキュメントです。この内容には、ユーザー・メッセージング・ドライバや他のコンポーネントを構成およびデプロイする方法、Oracle User Messaging Serviceでセキュリティを有効にする方法、Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle User Messaging Serviceを監視する方法などが含まれます。

Oracle Fusion Middleware Oracle User Messaging Serviceの管理, 12c (12.2.1.2.0)

E82669-01

Copyright © 2016, Oracle and/or its affiliates. All rights reserved.

原本著者: Megha Sharma

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

このドキュメントの情報は、情報共有の目的のみに使用され、顧客諮問委員会の会員の立場で考慮されるか、ベータ・トライアル版契約のみに準じる必要があります。資料、規約または機能性を配信する義務はなく、購買決定に依存すべきではないものとします。このドキュメントに記載されている開発、リリース、およびすべての機能または機能性の時期は、オラクル社の独自の判断に従うものとします。

このドキュメントは、ソフトウェアまたは印刷物などの形式にかかわらず、オラクル社の独占的な財産である機密情報を含みます。この機密資料へのアクセスと使用は、オラクル社との間で締結され遵守に同意したOracle Master Agreement、Oracle License and Services Agreement、Oracle PartnerNetwork Agreement、オラクル販売契約、あるいはその他のライセンス契約の条件にしたがうものとします。オラクル社の文書による事前承諾なしに、このドキュメントおよびここに含まれる情報を開示、コピー、再生、またはオラクル社外部の他者に配布することはできません。このドキュメントは使用許諾契約の一部ではなく、オラクル社の子会社またはアフィリエイトとの契約上の合意に組み込まれません。

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

Oracle User Messaging Serviceの新機能

- リリース12c (12.2.1)の新機能と変更された機能

1 Oracle User Messaging Serviceの概要

- 1.1 概要

- 1.1.1 コンポーネント

- 1.1.2 アーキテクチャ

- 1.2 Oracle User Messaging Serviceの構成の概要

- 1.3 非推奨の機能

2 Oracle User Messaging Serviceのスタート・ガイド

- 2.1 ユーザー・メッセージング・サービスのインストール

- 2.2 ユーザー・メッセージング・サービスのアップグレード

- 2.3 スケーラビリティと高可用性

- 2.4 テスト環境から本番環境への移行

3 Oracle User Messaging Serviceドライバ

- 3.1 電子メール・ドライバ

- 3.1.1 スケーラビリティに関する注意事項

- 3.1.2 高可用性に関する注意事項

- 3.1.3 互換性に関する注意事項

- 3.1.4 UMS APIプログラマに対する注意事項

- 3.2 SMS (SMPP)ドライバ

- 3.2.1 スケーラビリティに関する注意事項

- 3.2.2 高可用性に関する注意事項

- 3.2.3 互換性に関する注意事項

- 3.2.4 UMS APIプログラマに対する注意事項

- 3.3 XMPPドライバ

- 3.3.1 スケーラビリティに関する注意事項

- 3.3.2 高可用性に関する注意事項

- 3.3.3 互換性に関する注意事項

- 3.3.4 UMS APIプログラマに対する注意事項

- 3.4 拡張ドライバ

- 3.4.1 スケーラビリティに関する注意事項

- 3.4.2 高可用性に関する注意事項

- 3.4.3 互換性に関する注意事項

- 3.4.4 UMS APIプログラマに対する注意事項

- 3.5 Twitterドライバ

- 3.5.1 スケーラビリティに関する注意事項

- 3.5.2 高可用性に関する注意事項

- 3.5.3 互換性に関する注意事項

- 3.5.4 UMS APIプログラマに対する注意事項

- 3.6 APNSドライバ

- 3.6.1 スケーラビリティに関する注意事項

- 3.6.2 高可用性に関する注意事項

- 3.6.3 互換性に関する注意事項

- 3.6.4 UMS APIプログラマに対する注意事項

- 3.6.4.1 プッシュ通知の送信

- 3.6.4.2 追加のデータを指定したプッシュ通知の送信

- 3.6.4.3 追加のカスタム・データを指定したプッシュ通知の送信

- 3.6.4.4 RAW JSONデータを指定したプッシュ通知の送信

- 3.6.4.5 RAW JSONデータとMDMペイロードを指定したプッシュ通知の送信

- 3.6.4.6 到達できないデバイス・トークンの受信

- 3.6.4.7 Unicode文字を使用したプッシュ通知の送信

4 Oracle User Messaging Serviceの構成

- 4.1 ユーザー・メッセージング・サービスの構成ページへのアクセス

- 4.2 ユーザー・メッセージング・サーバーの構成

- 4.3 ユーザー・メッセージング・サービス・ドライバの構成

- 4.3.1 ドライバの構成

- 4.3.1.1 ドライバ・プロパティの概要

- 4.3.1.2 パスワードの保護

- 4.3.1.3 メッセージング拡張ドライバの構成

- 4.3.1.4 電子メール・ドライバの構成

- 4.3.1.5 SMPPドライバの構成

- 4.3.1.6 XMPPドライバの構成

- 4.3.1.7 Twitterドライバの構成

- 4.3.1.8 APNSドライバの構成

- 4.4 LDAPユーザー・プロファイルへのユーザー・メッセージング・サービスのアクセスの構成

- 4.5 グループ・メッセージングのためのOracle User Messaging Serviceの使用

- 4.6 メッセージの自動再送信の構成

- 4.7 Oracle User Messaging Serviceの保護

- 4.7.1 通知に関するWebサービス・セキュリティ

- 4.7.2 UMS Webサービス・セキュリティの有効化

- 4.7.3 クライアント・セキュリティの有効化

- 4.7.4 キーストア構成

- 4.7.5 クライアント別名

- 4.7.6 JMSリソースの保護

5 Oracle User Messaging Serviceの監視

- 5.1 Oracle User Messaging Serviceの監視

- 5.1.1 メッセージ・ステータスの使用

- 5.1.2 メッセージング・クライアント・アプリケーションの登録解除

- 5.2 ログ・ファイルの表示

- 5.2.1 ロギングの構成

- 5.3 メトリックおよび統計の表示

6 Oracle User Messaging Serviceの管理

- 6.1 ドライバのデプロイ

- 6.1.1 Fusion Middleware構成ウィザードを使用したドライバのデプロイ

- 6.2 UMSスキーマ・パージ・スクリプトの使用方法

- 6.2.1 UMS DBスキーマ・レコードのパージ

7 Oracle User Messaging Serviceのトラブルシューティング

A 11gから12cへのユーザー・メッセージング・サービスのアップグレード

B AQ JMSを設定したユーザー・メッセージング・サービスの構成

はじめに

このガイドでは、Oracle User Messaging Service (UMS)の管理方法について説明します。この内容には、ユーザー・メッセージング・ドライバや他のコンポーネントを構成およびデプロイする方法、UMSでセキュリティを有効にする方法、Oracle Enterprise Manager Fusion Middleware Controlを使用してUMSを監視する方法などが含まれます。

対象読者

このドキュメントは、UMSの構成や監視を担当するUMS管理者を対象としています。

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

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご購入の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 Infrastructureリリース・ノート

- Oracle User Messaging Serviceによるアプリケーションの開発

- ユーザー・メッセージング・サービスJava APIリファレンス

- インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

Oracle User Messaging Serviceの新機能

この章では、Oracle User Messaging Service (UMS)の機能と改良点について説明します。次のトピックでは、UMSの新機能および変更された機能と、このガイドに記載されているその他の重要な変更について紹介し、詳細情報の参照先を示します。

リリース12c (12.2.1)の新機能と変更された機能

- 複数の構成のサポート: UMSでは、デプロイされたドライバの単一インスタンスに対して複数の構成がサポートされています。これにより、ドメイン内の特定のドライバのインスタンスを複数デプロイしなくても、そのドライバの1つのインスタンスを異なる方法で構成できます。この機能の詳細は、第4.3項「ユーザー・メッセージング・サービス・ドライバの構成」を参照してください。

- クラスタ・レベルおよびドメイン・レベルのドライバの構成: UMSでは、サーバー・レベルおよびクラスタ・レベルでのドライバの構成がサポートされています。クラスタは、UMSでサポートされる最も細かいレベルの構成です。この機能の詳細は、第4.2項「ユーザー・メッセージング・サーバーの構成」を参照してください。

- ユーザーが展開可能なサーバー・グループを使用したドライバのデプロイ: 追加ドライバをデプロイするには、ドメインの更新時にFusion Middleware構成ウィザードで展開可能なサーバー・グループを使用します。詳細は、第6.1.1項「Fusion Middleware構成ウィザードを使用したドライバのデプロイ」を参照してください。

- ドライバのテスト: UMS 12.2.1では、構成ページで「テスト」ボタンがサポートされています。構成を保存する前に、このボタンをクリックして、構成プロパティが正しい形式であることを検証できます。

- メッセージ・ステータスの再送信: 12.2.1では、未送信のメッセージを再送信できます。

- 複数の電子メールIDおよびパスワードの拡張オプション: UMSは電子メール・ドライバで複数の受信IDおよびパスワードをサポートしています。

- Apple Push Notification Service (APNS)ドライバ: 12.2.1では、UMSはAPNSドライバをサポートしています。UMSメッセージをAppleのiOSデバイス(iPhone、iPadなど)への通知として送信するためのサポートを提供します。詳細は、第3.6項「APNSドライバ」を参照してください。

- ASM (Automatic Service Migration): 12.2.1では、UMSはWebLogicの機能であるASM (Automatic Service Migration)をサポートしています。

- ホワイトリスト: 12.2.1では、UMSホワイトリストが送信メッセージに使用され、UMSホワイトリストに明示的にリストされている受信者を除くすべての送信をブロックできるようになっています。UMSホワイトリストは、WLSTコマンドを使用してプロビジョニング、有効化または無効化します。

- SMPPドライバでの英数字の送信者アドレスの使用: 12.2.1では、SMPPドライバの場合、送信者アドレスを英数字のアドレスにして、たとえば、送信者を会社名にするために使用できます。

1 Oracle User Messaging Serviceの概要

この章では、Oracle User Messaging Service (UMS)について説明します。この章の内容は次のとおりです。

- 第1.1項「概要」

- 第1.2項「Oracle User Messaging Serviceの構成の概要」

- 1.3項「非推奨の機能」

1.1 概要

UMSによって、ユーザーとデプロイされたアプリケーション間の双方向の通信が可能になります。主な機能は次のとおりです。

- 様々なメッセージング・チャネルに対するサポート: メッセージは、電子メール、インスタント・メッセージ(IM) (XMPP)、ショート・メッセージ・サービス(SMS) (SMPP)などの各種チャネルを介して送受信できます。

- 双方向メッセージング: アプリケーションからユーザーへのメッセージ送信(アウトバウンド・メッセージングとも呼ばれる)以外に、ユーザーは、メッセージングの相互作用(インバウンド・メッセージング)を開始できます。たとえば、ユーザーが特定のアドレスに電子メールまたはテキスト・メッセージを送信すると、そのメッセージは適切なアプリケーションにルーティングされ、次に、アプリケーションでは、ビジネス・ロジックに従ってユーザーに応答するか、または別のプロセスを起動します。

- ユーザー・メッセージング・プリファレンス: エンド・ユーザーは、Webインタフェースを使用して、メッセージング通知の受信方法と受信時間に関するプリファレンスを定義できます。アプリケーションでは、ユーザーの電子メール・アドレスやIMクライアントへの送信を判断せずに、その柔軟性によって、単にメッセージをユーザーに送信し、その先のメッセージのルーティングをユーザーのプリファレンスに従ってUMSに任せます。

注意:
ユーザー・メッセージング・プリファレンスのUIは、http://host:port/sdpmessaging/userprefs-uiまたはhttps://host:sslport/sdpmessaging/userprefs-uiで入手できます。

- 強力なメッセージ配信: UMSは、メッセージング・ゲートウェイが提供する配信ステータス情報を継続して記録し、アプリケーションにこの情報を提供しているため、アプリケーションは失敗した配信に対応できます。また、アプリケーションでは、初期のアドレスへの配信が失敗した場合に備えて、メッセージに対して1つ以上のフェイルオーバー・アドレスを指定できます。UMSのフェイルオーバー機能を使用することで、アプリケーション開発者は、複雑な再試行ロジックの実装から解放されます。この再試行ロジックは、12cで導入された自動再送信機能でもサポートされます。

- Oracle Fusion Middleware内の広範な統合: UMSは、他のFusion Middlewareコンポーネントと統合して、単一の統合された双方向のユーザー・メッセージング・サービスを提供します。

- Oracle BPEL Process Managerとの統合: Oracle JDeveloperには、メッセージング操作に対応した事前作成のBPELアクティビティが含まれています。開発者は、目的のアクティビティを任意のワークフローにドラッグ・アンド・ドロップして、メッセージング機能をSOAコンポジット・アプリケーションに追加できます。

- ヒューマン・ワークフローとの統合: UMSによって、ヒューマン・ワークフロー・サービス・エンジンは、アクション可能なメッセージをユーザーに送信し、電子メールを介して返信を受信できるようになります。

- Oracle BAMとの統合: Oracle BAMでは、UMSを使用し、イベントの監視に対応した電子メール・アラートを送信します。

- Oracle WebCenter Portalとの統合: 開発者は、Oracle WebCenter Portal: スペースに対するアプリケーションの作成にUMS APIを使用できます。Oracle WebCenter Portalの詳細は、Oracle Fusion Middleware Oracle WebCenter Portalでのポータルの構築を参照してください。

1.1.1 コンポーネント

UMSを構成するコンポーネントには、次の3つのタイプがあります。これらのコンポーネントは標準のJava EEアプリケーションであるため、デプロイが容易であり、Oracle WebLogic Serverが提供する標準のツールを使用して管理できます。

- UMSサーバー: UMSサーバーは、アプリケーションとユーザー間のメッセージ・フローを統合します。このサーバーは、アウトバウンド・メッセージをクライアント・アプリケーションから適切なドライバにルーティングし、インバウンド・メッセージを適切なクライアント・アプリケーションにルーティングします。また、このサーバーは、以前送信したメッセージのリポジトリを永続ストアで保守し、配信ステータスの情報を以前送信したメッセージに関連付けます。

- UMSドライバ: UMSドライバは、UMSをメッセージング・ゲートウェイに接続し、UMSでサポートされている様々なプロトコルに対してコンテンツを適合させます。これらのドライバは、特定のインストールで使用できるメッセージング・チャネルに従って、相互に独立してデプロイまたはアンデプロイできます。

- UMSクライアント・アプリケーション: UMSクライアント・アプリケーションは、メッセージの送受信に関するビジネス・ロジックを実装します。UMSクライアント・アプリケーションは、BPELワークフローの1手順としてメッセージを送信するSOAアプリケーション、またはWebインタフェースからメッセージを送信できるWebCenterポータル・スペース・アプリケーションの場合があります。

UMS自体を構成するコンポーネントに加え、メッセージング環境における他の主なエンティティは、各メッセージング・チャネルに必要な外部ゲートウェイです。これらのゲートウェイは、UMSまたはOracle WebLogic Serverの一部ではありません。UMSドライバは、広範に適合できるメッセージング・プロトコルをサポートしているため、企業の電子メール・サーバーやXMPP (Jabber)サーバーなどの既存のインフラストラクチャにUMSを統合できます。または、SMPPがサポートされているSMSサービスの外部プロバイダにUMSを接続できます。

1.1.2 アーキテクチャ

図1-1に、UMSのシステム・アーキテクチャを示します。

12cでは、UMSはJRFの一部として使用できます。そのため、上位スタックと簡単に統合できます。JRFテンプレートを使用したドメインの構成の詳細は、『Oracle Fusion Middleware Oracle Fusion Middleware Infrastructureのインストールと構成』の「Oracle Fusion Middleware Infrastructureドメインの構成」の章を参照してください。

柔軟性を最大にするために、UMSの各コンポーネントは、それぞれが個別のJava EEアプリケーションです。このため、それらは相互に独立してデプロイおよび管理できます。たとえば、他のすべてのチャネルでのメッセージ配信に影響を与えずに、特定のドライバを停止して再構成できます。

UMSクライアント・アプリケーションとUMSサーバー間のデータ交換は、SOAP/HTTP WebサービスによるUMS WebサービスAPIクライアントのリクエスト時に発生するか、リモートのEnterprise JavaBeans (EJB)とJMSによるUMS Java APIクライアントのコールを介して発生します。UMSサーバーとUMSドライバ間のデータ交換は、JMSキューを介して発生します。

図1-1 UMSのアーキテクチャ

1.2 Oracle User Messaging Serviceの構成の概要

UMSでメッセージの送受信ができるようにするには、Oracle Enterprise Manager Fusion Middleware Controlを使用してドメインまたはクラスタで適切なドライバを構成し、UMSの環境を設定します。図1-2を参照してください。UMSには、電子メール、IM、SMSなどの各種チャネルを介したメッセージングをサポートするドライバが組み込まれています。UMSの構成の詳細は、第4章「Oracle User Messaging Serviceの構成」を参照してください。

図1-2 Oracle Enterprise Manager Fusion Middleware Control

ワークフローの参加者が通知を受信するには、メッセージのアクセスに使用するデバイスをユーザー通信プリファレンスを介して登録する必要があります。詳細は、『Oracle Fusion Middleware Oracle User Messaging Serviceによるアプリケーションの開発』の「ユーザー通信プリファレンス」を参照してください。

注意:
APIの一部の詳細は、基礎となるプロトコルによって異なる場合があります。管理ガイド(http://docs.oracle.com/middleware/1213/ums/administer/ns_descriptions.htm#UMSAG97610)のドライバの説明の章、特に「UMS APIプログラマ・ノート」に関する項を学習してください。

1.3 非推奨の機能

次の機能は12.2.1リリースで非推奨となった機能です。

- UMSプロキシ・ドライバ

- UMS VoiceXMLドライバ

- UMSワークリスト・ドライバ

- UMS EJB API

- UMS Parlay Xマルチメディア・メッセージングAPI

2 Oracle User Messaging Serviceのスタート・ガイド

この章は、Oracle User Messaging Service (UMS)の使用を開始する上での一助となります。UMSのインストール方法とアップグレード方法について説明します。また、高可用性の実現とテスト環境から本番環境への移行に必要な手順について説明します。

この章では、次の項目について説明します。

- 第2.1項「ユーザー・メッセージング・サービスのインストール」

- 第2.2項「ユーザー・メッセージング・サービスのアップグレード」

- 第2.3項「スケーラビリティと高可用性」

- 第2.4項「テスト環境から本番環境への移行」

2.1 ユーザー・メッセージング・サービスのインストール

UMSのインストールおよび構成の詳細は、『Oracle Fusion Middleware Oracle Fusion Middleware Infrastructureのインストールと構成』を参照してください。UMSのインストールは、主に次の手順で構成されています。

- リポジトリ作成ユーティリティ(RCU)の実行によるデータベース・スキーマの作成
RCUを実行したら、コンポーネントのリストで「ユーザー・メッセージング・サービス」を選択します。データベース・スキーマの作成の詳細は、『Oracle Fusion Middleware Oracle Fusion Middleware Infrastructureのインストールと構成』の「Oracle Fusion Middleware Infrastructureドメインの構成」を参照してください。

- UMSテンプレートを使用したドメインの拡張
UMSテンプレートは、ORACLE_HOME/oracle_common/common/templates/wlsにあります。UMSテンプレートの詳細は、『Oracle Fusion Middlewareドメイン・テンプレート・リファレンス』を参照してください。WebLogic Server構成ウィザードで、oracle.ums.basic_template.jarを使用してドメインを拡張し、UMS JDBCプロパティを設定し、選択したドライバとともにUMSサーバーを管理対象のサーバーまたはクラスタにターゲット設定します。Oracle User Messaging Service基本テンプレートは、管理対象サーバーums_server1を定義し、すべてのUMSコンポーネントをそのサーバーにターゲット設定するクイック・スタート・テンプレートです。

注意:
UMSクライアントAPIは、UMSクライアント・アプリケーションが参照する必要がある共有ライブラリにパッケージされています。この共有ライブラリは、UMSサーバーおよびJRFテンプレートがインストールされている場所で使用できます。ただし、クライアント・アプリケーションがUMS以外の管理対象サーバーで稼働していて、UMS WebサービスAPIが使用されているとき、JRFテンプレートを使用しない場合は、クライアント共有ライブラリを明示的にデプロイする必要があります。これを実現するには、$ORACLE_HOME/common/templates/wls/oracle.ums.client_template.jarで入手可能なUMSクライアントAPIテンプレートを使用して、クライアント・アプリケーションがデプロイされるドメインを拡張します。UMSクライアントAPI共有ライブラリはoracle.sdp.clientと呼ばれます。

2.2 ユーザー・メッセージング・サービスのアップグレード

UMS 12cへのアップグレードの詳細は、Oracle Fusion Middleware Oracle Fusion Middleware Infrastructureへのアップグレードを参照してください。

UMSには、Oracle Fusion Middleware Upgrade Assistantへのスキーマ・アップグレード・プラグインと構成アップグレード・プラグインが用意されています。構成アップグレード・プラグインでは、11gのアプリケーション・レベル構成から12cのドメイン・レベル構成への変更を処理します。これには、リモート管理対象サーバーから管理サーバーへのアプリケーション構成のコピーや、UMSドメイン・レベル構成ファイルへのアプリケーション構成のマージなどがあります。詳細は、付録A「11gから12cへのユーザー・メッセージング・サービスのアップグレード」を参照してください。アップグレード・アシスタントを使用した11gから12cへのアップグレードの詳細は、Oracle Fusion Middleware Upgrade Assistantによるアップグレードを参照してください。

2.3 スケーラビリティと高可用性

UMSに対してスケーラビリティの高い環境を実現できます。高いスケーラビリティを実現するために、UMSではまったく同じに構成された新しいノードを追加して水平方向に規模を拡大します。つまり、同じタイプのドライバおよびUMSアプリケーションが各ノードにデプロイされます。これで、JMSのスケーラビリティまたはデータ・ストレージのスケーラビリティが制限要因となるところまでUMSの線形スケーラビリティが実現します。

WS-UMSサーバー・アプリケーション・コンポーネントはUMSノードにデプロイされるため、UMSノードと同じように規模を拡大します。一方、WS-UMSクライアント・アプリケーションは別のマシンにデプロイされるため、スケーラビリティはそのコンポーネントの設計次第です。

UMSでは、環境の規模を拡大するための次のデプロイメント・シナリオに対応しています。

- ドメインにデプロイされたUMSのインスタンスをまったく同じに構成し、デプロイする場合。サーバー数にもドメイン/クラスタの設定方法にも制限はありません。

- ドメインにデプロイされた構成が異なるUMSのインスタンス(サーバーまたはドライバ、あるいはその両方)を別個のクラスタにデプロイする必要がある場合。

環境の規模拡大の詳細は、Oracle Fusion Middleware Oracle Fusion Middlewareの管理を参照してください。

サーバー全体の移行は、UMSでサポートされる主要な高可用性機能です。サーバー全体の移行の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverクラスタの管理』を参照してください。

UMSの高可用性は、次の方法によって実現できます。

- 外部ゲートウェイへの自動再接続

- メッセージの再送信とフェイルオーバー・チェーン

- データベース接続問題を処理する永続性レイヤー・リカバリ

高可用性の詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

2.4 テスト環境から本番環境への移行

このフレームワークにより、テスト環境から本番環境へのOracle Fusion Middlewareコンポーネントの移行が容易になります。テスト環境から本番環境へのOracle Fusion Middlewareの移行に使用する手順の詳細は、Oracle Fusion Middleware Oracle Fusion Middlewareの管理を参照してください。

テスト環境の構成のほとんどは、このフレームワークによって自動的に処理されます。カスタム・アクションが必要なコンポーネントは、T2Pプラグインでこれらを実装します。UMSには、このフレームワークに対するT2Pプラグインが用意されています。ユーザー・プリファレンスのデータの一部は、データベースに格納され、テスト・データベースから本番データベースにそのデータを移動するためにT2Pプラグインを必要とします。また、T2Pプラグインにより、本番システムの起動前に本番環境用の設定を準備できるように、ホスト名やポートなどの事前に選択したドライバ構成プロパティがmoveplan.xmlファイルに抽出されます。

テスト環境から本番環境への移行の詳細は、Oracle Fusion Middleware Oracle Fusion Middlewareの管理を参照してください。

3 Oracle User Messaging Serviceドライバ

この章では、Oracle User Messaging Service (UMS)ドライバの用途、機能および制限事項について説明します。次のUMSドライバについて説明します。

- 第3.1項「電子メール・ドライバ」

- 第3.2項「SMS (SMPP)ドライバ」

- 第3.3項「XMPPドライバ」

- 第3.4項「拡張ドライバ」

- 第3.5項「Twitterドライバ」

- 第3.6項「APNSドライバ」

UMSドライバには、電子メール・サーバーやショート・メッセージ・サービス・センター(SMSC)など、様々なメッセージング・ゲートウェイにUMSを接続するためのプロトコル固有の実装が含まれています。ドライバは、特定のインストールでメッセージング・チャネルの可用性に応じて、個別にデプロイまたはアンデプロイできます。

3.1 電子メール・ドライバ

電子メール・ドライバは、メッセージを送受信します。すべての関連する電子メール・プロトコル(電子メールの送信にはSMTP、電子メールの受信にはIMAPおよびPOP3)がサポートされ、あらゆる標準メール・サーバーと通信できます。セキュリティ・プロトコルのTLSまたはSSLを有効にして電子メールのコンテンツを通信時に保護するためのサポートが実装されています。電子メール・ドライバでは、必要なプロトコルおよびクライアントを実装する標準のJavaコンポーネントであるJavaMail v1.4を使用して、電子メールの作成、アクセス、送受信を実行します。

電子メール・ドライバでは、マルチスレッド設計を使用して複数のメール・ボックスを(IMAPまたはPOP3プロトコルで)ポーリングできます。ポーリングするメール・ボックスが1つしかない場合、この設計のため、そのメール・ボックスで機能するスレッドが1つのみになるという制限事項が1つあります。

注意:
POP3は非推奨となったプロトコルであり、使用しないようにしてください。

3.1.1 スケーラビリティに関する注意事項

電子メール・ドライバは、複数のノードにスケール・アウトできます。

3.1.2 高可用性に関する注意事項

電子メール・サーバーへの接続に失敗すると、電子メール・ドライバは待機して再試行します。待機期間および最大試行回数は構成できます。

3.1.3 互換性に関する注意事項

電子メール・ドライバは、POP3、IMAP4およびSMTPの各プロトコルと互換性があります。表3-1に、電子メール・ドライバのゲートウェイ・ベンダーとそのバージョンを示します。

表3-1 電子メール・ドライバのゲートウェイ・ベンダーとバージョン

ベンダー

バージョン

Oracle Beehive

リリース1 (1.4.3)

Oracle Collaboration Suite

10gリリース1 (10.1.2)

Microsoft Exchange

2003

Dovecot (IMAP4/POP3)

0.99.11

sendmail (SMTP)

8.13.1

UMSメッセージのAPI優先度レベルは、次のように電子メール・メッセージ・ヘッダーのX-Priorityに変換されます。

MessagePriorityType.LOWEST => header value "5"
MessagePriorityType.LOW => header value "4"
MessagePriorityType.NORMAL => header value "3"
MessagePriorityType.HIGH => header value "2"
MessagePriorityType.HIGHEST => header value "1"

3.1.4 UMS APIプログラマに対する注意事項

電子メール・ドライバでは、ヘッダー、コンテンツ・タイプと文字セット・エンコーディング、MIMEマルチパートと本文パートを含め、UMSメッセージから電子メール・メッセージへ(およびその逆)の変換を処理します。着信メッセージの場合、UMSメッセージの受信者はそのメールを受信した電子メール・ボックスの電子メール・アドレスです。受信者が電子メールの宛先、CCまたはBCCのフィールドに入っていたかどうかは、Addressメタデータを見るとわかります。

アウトバウンド電子メールが配信できない場合、受信者のメール・サーバーで配信状態通知(DSN)を作成し、送信者の電子メール・アドレスに返信することができます。電子メール・ドライバでは、受信したDSNとDSNで参照しているアウトバウンド電子メールと照合し、そのアウトバウンド・メッセージの"配信失敗"ステータスを作成しようとします。このような場合、配信成功ステータスがしばらくすると配信失敗ステータスに変ることがあります。

3.2 SMS (SMPP)ドライバ

ショート・メッセージ・ピアツーピア(SMPP)プロトコルは、ショート・メッセージ・サービス・センター(SMS-C)、外部ショート・メッセージング・エンティティ(ESME)などのSMSピア・エンティティ間でSMSメッセージを交換するためのTCP/IPベースの業界プロトコルです。UMS SMPPドライバは、ESMEとして実装されます。SMPPプロトコルv3.4に基づいています。

送信機能が有効な場合、SMPPドライバは送信用の送信側システムとしてSMS-CへのTCP接続を1つ開きます。ドライバの受信機能が有効な場合は、受信用の受信ドライバとしてSMS-Cに別の接続を開きます。ドライバとSMS-C間のすべての通信に必要なのは、2つのTCP接続(両方ともドライバが開始する)のみです。

3.2.1 スケーラビリティに関する注意事項

SMPPドライバは、複数のノードにスケール・アウトできます。SMS-Cで同じアカウントによる複数のログインを許可しない場合のみ、制限事項があります。

3.2.2 高可用性に関する注意事項

SMS-Cへの接続が失われると、SMPPドライバは一定の間隔をあけて再接続しようとします。

3.2.3 互換性に関する注意事項

SMPPドライバはSMPPプロトコルv3.4に基づいています。表3-2に、SMPPドライバのゲートウェイ・ベンダーを示します。

表3-2 SMPPドライバのゲートウェイ・ベンダー

ベンダー

Syniverse

Clickatell

Logica CMG

OpenSMPP (simulator)

3.2.4 UMS APIプログラマに対する注意事項

送信テキスト・メッセージは、UMSメッセージの件名とコンテンツを連結したものです。着信SMSのコンテンツは、UMSメッセージのコンテンツに挿入されます。UMSメッセージの件名は空になります。

UMSメッセージのAPI優先度レベルは、次のようにSMPPの優先度に変換されます。

MessagePriorityType.LOWEST、MessagePriorityType.LOW、MessagePriorityType.NORMAL => SMPPの優先度: 0

MessagePriorityType.HIGH => SMPPの優先度: 1

MessagePriorityType.HIGHEST => SMPPの優先度: 2

ただし、SMPPの優先度は、SMPPドライバの構成パラメータ"PriorityAllowed"によって制限されることがあります。

SMPPドライバは、UMS API MessageInfoの"有効期限"データを受け入れ、メッセージとともにその情報をSMS-Cに渡します。

3.3 XMPPドライバ

XMPPドライバは、Extensible Messaging and Presence Protocol (XMPP)を介したリアルタイムIMの場合に、Oracle Fusion Middlewareからエンド・ユーザーへの一方向または双方向のアクセスを提供します。このドライバを使用すると、エンド・ユーザーは、選択したIMクライアントを介して、アラート通知を受信したり、複数のアプリケーションと相互にチャットすることができます。

XMPPは、IM用のオープンXMLベースのプロトコルで、クライアント/サーバー・アーキテクチャで構成されており、ユビキタス電子メール・ネットワークに似ています。受信者は、[username]@domain[/resource]形式のXMPP ID (またはJabber ID (JID))によってアドレス指定されます。UMSでXMPPドライバを使用するには、Jabber/XMPPサーバーへのアクセス権と、ログインに使用するUMS XMPPドライバ・インスタンスのXMPPアカウントが必要です。

XMPPのエンド・ユーザーは、XMPPクライアントを使用してXMPPサーバーに接続して、インスタント・メッセージを他のXMPPユーザーに送信します。ただし、XMPPはIMに利用できる唯一のプロトコル・ネットワークではありません。XMPPには、拡張可能なモジュール型アーキテクチャがあります。これは固有のIMネットワークに統合され、XMPPユーザーは他のネットワーク上のユーザーと通信できるようになります。

3.3.1 スケーラビリティに関する注意事項

XMPPサーバーでは複数のドライバ(つまりクライアント)を使用して同じアカウントにアクセスできないため、XMPPドライバは複数のサーバーにスケール・アウトできません。2つ目のドライバがログインすると、XMPPサーバーでは最初のドライバが切断されます。しばらくして最初のドライバが再接続し、2番目のドライバが切断される、というようになります。この設定では、送信メッセージは、メッセージを処理するドライバがその特定の瞬間に接続している場合のみ機能します。

3.3.2 高可用性に関する注意事項

XMPPサーバーに対する接続問題がある場合、XMPPドライバは、リモート・サーバーに再接続しようとし続けますが、緊密なループを回避するために遅延が大きくなります。

3.3.3 互換性に関する注意事項

XMPPドライバのゲートウェイ・ベンダーとそのバージョンを示します。

表3-3 XMPPドライバのゲートウェイ・ベンダーとバージョン

ベンダー

バージョン

ejabberd

2.1.3

jabberd2

2.2.14

jabberd14

1.6.1.1-p1

Oracle Beehive

2.0.1.2.1

3.3.4 UMS APIプログラマに対する注意事項

XMPPには、UMSメッセージの件名とコンテンツに対応する件名と本文の概念があります。

3.4 拡張ドライバ

拡張ドライバは、UMSで定義されたNotification WebServicesインタフェースを実装する構成済エンドポイントURLにメッセージを送信します。メッセージング・ゲートウェイ(ゲートウェイに対するアダプタ)ではこのWebサービスを実装できるため、UMSで変更しなくてもUMSが拡張されます。

また、拡張ドライバでは、Oracleのワークフローおよびコラボレーション製品の1つであるATKポップアップ・サービスなどのADFビジネス・コンポーネントのWebアプリケーションへのメッセージ送信がサポートされています。実行時に、拡張ドライバでは、構成済エンドポイントURLがNotification WebServiceであるかATKポップアップ・サービスであるかを検出し、それに応じて動作します。

拡張ドライバは、送信メッセージに対してのみ使用されます。

3.4.1 スケーラビリティに関する注意事項

拡張ドライバは、複数のノードにスケール・アウトできます。

3.4.2 高可用性に関する注意事項

ドライバは、WebServicesコール経由で外部システムと通信し、エンドポイントURLのホスト部分は仮想IPです。つまり、外部システムはロード・バランサの背後にあります。

3.4.3 互換性に関する注意事項

該当なし

3.4.4 UMS APIプログラマに対する注意事項

UMSメッセージのコンテンツは、バイナリではなく、テキストにする必要があります。拡張ドライバを使用してUMSで新しいプロトコルを有効にするには、次のタスクを実行します。

1. MessagingNotifyService WSDL (umsnotify.wsdl)を基に、Webサービス・リスナー・エンドポイントを実装およびデプロイします。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://xmlns.oracle.com/ucs/messaging/extension"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
name="MessagingNotifyService"
targetNamespace="http://xmlns.oracle.com/ucs/messaging/extension">

<wsdl:types>

<xsd:schema targetNamespace="http://xmlns.oracle.com/ucs/messaging/extension">
<xsd:element name="notification">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="messageId" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Unique message identifier from User
Messaging Service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="sender" type="xsd:string">
<xsd:annotation>
<xsd:documentation>The sender address.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="recipient" type="xsd:string">
<xsd:annotation>
<xsd:documentation>The recipient address (typically
username).</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="subject" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The subject of the message, if
available.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="contentType" type="xsd:string"
default="text/plain">
<xsd:annotation>
<xsd:documentation>The MIME type of the message. e.g.
text/plain, text/html, text/xml.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="content" type="xsd:string">
<xsd:annotation>
<xsd:documentation>The main body of the message. Textual
content only (no binary content).</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="parameters" type="tns:parameter" minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Additional key-value pairs. This interface
does not define any specific key-value pair meanings. Use of such parameters
is defined on a private basis by particular implementations of this interface.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="parameter">
<xsd:sequence>
<xsd:element name="name" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Parameter name</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="value" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Parameter value</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:element name="notificationResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="messageId" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>A message identifier returned in response to
successfully accepting the message. If returned, the identifier should be
unique. Note: A fault is raised if the message cannot be
accepted.</xsd:documentation>
</xsd:annotation></xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="notificationFault">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="code" type="xsd:string"/>
<xsd:element name="message" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
</wsdl:types>
<wsdl:message name="notifyRequest">
<wsdl:part element="tns:notification" name="parameters" />
</wsdl:message>
<wsdl:message name="notifyResponse">
<wsdl:part element="tns:notificationResponse" name="parameters"/>
</wsdl:message>
<wsdl:message name="notifyException">
<wsdl:part element="tns:notificationFault" name="parameters"/>
</wsdl:message>
<wsdl:portType name="Notify">
<wsdl:operation name="invoke">
<wsdl:input message="tns:notifyRequest"/>
<wsdl:output message="tns:notifyResponse"/>
<wsdl:fault message="tns:notifyException" name="NotifyException"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="NotifySOAPBinding" type="tns:Notify">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="invoke">
<soap:operation
soapAction="http://www.oracle.com/ucs/messaging/extension" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
<wsdl:fault name="NotifyException">
<soap:fault name="NotifyException" use="literal"/>
</wsdl:fault>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="NotifyService">
<wsdl:port binding="tns:NotifySOAPBinding" name="Notify">
<soap:address location="http://localhost:8001/NotifyService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

2. 次のタスクを実行して、拡張ドライバを構成します。

1. usermessagingdriver-extensionという事前デプロイ済の拡張ドライバ(または新しいデプロイメント)を、UMS (usermessagingserver)が稼働している適切なサーバーにターゲット設定して、ドライバを起動します。

2. Enterprise Manager Fusion Middleware Controlで、usermessagingserverのホーム・ページに移動します。

3. 「ユーザー・メッセージング・サービス」をクリックし、「ドライバ・プロパティ」に移動します。

4. ドライバusermessagingdriver-extensionを選択して編集するか、新しいドライバ・デプロイメントと同じ名前で新しいドライバを作成します。

5. 「ドライバ固有の構成」で、新しい拡張エンドポイント構成グループを追加してプロパティを指定します。EndpointURLは、手順1で作成したWebサービス・リスナー・エンドポイントへのURLです。Protocolは、通知サポートを追加する新しいメッセージング・チャネルの値(myProtocolなど)です。

6. 「共通構成」で、Supported Protocolsを、各拡張エンドポイント・グループに定義されているプロトコルのカンマ区切りのリストで更新します。

7. 「OK」をクリックして、構成を保存します。
これで、拡張ドライバを使用したUMSでの新しいメッセージング・チャネル(プロトコル)の構成および統合は完了です。

この新しいチャネル(プロトコル)に通知を送信するには、次のURIアドレッシング形式を使用して、URI配信タイプに受信者を指定する必要があります。

URI:scheme:scheme-specific-address-value

ここで、schemeはプロトコルです。URI配信タイプはオプションです。たとえば、拡張ドライバがプロトコルmyProtocolをサポートするように構成されている場合、アプリケーションでmyProtocol:john.doe@example.com宛のメッセージを作成できます。

また、エンド・ユーザーは、「ユーザー通信プリファレンス」UIで新しいチャネル・タイプの新しいメッセージング・チャネルを作成することによって、メッセージング・プリファレンスを宣言することもできます。ユーザー・プリファレンスは、アプリケーションがユーザーベースの通知(つまり、USER:usernameの形式の受信者宛)を送信する場合にのみ適用されます。

3.5 Twitterドライバ

Twitterドライバは、Twitter APIサーバーと通信するUMSドライバです。Twitterサーバーとの双方向のメッセージング・サービスを提供します。そのため、Twitterドライバを使用すると、アプリケーション・ユーザーはTwitterフィードを公開し、これに対する応答を受信できます。

Twitterドライバの特徴は次のとおりです。

- 複数の認証モード: Twitter REST APIでは次の2種類の認証を使用できます。

- OAuth: これはシングル・サインオン・タイプの認証モードです。この認証モードはFusion Middleware Control (EM)のページから有効にできます。ドライバ固有のEMページで、「認証モード」パラメータをOauthに設定し、2組のキー、つまりカスタマ・キー、カスタマ・シークレット、アクセス・トークンおよびアクセス・トークン・シークレットを構成する必要があります。これらのキーの詳細は、表4-12「Twitterドライバのカスタム・プロパティ」を参照してください。

- xAuth: この認証モードはOAuthに基づいています。Twitterドライバは、OAuthの要件を満たしていないアプリケーションにのみxAuthを許可します。この認証モードを有効にするには、ユーザーがリクエストごとにユーザー名とパスワードを入力する必要があります。

- 複数のメッセージング・オプション: Twitterドライバを使用する場合に、ユーザーが目にするメッセージには次の2つのカテゴリがあります。

- アウトバウンド・メッセージ: UMSクライアント・アプリケーションからTwitterサーバーに送信されるメッセージをアウトバウンド・メッセージと呼びます。このメッセージはツイートまたはダイレクト・メッセージとして処理されます。

- ツイート: Twitterドライバに構成されているユーザー名に対して送信されるメッセージはツイートとして投稿されます。たとえば、TwitterドライバがユーザーTWという資格証明で構成されている場合、URI:twitter:TWに送信されるメッセージはすべて、ユーザーTWからのツイートとして投稿されます。

- ダイレクト・メッセージ: 構成済ユーザーのユーザー名から別のTwitterユーザーに送信されるメッセージはダイレクト・メッセージとして処理できます。Twitterでは、構成済ユーザーはそのユーザーの直接のフォロワにのみダイレクト・メッセージを送信できます。ダイレクト・メッセージの受信者がTwitterに登録されていないユーザーの場合、または送信者の直接のフォロワではない場合、メッセージの配信は失敗し、エラー・メッセージが表示されます。

- インバウンド・メッセージ: TwitterドライバがTwitterサーバーから受信するメッセージをインバウンド・メッセージと呼びます。インバウンド・メッセージには次のタイプがあります。

- タイムライン・メッセージ: これは構成済ユーザーまたは構成済ユーザーがフォローしているTwitterユーザーが投稿したツイートのリストです。

- ダイレクト・メッセージ: これは構成済ユーザーがフォーローするTwitterユーザーから構成済ユーザーに送信されたプライベート・メッセージです。

- ツイート・サイズの制限: Twitterでは各ツイートの長さが140バイトまでに制限されています。この制限を超えるツイートはTwitterサーバーで拒否されます。長いツイートの場合、Twitterサーバーに送信される前にTwitterドライバで切り捨てられます。

- ツイート頻度の制限: Twitterではユーザー当たりのツイート使用頻度が制限されています。Twitterの制限の詳細は、「About Twitter Limits」ページを参照してください。ユーザーの使用頻度がそのTwitterユーザーの頻度制限を超えると、アウトバウンド・メッセージの配信に失敗し、インバウンド・メッセージの受信は停止します。

UMSをファイアウォールの後方で使用する場合、WebLogic Serverのプロキシ設定を構成する必要があります。WebLogic Serverのプロキシ設定の構成に関する詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JAX-RPC Webサービス・スタート・ガイド』のシステム・プロパティを使用したプロキシ・サーバーの指定に関する項を参照してください。

3.5.1 スケーラビリティに関する注意事項

Twitterドライバは、複数のノードにスケール・アウトできます。

3.5.2 高可用性に関する注意事項

Twitterサーバーに対する接続問題がある場合、Twitterサーバーが正常な状態に戻るまで、Twitterドライバは4分に1回から16分に1回の低頻度でサーバーをポーリングします。正常動作では、ドライバは、1分に1回から4分に1回の頻度でTwitterサーバーをポーリングします。

Twitterでは、そのサービスの使用状況を積極的に監視します。ユーザーのリミットに達すると、理由を示すエラー・メッセージが表示され、そのクライアントがリクエストしたサービスの提供が許可されないことがあります。リミットはすべて現在のリミットのページに示されています。Twitterサーバーによって使用を制限されると、まずドライバは30分待機した後、4分に1回から16分に1回の低頻度でサーバーをポーリングします。

3.5.3 互換性に関する注意事項

Twitterドライバは12.1.2.0.0で導入されました。

3.5.4 UMS APIプログラマに対する注意事項

送信メッセージの場合、つまり、ツイートの投稿やダイレクト・メッセージの送信時、ツイート・テキストはUMSメッセージのコンテンツと連結されたUMSメッセージの件名です。着信ツイートおよびダイレクト・メッセージの場合、テキストはUMSメッセージのコンテンツに挿入されます。

表3-4に、アウトバウンド・メッセージに使用されるメタデータを示します。

ネームスペース: "UMS-TWITTER"

表3-4 Twitterドライバでアウトバウンド・メッセージに使用されるメタデータ

名前

説明

備考

retweet_id

リツイートされるメッセージのTwitter ID。このIDは、メッセージ/ツイートを受信すると入手できます。

このメタデータは、受信者のAddressオブジェクトに対するものです。

reply_to_id

返信するメッセージのTwitter ID。このIDは、メッセージ/ツイートを受信すると入手できます。

このメタデータは、受信者のAddressオブジェクトに対するものです。

geo_location

latitude,longitudeとして表される緯度と経度。latitudeとlongitudeはJavaプリミティブ・データ型doubleに変換されます。

このメタデータは、Messageオブジェクトに対するものです。

3.6 APNSドライバ

APNSドライバはユーザー・メッセージング・サービス(UMS) 12.2.1以降で使用できます。UMSメッセージをAppleのiOSデバイス(iPhone、iPadなど)への通知として送信するためのサポートを提供します。

APNSドライバの特徴は次のとおりです。

- アウトバウンド・メッセージ: UMSクライアント・アプリケーションからAppleのデバイスにAPNsを介して送信されるメッセージは、UMSの用語ではアウトバウンド・メッセージと呼ばれます。Appleの用語では「通知」です。受信者uri:apns:tokenに送信されたメッセージは、UMS APNSドライバによって処理されます。UMS APNSドライバは、受信者のアドレスからトークンを抽出して、空のApple Push Notification Payloadを作成します。UMSメッセージの情報に基づいて、Apple Push Notification Payloadが移入され、最後にAPNsに送信されます。

- サポートされる配信タイプ
配信タイプURIがサポートされます。プロトコルapnsがサポートされます。

- Mimeタイプがサポートされます。
Mimeタイプtext/plainおよびapplication/jsonがサポートされます。

- サポートされる配信ステータス・タイプ
UMS APIは様々なステータス・タイプを定義します。APNSドライバでは次のステータスが使用されます。

- DELIVER_TO_DRIVER_SUCCESS
さらなる処理のために、ドライバがメッセージを受信しました。

- DELIVERY_TO_GATEWAY_FAILURE
通知をAPNsに送信できません。

- DELIVERY_TO_GATEWAY_SUCCESS
通知がAPNsに送信されました。ただし、APNsは配信を保証せず、UMSはメッセージがデバイスに送信されたかどうかを認識しないため、APNSドライバがDELIVERY_TO_DEVICE_SUCCESSを返すことはありません。

- DELIVERY_TO_DEVICE_FAILURE
APNSドライバが、たとえば、使用されたアドレスが無効であることを見つけました。通常、ユーザーがそのデバイスでアプリケーションを登録解除しています。

- 外部プロトコルへのマッピング
表3-5は、UMSメッセージ・プロパティとAPNsプロトコルのマッピングを示しています。

表3-5 アウトバウンド・メッセージのGCMメタデータ

UMSメッセージ・プロパティ

APNsプロトコル

値のタイプ

説明

受信者のアドレス(例: 'uri:apns:token')

デバイス・トークン

UMSアドレス

受信者アドレスのトークンの部分は、APNsへのデバイス・トークンとして使用されます。

コンテンツ

alert

string

UMSメッセージ・テキストのコンテンツは、アラート・メッセージのペイロードとして使用されます。コンテンツ・タイプがtext/plainの場合、そのコンテンツはアラートに使用されます。メタデータ・プロパティ(次の表を参照)はペイロードに追加されます。コンテンツ・タイプがapplication/jsonの場合、そのコンテンツはそのままAPNsに渡され、メタデータ・プロパティは無視されます。

有効期限(MessageInfo)(秒単位)。デフォルトはzeroです。

expiry

integer

UMSプロパティの有効期限は、有効である期間を秒単位で指定します。ゼロまたは負の値は、メッセージが期限切れにならないことを意味します。有効期限が負の値またはゼロの場合、expiryはMAX_INTに設定され、それ以外の場合、expiryプロパティは現在の時間(秒単位)に有効期限を足した値として計算されます。

配信される前に期限切れになったプッシュ通知は失敗した配信と見なされず、フィードバック・サービスに影響しません。

件名

-

-

UMSメッセージの件名は無視されます。

表3-6は、オプションのUMSメッセージ・メタデータを示しています。

表3-6 オプションのUMSメッセージ・メタデータ

名前

説明

badge

アプリケーション・アイコンのバッジとして表示される番号。このプロパティがない場合、バッジは変更されません。バッジを削除するには、このプロパティの値に0を設定します。

sound

アプリケーション・バンドルのサウンド・ファイルの名前。このファイルのサウンドはアラートとして再生されます。サウンド・ファイルが存在しないか、default.aiffが値として指定されている場合は、デフォルトのアラート・サウンドが再生されます。

action-loc-key

文字列を指定した場合は、2つのボタンを持つアラートが表示されます。ただし、iOSは文字列をキーとして使用し、「表示」のかわりに右ボタンのタイトルに使用するために、現在のローカリゼーションにローカライズされた文字列を取得します。値がnullの場合、単一のOKボタンを持つアラートが表示され、タップすると単にアラートが閉じられます。

loc-key

現在のローカリゼーション(ユーザーの言語設定によって設定されます)のLocalizable.stringsファイルのアラートメッセージ文字列へのキー。キー文字列は、loc-argsに指定された変数を受け取るために、%@および%n$@指定子を使用してフォーマットできます。

launch-image

アプリケーション・バンドルのイメージ・ファイルのファイル名。拡張子を含めるか、省略できます。このイメージは、ユーザーがアクション・ボタンをタップするか、アクション・スライダを移動させたときの起動イメージとして使用されます。このプロパティを指定しない場合、前のスナップショット、またはアプリケーションのInfo.plistファイルのUILaunchImageFileキーによって識別されるイメージが使用されるか、Default.pngに戻ります。

custom

カスタム値をApple Push Payloadに追加するには、メタデータ名にcustomおよび値としてJSON形式の文字列を使用します。JSONオブジェクトはデバイス・アプリケーションにそのまま渡されます。カスタム値には、JSONの構造化型およびプリミティブ型(ディクショナリ(オブジェクト)、配列、文字列、数値およびブール)を使用する必要があります。JSONオブジェクトはペイロードに追加されます。

- ドライブ固有のメッセージの検証
デバイス・トークンおよびメッセージ・サイズが検証されます。デバイス・トークンが適切な長さではない場合、メッセージは送信されず、失敗ステータスが生成されます。メッセージ・サイズが256バイトを超えている場合、メッセージは送信されず、失敗ステータスが生成されます。

コンテンツ・タイプapplication/jsonの場合、またはカスタムJSONオブジェクトがメタデータ・プロパティに追加されている場合、JSONオブジェクトを解析できるかどうかについてJSON健全性チェックが行われます。解析できない場合、メッセージは送信されず、失敗ステータスが生成されます。

- RAW JSONの送信
コンテンツ・タイプにapplication/jsonを設定することによって、完全なAPNsメッセージを設定できます。UMSはJSONデータをそのままAPNsに渡します。コンテンツ・タイプにapplication/jsonが設定されている場合、ドライバ固有のすべてのメタデータ・プロパティは無視されます。

これにより、他のメッセージ・タイプ(MDM (Mobile Device Management)メッセージなど)をAPNsに使用することもできます。

- 複数のアプリケーションのサポート
複数の独立したアプリケーションがAPNSドライバを使用できるように、APNSドライバは複数の構成をサポートします。メッセージに適切なAPNSドライバを選択するために、UMSのコア機能であるドライバ選択が使用されます。推奨される方法は、SupportedApplicationNamesまたはSupportedCarriersドライバ構成プロパティを使用することです。

SupportedCarriersの場合、メッセージのinfoオブジェクト(oracle.sdp.messaging.MessageInfo)に、対応するキャリア・プロパティが設定されている必要があります。

message.getMessageInfo().setCarrier("myapp");

SupportedApplicationNamesの場合、アプリケーション名プロパティのデフォルト値は、通常の場合に使用できるようにアプリケーションのデプロイメント名です。なんらかの理由で他の値を使用する必要がある場合、アプリケーション名プロパティは次のようにMessagingClientが作成されるときに設定できます。

Map<String, Object> parameters = new HashMap<String, Object>();

parameters.put(ApplicationInfo.APPLICATION_NAME, "myapp");

messagingClient = MessagingClientFactory.createMessagingClient(parameters);

- インバウンド・メッセージ - フィードバック・サービス: インバウンド・メッセージはAPNsフィードバック・サービスからのレポートで構成されます。フィードバック・サービスは、到達できなくなったデバイス(たとえば、ユーザーがiOSアプリケーションをアンインストールしたため)を報告します。APNSドライバは、このデバイス・アプリケーションでの無効なデバイス・トークンについてフィードバック・サービスをポーリングし、それらをインバウンド・メッセージでプロバイダ・アプリケーションに報告します。プロバイダ・アプリケーションがそれらのメッセージを受信するには、ドライバの構成と同じ値(例: uri:apns:myapp)でアクセス・ポイントを登録する必要があります。
フィードバック・サービスは、TLS接続が示すデバイス・アプリケーションの到達できないすべてのデバイス・トークンを返します。デバイス・トークンのサブセットのみを受け取ることはできません。

AppleのAPNsドキュメントでは、フィードバック・サービスを使用することが推奨されています。この情報を使用して、配信に失敗するプッシュ通知の送信を停止することにより、アプリケーションで不要なメッセージのオーバーヘッドが減少し、全体的なシステム・パフォーマンスが向上します。APNsは、フィードバック・サービスを適切にチェックしていること、およびデバイスに存在しないアプリケーションへのプッシュ通知の送信を控えることについてプロバイダを監視します。

メッセージの形式はJSONです。メッセージは、デバイス・トークンおよび有効期限日(longのEpochミリ秒)を持つJSONオブジェクトの配列です。

[
{
"deviceToken" : "ad123e45f6f78c9041dd234e5a6f7890",
"expiry" : 134567878222112333
},
{
"deviceToken" : "bb223e45f6f78c9041dd234e5a6f1234",
"expiry" : 133577878222123456
}
]

- 異なるユーザーの同じ情報プロバイダ・アプリケーション: プロバイダ・アプリケーションが複数のユーザー(オンプレミスまたはクラウドにインストールされている)によって使用される場合、アプリケーションのクライアント側(デバイス・アプリケーション)は直接再使用できません。デバイス・アプリケーションは、一意のバンドルIDを使用してユーザーに配信する必要があります。これは、フィードバック・サービスが到達できないデバイス・トークンをポーリングする場合、各ユーザーに異なるTLS証明書を使用する必要があるためです。APNSドライバは、各ユーザーに異なるTLS証明書を使用する必要があります。そうしないと、他のユーザーの到達できないデバイス・トークンが取得されます。

テキストの追加。

3.6.1 スケーラビリティに関する注意事項

APNSドライバは、リソース・アダプタが特定のJEEプラットフォームで処理できる数と同等の数のメッセージの送信をサポートします。

ドライバのスケーラビリティは、JMSソリューションのスケーラビリティによって制限されます。UMSおよびドライバは複数のノードにデプロイできます。

3.6.2 高可用性に関する注意事項

APNsへの呼出しが失敗した場合、メッセージはゲートウェイへの配信に失敗したとマークされます。

UMSおよびAPNSドライバは複数のノードにデプロイできます。

注意:
プッシュ通知の配信はAPNsによって保証されません。データ転送はプッシュ通知を使用して実行しないでください。データが使用可能であるという通知のみを送信します。

3.6.3 互換性に関する注意事項

APNSドライバは12.2.1.0.0で導入されました。

3.6.4 UMS APIプログラマに対する注意事項

UMS APNSドライバが中間層サーバーにデプロイされている場合、すべてのUMSクライアントがuri:apns配信チャネルを使用できる必要があります。詳細は、次のコード例を参照してください。

3.6.4.1 プッシュ通知の送信

プッシュ通知を送信するには、メッセージをデバイス・トークンに送信します。トークンが1234567890…1234567890であるとします。次のjavaスニペットは、通知をそのデバイスにプッシュします。

String recipient = "uri:apns:1234567890..1234567890";
Message message = MessagingFactory.createTextMessage("New Lenny K clips");
message.addRecipient(MessagingFactory.createAddress(recipient));
String id = mMessagingClient.send(message);

3.6.4.2 追加のデータを指定したプッシュ通知の送信

バッジ番号およびサウンド・ファイルを指定してプッシュ通知を送信するには、次のjavaスニペットに示されているように、UMSメッセージにメタデータを追加します。

String recipient = "uri:apns:1234567890..1234567890";
Message message = MessagingFactory.createTextMessage("New Lenny K clips");
message.addRecipient(MessagingFactory.createAddress(recipient));
message.setMetaData("UMS-APNS", "badge", "3");
message.setMetaData("UMS-APNS", "sound", "Rocknroll.aiff");
String id = mMessagingClient.send(message);

ローカライズされたアラート・テキストを引数に指定してプッシュ通知を送信するには、次のjavaスニペットに示されているように、UMSメッセージにメタデータを追加します。

String recipient = "uri:apns:1234567890..1234567890";
Message message = MessagingFactory.createTextMessage("New Lenny K clips");
message.addRecipient(MessagingFactory.createAddress(recipient));
message.setMetaData("UMS-APNS", "loc-key", "GAME_PLAY_REQUEST_FORMAT");
message.setMetaData("UMS-APNS", "loc-args", "Jenna,Frank");
String id = mMessagingClient.send(message);

前述のスニペットは、次のような通知ペイロードになります。

{
"aps" : {
"alert" : {
"loc-key" : "GAME_PLAY_REQUEST_FORMAT",
"loc-args" : ["Jenna", "Frank"]
}
}
}

3.6.4.3 追加カスタム・データを指定したプッシュ通知の送信

カスタム・データを指定してプッシュ通知を送信するには、次のjavaスニペットに示されているように、カスタム・データを表すJSON形式の文字列を作成し、UMSメッセージにメタデータcustomとしてそれを追加します。

String customDataAsJson = "{\"myCustomDataSection\":{\"mykey1\":\"value1\",\"mykey2\":\"value2\"}, \"section2\":4711}";
String recipient = "uri:apns:1234567890..1234567890";
Message message = MessagingFactory.createTextMessage("New Lenny K clips");
message.addRecipient(MessagingFactory.createAddress(recipient));
message.setMetaData("UMS-APNS", "custom", customDataAsJson);
String id = mMessagingClient.send(message);

結果の通知ペイロードは次のようになります。

{
"aps" : {
"alert" : "New Lenny K clips",
},
"myCustomDataSection" : {
"mykey1" : "value1",
"mykey2" : "value2",
},
"section2" : 4711
}

注意:
JSON形式の文字列は、様々なオブジェクトから作成できます(たとえば、WebLogicですでに使用可能なcom.fasterxml.jacksonパッケージを使用して)。

3.6.4.4 RAW JSONデータを指定したプッシュ通知の送信

APSペイロード・データを指定してプッシュ通知を送信するには、ペイロードを表すJSON形式の文字列を作成します。

String rawJson = "{\"aps\":{\"alert\":\"UMS rocks\"}}";
String recipient = "uri:apns:1234567890..1234567890";
Message message = MessagingFactory.createMessage();
message.addRecipient(MessagingFactory.createAddress(recipient));
message.setContent(rawJson,"application/json; charset=\"UTF-8\"");
String id = mMessagingClient.send(message);

3.6.4.5 RAW JSONデータとMDMペイロードを指定したプッシュ通知の送信

MDMペイロード・データを指定してプッシュ通知を送信するには、ペイロードを表すJSON形式の文字列を作成します。

String rawJson = "{\"mdm\":\"the_push_magic_token\"}";
String recipient = "uri:apns:1234567890..1234567890";
Message message = MessagingFactory.createMessage();
message.addRecipient(MessagingFactory.createAddress(recipient));
message.setContent(rawJson,"application/json");
String id = mMessagingClient.send(message);

3.6.4.6 到達できないデバイス・トークンの受信

APNSドライバは、到達できないデバイス・トークンのリストを取得するために、フィードバック・サービスを定期的にポーリングします。デバイス・トークンのリストを受け取ると、フィードバック・サービスはそのデバイス・トークンに関する情報をクリアします。このため、同じデバイス・トークンを再度受け取ることはできません(再度登録されて、再度到達不能になった場合を除く)。

アプリケーションは、APNSドライバが構成されているアクセス・ポイントに対応するUMSアクセス・ポイントを登録する必要があります。

import com.fasterxml.jackson.databind.*;
String address = "uri:apns:myapp";
AccessPoint accessPoint = AccessPointFactory.createAccessPoint(MessagingFactory.createAddress(address));
messagingClient.registerAccessPoint(accessPoint);
Message[] messages = messagingClient.receive();
byte[] content = (byte[]) messages[0].getContent();
JsonNode devices = new ObjectMapper().readTree(content);
for (JsonNode device : devices) {
System.out.println("deviceToken: " + device.get("deviceToken").asText());
System.out.println("expiry: " + new Date(device.get("expiry").asLong()));
}

3.6.4.7 Unicode文字を使用したプッシュ通知の送信

ASCII以外の文字が使用される場合、UMSメッセージの文字セットをそれに応じて設定する必要があります(たとえば、UTF-8に)。次のコード例は、文字「ä」およびエモーティコンを使用したメッセージの作成を示しています。

// message with 'ä'
Message message1 = MessagingFactory.createTextMessage("\u00e4", "UTF-8");
// message with SMILING FACE WITH SUNGLASSES (U+1F60E)
Message message2 = MessagingFactory.createTextMessage("\ud83d\ude0e", "UTF-8");

4 Oracle User Messaging Serviceの構成

この章では、ご使用の環境でOracle User Messaging Server (UMS)を構成して保護する方法について説明します。

この章の内容は次のとおりです:

- 第4.1項「ユーザー・メッセージング・サービスの構成ページへのアクセス」

- 第4.2項「ユーザー・メッセージング・サーバーの構成」

- 第4.3項「ユーザー・メッセージング・サービス・ドライバの構成」

- 第4.4項「LDAPユーザー・プロファイルへのユーザー・メッセージング・サービスのアクセスの構成」

- 第4.5項「グループ・メッセージングのためのOracle User Messaging Serviceの使用」

- 第4.6項「メッセージの自動再送信の構成」

- 第4.7項「Oracle User Messaging Serviceの保護」

4.1 ユーザー・メッセージング・サービスの構成ページへのアクセス

UMSは、Oracle Enterprise Manager Fusion Middleware Controlを使用して構成できます。詳細は、Oracle Fusion Middleware Fusion Middleware ControlによるOracle Fusion Middlewareの管理を参照してください。

あるいは、WebLogic Scripting Tool (WLST)を使用してUMSを構成することもできます。詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』を参照してください。

4.2 ユーザー・メッセージング・サーバーの構成

UMSは、サーバー用に1つと、ドライバ・タイプごとに1つのエンタープライズ・アーカイブとしてデプロイされます。構成は、管理対象サーバー・レベルまたはクラスタ・レベルで定義でき、クラスタ・レベルによってドメイン・レベルはオーバーライドされます。サーバーおよびドライバは、WebLogic Scripting Tool (WLST)とEnterprise Manager (EM)を使用して構成できます。

ユーザー・メッセージング・サーバーの構成をクラスタ・レベルで定義する場合は、そのクラスタ名と次のすべてのプロパティを指定する必要があります。

表4-1 ユーザー・メッセージング・サーバーの構成プロパティ

名前

説明

必須

AppReceivingQueuesInfo

アプリケーションが受信メッセージをデキューするキューのデフォルト・セット。

はい

DuplicateMessageRetryDelay

メッセージが重複した場合に処理を保留するための遅延時間

はい

EngineCommandQueuesInfo

他のメッセージング・コンポーネントが送信したコマンド・メッセージをエンジンがデキューするキューのセット

はい

EnginePendingReceiveQueueInfo

エンジンが保留メッセージをデキューするキュー。この値のフォーマットはJNDIQueueConnectionFactoryName:JNDIQueueNameです

はい

EngineReceivingQueuesInfo

エンジンが受信メッセージをデキューするキューのセット

はい

EngineSendingQueuesInfo

エンジンが送信メッセージをデキューするキューのセット

はい

JpsContextName

アイデンティティ・ストア・サービス・インスタンスの取得時に使用するJava Platform Security (JPS)コンテキストの名前。値を空にするとJPSコンテキストに設定されます

はい

ReceivedmessageStatusEnabled

受信メッセージ・ステータス・レポーティングの有効化 - falseの場合、クライアント・ライブラリは配信ステータスをエンジンに返しません

はい

ResendDefault

配信失敗時の自動再送信のデフォルト回数。このプロパティはメッセージごとにプログラムでオーバーライドできます。上限は、構成パラメータResendMaxに指定した値です。

はい

ResendDelay

自動再送信間の遅延

はい

ResendMax

配信失敗時の自動再送信の最大回数

はい

SecurityPrincipal

デフォルトで使用されるシステム・ユーザー

はい

SessionTimeout

ドライバまたはメッセージング・クライアント・アプリケーションによってセッション・フラグが設定されている場合、セッション・タイムアウトの前に待機する期間

はい

SupportedDeliveryTypes

このサーバーがサポートしている配信タイプのセット

はい

4.3 ユーザー・メッセージング・サービス・ドライバの構成

UMSでは、複数の構成がサポートされています。つまり、デプロイされた1つのドライバ・インスタンスで複数の構成を処理できます。これにより、ドメイン内の特定のドライバのインスタンスを複数デプロイしなくても、そのドライバの1つのインスタンスを異なる方法で構成できます。すべてのドライバで複数の構成がサポートされます。各構成に一意の名前を使用して、ドライバの単一デプロイメントの構成を複数作成できます。可能ではありますが、意図しない結果をもたらす可能性があるため、特定のドライバ・インスタンスに複数の構成を作成する際に、同じ構成名を使用しないことをお薦めします。

UMSはクラスタまたはサーバーにデプロイできるため、クラスタ・レベルまたはサーバー・レベルでドライバを構成できます。デプロイメントと同じレベルで構成することをお薦めします。ただし、例外的なシナリオでは、デプロイメントとは異なるレベルで構成を作成することが正しい場合もあります。

UMSドライバは、Oracle Enterprise Manager Fusion Middleware Controlを使用して構成できます。または、WLSTコマンドconfigUserMessagingDriverを使用してUMSドライバを構成することもできます。このコマンドの詳細は、インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンスを参照してください。

この節では、以下のトピックについて説明します。

- ドライバの構成

- メッセージング拡張ドライバの構成

- 電子メール・ドライバの構成

- SMPPドライバの構成

- XMPPドライバの構成

- Twitterドライバの構成

- APNSドライバの構成

注意:
UMSドライバは、クラスタ・レベルまたはサーバー・レベルで構成できます。適切な構成レベルを必ず選択するように、詳細は第4.2項「ユーザー・メッセージング・サーバーの構成」を参照してください。

4.3.1 ドライバの構成

ドライバ構成ページには次のいずれかの場所から移動できます。

- 「ユーザー・メッセージング・サービス」ホーム・ページの「関連ドライバ」表

- 「ターゲット・ナビゲーション」ペインのドライバ・ターゲットの「ドライバ・プロパティ」メニュー

- 「ユーザー・メッセージング・サービス」ホーム・ページの「ドライバ・プロパティ」メニュー

ドライバを構成するには、次のタスクを実行します。

1. Oracle Enterprise Manager Fusion Middleware Controlコンソールに管理者としてログインします。

2. 「ユーザー・メッセージング・サービス」ホーム・ページに移動します。

3. 「usermessagingserver(AdminServer)」をクリックします。次の図のような「関連ドライバ」ページが表示されます。

4. 「ローカル」タブを選択して、UMSサーバー・インスタンスと関連付けられているドライバにアクセスします。これらのドライバは、正しく構成されているかどうかによって、UMSサーバーに登録されている場合と登録されていない場合があります。「すべて」タブには、ドメインにデプロイされており、かつ、すべてのUMSサーバー・インスタンスに登録されているドライバがすべてリストされます。

5. リストからドライバを選択し、対応する「ドライバの構成」アイコンをクリックします。
このドライバ・デプロイメントに適用されている構成をすべて示す構成ページが表示され、管理者は構成を作成、編集または削除できます。ユーザー・メッセージング・ドライバは、次のシナリオのとおり異なる方法で構成します。

1. 電子メール・ドライバ(12.1.3では電子メール・ドライバでのみが複数の構成がサポート)の場合、構成は、ドライバのデプロイ先がクラスタ環境か非クラスタ環境かによって決まります。

- ドライバをクラスタ、たとえばa_ums_clusterにデプロイする場合、クラスタa_ums_clusterだけでなくドメイン全体についても電子メールの構成がすべて表示されます。構成名が同じ場合、クラスタレベルの構成によってドメインレベルの構成はオーバーライドされます。

- 非クラスタ管理対象サーバーにデプロイされるドライバの場合、構成はサーバー・レベルで行います。

複数の構成のサポートおよびクラスタ・レベルとドメイン・レベルの構成間の関係の詳細は、第4.2項「ユーザー・メッセージング・サーバーの構成」および第4.3項「ユーザー・メッセージング・サービス・ドライバの構成」を参照してください。

6. 「作成」をクリックするか、リストからドライバ構成を選択して「編集」をクリックします。次の図のような「ドライバ・プロパティ」ページが表示されます。新しい構成を作成することも、既存の構成を更新することもできます。

7. 必要に応じて、「ドライバ固有の構成」セクションを展開し、ドライバのパラメータを構成します。詳細は、第4.3.1.1項「ドライバ・プロパティの概要」を参照してください。

8. デプロイメント環境で構成プロパティが正しい形式になっていて有効であるかどうかを検証するには、入力したドライバ構成パラメータをテストできます。そのページで「テスト」ボタンをクリックします。「OK」をクリックして続行します。

注意:
テストが成功しなかった場合でも、構成を保存できます。

4.3.1.1 ドライバ・プロパティの概要

UMSドライバは、アウトバウンド・メッセージをルーティングする際にメッセージング・エンジンで使用される共通プロパティ(表4-2を参照)を共有します。

表4-2 共通ドライバ・プロパティ

名前

説明

必須プロパティ

Capability

ドライバの機能をメッセージの送信にするかまたは受信にするかを設定します。値はSEND、RECEIVEおよびBOTHです。

はい

Cost

同じタイプの複数のドライバ構成間でのドライバ構成の選択にのみ使用され、クライアント・アプリケーションが必要とした場合にのみ使用されます。ドライバのコスト・レベル(0 - 10)。0は最小のコストで、10は最大のコストです。値がこの範囲にない場合、コストは0とみなされます。

いいえ

DefaultSenderAddress

ドライバがサポートする特定のDeliveryTypeの送信者アドレスがUMSメッセージで指定されていない場合、ドライバがDefaultSenderAddressを送信者のアドレスとして使用することがあります。DefaultSenderAddressの例は、EMAIL:alice@example.comです。

いいえ

SenderAddresses

ドライバで処理するように構成されている送信者アドレスのリスト。SenderAdressesが指定されているドライバは、送信メッセージの送信者アドレスが一致する場合にのみ選択されます。SenderAdressesが指定されていないドライバは、メッセージの送信者アドレスに関係なく、すべての送信メッセージを処理できるとみなされます。リストは、カンマ区切りのUMSアドレスで構成する必要があります(例: EMAIL:alice@example.com、EMAIL:alice@example.com,EMAIL:bob@example.com)。大/小文字の区別はありません。

いいえ

Speed

同じタイプの複数のドライバ構成間でのドライバ構成の選択にのみ使用され、クライアント・アプリケーションが必要とした場合にのみ使用されます。ドライバの速度レベル(0から10。10が最高速)。

いいえ

SupportedCarriers

サポートされている電話会社のカンマ区切りのリスト。

いいえ

構成レベル

ドライバ構成をserverレベルまたはclusterレベルで有効にします。「サーバー」レベルを選択した場合は、サーバー名を指定する必要があります。「クラスタ」レベルを選択した場合は、クラスタ名を指定する必要があります。

はい

SupportedContentTypes

ドライバでサポートされているコンテンツ・タイプ。

はい

SupportedDeliveryTypes

ドライバでサポートされている配信タイプ。

はい

SupportedProtocols

サポートされているプロトコルのカンマ区切りのリスト。

いいえ

SupportedStatusTypes

ドライバでサポートされているステータス・タイプ。

いいえ

サポートされるアプリケーション名

ドライバでサポートされるアプリケーション名。

いいえ

4.3.1.2 パスワードの保護

ドライバの重要なプロパティ(パスワード)は、Oracle Enterprise Manager Fusion Middleware Controlを使用して資格証明ストアに安全に格納できます。プロパティは「エンコード済資格証明」フラグでマークされ、カスタムの入力フォーム・フィールドがあります。

ドライバの重要なプロパティを安全に格納するには、次のタスクを実行します。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインし、選択したドライバのドライバ構成ページに移動します。
このドライバ・デプロイメントに適用されている構成をすべて示す構成ページが表示され、管理者は構成を作成、編集または削除できます。

2. 「作成」をクリックして新しい構成を作成するか、構成を選択して「編集」をクリックして既存の構成を編集します。
「ドライバ・プロパティ」ページが表示されます。

3. 「ドライバ固有の構成」表で、「エンコード済資格証明」フラグが設定されているプロパティを探します。

4. 次の図に示すように、隣接する「値」列で「パスワードのタイプ」ドロップダウン・リストから資格証明タイプを選択します。

5. 選択した資格証明タイプに従って、ユーザー名またはパスワード(あるいはその両方)の入力が求められます。次の3つのオプションがあります。

- 間接パスワード、新規のユーザーの作成(デフォルトのオプション): ユーザー名と実際のパスワードを指定し、このパスワードは、ユーザー名とともに資格証明ストアにキーの一部として格納されます。このキーと固定フォルダ(マップ名)は、ドライバ・デプロイメントのファイルに格納されます。

- 間接パスワード、既存のユーザーの使用: (以前に保存したパスワードを参照するために)資格証明ストアにある既存の間接ユーザー名/キーを選択します。

- クリアテキスト・パスワードの使用: パスワードを指定し、ドライバ・デプロイメント・ファイルに直接保存します。

6. 「OK」をクリックして変更を保存します。

7. ドライバ・アプリケーションまたはコンテナを再起動して、変更内容を有効にします。

パスワードは、ドライバ・デプロイメント・ディレクトリのファイルで確認できます。間接パスワードの場合のフォーマットは、次のようになります。

value="->mapName:keyName"    (mapName can be any name of the user's choice, and the key is <parameter_name>.<username>)

4.3.1.3 メッセージング拡張ドライバの構成

拡張ドライバは、任意の管理者定義チャネル(プロトコル)のサポートを有効にし、このようなチャネルの通知を管理者定義のWebサービス・リスナー・エンドポイントに配信することで、UMSのメッセージング機能を拡張します。

注意:
このドライバのインスタンスはデプロイされますが、デフォルトではどのサーバーにもターゲット設定されていません。このドライバ・インスタンスを有効化するには、UMS (usermessagingserver)が稼働している適切なサーバーにターゲット設定する必要があります。

4.3.1.3.1 共通プロパティ

これらは共通のドライバ・プロパティで、このドライバの機能を示しており、これらの機能は、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用されます。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。表4-3に、拡張ドライバの共通プロパティを示します。これらのプロパティの詳細は、表4-2を参照してください。使用可能な値の完全なリストについては、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。

表4-3 拡張ドライバの共通プロパティ

名前

必須

デフォルト値

InstanceName

はい

Extension-Driver

Capability

はい

SEND

SupportedDeliveryTypes

はい

URI

SupportedContentTypes

はい

text/plain、text/html、 text/xml

SupportedStatusTypes

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

コスト

いいえ

Speed

いいえ

SupportedCarriers

いいえ

構成レベル

はい

サーバー/クラスタ

SupportedProtocols

いいえ

popup

SenderAddresses

いいえ

DefaultSenderAddress

いいえ

サポートされるアプリケーション名

いいえ

空

4.3.1.3.2 カスタム・プロパティ

表4-4に、このドライバに固有のプロパティを示します。通常、これらは拡張通知を配信するリモート・エンドポイントの構成に関連しています。

表4-4 拡張ドライバのカスタム・プロパティ

名前

説明

必須

グループ名

この拡張エンドポイント構成グループの名前。

はい

エンドポイントURL

リモート・エンドポイント・リスナーURL。

はい

マップされたドメイン

受信者URIのドメイン部分がこの値と一致した場合に、メッセージの配信に使用される拡張エンドポイント。

いいえ

プロトコル

受信者URIのプロトコル(スキーム)部分がこの値と一致した場合に、メッセージの配信に使用される拡張エンドポイント。

はい

セキュリティ・ポリシー

このエンドポイントに適用されるWS-Securityポリシーのカンマ区切りのリスト。

いいえ

ユーザー名

WS-Securityヘッダーを介して伝播されるユーザー名。

いいえ

キーストア別名

WS-Securityポリシーの公開鍵の参照に使用するキーストア別名。

いいえ

資格証明ストア・キー

Oracle Web Services Managementの資格情報ストア・マップからWS-Securityのユーザー名およびパスワードを検索するために使用するキー。

いいえ

4.3.1.3.3 拡張ドライバのセキュリティ

リモート拡張エンドポイントがWS-Securityを使用して保護されている場合は、拡張ドライバの追加構成が必要です。2つの一般的なWS-Security構成がサポートされています。拡張ドライバではSAMLトークンまたはユーザー名トークンのいずれかを使用できます。

拡張ドライバのセキュリティを使用する手順は、次のとおりです。

1. SAMLトークンを使用するには、「セキュリティ・ポリシー」構成プロパティに値oracle/wss11_saml_token_identity_switch_with_message_protection_client_policyが含まれ、「キーストア別名」構成プロパティにリモート拡張エンドポイントで受け入れられる有効なキーストア・エントリの別名が含まれている必要があります。

2. ユーザー名トークンを使用するには、Security Policies構成プロパティに値oracle/wss11_username_token_with_message_protection_client_policyが含まれ、「資格証明ストア・キー」構成プロパティにリモート拡張エンドポイントで受け入れられる有効な資格情報ストア・エントリの別名が含まれている必要があります。

WS-Securityポリシーの使用およびOWSMの構成の詳細は、『Oracle Fusion Middleware Webサービスの管理』を参照してください。

4.3.1.4 電子メール・ドライバの構成

電子メール・ドライバは、メッセージの送受信両方を実行します(すなわち、デフォルトでcapabilityプロパティはbothに設定されています)。電子メール・ドライバはSMTPを通じてメッセージを送信し、メッセージの受信にはIMAPまたはPOP3のいずれかを使用します。

4.3.1.4.1 共通プロパティ

表4-5に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。これらのプロパティの詳細は、表4-2を参照してください。使用可能な値の完全なリストについては、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。

表4-5 共通の電子メール・プロパティ

名前

必須

デフォルト値

InstanceName

はい

Email-Driver

Capability

はい

Both

SupportedDeliveryTypes

はい

電子メール

SupportedContentTypes

はい

text/plain, text/html, multipart/mixed, multipart/alternative, multipart/related

SupportedStatusTypes

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE, USER_REPLY_ACKNOWLEDGEMENT_SUCCESS, USER_REPLY_ACKNOWLEDGEMENT_FAILURE

コスト

いいえ

N/A

速度

いいえ

N/A

SupportedCarriers

いいえ

N/A

構成レベル

はい

サーバー/クラスタ

Supported Protocols

いいえ

N/A

SenderAddresses

いいえ

N/A

DefaultSenderAddress

いいえ

N/A

サポートされるアプリケーション名

いいえ

空

4.3.1.4.2 電子メールのカスタム・プロパティ

表4-6に、このドライバに固有のプロパティを示します。これらは通常、リモート・ゲートウェイへのアクセス構成、および特定のプロトコルやチャネル固有の動作に関連します。

表4-6 カスタムの電子メール・プロパティ

名前

説明

必須

デフォルト値

MailAccessProtocol

電子メール受信プロトコル。設定可能な値はIMAPおよびPOP3です。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ

IMAP

AutoDelete

この値は、メッセージの処理後にドライバがメッセージに削除のマークを付けるかどうかを示します。デフォルトは「無効」です。POP3プロトコルの場合、メッセージは常に処理直後に削除されます。

いいえ

無効

Debug

この値は、ドライバがデバッグ・モードで実行されているかどうかを示します。有効になっている場合、電子メール・ドライバとメール・サーバー間のリクエストとレスポンスがJavaMailによってFusion Middleware Controlに出力されます。デフォルトは「無効」です。

いいえ

無効

CheckMailFreq

電子メール・サーバーからメッセージを取得する頻度。単位は秒で、デフォルト値は30秒です。

いいえ

30

ReceiveFolder

ドライバがメッセージをポーリングするフォルダの名前。デフォルト値はINBOXです。

いいえ

INBOX

OutgoingMailServer

SMTPサーバーの名前。電子メールの送信が必要な場合のみ必須です。

いいえ

N/A

OutgoingMailServerPort

SMTPサーバーのポート番号。通常は25です。

いいえ

25

OutgoingMailServerSecurity

SMTPサーバーで使用されるセキュリティ設定。設定可能な値は「なし」、「TLS」および「SSL」です。デフォルト値は「なし」です。

いいえ

なし

OutgoingDefaultFromAddr

デフォルトの送信者アドレス(送信メッセージで指定されていない場合)。

注意: OutgoingDefaultFromAddrプロパティは非推奨です。かわりにDefaultSenderAddressを使用してください。DefaultSenderAddressプロパティの詳細は、「共通プロパティ」を参照してください。

いいえ

N/A

OutgoingUsername

SMTP認証に使用するユーザー名。SMTP認証がSMTPサーバーでサポートされている場合のみ必要です。

いいえ

N/A

OutgoingPassword

SMTP認証に使用するパスワード。SMTP認証がSMTPサーバーでサポートされている場合のみ必要です。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

いいえ

N/A

IncomingMailServer

受信メール・サーバーのホスト名。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ

N/A

IncomingMailServerPort

IMAP4サーバーのポート番号(143または993)、またはPOP3サーバーのポート番号(110または995)。

いいえ

N/A

IncomingMailServerSSL

IMAP4またはPOP3サーバーへの接続時にSSLを有効にするかどうかを指定します。デフォルトは「無効」です。

いいえ

無効

IncomingMailIDs

ユーザー名に対応する電子メール・アドレス。各電子メール・アドレスはカンマで区切られ、対応するユーザー名がユーザー名リストに表示されているとおりに、リスト内で同じ位置に配置されている必要があります。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ

N/A

IncomingUserIDs

ドライバ・インスタンスがポーリングするメール・アカウントのユーザー名のリスト。各名前はカンマで区切られている必要があります(例: foo,bar)。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ

N/A

IncomingUserPasswords

ユーザー名に対応するパスワードのリスト。各パスワードはカンマで区切られ、対応するユーザー名がユーザー名リストに表示されているとおりに、リスト内で同じ位置に配置されている必要があります。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

いいえ

N/A

ProcessingChunkSize

メッセージ・ポーリングごとに処理されるメッセージ数。デフォルトは 100 です。

いいえ

100

ポーリング後の切断

メッセージ・ポーリングの後に電子メール・サーバーを切断するかどうか。POP3は常に切断されるため、IMAPの場合にのみ有効です。

いいえ

False

ImapAuthPlainDisable

IMAPユーザー認証のプレーン・テキスト認証(AUTHENTICATE PLAINコマンド)を無効にするか有効にするかを指定します。デフォルトは「無効」です。

いいえ

無効。このプロパティが無効の場合は、プレーン・テキストが許可されることを意味します。

注意:
数100個のID/パスワードを追加できるように、ポップアップ・ダイアログを使用して(CSVファイルからインポートするか、表に追加します)、複数の受信電子メールID/ユーザーID/パスワードを追加します。

4.3.1.5 SMPPドライバの構成

Short Message Peer-to-Peer (SMPP)は、一般的なGSM SMSプロトコルです。UMSには、事前作成のSMPPプロトコルの実装が、ショート・メッセージを送受信できるドライバとして組み込まれています。送信機能が有効な場合、SMPPドライバは送信用の送信ドライバとしてショート・メッセージ・サービス・センター(SMS-C)にTCP接続を開きます。ドライバの受信機能が有効な場合は、受信用の受信ドライバとしてSMS-Cに別の接続を開きます。ドライバとSMS-C間のすべての通信に必要なのは、2つのTCP接続(両方ともドライバが開始する)のみです。

注意:
SMPPドライバは、SMPPプロトコルのバージョン3.4を実装し、このバージョンをサポートするSMS-CまたはSMSゲートウェイへの接続のみをサポートします。

4.3.1.5.1 共通プロパティ

表4-7に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。これらのプロパティの詳細は、表4-2を参照してください。使用可能な値の完全なリストについては、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。

表4-7 共通のSMPPプロパティ

名前

必須

デフォルト値

InstanceName

はい

SMPP-Driver

Capability

はい

Both

SupportedDeliveryTypes

はい

SMS

SupportedContentTypes

はい

text/plain

SupportedStatusTypes

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

いいえ

N/A

Speed

いいえ

N/A

SupportedCarriers

いいえ

N/A

構成レベル

はい

サーバー/クラスタ

Supported Protocols

いいえ

N/A

SenderAddresses

いいえ

N/A

DefaultSenderAddress

いいえ

N/A

サポートされるアプリケーション名

いいえ

空

4.3.1.5.2 SMPPのカスタム・プロパティ

表4-8に、このドライバに固有のプロパティを示します。これらは通常、リモート・ゲートウェイへのアクセス構成、および特定のプロトコルやチャネル固有の動作に関連します。

表4-8 カスタムのSMPPプロパティ

名前

説明

必須

デフォルト値

SmsAccountId

この値は、SMPPドライバがメッセージをリクエストする宛先サーバーのアドレス値を示します。この値はUNIXの正規表現で指定します。たとえば、「555」は単一のアドレス、「^123|^789」は123または789で始まるすべてのアドレスを示します。

はい

N/A

SmsServerHost

SMS-Cサーバーの名前(またはIPアドレス)。

はい

N/A

TransmitterSystemId

メッセージの送信に使用するアカウントID。

はい

N/A

ReceiverSystemId

メッセージの受信に使用するアカウントID。

はい

N/A

TransmitterSystemType

送信側システムのタイプ。デフォルトはLogicaです。

はい

デフォルト値はLogicaです。

ReceiverSystemType

受信側システムのタイプ。デフォルトはLogicaです。

はい

デフォルト値はLogicaです。

TransmitterSystemPassword

送信側システムのパスワード。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

はい

N/A

ReceiverSystemPassword

受信側システムのパスワード。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

はい

N/A

ServerTransmitterPort

送信側サーバーのTCPポート番号。

はい

N/A

ServerReceiverPort

受信側サーバーのTCPポート番号。

はい

N/A

DefaultEncoding

受信メッセージに使用されます。SMS-CがエンコーディングをSMSC Default Alphabetに指定すると、これがSMPPドライバが前提とするエンコーディングになります。

ドロップダウン・リストで「IA5」、「UCS2」、「GSM_DEFAULT」、「ISO-8859-1」の中から選択します

いいえ

IA5

PreferredEncoding

送信メッセージに使用されます。設定した場合、テキストはPreferredEncodingパラメータに従ってエンコードされます。エンコーディングに失敗した場合(つまり、指定されたエンコーダを使用して文字をエンコードできない)、ドライバは16ビット・エンコーディングUCS2を使用します。

設定しない場合、ドライバはUMSメッセージのContent-Typeヘッダーからエンコーディングを導出しようとします。

ドロップダウン・リストで「IA5」、「UCS2」、「GSM_DEFAULT」、「ISO-8859-1」の中から選択します

いいえ

IA5

LocalSendingPort

SMPPドライバがSMS-Cへのメッセージの送信に使用するローカルTCPポート。

いいえ

N/A

LocalReceivingPort

SMPPドライバがSMS-Cからのメッセージの受信に使用するローカルTCPポート。

いいえ

N/A

LocalAddress

SMPPドライバをホスト管理するサーバーのホスト名(またはIPアドレス)。

いいえ

N/A

WindowSize

SMSのウィンドウ・サイズ。値は正数である必要があります。デフォルトは1です。

いいえ

1

EnquireInterval

SMS-Cへの問合せメッセージの送信間隔(秒単位)。デフォルトは、30秒間です。

いいえ

30

ThrottleDelay

スロットル間の遅延(秒単位)。デフォルトは 30 です。

いいえ

30

BindRetryDelay

バインド・エントリの試行間の最小遅延(秒単位)。デフォルトは 30 です。

いいえ

30

ResponseTimer

SMPPリクエストとレスポンス間に許可された経過時間(秒単位)。デフォルトは30です。

いいえ

30

RegisteredDeliveryMask

登録済配信ビット・マスク。デフォルトは0xFFで、配信フラグ値を変更しません。

いいえ

0xFF

RangeSetNull

trueに設定すると、BIND_RECEIVERのアドレス範囲フィールドがnullに設定されます。false(デフォルト値)に設定すると、アドレス範囲フィールドがSmsSystemIdに設定されます。デフォルトは「無効」です。

いいえ

無効

PriorityAllowed

SMPPドライバによってSMS-Cへのメッセージに設定される最高優先度。クライアント・アプリケーションによって設定されるUMSメッセージの優先度は、SMPPの優先度に変換されますが、PriorityAllowedによって制限されます。範囲は0(標準)から3(最高)です。デフォルトは0です。

いいえ

0

BulkSending

この値を 「有効」 (デフォルト値)に設定すると、複数のメッセージをSMS-Cに対して一括送信できます。

No

有効

PayloadSending

このプロパティを有効にすると、SMPPドライバはSMS-Cにメッセージを送信する際、常にSMPP仕様で定義されているmessage_payloadパラメータを使用します。デフォルトは「無効」です。

いいえ

無効

SourceTon

SMPP受信側セッションを経由して提供されるESMEアドレスの番号のタイプ(TON)。デフォルトは0です。

いいえ

0

SourceNpi

SMPP受信側セッションを経由して提供されるESMEアドレスの番号計画識別子(NPI)。デフォルトは0です。

いいえ

0

DestinationTon

宛先のTON。デフォルトは0です。

いいえ

0

DestinationNpi

宛先のNPI。デフォルトは0です。

いいえ

0

MaxChunks

1メッセージに対する最大SMSチャンク数。デフォルトは-1(最大値なし)です。

いいえ

-1(最大値なし)

ChunkSize

各SMSメッセージ・チャンクの最大サイズ。デフォルトは160です。

いいえ

160

LongMessageSending

断片化されたメッセージのためにオプションのSMPPパラメータsar_msg_ref_num、sar_total_segmentsおよびsar_segment_seqnumを設定することによって、長いメッセージの送信がサポートされます。デフォルト値は「有効」です。

いいえ

有効

DatagramMessageMode

データグラム・メッセージ・モードをサポートします。デフォルトは「無効」です。

いいえ

無効

4.3.1.6 XMPPドライバの構成

XMPPドライバは、Extensible Messaging and Presence Protocol (XMPP)を介したリアルタイムIMの場合に、Oracle Fusion Middlewareからエンド・ユーザーへの一方向または双方向のアクセスを提供します。このドライバを使用すると、エンド・ユーザーは、選択したIMクライアントを介して、アラート通知を受信したり、複数のアプリケーションと相互にチャットできます。

4.3.1.6.1 共通プロパティ

表4-9に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。これらのプロパティの詳細は、表4-2を参照してください。使用可能な値の完全なリストについては、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。

表4-9 共通のXMPPプロパティ

名前

必須

デフォルト値

InstanceName

はい

XMPP-IM-Driver

Capability

はい

Both

SupportedDeliveryTypes

はい

IM

SupportedContentTypes

はい

text/plain

XMPPドライバがメッセージを送信できるには、multipart/alternativeメッセージの一部分がtext/plainである必要があります。

SupportedStatusTypes

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

コスト

いいえ

N/A

速度

いいえ

N/A

SupportedCarriers

いいえ

N/A

構成レベル

はい

サーバー/クラスタ

Supported Protocols

いいえ

N/A

SenderAddresses

いいえ

N/A

DefaultSenderAddress

いいえ

N/A

サポートされるアプリケーション名

いいえ

空

4.3.1.6.2 XMPPのカスタム・プロパティ

XMPPドライバには、表4-10に示すカスタム・プロパティが組み込まれています。

表4-10 カスタムのXMPPプロパティ

名前

説明

必須

デフォルト値

IMServerHost

Jabber/XMPPサーバー・ホスト名。

いいえ

N/A

IMServerPort

対応するJabber/XMPPサーバー・ポート。デフォルトは5222です。

はい

5222

IMServerUsername

ログインに使用するJabber/XMPPユーザー名。ドメイン名がJabber/XMPPサーバーのホスト名と異なる場合は、完全なJabber IDを入力することもできます(例: myUserNameまたはmyUserName@xmpp-domain)。

注意: このユーザー・アカウントが存在せず、サーバーでアカウントの登録がサポートされている場合は、ユーザー・アカウントの登録が試行されます。

いいえ

N/A

IMServerPassword

上にリストされているユーザー名に対応するパスワード。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

いいえ

N/A

SecurityMode

サーバーへの接続時に使用するセキュリティ・モード。使用可能なオプションは、「なし」(セキュリティは無効になり、暗号化されていない接続のみ使用されます)、「TLS」(可能な場合にはTLS暗号化によるセキュリティが使用されます)、「SSL」(SSL暗号化によるセキュリティが使用されます)。デフォルトは「TLS」です。

いいえ

TLS

SASLAuthenticationEnabled

サーバーへのログイン時にSASL認証を使用するかどうか。SASL認証に失敗した場合、ドライバは非SASL認証の使用を試行します。デフォルトではSASLが有効になります。

いいえ

有効

4.3.1.7 Twitterドライバの構成

Twitterドライバは、Twitter APIサーバーと通信するUMSドライバです。Twitterサーバーとの双方向のメッセージング・サービスを提供します。そのため、Twitterドライバを使用すると、アプリケーション・ユーザーはTwitterフィードを公開し、これに対する応答を受信できます。

4.3.1.7.1 共通プロパティ

表4-11に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。これらのプロパティの詳細は、表4-2を参照してください。使用可能な値の完全なリストについては、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。

表4-11 Twitterドライバの共通プロパティ

名前

必須

デフォルト値

InstanceName

はい

usermessagingdriver-twitter

Capability

はい

SEND、RECEIVE

SupportedDeliveryTypes

はい

URI

SupportedContentTypes

はい

text/plain、text/html、text/xml

SupportedStatusTypes

はい

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

いいえ

N/A

Speed

いいえ

N/A

SupportedCarriers

いいえ

N/A

構成レベル

はい

サーバー/クラスタ

Supported Protocols

いいえ

N/A

SenderAddresses

いいえ

N/A

DefaultSenderAddress

いいえ

N/A

サポートされるアプリケーション名

いいえ

空

4.3.1.7.2 Twitterのカスタム・プロパティ

表4-12に、Twitterドライバに固有の構成可能なプロパティをリストします。

表4-12 Twitterドライバのカスタム・プロパティ

名前

説明

必須

デフォルト値

認証モード

このプロパティにはTwitterドライバで使用する認証モードを指定します。有効な値はOAuthまたはxAuthです。

はい

xAuth

ユーザー名

Twitterユーザーのユーザー名。

認証モードでxAuthを選択した場合、このフィールドは必須です。

Password

Twitterユーザーのパスワード。

認証モードでxAuthを選択した場合、このフィールドは必須です。

コンシューマ・キー

Twitterユーザーの公開鍵。

認証モードでOAuthを選択した場合、このフィールドは必須です。

コンシューマ・シークレット

Twitterユーザーの秘密鍵。

認証モードでOAuthを選択した場合、このフィールドは必須です。

アクセス・トークン

登録済Twitterアプリケーションの公開鍵。

認証モードでOAuthを選択した場合、このフィールドは必須です。

アクセス・トークン・シークレット

登録済Twitterアプリケーションの秘密鍵。

認証モードでOAuthを選択した場合、このフィールドは必須です。

4.3.1.8 APNSドライバの構成

(Apple Push Notification Service) APNSドライバは、APNS APIサーバーと通信するUMSドライバです。Appleから取得したアプリケーションの証明書は、OPSSサブシステムのWLSサーバーに保存する必要があります。APNSドライバの構成の前提条件の詳細は、第4.3.1.8.1項「APNSドライバを構成するための前提条件」を参照してください。

4.3.1.8.1 APNSドライバを構成するための前提条件

APNSドライバを使用してプッシュ通知を送信するには、ドライバはiOSアプリケーション固有の証明書にアクセスする必要があります。証明書(公開鍵と秘密鍵)はAppleの開発者ポータルから取得します。

タスク1: Entrustからの信頼証明書のインストール:

APNsを使用してTLSセッションを確立するには、Entrust CA (2048)のルート証明書をドメインのOPSSキーストアの信頼ストアにインストールする必要があります。欠落している証明書はかわりにJDKからインポートできます。

証明書をキーストア・サービスにインポートするためのWLSTコマンド:

import os
connect()
jdkCAcerts = os.path.join(os.getenv("JAVA_HOME"), "jre/lib/security/cacerts")
getOpssService(name='KeyStoreService').importKeyStore(appStripe='system', name='trust', password='changeit', aliases='entrustevca,entrustrootcag2,entrust2048ca', keypasswords='', type='JKS', permission=True, filepath=jdkCAcerts)

syncKeyStores(appStripe='system', keystoreFormat='KSS'

http://docs.oracle.com/middleware/1212/idm/JISEC/kssadm.htm#JISEC10119を参照してください

タスク2: ドメインへの証明書のインポート:

証明書はPKCS #12ファイル(ファイル拡張子はp12またはpfxです)にパッケージ化されています。証明書をキーストア・サービスにインポートする前に、(http://docs.oracle.com/middleware/1212/idm/JISEC/kssadm.htm#JISEC9596)アーカイブをJavaKeyStoreファイル(ファイル拡張子はjksです)に変換する必要があります。

keytoolコマンド(JDKの一部です) (https://docs.oracle.com/javase/8/docs/technotes/tools/unix/keytool.html)を使用してアーカイブを変換するには、次のコマンドを使用します。

JAVA_HOME/bin/keytool -importkeystore -destkeystore <com.example.myapp.jks> -srckeystore <com.example.myapp.p12> -srcstoretype pkcs12 -destalias <com.example.myapp> -deststorepass <mySecret> -srcstorepass <mySecret> -alias <the_friendly_name_in_p12_file>

必要なアプリケーションおよび証明書の実際の値にパラメータを置き換えます。

jksファイルをキーストア・サービスにインポートする場合は、2つのオプションがあります。

- Fusion Middleware Controlを使用 - Oracle Fusion Middleware Oracle Platform Security Servicesによるアプリケーションの保護

- WLST Infrastructureセキュリティ・カスタムWLSTコマンドを使用 - Oracle Fusion Middleware InfrastructureセキュリティWLSTコマンド・リファレンス

UMSは、インポートされた証明書に使用する必要があるapnsという事前定義済のキーストアとともに出荷されています。

証明書をキーストア・サービスにインポートする方法に関するWLSTを使用した例を次に示します。

# use empty string for the password since the keystore is permission protected (permission=true)
connect()
getOpssService(name='KeyStoreService').importKeyStore(appStripe='ums', name='apns', password='', aliases='com.example.myapp', keypasswords='mySecret', type='JKS', permission=True, filepath='path_to/com.example.myapp.jks')

注意:
値のaliasesパラメータ(前述のコマンドの)は、APNSドライバ構成の別名プロパティおよびキーストア名と一致している必要があります。

apnsと異なるキーストアが使用されている場合は、新しいキーストアを作成するために使用された値と同じappstripe値を使用して、UMSに追加の権限が付与される必要があります。

UMSの共有ライブラリoracle.sdp.clientには、同じappstripeを使用してoracle.security.jps.service.keystore.KeyStoreAccessPermission権限が付与される必要があります。

4.3.1.8.2 共通プロパティ

表4-13に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。これらのプロパティの詳細は、表4-2を参照してください。使用可能な値の完全なリストについては、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。

表4-13 APNSドライバの共通プロパティ

名前

必須

デフォルト値

InstanceName

はい

usermessagingdriver-apns

Capability

はい

SEND、RECEIVE

SupportedDeliveryTypes

はい

URI

SupportedContentTypes

はい

text/plain、application/json

SupportedStatusTypes

はい

DELIVER_TO_DRIVER、DELIVERY_TO_GATEWAY_FAILURE、DELIVERY_TO_GATEWAY_SUCCESS、DELIVERY_TO_DEVICE_FAILURE

コスト

いいえ

N/A

速度

いいえ

N/A

SupportedCarriers

はい

N/A

構成レベル

はい

サーバー/クラスタ

Supported Protocols

いいえ

N/A

サポートされるアプリケーション名

いいえ

空

ドライバ・タイプ

いいえ

False

SenderAddresses

いいえ

N/A

DefaultSenderAddress

いいえ

N/A

4.3.1.8.3 APNSのカスタム・プロパティ

表4-14に、APNSドライバに固有の構成可能なプロパティをリストします。

表4-14 APNSドライバのカスタム・プロパティ

名前

説明

必須

デフォルト値

サービス・モード

APNsの本番環境を判別します

はい

キーストア名

APNsとの通信に使用される秘密鍵および証明書を保持するKSSのキーストアの名前。

はい

apns

別名

キーストア内の秘密鍵証明書ペアの別名。

はい

フィードバック・アクセス・ポイント

インバウンド・フィードバック・メッセージに使用されるアクセス・ポイントの名前。配信タイプURIおよびプロトコルapnsである必要があります。推奨される値は「uri:apns:<applicationName>」です(例: 'uri:apns:myapp')。

いいえ

N/A

フィードバック・ポーリング間隔

ドライバがフィードバック・サービスをポーリングする頻度(秒単位)を示します。値の範囲は1-172800秒です。

いいえ

7200

4.4 LDAPユーザー・プロファイルへのユーザー・メッセージング・サービスのアクセスの構成

UMSデプロイメントでのLDAPプロバイダの設定の一環として、WebLogic Server管理コンソールを介して「ユーザー名属性」を構成します。デフォルトのcn以外の値でこの属性を構成する場合、またはユーザーの電子メール・アドレスがmailとは異なるLDAP属性に格納されている場合、UMSがユーザー・プロファイルに正常にアクセスして、勤務先電子メールなど、LDAPでプロビジョニングされた通信チャネルのリストを取得するには、Oracle Platform Security Services (OPSS)で追加の構成変更を行う必要があります。

Oracle Platform Security Services (OPSS)の詳細は、Oracle Platform Security Servicesによるアプリケーションの保護を参照してください。

LDAPユーザー・プロファイルへのアクセスを構成するには、次のタスクを実行します。

1. http://docs.oracle.com/middleware/11119/bisuite/BIEDG/toc.htmの手順に従って、LDAPを使用するためのアイデンティティ・ストアを構成します。

注意:
同じセクションに他のプロパティが定義されている場合があります。

2. バックエンドLDAPサーバー上のユーザー・プロファイルを検索する際に「ユーザー名属性」の値を使用するには、次の要素を追加します。

<property name="username.attr" value="username_attribute_value"/>

ここで、username_attribute_valueは、LDAPプロバイダ構成の「ユーザー名属性」プロパティの値です。たとえば、「ユーザー名属性」の値がmailの場合は、次の行を追加します。

<property name="username.attr" value="mail"/>

次のコード例は、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.WlsLdapIdStoreConfigProvide
r"/>

<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>

<property name="username.attr" value="mail"/>

</serviceInstance>

ユーザーの勤務先電子メール・アドレスを格納しているLDAP属性がmail属性以外である場合は、次の要素を追加します。

<property name="PROPERTY_ATTRIBUTE_MAPPING" value="BUSINESS_EMAIL=attr_containing_email"/>

ここで、attr_containing_emailは、ユーザーの電子メール・アドレスを格納しているLDAPプロバイダの属性名です。たとえば、電子メール・アドレスを格納しているユーザー属性がexternalEmailの場合は、次の行を追加します。

<property name="PROPERTY_ATTRIBUTE_MAPPING" value="BUSINESS_EMAIL=externalEmail"/>

次のコード例は、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.WlsLdapIdStoreConfigProvide
r"/>

<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>

<property name="PROPERTY_ATTRIBUTE_MAPPING" value="BUSINESS_
EMAIL=externalEmail"/>

</serviceInstance>

3. ドメインを再起動します。

4.5 グループ・メッセージングのためのOracle User Messaging Serviceの使用

UMSは、様々なチャネルによる双方向のマルチ・チャネル・メッセージングのサポートに加えて、グループ・メッセージングもサポートしています。この機能を使用すると、グループのURIにメッセージを送信してユーザーのグループにメッセージを送信したり、LDAPグループ(エンタープライズ・ロール)やアプリケーション・ロールにメッセージを送信したりできます。

グループ・メッセージング機能では、次の機能のサポートによりUMSの機能が拡張されています。

- グループへのメッセージの送信

- グループへの特定のチャネルを介したメッセージの送信

- アプリケーション・ロールへのメッセージの送信

- アプリケーション・ロールへの特定のチャネルを介したメッセージの送信

グループおよびアプリケーション・ロールへのメッセージの送信の詳細は、Oracle User Messaging Serviceによるアプリケーションの開発のグループ・メッセージの送信に関する項を参照してください。

グループ・メッセージング機能を使用する場合でも、新たにUMSを構成する必要はありません。UMSユーティリティを再使用してユーザー・ロールAPIにアクセスします。ユーザー・ロールAPI構成はUMSでは使用できないため、そのような構成はすべてUMSの外部で行います。ユーザー・ロールAPIは、最初のOracle Weblogic Serverオーセンティケータを使用するように自動的に構成されるため、特別な構成は必要ありません。

注意:
UMSでアプリケーション・ロールを解決できるようにするには、特定のセキュリティ権限が必要です。アプリケーション・デプロイヤは、次の例に示すようにWLSTコマンドを使用してこれらのセキュリティ権限を構成する必要があります。

connect('weblogic','welcome1','t3://host.example.com:7601')

grantPermission(codeBaseURL="file:MW_HOME/user_projects/domains/DOMAIN_NAME/servers/SERVER_NAME/tmp/_WL_user/usermessagingserver/-",permClass="oracle.security.jps.service.policystore.PolicyStoreAccessPermission",permTarget="context=APPLICATION,name=<appStripe>",permActions="getApplicationPolicy"
)

セキュリティ・コマンドの詳細は、インフラストラクチャ・セキュリティWLSTコマンド・リファレンスを参照してください。

4.6 メッセージの自動再送信の構成

12cでは、自動再送信機能を構成して管理者による再送信を自動化できます。つまり、メッセージの送信が完全に失敗であると分類された場合に、そのメッセージの再送信が自動的にスケジュールされるということです。これは、そのメッセージの送信が成功するまで、または構成した再送信回数に達するまで繰り返されます。再送信の遅延時間と最大回数を構成できます。機能上、これは、遅延時間を過ぎた場合に管理者が手動でメッセージを再送信するのと変わりません。自動再送信の目的は、ネットワークの一時的な問題や一時的にバックエンド・サービスを利用できない状況を解決することです。

この機能を構成するために、UMSのサーバー構成パラメータ、ResendDefault、ResendDelayおよびResendMaxが導入されました。これらのパラメータの詳細は、表4-1を参照してください。

再送信の試行回数はサーバーに対して構成されますが、クライアントのプログラムでメッセージごとにオーバーライドできます。ResendDefaultサーバー構成パラメータをオーバーライドするには、メッセージごとに使用する再送信の回数をクライアントで指定します。オーバーライドしてもResendMax構成パラメータの制限は受けます。

プログラムで再送信の試行回数を設定する方法の詳細は、Oracle User Messaging Serviceによるアプリケーションの開発のUMS Java APIを使用したメッセージの再送信の指定に関する項およびUMS WebサービスAPIを使用したメッセージの再送信の指定に関する項を参照してください。

注意:
メッセージの再送信が最大回数まで自動的に試行された後でもメッセージの再送信に失敗する場合は、管理者がEnterprise Managerからそのメッセージを手動で送信できます。再送信カウンタはリセットされます。再送信の最大回数を0で構成した場合の動作は、11gの動作と同じです。つまり、管理者がEnterprise Managerを使用して手動で失敗したメッセージを選択し、再送信する必要があります。

4.7 Oracle User Messaging Serviceの保護

ユーザー通信プリファレンスのユーザー・インタフェースは、Secure Sockets Layer (SSL)を使用してトランスポート・レベルで保護できます。デフォルトでは、デプロイされるすべてのWebサービスは保護されていません。本番環境にデプロイされるすべてのサービスに対して、Webサービス・セキュリティを有効にする必要があります。

- Oracle WebLogic ServerでSSLを有効にする方法は、『Oracle Fusion Middlewareの管理』のOracle WebLogic ServerのSSLの構成に関する項を参照してください。この手順で、ユーザー通信プリファレンスのユーザー・インタフェースを保護できます。

UMSは、UMS Webサービスを保護するためのOracle Web Services ManagerのWS-Securityポリシーの使用をサポートしています。Oracle Web Services Managerの詳細は、Oracle WebLogic Server WebLogic Webサービスの保護のOracle Web Service Managerのセキュリティ・ポリシーの使用に関する項を参照してください。

Webサービスの推奨セキュリティ構成では、Security Assertion Markup Language (SAML)トークンを使用して、Webサービス・クライアントとUMSの間でアイデンティティを受け渡します。SAMLトークンを使用する場合は、Webサービス・クライアントがユーザー名とパスワードをUMSに渡すかわりに、証明書の交換によってクライアントとUMSの間に信頼関係が確立されます。このキーストア構成が整うと、Webサービス・クライアントは、ユーザー・アイデンティティを渡すのみで、ユーザーを適切に認証していることを保証します。

UMS Webサービスで使用する推奨ポリシーは、次のとおりです。

- oracle/wss11_saml_token_with_message_protection_service_policy(サーバー側)

- oracle/wss11_saml_token_with_message_protection_client_policy(クライアント側)

- oracle/wss11_saml_token_identity_switch_with_message_protection_client_policy(クライアント側)

注意:
クライアント側ポリシーの選択は、アプリケーションによって実行されているセキュリティ・コンテキストに応じて異なります。

- Webサービス・コールを行っているスレッドに、(たとえば、ユーザー認証を実行するWebアプリケーションまたはrun-asアイデンティティが定義されているJava EEモジュールから)対象のサブジェクトが関連付けられている場合は、ポリシーoracle/wss11_saml_token_with_message_protection_client_policyを使用します。
現在のスレッド・サブジェクトは、SAML Policy WS-Securityヘッダーを使用して渡されます。この場合は、Webサービス・クライアント・インスタンスの作成時にパラメータjavax.xml.ws.BindingProvider.USERNAME_PROPERTYを指定しないでください。

- Webサービス・コールを行っているスレッドに未定義のサブジェクトが関連付けられる場合、または別のアイデンティティをプログラムで指定する必要がある場合は、ポリシーoracle/wss11_saml_token_identity_switch_with_message_protection_client_policyを使用し、Webサービス・クライアント・インスタンスの作成時にパラメータjavax.xml.ws.BindingProvider.USERNAME_PROPERTYを指定します。動的アイデンティティ切替えを実行する場合は、アプリケーションに追加のコード権限を付与する必要があります。詳細は、Webサービスの管理を参照してください。

4.7.1 通知に関するWebサービス・セキュリティ

様々なWebサービスに、対応する通知Webサービス(MessageNotification)が含まれており、これらはクライアント側で実行され、適合するイベントの発生時に通知(メッセージ配信ステータス、メッセージ受信、プレゼンス・ステータスの変更)を受信します。

4.7.2 UMS Webサービス・セキュリティの有効化

UMS Webサービスのポリシーを有効にするには、Oracle WebLogic Server WebLogic Webサービスの保護の管理コンソールを使用したOWSMセキュリティ・ポリシーのアタッチに関する項の手順に従って、ポリシーoracle/wss11_saml_token_with_message_protection_service_policyを選択します。この構成は、保護するサービスごとに繰り返す必要があります。

4.7.3 クライアント・セキュリティの有効化

Webサービス・クライアントのセキュリティは、プログラムで有効化する必要があります。Oracle User Messaging Serviceによるアプリケーションの開発に記載されているクライアント・ライブラリを使用すると、クライアント・オブジェクトの構築時にWS-Securityポリシー構成が提供されます。クライアント・コンストラクタは、Map<String, Objectタイプの引数を使用します。通常、SAML認証を使用する場合は、エンドポイント・アドレスなどの必須プロパティ以外に、キー/値のペア(表4-15)を構成マップに追加する必要があります。

表4-15 クライアント・セキュリティ・キー

キー

一般的な値

oracle.ucs.messaging.ws.ClientConstants.POLICIES

oracle/wss11_saml_token_
with_message_protection_
client_policy

javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY

リモートUMS WSのエンドポイントURL。これは通常「http://<host>:<port>/ucs/messaging/webservice」です。

javax.xml.ws.BindingProvider.USERNAME_PROPERTY

(オプション) <valid username>

注意: oracle/wss11_saml_token_with_message_protection_client_policyを使用する場合は、このキーは指定しないでください。

oracle.wsm.security.util.SecurityConstants.Conf
ig.KEYSTORE_RECIPIENT_ALIAS_PROPERTY

(オプション)ターゲット・サービスのキーストア別名。「クライアント別名」を参照してください。

oracle.wsm.security.util.SecurityConstants.ClientConstants.WSS_CSF_KEY

OWSMポリシーのアタッチに使用されます。Oracle Web Services Management資格証明ストア・マップからのリモート・ユーザー名/パスワード情報の参照に使用する資格証明ストア・キーを指定します。

例4-1 Webサービス・クライアントのセキュリティ

HashMap<String, Object> config = new HashMap<String, Object>();
config.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY,
"http://example.com:8001/ucs/messaging/webservice");
config.put(oracle.ucs.messaging.ws.ClientConstants.POLICIES, new String[]
{"oracle/wss11_saml_token_with_message_protection_client_policy"});

mClient = new MessagingClient(config);

4.7.4 キーストア構成

推奨WS-Securityポリシーを使用するには、OWSMに必要な公開鍵と秘密鍵の情報が含まれるキーストアを構成する必要があります。キーストアおよび対応する資格証明ストアのエントリを構成する方法は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の資格証明ストアの構成に関する項を参照してください。

- Webサービス・クライアントとUMSサーバーの両方が同じドメインにある場合、これらはキーストアと資格証明ストアを共有します。

- Webサービス・クライアントとUMSサーバーが異なるドメインにある場合は、UMS公開鍵をクライアント・ドメインのキーストアにインポートし、クライアント・ドメインの公開鍵をUMSキーストアにインポートする必要があります。

4.7.5 クライアント別名

ここで推奨しているSAMLポリシーなど、特定のWS-Securityポリシーを使用する場合、クライアントは、サーバーの公開鍵を使用してWebサービス・リクエストを暗号化する必要があります。ただし、通常はドメインごとにキーストアを1つのみ構成します。したがって、複数の他のドメイン内のWebサービスと通信するWebサービス・クライアントがあるドメインの場合は、OWSMで使用するデフォルトのキーストア・エントリをオーバーライドすることが必要になる場合があります。

たとえば、アプリケーション「A」がUMS Webサービスに対するWebサービス・クライアントで、アプリケーション「B」が別のドメイン内のWebサービスに対するWebサービス・クライアントであるドメインがあるとします。この場合、AのリクエストはUMSドメインの公開鍵を使用して暗号化する必要があり、Bのリクエストは他のドメインの公開鍵を使用して暗号化する必要があります。この目的を達成するには、OWSMで使用するキーストア別名をリクエストごとにオーバーライドします。

- たとえば、UMS公開鍵を別名"ums_public_key"でインポートし、他の公開鍵を別名"other_public_key"でインポートします。

- UMS Webサービス・クライアントの作成時に、例4-2に示すように、キーをoracle.wsm.security.util.SecurityConstants.Config.KEYSTORE_RECIPIENT_ALIAS_PROPERTYに設定し、値を"ums_public_key"に設定して受信者キーストア別名パラメータを指定します。

例4-2 クライアント別名

HashMap<String, Object> config = new HashMap<String, Object>();
config.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY,
"http://example.com:8001/ucs/messaging/webservice");
config.put(ClientConstants.POLICIES, new String[] {"oracle/wss11_saml_token_
identity_switch_with_message_protection_client_policy"});
config.put(BindingProvider.USERNAME_PROPERTY, "user1");
config.put(oracle.wsm.security.util.SecurityConstants.Config.CLIENT_CREDS_
LOCATION, oracle.wsm.security.util.SecurityConstants.Config.CLIENT_CREDS_LOC_
SUBJECT);
config.put(oracle.wsm.security.util.SecurityConstants.Config.KEYSTORE_RECIPIENT_
ALIAS_PROPERTY, "ums_public_key");
config.put(MessagingConstants.APPLICATION_NAME, "MyUMSWSApp");
mClient = new MessagingClient(config);

- 同様に、他のWebサービス・クライアントでもキーストア別名をオーバーライドする必要がありますが、正確なメカニズムは異なる場合があります。たとえば、JAX-WSクライアント・スタブを直接使用する場合は、オーバーライドプロパティをJAX-WSリクエスト・コンテキストに追加できます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』のWebサービス・クライアントのポリシー構成のオーバーライドに関する項を参照してください。

4.7.6 JMSリソースの保護

この(オプションの)手順では、セキュリティを向上させるために、管理者がUMSのJMSリソース(キューなど)へのアクセスを制限できます。

JMSシステム・リソースを保護するには、OracleSystemRoleロールを持つUMSJMSSystemResourceという名前で始まるすべてのJMSサブデプロイメントをロックします(複数サーバーまたはクラスタ・デプロイメントではUMSに対して複数の自動作成リソースがある場合があります)。この操作は、Oracle WebLogic Server管理コンソールを使用して行うか、または次のようにWLSTスクリプトを実行できます(MIDDLEWARE_HOME/oracle_common/communications/bin/secure_jms_system_resource.pyにあります)。

MIDDLEWARE_HOME/oracle_common/common/bin/wlst.sh
./secure_jms_system_resource.py
-userConfigFile=<UserConfigFile>, -userKeyFile=<UserKeyFile>
-url=<AdminServer_t3_url> -jmsSystemResource=<JMSSystemResourceName> -role=<SecurityRoleToUse>

UserConfigFileには、AdminUserの暗号化されたユーザー名とパスワードが含まれている必要があります。暗号化データのキーはUserKeyFile内に指定する必要があります。

デフォルトでは、UMSシステムはJMSリソースにアクセスするためにユーザーOracleSystemUserとして実行されます。ユーザーOracleSystemUserが存在しない場合、または他のユーザーに付与されている他のロールを使用してUMS JMSリソースを保護する場合は、別のユーザー名を指定することによって、UMSシステムで使用されるデフォルトのユーザー・アイデンティティをオーバーライドする必要があります。

5 Oracle User Messaging Serviceの監視

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle User Messaging Service (UMS)を監視する方法について説明します。

この章の内容は次のとおりです:

- 第5.1項「Oracle User Messaging Serviceの監視」

- 第5.2項「ログ・ファイルの表示」

- 第5.3項「メトリックおよび統計の表示」

5.1 Oracle User Messaging Serviceの監視

UMSのログとメトリックは、Oracle Enterprise Manager Fusion Middleware Controlを使用して監視できます。

UMSを監視するには、次の手順を実行します。

1. Oracle Enterprise Manager Fusion Middleware Controlコンソールに管理者としてログインします。

2. 「ユーザー・メッセージング・サービス」フォルダを開きます。ユーザー・メッセージング・サーバーと、ユーザー・メッセージング・ドライバのリストが表示されます。

3. 目的のサーバーまたはドライバを選択します。
ドライバを選択すると、そのドライバの状態とパフォーマンスを示すクイック統計が表示されます。

サーバーを選択すると、クイック統計に加えて、関連ドライバのリストが表示されます。いずれかのドライバを選択してその統計を表示したり、「ドライバの構成」アイコンをクリックしてドライバを構成できます。ドライバの構成の詳細は、第4章「Oracle User Messaging Serviceの構成」を参照してください。

4. サーバーに対して一連のアクションを実行できます。図5-1に示すように、サーバーを右クリックして任意のアクションを選択します。表5-1に、選択項目とその結果のアクションを示します。

図5-1 サーバー・アクション

表5-1 サーバーの選択項目とアクション

選択項目

アクション

ホーム

ホーム・ページに、選択したドライバのクイック統計が表示されます。

コントロール

ドライバを起動または停止します。

ログ

選択したドライバのメッセージ・ログを表示および構成します。

パフォーマンス・サマリー

カスタマイズ可能なメトリック・ページにパフォーマンス統計が表示されます。このページを使用して、このドライバの統計を表示します。このページをカスタマイズするには、「メトリック・パレット」を使用します。「メトリック・パレット」を使用すると、最も重要な情報のみが表示されるように、使用可能なすべてのメトリックから選択できるようになります。

メッセージ・ステータス

送受信したメッセージの配信ステータスを確認し、選択したメッセージを再送信します。検索フィールドを追加して、必要な演算子と検索値を設定すると、検索をフィルタ処理できます。一部のフィールドは、各種の相補演算子やContains演算子とともに使用するために、複数回追加できます。

メッセージング・クライアント・アプリケーション

UMSに登録したメッセージング・クライアント・アプリケーションは、そのアプリケーションがアンデプロイされ、他のアプリケーションが使用できるようにする必要があるアクセス・ポイントに留まったままの場合は、手動で登録解除できます。

サーバー・プロパティ

メッセージ保管方法およびメッセージ・フィルタ作成用のビジネス条件を構成します。詳細は、第4章「Oracle User Messaging Serviceの構成」を参照してください。

システムMBeanブラウザ

システムMBeanブラウザとその構成の設定。

ターゲット情報

「ターゲット情報」には、選択したドライバのバージョン、ミドルウェア・ホーム、ドメイン・ホーム、ホストおよびデプロイの詳細が表示されます。

5.1.1 メッセージ・ステータスの使用

送受信されたメッセージの配信ステータスの確認、メッセージの削除および選択したメッセージの再送信を行えます。

メッセージ・ステータスの確認

メッセージ・ステータスを確認するには、次のタスクを実行します。

1. ナビゲーション・ツリーで、サーバー・ページに移動します。サーバー・ページで、ページの上部に表示されるドロップダウン・リストから「メッセージ・ステータス」を選択します。
「メッセージ・ステータス」ページが表示されます。

2. 「検索」をクリックして、デフォルトの基準を使用してメッセージを検索します。検索結果のメッセージのリストが返されます。

検索のカスタマイズ

検索フィールドを追加して、必要な演算子と検索値を設定すると、検索をカスタマイズできます。一部のフィールドは、各種の補足的な演算子やContains演算子とともに使用するために、複数回追加できます。検索をカスタマイズするには、次のタスクを実行します。

1. 「フィールドの追加」をクリックします。

2. 検索対象のフィールドを選択します。

3. 演算子を選択し、必要に応じて変数を指定します。

4. 「検索」をクリックします。カスタマイズした検索が実行され、結果が返されます。

5. メッセージを再送信する場合は、リストのメッセージを選択して「再送信」をクリックします。

メッセージの削除

選択したメッセージを削除できます。また、特定の日付よりも古いメッセージをすべて削除するオプションを設定し、メッセージを一括削除することもできます。

- 選択したメッセージを削除するには、リストでメッセージを選択して「選択項目の削除」をクリックします。

- 特定の日付よりも古いメッセージをすべて削除するには、「オプションを指定して削除」をクリックします。表示されるポップアップ・ウィンドウで、7日よりも前の日付を指定し、「OK」をクリックします。指定した日付よりも前のメッセージがすべて削除されます。

注意:
EM UIの日付機能を使用してメッセージを削除する場合、削除するメッセージの数が2000個以下であることを必ず確認してください。削除するメッセージが2000個を超える場合、次のエラー・メッセージが表示されます。
指定したオプションでは、2000件を超えるメッセージが削除されます。問合せを絞り込んで再試行してください。

2000個を超えるメッセージを削除するには、Oracle DatabaseのDBパージ・スクリプトを使用する必要があります。

5.1.2 メッセージング・クライアント・アプリケーションの登録解除

メッセージング・クライアント・アプリケーションがアンデプロイされ、他のアプリケーションが使用できるようにする必要があるアクセス・ポイントに留まったままの場合は、そのアプリケーションを手動で登録解除できます。メッセージング・クライアント・アプリケーションの登録を解除するには、次のタスクを実行します。

1. ナビゲーション・ツリーでターゲットを右クリックし、「メッセージング・クライアント・アプリケーション」を選択します。次の図のようなメッセージング・クライアント・ページが表示されます。

2. 登録解除するメッセージを選択し、「登録解除」をクリックします。
確認を求める確認ボックスが表示されます。選択内容を確認します。

5.2 ログ・ファイルの表示

ログ・ファイルを表示できます。

ログ・ファイルを表示するには、次の手順を実行します。

1. ログ情報を表示するドライバ(またはサーバー)を右クリックして、「ログ」→「ログ・ファイルの表示」の順に選択します。
「ログ・メッセージ」ページが表示されます。

このページを使用して、ドライバ(またはサーバー)に関するログ情報を問い合せます。フィールドとリストを使用して問合せをカスタマイズします。

2. 検索条件を入力した後、「ログ・ファイル」をクリックします。「ログ・ファイル」ページが表示されます。

3. ログ情報を表示したり、ログをダウンロードします。

5.2.1 ロギングの構成

図5-2に示すように、Oracle Enterprise Manager Fusion Middleware Controlを使用して、ログ・レベルを構成します。

図5-2 ログ・レベルの構成

図5-3に示すように、各ロガーに対して通知レベルを設定します。

図5-3 通知レベルの選択

5.3 メトリックおよび統計の表示

アプリケーションのパフォーマンスは、メトリックおよび統計に反映されます。

メトリックおよび統計を表示するには、次の手順を実行します。

1. ドライバ(またはサーバー)のパフォーマンス・サマリーを選択します。
図5-4に示すように、「パフォーマンス・サマリー」ページが表示されます。

図5-4 パフォーマンス・サマリー

多数のメトリックを取得して表示できます。最も重要なフォーカスされた情報を取得するには、「メトリック・パレット」を使用します。

2. 「メトリック・パレットの表示」をクリックして、メトリック・パレットを表示します。

3. 最も関心のあるメトリックを選択します。図5-5に示すように、パレットからメトリックを選択したり、選択を解除すると、メトリック表示が自動的に更新されます。

図5-5 メトリック・パレット

6 Oracle User Messaging Serviceの管理

この章では、Oracle User Messaging Service(UMS)の管理方法について説明します。Oracle Enterprise Manager Fusion Middleware Controlで構成ウィザードを使用して、UMSドライバをデプロイ、アンデプロイおよび登録する方法について説明します。また、UMS DBスキーマで必要なくなったデータベース・レコードのパージに使用するプロシージャについても説明します。

この章の内容は次のとおりです:

- 第6.1項「ドライバのデプロイ」

- 第6.2項「UMSスキーマ・パージ・スクリプトの使用方法」

6.1 ドライバのデプロイ

Oracle UMSをインストールすると、事前にインストールされているドライバが組み込まれます(電子メール、XMPP、SMPPおよびTwitter)。このようなドライバの中で、WebLogic Serverにデプロイされるドライバは、ドメインの作成時に使用されるテンプレートに応じて1個または2、3個のみです。

追加ドライバをデプロイするには、ドメインの更新時にFusion Middleware構成ウィザードで展開可能なサーバー・グループを使用します。

6.1.1 Fusion Middleware構成ウィザードを使用したドライバのデプロイ

この項の手順に従って、構成ウィザードを使用してドライバをデプロイします。

- タスク1「構成ウィザードの起動」

- タスク2「構成タイプの選択」

- タスク3「製品テンプレートを使用した既存ドメインの更新」

- タスク4「管理対象サーバーへのユーザーが展開可能なサーバー・グループの割当て」

- タスク5「構成の完了」

タスク1 構成ウィザードの起動

『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』の構成ウィザードの起動に関する項の説明に従って、構成ウィザードを起動します。「構成タイプ」画面が表示されます。

タスク2 構成タイプの選択

「構成タイプ」画面で、「既存ドメインの更新」を選択します。

「ドメインの場所」ドロップダウン・リストからドメイン・ディレクトリを選択するか、「参照」をクリックして移動し、ドメイン・ディレクトリを選択します。「次へ」をクリックして続行します。「テンプレート」画面が表示されます。

タスク3 製品テンプレートを使用した既存ドメインの更新

「テンプレート」画面で、次の図に示すように、「製品テンプレートを使用してドメインを更新」を選択した後、JRFテンプレートのチェック・ボックスを選択してドメインに追加します。

「次へ」をクリックし、『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』の「WebLogicドメインの更新」の説明に従って、「管理対象サーバー」画面が表示されるまで構成ウィザードの各画面に従います。

タスク4 管理対象サーバーへのユーザーが展開可能なサーバー・グループの割当て

「管理対象サーバー」画面で、管理対象サーバーごとに、その管理対象サーバーにターゲット設定するドライバに対応したサーバー・グループのチェック・ボックスを選択します。次の図に示すように、複数のドライバを選択できます。

ユーザーが展開可能なサーバー・グループの詳細は、『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』の「構成ウィザードの画面」を参照してください。

注意:
UMSのリリース12.2.1には、GCM (Google Cloud Messaging) ドライバという新しいドライバが含まれています。このドライバは、このリリースのプレビュー機能として含まれており、一般的には使用できません。

タスク5 構成の完了

『Oracle Fusion Middleware構成ウィザードによるWebLogicドメインの作成』の「WebLogicドメインの更新」で説明されている構成ウィザードの各画面に従って、構成を完了します。

6.2 UMSスキーマ・パージ・スクリプトの使用方法

ums_cleanup.purgeは、UMS DBスキーマで必要なくなったレコードのパージに使用するPL/SQLプロシージャです。このプロシージャは、DBレコードを経過期間に基づいてOracleデータベースからパージします。最初の2、3回は、認定されたDBAがプロシージャを実行することをお薦めします。

警告:

このプロシージャでは、UMS DB表からDBレコードを削除し、即時コミットします。ロールバックはできません。削除されたレコードはリカバリできません。パージ前にこれらの表をバックアップすることをお薦めします。

パージにより、インバウンド・メッセージおよびアウトバウンド・メッセージのエントリがUMSの表から減ります。表6-1に、レコードがパージされる表を示します。

表6-1 UMS DB表のパージされるレコード

表の名前

パージされるレコード

MESSAGE

アウトバウンド/インバウンド・メッセージとその属性

ADDRESS

送信者および受信者のアドレス

DELIVERY_ATTEMPT

配信のレコード

STATUS

メッセージ配信のステータス

DELIVERY_CONTEXT

配信のレコード

6.2.1 UMS DBスキーマ・レコードのパージ

ums_cleanup.purge()は、唯一のパラメータdays_of_retentionを取ります。このパラメータの値は、日数を示す正の整数または浮動小数点です。このプロシージャは、指定の日数より古いレコードをすべてUMS DBスキーマから削除します。たとえば、ums_cleanup.purge(30.5)は、30日と12時間より古いレコードをすべて削除します。

注意:
days_of_retentionの値は、7日以上にする必要があります。

UMS DBスキーマのレコードをパージするには、次のタスクを実行します。

1. UMSスキーマを使用している中間層サーバーをすべて停止します。

2. 次に示すように、SQL Plusのオプションを設定します。

set serveroutput on
set autocommit off

3. SQL Plusから適切なdays_of_retentionパラメータを指定してプロシージャを起動し、必要なくなったレコードをパージします。100日より古いエントリを削除するには、次のコマンドを実行します。

SQL> call ums_cleanup.purge(100);

注意:
UMSスキーマが長期間クリーン・アップされておらず、表に行が大量にある場合は、少しずつ複数回パージすることをお薦めします。たとえば、インスタンスが6か月間頻繁に使用されており、過去30日間のレコードを保持する場合、170、160、…、30のように少しずつ段階的にスキーマをパージします。

4. パージ・プロセス時に停止した中間層サーバーをすべて起動します。

7 Oracle User Messaging Serviceのトラブルシューティング

Oracle User Messaging Service (UMS)をデバッグするには、最初にサーバーの診断ログを確認します。ログには、例外、エラーまたは警告メッセージが含まれている場合があり、不正な動作に関する詳細とともに問題を修正するアクションが示されます。表7-1では、一般的なUMSの問題をデバッグするための他の方法について説明します。

表7-1 UMSのトラブルシューティング

症状

考えられる原因

解決策

SSLハンドシェイク・エラー

WebLogic Serverのデフォルトのキーストア(DemoTrust.jks)が原因でこのエラーが発生している可能性があります。

WebLogic Serverのデフォルトのキーストアを変更します。WebLogic Serverの「カスタムIDとJava標準信頼」キーストアを構成します。

WebLogic Server管理コンソールを使用したキーストアの構成の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの「キーストアの構成」を参照してください。

電子メール通知が送信されない場合

UMS電子メール・ドライバの送信(SMTP)メール・サーバーの設定が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- OutgoingMailServer

- OutgoingMailServerPort

注意: SMTPサーバー接続用の電子メール・クライアントで、これらを使用して値を検証します。

SMTPサーバーに、認証またはセキュアな接続(TLSまたはSSL)が必要です。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- OutgoingUsername

- OutgoingPassword

- OutgoingMailServerSecurity

エラー・メッセージ: 送信者アドレス = <アドレス>に対して一致するドライバが見つかりませんのために通知が送信されない場合

該当するチャネルに対するUMSドライバが特定のSenderAddressesリストで構成されていますが、アプリケーションが送信したメッセージに、一致しない送信者アドレスが設定されています。

注意: UMSサーバーは、アウトバウンド・メッセージの送信者アドレスを使用可能なドライバのSenderAddressesに対して照合(送信者アドレスが設定されている場合)して、メッセージの配信に使用する一致ドライバを検索します。ドライバに1つ以上のSenderAddressesが設定されている場合、UMSサーバーは、一致する送信者アドレスが含まれているメッセージのみをそのドライバに送信します。

- Oracle Fusion Middleware Controlを使用して、該当するUMSドライバの次の設定を確認します。
SenderAddresses

注意: SenderAddressesのフォーマットは、<配信タイプ>:<アドレス>のカンマ区切りのリストです。

例:

EMAIL:sender@example.com, EMAIL:sender@example2.com

- このドライバで、このチャネル(配信タイプ)のすべての送信者アドレスに対するアウトバウンド・メッセージを処理する場合は、このプロパティを空白のままにします。

- 構成が異なる同じチャネル(配信タイプ)に対して複数のドライバ・インスタンスがデプロイされている場合は、SenderAddressesを使用して、ドライバ・インスタンスを区別します。たとえば、あるインスタンスは、SenderAddressesに値を指定して、一致する送信者アドレスが含まれているアウトバウンド・メッセージのみを処理するように設定でき、他のインスタンスはSenderAddressesを空白のままにして、送信者アドレスが指定されていないすべてのアウトバウンド・メッセージ、または最初のドライバ・インスタンスと送信者アドレスが一致しないすべてのアウトバウンド・メッセージを処理するようにできます。

- 構文が正しくないSenderAddresses(<配信タイプ>:が指定されていない場合など)は、ドライバ選択についてはUMSサーバーによって無視されます。

電子メール・クライアントによる通知の受信に矛盾がある場合

UMS電子メール・ドライバの受信メール・サーバーの設定が、通知の送信先と同じ電子メール・アカウントで構成されています。

通知が同じアカウントに送信された場合、電子メール・クライアントが電子メールを表示できるようになる前に、UMS電子メール・ドライバが電子メールをダウンロードして処理する場合があります。

受信メール・サーバーの設定には排他的な電子メール・アカウントを使用してください。Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- IncomingMailIDs

- IncomingUserIDs

アプリケーションが電子メールを受信しない場合

UMS電子メール・ドライバの受信メール・サーバーの設定が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- MailAccessProtocol(大文字でIMAPまたはPOP3)

- ReceiveFolder

- IncomingMailServer

- IncomingMailServerPort

- IncomingMailServerSSL

- IncomingMailServerSSL

- IncomingUserIDs

- IncomingUserPasswords

- ImapAuthPlainDisable

注意: IMAPまたはPOP3サーバー接続用の電子メール・クライアントで、これらを使用して値を検証します。

メール・アクセス・プロトコルが正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- MailAccessProtocol(大文字でIMAPまたはPOP3)

電子メール・サーバーがSSL対応です。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- IncomingMailServerSS

受信フォルダ名が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- ReceiveFolder

注意: 一部の電子メール・サーバーでは、値INBOXをinboxまたはInbox(つまり大/小文字を区別)と記述する必要があります。電子メール・サーバーに応じて適切な値を使用してください。

アプリケーションで対応するAccessPointが登録されませんでした。

UMS APIを使用して、AccessPointを登録します。

詳細は、『Oracle Fusion Middleware Oracle User Messaging Serviceによるアプリケーションの開発』を参照してください。

接続は成功したが、件名が一致していないのですぐに閉じられる

使用されている証明書がその環境では不正です。

各環境(開発、テスト、本番など)は、独自の証明書を使用してプロビジョニングする必要があります。リモート環境に正しい証明書が使用されていることを確認します。

APNS通知が配信されない

本番環境で受信されたデバイス・トークンが、本番以外の環境で使用されている可能性があります。

各環境で受信された正しいデバイス・トークンを使用します。詳細は、https://developer.apple.com/library/ios/technotes/tn2265/_index.htmlを参照してください

A 11gから12cへのユーザー・メッセージング・サービスのアップグレード

この付録では、User Messaging Service (UMS)を11gから12cにアップグレードする際にリモートの管理対象サーバー・ノードから管理サーバーにコピーされるUMS構成ファイルの場所を示します。必要な前提条件をすべて満たし、必要なログイン情報を指定した場合、アップグレード・アシスタントにより、リモート構成ファイルが自動的にコピーされます。アップグレード・アシスタントを使用した構成ファイルのコピーの詳細は、Oracle Fusion Middleware Upgrade AssistantによるアップグレードのUMSの構成に関する項を参照してください。

アップグレード・アシスタントで構成ファイルの自動コピーが失敗した場合のみ、これらのファイルを手動でコピーする必要があります。

構成ファイルは、リモートの管理対象サーバーから管理サーバー上の同じ場所にコピーする必要があります。コピーする必要がある構成ファイルには、UMSサーバー構成ファイル(appconfig.xml)、ドライバの構成ファイル(driverconfig.xml)およびユーザー・プリファレンス・ファイル(businessterms.xml)があります。これらのファイルは、表A-1に示されているように、各管理対象サーバーのapplicationsフォルダにあります。

管理対象サーバーから管理サーバーに構成ファイルを手動でコピーした後に、アップグレード・アシスタントを再度実行する必要があります。

表A-1 構成ファイルの場所

構成ファイル

場所

UMSサーバー(appconfig.xml)

<DOMAIN_HOME>/config/fmwconfig/servers/<MANAGED_SERVER_NAME>/applications/usermessagingserver/configuration/appconfig.xml

ドライバの構成(driverconfig.xml)

<DOMAIN_HOME>/config/fmwconfig/servers/<MANAGED_SERVER_NAME>/applications/usermessagingdriver-<DRIVER_NAME>/configuration/driverconfig.xml

ユーザー・プリファレンス(businessterms.xml)

<DOMAIN_HOME>/config/fmwconfig/servers/<MANAGED_SERVER_NAME>/applications/usermessagingserver/configuration/businessterms.xml

注意:
ドメイン内に複数のドライバがデプロイされている場合は、すべてのドライバの構成ファイルをコピーしていることを確認してください。<DRIVER_NAME>を、ドメインにデプロイされているすべてのドライバ名で置き換えて確認します。

B AQ JMSを設定したユーザー・メッセージング・サービスの構成

この付録では、WLS JMSではなくAQ JMSを使用するようにUMSを構成する方法を説明します。これは、WebLogic Server管理コンソールを使用して実行できます。

ユーザー・メッセージング・サービス(UMS)は、Oracle Streams Advanced Queuing (AQ) JMSを使用するように構成できます。AQ JMSでは、データベース接続を使用してWebLogic Serverクラスタ全体にアクセス可能なデータベースにJMSメッセージが格納されるため、データベース機能やデータ操作およびバックアップのツールを利用できるようにします。典型的な使用例として、サーバー全体の移行の標準サポートでは不十分な、拡張された高可用性(HA)があります。クラスタ内のあるUMSノードに障害が発生した場合、他のノードが障害が発生したUMSノードに対するデータベースからのメッセージを受信するため、メッセージは失われません。

次のタスクでは、WebLogic Server管理コンソールを使用してAQ JMSを設定したUMSの構成方法について説明します。

1. Oracle WebLogic Server管理コンソールにログインします。
ドメイン内のすべての管理対象サーバーを停止します。

2. 左パネルの「チェンジ・センター」で、「ロックして編集」をクリックして構成変更のためにドメインをロックします。

3. 左側の「ドメイン構造」で、「サービス」ノードを開き、「メッセージング」ノード下の「JMSモジュール」に移動します。次の図のような、このドメイン用に作成されたJMSシステム・モジュールが一覧表示されたページが表示されます。

4. UMSJMSSystemResourceを選択して「サブデプロイメント」タブに移動します。再構成するクラスタで稼働しているUMSJMSServerに移動し、次の図に示すように、すべてのUMSJMSServer_auto_xサーバーのターゲット設定を解除します。「保存」をクリックします。

5. UMSJMSSystemResourceの「ターゲット」タブに移動します。次の図に示すように、クラスタのチェック・ボックスの選択を解除してUMSJMSSystemResourceのクラスタのターゲット設定を解除します。「保存」をクリックします。

6. 最初の図に示すように、「JMSモジュール」表からUMSAQJMSSystemResourceに移動します。

7. UMSAQJMSSystemResourceの「ターゲット」タブに移動し、次の図に示すように、UMSJMSSYstemResourceのターゲット設定を解除したのと同じクラスタにUMSAQJMSSystemResourceをターゲット設定します。

設定を保存します。

8. 「チェンジ・センター」で、「変更のアクティブ化」をクリックし、ドメイン内のすべての管理対象サーバーを起動します。