Skip to content

Conversation

@Combs7th
Copy link
Contributor

@Combs7th Combs7th commented Dec 18, 2025

Document new SAML provider type identification and Enterprise Search in Support Packets for Mattermost v11.2.

Relates to engineering PR #34378 & 34377

Fixes #8571

🤖 Generated with Claude Code

Document new SAML provider type identification feature in Support Packets for Mattermost v11.1.1+. This enhancement helps administrators quickly identify SAML Identity Provider types and provides diagnostic context for troubleshooting authentication issues.

- Added SAML provider type identification section
- Documented enhanced authentication diagnostics
- Explained troubleshooting workflow improvements
- Listed benefits for support teams and administrators

Relates to engineering PR #34378

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com>
@Combs7th
Copy link
Contributor Author

@cpoile @vish9812 - Does the above docs update look accurate to you?

@github-actions
Copy link

Newest code from mattermost has been published to preview environment for Git SHA c4fdf46

@github-actions
Copy link

Newest code from mattermost has been published to preview environment for Git SHA 9701de0

@cwarnermm cwarnermm changed the title Docs: Add SAML provider type documentation for Support Packets Docs: Add SAML provider type & Enterprise search documentation for Support Packets Dec 19, 2025
@github-actions
Copy link

Newest code from mattermost has been published to preview environment for Git SHA 8554814

@cwarnermm cwarnermm added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor Guidance labels Dec 19, 2025
@cwarnermm cwarnermm removed the 2: Editor Review Requires review by an editor label Dec 19, 2025
@cpoile cpoile requested review from hanzei and removed request for cpoile January 5, 2026 15:31
@cpoile
Copy link
Member

cpoile commented Jan 5, 2026

@hanzei I think you worked on this, correct?

@github-actions
Copy link

github-actions bot commented Jan 6, 2026

Newest code from mattermost has been published to preview environment for Git SHA 324414b

Comment on lines 98 to 106
Enterprise search
~~~~~~~~~~~~~~~~~~

From Mattermost v11.2, the Support Packet ``diagnostics.yaml`` file includes connection testing for configured :doc:`enterprise search engines </administration-guide/scale/enterprise-search>`, including both :doc:`Elasticsearch </administration-guide/scale/elasticsearch-setup>` and :doc:`AWS OpenSearch </administration-guide/scale/opensearch-setup>`. Any connection errors encountered during testing are included to help diagnose enterprise search configuration issues.

SAML provider type
~~~~~~~~~~~~~~~~~~~

From Mattermost v11.2, the Support Packet ``diagnostics.yaml`` file includes SAML provider details to help administrators and support teams quickly identify the SAML Identity Provider (IdP) in use and provides additional diagnostic context for troubleshooting authentication issues. When SAML SSO is configured, SAML details include provider type, provider-specific diagnostic information to accelerate troubleshooting of SAML authentication flows, and relevant metadata about the SAML provider to help identify common configuration patterns and potential issues.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I appreciate that you documented by changes. Though, I wonder if we really need to document these fields. diagnostics.yaml doesn't have a detailed, per-field documentation and I'm not sure it needs one.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @hanzei. I agree with your feedback and have updated this section in my latest commit.

@github-actions
Copy link

github-actions bot commented Jan 6, 2026

Newest code from mattermost has been published to preview environment for Git SHA 8d97053

@github-actions
Copy link

github-actions bot commented Jan 6, 2026

Newest code from mattermost has been published to preview environment for Git SHA 3b81258

@cwarnermm cwarnermm requested a review from hanzei January 6, 2026 14:38
@github-actions
Copy link

github-actions bot commented Jan 6, 2026

Newest code from mattermost has been published to preview environment for Git SHA 32d30f6

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1: Dev Review Requires review by a core commiter Guidance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support Packet changes: SAML provider type added

5 participants