Adding Jamf credentials

Before you start

Best practice
For the integration with Oomnitza, create a dedicated user account.

For the integration with Oomnitza, you'll need the following information:

• The URL of your Jamf instance. Example:
  https://<customer-subdomain>.jamfcloud.com
• The Client ID and Secret

Obtaining your Client ID and Secret

1. In Jamf Pro, click Settings in the sidebar.
2. In the System section, click API Roles and Clients
3. Click the API Roles tab.
4. Click New.
5. Enter a display name for the API role.
6. In the Jamf Pro API role privileges field, begin typing the name of a privilege you want to assign, and then select it from the pop-up menu. Refer to the table for a list of privileges.
7. Click Save.
8. Return to the System section, and click APl Clients.
9. Click New.
10. Enter a display name for the API client.
11. In the API Roles field, add the roles you previously created.
12. Under Access Token Lifetime, enter the time in seconds that you want access tokens to be valid for.
13. Click Enable API Client to allow the client to be used to generate a client secret.
14. Click Save.
15. Click Create secret.

Jamf Pro Documentation: API Roles and Clients

Links for information about privileges for Jamf Integrations

Privilege requirements (Classic API)

Privileges and Deprecations (Pro API)

Adding the credentials

To authorize connections between Oomnitza and Jamf, complete these steps:

Make life easier and add your credentials to Oomnitza before you create the integration.  

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration.
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. Add the information details.
2. Click the AUTHORIZATION tab.
3. Ensure that OAuth 2.0 is selected as the Authorization type.
4. Ensure that Jamf Pro is selected from the SaaS list.
5. Enter the URL of your Jamf instance. 
6. Enter your Jamf Client ID and Secret.
7. Click Authenticate. You are prompted to log in to authorize your request.
8. Click CREATE. 

Important note for Jamf URL entry with port numbers
If you are experiencing errors during the authentication process and your Jamf URL includes a port number, add a trailing slash ('/') to the end of the URL. This additional step can help prevent authentication errors during the OAuth 2.0 process. For example, if your URL is https://example.jamfcloud.com:8443, enter it as https://example.jamfcloud.com:8443/