Oracle® Fusion Middleware

Enterprise Single Sign-On Provisioning Gateway管理者ガイド

11g リリース2 (11.1.2.2)

E53411-01(原本部品番号:E37696-01)

2013年12月

Oracle Fusion Middleware Enterprise Single Sign-On Provisioning Gateway管理者ガイド, 11g リリース2 (11.1.2.2)

E53411-01

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

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

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

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

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

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

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

1 Provisioning Gateway Administrative Consoleの概要

- 1.1 Provisioning Gateway Administrative Consoleへのアクセス

- 1.1.1 バージョン情報

- 1.1.2 ログオン・ページ

- 1.1.3 セキュリティ設定

- 1.1.4 Provisioning Gateway Administrative Consoleへのアクセス権の付与

- 1.1.5 暗号化アルゴリズムの変更

- 1.1.6 SSLの有効化

- 1.1.7 権限の設定

- 1.2 一般的な推奨事項および注意

2 Provisioning Gatewayの設定

- 2.1 「Web Service Account」の設定

- 2.2 「Storage」の設定

- 2.3 「Event Log」の設定

- 2.4 「Template Mapping」の設定

3 ユーザーの管理

- 3.1 「Manage SSO Users」ページ

- 3.1.1 ユーザーの検索

- 3.1.2 検索結果

- 3.1.2.1 ユーザーの管理

4 ロールまたはグループのサポートの設定

- 4.1 「Provisioning」タブの使用

- 4.1.1 ユーザーまたはグループの追加

- 4.1.1.1 LDAP

- 4.1.1.2 Active DirectoryおよびAD LDS (ADAM)

5 「Provisioning Gateway」ノード

- 5.1 「Provisioning」タブ

- 5.1.1 「Default Rights」タブ

- 5.1.2 「Delete SSO User Right」タブ

6 レポートとログ

- 6.1 レポートのタイプ

- 6.1.1 Event Log

- 6.1.2 Status Request

- 6.1.3 Generate Report

7 Provisioning Gateway CLI

- 7.1 CLIについて

- 7.2 CLI構文

- 7.2.1 .NETとJava CLIのアプローチの相違点

- 7.3 操作モード

- 7.3.1 コマンドライン・モード

- 7.3.2 バッチ・モード

- 7.3.3 対話モード

- 7.3.4 スマート・デフォルト

- 7.3.5 操作の実行

- 7.3.6 使用状況

- 7.3.7 ステータスの結果

- 7.4 プロビジョニング操作

- 7.4.1 パラメータ

- 7.4.2 構文

- 7.4.3 カンマのエスケープ

- 7.4.3.1 例

- 7.5 SDKとしての.NET CLIの使用

- 7.5.1 Passlogix.Provisioningへの参照の追加

- 7.5.2 IProvisioningインタフェースのインスタンスの作成

- 7.5.2.1 iProvインタフェースで使用可能なメソッド

- 7.5.3 結果の取得

- 7.5.3.1 インタフェース定義

- 7.5.4 属性コレクション

- 7.5.5 ExtSearchの結果

- 7.5.5.1 ExtSearchApplications

- 7.5.5.2 ExtSearchUsers

- 7.5.5.3 ExtSearchLog

- 7.5.6 サンプル・コード

- 7.6 SDKとしてのJava CLIの使用

- 7.6.1 サンプル・コード

- 7.6.2 クラス定義

- 7.6.2.1 CLIOperationParserクラス

- 7.6.2.2 OperationParserクラス

- 7.6.2.3 Operationクラス

- 7.6.2.4 OperationKeysインタフェース

- 7.6.2.5 ExtSearchKeysインタフェース

- 7.6.3 SSLを使用するためのJavaの設定

はじめに

『Oracle Enterprise Single Sign-On Provisioning Gateway管理者ガイド』では、各ユーザーのLogon Manager 資格証明ストア内で、アプリケーションの資格証明の追加、変更および削除をリモートから直接実行可能にすることによって、ローカルの資格証明取得の必要がなくなり、ユーザーはターゲット・アプリケーションにすぐにアクセスできるようになるためのProvisioning Gateway Administrative Consoleの使用方法について説明します。

対象読者

このドキュメントは、Provisioning Gatewayの計画、実装およびデプロイメントを担当する、経験豊富な管理者を対象としています。管理者は、シングル・サインオンの概念を理解し、Internet Information Services、Windowsレジストリ設定およびOracle Enterprise Single Sign-On Administrative Consoleに精通していることが求められます。

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

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 Enterprise Single Sign-On Suiteドキュメント・セットの次のドキュメントを参照してください。

- リリース・ノート

- Oracle Enterprise Single Sign-On Suiteインストレーション・ガイド

- Oracle Enterprise Single Sign-On Suite管理者ガイド

- Oracle Enterprise Single Sign-On Suiteセキュア・デプロイメント・ガイド

- Oracle Enterprise Single Sign-On Suiteユーザーズ・ガイド

- ディレクトリ・ベースのリポジトリでのLogon Managerのデプロイ

- Logon Managerアプリケーション・テンプレートの構成および診断

- Oracle Enterprise Single Sign-On Provisioning Gateway管理者ガイド

表記規則

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

表記規則

意味

太字

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

イタリック

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

固定幅

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

1 Provisioning Gateway Administrative Consoleの概要

管理者は、Provisioning Gateway Administrative Consoleを使用して、Provisioning Gateway Webサービスから情報を設定、収集および管理できます。Provisioning Gateway Administrative Consoleからは、次のモジュールにアクセスできます。

- Settings

- Users

- Reports and Logs

1.1 Provisioning Gateway Administrative Consoleへのアクセス

Provisioning Gateway Administrative Consoleへのアクセス方法:

- Webブラウザを開き、次のURLを入力します。

https://yourserverhost/v-go pm console/logon.aspx

意味は次のとおりです。

yourserverhostは、Provisioning Gatewayをインストールしたサーバーの名前です。

ログオン・ページが開きます。

1.1.1 バージョン情報

バージョン情報モジュールでは、インストールされたProvisioning GatewayおよびMicrosoft .NET Frameworkのバージョンについての情報が提供されます。

- Product Version: インストールされているProvisioning Gatewayのバージョンを示します。

- .Net Framework: インストールされているMicrosoft .Net Frameworkのバージョンを示します。

1.1.2 ログオン・ページ

ログオン資格証明を入力してProvisioning Gateway Webサービスにアクセスし、「Log On」をクリックします。ユーザー名およびパスワードは、ディレクトリ認証資格証明と同じにする必要があります。たとえば、Active DirectoryまたはAD LDS (ADAM)の場合、ユーザー名は、domainname\usernameという形式にする必要があります。

SunまたはIBMの場合、ユーザー名は、uid=usernameという形式になります。

注意:

Provisioning Gatewayサーバーでは、アクセス可能な資格証明のみが認識されます。Active DirectoryまたはAD LDS (ADAM)の場合、これらの認識される資格証明はドメイン・アカウントです。SunおよびIBMの場合は、このアカウントが記憶域に存在している必要があります。記憶域が定義されていない場合、このアカウントは、Webサービスが実行されているサーバーのローカル・アカウントに対して認証されます。

1.1.3 セキュリティ設定

Provisioning Gatewayは、デフォルトのセキュリティ設定を変更せずに実行できます。一部の設定を変更すると、セキュリティを強化できます。

Provisioning Gatewayのセキュリティ設定は、Microsoft .Net FrameworkのASP.NET構成の設定を使用して編集できます。その後、これらの設定の変更は、Provisioning Gatewayの次の構成ファイルに反映されます。

- <local directory>\Provisioning Gateway\Service\web.config

- <local directory>\Provisioning Gateway\Console\web.config

1.1.4 Provisioning Gateway Administrative Consoleへのアクセス権の付与

デフォルトでは、すべてのユーザーのProvisioning Gateway Administrative Consoleへのアクセスが拒否されます。Oracle Enterprise Single Sign-On Administrative Consoleを使用して、ユーザーにプロビジョニング権限を割り当てることができます。ユーザーに対して次のアクションを実行できます。

- ユーザーにログオンをプロビジョニング(資格証明を追加、変更、削除)します。テンプレートの「Provisioning」タブで、これらの権限を割り当てます。

- SSOユーザーを削除します。Provisioning Gatewayノードの「 Delete SSO User Right」で行います。

これらの設定を構成し、リポジトリに公開して、ユーザーにProvisioning Gateway Administrative Consoleへのアクセス権を付与します。

これらの設定の使用方法の詳細は、『Oracle Enterprise Single Sign-On Suite管理者ガイド』を参照してください。

1.1.5 暗号化アルゴリズムの変更

デフォルトでは、Provisioning Gateway Webサービスで3DES暗号化が使用されます。セキュリティを強化するには、暗号化をAESに変更できます。この機能を有効にするには、Oracleのサービス・プロパティの設定を編集する必要があります。

1. 「コントロール パネル」 > 「インターネット インフォメーション サービス」に移動します。

2. 「Provisioning Gateway Service」Webサイトをクリックします。「プロパティ」を選択します。

3. 「ASP.NET」タブをクリックします。ASP.NETのバージョンが2.0.xに設定されていることを確認します。(2.0に設定されていない場合は、設定を変更して「適用」をクリックします。)「構成の編集」をクリックします。

4. 「ASP.NET構成の設定」ダイアログで、「EncryptionAlgorithm」を選択し、「編集」をクリックします。

5. 「値」フィールドの「3DES」を「AES_256」に置き換えます。この値によって、Provisioning Gateway ServiceでAES暗号化メソッドが使用されるようになります。

1.1.6 SSLの有効化

テストの目的で、Provisioning Gateway Consoleのプロパティ内のlocalhost.UPキーを変更してSSLを有効にできます。

1. 「ASP.NET構成の設定」ダイアログで、「localhost.UP」を選択し、「編集」をクリックします。

2. 「コントロール パネル」 > 「インターネット インフォメーション サービス」に移動します。「Provisioning Gateway Console」Webサイトをクリックします。「プロパティ」を選択します。

3. 「ASP.NET」タブをクリックします。ASP.NETのバージョンが2.0.xに設定されていることを確認します。(2.0に設定されていない場合は、設定を変更して「適用」をクリックします。)「構成の編集」をクリックします。

4. 「値」フィールドで、https://localhost/Provisioning Gateway Service/UP.asmxと入力して、http://localhost/Provisioning Gateway Service/UP.asmxと置き換えます。

5. IIS内のProvisioning Gatewayサービスのプロパティを編集してSSLを無効にできます。

1.1.7 権限の設定

Provisioning Gatewayをインストールする際、Provisioning Gatewayが正常に機能するように、ドメイン・レベルで特定のサービス・アカウントを作成する必要があります。この項では、Active Directory内の特定のオブジェクトへの特定の権限セットを持つアカウントを作成することで、セキュリティを強化する方法を説明します。

セキュリティを強化するには、このサービス・アカウントをドメイン・ユーザー・グループのメンバーとして作成することをお薦めします。(このドキュメントでは、サービス・アカウントはPMSERVICEという名前ですが、任意の命名規則に従うことができます。)

この項の手順では、次の方法を説明します。

- ドメイン・ユーザー・グループのメンバーとしてサービス・アカウント(PMSERVICE)を作成する方法

- Active Directory内の特定のオブジェクトへの特定の権限セットをサービス・アカウントへ付与する方法

- プロビジョニングのテンプレートを作成する方法

- ユーザーをプロビジョニングする方法

注意:

また、PMSERVICEアカウントも、Provisioning Gatewayサーバー側のコンポーネントがインストールされているIISサーバーのローカル管理者グループのメンバーである必要があります。

Logon Managerのインストールに関する特定のタスク、スキーマの拡張、ソフトウェアのインストールおよびActive Directory内の特定の権限の変更を完了するには、ドメイン管理およびスキーマ管理権限を持つアカウントが必要です。

