Oracle® Fusion Middleware

Oracle User Messaging Serviceの管理

リリース12c (12.1.2)

E48000-02(原本部品番号:E27788-03)

2013年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.1.2)

E48000-02

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

原本主著者: Swati Thacker

原本協力著者: Savija Vijayaraghavan

原本協力者:

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

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

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

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 Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

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

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

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

Oracle User Messaging Serviceの新機能

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

- リリース12c (12.1.2)に関するこのドキュメントにおけるその他の大きな変更

1 Oracle User Messaging Serviceの概要

- 1.1 ユーザー・メッセージング・サービスの概要

- 1.1.1 コンポーネント

- 1.1.2 アーキテクチャ

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

2 Oracle User Messaging Serviceの構成

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

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

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

- 2.3.1 ドライバの構成

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

- 2.3.1.2 パスワードの保護

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

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

- 2.3.1.5 SMPPドライバの構成

- 2.3.1.6 XMPPドライバの構成

- 2.3.1.7 VoiceXMLドライバの構成

- 2.3.1.8 プロキシ・ドライバの構成

- 2.3.1.9 Twitterドライバの構成

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

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

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

- 2.7 Oracle User Messaging Serviceの保護

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

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

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

- 2.7.4 キーストア構成

- 2.7.5 クライアント別名

- 2.7.6 JMSリソースの保護

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

3 Oracle User Messaging Serviceの監視

- 3.1 Oracle User Messaging Serviceの監視

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

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

- 3.1.3 「すべて」タブを使用したドライバの監視

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

- 3.2.1 ロギングの構成

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

4 Oracle User Messaging Serviceの管理

- 4.1 ドライバのデプロイ

- 4.1.1 WLSTコマンドを使用したドライバのデプロイ

- 4.1.1.1 deployUserMessagingDriver

- 4.1.2 Oracle Enterprise Manager Fusion Middleware Controlを使用したドライバのデプロイ

- 4.2 ドライバのアンデプロイおよび登録解除

はじめに

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

対象読者

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

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

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 User Messaging Serviceによるアプリケーションの開発

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

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

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

Oracle User Messaging Serviceの新機能

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

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

このドキュメントに記載されているOracle User Messaging Service 12c (12.1.2)の新機能と変更された機能は次のとおりです。

- ユーザー・メッセージング・サービス(UMS)の再バンドル: ユーザー・メッセージング・サービス(UMS)は、SOAスイートではなくJRFの一部として使用できるようになりました。そのため、上位スタックと簡単に統合できます。UMSのアーキテクチャとパッケージ化の詳細は、第1.1項「ユーザー・メッセージング・サービスの概要」を参照してください。

- Twitterドライバの導入: 11gでサポートしていた他のドライバに加えて、Twitterドライバもサポートするようになりました。Twitterドライバでは双方向のメッセージング・サービスを利用できるので、アプリケーション・ユーザーはTwitterフィードを公開し、これに対する応答を受信できます。Twitterドライバの詳細は、第2.3.1.9項「Twitterドライバの構成」を参照してください。

- グループ・メッセージングのサポート: 様々なチャネルによる双方向のマルチ・チャネル・メッセージングのサポートに加えて、グループ・メッセージングもサポートするようになりました。グループ・メッセージングの詳細は、第2.5項「グループ・メッセージングのためのOracle User Messaging Serviceの使用」を参照してください。

- ドメイン・レベルおよびクラスタ・レベルの構成のサポート: 11gでは、UMSサーバーやほとんどのタイプのドライバはアプリケーション・レベルの構成のみをサポートしていました。12cでは、ドメイン・レベルで構成を定義しますが、これはクラスタ・レベルでオーバーライドできます。ドメイン・レベルおよびクラスタ・レベルの構成の詳細は、第2.2項「ユーザー・メッセージング・サービスの構成」を参照してください。

- 自動再試行機能のサポート: この機能により、配信に失敗した場合にメッセージの再送信が自動化されます。この機能の詳細は、第2.6項「メッセージの自動再送信の構成」を参照してください。

- ユーザー通信プリファレンス(UCP)サービスの機能拡張: ユーザー・コミュニケーション・プリファレンス(UCP)はユーザー・メッセージング・サービスとパッケージ化されなくなりました。UCPサービスの1つのインスタンスを複数のアプリケーションで使用できます。様々なアプリケーションの各種要件を満たすために、UCPの機能はプロファイルに仮想化されます。これにより、各アプリケーションで特定のプロファイルを指定して、UCP機能のサブセットをカプセル化できます。詳細は、Oracle User Messaging Serviceによるアプリケーションの開発の「ユーザー通信プリファレンス」を参照してください。

- アウトバウンドおよびインバウンド・メッセージでのXAトランザクション・サポート: UMSは、アウトバウンドおよびインバウンド・メッセージに対してXA対応トランザクション(分散トランザクション)をサポートしています。XAのサポートにより、UMSではトランザクションがコミットされたときに、トランザクション境界内のメッセージのみを送信できるようになります。トランザクションがロールバックされた場合は、メッセージの送信に失敗します。この機能の詳細は、Oracle User Messaging Serviceによるアプリケーションの開発のXAトランザクションでのUMSクライアントAPIの使用に関する項を参照してください。

リリース12c (12.1.2)に関するこのドキュメントにおけるその他の大きな変更

このガイドはリリース12c (12.1.2)でいくつかの点が更新されました。

- 11gでは、このドキュメントは『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』に含まれていました。今回のリリースでは、『Oracle Fusion Middleware Oracle User Messaging Serviceの管理』というタイトルの単独のドキュメントとして提供されるようになりました。

1 Oracle User Messaging Serviceの概要

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

- ユーザー・メッセージング・サービスの概要

- Oracle User Messaging Serviceの構成の概要

