13-01.シングルサインオン

シングルサインオン（ダイレクトリンク）とは、URLにIDやパスワード、遷移先の画面IDなどを埋め込むことで、 E-learningASPの受講者サイトの各画面に「ログインをせずに」ダイレクトに遷移すること ができる仕組みです。この仕組みを利用することにより、すでにログイン機能を有するサイトから ログインなしで講座の受講を行う等、外部システムとの連携がよりスムーズになり受講者の利便性が 向上します。

13-01-1.事前の設定

管理サイトログイン＞サイトTOP（E-learning）＞メニュー（基本設定）＞ASP基本情報設定

シングルサインオン機能を利用する場合、E-learningASPの場合ASP基本設定において 「シングルサインオンを利用する」にチェックをしてください。 また、E-learningASPを利用していない場合にシングルサインオンで遷移することはできません。 契約しているモジュールを再度確認してください。

さらに、シングルサインオンのハッシュ値を暗号化する際に利用する暗号化キーをメモしてください。

シングルサインオンURLの「暗号化情報」の暗号化に初期ベクトルを利用する場合は、下記にチェックを入れ、任意の初期ベクトル英数小文字16文字を入力下さい。
※「暗号化情報」については以降に記載しております。

13-01-2.URLフォーマット

シングルサインオンURLのフォーマットは以下の通りです。

13-01-3.暗号化情報

1.暗号化前の値

暗号化情報は以下の文字列をAES128で暗号化し、URLエンコーディングをしたものになります。

解説

【会社ID】・・会社ID
【画面ID】・・遷移先の画面ID。詳細は次章参照。
【受講者ログインID】・・ログインする受講者のID※メールアドレスか独自のログインID(※注１)
【受講者パスワード】・・ログインする受講者のパスワード(※注１)
【オプション情報】・・各画面ごとに指定できる、または指定が必須な項目。詳細は次章参照。
【有効期限】・・シングルサインオンURLの有効期限。この有効期限を過ぎると当該URLは利用できなくなります。半角数字16桁 (YYYYMMDDHHIISS) 。設定しなければ無期限になります。

(※注１)　+ / などの文字が含まれる場合
ログインIDやパスワードには、URLに利用される+や/といった文字が含まれることがあります。それらをそのまま挿入すると、シングルサインオンURLが正常に生成できないため、ログインIDやパスワードは必ずURLエンコードするように注意してください。

参考

kaisha_id=OMIYA&user_login_id=test@test.com&password=pass0123!&course_id=C0000001&lecture_id=01&page=mplay&limit=20170701120100

2.暗号化

AES128での暗号化のためには、まずは暗号化キーが必要になります。事前に取得した暗号化キーをもとに、以下のサイトなどを活用して先ほどの暗号化前の値をAES128暗号化してください。
（https://encode-decode.com/aes128-encrypt-online/）

【参考　講義視聴ページへ遷移するための暗号化情報】

・暗号化前

kaisha_id=OMIYA&userid=test@test.com&password=pass0123!&course_id=C0000001&lecture_id=01&page=play&limit=20170701120100

・暗号化後（キー：yu5vogzbbftk2dfr）

12e33v4rG3Momp45RPBzElr63lcxrfYhx03o4HqHBtQEUpJkwEKiyTHJY6mH8gq9vY+YyQkL3YDtloeEdAnSD0jYeozB4F2fimSPKgqpx9Zwzmbk9kBZtfrz+EfATZeqIkEc27O5jK3GPl1cW0+nENwKICAdBwSs2WV/TqUXUaw=

3.URLエンコード

作成したハッシュに「/」などのURLで作成する文字がふくまれると、そのままハッシュをURL化してもうまく動作しません。そこで、こちらのサイトなどで作成したハッシュをURLエンコードして、それをご利用ください。

・URLエンコード前

12e33v4rG3Momp45RPBzElr63lcxrfYhx03o4HqHBtQEUpJkwEKiyTHJY6mH8gq9vY+YyQkL3YDtloeEdAnSD0jYeozB4F2fimSPKgqpx9Zwzmbk9kBZtfrz+EfATZeqIkEc27O5jK3GPl1cW0+nENwKICAdBwSs2WV/TqUXUaw=

・URLエンコード後

12e33v4rG3Momp45RPBzElr63lcxrfYhx03o4HqHBtQEUpJkwEKiyTHJY6mH8gq9vY%2bYyQkL3YDtloeEdAnSD0jYeozB4F2fimSPKgqpx9Zwzmbk9kBZtfrz%2bEfATZeqIkEc27O5jK3GPl1cW0%2bnENwKICAdBwSs2WV%2fTqUXUaw%3d

13-01-4.オプション情報

オプション情報の一覧を以下に記載します。オプション情報は暗号化情報の中に含めます。複数のオプション情報を利用する場合、「＆」で値をつなげてください
※オプションは、すべての画面で利用できるわけではありません。画面IDと利用できるオプションの種類については次章をご覧ください。

13-01-5.画面ID

シングルサインオンで利用できる画面IDとオプションを表にしました。暗号化情報を作成する際にご利用ください。