Oracle OpenSSO Update 2 リリースノート

Oracle OpenSSO Fedlet の設定

この節では、サービスプロバイダアプリケーションで Fedlet を最初に設定する方法を説明します。

Fedlet の初回設定が終わったあと、ほかに実施する設定があれば続けます。いくつかの留意点を次に示します。

ProcedureJava Fedlet を設定する

  1. アイデンティティープロバイダ側で、アイデンティティープロバイダの XML メタデータを生成し、idp.xml という名前のファイルにそのメタデータを保存します。

    Oracle OpenSSO 8.0 Update 2 の場合、exportmetadata.jsp を使用します。例:

    http://opensso-idp.example.com:8080/opensso/saml2/jsp/exportmetadata.jsp
  2. 必要な場合は、サービスプロバイダ側で Fedlet の ZIP ファイルを解凍します。

  3. Fedlet のホームディレクトリを作成します。Fedlet は、メタデータ、トラストサークル、設定プロパティーファイルをこのディレクトリから読み取ります。

    デフォルトの場所は、Feldet の Web コンテナを実行しているユーザーのホームディレクトリ下にある Fedlet サブディレクトリです。この場所は user.home JVM プロパティーで示されています。たとえば、このホームディレクトリが /home/webservd の場合、Fedlet のホームディレクトリは次のようになります。

    /home/webservd/fedlet

    Fedlet のデフォルトホームディレクトリを変更するには、JVM ランタイム com.sun.identity.fedlet.home プロパティーの値を希望する場所に設定します。例:

    -Dcom.sun.identity.fedlet.home=/export/fedlet/conf

    このように変更すると、Fedlet はそのメタデータ、トラストサークル、設定ファイルを /export/fedlet/conf ディレクトリから読み取るようになります。

  4. Java Fedlet の java/conf ディレクトリから次のファイルを Fedlet ホームディレクトリにコピーします。

    • sp.xml-template

    • sp-extended.xml-template

    • idp-extended.xml-template

    • fedlet.cot-template

  5. Fedlet ホームディレクトリで、コピーしたファイルの名前を変更して、各ファイルの名前から -template を取り除きます。

  6. Fedlet ホームディレクトリにコピーして名前を変更した各ファイルで、次の表に示すとおりにタグを置き換えます。

    タグ 

    置き換え後のタグ 

    FEDLET_COT

    リモートアイデンティティープロバイダおよび Java Fedlet サービスプロバイダアプリケーションがメンバーとなっているトラストサークル (COT) の名前。  

    FEDLET_ENTITY_ID

    Java Fedlet サービスプロバイダアプリケーションの ID (名前)。例: fedletsp

    FEDLET_PROTOCOL

    Java Fedlet サービスプロバイダアプリケーションの Web コンテナのプロトコル (fedlet.war など)。例: https

    FEDLET_HOST

    Java Fedlet サービスプロバイダアプリケーションの Web コンテナのホスト名 (fedlet.war など)。例: fedlet-host.example.com

    FEDLET_PORT

    Java Fedlet サービスプロバイダアプリケーションの Web コンテナのポート番号 (fedlet.war など)。例: 80

    FEDLET_DEPLOY_URI

    Java Fedlet サービスプロバイダアプリケーションの URL。例: http://fedletsp.example.com/myFedletApp

    IDP_ENTITY_ID

    リモートアイデンティティープロバイダの ID (名前)。例: openssoidp

    : Fedlet サービスプロバイダまたはアイデンティティープロバイダのエンティティ ID にパーセント記号 (%) またはコンマ (,) が含まれている場合は、fedlet.cot ファイル内で置き換える前にその文字をエスケープする必要があります。 たとえば、「%」を「%25」に、「,」を「%2C」に変更します。

  7. Java Fedlet の java/conf ディレクトリから、FedletConfiguration.properties ファイルを Fedlet のホームディレクトリにコピーします。

  8. アイデンティティープロバイダの標準メタデータ XML ファイル (手順 1 のもの) を Fedlet ホームディレクトリにコピーします。このファイルは idp.xml という名前にする必要があります。

  9. Java Fedlet XML メタデータファイル (sp.xml) をアイデンティティープロバイダにインポートします。

    Oracle OpenSSO 8.0 Update 2 の場合、OpenSSO 8.0 管理コンソールで「Common Tasks」の下にある「Register Remote Service Provider」ワークフローを使用して、Java Fedlet サービスプロバイダのメタデータをインポートしたり、Java Fedlet サービスプロバイダをトラストサークルに追加したりできます。

次の手順

要件によっては、Java Fedlet のその他の設定を続けます。

Procedure.NET Fedlet を設定する

  1. アイデンティティープロバイダ側で、アイデンティティープロバイダの XML メタデータを生成し、idp.xml という名前のファイルにそのメタデータを保存します。

    Oracle OpenSSO 8.0 Update 2 の場合、exportmetadata.jsp を使用します。次に例を示します。

    http://opensso-idp.example.com:8080/opensso/saml2/jsp/exportmetadata.jsp
  2. 必要な場合は、サービスプロバイダ側で Fedlet の ZIP ファイルを解凍します。

  3. .NET Fedlet の asp.net/conf フォルダから次のファイルをアプリケーションの App_Data フォルダにコピーします。

    • sp.xml-template

    • sp-extended.xml-template

    • idp-extended.xml-template

    • fedlet.cot-template

  4. App_Data フォルダで、コピーしたファイルの名前を変更して、各ファイルの名前から -template を取り除きます。

  5. App_Data フォルダにコピーして名前を変更した各ファイルで、次の表に示すとおりにタグを置き換えます。

    タグ 

    置き換え後のタグ 

    FEDLET_COT

    リモートアイデンティティープロバイダおよび .NET Fedlet サービスプロバイダアプリケーションがメンバーとなっているトラストサークル (COT) の名前。  

    FEDLET_ENTITY_ID

    .NET Fedlet サービスプロバイダアプリケーションの ID (名前)。例: fedletsp

    FEDLET_DEPLOY_URI

    .NET Fedlet サービスプロバイダアプリケーションの URL。例: http://fedletsp.example.com/myFedletApp

    IDP_ENTITY_ID

    リモートアイデンティティープロバイダの ID (名前)。例: openssoidp

  6. アイデンティティープロバイダの標準メタデータ XML ファイル (手順 1 のもの) をアプリケーションの App_Data フォルダにコピーします。このファイルは idp.xml という名前にする必要があります。

  7. .NET Fedlet asp.net/bin フォルダの Fedlet.dll ファイルおよび Fedlet.dll.config ファイルを、アプリケーションの bin フォルダにコピーします。

  8. .NET Fedlet XML メタデータファイル (sp.xml) をアイデンティティープロバイダにインポートします。

    Oracle OpenSSO 8.0 Update 2 の場合、OpenSSO 8.0 管理コンソールで「Common Tasks」の下にある「Register Remote Service Provider」ワークフローを使用して、.NET Fedlet サービスプロバイダのメタデータをインポートしたり、Java Fedlet サービスプロバイダをトラストサークルに追加したりできます。

次の手順

要件によっては、.NET Fedlet のその他の設定を続けます。