1.2 一般的な推奨事項および注意

Microsoft社は、ドメイン・コントローラにInternet Information Server (IIS)をインストールすることを推奨しています。Oracleでは、ドメイン・コントローラではなく、メンバー・サーバーにProvisioning Gatewayのサーバー側コンポーネントをインストールすることをお薦めします。

このドキュメントに示す手順および推奨事項は、目的の結果が得られるように制御された環境でテストされています。作業環境にできるだけ近い非本番環境でこれらの手順をテストすることをお薦めします。

ここに示す手順には、ドメイン全体に影響する可能性がある変更が含まれています。大規模な企業には、特別なポリシー、信頼、継承問題、イントラサイトやインターサイトのレプリケーション問題が存在するため、実際の環境外で完全にテストすることはできません。

多数のユーザーに影響を与える可能性のある問題と同様に、インストール、構成およびメンテナンスの担当者がこの製品をテストおよびデプロイする賢明かつ慎重な方法をお薦めします。

2 Provisioning Gatewayの設定

この章では、Provisioning Gatewayを構成する設定の使用に関する情報を提供します。

2.1 「Web Service Account」の設定

「Web Service Account」ページを使用して、IIS Webサービス用の匿名ログオンを設定または変更します。Provisioning Gateway Webサービスは、このドメイン・アカウントとして実行します。「Web Service Account」ダイアログに、現行の匿名ログオン・アカウントおよびこのアカウントを変更するためのログオン・フォームが表示されます。

注意:

アカウントを変更するには、Provisioning Gateway Consoleに対してProvisioning Gateway Webサーバーの管理者グループのメンバーとして認証される必要があります。

Webサービス・アカウントには、次の権限が必要です。

- レジストリ・パスHKLM\Software\Passlogixに対する読取り権限および書込み権限

- 記憶域に対する接続権限、読取り権限および書込み権限(Active DirectoryまたはAD LDS (ADAM)の場合)

Webサービス・アカウントを変更するには、アカウントのユーザー名(Domain\Usernameという形式)およびパスワードを入力し、パスワードを確認して「Save」をクリックします。

2.2 「Storage」の設定

「Storage」ページを使用して、Provisioning Gatewayデータのリポジトリとして使用されるディレクトリ・サービス(Oracle Internet Directory、Microsoft Active Directory、Microsoft AD LDS (ADAM)、IBM LDAP DirectoryまたはSun Directory Server)の接続設定を表示または変更します。

変更が完了したら、「Save Changes」をクリックして、Provisioning Gatewayに新しい設定を適用します。記憶域の設定を保存すると、Provisioning Gatewayに対する再認証を求められます。

このページの情報は、暗号化され、HKLM\Software\Passlogix\PM\Server\Storageの下のレジストリに保存されます。

設定

値

*Storage Type

次のいずれかの記憶域の場所を選択します。

- Oracle Internet Directory

- Oracle Directory Server Enterprise Edition

- Oracle Virtual Directory

- Sun Directory Server

- Microsoft Active Directory

- Microsoft AD LDS (ADAM)

- IBM LDAP Directory

- Novell eDirectory

*Server

サーバーの名前またはIPアドレスのいずれかを入力します。

*Root DN

ルート・ディレクトリ。

たとえば、DC=mydir,DC=comなどです。

次の設定は、Oracle Directories、Active Directory、IBM LDAP Directory、Novell eDirectoryおよびSun Directory Serverの記憶域でのみ使用します。

*User Path(s)

ユーザー・アカウントの場所を示す完全修飾されたパス。検索するパスの数に制限はありません。パスは、セミコロン(;)で区切られていて、入力した順序で検索されます。

たとえば、CN=users,DC=mydir,DC=comなどです。

次の設定は、Active DirectoryまたはAD LDS (ADAM)(あるいはその両方)の記憶域でのみ使用します。

Prepend Domain

このオプションは、ユーザーのコンテナに名前を付ける際にユーザー名にユーザーのドメインを追加できるようにする場合に選択します。たとえば、ドメインoracleおよびユーザーjameskの場合、コンテナは、このフラグを無効にするとjameskと名付けられ、このフラグを有効にするとoracle.jameskと名付けられます。

次の設定は、Active Directoryの記憶域でのみ使用します。

Locate in User

Active Directoryユーザー・オブジェクトの下のProvisioning Gatewayユーザー・データを検索できるようにする場合に選択します。

次の設定は、Sun LDAPの記憶域でのみ使用します。

User Prepend

ディレクトリのユーザー・オブジェクトのユーザー・ネーミング属性を指定します。この設定は、ユーザー・オブジェクトの相対識別名(RDN)の作成に使用します。一般的な値は、CNまたはUIDです。

次の設定は、Oracle Directories、IBM LDAP Directory、Novell eDirectoryまたはSun Directory Serverの記憶域でのみ使用します。

*Connect as User

ディレクトリ管理者のユーザー名。

*Password

ディレクトリ管理者のパスワード。

次の設定は、Oracle Directories、Active Directory、IBM LDAP Directory、Novell eDirectoryまたはSun Directory Serverの記憶域でのみ使用します。

Use secure connection (SSL)

Secure Socket Layerを有効にする場合に選択します。

構成オブジェクトまたはロール/グループのサポートを使用する場合は、ディレクトリのすべての記憶域タイプで次の設定を使用します。

Use configuration objects instead of application list

アプリケーション構成リスト(entlistsとも呼ばれる)のかわりに、構成オブジェクト(OC)を使用できるようにする場合に選択します。

Provisioning Gatewayサーバーでは、ディレクトリ内のプロビジョニング・オブジェクトを検索することによって、プロビジョニング・クライアントのアクセス制御権が取得されます。アクセス可能なオブジェクトのみが検出されます。

Role/Group support

管理ユーザーのロール/グループ・ベースのアクセス制御を有効にする場合に選択します。ロール/グループのサポートを有効にすると、構成オブジェクトのサポートが有効になります。

ロール/グループのサポートを有効にする場合は、権限を指定する必要があります。権限を指定しない場合、デフォルトでは、すべてのユーザーおよびグループによるすべてのアクションへのアクセスが拒否されます。

権限の設定については、第4章「ロールまたはグループのサポートの設定」を参照してください。

Configuration and role/group objects root DN

構成オブジェクトおよびプロビジョニング・オブジェクトの検索を開始する場所を指定します。指定した場所から下方向に検索が行われます。たとえば、ou=vgoconfig、dc=test2003,dc=com、dc=passlogix,dc=comなどです。

このコンテナへのパスには、これらの記憶域設定の入力の前に、少なくとも1つのテンプレートが存在するか含んでいる必要があります。テンプレートは、そのパスではなくサブパスに存在することもできます。このコンテナが存在しない場合、エラー・メッセージが表示されます。

権限の設定については、第4章「ロールまたはグループのサポートの設定」を参照してください。

2.3 「Event Log」の設定

「Event Log」ページを使用して、イベントの記録先のサーバーを構成します。変更が完了したら、「Save Changes」をクリックして、Provisioning Gatewayに新しい設定を適用します。

設定

説明

Database Type

Syslogデーモンはデータベースではありませんが、デーモンにイベントを送信するには、「Event Log Settings」ページの「 Database Type」ドロップダウン・リストから選択します。

Syslogデーモンに設定するパラメータはありません。インストール後に手動で構成を行います。詳細は、『Oracle Enterprise Single Sign-On Suite管理者ガイド』を参照してください。

次の設定は、Oracle Databaseでのみ使用します。

Connection String

データベース接続文字列を入力します。たとえば、外部認証を使用しているOracleを使用する場合、この文字列には、次の形式を使用する必要があります。

Provider=[OLE DB Provider] ;Data Source=[SID]; User Id=/;

MicrosoftのOracle OLE Providerの場合:

Provider=MSDAORA ;Data Source=ORCL; User Id=/;

次の設定は、Microsoft SQL Serverデータベースでのみ使用します。

Server

イベントの記録先のサーバーの名前を入力します。このマシンで、SQL Serverが実行されている必要があります。ただし、Provisioning Gatewayデータベースが存在している必要はありません。このサーバーをProvisioning Gatewayではじめて使用する場合は、Provisioning Gatewayデータベースを作成するため、「Initialize Event Log」ボックスを選択する必要もあります。

現在のマシンを指定するためにサーバーのIPアドレスを使用することはできません。実際のマシンの名前を使用する必要があります(pdevrx2など)。

ローカル・マシンをlocalhostという名前で表すことはできません。マシンの名前を使用する必要があります。

次の設定は、OracleおよびSQLデータベースで使用します。

Initialize Event Log

この設定を有効にすると、指定したサーバーにProvisioning Gatewayデータベースが作成されます。データベースがすでに存在する場合は、そのデータベース内のすべての既存データが消去されます。通常、この設定は、初回のインストールおよびデータベース内のログ・エントリを消去する場合に使用します。この設定は保存されません。

2.4 「Template Mapping」の設定

このページを使用して、Logon ManagerテンプレートをOracle Privileged Accounts Manager (OPAM)ターゲットにマップします。

注意:

次のいずれかの機能を実行するには、Oracle Enterprise Single Sign-On Administrative Consoleで「Map Template」権限が付与されている必要があります。

1. 「Targets」ウィンドウでは、使用可能なすべてのOPAMターゲットの名前と、それにマップされているテンプレートがある場合は、その名前がカッコで囲まれて表示されます。

2. ターゲットを選択し、「Edit」ボタンをクリックして、ターゲットのマッピング・プロパティを編集します。

3. テンプレート・マッピングの「Edit」ダイアログで、OPAMターゲットにマップするテンプレートを選択します。テンプレートがすでにターゲットにマップされている場合は、ダイアログの起動時に選択されています。

テンプレート・マッピングの設定および権限の付与については、『Oracle Enterprise Single Sign-On Suite管理者ガイド』を参照してください。

3 ユーザーの管理

Provisioning Gateway Administrative Consoleは、ユーザー権限およびアクティビティを構成するコントロールを提供します。この章では、これらのユーザー設定が含まれる「Console」ページについて説明します。

3.1 「Manage SSO Users」ページ

このページでは、ユーザーの検索およびユーザーの資格証明の追加、変更または削除を行うことができます。ユーザーは、名前またはログオンで検索できます。

3.1.1 ユーザーの検索

次のパラメータを使用し、ユーザー検索の範囲および特性を指定します。

- Show user(s) with User Name:検索対象のユーザー名を入力します。すべてのユーザーに対して検索を実行する場合は、このフィールドを空白のままにします。ドロップダウン・リストで、「substring match」または「exact match」のいずれかを選択します。

- Only show users who have logons for:このリストには、所属する組織のユーザーが使用できるすべてのアプリケーションが含まれます。結果をフィルタ処理する1つ以上のアプリケーションを選択して、これらのアプリケーションに対するログオンを持つユーザーのみを表示します。

- Show additional information: 検索結果に、ユーザー名が表示されます。検索結果に「Logons」または「Pending Provisioning Instructions」を表示することもできます。必要に応じて、これらのオプションのいずれかを選択します。

すべての必要な情報を入力したら、「Find Users」をクリックします。

3.1.2 検索結果

結果リストには、ユーザー名、ログオン(追加の情報が選択されているかどうかによる)およびすべての保留中のプロビジョニング指示(該当する場合)が表示されます。ユーザーを追加、削除および変更するには、(カーソルを置くとハイライト表示される)ボタンを使用します。ユーザーの名前をクリックして、そのユーザーのプロファイルの表示または編集を行います。

注意:

事前定義されていないアプリケーション(オンザフライWebアプリケーションなど)はプロビジョニングできません。

新しいログオンの追加

SSOユーザーの削除

ログオンの削除

プロビジョニング・リクエストの取消し

ログオンの変更

3.1.2.1 ユーザーの管理

