Windchill にフォームベース認証を設定する前に、フォームベース認証ソリューションを選択して、Windchill で使用するために必要な修正を実行する必要があります。フォームベース認証ソリューションには、SiteMinder から埋め込み型サーブレットエンジンに組み込まれたフォームベース認証サポートビルドまでさまざまなものがあります。個別の設定の詳細はソリューションによって異なっており、ここには記載しませんが、理解することが重要な Windchill の詳細を次のセクションに示します。フォームベース認証ソリューションの設定については、ソリューションのマニュアルを参照してください。

フォームベース認証で使用できるログオフ機能はデフォルトの基本認証では使用できず、したがってエンドユーザー向けドキュメントには説明されていません。ユーザーはログオフ機能について認識していない可能性があります。フォームベース認証を有効にして Windchill 環境をロールアウトする場合、ログオフの方法についてユーザーに注意喚起してください。「ログオフ」メニューオプションのデフォルトのログオフ動作 (このセクションで後述します) を変更した場合、変更後の動作についてユーザーに必ず周知してください。

フォームベース認証ソリューションの設定の一部として、ログインフォームを非ブラウザクライアント (Java アプリケーションなど) で使用してログインデータの収集や wt.auth.form.submitUrl プロパティで指定した URL への投稿を行う、単純な XHTML で表示されたログインページを作成する必要があります。非ブラウザクライアントにはフォームベース認証の処理 (結局はブラウザクライアントを対象とするアプリケーション変換) に支援が必要なため、このページは必須です。

PTC では、非ブラウザクライアントで使用するログイン要求ページ表示として login.jsp ファイルを用意しています。ファイルは Windchill がインストールされている codebase/login サブディレクトリにあります。ログインフォームに必要な資格証明データフィールドは login.jsp ファイルを使用して表示されているため、このファイルを編集して適切な表示ラベルとフォームのフィールド名を含めることができます。

フォームベース認証ソリューションを設定する際に、一部の Windchill URL へのアクセスをソリューションで制約しなければならず、その他は制約してはならない場合があります。

関連する Windchill Web アプリケーション URL は <Windchill>/apacheConf/config/authResAdditions.xml ファイルにあります。ここで、<Windchill> は Windchill インストールディレクトリです。

各 URL はリソースタグに保存されます。たとえば、次のリソースタグがファイルに含まれています。

フォームベース認証では、URL を次のようにグループ化できます。

指定したタイプを含むリソースタグ内の URL には、フォームベース認証の制約を適用してはなりません。指定したタイプを含まない URL にはフォームベース認証の制約を適用する必要があります。

ファイル内の関連 URL のすべてのリストをレビューして、タイプ属性を含まないリソースタグにリストされている URL のセットのみがフォームベース認証ソリューションで制約されていることを確認します。

必要な変更を実装するために使用するフォームベース認証ソリューションを検討する際に、次の注記が役に立ちます。

フォームベース認証ソリューションの使用準備ができたら、次の設定手順に従います。

フォームベース認証はプロトコルレベルで透過的に処理することができないので、Windchill へのアクセスに使用されるクライアントには、フォームベース認証をサポートするように特別に設計する必要があるものがあります。たとえば、フォームベース認証を使用する際に、Windchill プログラム (ビジュアリゼーションサービスや Windchill Desktop Integration など) の変更が必要になることがあります。

フォームベース認証のためにビジュアリゼーションを変更する方法については、フォームベース認証に関する WVS の考慮事項を参照してください。

Windchill Desktop Integration の変更については、「高度なカスタマイズ」のデスクトップインテグレーションを参照してください。

カスタム JSP、SOAP サービス、および Info*Engine タスクをフォームベース認証ソリューションと一緒に使用できます。

フォームベース認証ソリューションを使用する際には、クライアントが使用して IE サーブレットにアクセスする URL、RPC、SimpleTaskDispatcher サーブレットに /protocolAuth URL プレフィックスを含める必要があります。

詳細については、Info*Engine の操作を参照してください。

サポートされるサードパーティ製品を使用している場合は、フォームベース認証をサポートするためにこれらの製品に変更が必要かどうかを判別する必要があります。

たとえば、Cognos は Windchill サーブレットエンジンと認証コードを使用しません。このため、組み込みの Windchill サーブレットエンジンベースのフォームベース認証を使用して、Windchill と Cognos の間で一貫性のあるシングルサインオンを実行することはできません。通常の設定では、Cognos は REMOTE_USER を直接取得します。REMOTE_USER が設定されていない場合、Cognos はフォームベース認証を使用するために特別な設定を必要とします。

匿名および Web サーバー設定からのプロトコルベースの認証制約以外のすべてを除去します。

Windchill 向けに設定されている Apache ベースの Web サーバーからの Windchill Web アプリケーションでは、次の手順に従って、プロトコルのみによる認証と匿名アクセスを行うもの以外のすべての認証制約を除去します。

フォームベース認証ソリューションの使用を有効にする wt.properties プロパティは、wt.auth.form.enabled です。

デフォルトで、フォームベース認証ソリューションの使用は無効になっています。有効にするには、xconfmanager ユーティリティを使用してプロパティを真に設定します。たとえば、Windchill シェルで次のように入力します。

フォームベース認証ソリューションの使用を有効にすることで、Windchill ページの右上隅にある Windchill「クイックリンク」メニューの「ログオフ」メニューオプションの表示も有効になります。

「ログオフ」メニューオプションを選択すると、デフォルト動作では Windchill サーブレットセッションが終了し、ログオフイベントが Windchill 監査ログに取り込まれます。ユーザーが開始したアクティビティでログオフ時に進行中のものは、サーブレットセッションにアクセスしないかぎりは続行されます。たとえば、ユーザーがサーチを開始した後、完了する前にログオフした場合は、結果を表示しようとしたときにサーチエラーが発生します。ユーザーがチェックイン操作を開始した後、チェックイン確認が表示される前に「ログオフ」をクリックした場合、チェックインは完了しますが、確認は表示できず、エラーが記録されます。

デフォルトで、サーブレットセッションが認証セッションと同じ場合は、そのセッションに関連付けられている状態データはいずれも失われ、ログイン状態でなくなります。「ログオフ」メニューオプションを使用してユーザーがログオフした後、ページは Windchill ベース URL を実行します。ユーザーはもうログインしていないので、再度ログインできるログインフォームが URL に表示されます。

お使いのフォームベース認証ソリューションでさまざまなコンフィギュレーション設定を選択したり、wt.properties の wt.logout.url プロパティにさまざまな URL を設定したりすることで、このデフォルトのログオフ動作を変更できます。サーブレットセッションに基づかない (したがって認証セッションがサーブレットセッションの終了によって終了しない) フォームベース認証ソリューションの場合、wt.logout.url プロパティに設定する URL はお使いのフォームベース認証ソリューションで現在の認証セッションのログアウトを行うものでなければなりません。