mirror of
https://github.com/apple/device-management.git
synced 2026-07-10 21:13:42 +02:00
Cyrus Daboo
74 lines
2.5 KiB
YAML
74 lines
2.5 KiB
YAML
title: Asset:Data
|
|
description: A reference to arbitrary data with a specific media type.
|
|
payload:
|
|
declarationtype: com.apple.asset.data
|
|
supportedOS:
|
|
iOS:
|
|
introduced: '17.0'
|
|
macOS:
|
|
introduced: '14.0'
|
|
tvOS:
|
|
introduced: '17.0'
|
|
visionOS:
|
|
introduced: '1.1'
|
|
watchOS:
|
|
introduced: '10.0'
|
|
payloadkeys:
|
|
- key: Reference
|
|
title: External reference
|
|
type: <dictionary>
|
|
presence: required
|
|
content: The external reference.
|
|
subkeys:
|
|
- key: DataURL
|
|
title: Data URL
|
|
type: <string>
|
|
presence: required
|
|
content: The URL to retrieve data, which needs to start with `https://`.
|
|
- key: ContentType
|
|
title: Content type
|
|
type: <string>
|
|
presence: optional
|
|
content: The media type that describes the data. If present, the system checks
|
|
the actual media type of the downloaded data, and an error occurs if the values
|
|
don't match.
|
|
- key: Size
|
|
title: Size
|
|
type: <integer>
|
|
presence: optional
|
|
content: The size of the data. Set the size to `0` if there's no expectation of
|
|
a response body. If present, the system checks the actual size of the downloaded
|
|
data, and an error occurs if the values don't match.
|
|
- key: Hash-SHA-256
|
|
title: SHA-256 hash
|
|
type: <string>
|
|
presence: optional
|
|
content: A SHA-256 hash of the data stored at the `DataURL`. Don't set this value
|
|
if `Size` is `0` as the client ignores it. However, if present, the system checks
|
|
the actual hash of the downloaded data, and an error occurs if the values don't
|
|
match.
|
|
- key: Authentication
|
|
title: Server authentication
|
|
type: <dictionary>
|
|
presence: optional
|
|
content: The server authentication details. If this key is absent, the default authentication
|
|
type is MDM.
|
|
subkeys:
|
|
- key: Type
|
|
title: Authentication type
|
|
type: <string>
|
|
presence: required
|
|
rangelist:
|
|
- MDM
|
|
- None
|
|
content: |-
|
|
The type of authentication, which has these allowed values:
|
|
- `MDM`: A request that uses MDM semantics, which includes the device-identity certificate, and any user authentication. This is equivalent to an MDM request made to the `CheckInURL` or `ServerURL`. This option is only available through declarative device management.
|
|
- `None`: A standard GET request.
|
|
|
|
If the `Authentication` dictionary is absent, the default authentication type is MDM.
|
|
examples:
|
|
title: Asset example
|
|
files:
|
|
- file: examples/declarative/declarations/assets/data/example1.json
|