InstallAppleCertificate@1 – Apple Certificate v1-Aufgabe installieren

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um das Apple-Zertifikat zu installieren, das zum Erstellen auf einem macOS-Agent erforderlich ist. Sie können diese Aufgabe verwenden, um ein Apple-Zertifikat zu installieren, das als sichere Datei auf dem Server gespeichert ist.

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.

Eingaben

certSecureFile - Zertifikat (P12)
string. Erforderlich.

Gibt das Zertifikat (P12) an, das auf die Installation auf dem macOS-Agent hochgeladen Secure Files wurde.

certPwd - Zertifikatkennwort (P12)
string.

Gibt das Kennwort für das Apple-Zertifikat (P12) an. Verwenden Sie eine neue Buildvariable mit aktivierter Sperre auf der Variables Registerkarte, um diesen Wert zu verschlüsseln.

keychain - Schlüsselbund
string. Erforderlich. Zulässige Werte: default (Standardschlüsselkette), (temporärer Schlüsselbund), customtemp (benutzerdefinierter Schlüsselbund). Standardwert. temp.

Gibt die Schlüsselkette an, in der das Apple-Zertifikat installiert werden soll. Nach Abschluss des Builds oder der Veröffentlichung wird immer eine temporäre Schlüsselkette gelöscht.

keychainPassword - Schlüsselbundkennwort
string.

Gibt das Kennwort an, um die Schlüsselkette zu entsperren. Verwenden Sie eine neue Buildvariable mit aktivierter Sperre auf der Variables Registerkarte, um diesen Wert zu verschlüsseln. Ein Kennwort wird für den temporären Schlüsselbund generiert, wenn noch kein Kennwort angegeben ist.

customKeychainPath - Benutzerdefinierter Schlüsselbundpfad
string. Erforderlich, wenn keychain = custom.

Gibt den vollständigen Pfad zu einer benutzerdefinierten Schlüsselbunddatei an. Die Schlüsselkette wird erstellt, wenn sie noch nicht vorhanden ist.

deleteCert - Löschen des Zertifikats aus der Schlüsselkette
boolean. Optional. Wird verwendet, wenn keychain = custom || keychain = default.

Gibt das Zertifikat an, das nach Abschluss des Builds oder der Veröffentlichung aus der Schlüsselkette gelöscht werden soll.

deleteCustomKeychain - Benutzerdefinierte Schlüsselkette löschen
boolean. Optional. Wird verwendet, wenn keychain = custom.

Gibt den benutzerdefinierten Schlüsselbund an, der nach Abschluss des Builds oder der Veröffentlichung aus dem Agent gelöscht werden soll.

signingIdentity - Zertifikatsignaturidentität
string.

Gibt den Common Name Betreff im Signaturzertifikat an. Versucht, dies Common Name zu analysieren, wenn dies leer ist.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen über Steuerungsoptionen zusätzlich zu ihren Aufgabeneingaben. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Diese Aufgabe definiert die folgenden Ausgabevariablen, die Sie in nachgelagerten Schritten, Aufträgen und Phasen nutzen können.

signingIdentity
Gibt die Auflösung Common Name des Betreffs im Signaturzertifikat an. Entweder als Eingabe oder analysiert aus der P12-Zertifikatdatei.

keychainPath
Gibt den Pfad für die Schlüsselbunddatei mit dem Zertifikat an.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbst gehostete Agents müssen Über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: xcode
Capabilities	Dieser Vorgang erfüllt keine Anforderungen an nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Beliebig
Settable-Variablen	Beliebig
Agent-Version	2.116.0 oder höher
Aufgabenkategorie	Hilfsprogramm

Freigeben über