1.1 ユーザー・メッセージング・サービスの概要

Oracle User Messaging Serviceは、ユーザーとデプロイされたアプリケーション間での双方向通信を可能にします。主な機能は次のとおりです。

- 様々なメッセージング・チャネルに対するサポート: メッセージは、電子メール、インスタント・メッセージ(IM)(XMPP)、ショート・メッセージ・サービス(SMS)(SMPP)およびボイスを介して送受信できます。メッセージはユーザーのSOA/Oracle WebCenterポータル・ワークリストにも配信できます。

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

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

注意:

ユーザー・メッセージング・プリファレンスのUIは、次の場所で入手できます。

http://host:port/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ポータルとの統合: 開発者は、Oracle WebCenterポータル: スペースに対するアプリケーションの作成に、UMS APIを使用できます。このAPIは、Parlay X Web Services for Multimedia Messagingのバージョン2.1(強力なメッセージングに対する標準のWebサービス・インタフェース)を実現したものです。

1.1.1 コンポーネント

Oracle User Messaging Serviceを構成するコンポーネントには、次の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を統合できます。また、UMSは、SMPPをサポートするSMSサービスや、VoiceXMLをサポートする音声変換サービスの外部プロバイダに接続できます。

1.1.2 アーキテクチャ

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

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

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

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

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

1.2 Oracle User Messaging Serviceの構成の概要

Oracle User Messaging Serviceによって、ユーザーはOracle Developerを使用して開発し、Oracle Robotic Serverにデプロイしたクライアント・アプリケーションから送信された通知を受信できます。

Oracle JDeveloperの詳細は、『Oracle Fusion Middleware Oracle Jdeveloperによるアプリケーションの開発』を参照してください。

ワークフロー参加者が通知を受信して転送できるようにするには、Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle User Messaging Service環境を設定します。この環境を設定するには、ワークフロー・アプリケーションのデプロイ先と同じOracle WebLogic Serverに適切なドライバ・インスタンスを構成します。図1-2を参照してください。Oracle User Messaging Serviceには、電子メール、IM、SMSおよびボイスの各チャネルを介したメッセージングをサポートするドライバが含まれています。ユーザー・メッセージング・サービスの構成の詳細は、第2章「Oracle User Messaging Serviceの構成」を参照してください。

図1-2 Oracle Enterprise Manager Fusion Middleware Control

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

2 Oracle User Messaging Serviceの構成

この章では、Oracle User Messaging Service (UMS)の機能およびアーキテクチャについて説明します。使用環境でのOracle UMSの構成および保護方法についても説明します。

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

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

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

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

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

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

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

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

- 第2.8項「Oracle User Messaging Serviceのトラブルシューティング」

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

Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle User Messaging Serviceを構成します。詳細は、Oracle User Messaging Serviceによるアプリケーションの開発を参照してください。

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

ユーザー・メッセージング・サービスでは、ユーザー・メッセージング・サーバーとUMSドライバを構成できます。12cでは、ドメイン・レベルでUMSサーバーの構成を定義しますが、これはクラスタ・レベルでオーバーライドできます。ドメイン内の複数のUMSインスタンスを個別に構成またはデプロイする必要がある場合は、UMSをクラスタ単位でデプロイし、クラスタごとに異なる構成を使用する必要があります。そのため、UMSではUMSサーバーとUMSドライバをドメイン全体およびクラスタ全体で構成できます。

ドメインがクラスタのみで構成されている場合(およびそのドメインにクラスタ化されていない管理対象サーバーが存在しない場合)は、クラスタ・レベルのみの構成の使用をお薦めします。また、UMSでは、特定のドライバ・タイプ(電子メール・ドライバなど)を異なるデプロイメント名で2回以上デプロイすることもできます。これにより、ドメイン内で特定のドライバ・タイプ(この場合は電子メール・ドライバ)の複数のインスタンスを異なる構成で使用できます。

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

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

名前

説明

必須

AppReceivingQueuesInfo

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

はい

DuplicateMessageRetryDelay

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

はい

EngineCommandQueuesInfo

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

はい

EnginePendingReceiveQueueInfo

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

はい

EngineReceivingQueuesInfo

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

はい

EngineSendingQueuesInfo

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

はい

JpsContextName

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

はい

ReceivedmessageStatusEnabled

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

はい

ResendDefault

配信失敗時の自動再送信のデフォルト回数。このプロパティはメッセージごとにプログラムでオーバーライドできます。

はい

ResendDelay

自動再送信間の遅延

はい

ResendMax

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

はい

SecurityPrincipal

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

はい

SessionTimeout

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

はい

SupportedDeliveryTypes

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

はい

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

この項では、Oracle Enterprise Manager Fusion Middleware Controlを使用して次のOracle User Messagingドライバを構成する方法について説明します。

注意:

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

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

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

- SMPPドライバの構成

- XMPPドライバの構成

- VoiceXMLドライバの構成

- プロキシ・ドライバの構成

- Twitterドライバの構成

注意:

クラスタ環境では、管理対象サーバー・ノードごとに別々のメッセージング・ドライバを使用する場合は、すべてのドライバを個別に構成する必要があります。

UMSメッセージング・ドライバはドメイン全体で構成されます。ドメイン内の複数のUMSインスタンスを個別に構成またはデプロイする必要がある場合は、UMSをクラスタ単位でデプロイし、クラスタごとに異なる構成を使用できます。ドライバを1つのみ構成した場合、その構成値は他のクラスタ・ノード上のドライバに移入されません。

2.3.1 ドライバの構成

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

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

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

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

ドライバを構成する手順は、次のとおりです。

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

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

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

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

5. リストからドライバ(電子メール・ドライバなど)を選択し、そのドライバの「ドライバの構成」アイコンをクリックします。
構成ページが表示されます。

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

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

