NAME

XML::AppleConfigProfile::Payload::Certificate::PKCS12 - Bundle containing one certificate and its matching private key.

SYNOPSIS

use XML::AppleConfigProfile::Profile;
use XML::AppleConfigProfile::Payload::Certificate::PKCS12;

my $cert = new XML::AppleConfigProfile::Payload::Certificate::PKCS12;
$cert->payload->{PayloadIdentifier} = 'local.acme.key.user10';
$cert->payload->{PayloadDisplayName} = 'Private key & cert';
$cert->payload->{PayloadDescription} = 'The private key and certificate for employee #10';
$cert->payload->{PayloadOrganization} = 'Acme, Inc.';
$cert->payload->{PayloadCertificateFileName} = 'user10.p12'; 
$cert->payload->{Password} = 'Monkey123'; # DON'T DO THIS IN REAL LIFE!!!
$cert->payload->{PayloadContent} = '.................'; # Binary data here

my $profile = new XML::AppleConfigProfile::Profile;
push @{$profile->content}, $cert;

print $profile->string;

DESCRIPTION

This class implements the PKCS12 type of Certificate payload.

This payload contains a single certificate, and the certificate's private key, in a PKCS#12 container. The container is encrypted with a password.

This payload is used to hold only one certificate. If you have any intermediate certificates, you will need to use a second Certificate payload (either a PEM or a PKCS1) to hold each intermediate certificate.

PAYLOAD KEYS

All of the payload keys defined in XML::AppleConfigProfile::Payload::Common::Certificate are used by this payload.

This payload has the following additional keys:

Password

This is the password needed to decrypt the PKCS#12 file. If no password is provided, the user will be prompted to enter the password when installing the profile.

PayloadType

This is fixed to the string com.apple.security.pem.

PayloadVersion

This is fixed to the value 1.

ACKNOWLEDGEMENTS

Refer to the XML::AppleConfigProfile for acknowledgements.

AUTHOR

A. Karl Kornel, <karl at kornel.us>

COPYRIGHT AND LICENSE

Copyright © 2014 A. Karl Kornel.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.