Dela via


InstallAppleCertificate@2 – Installera apple certificate v2-uppgift

Använd den här uppgiften för att installera Det Apple-certifikat som krävs för att bygga på en macOS-agent. Du kan använda den här uppgiften för att installera ett Apple-certifikat som lagras som en säker fil på servern.

Installera ett Apple-certifikat som krävs för att bygga på en macOS-agent.

Syntax

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

Indata

certSecureFile - Certifikat (P12)
string. Krävs.

Anger det certifikat (.p12) som laddades upp till för Secure Files att installeras på macOS-agenten.


certPwd - Certifikatlösenord (P12)
string.

Anger lösenordet till Apple-certifikatet (.p12). Använd en ny byggvariabel med låset aktiverat på fliken Variables för att kryptera det här värdet.


keychain - Nyckelring
string. Krävs. Tillåtna värden: default (standardnyckelring), temp (tillfällig nyckelring), custom (anpassad nyckelring). Standardvärde: temp.

Anger i vilken nyckelring Apple-certifikatet ska installeras. För Microsoft-värdbaserade versioner använder du Temporary Keychain. En tillfällig nyckelring tas alltid bort när bygget eller versionen har slutförts.


keychainPassword - Nyckelringslösenord
string. Krävs när keychain = custom || keychain = default.

Anger lösenordet för att låsa upp nyckelringen. Använd en ny byggvariabel med låset aktiverat på fliken Variables för att kryptera det här värdet. Ett lösenord genereras för den tillfälliga nyckelringen om det inte anges.


customKeychainPath - Anpassad nyckelringssökväg
string. Krävs när keychain = custom.

Anger den fullständiga sökvägen till en anpassad nyckelringsfil. Nyckelringen skapas om den inte redan finns.


deleteCert - Ta bort certifikat från nyckelringen
boolean. Valfritt. Använd när keychain = custom || keychain = default.

Anger certifikatet som ska tas bort från nyckelringen när bygget eller versionen har slutförts.


deleteCustomKeychain - Ta bort anpassad nyckelring
boolean. Valfritt. Använd när keychain = custom.

Anger den anpassade nyckelringen som ska tas bort från agenten när bygget eller versionen har slutförts.


signingIdentity - Certifikatsigneringsidentitet
string.

Anger ämnet i signeringscertifikatet Common Name . Försöker parsa Common Name om detta lämnas tomt.


setUpPartitionIdACLForPrivateKey - Konfigurera partition_id ACL för den importerade privata nyckeln
boolean.

Om trueanger du partition_id ACL för den importerade privata nyckeln så att codesign du inte uppmanas att använda nyckeln för signering. Detta är inte nödvändigt för tillfälliga nyckelringar på MacOS High Sierra. Läs mer om Open Radar.


opensslPkcsArgs - OpenSSL-argument för PKCS12
string.

Argument för extrahering av certifikatinformation med hjälp av openssl.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här aktiviteten definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och faser.

signingIdentity
Anger ämnets Common Name lösning i signeringscertifikatet. Antingen anges som indata eller parsas från P12-certifikatfilen.

keychainPath
Anger sökvägen för nyckelringsfilen med certifikatet.

Kommentarer

Använd den här uppgiften för att installera ett Apple-certifikat som krävs för att bygga på en macOS-agent. Du kan använda den här uppgiften för att installera ett Apple-certifikat som lagras som en säker fil på servern.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: xcode
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Den här aktiviteten körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler Den här uppgiften har behörighet att ange följande variabler: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Agentversion 2.182.1 eller senare
Uppgiftskategori Verktyg
Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: xcode
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 2.116.0 eller senare
Uppgiftskategori Verktyg