Important Update Effective February 1, 2024!
Due to recent changes in Jira and Confluence, we've made the tough decision to discontinue the OpenID Connect (OIDC)/OAuth app and no longer provide new versions for the newest Jira/Confluence releases as of January 31, 2024.
This is due to some necessary components no longer shipping with Jira/Confluence, which would require some extensive rewrites of the OIDC App.
Important Update! This app will be discontinued soon!
Due to recent changes in Jira, which no longer ships with some components required for our Read Receipts app to run, we've made the tough decision to discontinue the app, as of Februar 5, 2025.
Important Update! This app will be discontinued soon!
We've made the tough business decision to discontinue the app, as of January 11, 2025.
Retrieve and Upload Config via API
Problem
We are looking for a REST API endpoint to import the SAML config json file in to our Atlassian SSO.
Solution
This article refers to our plugin version SAML Single Sign On 4.x. If you are using an older version, you need to disable the plugin and enable it again, after deleting a configuration via API (see below).
You can use the REST API of the SAML SSO app which allows you to download and upload the SAML Single Sign-On configuration.
Please note that this is our private API, there might be breaking changes in upcoming versions. Please contact our support, if something does not work as expected anymore.
GET
Use the following example to download the configuration.
curl -u username:password -X GET https://base-url/rest/samlsso-admin/1.0/config --output saml.json
Open the saml.json file and verify that the file contains data.
DELETE
You could also delete existing configurations with the call below, i.e. for a simple test of importing a configuration again.
The SAML SSO configuration menu should then not show any identity provider config anymore.
curl -u username:password -X DELETE https://base-url/rest/samlsso-admin/1.0/config
Please open Jira Administration > Manage apps > SAML Single Sign-On > Configure and you should see the welcome wizard screen which you can close.
In the app configuration, you will also see the info that no IdP is configured.
PUT
Now it is time to put the configuration back to the system.
curl -u username:password -X PUT https://base-url/rest/samlsso-admin/1.0/config -d @saml.json --header "Content-Type: application/json"
Verify, that the correct configuration has been imported correctly