Managing TLS Server Certificates via the Command Line

You can use the datasphere command line interface to list, upload, and delete TLS server certificates.

Prerequisites

To manage TLS Server Certificates on the command line, you must have a global role that grants you the following privileges:
  • Data Warehouse General (-R------) - To access SAP Datasphere.

  • System Information (-RU-----) - To access the System tool.

The DW Administrator role template, for example, grants these privileges. For more information, see Privileges and Permissions and Standard Roles Delivered with SAP Datasphere.
You must, in addition:
To browse the available commands, enter the following and press Return:
datasphere configuration certificates 

For information about managing certificates in SAP Datasphere, see Manage Certificates.

List TLS Certificates

You can list all TLS server certificates uploaded to SAP Datasphere.

Enter the following command and press Return:
datasphere configuration certificates list

Upload TLS Certificates

You can upload a TLS server certificate.

Enter the following command and press Return:
datasphere configuration certificates upload 
    --description <description>
	--file-path<path> | --input <input>
Complete the parameters as follows:

Parameter

Description

--description <description>

Enter a description to provide intelligible information on the certificate, for example to point out to which connection type the certificate applies.

--file-path<path>

[optional] Enter a path to a certificate file with a supported file extension - .pem (privacy-enhanced mail), .crt, or .cer.

--input <input>

[optional] Provide your certificate definition in stringified json format instead of via the --file-path option.

For example, to upload a TLS Server certificate for SAP SuccessFactors connections, enter:
datasphere configuration certificates upload --description SAP Success Factors --file-path MySAPSuccssFactorsCertificate.pem 

Delete TLS Certificates

You can delete a certificate.

Enter the following command and press Return:
datasphere configuration certificates delete 
    --fingerprint <fingerprint>
Complete the parameters as follows:

Parameter

Description

--fingerprint <fingerprint>

Enter the fingerprint of the certificate that you want to delete.

You can retrieve the fingerprint via the command datasphere configuration certificates list.