Share via


InstallAppleCertificate@2 – Az Apple-tanúsítvány v2-feladatának telepítése

Ezzel a feladattal telepítheti a macOS-ügynökre való buildeléshez szükséges Apple-tanúsítványt. Ezzel a feladattal telepítheti a kiszolgálón biztonságos fájlként tárolt Apple-tanúsítványt.

Telepítse a macOS-ügynökre való buildeléshez szükséges Apple-tanúsítványt.

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.

Bevitelek

certSecureFile - Tanúsítvány (P12)
string. Kötelező.

Megadja a macOS-ügynökre való telepítéshez Secure Files feltöltött tanúsítványt (.p12).


certPwd - Tanúsítvány (P12) jelszava
string.

Megadja az Apple-tanúsítvány jelszavát (.p12). Az érték titkosításához használjon egy új buildváltozót, amelynek zárolása engedélyezve van a Variables lapon.


keychain - Kulcstartó
string. Kötelező. Engedélyezett értékek: default (alapértelmezett kulcskarika), temp (ideiglenes kulcskarika), custom (egyéni kulcskarika). Alapértelmezett érték: temp.

Meghatározza azt a kulcskarikát, amelyben telepíteni szeretné az Apple-tanúsítványt. A Microsoft által üzemeltetett buildekhez használja a következőt Temporary Keychain: . Az ideiglenes kulcskarika mindig törlődik a build vagy a kiadás befejezése után.


keychainPassword - Kulcskarika jelszava
string. Akkor szükséges, ha keychain = custom || keychain = default.

Megadja a kulcskarika feloldásához tartozó jelszót. Az érték titkosításához használjon egy új buildváltozót, amelynek zárolása engedélyezve van a Variables lapon. Ha nincs megadva jelszó az ideiglenes kulcskarikához.


customKeychainPath - Egyéni kulcskarika elérési útja
string. Akkor szükséges, ha keychain = custom.

Megadja egy egyéni kulcsláncfájl teljes elérési útját. A kulcskarika akkor jön létre, ha még nem létezik.


deleteCert - Tanúsítvány törlése a kulcskarikáról
boolean. Választható. Használja a következőt: keychain = custom || keychain = default.

Megadja a kulcskarikáról a build vagy a kiadás befejezése után törölni kívánt tanúsítványt.


deleteCustomKeychain - Egyéni kulcskarika törlése
boolean. Választható. Használja a következőt: keychain = custom.

Megadja azt az egyéni kulcsláncot, amelyet törölni szeretne az ügynökből a build vagy a kiadás befejezése után.


signingIdentity - Tanúsítvány-aláíró identitás
string.

Common Name Az aláíró tanúsítvány tulajdonosát adja meg. Megkísérli elemezni az Common Name értéket, ha üresen marad.


setUpPartitionIdACLForPrivateKey - Partition_id ACL beállítása az importált titkos kulcshoz
boolean.

Ha truea , úgy állítja be az partition_id importált titkos kulcs ACL-ét, hogy codesign az ne kérje a kulcs használatát az aláíráshoz. Ez nem szükséges ideiglenes kulcskarikákhoz a MacOS High Sierra rendszeren. További információ az Open Radarról.


opensslPkcsArgs - OpenSSL-argumentumok a PKCS12-höz
string.

Argumentumok a kinyerési tanúsítvány adataihoz az openssl használatával.


Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

signingIdentity
Megadja a tulajdonos feloldását Common Name az aláíró tanúsítványban. Bemenetként vagy a P12-tanúsítványfájlból elemezve.

keychainPath
Megadja a tanúsítványt tartalmazó kulcskarikafájl elérési útját.

Megjegyzések

Ezzel a feladattal telepítheti a macOS-ügynökre való buildeléshez szükséges Apple-tanúsítványt. Ezzel a feladattal telepítheti a kiszolgálón biztonságos fájlként tárolt Apple-tanúsítványt.

Követelmények

Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás: Ügynök, DeploymentGroup
Igények A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: xcode
Képességek Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások Ez a feladat a következő parancskorlátozásokkal fut: korlátozott
Változók beállítása Ez a feladat a következő változók beállítására jogosult: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Ügynök verziója 2.182.1 vagy újabb
Feladatkategória Segédprogram
Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás: Ügynök, DeploymentGroup
Igények A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: xcode
Képességek Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások Bármelyik
Változók beállítása Bármelyik
Ügynök verziója 2.116.0 vagy újabb
Feladatkategória Segédprogram