snipe2jamf/snipe2jamf.example.yaml at main · CampusTech/snipe2jamf · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
snipeit:
  url: "https://your-instance.snipe-it.io"
  token: "your-snipe-it-api-token"

jamf:
  instance_domain: "https://your-instance.jamfcloud.com"
  client_id: "your-client-id"
  client_secret: "your-client-secret"

# How to match Snipe-IT assets to Jamf devices.
# Default matches on serial number (recommended).
matching:
  snipe_field: serial          # Snipe-IT field
  jamf_field: serial_number    # Jamf field

# Source fields (Snipe-IT) — same for computers and mobile devices:
#   Standard: serial, name, asset_tag, model_number, order_number, notes,
#             purchase_date, purchase_cost, warranty_months, supplier.name
#   Custom:   custom_fields._snipeit_fieldname_N
#   Static:   use "value" instead of "source" for constant values
#
# Transforms (optional):
#   prefix:STR       - prepend a string (e.g. prefix:$ for currency)
#   months_to_years  - convert months to years (integer division by 12)
#   warranty_to_date - convert warranty_months to expiry date using purchase_date
#   date:FORMAT      - reformat date (Go time format, e.g. date:2006-01-02)
#   string           - pass through as string
#   float            - validate as float
#   int              - validate as integer
#   bool             - normalize to "true"/"false"

# ──────────────────────────────────────────────
# Computer mappings (Snipe-IT -> Jamf Pro Computers)
# ──────────────────────────────────────────────
# Target fields:
#   Purchasing: purchasing.poNumber, purchasing.poDate, purchasing.vendor,
#               purchasing.warrantyDate, purchasing.appleCareId,
#               purchasing.leaseDate, purchasing.purchasePrice,
#               purchasing.lifeExpectancy, purchasing.purchasingAccount,
#               purchasing.purchasingContact, purchasing.leased, purchasing.purchased
#   General:    general.assetTag, general.barcode1, general.barcode2
#   Extension:  extensionAttributes.<Attribute Name>
computers:
  mappings:
    - source: purchase_date
      target: purchasing.poDate

    - source: purchase_cost
      target: purchasing.purchasePrice
      transform: "prefix:$"

    - source: order_number
      target: purchasing.poNumber

    - source: supplier.name
      target: purchasing.vendor

    - source: asset_tag
      target: general.assetTag

    # Static value — mark all synced devices as "Purchased"
    - value: "true"
      target: purchasing.purchased

    # Convert warranty months to life expectancy in years
    - source: warranty_months
      target: purchasing.lifeExpectancy
      transform: months_to_years

    # Snipe-IT custom fields -> Jamf Purchasing
    # - source: custom_fields._snipeit_warranty_id_5
    #   target: purchasing.appleCareId

    # - source: custom_fields._snipeit_warranty_end_date_4
    #   target: purchasing.warrantyDate

    # Snipe-IT custom fields -> Jamf Extension Attributes
    # - source: custom_fields._snipeit_storage_3
    #   target: extensionAttributes.Storage

# ──────────────────────────────────────────────
# Mobile Device mappings (Snipe-IT -> Jamf Pro Mobile Devices)
# ──────────────────────────────────────────────
# Supports iOS, iPadOS, tvOS, watchOS, and visionOS devices.
# The purchasing section is nested under the device type automatically.
#
# Target fields:
#   Top-level:  name, assetTag
#   Purchasing: purchasing.poNumber, purchasing.poDate, purchasing.vendor,
#               purchasing.warrantyExpiresDate, purchasing.appleCareId,
#               purchasing.leaseExpiresDate, purchasing.purchasePrice,
#               purchasing.lifeExpectancy, purchasing.purchasingAccount,
#               purchasing.purchasingContact, purchasing.leased, purchasing.purchased
#   Extension:  extensionAttributes.<Attribute Name>
#
# NOTE: Mobile devices use "warrantyExpiresDate" and "leaseExpiresDate"
#       (not "warrantyDate" and "leaseDate" like computers).
mobile_devices:
  mappings:
    - source: purchase_date
      target: purchasing.poDate

    - source: purchase_cost
      target: purchasing.purchasePrice
      transform: "prefix:$"

    - source: order_number
      target: purchasing.poNumber

    - source: supplier.name
      target: purchasing.vendor

    - source: asset_tag
      target: assetTag

    - value: "true"
      target: purchasing.purchased

    - source: warranty_months
      target: purchasing.lifeExpectancy
      transform: months_to_years

    # - source: custom_fields._snipeit_warranty_id_5
    #   target: purchasing.appleCareId

    # - source: custom_fields._snipeit_warranty_end_date_4
    #   target: purchasing.warrantyExpiresDate