{"id":965,"date":"2026-03-18T08:00:00","date_gmt":"2026-03-17T23:00:00","guid":{"rendered":"https:\/\/support.learningbox.online\/?post_type=how-to-use&p=965"},"modified":"2026-04-02T15:09:05","modified_gmt":"2026-04-02T06:09:05","slug":"cooperation-with-external-systems","status":"publish","type":"how-to-use","link":"https:\/\/support.learningbox.online\/en\/how-to-use\/cooperation-with-external-systems\/","title":{"rendered":"External system integration"},"content":{"rendered":"

You can integrate with external systems using four methods: SAML, SCIM, Custom SSO, and LDAP.

To get started, select Site customizer<\/b> from the side menu, click Basic settings<\/b>, and open the Basic information<\/b> tab.
Select System integration<\/b> tab on the Basic settings<\/b>.<\/p>\n\n\n\n

*Note that we cannot assist with issues arising from your use of Site customizer. For details on potential issues, click\u00a0here<\/a>.<\/p>\n\n\n\n

\n

Required<\/span><\/p>\n\n\n\n

Customization option, Site customizer, Management role of Co-admin<\/p>\n<\/div>\n\n\n\n

SAML<\/span><\/h2>\n\n\n\n

If you want to use SAML, turn on the toggle key of SAML.
*For all settings, make sure to click Save<\/b> at the bottom right of the screen before finishing.<\/p>\n\n\n\n

Introduction<\/span><\/h4>\n\n\n\n

Regarding the use of SAML, refer to\u00a0Single sign-on SAML protcol<\/a>.<\/p>\n\n\n\n

SAML integration with Microsoft Entra ID:<\/span><\/h4>\n\n\n\n

You can use SAML authentication with Microsoft Entra ID.
*For more details, refer to SAML integration settings in Microsoft Entra ID<\/a>.<\/p>\n\n\n\n

Advanced settings<\/span><\/h3>\n\n\n\n

01. Automatically register account upon successful SAML authentication<\/span><\/strong><\/p>\n\n\n\n

When you succeed in SAML authentication with an account that does not exist on learningBOX and try to register it as a new account, turn on the toggle key.<\/p>\n\n\n\n

02. Include Requested Authn Context Attribute<\/span><\/strong><\/p>\n\n\n\n

Turn the toggle off if you want to support Microsoft 365.<\/p>\n\n\n\n

03. SAML advanced settings<\/span><\/strong><\/p>\n\n\n\n

Register your IdP information.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

04. SAML parameter mapping<\/span><\/strong><\/p>\n\n\n\n

Configure which parameter values to apply to the login ID, name, and email address respectively.
Enter them directly, or click Add<\/b> to open the Add Fixed Parameter Tag<\/b> screen and select from the dropdown menu.<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n
\u2003<\/span>Important<\/span><\/span><\/div>
\n

 Input field settings<\/a>If you choose not to use \"Login ID\" in \"Login ID\", a random string will be applied to this \"Login ID\".<\/p>\n<\/div><\/div>\n\n\n\n

SP (learningBOX) configuration information<\/span><\/h3>\n\n\n\n

The information required to register learningBOX as an SP with your IdP is listed.
Enter this information into your IdP.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

SCIM<\/span><\/h2>\n\n\n\n

SCIM provisioning with Microsoft Entra ID:<\/span><\/h4>\n\n\n\n

You can use SCIM synchronization with Microsoft Entra ID.
*For more details, refer to SCIM provisioning with Microsoft Entra ID<\/a>.<\/p>\n\n\n\n

SCIM settings<\/span><\/h3>\n\n\n\n
\"\"<\/figure>\n\n\n\n

*For all settings, make sure to click Save<\/b> at the bottom right of the screen before finishing.<\/p>\n\n\n\n

01. Enable SCIM provisioning<\/span><\/strong><\/p>\n\n\n\n

If you want to use SCIM provisioning, tick Enable SCIM provisioning<\/b>.<\/p>\n\n\n\n

02. Invitation email<\/span><\/strong><\/p>\n\n\n\n

You can choose whether to send an invitation email when registering new users to learningBOX through IdP synchronization.
If you choose to send them, also select an email template from the dropdown menu.
*If you choose not to send them, passwords will not be generated.<\/p>\n\n\n\n

03. Sync active attribute and user status in learningBOX<\/span><\/strong><\/p>\n\n\n\n

You can sync the active attribute on the IdP side with the user status in learningBOX.
Check Sync<\/b> if you want to sync them.
Select Invalid<\/b> or Temporarily suspended<\/b> for the user status when the active attribute is invalid.
*Admin in learningBOX is excluded from the sync of the user status.
\u3000For more information about user status, refer to  Add user<\/a>.<\/p>\n\n\n\n

04. Action on learningBOX when users are deactivated via SCIM<\/span><\/strong><\/p>\n\n\n\n

When a user is deleted on the IdP side, the status of the corresponding user in learningBOX automatically changes to Invalid<\/b>.<\/p>\n\n\n\n

\u2003<\/span>Important<\/span><\/span><\/div>
\n

Depending on the IdP, the above action may occur when user information is permanently deleted.
If it is not permanently deleted, the action configured in 03. Sync active attribute and User status in learningBOX<\/b> may be applied instead.<\/p>\n<\/div><\/div>\n\n\n\n

05. Sync group information<\/span><\/strong><\/p>\n\n\n\n

You can sync the group hierarchy configured on the IdP side with the information of users belonging to that group hierarchy.
Tick Enable SCIM provisioning to sync.
You can also select whether Archive group<\/b> or Delete group<\/b> when a group is deleted via SCIM.<\/p>\n\n\n\n

\u2003<\/span>Important<\/span><\/span><\/div>
\n

If you untick synchronization after linking groups, you will not be able to delete SCIM-linked groups or remove users from SCIM-linked groups on the learningBOX side.
If you need to perform deletions or other changes, tick Enable SCIM provisioning<\/b> and modify the group settings on the IdP side.<\/p>\n<\/div><\/div>\n\n\n\n

06. Mapping<\/span><\/strong><\/p>\n\n\n\n

Synchronization becomes possible by mapping field keys in learningBOX with SCIM attributes on the IdP side.<\/p>\n\n\n\n

\u25bc Field Keys<\/strong>
Field keys used on the learningBOX side will be displayed.
These can be edited or added under Input field settings<\/a>.<\/p>\n\n\n\n

\u25bcSCIM attributes<\/strong>
Select the SCIM attribute to correspond with each field key in learningBOX from the dropdown menu.
Leave items unselected if synchronization is not required.
*Even if a field key is set to Unchangeable<\/b>, mapped items will still be updated during synchronization.<\/p>\n\n\n\n

Base URL\/Access token<\/span><\/h3>\n\n\n\n
\"\"<\/figure>\n\n\n\n

You can check Service Provider information and issue tokens.<\/p>\n\n\n\n

01. Base URL<\/span><\/strong><\/p>\n\n\n\n

You can copy the Service Provider information to register in your IdP.<\/p>\n\n\n\n

02. Access token<\/span><\/strong><\/p>\n\n\n\n

You can issue a token to register in your IdP.
*If already in use, reissuing it will require you to re-register the token on the IdP side.<\/p>\n\n\n\n

Sync history<\/span><\/h3>\n\n\n\n

The SCIM synchronization history will be displayed.
You can review history from the past year.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

01. Search<\/span><\/strong><\/p>\n\n\n\n

You can filter by the following items:<\/p>\n\n\n\n