Module: Chook::Randomizers

Defined in:
lib/chook/subject/randomizers.rb

Overview

A namespace for holding methods and constants used for creating random data for Test Events and Test Subjects.

Constant Summary collapse

WORDS =
Pathname.new '/usr/share/dict/words'
NAMES =
Pathname.new '/usr/share/dict/propernames'
REST_OPS =
%w(GET POST PUT DELETE).freeze
MOBILE_SERIAL_CHARACTER_SETS =
[
  %w(F D C H),
  %w(4 L Q 7 M 3 K N 2 9 5 C 8 1 X Y 6 0 J F T G D A P R),
  %w(L X T 8 Q 9 K V P 7 R J F 6 G N 3 M 5 Y W 4 1 H 2 C D),
  %w(K M L J H G N F 3 P B Q R S A),
  %w(H 6 4 C G V J 5 T R N K X 1 F L 9 Q 8 W M 2 P D 7 3 Y A),
  %w(J 1 2 8 B W 0 C 4 7 F 5 6 M 3 G A E Q S N R D Z X 9 P K V Y H U T L),
  %w(3 2 S Y V R M Q F J 1 8 9 L 6 H W A 4 0 E T U 5 N 7 X Z K G B D C P),
  %w(V 7 Z R P C G 8 A 2 J X Q 4 D E N B 9 0 H K Y 3 6 1 L T 5 M W F U S),
  %w(F D G 9 7 H 1),
  %w(1 C N K F J 8 R T 2 P V 3 L 4 H 5 0 6 D M X 9 G),
  %w(9 M D 1 J H 8 C 2 F P G W T Y 5 R Q 7 3 V N K X L 6 0),
  %w(6 5 K 4 J W T 2 0 V M Y 9 N 8 3 1 H Q L D R 7 P G C F X)
].freeze
COMPUTER_SERIAL_CHARACTER_SETS =
[
  %w(C),
  %w(0 2 1 P),
  %w(7 2 V M W F Q X),
  %w(K L F G M N J H D P Q R S),
  %w(8 G 5 7 L T M 2 P 9 X 4 K J D W C H F Q V N R 3 6 1 Y),
  %w(1 9 0 7 5 2 6 B A P 4 E 3 K F R G U W C L V 8 J D T X Y M Z N S H),
  %w(9 U 2 S Q H M V Z J G P D N 5 Y X 7 3 E 6 0 K T 4 L C F 8 A B W 1 R),
  %w(4 E N C Y H F A G 1 B 3 0 5 8 M J W L T S D V P R K U 6 Z 2 Q 7 9 X),
  %w(D F G H),
  %w(Y 6 D R H 5 W G F 0 8 T K V L 2 N 3 J 9 1 C Q),
  %w(3 T Q 0 Y P 5 V R 8 4 2 J 7 1 C M H N D F 6 G W),
  %w(H 6 X 4 5 W L J 8 G 3 P 7 T N 9 1 F M V 0 D R K 2 C Y)
].freeze
SAMPLE_MOBILE_MODELS =
[
  'iPhone SE',
  'iPhone 7',
  'iPhone 6S Plus',
  'iPhone 6S',
  'iPhone 6',
  'iPhone 5S (GSM)',
  'iPad Air 2 (CDMA)',
  'iPad Pro (9.7-inch Wi-Fi)',
  'iPhone 6 Plus',
  'iPad Pro (9.7-inch Cellular)',
  'iPhone 5C (GSM)',
  'iPad Air (GSM)',
  'iPhone 7 Plus',
  'iPad Pro (12.9-inch Wi-Fi)',
  'iPad Air (Wi-Fi)',
  'iPhone 5 (GSM)',
  'iPad mini 2nd Generation (GSM)',
  'iPad 3rd Generation (Wi-Fi)',
  'iPad mini 2nd Generation (Wi-Fi)',
  'iPad Air 2 (Wi-Fi)',
  'iPad mini 4 (GSM)',
  'iPod touch (5th Generation)',
  'iPod touch (6th Generation)',
  'iPad Pro (12.9-inch Cellular)',
  'iPhone 5 (CDMA)',
  'iPad 3rd Generation (GSM)',
  'iPhone 4S',
  'iPad 4th Generation (Wi-Fi)',
  'iPad mini 4 (Wi-Fi)',
  'iPad mini 3 (Wi-Fi)',
  'iPhone 4 (GSM)',
  'iPhone 5S (CDMA)',
  'iPad 4th Generation (GSM)',
  'iPad 2 (Wi-Fi)',
  'iPad 4th Generation (CDMA)',
  'iPad (Original)',
  'iPad 2 (GSM)',
  'iPad mini (GSM)',
  'iPhone 5C (CDMA)',
  'iPad 3rd Generation (CDMA)',
  'iPhone3,2',
  'iPad6,11',
  'iPad mini 3 (GSM)',
  'iPad mini (CDMA)'
].freeze
SAMPLE_COMPUTER_MODELS =
[
  'MacBookPro12,1',
  'MacBookAir7,2',
  'MacBookPro11,5',
  'MacPro1,1',
  'MacPro6,1',
  'MacBookAir6,2',
  'MacBookPro11,2',
  'MacBookPro13,3',
  'Xserve3,1',
  'MacPro4,1',
  'Macmini3,1',
  'iMac15,1',
  'MacBookPro11,1',
  'MacBook9,1',
  'Macmini4,1',
  'MacPro5,1',
  'Xserve1,1',
  'MacPro3,1',
  'Macmini1,1',
  'iMac14,2',
  'Macmini6,2',
  'Macmini7,1',
  'MacBookAir6,1',
  'MacBook4,1',
  'iMac11,1',
  'MacBookPro1,1',
  'MacBookPro5,3',
  'iMac7,1',
  'MacBookAir5,2',
  'iMac13,2',
  'VMware7,1',
  'MacBook5,2',
  'MacBookPro13,2',
  'iMac11,3',
  'MacBookPro7,1',
  'MacBookPro11,3',
  'MacBookPro9,2',
  'MacBookAir3,1',
  'iMac11,2',
  'MacBookPro6,2',
  'MacBookPro9,1',
  'MacBookPro8,2',
  'MacBookPro13,1',
  'iMac12,2',
  'MacBookPro8,1',
  'MacBook7,1',
  'iMac14,1',
  'Macmini5,2',
  'iMac13,1',
  'iMac12,1',
  'iMac17,1',
  'MacBookAir7,1',
  'MacBookPro10,1',
  'MacBookAir5,1',
  'MacBookAir4,2',
  'Macmini5,1',
  'Xserve2,1',
  '“MacPro6,1”'
].freeze
PUSH_COMMANDS =

