How to set up Single-Sign-On (SSO) authentication for Neowit using Okta

1. Navigate to your Okta administrator console
2. Click Create App Integration
3. Choose Sign-in method SAML2.0
4. You can now fill in general settings, choose a name for your SAML application, for example "Neowit", and click next.


5. You should now see the Configure SAML screen, head over to https://app.neowit.io/settings/idps and click the bottom right + sign to add a new idp.
6. Fill in a name and click Add
7. Copy the ACS URL field from the IdP you created in Neowit and paste it into Okta as Single sign-on URL field as well as the Audience URI field.
8. Fill in the rest of the SAML configuration according to your needs, Name ID format should be EmailAddress and Application username should be Email.
9. Go next, write your Okta feedback and click finish.
10. Copy the SAML metadata URL, you need to upload the content of this URL to Neowit. For example, you can open the URL in the browser, view the source and copy it to a file that you upload.

11. Navigate to  Assignments  in the application you created and assign users or groups you want to be able to log in to this application.

Note: If you aren't using SCIM to import your Okta users, you will have to make sure the Neowit user is set up to use your Okta IdP as authentication method (you can do this under settings/user). Also make sure the Name field (displayName) is the same as in the Okta directory.