> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Configure SAML

> Configure SAML integration for single sign-on.

### Retrieve your organization's SAML settings

Go to **Settings > Security** and locate the SAML section.

Copy and save the **SAML entity ID** and **SAML reply URL**. You will enter these values in your IdP's SSO configuration screen.

<img src="https://mintcdn.com/admina-sbn/BjdC6TkH07eWqFjx/images/it-management/sni7chcawy/1781246426268-2026-06-12-15-39-48.png?fit=max&auto=format&n=BjdC6TkH07eWqFjx&q=85&s=77e57cdc4feae67b0a2ff782ee369f36" alt="SAML settings screen" width="1920" height="1174" data-path="images/it-management/sni7chcawy/1781246426268-2026-06-12-15-39-48.png" />

#### Retrieve SAML metadata from your Identity Provider

You first need to create an SSO app. The steps vary depending on your **Identity Provider (IdP)**.

#### Microsoft Entra ID (Azure AD)

1. Select Enterprise Applications.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639290964705-screen-shot-2021-03-09-at-18-14-38.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=67c9f5ce0b859410709a4b8a58c1c633" alt="Select Enterprise Application" width="1610" height="905" data-path="images/it-management/sni7chcawy/1639290964705-screen-shot-2021-03-09-at-18-14-38.png" />

2. Click **New Application**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639290978630-screen-shot-2021-03-09-at-18-15-18.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=1fcbdf2d28f63a1a73baf28fcd694d25" alt="New Application" width="1610" height="915" data-path="images/it-management/sni7chcawy/1639290978630-screen-shot-2021-03-09-at-18-15-18.png" />

3. Enter a name for your application (for example: `service name`).
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291010851-screen-shot-2021-03-09-at-18-24-01.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=563b10c14c6436cc0adf6c18bbbbf3d1" alt="Set app name" width="1610" height="912" data-path="images/it-management/sni7chcawy/1639291010851-screen-shot-2021-03-09-at-18-24-01.png" />

4. Click **Create** and wait a moment.
   When the app screen appears, select **Single sign-on > SAML**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291026350-screen-shot-2021-03-09-at-18-27-08.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=e07a87fb7323746dde756242e973c2be" alt="Select SAML" width="1610" height="914" data-path="images/it-management/sni7chcawy/1639291026350-screen-shot-2021-03-09-at-18-27-08.png" />

5. Enter the following values.

   | Field                      | Value                                                 |
   | -------------------------- | ----------------------------------------------------- |
   | **Identifier (Entity ID)** | The `SAML entity ID` shown on our SSO settings screen |
   | **Reply URL**              | The `SAML reply URL` shown on our SSO settings screen |
   | **Unique User ID**         | Change from `user.principalname` to `user.mail`       |

   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1684825330232-image.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=bc2e9098bc3fe6d139fa241039f2484f" alt="Enter settings" width="2534" height="1650" data-path="images/it-management/sni7chcawy/1684825330232-image.png" />