次の設定により、SSOユーザーをコントロールします。

3.1.2.1.1 新しいログオンの追加

このページでは、プロビジョニング指示を作成して、指定したユーザー用の新しいアプリケーション・ログオンを追加できます。このページには、「Manage SSO Users」ページでユーザーを検索し、ユーザー名の横にあるボタンをクリックしてアクセスします。

- Add Logons

- SSO User: ユーザーの検索結果から選択されたLogon Managerユーザーの名前。

- Application:使用可能なすべてのアプリケーションが表示されます。「not list applications that user already has a logon for」というオプションもあります。アプリケーションを選択すると、「Logon Information」セクションがリフレッシュされ、選択したアプリケーションで必要な各フィールドにテキスト・ボックスが表示されます。

- Description:Logon Managerに表示されているとおりにログオンの説明フィールドを変更できます。このフィールドはオプションです。

- Logon Information

- User ID:アプリケーションに対するユーザー名/ID。

- Password/Confirm Password:アプリケーションに対するユーザーのパスワード。

注意:

「UserID」フィールドは、作成した後に変更することはできません。「UserID」を変更する必要がある場合、既存のログオンを削除し、新しいログオンと新しいユーザーIDを追加する必要があります。追加するアプリケーションの要件に応じて、「Third Field」、「Fourth Field」フィールドなどの追加フィールドへの入力を求められる場合があります。同様に、一部のアプリケーションでは不要なフィールドが存在する場合があります。この場合、不要なフィールドは表示されません。

必要な情報をすべて入力したら、「Add Logon」をクリックして、追加要求を送信します。

3.1.2.1.2 SSOユーザーの削除

このページでは、選択したSSOユーザーを削除するかどうかを尋ねられます。このユーザーを削除する場合は「OK」、削除しない場合は「Cancel」をクリックします。「OK」をクリックすると、このユーザーの削除を確認するメッセージが表示されます。

このダイアログには、「Manage SSO Users」ページでユーザーを検索し、ユーザー名の横にあるボタンをクリックしてアクセスします。

3.1.2.1.3 ログオンの削除

このダイアログでは、選択したログオンを削除するかどうかを尋ねられます。このログオンを削除する場合は「OK」、削除しない場合は「Cancel」をクリックします。「OK」をクリックすると、このログオンの削除を確認するメッセージが表示されます。このダイアログには、「Manage SSO Users」ページでユーザーを検索し、「Logon」の横にあるボタンをクリックしてアクセスします。

3.1.2.1.4 要求の取消し

このページでは、保留中のプロビジョニング指示を取り消すかどうかを尋ねられます。この要求を取り消す場合は「OK」、取り消さない場合は「Cancel」をクリックします。「OK」をクリックすると、ページがリフレッシュされ、保留中のプロビジョニング指示が表示されなくなります。このダイアログには、「Manage SSO Users」ページでユーザーを検索し、「Pending Provisioning Request」の横にあるボタンをクリックしてアクセスします。

3.1.2.1.5 ログオンの変更

このページでは、アプリケーション・ログオンを変更できます。このページで空白のままになっているフィールドは変更されません。このダイアログには、「Manage SSP Users」ページでユーザーを検索し、ユーザー名の横にあるボタンをクリックしてアクセスします。

- Logon to Modify

- SSO User: ユーザーの検索結果から選択されたLogon Managerユーザーの名前。

- Application:変更するアプリケーション。

- User ID:アプリケーションに対するユーザー名またはID。

注意:

「UserID」フィールドは、作成した後に変更することはできません。ユーザーIDを変更する必要がある場合は、既存のログオンを削除し、新しいユーザーIDで新しいログオンを追加する必要があります。

ログオンに関連付けられているユーザーIDがない場合は、パスワード・フィールドを変更することはできません。パスワードを変更するには、ユーザーIDが存在している必要があります。関連付けられているユーザーIDがないログオンは削除し、新しいログオンが必要な場合は再作成する必要があります。

- New Logon Information

- Password/Confirm Password:アプリケーションに対するユーザーのパスワード。

- Description:Provisioning Gateway Logon Managerに表示されているとおりにログオンの説明フィールドを変更できます。

- Third Field:　このログオンの3つ目のフィールド。

- Fourth Field:　このログオンの4つ目のフィールド。

注意:

3つ目および4つ目のフィールドは、指定したアプリケーションに3つ目または4つ目のフィールドが構成されている場合にのみ必要です。追加するアプリケーションの要件に応じて、追加フィールドへの入力を求められる場合があります。一部のアプリケーションでは不要なフィールドが存在する場合があります。この場合、不要なフィールドは表示されません。

必要な情報をすべて入力したら、「Modify Logon」をクリックして、変更要求を送信します。

3.1.2.1.6 ユーザーの編集

このページには、選択したユーザーのログオンおよびすべての保留中のプロビジョニング指示が表示されます。このページには、「 Manage SSO Users」ページでユーザーを検索し、検索結果リスト内のユーザーの名前をクリックしてアクセスします。

User Name

選択したユーザーの名前が表示されます。

このユーザーに対して新しいログオンを追加する場合にクリックします。

このユーザーを削除する場合にクリックします。

Logons

ユーザーに割り当てられているログオンが表示されます。

ユーザー・ログオンを追加、削除および変更するには、(カーソルを置くとハイライト表示される)リンクおよびボタンを使用します。

Delete All Logons

ユーザーのディレクトリからすべてのログオン資格証明が削除されます。

Advanced Delete

カスタム削除要求を生成できます。

このユーザーに関連付けられている特定のログオンが削除されます。

特定のログオンに対するユーザーのログオン資格証明が変更されます。

注意:

ログオンに関連付けられているユーザーIDがない場合は、パスワード・フィールドを変更することはできません。関連付けられているユーザーIDがない資格証明は削除し、置き換える必要があります。

Pending Provisioning Items

選択したユーザーに対するすべての保留中のプロビジョニング指示が表示されます。プロビジョニング指示(追加、削除など)、アプリケーションおよびプロビジョニング指示の作成日および実行日が表示されます。この指示をリポジトリから削除するには、「Cancel Instruction」をクリックします。

3.1.2.1.7 高度な削除

- SSO User:ユーザーの検索結果から選択されたLogon Managerユーザーの名前が表示されます。

- Application:このユーザーから削除できるアプリケーションが表示されます。削除するアプリケーションをドロップダウン・リストから選択します。選択されたアプリケーションに関連付けられている資格証明フィールドが表示されます。すべての資格証明フィールドを、ディレクトリに格納されているとおりに正確に入力する必要があります。

- User ID: ユーザーIDを入力します。

- Password/Confirm Password:アプリケーションに対するユーザーのパスワード。これらのフィールドは、パスワード・フィールドのみが表示されるようにアプリケーションが構成されている場合にのみ表示されます。

- Description: Logon Manager Logon Managerに表示されているとおりのログオンの説明フィールド。

- Third Field:　 このアプリケーション・ログオンの3つ目のフィールド。

- Fourth Field:　 このアプリケーション・ログオンの4つ目のフィールド。

情報をすべて入力したら、「Submit」をクリックして、削除要求を送信します。

3.1.2.1.8 新しいSSOユーザーの追加

このページでは、新しいLogon Managerユーザーを作成できます。ユーザーのリポジトリに記憶域オブジェクトが作成されます。ユーザーの作成後、その新しいユーザーにアプリケーションを追加できるように「Add New Logon」ページが表示されます。

User Name:追加対象のユーザー名を入力します。「Next」をクリックします。「Add New Logon」画面が表示されます。

注意:

ディレクトリ内にユーザー名が存在している必要があります。存在していない場合は、エラーが発生します。

4 ロールまたはグループのサポートの設定

Provisioning Gatewayロール/グループのサポートによって、特定のアプリケーションおよびユーザーのプロビジョニング権限を管理できます。これらのプロビジョニング権限は、Oracle Enterprise Single Sign-On Administrative Consoleで構成および管理されます。ロール/グループのサポートを設定するには、「スタート」 > 「プログラム」 > 「Oracle」> 「Logon Manager Console」の順にクリックし、Oracle Enterprise Single Sign-On Administrative Consoleを開きます。

プロビジョニング権限を管理する場合、次の2つのパネルを使用できます。

- 「Provisioning」タブ: 個々のアプリケーション・パネルにあります。このタブによって、特定のアプリケーションのプロビジョニング権限を管理できます。

- 「Provisioning Manager」ノード: Oracle Enterprise Single Sign-On Administrative Consoleのツリー(左ペイン)にあります。このタブによって、ユーザーのプロビジョニング権限を管理できます。

4.1 「Provisioning」タブの使用

「Provisioning」タブにアクセスするには、Oracle Enterprise Single Sign-On Administrative Consoleの左側の「Applications」を展開して、任意のアプリケーションをダブルクリックします。「Provisioning」タブをクリックします。

このタブから、権限の追加および削除を行うことができます。また、権限に対するアクセス権のレベル(アプリケーションの追加、変更または削除)も選択できます。

コントロール

値

Directory

ターゲット・ディレクトリ・サーバーを選択します。

Name

このアイテムに現在アクセスできるグループまたはユーザーが表示されます。

ID

ユーザーのアカウント名が表示されます。

Access

ユーザーまたはグループに付与されている権限(ログオンの追加、変更または削除)を示します。ユーザーまたはグループのアクセス権を変更するには、ユーザーまたはグループを右クリックし、ショートカット・メニューから「Add Logon」、「Modify Logon」または「Delete Logon」を選択します。

Copy Permissions To

現行のアプリケーションのプロビジョニング権限を複数のアプリケーションに簡単に適用できます。このボタンをクリックすると、すべてのアプリケーションが示されているダイアログが表示されます。これらのプロビジョニング権限をコピーするアプリケーションを選択します。複数のエントリを選択するには、[Ctrl]キーまたは[Shift]キーを押しながらクリックします。「OK」をクリックします。

Remove

選択したユーザーまたはグループがリストから削除されます。削除するユーザーまたはグループを選択します。複数のエントリを選択するには、[Ctrl]または[Shift]を押しながらクリックします。

4.1.1 ユーザーまたはグループの追加

ユーザーまたはグループの追加に使用するダイアログは、使用するディレクトリ・サーバーによって異なります。

- LDAP

- Active DirectoryまたはAD LDS (ADAM)

4.1.1.1 LDAP

現行の構成アイテム(「Add Logon」、「Modify Logon」または「Delete Logon」)用のアクセス・リストに追加する個々のユーザーまたはユーザー・グループを選択する場合は、「Add Users and Groups」ダイアログを使用します。

コントロール

値

Search Base

ユーザーまたはグループのアカウントの検索を開始するベース・ディレクトリ(最上位のディレクトリ)。ベース・ディレクトリのすべてのサブサブディレクトリが検索されます。場所を入力するか、Changeをクリックしてディレクトリ・ツリーを参照してください。

Change

検索用のベース・ディレクトリを参照するために「Select Search Base」ダイアログが表示されます。このダイアログは、ユーザーおよびグループの名前を検索するためのベース・ディレクトリ(最上位のディレクトリ)を参照して選択する場合に使用します。終了したら、「OK」をクリックします。

Search

ベース・ディレクトリ内のユーザーおよびグループの検索を開始します。

Users or Groups

検索結果が表示されます。現行の構成アイテム用のアクセス・リストに追加する名前を選択します。複数のエントリを選択するには、[Ctrl]キーまたは[Shift]キーを押しながらクリックします。アクセス・リストへの選択したアイテムのコピーを終了したら、「OK」をクリックします。

4.1.1.2 Active DirectoryおよびAD LDS (ADAM)

現行の構成アイテム(「Add Logon」、「Modify Logon」または「Delete Logon」)用のアクセス・リストに追加する個々のユーザーまたはユーザー・グループを選択する場合は、「Select User or Group」ダイアログを使用します。

コントロール

