Share via


InstallAppleCertificate@1 - Apple Certificate v1-taak installeren

Gebruik deze taak om het Apple-certificaat te installeren dat is vereist voor het bouwen op een macOS-agent. U kunt deze taak gebruiken om een Apple-certificaat te installeren dat is opgeslagen als een beveiligd bestand op de server.

Syntax

# Install Apple Certificate v1
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@1
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. 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.

Invoerwaarden

certSecureFile - Certificaat (P12)
string. Vereist.

Hiermee geeft u het certificaat (.p12) op waarnaar is geüpload Secure Files om te installeren op de macOS-agent.


certPwd - Certificaatwachtwoord (P12)
string.

Hiermee geeft u het wachtwoord voor het Apple-certificaat (.p12). Gebruik een nieuwe buildvariabele met de vergrendeling ingeschakeld op het Variables tabblad om deze waarde te versleutelen.


keychain - Sleutelhanger
string. Vereist. Toegestane waarden: default (standaardsleutelhanger), temp (tijdelijke sleutelhanger), custom (aangepaste sleutelhanger). Standaardwaarde: temp.

Hiermee geeft u de sleutelhanger op waarin het Apple-certificaat moet worden geïnstalleerd. Een tijdelijke sleutelhanger wordt altijd verwijderd nadat de build of release is voltooid.


keychainPassword - Wachtwoord voor sleutelhanger
string.

Hiermee geeft u het wachtwoord op om de sleutelhanger te ontgrendelen. Gebruik een nieuwe buildvariabele met de vergrendeling ingeschakeld op het Variables tabblad om deze waarde te versleutelen. Er wordt een wachtwoord gegenereerd voor de tijdelijke sleutelhanger als er nog geen wachtwoord is opgegeven.


customKeychainPath - Aangepast sleutelhangerpad
string. Vereist wanneer keychain = custom.

Hiermee geeft u het volledige pad naar een aangepast sleutelhangerbestand. De sleutelhanger wordt gemaakt als deze nog niet bestaat.


deleteCert - Certificaat verwijderen uit sleutelhanger
boolean. Optioneel. keychain = custom || keychain = defaultWanneer gebruiken.

Hiermee geeft u het certificaat te verwijderen uit de sleutelhanger nadat de build of release is voltooid.


deleteCustomKeychain - Aangepaste sleutelhanger verwijderen
boolean. Optioneel. keychain = customWanneer gebruiken.

Hiermee geeft u de aangepaste sleutelhanger op die uit de agent moet worden verwijderd nadat de build of release is voltooid.


signingIdentity - Identiteit van certificaatondertekening
string.

Hiermee geeft u het Common Name onderwerp in het handtekeningcertificaat op. Probeert te parseren Common Name of dit leeg blijft.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast de taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

signingIdentity
Hiermee geeft u het opgeloste Common Name onderwerp in het handtekeningcertificaat op. Geleverd als invoer of geparseerd uit het P12-certificaatbestand.

keychainPath
Hiermee geeft u het pad voor het sleutelhangerbestand met het certificaat op.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten voor het uitvoeren van taken die gebruikmaken van deze taak: xcode
Functies Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Variabelen instellen Alle
Agentversie 2.116.0 of hoger
Taakcategorie Hulpprogramma