Skip to content

Advanced Configuration: RFID Chip

PKD Certificates

  • To add a list of PKD certificates during the initialization process that will be passed to Core, use:
DocumentReader.Instance().addPKDCertificates(certificates);
  • To add a list of PKD certificates when the PKD reading started that will be passed to Core, use:
DocumentReader.Instance().startRFIDReader(new IDocumentReaderCompletion() {
    @Override
    public void onCompleted(int rfidAction, DocumentReaderResults results, Throwable error) {
        // Completed RFID-chip processing
    }
}, new DocumentReader.RfidReaderRequest() {
    @Override
    public void onRequestPACertificates(byte[] bytes, PAResourcesIssuer paResourcesIssuer, DocumentReader.RfidPKDCertificateCompletion rfidPKDCertificateCompletion) {
        // Requested PA certificates
    }

    @Override
    public void onRequestTACertificates(String s, DocumentReader.RfidPKDCertificateCompletion rfidPKDCertificateCompletion) {
        // Requested TA certificates
    }

    @Override
    public void onRequestTASignature(TAChallenge taChallenge, DocumentReader.RfidTASignatureCompletion rfidTASignatureCompletion) {
        // Requested TA signature
    }
});
  • Clear the list of PKD certificates that have been passed to Core:
DocumentReader.Instance().clearPKDCertificates();

TCC Params

Sets the given TccParams to the RFID session. The parameters are required to be set before starting the RFID session.

The TCCParams includes the following properties:

  • setServiceUrlTA is the TA URL for the TCC service. The value of the property must be a valid URL string.
  • setServiceUrlPA is the PA URL for the TCC service. The value of the property must be a valid URL string.
  • setPfxCertUrl is the URL for the certificate for a TCC service. The value of the property must be a valid URL string.
  • setPfxCert is the bytes of the certificate for a TCC service. This data will be used instead of loading the certificate via setPfxCertUrl.
  • setPfxPassPhrase is the passphrase for the cerficiate provided by the setPfxCertUrl property. 
TccParams tccParams = new TccParams();
tccParams.setServiceUrlTA("");
tccParams.setServiceUrlPA("");
tccParams.setPfxCertUrl("");
tccParams.setPfxCert(null);
tccParams.setPfxPassPhrase("");

DocumentReader.Instance().setTccParams(tccParams, new ITccParamsCompletion() {
    @Override
    public void onSetTccParamsCompleted(boolean success, @Nullable DocumentReaderException error) {

    }
});

val tccParams = TccParams()
tccParams.serviceUrlTA = ""
tccParams.serviceUrlPA = ""
tccParams.pfxCertUrl = ""
tccParams.pfxCert = null
tccParams.pfxPassPhrase = ""

DocumentReader.Instance().setTccParams(
    tccParams
) { success, error -> }

paIgnoreNotificationCodes

Use paIgnoreNotificationCodes to define notification codes (int type) that should be ignored during passive authentication (PA). For the full list of notification codes, see the eLDS_ParsingNotificationCodes enumeration.

RFIDParams rfidParams = new RFIDParams();
rfidParams.paIgnoreNotificationCodes(new int[] {-1879047913, -1845493480});
DocumentReader.Instance().processParams.rfidParams = rfidParams;

val rfidParams = RFIDParams()
rfidParams.paIgnoreNotificationCodes = intArrayOf(-1879047913, -1845493480)
Instance().processParams().rfidParams = rfidParams

Next Steps