{"_id":"5d77ba7aa0432d00567b76f7","project":"55208137623ff50d009b2bec","version":{"_id":"55208137623ff50d009b2bef","__v":15,"project":"55208137623ff50d009b2bec","createdAt":"2015-04-05T00:26:31.564Z","releaseDate":"2015-04-05T00:26:31.563Z","categories":["55208138623ff50d009b2bf0","55494a226a82a10d00817ae5","55494ba7ee219b0d001743c8","55494bc1ee219b0d001743cc","56ead8c1df765617008bccaf","573a2073dd007d1700cf288f","579695b1f64c9f0e007cd76c","57969e3dfa1ff60e006a1274","579a4592fd9f3c0e008e4f4a","57ab9afe54fa780e006c5430","57b784f5b7ebd60e009cb4a6","58f686818193090f008cec76","59e79fbd4cf31900341d50c6","5b2436973fd93f0003dcf99d","5d824fb2ce98a801366098a2"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"57969e3dfa1ff60e006a1274","project":"55208137623ff50d009b2bec","version":"55208137623ff50d009b2bef","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-25T23:18:21.457Z","from_sync":false,"order":7,"slug":"slack-integration","title":"Integrations"},"user":"5cab7368183df802e83943c4","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-09-10T15:00:10.203Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":1,"body":"##Setting up OKTA for SSO with Sonar\n\nThese steps will allow you to use Okta for SSO with Sonar:\n\n1. In Okta, add the Sonar application from the Okta Integration Network:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/85e818a-Screen_Shot_2019-09-10_at_11.04.51_AM.png\",\n        \"Screen Shot 2019-09-10 at 11.04.51 AM.png\",\n        665,\n        220,\n        \"#ebeaeb\"\n      ],\n      \"sizing\": \"smart\"\n    }\n  ]\n}\n[/block]\n2. Set a label that is specific to the Sonar org (currently you will need separate Okta Sonar applications if you have multiple orgs within Sonar):\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/027a7d0-Screen_Shot_2019-09-10_at_11.08.10_AM.png\",\n        \"Screen Shot 2019-09-10 at 11.08.10 AM.png\",\n        626,\n        272,\n        \"#f8f8f8\"\n      ]\n    }\n  ]\n}\n[/block]\n3. Go to the Sign On tab. In the Settings section, copy the link URL for the link that says “Identity Provider metadata” and paste it where you can get it later:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/aa3589b-Screen_Shot_2019-09-10_at_11.09.50_AM.png\",\n        \"Screen Shot 2019-09-10 at 11.09.50 AM.png\",\n        796,\n        179,\n        \"#f2d215\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Next, go to the General tab. Scroll down to a section called App Embed Link. Copy the Embed Link there and paste it somewhere:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/cb6ee39-Screen_Shot_2019-09-10_at_11.10.29_AM.png\",\n        \"Screen Shot 2019-09-10 at 11.10.29 AM.png\",\n        810,\n        203,\n        \"#f7f7f7\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Send an email to ​contact:::at:::sendsonar.com​ indicating you’d like to activate SSO, and provide the metadata URL and embed link.\n\n6. We will email you with a custom ID. To input it, go to the Sign On tab. Click Edit in the Settings section. Enter your custom ID in the Custom ID field and save:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/25451fe-Screen_Shot_2019-09-10_at_11.11.50_AM.png\",\n        \"Screen Shot 2019-09-10 at 11.11.50 AM.png\",\n        803,\n        204,\n        \"#fafafa\"\n      ]\n    }\n  ]\n}\n[/block]\n7. You should now be configured for SSO! You can assign users to the app from the Assignments tab so that they can log in. There are 3 ways to login using SSO:\n\na) Go to your Okta home screen. You can click the Sonar link and you will be logged in:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a3753f6-Screen_Shot_2019-09-10_at_11.14.04_AM.png\",\n        \"Screen Shot 2019-09-10 at 11.14.04 AM.png\",\n        763,\n        313,\n        \"#2083b9\"\n      ]\n    }\n  ]\n}\n[/block]\nb) Go to ​https://www.sendsonar.com/login/your-custom-id​. You will be redirected to Okta to login.\n\nc) Login in through the regular Sonar login page. This will also redirect you to the Okta login for authentication. (We can also continue to support the non-SSO Sonar login if desired).","excerpt":"","slug":"okta-sso-setup","type":"basic","title":"OKTA SSO Setup"}
##Setting up OKTA for SSO with Sonar These steps will allow you to use Okta for SSO with Sonar: 1. In Okta, add the Sonar application from the Okta Integration Network: [block:image] { "images": [ { "image": [ "https://files.readme.io/85e818a-Screen_Shot_2019-09-10_at_11.04.51_AM.png", "Screen Shot 2019-09-10 at 11.04.51 AM.png", 665, 220, "#ebeaeb" ], "sizing": "smart" } ] } [/block] 2. Set a label that is specific to the Sonar org (currently you will need separate Okta Sonar applications if you have multiple orgs within Sonar): [block:image] { "images": [ { "image": [ "https://files.readme.io/027a7d0-Screen_Shot_2019-09-10_at_11.08.10_AM.png", "Screen Shot 2019-09-10 at 11.08.10 AM.png", 626, 272, "#f8f8f8" ] } ] } [/block] 3. Go to the Sign On tab. In the Settings section, copy the link URL for the link that says “Identity Provider metadata” and paste it where you can get it later: [block:image] { "images": [ { "image": [ "https://files.readme.io/aa3589b-Screen_Shot_2019-09-10_at_11.09.50_AM.png", "Screen Shot 2019-09-10 at 11.09.50 AM.png", 796, 179, "#f2d215" ] } ] } [/block] 4. Next, go to the General tab. Scroll down to a section called App Embed Link. Copy the Embed Link there and paste it somewhere: [block:image] { "images": [ { "image": [ "https://files.readme.io/cb6ee39-Screen_Shot_2019-09-10_at_11.10.29_AM.png", "Screen Shot 2019-09-10 at 11.10.29 AM.png", 810, 203, "#f7f7f7" ] } ] } [/block] 5. Send an email to ​contact@sendsonar.com​ indicating you’d like to activate SSO, and provide the metadata URL and embed link. 6. We will email you with a custom ID. To input it, go to the Sign On tab. Click Edit in the Settings section. Enter your custom ID in the Custom ID field and save: [block:image] { "images": [ { "image": [ "https://files.readme.io/25451fe-Screen_Shot_2019-09-10_at_11.11.50_AM.png", "Screen Shot 2019-09-10 at 11.11.50 AM.png", 803, 204, "#fafafa" ] } ] } [/block] 7. You should now be configured for SSO! You can assign users to the app from the Assignments tab so that they can log in. There are 3 ways to login using SSO: a) Go to your Okta home screen. You can click the Sonar link and you will be logged in: [block:image] { "images": [ { "image": [ "https://files.readme.io/a3753f6-Screen_Shot_2019-09-10_at_11.14.04_AM.png", "Screen Shot 2019-09-10 at 11.14.04 AM.png", 763, 313, "#2083b9" ] } ] } [/block] b) Go to ​https://www.sendsonar.com/login/your-custom-id​. You will be redirected to Okta to login. c) Login in through the regular Sonar login page. This will also redirect you to the Okta login for authentication. (We can also continue to support the non-SSO Sonar login if desired).