InstallAppleCertificate@1 - Apple Certificate v1-taak installeren

Artikel
03/24/2025

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.

Syntaxis

# 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.

Invoer

certSecureFile - certificaat (P12)
string. Verplicht.

Hiermee geeft u het certificaat (.p12) dat is geüpload naar Secure Files 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 tabblad Variables om deze waarde te versleutelen.

keychain - sleutelhanger
string. Verplicht. 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 - sleutelhangerwachtwoord
string.

Hiermee geeft u het wachtwoord voor het ontgrendelen van de sleutelhanger. Gebruik een nieuwe buildvariabele met de vergrendeling ingeschakeld op het tabblad Variables 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 de sleutelhanger
boolean. Facultatief. Gebruiken wanneer keychain = custom || keychain = default.

Hiermee geeft u het certificaat dat moet worden verwijderd uit de sleutelhanger nadat de build of release is voltooid.

deleteCustomKeychain - aangepaste sleutelhanger verwijderen
boolean. Facultatief. Gebruiken wanneer keychain = custom.

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

signingIdentity - identiteit voor certificaatondertekening
string.

Hiermee geeft u de Common Name van het onderwerp in het handtekeningcertificaat. Probeert de Common Name te parseren als dit leeg blijft.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

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

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

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

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: xcode
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	2.116.0 of hoger
Taakcategorie	Nutsvoorzieningen

Delen via