値

List Names From

Active Directoryのドメインまたはサーバーを選択します。

Names

選択したドメインまたはサーバー用のユーザーおよびグループの名前が表示されます。アクセス・リストに追加する名前を1つ以上選択します。

Add

「Names」リストで選択したユーザーおよびグループが「Add Names」リストにコピーされます。複数のエントリを選択するには、[Ctrl]キーまたは[Shift]キーを押しながらクリックします。

Members

「Names」でグループを選択した場合は、「Global Group Membership」ダイアログが表示されます。このダイアログには、選択したグループのメンバーが表示されます。

Search

「Names」でグループを選択した場合は、「Global Group Membership」ダイアログが表示されます。このダイアログには、選択したグループのメンバーが表示されます。

Add Names

この時点までに追加したユーザーまたはグループの名前が表示されます。これらの名前を現行の構成アイテム用のアクセス・リストに追加する場合は、「OK」をクリックします。

このリスト内のユーザー名は、入力または編集できます。ただし、エントリのアカウント名が有効かどうかが確認され、アカウントが重複して選択されている場合は、「OK」をクリックすると、重複しているアカウントが自動的に削除されます。

5 「Provisioning Gateway」ノード

「Provisioning Gateway」ノードを使用して、ユーザーのプロビジョニング権限を管理します。この機能にアクセスするには、左ペインのツリーから「Provisioning Gateway」ノードをクリックします。

5.1 「Provisioning」タブ

「Provisioning Gateway」ノードを選択すると、2つのタブが含まれている右ペインが表示されます。

- Default Rights

- Delete SSO User Right

このノードの設定を変更する際、変更を有効にするにはリポジトリに公開する必要があります。Oracle Enterprise Single Sign-On Administrative Consoleの「 Provisioning Gateway」ノードを右クリックし、「Publish」を選択します。

5.1.1 「Default Rights」タブ

「Default Rights」タブを使用して、作成した新しいアプリケーションそれぞれに対してプロビジョニング権限を定義します。この機能によって、作成した各アプリケーションに対して標準の権限が設定されます。アプリケーションの作成後、必要に応じて権限を変更します。

このタブのコントロールは、アプリケーションの「Provisioning」タブのコントロールと同じです。

5.1.2 「Delete SSO User Right」タブ

「Delete SSO User Right」タブを使用して、Provisioning Gateway Management Consoleで、ユーザー削除機能を付与するユーザーを定義します。

このタブのコントロールは、アプリケーションの「Provisioning」タブのコントロールと同じです。

6 レポートとログ

「Reports and Logs」ページを使用して、Provisioning Gatewayイベントを表示します。イベントは、日付範囲ごとに表示でき、タイプでフィルタ処理できます。

6.1 レポートのタイプ

「Reports and Logs」ページには、3つの選択項目があります。

- Event Log

- Status Request

- Generate Report

6.1.1 Event Log

イベント・ログの設定方法:

1. 日付を選択するには、「Choose」をクリックします。

2. 適切な検索パラメータを入力し、「View Log」をクリックします。画面の下部に、次のログ・エントリが表示されます。

- Date/Time

- Event Type

- Provisioned User

- Application

- Execute Date

3. 指示のステータスの詳細を表示するには、ボタンをクリックします。

ログは、CSVファイルにエクスポート可能です。CSVファイルは、分析用の多数のオプション・ツール(Microsoft Excelなど)にロードできます。

ログ・ファイルのエクスポート方法:

1. ログ・ファイルをエクスポートするには、「Export Log」をクリックします。

2. ログ・ファイルのエクスポート先を選択して、「OK」をクリックします。このファイルにエクスポートされるフィールドは次のとおりです。

- Time Stamp

- Event Type

- User Name

- Application

- Execute Date

- Provisioning Agent

6.1.2 Status Request

「Status」ページに、選択したプロビジョニング指示のステータスのサマリーが表示されます。

- State: 指示の状態:

- Pending

- Retrieved

- Processed

- Result:指示の結果:

- Success

- Failure

- Retrieved

- Description:結果を処理する指示に関する詳細な説明。

- Modified Date:指示が最後に変更された日付。指示の状態が「Pending」の場合、他のすべてのフィールドは空白のままになります。

「Back to Event Log」をクリックして、「Event Log」ページに戻ります。

6.1.3 Generate Report

「Generate Report」ページを使用して、リポジトリに格納されているすべてのデータが含まれているCSV形式のファイルをダウンロードします。

生成するレポートのタイプの選択:

- Logons:このオプションを選択すると、アプリケーション・レポート(ユーザーの資格証明)が生成されます。このレポートには、次のフィールドが含まれています。

- User DN(cn=user1、ou=people、ou=vgo、dc=passlogix、dc=comなど)

- User Name(user1など)

- Application Name

- Last Used Date

- Modified Date

- Provisioning Instructions:このオプションを選択すると、プロビジョニング・アイテム・レポート(ユーザーのプロビジョニング指示)が生成されます。このレポートには、次のフィールドが含まれています。

- Instruction Type

- Instruction GUID

- Current Status

- Provisioned User

- Application

- Create Date/Time

- Execute Date/Time

- Provisioning Agent

生成するレポートのタイプの選択し、「Download Report」をクリックします。

7 Provisioning Gateway CLI

Provisioning Gatewayサーバーでは、他のプロビジョニング・サーバーにより発行された指示を受信できる、Webサービス・インタフェースが公開されています。Provisioning Gateway CLIは、プロビジョニング・ソリューション用の統合コンポーネントとして提供されています。

7.1 CLIについて

Provisioning Gatewayには2種類のCLIが含まれます。

- .NET CLI
.NET CLIはProvisioning Gateway Webサービスと通信するためのインタフェースを提供し、デフォルトでインストールされます。プログラミングAPIは、.NET CLIのメイン実行可能ファイルをSDKライブラリとして利用する、Passlogix.Provisioning.dllアセンブリ内に保持されています。このガイドの.NETに関する項は、組織のプロビジョニング・ソリューションの開発を担当する、経験豊かな.NET アプリケーション・プログラマを対象としています。

- Java CLI
Java CLIでは、Provisioning Gateway Webサービスと通信するためのいくつかのインタフェース、クラス・ファクトリ、およびサポートするタイプが公開されています。これらのプログラミングAPIは、クラス・ライブラリであるpmcli.jar内に保持されていますが、これはJava CLIのメインの実行可能ファイルと同じライブラリであり、SDKで再利用されます。このガイドのJavaに関する項では、Java CLIで公開されているインタフェースをアプリケーションで使用する方法を説明します。

このドキュメントでは、次の内容を説明します。

- CLI構文の書式、戻り値、コマンド、オプションおよびパラメータ

- 空白、引用符を含むパラメータのエスケープ

- Java CLI用のSSLの設定

- CLIコマンドの適切な使用方法を示す例

.NETおよびJava CLIの実装手順は、Oracle Enterprise Single Sign-On Suiteのアプリケーション・インタフェースの開発に関する説明を参照してください。

注意:

.NETおよびJava CLIの機能はほぼ同一です。相違点については、このドキュメント全体を通して記載されています。

.NET CLIはデフォルトでインストールされます。Java CLIをインストールするには、インストール時に「Custom」オプションを選択する必要があります。

7.2 CLI構文

CLIでは次の構文を使用します。

usage: pmcli [-url service] [-agent name] [-u login id]

[-p password] [-t date/time] [-f inputfile]

[-security <sec_opts>] "operation"

CLIは、どのような組合せでも、次の形式のスイッチを受け入れます。

スイッチ

説明

-arg=value

「=」の後に指定された値。

-arg value

次の引数として指定された値。

-arg:value

「:」の後に指定された値。

--arg

argの前のダッシュ2個。

/arg

argの前のフォワード・スラッシュ。

-u, -p

-security username=<value> password=<value>と同義。

-f

ファイルからバッチ処理を実行した後、終了。

-t

-execの別名。プロビジョニング操作を実行する時間の指定。

7.2.1 .NETとJava CLIのアプローチの相違点

.NET CLIの実行可能ファイルの名前はpmcli.exeです。

Java CLIの実装は pmcli.jarというクラス・ライブラリにあります。このライブラリを実行するため、バッチ・ファイルpmcli.batが用意されています。Windowsでは、バッチ・ファイルの実行前に、pmcli.jarの場所およびサポートしているライブラリを示すため、環境変数%PMCLI_ROOT%を設定する必要があります。次の手順に従って、バッチ・ファイルを使用せずに手動でJava CLIを実行することもできます。

java -cp <classpath> pmcli.Main <args>

pmcli.batファイルの指示に従って、pmcli.batファイルを編集し、dの値を定義しなおす必要がある場合があります。%P%の値は、プロパティ・ファイルの保存場所へのパスを示します。プロパティ・ファイルを使用してJava CLIをカスタマイズできます。このファイルは、名前にスペースのないパスに存在する必要があります。デフォルトでは、Java CLIはWindowsのProgram Filesフォルダ下にインストールされ、プロパティ・ファイルを使用する場合は、ファイルを保存するディレクトリの名前を参照するため、%P%の値を設定する必要があります。ディレクトリ名にスペースを含むことはできません。

7.3 操作モード

3つの操作モードがサポートされています。

- コマンドライン・モード

- バッチ・モード

- 対話モード

7.3.1 コマンドライン・モード

このモードでは、コマンドラインで入力することによりプロビジョニング操作を指定します。サポートされているプロビジョニング操作は次のとおりです。

操作

定義

ADD_CREDENTIAL

新しい資格証明の追加

MODIFY_CREDENTIAL

既存の資格証明の変更

DELETE_CREDENTIAL

既存の資格証明の削除

DELETE_USER

SSOユーザーと保存した資格証明の削除

STATUS

保留中の指示のステータス取得

CANCEL

保留中のプロビジョニング指示の取消し

EXT_SEARCH

ログオンおよび保留中のリクエストの検索

SET_SETTINGS

現在の記憶域設定の変更

GET_SETTINGS

現在の記憶域設定の取得

GET_SCHEMA

使用可能なストレージ・スキーマの取得

CHECK_SERVER

サーバーのステータスの確認

これらの操作およびパラメータについては、このドキュメントの後の項で説明します。

注意:

バッチ・ファイルおよび操作の両方がコマンドラインで指定されている場合は、バッチ・モードが優先されます。

7.3.2 バッチ・モード

バッチ・モードでは、-fスイッチで指定したファイルのCLIに、一連のプロビジョニング操作を渡すことができます。

7.3.3 対話モード

コマンド・ラインで操作が指定されておらず、またバッチ・ファイルが指定されていない場合、CLIは対話モードに入ります。対話モードでは、中止または終了するまで、シェルのような環境でプロビジョニング操作を指定します。

対話モードでは、コマンドライン・モードまたはバッチ・モードでは使用できない、3つの追加コマンドがサポートされます。

コマンド

説明

HELP

使用可能なすべてのコマンドのリスト

Help [operation]

特定のコマンド用の構文の表示

QUIT, EXIT, Q, E

対話モードの終了またはバッチの実行停止

7.3.4 スマート・デフォルト

url、agent、usernameまたはpasswordスイッチが指定されていない場合、CLIでは次のデフォルトが使用されます。

スイッチ

デフォルト

-url

http://localhost/v-GO%20PM%20Service/UP.asmx

-agent

現在のマシン名(Windowsでは%MACHINENAME%)。

-password

CLIがパスワードの入力を要求。

注意:

.NETとJava CLIの相違点

セキュリティ上の理由から、.NET CLIでは(ユーザーがパスワードの入力を求められた場合)、ユーザーが入力したパスワードは不明瞭化されます。Java CLIはプラットフォームに依存しないため、ユーザーが入力したパスワードは不明瞭化されません。

7.3.5 操作の実行

CLIが操作を実行すると、結果が画面に出力されます。出力される形式は実行された操作により異なります。一般的に、結果は次のようになります。

