Skip to content

Commit c530318

Browse files
committed
Add documentation for Configuration Profiles
1 parent 990bf3f commit c530318

File tree

1 file changed

+82
-0
lines changed
  • content/manuals/security/for-admins/enforce-sign-in

1 file changed

+82
-0
lines changed

content/manuals/security/for-admins/enforce-sign-in/methods.md

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,88 @@ There are many ways to deploy the registry key, for example using an MDM solutio
4747
7. Test the GPO. Test the GPO on a small set of machines first to ensure it behaves as expected. You can use the `gpupdate /force` command on a test machine to manually refresh its group policy settings and check the registry to confirm the changes.
4848
8. Once verified, you can proceed with broader deployment. Monitor the deployment to ensure the settings are applied correctly across the organization's computers.
4949

50+
## Configuration Profiles method (Mac only)
51+
52+
> [!NOTE]
53+
>
54+
> The configuration profiles method is available with Docker Desktop version 4.35 and later.
55+
56+
Configuration Profiles are a feature of macOS that allows administrators to distribute
57+
configuration information to the Macs they manage. Is is the safest method to
58+
enforce sign-in on macOS because the installed configuration profiles are
59+
protected by Apples' System Integrity Protection (SIP) and can therefore not be
60+
tampered with by the users.
61+
62+
1. Save the the following XML code to a file with the suffix `.mobileconfig` (e.g.
63+
`docker.mobileconfig`):
64+
65+
66+
```xml
67+
<?xml version="1.0" encoding="UTF-8"?>
68+
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
69+
<plist version="1.0">
70+
<dict>
71+
<key>PayloadContent</key>
72+
<array>
73+
<dict>
74+
<key>PayloadType</key>
75+
<string>com.docker.config</string>
76+
<key>PayloadVersion</key>
77+
<integer>1</integer>
78+
<key>PayloadIdentifier</key>
79+
<string>com.docker.config</string>
80+
<key>PayloadUUID</key>
81+
<string>eed295b0-a650-40b0-9dda-90efb12be3c7</string>
82+
<key>PayloadDisplayName</key>
83+
<string>Docker Desktop Configuration</string>
84+
<key>PayloadDescription</key>
85+
<string>Configuration profile to manage Docker Desktop settings.</string>
86+
<key>PayloadOrganization</key>
87+
<string>Your Company Name</string>
88+
<key>allowedOrgs</key>
89+
<string>first_org;second_org</string>
90+
</dict>
91+
</array>
92+
<key>PayloadType</key>
93+
<string>Configuration</string>
94+
<key>PayloadVersion</key>
95+
<integer>1</integer>
96+
<key>PayloadIdentifier</key>
97+
<string>com.yourcompany.docker.config</string>
98+
<key>PayloadUUID</key>
99+
<string>0deedb64-7dc9-46e5-b6bf-69d64a9561ce</string>
100+
<key>PayloadDisplayName</key>
101+
<string>Docker Desktop Config Profile</string>
102+
<key>PayloadDescription</key>
103+
<string>Config profile to enforce Docker Desktop settings for allowed organizations.</string>
104+
<key>PayloadOrganization</key>
105+
<string>Your Company Name</string>
106+
</dict>
107+
</plist>
108+
```
109+
110+
2. Change the placeholder `Your Company Name` to the name of your company.
111+
112+
3. The names of the allowed organizations are stored in the `allowedOrgs`
113+
property. It can contain either the name of a single organization
114+
115+
```xml
116+
<key>allowedOrgs</key>
117+
<string>yourcompany</string>
118+
```
119+
120+
or a list of organization names, separated by semicolon:
121+
122+
123+
```xml
124+
<key>allowedOrgs</key>
125+
<string>first_org;second_org</string>
126+
```
127+
128+
4. Use a MDM solution to distribute your modified `.mobileconfig` file to your
129+
macOS clients. Sign-in is now enforced on all of those devices.
130+
131+
50132
## plist method (Mac only)
51133

52134
> [!NOTE]

0 commit comments

Comments
 (0)