Interstage Application Server リファレンスマニュアル（コマンド編）

A.46 ssomksid

名前

　ssomksid　−　サービスIDファイルの作成

形式

　ssomksid serviceidpath {-f FQDN | -n domain-name}

機能説明

　以下の場合において必要になるサービスIDファイルを作成します。

• JAAS認証を行う場合
• Interstage Security Directorが提供するInterstage シングル・サインオン連携機能を使用する場合
• SOAPメッセージに対するユーザ認証を行う場合
• UDDIレジストリサービス機能を利用する場合

　本コマンドはSSO管理者が使用します。なお、本コマンドは絶対パスで実行する必要はありません。

　以下に、ssomksidコマンドのオプションと引数を説明します。

serviceidpath

　serviceidpathには、サービスIDファイルの出力先ファイル名を絶対パスで指定します。
　出力先ファイルがすでに存在する場合、または出力先ファイルを書き込む権限がない場合は、その旨をエラーメッセージで標準エラー出力に表示してエラーで終了します。
　出力先ファイル名が絶対パスで指定されていない場合は、その旨をエラーメッセージで標準エラー出力に表示してエラーで終了します。

-f FQDN

　FQDNには、サービスIDを使用するJavaアプリケーション、または業務サーバを実行するサーバのホスト名、または業務サーバのホスト名をFQDN(Fully Qualified Domain Name)で指定します。なお、FQDNとdomain-nameは同時に指定することはできません。

-n domain-name

　domain-nameには、サービスIDを共有する範囲をドメイン名で指定します。業務サーバのサービスIDファイルを作成する場合のみ指定します。なお、FQDN(Fully Qualified Domain Name)とdomain-nameは同時に指定することはできません。
　指定するドメイン名が2階層（.co.jpなど）の場合、ブラウザがCookieを受け付けない可能性があります。この場合、運用時にブラウザに403のHTTPのステータスコードが通知されます。3階層以上(.fujitsu.co.jpなど)のドメイン名を指定して、サービスIDファイルを作成し直してください。
　指定するドメイン名は、以下の形式で設定してください。
　　・英字、数字、ハイフン（-）、ピリオド(.)以外の文字は使用しないでください。
　　・先頭1文字目は必ずピリオド(.)を設定してください。
　　・2階層以上のドメイン名を指定してください。
　　・以下の場合はエラーになります。設定しないでください。
　　　−ピリオド(.)を連続して設定した場合
　　　−ピリオド(.)に続けてハイフン(-)を設定した場合
　　　−末尾の文字列がピリオド(.)の場合
　　　−末尾の文字列がハイフン(-)の場合

サービスIDファイルの作成手順

　サービスIDファイルを作成する際には、運用方法により以下の2つのどちらかを指定します。

1. サーバのFQDN(Fully Qualified Domain Name)を指定して作成する方法
   　認証情報をFQDNで指定したサーバのみで保持します。-fオプションにサーバのFQDNを指定し、サービスIDファイルを作成してください。通常はこの方法で作成してください。
   
2. サーバの属するネットワークのドメインを指定して作成する方法
   　認証情報をサーバの属するネットワークのドメイン単位で保持します。-nオプションにドメインを指定し、サービスIDファイルを作成してください。この場合、認証情報をドメインで共有するため、より高速な運用が行えます。
   　ただし、シングル・サインオン専用のドメインを用意するなどして、ドメイン内に不正なサーバが構築されることがないように、厳重に管理する必要があります。

　サービスIDを共有するドメイン“.co.jp”と“.com”など全く異なるドメインの単位で設定してください。例えば“.abc.sample.co.jp”と“.sample.co.jp”といったような、包含関係となるドメインを指定しないでください。
　また、同一のドメイン内で、-fオプションで作成したサービスIDファイルと、-nオプションで作成したサービスIDファイルを混在させて運用することはできません。例えば、業務サーバ（“hostA.sample.co.jp”）用のサービスIDファイルを-fオプションで“hostA.sample.co.jp”と指定して作成し、業務サーバ（“hostB.sample.co.jp”）用のサービスIDファイルを-nオプションで“.sample.co.jp”と指定して作成した場合も、“hostA.sample.co.jp”と“.sample.co.jp”が包含関係となるため指定しないでください。

例）

　以下のように、x.abc.co.jpとy.abc.comという業務サーバ用にサービスIDファイルを用意する場合、ドメインが異なっているため業務サーバごとに、“.abc.co.jp”と“.abc.com”でサービスIDファイルを作成します。
　ssomksid C:\temp\sid-for-x -n .abc.co.jp

　ssomksid C:\temp\sid-for-y -n .abc.com

　以下のようにサービスIDを共有するドメインを“.abc.co.jp”と指定すると“x.abc.co.jp”と“y.domain.abc.co.jp”のどちらの業務サーバも同じサービスIDファイルを使用することができます。
　ssomksid C:\temp\sid -n .abc.co.jp

例）

　以下のように、x.abc.co.jpとy.abc.comという業務サーバ用にサービスIDファイルを用意する場合、ドメインが異なっているため業務サーバごとに、“.abc.co.jp”と“.abc.com”でサービスIDファイルを作成します。
　ssomksid /tmp/sid-for-x -n .abc.co.jp

　ssomksid /tmp/sid-for-y -n .abc.com

　以下のようにサービスIDを共有するドメインを“.abc.co.jp”と指定すると“x.abc.co.jp”と“y.domain.abc.co.jp”のどちらの業務サーバも同じサービスIDファイルを使用することができます。
　ssomksid /tmp/sid -n .abc.co.jp

注意事項

• 本コマンドはセション管理の運用を行っていないリポジトリサーバで実行してください。
• 本コマンドはリポジトリサーバの環境構築後に実行してください。
• 本コマンドで出力されたファイルは編集しないでください。
• 本コマンドは管理者権限で実行してください。
  
  　本コマンドで作成したサービスIDファイルは、Administratorsグループのみアクセス可能となります。
  
  　本コマンドで作成したサービスIDファイルの所有者はスーパユーザとなり、スーパユーザのみアクセス可能となります。
• サービスIDファイルを作成するときに、-fオプションに指定するFQDN、または-nオプションに指定するドメイン名が、業務サーバの定義ファイルのFQDNと一致していない場合には、業務サーバの起動時にエラーになるため、サービスIDファイルを再作成する必要があります。この場合、業務サーバとユーザID／パスワードで認証サーバに認証するJavaアプリケーションでサービスIDファイルを共用していた場合でも、Javaアプリケーションへの影響はありません。

使用例

　業務サーバ(FQDN=www.fujitsu.example.com)用のサービスIDファイルをFQDNで作成し、“C:\temp”ディレクトリの“atz.sid”に出力します。

ssomksid C:\temp\atz.sid -f www.fujitsu.example.com

　業務サーバ(FQDN=www.fujitsu.example.com)用のサービスIDファイルを共有するドメイン名“.example.com”で作成し、“C:\temp”ディレクトリの“atz.sid”に出力します。

ssomksid C:\temp\atz.sid -n .example.com

　業務サーバ(FQDN=www.fujitsu.example.com)用のサービスIDファイルをFQDNで作成し、“/tmp”ディレクトリの“atz.sid”に出力します。

ssomksid /tmp/atz.sid -f www.fujitsu.example.com

　業務サーバ(FQDN=www.fujitsu.example.com)用のサービスIDファイルを共有するドメイン名“.example.com”で作成し、“/tmp”ディレクトリの“atz.sid”に出力します。

ssomksid /tmp/atz.sid -n .example.com