Oracle User Messaging Serviceのドライバは、アウトバウンド・メッセージをルーティングする際にメッセージング・エンジンで使用される共通プロパティ(表2-2に記載)を共有します。通常、管理者が設定するプロパティは、ドライバ・コスト(Cost)とドライバ速度(Speed)、サポートされている電話会社(SupportedCarriers)、構成レベル、サポートされているプロトコル(SupportedProtocols)などのサービスのクオリティ(QoS)に関するプロパティです。ドライバ開発者が構成するプロパティは、管理者が通常変更する必要のない、サポートされている配信タイプ(SupportedDeliveryTypes)、サポートされているコンテンツ・タイプ(SupportedContentTypes)などです。

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

名前

説明

必須プロパティ?

Capability

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

はい

Cost

ドライバのコスト・レベル(0から10)。0は最も低いコスト、10は最も高いコストです。値がこの範囲にない場合、コストは0とみなされます。

いいえ

DefaultSenderAddress

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

いいえ

SenderAddresses

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

いいえ

Speed

ドライバの速度レベル(0から10。10が最高速)。

いいえ

SupportedCarriers

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

いいえ

構成レベル

ドメイン・レベルまたは選択したクラスタに対してクラスタ・レベルでドライバ構成を有効にします。「クラスタ」レベルを選択した場合は、クラスタ名を指定する必要があります。ドメインにクラスタがない場合は、「クラスタ」レベルの選択が無効になります。

はい

SupportedContentTypes

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

はい

SupportedDeliveryTypes

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

はい

SupportedProtocols

サポートされているプロトコルのカンマ区切りのリスト。任意のプロトコルに対してアスタリスク(*)を入力します。

いいえ

SupportedStatusTypes

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

いいえ

SupportsCancel

メッセージの取消し操作をサポート。

いいえ

SupportsReplace

メッセージの置換操作をサポート。

いいえ

SupportsStatusPolling

特定のプロトコルについては、リモート・ゲートウェイのアクティブ・ポーリングを実行して、以前に送信したメッセージのステータスをチェックする必要があります。このプロパティは、ドライバでこのようなステータス・ポーリングがサポートされているかどうかを示します。trueに設定されている場合は、メッセージング・エンジンによって、ドライバ接続のgetStatus()操作が起動されます。

いいえ

SupportsTracking

メッセージのトラッキング操作をサポート。

いいえ

注意:

UMS 12cでは次のドライバ・プロパティをサポートしていません。

- SupportsCancel

- SupportsReplace

- SupportsStatusPolling

- SupportsTracking

これらのプロパティはEMのドライバ構成ページに表示されますが、構成は無効になっています。

2.3.1.2 パスワードの保護

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

ドライバの重要なプロパティを安全に格納する手順は、次のとおりです。

1. 選択したドライバのドライバ構成ページに移動します。

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

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

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

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

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

4. 「適用」をクリックして変更を保存します。

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

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

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

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

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

注意:

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

2.3.1.3.1 共通プロパティ

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

表2-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

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

2.3.1.3.2 カスタム・プロパティ

このドライバは、拡張エンドポイント・グループと呼ばれる複数の構成グループをサポートします。拡張エンドポイント・グループには、拡張通知を配信するリモート・エンドポイントの構成が保持されます。各エンドポイントには、それぞれ異なるプロトコルとマップされたドメインの組合せが必要です。拡張エンドポイント・グループのプロパティを表2-4に示します。

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

名前

説明

必須?

グループ名

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

はい

エンドポイントURL

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

はい

マップされたドメイン

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

いいえ

プロトコル

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

はい

セキュリティ・ポリシー

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

いいえ

ユーザー名

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

いいえ

キーストア別名

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

いいえ

資格証明ストア・キー

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

いいえ

2.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サービスの管理』を参照してください。

2.3.1.3.4 クライアントAPI MessageInfoのサポート

表2-5は、次のメッセージ配信関連のプロパティに対するプロトコルまたはドライバの実装による影響を示しています。これらのプロパティは、クライアントAPIを介して指定されます。

表2-5 クライアントAPI MessageInfoのサポート

名前

説明

サポート対象か

Expiration

Expirationは、メッセージの期限が切れるまでの秒数を意味します。

False

Delay

Delayは、メッセージを送信するまでの秒数を意味します。

False

2.3.1.3.5 使用手順

拡張ドライバを使用するには、次の手順を実行します。

拡張ドライバを使用する手順は、次のとおりです。

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の形式の受信者宛)を送信する場合にのみ適用されることに注意してください。

注意:

UMSと電子メール・サーバー間にセキュアな接続を実現するには、Oracle WebLogic Serverコンテナ内でSSL/TLSが適切に構成されていることが前提条件となります。『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。

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

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

2.3.1.4.1 電子メール・ドライバの互換性

この項では、電子メール・ドライバの互換性機能について詳細に説明します。

電子メール・ドライバは、POP3、IMAP4およびSMTPの各プロトコルと互換性があります。

電子メール・ドライバの機能は、次のとおりです。

- 自動接続再試行

- メッセージ送信にSMTPを使用

- メッセージ受信にIMAP4およびPOP3を使用(ポーリングを使用)

- スケーラブルおよび高可用性

- メッセージ消失の防止および重複の回避

表2-6のゲートウェイ・ベンダーとバージョンが検証済です。

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

ベンダー

バージョン

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

2.3.1.4.2 共通プロパティ

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

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

名前

説明

必須

デフォルト値

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

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

構成レベル

ドメイン・レベルまたは選択したクラスタに対してクラスタ・レベルでドライバ構成を有効にします

はい

ドメイン

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

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

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

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

名前

説明

必須?

デフォルト値

MailAccessProtocol

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

いいえ

IMAP

RetryLimit

