楽楽精算で「SSLクライアント認証オプション」をご利用の場合、旧URL(通常の「楽楽精算」URL)の閉鎖が完了している状態でないと、新URL(SSLクライアント認証専用の「楽楽精算」URL)でのシングルサインオンは行うことができません。
本記事では、OneLoginから楽楽精算へのSAML シングルサインオン(SSO)の設定手順をご案内します。
目次
前提条件
- OneLoginのライセンスが Starter, Enterprise, Unlimited または SSO, Advanced, Professional(新料金体系)のいずれかであること
- OneLoginの Super User または Account Owner 権限を持つアカウントを所有していること
- 楽楽精算における 管理者権限 をお持ちであること
SAML連携の設定
1. OneLogin側の操作
- OneLoginに管理者でログインし、[管理]をクリックします
-
Applications メニューから[Applications]を選択します
- [Add App]をクリックします
-
楽楽精算 と検索し、該当コネクタを選択します
- [Save]をクリックします
-
SSO タブに移動し、SAML 2.0 Endpoint (HTTP) をクリップボードへコピーします
-
View Details をクリックします
- [Download]をクリックします
2. 楽楽精算側の設定
- 楽楽精算に管理者としてログインし、アドレスバーから サブドメイン と アカウントID をクリップボードへコピーします
例)URLがhttps://etude2.rakurakuseisan.jp/D0zEurE3mDa/sapTopPage/mainViewの場合、サブドメイン:etude2, アカウントID:D0zEurE3mDaをクリップボードへコピーします
-
管理 タブに移動します
-
システム設定 を選択します
-
セキュリティ タブの シングルサインオン で 有効にする を選択します
-
1. OneLogin側の操作 で取得した情報を設定します
楽楽精算の項目 OneLoginの項目 IDプロバイダーのログインURL 手順6でコピーした SAML2.0 Endpoint (HTTP) IDプロバイダーのログアウトURL https://<subdomain>.onelogin.com/portal IDプロバイダーの証明書 手順8でダウンロードした onelogin.pem -
関連付け で [方式1] IDプロバイダーの任意の属性と、本システムの社員コードを関連付ける を選択します
- [✓ 確定]をクリックします
3. OneLogin側の設定
-
Configuration タブに移動し、サブドメイン と アカウントID に 2. 楽楽精算側の設定 手順1でコピーした値を貼り付けます
-
SSO タブに移動し、SAML Signature Algorithm を SHA-256 に変更します
-
Access タブに移動し、割り当てたいユーザーが属するロールを選択後、[Save]をクリックします
SAML連携の設定は以上です。
ユーザー識別子のパラメータ設定
*OneLoginの旧ライセンス Starter, Enterprise, Unlimited プランをご利用場合は、【旧ライセンス】お客様のパラメータの設定 を参照ください。
- 楽楽精算に管理者でログインし、管理 タブに移動します
-
社員マスタ を選択します
- [CSV出力]をクリックし、メンバーの情報が入ったCSVを出力します
- 読み込んだCSVファイルの 社員コード をクリップボードへコピーします
- OneLogin管理ポータルの Users メニューから[Custom User Fields]を選択します
- [New User Field]をクリックします
-
Name と Shortname を入力し、[Save]をクリックします
例)Name: 社員コード, Shortname: employee_code
- ユーザーフィールドが追加されることを確認します
-
Users メニューから[Users]を選択します
- More Actions > Import users を選択します
- [CSVテンプレートをダウンロードする]をクリックします
- 以下のCSVファイルがダウンロードされますので、username、phone、company、department、group、role、password、title、status、deleteの列を消去します
- 必要な列は以下の通りです
-
firstname、lastname、emailに楽楽精算で登録されているユーザーの情報を入力します
また、custom_attribute_1 を custom_attribute_{Shortname} に書き換え、手順4でコピーした社員コードを貼り付けます
{Shortname} とは、手順7のCustom User FieldsのShortnameで入力した値です
入力が完了後、CSVファイルを保存します
- Import usersに戻り、[Upload File]から手順14で保存したCSVファイルをアップロードし、[import]をクリックします
CSVファイルをインポートすることで楽楽精算に登録されているユーザーの社員コードを一括で設定することができます
- 社員コードが入力されているか確認するため、[Users] > [Users]から社員コードを入力したユーザーをクリックします
- User info > Custom Fieldsから社員コードが入力されていることを確認します
-
Applications メニューから[Applications]を選択します
-
楽楽精算 と検索し、該当コネクタを選択します
-
Parameters タブに移動し、Name ID フィールドを選択します
-
Value から 社員コード(Custom) を選択します
- [Save]をクリックします
SAML SSOの動作確認
- OneLoginに対象ユーザーでログインし、設定した 楽楽精算 を選択します
- SAML認証が完了し、楽楽精算にSSOされることを確認します
*初回は、以下のようにパスワード設定が要求されます(管理者があらかじめ楽楽精算ユーザーのパスワードを設定した場合は、初回SSO時にパスワード設定を求められません)。
SAML SSOの動作確認は以上です。
SAML SSOの無効化
- OneLoginに管理者でログインし、 楽楽精算 をクリックします
-
管理 タブに移動し、システム設定 を選択します
-
セキュリティ タブの シングルサインオン で 無効にする を選択します
- [確定]をクリックします
SAML SSOの無効化は以上です。
旧ライセンスご契約者様のパラメータの設定
Unlimitedプランのお客様のパラメータの設定
*OneLoginのUnlimitedプランを契約しているお客様と、Starter、Enterpriseプランを契約しているお客様とで、ユーザー認証で用いるパラメータの設定方法が異なります。Unlimitedプランを契約しているお客様は、カスタムユーザーフィールドを使って楽楽精算用のパラメータを設定することが可能です。
- 楽楽精算に管理者でログインし、管理 タブに移動します
-
社員マスタ を選択します
- [CSV出力]をクリックし、メンバーの情報が入ったCSVを出力します
- 読み込んだCSVファイルの社員コードをコピーします
- OneLoginに戻り、[Users] > [Custom User Fields] を選択します
- [New User Field]をクリックします
-
Name と Shortname を入力し、[Save]をクリックします
例:Name 社員コード、Shortname employee_code
- ユーザーフィールドが追加されることを確認します
- [Users] > [Users] を選択します
- More Actions > Import users を選択します
- [CSVテンプレートをダウンロードする]をクリックし、CSVファイルをダウンロードします
- 以下のCSVファイルがダウンロードされますので、username、phone、company、department、group、role、password、title、status、deleteの列を消去します
- 必要な列は以下の通りです
- ここで、firstname、lastname、emailに楽楽精算で登録されているユーザーの情報を入力します
また、custom_attribute_1 を custom_attribute_{Shortname} に書き換え、手順4でコピーした社員コードを貼り付けます
{Shortname} とは、手順7のCustom User FieldsのShortnameで入力した値です
入力が完了後、CSVファイルを保存します
- Import usersに戻り、[Upload File] から手順14で保存したCSVファイルをアップロードし、[import]をクリックします
CSVファイルをインポートすることで楽楽精算に登録されているユーザーの社員コードを一括で設定することができます
- 社員コードが入力されているか確認するため、[Users] > [Users]から社員コードを入力したユーザーをクリックします
- User info > Custom Fieldsから社員コードが入力されていることを確認します
- [Applications] > [Applications] を選択します
-
楽楽精算 と検索し、該当コネクタを選択します
-
Parameters タブに移動し、Name ID フィールドを選択します
- Valueのプルダウンから 社員コード(Custom) を選択し、[Save]をクリックします
Unlimitedプランのパラメータの設定は以上です。
Starter、Enterpriseプランのお客様のパラメータの設定
*Starterプラン、Enterpriseプランを契約しているお客様は、カスタムユーザーフィールド 機能がご利用いただけないためUserタブからユーザー毎にName IDを設定する必要があります。
- Parametersタブから Value が No default であることを確認します
- Usersタブへ移動し、Name IDを設定するユーザーを選択します
-
Name IDに楽楽精算で登録されている社員コードを入力し、[Save]をクリックします