Forguncyで作成したアプリケーションで異なるWebアプリケーションやクラウドサービスの認証情報を利用する、いわゆるシングルサインオンを実現する場合、認証プロバイダーの利用を検討してください。

認証プロバイダーでは実現が不可能な場合、プログラミングによるカスタマイズによってシングルサインオンが可能です。ここでは、そのような場合におけるシングルサインオンの方法を説明します。なお、本機能はWindows認証では使用できません。

Forguncyの認証連携機能は、以下の図のような流れで行われます。

1. ユーザーのトークンを要求します。

   ユーザーのトークンを要求するには、以下の仕様を満たしたHTTPリクエストを行います。

   送信先	http://＜サーバー名＞/＜アプリケーションパス＞/SSO/GetUserToken
   HTTPメソッド	POST
   メッセージボディ	認証させたいForguncyのユーザー名と認証連携用パスワードを持つJSON 例） {userName:"user1", password:"6s6s6s6s6s6s"}

   上記のメッセージボディに含まれるパスワードは、他のアプリケーションからログインを許可した場合に設定されるアプリケーションで共通のパスワードです。このパスワードは、以下の場所で確認、および変更を行うことが可能です。

   ［ファイル］→［オプション］→［アプリケーション連携］を選択して、［他のアプリケーションからのログインを許可する］をチェックします。

   ［他のアプリケーションからのログインを許可する］がチェックされていなければ、ユーザーのトークンを要求することはできません。

   

2. ユーザートークンを受け取る。

   トークンを要求するHTTPリクエストが成功した場合、そのレスポンスとしてトークンが返されます。トークンを要求するHTTPリクエストが失敗した場合、返されるトークンは「Error:」の文字列から始まります。

3. トークンをクエリ文字列（URLパラメーター）として指定して、遷移したいForguncyアプリケーションのページに遷移します。

   http://＜サーバー名＞/＜アプリケーションパス＞/?token=1h1h1h1h-1h1h-1h1h-1h1h-1h1h1h1h1h1h

   2の手順でトークンを受け取ってから、3の手順を行うまでの制限時間は、既定では10秒に設定されています。これを変更する場合には、以下の手順で行います。

   ［ファイル］→［オプション］→［アプリケーション連携］を選択して、［トークンの有効期限］を変更します。

   

サンプルコード

C#の場合のサンプルコードを以下に示します。

var baseUrl = "http://localhost/app1";
var userName = "user1";
var password = "6s6s6s6s6s6s";
HttpWebRequest rq = HttpWebRequest.Create(baseUrl + "/SSO/GetUserToken") as HttpWebRequest;
rq.Method = WebRequestMethods.Http.Post;
rq.Accept = "application/json";
rq.ContentType = "application/json";
var loginStr = "{userName:\"" + userName + "\", password:\"" + password + "\"}";
var data = Encoding.UTF8.GetBytes(loginStr);
using (Stream stream = rq.GetRequestStream())
{
    stream.Write(data, 0, data.Length);
}
var response = rq.GetResponse();
var token = new StreamReader(response.GetResponseStream()).ReadToEnd();
if(token.StartsWith("Error:"))
{
    MessageBox.Show(token);
    return;
}
Process.Start(baseUrl + "?token=" + token);