How to Install Clients on Mac Computers in Configuration Manager
Updated: May 14, 2015
Applies To: System Center 2012 Configuration Manager SP1, System Center 2012 Configuration Manager SP2, System Center 2012 R2 Configuration Manager, System Center 2012 R2 Configuration Manager SP1
Note
The information in this topic applies to System Center 2012 Configuration Manager SP1 or later, and System Center 2012 R2 Configuration Manager or later.
Client installation and management for Mac computers in System Center 2012 Configuration Manager requires public key infrastructure (PKI) certificates. Configuration Manager can request and install a user client certificate by using Microsoft Certificate Services with an enterprise certification authority (CA) and the Configuration Manager enrollment point and enrollment proxy point site system roles. Or, you can request and install a computer certificate independently from Configuration Manager if the certificate meets the requirements for Configuration Manager. PKI certificates secure the communication between the Mac computers and the Configuration Manager site by using mutual authentication and encrypted data transfers.
Important
Configuration Manager Mac clients always perform certificate revocation checking; unlike Configuration Manager clients that run on Windows, you cannot disable this certificate revocation list (CRL) checking function.
If Mac clients cannot confirm the certificate revocation status for a server certificate because they cannot locate the CRL, they will not be able to successfully connect to Configuration Manager site systems, such as management points and distribution points. Especially for Mac clients in a different forest to the issuing certification authority, check your CRL design to ensure that Mac clients can locate and connect to a CRL distribution point (CDP) for connecting site system servers.
Before you install the Configuration Manager client on a Mac computer, decide how to install the client certificate:
Use Configuration Manager enrollment by using the CMEnroll tool and follow the steps in the next section of this topic. The enrollment process does not support automatic certificate renewal so you must re-enroll Mac computers before the installed certificate expires.
Use a certificate request and installation method that is independent from Configuration Manager. For this installation method, see the Use a Certificate Request and Installation Method that is Independent from Configuration Manager section in this topic.
Note
For more information about the Mac client certificate requirement and other PKI certificates that are required to support Mac computers, see PKI Certificate Requirements for Configuration Manager.
Mac clients are automatically assigned to the Configuration Manager site that manages them. Mac clients install as Internet-only clients, even if communication is restricted to the intranet. This client configuration means that they will communicate with the site system roles (management points and distribution points) in their assigned site when you configure these site system roles to allow client connections from the Internet. Mac computers do not communicate with site system roles outside their assigned site.
Important
The Configuration Manager Mac client cannot be used to connect to a management point that is configured to use a database replica. For information about database replicas, see Configure Database Replicas for Management Points.
Use the following sections to install, configure, and manage Mac computers for Configuration Manager:
Steps to Install and Configure the Client for Mac Computers
- Supplemental Procedures to Install and Configure the Client for Mac Computers
Steps to Upgrade the Client for Mac Computers
Use a Certificate Request and Installation Method that is Independent from Configuration Manager
Steps to Install and Configure the Client for Mac Computers
Use the following table for the steps, details, and more information about how to install and configure the client for Mac computers.
Important
Before you perform these steps, make sure that your Mac computer meets the prerequisites listed in the Client Requirements for Mac Computers section in the Supported Configurations for Configuration Manager topic.
Steps |
Details |
More information |
---|---|---|
Step 1: Deploy a web server certificate to site system servers. |
These site systems might already have this certificate for other Configuration Manager clients. If not, deploy a web server certificate to the following computers that hold the following site system roles:
Important The web server certificate must contain the Internet FQDN that is specified in the site system properties. This does not mean that the server must be accessible from the Internet to support Mac computers. If you do not require Internet-based client management, you can specify the intranet FQDN value for the Internet FQDN. |
For an example deployment that creates and installs this web server certificate, see the Deploying the Web Server Certificate for Site Systems that Run IIS section in the Step-by-Step Example Deployment of the PKI Certificates for Configuration Manager: Windows Server 2008 Certification Authority topic. Important Make sure that you specify the site system’s Internet FQDN value in the web server certificate for the management point, the distribution point, and the enrollment proxy point. |
Step 2: Deploy a client authentication certificate to site system servers. |
These site systems might already have this certificate for Configuration Manager functionality. If not, deploy a client authentication certificate to the following computers that hold the following site system roles:
|
For an example deployment that creates and installs the client certificate for management points, see the Deploying the Client Certificate for Windows Computers section in the Step-by-Step Example Deployment of the PKI Certificates for Configuration Manager: Windows Server 2008 Certification Authority topic. For an example deployment that creates and installs the client certificate for distribution points, see the Deploying the Client Certificate for Distribution Points section in the Step-by-Step Example Deployment of the PKI Certificates for Configuration Manager: Windows Server 2008 Certification Authority topic. |
Step 3: Prepare the client certificate template for Mac computers. Note To run the Configuration Manager enrollment tool, you must have an Active Directory user account. |
The certificate template must have Read and Enroll permissions for the user account that will enroll the certificate on the Mac computer. |
See the Deploying the Client Certificate for Mac Computers section in the Step-by-Step Example Deployment of the PKI Certificates for Configuration Manager: Windows Server 2008 Certification Authority topic. |
Step 4: Configure the management point and distribution point. |
Configure management points for the following options:
Although distribution points are not required to install the client on Mac computers, you must configure distribution points to allow client connections from the Internet if you want to deploy software to these Mac computers after the Configuration Manager client is installed. |
See the following procedure in this topic: Step 4: Configuring Management Points and Distribution Points to support Mac Computers. |
Step 5: Configure the enrollment proxy point and the enrollment point. |
You must install both these site system roles in the same site but you do not have to install them on the same site system server, or in the same Active Directory forest. |
For more information about site system role placement and considerations, see the Planning Where to Install Sites System Roles in the Hierarchy section in the Planning for Site Systems in Configuration Manager topic. To configure the enrollment proxy point and the enrollment point, see the following procedure in this topic: Step 5: Installing and Configuring the Enrollment Site Systems. |
Step 6: Optional:
|
Install the reporting services point if you want to run reports for Mac computers. |
For more information about how to install and configure the reporting services point, see Configuring Reporting in Configuration Manager. |
Step 7: Configure client settings for enrollment. |
You must use the default client settings to configure enrollment for Mac computers; you cannot use custom client settings. |
For more information about client settings, see About Client Settings in Configuration Manager. For information about how to configure these client settings, see the following procedure in this topic: Step 7: Configuring the Client Settings for Enrollment. |
Step 8: Download the client source files for Mac clients. |
Download the installation files and then install them on the Mac computer. |
See the following procedure in this topic: Step 8: Download and Install the Mac Client Files. |
Step 9: Install the client and then enroll the client certificate on the Mac computer. |
When you use Configuration Manager enrollment, you must first install the client by using the Ccmsetup application, and then enroll the client certificate by using the CMEnroll tool. |
See the following procedure in this topic: Step 9: Installing the Client and Enrolling the Certificate by using the CMEnroll Tool on the Mac computer. |
Supplemental Procedures to Install and Configure the Client for Mac Computers
Use the following information when the steps in the preceding table require supplemental procedures.
Step 4: Configuring Management Points and Distribution Points to support Mac Computers
This procedure configures existing management points and distribution points to support Mac computers. Before you start this procedure, make sure that the site system server that runs the management point and distribution point is configured with an Internet FQDN. If these site system servers will not support Internet-based client management, you can specify the intranet FQDN as the Internet FQDN value. In addition, these site system roles must be in a primary site.
To configure management points and distribution points to support Mac computers
-
In the Configuration Manager console, click Administration.
-
In the Administration workspace, expand Site Configuration, select Servers and Site System Roles, and then select the server that holds the site system roles to configure.
-
In the details pane, right-click Management point, click Role Properties, and in the Management Point Properties dialog box, configure the following options, and then click OK:
Select HTTPS.
Select Allow Internet-only client connections or Allow intranet and Internet client connections. These options require that an Internet FQDN is specified in the site system properties, even if the site system server will not be accessible from the Internet.
Select Allow mobile devices and Mac computers to use this management point.
-
In the details pane, right-click Distribution point, click Role Properties, and in the Distribution Point Properties dialog box, configure the following options, and then click OK:
- Select **HTTPS**. - Select **Allow Internet-only client connections** or **Allow intranet and Internet client connections**. These options require that an Internet FQDN is specified in the site system properties, even if the site system server will not be accessible from the Internet. - Click **Import certificate**, browse to the exported client distribution point certificate file, and then specify the password.
-
Repeat steps 2 through 4 in this procedure for all management points and distribution points in primary sites that you will use with Mac computers.
Step 5: Installing and Configuring the Enrollment Site Systems
These procedures configure the site system roles to support Mac computers. Choose one of these procedures, depending on whether you will install a new site system server to support Mac computers or use an existing site system server:
To install and configure the enrollment site systems: New site system server
To install and configure the enrollment site systems: Existing site system server
To install and configure the enrollment site systems: New site system server
-
In the Configuration Manager console, click Administration.
-
In the Administration workspace, expand Site Configuration, and click Servers and Site System Roles
-
On the Home tab, in the Create group, click Create Site System Server.
-
On the General page, specify the general settings for the site system, and then click Next.
Important
Make sure that you specify a value for the Internet FQDN, even if the site system server will not be accessible from the Internet. If you do not have an Internet FQDN because the site system server will not be accessible from the Internet, you can specify the intranet FQDN value as the Internet FQDN. Mac computers always connect to the Internet FQDN, even when they are on the intranet.
-
On the System Role Selection page, select Enrollment proxy point and Enrollment point from the list of available roles, and then click Next.
-
On the Enrollment Proxy Point page, review the settings and make any changes that you require, and then click Next.
-
On the Enrollment Point Settings page, review the settings and make any changes that you require, and then click Next.
-
Complete the wizard.
To install and configure the enrollment site systems: Existing site system server
-
In the Configuration Manager console, click Administration.
-
In the Administration workspace, expand Site Configuration, select Servers and Site System Roles, and then select the server that you want to use to support Mac computers.
-
On the Home tab, in the Create group, click Add Site System Roles.
-
On the General page, specify the general settings for the site system, and then click Next.
Important
Make sure that you specify a value for the Internet FQDN, even if the site system server will not be accessible from the Internet. If you do not have an Internet FQDN because the site system server will not be accessible from the Internet, you can specify the intranet FQDN value as the Internet FQDN. Mac computers always connect to the Internet FQDN, even when they are on the intranet.
-
On the System Role Selection page, select Enrollment proxy point and Enrollment point from the list of available roles, and then click Next.
-
On the Enrollment Proxy Point page, review the settings and make any changes that you require, and then click Next.
-
On the Enrollment Point Settings page, review the settings and make any changes that you require, and then click Next.
-
Complete the wizard.
Step 7: Configuring the Client Settings for Enrollment
This step is required for Configuration Manager to request and install the certificate on the Mac computer.
To configure the default client settings for Configuration Manager to enroll certificates for Mac computers
-
In the Configuration Manager console, click Administration.
-
In the Administration workspace, click Client Settings.
-
Click Default Client Settings.
Important
You cannot use a custom client setting for the enrollment configuration; you must use the default client settings.
-
On the Home tab, in the Properties group, click Properties.
-
Select the Enrollment section, and then configure the following user settings:
Allow users to enroll mobile devices and Mac computers: Yes
Enrollment profile: Click Set Profile.
-
In the Mobile Device Enrollment Profile dialog box, click Create.
-
In the Create Enrollment Profile dialog box, enter a name for this enrollment profile, and then configure the Management site code. Select the Configuration Manager SP1 primary site that contains the management points that will manage the Mac computers.
Note
If you cannot select the site, check that at least one management point in the site is configured to support mobile devices.
-
Click Add.
-
In the Add Certification Authority for Mobile Devices dialog box, select the certification authority (CA) server that will issue certificates to Mac computers, and then click OK.
-
In the Create Enrollment Profile dialog box, select the Mac computer certificate template that you created in Step 3, and then click OK.
-
Click OK to close the Enrollment Profile dialog box, and then click OK to close the Default Client Settings dialog box.
Tip
If you want to change the client policy interval, use the Client policy polling interval client setting in the Client Policy client setting group.
All users will be configured with these settings when they next download client policy. To initiate policy retrieval for a single client, see the Initiate Policy Retrieval for a Configuration Manager Client section in the How to Manage Clients in Configuration Manager topic.
In addition to the enrollment client settings, ensure that you have configured the following Configuration Manager client device settings:
Hardware inventory: Enable and configure this client setting if you want to collect hardware inventory from Mac and Windows client computers. For more information, see How to Configure Hardware Inventory in Configuration Manager.
Compliance settings: Enable and configure this client setting if you want to evaluate and remediate settings on Mac and Windows client computers. For more information, see Configuring Compliance Settings in Configuration Manager.
Note
For more information about Configuration Manager client settings, see How to Configure Client Settings in Configuration Manager.
Step 8: Download and Install the Mac Client Files
You must download and install the following programs before you can install and manage the Configuration Manager client on Mac computers:
Ccmsetup: Use this application to install the Configuration Manager client on Mac computers in your organization.
CMDiagnostics: Use this tool to collect diagnostic information related to the Configuration Manager client on Mac computers in your organization.
CMUninstall: Use this tool to uninstall the Configuration Manager client from Mac computers in your organization.
CMAppUtil: Use this tool to convert Apple application packages into a format that can be deployed as a Configuration Manager application.
CMEnroll: Use this tool to request and install the client certificate for a Mac computer so that you can then install the Configuration Manager client.
Important
When you install a new client for Mac computers, you might have to also install Configuration Manager updates to reflect the new client information in the Configuration Manager console. For the latest information, see the Client Requirements for Mac Computers section in the Supported Configurations for Configuration Manager topic.
To download and install the Mac OS X client files
-
Download the Mac OS X client file package, ConfigmgrMacClient.msi, and save it to a computer that runs Windows.
This file is not supplied on the Configuration Manager installation media. You can download this file from the Microsoft Download Center for Configuration Manager SP1, and the Microsoft Download Center for System Center 2012 R2 Configuration Manager.
-
On the Windows computer, run the ConfigmgrMacClient.msi file that you just downloaded to extract the Mac client package, Macclient.dmg to a folder on the local disk (by default C:\Program Files (x86)\Microsoft\System Center 2012 Configuration Manager Mac Client\).
-
Copy the Macclient.dmg file to a folder on the Mac computer.
-
On the Mac computer, run the Macclient.dmg file that you just downloaded to extract the files to a folder on the local disk.
-
In the folder, ensure that the files Ccmsetup and CMClient.pkg are extracted and that a folder named Tools is created that contains the CMDiagnostics, CMUninstall, CMAppUtil and CMEnroll tools.
Step 9: Installing the Client and Enrolling the Certificate by using the CMEnroll Tool on the Mac computer
This procedure installs the client and then uses the CMEnroll tool to request and install the client certificate for a Mac computer so that you can then manage this computer by using Configuration Manager.
For System Center 2012 R2 Configuration Manager and later: You can enroll the client by using the Mac Computer Enrollment wizard without having to use the CMEnroll tool. For more information, see the procedure below.
To install the client and enroll the certificate by using the CMEnroll tool
-
On the Mac computer, navigate to the folder where you extracted the contents of the Macclient.dmg file that you downloaded from the Microsoft Download Center.
-
Enter the following command-line: sudo ./ccmsetup
-
Wait until you see the Completed installation message. Although the installer displays a message that you must restart now, do not restart now but continue to the next step.
-
From the Tools folder on the Mac computer, type the following: sudo ./CMEnroll -s <enrollment_proxy_server_name> -ignorecertchainvalidation -u <'user name'>
Note
In System Center 2012 R2 Configuration Manager, after the client installs, the Mac Computer Enrollment wizard opens to help you enroll the Mac computer. To enroll the client by this method, see To enroll the client by using the Mac Computer Enrollment Wizard (System Center 2012 R2 Configuration Manager only) in this topic.
You are then prompted to type the password for the Active Directory user account.
Important
When you enter this command, you are actually prompted for two passwords: The first prompt is for the super user account to run the command. The second prompt is for the Active Directory user account. The prompts look identical, so make sure that you specify them in the correct sequence.
The user name can be in the following formats:
- 'domain\\name’. For example: 'contoso\\mnorth' - 'user@domain'. For example: '[email protected]'
The user name and corresponding password must match an Active Directory user account that is granted Read and Enroll permissions on the Mac client certificate template.
Example: If the enrollment proxy point server is named server02.contoso.com, and a user name of contoso\mnorth has been granted permissions for the Mac client certificate template, type the following: sudo ./CMEnroll -s server02.contoso.com –ignorecertchainvalidation -u 'contoso\mnorth'
Important
If the username contains any of the characters <>"+=, then enrollment will fail.
To fix this problem, obtain an out-of-band certificate with a username that does not contain these characters.
Note
For a more seamless user experience, you can script the installation steps and commands so that users only have to supply their user name and password.
-
Wait until you see the Successfully enrolled message.
-
For Configuration Manager SP1 only: To limit the enrolled certificate to Configuration Manager, on the Mac computer, open a terminal window and make the following changes:
Enter the command sudo /Applications/Utilities/Keychain\ Access.app/Contents/MacOS/Keychain\ Access
In the Keychain Access dialog box, in the Keychains section, click System, and then, in the Category section, click Keys.
Expand the keys to view the client certificates. When you have identified the certificate with a private key that you have just installed, double-click the key.
On the Access Control tab, select Confirm before allowing access.
Browse to /Library/Application Support/Microsoft/CCM, select CCMClient, and then click Add.
Click Save Changes and close the Keychain Access dialog box.
-
Restart the Mac computer.
Verify that the client installation is successful by opening the Configuration Manager item in System Preferences on the Mac computer. You can also update and view the All Systems collection to confirm that the Mac computer now appears in this collection as a managed client.
Tip
To help troubleshoot any problems with the Mac client, you can use the CMDiagnostics program that is included with the Mac OS X client package to collect the following diagnostic information:
-
A list of running processes
-
The Mac OS X operating system version
-
Mac OS X crash reports relating to the Configuration Manager client including CCM*.crash and System Preference.crash.
-
The Bill of Materials (BOM) file and property list (.plist) file created by the Configuration Manager client installation.
-
The contents of the folder /Library/Application Support/Microsoft/CCM/Logs.
The information collected by CmDiagnostics is added to a zip file that is saved to the desktop of the computer and is named cmdiag-<hostname>-<date and time>.zip.
To enroll the client by using the Mac Computer Enrollment Wizard (System Center 2012 R2 Configuration Manager only)
-
After you have finished installing the client the Computer Enrollment wizard opens. Click Next to continue past the welcome page.
Note
If the wizard does not open, or if you accidentally close the wizard, click Enroll from the Configuration Manager preference page to open the wizard.
-
On the next page of the wizard, specify the following information:
- **User name** - The user name can be in the following formats: - 'domain\\name’. For example: 'contoso\\mnorth' - 'user@domain'. For example: '[email protected]' <div class="alert"> > [!IMPORTANT] > <P>When you use an email address to populate the <STRONG>User name</STRONG> field, Configuration Manager automatically uses the domain name of the email address and the default name of the enrollment proxy point server to populate the <STRONG>Server name</STRONG> field. If this domain name and server name do not match the name of the enrollment proxy point server, you must advise your users of the correct name to use, so that they can enter this when enrolling their Mac computers.</P> </div> The user name and corresponding password must match an Active Directory user account that is granted Read and Enroll permissions on the Mac client certificate template. - **Password** – Enter a corresponding password for the user name specified. - **Server name** – Enter the name of the enrollment proxy point server.
-
Click Next to continue, and then complete the wizard.
Uninstalling the Mac Client
If you want to uninstall the Mac client, use the CMUninstall script that is provided with the Mac client files you downloaded from the web. Use the following procedure to help you uninstall the Configuration Manager client from Mac computers.
-
On a Mac computer, open a terminal window and navigate to the folder where you extracted the contents of the macclient.dmg file that you downloaded from the Microsoft Download Center.
-
Navigate to the Tools folder and enter the following command-line:
./CMUninstall -c
Note
The –c property instructs the client uninstall to also remove and client crash logs and log files. This is optional, but a best practice to help avoid confusion if you later reinstall the client.
-
If required, manually remove the client authentication certificate that Configuration Manager was using, or revoke it. CMUnistall does not remove or revoke this certificate.
Renewing the Mac Client Certificate
Use one of the following methods to renew the Mac client certificate:
Renewing the Mac Client Certificate by Using the Renew Certificate Wizard (System Center 2012 R2 Configuration Manager only)
Renewing the Mac Client Certificate Manually
Use the following procedure to configure and use the Renew Certificate Wizard in System Center 2012 R2 Configuration Manager.
To renew the Mac client certificate by Using the Renew Certificate Wizard
-
Configure the following values in the ccmclient.plist file that control when the Renew Certificate Wizard opens:
Important
You must configure these values as strings. If you configure the values as integer data types (by using the –int property), they will not be read.
- **RenewalPeriod1** – Specifies, in seconds, the first renewal period in which users can renew the certificate. The default value is 3,888,000 seconds (45 days). <div class="alert"> > [!NOTE] > <P>If <STRONG>RenewalPeriod1</STRONG> is configured and is greater than or equal to 300 seconds, the configured value will be used. If the configured value is greater than 0 and less than 300 seconds, the default value of 45 days will be used.</P> </div> - **RenewalPeriod2** – Specifies, in seconds, the second renewal period in which users can renew the certificate. The default value is 259,200 seconds (3 days). <div class="alert"> > [!NOTE] > <P>If <STRONG>RenewalPeriod2</STRONG> is configured and is greater than or equal to 300 seconds and is less than or equal to <STRONG>RenewalPeriod1</STRONG>, the configured value will be used. If <STRONG>RenewalPeriod1</STRONG> is greater than 3 days, a value of 3 days will be used for <STRONG>RenewalPeriod2</STRONG>. If <STRONG>RenewalPeriod1</STRONG> is less than 3 days, then <STRONG>RenewalPeriod2</STRONG> is set to the same value as <STRONG>RenewalPeriod1</STRONG>.</P> </div> - **RenewalReminderInterval1** – Specifies, in seconds, the frequency at which the Renew Certificate Wizard will be displayed to users during the first renewal period. The default value is 86,400 seconds (1 day). <div class="alert"> > [!NOTE] > <P>If <STRONG>RenewalReminderInterval1</STRONG> is greater than 300 seconds and less than the value configured for <STRONG>RenewalPeriod1</STRONG>, then the configured value will be used. Otherwise, the default value of 1 day will be used.</P> </div> - **RenewalReminderInterval2** – Specifies, in seconds the frequency at which the Renew Certificate Wizard will be displayed to users during the second renewal period. The default value is 28,800 seconds (8 hours). <div class="alert"> > [!NOTE] > <P>If <STRONG>RenewalReminderInterval2</STRONG> is greater than 300 seconds, less than or equal to <STRONG>RenewalReminderInterval1</STRONG> and less than or equal to <STRONG>RenewalPeriod2</STRONG>, then the configured value will be used. Otherwise, a value of 8 hours will be used.</P> </div>
Example: If the values are left as their defaults, 45 days before the certificate expires, the wizard will open every 24 hours. Within 3 days of the certificate expiring, the wizard will open every 8 hours.
Example: Use the following command line, or a script, to set the first renewal period to 20 days.
sudo defaults write com.microsoft.ccmclient RenewalPeriod1 1728000
-
When the Renew Certificate Wizard opens, the User name and Server name fields will typically be pre-populated and the user will only need to enter a password to renew the certificate.
Note
If the wizard does not open, or if you accidentally close the wizard, click Renew from the Configuration Manager preference page to open the wizard.
A typical validity period for the Mac client certificate is 1 year. Configuration Manager does not automatically renew the user certificate that it requests during enrollment, so you must use the following procedure to renew the certificate manually.
Important
If the certificate expires, you must uninstall, reinstall and then re-enroll the Mac client.
This procedure removes the SMSID, which is required to request a new certificate for the same Mac computer. After the new certificate is requested, it is automatically used by Configuration Manager.
Important
When you remove and replace the client SMSID, any stored client history such as inventory is deleted after you delete the client from the Configuration Manager console.
-
Create a device collection for the Mac computers that must renew the user certificates, and then add the Mac computers to the collection.
Warning
Configuration Manager does not monitor the validity period of the certificate that it enrolls for Mac computers. You must monitor this independently from Configuration Manager to identify the Mac computers to add to this collection.
-
In the Assets and Compliance workspace, start the Create Configuration Item Wizard.
-
On the General page of the wizard, specify the following information:
- **Name:** **Remove SMSID for Mac** - **Type:** **Mac OS X**
-
On the Supported Platforms page of the wizard, ensure that all Mac OS X versions are selected.
-
On the Settings page of the wizard, click New and then, in the Create Setting dialog box, specify the following information:
- **Name:** **Remove SMSID for Mac** - **Setting type:** **Script** - **Data type:** **String**
-
In the Create Setting dialog box, for Discovery script, click Add script to specify a script that discovers Mac computers with an SMSID configured.
-
In the Edit Discovery Script dialog box, enter the following Shell Script:
defaults read com.microsoft.ccmclient SMSID
-
Click OK to close the Edit Discovery Script dialog box.
-
In the Create Setting dialog box, for Remediation script (optional), click Add script to specify a script that removes the SMSID when it is found on Mac computers.
-
In the Create Remediation Script dialog box, enter the following Shell Script:
defaults delete com.microsoft.ccmclient SMSID
-
Click OK to close the Create Remediation Script dialog box.
-
On the Compliance Rules page of the wizard, click New, and then in the Create Rule dialog box, specify the following information:
Name: Remove SMSID for Mac
Selected setting: Click Browse and then select the discovery script that you specified previously.
In the following values field, enter The domain/default pair of (com.microsoft.ccmclient, SMSID) does not exist.
Enable the option Run the specified remediation script when this setting is noncompliant.
-
Complete the Create Configuration Item Wizard.
-
Create a configuration baseline that contains the configuration item that you have just created and deploy this to the device collection that you created in step 1.
For more information about how to create and deploy configuration baselines, see How to Create Configuration Baselines for Compliance Settings in Configuration Manager and How to Deploy Configuration Baselines in Configuration Manager.
-
On Mac computers that have the SMSID removed, run the following command to install a new certificate:
sudo ./CMEnroll -s <enrollment_proxy_server_name> -ignorecertchainvalidation -u <'user name'>
When prompted, provide the password for the super user account to run the command and then the password for the Active Directory user account.
-
For Configuration Manager SP1 only: To limit the enrolled certificate to Configuration Manager, on the Mac computer, open a terminal window and make the following changes:
Enter the command sudo /Applications/Utilities/Keychain\ Access.app/Contents/MacOS/Keychain\ Access
In the Keychain Access dialog box, in the Keychains section, click System, and then, in the Category section, click Keys.
Expand the keys to view the client certificates. When you have identified the certificate with a private key that you have just installed, double-click the key.
On the Access Control tab, select Confirm before allowing access.
Browse to /Library/Application Support/Microsoft/CCM, select CCMClient, and then click Add.
Click Save Changes and close the Keychain Access dialog box.
-
Restart the Mac computer.
Steps to Upgrade the Client for Mac Computers
For System Center 2012 R2 Configuration Manager and later:
Use the following table for the steps, details, and more information about how to upgrade the client for Mac computers by using a Configuration Manager application. Alternatively, you can also download the Mac client installation file, copy it to a shared network location or a local folder on the Mac computer and then instruct users to run the installation manually.
Note
Before you perform these steps, make sure that your Mac computer meets the prerequisites listed in the Client Requirements for Mac Computers section in the Supported Configurations for Configuration Manager topic.
Steps |
Details |
More Information |
---|---|---|
Step 1: Download the latest Mac client installation file from the Microsoft Download Center |
The Mac client for Configuration Manager is not supplied on the Configuration Manager installation media and must be downloaded from the Microsoft Download Center. The Mac client installation files are contained in a Windows Installer file named ConfigmgrMacClient.msi. |
You can download this file from the Microsoft Download Center for Configuration Manager SP1, and the Microsoft Download Center for System Center 2012 R2 Configuration Manager. |
Step 2: Run the downloaded installation file to create the Mac client installation file. |
On a computer that runs Windows, run the ConfigmgrMacClient.msi that you downloaded to unpack the Mac client installation file, named Macclient.dmg. This file can be found, by default, in the C:\Program Files (x86)\Microsoft\System Center 2012 Configuration Manager Mac Client folder on the Windows computer after you have unpacked the files. |
No additional information. |
Step 3: Extract the client installation files. |
Copy the Macclient.dmg file to a network share, or a local folder on a Mac computer. Then, from the Mac computer, mount and then open the Macclient.dmg file and copy the files to a folder on the Mac computer. |
No additional information. |
Step 4: Create a .cmmac file that can be used to create an application. |
Use the CMAppUtil tool (found in the Tools folder of the Mac client installation files) to create a .cmmac file from the client installation package. This file will be used to create the Configuration Manager application. Copy the new file CMClient.pkg.cmmac file to a location that is available to the computer that is running the Configuration Manager console. |
For more information, see the Step 1: Prepare Mac Applications for Configuration Manager section in the How to Create and Deploy Applications for Mac Computers in Configuration Manager topic. |
Step 5: Create and deploy a Configuration Manager application containing the Mac client files. |
In the Configuration Manager console, create an application from the CMClient.pkg.cmmac file that contains the client installation files. Deploy this application to Mac computers in your hierarchy. |
For more information, see How to Create and Deploy Applications for Mac Computers in Configuration Manager. |
Step 6: Users install the latest client. |
Users of Mac clients will be prompted that an update to the Configuration Manager client is available and must be installed. After users install the client, they must restart their Mac computer. |
After the computer restarts, the Computer Enrollment wizard automatically runs to request a new user certificate. If you do not use Configuration Manager enrollment but install the client certificate independently from Configuration Manager, see Upgrading the Client in the Use a Certificate Request and Installation Method that is Independent from Configuration Manager section of this topic. |
Use a Certificate Request and Installation Method that is Independent from Configuration Manager
When you do not use Configuration Manager enrollment but instead, request and install the client certificate independently from Configuration Manager, the configuration steps are slightly different:
Perform steps 1, 2, 4, 6 (optional), and 8.
Do not perform steps 3, 5, 7, and 9.
Install the client by using the following instructions.
To install the client certificate independently from Configuration Manager and install the client
-
To install the client certificate independently from Configuration Manager, use the instructions that accompany your chosen certificate deployment method to request and install the client certificate on the Mac computer.
-
Navigate to the folder where you extracted the contents of the macclient.dmg file that you downloaded from the Microsoft Download Center.
-
Enter the following command-line: sudo ./ccmsetup –MP <management point Internet FQDN> -SubjectName <certificate subject value>
Important
The certificate subject value is case-sensitive, so type it exactly as it appears in the certificate details.
Example: If the Internet FQDN in the site system properties is server03.contoso.com and the Mac client certificate has the FQDN of mac12.contoso.com as a common name in the certificate subject, type: sudo ./ccmsetup –MP server03.contoso.com –SubjectName mac12.contoso.com
-
Wait until you see the Completed installation message and then restart the Mac computer.
-
To make sure that this certificate is accessible to Configuration Manager, on the Mac computer, open a terminal window and make the following changes:
Enter the command sudo /Applications/Utilities/Keychain\ Access.app/Contents/MacOS/Keychain\ Access
In the Keychain Access dialog box, in the Keychains section, click System, and then, in the Category section, click Keys.
Expand the keys to view the client certificates. When you have identified the certificate with a private key that you have just installed, double-click the key.
On the Access Control tab, select Confirm before allowing access.
Browse to /Library/Application Support/Microsoft/CCM, select CCMClient, and then click Add.
Click Save Changes and close the Keychain Access dialog box.
-
If you have more than one certificate that contains the same subject value, you must specify the certificate serial number to identify the certificate that you want to use for the Configuration Manager client. To do this, use the following command: sudo defaults write com.microsoft.ccmclient SerialNumber -data "<serial number>".
For example: sudo defaults write com.microsoft.ccmclient SerialNumber -data "17D4391A00000003DB"
-
To limit this certificate to Configuration Manager, on the Mac computer, open a terminal window and make the following changes:
Enter the command sudo /Applications/Utilities/Keychain\ Access.app/Contents/MacOS/Keychain\ Access
In the Keychain Access dialog box, in the Keychains section, click System, and then, in the Category section, click Keys.
Expand the keys to view the client certificates. When you have identified the certificate with a private key that you have just installed, double-click the key.
On the Access Control tab, select Confirm before allowing access.
Browse to /Library/Application Support/Microsoft/CCM, select CCMClient, and then click Add.
Click Save Changes and close the Keychain Access dialog box.
Verify that the client installation is successful by opening the Configuration Manager item in System Preferences on the Mac computer. You can also update and view the All Systems collection to confirm that the Mac computer now appears in this collection as a managed client.
Renewing the Mac Client Certificate
Use the following procedure before you renew the computer certificate on Mac computers.
This procedure removes the SMSID, which is required for the client to use a new or renewed certificate on the Mac computer.
Important
When you remove and replace the client SMSID, any stored client history such as inventory is deleted after you delete the client from the Configuration Manager console.
To renew the Mac client certificate
-
Create a device collection for the Mac computers that must renew the computer certificates, and then add the Mac computers to the collection.
-
In the Assets and Compliance workspace, start the Create Configuration Item Wizard.
-
On the General page of the wizard, specify the following information:
- **Name:** **Remove SMSID for Mac** - **Type:** **Mac OS X**
-
On the Supported Platforms page of the wizard, ensure that all Mac OS X versions are selected.
-
On the Settings page of the wizard, click New and then, in the Create Setting dialog box, specify the following information:
- **Name:** **Remove SMSID for Mac** - **Setting type:** **Script** - **Data type:** **String**
-
In the Create Setting dialog box, for Discovery script, click Add script to specify a script that discovers Mac computers with an SMSID configured.
-
In the Edit Discovery Script dialog box, enter the following Shell Script:
defaults read com.microsoft.ccmclient SMSID
-
Click OK to close the Edit Discovery Script dialog box.
-
In the Create Setting dialog box, for Remediation script (optional), click Add script to specify a script that removes the SMSID when it is found on Mac computers.
-
In the Create Remediation Script dialog box, enter the following Shell Script:
defaults delete com.microsoft.ccmclient SMSID
-
Click OK to close the Create Remediation Script dialog box.
-
On the Compliance Rules page of the wizard, click New, and then in the Create Rule dialog box, specify the following information:
Name: Remove SMSID for Mac
Selected setting: Click Browse and then select the discovery script that you specified previously.
In the following values field, enter The domain/default pair of (com.microsoft.ccmclient, SMSID) does not exist.
Enable the option Run the specified remediation script when this setting is noncompliant.
-
Complete the Create Configuration Item Wizard.
-
Create a configuration baseline that contains the configuration item that you have just created and deploy this to the device collection that you created in step 1.
For more information about how to create and deploy configuration baselines, see How to Create Configuration Baselines for Compliance Settings in Configuration Manager and How to Deploy Configuration Baselines in Configuration Manager.
-
After you have installed a new certificate on Mac computers that have the SMSID removed, run the following command to configure the client to use the new certificate:
sudo defaults write com.microsoft.ccmclient SubjectName –string <Subject_Name_of_New_Certificate>
-
If you have more than one certificate that contains the same subject value, you must then specify the certificate serial number to identify the certificate that you want to use for the Configuration Manager client. To do this, use the following command: sudo defaults write com.microsoft.ccmclient SerialNumber -data "<serial number>".
For example: sudo defaults write com.microsoft.ccmclient SerialNumber -data "17D4391A00000003DB"
-
Restart the Mac computer.
Upgrading the Client
For System Center 2012 R2 Configuration Manager and later:
Follow the Steps to Upgrade the Client for Mac Computers. After you upgrade the client, run the following procedure to prevent the Computer Enrollment Wizard from running and to configure the upgraded client to use an existing client certificate.
To configure the upgraded client to use an existing certificate
-
In the Configuration Manager console, create a configuration item of the type Mac OS X.
-
Add a setting to this configuration item with the setting type Script.
-
Add the following script to the setting:
#!/bin/sh echo "Starting script\n" echo "Changing directory to MAC Client\n" cd /Users/Administrator/Desktop/'MAC Client'/ echo "Import root cert\n" /usr/bin/sudo /usr/bin/security import /Users/Administrator/Desktop/'MAC Client'/Root.pfx -A -k /Library/Keychains/System.Keychain -P ROOT echo "Using openssl to convert pfx to a crt\n" /usr/bin/sudo openssl pkcs12 -in /Users/Administrator/Desktop/'MAC Client'/Root.pfx -out Root1.crt -nokeys -clcerts -passin pass:ROOT echo "Adding trust to root cert\n" /usr/bin/sudo /usr/bin/security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.Keychain Root1.crt echo "Import client cert\n" /usr/bin/sudo /usr/bin/security import /Users/Administrator/Desktop/'MAC Client'/MacClient.pfx -A -k /Library/Keychains/System.Keychain -P MAC echo "Executing ccmclient with MP\n" sudo ./ccmsetup -MP https://SCCM34387.SCCM34387DOM.NET/omadm/cimhandler.ashx echo "Editing Plist file\n" sudo /usr/libexec/Plistbuddy -c 'Add:SubjectName string CMMAC003L' /Library/'Application Support'/Microsoft/CCM/ccmclient.plist echo "Changing directory to CCM\n" cd /Library/'Application Support'/Microsoft/CCM/ echo "Making connection to the server\n" sudo open ./CCMClient echo "Ending Script\n" exit
-
Add the configuration item to a configuration baseline, and then deploy the configuration baseline to all Mac computers that install a certificate independently from Configuration Manager.
For more information about how to create and deploy configuration items for Mac computers, see How to Create Mac Computer Configuration Items in Configuration Manager and How to Deploy Configuration Baselines in Configuration Manager.