Jamf Device Sync
Sync your Devices from Jamf
Jamf API Privileges
Step 1: Access Jamf Admin Console
- Log in to your admin account on the Jamf Pro cloud organization.
- Navigate to the Settings tab in the left sidebar.
- Use the search bar to find "API Roles and Clients" and select it.
![Find the API Roles and Clients configuration here.](https://files.readme.io/7eeaa25-Screenshot_2023-11-17_at_4.19.03_PM.png)
Navigate to the Settings bar and search for "API" to configure your roles and clients.
Step 2: Configure API Roles
- Create a new API role (name is arbitrary) or use an existing one.
- Assign the permissions "Read Computers" and/or "Read Mobile Devices". This allows our sync API to access the appropriate devices from Jamf.
![Ensure you have "Read Computers" and/or "Read Mobile Devices" enabled in the privileges section, as shown above.](https://files.readme.io/a71b042-Screenshot_2023-11-17_at_4.20.07_PM.png)
Ensure you have "Read Computers" and/or "Read Mobile Devices" enabled in the privileges section, as shown above.
Step 3: Set Up API Clients
- Go to the API Clients section.
- Create a new API client or select an existing one (name is arbitrary). Assign the newly created or chosen API role to this client and set a token lifetime as desired and click 'Enable', then 'Save'.
![Create the API client with the role we created earlier and click 'Enable API client'. Then click on this client again to generate the secret.](https://files.readme.io/cc9e501-Screenshot_2023-11-17_at_4.20.44_PM.png)
Create the API client with the role we created earlier and click 'Enable API client'. Then click on this client again to generate the secret.
- To generate the client-id/secret, click on your API client's name and then select 'Generate client secret'.
- Note: The client secret is shown only once. Make sure to copy and save it securely.
- Lost the secret? Click 'Rotate client secret' to generate a new one.
![Click Generate secret](https://files.readme.io/2f4c005-Screenshot_2023-12-07_at_9.09.07_AM.png)
Click Generate secret
![Copy client credentials](https://files.readme.io/0a36c5a-Screenshot_2023-12-07_at_9.11.29_AM.png)
Copy client credentials
Set up JamfConnector on Foxpass
Step 4: Access Foxpass Console
- Navigate to the Devices page on your Foxpass console.
- Click on the Jamf tab.
Step 5: Add Jamf API Key
- If you haven't set up a JamfConnector, click 'Add Jamf API Key'.
- In the modal window, enter your Jamf credentials:
Client ID: Found on the Jamf console by clicking your API client.
API Key: The client secret saved from earlier (regenerate if needed).
URL: Your Jamf console URL (e.g., https://foxpass.jamfcloud.com). - Click Submit.
![Enter Jamf credentials](https://files.readme.io/29dfc4b-Screenshot_2023-12-07_at_9.26.41_AM.png)
Enter Jamf credentials
- Click 'Sync Jamf Devices' and then 'Ok' to pull devices from Jamf and sync them to your Foxpass device console.
![Confirm to perform Sync](https://files.readme.io/19e49b7-Screenshot_2023-12-07_at_9.30.15_AM.png)
Confirm to perform Sync
Troubleshooting and Management
If JamfConnector details change or are incorrect, go to the actions bar to 'Disable' or 'Delete' the connector and set up a new one. Furthermore, if ensure async tasks are enabled in your config.py and that your Redis/Celery tasks are properly setup so the sync task can be handled appropriately.
For further assistance, contact [email protected].
Updated 8 months ago