[RESULT] ID: [GUID]

[RESPONSE]

意味は次のとおりです。

[RESULT]

プロビジョニング・サーバーの結果。

success

リクエストが正常に作成され、ディレクトリに配置されました。

エージェントはこのリクエストを処理し、成功または失敗かをマークします。

noSuchRequest

リクエストIDが存在しません。状態操作および取消操作に適用されます。

CouldNotCancel

リクエストは中止できない状態です。取消操作に適用されます。

[GUID]

正常に発行されたプロビジョニング指示の一意の識別子。

[RESPONSE]

特定のプロビジョニング指示によって返される追加の結果。status、ext_search、get_settingsおよびget_schema操作に適用されます。一般的に、結果は名前と値のペアの書式をとります。この属性書式は返された情報の説明として表示することができます。

エラーが発生した場合、次のように、例外が出力された後に説明文が続きます。

[exception]: [descriptive error message]

7.3.6 使用状況

pmcli -?コマンドにより、使用状況および構文情報を表示します。

7.3.7 ステータスの結果

Logon Manager Agentがプロビジョニング指示の処理を完了すると、指示のResult属性は実行結果に設定されます。エージェントが指示の処理に失敗すると、属性はFailedに設定され、Descriptionは発生した特定のエラーに設定されます。発生する可能性があるエラーは次のとおりです。

- プロビジョニング指示の復号に失敗しました。

- リクエストされた指示の削除に失敗しました。

- 無効または不明な指示タイプです。

- 指示で指定されたアプリケーションが見つかりません。

- 変更指示を追加指示として処理するのに失敗しました。

- 指示の追加に失敗しました、資格証明がすでに存在します。

- 指示の追加に失敗し、必須フィールドが含まれていません。

7.4 プロビジョニング操作

次の表は、実行可能な特定のプロビジョニング操作、および各操作に固有の構文の一覧です。

add_credential

指定されたユーザーの新しい資格証明の追加。

delete_credential

指定されたユーザーに関連付けられた既存の資格証明の削除。

modify_credential

指定されたユーザーに関連付けられた既存の資格証明の変更。

delete_user

SSOユーザーと保存した資格証明の削除。

status

保留中または発行されたプロビジョニング指示のステータスの取得。

cancel

保留中のプロビジョニング指示の取消し。

ext_search

アプリケーション、ユーザーおよびイベント・ログのエントリの検索。

set_settings

現在の記憶域設定の変更。

get_settings

現在の記憶域設定の取得。

get_schema

使用可能なストレージ・スキーマの取得。

check_server

サーバーのステータスの確認(successの場合はエラーなし)。

7.4.1 パラメータ

操作パラメータは、リクエストに固有の特性を定義します。使用する可能性のあるパラメータのセットが操作別に記載されています。各パラメータは、次のように指定された名前と値のペアで構成されます。

sso_userid

Provisioning Gatewayに認識されるユーザーのID。Provisioning Serviceが、Provisioning Gatewayデータ・ストアにおいてユーザーを特定するために使用するIDです。

sso_application

資格証明を追加するアプリケーションの名称。

sso_description

資格証明の説明。このフィールドはオプションです。

sso_app_userid

資格証明に対するアプリケーションのユーザーID。

sso_password

この資格証明のパスワード・フィールド。

sso_other1

この資格証明の3番目のフィールド。

sso_other2

この資格証明の4番目のフィールド。

command_id

正常なプロビジョニングにより発行されたGUID。

SET_SETTINGS

set_settings操作に固有の設定は、次のとおりです。

name

記憶域のキーの名前のカンマ区切りリスト。

value

ストレージ値のカンマ区切りリスト。

EXT_SEARCH

ext_search操作に固有の設定は、次の表のとおりです。

catalog

検索するカタログ。

userId

検索するユーザーのsso_userid(ext_search)。

logon

アプリケーション・ログオン名のカンマ区切りリスト。

returnLogons

選択したユーザーのアプリケーション・テンプレートに対して、保存された資格証明コンテナに関連付けられたGUIDのリストを返す。

returnInstructions

保留中の指示のリストを返す。

uidMatch

userIDを完全一致または部分文字列一致で検索。

startDate

イベント・ログの開始日。

endDate

イベント・ログの終了日。

eventType

検索でフィルタ処理するイベントのタイプ。

7.4.2 構文

構文には各操作に必要なパラメータおよび形式を記述します。各操作とその構文は、次のように定義されます。

ADD_CREDENTIAL sso_userid sso_application [sso_app_userid] [sso_password] [sso_description] [sso_other1] [sso_other2]

MODIFY_CREDENTIAL sso_userid sso_application sso_app_userid [sso_description] [sso_password] [sso_other1] [sso_other2]

DELETE_CREDENTIAL sso_userid sso_application [sso_app_userid] [sso_password] [sso_other1] [sso_other2]

DELETE_USER sso_userid

STATUS sso_userid command_id

CANCEL sso_userid command_id

EXT_SEARCH CATALOG=Applications [userId]

EXT_SEARCH CATALOG=Users [userId] [logon="logon1,logon2,..."][returnLogons=true|false] [returnInstructions=true|false] [uidMatch=substring|equal]

注意:

uidMatchが指定されていない場合、equalが指定されているものとして処理されます。returnLogonsおよびreturnInstructionsが指定されていない場合、falseが指定されているものとして処理されます。

EXT_SEARCH CATALOG=EventLog [startDate=mm/dd/yyyy] [endDate=mm/dd/yyyy] [eventType=amducs]

eventTypeに使用できる値は次のとおりです。

a

ログオンの追加

m

ログオンの変更

d

ログオンの削除

c

ユーザーの削除

u

リクエストの取消し

s

ステータスのリクエスト

一致イベントを返すために組み合せて使用できます。

SET_SETTINGS name="key1,key2,..." value="value1,value2,..."

GET_SCHEMAを使用し、有効なキーを取得できます。キーと値の数は同一である必要があります。名前リストの各キーは、値リストの対応する値とペアになっています(位置に基づく)。

GET_SETTINGS

このコマンド用のパラメータはありません。

GET_SCHEMA

このコマンド用のパラメータはありません。

CHECK_SERVER

このコマンド用のパラメータはありません。

7.4.3 カンマのエスケープ

カンマ区切りの値を取るパラメータは、「\」 (バックスラッシュ)をカンマのエスケープ文字としてサポートしています。たとえば、Active DirectoryのUserPathにCN=USERS,DC=DOMAIN,DC=COMの値を入力するには、次のコマンドを発行します。

SET_SETTINGS name="Storage\AD\UserPath" value="CN=USERS\,DC=DOMAIN\,DC=COM"

エスケープされていないコマンドは、複数の値またはキーの区切りとして処理されます。

7.4.3.1 例

次の例では、CLIの使用方法を示しています。

7.4.3.1.1 スイッチ

pmcli -username=johns

pmcli -username johns

pmcli -username:johns

pmcli -u:johns

pmcli -u=johns

pmcli -u johns

pmcli /u:johns

pmcli --u:johns

前述の呼出しは同じ意味を持ち、すべてのスイッチに適用されます。

7.4.3.1.2 スマート・デフォルト

pmcli -p:Password

urlのデフォルトはhttp://localhost/v-go%20pm%20service/up.asmxです。

agentのデフォルトagentマシン名です。

usernameは現在ログオン中のユーザーです。

pmcli -u:Administrator -p:Password

urlのデフォルトはhttp://localhost/v-go%20pm%20service/up.asmxです。

agentのデフォルトagentマシン名です。

pmcli -url:http://test.com/v-go%20pm%20service/up.asmx -p:mypassword

agentのデフォルトagentマシン名です。

usernameは現在ログイン中のユーザーです。

pmcli

urlのデフォルトはhttp://localhost/v-go%20pm%20service/up.asmxです。

agentのデフォルトagentマシン名です。

usernameは現在ログイン中のユーザーです。

パスワードの入力が要求されます(CLIがパスワードの入力を要求します)。

7.4.3.1.3 資格証明の追加

次の例では、SSOユーザーであるjoeuserのLotus Notes資格証明を追加します。

pmcli -url "http://example.com/v-GO PM Service/UP.asmx" -agent "PM Agent" -username=PMAdmin -password=mysecretpassword add_credential sso_userid=joeuser sso_application="Lotus Notes" sso_app_userid=lotususer sso_password=password123 sso_other1=mydomain

CLIに対する最初の4つのスイッチが示しているものは、次のとおりです。

- Provisioning Gateway Webサービスの場所

- このエージェントの識別子

- Webサービスの認証に使用する資格証明

- 操作およびそのパラメータ

この場合、プロビジョニングするSSOユーザーはjoeuserで、mydomainドメインでLotus Notesの資格証明、lotususerの資格証明、およびpassword123が追加されています。

7.4.3.1.4 ユーザーのすべての資格証明の削除

次の例では、SSOユーザーであるjoeuserの資格証明をすべて削除します。

pmcli -url "http://example.com/v-GO PM Service/UP.asmx" -agent "PM Agent" -username=PMAdmin -password=mysecretpassword delete_user sso_userid=joeuser

7.4.3.1.5 特定のユーザーのリストを返す

この例では、ユーザーおよびシステム上のプロビジョニング済のログオンと指示のリストを返します。

pmcli -url "http://example.com/v-GO PM Service/UP.asmx" -agent "PM Agent" -username=PMAdmin -password=mysecretpassword ext_search catalog=users returnLogons=true returnInstructions=true

7.4.3.1.6 バッチ・ファイルからの操作の実行

次の例は、バッチ・ファイルから操作を実行する方法です。

pmcli -url:"http://example.com/v-GO PM Service/UP.asmx" -agent:"PM Agent" -u:PMAdmin -p:mysecretpassword -f=c:\operations.txt

operations.txtファイルでは、行ごとにプロビジョニング操作が1つ記述されています。

add_credential sso_userid=joeuser sso_application="Lotus Notes" ...

add_credential sso_userid=janeuser sso_application="Lotus Notes" ...

delete_credential sso_userid=jackuser sso_application="Lotus Notes"

7.4.3.1.7 対話モードでのCLIの実行

次の例は、対話モードでCLIを実行する方法です。

pmcli -url:"http://example.pass.com/v-GO PM Service/UP.asmx" -agent:

"PM Agent" -u:PMAdmin -p:mysecretpassword

CLIは対話モードに入り、次のように表示されます。

Passlogix (R) v-GO PM CLI Version 6.0.0

Copyright (C) Passlogix, Inc. 1998-2005. All rights reserved.

URL: http://example.pass.com/v-GO PM Service/UP.asmx

AGENT: PM Agent"

USERNAME: PMAdmin

EXECUTE: 10/17/2005-15:07:04

-------------------------------------

セッションを終了するには、「e」[xit] または「q」[uit]を入力します。

7.4.3.1.8 ヘルプの表示

HELP

HELP [operation]

operation - その操作のヘルプ情報を表示します。

ユーザーは、中断または終了するまで、バッチ・モードでの操作と同様のプロンプトにプロビジョニング操作を入力できます。

7.4.3.1.9 プロビジョニング操作の実行時刻の指定

次の例は、プロビジョニング操作の実行時刻を指定する方法です。

コマンドラインで-tスイッチを指定し、その後に続けて時間を指定すると、Logon Manager Agentはプロビジョニング操作を指定された時刻またはその後に実行します。操作はディレクトリ・サービスおよびそれを実行するProvisioning Gateway Agentに存在しますが、指定された時刻までSSOユーザーはログオンできません。

-tの書式は次のとおりです。

Java:MM/DD/YYYY-HH:MM:SS

.NET:"MM/DD/YYYY HH:MM:SS"

7.5 SDKとしての.NET CLIの使用