この値は、なんらかの理由で接続が失われた場合の受信メール・サーバーへの接続再試行回数を指定します。デフォルト値は-1で、試行回数に制限がないことを示します。

いいえ

-1

MailDelFreq

削除済メッセージを永続的に削除する頻度。単位は秒で、デフォルト値は600秒です。負の値は、メッセージを消去しないことを示します。POP3プロトコルの場合、メッセージは処理後に消去されます。

いいえ

600

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

ImapAuthPlainDisable

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

いいえ

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

2.3.1.4.4 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表2-9は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表2-9 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

2.3.1.5 SMPPドライバの構成

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

注意:

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

2.3.1.5.1 SMPPドライバの互換性

この項では、SMPPドライバの互換性機能について詳細に説明します。

SMPPドライバは、SMPP v3.4プロトコルと互換性があります。

SMPPドライバの機能は、次のとおりです。

- 自動接続再試行

- ファイアウォール・トラバースにHTTPプロキシを使用

- 認証構成

- 構成可能なチャンク・サイズ

- 一括送信

- エンコーディング: UCS2、IA5、GSM_DEFAULT

- 優先度設定

- 構成可能なウィンドウ・サイズ

- プレーン・テキスト・コンテンツのみを使用

表2-10のゲートウェイ・ベンダーが検証済です。

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

ベンダー

Syniverse

Clickatell

Logica CMG

OpenSMPP (simulator)

2.3.1.5.2 共通プロパティ

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

表2-11 共通の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

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

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

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

表2-12 カスタムの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ドライバが前提とするエンコーディングになります。送信メッセージの場合、EncodingAutoDetectを有効にすると、SMPPドライバはこのパラメータの指定どおりにメッセージをエンコードしようとします。

ドロップダウン・リストから「IA5」、「UCS2」または「GSM_DEFAULT」を選択します。

いいえ

IA5

EncodingAutoDetect

有効な場合、SMPPドライバはDefaultEncodingパラメータに指定された値に基づいて送信メッセージをエンコードしようとします。エンコーディングが失敗すると、ドライバは16ビット・エンコーディングUCS2を使用します。

有効でない場合、ドライバはUMSメッセージのContent-Typeヘッダーからエンコーディングを得ます。

いいえ

有効

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ドライバに許容されている最高優先度。範囲は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

ExtraErrorCode

エラー・コードのカンマ区切りのリスト。

いいえ

N/A

MaxChunks

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

いいえ

-1(最大値なし)

ChunkSize

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

いいえ

160

LongMessageSending

長いメッセージの送信をサポートします。デフォルトは「無効」です。

いいえ

無効

DatagramMessageMode

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

いいえ

無効

2.3.1.5.4 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表2-13は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表2-13 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

True

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

2.3.1.6 XMPPドライバの構成

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

2.3.1.6.1 XMPPの概要

XMPPは、IMに対するXMLベースのオープン・プロトコルです。XMPPベースのソフトウェアは、インターネットを介して多数のサーバーにデプロイされており、世界中に何百万人ものユーザーがいます。XMPPは、ユビキタス電子メール・ネットワークに類似した、クライアント/サーバー・アーキテクチャで構成されています。XMPPサーバーは、完全に分散化されているため、誰でも自分のサーバーを設定できます。メッセージングは電子メール・ネットワーク内と同様に実行され、受信者のアドレスには[username]@domain[/resource]という形式のXMPP ID(またはJabber ID、つまりJID)が使用されます。アドレッシング・スキームの詳細は、RFC 3920を参照してください。

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

UMSでXMPPドライバを使用するには、Jabber/XMPPサーバーへのアクセス権と、ログインに使用するUMS XMPPドライバ・インスタンスのXMPPアカウントが必要です。

2.3.1.6.2 XMPPドライバの互換性

この項では、XMPPドライバの互換性機能について詳細に説明します。

XMPPドライバは、XMPP (RFC 3920、3921)のプロトコルと互換性があります。

XMPPドライバの機能は次のとおりです。

- 自動接続再試行

- ファイアウォール・トラバースにHTTPプロキシを使用

- プレーン・テキスト・コンテンツのみを使用

表2-14のゲートウェイ・ベンダーとバージョンが検証済です。

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

ベンダー

バージョン

ejabberd

2.1.3

jabberd2

2.2.14

jabberd14

1.6.1.1-p1

Oracle Beehive

2.0.1.2.1

2.3.1.6.3 サード・パーティ・ソフトウェア

XMPPドライバは、次のサード・パーティ・ソフトウェアを使用または必要とします(オプションで、独自のXMPPサーバーをインストールして構成することもできます)。

表2-15 必要なサード・パーティ・ソフトウェア

名前

説明

バージョン

Apache Smack

このドライバは、Apache Smack XMPP Javaライブラリを使用してJabber/XMPP IMサーバーに接続します。このドライバには、Smackのライセンス・コピーが含まれています。

3.2.2

注意:

既存のサーバーへのアクセス権がある場合、独自のXMPPサーバーのインストールは不要です。パブリック・サーバーのリストについては、http://www.jabber.orgを参照してください。

2.3.1.6.4 ドライバ・アプリケーション・アーカイブ(EAR)

EARファイルは$ORACLE_HOME/communications/applications/usermessagingdriver-xmpp-ear-12.1.2.earです。

2.3.1.6.5 共通プロパティ

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

表2-16 共通のXMPPプロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)

はい

XMPP-IM-Driver

Capability

メッセージの送受信機能

はい

Both

SupportedDeliveryTypes

サポートされている配信タイプ

はい

IM

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

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

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

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

表2-17 カスタムの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が有効になります。

いいえ

有効

2.3.1.6.7 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表2-18は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表2-18 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

2.3.1.7 VoiceXMLドライバの構成

注意:

この項に記載されているVocieXMLドライバは非推奨です。

