Product Documentation

    A user with special permission can perform various KA operations using sakamclient, such as encryption, decryption, deletion, search, and both encryption and decryption.

    1. Open a terminal window.

    2. Change directory where sakamclient.jar is present.

      shell> cd /usr/local/topaz/
    3. Execute sample client to view usage by using the following command: 
      shell> java -jar sakamclient.jar

      Output

      $ example:~/topaz> java -jar sakamclient.jar 

NOTE: Picked up JDK_JAVA_OPTIONS: --add-opens java.base/java.util=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.lang.reflect=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED --add-opens java.management/javax.management.openmbean=ALL-UNNAMED --add-opens java.management/javax.management=ALL-UNNAMED --add-opens java.base/sun.security.provider=ALL-UNNAMED

      Usage: java -jar sakamclient.jar  https://<host:port>[,https://<host:port>,..] <did> <username> <password> E  <16-digit-PAN-start-value> <#-of-iterations>
             java -jar sakamclient.jar  https://<host:port>[,https://<host:port>,..] <did> <username> <password> D  <token-start-value> <#-of-iterations>
             java -jar sakamclient.jar  https://<host:port>[,https://<host:port>,..] <did> <username> <password> B  <16-digit-PAN-start-value> <#-of-iterations>
             java -jar sakamclient.jar  https://<host:port>[,https://<host:port>,..] <did> <username> <password> L  <token-start-value> <#-of-iterations>
             java -jar sakamclient.jar  https://<host:port>[,https://<host:port>,..] <did> <username> <password> S  <16-digit-PAN-start-value> <#-of-iterations>

             java -jar sakamclient.jar  https://<host:port>[,https://<host:port>,..] <did> <password> P

     

    Here is a brief description of each argument used with sakamclient:

    Value

    Explanation

    did

    Unique domain identifier that belongs to SAKA

    hostport

    Host and port to access the SAKA SOAP and REST formats:

    http://<FQDN>:<non-ssl-portnumber> or

    https://<FQDN>:<ssl-portnumber>

    Example: https://saka.strongauth.com:8181

    username

    The username in the encryption domain with authorization to call the web service.

    password

    The password of the username above.

    16-digit-PAN-start-value

    PAN to be encrypted with numbers from 1 to 16 digits.

    token-start-value

    Token made by the appliance to be decrypted.

    #-of-iterations

    For both encryption and decryption, one can choose how many iterations to do from the original number given. Example, encrypting from number 1 and setting 10 iterations, will encrypt the numbers 1 through 9.