準備中です / Coming soon

What should I do if "failed_to_update_sso_setting" is displayed on the Single Sign-On settings screen?

2023-06-30 15:54:16 UTC 2026-10-21 01:29:42 UTC

The issue may be caused by settings on Teachme Biz.

Please check whether settings such as the Metadata endpoint URL and metadata file are correct here.

Re-configuring the Metadata endpoint URL or metadata file

If the certificate has been updated on the IdP side, the following steps are required to have Teachme Biz recognize the updated information.

For Metadata endpoint URL

If the IdP allows you to register multiple certificates, you can avoid reconfiguration by enabling both the old and new certificates at the same time.
If you cannot register the old certificate, please follow the steps below.

If the Metadata endpoint URL remains unchanged

  1. Click "Re-fetch" next to the Metadata endpoint URL field
  2. The process is complete when "Metadata re-fetched successfully." is displayed

* "Re-fetch" retrieves the metadata again from the saved Metadata endpoint URL. "Re-fetch" cannot be clicked while the URL field is being edited.

If you click "Re-fetch" and "Failed to re-fetch metadata." is displayed

Metadata could not be retrieved from the saved Metadata endpoint URL. Please check the following.

  • Whether there are any errors in the Metadata endpoint URL
  • Whether the Metadata endpoint URL is publicly accessible on the IdP side (whether metadata can be retrieved by accessing the URL)

If the Metadata endpoint URL changes

  1. Enter URL the new URL in the Metadata endpoint URL field
  2. Click "Save"

When you change the URL and save, the metadata will be automatically retrieved from the new URL. There is no need to click "Re-fetch".

For metadata file

Please follow the steps below.

▼Re-upload Metadata Following SAML Certificate Renewal (Web Browser Version)
https://teachme.jp/8/manuals/46456708

If the error persists after checking the settings

Please Contact our support team at support@teachme.jp with the Message displayed and a screenshot of the entire settings screen.

Related: Configure single sign-on (SSO) (Web Browser)
https://teachme.jp/8/manuals/11468504


Asking the chatbot a question