VoiceXMLドライバは、VoiceXMLで作成されたメッセージを送信する、Genesys VoiceGenieゲートウェイのアウトバウンド・コール・プロトコルをサポートしています。ゲートウェイは、音声変換合成を使用してメッセージを配信します。

2.3.1.7.1 VoiceXMLドライバの互換性

この項では、VoiceXMLドライバの互換性機能について詳細に説明します。

VoiceXMLドライバは、VoiceXML over HTTPプロトコル(VoiceGenieゲートウェイ・プロトコル)と互換性があります。

VoiceXMLドライバの機能は、次のとおりです。

- VoiceXMLコンテンツのみを使用

表2-19のゲートウェイ・ベンダーとバージョンが検証済です。

表2-19 VoiceXMLドライバのゲートウェイ・ベンダーとバージョン

ベンダー

バージョン

Genesys VoiceGenie

6.4.2

2.3.1.7.2 共通プロパティ

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

表2-20 共通のVoiceXMLプロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)

はい

VoiceXML-Driver

Capability

メッセージの送受信機能

はい

SEND

SupportedDeliveryTypes

サポートされている配信タイプ

はい

VOICE

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/vxml, text/x-vxml

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

構成レベル

ドメイン・レベルまたは選択したクラスタに対してクラスタ・レベルでドライバ構成を有効にします

はい

ドメイン

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

2.3.1.7.3 VoiceXMLのカスタム・プロパティ

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

表2-21 カスタムのVoiceXMLプロパティ

名前

説明

必須

デフォルト値

VoiceXMLOutboundServletURI

VoiceXMLゲートウェイのURL。

はい

N/A

VoiceXMLOutboundServletUserName

VoiceXMLゲートウェイのユーザー名。

いいえ

N/A

VoiceXMLOutboundServletPassword

VoiceXMLゲートウェイのユーザーのパスワード。

いいえ

N/A

VoiceXMLOutboundServletDNIS

受信者の呼出し側ID表示で表示される数字。

いいえ

N/A

VoiceXMLReceiveURL

VoiceXMLゲートウェイからの受信リクエストを処理するこのドライバのサーブレットのURL。フォーマットはhttp://host:port/usermessagingdriver-voicexml/receiveです。このプロパティが設定されていない場合のデフォルトの動作では、ローカル・コンテナのHTTPリスナー・ホストおよびポートが使用されます。デフォルトの動作は、最初のドライバ・インスタンスに対してのみ機能します。追加のインスタンスについては、コンテキスト・ルートが異なるため、/sdpmessagingdriver-voicexmlを正しいコンテキスト・ルートに置き換えて構成する必要があります。

いいえ

N/A

注意:

Oracle HTTP Server (OHS)が構成されているクラスタ(高可用性)環境では、OHSポートを使用してVoiceXMLドライバの受信URLを構成しないでください。OHSポートを使用してVoiceXMLドライバの受信URLを構成すると、ドライバと競合します。

各VoiceXMLドライバは、固有のWLSサーバーのポートで構成する必要があります。

2.3.1.7.4 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表2-22は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表2-22 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

2.3.1.8 プロキシ・ドライバの構成

プロキシ・ドライバは、イントラネットやインターネットの他の場所でホスト管理されるFusion Middlewareメッセージング・サーバーに対するメッセージングWebサービス・クライアントとして機能します。SOAP over HTTPを使用して、複数メッセージを送受信し、メッセージの配信ステータスを返します。ParlayX Webサービスは、UMSインスタンス間でメッセージをリレーします。これは、イントラネット内の複数インスタンスから、プロトコル固有のドライバをすべて備えた終了インスタンスにトラフィックをリレーできます。この場合のドライバは、SMSCなどの外部ゲートウェイまたはSMTPやIMAPなどのメール・サーバー用に構成されています。

2.3.1.8.1 共通プロパティ

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

表2-23 共通のプロキシ・プロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)

はい

Proxy-Driver

Capability

メッセージの送受信機能

はい

SEND

SupportedDeliveryTypes

サポートされている配信タイプ

はい

EMAIL, SMS, VOICE, IM, WORKLIST

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

*

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

コスト

コスト

いいえ

N/A

速度

速度

いいえ

N/A

SupportedCarriers

SupportedCarriers

いいえ

N/A

構成レベル

ドメイン・レベルまたは選択したクラスタに対してクラスタ・レベルでドライバ構成を有効にします

はい

ドメイン

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

2.3.1.8.2 プロキシのカスタム・プロパティ

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

表2-24 カスタムのプロキシ・プロパティ

名前

説明

必須

デフォルト値

GatewayURL

ホスト管理されている11g UMS Webサービス・ゲートウェイのURL。このURLのフォーマットは、次のとおりです。

http://<host>:<port>/sdpmessaging/parlayx/SendMessageService

はい

N/A

ユーザー名

メッセージング・ゲートウェイのユーザー名。

いいえ

N/A

Password

ユーザー名のパスワード

いいえ

N/A

Policies

プロキシ・ドライバ・リクエストにアタッチされる、Oracle Web Services ManagerのWS-Securityポリシーのカンマ区切りのリスト

いいえ

N/A

2.3.1.8.3 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表2-25は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表2-25 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

2.3.1.9 Twitterドライバの構成

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

2.3.1.9.1 Twitterドライバの互換性と特徴

TwitterドライバはUMSサーバー12.1.xと互換性がありますが、デフォルトではデプロイされません。個別にデプロイおよびアンデプロイできます。

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

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

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

2.3.1.9.2 共通プロパティ

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

表2-26 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

サポートされている電話会社

サポートされている電話会社

いいえ

N/A

構成レベル

ドメイン・レベルまたは選択したクラスタに対してクラスタ・レベルでドライバ構成を有効にします

はい

ドメイン

