Class: AppInfo::MobileProvision

Inherits:
File
  • Object
show all
Defined in:
lib/app_info/mobile_provision.rb

Overview

Apple code signing: provisioning profile parser

See Also:

Instance Attribute Summary

Attributes inherited from File

#file, #logger

Instance Method Summary collapse

Methods inherited from File

#device, #format, #initialize, #not_implemented_error!, #size

Constructor Details

This class inherits a constructor from AppInfo::File

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method_name, *args, &block) ⇒ Object 



254
255
256
257
258
 
# File 'lib/app_info/mobile_provision.rb', line 254

def method_missing(method_name, *args, &block)
  mobileprovision.try(:[], method_name.to_s.ai_camelcase) ||
    mobileprovision.send(method_name) ||
    super
end

Instance Method Details

#[](key) ⇒ String? 



233
234
235
 
# File 'lib/app_info/mobile_provision.rb', line 233

def [](key)
  mobileprovision.try(:[], key.to_s)
end

#adhoc? ⇒ Boolea 



141
142
143
144
145
 
# File 'lib/app_info/mobile_provision.rb', line 141

def adhoc?
  return false if platform == Platform::MACOS # macOS no need adhoc

  !development? && !devices.nil?
end

#app_name ⇒ String? 



33
34
35
 
# File 'lib/app_info/mobile_provision.rb', line 33

def app_name
  mobileprovision.try(:[], 'AppIDName')
end

#appstore? ⇒ Boolea

Detect app store type

See Also:



129
130
131
132
133
134
135
136
137
138
 
# File 'lib/app_info/mobile_provision.rb', line 129

def appstore?
  case platform
  when Platform::IOS
    !development? && entitlements.key?('beta-reports-active')
  when Platform::MACOS
    !development?
  else
    raise NotImplementedError, "Unknown platform: #{platform}"
  end
end

#certificates ⇒ Array<Certificate>

return developer certificates.



101
102
103
104
105
106
107
108
 
# File 'lib/app_info/mobile_provision.rb', line 101

def certificates
  certs = mobileprovision.try(:[], 'DeveloperCertificates')
  return if certs.empty?

  certs.each_with_object([]) do |cert_data, obj|
    obj << Certificate.parse(cert_data)
  end
end

#created_date ⇒ String? 



77
78
79
 
# File 'lib/app_info/mobile_provision.rb', line 77

def created_date
  mobileprovision.try(:[], 'CreationDate')
end

#developer_certs ⇒ Object

Deprecated.

Use #certificates instead of this method.

return developer certificates.



94
95
96
 
# File 'lib/app_info/mobile_provision.rb', line 94

def developer_certs
  certificates
end

#development? ⇒ Boolea

Detect is development type of mobileprovision

See Also:



114
115
116
117
118
119
120
121
122
123
 
# File 'lib/app_info/mobile_provision.rb', line 114

def development?
  case platform
  when Platform::IOS
    entitlements['get-task-allow'] == true
  when Platform::MACOS
    !devices.nil?
  else
    raise NotImplementedError, "Unknown platform: #{platform}"
  end
end

#devices ⇒ Array<String>? 



57
58
59
 
# File 'lib/app_info/mobile_provision.rb', line 57

def devices
  mobileprovision.try(:[], 'ProvisionedDevices')
end

#empty? ⇒ Boolea 



238
239
240
 
# File 'lib/app_info/mobile_provision.rb', line 238

def empty?
  mobileprovision.nil?
end

#enabled_capabilities ⇒ Array<String>

Enabled Capabilites

See Also:



159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
 
# File 'lib/app_info/mobile_provision.rb', line 159