この項の手順を実施する前に、Provisioning Gateway .NET CLIをインストールする必要があります。Provisioning Gateway .NET CLIのインストールの詳細は、『Oracle Enterprise Single Sign-On Suiteインストレーション・ガイド』を参照してください。

.NET CLIは<Passlogix home>\v-GO PM\Client\CLI\DotNetの下にあります。

.NET CLIをSDKとして使用するには、次の手順を実行します。

1. .NETプロジェクトにおいて、Passlogix.Provisioning.dllへの参照を追加します。

2. IProvisioningインタフェースのインスタンスを作成します。

3. このインタフェースに使用可能なメソッド(AddCredentialなど)を呼び出します。

4. 返されたIProvisioningResultインタフェースを使用して、成功したかを判断し、結果を取得します。

7.5.1 Passlogix.Provisioningへの参照の追加

.NETプロジェクトにPasslogix.Provisioning.dllへの参照を追加します。

1. Visual Studioから、ソリューションをロードし、Solution Explorerを起動します。

2. 該当する.NETプロジェクトを選択し、展開します。

3. 「References」ノードを右クリックし、「Add Reference」を選択します。

4. ダイアログから「Browse」を選択し、(<Passlogix home>\v-GO PM\Client\DotNet下にある)Passlogix.Provisioning.dllを指定します。

5. 「Open」をクリックします。アセンブリへの新しい参照が作成されます。

6. APIが呼び出されるソース・ファイル(拡張子.cs)を開き、ファイルの先頭に次の行を追加します。
using Passlogix.Provisioning;

using Passlogix.Provisioning.Exceptions;

7.5.2 IProvisioningインタフェースのインスタンスの作成

同じファイル内で、IProvisioningインタフェースのインスタンスを初期化するメソッドを作成し、次の行のうち1つをメソッドに追加します。

メソッド1:フルパスが判明している場合

IProvisioning iprov =

ProvisioningFactory.CreateFrom(@"<Path to .NET CLI>");

メソッド2: プロビジョニング・アセンブリと同じディレクトリからロード

IProvisioning iprov = ProvisioningFactory.CreateFromPrivate();

メソッド3: (%PATH%で指定された)パスからファイルをロード

IProvisioning iprov = ProvisioningFactory.CreateFromPath();

ロードするためのメソッドを選択した後、誤りがないか確認し、Provisioning Gatewayサービスの接続用の資格証明を設定します。

ロードするアセンブリ・メソッドを選択した後、次のコードを使用します。

if (iprov != null)

