You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-10Lines changed: 8 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,23 +8,21 @@ If you plan on using [AutoPkg](https://github.com/autopkg/autopkg), release 2.2
8
8
9
9
1. Place `SimpleMDMRepo.py` in the `/usr/local/munki/munkilib/munkirepo/` folder.
10
10
11
-
## Usage
11
+
## API Key
12
12
13
-
### API Key
14
-
15
-
#### Generating a Key
13
+
### Generating a Key
16
14
17
15
API keys may be generated within the API section of the SimpleMDM administrator interface. Be sure to grant the key permission for Munki plugin activity.
18
16
19
-
####Setting the Key
17
+
### Setting the Key
20
18
21
19
The plugin attempts to fetch the API key three ways, in order:
22
20
23
21
1. environment variable
24
22
1. configuration file
25
23
1. interactively
26
24
27
-
#####Environment Variable
25
+
#### Environment Variable
28
26
29
27
You may set the key once per terminal session like so:
30
28
@@ -38,7 +36,7 @@ You can also set the key for a single command by prepending it like so:
38
36
SIMPLEMDM_API_KEY="Whvop7kWXxsva326ABDF8VDCSGFyEkuEx2xGgj4jab8AE90cn70QdBTq0fplli0a" autopkg run ...
39
37
```
40
38
41
-
#####Configuration File
39
+
#### Configuration File
42
40
43
41
You may store the key in a configuration file at `/usr/local/simplemdm/munki-plugin/config.plist`. Please scope the permissions on this file so that it is restricted, however still allowing utilities using the repo plugin to access it.
44
42
@@ -55,7 +53,7 @@ The file should be formatted as below. Be sure to provide your own API key:
55
53
</plist>
56
54
```
57
55
58
-
###Using AutoPkg
56
+
## Using AutoPkg
59
57
60
58
Any `.munki` recipe is supported. In this case, we are importing `GoogleChrome.munki`. Be sure to include `extract_icon` if you'd like the icon uploaded to SimpleMDM, if available.
61
59
@@ -65,15 +63,15 @@ Any `.munki` recipe is supported. In this case, we are importing `GoogleChrome.m
65
63
autopkg run -v GoogleChrome.munki -k MUNKI_REPO_PLUGIN="SimpleMDMRepo" -k extract_icon=True
66
64
```
67
65
68
-
###Using munkiimport and manifestutil
66
+
## Using munkiimport and manifestutil
69
67
70
68
**Please Note:** Running makecatalogs is not necessary. See "Using Makecatalogs" below for more information.
71
69
72
70
Before using either of these tools, they must be configured by running `munkiimport --configure` or `manifestutil --configure`. Keep all settings default, except:
73
71
- Set repo url to `BLANK` or some other dummy value, as it is unused.
0 commit comments