GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
OpenXPKI::Server::API2::Plugin::Cert::import_chain(3) User Contributed Perl Documentation OpenXPKI::Server::API2::Plugin::Cert::import_chain(3)

OpenXPKI::Server::API2::Plugin::Cert::import_chain

Expects a set of certificates as PKCS7 container, concated PEM or array of PEM blocks - expected sorting is "entity first". For security reasons the root is not imported by default, set import_root to import root certificates. If the chain can not be build, the import will fail unless you set force_nochain, which will import the chain as far as it can be built. Certificates from the chain that are already in the database are ignored. If the data contain certs from different chains, all chains are built (works only with PEM array/block)

Return value is a hash with keys imported, existed and failed:

imported
array ref holding the db_hash of the successful imports
existed
array ref holding the db_hash of items that have been in the database already.
failed
array ref holding the cert_identifier and error message of failed imports ([{ cert_identifier => ..., error => .... }])

Parameters

  • "chain" Str or ArrayRef - PEM encoded certificate (Str) or full certificate chain (list of PEM encoded certificates) starting with the entity
  • "pkcs7" Str - PEM encoded PKCS7 container
  • "pki_realm" Str - realm to import to, default is the current realm
  • "force_nochain" Bool - force import of incomplete chains
  • "import_root" Bool - import the root certificate if required

Changes compared to API v1:

The old parameter "DATA" was split up into two separate parameters "chain" and "pkcs7".

2022-05-14 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.