This section explains how to create CSR-based certificate requests in the Web RA web portal.



Following are a few things to remember with respect to SDNs, SANs and RDNs:


  • When a user creates a new certificate request, the SDNs and SANs will be rendered as configured in the certification profile and its values will be auto-filled from the certificate details. 
  • A user will not be able to change the values of the RDNs if an operator has configured them in the certificate details.
  • An operator will see the rendered values in a disabled form. 
  • If there is an RDN that is added in certification profile but has not been configured in the user's certificate details, it will be shown as editable in the request form and the user can update its value.
  • If no RDN is configured in the user certificate details then the request will be generated.
  • In case of an error, the user will not be allowed to move to the next step. 


Second Factor Authentication 


If second-factor authentication is enabled for certificate requests, the configured authentication mechanism operates accordingly. When the user clicks Generate, an authentication window appears. After the selected method is successfully verified, the certificate is generated.


The authentication mechanism can be one of the following:


  • SMS OTP Authentication 
  • Email OTP Authentication 
  • Email & SMS Authentication
  • SAML Authentication 
  • Active Directory Authentication 
  • Azure Active Directory Authentication
  • OIDC Authentication 


Request Notes


If an operator has added a customized Request Note to certificate requests for a specific enterprise, it will appear in all types of certificates requests -- issued, rekey, revoked, renewed and reissued. The Request Notes appear only on the screens against which the operator has customised them. 


An operator can configure Request Notes from the Enterprise Request Notes section in the Admin portal.


The following steps describe how to create a CSR-based certificate request:


In the web portal, navigate to Certificate Center > Certificate Requests from the left menu tree.



Click on the ‘+’ plus button in the listing header to create a new certificate request. The system will display the ‘Create Request’ screen. 



On this screen, select the certification profile from the ‘Certificate Type’ dropdown and click ‘Create’. 


The system will display the ‘Certificate Signing Request (CSR)’ screen. Here, you will be required to either upload a CSR or paste the file in the given box. 



After uploading the CSR, the following screen will appear. 



You can click on the eye icon to view the details of the CSR. The details will appear in a dialog as displayed below:



You can scroll down the dialog to view the complete details inside the CSR.


Click ‘Next’ to navigate to the ‘Subject Distinguished Name (SDNs)’ screen. Enter the details in the fields as per your requirement.


Country, State, Locality and Postal Code in a Certificate Request


When you create a certificate request, you may need to enter the certificate holder's Country, State, Locality (city) and Postal Code. Depending on how the certificate type is set up, these fields appear on the Subject Distinguished Name (SDN) screen.


Field

Description

Country

Select the country. Only the countries allowed by your administrator are displayed. The country field will be pre-selected according to the country selected under the Enterprise > Profile > Organisation Information.

State

Select the state or province from the list. Only the states or provinces associated with the selected country are displayed.

Locality

Select the city from the list. This field is available only after a state or province has been selected. You can type in the field to search for a city.

Postal Code

Enter the postal code in the format required by the selected country. If the entered postal code does not match the required format, an error message is displayed. For example: "The postal code does not match the format of the selected country. It must be 5 characters."


Note: 

  • On this screen the field names always stay the same. For example, State is still called State even if the country uses provinces.
  • If you change the country, the State and Locality are cleared and you need to select them again.
  • Ensure that the CSR uploaded with the certificate request contains the correct country, state or province, and locality details. 



Note: 

If the 'Enable Document ID Pairing with Emails' policy is enabled in the Configurations module, and both the Email and Subject Serial Number fields are included in the Subject Distinguished Name (SDN), the system automatically associates the email address with the subject serial number when they are used together for the first time.


After an email address has been associated with a subject serial number, all future certificate requests using that email address must include the same subject serial number. If a different subject serial number is entered, the certificate request is rejected and an error is displayed. The following error will appear on the screen:



A single subject serial number can be associated with multiple email addresses; however, each email address can only be associated with one subject serial number.


Note:

If the 'Enable Document ID Pairing with Emails' policy is enabled and the Subject Distinguished Name (SDN) contains either multiple Email fields or multiple Subject Serial Number (SSN) fields, the system does not process the certificate request and displays an error.



After making the required changes on the SDN screen, click the next '>' button to navigate to the the ‘Subject Alternative Name (SANs)’ screen. Enter the details in the fields as per your requirement.


Note: 

