Testing Network Authentication

If your Jamf Connect configuration profiles are stored in the Jamf Connect Configuration app, you can test your authentication settings to ensure your configuration profile successfully authenticates users to your cloud identity provider (IdP). You can test the following:

  • Authentication via OpenID Connect

  • Authentication via Okta's authentication API

  • Password verification via a Resource Owner Password Grant (ROPG)

Testing Okta Authentication

  1. In Jamf Connect Configuration, click Test > Okta.
  2. Enter a valid username and password and click Sign In.
    One of the following will occur:
    • If you successfully authenticate, your configuration is working and ready to save.

    • If you are unable to authenticate, your configuration needs additional settings or contains errors. Review your settings and repeat the testing process.

  3. (Optional) Save and export your configuration profile.
    1. Click File > Save from the Apple menu bar.
    2. Select which preference domain to write the configuration profile to.
    3. To upload the profile to Jamf Pro, select the Jamf Pro Upload checkbox and enter your Jamf Pro instance URL, username, and password.

      Make sure to also confirm a successful connection using the Check Connection button.

    4. Select a file format.
      Important:

      • To upload your configuration to Jamf Pro, you must save the configuration in .mobileconfig format.

      • If you select .mobileconfig, you must also complete the Payload Configuration Profile Data section.

    5. Click Save and name your configuration profile.

Testing OpenID Connect Authentication

  1. In Jamf Connect Configuration, click Test > OIDC.
  2. Log in with a valid username and password that has been assigned Jamf Connect in your IdP's admin console, portal, or a similar tool.
    One of the following will occur:
    • If you successfully authenticate, your configuration is working and ready to save.

    • If you are unable to authenticate, your configuration needs additional settings or contains errors. Review your settings and repeat the testing process.

  3. (Optional) Click Save on the bottom-right of the window to save the access, refresh, and ID tokens to your computer.
  4. (Optional) Save and export your configuration profile.
    1. Click File > Save from the Apple menu bar.
    2. Select which preference domain to write the configuration profile to.
    3. To upload the profile to Jamf Pro, select the Jamf Pro Upload checkbox and enter your Jamf Pro instance URL, username, and password.

      Make sure to also confirm a successful connection using the Check Connection button.

    4. Select a file format.
      Important:

      • To upload your configuration to Jamf Pro, you must save the configuration in .mobileconfig format.

      • If you select .mobileconfig, you must also complete the Payload Configuration Profile Data section.

    5. Click Save and name your configuration profile.

Testing Password Verification

To ensure the resource owner password grant (ROPG), which Jamf Connect uses for password verification and syncing, is correctly configured, do the following:

  1. In Jamf Connect Configuration, click Test > ROPG.
  2. Enter a valid username and password and click Sign In.
    One of the following will occur:
    • If you successfully authenticate your configuration is working and ready to save.

    • If you are unable to authenticate, your configuration needs additional settings or contains errors. Review your settings and repeat the testing process.

  3. (Optional) Save and export your configuration profile.
    1. Click File > Save from the Apple menu bar.
    2. Select which preference domain to write the configuration profile to.
    3. To upload the profile to Jamf Pro, select the Jamf Pro Upload checkbox and enter your Jamf Pro instance URL, username, and password.

      Make sure to also confirm a successful connection using the Check Connection button.

    4. Select a file format.
      Important:

      • To upload your configuration to Jamf Pro, you must save the configuration in .mobileconfig format.

      • If you select .mobileconfig, you must also complete the Payload Configuration Profile Data section.

    5. Click Save and name your configuration profile.