Skip to main content
Skip table of contents

Authenticating with OKTA via OpenID Connect

OKTA Configuration

  1. Configure using the OKTA admin panel.

EzeScan WebApps Configuration

  1. Locate the appsettings.json file found in the root directory of your EzeScan WebApps installation directory.

  2. Edit the appsettings.json file using your favorite text editor and modify the Authentication section to contain the following:


             "OpenIdConnect": {
                "Scope": ["openid", "profile", "email", "groups"],
                "Authority": "",
                "ClientId": "0o2344325dsfsdfdsfsdsf7",
                "MetadataAddress": "",
                  "TokenValidationParameters": {
                     "NameClaimType": "name",
                     "RoleClaimType": "groups"

    You will need to substitute "" with your OKTA domain.

    Be sure to substitute the value of "ClientId" with the "Client Id" set in OKTA. If you're unsure then see Locating the Client Id

  3. Save the appsettings.json file.

  4. Restart the IIS App Pool that runs EzeScan WebApps.

  5. Navigate to your EzeScan WebApps site and click the Login button.

  6. Try logging in as a valid OKTA user.

  7. After successfully logging in you will be redirected back to EzeScan WebApps and in the top right hand corner you should see your display name.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.