Skip to content

Added new documentation page to show users how to export a HAR file#998

Merged
ProgrammerAL merged 10 commits intomainfrom
ar/how-to-har
Jan 28, 2026
Merged

Added new documentation page to show users how to export a HAR file#998
ProgrammerAL merged 10 commits intomainfrom
ar/how-to-har

Conversation

@ProgrammerAL
Copy link
Copy Markdown
Contributor

@ProgrammerAL ProgrammerAL commented Jan 27, 2026

  • Created a new page to show users how to export a HAR file
  • It's in the Troubleshooting section, which is different from https://github.com/DuendeSoftware/customer-success/issues/430 suggesting we use Diagnostics section. I thought Troubleshooting would be better, but we can move it to Diagnostics if we decide that's better.

@ProgrammerAL ProgrammerAL self-assigned this Jan 27, 2026
@ProgrammerAL ProgrammerAL added the documentation Improvements or additions to documentation label Jan 27, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds comprehensive documentation for exporting HAR (HTTP Archive) files, a critical troubleshooting tool for diagnosing network-related issues. The documentation guides users through the process of generating HAR files across multiple browsers and includes important security considerations.

Changes:

  • Created new documentation page explaining HAR files and their use in diagnostics
  • Added browser-specific instructions for Chrome, Safari, Firefox, and Microsoft Edge
  • Included guidance on handling sensitive data and sanitizing HAR files

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/content/docs/identityserver/troubleshooting/export-har-files.md Outdated
Comment thread src/content/docs/identityserver/troubleshooting/export-har-files.md Outdated
ProgrammerAL and others added 2 commits January 27, 2026 11:05
…export-har-files.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…export-har-files.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Comment thread src/content/docs/identityserver/troubleshooting/export-har-files.md Outdated
Comment thread src/content/docs/identityserver/troubleshooting/export-har-files.md Outdated
@khalidabuhakmeh
Copy link
Copy Markdown
Contributor

Could you add a section telling Duende IdentityServer customers some common scenarios that HAR helps resolve? This might be something @AndersAbel and @wcabus can give some background on.

Copy link
Copy Markdown
Member

@maartenba maartenba left a comment

Choose a reason for hiding this comment

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

Couple of small suggestions for your consideration

Comment thread src/content/docs/identityserver/troubleshooting/export-har-files.md Outdated
Comment thread src/content/docs/identityserver/troubleshooting/export-har-files.md Outdated
…es.md

Co-authored-by: Khalid Abuhakmeh <khalid.abuhakmeh@duendesoftware.com>
@wcabus
Copy link
Copy Markdown
Member

wcabus commented Jan 27, 2026

Could you add a section telling Duende IdentityServer customers some common scenarios that HAR helps resolve? This might be something @AndersAbel and @wcabus can give some background on.

One particular one would be cookies not flowing to BFF/IdentityServer when they have incorrect SameSite settings. Which immediately is a good use case of including cookies but removing their sensitive data, although most browsers will automatically remove all cookie information when exporting a HAR file by default.

The most recent example where a HAR file helps, is to see the flow between the client application, Duende IdentityServer and external IdPs when these are involved.

ProgrammerAL and others added 6 commits January 27, 2026 11:17
…es.md

Co-authored-by: Khalid Abuhakmeh <khalid.abuhakmeh@duendesoftware.com>
…es.md

Co-authored-by: Maarten Balliauw <maarten.balliauw@duendesoftware.com>
…es.md

Co-authored-by: Maarten Balliauw <maarten.balliauw@duendesoftware.com>
…p. Added the suggested section at the top "When To Use A HAR File". Added a new section towards the bottom, "Viewing A HAR File"
@ProgrammerAL
Copy link
Copy Markdown
Contributor Author

Updated the PR. Got in the formatting suggestions everyone mentioned. Reworded the caution tip at the top. Added the suggested section at the top "When To Use A HAR File". Also decided to add a new section towards the bottom, "Viewing A HAR File"

Copy link
Copy Markdown
Contributor

@khalidabuhakmeh khalidabuhakmeh left a comment

Choose a reason for hiding this comment

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

Looks better.

@maartenba
Copy link
Copy Markdown
Member

Agreed, looking good. Feel free to merge at will!

@ProgrammerAL ProgrammerAL merged commit 896d5ce into main Jan 28, 2026
5 of 6 checks passed
@ProgrammerAL ProgrammerAL deleted the ar/how-to-har branch January 28, 2026 13:28
@maartenba maartenba added this to the 2026-Q1 milestone Apr 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants