465 lines
17 KiB
JavaScript
465 lines
17 KiB
JavaScript
/**
|
|
* @module sign
|
|
*/
|
|
|
|
'use strict'
|
|
|
|
const path = require('path')
|
|
|
|
const Promise = require('bluebird')
|
|
const compareVersion = require('compare-version')
|
|
|
|
const pkg = require('./package.json')
|
|
const util = require('./util')
|
|
const debuglog = util.debuglog
|
|
const debugwarn = util.debugwarn
|
|
const getAppContentsPath = util.getAppContentsPath
|
|
const execFileAsync = util.execFileAsync
|
|
const validateOptsAppAsync = util.validateOptsAppAsync
|
|
const validateOptsPlatformAsync = util.validateOptsPlatformAsync
|
|
const walkAsync = util.walkAsync
|
|
const Identity = require('./util-identities').Identity
|
|
const findIdentitiesAsync = require('./util-identities').findIdentitiesAsync
|
|
const ProvisioningProfile = require('./util-provisioning-profiles').ProvisioningProfile
|
|
const preEmbedProvisioningProfile = require('./util-provisioning-profiles').preEmbedProvisioningProfile
|
|
const preAutoEntitlements = require('./util-entitlements').preAutoEntitlements
|
|
|
|
const osRelease = require('os').release()
|
|
|
|
/**
|
|
* This function returns a promise validating opts.binaries, the additional binaries to be signed along with the discovered enclosed components.
|
|
* @function
|
|
* @param {Object} opts - Options.
|
|
* @returns {Promise} Promise.
|
|
*/
|
|
function validateOptsBinariesAsync (opts) {
|
|
return new Promise(function (resolve, reject) {
|
|
if (opts.binaries) {
|
|
if (!Array.isArray(opts.binaries)) {
|
|
reject(new Error('Additional binaries should be an Array.'))
|
|
return
|
|
}
|
|
// TODO: Presence check for binary files, reject if any does not exist
|
|
}
|
|
resolve()
|
|
})
|
|
}
|
|
|
|
/**
|
|
* This function returns a promise validating all options passed in opts.
|
|
* @function
|
|
* @param {Object} opts - Options.
|
|
* @returns {Promise} Promise.
|
|
*/
|
|
function validateSignOptsAsync (opts) {
|
|
if (opts.ignore && !(opts.ignore instanceof Array)) {
|
|
opts.ignore = [opts.ignore]
|
|
}
|
|
|
|
if (opts['provisioning-profile']) {
|
|
if (typeof opts['provisioning-profile'] !== 'string' && !(opts['provisioning-profile'] instanceof ProvisioningProfile)) return Promise.reject(new Error('Path to provisioning profile should be a string or a ProvisioningProfile object.'))
|
|
}
|
|
|
|
if (opts['type']) {
|
|
if (opts['type'] !== 'development' && opts['type'] !== 'distribution') return Promise.reject(new Error('Type must be either `development` or `distribution`.'))
|
|
} else {
|
|
opts['type'] = 'distribution'
|
|
}
|
|
|
|
return Promise.map([
|
|
validateOptsAppAsync,
|
|
validateOptsPlatformAsync,
|
|
validateOptsBinariesAsync
|
|
], function (validate) {
|
|
return validate(opts)
|
|
})
|
|
}
|
|
|
|
/**
|
|
* This function returns a promise verifying the code sign of application bundle.
|
|
* @function
|
|
* @param {Object} opts - Options.
|
|
* @returns {Promise} Promise resolving output.
|
|
*/
|
|
function verifySignApplicationAsync (opts) {
|
|
// Verify with codesign
|
|
var compareVersion = require('compare-version')
|
|
debuglog('Verifying application bundle with codesign...')
|
|
|
|
var promise = execFileAsync('codesign', [
|
|
'--verify',
|
|
'--deep'
|
|
]
|
|
.concat(
|
|
opts['strict-verify'] !== false &&
|
|
compareVersion(osRelease, '15.0.0') >= 0 // Strict flag since darwin 15.0.0 --> OS X 10.11.0 El Capitan
|
|
? ['--strict' +
|
|
(opts['strict-verify']
|
|
? '=' + opts['strict-verify'] // Array should be converted to a comma separated string
|
|
: '')]
|
|
: [],
|
|
['--verbose=2', opts.app]))
|
|
|
|
// Additionally test Gatekeeper acceptance for darwin platform
|
|
if (opts.platform === 'darwin' && opts['gatekeeper-assess'] !== false) {
|
|
promise = promise
|
|
.then(function () {
|
|
debuglog('Verifying Gatekeeper acceptance for darwin platform...')
|
|
return execFileAsync('spctl', [
|
|
'--assess',
|
|
'--type', 'execute',
|
|
'--verbose',
|
|
'--ignore-cache',
|
|
'--no-cache',
|
|
opts.app
|
|
])
|
|
})
|
|
}
|
|
|
|
return promise
|
|
.thenReturn()
|
|
}
|
|
|
|
/**
|
|
* This function returns a promise codesigning only.
|
|
* @function
|
|
* @param {Object} opts - Options.
|
|
* @returns {Promise} Promise.
|
|
*/
|
|
function signApplicationAsync (opts) {
|
|
return walkAsync(getAppContentsPath(opts))
|
|
.then(function (childPaths) {
|
|
function ignoreFilePath (opts, filePath) {
|
|
if (opts.ignore) {
|
|
return opts.ignore.some(function (ignore) {
|
|
if (typeof ignore === 'function') {
|
|
return ignore(filePath)
|
|
}
|
|
return filePath.match(ignore)
|
|
})
|
|
}
|
|
return false
|
|
}
|
|
|
|
if (opts.binaries) childPaths = childPaths.concat(opts.binaries)
|
|
|
|
var args = [
|
|
'--sign', opts.identity.hash || opts.identity.name,
|
|
'--force'
|
|
]
|
|
if (opts.keychain) {
|
|
args.push('--keychain', opts.keychain)
|
|
}
|
|
if (opts.requirements) {
|
|
args.push('--requirements', opts.requirements)
|
|
}
|
|
if (opts.timestamp) {
|
|
args.push('--timestamp=' + opts.timestamp)
|
|
} else {
|
|
args.push('--timestamp')
|
|
}
|
|
if (opts['signature-size']) {
|
|
if (Number.isInteger(opts['signature-size']) && opts['signature-size'] > 0) {
|
|
args.push('--signature-size', opts['signature-size'])
|
|
} else {
|
|
debugwarn(`Invalid value provided for --signature-size (${opts['signature-size']}). Must be a positive integer.`)
|
|
}
|
|
}
|
|
|
|
let optionsArguments = []
|
|
|
|
if (opts['signature-flags']) {
|
|
if (Array.isArray(opts['signature-flags'])) {
|
|
optionsArguments = [...opts['signature-flags']]
|
|
} else {
|
|
const flags = opts['signature-flags'].split(',').map(function (flag) { return flag.trim() })
|
|
optionsArguments = [...flags]
|
|
}
|
|
}
|
|
|
|
if (opts.hardenedRuntime || opts['hardened-runtime'] || optionsArguments.includes('runtime')) {
|
|
// Hardened runtime since darwin 17.7.0 --> macOS 10.13.6
|
|
if (compareVersion(osRelease, '17.7.0') >= 0) {
|
|
optionsArguments.push('runtime')
|
|
} else {
|
|
// Remove runtime if passed in with --signature-flags
|
|
debuglog('Not enabling hardened runtime, current macOS version too low, requires 10.13.6 and higher')
|
|
optionsArguments = optionsArguments.filter(function (element, index) { return element !== 'runtime' })
|
|
}
|
|
}
|
|
|
|
if (opts['restrict']) {
|
|
optionsArguments.push('restrict')
|
|
debugwarn('This flag is to be deprecated, consider using --signature-flags=restrict instead')
|
|
}
|
|
|
|
if (optionsArguments.length) {
|
|
args.push('--options', [...new Set(optionsArguments)].join(','))
|
|
}
|
|
|
|
var promise
|
|
/**
|
|
* Sort the child paths by how deep they are in the file tree. Some arcane apple
|
|
* logic expects the deeper files to be signed first otherwise strange errors get
|
|
* thrown our way
|
|
*/
|
|
childPaths = childPaths.sort((a, b) => {
|
|
const aDepth = a.split(path.sep).length
|
|
const bDepth = b.split(path.sep).length
|
|
return bDepth - aDepth
|
|
})
|
|
if (opts.entitlements) {
|
|
// Sign with entitlements
|
|
promise = Promise.mapSeries(childPaths, function (filePath) {
|
|
if (ignoreFilePath(opts, filePath)) {
|
|
debuglog('Skipped... ' + filePath)
|
|
return
|
|
}
|
|
debuglog('Signing... ' + filePath)
|
|
|
|
let entitlementsFile = opts['entitlements-inherit']
|
|
if (filePath.includes('Library/LoginItems')) {
|
|
entitlementsFile = opts['entitlements-loginhelper']
|
|
}
|
|
|
|
const clonedArgs = args.concat([]);
|
|
if (opts.entitlementsForFile) {
|
|
entitlementsFile = opts.entitlementsForFile(filePath, clonedArgs) || entitlementsFile
|
|
}
|
|
|
|
return execFileAsync('codesign', clonedArgs.concat('--entitlements', entitlementsFile, filePath))
|
|
})
|
|
.then(function () {
|
|
debuglog('Signing... ' + opts.app)
|
|
|
|
const clonedArgs = args.concat([]);
|
|
let entitlementsFile = opts.entitlements
|
|
if (opts.entitlementsForFile) {
|
|
entitlementsFile = opts.entitlementsForFile(opts.app, clonedArgs) || entitlementsFile;
|
|
}
|
|
|
|
return execFileAsync('codesign', clonedArgs.concat('--entitlements', opts.entitlements, opts.app))
|
|
})
|
|
} else {
|
|
// Otherwise normally
|
|
promise = Promise.mapSeries(childPaths, function (filePath) {
|
|
if (ignoreFilePath(opts, filePath)) {
|
|
debuglog('Skipped... ' + filePath)
|
|
return
|
|
}
|
|
debuglog('Signing... ' + filePath)
|
|
return execFileAsync('codesign', args.concat(filePath))
|
|
})
|
|
.then(function () {
|
|
debuglog('Signing... ' + opts.app)
|
|
return execFileAsync('codesign', args.concat(opts.app))
|
|
})
|
|
}
|
|
|
|
return promise
|
|
.then(function () {
|
|
// Verify code sign
|
|
debuglog('Verifying...')
|
|
var promise = verifySignApplicationAsync(opts)
|
|
.then(function (result) {
|
|
debuglog('Verified.')
|
|
})
|
|
|
|
// Check entitlements if applicable
|
|
if (opts.entitlements) {
|
|
promise = promise
|
|
.then(function () {
|
|
debuglog('Displaying entitlements...')
|
|
return execFileAsync('codesign', [
|
|
'--display',
|
|
'--entitlements', ':-', // Write to standard output and strip off the blob header
|
|
opts.app
|
|
])
|
|
})
|
|
.then(function (result) {
|
|
debuglog('Entitlements:', '\n',
|
|
result)
|
|
})
|
|
}
|
|
|
|
return promise
|
|
})
|
|
})
|
|
}
|
|
|
|
/**
|
|
* This function returns a promise signing the application.
|
|
* @function
|
|
* @param {mixed} opts - Options.
|
|
* @returns {Promise} Promise.
|
|
*/
|
|
var signAsync = module.exports.signAsync = function (opts) {
|
|
debuglog('electron-osx-sign@%s', pkg.version)
|
|
return validateSignOptsAsync(opts)
|
|
.then(function () {
|
|
// Determine identity for signing
|
|
var promise
|
|
if (opts.identity) {
|
|
debuglog('`identity` passed in arguments.')
|
|
if (opts['identity-validation'] === false) {
|
|
if (!(opts.identity instanceof Identity)) {
|
|
opts.identity = new Identity(opts.identity)
|
|
}
|
|
return Promise.resolve()
|
|
}
|
|
promise = findIdentitiesAsync(opts, opts.identity)
|
|
} else {
|
|
debugwarn('No `identity` passed in arguments...')
|
|
if (opts.platform === 'mas') {
|
|
if (opts.type === 'distribution') {
|
|
debuglog('Finding `3rd Party Mac Developer Application` certificate for signing app distribution in the Mac App Store...')
|
|
promise = findIdentitiesAsync(opts, '3rd Party Mac Developer Application:')
|
|
} else {
|
|
debuglog('Finding `Mac Developer` certificate for signing app in development for the Mac App Store signing...')
|
|
promise = findIdentitiesAsync(opts, 'Mac Developer:')
|
|
}
|
|
} else {
|
|
debuglog('Finding `Developer ID Application` certificate for distribution outside the Mac App Store...')
|
|
promise = findIdentitiesAsync(opts, 'Developer ID Application:')
|
|
}
|
|
}
|
|
return promise
|
|
.then(function (identities) {
|
|
if (identities.length > 0) {
|
|
// Identity(/ies) found
|
|
if (identities.length > 1) {
|
|
debugwarn('Multiple identities found, will use the first discovered.')
|
|
} else {
|
|
debuglog('Found 1 identity.')
|
|
}
|
|
opts.identity = identities[0]
|
|
} else {
|
|
// No identity found
|
|
return Promise.reject(new Error('No identity found for signing.'))
|
|
}
|
|
})
|
|
})
|
|
.then(function () {
|
|
// Determine entitlements for code signing
|
|
var filePath
|
|
if (opts.platform === 'mas') {
|
|
// To sign apps for Mac App Store, an entitlements file is required, especially for app sandboxing (as well some other services).
|
|
// Fallback entitlements for sandboxing by default: Note this may cause troubles while running an signed app due to missing keys special to the project.
|
|
// Further reading: https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html
|
|
if (!opts.entitlements) {
|
|
filePath = path.join(__dirname, 'default.entitlements.mas.plist')
|
|
debugwarn('No `entitlements` passed in arguments:', '\n',
|
|
'* Sandbox entitlements are required for Mac App Store distribution, your codesign entitlements file is default to:', filePath)
|
|
opts.entitlements = filePath
|
|
}
|
|
if (!opts['entitlements-inherit']) {
|
|
filePath = path.join(__dirname, 'default.entitlements.mas.inherit.plist')
|
|
debugwarn('No `entitlements-inherit` passed in arguments:', '\n',
|
|
'* Sandbox entitlements file for enclosed app files is default to:', filePath)
|
|
opts['entitlements-inherit'] = filePath
|
|
}
|
|
// The default value for opts['entitlements-file'] will be processed later
|
|
} else {
|
|
// Not necessary to have entitlements for non Mac App Store distribution
|
|
if (!opts.entitlements) {
|
|
debugwarn('No `entitlements` passed in arguments:', '\n',
|
|
'* Provide `entitlements` to specify entitlements file for codesign.')
|
|
} else {
|
|
// If entitlements is provided as a boolean flag, fallback to default
|
|
if (opts.entitlements === true) {
|
|
filePath = path.join(__dirname, 'default.entitlements.darwin.plist')
|
|
debugwarn('`entitlements` not specified in arguments:', '\n',
|
|
'* Provide `entitlements` to specify entitlements file for codesign.', '\n',
|
|
'* Entitlements file is default to:', filePath)
|
|
opts.entitlements = filePath
|
|
}
|
|
if (!opts['entitlements-inherit']) {
|
|
filePath = path.join(__dirname, 'default.entitlements.darwin.inherit.plist')
|
|
debugwarn('No `entitlements-inherit` passed in arguments:', '\n',
|
|
'* Entitlements file for enclosed app files is default to:', filePath)
|
|
opts['entitlements-inherit'] = filePath
|
|
}
|
|
// The default value for opts['entitlements-file'] will be processed later
|
|
}
|
|
}
|
|
})
|
|
.then(function () {
|
|
// Pre-sign operations
|
|
var preSignOperations = []
|
|
|
|
if (opts['pre-embed-provisioning-profile'] === false) {
|
|
debugwarn('Pre-sign operation disabled for provisioning profile embedding:', '\n',
|
|
'* Enable by setting `pre-embed-provisioning-profile` to `true`.')
|
|
} else {
|
|
debuglog('Pre-sign operation enabled for provisioning profile:', '\n',
|
|
'* Disable by setting `pre-embed-provisioning-profile` to `false`.')
|
|
preSignOperations.push(preEmbedProvisioningProfile)
|
|
}
|
|
|
|
if (opts['pre-auto-entitlements'] === false) {
|
|
debugwarn('Pre-sign operation disabled for entitlements automation.')
|
|
} else {
|
|
debuglog('Pre-sign operation enabled for entitlements automation with versions >= `1.1.1`:', '\n',
|
|
'* Disable by setting `pre-auto-entitlements` to `false`.')
|
|
if (opts.entitlements && (!opts.version || compareVersion(opts.version, '1.1.1') >= 0)) {
|
|
// Enable Mac App Store sandboxing without using temporary-exception, introduced in Electron v1.1.1. Relates to electron#5601
|
|
preSignOperations.push(preAutoEntitlements)
|
|
}
|
|
}
|
|
|
|
// preAutoEntitlements may update opts.entitlements,
|
|
// so we wait after it's done before giving opts['entitlements-loginhelper'] its default value
|
|
preSignOperations.push(function (opts) {
|
|
if (opts.entitlements) {
|
|
if (!opts['entitlements-loginhelper']) {
|
|
// Default to App Sandbox enabled
|
|
const filePath = opts.entitlements
|
|
debugwarn('No `entitlements-loginhelper` passed in arguments:', '\n',
|
|
'* Entitlements file for login helper is default to:', filePath)
|
|
opts['entitlements-loginhelper'] = filePath
|
|
}
|
|
}
|
|
})
|
|
|
|
return Promise.mapSeries(preSignOperations, function (preSignOperation) {
|
|
return preSignOperation(opts)
|
|
})
|
|
})
|
|
.then(function () {
|
|
debuglog('Signing application...', '\n',
|
|
'> Application:', opts.app, '\n',
|
|
'> Platform:', opts.platform, '\n',
|
|
'> Entitlements:', opts.entitlements, '\n',
|
|
'> Child entitlements:', opts['entitlements-inherit'], '\n',
|
|
'> Login helper entitlements:', opts['entitlements-loginhelper'], '\n',
|
|
'> Additional binaries:', opts.binaries, '\n',
|
|
'> Identity:', opts.identity)
|
|
return signApplicationAsync(opts)
|
|
})
|
|
.then(function () {
|
|
// Post-sign operations
|
|
debuglog('Application signed.')
|
|
})
|
|
}
|
|
|
|
/**
|
|
* This function is a normal callback implementation.
|
|
* @function
|
|
* @param {Object} opts - Options.
|
|
* @param {RequestCallback} cb - Callback.
|
|
*/
|
|
module.exports.sign = function (opts, cb) {
|
|
signAsync(opts)
|
|
.then(function () {
|
|
debuglog('Application signed: ' + opts.app)
|
|
if (cb) cb()
|
|
})
|
|
.catch(function (err) {
|
|
debuglog('Sign failed:')
|
|
if (err.message) debuglog(err.message)
|
|
else if (err.stack) debuglog(err.stack)
|
|
else debuglog(err)
|
|
if (cb) cb(err)
|
|
})
|
|
}
|