サポートされているプロトコル

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

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

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

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

名前

説明

必須

デフォルト値

認証モード

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

はい

xAuth

ユーザー名

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

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

Password

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

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

コンシューマ・キー

Twitterユーザーの公開鍵。

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

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

Twitterユーザーの秘密鍵。

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

アクセス・トークン

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

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

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

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

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

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

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

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

LDAPユーザー・プロファイルへのアクセスを構成する手順は、次のとおりです。

1. $DOMAIN_HOME/config/fmwconfigディレクトリのjps-config.xmlファイルを変更して、idstore.ldap serviceInstanceセクションに<property>要素を追加します。

- バックエンド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>

注意:

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

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

2.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')
createApplicationPolicy(appStripe="myapp")
grantPermission(appStripe="myapp", principalClass="oracle.security.jps.service.policystore.PolicyStoreAccessPermission",codeBaseURL="file:MW_HOME/oracle_common/communications/applications/myapp.ear/-",principalName="orcladmin",permClass="java.security.AllPermission")
grantPermission(appStripe="myapp", principalClass="oracle.security.jps.service.credstore.CredentialAccessPermission",codeBaseURL="file:MW_HOME/oracle_common/communications/applications/myapp.ear/-",principalName="GMgroup1",permClass="java.security.AllPermission"
grantPermission(appStripe="myapp", principalClass="oracle.security.jps.service.credstore.CredentialAccessPermission",codeBaseURL="file:MW_HOME/oracle_common/communications/applications/myapp.ear/-",principalName="GMrole2",permClass="java.security.AllPermission")

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

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

11gでは、UMS APIでフェイルオーバー・アドレスの指定をサポートしています。このアドレスは元の受信者にメッセージを配信できなかった場合に使用されます。フェイルオーバー・アドレスの指定がない場合や、すべてのフェイルオーバー・アドレスに配信を試みて失敗した場合、そのメッセージの送信は完全に失敗したことになります。ただし、管理者はEnterprise Manager Fusion Middleware Controlを使用して失敗したメッセージを選択し、再送信できます。12cでは、自動再送信機能を構成することで、管理者の再送信操作を自動化できます。つまり、メッセージの送信が完全に失敗であると分類された場合に、そのメッセージの再送信が自動的にスケジュールされるということです。これは、そのメッセージの送信が成功するまで、または構成した再送信回数に達するまで繰り返されます。再送信の遅延時間と最大回数を構成できます。機能上、これは、遅延時間を過ぎた場合に管理者が手動でメッセージを再送信するのと変わりません。自動再送信の目的は、ネットワークの一時的な問題や一時的にバックエンド・サービスを利用できない状況を解決することです。

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

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

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

フェイルオーバー・アドレスのステータスを受信するには、getTotalFailovers()とgetFailoverOrder()を呼び出します。これらのメソッドの詳細は、ユーザー・メッセージング・サービスJava APIリファレンスを参照してください。フェイルオーバーの順序とフェイルオーバーの合計が同じ場合は、フェイルオーバー・チェーンがすべて使用されたことがわかります。ただし、再送信機能はフェイルオーバー・チェーンをループします。再送信およびフェイルオーバー・チェーンがすべて使用されたかどうかを確認するには、getMaxResend()とgetCurrentResend()を呼び出します。

注意:

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

2.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サービスの管理を参照してください。

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

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

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

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

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

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

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

キー

一般的な値

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資格証明ストア・マップからのリモート・ユーザー名/パスワード情報の参照に使用する資格証明ストア・キーを指定します。

例2-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);

2.7.4 キーストア構成

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

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

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

2.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サービス・クライアントの作成時に、例2-2に示すように、キーをoracle.wsm.security.util.SecurityConstants.Config.KEYSTORE_RECIPIENT_ALIAS_PROPERTYに設定し、値を「ums_public_key」に設定して受信キーストア別名パラメータを指定します。

例2-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サービス・クライアントのポリシー構成のオーバーライドに関する項を参照してください。

2.7.6 JMSリソースの保護

この(オプションの)手順では、セキュリティを向上させるために、管理者がOracle User Messaging Serviceの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システムで使用されるデフォルトのユーザー・アイデンティティをオーバーライドする必要があります。

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

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

表2-29 UMSのトラブルシューティング

症状

考えられる原因

解決策

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

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

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

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

通知がSOA内のBPELまたはヒューマン・ワークフローから送信されない場合

SOAワークフロー通知の構成で通知モードが「NONE」に設定されています。

Oracle Fusion Middleware Controlを使用して、通知モードの設定を「EMAIL」または「ALL」に変更します。

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

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

SOAヒューマン・ワークフロー通知が送信されるが、アクション可能ではない場合

アクション可能な電子メール・アドレスがSOAワークフロー通知プロパティで構成されていません。

UMS電子メール・ドライバで構成された電子メール・アカウントのアドレスを使用して、SOAワークフロー通知プロパティでアクション可能な電子メール・アドレスを設定します。

ヒューマン・ワークフロー・タスクがアクション可能な通知を送信するように設定されていません。

JDeveloperでヒューマン・ワークフロー・タスクのアクション可能属性を設定し、SOAコンポジット・アプリケーションを再デプロイします。

SOAヒューマン・ワークフローのアクション可能な通知が送信されるが、応答後アクションが実行されない場合

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(つまり大/小文字を区別)と記述する必要があります。電子メール・サーバーに応じて適切な値を使用してください。

デフォルト以外の電子メール・クライアントが通知受信用に構成されています。ユーザーが承認リンクをクリックすると、デフォルトのメール・クライアント・ページが開き、このページで別の電子メール・サーバーに電子メールを送信できます。

デフォルトの電子メール・クライアントを、アクション可能な通知を受信するように構成します。

