変更履歴 Biz メール SSO 連携サービス IF 仕様書変更年月変更内容新規作成 ii

Size: px

Start display at page:

Download "変更履歴 Biz メール SSO 連携サービス IF 仕様書変更年月変更内容 1 2012-04-05 新規作成 ii"

しょうすけかせ
7 years ago
Views:

1 Biz メールシングルサインオン連携サービス IF 仕様書第 1.0 版 NTT コミュニケーションズ株式会社 i

2 変更履歴 Biz メール SSO 連携サービス IF 仕様書変更年月変更内容新規作成 ii

3 目次 1 はじめに本書の目的 SSO(シングルサインオン) 機能概要 SSO リダイレクト詳細認証用生成値の生成方法ドメイン追加時の手順 SSO エラー発生時の切り分け手順遷移先 URL SSO 用 JSP のサンプル...7 iii

4 1 はじめに 1.1 本書の目的本書は Biz メールサービスへのシングルサインオン( 以下 SSO)を実現するための手順について記述する 4

5 2 SSO(シングルサインオン) 2.1 機能概要通常 Biz メールのメールクライアントを利用する場合ユーザは Biz メールサーバへの認証行為が必要となるがユーザのメールアドレスが連携システムで認証された場合は Biz メールサーバに対して内部的に認証処理を行うことによりユーザに Biz メールサーバへの認証行為を行わせることなく Biz メールのメールクライアントを利用させることができる SSO 機能で認証させるにはBiz メール側で認証するために必要なパラメータの生成を行い Biz メールに対してリダイレクトする必要がある連携システムから Biz メールへ SSO する際の処理遷移について図 1に示す User 連携システム Biz メール Biz メール起動 SSO リダイレクトURL 生成 SSO リダイレクト先 URL をリターン SSO 処理 SSO 認証完了ログイン後操作図 1 : SSO 処理遷移 2.2では生成するパラメータおよびリダイレクト方法について記述する 2.2 SSO リダイレクト詳細リダイレクト先の URL のフォーマットは以下のフォーマットとなるメールホスト名 >/service/preauth? account={account-identifier& by={by-value& timestamp={time& expires={expires& preauth={computed-preauth redirecturl={redirection-url 5

わせることなく Biz メールのメールクライアントを利用させることができる SSO 機能で認証させるにはBiz メール側で認証するために必要なパラメータの生成を行い Biz メールに対してリダイレクトする必要がある連携システムから Biz メールへ SSO する際の処理遷移について図 1に示す User 連携

6 表 1 : リダイレクト URL パラメータ一覧 # パラメータ必須内容 1 account- identifier メールアドレス 2 by-value name 固定 3 time 現在時刻のミリ秒 1 4 expires 0 固定 5 computed-preauth 認証用生成値 (2.3 認証用生成値の生成方法 ) 6 redirection-url 遷移先 URL(2.36 遷移先 URL) 1:シングルサインオン処理を行うサーバのシステム時刻との差が前後 5 分以内に収まっていなければエラーとなる 2.3 認証用生成値の生成方法認証用生成値を生成する手順は以下のとおり 1 account by expires timestamp の値をで連結した文字列を生成 2 連結した文字列を SHA-1 HMAC で PreAuthKey( 後述 )を使用し暗号化し 16 進数文字列に変換文字列の連結表 2のパラメータの値より文字列を連結する表 2 : 連結文字列の設定値 # パラメータ値 1 account john.doe@domain.com 2 by name 3 expires 0 4 timestamp [ 連結文字列の例 ] john.doe@domain.com name SHA-1 HMAC で暗号化し 16 進数文字列に変換で連結した文字列を元に弊社より別途提示させていただく PreAuthKey を使用し暗号化処理を行う連結した文字列を PreAuthKey で暗号化し 16 進数の文字列に変換する hmac("john.doe@domain.com name ", "6b7ead4bd421836e8cf0379cd6c1a04acc127abd07c8ee4b61023e19220e929c"); 認証用生成値 : b248f6cfd027edi45c5h69f k04772f844 PreAuthKey 及び認証用生成値はサンプル生成した認証用生成値を元に2.2のフォーマットに従いリダイレクトすることでシングルサインオンが可能となる 6

3 認証用生成値の生成方法認証用生成値を生成する手順は以下のとおり 1 account by expires timestamp の値をで連結した文字列を生成 2 連結した文字列を SHA-1 HMAC で PreAuthKey( 後述 )を使用し暗号化し 16 進数文字列に変換

7 2.4 ドメイン追加時の手順 PreAuthKey はドメイン単位で必要となるため新たなドメインを追加する場合は新ドメインでシングルサインオン連携サービスの申し込みをする必要がある 2.5 SSO エラー発生時の切り分け手順 2.6 遷移先 URL SSO 成功後の遷移先画面はパラメータの redirecturl で指定する指定できる値について表 3 に示す表 3 : 遷移先 URL の設定 # パラメータ SSO 成功後の遷移先画面 1 省略時アドバンスト版 2 /webmail/h/ 標準版 3 /webmail/m/ スマートフォン画面 2.7 SSO 用 JSP のサンプル <%@ page contenttype="text/html; charset=ms932" %> <%@ page import="java.security.invalidkeyexception" %> <%@ page import="java.security.nosuchalgorithmexception" %> <%@ page import="java.security.securerandom" %> <%@ page import="java.util.hashmap" %> <%@ page import="java.util.map" %> <%@ page import="java.util.iterator" %> <%@ page import="java.util.treeset" %> <%@ page import="javax.crypto.mac" %> <%@ page import="javax.crypto.secretkey" %> <%! // preauth 定義開始 // preauthkey( 以下はサンプル)を指定する public static final String DOMAIN_KEY = "6b7ead4bd421836e8cf0379cd6c1a04acc127abd07c8ee4b61023e19220e929c "; public static String generateredirect(httpservletrequest request, String name) { HashMap params = new HashMap(); String ts = System.currentTimeMillis()+""; params.put("account", name); params.put("by", "name"); // needs to be part of hmac params.put("timestamp", ts); params.put("expires", "0"); // means use the default String preauth = computepreauth(params, DOMAIN_KEY); + returnrequest.getscheme()+"://"+request.getservername()+":"+request.getserverport()+"/service/preauth/?" "account="+name+ "&by=name"+ "&timestamp="+ts+ "&expires=0"+ 7

画面 2.7 SSO 用 JSP のサンプル <%@ page contenttype="text/html; charset=ms932" %> <%@ page import="java.security.invalidkeyexception" %> <%@ page import="java.security.nosuchalgorithmexception" %> <%@ page import="java.

8 "&preauth="+preauth; public static String computepreauth(map params, String key) { TreeSet names = new TreeSet(params.keySet()); StringBuffer sb = new StringBuffer(); for (Iterator it=names.iterator(); it.hasnext();) { if (sb.length() > 0) sb.append(' '); sb.append(params.get(it.next())); return gethmac(sb.tostring(), key.getbytes()); private static String gethmac(string data, byte[] key) { try { ByteKey bk = new ByteKey(key); Mac mac = Mac.getInstance("HmacSHA1"); mac.init(bk); return tohex(mac.dofinal(data.getbytes())); catch (NoSuchAlgorithmException e) { throw new RuntimeException("fatal error", e); catch (InvalidKeyException e) { throw new RuntimeException("fatal error", e); static class ByteKey implements SecretKey { private byte[] mkey; ByteKey(byte[] key) { mkey = (byte[]) key.clone();; public byte[] getencoded() { return mkey; public String getalgorithm() { return "HmacSHA1"; public String getformat() { return "RAW"; public static String tohex(byte[] data) { StringBuilder sb = new StringBuilder(data.length * 2); for (int i=0; i<data.length; i++ ) { sb.append(hex[(data[i] & 0xf0) >>> 4]); sb.append(hex[data[i] & 0x0f] ); return sb.tostring(); private static final char[] hex = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'; // preauth 定義終了 %> <% // Preauth メインロジック開始 try { String account = request.getparameter("account"); // // 他システム認証 (POP など) // // // 他システム認証が OK の場合は 8

getbytes()); private static String gethmac(string data, byte[] key) { try { ByteKey bk = new ByteKey(key); Mac mac = Mac.getInstance("HmacSHA1"); mac.init(bk); return tohex(mac.dofinal(data.

9 // Biz メールサーバ認証 OK として preauth にリダイレクトする // String redirect = generateredirect(request, account); response.sendredirect(redirect); catch (Exception ex) { // 例外が発生した場合の処理 finally { // finally 処理 // Preauth メインロジック終了 %> 9

購買ポータルサイトyOASIS簡易説明書 b

購買ポータルサイトyOASIS簡易説明書 b 購買ポータルサイト yoasis 簡易説明書横河電機株式会社本書は購買ポータルサイト yoasis の簡易的な基本操作について記載してあります詳細な操作方法については別冊の購買ポータルサイト yoasis 操作説明書をご覧下さい本書の内容は性能 / 機能の向上などにより

変 更 履 歴 Biz メール SSO 連 携 サービス IF 仕 様 書 変 更 年 月 変 更 内 容 新 規 作 成 ii

変更履歴 Biz メール SSO 連携サービス IF 仕様書変更年月変更内容新規作成 ii