Keeping this set of PUSH_COMMANDS in here just in case JAMF decides to make the Push webhooks more useful… PUSH_COMMANDS = [

'Settings',
'DeviceLock',
'EraseDevice',
'ClearPasscode',
'UnmanageDevice',
'UpdateInventory',
'ClearRestrictionsPassword',
'SettingsEnableDataRoaming',
'SettingsDisableDataRoaming',
'SettingsEnableVoiceRoaming',
'SettingsDisableVoiceRoaming',
'SettingsEnableAppAnalytics',
'SettingsDisableAppAnalytics',
'SettingsEnableDiagnosticSubmission',
'SettingsDisableDiagnosticSubmission',
'BlankPush',
'Wallpaper', # supervised only
'DeviceName', # supervised only
'ShutDownDevice', # supervised only
'RestartDevice', # supervised only
'PasscodeLockGracePeriod' # shared iPad only

].freeze

%w(MobileDevicePushSent PushSent).freeze
PATCH_SOFTWARE_TITLES =

A full list of supported titles is unfortunately not available via the API :(

[
  'Adobe AIR',
  'Adobe Acrobat Pro DC',
  'Adobe Acrobat Pro XI',
  'Adobe Acrobat Reader DC',
  'Adobe Acrobat Reader XI',
  'Adobe After Effects CC',
  'Adobe Bridge CC	Adobe',
  'Adobe Core Components',
  'Adobe Dreamweaver CC',
  'Adobe Fireworks CS6',
  'Adobe Flash Player',
  'Adobe Illustrator CC',
  'Adobe InDesign CC',
  'Adobe Photoshop CC',
  'Adobe Photoshop Lightroom CC',
  'Adobe Prelude CC',
  'Adobe Premiere Pro CC',
  'Adobe Shockwave Player',
  'Google Chrome',
  'Java SE Development Kit 7',
  'Java SE Development Kit 8',
  'Java SE Runtime Environment JRE 7',
  'Java SE Runtime Environment JRE 8',
  'McAfee Endpoint Security for Mac',
  'Microsoft AutoUpdate',
  'Microsoft Excel 2016',
  'Microsoft OneNote 2016',
  'Microsoft Outlook 2016',
  'Microsoft PowerPoint 2016',
  'Microsoft Silverlight',
  'Microsoft Word 2016',
  'Mozilla Firefox Extended Support Release (ESR)',
  'Mozilla Firefox',
  'Skype',
  'Skype for Business'
].freeze

Class Method Summary collapse

Class Method Details

.boolBoolean

Random Boolean

Returns:

  • (Boolean)

    True or False


434
435
436
# File 'lib/chook/subject/randomizers.rb', line 434

def self.bool
  rand(0..1).zero?
end

.computer_modelString

Computer Model (wrapper)

Returns:

  • (String)

    Randomly selected Computer model


381
382
383
# File 'lib/chook/subject/randomizers.rb', line 381

def self.computer_model
  model
end

.computer_os_versionString

Computer OS Version (wrapper)

Returns:

  • (String)

    Operating System Version from a Computer in the JSS


418
419
420
# File 'lib/chook/subject/randomizers.rb', line 418

def self.computer_os_version
  os_version
end

.computer_serial_numberString

Computer Serial Number

Returns:

  • (String)

    Valid Computer Serial Number


271
272
273
# File 'lib/chook/subject/randomizers.rb', line 271

def self.computer_serial_number
  serial_number_from COMPUTER_SERIAL_CHARACTER_SETS
end

.computer_udidString

Computer UUID (wrapper)

Returns:

  • (String)

    Randomly generated computer UUID formatted String


312
313
314
# File 'lib/chook/subject/randomizers.rb', line 312

def self.computer_udid
  udid
end

.email_addressString

Random Email

Returns:


241
242
243
# File 'lib/chook/subject/randomizers.rb', line 241

def self.email_address
  name.gsub(' ','.') + '@' + word + '.com'
end

.hostString

Random hostname-formatted String

Returns:

  • (String)

    A random hostname-formatted String


500
501
502
# File 'lib/chook/subject/randomizers.rb', line 500

def self.host
  "#{word}.#{word}.com"
end

.iccidString

Random ICCID

Returns:

  • (String)

    Randomly generated ICCID formatted number String


352
353
354
# File 'lib/chook/subject/randomizers.rb', line 352

def self.iccid
  int(20).to_s.scan(/.{4}/).join(' ')
end

.imeiString

Random IMEI

Returns:

  • (String)

    Randomly generated IMEI formatted number String


341
342
343
344
345
346
# File 'lib/chook/subject/randomizers.rb', line 341

def self.imei
  indexes = [2, 9, 16]
  imei = int(15).to_s
  indexes.each { |idx| imei.insert(idx, ' ') }
  imei
end

.int(x = 1) ⇒ Integer

Random Int

Parameters:

  • Optionally (Integer)

    choose the length of the returned random Integer

Returns:

  • (Integer)

    Randomized number of an optionally specified length


250
251
252
253
254
# File 'lib/chook/subject/randomizers.rb', line 250

def self.int(x = 1)
  startpoint = 10**(x - 1)
  endpoint = (10**x) - 1
  rand(startpoint..endpoint)
end

.mac_addressString

Random MAC Address

Returns:

  • (String)

    Randomly generated MAC address formatted String


333
334
335
# File 'lib/chook/subject/randomizers.rb', line 333

def self.mac_address
  SecureRandom.hex(6).upcase.scan(/.{2}/).join(':')
end

.mobile_modelString

Mobile Model (wrapper)

Returns:

  • (String)

    Randomly selected MobileDevice model


373
374
375
# File 'lib/chook/subject/randomizers.rb', line 373

def self.mobile_model
  model(true)
end

.mobile_os_versionString

Mobile OS Version (wrapper)

Returns:

  • (String)

    Operating System Version from a MobileDevice in the JSS


410
411
412
# File 'lib/chook/subject/randomizers.rb', line 410

def self.mobile_os_version
  os_version(true)
end

.mobile_serial_numberString

Mobile Serial Number (wrapper)

Returns:

  • (String)

    Valid Mobile Device Serial Number


279
280
281
# File 'lib/chook/subject/randomizers.rb', line 279

def self.mobile_serial_number
  serial_number_from MOBILE_SERIAL_CHARACTER_SETS
end

.mobile_udidString

Mobile UDID (wrapper)

Returns:

  • (String)

    Randomly generated mobile UDID formatted String


320
321
322
# File 'lib/chook/subject/randomizers.rb', line 320

def self.mobile_udid
  udid(true)
end

.model(mobile = false) ⇒ String

Random Model

Parameters:

  • mobile (Boolean) (defaults to: false)

    Returns a valid Computer model by default, mobile: true returns a valid Mobile Device model

Returns:

  • (String)

    Randomly selected Computer or MobileDevice model


361
362
363
364
365
366
367
# File 'lib/chook/subject/randomizers.rb', line 361

def self.model(mobile = false)
  if mobile
    SAMPLE_MOBILE_MODELS.sample
  else
    SAMPLE_COMPUTER_MODELS.sample
  end
end

.nameString

Random Name

Returns:

  • (String)

    Randomly generated US English formatted “FirstName LastName”.


233
234
235
# File 'lib/chook/subject/randomizers.rb', line 233

def self.name
  NAMES.read.lines.sample.chomp + ' ' + NAMES.read.lines.sample.chomp
end

.os_buildString

Random OS Build

Returns:

  • (String)

    Randomized OS build string


426
427
428
# File 'lib/chook/subject/randomizers.rb', line 426

def self.os_build
  SecureRandom.hex(3).upcase
end

.os_version(mobile = false) ⇒ Type

Random OS Version

Parameters:

  • mobile (Boolean) (defaults to: false)

    Returns a randomized Computer OS version by default, mobile: true returns a randomized Mobile Device OS version

Returns:

  • (Type)

    String


398
399
400
401
402
403
404
# File 'lib/chook/subject/randomizers.rb', line 398

def self.os_version(mobile = false)
  if mobile
    [rand(4..11), int, int].join('.')
  else
    [10, rand(6..15), int].join('.')
  end
end

.patchString

Random Patch Software Title

Returns:

  • (String)

    Random Patch Software Title


476
477
478
# File 'lib/chook/subject/randomizers.rb', line 476

def self.patch
  PATCH_SOFTWARE_TITLES.sample
end

.phoneString

Random Phone Number

Returns:

  • (String)

    Random US-formatted Phone Number


450
451
452
453
454
# File 'lib/chook/subject/randomizers.rb', line 450

def self.phone
  raw_phone = int(10).to_s.split(//)
  [3, 7].each { |index| raw_phone.insert(index, '-') }
  raw_phone.join('')
end

.productObject

Product is null in the sample JSONs… And there isn't anything labeled “product” in JSS::API.get_rsrc(“mobiledevices/id/#id”)


325
326
327
# File 'lib/chook/subject/randomizers.rb', line 325

def self.product
  nil
end

.pushString

Random Push Command

Returns:

  • (String)

    Random Push Command from PUSH_COMMANDS


468
469
470
# File 'lib/chook/subject/randomizers.rb', line 468

def self.push
  PUSH_COMMANDS.sample
end

.rest_operationString

Random REST Operation

Returns:

  • (String)

    Random GET, POST, PUT, or DELETE


442
443
444
# File 'lib/chook/subject/randomizers.rb', line 442

def self.rest_operation
  REST_OPS.sample
end

.roomString

Random Room Number

Returns:

  • (String)

    Random Room Number


460
461
462
# File 'lib/chook/subject/randomizers.rb', line 460

def self.room
  int((1..4).to_a.sample).to_s
end

.serial_number_from(dataset) ⇒ String

Random Serial Number

Parameters:

  • A (Array<Array>)

    dataset for generating a serial number

Returns:

  • (String)

    Valid Computer or Mobile Device Serial Number


261
262
263
264
265
# File 'lib/chook/subject/randomizers.rb', line 261

def self.serial_number_from(dataset)
  serial = ''
  dataset.each { |pos| serial << pos.sample }
  serial
end

.timeTime

Random Time (for lastUpdate in Patch Software Update subject)

Returns:

  • (Time)

    A random date and time


484
485
486
# File 'lib/chook/subject/randomizers.rb', line 484

def self.time
  Time.at(rand * Time.now.to_i)
end

.udid(mobile = false) ⇒ String

Random U*ID MobileDevice UDID and Mac UUID are poorly distingusished in Jamf Pro. In a Jamf Pro Computer record, the “UDID” in the web interface corresponds to the Hardware UUID. On a Jamf Pro MobileDevice record, the UDID is actually a UDID. Since these are actually different things, they are generated differently.

Returns:

  • (String)

    Randomly generated UUID/UDID formatted String


291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
# File 'lib/chook/subject/randomizers.rb', line 291

def self.udid(mobile = false)
  if mobile
    # UDID = SHA1(serial + IMEI + wifiMac + bluetoothMac)
    Digest::SHA1.hexdigest(serial_number(mobile: true) + int(15).to_s + mac_address + mac_address)
  else
    # UUID
    # In its canonical textual representation, the sixteen octets of a UUID are represented as 32 hexadecimal (base 16) digits
    # displayed in five groups separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 alphanumeric characters and four hyphens).
    # For example:
    # 123e4567-e89b-12d3-a456-426655440000
    indexes = [8, 13, 18, 23]
    uuid = SecureRandom.hex(16).upcase
    indexes.each { |idx| uuid.insert(idx, '-') }
    uuid.upcase
  end
end

.urlString

Random URL-formatted String

Returns:

  • (String)

    A random URL-formatted String


492
493
494
# File 'lib/chook/subject/randomizers.rb', line 492

def self.url
  "http://www.#{word}.com:#{int}"
end

.versionString

Version

Returns:

  • (String)

    Carrier Settings Version formatted String


389
390
391
# File 'lib/chook/subject/randomizers.rb', line 389

def self.version
  [int(2), int].join('.')
end

.wordString

Random Word Use this to generate device or username Strings

Returns:

  • (String)

    Randomly generated US English word to stand in for a username, device name, etc.


225
226
227
# File 'lib/chook/subject/randomizers.rb', line 225

def self.word
  WORDS.read.lines.sample.chomp
end