microCMS
Documentation
  • Pricing
  • Blog
  • FAQ
  • Contact
  • Sign In
  • Get started for free
Navigation
Tutorial
Next.js
  • Integration with Next.js
  • Getting Started with App Router
  • Tutorial (App Router)
  • Getting Started with Pages Router
  • Tutorial (Pages Router)
Astro
  • Getting Started
  • Integration with Astro
  • Tutorial
Nuxt
  • Integration with Nuxt
  • Getting Started
  • Tutorial
Gatsby
  • Integration with Gatsby
  • Getting Started
  • Tutorial
JavaScript
  • Integration with JavaScript
  • Getting Started (Browser)
  • Getting Started (Server)
PHP
  • Integration with PHP
  • Getting Started
Ruby
  • Integration with Ruby
  • Getting Started
Go
  • Integration with Go
  • Getting Started with microCMS
Manual
  • Introduction
Account & Login
  • Account Registration
  • Login
  • Email Address Authentication
Services
  • Creating a Service
  • Service Configuration
  • Template
  • Service Deletion
Payment
  • Change of Pricing Plan
  • Registering and Changing Payment Methods
API
  • Creating and Managing APIs
  • API Settings
  • Export/Import of API Schema
Fields
  • Text Field
  • Text Area
  • Image
  • Multiple Images
  • Date
  • Boolean
  • Selectable Field
  • Content Reference
  • Multiple Content References
  • Number
  • File
  • Extended Field
  • Repetition
  • Custom
Contents
  • CSV Export of Content
  • Content Creation
  • Content Editing
  • Content Management
  • View
  • Content Status
  • Custom Status
  • Setting the Content ID
  • Automatically Assigned Values for Content
  • CSV Import of Content
  • API Preview
  • Examples of Using Query Parameters with API Preview
  • Integration Methods by Rendering Type
  • Screen Preview
  • Setting Up Webhooks for Content
Rich Editor
  • How to Use the Rich Editor
  • Rich Editor WRITE API
  • How to Use the Old Rich Editor
Reviews
  • Review
  • AI Review
Media
  • Media Management
  • Changing Media Filters and Display Order
  • Media Tag Configuration
  • Setting Up Media Webhooks
  • Custom Domain Settings for Media
Permission Management
  • Member Management
  • Roles (Permission Management in the Admin Panel)
Environments
  • Multiple Environments (Development Environment)
  • Merging API Settings Between Environments
Connection
  • Amazon S3 Integration
Logs
  • Audit Log
  • Data Transfer Volume
Security
  • Content Update History
  • IP Restrictions for Management Dashboard
  • IP Restrictions for APIs
Authentication
  • Setting Up Two-Factor Authentication
  • Mandatory Two-Factor Authentication
  • Single Sign-On
Specifications & Limitations
  • Recommended Environment
  • Limitations / Precautions
Content API
  • What is the Content API?
Basic Operations
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
API Keys
  • API Key (API Authentication and Authorization Management)
  • Migration from the Old API (X-API-KEY, etc.)
Responses & Error Handling
  • Response format for each field in the GET API
  • Specifying Query Parameters in the GET API
  • Error Responses of the Content API
Management API (Beta)
  • What is the Management API?
Content Operations
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
Media Operations
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
Member Operations
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API Operations
  • POST /api/v1/apis
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
Service Operations
  • GET /api/v1/service
Responses & Error Handling
  • Management API Error Responses
Image API
  • What is the Image API?
Parameters
  • Image Size
  • Quality
  • Resolution and Screen Size
  • Format
  • Text
  • Border
  • Padding
  • Shape
  • Download
  • Watermark
MCP Server
  • microCMS MCP
  • microCMS Document MCP Server
  • Top
  • Manual

Single Sign-On

Last updated: 2026/08/26

microCMS allows you to configure single sign-on using the SAML authentication method. You can utilize it to build an authentication flow tailored to your team's environment.

Information

Single Sign-On is a feature available with the Enterprise plan.
A free trial is also possible, so please contact us via the contact form if you are interested.
For information on the features available with each plan, please refer to the pricing page.

Verified IdPs

The following IdPs have been verified for operation:

  • Auth0
  • Microsoft Entra ID (formerly Azure AD)
  • Okta
  • GMO Trust Login

In principle, other IdPs should also work without issues.
If you encounter any problems with the IdP you are considering, please contact us via the chat section in the bottom right corner of the screen.

Notes

There are several constraints to consider when setting up. Please check the following items.

  • You cannot switch registered users from microCMS to single sign-on login midway.
  • Only SP-initiated SAML authentication is supported. IdP-initiated SAML authentication is not supported.
  • Depending on the IdP settings, it may be possible to log in just by knowing the login URL. This behavior depends on the IdP's configuration, so please thoroughly check and adjust the handling of URLs and the security settings of the IdP.
  • Depending on the IdP used, it may not be possible to link multiple applications created in the IdP with multiple services of microCMS on a one-to-one basis. If you are considering using multiple services, please conduct functionality tests during the free trial in advance.
// NG
microCMS Service A <--> IdP Application A
microCMS Service B <--> IdP Application B

// OK
microCMS Services A and B <--> IdP Application A

Integration Methods for Each IdP

For detailed integration methods for each IdP, please refer to the links below.

  • How to Integrate with Auth0
  • How to Integrate with GMO Trust Login

Setup Instructions

This document explains the general method for integrating IdP with microCMS using SAML.

1. Configure microCMS Information in IdP

Navigate to the service settings in the microCMS management screen > Security > SAML.

Information
  • Only users with an administrator role can make changes to the SAML settings.

Items that need to be configured on the IdP side will be displayed. Please set these values on the IdP side.

  • Service Provider Callback URL
  • Entity ID
  • Name ID Format
  • Attribute (email / name / picture)
Information

If the attribute mapping settings are not configured, the login process may not function correctly depending on the IdP.
If you have configured SAML but the login process is still not functioning properly, please check whether the attribute mapping is set with the correct values.

2. Set IdP Information in microCMS

Obtain the metadata information from the IdP settings page.
Please enter that information into microCMS in either URL or XML format.



The SSO configuration is now complete. Let's save it by clicking the "Save Changes" button.


3. Configure Behavior During SAML Login

You can set the roles assigned during SAML login and make SAML login mandatory.


4. Log In from the Login URL

Once the configuration is complete, please log in using the URL specified in the "Login URL".
If you can log in, the SAML configuration is complete.

Contents

  • Verified IdPs
  • Notes
  • Integration Methods for Each IdP
  • Setup Instructions
  • 1. Configure microCMS Information in IdP
  • 2. Set IdP Information in microCMS
  • 3. Configure Behavior During SAML Login
  • 4. Log In from the Login URL
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.