6. After saving, copy the **App Federation Metadata URL**.
   Paste the copied URL into the `SAML metadata URL` field and save.
   Azure AD SAML configuration is now complete. Next, [enable SAML](/en/it-management/settings/sni7chcawy-saml#enable-saml).

#### Google Workspace

1. Sign in to the GWS Admin Console and go to **Apps > Web and mobile apps**. Select **Add Custom SAML App** from the Add app menu.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1712132370560-image.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=c34af6351ab45324ff3f24fd290027f5" alt="Add Custom SAML App" width="2394" height="1286" data-path="images/it-management/sni7chcawy/1712132370560-image.png" />

2. Enter an application name and click **CONTINUE**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1712132287469-image.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=6836288a69b993eb43a1a0df2f2d0dd8" alt="Set app name" width="1050" height="687" data-path="images/it-management/sni7chcawy/1712132287469-image.png" />

3. Click **DOWNLOAD METADATA** and save the metadata file.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1712132537529-image.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=db7ddd38061d893b414f626037cc6582" alt="Download metadata" width="1996" height="1644" data-path="images/it-management/sni7chcawy/1712132537529-image.png" />

4. Enter the values you copied into **ACS URL** and **Entity ID**, then click **Continue**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1712132528718-image.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=6f9432fa7a371d2210fb4cff94d9f52a" alt="Enter ACS URL and Entity ID" width="1911" height="896" data-path="images/it-management/sni7chcawy/1712132528718-image.png" />

5. On the next screen, click **FINISH** without entering anything.
   Your SAML application is now created.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1712136414619-image.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=b4b2047432c5afb72b6b1153f0b76b79" alt="Complete" width="1904" height="660" data-path="images/it-management/sni7chcawy/1712136414619-image.png" />

#### Okta

<Info>
  Okta Integration Network (OIN) is now supported, making setup much easier. Follow the steps at the link below: [SAML/SCIM setup with Okta Integration Network](/en/it-management/settings/wllb3ml0pq-oin)
</Info>

1. Go to the Okta Admin Console and click the button to add an application.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291080251-screen-shot-2021-04-28-at-9-51-10.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=4b0cd460bc642fa6867ef00cf4087612" alt="Add application" width="1610" height="867" data-path="images/it-management/sni7chcawy/1639291080251-screen-shot-2021-04-28-at-9-51-10.png" />

2. Click the button to create a new application.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291097797-screen-shot-2021-04-28-at-9-51-53.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=1f52fa643263d3b3ee7c98d4cd4147b1" alt="Create new application" width="1610" height="865" data-path="images/it-management/sni7chcawy/1639291097797-screen-shot-2021-04-28-at-9-51-53.png" />

3. Set **Platform** to `Web`, select `SAML 2.0` as the **Sign on method**, and click **Create**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291140719-screen-shot-2021-04-28-at-9-53-05.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=84a78d35f8b77545d18b9936af2f85dc" alt="Select SAML 2.0" width="1610" height="865" data-path="images/it-management/sni7chcawy/1639291140719-screen-shot-2021-04-28-at-9-53-05.png" />

4. Enter an application name (for example: `service name`) and proceed to the next screen.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291175142-screen-shot-2021-04-28-at-9-54-24.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=f68f7b792893ec5d4cffe0b7efa38c63" alt="Enter app name" width="1610" height="867" data-path="images/it-management/sni7chcawy/1639291175142-screen-shot-2021-04-28-at-9-54-24.png" />

5. Enter the SAML settings and proceed to the next screen.
   **Single sign on URL**: enter the `SAML reply URL` shown earlier.
   **Audience URI**: enter the `SAML entity ID` shown earlier.
   **Name ID format**: select `EmailAddress`.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291216556-screencapture-i-moneyforward-admin-okta-admin-apps-saml-wizard-create-2021-04-28-10-03-05.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=14b9178b7e081ccf290dccf87053e944" alt="Enter SAML settings" width="1610" height="2463" data-path="images/it-management/sni7chcawy/1639291216556-screencapture-i-moneyforward-admin-okta-admin-apps-saml-wizard-create-2021-04-28-10-03-05.png" />

6. On the next screen, click the **`Identity Provider metadata`** link.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291248777-screen-shot-2021-04-28-at-10-17-17.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=b6f16210c9aa888515dc0303d97bef89" alt="Identity Provider metadata" width="1610" height="894" data-path="images/it-management/sni7chcawy/1639291248777-screen-shot-2021-04-28-at-10-17-17.png" />

7. The XML file opens in a new tab.
   Copy that URL and enter it into the `SAML metadata URL` field.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291262919-screen-shot-2021-04-28-at-10-18-16.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=53431d554a76e88127e784098b450cc0" alt="Enter SAML metadata URL" width="1610" height="984" data-path="images/it-management/sni7chcawy/1639291262919-screen-shot-2021-04-28-at-10-18-16.png" />

8. Okta SAML configuration is now complete. Next, [enable SAML](/en/it-management/settings/sni7chcawy-saml#enable-saml).

#### OneLogin

1. In the OneLogin Admin Console, click the button to add an app.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291300434-screen-shot-2021-04-28-at-18-16-31.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=cb6898fb74f10a9f231606e49e334e04" alt="Add app" width="1610" height="942" data-path="images/it-management/sni7chcawy/1639291300434-screen-shot-2021-04-28-at-18-16-31.png" />

2. Search for `SCIM` and select **SCIM Provisioner with SAML (SCIM v2 Core)**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291325435-screen-shot-2021-04-28-at-18-17-58.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=92e91bc24698146952cbf52452e31a2c" alt="Select SCIM Provisioner" width="1610" height="942" data-path="images/it-management/sni7chcawy/1639291325435-screen-shot-2021-04-28-at-18-17-58.png" />

3. Enter an application name and save (for example: `company name`).
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291356665-screen-shot-2021-04-28-at-18-18-45.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=6348e6d31d22ed3f0276fe29463c1b8a" alt="Save app name" width="1610" height="944" data-path="images/it-management/sni7chcawy/1639291356665-screen-shot-2021-04-28-at-18-18-45.png" />

4. Open the **Configuration** tab, enter the following values, and save.
   **SAML Audience URL**: enter the `SAML entity ID` value.
   **SAML Consumer URL**: enter the `SAML reply URL` value.
   **SCIM Base URL**: enter a placeholder URL for now — you will configure this later on the SCIM settings page.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291384402-screen-shot-2021-04-28-at-18-30-01.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=bc0210f5e23a198e81f75e8d006a4980" alt="Configuration settings" width="1610" height="942" data-path="images/it-management/sni7chcawy/1639291384402-screen-shot-2021-04-28-at-18-30-01.png" />

5. Select the **SSO** tab and copy the **Issuer URL**.
   Paste it into the `SAML metadata URL` field and save.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1639291401905-screen-shot-2021-04-28-at-18-31-12.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=0c2079a23bd75505e0eb2bb19634f934" alt="SSO settings" width="1610" height="941" data-path="images/it-management/sni7chcawy/1639291401905-screen-shot-2021-04-28-at-18-31-12.png" />

6. OneLogin SAML configuration is now complete. Next, [enable SAML](/en/it-management/settings/sni7chcawy-saml#enable-saml).

#### HENNGE One

For SAML integration with HENNGE One, contact the HENNGE support center.

After completing the setup, follow the steps below to enable SAML.

<h4 id="enable-saml">
  Enable SAML
</h4>

Set the SAML metadata URL you obtained in the previous step.

1. For Google Workspace, select a file and upload the metadata file.
   The screenshots below show how to configure using a URL.
   <img src="https://mintcdn.com/admina-sbn/BjdC6TkH07eWqFjx/images/it-management/sni7chcawy/1781246456779-2026-06-12-15-40-14.png?fit=max&auto=format&n=BjdC6TkH07eWqFjx&q=85&s=85ddc41521f0261c3df5f1d5609875bc" alt="Set SAML metadata URL" width="1744" height="1008" data-path="images/it-management/sni7chcawy/1781246456779-2026-06-12-15-40-14.png" />
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1744876958618-2025-04-17-17-01-50.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=595be04d81482a213b1969d1febbdb65" alt="Set SAML metadata URL 2" width="656" height="380" data-path="images/it-management/sni7chcawy/1744876958618-2025-04-17-17-01-50.png" />

2. Turn on the SAML enable switch.
   <img src="https://mintcdn.com/admina-sbn/BjdC6TkH07eWqFjx/images/it-management/sni7chcawy/1781246512135-2026-06-12-15-41-44.png?fit=max&auto=format&n=BjdC6TkH07eWqFjx&q=85&s=2952737038bbbe3d5653f992db5765aa" alt="Enable SAML" width="1812" height="1118" data-path="images/it-management/sni7chcawy/1781246512135-2026-06-12-15-41-44.png" />
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1744877268725-2025-04-17-17-07-36.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=726a852f5e72753ff490757fe2845697" alt="Enable SAML 2" width="924" height="532" data-path="images/it-management/sni7chcawy/1744877268725-2025-04-17-17-07-36.png" />

3. SAML-based SSO setup is now complete.
   Assign users in each SaaS application and verify that single sign-on works.
   Next, configure SCIM for user provisioning.
   [How to Configure SCIM](/en/it-management/settings/msu9u84kyh-scim)

#### Update SAML settings

Go to **Settings > Security** and locate the SAML section.

Before your SAML certificate expires, issue a new certificate in your IdP and update the SAML metadata URL.

1. Click **Edit** next to SAML metadata.
   <img src="https://mintcdn.com/admina-sbn/BjdC6TkH07eWqFjx/images/it-management/sni7chcawy/1781247079905-2026-06-12-15-51-02.png?fit=max&auto=format&n=BjdC6TkH07eWqFjx&q=85&s=44ac1322439c52bccf7de1d46a1ef056" alt="Edit SAML" width="1818" height="1044" data-path="images/it-management/sni7chcawy/1781247079905-2026-06-12-15-51-02.png" />

2. Before changing the SAML metadata URL, note down the current URL as a backup.
   Enter the new SAML metadata URL and click **Save**.
   <img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1744877689396-2025-04-17-17-09-46.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=74aba563d3681637e4ed32d4ff367903" alt="Change SAML metadata URL" width="650" height="374" data-path="images/it-management/sni7chcawy/1744877689396-2025-04-17-17-09-46.png" />

#### For Admin users

Users with the Admin role follow a slightly different login flow. This prevents Admin users from being locked out if the SAML configuration fails.

We also recommend [requiring multi-factor authentication (MFA) at sign-in](/en/it-management/settings/lqb4m5d1tj-login-method-2fa).

For users with the Admin role:

1. When signing in from the login screen, the user logs in directly using their MoneyForward ID. The IdP does not receive a redirect.

2. When signing in from the IdP login UI, the IdP Initiated Flow (sign in via SSO) is used.

<img src="https://mintcdn.com/admina-sbn/ngvxymYsn9y2nuZz/images/it-management/sni7chcawy/1756363494077-2025-08-28-15-36-17.png?fit=max&auto=format&n=ngvxymYsn9y2nuZz&q=85&s=bde1d014e67a98fca60ddb698aacf55a" alt="Admin login flow" width="2318" height="904" data-path="images/it-management/sni7chcawy/1756363494077-2025-08-28-15-36-17.png" />

#### FAQ

#### Q. I am an Admin, but I cannot sign in with my MoneyForward ID on the login screen.

What should I check if the password reset email does not arrive?

A. If you do not have a MoneyForward ID, you need to create one. See [**If you do not have a MoneyForward ID**](/en/it-management/tutorial/93a9bikaqq-user#no-moneyforward-id) for details.

If the email does not arrive, see [If you cannot receive emails](https://biz.moneyforward.com/support/guide/a010.html#wrapper).

#### Q. After configuring SAML, how do I sign in with the Admin role?

A. The login method depends on where you initiate the sign-in. To prevent lockout if the SAML configuration fails, the following behavior applies.

**Signing in from the login screen**: You log in directly using your MoneyForward ID.

**Signing in from the IdP login UI**: The IdP Initiated Flow (sign in via SSO) is used.