SOA BPELユーザー通知またはヒューマン・ワークフロー通知が正しい配信タイプ(電子メール、SMSなど)に送信されるが、間違ったアドレスに送信される場合

ユーザー・メッセージング・プリファレンスで、ユーザーが、BPELユーザー通知またはヒューマン・ワークフロー・ユースケースで使用するために、セルフプロビジョニング・メッセージング・チャネルを作成しました。

注意: ユーザー・メッセージング・プリファレンスのUIを使用すると、エンド・ユーザーは様々なユースケースに対する独自のメッセージング・チャネルを作成できますが、これらはBPELユーザー通知およびヒューマン・ワークフローに使用することを目的としていません。

BPELユーザー通知またはヒューマン・ワークフロー・ユースケースには、セルフプロビジョニング・メッセージング・チャネルは使用しないでください(つまり、デフォルトのチャネルとして設定しないでください。また、このようなユースケースに対するメッセージ・フィルタで使用しないでください)。BPELユーザー通知およびヒューマン・ワークフローでは、配信タイプ・プリファレンスに対してのみユーザー・メッセージング・プリファレンスが使用され、実際のアドレスはアイデンティティ管理システムのユーザー・プロファイルから取得されます。

注意: アイデンティティ管理システムのユーザー・プロファイルからのアドレスは、事前定義のチャネル名(「勤務先電子メール」、「業務用携帯電話番号」、「勤務先電話番号」、「インスタント・メッセージ」など)を使用して、ユーザー・メッセージング・プリファレンスを介して使用可能です。BPELユーザー通知およびヒューマン・ワークフロー・ユースケースには、かわりにこれらの事前定義済メッセージング・チャネルを使用してください。

3 Oracle User Messaging Serviceの監視

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

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

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

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

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

3.1 Oracle User Messaging Serviceの監視

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

Oracle User Messaging Serviceを監視するには、次の手順を実行します。

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

2. 「ユーザー・メッセージング・サービス」フォルダを開きます。

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

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

4. 次の図に示すように、サーバーを右クリックして任意のアクションを選択します。

選択項目

アクション

ホーム

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

コントロール

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

ログ

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

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

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

メッセージ・ステータス

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

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

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

サーバー・プロパティ

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

システムMBeanブラウザ

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

ターゲット情報

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

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

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

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

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

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

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

検索のカスタマイズ

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

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

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

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

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

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

メッセージの削除

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

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

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

注意:

EM UIの日付機能を使用してメッセージを削除する場合、削除するメッセージの数が2000個以下であることを必ず確認してください。削除するメッセージが2000個を超える場合、次のエラー・メッセージが表示されます。

指定したオプションでは、2000件を超えるメッセージが削除されます。問合せを絞り込んで再試行してください。

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

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

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

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

2. 登録解除するメッセージを選択します。

3. 「登録解除」をクリックします。

選択内容を確認する確認ボックスが表示されます。

4. 選択内容を確認します。

3.1.3 「すべて」タブを使用したドライバの監視

「すべて」タブには、(存在するすべてのドライバではなく)ドメイン内で正常に登録されたドライバのみがリストされます。

ドライバはデフォルトでは構成されていないため、自分で構成しないかぎり登録されません。「すべて」タブにすべてのドライバを表示するには、SMPP、VoiceXMLおよびXMPPドライバを構成します(使用することを計画している場合)。構成すると、ドライバはエンジンに登録され、「すべて」タブに表示されます。

3.2 ログ・ファイルの表示

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

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

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

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

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

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

3.2.1 ロギングの構成

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

図3-1 ログ・レベルの構成

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

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

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

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

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

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

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

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

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

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

図3-4 メトリック・パレット

4 Oracle User Messaging Serviceの管理

この章では、Oracle WebLogic Scripting Tool (WLST)およびOracle Enterprise Manager Fusion Middleware Controlを使用してOracle User Messaging Service (UMS)ドライバをデプロイする方法について説明します。Oracle UMSドライバのアンデプロイおよび登録方法についても説明します。

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

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

- 第4.2項「ドライバのアンデプロイおよび登録解除」

4.1 ドライバのデプロイ

Oracle UMSをインストールすると、事前にインストールされているドライバが組み込まれます(電子メール、XMPP、SMPPおよびVoiceXML)。このドライバの中で、WebLogic Serverにデプロイされるのは電子メール・ドライバのみです。他のドライバをデプロイするには、Oracle WebLogic Server管理コンソールを使用して、そのドライバをWebLogic Serverにデプロイしてください。

UMSとワークリストの統合を使用する場合は、ワークリスト・ドライバをSOAサーバーにデプロイする必要があります。この統合には複数のJEEアプリケーションおよびSOAコンポジットが含まれているため、この機能を1ステップで使用可能にするには、特別な拡張テンプレートを使用する必要があります。詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のOracle WebLogic Serverプラットフォームでのワークリスト・ドライバのインストールに関する項およびIBM WebSphereプラットフォームでのワークリスト・ドライバのインストールに関する項を参照してください。

追加のドライバは様々な方法でデプロイでき、WLSTコマンド(推奨)、Oracle Enterprise Manager Fusion Middleware Controlを使用する方法があります。

この項は次のトピックで構成されています。

- 第4.1.1項「WLSTコマンドを使用したドライバのデプロイ」

- 第4.1.2項「Oracle Enterprise Manager Fusion Middleware Controlを使用したドライバのデプロイ」

注意:

特定のドライバEARの2つ以上のドライバ・インスタンスをデプロイするには、$ORACLE_HOME/communications/plansで入手できるカスタムのデプロイ・プラン・テンプレートを使用する必要があります。WLSTコマンドではデプロイ・プランが自動的に変更されるため、これらのコマンドを使用したドライバのデプロイをお薦めしますが、他の方法を使用する場合は、デプロイ・プランを手動で変更する必要があります。