ADSS Web RA now supports the following additional Subject Alternative Name (SAN) fields:


  • Directory Name
  • Uniform Resource Identifier (URI)
  • EDI Party Name
  • Registered ID


When these SAN fields are configured in the ADSS Certification Profile, the corresponding fields are also supported in ADSS Web RA.


Furthermore, ADSS Web RA now supports additional encoding methods for the Directory Name and EDI Party Name SAN fields. The newly supported encoding methods are:


  • UTF8
  • Printable
  • Teletex
  • Universal
  • BMP




Click ‘Next’ to navigate to the ‘Certificate Validity’ screen.



Here, click the 'Generate' button to create the certificate. The system will generate the certificate and display the 'Certificate Generated' dialog on the screen.



This certificate request will appear in the 'Certificate Requests' and 'Issued Certificates' listing.


Note: If the setting for Digital Onboarding is enabled in the Certification Profile, clicking the 'Generate' button displays a dialog containing the providers configured in the selected Digital Onboarding connector.


Select the required provider from the given options.



The system then displays a QR code. Scan the QR code using the Digital Onboarding mobile application.



After scanning the QR code, complete the identity verification process by providing the required documents as configured in the Digital Onboarding policy.


Once the identity verification process is completed successfully, the QR code will disappear and the certificate request will be generated.


After the certificate request generation, you can download, revoke, or renew the certificate using the respective buttons.


Additionally, if the Rekey Certificate policy is enabled in Configurations > Policies > Requests, you can click the More Actions button to rekey the certificate if required.


How to Renew a Certificate


To renew a certificate before its expiration, you need to first open the certificate request generated from the Web RA system.


To do this, expand Certificate Center > Certificate Requests from the left-tree menu in the Web Portal.


Then, click the request number of the certificate that you want to renew. Alternatively, click the three-dot button next to the certificate request entry and select the 'View Request' option.


The system will then open the certificate request in View mode.



To renew the certificate, click the 'Renew Certificate' button. 


Note: The 'Renew Certificate' button appears only if the 'Renew Certificate' policy is selected in Configurations > Policies > Requests section under the certificate renewal settings.


The Certificate Signing Request (CSR) screen will appear again, as displayed in the image below.



Click the next '>' button to navigate to the 'Certificate Validity' screen. Here, click the 'Renew' button to renew the certificate.



The system will display the Certificate Renew dialog on the screen. Here, you can optionally enter a message in the Message box.



Click the Renew button. The certificate will be renewed, and a Certificate Renewed alert will appear on the screen.



Each certificate can be renewed only up to the renewal limit configured in the certification profile. For example, if a renewal limit of 1 is configured in the certification profile, a certificate can only be renewed once. Any subsequent attempt to renew the same certificate will result in an error being displayed by the system.


The following error will appear on the screen if you attempt to renew a certificate after the renewal limit has been reached.



Note: If the renewal limit is set to zero in the certification profile, certificates generated under that certification profile cannot be renewed.


How to Provision a Certificate


Expand Certificate Center > Certificate Requests from the left-tree menu in the Web Portal.


Click the request number of the certificate that you want to provision.


Click the Provision button. The Provision dialog will appear on the screen.



Choose the required option from the 'Provision' dropdown and click the Provision button. The certificate will then be provisioned.

When you click the 'Download' button, the 'Download Certificate' dialog appears. From this dialog, you can choose to download either the certificate only or the certificate PFX.



If you click on the 'Download Certificate PFX' radio button, the dialog will display Password and Confirm Password fields. Type in the required password and click 'OK'.


Note: If ‘Enable one-time PFX download” option is enabled in the Certification Profile, the PFX can only be downloaded once. If the option is disabled, the PFX can be downloaded multiple times.

When you click the 'Revoke Certificate' button, the 'Certificate Action' screen appears. On this screen, you must select a reason for revoking the certificate from the 'Certificate Revocation Reason' dropdown and, if required, a message in the optional message box. 

Before revoking a certificate, you must select the 'Are you sure you want to revoke this certificate' checkbox. Then, click 'Revoke' to proceed with the revocation. 


Create a CSR-Based Certificate Request Using a Vetting Form with SDN/SAN Mappings


In the web portal, navigate to Certificate Center > Certificate Requests from the left menu tree.



Click on the ‘+’ plus button in the listing header to create a new certificate request. The system will display the ‘Create Request’ screen. 