{

try

{

メソッドへのすべての結果呼出しが失敗していないことを確認するため、最初に接続を確立する必要があります。このメソッドは、プロビジョニング・サービスに接続するための資格証明をセットします。プロビジョニング・リクエストが行われるまで、実際にサービスへは接続しません。

3通りの接続方法があります。

メソッド1

iprov.Connect("Administrator", "password");

http://localhost/v-go pm service/up.asmxおよび%COMPUTERNAME%をエージェント名とします。

メソッド2

URLおよびエージェント名を指定します。

iprov.Connect(

"http://<server>/v-go pm service/up.asmx",

"My Agent",

"Administrator", "password");

メソッド3

URLを指定します。

iprov.Connect(

"http://<server>/v-go pm service/up.asmx",

"Administrator", "password");

iprovインタフェース経由でプロビジョニング・リクエストを作成します。Webサービスはローカルではないものの、ユーザーがエージェント名を必ず指定するとは限らないため(デフォルトは %COMPUTERNAME%)、望ましいメソッドです。例は「サンプル・コード」を参照してください。

}

catch (ProvisioningException ex) { // Handle exception } }

正常に接続されると、iprov変数のメソッドにより、リクエストをProvisioning Gateway Webサービスに送ることができます。各メソッドはIProvisioningnResultインタフェースに結果を返します。エラー処理のため、try…catchブロック内でメソッドを呼び出すことをお薦めします。CLIがスローした例外は、ProvisioningExceptionクラスをキャッチすることで十分に処理できます。その他の例外は、catch (Exception)を追加することにより処理できます。

7.5.2.1 iProvインタフェースで使用可能なメソッド

この項では、各プロビジョニング操作に使用可能なメソッドおよびパラメータについて説明しています。使用可能な各メソッドの詳細は次のとおりです。

- メソッド名と説明

- メソッドのオーバーロード・リスト

- メソッドのパラメータの説明(該当する場合)

パラメータのうち1つは、特別に説明する必要があります。optionsパラメータは、キーと値のペアのディクショナリです。キーは、コマンドラインでCLIが使用する引数の名前です。値はキーの値です。開発者は、キーのリテラル名(コマンドラインで渡す)またはOperationKeysクラスで定義されたキー定数を使用して、ディレクトリにキーと値のペアを設定できます。

- CLIが使用するコマンドライン構文(CLI_Syntax)(該当する場合)

コマンドライン引数は、メソッドのオプション・パラメータの入力に使用できる有効なキーに直接マップします。OperationKeysクラスは、各キーのリテラル値への定数マッピングの利便性のために用意されています。オプション配列の入力または索引付けに使用できます。煩雑さを避けるため、CLI構文では完全な構文は表示されません。詳しい情報は、「CLI構文」を参照してください。操作名は大文字で始まります。括弧内に指定された引数はオプションです。

メソッド

説明

Connect

Webサービスへの接続の確立。このメソッドは実際の接続は行わず、他のメソッドが接続に使用する資格証明を保存します。

オーバーロード・リスト

void Connect(string strUsername, string strPassword);

void Connect(string strURL, string strUsername, string strPassword);

void Connect(

string strURL,

string strAgent,

string strUsername,

string strPassword);

パラメータ

説明

strURL

WebサービスのURL。デフォルトはhttp://localhost/v-GO%20PM%20Service/up.asmx。

strAgent

このエージェントの識別子。デフォルトは%COMPUTERNAME%。

strUsername

Webサービスの認証に使用するユーザー名。

strPassword

Webサービスの認証に使用するパスワード。

メソッド

説明

SetExecTime

プロビジョニングの指示の実行時間の設定。指示を作成した後、将来の日付または時間に指示をエージェントで実行するよう伝えるために使用します。設定されていない場合、デフォルトの"Now"が使用されます。

オーバーロード・リスト

void SetExecTime(DateTime dtExec);

メソッド

説明

AddCredential

新しい資格証明を持つユーザーのプロビジョニング。

オーバーロード・リスト

IProvisioningResult AddCredential(

string strUserId,

string strApplication,

string strDescription,

string strAppUserId,

string strPassword);

IProvisioningResult AddCredential(

string strUserId,

string strApplication,

StringDictionary options);

パラメータ

説明

strUserId

プロビジョニングされるユーザーのユーザーID。

strApplication

プロビジョニングするためのアプリケーションの名称。

strDescription

プロビジョニングの指示の説明。

strAppUserId

資格証明のアプリケーション・ユーザーID。

strPassword

資格証明のパスワード。

options

オプションのハッシュテーブル(OperationKeysで指定したキー)。

CLI構文

ADD_CREDENTIAL sso_userid sso_application [sso_app_userid] sso_password]
[sso_description] [sso_other1] [sso_other2]

メソッド

説明

CancelRequest

プロビジョニング・リクエストの取消し(エージェントの動作前)。

オーバーロード・リスト

IProvisioningResult CancelRequest(string strUserId, string strGuid);

パラメータ

説明

strUserId

プロビジョニングされるユーザーのユーザーID。

strGuid

取消し可能な、取消しのためのプロビジョニング指示のID(複数のメソッドにより返される)。

CLI構文

CANCEL sso_userid=<username> command_id=<guid>

メソッド

説明

DeleteCredential

プロビジョニングされた資格証明の削除。

オーバーロード・リスト

IProvisioningResult DeleteCredential(string strUserId,

string strApplication, string strAppUserId, string strOther1,

string strOther2);

IProvisioningResult DeleteCredential(string strUserId,

string strApplication, StringDictionary options);

パラメータ

説明

strUserId

プロビジョニングされるユーザーのユーザーID。

strApplication

プロビジョニングするためのアプリケーションの名称。

strAppUserId

資格証明のアプリケーション・ユーザーID。

strOther1

他のフィールド値(1)。

strOther2

他のフィールド値(2)。

options

オプションのハッシュテーブル(OperationKeysで指定したキー)。

CLI構文

DELETE_CREDENTIAL sso_userid sso_application [sso_app_userid]
[sso_password] [sso_other1] [sso_other2]

メソッド

説明

ModifyCredential

プロビジョニングされた資格証明の変更。

オーバーロード・リスト

IProvisioningResult ModifyCredential(string strUserId, string strApplication, string strAppUserId, string strDescription, string strPassword, string strOther1, string strOther2);

IProvisioningResult ModifyCredential(string strUserId, string strApplication, string strAppUserId, StringDictionary options);

パラメータ

説明

strUserId

変更するユーザーのユーザーID。

strApplication

変更する資格証明のアプリケーションの名称。

strAppUserId

変更する資格証明のアプリケーション・ユーザーID。

strAppUserId

変更する資格証明のパスワード。

strDescription

プロビジョニングの指示の説明。

strOther1

他のフィールド値(1)。

strOther2

他のフィールド値(2)。

options

オプションのハッシュテーブル(OperationKeysで指定したキー)。

CLI構文

MODIFY_CREDENTIAL sso_userid sso_application sso_app_userid [sso_description] [sso_password] [sso_other1] [sso_other2] [sso_password] [sso_other1] [sso_other2]

メソッド

説明

DeleteUser

ユーザー・コンテナの削除(特定のユーザーの全資格証明の削除とほぼ同じ)。

オーバーロード・リスト

IProvisioningResult DeleteUser(string strUserId);

パラメータ

説明

strUserId

削除するコンテナのユーザーID。

CLI構文

DELETE_USER sso_userid=<username>

メソッド

説明

GetStatus

サーバーにpingを打つ。エラーが発生せずにpingが返された場合、サーバーは機能しています。

オーバーロード・リスト

IProvisioningResult GetStatus();

CLI構文

CHECK_SERVER

メソッド

説明

StatusRequest

保留中のプロビジョニング指示のステータスのリクエスト。

オーバーロード・リスト

IProvisioningResult StatusRequest(string strUserId, string strGuid);

パラメータ

説明

strUserId

問い合わせるUser ID。

strGuid

プロビジョニング指示のID(複数メソッドにより返される)。

CLI構文

STATUS sso_userid=<username> command_id=<guid>

メソッド

説明

GetSettings

PM Webサービスのディレクトリ設定を返す。

オーバーロード・リスト

IProvisioningResult GetSettings();

CLI構文

GET_SETTINGS

メソッド

説明

GetSchema

スキーマ(またはSetSettingsに使用可能なオプションのリスト)の取得。

オーバーロード・リスト

IProvisioningResult GetSchema();

CLI構文

GET_SCHEMA

メソッド

説明

SetSettings

Webサービスで使用される設定の変更。

オーバーロード・リスト

IProvisioningResult SetSettings(IDictionary map);

パラメータ

説明

Map

各設定のキーと値のペア。

CLI構文

SET_SETTINGS name="key1, key2, ..." value="value1, value2, ..."

メソッド

説明

ExtSearch

ディレクトリ・サービスを検索し、ユーザー、アプリケーション、およびログの情報を返す。特定のユーザーまたはすべてのユーザーに対してプロビジョニング可能なアプリケーションのリストを返します。

アプリケーション用のオーバーロード・リスト

IProvisioningResult ExtSearchApplications();

IProvisioningResult ExtSearchApplications(string strUserId);

パラメータ

説明

strUserId

返すアプリケーション・リストのユーザーの名前。

ユーザー用のオーバーロード・リスト

IProvisioningResult ExtSearchUsers();

IProvisioningResult ExtSearchUsers(string strUserId,

StringCollection logons, bool fRetLogons, bool fRetInsts,

bool fMatchExact);

IProvisioningResult ExtSearchUsers(StringDictionary options);

パラメータ

説明

strUserId

情報を返すユーザー。

logons

ログオンのみを返す(csv形式)。

fRetLogons

ログオン情報を返す。

fRetInsts

保留中のプロビジョニング指示を返す。

fMatchExact

strUserIdで完全一致を使用。

options

オプションのハッシュテーブル(ExtSearchKeysで指定)。

ロギング用のオーバーロード・リスト

IProvisioningResult ExtSearchLog();

IProvisioningResult ExtSearchLog(EventType evt);

IProvisioningResult ExtSearchLog(DateTime dtStart, DateTime dtEnd,

EventType evt);

パラメータ

説明

evt

返すEventType。

dtStart

返す日付範囲の開始日。

dtEnd

返す日付範囲の終了日。

CLI構文

EXT_SEARCH CATALOG=Applications [userId=<username>]

EXT_SEARCH CATALOG=Users [userId=<username>]

[logon="logon1,logon2,..."][returnLogons=true|false]

[returnInstructions=true|false] [uidMatch=substring|equal]

EXT_SEARCH CATALOG=EventLog [startDate=mm/dd/yyyy] [endDate=mm/dd/yyyy]

[eventType=amducs]

7.5.3 結果の取得

Provisioning Gateway Webサービスに対するプロビジョニング・リクエストの完了後、呼び出されたメソッドによりIProvisioningResultインタフェースが返されます。アプリケーションは、リクエストが正常に成功したかどうか判断し、関連する結果を取得するため、このインタフェースを使用できます。この項では、IProvisioningResultインタフェースで使用可能なプロパティ、およびIProvisioningで呼び出されるメソッドの値の解釈方法を説明します。

7.5.3.1 インタフェース定義

public interface IProvisioningResult { string Response { get; }

bool Success { get; }

string CommandID { get; }

string ErrorMessage { get; }

IDictionary AttributesCollection { get; } }

プロパティ

説明

Success

コマンドが正常に完了した場合、trueとなります。

ErrorMessage

SuccessがFalseの場合のエラー文字列。必ずしも設定する必要はありません。

CommandID

完了したコマンドに関連付けられた一意のID(32桁のGUID)。ExtSearch以外のすべてのメソッドはGUIDを返します。ただし、次のメソッドのみがCancelRequestおよびStatusRequest操作で使用できるGUIDを提供します。

- AddCredential

- ModifyCredential

- DeleteCredential

Response

Webサービスが返すraw XMLレスポンス。結果の再解析が必要な場合に便利です。

AttributesCollection

成功時に、詳細な結果がWebサービスにより返されます。形式は、キーと値のペアのディクショナリです。このプロパティに入力するメソッドは次のとおりです。

- GetSettings

- GetSchema

- StatusRequest

- ExtSearch

7.5.4 属性コレクション

属性コレクションは、GetSettings、GetSchema、ExtSearch、およびStatusRequestによって返される属性のディクショナリです。キーは属性名を示す文字列です。値はIDictionary、IList、または文字列のいずれかを参照できます。ただし、同一のコレクションで複数のタイプが混じり合うことはありません。タイプの確定後、すべてのキーは同一のタイプを参照します。

次の表は、プロビジョニング操作により返されるキーと値、およびその意味の一覧です。

メソッド

説明

GetSettings

文字列キーと値のペアのコレクションを返します。キーは設定の名前です。値はキーの値です。Provisioning Gateway Webサービスによりレジストリに設定されるストレージ値です。

StatusRequest

文字列キーと値のペアのコレクションを返します。キーはステータス・プロパティの名前です。値はキーの値です。サポートされているステータス・キーは次のとおりです。

ステータス・キー

値

InstructionState

PENDING, PROCESSED

Result

SUCCESS, FAILED

Description

SUCCESS, <Reason for failure>

Modified

<Date modified>

GetSchema

キーは記憶域設定のグループの名前を示す文字列です。値はIListです。各IListエントリには、このグループの設定が1つ記述されています。エントリは、文字列キーと値のペアのIDictionaryです。キーは次のいずれかで、使用可能な値のうちいずれか1つが後に続きます。

キー

値

DataType

文字列またはブール。

DisplayDesc

この設定の説明。空にできます。

DisplayName

表示するための、設定のわかりやすい名前。

Flags

設定が非永続的かどうかを示す使用する内部値で、必須です。

RegDefault

この設定のデフォルト値。空にできます。

RegName

レジストリ・キーの名前。

RegPath

この設定の相対レジストリ・パス。

RegType

レジストリ・タイプ(DWORDまたはstring)。

注意: このエントリにより記述される設定は、GetSettingsおよびSetSettingsで取得または設定できる値になります。

ExtSearch

ハッシュテーブルの集まり。(詳細は、次の項を参照してください)。キーは文字列ですが、戻り値のタイプは呼び出されたExtSearchXXXにより異なります。

注意:

AttributesCollectionプロパティによって返されるキーと値のペアの構造および形式は、実際のCLIからのコンソール出力を細密に反映するように設計されています。CLIを使用するだけで、これらのメソッドにより返されるコレクションの形式および構造を理解できます。

7.5.5 ExtSearchの結果

この項では、ExtSearchが返すAttributesCollectionマップの形式について説明します。

7.5.5.1 ExtSearchApplications

戻り値:

.NET: ハッシュテーブルのハッシュテーブル

Java: ハッシュマップのハッシュマップ

キー

値

Application Name

ハッシュテーブル(文字列キーと値のペア)

キー

値

HasFourthField

True | False

HasPassword

True | False

HasThirdField

True | False

HasUserId

True | False

IsSecurId

True | False

IsSecurIdがtrueの場合、最初の4つのフィールドの名前が変更されます。

- SecurID-UserId

- SecurID-Other[4th]

- HasPassword

- PassKeyType

検索結果の例を次に示します。

Adobe Acrobat Readers

HasFourthField: False

HasPassword: True

HasThirdField: False

IsSecurID: False

HasUserId: False

MSNメッセンジャー

HasFourthField: False

HasPassword: True

HasThirdField: False

IsSecurID: False

HasUserId: True

Visual SourceSafe

HasFourthField: False

HasPassword: True

HasThirdField: True

IsSecurID: False

HasUserId: True

7.5.5.2 ExtSearchUsers

戻り値:

.NET: ハッシュテーブルのリストのHashTable

Java: ハッシュマップのリストのHashMap

キー

値

ユーザー名

ログオンエントリ

キー

値

name

アプリケーション名

modifiedDate

最終更新日

lastUsedDate

SSOによる最終使用日

Id

GUID識別子

保留中のエントリ

applicationName

アプリケーション

createDate

作成日

executeDate

実行予定日

id

GUID識別子

instructionType

ADD | MODIFY | DELETE

provisioningAgent

エージェント名

status

SUCCESS | Pending

7.5.5.2.1 CLI出力

ext_search catalog=users returnLogons=true

すべてのユーザーのログオンのリストを返します。

johnd

modifiedDate: 2005-08-24 16:43:41Z

lastUsedDate: 2005-08-24 16:43:41Z

name: Adobe Acrobat Reader

id: a75f58c8-a3bd-4d00-bc27-99a587dd98f8

modifiedDate: 2005-08-24 16:43:41Z

lastUsedDate: 2005-08-24 16:43:41Z

name: Adobe Acrobat Reader

id: d6bc375d-3f90-400b-a012-6b80aff4ef49

modifiedDate: 2005-09-09 16:28:15Z

lastUsedDate: 2005-09-09 16:28:15Z

name: Visual SourceSafe

id: 80cdc929-61a6-4b86-8763-d5f02b0dbb8b

modifiedDate: 2005-09-01 17:30:26Z

lastUsedDate: 2005-09-01 17:30:26Z

name: Visual SourceSafe

id: 065f5cff-b651-4a3a-a99c-c606059cbad7

modifiedDate: 2005-09-09 16:41:33Z

lastUsedDate: 2005-09-09 16:41:33Z

name: Visual SourceSafe

id: 0a0686b5-3e38-4830-8e02-79b8177de0b4

7.5.5.3 ExtSearchLog

戻り値:

.NET: ハッシュテーブルのハッシュテーブル

Java: ハッシュマップのハッシュマップ

キー

値

エントリ番号

ハッシュテーブル(文字列キーと値のペア)

キー

値

applicationName

アプリケーション名

eventType

イベントのタイプ(DWORDフラグ)

executeDate

実行日

id

GUID識別子

provisionedUser

プロビジョニングされたユーザー

provisioningAgent

エージェント名

timeStamp

タイムスタンプ

7.5.5.3.1 CLI出力

ext_search catalog=eventLog

すべてのユーザーのログオンのリストを返します。

エントリ1

applicationName:

eventType: 64

executeDate: 0001-01-01 00:00:00.000Z

id: a09b9de7-4b65-464c-8dcb-90219e222991

provisionedUser:

provisioningAgent: SSO PM Console

timestamp: 2005-11-17 18:33:37.290Z

エントリ2

applicationName:

eventType: 64

executeDate: 0001-01-01 00:00:00.000Z

id: bd444f6c-e3cf-4efc-bbd8-c5e82d55ed96

provisionedUser:

provisioningAgent: SSO PM Console

timestamp: 2005-11-17 18:33:37.370Z

エントリ3

applicationName:

eventType: 64

executeDate: 0001-01-01 00:00:00.000Z

id: 6eebd1dd-a904-43db-8c22-38ef941e83b3

provisionedUser:

provisioningAgent: SSO PM Console

timestamp: 2005-11-17 18:33:38.960Z

エントリ4

applicationName: Visual SourceSafe

eventType: 4

executeDate: 2005-11-17 19:28:51.427Z

id: 2c45f078-c9c7-4268-9abd-4e50111ba644

provisionedUser: davidh

provisioningAgent: SSO PM Console

timestamp: 2005-11-17 19:28:51.427Z

7.5.6 サンプル・コード

次のコードは、IProvisioningインタフェースからAddCredentialメソッドを呼び出す方法を示します。この例では、Logon Managerユーザーjohndoeの資格証明を追加しています。追加されるアプリケーションはYahoo、アプリケーションの資格証明はjdoeおよびpasswordです。この資格証明の説明はTestAppです。

try

{

IProvisioningResult ipr = iprov.AddCredential(

"johndoe",

"Yahoo",

"Test App",

"jdoe",

"password");

//Process results in ipr

if (!ipr.Success)

{

Console.WriteLine(ipr.ErrorMessage);

return;

}

//Display GUID

Console.WriteLine("SUCCESS" + ipr.CommandID);

}

catch (ProvisioningException ex)

{

// Handle Exception...

}

よりフレキシブルな方法として、オプションの引数を使用して資格証明を追加することもできます。このメソッドでは、追加パラメータ(アプリケーションによってはOTHER1およびOTHER2フィールドが必要です)、およびそれらのパラメータの組み合わせを使用できます。

次の例では、SSOユーザーjohndoeのVisual SourceSafeアプリケーションの資格証明を追加する方法を示します。このアプリケーションにはOTHER1フィールドが必要なため、この方法が資格証明を追加する唯一の方法です。

StringDictionary options = new StringDictionary();

options.Add(OperationKeys.DESCRIPTION, "Test App");

options.Add(OperationKeys.APP_USERID, "jdoe");

options.Add(OperationKeys.PASSWORD, "password");

options.Add(OperationKeys.OTHER1, "VGO");

IProvisioningResult ipr = iprov.AddCredential("johndoe",

"Visual SourceSafe", options);

7.6 SDKとしてのJava CLIの使用

この項の手順を実施する前に、Provisioning Gateway CLIをインストールする必要があります。Provisioning Gateway CLIのインストールの詳細は、『Oracle Enterprise Single Sign-On Suiteインストレーション・ガイド』を参照してください。

Java CLIは<home directory>\v-GO PM\Client\Java\<version>の下にあります。

Java CLIをSDKとして使用するには、次の手順を実行します。

- pmcli.jarおよびサポートしているライブラリをCLASSPATHに追加します。

- プロビジョニング・クラスをアプリケーションにインポートします。

- ProvisioningConnectionクラスのインスタンスを作成します。

- CLIOperationParserクラスのインスタンスを作成します。

- StringMapを使用し、操作および操作パラメータを定義します。

- 手順4で作成したオブジェクト・インスタンスを使用し、Operationのインスタンスを作成します。

- 実行時間を設定します(設定しない場合、デフォルトの"Now"が使用されます)。

- ProvisioningConnection(手順3)インスタンスを使用し、WebサービスにOperationインスタンス(手順6)を送信します。

- 操作の成功および結果を取得します。

7.6.1 サンプル・コード

次のコードは、それぞれの手順を実行する簡単なプログラムです。

1. これらのクラスをアプリケーションにインポートします。
import com.passlogix.vgo.pm.cli.*; import com.passlogix.vgo.pm.operations.*;

Webサービスを呼び出すサンプル・ルーチンです。

void CallWebService(/* Parameters */) {

ProvisioningConnectionへの引数は次のように定義されます。

URL: WebサービスのURL strAgent: クライアント・エージェントのユーザー定義名 strUsername: 接続するユーザー名 strPassword: 接続に使用するパスワードProvisioningConnection conn = new ProvisioningConnection(strURL, strAgent, strUsername, strPassword); try {

2. 指示の実行を開始します。
CLIOperationParser opParser = CLIOperationParser.newInstance(); Operation.StringMap options = new Operation.StringMap();

3. ほとんどのオプションに対してはOperationKeysクラスを使用します。ExtSearch操作にはExtSearchKeysクラスを使用します。
options[OperationKeys.USERID] = "davidh"; options[OperationKeys.APPLICATION] = "Visual SourceSafe";

strOperは、CLIOperationParserで定義された操作と同一にすることができます。: Operation oper = opParser.parse(strOper, options);

4. 指示の実行時間を設定します。実行時間が指定されていない場合は、デフォルトのNowが使用されます。oper.setExecTime(dtExec); conn.sendInstruction(oper);

5. 操作が正常に実行された場合、結果を取得します。if (!oper.getSuccess()) { String strMsg = String.format(
"The command failed: id=%s, msg=%s", oper.getCommandID(), oper.getError()); return; }

6. コマンドIDおよび結果属性を取得します。
String strID = oper.getCommandID()); CollectionsMap map = oper.getResultAttributes()); } catch (Exception ex) { // print exception } }

コマンドによっては、片方または両方が空です。コマンドIDと結果属性のフォーマットの詳細、および各操作に使用可能なオプションについては、「SDKとしての.NET CLIの使用」の項を参照してください。使用可能な操作は、CLIOperationParserクラスの静的メンバーとして定義されます。サポートされている操作に対して使用可能なオプションおよびパラメータは、すべてこの文書の「OperationKeysインタフェース」および「ExtSearchKeysインタフェース」の項で定義されています。

7.6.2 クラス定義

次のクラス定義では、リクエストをProvisioning Gateway Webサービスにプログラム的に送信するために必要な、重要な定数およびメソッドについて記載します。

7.6.2.1 CLIOperationParserクラス

このクラスはOperationParserを継承しています。それ自身のインスタンスは、newInstance()を呼び出すことにより作成できます。インスタンスが存在する場合、サーバー上で実行される特定のリクエストを示すOperationオブジェクトの作成に使用できます。

定数文字列として定義された、サポートされているすべての操作は次のとおりです。

static public final String ADD_CREDENTIAL = "add_credential";

static public final String MODIFY_CREDENTIAL = "modify_credential";

static public final String DELETE_CREDENTIAL = "delete_credential";

static public final String DELETE_USER = "delete_user";

static public final String STATUS = "status";

static public final String CANCEL = "cancel";

static public final String CHECK_SERVER = "check_server";

static public final String GET_SETTINGS = "get_settings";

static public final String GET_SCHEMA = "get_schema";

static public final String SET_SETTINGS = "set_settings";

static public final String EXT_SEARCH = "ext_search";

このパーサーの新しいインスタンスの作成

static public CLIOperationParser newInstance();

選択した出力ストリームへの結果の出力

public void printResults(PrintStream out, Operation oper);

7.6.2.2 OperationParserクラス

このクラスはCLIOperationParserのベース・クラスです。追加操作をサポートし、Operationオブジェクトを作成するメソッドを定義します。

- 新規プロビジョニング操作およびそのサポート・クラスを追加します。
public void addOperation(String strOper, Class<? extends Operation> c)

サポート・クラスは、抽象Operationクラスから派生したものである必要があります。このメソッドは内部使用用です。

- 特定のプロビジョニング指示のOperationオブジェクトのインスタンス作成:
public Operation parse(String strInstr) throws InstantiationException, IllegalAccessException

この指示の形式は、コマンドラインで渡されたものと同じです。

- 操作名に基づくOperationオブジェクトのインスタンス作成:
public Operation parseNoOpt(String strOper) throws InstantiationException, IllegalAccessException

- 操作名およびパラメータ(キーと値のペアのマップとして指定された)に基づくOperationオブジェクトのインスタンス作成:
public Operation parse(String strOper, Operation.StringMap options) throws InstantiationException, IllegalAccessException

7.6.2.3 Operationクラス

OperationクラスはJava CLIがサポートするすべての操作のベース・クラスです。このクラスは正しいメッセージを構成してWebサービスに送信し、レスポンスの取得と保存を行います。結果の問合せに使用できるメソッドは次のとおりです。

- サーバーからraw xmlレスポンスを取得します。
public String getResponse()

- 操作が正常に実行されたかどうかを問い合わせます。
public boolean getSuccess()

- 操作の実行後、関連付けられたGUIDを取得します。
public String getCommandID()

操作に関連付けられたGUIDがない場合、空の文字列にすることができます。

- getSuccessがfalseを返した場合、エラー・メッセージを取得します。
public String getError()

- サーバー上でのこの操作の実行時間を設定します。
public void setExecTime(Date dtExec)

このパラメータの値を指定しない場合、操作はただちに実行されます。指定した場合、操作は指定された時間まで実行されません。

- 操作が正常に実行された場合、結果属性を取得します。
public CollectionsMap getResultAttributes()

success以外の結果が返されなかった場合、空のCollectionsMapが返されます。CollectionsMapの形式は、リストの名前と値のペアのマップ、またはその他のマップです。正確な形式は実行された操作により異なります。詳細は、「SDKとしての.NET CLIの使用」を参照してください。

- 操作を実行します。
public String send(ProvisioningConnection conn) throws PMCLIException, RemoteException

通常は、メソッドを直接呼び出さないでください。かわりに、次のように呼び出します。

ProvisioningConnection.sendInstruction(...)

これによりOperationオブジェクトが渡されます。

7.6.2.4 OperationKeysインタフェース

OperationKeysインタフェースは、操作に使用できるすべてのパラメータを定義します。パラメータはStringMapに対するキーとして指定し、その値が後に続きます。操作でサポートされるキーのサブセットの詳細については、Provisioning Gatewayに関する説明の「SDKとしての.NET CLIの使用」を参照してください。

public interface OperationKeys

{

static public final String USERID = "sso_userid";

static public final String APPLICATION = "sso_application";

static public final String DESCRIPTION = "sso_description";

static public final String APP_USERID = "sso_app_userid";

static public final String PASSWORD = "sso_password";

static public final String OTHER1 = "sso_other1";

static public final String OTHER2 = "sso_other2";

static public final String GUID = "command_id";

static public final String NAME = "name";

static public final String VALUE = "value"; }

7.6.2.5 ExtSearchKeysインタフェース

ExtSearchKeysインタフェースは、ExtSearch操作に対してサポートされるパラメータを定義します。OperationKeysインタフェースはこの操作に適用されません。このリストに記載されているパラメータを使用できます。

public interface ExtSearchKeys

{

ExtSearchでサポートされるキー

static public final String OPTION_CATALOG = "catalog";

static public final String OPTION_USERID = "userId";

static public final String OPTION_APPLICATION= "applicationName";

static public final String OPTION_EVENTTYPE = "eventType";

static public final String OPTION_STARTDATE = "startDate";

static public final String OPTION_ENDDATE = "endDate";

static public final String OPTION_LOGON = "logon";

static public final String OPTION_SHOWLOGONS = "returnlogons";

static public final String OPTION_SHOWPENDING = "returnInstructions";

static public final String OPTION_UIDMATCH = "uidMatch";

OPTION_UIDMATCHキーに使用可能な値

static public final String MATCH_EQUAL = "equal";

static public final String MATCH_SUBSTRING = "substring";

OPTION_CATALOGキーに使用可能な値

static public final String CATALOG_APPS = "Applications";

static public final String CATALOG_EVENTLOG = "EventLog";

static public final String CATALOG_USERS = "Users"; }

7.6.3 SSLを使用するためのJavaの設定

Java CLIにSSLサポートを設定するためには、Java Keystore Fileのルートを示すプロパティ・ファイルを変更する必要があります。

1. 使用するSSL資格証明のパブリック・バージョン(秘密鍵なし)をダウンロードします。IISをホストしているサーバーから取得できます。次の手順に従い、公開証明書をssl.cerファイルとして保存します。

1. SSL証明書を使用しているサーバーから、「Start」→「Run」を選択してMicrosoft Management Consoleを開き、MMCと入力し、「OK」をクリックします。

2. 「File」→「Add/Remove Certificates Snap-in」をクリックします。「Standalone」タブの「Add」をクリックします。

3. 「Certificate」スナップインを選択して、「Add」をクリックします。

4. 「Computer Account」を選択して、「次へ」をクリックします。

5. 「Local Computer」を選択して、「Finish」をクリックします。

6. 「Console Root」下の「Certificates (Local Computer)」を展開します。

7. 「Personal」を展開し、「Certificates」をクリックします。

8. 「SSL certificate」を右クリックし、「All Tasks」→「Export」を選択します。

9. 「Certificate Export Wizard」パネルで、「次へ」をクリックします。

10. 「Export Private Key」パネルで、「No, do not export the private key」をクリックします。

11. 使用するファイル形式(DERまたはBASE-64)を選択し、「次へ」をクリックします。

12. エクスポートするファイルを参照して選択します。「次へ」をクリックします。

13. ssl.cerファイルとして保存します。

14. 「Finish」をクリックしてから「OK」をクリックします。ファイルは(次に作成する)クライアントのJavaキーストアにインポートされます。

2. JDK 1.42+がクライアント・ワークステーションにインストールされていることを確認します。キーストアの作成に使用する、keytool.exeというバイナリがあります。

3. 次の手順に従い、pmcli.jksという名前のファイルをpmsslという別名で作成します。

1. 実行: keytool -import -trustcacerts -file ssl.cer -alias pmssl -keystore pmcli.jks

2. キーストアに対するパスワードを入力します。

3. 証明書の信頼を要求された場合は、「Yes」をクリックします。

4. pmcli.jksファイルをpmcli.jarが格納されているフォルダにコピーします。

4. pmcli.batでプロパティ・ファイルに対して定義されたフォルダに、pmcli.propertiesファイルを作成します。

5. pmcli.propertiesを編集して次の行を追加します。rmi.ssl.trust.keystore.location=pmcli.jks。

6. ファイルを保存します。

7. pmcli.propertiesがあるディレクトリへのフルパスを(ファイルへのフルパスではなく)CLASSPATHに追加します。

8. pmcli.batを実行し、https URLを-urlスイッチに渡します。

注意:

SSLを有効にしても、CLIのhttpサービスとの通信が妨げられることはありません。

Oracle Legal Notices

Copyright Notice

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

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

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.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.