Ask the Community
Groups
How do I set up Okta Integration to Kaseya - Connect IT Community | Kaseya
<main> <article class="userContent"> <p><strong>QUESTION</strong></p> <p>How do I set up Okta Integration to Kaseya?</p> <p><strong><br>RESOLUTION</strong></p> <h3 data-id="okta-configuration"><strong>Okta Configuration</strong></h3> <ol><li> <p>Sign into Okta> Admin>Applications</p> </li> <li> <p>Add Application> search “Kaseya” > Add<br><img src="/attachments/token/bxDpi8o97iDTaTPJJjb2vngTm/?name=1.png" alt="1.png" width="1102" height="535" class="embedImage-img importedEmbed-img"></img></p> </li> <li>For “Kaseya Host” enter the domain name that your Kaseya server is on. This will be the domain portion of the URL you would normally go to, to log into your Kaseya Server.<br><img src="/attachments/token/ArYkjsSIwrU6HPwtVz2oCPIFx/?name=2.png" alt="2.png" width="1029" height="604" class="embedImage-img importedEmbed-img"></img></li> <li>Click “Next”</li> <li> <p>Assign people to the application, Click Next<br><img src="/attachments/token/Y3z5kn4ldRGVJmMwoU8HFnXtS/?name=3.png" alt="3.png" width="1048" height="632" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Click Done</li> <li> <p>Select “Sign On” at the top menu<br><img src="/attachments/token/lQegU3afGQ76lz29Z9Ksk2ujq/?name=4.png" alt="4.png" width="988" height="496" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Select “Edit” in the Settings area<br><img src="/attachments/token/392kodLTXDkiRiKLSPLprbEac/?name=5.png" alt="5.png" width="1028" height="583" class="embedImage-img importedEmbed-img"></img> </li> <li> <p>Add the “Default Relay State” as “<a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2F%5Bkaseyahost%5D%2Fvsapres%2Fweb20%2Fcore%2Fssologin.aspx">http://[kaseyahost]/vsapres/web20/core/ssologin.aspx</a>”</p> </li> <li> <p>Click the “View Setup Instructions” button</p> </li> <li> <p>On the window that opens, scroll down until you see the “x.509 Certificate” area and click the link to download the Certificate in *.cert format.<br><img src="/attachments/token/4SvFUiO5BX2KqhRlRYNxilF5S/?name=6.png" alt="6.png" width="1005" height="374" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Open the folder where the Certificate downloaded to, and rename the extension from “cert” to “cer”.<br><img src="/attachments/token/MnJNzmHrQIRH7xwQW7KXMonjR/?name=7.png" alt="7.png" width="842" height="459" class="embedImage-img importedEmbed-img"></img></li> <li>Close the Window</li> <li> <p>Click Save.</p> </li> <li> <p>The default “Credential Details” are configured to use the “Okta Username” which pertains to the Email address. As long as the email address exists in Kaseya as the Username for the user, the Okta integration will function.</p> <p> </p> </li> </ol><h3 data-id="steps-for-kaseya-configuration"><strong>Steps for Kaseya Configuration:</strong></h3> <ol><li> <p>Log into Kaseya with a user that has Master Role</p> </li> <li> <p>Browse to AuthAnvil > Two Factor Auth > Configure Kaseya Logon</p> </li> <li>Under the Kaseya Two Factor Auth Settings settings > AuthAnvil SAS URL enter <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Flocalhost%2FAuthAnvil%2Fsas.asmx">https://localhost/AuthAnvil/sas.asmx</a><br>Site ID: 1<br><strong>Note</strong>: You will receive a warning message "SAS URL is set to localhost and will not be verified. Use this for SSO only configurations." this is expected as you are not using AuthAnvil for 2FA as well.<br><img src="https://us.v-cdn.net/6032361/uploads/migrated/9TB10Q6GKONP/mceclip0.png" alt="mceclip0.png" width="629" height="101" class="embedImage-img importedEmbed-img"></img></li> <li> <p>In Kaseya Single sign-on area at the bottom, Upload the Certificate (*.cer file) that was downloaded from Okta.</p> </li> <li> <p>Set the Reply to URL to:</p> <ol><li> <p> (<a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2F%5Bsub-domain">https://[sub-domain</a> for the Kaseya server]/vsapres/web20/core/ssologin.aspx)</p> </li> </ol></li> <li> <p>Select the “Enable Sign Sign On to Kaseya” checkbox</p> </li> <li> <p>Save changes.<br><img src="/attachments/token/C3VaoqCqPZBrtgHM0QMKzanPP/?name=8.png" alt="8.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Test Single Sign-on from Okta.</li> </ol><div> <p> </p> <p> </p> <p> </p> <p> </p> </div> </article> </main>