On This Page
Limited Availability
Client Authentication Setup
You must setup secure
client authentication
in order for Cybersource
to verify your application when it requests access tokens. When using this
integration method, you must use mutual TLS (mTLS)
client authentication. MTLS
client authentication provides bidirectional authentication between you and Cybersource
. When your application sends an API request, it includes an
authentication certificate. Cybersource
validates the certificate, which
verifies your application's identity, and then issues you an access token and refresh
token.Supported Certificates
Obtain a supported certificate from the DigiCert Certificate Authority (CA) or Visa.
To request a DigiCert certificate, see the DigiCert support page:
https://www.digicert.com/contact-us
Cybersource
offers the free VICA10 CA certificate. It is ideal for
testing and is self-managed by the root certificate authority – G2. To request a
VICA10 certificate, contact customer support: https://developer.cas.cybersource.com/support/contact-us.html
- DigiCert CAs
- X9 Financial PKI – ECC P-256 Root
- X9 Financial PKI – RSA 2048 Root
- X9 Financial PKI – RSA 4096 Root
- Visa CA
- VICA 10 CA
Overview of Set Up
Complete these tasks to set up mTLS client authentication:
- Generate a private key in your system.
- Extract a certificate signing request (CSR) from your private key.IMPORTANTThe CSR's common name cannot exceed forty characters.
- Request a certificate from the DigiCert certificate authority (CA). You submit your CSR in this request.For a list of the supported certificates, see theSupported DigiCert Certificatessection above.
- Receive a certificate from DigiCert after your request is validated.
- Submit your certificate in theCybersourceBusiness Center, which generates a P12 certificate for you to download and use in your integration.IMPORTANTSecurely store the P12 certificate and password in your system. Do not share the certificate or its credentials with anyone outside of your administrative team.For instructions about how to submit your certificate, see theSubmit Your Certificate tosection below.Cybersource
To test mTLS client authentication before you request a DigiCert certificate, contact
Cybersource
customer support.Submit Your Certificate
To submit your certificate to
Cybersource
, contact customer
support.