【企業管理者向け】SAML SSO設定ガイド

<tips>

• Microsoft Entra ID（旧名称：Azure Active Directory） を、SAML 2.0のIdentity Provider（以下、IdP）として、ラクスルにSSOを設定する方法を説明します。他IdP接続においても基本的な流れと設定は同じになります。
• SCIM（同期的にユーザー認証情報をやり取りするためのプロトコル/プロビショニング）には対応しておらず、ラクスル上でのグループ異動やアカウント削除には対応していません。
• ご利用にあたり、別途Microsoft Entra ID側で追加費用が発生する場合があります。詳細についてはMicrosoft Entra IDご提供元にご確認ください。

</tips>

<toc>

Step1:ラクスル側の設定

<warn>

ラクスルのSSOは、すべての企業/ユーザーが利用できるサービスではありません。

ご利用には事前にラクスルの専任担当者へ申請をお願いします。

※SSOの設定は「企業管理者」権限を持つユーザーのみ可能です。

</warn>

手順

1. ラクスル 企業マイページにログイン（https://enterprise-app.raksul.com/）
2. 画面右側メニューの [ 企業設定 > 設定変更] をクリックする

3. [ SAML SSO認証 > 編集 ]をクリックする

   

4. SAML SSOの設定画面が開きます
5. SAML SSO 有効化にチェック。詳細設定画面が開きます

6. 設定画面中程に、IdPに登録する情報（Service Providerの情報）が表示されます

   

7. メタデータファイルをダウンロードして、ここで一度、Microsoft Entra ID側の設定に進みます。

   （※ Microsoft Entra ID側の設定で、Service Providerの情報が必要になるので、画面は閉じずに作業を進めます。）

Step2:Microsoft Entra ID側の設定

※括弧内[　]の名称はMicrosoft Entra内の名称となります。

手順

1. Microsoft Entra IDにログイン
2. メニューから[エンタープライズ アプリ]をクリック
3. アプリケーション一覧の画面が開くので、[+ 新しいアプリケーション]をクリック
4. アプリケーションの検索をする画面[Microsoft Entra IDギャラリーの参照]が開く
5. 上部にある[+ 独自のアプリケーションの作成]をクリック

6. [独自のアプリケーションの作成]画面が表示されるので、必要事項を入力していきます。

   項目	入力内容
   お使いのアプリの名前は何ですか?	一覧に表示されるので、任意の名前を入力　 例：「ラクスル」「raksul」
   アプリケーションでどのような操作を行いたいですか?	[ギャラリーに見つからないその他の・・・]を選択する。

7. 入力画面右下にある[作成]をクリック
8. しばらく待つと、⑦で入力した名称が記載された[概要]画面が開く
9. [2.シングルサインオンの設定]ボタンにある、[作業の開始]をクリック
10. [シングルサインオン方式の選択]に移動するので、[SAML]をクリック
11. [1 基本的なSAML構成]の右上にある[編集]をクリック

12. [基本的なSAML構成]の詳細を入力する画面が、右側に開く

    

13. [識別子の追加][応答URL]をクリックし、入力フォームを開く

14. ラクスルのSSO設定の画面上にService Provider情報が表示されているため、EntityIDとACS URLを転記します

    表示項目	ラクスルに表示されている内容
    識別子 (エンティティ ID)	EntitiyID
    応答 URL (Assertion Consumer Service URL)	ACS URL

15. [保存]をクリックし、[SAMLベースのサインオン]に戻る
16. [2. 属性とクレーム]の右上にある[編集]をクリック
17. [一意のユーザー識別子 (名前 ID)]をクリック

18. 名前識別子の形式：電子メールアドレス、ソース属性：user.mail に設定

    項目	入力/選択内容
    名前識別子の形式	電子メールアドレス
    ソース	属性
    ソース属性	user.mail

    ※貴社にて、メールアドレスとして管理している項目を、NameIDとemailaddressクレームに設定してください

19. [保存]をクリックし、[SAMLベースのサインオン]に戻る
20. [3.SAML署名証明書]の欄にある[フェデレーション メタデータ XML]からダウンロードをクリック
21. [概要]のページに戻り、[1.ユーザーとグループの割り当て]をクリック
22. [ユーザーとグループ]が表示されます。
23. [ユーザーまたはグループの追加]をクリックし、ユーザーを追加 ※「ユーザーの種類」は「メンバー」と設定してください。
24. 以上で、Microsoft Entra ID設定は完了です。

Step3:ラクスル側の設定

手順

1. ラクスルのSAML SSO設定画面に戻ります

   

2. [IdPメタデータの設定]に、先ほど作成したメタデータをファイル選択で選びます

3. その他の必要な項目を設定します

   <tips>

   a:ログイン方法を選択。※初期は "パスワードも許可" を推奨いたします。

   b:ログインセッション有効期間を入力。（例: 24）

   ※6時間以上で設定可能です。半角数字のみ可能。

   c:基本情報（会社名フリガナ・都道府県・電話番号・従業員数・業種）を入力。

   ※ SSO経由で新規ユーザーがラクスル登録した場合、新規アカウント作成画面にて自動入力される事項を設定できます。

   d:グループの設定で SSO ユーザーのデフォルト所属グループを選択。

   ※ SSO経由で新規ユーザーがラクスル登録した場合、新規アカウント作成画面にて自動入力される事項を設定できます。

   e:SAML SSOによる新規ユーザー参加時にメール通知を受け取るユーザーを選択する

   ※SAML SSO経由で新規ユーザーがエンタープライズへ参加した場合メール通知を受け取ることが可能です。

   （通知メールの詳細についてはこちら）

   </tips>

4. 画面下部の 保存する をクリック。
5. 画面左下に[SAML SSOの設定が完了しました]と表示されます。最大 1 分後 に設定が有効化されるのを待ちます
6. 以上で、Microsoft Entra IDをIdPとしたSAML設定は完了です

<テスト方法>

SAML設定後のログインテストは以下のSAML SSOログイン画面からお試しください。

https://raksul.com/account/saml_login

※IdP主導のログインはご利用いただけません。

<SAMLログインできない場合にお試しください>

SAML設定後のテストでログインが正常に行えない場合は、以下の点をご確認ください。多くの場合、設定情報やブラウザ環境に原因があります。

• 設定の一時的な無効化と再有効化
  • 一度SAML設定を無効にし、再度有効にすることで問題が解決することがあります。
• 各URLとIDの確認
  • エンティティID: IdPとSP（ラクスル）で完全に一致していますか？
  • ACS URL: IdPに設定したURLは、SPが指定したものと正確に一致していますか？
  • URLの末尾のスラッシュ / の有無なども含め、完全に一致しているかご確認ください。
• ユーザー情報の確認
  • ユーザーの存在: ログインしようとしているユーザーは、IdPに存在し、有効な状態になっていますか？
• ブラウザのキャッシュとCookieのクリア
  • ブラウザのキャッシュとCookieをすべて削除してから、再度ログインをお試しください。
• シークレットモード（プライベートブラウジング）で試す
  • ブラウザの拡張機能などが影響していないか確認するため、シークレットモードでログインできるかお試しください。
• 別のブラウザで試す
  • 普段お使いのブラウザとは別のブラウザ（Chrome, Firefox, Edgeなど）でログインできるかご確認ください。

<項目別の詳細説明と推奨設定>

<その他よくある質問>

SAML SSOに関するよくある質問はこちらをご確認ください。