InstallAppleCertificate@2 - Installare l'attività Certificato Apple v2
Usare questa attività per installare il certificato Apple necessario per compilare un agente macOS. È possibile usare questa attività per installare un certificato Apple archiviato come file sicuro nel server.
Installare un certificato Apple necessario per compilare in un agente macOS.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password.
#customKeychainPath: # string. Required when keychain = custom. Custom keychain path.
#deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain.
#deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain.
#signingIdentity: # string. Certificate signing identity.
#setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key.
#opensslPkcsArgs: # string. OpenSSL arguments for PKCS12.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password.
#customKeychainPath: # string. Required when keychain = custom. Custom keychain path.
#deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain.
#deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain.
#signingIdentity: # string. Certificate signing identity.
#setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password.
#customKeychainPath: # string. Required when keychain = custom. Custom keychain path.
#deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain.
#deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain.
#signingIdentity: # string. Certificate signing identity.
# Install Apple Certificate v2
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@2
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password.
#customKeychainPath: # string. Required when keychain = custom. Custom keychain path.
#deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain.
#deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain.
#signingIdentity: # string. Certificate signing identity.
certSecureFile
- Certificato (P12)
string
. Obbligatorio.
Specifica il certificato (.p12) caricato per Secure Files
l'installazione nell'agente macOS.
certPwd
- Password del certificato (P12)
string
.
Specifica la password del certificato Apple (.p12). Usare una nuova variabile di compilazione con il blocco abilitato nella Variables
scheda per crittografare questo valore.
keychain
- Portachiavi
string
. Obbligatorio. Valori consentiti: default
(Keychain predefinito), (Keychain temporaneo), temp
custom
(Keychain personalizzato). Valore predefinito: temp
.
Specifica la keychain in cui installare il certificato Apple. Per le build ospitate da Microsoft, usare Temporary Keychain
. Una keychain temporanea verrà sempre eliminata dopo il completamento della compilazione o della versione.
keychainPassword
- Password keychain
string
. Obbligatorio quando keychain = custom || keychain = default
.
Specifica la password per sbloccare la keychain. Usare una nuova variabile di compilazione con il blocco abilitato nella Variables
scheda per crittografare questo valore. Se non specificato, viene generata una password per la keychain temporanea.
customKeychainPath
- Percorso della portachiavi personalizzato
string
. Obbligatorio quando keychain = custom
.
Specifica il percorso completo di un file di keychain personalizzato. La keychain verrà creata se non esiste già.
deleteCert
- Eliminare il certificato dalla keychain
boolean
. facoltativo. Usare quando keychain = custom || keychain = default
.
Specifica il certificato da eliminare dalla keychain dopo il completamento della compilazione o della versione.
deleteCustomKeychain
- Eliminare la keychain personalizzata
boolean
. facoltativo. Usare quando keychain = custom
.
Specifica la keychain personalizzata da eliminare dall'agente dopo il completamento della compilazione o della versione.
signingIdentity
- Identità firma certificato
string
.
Specifica l'oggetto Common Name
nel certificato di firma. Tenterà di analizzare l'oggetto Common Name
se questo è vuoto.
setUpPartitionIdACLForPrivateKey
- Configurare partition_id ACL per la chiave privata importata
boolean
.
Se true
, imposta l'elenco partition_id
di controllo di accesso per la chiave privata importata in modo che codesign
non venga richiesto di usare la chiave per la firma. Questo non è necessario per le keychain temporanee in MacOS High Sierra. Altre informazioni su Open Radar.
opensslPkcsArgs
- Argomenti OpenSSL per PKCS12
string
.
Argomenti per le informazioni sul certificato di estrazione usando openssl.
Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.
Questa attività definisce le variabili di output seguenti, che è possibile usare nei passaggi, nei processi e nelle fasi downstream.
signingIdentity
Specifica il valore risolto Common Name
dell'oggetto nel certificato di firma. Fornito come input o analizzato dal file di certificato P12.
keychainPath
Specifica il percorso del file keychain con il certificato.
Usare questa attività per installare un certificato Apple necessario per compilare un agente macOS. È possibile usare questa attività per installare un certificato Apple archiviato come file sicuro nel server.
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica, versione classica |
Esecuzione in | Agente, DeploymentGroup |
Richieste | Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: xcode |
Capabilities | Questa attività non soddisfa le richieste per le attività successive nel processo. |
Restrizioni dei comandi | Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato |
Variabili impostabili | Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: firmaIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN |
Versione agente | 2.182.1 o versione successiva |
Categoria attività | Utilità |
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica, versione classica |
Esecuzione in | Agente, DeploymentGroup |
Richieste | Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: xcode |
Capabilities | Questa attività non soddisfa le richieste per le attività successive nel processo. |
Restrizioni dei comandi | Qualsiasi |
Variabili impostabili | Qualsiasi |
Versione agente | 2.116.0 o versione successiva |
Categoria attività | Utilità |