> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/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/moneyforwardi/ybY5W9Y5KYWA_DUD/images/it-management/sni7chcawy/1781246426268-2026-06-12-15-39-48.png?fit=max&auto=format&n=ybY5W9Y5KYWA_DUD&q=85&s=05211548467585b403bfc57f6db67d04" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639290964705-screen-shot-2021-03-09-at-18-14-38.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=cef713638ab5abbb7f8d2e664d813af5" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639290978630-screen-shot-2021-03-09-at-18-15-18.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=96f2ad2dadeb317b1137905c4223d044" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291010851-screen-shot-2021-03-09-at-18-24-01.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=3b0882bb0d3aecc472c2a92c85d8cecc" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291026350-screen-shot-2021-03-09-at-18-27-08.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=948bf4d4bc063535bd6fabbb1702e878" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1684825330232-image.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=a9adf0914923553e1ef044cae544b48d" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1712132370560-image.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=84502d3c2348e8e499e383b5854483fb" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1712132287469-image.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=0e62cdeeaf2678bfe874fd8583d0cf60" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1712132537529-image.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=c4802876190ecc814cf7d74137dd559b" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1712132528718-image.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=fa65685c835ceed1a775872fc0d31b18" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1712136414619-image.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=6297ba7d254fad1d299f57f85f788a6e" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291080251-screen-shot-2021-04-28-at-9-51-10.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=fc2614befc60c26f91c1ea99615a07a4" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291097797-screen-shot-2021-04-28-at-9-51-53.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=a1223d85241485821aa4f60c49b5789a" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291140719-screen-shot-2021-04-28-at-9-53-05.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=f89728fbdea27c6f5d480caea175d919" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291175142-screen-shot-2021-04-28-at-9-54-24.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=b4977aec9257b389c6c795aeea7fed37" 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/moneyforwardi/ymUB0snpc69tjdrT/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=ymUB0snpc69tjdrT&q=85&s=2c81df1531ba904cc39f469158b0dc7c" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291248777-screen-shot-2021-04-28-at-10-17-17.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=583440ff5a6edfad7e698cb10aa43f75" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291262919-screen-shot-2021-04-28-at-10-18-16.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=5c34acfceb64e8e38760c5ae706c7442" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291300434-screen-shot-2021-04-28-at-18-16-31.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=dd9d1263288a4504918d1d446e1564b9" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291325435-screen-shot-2021-04-28-at-18-17-58.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=ad12f32b20730d17a9a81ac16ecf6ec6" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291356665-screen-shot-2021-04-28-at-18-18-45.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=3675f3f7d8bf392d8b046c95de96e996" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291384402-screen-shot-2021-04-28-at-18-30-01.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=a3df76b9e605fe73e3c07faef21ea975" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1639291401905-screen-shot-2021-04-28-at-18-31-12.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=4d4275ee6b75f688ea10252eca4abbe2" 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/moneyforwardi/ybY5W9Y5KYWA_DUD/images/it-management/sni7chcawy/1781246456779-2026-06-12-15-40-14.png?fit=max&auto=format&n=ybY5W9Y5KYWA_DUD&q=85&s=fa407f25c9c32bd53b504b0a7205e1e1" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1744876958618-2025-04-17-17-01-50.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=dfd6f5e36cbac49af07327c60c202cbf" 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/moneyforwardi/ybY5W9Y5KYWA_DUD/images/it-management/sni7chcawy/1781246512135-2026-06-12-15-41-44.png?fit=max&auto=format&n=ybY5W9Y5KYWA_DUD&q=85&s=9b7db1ad0295b5171625fe7f3721832d" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1744877268725-2025-04-17-17-07-36.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=c641513af3d2531e2ca7c2287aa22d77" 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/moneyforwardi/ybY5W9Y5KYWA_DUD/images/it-management/sni7chcawy/1781247079905-2026-06-12-15-51-02.png?fit=max&auto=format&n=ybY5W9Y5KYWA_DUD&q=85&s=a5da7370dd0f248ace9b7d36059cfe58" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1744877689396-2025-04-17-17-09-46.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=13ea431f04edcdbed6c4214323737e1e" 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/moneyforwardi/ymUB0snpc69tjdrT/images/it-management/sni7chcawy/1756363494077-2025-08-28-15-36-17.png?fit=max&auto=format&n=ymUB0snpc69tjdrT&q=85&s=da45162fc162d697a369435c1f2c0aee" 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.
