In order to use a privately signed certificate with our connector you will need to ensure that you have the entire certificate chain provided by your IT department. This usually includes a root certificate, an intermediate certificate and the site certificate. These all need to be in PEM format. To verify the format, you can open the certificate in a text editor. If the file shows binary characters, it is probably DER/Binary.
In order to convert from another format to PEM, you can use a tool like this: https://www.sslshopper.com/ssl-converter.html
Once you have the PEM files for your private certificate, you will also need to get the Agile Central certificates. These have been provided in PEM format for your convenience in the "Additional Information" section below.
Combine all the PEM files, along with the Agile Central certificate chain into a single file. See the Agile Central certificate chain for an example of how this is done. Save this file in a convenient location on the server where your connector is installed.
The final step is setting an environmental variable as follows:
REQUESTS_CA_BUNDLE=/path/to/your/certificate/bundle.pem
CA Agile Central Certificate Chain
Copy everything below this line
-----BEGIN CERTIFICATE-----
MIIGrDCCBZSgAwIBAgIQAxzyZPgwMqpKNLrLTMBswjANBgkqhkiG9w0BAQsFADBN
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E
aWdpQ2VydCBTSEEyIFNlY3VyZSBTZXJ2ZXIgQ0EwHhcNMTkwNzE0MDAwMDAwWhcN
MjEwNzExMTIwMDAwWjBqMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5p
YTERMA8GA1UEBxMIU2FuIEpvc2UxFTATBgNVBAoTDEJyb2FkY29tIEluYzEcMBoG
A1UEAxMTcmFsbHkxLnJhbGx5ZGV2LmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEP
ADCCAQoCggEBAKPAFtGBCNxh4Zq0o8KAxsIj5I5ga1469d84HotlntvUnXy18iDe
vNgAEmG3MIab3TlBF1xWF03gJHazy5BVX3KFPfOXkLMKm4+LTMfWzmsdNyvdOEvo
NSpl9NhAV9wC/dlOQ6VX3kD/KIr6Zx3IQDJ4ELsRm4TzRjVuKUHkoNdTUZ8/vntM
Bdid6SloBo1esJuB8j2JYK+dzRNg0DO960kh2YHfB4Z5WMqYLI+e0/+Dvm4WqFe2
WG3mc164OaeNiV0RAdvi3BYpZal7grzExGjueuUFPI4N/oHXRT6B7iTGduyXZsk9
l3vGaeDjG5n3qT8ZIa+qiO6/0DfkZNo4i28CAwEAAaOCA2kwggNlMB8GA1UdIwQY
MBaAFA+AYRyCMWHVLyjnjUY4tCzhxtniMB0GA1UdDgQWBBQn+JF5sldn+3bnCgSU
H02PrJbl9zAwBgNVHREEKTAnghB1czEucmFsbHlkZXYuY29tghNyYWxseTEucmFs
bHlkZXYuY29tMA4GA1UdDwEB/wQEAwIFoDAdBgNVHSUEFjAUBggrBgEFBQcDAQYI
KwYBBQUHAwIwawYDVR0fBGQwYjAvoC2gK4YpaHR0cDovL2NybDMuZGlnaWNlcnQu
Y29tL3NzY2Etc2hhMi1nNi5jcmwwL6AtoCuGKWh0dHA6Ly9jcmw0LmRpZ2ljZXJ0
LmNvbS9zc2NhLXNoYTItZzYuY3JsMEwGA1UdIARFMEMwNwYJYIZIAYb9bAEBMCow
KAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCAYGZ4EM
AQICMHwGCCsGAQUFBwEBBHAwbjAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln
aWNlcnQuY29tMEYGCCsGAQUFBzAChjpodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j
b20vRGlnaUNlcnRTSEEyU2VjdXJlU2VydmVyQ0EuY3J0MAkGA1UdEwQCMAAwggF8
BgorBgEEAdZ5AgQCBIIBbASCAWgBZgB1AO5Lvbd1zmC64UJpH6vhnmajD35fsHLY
gwDEe4l6qP3LAAABa/DC1/0AAAQDAEYwRAIgMHjTHoHJODCCdspedED1pJ3iO0GM
4PL1W9jxVrYUxxsCIF0MGEF9ImFH4aTYSVLTs4ZhNwxgZtTBBCgGCjNWuMetAHYA
h3W/51l8+IxDmV+9827/Vo1HVjb/SrVgwbTq/16ggw8AAAFr8MLYMgAABAMARzBF
AiAGAEC4priWG557uD+mP7nQTivd8gA4dl9IvqjcoppxmAIhANdePVXZmeqdspru
uvrmYdahgMv+Zv6GDOkaimSWcLhAAHUARJRlLrDuzq/EQAfYqP4owNrmgr7YyzG1
P9MzlrW2gagAAAFr8MLXPAAABAMARjBEAiBGiw4ORokKdd5Vw4hQQUlHzLeBSDF9
YIIT3PQJpKH8TAIgOXxQbaDA0rpM7o7aHH1s58jnYNDnuLdOpUL2rGW0618wDQYJ
KoZIhvcNAQELBQADggEBAFilXexYtYTmgfp+Gtj7eKOvUR5xZu4mP5N9/7UXVxsK
mBBEG74mfkYxrA8v1YsxrrjNQK7rkTc72nfpZZAdT1mCHlsQMfJH0DBjCUX40s5d
zcsCTmm1xPCA/HtxqK+j+f3LSD+k3hx44mXwtEW086n8+Re7ORGN6KcDww+2CbBK
uXUncXhVoPXpvmViXJlVqd3+Wakksisk8OSLbTAFgrZ9/deUa2wv59Gf9DtOTEG1
fsTOdXJqdgWUcxCxyFtDbGftRuWUIW3k/hzO3PKkKPs92jglt5GpB8RDvzONA/sB
AKvpzRgPM9vLu2TObwLeonuoD1hlpd0eoQLrgt53QZE=
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIElDCCA3ygAwIBAgIQAf2j627KdciIQ4tyS8+8kTANBgkqhkiG9w0BAQsFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
QTAeFw0xMzAzMDgxMjAwMDBaFw0yMzAzMDgxMjAwMDBaME0xCzAJBgNVBAYTAlVT
MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxJzAlBgNVBAMTHkRpZ2lDZXJ0IFNIQTIg
U2VjdXJlIFNlcnZlciBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
ANyuWJBNwcQwFZA1W248ghX1LFy949v/cUP6ZCWA1O4Yok3wZtAKc24RmDYXZK83
nf36QYSvx6+M/hpzTc8zl5CilodTgyu5pnVILR1WN3vaMTIa16yrBvSqXUu3R0bd
KpPDkC55gIDvEwRqFDu1m5K+wgdlTvza/P96rtxcflUxDOg5B6TXvi/TC2rSsd9f
/ld0Uzs1gN2ujkSYs58O09rg1/RrKatEp0tYhG2SS4HD2nOLEpdIkARFdRrdNzGX
kujNVA075ME/OV4uuPNcfhCOhkEAjUVmR7ChZc6gqikJTvOX6+guqw9ypzAO+sf0
/RR3w6RbKFfCs/mC/bdFWJsCAwEAAaOCAVowggFWMBIGA1UdEwEB/wQIMAYBAf8C
AQAwDgYDVR0PAQH/BAQDAgGGMDQGCCsGAQUFBwEBBCgwJjAkBggrBgEFBQcwAYYY
aHR0cDovL29jc3AuZGlnaWNlcnQuY29tMHsGA1UdHwR0MHIwN6A1oDOGMWh0dHA6
Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEdsb2JhbFJvb3RDQS5jcmwwN6A1
oDOGMWh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEdsb2JhbFJvb3RD
QS5jcmwwPQYDVR0gBDYwNDAyBgRVHSAAMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8v
d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwHQYDVR0OBBYEFA+AYRyCMWHVLyjnjUY4tCzh
xtniMB8GA1UdIwQYMBaAFAPeUDVW0Uy7ZvCj4hsbw5eyPdFVMA0GCSqGSIb3DQEB
CwUAA4IBAQAjPt9L0jFCpbZ+QlwaRMxp0Wi0XUvgBCFsS+JtzLHgl4+mUwnNqipl
5TlPHoOlblyYoiQm5vuh7ZPHLgLGTUq/sELfeNqzqPlt/yGFUzZgTHbO7Djc1lGA
8MXW5dRNJ2Srm8c+cftIl7gzbckTB+6WohsYFfZcTEDts8Ls/3HB40f/1LkAtDdC
2iDJ6m6K7hQGrn2iWZiIqBtvLfTyyRRfJs8sjX7tN8Cp1Tm5gr8ZDOo0rwAhaPit
c+LJMto4JQtV05od8GiG7S5BNO98pVAdvzr508EIDObtHopYJeS4d60tbvVS3bR0
j6tJLp07kzQoH3jOlOrHvdPJbRzeXDLz
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
-----END CERTIFICATE-----