def enabled_capabilities
  capabilities = []
  capabilities << 'In-App Purchase' << 'GameKit' if adhoc? || appstore?

  entitlements.each_key do |key|
    case key
    when 'aps-environment'
      capabilities << 'Push Notifications'
    when 'com.apple.developer.applesignin'
      capabilities << 'Sign In with Apple'
    when 'com.apple.developer.siri'
      capabilities << 'SiriKit'
    when 'com.apple.security.application-groups'
      capabilities << 'App Groups'
    when 'com.apple.developer.associated-domains'
      capabilities << 'Associated Domains'
    when 'com.apple.developer.default-data-protection'
      capabilities << 'Data Protection'
    when 'com.apple.developer.networking.networkextension'
      capabilities << 'Network Extensions'
    when 'com.apple.developer.networking.vpn.api'
      capabilities << 'Personal VPN'
    when 'com.apple.developer.healthkit',
        'com.apple.developer.healthkit.access'
      capabilities << 'HealthKit' unless capabilities.include?('HealthKit')
    when 'com.apple.developer.icloud-services',
        'com.apple.developer.icloud-container-identifiers'
      capabilities << 'iCloud' unless capabilities.include?('iCloud')
    when 'com.apple.developer.in-app-payments'
      capabilities << 'Apple Pay'
    when 'com.apple.developer.homekit'
      capabilities << 'HomeKit'
    when 'com.apple.developer.user-fonts'
      capabilities << 'Fonts'
    when 'com.apple.developer.pass-type-identifiers'
      capabilities << 'Wallet'
    when 'inter-app-audio'
      capabilities << 'Inter-App Audio'
    when 'com.apple.developer.networking.multipath'
      capabilities << 'Multipath'
    when 'com.apple.developer.authentication-services.autofill-credential-provider'
      capabilities << 'AutoFill Credential Provider'
    when 'com.apple.developer.networking.wifi-info'
      capabilities << 'Access WiFi Information'
    when 'com.apple.external-accessory.wireless-configuration'
      capabilities << 'Wireless Accessory Configuration'
    when 'com.apple.developer.kernel.extended-virtual-addressing'
      capabilities << 'Extended Virtual Address Space'
    when 'com.apple.developer.nfc.readersession.formats'
      capabilities << 'NFC Tag Reading'
    when 'com.apple.developer.ClassKit-environment'
      capabilities << 'ClassKit'
    when 'com.apple.developer.networking.HotspotConfiguration'
      capabilities << 'Hotspot'
    when 'com.apple.developer.devicecheck.appattest-environment'
      capabilities << 'App Attest'
    when 'com.apple.developer.coremedia.hls.low-latency'
      capabilities << 'Low Latency HLS'
    when 'com.apple.developer.associated-domains.mdm-managed'
      capabilities << 'MDM Managed Associated Domains'
    # macOS Only
    when 'com.apple.developer.maps'
      capabilities << 'Maps'
    when 'com.apple.developer.system-extension.install'
      capabilities << 'System Extension'
    when 'com.apple.developer.networking.custom-protocol'
      capabilities << 'Custom Network Protocol'
    end
  end

  capabilities
end

#enterprise? ⇒ Boolea Also known as: inhouse? 



148
149
150
151
152
 
# File 'lib/app_info/mobile_provision.rb', line 148

def enterprise?
  return false if platform == Platform::MACOS # macOS no need adhoc

  !development? && !adhoc? && !appstore?
end

#entitlements ⇒ Array<String>? 



87
88
89
 
# File 'lib/app_info/mobile_provision.rb', line 87

def entitlements
  mobileprovision.try(:[], 'Entitlements')
end

#expired_date ⇒ String? 



82
83
84
 
# File 'lib/app_info/mobile_provision.rb', line 82

def expired_date
  mobileprovision.try(:[], 'ExpirationDate')
end

#manufacturer ⇒ Symbol 



11
12
13
 
# File 'lib/app_info/mobile_provision.rb', line 11

def manufacturer
  Manufacturer::APPLE
end

#mobileprovision ⇒ CFPropertyList 



243
244
245
246
247
248
249
250
251
252
 
# File 'lib/app_info/mobile_provision.rb', line 243

def mobileprovision
  return @mobileprovision = nil unless ::File.exist?(@file)

  data = ::File.read(@file)
  data = strip_plist_wrapper(data) unless bplist?(data)
  list = CFPropertyList::List.new(data: data).value
  @mobileprovision = CFPropertyList.native_types(list)
rescue CFFormatError
  @mobileprovision = nil
end

#name ⇒ String? 



28
29
30
 
# File 'lib/app_info/mobile_provision.rb', line 28

def name
  mobileprovision.try(:[], 'Name')
end

#platform ⇒ Symbol 



16
17
18
19
20
21
22
23
24
25
 
# File 'lib/app_info/mobile_provision.rb', line 16

def platform
  case platforms[0]
  when :macos
    Platform::MACOS
  when :ios
    Platform::IOS
  else
    raise NotImplementedError, "Unkonwn platform: #{platforms[0]}"
  end
end

#platforms ⇒ Array<Symbol> 



47
48
49
50
51
52
53
54
 
# File 'lib/app_info/mobile_provision.rb', line 47

def platforms
  return unless platforms = mobileprovision.try(:[], 'Platform')

  platforms.map do |v|
    v = 'macOS' if v == 'OSX'
    v.downcase.to_sym
  end
end

#profile_name ⇒ String? 



72
73
74
 
# File 'lib/app_info/mobile_provision.rb', line 72

def profile_name
  mobileprovision.try(:[], 'Name')
end

#respond_to_missing?(method_name, *args) ⇒ Boolean 



260
261
262
263
264
 
# File 'lib/app_info/mobile_provision.rb', line 260

def respond_to_missing?(method_name, *args)
  mobileprovision.key?(method_name.to_s.ai_camelcase) ||
    mobileprovision.respond_to?(method_name) ||
    super
end

#team_identifier ⇒ String? 



62
63
64
 
# File 'lib/app_info/mobile_provision.rb', line 62

def team_identifier
  mobileprovision.try(:[], 'TeamIdentifier')
end

#team_name ⇒ String? 



67
68
69
 
# File 'lib/app_info/mobile_provision.rb', line 67

def team_name
  mobileprovision.try(:[], 'TeamName')
end

#type ⇒ Symbol? 



38
39
40
41
42
43
44
 
# File 'lib/app_info/mobile_provision.rb', line 38

def type
  return :development if development?
  return :adhoc if adhoc?
  return :appstore if appstore?

  :enterprise if enterprise?
end