Troubleshooting

Jupyter Viewer for Confluence Cloud: page-attached notebooks do not render; Atlassian authorization error

Problem

Page-attached notebooks do not render within the Insert/Edit macro browser preview window or in-page. Instead, an “Atlassian authorization” error is displayed.

There are two known causes of this erroneous behavior:

• Missing space permissions for the app

• IP allowlisting is enabled

Solutions

Space permission

The app does not have permission to the Confluence Space containing the notebook attachment.

To resolve, following the Permission Configuration settings in the Installation guide.

Allowlisting

IP “Allowlisting” (a “Premium” feature) is enabled in the Confluence Cloud security settings.

To resolve, either:

• Disable this Confluence Cloud feature for the site

• Whitelist the IP range used by Jupyter Viewer

  • The app uses the Heroku platform in the European zone, so the IP used may be from anywhere in the AWS European range. The latest AWS IP ranges can be programmatically queried by following the AWS guide.

Is it possible to define an external Jupyter renderer for IPython Notebook Viewer for Confluence?

It is not possible to define an external renderer. The rendering happens with JavaScript on the client for the cloud and server app.