ページの先頭行へ戻る
Interstage Mobile Application Server V1.3.0 アプリケーション開発ガイド
FUJITSU Software

3.3.3.2 ログイン

アプリケーションは、IMAPSが提供している認証機構を呼び出して、利用しているユーザーの正当性を検証できます。ログインには以下の種類があります。
  • IMAPSサーバが提供している認証機能をネットワーク経由で呼び出し、サーバ側で認証するオンライン認証
  • クライアント内部で保持しているクレデンシャルを用いて認証する、オフライン認証

注意

Androidの場合、ログアウトを呼び出さずにアプリケーションを終了すると、再度アプリケーションを起動したときに、ユーザー情報や認証情報が残ったままになっている場合があります。

アプリケーション終了時、または起動時にログアウトを呼び出して、ユーザー情報を初期化してください。

使用例
オンライン認証を行うためには、com.fujitsu.imaps.plugin.auth.javaapi.LoginManager#loginOnlineメソッド、オフライン認証を行うためには、com.fujitsu.imaps.plugin.auth.javaapi.LoginManager#loginOfflineメソッドを呼び出します。
     private void loginFunc(Context context) {
         String url = "https://サーバアドレス:ポート";
         String userId = "user1";
         String passwd = "pass11";
         new AsyncLoginTask(context, url, userId, passwd).execute();
     }
 
     class AsyncLoginTask extends AsyncTask<String, Integer, String> {
         LoginManager mLoginManager = null;
         String mLoginURL = null;
         String mUserId = null;
         String mPasswd = null;
         ・・・・
 
         public AsyncLoginTask(Context context, String loginURL, String userId, String passwd) {
             mLoginManager = new LoginManager(context);
             mLoginURL = loginURL;
             mUserId = userId;
             mPasswd = passwd;
             ・・・・
         }
 
         protected String doInBackground(String... params) {
             try { 
                 mLoginManager.loginOnline(mLoginURL, mUserId, mPasswd);
             } catch (例外キャッチ) {
                 // キャッチした例外の内容に応じて、例外処理を実装します。
             }
             return null;
         }
     }
     private void loginFunc(Context context) {
         String userId = "user1";
         String passwd = "pass11";
         try { 
             mLoginManager = new LoginManager(context);
             mLoginManager.loginOffline(userId, passwd);
         } catch (例外キャッチ) {
             // キャッチした例外の内容に応じて、例外処理を実装します。
         }
     }
オフライン認証とは、クライアントが保持しているクレデンシャルを用いて利用ユーザーの正当性を検証する認証です。IMAPSサーバの認証機構を利用しないので、ネットワークが利用できない状態でも認証できます。オフライン認証をするには、オンライン認証で一度は認証しておく必要があります。
ネットワーク状態を気にせずログインを実行したい場合は、com.fujitsu.imaps.plugin.auth.javaapi.LoginManager#loginAutoメソッドを呼び出します。loginAutoメソッドは、ネットワーク状態に応じて最適なログイン方法を選択します。

ポイント

  • オンライン認証では、クライアント設定ファイルのimapsServerAddressで接続先のサーバを設定することも可能です。詳細は、開発者用マニュアル、付録C クライアント設定ファイルを参照してください。