4.1.1 WLSTコマンドを使用したドライバのデプロイ

WLSTコマンドdeployUserMessagingDriverを使用してドライバをデプロイできます。

4.1.1.1 deployUserMessagingDriver

コマンド・カテゴリ: UMS

WLSTでの使用: オンライン

4.1.1.1.1 説明

deployUserMessagingDriverは、ユーザー・メッセージング・ドライバの追加インスタンスをデプロイするために使用されます。新しいドライバ・デプロイメントのベース・ドライバ・タイプ(例: email、xmpp、voicexmlなど)および短縮名を指定します。指定されたアプリケーション名の前に文字列usermessagingdriver-が付加されます。deployコマンドについて有効なパラメータを指定でき、ドライバをデプロイするときに渡されます。

4.1.1.1.2 構文

deployUserMessagingDriver(baseDriver, appName, [targets],
[stageMode], [options])

引数

定義

baseDriver

ベース・メッセージング・ドライバ・タイプを指定します。

email、proxy、smpp、voicexmlまたはxmppなどの既知のドライバ・タイプを指定する必要があります。

appName

新規デプロイメントの短い説明の名前。指定された値が文字列usermessagingdriver-の前に付加されます。

targets

stageMode

options

オプション。deployコマンドについて有効な追加の引数を指定でき、新規ドライバをデプロイするときに渡されます。

4.1.1.1.3 例

myEmailという名前の電子メール・ドライバの2番目のインスタンスをデプロイする場合

wls:/base_domain/serverConfig> deployUserMessagingDriver(baseDriver='email',
appName='myEmail')

デプロイメント・ターゲットを指定して、電子メール・ドライバの2番目のインスタンスをデプロイする場合

wls:/base_domain/serverConfig> deployUserMessagingDriver(baseDriver='email',
appName='email2', targets='server1,server2')

4.1.2 Oracle Enterprise Manager Fusion Middleware Controlを使用したドライバのデプロイ

Oracle Enterprise Manager Fusion Middleware Controlを使用してドライバをデプロイするには、次の手順を実行します。

1. デプロイメント・テンプレート(例: ORACLE_HOME/communications/plans)を取得します

2. プランを目的の場所(同じディレクトリまたは他のディレクトリ)にコピーします。

3. プランを編集します。

使用する任意の名前で、「DriverDeploymentName」を置き換えます(この名前のすべての出現箇所を置き換えたことを確認します)。

「DriverShortName」を任意の名前に置き換えます。

@RunAsPrincipalName@トークンを、UMSで使用する有効なプリンシパルに置き換えます。デフォルト・デプロイメントでは、システム・プリンシパル「OracleSystemUser」がこの目的で使用できます。

4. Oracle Enterprise Manager Fusion Middleware Controlを開始します。

5. .earファイルの場所を入力します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

7. デプロイメント・プランの場所を入力します。

8. SOAターゲットを選択します。

9. 「アプリケーション属性」ページでアプリケーション名を入力します。アプリケーション名は、デプロイ・プランで指定したDriverDeploymentName(前述のステップ3)に使用した文字列と正確に一致する必要があります。一致しない場合、デプロイメントおよびアクティブ化は失敗します。「デプロイ設定」ページが表示されます。

10. 「デプロイ」をクリックします。「デプロイが完了しました」ページが表示されます。

11. 結果(デプロイされたドライバ)を確認するには、SOAサーバーを起動します。

4.2 ドライバのアンデプロイおよび登録解除

メッセージング・ドライバは標準JEEアプリケーションであるため、管理コンソールやWLSTなどの標準のOracle WebLogicツールを使用して、Oracle WebLogic Serverからアンデプロイできます。

ただし、UMSサーバーは、登録されたメッセージング・ドライバを永続ストア(データベース)に記録し続けるため、UMSサーバーによって公開されているランタイムMBeanを使用して、別の手順でこの登録を解除する必要があります。これをOracle Enterprise Manager Fusion Middleware Controlから実行する手順は、次のとおりです。

ドライバをアンデプロイおよび登録解除するには、次の手順を実行します。

1. UMSサーバーが使用可能であることを確認します。

2. Oracle Enterprise Manager Fusion Middleware Controlで、ドメイン内の任意のusermessagingserverターゲットを選択します。

3. ターゲットのメニューから「システムMBeanブラウザ」を選択します。

4. 「システムMBeanブラウザ」で、usermessagingserverの「ComponentAdministration」MBeanを検索します。
フォルダ「com.oracle.sdp.messaging」→「Server」(Server: AdminServerなど)→「SDPMessagingRuntime」→「ComponentAdministration」を開きます。

5. 次の方法で、操作listDriverInstancesを起動します。

1. 「操作」タブをクリックします。

2. 操作listDriverInstancesをクリックします。

3. 「呼出し」をクリックします。

4. 登録解除するドライバの名前を見つけてコピーします。たとえば、Farm_base_domain/base_domain/AdminServer/usermessagingdriver-email:oracle_sdpmessagingdriver_email#Email-Driverです。次の図に示すように、ドライバ名は「戻り値」表に表示されます。

6. 「戻る」をクリックします。

7. 次の方法で、目的のドライバ名を指定して操作unregisterDriverInstanceを起動します。

1. 操作unregisterDriverInstanceをクリックします。

2. 「値」フィールドにドライバ名を貼り付けます。たとえば、Farm_base_domain/base_domain/AdminServer/usermessagingdriver-email:oracle_sdpmessagingdriver_email#Email-Driverです。

3. 「呼出し」をクリックします。

8. 確認ダイアログで処理が成功したことを確認します。

これで、指定したドライバのUMSサーバーからの登録解除が完了し、今後のメッセージ配信で使用されなくなります。

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2014, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

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の登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利

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

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）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

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

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。