ナレッジベース
公開されました Jun. 30, 2025

SAML Authentication Error: "This message decoder only supports the HTTP POST method

written-by

Anushka Tiwari

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Issue

The following SAML errors appear in the Liferay logs:

ERROR [http-nio-8080-exec-5][BaseSamlStrutsAction:53] org.opensaml.messaging.decoder.MessageDecodingException: This message decoder only supports the HTTP POST method
com.liferay.saml.runtime.SamlException: org.opensaml.messaging.decoder.MessageDecodingException: This message decoder only supports the HTTP POST method

Environment

  • Liferay DXP 7.4

Resolution

When using Liferay as the Service Provider (SP), this error indicates a mismatch in the HTTP method used for SAML communication between the SP and the Identity Provider (IdP). Liferay expects the SAML message through an HTTP POST binding, but receiving an alternative method (such as GET or REDIRECT) causes this error string. Follow these steps:

  1. Verify IdP Configuration: Ensure the IdP is configured to send SAML messages using the HTTP POST binding.
  2. Check Network Restrictions: Confirm that no network restrictions, such as firewalls or proxy settings between the SP and the IdP, alter or block communication methods.
  3. Confirm Artifact Resolution Support: The SAML 2.0 plugin in Liferay DXP does not support Artifact resolution. If the IdP requires it, this error occurs. Adjust the IdP configuration to use POST binding.

Additional Information

did-this-article-resolve-your-issue

ナレッジベース