Overview
This page describes the steps to configure Single Sign-on (SSO) login to Josys using SmartHR.
Configuring the Integration
Creating a Custom App
- Log in to SmartHR.
- Click "IdP" from the menu.
-
Click
+ID連携アプリ追加(Add ID Integration App). - Select "カスタムアプリ(SAML)" (Custom App (SAML)) and click "追加" (Add) in the bottom right.
- Click "編集" (Edit) in the usage settings.
- Change the app name to your preferred name and click the "更新" (Update) button in the bottom right. Example: Josys
- Switch to the SSO settings tab.
Configuring SAML Settings
- Click the "編集" (Edit) button for SAML authentication settings.
- Open Josys and click Settings > Single Sign-on.
- Click the "Configure SSO" button.
- Since "Okta" is selected by default on the Josys side, select "Others (SAML 2.0 IdPs only)".
- Copy the ACS URL and Entity ID, and paste them into SmartHR.
SmartHR Entity ID: Entity ID
SmartHR ACS URL: ACS URL - Leave other fields at their default values.
- Click the "更新" (Update) button in the bottom right.
- Register the information displayed on the right side of the screen into Josys.
Set any preferred name for the External ID (IdP) Name.
When copying and pasting from the screen, copy the following items from SmartHR and configure them in Josys:
Josys IdP Login URL: SSO URL
Josys IdP Entity ID: Entity ID
Josys Certificate: Certificate - In SmartHR, configure the settings for the employees who will use SSO.
Official Documentation: https://support.smarthr.jp/ja/help/articles/2b84d949-fa50-4bb2-b66a-07524cb30f49/
Testing the Integration
Josys Admin Console
- Open Josys and click Settings > Single Sign-on.
- Click "Test Connection".
- The setup is complete once the SAML connection test results are displayed.
Josys Employee Portal
- In the Josys admin screen, click "Settings > Employee Portal" in the left sidebar.
- Click the Single Sign-on tab.
- Click the three-dot menu (...) and select "Test Connection".
- The setup is complete once the test results are displayed.