You can export a connection either manually, using the administrative console, or programmatically via a call to the Connection Management Service.

In either case, the exported XML complies with the standard SAML 2.0 metadata format, with extensions to capture PingFederate's proprietary configuration. Most connection configuration information is contained in the XML markup, with the exception of global configuration items such as adapter instances, data stores, and keypairs. Adapter instances and data stores are referenced by ID, and keypairs are referenced by the MD5 fingerprint of their X.509 certificate. Public certificates, such as the partner's signature verification certificate, are included completely (base-64 encoded).

Export manually

For information about using the administrative console to export connections, see Accessing SP connections or Accessing IdP connections.

Export via the Connection Management Service

The Connection Management Service exposes the following method for exporting connections:

public string getConnection( String entityId, String role,) throws IOException

The entityId parameter is the connection ID, which identifies the connection to be deleted. The role parameter is the connection role, IDP or SP.

Code sample

The following example invoke this web service to export a connection:
Service service = new Service();
Call call = (Call)service.createCall();
call.setUsername("username");
call.setPassword("password");
call.setTargetEndpointAddress("https://localhost:9999/pf-mgmt-ws/ws/ConnectionMigrationMgr");
call.setOperationName("getConnection");
Object result = call.invoke(new Object[] {"entityId", "SP"});