On this screen, select the certification profile from the ‘Certificate Type’ dropdown and click ‘Create’. 


The system displays the certificate request, where you can enter the required information in different sections according to your requirements.


If any fields in the vetting form are mapped to Subject Distinguished Name (SDN) or Subject Alternative Name (SAN) fields, the vetting form appears as the first step in the certificate request. The user must enter the details in the vetting form before proceeding to the remaining sections of the certificate request. The values entered in the vetting form are used to populate the corresponding mapped SDN/SAN fields.


Note: 

  • If the vetting form has Country, Province/State, City, Postal Code, Mobile Number or Multi-Text fields, fill them in the same way: select the country first, then the province or state, then the city. Some field names change to match the selected country.
  • If the administrator has linked these vetting form fields to SDN fields, you only need to fill them in on the Vetting Form. The values are copied to the SDN screen for you and cannot be changed there.



After entering the information in the Vetting Form fields, click the next ‘>’ button to proceed to the ‘Certificate Signing Request (CSR)’ screen. Here, you will be required to either upload a CSR or paste the file in the given box.



When you upload a Certificate Signing Request (CSR), the system displays the Subject Distinguished Name (SDN) screen.



Note: 

  • All SDN fields mapped to Vetting Form fields are populated automatically using the information entered in the Vetting Form. These fields are displayed as disabled and cannot be edited manually.
  • If a Vetting Form field mapped to an SDN field is optional and the user does not enter a value, the corresponding SDN field remains empty and disabled.
  • If an SDN value is configured in the ADSS Certification Profile and marked as fixed, the system populates the corresponding field on the Subject Distinguished Name (SDN) screen with the value from the Certification Profile. This value takes precedence over any value entered in the mapped Vetting Form field and cannot be overridden by the user.
  • For CSR-based requests (PKCS#10), the SDN values are taken from the uploaded CSR. These values take priority over any values entered in the Vetting Form.
  • For CSR-based requests ($Request), the system populates the SDN values using the values entered in the Vetting Form.
  • For Certification Profiles configured for server-side certificate generation or with the Enable Client Keys option enabled, the system populates the SDN values using the values entered in the Vetting Form.


If an SDN field is not mapped to a Vetting Form field and is not configured as fixed in the ADSS Certification Profile, the field remains enabled, allowing you to enter a value according to your requirements.


After reviewing and entering the required values, click the next ‘>’ button to navigate to the Subject Alternative Name (SAN) screen. 


Note: 

ADSS Web RA now supports the following additional Subject Alternative Name (SAN) fields:


  • Directory Name
  • Uniform Resource Identifier (URI)
  • EDI Party Name
  • Registered ID


When these SAN fields are configured in the ADSS Certification Profile, the corresponding fields are also supported in ADSS Web RA.


Furthermore, ADSS Web RA now supports additional encoding methods for the Directory Name and EDI Party Name SAN fields. The newly supported encoding methods are:


  • UTF8
  • Printable
  • Teletex
  • Universal
  • BMP



Note: 

  • All SAN fields mapped to Vetting Form fields are populated automatically using the information entered in the Vetting Form. These fields are displayed as disabled and cannot be edited manually.
  • If a Vetting Form field mapped to a SAN field is optional and the user does not enter a value, the corresponding SAN field remains empty and disabled.
  • If a SAN value is configured in the ADSS Certification Profile and marked as fixed, the system populates the corresponding field on the Subject Alternative Name (SAN) screen with the value from the Certification Profile. This value takes precedence over any value entered in the mapped Vetting Form field and cannot be overridden by the user.
  • For CSR-based requests (PKCS#10), the SAN values are taken from the uploaded CSR. These values take priority over any values entered in the Vetting Form.
  • For CSR-based requests ($Request), the system populates the SAN values using the values entered in the Vetting Form.
  • For Certification Profiles configured for server-side certificate generation or with the Enable Client Keys option enabled, the system populates the SAN values using the values entered in the Vetting Form..


If a SAN field is not mapped to a Vetting Form field and is not configured as fixed in the ADSS Certification Profile, the field remains enabled, allowing you to enter a value according to your requirements.


After reviewing and entering the required values, click the next ‘>’ button to navigate to the ‘Certificate Validity’ screen.



The ‘Validity Period’ field will appear enabled or disabled according to the configuration in the Certification Profile. 


After completing the certificate request details, click the Submit button to submit the request for approval by the operator.