{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"How to set up SSO (single sign-on)","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","siteUrl":"https://docs.lusha.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"how-to-set-up-sso-single-sign-on","__idx":0},"children":["How to set up SSO (single sign-on)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha supports three SSO options: Google, Office 365, and SAML-based SSO via Okta or Azure. Admins and Managers on Scale plans can configure SAML SSO for their team. Google and Office 365 sign-in are available to all users."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a custom SAML 2.0 app built from scratch in Okta, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/security/okta-saml-20-setup-for-lusha-sso"},"children":["Okta SAML 2.0 setup article"]}," instead."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sign-up-with-google-or-office-365","__idx":1},"children":["Sign up with Google or Office 365"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"google","__idx":2},"children":["Google"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://auth.lusha.com/signup"},"children":["Lusha signup page"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue with Google"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your Gmail Business account from the pop-up."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13259825/e62c57e7f9bd5cd0f1be2076/Screen%2BShot%2B2022-12-14%2Bat%2B16_25_46.png?expires=1780056000&signature=a07e3ff16dc87bf20ae0513a4f968183aa80a4b8631cbadbe0c799939e7428ca&req=0dZtwFHyrjJk2hj99dpg6rfyIxlL9a7q%2BOQrFsOb8vG0vw1ONCj%2BTsH2N9SG%0ACylDEqbjfS46Tq0YXa27EWdg%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"office-365","__idx":3},"children":["Office 365"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://auth.lusha.com/signup"},"children":["Lusha signup page"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue with Office 365"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your Microsoft Office Business account."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: You can switch from Google/Office 365 to a password-based login at any time by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Forgot password"]}," — a reset link will be sent to your email address."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"set-up-okta-sso","__idx":4},"children":["Set up Okta SSO"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll need Lusha Admin or Manager permissions and Okta admin access to complete this setup."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-set-up-in-okta-performed-by-the-okta-admin","__idx":5},"children":["Step 1: Set up in Okta (performed by the Okta admin)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Okta, go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applications"]}," tab and add Lusha to your applications."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13259937/b1acfc30979a37c9afe79b32/image.png?expires=1780056000&signature=d5cfcce8872ec33d16b601529addace4c4d1083eab3912504e1b36f99b0123e2&req=0dZtwFHzrzBk2hj99dpg6rt9Zl9yQSTqrn%2Bk75U6m1Eky9MdSiGduYfVy7Qw%0AcHxmXBBTG1P4IiimrarClx2L%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign the team members who will use Lusha with Okta to the Lusha application."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13259980/42e1b057ba95378bdccab6b9/image.png?expires=1780056000&signature=f7b3c9af4c8190f78bdda9f9875dd7e9a082899260e4883abb3036a2c1c00472&req=0dZtwFHzpDdk2hj99dpg6kmE3gPUfB%2F1fIyyJSYSefhIBnE2A5rXRtI12GYx%0AWTLZyHTQNr3SdxymYRbq3Zj1%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-On"]}," tab and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View SAML setup instructions"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the IDP metadata XML."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260010/8b8512652f3ff1a549581dc2/Screen%2BShot%2B2022-10-25%2Bat%2B12_47_56.png?expires=1780056000&signature=9a2d7112beaf6c07e61433e8aab45985b346ea73532065d003bcb1a41344bc78&req=0dZtw1j6rTdk2hj99dpg6tlQf4yswWvON9VPjZKKhF%2BRcsP2CMMOd9adImuW%0AsowNgX5DjZAbia9LnC4ehGVv%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260033/4e0f861fc9be28b7ab0ef3a5/Screen%2BShot%2B2022-10-25%2Bat%2B12_50_19.png?expires=1780056000&signature=8fa794de28d9c29be0258b3632cd0b00062e63ff13bf25eaa0aaea17b549b8f0&req=0dZtw1j6rzRk2hj99dpg6mRugzjy7thkXTCECdtfD%2BfjGM7Hu0uyywynTMD9%0ApCxW0U8B39lbTf8xz4oWQyj3%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-configure-in-lusha","__idx":6},"children":["Step 2: Configure in Lusha"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/account/accountSettings"},"children":["Account Settings"]}]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste the XML metadata under the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Okta activation"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test SSO"]},". Lusha runs a real sign-in against the metadata you provided and only shows ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SSO test passed"]}," once it succeeds — nothing is enforced yet at this point."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once the test passes, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apply"]},"."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260067/9afcd03dd5c6939929e4fd8e/Screen%2BShot%2B2022-11-16%2Bat%2B13_13_51.png?expires=1780056000&signature=363819b6b29a6cbaaf1ed68d220945cec0cebeb0cb8f55d28a563b54a63419bc&req=0dZtw1j6qjBk2hj99dpg6hsZ%2FnwvSUDX8RMqu%2BmxilRv6Xr0HrHcUTdz2mh0%0Af0809NNYAeAi04m0%2B2DO%2FYoK%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your account is now integrated with Okta. Team members assigned in Okta will sign in via Okta only."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Users must already be part of your Lusha account before being assigned in Okta. After assigning, they can sign in via Okta or from Lusha's login page by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign in with SSO provider"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"set-up-azure-ad-sso","__idx":7},"children":["Set up Azure AD SSO"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll need Lusha Admin or Manager permissions and Azure admin access to complete this setup."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"part-1-add-lusha-in-azure","__idx":8},"children":["Part 1: Add Lusha in Azure"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign in to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://portal.azure.com"},"children":["Azure portal"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enterprise applications"]}," and add Lusha."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260086/6dd7fd0d3e9dbf44073e3423/Screen%2BShot%2B2022-12-20%2Bat%2B16_47_49.png?expires=1780056000&signature=bfcd9c1cc23d95bbed3826dc47189f34fab1f758ce8913424923c00dae672b97&req=0dZtw1j6pDFk2hj99dpg6oSCk9o08L%2F%2Fc5nXoEeUCU5%2BWZa8ole9KNjT4qOC%0ABGpiTPjjmdxTZsiEgGi8KWaZ%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for Lusha and click the Lusha URL in the results."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260096/771f5158726b573c15a76bfe/Screen%2BShot%2B2022-12-20%2Bat%2B16_51_14.png?expires=1780056000&signature=4ccf820a33afe3f5447c7dd7a7a0be56b09eadcf9810afebb55c9aaf5fda6a6c&req=0dZtw1j6pTFk2hj99dpg6rG5Deh0qFGgjqt7Wi%2F9bXCIseWqEAkwOftKdSr2%0Ai5B5JOpFz%2FvxKmyO6s6OWj9K%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single sign-on"]}," from the left panel."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SAML Certificate"]},", download the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Federation Metadata XML"]},"."]}]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260101/28ab85a9055941315ca79548/Screen%2BShot%2B2022-12-20%2Bat%2B16_57_00.png?expires=1780056000&signature=d26dd8a986b6d4d2d9275daf2f84af6b5e1edffa3d3255f1a01b805ce10fafb3&req=0dZtw1j7rDZk2hj99dpg6ngj%2FnsdssnZ2qsS%2FMhGqGJ9gdNUyfM2gM540Smy%0AIhMFskECwPYAZLNnfdmhdmFN%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/14042481/478e0f99c6dcafb4beef8126/Screen%2BShot%2B2022-12-20%2Bat%2B16_58_18.png?expires=1780056000&signature=14552f84c05fb478c3433e2750c1bc057666b23ab3bb0b0c6f83c2b16939874a&req=0dFvwVr%2BpDZk2hj99dpg6prNl5c08JMbVV29T4wN9B3hXF0b2KKcBBmPzRPR%0AKpkepxry%2BXAxebcKmQb%2BxmjR%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"part-2-configure-in-lusha","__idx":9},"children":["Part 2: Configure in Lusha"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/account/accountSettings"},"children":["Account Settings"]}]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste the XML under the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Azure AD activation"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test SSO"]},". Lusha runs a real sign-in against the metadata you provided and only shows ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SSO test passed"]}," once it succeeds — nothing is enforced yet at this point."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once the test passes, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260113/0b4e834b33bdba06f68a9673/Screen%2BShot%2B2022-11-10%2Bat%2B12_21_53.png?expires=1780056000&signature=4238a9c7c7b35a2be4969f8ca94ba53436df0ab7d8cc2e97a381a7642b862a86&req=0dZtw1j7rTRk2hj99dpg6lPUUdFabUcKD%2FusvSsjTsUC%2F%2FWlOGWS1S4Kdl%2FM%0AHFNtC%2B1tMNNALnkV7Ewu3Fb0%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign team members by going to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]}," tab → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New user"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invite users"]},"."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://lusha-eu.intercom-attachments.eu/i/o/13260119/98ba2462b72a832a5abe943d/skitch%2B-281-29.png?expires=1780056000&signature=40f19a84da9a314871876af8b8db084d36c9a0376311f7faf4779f22c5a3ea17&req=0dZtw1j7rT5k2hj99dpg6uDJz3yYczaoRx4yKSafD4jb8q05BBB0nwjqM9Cs%0AS2LYiUu0RxHD74m7rJWouC%2F6%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your account is now integrated with Azure. Team members will be able to sign in using Azure SSO and Office 365."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Users must already be part of your Lusha account before being assigned in Azure. After assigning, they can sign in via Azure or via Lusha's login page by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign in with SSO provider"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For custom SAML SSO configuration, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/security/custom-saml-single-sign-on"},"children":["Custom SAML single sign-on"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a custom SAML 2.0 app built from scratch in Okta, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/security/okta-saml-20-setup-for-lusha-sso"},"children":["Okta SAML 2.0 setup article"]}," instead."]}]},"headings":[{"value":"How to set up SSO (single sign-on)","id":"how-to-set-up-sso-single-sign-on","depth":1},{"value":"Sign up with Google or Office 365","id":"sign-up-with-google-or-office-365","depth":2},{"value":"Google","id":"google","depth":3},{"value":"Office 365","id":"office-365","depth":3},{"value":"Set up Okta SSO","id":"set-up-okta-sso","depth":2},{"value":"Step 1: Set up in Okta (performed by the Okta admin)","id":"step-1-set-up-in-okta-performed-by-the-okta-admin","depth":3},{"value":"Step 2: Configure in Lusha","id":"step-2-configure-in-lusha","depth":2},{"value":"Set up Azure AD SSO","id":"set-up-azure-ad-sso","depth":2},{"value":"Part 1: Add Lusha in Azure","id":"part-1-add-lusha-in-azure","depth":3},{"value":"Part 2: Configure in Lusha","id":"part-2-configure-in-lusha","depth":3}],"frontmatter":{"title":"How to set up SSO (single sign-on)","description":"How to set up SSO for Lusha using the pre-built integrations for Google, Office 365, Okta (Integration Network app), or Azure AD.","seo":{"title":"How to set up SSO (single sign-on)"}},"lastModified":"2026-07-09T11:47:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/security/how-to-set-up-sso-single-sign-on","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}