Document fix for `Something went wrong with embedded authentication. Check the dev console for details.`

[ambroiseRabier]

Related to: #925

Env

Brand new Ulmo installation with Aspects plugin. tutor local and HTTPS to true.

The error

In LMS embedded dashboard: Something went wrong with embedded authentication. Check the dev console for details.

The fix

name: superset-fix
version: "0.1.0"
patches:
  openedx-common-settings: |
    import os
    os.environ["OAUTHLIB_INSECURE_TRANSPORT"] = "1"
    SUPERSET_CONFIG["internal_service_url"] = "http://superset:8088"

The issue

In the github issue that was closed, linked above, it is mentioned at the end that everything is documented in https://docs.openedx.org/projects/openedx-aspects/en/latest/technical_documentation/how-tos/troubleshooting_aspects.html (oct 2025).

Implying that the plugin above, which is derived from above issue, is either documented or unnecessary.
However I was only able to make embedded dashboard work only with the help of the plugin, everything else failed.

Proposal

I believe it should be documented in docs.openedx.org, and be added in this repository Readme install instructions. If not integrated by default in source code.

Disclamer

As someone new to Open edX... I do have to wonder if I am the only one having encountered this issue in the past 5 months (=Installed Aspects on latest Open edX). Or if I missed something in the install instructions. Or if I have an environment which differ from what most operators have?

[saraburns1]

Hi @ambroiseRabier! Welcome to the community! Thanks so much for bringing this up. This issue only appears in certain environments so it isn't super common, but definitely something that should be documented clearer.

Most development questions are actually brought up in https://discuss.openedx.org/ instead of Github since it's easier to categorize and posts reach a wider audience which encourages community involvement. Feel free to poke around that site and we'd love if you introduced yourself. If you run into any other issues, feel free to post here!

[bmtcril]

@ambroiseRabier I've created a PR to update the docs to include more information about the potential issues that can cause this and the patch. I can link to it from the README here once it lands. Do you think this is sufficient or is there more that would have helped you?

[bmtcril]

The rendered version of the document in the PR is here:

https://docsopenedxorg--341.org.readthedocs.build/projects/openedx-aspects/en/341/technical_documentation/how-tos/aspects_troubleshooting.html

[bmtcril]

The docs changed, I'm going to wait to close this until I can get a minute to update README as well.

[ambroiseRabier]

It is great that you have added documentation on it, as suggested I have started a discussion here: https://discuss.openedx.org/t/github-issue-document-fix-for-something-went-wrong-with-embedded-authentication-check-the-dev-console-for-details/18533/4

Things have evolved a bit, the "fix" that I mentioned is not necessary in prod with HTTPS, it is my mistake.

However, on my PC, with a tutor local instance, with HTTPS disabled. The "fix" is needed for embedded dashboard to show. I verified again just in case.

[bmtcril]

That's great to know, thank you!